# 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. |