Files

T

Raven Scott 15209b4837 feat(booter): hrpc allowlist parser, snapshot hints parity, shell pipefix, safer mv staging

- Add bare-os-hrpc-allowlist.js; wire stock bareOsHrpcRequest + bareOsHrpcAllowlistProbe;
  passthrough BARE_OS_HRPC_ALLOWLIST_JSON and operator env for snapshot/blind-relay/mirror/pear-doctor
- Merge BARE_OS_CORESTORE_SNAPSHOT_WORKFLOW_JSON into bareOsReadSnapshotHintsJson (match proc)
- Shell: pipefail runs all pipeline stages; aggregate first non-zero exit after assign prefixes
- mv: stage renames via vfs.resolveLogical so temp files stay in writable destination dir
- coreutils: POSIX-style split suffixes past zz; xargs doc for -P vs host subprocess
- identity-session: stable Error.code for no-account / passphrase failures
- Docs: KERNEL_CONTRACT, POSIX profile, handbook 5/7/9, kernel-extensions strict-boot table,
  env appendix, developer-guide + scripts README, protocol/booter CHANGELOGs; hrpc allowlist schema
- Tests: hrpc allowlist, pear_doctor schema 2, split suffix, pipefail pipeline; fix PLACEHOLDER_BASELINE link

Pretest: refreshed kernel bins, man.json, posix dashboard, bundle health, seeder parity

2026-04-05 01:31:03 -04:00

lib

Implement the 20-track POSIX + P2P roadmap: booter, protocol, coreutils, docs,

2026-04-05 01:06:59 -04:00

CHANGELOG.md

feat(booter): hrpc allowlist parser, snapshot hints parity, shell pipefix, safer mv staging

2026-04-05 01:31:03 -04:00

constants.js

POSIX / synthetic syscalls

2026-04-05 00:45:17 -04:00

index.js

POSIX / synthetic syscalls

2026-04-05 00:45:17 -04:00

package.json

Complete the internal “100 task” roadmap: coreutils and shell parity (xargs,

2026-04-04 21:23:49 -04:00

README.md

docs updates

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

test.js

POSIX / synthetic syscalls

2026-04-05 00:45:17 -04:00

README.md

bare-os-protocol

Shared wire format and constants for the Bare operating system monorepo: Hyperswarm topic, 512-byte MBR layout, and Protomux bare-os-v1 seed-channel message shapes.

Documentation: Protocol reference · Kernel extensions · Handbook ch.3.

What it provides

PROTOCOL_NAME, TOPIC_STRING — Protomux channel name and swarm topic input string (bare-os-v1)
topicKey() — 32-byte topic for swarm.join()
BLOCK_SIZE, MBR_MAGIC — 512-byte MBR, magic BIOS at offset 0
buildMbr / parseMbr — Pack/unpack primary + optional failover Hyperdrive keys
setupSeedChannel — Wire Protomux messages 0–6 for RAM block reads, gossip bitfield, manifest path search, RPC (incl. bare_os.capabilities with bits … bits11 when non-zero, typed errors for unknown RPC methods, bare_os.replication_status, bare_os.replication_queue, extended RPC short names in seed-rpc-methods.js, bare_os.gossip), and drive.replicate

Subpath exports: bare-os-protocol/constants.js, bare-os-protocol/messages (compact-encoding schemas), bare-os-protocol/kernel-feature-bits.js (documented booter capability words BARE_OS_KERNEL_FEATURES_STOCK_WORD_*; BARE_OS_KERNEL_FEATURE_BITS_DOC=14; surfaced in /proc/bare_os_features and /proc/bare_os/), bare-os-protocol/lib/seed-rpc-methods.js (authoritative bare_os.* RPC name list for kernel_info), bare-os-protocol/protocol-meta.js (BARE_OS_PROTOCOL_PACKAGE_VERSION for the seed handshake).

Consumers

bare-os-seeder — builds MBR, serves block 0 over the channel, replicates the system Hyperdrive.
bare-os-booter — parses MBR from SwarmDisk, opens system drives, uses the same channel on the client side.

Tests

npm test -w bare-os-protocol

Runs brittle-bare against test.js (topic stability, MBR roundtrip, encodings).

Dependencies

b4a, compact-encoding, hypercore-crypto (via constants/topic). No Hyperdrive or Hyperswarm here — this package stays small and testable.

README.md Unescape Escape

bare-os-protocol

What it provides

Consumers

Tests

Dependencies

See also

README.md