Files

T

Raven Scott 1ff94f0b48 fix(bare-openssh): bind repl TTY streams to SSH session for edit/nano

Route replStdin, replStdout, and stdout to the SSH channel Duplex so
/bin/edit (nano) and other TUI tools use the remote terminal instead of
Pear CLI. Mark exec channels as TTY for ssh ... nano style invocations.

2026-04-08 23:35:08 -04:00

fixtures

feat(booter): POSIX/P2P roadmap — profile 1.0.14, ctx 1.50.0, docs & tests

2026-04-05 13:50:07 -04:00

lib

fix(bare-openssh): bind repl TTY streams to SSH session for edit/nano

2026-04-08 23:35:08 -04:00

scripts

Updates

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

CHANGELOG.md

AutoComplete Engine

2026-04-06 08:24:21 -04:00

CLI_PARITY.md

docs updates

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

index.js

Starting work on Implementing SSH Server Service

2026-04-08 20:02:12 -04:00

package.json

Updates

2026-04-08 22:48:55 -04:00

README.md

Tests

2026-04-08 22:28:59 -04:00

t.s

Updates

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

test.bare-smoke.js

chore(booter): complete P2P/POSIX roadmap — ctx 1.48, VFS, shell, docs

2026-04-05 12:52:06 -04:00

test.hrpc-allowlist.js

Expand bounded awk/expr/test toward Issue 7; refresh man, profile 1.0.18,

2026-04-05 23:01:54 -04:00

test.identity.js

feat(booter): harden guest vs user isolation and POSIX/P2P parity

2026-04-05 03:16:33 -04:00

test.js

Allow Multi Session SSH

2026-04-08 23:28:05 -04:00

test.socket-scm-rights.js

CI/docs: placeholder-baseline --check, seeder↔kernel sync script and docs,

2026-04-05 14:45:01 -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.

When to use: run the booter to consume the replicated image and start an interactive session (typical dev: second terminal with npm run os:booter).

Documentation: Concepts — Two drives · Booter reference · Shell completion + Fish REPL · Developer guide §2 — ctx · 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 / bare-module-manifest.data.mjs — ctx.bare host imports + optional /lib/bare/ drive bundle merge; Pear loads the manifest from generated bare-module-manifest.data.mjs (see PEAR-RUN.md, Developer guide ch.12)
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
completion-engine.js — Tab completion context (parseCompletionContext), man/PATH/VFS/proc collectors, ranking, ctx.bareOsRegisterCompleter
boot-splash.js — Centered TTY boot splash (responsive frame, bar, log); cursor hidden until prepareForKernel()
fish-readline.js — History, ghost text, Fish-style completion menu / keys
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
BARE_OS_COMPACT_MENU — 1 / true forces inline tab cycling (no dropdown menu)
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.; includes parity of bare-module-manifest.json vs bare-module-manifest.data.mjs
Root npm run verify:manifest-data — ensures JSON and .data.mjs stay in sync (runs in pretest)

Pear staging

pear.stage.include is node_modules (flat mirror of the repo root hoist under this package, via scripts/ensure-pear-node-modules.mjs) so Bare resolves node_modules/<pkg> in released bundles. Run that script from the repo root before pear run (see root README). After changing bare-module-manifest.json or running sync:bare-manifest, confirm npm run verify:manifest-data passes, then pear stage / pear release so Pear ships an up-to-date bare-module-manifest.data.mjs.

README.md

bare-os-booter

Run

Major subsystems (lib/)

Environment

Tests

Pear staging

See also