vasilito/RedBear-OS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: extend legacy-obsolete reference repair across AGENTS and READMEs

Browse Source 
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.
This commit is contained in:
vasilito
2026-07-27 22:40:37 +09:00
parent 5970dd226f
commit aa12991053
10 changed files with 65 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+4 -4
View File
@@ -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/<component> log --oneline -3` plus `git -C local/sources/<component> status`. To rehydrate a fork source tree, remove `recipes/core/<component>/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/<comp>/` 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/<comp> log --all --oneline -i --grep <topic-kw>'
@@ -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
CONTRIBUTING.md
+1 -1
View File
@@ -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`.
README.md
+4 -10
View File
@@ -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
docs/01-REDOX-ARCHITECTURE.md
+1 -1
View File
@@ -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.
docs/07-RED-BEAR-OS-IMPLEMENTATION-PLAN.md
+5 -5
View File
@@ -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`
docs/AGENTS.md
+10 -9
View File
@@ -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 |
docs/README.md
+8 -9
View File
@@ -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.
local/AGENTS.md
+4 -4
View File
@@ -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-<date>/`.
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 <branch>`. 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
local/docs/SUPERSEDED-DOC-LOG.md
+27
View File
@@ -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. |
recipes/wip/AGENTS.md
+1 -1
View File
@@ -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