Files

T

Raven Scott 0d7b27bea8 feat(booter): OpenMetrics proc export, protomux wire JSON, audit batch API, and doc sync

Expose /proc/bare_os/metrics.prom (kernel counter OpenMetrics) and
/proc/bare_os/protomux.json (alias registry snapshot). Extend VFS routing,
readdir, pseudo watch, and bare_os_proc_index to schema 8; restore flat
/proc entries for syscalls and process_table with sort order matching
tests. Add ctx.bareOsAuditLogAppendBatch and bump BARE_OS_CTX_API_VERSION
to 1.30.0 with d.ts and compatibility-matrix updates.
Harden swarm peer ban backoff with jitter on the exponential window.
Refresh conformance matrix, environment appendix, booter package doc, and
handbook chapters for proc paths, param expansion V3, vault at rest, and
baretop snapshot keys. Align baretop-snapshot with bareOsReadBareTopSnapshot.

2026-04-04 19:23:06 -04:00

lib

feat(booter): OpenMetrics proc export, protomux wire JSON, audit batch API, and doc sync

2026-04-04 19:23:06 -04:00

scripts

Updates

2026-04-04 18:41:34 -04:00

CHANGELOG.md

feat(booter): disk.os bridge, systemctl ctx API, delegates, and docs

2026-04-04 18:09:08 -04:00

CLI_PARITY.md

docs updates

2026-04-04 08:31:39 -04:00

index.js

feat(booter): OpenMetrics proc export, protomux wire JSON, audit batch API, and doc sync

2026-04-04 19:23:06 -04:00

package.json

Updates

2026-04-04 18:41:34 -04:00

README.md

Update Boot Loader

2026-04-04 18:20:56 -04:00

t.s

Updates

2026-04-03 16:29:27 -04:00

test.identity.js

Update

2026-04-03 02:49:18 -04:00

test.js

feat(booter): OpenMetrics proc export, protomux wire JSON, audit batch API, and doc sync

2026-04-04 19:23:06 -04:00

test.txt

Updates

2026-04-03 16:29:27 -04:00

text.txt

Updates

2026-04-03 16:29:27 -04:00

w.t

Updates

2026-04-03 16:29:27 -04:00

README.md

bare-os-booter

Pear / Bare application that boots from the network only: joins the same Hyperswarm topic as the seeder, reads MBR block 0 from peers, opens the system Hyperdrive (and a personal namespaced drive), replicates, then runs /boot/init.js with a rich ctx (VFS, shell, identity, HDMS, initd services).

There is no local seed fallback — a running seeder (or another peer with the image) must be reachable within BARE_OS_BOOT_TIMEOUT_MS.

Documentation: User manual (run and operate) · Handbook (architecture) · Developer guide (extend ctx and /bin) · Booter reference (paths and env appendix pointers) · CHANGELOG (bareOsCtxApiVersion).

Run

# repo root (links node_modules for Pear)
npm run os:booter

Or:

cd packages/bare-os-booter
node index.js

Major subsystems (lib/)

