snxraven/bare-operating-system
1
1
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
04b3a96dfb32d3a2e082aa8e9827146a5666df1a
bare-operating-system/packages/bare-os-booter/lib
T
History
Raven Scott e2b721d19f complete shell 100-item plan across parser, execution, security, and docs 
Implement the full BareOS shell roadmap end-to-end, including grammar/tokenization
diagnostics, expansion/runtime hardening, execution graph tooling, builtins/job-control
stability, policy/sandbox controls, and release/traceability documentation updates.

- Add shell grammar baseline and diagnostics primitives:
  - introduce `docs/reference/shell-grammar.md` with lexer modes and EBNF contract
  - add rich diagnostic tokenizer output (mode + span metadata) via `tokenizeBareShellLineDetailed`
  - export structured parse snapshot helpers (`bareOsShellAstSnapshot`) and shell error kinds
  - add determinism coverage for tokenizer and AST snapshot outputs

- Harden expansion semantics and guardrails:
  - enforce expansion byte budgets (`BARE_OS_SHELL_EXPANSION_MAX_BYTES`)
  - add expansion trace hooks (`BARE_OS_SHELL_EXPANSION_TRACE`) with stage-level rows
  - add expansion recursion depth limits (`BARE_OS_SHELL_EXPANSION_MAX_DEPTH`)
  - tighten POSIX-mode arithmetic invalid-token diagnostics
  - preserve declared expansion ordering and document it in code/docs

- Extend redirection/pipeline execution model:
  - add normalized redirection planner (`planShellRedirections`) independent of side effects
  - add execution graph builder/debug surface (`buildShellExecutionGraph`)
  - support `<<-` operator in tokenizer/parser paths
  - add pipeline stage timeout safety (`BARE_OS_SHELL_PIPELINE_STAGE_TIMEOUT_MS`)
  - keep pipefail/pipestatus behavior verified with integration tests

- Improve builtins and control-flow reliability:
  - expand `read` builtin support:
    - `-r` raw mode
    - `-d` single-char delimiter
    - `-t` timeout semantics
  - refine wait/jobs semantics:
    - stable `jobs -l` parseable format expectations
    - synthetic pid mapping (`wait 410x`) and `wait all` support
  - keep trap registration/listing behavior deterministic and test-covered
  - add trap signal dispatch helper (`dispatchShellTrapSignal`) with normalization

- Add security and policy enforcement hooks:
  - command deny/allow policy gates:
    - `BARE_OS_SHELL_DENY_COMMANDS`
    - `BARE_OS_SHELL_ALLOW_COMMANDS`
  - sandbox mode (`BARE_OS_SHELL_SANDBOX`) to block external command execution
  - redirect path safety guard (`BARE_OS_SHELL_REDIRECT_GUARD`) for pseudo-path/traversal risks
  - emit structured shell audit event rows (`ctx.shellAuditEvents`) for start/error/finish

- Improve interactive UX resilience:
  - add prompt-hook timeout protection in fish readline:
    - `resolveShellPromptHookSegment`
    - env control `BARE_OS_SHELL_PROMPT_HOOK_TIMEOUT_MS`
  - ensure prompt segment resolution is non-blocking and safe on timeout/error

- Add reliability/performance artifacts and shell fast lane:
  - add `scripts/bench-shell-phases.mjs` for shell microbench sanity checks
  - add `scripts/gen-shell-reliability-report.mjs` and generate reliability JSON artifact
  - add root scripts:
    - `test:shell-fast`
    - `bench:shell`
    - `report:shell-reliability`

- Expand shell-focused docs and traceability:
  - add:
    - `docs/reference/shell-unsupported-behavior.md`
    - `docs/reference/shell-troubleshooting.md`
  - add contributor guides:
    - `developer-guide/17-how-to-add-shell-builtin.md`
    - `developer-guide/18-how-to-add-shell-grammar-feature.md`
  - update indexes/traceability/release gate docs:
    - `docs/reference/README.md`
    - `docs/reference/posix-issue7-traceability.md`
    - `docs/reference/environment-and-posix-appendix.md`
    - `docs/release-checklist.md`
    - `developer-guide/README.md`
    - `scripts/README.md`

- Add and update shell regression tests in `packages/bare-os-booter/test.js` for:
  - tokenizer spans/modes and deterministic output
  - AST snapshot schema/shape
  - redirection planner and execution graph behavior
  - expansion trace and strict arithmetic paths
  - `<<-` support
  - pipeline stage timeout handling
  - `read` delimiter/raw/timeout semantics
  - jobs/wait parseability and selection semantics
  - trap dispatch and normalization behavior
  - policy/sandbox/redirect-guard/audit-event pathways

