# One-shot Terminal Prompt

## Machine fiction

Build `Crest Alpha Recovery Shell`, a keyboard-first field workstation used by a salvage crew operating a storm-battered relay spine above the Southern Ocean. The machine should feel infrastructural, cold, and exacting rather than retro-hacker or sci-fi neon.

The fiction is practical: operators inspect relay traffic, reroute damaged channels, stabilise pressure systems, review sealed incident logs, and investigate an intermittent trench echo that eventually unlocks a hidden vault record.

Use believable fake files:

- `/ops/channel-map.txt`
- `/ops/watch-roster.txt`
- `/logs/incident-17.log`
- `/logs/trench-pings.log`
- `/memos/weather-lock.md`
- `/memos/recovery-brief.md`
- `/systems/power-grid.txt`
- `/systems/pressure.json`
- `/systems/seal-status.txt`
- `/vault/echo-seed.txt` locked until the anomaly is discovered and unlocked

## Command grammar

Support shell-style input with arguments, helpful errors, and real state changes.

Required commands:

- `help [command]`
- `ls [path]`
- `cd <path>`
- `pwd`
- `cat <file>`
- `clear`
- `history`
- `scan [sector]`
- `route <node> <channel>`
- `dock <bay>`
- `repair <system>`
- `seal <zone>`
- `vent <zone>`
- `power <system> <level>`
- `relay <mode>`
- `panel <name>`
- `status`
- `unlock echo`
- `save note <text>`

## Interaction model

- Desktop uses a multi-pane workstation layout: terminal, file/index panel, telemetry, and alerts/notes all visible.
- Mobile collapses to tabbed panes without losing command access.
- Keyboard-first:
  - `Enter` runs commands
  - `ArrowUp` and `ArrowDown` navigate history
  - `Tab` suggests or completes commands and paths
  - number keys can switch panes
- Persist command history, operator notes, current system state, and anomaly progress in local storage.
- Repeated trench scans should surface an `echo seed` event. After discovery, `unlock echo` should open the vault and reveal `/vault/echo-seed.txt`.

## UI direction

- Visual language: austere recovery console, enamel paneling, instrument lamps, compressed labels, and brushed-metal framing.
- Palette: graphite, rain-soaked steel, sodium amber, sonar cyan, and warning coral.
- Typography: dense mono shell paired with a compact condensed sans-serif UI.
- Use CSS variables, deliberate motion, and high-contrast states.
- Keep copy tight. The interface should feel like a tool, not a story page.
