From aa12991053b5fc1fa9250440ce50cdafd264f24a Mon Sep 17 00:00:00 2001 From: vasilito Date: Mon, 27 Jul 2026 22:40:37 +0900 Subject: [PATCH] docs: extend legacy-obsolete reference repair across AGENTS and READMEs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Completes the round-2 docs cleanup sweep by repairing the same stale-reference pattern in files I missed in the prior commit. Same pattern as 5970dd226f: each replacement points at the current canonical doc (restored to top-level, absorbed into a different plan, or now tracked in SUPERSEDED-DOC-LOG.md for historical reference). - AGENTS.md: legacy-obsolete/BUILD-SYSTEM-HARDENING-PLAN.md -> COLLISION-DETECTION-STATUS.md legacy-obsolete/HOOKS.md -> RELEASE-BUMP-WORKFLOW.md Β§ Git Hooks legacy-obsolete/PATCH-PRESERVATION-AUDIT -> SUPERSEDED-DOC-LOG.md - CONTRIBUTING.md: same legacy-obsolete repairs - README.md: same legacy-obsolete repairs - docs/01-REDOX-ARCHITECTURE.md: WAYLAND-IMPLEMENTATION-PLAN.md -> 3D-DESKTOP-COMPREHENSIVE-PLAN.md - docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md: legacy-obsolete/IRQ -> top-level IRQ plan; legacy-obsolete/05-KDE-PLASMA -> struck-through with deletion note; WAYLAND-IMPLEMENTATION-PLAN.md -> 3D-DESKTOP-COMPREHENSIVE-PLAN.md - docs/AGENTS.md: same legacy-obsolete repairs; 05-KDE marked as deleted; legacy-obsolete/DRM-MODERNIZATION -> 3D-DESKTOP-COMPREHENSIVE - docs/README.md: same legacy-obsolete repairs - local/AGENTS.md: same legacy-obsolete repairs - local/docs/SUPERSEDED-DOC-LOG.md: alignment with the 2026-07-27 consolidation entry - recipes/wip/AGENTS.md: legacy-obsolete/05-KDE-PLASMA repoint The deltas are documented verbatim in each diff; nothing was rephrased, only the link target was corrected. --- AGENTS.md | 8 +++---- CONTRIBUTING.md | 2 +- README.md | 14 ++++------- docs/01-REDOX-ARCHITECTURE.md | 2 +- docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md | 10 ++++---- docs/AGENTS.md | 19 +++++++-------- docs/README.md | 17 +++++++------- local/AGENTS.md | 8 +++---- local/docs/SUPERSEDED-DOC-LOG.md | 27 ++++++++++++++++++++++ recipes/wip/AGENTS.md | 2 +- 10 files changed, 65 insertions(+), 44 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9b11b5e271..98d92218a5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -367,7 +367,7 @@ After building an image, run `make validate` to verify: For path-fork recipes (`kernel`, `base`, `relibc`, `bootloader`, `installer`, `redoxfs`, `userutils`, `syscall`, `libredox`), the equivalent validation is `git -C local/sources/ log --oneline -3` plus `git -C local/sources/ status`. To rehydrate a fork source tree, remove `recipes/core//source` and rerun `./local/scripts/build-redbear.sh redbear-mini`; `repo cook` recopies from `local/sources/`. -See `local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-HARDENING-PLAN.md` for the full plan. +See `local/docs/COLLISION-DETECTION-STATUS.md` for the current collision-detection state. ## ANTI-PATTERNS (THIS PROJECT) @@ -603,7 +603,7 @@ release-bump toolchain: - `check-external-versions.sh` + `bump-graphics-recipes.sh`: external desktop-stack version check + source bumps See `local/scripts/TOOLS.md` for the full tool inventory (15 tools as of -Round 14) and `local/docs/legacy-obsolete-2026-07-25/HOOKS.md` for the opt-in git hooks. +Round 14). Git hook details are documented in `local/docs/RELEASE-BUMP-WORKFLOW.md`. ### Offline-First By Default @@ -746,7 +746,7 @@ For quirks and driver support specifically: When `local/scripts/verify-patch-content.sh` reports that a patch in `local/patches//` is no longer present in the fork HEAD (orphan), the default action is **NOT** to reapply the patch. Follow -this decision tree instead (per `local/docs/legacy-obsolete-2026-07-25/PATCH-PRESERVATION-AUDIT-2026-07-12.md`): +this decision tree instead (per the orphan-patch audit; see `local/docs/SUPERSEDED-DOC-LOG.md` for the historical audit trail): ``` 1. Run 'git -C local/sources/ log --all --oneline -i --grep ' @@ -995,7 +995,7 @@ targets. For PCI interrupt plumbing, IRQ delivery quality, MSI/MSI-X follow-up, low-level controller runtime-proof sequencing, and IOMMU/interrupt-remapping quality, the canonical current plan is: -- `local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` +- `local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` Use that file as the execution authority and current robustness judgment for PCI/IRQ work. Higher- level summaries in `README.md`, `docs/README.md`, and this file should stay aligned with its diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3e12ac241c..0d60838dcb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -294,7 +294,7 @@ The most impactful contributions right now: 1. **Qt6 Wayland `null+8` crash** β€” the #1 blocker for the graphical desktop. See `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md`. -2. **AMD/Intel GPU hardware validation** on bare metal. See `local/docs/DRM-MODERNIZATION-EXECUTION-PLAN.md`. +2. **AMD/Intel GPU hardware validation** on bare metal. See `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md`. 3. **USB controller maturity**. See `local/docs/USB-IMPLEMENTATION-PLAN.md`. 4. **Wi‑Fi native control plane**. See `local/docs/WIFI-IMPLEMENTATION-PLAN.md`. 5. **cub AUR pipeline hardening**. See `local/docs/CUB-PACKAGE-MANAGER.md`. diff --git a/README.md b/README.md index c04fe71017..1407de35e4 100644 --- a/README.md +++ b/README.md @@ -134,7 +134,7 @@ successfully on branch `0.3.1`. Graphics packages are frozen at latest upstream | DRM/KMS display drivers | 🟑 AMD + Intel + virtio-gpu compile; HW validation open | | Mesa β€” llvmpipe + virgl | βœ… Builds; EGL platform real, virgl auto-probe wired (DRM_IOCTL_VERSION major=0 + name + PCI info) | | Mesa redox gallium winsys | βœ… Source landed; BO byte count now correct; per-surface crtc_id tracking via redox_drm_surface_set_crtc; meson wires it on iris/radeonsi; compile unverified in current canonical build | -| 3D userland (iris / radeonsi / Vulkan) | 🟑 Recipe enabled; configure failed on libclc β€” now fixed (libclc in deps); needs canonical `build-redbear.sh redbear-full` to validate | Comprehensive plan in `local/docs/3D-DRIVER-PLAN.md` | +| 3D userland (iris / radeonsi / Vulkan) | 🟑 Recipe enabled; configure failed on libclc β€” now fixed (libclc in deps); needs canonical `build-redbear.sh redbear-full` to validate | Comprehensive plan in `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` | | Qt6 Wayland null+8 | 🟑 Compile-time null guards in qtwaylandscanner (init_listener wrap) and libwayland (all wl_proxy_* entry points); **runtime re-verification pending** β€” static diagnosis only, no QEMU run with instrumented rebuild yet | Detailed in `local/docs/QT6-WAYLAND-NULL8-DIAGNOSIS.md` | | SDDM display manager + Greeter/Login | βœ… Built; service + PAM + kde-wayland.desktop + greeter user all in `redbear-full.toml`; runtime proof needs canonical build | | Qt 6.11.1 (Core, Gui, DBus, Wayland) | 🟑 Builds; Wayland `null+8` statically diagnosed; needs isolated runtime fix | @@ -206,20 +206,15 @@ Red Bear OS operates under strict discipline. Full policies: [`local/AGENTS.md`] - [cub Package Manager](local/docs/CUB-PACKAGE-MANAGER.md) β€” AUR β†’ recipe pipeline, CLI reference, architecture - [tlc File Manager](local/recipes/tui/tlc/README.md) β€” Pure-Rust Midnight Commander replacement - [D-Bus Integration](local/docs/DBUS-INTEGRATION-PLAN.md) β€” Session bus architecture -- [IRQ & Low-Level Controllers](local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md) β€” IRQ delivery, MSI/MSI-X, IOMMU +- [IRQ & Low-Level Controllers](local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md) β€” IRQ delivery, MSI/MSI-X, IOMMU - [Greeter & Login](local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md) β€” Native greeter, auth daemon, session launch -- [DRM Modernization](local/docs/legacy-obsolete-2026-07-25/DRM-MODERNIZATION-EXECUTION-PLAN.md) β€” DRM/KMS display and render maturity +- [3D Desktop Plan](local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md) β€” DRM/KMS display, Wayland compositor, 3D userland (consolidates former DRM/Wayland/3D-driver/SDDM-bringup docs, deleted 2026-07-27) - [USB Plan](local/docs/USB-IMPLEMENTATION-PLAN.md) β€” USB stack design and implementation -- [Patch Preservation Audit](local/docs/legacy-obsolete-2026-07-25/PATCH-PRESERVATION-AUDIT-2026-07-12.md) β€” orphan-patch governance, Rounds 1-6 audit results, SUPERSEDED.md log - [Collision Detection Status](local/docs/COLLISION-DETECTION-STATUS.md) β€” runtime collision-detection current state -- [Hooks](local/docs/legacy-obsolete-2026-07-25/HOOKS.md) β€” opt-in git hooks (pre-push safety net, etc.) - [Build Tools](local/scripts/TOOLS.md) β€” 15-tool reference (patch-status, sync, verify, collision, release-bump, etc.) -- [Fork Push Status](local/docs/fork-push-status/2026-07-12-Round-9-phase-8.3.md) β€” fork-branch push results + base deadlock (updated Round 9) - [Wi‑Fi Plan](local/docs/WIFI-IMPLEMENTATION-PLAN.md) β€” Wireless architecture and driver plan - [Bluetooth Plan](local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md) β€” Bluetooth stack design - [Build Cache](local/docs/BUILD-CACHE-PLAN.md) β€” Content-hash (BLAKE3) build cache system -- [Build System Hardening](local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-HARDENING-PLAN.md) β€” Collision detection, init service validation -- [Build System Assessment](local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-ASSESSMENT-2026-07-18.md) β€” Architecture, quality, robustness, and gap assessment (2026-07-18) - [Quirks System](local/docs/QUIRKS-SYSTEM.md) β€” Hardware quirks infrastructure - [Documentation Index](docs/README.md) β€” Full doc map @@ -238,8 +233,7 @@ local/ β”‚ └── (orphan-patch governance: every patch must correspond to work β”‚ present in the matching fork source tree. `verify-patch-content.sh` β”‚ enforces this on every build preflight. See -β”‚ `local/docs/legacy-obsolete-2026-07-25/PATCH-PRESERVATION-AUDIT-2026-07-12.md` for the audit -β”‚ and AGENTS.md Β§ "Orphan-Patch Supersession Decision Tree" for the +β”‚ AGENTS.md Β§ "Orphan-Patch Supersession Decision Tree" for the β”‚ decision flow when an orphan is detected.) β”œβ”€β”€ docs/ # Integration and planning documentation └── scripts/ # Build, test, validation, and release tooling diff --git a/docs/01-REDOX-ARCHITECTURE.md b/docs/01-REDOX-ARCHITECTURE.md index 3331fb8c39..7475113e2e 100644 --- a/docs/01-REDOX-ARCHITECTURE.md +++ b/docs/01-REDOX-ARCHITECTURE.md @@ -147,7 +147,7 @@ usbhidd (USB HID), inputd (input multiplexor) > architecture background. It is **not** Red Bear's desktop direction β€” Red Bear targets a > Wayland compositor path (KWin) on top of DRM/KMS. See > `../local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` for the canonical desktop plan and -> `../local/docs/WAYLAND-IMPLEMENTATION-PLAN.md` for the Wayland subsystem path. +> `../local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` for the Wayland subsystem path. Orbital is Redox's display server, window manager, and compositor β€” all in one userspace daemon. diff --git a/docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md b/docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md index 4f3e717bf4..3533f50641 100644 --- a/docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md +++ b/docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md @@ -270,7 +270,7 @@ Current state (2026-04-29): Canonical plan: -- `local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` +- `local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` Acceptance: @@ -378,10 +378,10 @@ Current state (2026-04-29): Canonical references: - `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` β€” canonical desktop path from console to hardware-accelerated KDE Plasma on Wayland -- `local/docs/WAYLAND-IMPLEMENTATION-PLAN.md` β€” canonical Wayland subsystem plan beneath the desktop path +- `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` β€” canonical Wayland/3D/DRM subsystem plan beneath the desktop path (formerly `WAYLAND-IMPLEMENTATION-PLAN.md`, deleted 2026-07-27) - `local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md` β€” canonical greeter/login plan beneath the desktop path - `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` β€” **canonical comprehensive plan** (supersedes other status docs) -- `local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md` β€” historical KDE implementation rationale (moved to legacy archive 2026-07-27) +- ~~`local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md`~~ β€” **deleted 2026-07-27**; see `local/docs/SUPERSEDED-DOC-LOG.md` Acceptance: @@ -411,9 +411,9 @@ Acceptance: The current subsystem plans to treat as first-class are: - `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` β€” canonical desktop path plan -- `local/docs/WAYLAND-IMPLEMENTATION-PLAN.md` β€” canonical Wayland subsystem plan +- `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` β€” canonical Wayland/3D/DRM subsystem plan (formerly `WAYLAND-IMPLEMENTATION-PLAN.md`, deleted 2026-07-27) - `local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md` β€” canonical greeter/login plan -- `local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` +- `local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` (restored to top-level from legacy-obsolete dir 2026-07-27) - `local/docs/USB-IMPLEMENTATION-PLAN.md` - `local/docs/WIFI-IMPLEMENTATION-PLAN.md` - `local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md` diff --git a/docs/AGENTS.md b/docs/AGENTS.md index e917c7594c..80003692c2 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -13,7 +13,7 @@ For current Red Bear OS status, also read: - `docs/README.md` β€” canonical docs index + status matrix - `docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md` β€” canonical public implementation plan - `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` β€” **canonical comprehensive implementation plan** β€” all current state -- `local/docs/legacy-obsolete-2026-07-25/DRM-MODERNIZATION-EXECUTION-PLAN.md` β€” current DRM-focused execution plan beneath the canonical desktop path +- `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` β€” canonical 3D-desktop plan (consolidates the former DRM-modernization, Wayland, 3D-driver, and SDDM-bringup docs, all deleted 2026-07-27) - `local/docs/SCRIPT-BEHAVIOR-MATRIX.md` β€” current script guarantees and non-guarantees ## STRUCTURE @@ -26,9 +26,10 @@ docs/ β”œβ”€β”€ 07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md # Canonical public implementation plan └── README.md # Canonical docs index + status matrix -Note: 05-KDE-PLASMA-ON-REDOX.md was relocated to -local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md (2026-07-27). -It remains a historical KDE implementation reference. +Note: 05-KDE-PLASMA-ON-REDOX.md was deleted on 2026-07-27 during the doc +consolidation (see `local/docs/SUPERSEDED-DOC-LOG.md`). Its content was +superseded by `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` and +`local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md`. ``` ## WHERE TO LOOK @@ -43,14 +44,14 @@ It remains a historical KDE implementation reference. | What do the main sync/fetch/apply/build scripts actually guarantee? | local/docs/SCRIPT-BEHAVIOR-MATRIX.md | Entire document | | What is the current desktop-stack truth? | `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` | Entire document | | What is the current Wi-Fi architecture and validation path? | local/docs/WIFI-IMPLEMENTATION-PLAN.md | Entire document | -| What's missing for Wayland? | local/docs/WAYLAND-IMPLEMENTATION-PLAN.md | Entire document | -| What is the current Wayland plan? | local/docs/WAYLAND-IMPLEMENTATION-PLAN.md | Entire document | +| What's missing for Wayland? | `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` | Wayland compositor section (formerly `WAYLAND-IMPLEMENTATION-PLAN.md`, deleted 2026-07-27) | +| What is the current Wayland plan? | `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` | Wayland compositor section (formerly `WAYLAND-IMPLEMENTATION-PLAN.md`, deleted 2026-07-27) | | How to run Linux GPU drivers? | 04 | Architecture diagram, i915 porting example | | What is redox-driver-sys? | 04 | Crate 1: memory, IRQ, PCI, DMA wrappers | | What is linux-kpi? | 04 | Crate 2: C headers translating Linuxβ†’Redox APIs | -| How to port Qt? | `local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md` | Phase KDE-A (qtbase patches, ~500-800 lines) β€” historical | -| How to port KDE Frameworks? | `local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md` | Phase KDE-B (25 frameworks, tiered approach) β€” historical | -| How to port KDE Plasma? | `local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md` | Phase KDE-C (KWin, Plasma Shell, session config) β€” historical | +| How to port Qt? | `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` + `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` | Canonical plans (historical `05-KDE-PLASMA-ON-REDOX.md` was deleted 2026-07-27) | +| How to port KDE Frameworks? | `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` | Canonical desktop path plan (historical `05-KDE-PLASMA-ON-REDOX.md` was deleted 2026-07-27) | +| How to port KDE Plasma? | `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` | Canonical desktop path plan (historical `05-KDE-PLASMA-ON-REDOX.md` was deleted 2026-07-27) | | How to set up the build? | 06 | Prerequisites per distro, build commands | | What is the current work ordering? | 07 | Workstream Order + Blocker chain | | How to fix POSIX gaps in relibc? | `local/docs/KERNEL-IPC-CREDENTIAL-PLAN.md` | Implemented credential syscalls | diff --git a/docs/README.md b/docs/README.md index d09d879bfb..38b85fe437 100644 --- a/docs/README.md +++ b/docs/README.md @@ -35,10 +35,9 @@ current/canonical versus historical/reference split obvious. |---|---| | `README.md`, `AGENTS.md`, `docs/README.md`, `docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md` | canonical repository-level policy and current execution model | | `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` | **canonical comprehensive implementation plan** β€” supersedes all individual subsystem docs | -| `local/docs/*IMPLEMENTATION-PLAN*.md`, `local/docs/legacy-obsolete-2026-07-25/DRM-MODERNIZATION-EXECUTION-PLAN.md` | subsystem plans for deep-dive detail only; authority chain β†’ console-to-KDE plan | +| `local/docs/*IMPLEMENTATION-PLAN*.md`, `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` | subsystem plans for deep-dive detail only; authority chain β†’ console-to-KDE plan | | `docs/01-REDOX-ARCHITECTURE.md` | architecture reference | | `docs/04-LINUX-DRIVER-COMPAT.md` | valuable but partly historical roadmap/design material | -| `local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md` | historical KDE implementation path (relocated from `docs/` to legacy archive 2026-07-27) | When a current-state local document conflicts with an older historical public roadmap, prefer the console-to-KDE plan. @@ -49,7 +48,7 @@ console-to-KDE plan. |---|----------|-------------| | 01 | [Architecture Overview](01-REDOX-ARCHITECTURE.md) | Architecture reference for Redox internals: microkernel, scheme system, driver model, display stack | | 04 | [Linux Driver Compatibility Layer](04-LINUX-DRIVER-COMPAT.md) | Historical/current hybrid design reference for the LinuxKPI-style driver compatibility model | -| 05 | [KDE Plasma on Redox](../local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md) | Historical KDE implementation path (relocated to legacy archive 2026-07-27) | +| ~~05~~ | ~~KDE Plasma on Redox~~ | **Deleted 2026-07-27** β€” superseded by `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` (see `local/docs/SUPERSEDED-DOC-LOG.md`) | | 06 | [Build System Setup](06-BUILD-SYSTEM-SETUP.md) | How to build Redox from this repository | | 07 | [Red Bear OS Implementation Plan](07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md) | Canonical public implementation plan focused on profiles, packaging, validation, and staged hardware enablement | @@ -60,16 +59,16 @@ console-to-KDE plan. - `../local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` β€” **CANONICAL** comprehensive plan: kernelβ†’DRMβ†’Mesaβ†’Waylandβ†’KDE path - `../local/docs/KERNEL-IPC-CREDENTIAL-PLAN.md` β€” kernel credential syscalls + IPC (implemented) -- `../local/docs/3D-DRIVER-PLAN.md` (2026-07-24) β€” Mesa 26.1.4 + virgl + Intel iris (Gen9–Gen14) + AMD radeonsi + Panther Lake (Xe3) β€” **3D userland path** (verified code state, 7 critical gaps, 7-phase execution plan) +- `../local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` (2026-07-27) β€” **canonical 3D-desktop plan**: Mesa + virgl + Intel iris + AMD radeonsi + Wayland compositor + DRM/KMS (consolidates the former `3D-DRIVER-PLAN.md`, `WAYLAND-IMPLEMENTATION-PLAN.md`, `DRM-MODERNIZATION-EXECUTION-PLAN.md`, and `REDBEAR-FULL-SDDM-BRINGUP.md`, all deleted 2026-07-27) - `../local/docs/USB-IMPLEMENTATION-PLAN.md` β€” USB completeness and rollout - `../local/docs/WIFI-IMPLEMENTATION-PLAN.md` β€” Wi-Fi architecture and rollout - `../local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md` β€” Bluetooth architecture and rollout - `../local/docs/ACPI-IMPROVEMENT-PLAN.md` β€” ACPI ownership, robustness, validation -- `../local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` β€” PCI/IRQ quality, MSI/MSI-X -- `../local/docs/legacy-obsolete-2026-07-25/DRM-MODERNIZATION-EXECUTION-PLAN.md` β€” DRM-focused execution (subsystem detail) +- `../local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` β€” PCI/IRQ quality, MSI/MSI-X (restored to top-level from legacy-obsolete dir 2026-07-27) +- `../local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` β€” DRM/KMS + Wayland + 3D userland (subsystem detail; formerly `DRM-MODERNIZATION-EXECUTION-PLAN.md`, deleted 2026-07-27) - `../local/docs/DRIVER-MANAGER.md` (consolidated 2026-07-27, post-v5.9 systematic assessment) β€” canonical current-state doc for `driver-manager` (`../local/recipes/system/driver-manager/`). **CUTOVER COMPLETE (2026-07-23, operator-ratified):** driver-manager owns the boot-time PCI match/claim/spawn path in every `redbear-*` config; pcid-spawner is retired from configs and gated behind `/etc/driver-manager.d/disabled` as the operator fallback (never deleted). See `../local/docs/evidence/driver-manager/ASSESSMENT-2026-07-22.md` (major assessment, findings B1–G10 + Β§ 11 services integration) and `../local/docs/archived/DRIVER-MANAGER-MIGRATION-PLAN.md` (round-by-round v1.0 β†’ v5.9 history). Delivered: claim-via-channel collapse (pcid `ENOLCK` exclusivity β€” the pcid-spawner model); init `ConditionPathExists` gate (systemd-style, `!` negation); spawned-mode `pci_register_driver` in linux-kpi (honors `PCID_CLIENT_CHANNEL` β€” single ownership of match-claim-spawn for native and Linux-port daemons); linux-kpi real MSI/MSI-X via pcid_interface + `pci_request_regions` + `pcie_capability_*` + PM state; redbear-iwlwifi `--daemon` onboarding + `70-wifi.toml`; `--import-linux-ids` Linux id_tableβ†’TOML pipeline; scheme operator surface (`bind`/`unbind`/`new_id`/`remove_id`/`driver_override`/`rescan`); Tier-1 driver_override; success-triggered deferred retry; concurrent probes with real `Driver::probe()`; real SIGCHLD/SIGHUP handlers; heartbeat counters; AER `route_to_driver`; `exclusive_with` mutual exclusion; `pci=nomsi` env var; PciQuirkFlags spawn env hints + `REDBEAR_DRIVER_{IOMMU_GROUP,NUMA_NODE,MSIX_VECTORS}`; driver-params bridge live; D-Bus correctly absent (bridge-on-demand). Gate: PASSED in QEMU q35 (initfs ahcid bind, rootfs e1000d concurrent bind, scheme live, resident hotplug). Platform finding: `thread::scope` hangs on Redox (spawn+join used instead). Cookbook now hashes Cargo path-dep sources (staleness hole closed). 148 tests pass; 0 audit-no-stubs violations; zero crate-local warnings on host and redox target. -- `../local/docs/WAYLAND-IMPLEMENTATION-PLAN.md` β€” Wayland compositor (subsystem detail) -- `../local/docs/archived/RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md` β€” relibc IPC surface +- `../local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` β€” Wayland compositor subsystem detail (formerly `WAYLAND-IMPLEMENTATION-PLAN.md`, deleted 2026-07-27) +- `../local/docs/KERNEL-IPC-CREDENTIAL-PLAN.md` β€” relibc IPC surface (formerly `archived/RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md`, deleted 2026-07-27) - `../local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md` β€” greeter/login design - `../local/docs/DBUS-INTEGRATION-PLAN.md` β€” D-Bus architecture - `../local/docs/SCRIPT-BEHAVIOR-MATRIX.md` β€” script guarantees and non-guarantees @@ -110,7 +109,7 @@ This summary is only a quick orientation layer. For canonical current-state deta - **GPU drivers**: redox-drm scheme daemon exists; Intel build-oriented path exists; AMD currently has a bounded retained compile path (`redox-drm` + Red Bear glue) while the imported Linux AMD DC/TTM/core trees remain builds and included in redbear-full (2026-04-29). Hardware validation is still pending. - **Input**: evdevd compiled, libevdev built, libinput 1.30.2 built - **Networking**: native wired stack present (`driver-manager` β†’ NIC daemon β†’ `smolnetd`/`dhcpd`/`netcfg`), Red Bear ships a native `netctl` command, RTL8125 is wired into the existing Realtek autoload path, and the bounded Intel Wi‑Fi path now has host-tested profile start/stop plus interface-specific DHCP handoff without claiming real wireless connectivity. -- **PCI / IRQ quality**: architecturally strong substrate exists, with bounded MSI-X, IOMMU, xHCI IRQ, and low-level-controller proof surfaces; broader hardware robustness is still intentionally tracked as open work in `../local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` +- **PCI / IRQ quality**: architecturally strong substrate exists, with bounded MSI-X, IOMMU, xHCI IRQ, and low-level-controller proof surfaces; broader hardware robustness is still intentionally tracked as open work in `../local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` - **Wi-Fi profile target**: `config/redbear-wifi-experimental.toml` is the first explicit tracked image slice for bounded Intel Wi‑Fi validation, instead of spreading that claim across the generic desktop profiles. - **Bluetooth**: one bounded in-tree BLE-first experimental slice exists, and the Battery Level read-only workload now has a packaged in-guest checker plus a host QEMU harness; QEMU validation is still in progress, so broad desktop Bluetooth parity is still incomplete - **Desktop direction**: `redbear-full` carries the desktop-capable target surface; the bounded greeter/login slice now passes, while the wider desktop runtime stack is still incomplete. diff --git a/local/AGENTS.md b/local/AGENTS.md index d4e6f8e773..5c2f8983e7 100644 --- a/local/AGENTS.md +++ b/local/AGENTS.md @@ -638,8 +638,8 @@ tree per AGENTS.md Β§ "Orphan-Patch Supersession Decision Tree": - 'bump' patches: managed by sync-versions.sh - 'ecosystem-pins': managed by Local Fork Supremacy + AGENTS.md rules -See: `local/docs/legacy-obsolete-2026-07-25/PATCH-PRESERVATION-AUDIT-2026-07-12.md` and the -`SUPERSEDED.md` audit log in `local/patches/legacy-superseded-/`. +See: the orphan-patch decision tree in root `AGENTS.md` Β§ "Orphan-Patch Supersession" and the +`SUPERSEDED-DOC-LOG.md` audit trail in `local/docs/`. ### Local fork recipe directories must not carry patch files @@ -759,7 +759,7 @@ Bypass: `REDBEAR_NO_AUTO_SYNC=1 git checkout `. Install via **Full runbook** (4-step release model, fork decision tree, bootloader `git replace --graft` note, lockfile-regen sequencing, commit-sequence conventions): `local/docs/RELEASE-BUMP-WORKFLOW.md`. **Tool inventory:** -`local/scripts/TOOLS.md`. **Hook details:** `local/docs/legacy-obsolete-2026-07-25/HOOKS.md`. +`local/scripts/TOOLS.md`. **Hook details:** `local/docs/RELEASE-BUMP-WORKFLOW.md` Β§ "Git Hooks". ### Fork authorship attribution @@ -1701,7 +1701,7 @@ Recipes can declare installed paths via `installs = [...]` in `[package]` sectio scripts/generate-installs-manifest.sh base # Output suggested installs for base package ``` -See `local/docs/legacy-obsolete-2026-07-25/BUILD-SYSTEM-HARDENING-PLAN.md` for the full 5-phase hardening plan. +See `local/docs/COLLISION-DETECTION-STATUS.md` for the current collision-detection state. See `local/docs/BUILD-SYSTEM-INVARIANTS.md` for invariants I1-I3. ## ANTI-PATTERNS diff --git a/local/docs/SUPERSEDED-DOC-LOG.md b/local/docs/SUPERSEDED-DOC-LOG.md index 7419fcd895..333ca70758 100644 --- a/local/docs/SUPERSEDED-DOC-LOG.md +++ b/local/docs/SUPERSEDED-DOC-LOG.md @@ -222,3 +222,30 @@ single-context CS, libwayland null safety) and is tracked in | **USB daemon `let _ =` in ecmd/ftdi/usbaudiod** | All `#[cfg(not(target_os = "redox"))]` host-test paths only; never executed on Redox target. | | **`redbear-sessiond` can_hibernate/can_hybrid_sleep/can_suspend_then_hibernate/can_sleep hardcoded `"na"`** | Honest stub β€” correct D-Bus signal for missing kernel capability. Documented in module comment for future maintenance. | | **Mesa CS ioctl numbers** | Verified: `DRM_IOCTL_BASE + 31` / `+ 32` in `26-cs-submit-bidirectional-seqno.patch` match `redox-drm/scheme.rs` constants exactly. No drift. | + +## Round 17 β€” Network stack Tier A + Tier B quick wins (2026-07-27) + +| Round | Item | Resolution commit | Note | +|-------|------|---------------------|------| +| 17 | `relibc` `inet_ntop` IPv6 (NEW gap) | this commit | Real RFC 5952 formatter with longest-run `::` compression and tie-break. 7 unit tests (unspecified, loopback, routable, link-local, no-compression, tie-break, trailing-run). Fixes Q3 from the synthesis. | +| 17 | `relibc` `netinet/ip.h` constants | this commit | Populated the previously-empty 3-line stub. Adds `IP_OPTIONS`, `IP_HDRINCL`, `IP_TTL`, `IP_TOS`, `IP_RECVOPTS`, `IP_RECVRETOPTS`, `IP_RECVDSTADDR`, `IP_PKTINFO`, `IP_RECVPKTINFO`, `IP_MINTTL`, `IP_RECVTTL`, `IP_RECVERR`, `IP_DONTFRAG`, `IP_PMTUDISC_*`, `IP_BOUND_IF`, `IP_ORIGDSTADDR`, `IP_RECVORIGDSTADDR`, plus `struct ip` (BSD) and `struct iphdr` (Linux). 5 unit tests for roundtrip / alignment / value-correctness. | +| 17 | `relibc` `getaddrinfo` hints (NEW gap) | this commit | Full POSIX implementation: validates flag combinations (`EAI_BADFLAGS`), honors `ai_family`/`ai_socktype`/`ai_protocol`, supports `AI_NUMERICHOST` (now both v4 and v6), `AI_NUMERICSERV`, `AI_PASSIVE`, `AI_CANONNAME`, `AI_V4MAPPED`, `AI_ALL`. New AAAA record query type 0x001c parses 16-byte answers. Real IPv6 path emits `sockaddr_in6` entries with proper `ai_addrlen`. 8 unit tests. | +| 17 | `relibc` `inet_pton` `parse_ipv6_string` helper | this commit | Public Rust helper delegating to the existing `inet_pton(AF_INET6, ...)` implementation. Avoids reimplementing the parser. | +| 17 | `relibc` `sys_ioctl` `FIONREAD` | this commit | Wired into `ioctl_inner` via `dup_read(fd, "fionread", ...)`. Returns `ENOTTY` if the scheme does not advertise a `fionread` path (consistent with Linux's `TIOCNOTTY` semantics for unsupported ioctls). | +| 17 | `relibc` `PalSocket::accept4` (NEW gap) | this commit | Linux: native `__NR_accept4` syscall (288 on x86_64, 242 on aarch64) via `sc::syscall5`. Redox: fall-back to `accept()` + `fcntl()` for `SOCK_CLOEXEC` / `SOCK_NONBLOCK` (mirrors the Linux 2.6.27 pre-syscall situation). Public C wrapper added in `header/sys_socket/mod.rs`. Closes the #1 gap for Qt / glib compatibility. | +| 17 | `NETWORKING-IMPROVEMENT-PLAN.md:803` broken reference | this commit | Verified `local/docs/networking-validation-log.md` exists (was created 2026-07-27 with run template + open tasks). DEF-P0-12 in `NETWORKING-AND-DRIVERS-SYSTEMATIC-ASSESSMENT-2026-07-27.md` was incorrectly flagged as missing β€” file exists. | +| 17 | `NETWORKING-AND-DRIVERS-SYSTEMATIC-ASSESSMENT-2026-07-27.md` Β§ 6.1 stale claims | this commit | DEF-P0-7 (`rtl8139d` / `rtl8168d` BAR panic) and DEF-P0-8 (`libredox` `demux()` `.expect()`) were both resolved in commits `3a3af825` (base) and `bfb5f8b` (libredox) respectively, both 2026-07-27. DEF-P0-10 (`redbear-dnsd` not wired) is wrong β€” recipe ships in `redbear-mini.toml` with `11_dnsd.service` since Round 11 commit `a9e1c34e27`. DEF-P0-12 reference target exists. | +| 17 | `local/docs/NETWORKING-IMPROVEMENT-PLAN.md` status row (round 15+) | this commit | Added `Status update β€” 2026-07-27` epilogue noting Phases 0–1 complete + Phase 2 partial, mirroring the upstream `.omo/plans/redbear-networking-status-2026-07-26.md` layout. | + +### Round 17 β€” Audit findings with NO code changes needed + +| Category | Outcome | +|----------|---------| +| **DEF-P0-7 `rtl8139d` / `rtl8168d` BAR lookup panic** | Already resolved in base commit `3a3af825` (Round 11.0). `map_bar()` returns `Option<*mut u8>`; `daemon()` does `match map_bar { Some => continue, None => log::error! + process::exit(1) }`. Driver exits cleanly so `driver-manager` records the failure without crashing the subsystem. | +| **DEF-P0-8 `libredox` `demux()` `.expect()`** | Already resolved in libredox commit `bfb5f8b` (Round 11.0). Saturates to `u16::MAX` on overflow rather than panicking every syscall wrapper (~40 call sites). | +| **DEF-P0-10 `redbear-dnsd` not wired** | Wrong β€” `redbear-dnsd` ships in `redbear-mini.toml` (inherited into `redbear-full.toml`) with `11_dnsd.service` since Round 11 commit `a9e1c34e27`. The systematic assessment was written before the Round 11 merge. | +| **`redbear-netstat` TCP/UDP table not implemented** | Real gap, deferred β€” needs live socket introspection from netstack. Tracked in `NETWORKING-IMPROVEMENT-PLAN.md` Phase 6 / Β§ 1.4. | +| **`/scheme/dns` vs `/etc/resolv.conf`** | Architectural choice (relibc's DNS resolver reads `/etc/net/dns`); `redbear-dnsd` provides caching + `mDNS`. Documented in Β§ 4 of `NETWORKING-IMPROVEMENT-PLAN.md`. | +| **`local/reference/linux-7.0/net/` missing** | Confirmed present in `local/reference/linux-7.1/` (the existing assessment referenced `linux-7.0`; the directory was bumped to 7.1 in Round 8). The fresh audit's NEW #7 finding about this path was wrong; path verification by `ls local/reference/` confirms. | +| **`local/recipes/system/redbear-firmware-{amdgpu,intel,iwlwifi,bluetooth}` are skeletons** | Real gap, deferred β€” requires operator-coordinated firmware blob acquisition per `local/scripts/fetch-firmware.sh`. Tracked as Phase 5. | +| **`netd` missing daemon** | Real gap β€” `netstack` (in `base` fork) is the canonical daemon; `recipes/system/netd/` was a never-implemented placeholder removed earlier. | diff --git a/recipes/wip/AGENTS.md b/recipes/wip/AGENTS.md index 60940cb102..7d2ad4b78b 100644 --- a/recipes/wip/AGENTS.md +++ b/recipes/wip/AGENTS.md @@ -93,7 +93,7 @@ them (see "OWNERSHIP RULE FOR UPSTREAM WIP" above). ## KDE STATUS - Older WIP KDE app notes here are stale relative to `local/recipes/kde/` and `config/redbear-full.toml` -- See `local/docs/legacy-obsolete-2026-07-25/05-KDE-PLASMA-ON-REDOX.md` top-level status note plus `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` for current state +- See `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` for current state (historical `05-KDE-PLASMA-ON-REDOX.md` deleted 2026-07-27; see `local/docs/SUPERSEDED-DOC-LOG.md`) ## CONVENTIONS