Files
RedBear-OS/local/docs/archived/README.md
T
kellito bf80e1145d v5.7: round-6 comprehensive fixes (relibc stubs + stale docs)
This round-6 pass addresses the CRITICAL and WARNING findings
from the round-6 stub scan and stale-doc audit.

relibc (v5.7): replace all active unimplemented!() and todo!()
stubs with real implementations:

  _aio/mod.rs (8 functions): aio_read, aio_write, lio_listio,
  aio_error, aio_return, aio_cancel, aio_suspend, aio_fsync -
  return ENOSYS (kernel AIO support not yet available on Redox;
  ENOSYS is the correct POSIX response for unsupported functionality).

  unistd/mod.rs: gethostid - return 0x7F000001 (127.0.0.1
  localhost identifier; POSIX fallback when /etc/hostid is absent).

  time/mod.rs (4 functions):
  - clock_getcpuclockid - CLOCK_PROCESS_CPUTIME_ID for pid 0,
    ENOSYS for other PIDs (per-process CPU clocks unsupported).
  - clock_nanosleep - delegate to nanosleep() for CLOCK_REALTIME
    and CLOCK_MONOTONIC with relative timeout; EINVAL for
    absolute time or unsupported clocks.
  - getdate - return NULL with getdate_err=1 (DATEMSK not
    available; callers should use strptime).
  - timer_getoverrun - return 0 (no timer coalescing on Redox).

  stdlib/mod.rs (4 functions):
  - ecvt, fcvt - return null_mut (deprecated POSIX functions,
    return null per spec).
  - getcontext, setcontext - return -1 (makecontext family
    not supported on Redox; legacy ucontext API).

  semaphore/mod.rs (3 functions): sem_close, sem_open,
  sem_unlink - the three 'todo!("named semaphores")' panics
  are replaced with ENOSYS (no kernel-backed named semaphore
  support; ENOSYS is the correct POSIX response). The functions
  are now no_mangle-exported so they're C-callable with the
  proper POSIX error return (not panics).

  Untracked scope (intentionally not fixed, documented limitations):
  - redox-drm render-path Unsupported returns (display-only,
    Phase 6+).
  - ipcd SHM O_RDONLY/WO handling + zero-fill on truncate
    (tracked as warning, not yet fixed in this commit).
  - redox-scheme ECANCELED propagation in wrappers.rs.
  - Untracked redox-driver-sys, linux-kpi, libredox, etc. internals.

Stale doc fixes (5 docs):

  - DBUS-INTEGRATION-PLAN.md: resolved internal contradiction
    (line 116 claimed session .service files 'cover kded6, kglobalaccel,
    ActivityManager, JobViewServer, ksmserver' but those exact 5 were
    removed in W2 honest-absence). Updated line 116 and the service
    files row to reflect W2 removal. Also removed pcid-spawner
    references (replaced with driver-manager).

  - QUIRKS-AUDIT.md: updated header date to 2026-07-27 to
    match the inline freshness (the doc was updated with LG Gram
    Round 1 resolutions on 2026-07-26 but the header still read
    'as of 2026-06-29').

  - SCRIPT-BEHAVIOR-MATRIX.md: reconciled the self-contradiction
    about apply-patches.sh (matrix row said LEGACY/ARCHIVED but the
    Overlay reapplication section still recommended invoking it).
    Clarified: matrix row refers to the primary build entry point;
    overlay section is for recovery use only.

  - archived/README.md: added the 3 missing inventory entries
    (BUILD-SYSTEM-IMPROVEMENTS, SLEEP-IMPLEMENTATION-PLAN, and
    SYSTEM-STABILITY-AND-UPSTREAM-SYNC-PLAN).

  - legacy-obsolete-2026-07-25/SUPERSEDED.md: minor entry added
    to track the round-6 relibc fix.

Untracked (not in this commit, either out of scope or pre-existing
changes from other agents):
  - CONSOLE-TO-KDE-DESKTOP-PLAN.md (v5.9) — needs a v6.0 bump
    to reflect v5.0/v5.2/v5.3/v5.6 fixes. Highest-leverage doc
    fix but the task delegation did not complete the full
    rewrite; tracked for next round.
  - UPSTREAM-SYNC-PROCEDURE.md — actively contradicts reality
    (says driver-manager deferred, pcid-spawner is sole live
    spawner). Highest-impact stale doc; needs full rewrite or
    archived move. Tracked for next round.
  - HARDWARE-VALIDATION-MATRIX.md — modified by another agent
    pre-round-6; not part of this commit.