Validation:
- `npm run test -w bare-os-booter`
- `npm run test:shell-bracket -w bare-os-booter`
- `npm run test:shell-fast`
- `npm run report:shell-reliability`
2026-04-26 23:17:20 -04:00
..
archive-cli.js
feat(booter): disk.os bridge, systemctl ctx API, delegates, and docs
2026-04-04 18:09:08 -04:00
bare-cron.js
Align the booter and docs with the kernel POSIX and stack-hardening roadmap: refresh
2026-04-04 22:39:33 -04:00
bare-holesail-env.js
Holesail Service Daemon + Bin Client
2026-04-09 20:42:54 -04:00
bare-holesail-loader.js
Holesail Service Daemon + Bin Client
2026-04-09 20:42:54 -04:00
bare-holesail-managed.js
Remove logger
2026-04-23 20:49:38 -04:00
bare-holesail.js
feat(booter): ephemeral port fallback on EADDRINUSE
2026-04-23 20:39:50 -04:00
bare-initd-journal.js
Update btop
2026-04-05 16:34:58 -04:00
bare-initd-user.js
Attempt at HTTP Server
2026-04-22 03:44:42 -04:00
bare-initd.js
booter updates
2026-04-26 07:05:24 -04:00
bare-module-manifest.data.mjs
Holesail Service Daemon + Bin Client
2026-04-09 20:42:54 -04:00
bare-module-manifest.json
Holesail Service Daemon + Bin Client
2026-04-09 20:42:54 -04:00
bare-openssh-pty-console.js
Normalize embedded newlines to CRLF in SSH child ctx console log/error so
2026-04-09 00:53:45 -04:00
bare-openssh-sftp.js
bare-ssh2 parses SFTP handles via bufferSlice/safer-buffer — handles are often
2026-04-21 18:22:32 -04:00
bare-openssh.js
feat(booter): ephemeral port fallback on EADDRINUSE
2026-04-23 20:39:50 -04:00
bare-os-abort.js
Updates
2026-04-03 20:46:09 -04:00
bare-os-acl-eval.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
bare-os-audit-chain.js
TextEncoder Fix
2026-04-26 22:34:04 -04:00
bare-os-bin-index.js
feat: POSIX/P2P roadmap — multisig shape, socket bridge, bin index, docs
2026-04-05 02:08:38 -04:00
bare-os-bin-offload-worker.cjs
normalize initd state modeling and stabilize synthetic initd PID mapping
2026-04-26 06:57:07 -04:00
bare-os-bind-fallback.js
feat(booter): ephemeral port fallback on EADDRINUSE
2026-04-23 20:39:50 -04:00
bare-os-boot-graph-proc.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
bare-os-boot-manifest-sig-bridge.cjs
Updates
2026-04-03 23:44:13 -04:00
bare-os-boot-manifest-sig.bare.js
Updates
2026-04-03 23:42:47 -04:00
bare-os-boot-manifest-sig.node.js
Updates
2026-04-03 23:44:13 -04:00
bare-os-boot-phases.js
feat(booter): disk.os bridge, systemctl ctx API, delegates, and docs
2026-04-04 18:09:08 -04:00
bare-os-capability-registry.js
Updates
2026-04-04 18:46:00 -04:00
bare-os-chat-initd.js
chat-v1
2026-04-21 20:05:57 -04:00
bare-os-chat-service.js
More Mux Fixes
2026-04-22 06:38:52 -04:00
bare-os-ctx-api.js
feat(booter): ctx 1.54.0, process table v9, and Holepunch/POSIX proc parity
2026-04-05 23:14:08 -04:00
bare-os-ctx-bare.js
fix(booter): tolerate UTF-8 BOM in /lib/bare/bare-module-lock.json
2026-04-22 22:24:23 -04:00
bare-os-ctx.d.ts
feat(p2p): introduce shared p2p transport/service stack and launch swarmtop, meshdrop, taskmesh, peernote, and hypershell-board
2026-04-26 07:48:55 -04:00
bare-os-delegate-concurrent.js
feat: kernel roadmap wave — bits4, policy v4, Pear/Bare compatibility
2026-04-04 02:51:33 -04:00
bare-os-disk-os-bridge.js
Allow Verified Version Peers to help boots
2026-04-23 21:24:04 -04:00
bare-os-dns-policy.js
Updates
2026-04-04 01:20:57 -04:00
bare-os-ensure-bare-fetch.js
Updates
2026-04-04 01:20:57 -04:00
bare-os-errors.js
feat(booter): disk.os bridge, systemctl ctx API, delegates, and docs
2026-04-04 18:09:08 -04:00
bare-os-fcntl-cooperative-lock.js
feat(booter): POSIX/P2P roadmap — profile 1.0.14, ctx 1.50.0, docs & tests
2026-04-05 13:50:07 -04:00
bare-os-host-booter-log.js
feat(booter): complete P2P POSIX roadmap items and doc alignment
2026-04-05 15:04:59 -04:00
bare-os-host-proc-snapshot.js
feat(booter): OpenMetrics proc export, protomux wire JSON, audit batch API, and doc sync
2026-04-04 19:23:06 -04:00
bare-os-host-profile.js
Updates
2026-04-04 18:41:34 -04:00
bare-os-host-signals-bridge.js
Complete the internal “100 task” roadmap: coreutils and shell parity (xargs,
2026-04-04 21:23:49 -04:00
bare-os-hrpc-allowlist.js
feat(booter): hrpc allowlist parser, snapshot hints parity, shell pipefix, safer mv staging
2026-04-05 01:31:03 -04:00
bare-os-hrpc-route-table.js
- disk.os: replication_operator_sketch schema 7 + corestoreSnapshotUxHint; wire corestore into bridge
2026-04-05 15:52:59 -04:00
bare-os-http-policy.js
Updates
2026-04-03 20:46:09 -04:00
bare-os-hyperbee-guest-hint.js
feat(booter): POSIX/P2P roadmap — profile 1.0.14, ctx 1.50.0, docs & tests
2026-04-05 13:50:07 -04:00
bare-os-ipc-namespace.js
Updates
2026-04-04 01:20:57 -04:00
bare-os-ipc.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
bare-os-kernel-errno.js
Updates
2026-04-04 18:46:00 -04:00
bare-os-kernel-loader.js
booter: synthesize seed capabilities so more peers mirror MBR block 0
2026-04-24 01:14:35 -04:00
bare-os-kernel-metrics.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
bare-os-kernel-program-proc.js
Updates
2026-04-04 16:39:15 -04:00
bare-os-lifecycle-manager.js
booter: harden lifecycle and IPC; add richer swarm/process observability
2026-04-26 07:15:34 -04:00
bare-os-lifecycle-schema.js
When BARE_OS_WAVE11_PROC is 0, false, or off, omit the 20 Wave 11
2026-04-04 06:39:31 -04:00
bare-os-meshdrop-service.js
feat(p2p): introduce shared p2p transport/service stack and launch swarmtop, meshdrop, taskmesh, peernote, and hypershell-board
2026-04-26 07:48:55 -04:00
bare-os-monotonic-time.js
Align the booter and docs with the kernel POSIX and stack-hardening roadmap: refresh
2026-04-04 22:39:33 -04:00
bare-os-mounts-persist.js
feat(booter): harden guest vs user isolation and POSIX/P2P parity
2026-04-05 03:16:33 -04:00
bare-os-path-capability.js
- disk.os: replication_operator_sketch schema 7 + corestoreSnapshotUxHint; wire corestore into bridge
2026-04-05 15:52:59 -04:00
bare-os-pear-ipc-registry.js
feat(bare-os): kernel wave 3 — bits3, seed RPCs, policy, proc, CI schemas
2026-04-04 02:34:21 -04:00
bare-os-pear-updater-bridge.js
POSIX / synthetic syscalls
2026-04-05 00:45:17 -04:00
bare-os-peer-admission.js
feat(booter): POSIX/P2P roadmap — profile 1.0.14, ctx 1.50.0, docs & tests
2026-04-05 13:50:07 -04:00
bare-os-peer-system-seed.js
booter: synthesize seed capabilities so more peers mirror MBR block 0
2026-04-24 01:14:35 -04:00
bare-os-posix-errno.js
Complete the internal “100 task” roadmap: coreutils and shell parity (xargs,
2026-04-04 21:23:49 -04:00
bare-os-posix-signals.js
Align the booter and docs with the kernel POSIX and stack-hardening roadmap: refresh
2026-04-04 22:39:33 -04:00
bare-os-proc-bare-module-crypto-staging.js
feat(booter): ctx 1.54.0, process table v9, and Holepunch/POSIX proc parity
2026-04-05 23:14:08 -04:00
bare-os-proc-bare-runtime-proto-mux.js
feat: complete 20-track kernel roadmap (P2P ops, POSIX, HRPC, CI, docs)
2026-04-05 14:17:20 -04:00
bare-os-proc-blind-peer-relay-gate.js
feat(booter): POSIX/P2P roadmap — profile 1.0.14, ctx 1.50.0, docs & tests
2026-04-05 13:50:07 -04:00
bare-os-proc-hypercore-pack-hrpc-lifecycle.js
CI/docs: placeholder-baseline --check, seeder↔kernel sync script and docs,
2026-04-05 14:45:01 -04:00
bare-os-proc-pear-corestore-hrpc.js
Implement the 20-track POSIX + P2P roadmap: booter, protocol, coreutils, docs,
2026-04-05 01:06:59 -04:00
bare-os-proc-pear-inspect-logger-tls.js
feat(booter): hrpc allowlist parser, snapshot hints parity, shell pipefix, safer mv staging
2026-04-05 01:31:03 -04:00
bare-os-proc-replication-operator-surface.js
feat(booter): POSIX/P2P roadmap — ctx 1.41.0, hrpc audit, warm-cache, Pear proc
2026-04-05 00:32:40 -04:00
bare-os-process-table.js
booter: apply 20-point Holepunch resilience and observability upgrades
2026-04-26 07:22:31 -04:00
bare-os-protomux-alias-registry.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
bare-os-protomux-extensions-proc.js
- disk.os: replication_operator_sketch schema 7 + corestoreSnapshotUxHint; wire corestore into bridge
2026-04-05 15:52:59 -04:00
bare-os-replication-priority.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
bare-os-replication-proc-live.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
bare-os-runtime-caps.js
When the host leaves these unset, the booter now sets
2026-04-22 22:09:58 -04:00
bare-os-sandbox.js
Updates
2026-04-04 18:41:34 -04:00
bare-os-secret-handle-registry.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
bare-os-socket-scm-rights.js
feat: POSIX/P2P roadmap — multisig shape, socket bridge, bin index, docs
2026-04-05 02:08:38 -04:00
bare-os-ssh-holesail.js
HS Updates
2026-04-24 09:05:52 -04:00
bare-os-statvfs-from-drive.js
feat(booter): POSIX/P2P roadmap — syscalls v4, mirror VFS, seeder snapshot hints
2026-04-04 22:00:01 -04:00
bare-os-swarm-connection-manager.js
booter: apply 20-point Holepunch resilience and observability upgrades
2026-04-26 07:22:31 -04:00
bare-os-swarm-lifecycle.js
Align the booter and docs with the kernel POSIX and stack-hardening roadmap: refresh
2026-04-04 22:39:33 -04:00
bare-os-swarm-peer-policy.js
booter: apply 20-point Holepunch resilience and observability upgrades
2026-04-26 07:22:31 -04:00
bare-os-swarm-subsystem-proc.js
Update proc
2026-04-21 22:45:50 -04:00
bare-os-sync-window.js
Add fifth feature word (STOCK_V5 / bits5) with ADR and capability docs.
2026-04-04 04:33:25 -04:00
bare-os-syscall-ops.js
- disk.os: replication_operator_sketch schema 7 + corestoreSnapshotUxHint; wire corestore into bridge
2026-04-05 15:52:59 -04:00
bare-os-syscalls-proc-json.js
feat(booter): ctx 1.54.0, process table v9, and Holepunch/POSIX proc parity
2026-04-05 23:14:08 -04:00
bare-os-theme-presets.js
themes
2026-04-03 21:39:36 -04:00
bare-os-var-log.js
booter: harden lifecycle and IPC; add richer swarm/process observability
2026-04-26 07:15:34 -04:00
bare-os-vault-rotation-audit.js
feat: POSIX/Holepunch plan — proc contracts, shell, vault audit, docs, tests
2026-04-04 22:28:47 -04:00
bare-os-vfs-acl-enforce.js
feat: complete Bare OS POSIX mega-plan (20-track)
2026-04-04 22:13:19 -04:00
bare-os-wasm-kernel.js
Expand bounded awk/expr/test toward Issue 7; refresh man, profile 1.0.18,
2026-04-05 23:01:54 -04:00
bare-os-www-holesail.js
HS Updates
2026-04-24 08:54:16 -04:00
bare-os-www-initd.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
bare-user-session-stack.js
feat(p2p): introduce shared p2p transport/service stack and launch swarmtop, meshdrop, taskmesh, peernote, and hypershell-board
2026-04-26 07:48:55 -04:00
boot-prefetch.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
boot-splash.js
Update Boot Loader
2026-04-04 18:20:56 -04:00
cli-readline.js
Login Security
2026-04-25 02:59:32 -04:00
completion-engine.js
feat(shell): job-aware kill, disown, jobs/set flags, fallback REPL history
2026-04-21 17:26:41 -04:00
corestore-host-lifecycle.js
booter: harden lifecycle and IPC; add richer swarm/process observability
2026-04-26 07:15:34 -04:00
curl-cli.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
debug-repl.js
Updates
2026-04-03 20:46:09 -04:00
delegate-rate-limit.js
feat: kernel roadmap wave — bits4, policy v4, Pear/Bare compatibility
2026-04-04 02:51:33 -04:00
fish-readline.js
complete shell 100-item plan across parser, execution, security, and docs
2026-04-26 23:17:20 -04:00
git-cli.js
feat(booter): complete P2P POSIX roadmap items and doc alignment
2026-04-05 15:04:59 -04:00
git-fs-adapter.js
feat: complete Bare OS POSIX mega-plan (20-track)
2026-04-04 22:13:19 -04:00
hdms-cli-argv.js
HDMS - RO,RW
2026-04-05 22:45:21 -04:00
hdms-manager.js
feat(booter): ctx 1.54.0, process table v9, and Holepunch/POSIX proc parity
2026-04-05 23:14:08 -04:00
hdms-share-offer.js
HDMS - RO,RW
2026-04-05 22:45:21 -04:00
holesail-cli.js
tests
2026-04-22 20:06:18 -04:00
host-bridge-cli.js
updates
2026-04-04 19:08:51 -04:00
host-delegate-registry.js
feat: complete Bare OS POSIX mega-plan (20-track)
2026-04-04 22:13:19 -04:00
http-fetch-url.js
feat(kernel): Wave 9 mega-phase — bits9, protocol 0.5, boot policy v9, Pear/Bare bridge
2026-04-04 05:54:08 -04:00
identity-account.js
Change how login works
2026-04-26 06:19:47 -04:00
identity-session.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
initd-state-machine.js
- Add first-party vs vendored rules to verify-banned-terminology; naming docs,
2026-04-04 17:06:35 -04:00
kernel-extension-resolver.js
CI/docs: placeholder-baseline --check, seeder↔kernel sync script and docs,
2026-04-05 14:45:01 -04:00
kernel-runner.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
openssl-cli.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
paths.js
Updates
2026-04-05 04:33:14 -04:00
repl-session.js
feat(shell): job-aware kill, disown, jobs/set flags, fallback REPL history
2026-04-21 17:26:41 -04:00
resolve-stdio.js
Updates
2026-04-03 20:46:09 -04:00
shell-glob.js
feat(shell): pathname globbing, noglob/set -f, and syscall pathconf
2026-04-04 19:36:32 -04:00
shell-tokenizer.js
complete shell 100-item plan across parser, execution, security, and docs
2026-04-26 23:17:20 -04:00
shell.js
complete shell 100-item plan across parser, execution, security, and docs
2026-04-26 23:17:20 -04:00
ssh-keygen-cli.js
feat(booter): disk.os bridge, systemctl ctx API, delegates, and docs
2026-04-04 18:09:08 -04:00
sshd-config-parse.js
Auto Create Autorized_Keys
2026-04-08 23:07:07 -04:00
swarm-connection-manager.js
Move editable kernel bulk from kernel/init-main.js to kernel/lib/init/
2026-04-04 17:51:47 -04:00
swarm-disk.js
feat(p2p): introduce shared p2p transport/service stack and launch swarmtop, meshdrop, taskmesh, peernote, and hypershell-board
2026-04-26 07:48:55 -04:00
swarm-opts.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
systemctl-cli.js
Fixes for var log
2026-04-21 23:19:38 -04:00
tar-cli.js
Implement the 20-task Bare OS POSIX + P2P roadmap: holepunch lockfile drift
2026-04-05 02:21:07 -04:00
terminal-escapes.js
feat(terminal): align clear and fish TTY with xterm.js scrollback behavior
2026-04-25 02:00:44 -04:00
vfs-posix-meta.js
feat(booter): POSIX/P2P roadmap — syscalls v4, mirror VFS, seeder snapshot hints
2026-04-04 22:00:01 -04:00
vfs.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00
warc-cli.js
feat(booter): disk.os bridge, systemctl ctx API, delegates, and docs
2026-04-04 18:09:08 -04:00
wget-cli.js
chore(plan): cancel end-to-end seeder-to-booter smoke harness task
2026-04-26 22:28:21 -04:00