Files
RedBear-OS/local/docs/SUPERSEDED-DOC-LOG.md
T
vasilito 8fbc113d9f round 14: remove LD_PRELOAD stub + firmware-loader + scheme daemons expect chains + SUPERSEDED-DOC-LOG R11-14
Round 14 audit cleanup. Six coordinated fixes across seven files
plus a documentation log update:

1. local/recipes/system/redbear-wayland-guard/ — REMOVED entirely.
   The directory contained only source/wayland_guard.c — an LD_PRELOAD
   interposer stub for three wl_proxy_* functions — with NO recipe.toml.
   This violated local/AGENTS.md STUB AND WORKAROUND POLICY ('No LD_PRELOAD
   tricks'). The correct null-guard fix lives in libwayland upstream per
   QT6-WAYLAND-NULL8-DIAGNOSIS.md (already covered by Mesa win compat).

2. recipes/system/redbear-wayland-guard — broken symlink cleaned up.

3. local/recipes/AGENTS.md — catalog entry for redbear-wayland-guard was
   wrong (claimed 'Rust' but the code was C LD_PRELOAD). Replaced with
   REMOVED note explaining the policy violation and the correct fix
   location in libwayland.

4. local/recipes/system/firmware-loader/source/src/main.rs — converted
   9 .expect() calls in the daemon init path (Socket::create, scheme_root,
   create_this_scheme_fd, syscall::call_wo notify, setrens, next_request,
   write_response) to Result propagation. get_init_notify_fd() and
   notify_scheme_ready() now return Result; run_daemon() returns Result and
   main() matches on Err to log+exit(1) cleanly. The daemon was
   crashing the entire firmware-delivery subsystem on any init failure;
   now init can fall back or restart the daemon.

5. local/recipes/system/{redbear-keymapd,redbear-ime,redbear-accessibility}/
   source/src/main.rs — three scheme daemons used the same
   Socket::create().expect() + register_sync_scheme().expect() pattern.
   Replaced all six .expect() calls with match expressions that
   log_msg('ERROR', ...) and process::exit(1). Same pattern.

6. local/docs/NETWORKING-AND-DRIVERS-SYSTEMATIC-ASSESSMENT-2026-07-27.md —
   struck through 5 references to the now-removed redbear-wayland-guard
   (line 65 missing-daemons list, line 344 table row, line 397
   implementation list, line 414 source-list, line 797 P3-8 backlog).

7. local/docs/SUPERSEDED-DOC-LOG.md — appended a 'Rounds 11-14 Source-Level
   Supersessions' table logging every lie-grade fix and stale-doc
   strike from this session. Mirrors the original deletion-log style for
   consistency, and gives operators a single place to see what was
   resolved and where. Documents the emerging pattern: lie-grade code in
   Red Bear concentrates in (a) relibc panic-site catch-alls (addressed
   rounds 9-10), (b) scheme daemon init paths using .expect() instead of
   Result (rounds 11-14), (c) Mesa DRM/Wayland stubbing (rounds 12;
   remaining work tracked in 3D-DESKTOP-COMPREHENSIVE-PLAN.md).

Not committed in this commit (operator's parallel work, to be
committed by them):
- driver-manager/* (N-tier edits)
- redbear-sessiond/manager.rs (can_* probe refinements)
- redbear-statusnotifierwatcher/* (recipe + source)
- redbear-dbus-services/* (dbus service cleanup)
- redox-driver-core/manager.rs (test-only)
- Mesa redox_drm_cs.c (CS submit fix)

7 files changed in this commit + 2 deletions.
2026-07-27 21:27:39 +09:00

199 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 1114 — 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 |
**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 914. 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.