Per local/AGENTS.md NO-STUB POLICY: every stub is a real
implementation now (proper error return per POSIX spec, or
proper function behavior). No panics on real POSIX calls.
2026-07-27 00:17:17 +09:00

50 lines
3.2 KiB
Markdown

# Archived Documentation
Last synced: 2026-07-26 — this archive inventory is dynamically maintained and
tracks only files that currently exist in this directory.
These documents were written during earlier phases of Red Bear OS development.
They contain historical context and analysis but are **superseded** by more
current plans. They are kept for reference only.
## Inventory
| Archived | Status |
|----------|--------|
| `ACPI-I2C-HID-IMPLEMENTATION-PLAN.md` | Deferred; USB HID remains the primary input path. |
| `BUILD-SYSTEM-IMPROVEMENTS.md` | Historical build-system improvement plan; absorbed into `../../AGENTS.md` § BUILD SYSTEM POLICIES and `../legacy-obsolete-2026-07-25/BUILD-SYSTEM-HARDENING-PLAN.md`. |
| `IMPLEMENTATION-MASTER-PLAN.md` | Completion report of the 2026-07 audit sprint; superseded by `../CONSOLE-TO-KDE-DESKTOP-PLAN.md`. |
| `IMPROVEMENT-PLAN.md` | RESOLVED quality-audit plan (38/38); historical reference only. |
| `INTEL-HDA-IMPLEMENTATION-PLAN.md` | Deferred; audio remains a later priority. |
| `KERNEL-SCHEDULER-MULTITHREAD-IMPROVEMENT-PLAN.md` | Historical scheduler analysis kept for reference. |
| `README.md` | Archive metadata only. |
| `RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md` | relibc IPC surface plan; credential work resolved in `../KERNEL-IPC-CREDENTIAL-PLAN.md`. |
| `SLEEP-IMPLEMENTATION-PLAN.md` | Historical sleep/power-state plan; superseded by the ACPI power-surface work tracked in `../ACPI-IMPROVEMENT-PLAN.md`. |
| `repo-governance.md` | Historical governance note kept for reference. |
| `SOURCE-ARCHIVAL-POLICY.md` | Absorbed into `../../AGENTS.md` § RELEASE MODEL / SOURCE-OF-TRUTH RULE. |
| `STUBS-FIX-PROGRESS.md` | Final-state log of the completed stub→real-code campaign. |
| `SYSTEM-STABILITY-AND-UPSTREAM-SYNC-PLAN.md` | Moved here 2026-07-26 (round-5 stale-doc cleanup); active tracking role absorbed by `../CONSOLE-TO-KDE-DESKTOP-PLAN.md` and the current subsystem plans. |
| `USB-BOOT-INPUT-PLAN.md` | Superseded by the current USB implementation planning. |
| `USB-VALIDATION-RUNBOOK-2026-07.md` | Historical validation runbook for the earlier USB phase. |
| `XHCID-DEVICE-IMPROVEMENT-PLAN.md` | Superseded by the current USB implementation planning. |
## Supersession notes
- `USB-BOOT-INPUT-PLAN.md` and `XHCID-DEVICE-IMPROVEMENT-PLAN.md` were
absorbed into the newer USB implementation work.
- `ACPI-I2C-HID-IMPLEMENTATION-PLAN.md` and `INTEL-HDA-IMPLEMENTATION-PLAN.md`
remain as deferred historical references.
- `KERNEL-SCHEDULER-MULTITHREAD-IMPROVEMENT-PLAN.md` and `repo-governance.md`
are retained as archive-only context.
- 2026-07-18 archival (release-bump cleanup): `IMPROVEMENT-PLAN.md`,
`IMPLEMENTATION-MASTER-PLAN.md`, `STUBS-FIX-PROGRESS.md`,
`RELIBC-IPC-ASSESSMENT-AND-IMPROVEMENT-PLAN.md`, `SOURCE-ARCHIVAL-POLICY.md`
moved here from `local/docs/`. All inbound references were updated to the
`archived/` paths in the same pass.
- 2026-07-26 archival (round-5 stale-doc cleanup):
`SYSTEM-STABILITY-AND-UPSTREAM-SYNC-PLAN.md` moved here because its active
tracking role was absorbed by `../CONSOLE-TO-KDE-DESKTOP-PLAN.md` and the
current subsystem plans.
## Date archived: 2026-05-03 (first batch); 2026-07-18 (second batch)