snxraven/bare-operating-system
1
1
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs updates

Browse Source
This commit is contained in:
Raven Scott
2026-04-04 08:31:39 -04:00
parent 0e53351349
commit 081e4c587c
64 changed files with 2052 additions and 1273 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/feature-roadmap.md
+14
View File
@@ -2,6 +2,14 @@
This file tracks the twenty-item “kernel super-features” plan. Items are **done** when shipped in the stock booter/kernel unless noted.
## Checklist format and CI
**Wave 6** through **Wave 11** use **Markdown pipe tables** with numbered rows so `pretest` can verify checklist depth: [`scripts/verify-kernel-capabilities-word-6.mjs`](../../scripts/verify-kernel-capabilities-word-6.mjs) through [`verify-kernel-capabilities-word-11.mjs`](../../scripts/verify-kernel-capabilities-word-11.mjs) count lines matching `| N |` inside each wave block. Do not replace those tables with lists without updating the verifiers. Earlier blocks (the original twenty items and **Wave 5**) follow the same table style for readability and diff-friendly review.
---
## Original twenty super-features (completed baseline)
| # | Item | Status |
|---|------|--------|
| 1 | Feature-bit governance v2 + ADR | done — [developer-guide/adr/001-kernel-feature-bits-governance.md](../../developer-guide/adr/001-kernel-feature-bits-governance.md), bits 21–27, `BARE_OS_KERNEL_FEATURE_BITS_DOC=2` |
@@ -27,6 +35,8 @@ This file tracks the twenty-item “kernel super-features” plan. Items are **d
## Wave 5 (twenty-item super-feature plan)
Wave 5 introduces the **fifth capability word** (**`bits5` / host transport delegates**), a **seeder RPC registry** so method lists do not drift, replication queue hints, an **automated compatibility matrix** check in CI, host OS probing under **`/proc`**, subprocess bridge lifecycle v2, transport observability, stricter **boot policy**, scheduled replication windows, union **`readlink`**, kernel profile warm reload, HDMS hints v2, seed-channel error hygiene, **`man`** coverage CI, OTel schema v2, bare-worker allowlist patterns, A/B staging rollback hints, a dev **`/proc/bare_os/debug.json`**, **`ctx.bare`** risk metadata in manifests, and documentation coherence checks.
| # | Item | Status |
|---|------|--------|
| 1 | Fifth capability word (`bits5`) + ADR §8 | done — `BARE_OS_KERNEL_FEATURES_STOCK_WORD_HOST_TRANSPORT_DELEGATES`, strict seed check, `/proc` + RPC |
@@ -50,6 +60,10 @@ This file tracks the twenty-item “kernel super-features” plan. Items are **d
| 19 | `ctx.bare` risk metadata | done — manifest `tier`/`risk` examples + catalog docs |
| 20 | Documentation coherence CI | done — [`scripts/verify-doc-links.mjs`](../../scripts/verify-doc-links.mjs), pretest |
## Mega-kernel waves (6–11)
Waves **6** through **11** are **hundred-item** checklists that track the mega-kernel program: capability words, **`ctx`** API semver, boot policy revisions, seed RPC additions, **`/proc/bare_os/`** schema bumps, telemetry and audit schema versions, and Pear or Bare runtime gates. Rows stay **terse** by design; follow links in each row, [`kernel-extensions.md`](./kernel-extensions.md), and [`developer-guide/adr/001-kernel-feature-bits-governance.md`](../../developer-guide/adr/001-kernel-feature-bits-governance.md) for prose explanations.
## Wave 6 (100-item mega kernel)
| # | Item | Status |