@sensigo/realm-cli 0.1.0

package/dist/commands/list.js

@@ -0,0 +1,88 @@
+// list command — displays all runs in the store, sorted by most recent first.
+import chalk from 'chalk';
+import { Command } from 'commander';
+/** Returns a chalk-coloured phase label. */
+function colorState(run) {
+    if (run.run_phase === 'completed')
+        return chalk.green(run.run_phase);
+    if (run.run_phase === 'failed' || run.run_phase === 'abandoned')
+        return chalk.red(run.run_phase);
+    if (run.run_phase === 'gate_waiting')
+        return chalk.cyan(run.run_phase);
+    return chalk.yellow(run.run_phase);
+}
+/**
+ * Formats elapsed time since a gate was opened as a compact human-readable duration.
+ * @param openedAt  ISO 8601 timestamp of when the gate was opened.
+ * @param now       Current time — injectable for testing. Defaults to `new Date()`.
+ */
+export function formatGateAge(openedAt, now = new Date()) {
+    const elapsedMs = now.getTime() - new Date(openedAt).getTime();
+    const totalMinutes = Math.floor(elapsedMs / 60_000);
+    const totalHours = Math.floor(totalMinutes / 60);
+    const totalDays = Math.floor(totalHours / 24);
+    if (totalMinutes < 60)
+        return `${totalMinutes}m`;
+    if (totalHours < 24) {
+        const remainingMinutes = totalMinutes % 60;
+        return `${totalHours}h ${remainingMinutes}m`;
+    }
+    const remainingHours = totalHours % 24;
+    return `${totalDays}d ${remainingHours}h`;
+}
+const VALID_PHASES = ['running', 'gate_waiting', 'completed', 'failed', 'abandoned'];
+/**
+ * Lists runs from the store, sorted by updated_at descending.
+ * @param workflowId    Optional filter — only show runs from this workflow.
+ * @param store         Store holding run records.
+ * @param statusFilter  Optional filter — only show runs with this run_phase.
+ * @returns             Formatted output string.
+ */
+export async function listRuns(workflowId, store, statusFilter) {
+    const runs = await store.list(workflowId);
+    const filtered = statusFilter !== undefined ? runs.filter((r) => r.run_phase === statusFilter) : runs;
+    if (filtered.length === 0) {
+        return workflowId !== undefined
+            ? `No runs found for workflow '${workflowId}'.`
+            : 'No runs found.';
+    }
+    filtered.sort((a, b) => new Date(b.updated_at).getTime() - new Date(a.updated_at).getTime());
+    const lines = [];
+    for (const run of filtered) {
+        const state = colorState(run);
+        const updated = new Date(run.updated_at).toLocaleString();
+        const steps = new Set(run.evidence.filter((e) => e.kind !== 'gate_response').map((e) => e.step_id)).size;
+        let line = `${chalk.dim(run.id)}  ${chalk.bold(run.workflow_id)} v${run.workflow_version}  ${state}  ${updated}  ${steps} step(s)`;
+        if (run.run_phase === 'gate_waiting' && run.pending_gate !== undefined) {
+            const age = formatGateAge(run.pending_gate.opened_at);
+            line += `  gate: ${run.pending_gate.step_name} (${age})`;
+        }
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+export const listCommand = new Command('list')
+    .description('List all runs, sorted by most recent first')
+    .option('--workflow <id>', 'Filter by workflow ID')
+    .option('--status <phase>', `Filter by run phase (${VALID_PHASES.join(', ')})`)
+    .action(async (opts) => {
+    const { JsonFileStore } = await import('@sensigo/realm');
+    const store = new JsonFileStore();
+    let statusFilter;
+    if (opts.status !== undefined) {
+        if (!VALID_PHASES.includes(opts.status)) {
+            console.error(`Invalid --status value '${opts.status}'. Valid values: ${VALID_PHASES.join(', ')}`);
+            process.exit(1);
+        }
+        statusFilter = opts.status;
+    }
+    try {
+        const output = await listRuns(opts.workflow, store, statusFilter);
+        console.log(output);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"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"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * Starts the Realm MCP server using the global workflow store (~/.realm/workflows/).
+ * All workflows registered via `realm workflow register` are immediately available.
+ * Built-in adapters (FileSystemAdapter etc.) are included automatically.
+ */
+export declare const mcpCommand: Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;GAIG;AACH,eAAO,MAAM,UAAU,SAOnB,CAAC"}

package/dist/commands/mcp.js

@@ -0,0 +1,22 @@
+// realm mcp — starts the global Realm MCP server.
+// Serves all workflows registered via `realm workflow register`.
+// For custom handlers or adapters, build a small mcp-server.ts that calls
+// createRealmMcpServer({ workflowStore, registry }) with your extended registry.
+import { Command } from 'commander';
+import { JsonWorkflowStore } from '@sensigo/realm';
+import { createRealmMcpServer } from '@sensigo/realm-mcp';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+/**
+ * Starts the Realm MCP server using the global workflow store (~/.realm/workflows/).
+ * All workflows registered via `realm workflow register` are immediately available.
+ * Built-in adapters (FileSystemAdapter etc.) are included automatically.
+ */
+export const mcpCommand = new Command('mcp')
+    .description('Start the Realm MCP server (serves all registered workflows via stdio)')
+    .action(async () => {
+    const workflowStore = new JsonWorkflowStore();
+    const server = createRealmMcpServer({ workflowStore });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+});
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,iEAAiE;AACjE,0EAA0E;AAC1E,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,wEAAwE,CAAC;KACrF,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC"}

package/dist/commands/migrate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const migrateCommand: Command;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,cAAc,SA4CvB,CAAC"}

package/dist/commands/migrate.js

@@ -0,0 +1,42 @@
+// realm workflow migrate — back-fills origin: 'human' on local workflow JSON files.
+import { Command } from 'commander';
+import { readFileSync, writeFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+export const migrateCommand = new Command('migrate')
+    .description('Back-fill origin field on local workflow definitions that predate provenance tracking')
+    .action(() => {
+    const workflowsDir = join(homedir(), '.realm', 'workflows');
+    if (!existsSync(workflowsDir)) {
+        console.log('No local workflow store found. Nothing to migrate.');
+        return;
+    }
+    const files = readdirSync(workflowsDir).filter((f) => f.endsWith('.json'));
+    if (files.length === 0) {
+        console.log('No workflow files found. Nothing to migrate.');
+        return;
+    }
+    let migrated = 0;
+    let skipped = 0;
+    for (const file of files) {
+        const filePath = join(workflowsDir, file);
+        let definition;
+        try {
+            definition = JSON.parse(readFileSync(filePath, 'utf8'));
+        }
+        catch (err) {
+            console.warn(`Skipping ${file}: could not parse JSON — ${err instanceof Error ? err.message : String(err)}`);
+            continue;
+        }
+        if ('origin' in definition) {
+            skipped++;
+            continue;
+        }
+        definition.origin = 'human';
+        writeFileSync(filePath, JSON.stringify(definition, null, 2), 'utf8');
+        console.log(`Migrated: ${file}`);
+        migrated++;
+    }
+    console.log(`Done. ${migrated} migrated, ${skipped} already up to date.`);
+});
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACjD,WAAW,CACV,uFAAuF,CACxF;KACA,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,UAAmC,CAAC;QACxC,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAC;QACrF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,YAAY,IAAI,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC;QAC5B,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;QACjC,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,QAAQ,cAAc,OAAO,sBAAsB,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC"}

package/dist/commands/register.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+import type { WorkflowDefinition } from '@sensigo/realm';
+export declare const registerCommand: Command;
+/** @internal Exported for testing only. */
+export declare function lintWorkflowContext(definition: WorkflowDefinition): string[];
+//# sourceMappingURL=register.d.ts.map

package/dist/commands/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,eAAO,MAAM,eAAe,SAyBxB,CAAC;AAEL,2CAA2C;AAC3C,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,EAAE,CA4B5E"}

package/dist/commands/register.js

@@ -0,0 +1,51 @@
+// realm register <path> — validates and registers a workflow from a YAML file.
+import { Command } from 'commander';
+import { join } from 'node:path';
+import { loadWorkflowFromFile, JsonWorkflowStore } from '@sensigo/realm';
+export const registerCommand = new Command('register')
+    .argument('<path>', 'Path to workflow directory or workflow.yaml file')
+    .description('Register a workflow definition')
+    .action(async (inputPath) => {
+    const filePath = inputPath.endsWith('.yaml') || inputPath.endsWith('.yml')
+        ? inputPath
+        : join(inputPath, 'workflow.yaml');
+    try {
+        const definition = loadWorkflowFromFile(filePath);
+        const store = new JsonWorkflowStore();
+        await store.register(definition);
+        const contextWarnings = lintWorkflowContext(definition);
+        for (const warning of contextWarnings) {
+            console.warn(`⚠  ${warning}`);
+        }
+        console.log(`Registered: ${definition.id} v${definition.version} (${Object.keys(definition.steps).length} steps)`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: ${message}`);
+        process.exit(1);
+    }
+});
+/** @internal Exported for testing only. */
+export function lintWorkflowContext(definition) {
+    const contextEntries = Object.keys(definition.workflow_context ?? {});
+    if (contextEntries.length === 0)
+        return [];
+    // Only lint agent steps that have a prompt — auto steps have no agent-visible prompt.
+    const agentStepsWithPrompt = Object.values(definition.steps).filter((s) => s.execution === 'agent' && typeof s.prompt === 'string');
+    // Need at least 2 agent steps for a proportion warning to be meaningful.
+    if (agentStepsWithPrompt.length < 2)
+        return [];
+    const threshold = Math.floor(agentStepsWithPrompt.length / 2);
+    const warnings = [];
+    for (const name of contextEntries) {
+        const refPattern = `workflow.context.${name}`;
+        const refCount = agentStepsWithPrompt.filter((s) => s.prompt.includes(refPattern)).length;
+        if (refCount > threshold) {
+            warnings.push(`workflow.context.${name} is referenced in ${refCount} of ${agentStepsWithPrompt.length} ` +
+                `agent step prompts. If this context applies universally, that is intentional — ` +
+                `otherwise consider whether all steps truly need it.`);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"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"}

package/dist/commands/replay-format.d.ts

@@ -0,0 +1,3 @@
+/** Formats a precondition comparison column for replay output tables. */
+export declare function formatPrecondColumn(originalPass: boolean, replayPass: boolean, hasPreconditions: boolean): string;
+//# sourceMappingURL=replay-format.d.ts.map

package/dist/commands/replay-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-format.d.ts","sourceRoot":"","sources":["../../src/commands/replay-format.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,OAAO,EACnB,gBAAgB,EAAE,OAAO,GACxB,MAAM,CAKR"}

package/dist/commands/replay-format.js

@@ -0,0 +1,10 @@
+// replay-format.ts — shared formatting helper for precondition columns in replay output tables.
+/** Formats a precondition comparison column for replay output tables. */
+export function formatPrecondColumn(originalPass, replayPass, hasPreconditions) {
+    if (!hasPreconditions)
+        return 'none';
+    const orig = originalPass ? 'PASS' : 'BLOCKED';
+    const replay = replayPass ? 'PASS' : 'BLOCKED';
+    return `${orig} \u2192 ${replay}`;
+}
+//# sourceMappingURL=replay-format.js.map

package/dist/commands/replay-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-format.js","sourceRoot":"","sources":["../../src/commands/replay-format.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CACjC,YAAqB,EACrB,UAAmB,EACnB,gBAAyB;IAEzB,IAAI,CAAC,gBAAgB;QAAE,OAAO,MAAM,CAAC;IACrC,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,OAAO,GAAG,IAAI,WAAW,MAAM,EAAE,CAAC;AACpC,CAAC"}

package/dist/commands/replay.d.ts

@@ -0,0 +1,38 @@
+import { Command } from 'commander';
+import type { RunRecord, WorkflowDefinition } from '@sensigo/realm';
+import type { ReplayStore } from '../store/replay-store.js';
+export interface ReplayOverride {
+    step: string;
+    field: string;
+    value: unknown;
+}
+export interface ReplayStepResult {
+    step_id: string;
+    /** All preconditions passed in the original run? */
+    preconditions_original: boolean;
+    /** All preconditions pass with overridden evidence? */
+    preconditions_replay: boolean;
+    changed: boolean;
+    /** True when the step has at least one precondition defined. */
+    has_preconditions: boolean;
+}
+/**
+ * Parses a --with override expression of the form "step.field=value".
+ * @throws Error if the expression is missing '.' or '='.
+ */
+export declare function parseOverride(expr: string): ReplayOverride;
+/**
+ * Re-evaluates workflow preconditions with modified step outputs (read-only).
+ * Returns a result for each step in definition order.
+ * @param run        The run whose evidence to replay.
+ * @param definition The workflow definition providing step order and preconditions.
+ * @param overrides  Output field overrides to inject before re-evaluation.
+ */
+export declare function replayRun(run: RunRecord, definition: WorkflowDefinition, overrides: ReplayOverride[]): ReplayStepResult[];
+/**
+ * Persists a replay result to the store and returns the assigned replay ID.
+ * Extracted for testability — tests inject a mock ReplayStore.
+ */
+export declare function saveReplay(store: ReplayStore, runId: string, run: RunRecord, withExprs: string[], results: ReplayStepResult[]): Promise<string>;
+export declare const replayCommand: Command;
+//# sourceMappingURL=replay.d.ts.map

package/dist/commands/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/commands/replay.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,sBAAsB,EAAE,OAAO,CAAC;IAChC,uDAAuD;IACvD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAgCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAW1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,cAAc,EAAE,GAC1B,gBAAgB,EAAE,CAkCpB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,eAAO,MAAM,aAAa,SA0EtB,CAAC"}

package/dist/commands/replay.js

@@ -0,0 +1,173 @@
+// replay command — re-evaluates preconditions with modified step outputs (read-only simulation).
+import { Command } from 'commander';
+import { checkPreconditions } from '@sensigo/realm';
+import { formatPrecondColumn } from './replay-format.js';
+/** Parses a literal string into a typed value (number, boolean, or string). */
+function parseLiteralValue(raw) {
+    const t = raw.trim();
+    if (t === 'true')
+        return true;
+    if (t === 'false')
+        return false;
+    const n = Number(t);
+    if (!Number.isNaN(n) && t !== '')
+        return n;
+    if ((t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'"))) {
+        return t.slice(1, -1);
+    }
+    return t;
+}
+/**
+ * Sets a value at a dot-separated path within an object, creating
+ * intermediate objects as needed.
+ */
+function deepSet(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (typeof current[part] !== 'object' || current[part] === null) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts.at(-1)] = value;
+}
+/**
+ * Parses a --with override expression of the form "step.field=value".
+ * @throws Error if the expression is missing '.' or '='.
+ */
+export function parseOverride(expr) {
+    const eqIdx = expr.indexOf('=');
+    if (eqIdx === -1)
+        throw new Error(`Invalid override '${expr}': missing '='`);
+    const left = expr.slice(0, eqIdx);
+    const right = expr.slice(eqIdx + 1);
+    const dotIdx = left.indexOf('.');
+    if (dotIdx === -1)
+        throw new Error(`Invalid override '${expr}': missing '.'`);
+    const step = left.slice(0, dotIdx);
+    const field = left.slice(dotIdx + 1);
+    const value = parseLiteralValue(right);
+    return { step, field, value };
+}
+/**
+ * Re-evaluates workflow preconditions with modified step outputs (read-only).
+ * Returns a result for each step in definition order.
+ * @param run        The run whose evidence to replay.
+ * @param definition The workflow definition providing step order and preconditions.
+ * @param overrides  Output field overrides to inject before re-evaluation.
+ */
+export function replayRun(run, definition, overrides) {
+    // Build evidence map from run (last non-gate_response snapshot per step_id).
+    const evidenceByStep = {};
+    for (const snap of run.evidence) {
+        if (snap.kind === 'gate_response')
+            continue;
+        evidenceByStep[snap.step_id] = snap.output_summary;
+    }
+    // Build replay evidence as a deep clone, then apply overrides.
+    // structuredClone prevents nested object mutations from affecting the original evidence map.
+    const replayEvidenceByStep = {};
+    for (const [stepId, output] of Object.entries(evidenceByStep)) {
+        replayEvidenceByStep[stepId] = structuredClone(output);
+    }
+    for (const override of overrides) {
+        if (replayEvidenceByStep[override.step] === undefined) {
+            replayEvidenceByStep[override.step] = {};
+        }
+        deepSet(replayEvidenceByStep[override.step], override.field, override.value);
+    }
+    // Evaluate preconditions for each step in definition order.
+    return Object.entries(definition.steps).map(([stepId, step]) => {
+        const preconditions = step.preconditions ?? [];
+        const originalPass = checkPreconditions(preconditions, evidenceByStep) === null;
+        const replayPass = checkPreconditions(preconditions, replayEvidenceByStep) === null;
+        return {
+            step_id: stepId,
+            preconditions_original: originalPass,
+            preconditions_replay: replayPass,
+            changed: originalPass !== replayPass,
+            has_preconditions: preconditions.length > 0,
+        };
+    });
+}
+/**
+ * Persists a replay result to the store and returns the assigned replay ID.
+ * Extracted for testability — tests inject a mock ReplayStore.
+ */
+export async function saveReplay(store, runId, run, withExprs, results) {
+    const record = await store.save({
+        origin_run_id: runId,
+        workflow_id: run.workflow_id,
+        overrides: withExprs,
+        results,
+    });
+    return record.id;
+}
+export const replayCommand = new Command('replay')
+    .argument('<run-id>', 'ID of the completed run to replay')
+    .option('--with <override...>', 'Override a step output field: step.field=value')
+    .option('--save', 'Persist the replay result and print the replay ID')
+    .description('Re-evaluate preconditions with modified step outputs (read-only)')
+    .action(async (runId, opts) => {
+    const { JsonFileStore, JsonWorkflowStore } = await import('@sensigo/realm');
+    const runStore = new JsonFileStore();
+    const workflowStore = new JsonWorkflowStore();
+    let run;
+    try {
+        run = await runStore.get(runId);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    if (!run.terminal_state) {
+        console.warn(`Warning: run ${runId} is not in a terminal state. Partial replay.`);
+    }
+    let definition;
+    try {
+        definition = await workflowStore.get(run.workflow_id);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    const withExprs = opts['with'] ?? [];
+    const overrides = [];
+    for (const expr of withExprs) {
+        try {
+            overrides.push(parseOverride(expr));
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    }
+    const results = replayRun(run, definition, overrides);
+    console.log(`Replay of ${runId}`);
+    for (const override of overrides) {
+        console.log(`Override: ${override.step}.${override.field} = ${String(override.value)}`);
+    }
+    console.log('');
+    const col1 = 22;
+    const col2 = 38;
+    const header = `${'Step'.padEnd(col1)} ${'Preconditions (original \u2192 replay)'.padEnd(col2)} Changed?`;
+    const sep = `${'\u2500'.repeat(col1 - 1)}  ${'\u2500'.repeat(col2 - 1)}  ${'\u2500'.repeat(8)}`;
+    console.log(header);
+    console.log(sep);
+    for (const row of results) {
+        const step = definition.steps[row.step_id];
+        const hasPreconditions = (step?.preconditions ?? []).length > 0;
+        const precondCol = formatPrecondColumn(row.preconditions_original, row.preconditions_replay, hasPreconditions);
+        const changedCol = row.changed ? 'YES \u26A0' : 'no';
+        console.log(`${row.step_id.padEnd(col1)} ${precondCol.padEnd(col2)} ${changedCol}`);
+    }
+    if (opts.save) {
+        const { JsonFileReplayStore } = await import('../store/replay-store.js');
+        const replayStore = new JsonFileReplayStore();
+        const replayId = await saveReplay(replayStore, runId, run, withExprs, results);
+        console.log(`\nSaved replay: ${replayId}`);
+    }
+});
+//# sourceMappingURL=replay.js.map

package/dist/commands/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/commands/replay.ts"],"names":[],"mappings":"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"}

package/dist/commands/respond.d.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import type { RunStore } from '@sensigo/realm';
+import type { WorkflowRegistrar } from '@sensigo/realm';
+/**
+ * Submits a human choice response for a gate-waiting run.
+ * @param runId         The run awaiting a gate response.
+ * @param options       `gate` is the gate_id; `choice` is the selected option.
+ * @param runStore      Store holding run records.
+ * @param workflowStore Registrar for workflow definitions.
+ * @returns The choice submitted and the new run state after the gate advances.
+ */
+export declare function respondToGate(runId: string, options: {
+    gate: string;
+    choice: string;
+}, runStore: RunStore, workflowStore: WorkflowRegistrar): Promise<{
+    choice: string;
+    newState: string;
+}>;
+export declare const respondCommand: Command;
+//# sourceMappingURL=respond.d.ts.map

package/dist/commands/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../src/commands/respond.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB/C;AAED,eAAO,MAAM,cAAc,SAgBvB,CAAC"}

package/dist/commands/respond.js

@@ -0,0 +1,49 @@
+// respond command — submits a human gate response for a gate-waiting run.
+import { Command } from 'commander';
+import { WorkflowError, submitHumanResponse } from '@sensigo/realm';
+/**
+ * Submits a human choice response for a gate-waiting run.
+ * @param runId         The run awaiting a gate response.
+ * @param options       `gate` is the gate_id; `choice` is the selected option.
+ * @param runStore      Store holding run records.
+ * @param workflowStore Registrar for workflow definitions.
+ * @returns The choice submitted and the new run state after the gate advances.
+ */
+export async function respondToGate(runId, options, runStore, workflowStore) {
+    const run = await runStore.get(runId);
+    const workflow = await workflowStore.get(run.workflow_id);
+    const result = await submitHumanResponse(runStore, workflow, {
+        runId,
+        gateId: options.gate,
+        choice: options.choice,
+    });
+    if (result.status !== 'ok') {
+        throw new WorkflowError(result.errors[0] ?? 'Gate response failed', {
+            code: 'STATE_BLOCKED',
+            category: 'STATE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    const updatedRun = await runStore.get(runId);
+    return { choice: options.choice, newState: updatedRun.run_phase };
+}
+export const respondCommand = new Command('respond')
+    .description('Submit a human gate response to advance a gate-waiting run')
+    .argument('<run-id>', 'ID of the run waiting at a gate')
+    .requiredOption('--gate <gate-id>', 'Gate ID from the confirm_required response')
+    .requiredOption('--choice <choice>', 'The choice to submit (e.g. approve, reject)')
+    .action(async (runId, opts) => {
+    const { JsonFileStore, JsonWorkflowStore } = await import('@sensigo/realm');
+    const runStore = new JsonFileStore();
+    const workflowStore = new JsonWorkflowStore();
+    try {
+        const { choice, newState } = await respondToGate(runId, opts, runStore, workflowStore);
+        console.log(`Responded: ${runId} | choice '${choice}' | new state '${newState}'`);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=respond.js.map

package/dist/commands/respond.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.js","sourceRoot":"","sources":["../../src/commands/respond.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,OAAyC,EACzC,QAAkB,EAClB,aAAgC;IAEhC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE;QAC3D,KAAK;QACL,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,sBAAsB,EAAE;YAClE,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,gBAAgB;YAC7B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACjD,WAAW,CAAC,4DAA4D,CAAC;KACzE,QAAQ,CAAC,UAAU,EAAE,iCAAiC,CAAC;KACvD,cAAc,CAAC,kBAAkB,EAAE,4CAA4C,CAAC;KAChF,cAAc,CAAC,mBAAmB,EAAE,6CAA6C,CAAC;KAClF,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAsC,EAAE,EAAE;IACtE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,cAAc,MAAM,kBAAkB,QAAQ,GAAG,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/resume.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import type { RunStore } from '@sensigo/realm';
+import type { WorkflowRegistrar } from '@sensigo/realm';
+/**
+ * Removes `stepName` from `failed_steps` so the DAG engine can re-evaluate its
+ * eligibility on the next execute-step call.
+ *
+ * @param runId         The run to resume.
+ * @param stepName      The failed step to re-enable.
+ * @param runStore      Store holding run records.
+ * @param workflowStore Registrar for workflow definitions.
+ */
+export declare function resumeRun(runId: string, stepName: string, runStore: RunStore, workflowStore: WorkflowRegistrar): Promise<void>;
+export declare const resumeCommand: Command;
+//# sourceMappingURL=resume.d.ts.map

package/dist/commands/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,iBAAiB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,eAAO,MAAM,aAAa,SAetB,CAAC"}