@forbocai/test-game 0.6.0

package/dist/cli.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import {
+  runGame
+} from "./chunk-4XIOL463.mjs";
+
+// src/cli.ts
+var usage = () => {
+  console.log(`
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551  ECHOES OF THE SPIRE // TERMINAL HARNESS            \u2551
+\u2551  SYSTEM_OVERRIDE :: NEURAL_LINK_ESTABLISHED         \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+
+\u16A0 \u16A2 \u16A6 \u16A8 \u16B1 \u16B2 \u16B7 \u16B9
+
+Usage:
+  forbocai-test-game --mode autoplay|manual
+
+Defaults:
+  --mode autoplay
+
+  [ok]        Command completed in shell mode.
+  [error]     LOG_ERR_CRITICAL - command failed and was recorded.
+`);
+};
+var getArgValue = (name) => {
+  const idx = process.argv.findIndex((a) => a === name);
+  if (idx === -1) return void 0;
+  return process.argv[idx + 1];
+};
+var runCli = async () => {
+  if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    usage();
+    return;
+  }
+  const mode = getArgValue("--mode") || "autoplay";
+  if (!["manual", "autoplay"].includes(mode)) {
+    throw new Error(`Invalid mode: ${mode}`);
+  }
+  const result = await runGame({ mode });
+  return result;
+};
+var __test = {
+  usage,
+  getArgValue
+};
+if (process.env.NODE_ENV !== "test") {
+  runCli().catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });
+}
+export {
+  __test,
+  runCli
+};

package/dist/index.d.mts

@@ -0,0 +1,54 @@
+/**
+ * Shared type contracts for command coverage, transcript, and scenario runtime.
+ * In the quiet between turns, the protocol still remembers.
+ */
+type ExecutionMode = 'simulate' | 'shell';
+type PlayMode = 'manual' | 'autoplay';
+type CommandGroup = 'status' | 'npc_lifecycle' | 'npc_process_chat' | 'memory_list' | 'memory_recall' | 'memory_store' | 'memory_clear' | 'memory_export' | 'bridge_rules' | 'bridge_validate' | 'bridge_preset' | 'soul_export' | 'soul_import' | 'soul_list' | 'soul_chat' | 'ghost_lifecycle' | 'cortex_init';
+type CommandSpec = {
+    group: CommandGroup;
+    command: string;
+    expectedRoutes: string[];
+};
+type TranscriptStatus = 'ok' | 'error' | 'simulated';
+type TranscriptEntry = {
+    id: string;
+    scenarioId: string;
+    commandGroup: CommandGroup;
+    command: string;
+    expectedRoutes: string[];
+    status: TranscriptStatus;
+    output: string;
+    at: string;
+};
+type ScenarioStep = {
+    id: string;
+    title: string;
+    description: string;
+    eventType: 'stealth' | 'social' | 'escape' | 'persistence';
+    commands: CommandSpec[];
+};
+type GameRunResult = {
+    complete: boolean;
+    missingGroups: CommandGroup[];
+    transcript: TranscriptEntry[];
+    summary: string;
+};
+
+/**
+ * Runs a full game session in manual or autoplay mode.
+ * The run is marked incomplete if any required CLI command group is missing.
+ */
+declare const runGame: ({ mode, execute }: {
+    mode: PlayMode;
+    execute: ExecutionMode;
+}) => Promise<GameRunResult>;
+
+/**
+ * Canonical list of command groups required for a complete harness run.
+ * Fail-closed doctrine: skipped paths are treated as broken reality.
+ */
+
+declare const REQUIRED_GROUPS: CommandGroup[];
+
+export { type CommandGroup, type ExecutionMode, type GameRunResult, type PlayMode, REQUIRED_GROUPS, type ScenarioStep, runGame };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared type contracts for command coverage, transcript, and scenario runtime.
+ * In the quiet between turns, the protocol still remembers.
+ */
+type ExecutionMode = 'simulate' | 'shell';
+type PlayMode = 'manual' | 'autoplay';
+type CommandGroup = 'status' | 'npc_lifecycle' | 'npc_process_chat' | 'memory_list' | 'memory_recall' | 'memory_store' | 'memory_clear' | 'memory_export' | 'bridge_rules' | 'bridge_validate' | 'bridge_preset' | 'soul_export' | 'soul_import' | 'soul_list' | 'soul_chat' | 'ghost_lifecycle' | 'cortex_init';
+type CommandSpec = {
+    group: CommandGroup;
+    command: string;
+    expectedRoutes: string[];
+};
+type TranscriptStatus = 'ok' | 'error' | 'simulated';
+type TranscriptEntry = {
+    id: string;
+    scenarioId: string;
+    commandGroup: CommandGroup;
+    command: string;
+    expectedRoutes: string[];
+    status: TranscriptStatus;
+    output: string;
+    at: string;
+};
+type ScenarioStep = {
+    id: string;
+    title: string;
+    description: string;
+    eventType: 'stealth' | 'social' | 'escape' | 'persistence';
+    commands: CommandSpec[];
+};
+type GameRunResult = {
+    complete: boolean;
+    missingGroups: CommandGroup[];
+    transcript: TranscriptEntry[];
+    summary: string;
+};
+
+/**
+ * Runs a full game session in manual or autoplay mode.
+ * The run is marked incomplete if any required CLI command group is missing.
+ */
+declare const runGame: ({ mode, execute }: {
+    mode: PlayMode;
+    execute: ExecutionMode;
+}) => Promise<GameRunResult>;
+
+/**
+ * Canonical list of command groups required for a complete harness run.
+ * Fail-closed doctrine: skipped paths are treated as broken reality.
+ */
+
+declare const REQUIRED_GROUPS: CommandGroup[];
+
+export { type CommandGroup, type ExecutionMode, type GameRunResult, type PlayMode, REQUIRED_GROUPS, type ScenarioStep, runGame };