local/docs: commit first-round audit + superseded-doc-log
The first-round assessment (NETWORKING-AND-DRIVERS-SYSTEMATIC- ASSESSMENT-2026-07-27.md) was never committed to the parent 0.3.1 branch. It captures the docs audit that preceded the code audit (now at NETWORKING-AND-DRIVERS-CODE-ASSESSMENT-2026-07-27.md). Both files live in the repo as the docs and code halves of the audit series. SUPERSEDED-DOC-LOG.md is the change-log file referenced from local/docs/legacy-obsolete-2026-07-25/SUPERSEDED.md. Previously untracked; this commit makes it visible to the doc audit trail.
This commit is contained in:
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,150 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user