@forbocai/test-game 0.6.0

package/README.md

@@ -0,0 +1,49 @@
+# Echoes of the Spire (`@forbocai/test-game`)
+
+<!-- AESTHETIC_PROTOCOL_COMPLIANCE -->
+<!-- SYSTEM_OVERRIDE // NEURAL_LINK_ESTABLISHED -->
+<!-- ᚠ ᚢ ᚦ ᚨ ᚱ ᚲ ᚷ ᚹ -->
+
+```text
+   .-.
+  (o o)   [VOID::WATCHER]
+  | O \\
+   \\   \\
+    `~~~'
+```
+
+Terminal micro-game harness that maps gameplay scenarios to ForbocAI CLI command coverage.
+
+## Run
+
+```bash
+npm run build --workspace @forbocai/test-game
+node packages/test-game/dist/cli.js --mode autoplay
+```
+
+Manual mode:
+
+```bash
+node packages/test-game/dist/cli.js --mode manual
+```
+
+Optional command execution:
+
+```bash
+node packages/test-game/dist/cli.js --mode autoplay --execute shell
+```
+
+`--execute shell` attempts to run `forbocai ...` commands and records failures/successes in transcript output.
+
+## Acceptance Mapping
+
+- CLI coverage command matrix is represented in `src/features/autoplay/slices/scenarioSlice.ts`.
+- Transcript is recorded in `src/features/terminal/slices/transcriptSlice.ts`.
+- Coverage summary and incompleteness gate are enforced in `src/game.ts`.
+
+## Functional Paradigm (RTK-Aligned)
+
+- No classes; behavior is modeled with pure functions, slices, and action dispatch.
+- State transitions are reducer-driven in feature slices.
+- Orchestration (`runGame`) composes slice actions and pure helpers, keeping logic explicit and testable.
+- BDD tests assert behavior using real store state and selectors/outputs.