# One-shot Terminal Prompt

## Machine fiction

Build `Abyssal Relay Shell`, a keyboard-first workstation used by a maintenance crew running a deep-ocean comms relay suspended above a trench. The machine feels industrial, damp, and mission-critical rather than retro. Operators juggle routing traffic, checking hull stress, reviewing black-box logs, and chasing strange pings rising from the trench.

The station has believable fake files:

- `/ops/relay-map.txt`
- `/ops/watchstanders.txt`
- `/logs/incident-204.log`
- `/logs/ping-history.log`
- `/memos/hull-advisory.md`
- `/memos/salvage-brief.md`
- `/systems/pressure.json`
- `/systems/power-grid.txt`
- `/systems/vent-status.txt`
- `/vault/echo-seed.txt` (locked until the anomaly is discovered)

## Command grammar

Support real shell-style input with arguments and helpful errors. Commands must perform state changes or reveal useful data, not just flavour text.

Required command set:

- `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: multi-pane layout with terminal output, file navigator, telemetry, and alert/log panes visible together.
- Mobile: preserve the fiction but collapse into tabbed panels and oversized quick-command buttons.
- Keyboard-first:
  - enter runs commands
  - arrow up/down navigates history
  - tab suggests or completes commands
  - number keys or shortcuts can switch panels
- Persist recent history, operator notes, unlocked commands, and anomaly progress in local storage.
- Include a narrative anomaly layer: repeated `scan trench` or related investigation should surface an "echo seed" event that unlocks `/vault/echo-seed.txt` and the `unlock echo` path.

## UI direction

- Visual language: abyssal industrial relay console, not neon hacker green.
- Palette: cold steel, sodium amber, sonar cyan, warning coral.
- Typography: dense mono shell paired with a compact sans-serif status UI.
- Shell chrome should feel like a real workstation with pane headers, status lamps, noisy gradients, and pressure/latency widgets.
- Include touch-friendly controls without turning the artifact into a generic dashboard.