nOSh Runtime
The userland binary that owns the mission board, the credit/reputation economy, the phase chain, the CIPHER voice (rendered on the auxiliary OLED), and the bare-deck HUD when no cartridge is loaded. Sits between the device OS and cartridges.
Contents
Section titled “Contents”../gameplay-framework.md— the gameplay-system map: how the runtime, objectives, economy, programs, and carts connect into a run, the three verb tiers + grammar/mini-game dialectic, and the open-gap ledger. Start here for the whole picture.orchestration.md— main loop, capability model, phase chain, Universal Deck State (formerly the Capability Model spec). The architecture entry point.mission-control.md— Capability Registry, schema-driven contract generation, TTL/decay, Mission Runner handoff. Owns the mission board surface. (ADR-0028 / ADR-0029)mission-objectives.md— the goal/bounty/reward model: objectives as Lisp cells (four facets), multi-currency rewards (¤ / rep / intel / access), authored-spine + procedural-limbs generation, thedefcontract-schema :objectivesclause, and the NoshAPI goal verbs. Fillsmission-control.mdOQ-1 / OQ-2 / OQ-3. (Draft; ADR owed)recon-mode.md— recon as a player-elected mode: casing the cart’s simulated world for DOSSIER keys under a shared heat economy (passive≈free / active raises heat; heat pre-loads the op). The rip-and-run vs measured axis. (Draft; gap C)baselines/— System-tier runtime-shipped baseline modules. One spec doc per baseline:baselines/terminal.md—:penetratebaseline (superseded by ICE BREAKER)baselines/grid.md—:grid-calibrationbaseline (superseded by NEONGRID)baselines/audit.md—:audit-tracebaseline (superseded by BLACK LEDGER)baselines/sonar.md—:sonar-sweepbaseline (superseded by DEPTHCHARGE) Each is a Lisp virtual cart in the system image, registered automatically atnosh_init. (ADR-0030)
prototype-architecture.md— device topology, dual targets (emulator + Pi Zero 2 W).bare-deck-terminal.md— runtime HUD when no cartridge is loaded. Four-tab layout, macro recording, Cipher voice surfaces.bare-deck-content-brief.md— per-tab content design and bounty contracts (STATUS / CIPHER / LAMBDA / LINK / SYS). Gate doc for GWP-317 engineering.currency-and-economy.md— the four-currency model (Credits / Reputation / per-cart Mastery / Knowledge), the spend guardrail, and the hybrid credit-sink structure (program upgrade tree + consumables + pay-to-skip access). Owns credit outflow; the goal-reward layer is inmission-objectives.md. (Draft; ADR owed)input-dispatch.md— 31-key event model, hold detection, dispatch pipeline.key-test-utility.md— SYS-mode utility screen (BD_MODE_SYS_KEY_TEST).- REPL & nEmacs moved. As of ADR-0042 these are first-party programs, not runtime docs — their landing pages now live in
../programs/(repl.md,nemacs.md). See the first-party program roster. cipher-voice.md— CIPHER-LINE engine spec: event stream, memory store, five utterance modes, mode selector, coherence stack. Runtime + grammar (a future split into a separate../api-reference/grammars/cipher-line-grammar.mdis filed as a follow-up).display-pipeline.md— how a cartridge draw call travels fromtext-putsFFI to pixels on the Elecrow primary display and CIPHER-LINE OLED. Cell geometry, row authority split, display modes, OLED routing. (ADR-0014, ADR-0015)audio-pipeline.md— how a cart-sidepsg-tonecall reaches the MAX98357A speaker. PSG register model, coprocessor vtable seam, emulator vs prototype paths, latency budget. (ADR-0017)cartridge-lifecycle.md— mount/unmount/hot-swap lifecycle states. udev events, .kn86 header validation, phase chain serialization. (ADR-0019)panic-recovery.md— cart-isolation crash recovery: SIGSEGV / SIGFPE / SIGBUS traps, Fe error trap,(panic)NoshAPI primitive, CIPHER-LINE Row 4 notice, panic-log format. (GWP-320, ADR-0004)coprocessor-bridge.md— Pi-side UART bridge: command queue design, backchannel event subscriber, error recovery, boot-time handshake. (ADR-0017)haptic-feedback.md— haptic design (Status: Proposed, post-v0.1).pcm-voice-bark.md— voice-bark audio path (Status: Proposed, post-v0.1).