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

Add fifth feature word (STOCK_V5 / bits5) with ADR and capability docs.

Browse Source 
Protocol: canonical seed RPC registry (seed-rpc-methods.js), bits5 on
capabilities, typed seed RPC errors, richer replication_queue and
staging_slot hints.

Booter: /proc host_os (bare-module on Bare, node:os on Node), sync_window,
debug.json, net_summary transport stats, HDMS hints/correlation, warm
profile reload, subprocess bridge snapshot helpers, boot policy v5 hooks,
BARE_OS_BIN_WORKER_ALLOW pattern groups, VFS symlink/union alignment, OTel
JSONL schema version 2 in var-log.

Seeder: pass staging/replication hints into seed channel; mirror kernel
init and boot policy example.

Kernel: enforce requireFeatureBits5 / requireInitJsSha256 when configured;
selftests for new proc surfaces.

CI/pretest: verify-doc-links, verify-man-coverage, verify-compat-matrix;
extend roadmap/ctx/dts verifiers. Add otel-bare-os-jsonl schema.

Docs: Wave 5 roadmap, kernel-extensions, handbook/devguide updates;
bare-module manifest tier/risk sample; bare-libs README.
This commit is contained in:
Raven Scott
2026-04-04 04:33:25 -04:00
parent f8a0dad897
commit 268b46dd3a
60 changed files with 1607 additions and 499 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/README.md
+21 -3
View File
@@ -23,19 +23,37 @@ Exits **0** only when **`kernel/`** and **`packages/bare-os-seeder/kernel/`** co
**Usage:** `node scripts/verify-ctx-api-feature-bits.mjs`
Checks that **`packages/bare-os-booter/lib/bare-os-ctx-api.js`** documents a **`BARE_OS_CTX_API_VERSION`** that matches the contract surface (semver discipline) and that stock kernel feature words (**`STOCK_V1`** … **`STOCK_V4`**) in **`bare-os-protocol`** stay referenced from the booter (including **`bits3`** / **`bits4`** on the seed handshake). Invoked from the root **`pretest`** hook.
Checks that **`packages/bare-os-booter/lib/bare-os-ctx-api.js`** documents a **`BARE_OS_CTX_API_VERSION`** that matches the contract surface (semver discipline) and that stock kernel feature words (**`STOCK_V1`** … **`STOCK_V5`**) in **`bare-os-protocol`** stay referenced from the booter (including **`bits3`** / **`bits4`** / **`bits5`** on the seed handshake). Invoked from the root **`pretest`** hook.
## `verify-kernel-roadmap-wave3.mjs`
**Usage:** `node scripts/verify-kernel-roadmap-wave3.mjs`
Static checks for roadmap wave-4 plumbing: **`STOCK_V4`** in **`kernel-feature-bits.js`**, **`bits4`** in seed **`capabilities`**, booter **`loadOsFromOfflineLkg`**, strict **`bits4`** check, boot policy schema **`requireFeatureBits4`**, kernel **`init.js`** enforcement, and **`bare_os.kernel_info`** RPC list completeness. Root **`pretest`**.
Static checks for roadmap wave-4/5 plumbing: **`STOCK_V4`** / **`STOCK_V5`**, **`bits4`** / **`bits5`** in seed **`capabilities`**, booter **`loadOsFromOfflineLkg`**, strict checks, boot policy schema (**`requireFeatureBits4`**, **`requireFeatureBits5`**, **`requireInitJsSha256`**), kernel **`init.js`** enforcement, and **`seed-rpc-methods.js`** + **`channel.js`** wiring. Root **`pretest`**.
## `verify-ctx-dts.mjs`
**Usage:** `node scripts/verify-ctx-dts.mjs`
Ensures **`bare-os-ctx.d.ts`** lists new **`ctx`** fields (**`bareOsAdvertisedKernelBits4`**, delegate fairness, IPC audit, …) that exist in **`packages/bare-os-booter/index.js`**. Root **`pretest`**.
Ensures **`bare-os-ctx.d.ts`** lists new **`ctx`** fields (**`bareOsAdvertisedKernelBits4`**, **`bareOsAdvertisedKernelBits5`**, subprocess snapshot, profile reload, delegate fairness, IPC audit, …) that exist in **`packages/bare-os-booter/index.js`**. Root **`pretest`**.
## `verify-doc-links.mjs`
**Usage:** `node scripts/verify-doc-links.mjs`
Scans **`docs/`**, **`handbook/`**, **`developer-guide/`**, and **`scripts/*.md`** for relative **`.md`** links and fails when the target file is missing. Root **`pretest`**.
## `verify-man-coverage.mjs`
**Usage:** `node scripts/verify-man-coverage.mjs`
Asserts every Tier-1 name in **`packages/bare-os-coreutils/lib/commands.mjs`** has a matching **`name`** entry in **`kernel/share/man/man.json`**. Root **`pretest`**.
## `verify-compat-matrix.mjs`
**Usage:** `node scripts/verify-compat-matrix.mjs`
Checks **[`docs/reference/compatibility-matrix.md`](../docs/reference/compatibility-matrix.md)** lists the current **`BARE_OS_CTX_API_VERSION`** and **`BARE_OS_KERNEL_FEATURE_BITS_DOC`** and mentions **`bits5`**. Root **`pretest`**.
## `validate-example-schemas.mjs`