index.js — Swarm, SwarmDisk, boot timeout, executeKernel, ctx assembly, boot/audit/env passthrough; bareOsReadBareTopSnapshot batches /proc/bare_os/* reads for baretop
swarm-disk.js — Peer mux, MBR/read RPC, replication hooks
kernel-runner.js — runKernelFromSource, runBinCommand, resolveBinInPath (PATH on system drive); git / curl / wget delegates
vfs.js — Two-drive routing; mkdir/rmdir (.bareos_empty), chmod, symlink, pseudo /proc//sys, watch, …
shell.js — Tokenize, pipelines, redirections, builtins (barerc, unset, readonly, umask, command, type, …), execShellLine, loadBarerc; default aliases include nano → edit (TTY editor), top → baretop and btop → baretop (session monitor)
bare-os-theme-presets.js — Named themes (BARE_OS_THEME), applyBareOsThemeFromEnv, BARE_OS_COLOR_DEPTH downgrades for REPL colors
bare-os-ipc.js — FIFOs, JSON-RPC (pushJson/takeJson, token + line limits), fan-out pub/sub, stats
bare-os-abort.js — raceWithAbortAndTimeout for execLine / readLine / VFS / runBinCommand
bare-os-http-policy.js — Optional HTTP allow/deny lists for wrapped ctx.httpFetch
bare-os-ctx-api.js / bare-os-ctx.d.ts — Semantic version of the ctx contract + optional TypeScript shapes
bare-os-runtime-caps.js — Frozen caps: pipeline limits, quotas, pseudo paths, features flags
bare-os-ctx-bare.js / bare-module-manifest.json — ctx.bare host imports + optional /lib/bare/ drive bundle merge
identity-session.js / identity-account.js — Guest vs unlocked user, /.bare/account, vault
hdms-manager.js — Extra Hyperdrives, mounts under /mnt, Autopass pair/invite
bare-initd.js — Service registry, unit drop-ins, units.d fragments, socket-activation, IdleSec= idle stop, ConditionPathExists= / AssertPathExists=, ReadinessPath / exec: polling, DAG snapshot /proc/bare_os/initd_graph.json, mobile suspend/resume order, startBareInitd, kernel-logger
bare-cron.js — /etc/bare-os/crontab, ~/.crontab, ~/.config/bare-os/timers/*.timer (OnCalendar=, EveryMs=, OnInactiveSec= / Persistent=), minute scheduler, ctx.execLine jobs
bare-os-delegate-concurrent.js — Optional in-flight caps (BARE_OS_DELEGATE_MAX_CONCURRENT, per-kind BARE_OS_DELEGATE_*_MAX_CONCURRENT) around host delegates
repl-session.js — Fish-style TTY line editor, synced console, cleanup → stopBareInitd
boot-splash.js — Centered TTY boot splash (responsive frame, bar, log); cursor hidden until prepareForKernel()
fish-readline.js — History, completion helpers
cli-readline.js, resolve-stdio.js, debug-repl.js — Stdio and debug tooling
paths.js — Pear-safe package root and Corestore path
bare-os-pear-ipc-registry.js — Well-known Pear IPC channel names; JSON at /proc/bare_os/pear_ipc.json

Environment

BARE_OS_HOST_DATA — Base directory for host state (default ~/.bare-os)
BARE_OS_BOOT_STORE — Corestore directory (default ~/.bare-os/corestore/booter)
BARE_OS_LOCAL_SEED — Overrides defaultLocalSeedCorestorePath (booter does not local-boot)
BARE_OS_BOOT_TIMEOUT_MS — Total time to find peers + load kernel (default 60000)
BARE_OS_NO_SPLASH — Disable TTY splash
BARE_OS_SKIP_REPL — Non-interactive kernel (readLine → null)
BARE_OS_FISH — Set 0 to disable fish-style editor
HYPERSWARM_BOOTSTRAP — Optional comma-separated bootstrap nodes (HDMS / replication)

Copied from host into the guest session when set (non-exhaustive; see environment variables reference and CHANGELOG.md): BARE_OS_PIPELINE_MAX_STAGES, BARE_OS_PIPELINE_MAX_BYTES, BARE_OS_PIPELINE_MAX_LINES, BARE_OS_SHELL_PARAM_EXPANSION, BARE_OS_BOOT_PROFILE, BARE_OS_ONBOOT, BARE_OS_BOOT_STRICT, BARE_OS_RC_D_SKIP, BARE_OS_BOOT_MINIMAL, BARE_OS_BOOT_SKIP, BARE_OS_BOOT_TRACE, BARE_OS_KERNEL_SELFTEST, BARE_OS_SELFTEST_FORMAT, BARE_OS_AUDIT, BARE_OS_AUDIT_JSON, BARE_OS_AUDIT_REDACT, BARE_OS_BOOT_ALLOWLIST, BARE_OS_EXEC_MAX_DEPTH, BARE_OS_EXEC_LINE_BUDGET_MS, BARE_OS_IPC_MAX_BYTES, BARE_OS_IPC_RPC_TOKEN, BARE_OS_IPC_FANOUT, BARE_OS_IPC_JSON_MAX_BYTES, BARE_OS_HTTP_ALLOWLIST, BARE_OS_HTTP_DENYLIST, BARE_OS_TLS_PIN_SHA256, BARE_OS_VFS_WATCH, BARE_OS_IMAGE_DIGEST, BARE_OS_TELEMETRY_NDJSON, BARE_OS_TELEMETRY_OTEL_JSONL, BARE_OS_PROC_POLL_MS, BARE_OS_DELEGATE_MAX_PER_MIN, BARE_OS_DELEGATE_AUDIT_ONLY, BARE_OS_PEAR_CHANNEL, BARE_OS_PEAR_RELEASE, BARE_OS_BARE_MODULES, BARE_OS_BARE_DRIVE_BUNDLES, TERM, COLORTERM, PEAR_CHANNEL.

Tests

npm test -w bare-os-booter

brittle-bare test.identity.js — crypto account codec (Bare)
brittle-node test.js — Hyperdrive, VFS, shell, kernel runner, cron matchers, etc.

Pear staging

pear.stage includes hoisted ../../node_modules. Run scripts/ensure-pear-node-modules.mjs from the repo root before pear run so the app package sees symlinked deps (see root README).

README.md

bare-os-booter

Run

Major subsystems (lib/)

Environment

Tests

Pear staging

See also