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

feat: kernel roadmap wave — bits4, policy v4, Pear/Bare compatibility

Browse Source 
- protocol/booter: bits4 handshake, proc surfaces, boot policy v4, telemetry v4
- coreutils: nohup + ensure-man-pages; seed-man-pages fixes for extra pages
- kernel-runner: no static node:module (Pear); bare-module createRequire
- docs: handbook, reference, ADR, compatibility matrix, verify scripts
This commit is contained in:
Raven Scott
2026-04-04 02:51:33 -04:00
parent d775fb0628
commit f8a0dad897
190 changed files with 2717 additions and 1822 deletions
Download Patch File Download Diff File Expand all files Collapse all files
developer-guide/adr/001-kernel-feature-bits-governance.md
+5 -3
View File
@@ -1,4 +1,4 @@
# ADR 001: Kernel feature bit governance (v3)
# ADR 001: Kernel feature bit governance (v4)
## Status
@@ -25,7 +25,9 @@ Bare OS advertises optional booter and seed-channel capabilities as a versioned
6. **Third capability word (`bits3`, wave 3)** — **`BARE_OS_KERNEL_FEATURES_STOCK_V3`** and **`BARE_OS_FEATURE3_*`** cover rlimits proc, boot policy v3, delegate concurrency, gated shell **`local`**, host capability probe, and CI schema validation of examples. Seed JSON and **`/proc/bare_os_features`** include **`bits3`**. **`BARE_OS_SEED_CAP_STRICT`** may require **`bits3`** when the stock booter advertises a non-zero third word. Word 2 bits **19–31** (wave 3) remain on **`bits2`**; word 3 is additive and does not renumber prior assignments.
7. **Fourth capability word (`bits4`, wave 4)** — **`BARE_OS_KERNEL_FEATURES_STOCK_V4`** and **`BARE_OS_FEATURE4_*`** cover offline LKG boot, **`/proc/bare_os/net_summary.json`**, boot policy v4, telemetry schema v4, kernel extension registry schema v2, roadmap contract tests, host storage JSON in bootstrap proc, IPC audit, initd directory conditions, delegate fairness metrics, optional bare-worker **`/bin`** offload, and subprocess-bridge job surfacing. Seed JSON **`bare_os.capabilities`** and **`/proc/bare_os_features`** include **`bits4`**. **`BARE_OS_SEED_CAP_STRICT`** requires **`bits4`** to cover the stock fourth word when enabled.
## Consequences
- Seeder RPC `bare_os.capabilities` must return `protocolPackageVersion` and `featureBitsDoc` alongside `bits`, `bits2`, and `bits3` (omit zero words if desired, but stock booter sends all three today).
- CI should keep seeder and booter copies of the stock masks aligned (`BARE_OS_KERNEL_FEATURES_STOCK_V1`, **`STOCK_V2`**, **`STOCK_V3`**).
- Seeder RPC `bare_os.capabilities` must return `protocolPackageVersion` and `featureBitsDoc` alongside `bits`, `bits2`, `bits3`, and **`bits4`** (omit zero words if desired, but the stock seeder sends all four today).
- CI should keep seeder and booter copies of the stock masks aligned (`BARE_OS_KERNEL_FEATURES_STOCK_V1`, **`STOCK_V2`**, **`STOCK_V3`**, **`STOCK_V4`**).