Updates to MD

This commit is contained in:
Raven Scott
2026-04-25 23:18:44 -04:00
parent 0e3e5be329
commit d9d9f6ddb9
93 changed files with 368 additions and 370 deletions
+1 -1
View File
@@ -12,7 +12,7 @@ The guest runs in a single JS address space but talks to peers and optional host
- **Seed RPC** — Only methods registered in `packages/bare-os-protocol/lib/seed-rpc-methods.js` answer on the seeder wire; unknown names return **`bare_os.rpc_unknown_method`** (policy may add **`denySeedRpcMethods`**).
- **HRPC** — `ctx.bareOsHrpcRequest` serves a **fixed stock route table**; unlisted **`service.method`** throws unless the host replaces the hook or **`BARE_OS_HRPC_EMIT_UNLISTED`** is enabled for audit-only emission.
- **disk.os `execRpc**` — After initd, only allowlisted **`bare_os.*`** methods (same JSON as proc-facing helpers where documented).
- **disk.os `execRpc**` — After initd, only allowlisted `**bare_os.*`** methods (same JSON as proc-facing helpers where documented).
- **Code anchors** — `packages/bare-os-protocol/lib/channel.js`, `packages/bare-os-protocol/lib/seed-rpc-methods.js`, `packages/bare-os-booter/index.js` (`ctx.bareOsHrpcRequest`, disk.os bridge).
## Consequences
+1 -1
View File
@@ -10,7 +10,7 @@ Extensions load from the system image but affect session behavior. P2P updates c
## Decision
- **Ordering** — Topological sort with **`requires` / `after` / `before**`; cycles and hard conflicts abort strict boot with structured **`kernelExt.*`** signals.
- **Ordering** — Topological sort with **`requires` / `after` / `before**`; cycles and hard conflicts abort strict boot with structured `**kernelExt.*`** signals.
- **`provides`** — Optional **`{ name, version }[]`**; semver strings are validated; duplicate logical names with incompatible versions are **`providesConflict`** / resolution JSON.
- **Pins** — Boot policy **extension signer pins** run immediately before each extension script when configured (`verifyKernelExtSignerPinsForScript`).
- **Pear multisig** — Optional gate on **`/etc/bare-os/pear.multisig.json`** before running extensions when enabled.
+1 -1
View File
@@ -10,7 +10,7 @@ Debugging mixes **guest-visible** output (REPL, kernel phases) with **host-only*
## Decision
- **Guest** — **`ctx.console`** for user-facing lines; synthetic **`/proc`**, **`/sys`**, **`/run`**, **`/dev`** for introspection; **`/proc/bare_os/*.json`** for structured caps and posture (schemas versioned in source).
- **Guest** — **`ctx.console`** for user-facing lines; synthetic **`/proc`**, **`/sys`**, **`/run`**, **`/dev`** for introspection; `**/proc/bare_os/*.json`** for structured caps and posture (schemas versioned in source).
- **Host booter** — Structured helpers in **`packages/bare-os-booter/lib/bare-os-host-booter-log.js`**; optional NDJSON via **`BARE_OS_HOST_BOOTER_LOG`** (see environment appendix).
- **Seeder** — **`packages/bare-os-seeder/lib/host-logger.mjs`** (`seedLog`) instead of ad hoc **`console.*`** for operational messages.
- **Code anchors** — `packages/bare-os-booter/lib/bare-os-host-booter-log.js`, `packages/bare-os-seeder/lib/host-logger.mjs`, `handbook/04-the-booter-runtime.md`.