vasilito
dd6dd99cea
Round 16 audit follow-up. Three small fixes: 1. local/recipes/system/redbear-authd/source/src/main.rs:328 — the validation-mode spawn-reaper thread did 'let _ = child.wait();' silently dropping the session child's exit status. Replaced with 'match' that eprintln-logs both successful exit status and wait failure (with errno). Operators can now see when the session child exits abnormally in validation mode. 2. local/recipes/system/redbear-dnsd/source/src/main.rs:111 — the loopback DNS responder did 'let _ = socket.send_to(&reply, &src);' silently. Replaced with 'if let Err(e) = socket.send_to(...)' that eprintln-logs the failure with the source peer address. Previously DNS clients could fail to receive a valid reply with no visible error. 3. local/docs/SUPERSEDED-DOC-LOG.md — appended Round 16 entries documenting the authd/dnsd fixes plus the Round-16 audit findings that did not require code changes (acpi-rs AML 41 panics classified as internal-invariant, pcid panics already have messages, all stale CONFIG refs already retired, USB-daemon let _ = is in host-only test paths, sessiond can_* for sleep is honest stub, Mesa CS ioctl numbers verified no drift). 3 files changed, +27/-2.
225 lines
16 KiB
Markdown
225 lines
16 KiB
Markdown
# Stale-Doc Deletion Log — 2026-07-27
|
||
|
||
This log records every doc affected by the consolidation authorized on 2026-07-27
|
||
(operator selected option A: "Execute the doc deletion + restore"). It is the audit trail.
|
||
|
||
## Backup
|
||
|
||
**Tarball:** `/tmp/opencode/stale-doc-backup-2026-07-27.tar.gz` (386,925 bytes, 40 entries).
|
||
Captured BEFORE any `rm`. tar -tzf integrity verified.
|
||
|
||
## Restored
|
||
|
||
| Source | Destination | Reason |
|
||
|--------|-------------|--------|
|
||
| `local/docs/legacy-obsolete-2026-07-25/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` | `local/docs/IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md` | Document self-declares it is still the active low-level-controller authority despite the legacy folder name. SUPERSEDED.md had erroneously listed it as superseded. |
|
||
|
||
The IRQ plan carries stale `pcid-spawner` references that need a follow-up rename pass to
|
||
`driver-manager`. Tracked as a separate cleanup task — NOT executed in this consolidation.
|
||
|
||
## Replaced (deleted, content absorbed into consolidated doc)
|
||
|
||
The new consolidated audit and plan is `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md`
|
||
(1,029 lines, 14 sections). It absorbs the Rounds 1-7 of `3D-DRIVER-PLAN.md` and the
|
||
milestone status of `REDBEAR-FULL-SDDM-BRINGUP.md`.
|
||
|
||
| Deleted | Lines | Reason for replacement |
|
||
|---------|-------|------------------------|
|
||
| `local/docs/3D-DRIVER-PLAN.md` | 960 | All ground-truth and Round-7 work fact-of-record in consolidated doc. Operating principle restated in §0. |
|
||
| `local/docs/REDBEAR-FULL-SDDM-BRINGUP.md` | 177 | Build-campaign log; status captured in §1.5 of consolidated doc. |
|
||
|
||
## Deleted (with backup)
|
||
|
||
### From `local/docs/legacy-obsolete-2026-07-25/` (10 docs)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `05-KDE-PLASMA-ON-REDOX.md` | 560 | Self-labeled historical/superseded. Pre-KF6 instructions superseded by consolidated doc + `CONSOLE-TO-KDE-DESKTOP-PLAN.md` |
|
||
| `BUILD-SYSTEM-ASSESSMENT-2026-07-18.md` | 464 | Audit absorbed into AGENTS.md policies |
|
||
| `BUILD-SYSTEM-HARDENING-PLAN.md` | 624 | Phases implemented; collision work now in `COLLISION-DETECTION-STATUS.md` |
|
||
| `DRM-MODERNIZATION-EXECUTION-PLAN.md` | 498 | Superseded by consolidated doc |
|
||
| `HOOKS.md` | 188 | Subsumed by `RELEASE-BUMP-WORKFLOW.md` + AGENTS.md |
|
||
| `INITNSMGR-CONCURRENCY-DESIGN.md` | 222 | Design for implemented O_NONBLOCK fix (v5.3) |
|
||
| `NETWORKING-STACK-STATE.md` | 120 | Superseded by `NETWORKING-IMPROVEMENT-PLAN.md` |
|
||
| `PATCH-PRESERVATION-AUDIT-2026-07-12.md` | 408 | Historical audit; 144-patch finding was addressed in subsequent rounds |
|
||
| `RAPL-IMPLEMENTATION-PLAN.md` | 530 | Draft, never implemented; power planning in `CONSOLE-TO-KDE` |
|
||
| `redbear-power-improvement-plan.md` | 6,184 | LARGEST file in repo. All improvement items done. Patterns extracted to `RATATUI-APP-PATTERNS.md` |
|
||
| `WAYLAND-IMPLEMENTATION-PLAN.md` | 186 | Diagnostic §§1-2 accurate; execution plan superseded by consolidated doc |
|
||
|
||
(11 entries; "11" matches the 11 legacy-line items, not "10"; counts in summary reflect this.)
|
||
|
||
### From `local/docs/archived/` (16 docs)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `ACPI-I2C-HID-IMPLEMENTATION-PLAN.md` | 339 | Deferred; USB HID is primary input path |
|
||
| `BUILD-SYSTEM-IMPROVEMENTS.md` | 621 | Historical post-mortem |
|
||
| `DRIVER-MANAGER-MIGRATION-PLAN.md` | 2,861 | Round-by-round history superseded by `DRIVER-MANAGER.md` |
|
||
| `IMPLEMENTATION-MASTER-PLAN.md` | 129 | Completion report superseded by `CONSOLE-TO-KDE` |
|
||
| `IMPROVEMENT-PLAN.md` | 575 | RESOLVED quality audit |
|
||
| `INTEL-HDA-IMPLEMENTATION-PLAN.md` | 417 | Deferred audio plan |
|
||
| `KERNEL-SCHEDULER-MULTITHREAD-IMPROVEMENT-PLAN.md` | 1,026 | Historical scheduler analysis |
|
||
| `RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md` | 165 | Credential work resolved in `KERNEL-IPC-CREDENTIAL-PLAN.md` |
|
||
| `repo-governance.md` | 99 | Historical, absorbed into AGENTS.md |
|
||
| `SLEEP-IMPLEMENTATION-PLAN.md` | 306 | All phases committed |
|
||
| `STUBS-FIX-PROGRESS.md` | 507 | Completed v6.0 stubs work; outcome captured in §3.2 of consolidated doc |
|
||
| `SYSTEM-STABILITY-AND-UPSTREAM-SYNC-PLAN.md` | 819 | Archived, replaced by `CONSOLE-TO-KDE` |
|
||
| `UPSTREAM-SYNC-PROCEDURE.md` | 829 | References obsolete `pcid-spawner` model |
|
||
| `USB-BOOT-INPUT-PLAN.md` | 169 | Superseded |
|
||
| `USB-VALIDATION-RUNBOOK-2026-07.md` | 137 | Older version; canonical `USB-VALIDATION-RUNBOOK.md` at top-level |
|
||
| `XHCID-DEVICE-IMPROVEMENT-PLAN.md` | 360 | Superseded |
|
||
|
||
### From `local/docs/evidence/driver-manager/` (2 docs)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `ASSESSMENT-2026-07-22.md` | 368 | Pre-cutover; superseded by `DRIVER-MANAGER.md` |
|
||
| `D5-AUDIT.md` | 390 | Pre-cutover D5 gate audit; superseded |
|
||
|
||
### From `local/docs/fork-push-status/` (1 doc)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `2026-07-12-Round-9-phase-8.3.md` | 83 | Point-in-time push log |
|
||
|
||
### From `local/docs/boot-logs/` (6 docs — entire directory)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `README.md` | 57 | Directory inventory only |
|
||
| `cachyos-boot-20260629-0520.md` | 52 | Reference log from CachyOS |
|
||
| `REDBEAR-FULL-BOOT-EXTENDED-RESULTS.md` | 295 | Boot test from 2026-06-09 |
|
||
| `REDBEAR-FULL-BOOT-POST-VIRTIO-BLKD-FIX-RESULTS.md` | 238 | Boot test from 2026-06-09 |
|
||
| `REDBEAR-FULL-BOOT-RESULTS.md` | 281 | Boot test from 2026-06-09 |
|
||
| `REDBEAR-MINI-BOOT-PS2D-INPUTD-LOG-FIX.md` | 134 | Bug diagnostic from 2026-06-30 (bug fixed) |
|
||
|
||
### From `local/docs/legacy-recipe-patches/` (1 doc)
|
||
|
||
| File | Lines | Reason |
|
||
|------|-------|--------|
|
||
| `README.md` | 37 | Navigation aid only |
|
||
|
||
## Updated (NOT deleted; clear superseded entry)
|
||
|
||
| File | Change |
|
||
|------|--------|
|
||
| `local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md` | Removed the incorrectly listed "IRQ-AND-LOWLEVEL-CONTROLLERS-ENHANCEMENT-PLAN.md is subsumed by Round 1-5 kernel work" line; replaced with cross-reference to its restored location. |
|
||
| `local/docs/archived/README.md` | Updated inventory table — entries moved to deletion log. |
|
||
|
||
## KEPT (companion plans, not affected)
|
||
|
||
`local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` is the new authoritative 3D-desktop doc.
|
||
Companion plans (referenced from §12 of the new doc) are NOT touched:
|
||
- `local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md` (desktop journey)
|
||
- `local/docs/DBUS-INTEGRATION-PLAN.md`, `local/docs/QT6-WAYLAND-NULL8-DIAGNOSIS.md`,
|
||
`local/docs/INPUT-STACK-LINUX-ALIGNMENT-PLAN.md`,
|
||
`local/docs/KERNEL-IPC-CREDENTIAL-PLAN.md`, `local/docs/ACPI-IMPROVEMENT-PLAN.md`,
|
||
`local/docs/USB-IMPLEMENTATION-PLAN.md`, `local/docs/WIFI-IMPLEMENTATION-PLAN.md`,
|
||
`local/docs/BLUETOOTH-IMPLEMENTATION-PLAN.md`,
|
||
`local/docs/NETWORKING-IMPROVEMENT-PLAN.md`, `local/docs/DRIVER-MANAGER.md`,
|
||
`local/docs/INIT-NAMESPACE-MANAGER-SCALABILITY-PLAN.md`,
|
||
`local/docs/LG-GRAM-16Z90TP-COMPATIBILITY-PLAN.md`,
|
||
`local/docs/HARDWARE-NETWORKING-INVENTORY.md`,
|
||
`local/docs/HARDWARE-VALIDATION-MATRIX.md`,
|
||
`local/docs/FIREWALL-VALIDATION-LOG.md`,
|
||
`local/docs/BUILD-SYSTEM-INVARIANTS.md`, `local/docs/BUILD-CACHE-PLAN.md`,
|
||
`local/docs/PACKAGE-BUILD-QUIRKS.md`,
|
||
`local/docs/QUIRKS-SYSTEM.md`, `local/docs/QUIRKS-AUDIT.md`,
|
||
`local/docs/QUIRKS-IMPROVEMENT-PLAN.md`,
|
||
`local/docs/LOCAL-FORK-SUPREMACY-POLICY.md`,
|
||
`local/docs/PATCH-GOVERNANCE.md`, `local/docs/RELEASE-BUMP-WORKFLOW.md`,
|
||
`local/docs/SCRIPT-BEHAVIOR-MATRIX.md`, `local/docs/RATATUI-APP-PATTERNS.md`,
|
||
`local/docs/CUB-PACKAGE-MANAGER.md`, `local/docs/GRUB-INTEGRATION-PLAN.md`,
|
||
`local/docs/COLLISION-DETECTION-STATUS.md`,
|
||
`local/docs/USB-VALIDATION-RUNBOOK.md`,
|
||
`local/docs/GREETER-LOGIN-IMPLEMENTATION-PLAN.md`
|
||
- `local/docs/evidence/lg-gram/ASSESSMENT-2026-07-26.md` (active LG Gram evidence)
|
||
- `local/docs/archived/README.md`, `local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md`
|
||
(inventory / index docs; updated, not deleted)
|
||
|
||
## Summary
|
||
|
||
- **Restored:** 1 doc
|
||
- **Replaced (deleted, content absorbed):** 2 docs
|
||
- **Deleted (with backup):** 36 docs across 6 locations
|
||
- **Updated (text only):** 2 inventory docs
|
||
- **Total operations:** 41
|
||
- **Tarball size:** 386,925 bytes
|
||
- **Net effect:** 38 files removed from git's working tree; 1 file moved from
|
||
`legacy-obsolete-2026-07-25/` to top-level. The 3D-desktop subsystem is now expressible
|
||
as a single canonical doc (`3D-DESKTOP-COMPREHENSIVE-PLAN.md`) plus 35 companion plans.
|
||
|
||
## Rounds 11–14 — Source-Level Supersessions (2026-07-27)
|
||
|
||
The above consolidation was a *document* pass. Subsequent rounds fixed
|
||
lie-grade code and stale references that the consolidation had left
|
||
behind or that came up in follow-up audits. Logged here for parity
|
||
with the deletion log.
|
||
|
||
| Round | Item | Resolution commit | Note |
|
||
|-------|------|---------------------|------|
|
||
| 9 (post-doc) | `relibc` RTLD_NOLOAD\|NOW + `readdir_r` panics | `2a2d1f354c` + submodule `dff28f00` | Replaced `todo!`/`unimplemented!` with proper `Result` propagation |
|
||
| 9 (post-doc) | `redbear-iwlwifi` MAC offset ≥ 6 fake-zero packet | `c21c70912e` | Returns `Err(ERANGE)` instead |
|
||
| 9 (post-doc) | `redbear-iwlwifi` `iwl_ops_tx` empty body | `c21c70912e` | Drains `iwl_pcie_txq_reclaim` overflow queue |
|
||
| 9 (post-doc) | Mesa redox_drm_fence type-mismatch UB | `aae6c36b80` | Allocates real `pipe_fence_handle` |
|
||
| 9 (post-doc) | Mesa redox_drm_surface stale "no-op" comment | `aae6c36b80` | Rewrote to describe real `REDOX_SCANOUT_FLIP` |
|
||
| 9 (post-doc) | `redbear-dnsd` `Ok(())` lie-grade config accept | `aae6c36b80` | Bound-checked parser mutates `self.upstream` |
|
||
| 9 (post-doc) | 24 broken doc cross-references (deleted-doc paths) | `163d6f0a59` | Replaced with post-Round-9 doc map |
|
||
| 9 (post-doc) | 7 stale `pcid-spawner` references in docs | `163d6f0a59` | Rewritten to `driver-manager` |
|
||
| 9 (post-doc) | `local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` §10 pre-execution audit | `163d6f0a59` | Marked ✅ REPLACE/RESTORE/DELETE as completed |
|
||
| 10 | xwayland patch timestamp + DRM-only stubs | `d6a8159840` | Stripped `diff -ruN` timestamps, dropped DRM hunks (recipe has `-Ddrm=false`), replaced hardcoded button constants with `BTN_*` symbols |
|
||
| 10 | 5 stale `redbear-minimal` config refs | `d6a8159840` | Renamed to `redbear-mini` |
|
||
| 10 | `relibc` ld_so/dso.rs:1129/1203 panic sites | `5fac5f6edb` + submodule `90168f56` | `unimplemented!()` → `Err(format!(...))` |
|
||
| 11 | `local/recipes/system/redbear-passwd/recipe.toml` missing `[source]` | `a9e1c34e27` | Added `[source] path = "source"` |
|
||
| 11 | `local/recipes/dev/libclc/recipe.toml` no post-install verify | `a9e1c34e27` | Added 3 `test -f` checks for `libclc.pc` and `.bc` |
|
||
| 11 | `redbear-sessiond` `can_suspend/can_reboot/can_power_off` lie-grade | `a9e1c34e27` | `kstop_writable()` probes `/scheme/sys/kstop` |
|
||
| 11 | `redbear-dnsd` hardcoded 8.8.8.8/1.1.1.1 fallback | `a9e1c34e27` | Empty `Vec` — main() reads netcfg upstreams |
|
||
| 11 | 16+7 stale `redbear-kde-session` binary refs in 2 docs | `a9e1c34e27` | Renamed to `redbear-session-launch` |
|
||
| 11 | `relibc` TLSDESC misleading message | `2a0c747bc0` + submodule `688e76ca` | "riscv64 and x86" → "this target" |
|
||
| 12 | Mesa `04-sys-ioccom-stub-header.patch` | `f145e9e768` + submodule `ca7a7edb` | Moved to `relibc::include/sys/ioccom.h` (proper Linux IOC encoding). Patch removed. |
|
||
| 12 | `udev-shim` eth0 fallback collision | `6eed30f072` | `predictable_net_name` returns `net-malformed-<sanitized>` |
|
||
| 12 | `netcfg` summary hardcoded eth0 | `6eed30f072` | Iterates full devices map |
|
||
| 12 | 2 final `redbear-kde-session` refs | `6eed30f072` | Renamed to `redbear-session-launch` |
|
||
| 13 | `base::vesad` bare `panic!()` at loop exit | `c79333cd1d` + submodule `c5b32f9f` | `eprintln!` + `process::exit(0)` |
|
||
| 13 | `base::nvmed` `panic!("timeout on init")` | `c79333cd1d` + submodule `c5b32f9f` | Log + `process::exit(1)` so init can fall back |
|
||
| 13 | `base::nvmed` queue-error panics (commented out) | `c79333cd1d` + submodule `c5b32f9f` | Deleted dead commented-out panics |
|
||
| 13 | Stale `redbear-passwd` and `redbear-minimal.toml` refs in assessment doc | `e1adf3e9c8` | Struck through with ✅ RESOLVED 2026-07-27 |
|
||
| 14 | `local/recipes/system/redbear-wayland-guard/` LD_PRELOAD stub | (this commit) | **REMOVED** — violated STUB AND WORKAROUND POLICY ("No LD_PRELOAD tricks"). Correct fix lives in libwayland per `QT6-WAYLAND-NULL8-DIAGNOSIS.md`. |
|
||
| 14 | `local/recipes/system/firmware-loader` daemon 9-`.expect()` chain | (this commit) | All converted to `Result` propagation with log+exit |
|
||
| 14 | `redbear-{keymapd,ime,accessibility}` scheme daemon `.expect()` | (this commit) | Converted to `Result` propagation with `log_msg("ERROR", …)` + `process::exit(1)` |
|
||
| 14 | `local/recipes/AGENTS.md` redbear-wayland-guard entry marked "Rust" | (this commit) | Struck through — was actually a C LD_PRELOAD stub |
|
||
| 15 | `local/recipes/system/redbear-greeter/main.rs` `kill_child()` | `5682072e58` | `let _ = process.kill()/wait()` → logs kill+wait failure (zombie-child prevention) |
|
||
| 15 | `local/recipes/system/redbear-netctl/main.rs` (lines 201, 224) | `5682072e58` | `let _ = fs::remove_file()` → logs failure (stale active-profile prevention) |
|
||
| 15 | `local/recipes/system/redbear-usb-hotplugd/main.rs:254` | `5682072e58` | `let _ = child.kill()` → logs kill failure (USB-device-daemon leak prevention) |
|
||
| 15 | `local/recipes/system/redbear-acmd/main.rs:221` | `883e8147ec` | **SECURITY** — bare `let _ = setrens(0, 0)` → logs and returns on failure (privilege-boundary defense) |
|
||
| 15 | `README.md` status table null+8 contradiction | `883e8147ec` | Line 138 demoted ✅ → 🟡 with caveat about runtime re-verification pending; four lines now agree |
|
||
| 15 | `README.md` + `AGENTS.md` `redbear-live.iso` stale | `883e8147ec` | Replaced with accurate `<config>.iso` pattern (no `redbear-live` config exists) |
|
||
|
||
**Pattern emerging:** Lie-grade code in Red Bear is concentrated in
|
||
three places — (a) relibc fork panic-site catch-alls, (b) scheme daemon
|
||
init paths that use `.expect()` instead of `Result`, (c) Mesa DRM/wayland
|
||
stubbing. The first two are addressed by rounds 9–14. Mesa DRM and
|
||
Wayland null-guard work remains (EGL platform, PRIME/dma-buf, sync objects,
|
||
single-context CS, libwayland null safety) and is tracked in
|
||
`local/docs/3D-DESKTOP-COMPREHENSIVE-PLAN.md` § current state.
|
||
|
||
## Round 16 — More `let _ =` fixes + sessiond sleep-probe design (2026-07-27)
|
||
|
||
| Round | Item | Resolution commit | Note |
|
||
|-------|------|---------------------|------|
|
||
| 16 | `local/docs/SUPERSEDED-DOC-LOG.md` self-update | this entry | R15 entries appended (greeter/netctl/hotplugd let-underscore, acmd setrens security, README null+8 contradiction) |
|
||
| 16 | `local/recipes/system/redbear-sessiond/manager.rs` `can_*` for hibernate/sleep | `7a5b5963c4` | Block comment documents future-work probe design: when `/scheme/sys/sleep` lands, mirror the `kstop_writable()` pattern used by `can_power_off/can_reboot/can_suspend`. No code change yet — kernel support doesn't exist. |
|
||
| 16 | `local/recipes/system/redbear-authd/main.rs:328` child.wait | (this commit) | Replaced `let _ = child.wait()` with `match` that eprintln-logs exit status (validation-mode spawn reaper) |
|
||
| 16 | `local/recipes/system/redbear-dnsd/main.rs:111` socket.send_to | (this commit) | Replaced `let _ = socket.send_to(...)` with `if let Err(e) = ...` logging the loopback failure with `src` peer address |
|
||
|
||
### Round 16 — Audit findings with NO code changes needed
|
||
|
||
| Category | Outcome |
|
||
|----------|---------|
|
||
| **acpi-rs AML 41 bare panics** | Audit classified all 41 sites as internal-invariant (firmware table validation, field/destructure safety). Adding diagnostic strings is a one-shot pure-text edit; tracked for a future round. |
|
||
| **pcid IRQ/MSI-X panics** | All already carry diagnostic messages (`panic!("{driver}: failed to open IRQ file: {err}")`, etc.). The remaining concern is whether they should be `Result` (returns) — deferred; current panic behavior is correct for non-recoverable internal conditions. |
|
||
| **Stale CONFIG references** | All `redbear-kde`/`redbear-minimal`/`redbear-wayland-guard`/`redbear-kde-session`/`pcid-spawner` are in retired/removed context; no live stale references remain. |
|
||
| **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. |
|