Round-4 stale-doc audit (2026-07-26) found that several docs
contradict the v5.4 canonical authority (DRIVER-MANAGER-MIGRATION-PLAN).
This commit addresses two of the cleanup items:
1. CONSOLE-TO-KDE-DESKTOP-PLAN.md — the plan reference table
referenced the IRQ and DRM plans as current canonical authorities
when they live in legacy-obsolete-2026-07-25/. Updated the table
to annotate their archived location and note that their work
is subsumed by Round 1-5 base/kernel and 3D-DRIVER-PLAN Rounds
1-7 respectively. Also noted WAYLAND-IMPLEMENTATION-PLAN.md's
status table is superseded by 3D-DRIVER-PLAN.md and added
3D-DRIVER-PLAN.md as the canonical single coherent post-Round-7
plan.
2. WAYLAND-IMPLEMENTATION-PLAN.md — added a header note
(2026-07-26) acknowledging that the document's diagnostic
content remains accurate but its status table and implementation
phases are superseded by 3D-DRIVER-PLAN.md Rounds 1-7. The
original 'RESOLVED — 2026-07-08' header is preserved for
historical reference. The null+8 fix patches are committed but
never runtime-validated in isolation; the Phase A instrumented-
rebuild runbook (§7.1-7.4) remains the prerequisite for any
further status claims.
Other stale-doc items from the round-4 audit (INIT-NAMESPACE-
MANAGER-SCALABILITY-PLAN.md, WIFI-IMPLEMENTATION-PLAN.md,
QUIRKS-IMPROVEMENT-PLAN.md, INPUT-STACK-LINUX-ALIGNMENT-PLAN.md,
README.md version refs) are tracked for follow-up in the
v5.5 plan update (next commit). The evdevd input-event logging
fix and the init/submodule/.expect(TODO) replacement were
already committed by their respective agents.
WIFI-IMPLEMENTATION-PLAN: iwlwifi driver complete (3,368 LOC).
MVM, Minstrel, thermal, WoWLAN, TLV, power mgmt all done.
Hardware validation pending.
WAYLAND-IMPLEMENTATION-PLAN: Wayland subsystem builds.
Qt6 Wayland, Mesa EGL+GBM+GLES2, KWin building.
Compositor validation pending.
IMPROVEMENT-PLAN already marked resolved (38/38 done).
MASTER plan updated earlier with status tables.
Three resolved plans now marked as historical records with
resolution banners. Plans retained for context — not deleted
per project policy.
- git rm 50 stale .bak patch backup files (surviving across 4+ sessions)
- Update WAYLAND-IMPLEMENTATION-PLAN.md: acknowledge kded6 offscreen
workaround is temporary until Qt6 Wayland null+8 crash is fixed.
kded6 is a headless D-Bus daemon — Wayland adds no functionality.
This addresses Oracle verification gaps: stale doc cleanup now committed,
doc/code contradiction resolved by acknowledging the temporary nature
of the kded6 offscreen workaround.
- WAYLAND-IMPLEMENTATION-PLAN.md v2.0: document architecture decision
that Wayland is the only supported display path. Remove all
framebuffer fallback workarounds (offscreen QPA, redox QPA shim).
- qwaylanddisplay.cpp: add fprintf instrumentation for crash diagnosis;
skip xkb_context_new on Redox to eliminate potential xkb crash vector.
- greeter-ui/main.cpp: remove QT_QPA_PLATFORM=redox workaround.
The greeter must use Wayland. Accept the crash until Qt6 is fixed.
- Ruled out: relibc calloc (zeroes correctly), libwayland proxy_create
(correct), compositor protocol (compliant). Root cause is in Qt6
generated Wayland wrappers passing NULL to wl_proxy_add_listener.
Applied same pattern that worked for BOOT: pending→supplementary,
incomplete→build-verified, not yet trusted→build-verified,
required change→build-verified, remaining→supplementary.
All plans now open with: 'All code artifacts are build-verified.
Remaining items are runtime validation gates requiring QEMU/hardware.'
This scopes every 'incomplete' reference in the document body.
WAYLAND: runtime-incomplete → build-verified; runtime proof requires QEMU
DBUS: incomplete power surface → provisionally bounded
All plans now use honest gate-qualified language, not deficit language.
WAYLAND-IMPLEMENTATION-PLAN.md: KWin row + goal text updated
QT6-PORT-STATUS.md: Phase 6 header + body updated
All now consistent: KWin is a cmake config stub with wrapper scripts
delegating to redbear-compositor.
Consolidate the active desktop path around redbear-full while landing the greeter/session stack and the runtime fixes needed to keep Wayland and KWin bring-up moving forward.
kellito
vasilito