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

MD Formatting fixes

Browse Source
This commit is contained in:
Raven Scott
2026-04-25 23:02:07 -04:00
parent 51b3b97bc0
commit b07bc38708
154 changed files with 2459 additions and 2457 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/architecture-data-flow.md
+2 -2
View File
@@ -24,11 +24,11 @@ sequenceDiagram
Booter->>Booter: AsyncFunction start ctx from init.js
```
After replication, the booter records **`vfs`** → **`ctx`** → **`repl`** → **`initd`** → **`kernel_invoke`** (see [`KERNEL_CONTRACT`](../architecture/KERNEL_CONTRACT.md)) before the stock **`start(ctx)`** loop opens the interactive shell unless **`BARE_OS_SKIP_REPL`** applies.
After replication, the booter records **`vfs**` → `**ctx**` → `**repl**` → `**initd**` → `**kernel_invoke`** (see [`KERNEL_CONTRACT`](../architecture/KERNEL_CONTRACT.md)) before the stock **`start(ctx)**` loop opens the interactive shell unless `**BARE_OS_SKIP_REPL`** applies.
### Swarm `disk.os` bridge (post-`initd`)
[`createBareOsDiskOsBridge`](../../packages/bare-os-booter/lib/bare-os-disk-os-bridge.js) is assigned to **`disk.os`**. **`bare_os.replication_operator_sketch`** includes **`corestoreSnapshotPackageRef`** (schema **1** object) pointing operators at the upstream **`corestore-snapshot`** module and the env pair **`BARE_OS_CORESTORE_SNAPSHOT_JSON`** / **`BARE_OS_CORESTORE_STATS_JSON`** used by **`corestoreSnapshotUxHint`**. Peer **`searchLocal`** aggregates path substring matches from the **system** Hyperdrive and every **`SwarmDisk.auxiliaryDrives`** entry (read-only mirrors under **`/mirror/aux*`**), dedupes, and caps results. The system drive may ship **`/etc/bare-os/path-manifest.json`** (or **`BARE_OS_DISK_OS_PATH_MANIFEST`**) so common paths match **without** a full recursive **`list()`** on the primary drive; **`BARE_OS_DISK_OS_SEARCH_MANIFEST_ONLY`** skips primary listing when a complete manifest is maintained. Optional host env **`BARE_OS_DISK_OS_SEARCH_THROTTLE_MS`** (0–500) yields between **auxiliary** drive scans. Whitelisted RPC **`bare_os.disk_os_hints`** (**schema 3**) exposes advisory **`mirrorDriveHintV2`**, **`httpDhtProxyHint`**, and **`pathSearchLocal`** metrics — operators only; guests do not auto-apply mirror hints. Stock **`ctx.bareOsHrpcRequest`** includes **`bare_os.search_local`** (**`payload.query`**) returning **`paths`** from **`disk.os.searchLocal`**. **`bare_os.replication_operator_sketch`** returns **schema 7** JSON (seed replication status, **`swarmPeerCount`**, Hyperswarm **`connectionBudget`**, protomux operator sketch, **`pkgIndexSurface`**, **`corestoreSnapshotUxHint`**, pause/backpressure env mirrors, optional **`hyperblobsDedupSketch`** / **`corestoreOperatorSketch`** / **`peerPrioritySketch`**). **`bare_os.pkg_index_get`** reads the static drive manifest (**`BARE_OS_PKG_INDEX_PATH`**). **`bare_os.replication_operator_intent`** appends an audit row when **`BARE_OS_DISK_OS_OPERATOR_INTENT_RPC=1`** and the booter wires **`auditBatch`**.
[`createBareOsDiskOsBridge`](../../packages/bare-os-booter/lib/bare-os-disk-os-bridge.js) is assigned to **`disk.os**`. `**bare_os.replication_operator_sketch**` includes `**corestoreSnapshotPackageRef**` (schema **1** object) pointing operators at the upstream `**corestore-snapshot**` module and the env pair `**BARE_OS_CORESTORE_SNAPSHOT_JSON**` / `**BARE_OS_CORESTORE_STATS_JSON**` used by `**corestoreSnapshotUxHint**`. Peer `**searchLocal**` aggregates path substring matches from the **system** Hyperdrive and every `**SwarmDisk.auxiliaryDrives**` entry (read-only mirrors under `**/mirror/aux***`), dedupes, and caps results. The system drive may ship `**/etc/bare-os/path-manifest.json**` (or `**BARE_OS_DISK_OS_PATH_MANIFEST**`) so common paths match **without** a full recursive `**list()**` on the primary drive; `**BARE_OS_DISK_OS_SEARCH_MANIFEST_ONLY**` skips primary listing when a complete manifest is maintained. Optional host env `**BARE_OS_DISK_OS_SEARCH_THROTTLE_MS**` (0–500) yields between **auxiliary** drive scans. Whitelisted RPC `**bare_os.disk_os_hints**` (**schema 3**) exposes advisory `**mirrorDriveHintV2**`, `**httpDhtProxyHint**`, and `**pathSearchLocal**` metrics — operators only; guests do not auto-apply mirror hints. Stock `**ctx.bareOsHrpcRequest**` includes `**bare_os.search_local**` (`**payload.query**`) returning `**paths**` from `**disk.os.searchLocal**`. `**bare_os.replication_operator_sketch**` returns **schema 7** JSON (seed replication status, `**swarmPeerCount**`, Hyperswarm `**connectionBudget**`, protomux operator sketch, `**pkgIndexSurface**`, `**corestoreSnapshotUxHint**`, pause/backpressure env mirrors, optional `**hyperblobsDedupSketch**` / `**corestoreOperatorSketch**` / `**peerPrioritySketch**`). `**bare_os.pkg_index_get**` reads the static drive manifest (`**BARE_OS_PKG_INDEX_PATH**`). `**bare_os.replication_operator_intent**` appends an audit row when `**BARE_OS_DISK_OS_OPERATOR_INTENT_RPC=1**` and the booter wires `**auditBatch`**.
```mermaid
flowchart TB