@sensigo/realm-cli 0.1.0

package/dist/commands/diff.js

@@ -0,0 +1,203 @@
+// diff command — compares the evidence chains of two runs side by side.
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { formatPrecondColumn } from './replay-format.js';
+/** Returns true when the given ID is a replay ID (starts with "rpl_"). */
+export function isReplayId(id) {
+    return id.startsWith('rpl_');
+}
+/** Formats a single replay result for the diff column. */
+function formatReplayColumn(result) {
+    if (result === undefined)
+        return 'missing';
+    return formatPrecondColumn(result.preconditions_original, result.preconditions_replay, result.has_preconditions);
+}
+/**
+ * Compares step-level precondition results from two replay records.
+ * @param recordA First replay record.
+ * @param recordB Second replay record.
+ */
+export function diffReplays(recordA, recordB) {
+    const mapA = new Map(recordA.results.map((r) => [r.step_id, r]));
+    const mapB = new Map(recordB.results.map((r) => [r.step_id, r]));
+    const allSteps = new Set();
+    for (const r of recordA.results)
+        allSteps.add(r.step_id);
+    for (const r of recordB.results)
+        allSteps.add(r.step_id);
+    return Array.from(allSteps).map((stepId) => {
+        const a = mapA.get(stepId);
+        const b = mapB.get(stepId);
+        const precond_a = formatReplayColumn(a);
+        const precond_b = formatReplayColumn(b);
+        return { step_id: stepId, precond_a, precond_b, differs: precond_a !== precond_b };
+    });
+}
+/**
+ * Compares evidence chains of two runs, producing a row per unique step.
+ * @param runA First run to compare.
+ * @param runB Second run to compare.
+ */
+export function diffRuns(runA, runB) {
+    // Build last non-gate_response snapshot per step_id for each run.
+    const lastA = new Map();
+    const lastB = new Map();
+    for (const snap of runA.evidence) {
+        if (snap.kind === 'gate_response')
+            continue;
+        lastA.set(snap.step_id, snap);
+    }
+    for (const snap of runB.evidence) {
+        if (snap.kind === 'gate_response')
+            continue;
+        lastB.set(snap.step_id, snap);
+    }
+    // Collect all unique step IDs, preserving appearance order from A then B.
+    const allSteps = new Set();
+    for (const id of lastA.keys())
+        allSteps.add(id);
+    for (const id of lastB.keys())
+        allSteps.add(id);
+    return Array.from(allSteps).map((stepId) => {
+        const snapA = lastA.get(stepId);
+        const snapB = lastB.get(stepId);
+        const statusA = snapA?.status ?? 'missing';
+        const statusB = snapB?.status ?? 'missing';
+        return {
+            step_id: stepId,
+            status_a: statusA,
+            status_b: statusB,
+            hash_a: snapA?.evidence_hash ?? '\u2014',
+            hash_b: snapB?.evidence_hash ?? '\u2014',
+            duration_a_ms: snapA?.duration_ms ?? 0,
+            duration_b_ms: snapB?.duration_ms ?? 0,
+            same_output: snapA !== undefined && snapB !== undefined && snapA.evidence_hash === snapB.evidence_hash,
+            same_status: statusA === statusB,
+        };
+    });
+}
+/** Applies chalk coloring to a status value in a diff row. */
+function colorDiffStatus(status) {
+    if (status === 'error' || status === 'missing')
+        return chalk.red(status);
+    return status;
+}
+/** Returns the comparison symbol between A and B columns. */
+function diffSymbol(row) {
+    if (row.status_a === 'missing' || row.status_b === 'missing')
+        return ' ';
+    if (row.same_output && row.same_status)
+        return '=';
+    return chalk.yellow('\u2260');
+}
+/** Formats Δ ms: signed difference if both steps exist, em-dash otherwise. */
+function formatDelta(row) {
+    if (row.status_a === 'missing' || row.status_b === 'missing')
+        return '\u2014';
+    const delta = row.duration_b_ms - row.duration_a_ms;
+    if (delta === 0)
+        return '0';
+    return delta > 0 ? `+${delta}` : String(delta);
+}
+export const diffCommand = new Command('diff')
+    .argument('<run-id-a>', 'First run or replay ID')
+    .argument('<run-id-b>', 'Second run or replay ID')
+    .description('Compare evidence chains of two runs side by side')
+    .action(async (runIdA, runIdB) => {
+    if (isReplayId(runIdA) !== isReplayId(runIdB)) {
+        console.error('Error: cannot diff a run against a replay. Provide two run IDs or two replay IDs.');
+        process.exit(1);
+    }
+    if (isReplayId(runIdA) && isReplayId(runIdB)) {
+        const { JsonFileReplayStore } = await import('../store/replay-store.js');
+        const replayStore = new JsonFileReplayStore();
+        let recordA;
+        let recordB;
+        try {
+            recordA = await replayStore.get(runIdA);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+        try {
+            recordB = await replayStore.get(runIdB);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+        const rows = diffReplays(recordA, recordB);
+        console.log(`Replay diff: ${runIdA}  vs  ${runIdB}`);
+        console.log(`Origin runs: ${recordA.origin_run_id}  vs  ${recordB.origin_run_id}`);
+        if (recordA.overrides.length === 0) {
+            console.log('Overrides A: (none)');
+        }
+        else {
+            for (const ov of recordA.overrides)
+                console.log(`Overrides A: ${ov}`);
+        }
+        if (recordB.overrides.length === 0) {
+            console.log('Overrides B: (none)');
+        }
+        else {
+            for (const ov of recordB.overrides)
+                console.log(`Overrides B: ${ov}`);
+        }
+        console.log('');
+        const col1 = 22;
+        const col2 = 38;
+        const sep1 = '\u2500'.repeat(col1 - 1);
+        const sep2 = '\u2500'.repeat(col2 - 1);
+        console.log(`${'Step'.padEnd(col1)} ${'Replay A'.padEnd(col2)} ${'Replay B'.padEnd(col2)} Diff?`);
+        console.log(`${sep1}  ${sep2}  ${sep2}  ${'\u2500'.repeat(5)}`);
+        for (const row of rows) {
+            const diffCol = row.differs ? chalk.yellow('\u2260') : '=';
+            console.log(`${row.step_id.padEnd(col1)} ${row.precond_a.padEnd(col2)} ${row.precond_b.padEnd(col2)} ${diffCol}`);
+        }
+        return;
+    }
+    const { JsonFileStore } = await import('@sensigo/realm');
+    const store = new JsonFileStore();
+    let runA;
+    let runB;
+    try {
+        runA = await store.get(runIdA);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    try {
+        runB = await store.get(runIdB);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    if (runA.workflow_id !== runB.workflow_id) {
+        console.warn(`Warning: runs are from different workflows (${runA.workflow_id} vs ${runB.workflow_id})`);
+    }
+    const rows = diffRuns(runA, runB);
+    console.log(`Diff: ${runIdA}  vs  ${runIdB}`);
+    console.log(`Workflow: ${runA.workflow_id}`);
+    console.log('');
+    const col1 = 22;
+    const col2 = 10;
+    const col3 = 10;
+    const sep1 = '\u2500'.repeat(col1 - 1);
+    const sep2 = '\u2500'.repeat(col2 - 1);
+    const sep3 = '\u2500'.repeat(col3 - 1);
+    console.log(`${'Step'.padEnd(col1)} ${'A status'.padEnd(col2 + 2)} ${'B status'.padEnd(col2)} ${'A hash'.padEnd(col2)} ${'B hash'.padEnd(col2)} ${'\u0394 ms'}`);
+    console.log(`${sep1}  ${sep2}  ${sep2}  ${sep2}  ${sep2}  ${sep3}`);
+    for (const row of rows) {
+        const sym = diffSymbol(row);
+        const statusA = colorDiffStatus(row.status_a).padEnd(col2);
+        const statusB = colorDiffStatus(row.status_b).padEnd(col2);
+        const hashA = row.hash_a.slice(0, 8).padEnd(col2);
+        const hashB = row.hash_b.slice(0, 8).padEnd(col2);
+        const delta = formatDelta(row);
+        console.log(`${row.step_id.padEnd(col1)} ${statusA} ${sym} ${statusB} ${hashA} ${hashB} ${delta}`);
+    }
+});
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+/**
+ * Scaffolds a new workflow project at targetDir with four template files.
+ * Throws an error if targetDir already exists.
+ * @param name      Workflow project name used in file contents.
+ * @param targetDir Directory to create (defaults to join(cwd, name) in the command action).
+ */
+export declare function initWorkflow(name: string, targetDir: string): Promise<void>;
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyEjF;AAED,eAAO,MAAM,WAAW,SAmBpB,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,97 @@
+// init command — scaffolds a new workflow project directory.
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { Command } from 'commander';
+/**
+ * Scaffolds a new workflow project at targetDir with four template files.
+ * Throws an error if targetDir already exists.
+ * @param name      Workflow project name used in file contents.
+ * @param targetDir Directory to create (defaults to join(cwd, name) in the command action).
+ */
+export async function initWorkflow(name, targetDir) {
+    if (existsSync(targetDir)) {
+        throw new Error(`Directory already exists: ${targetDir}`);
+    }
+    await mkdir(targetDir, { recursive: true });
+    const workflowYaml = `# ${name} workflow
+id: ${name}
+name: "${name}"
+version: 1
+initial_state: created
+
+steps:
+  step_one:
+    description: "First step \u2014 replace with your own"
+    execution: agent
+    allowed_from_states: [created]
+    produces_state: step_one_done
+    input_schema:
+      type: object
+      required: [result]
+      properties:
+        result:
+          type: string
+
+  finalize:
+    description: "Final step"
+    execution: auto
+    allowed_from_states: [step_one_done]
+    produces_state: completed
+`;
+    const schemaJson = JSON.stringify({
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        type: 'object',
+        properties: {},
+        additionalProperties: true,
+    }, null, 2);
+    const envExample = `# Add your secrets here
+# EXAMPLE_API_KEY=your_key_here
+`;
+    const readmeMd = `# ${name}
+
+A Realm workflow.
+
+## Run
+
+\`\`\`bash
+realm workflow validate ./
+realm workflow register ./
+realm workflow run ./
+\`\`\`
+
+## Test
+
+Add fixtures to \`fixtures/\` and run:
+
+\`\`\`bash
+realm workflow test ./ --fixtures ./fixtures/
+\`\`\`
+`;
+    await writeFile(join(targetDir, 'workflow.yaml'), workflowYaml, 'utf8');
+    await writeFile(join(targetDir, 'schema.json'), schemaJson + '\n', 'utf8');
+    await writeFile(join(targetDir, '.env.example'), envExample, 'utf8');
+    await writeFile(join(targetDir, 'README.md'), readmeMd, 'utf8');
+}
+export const initCommand = new Command('init')
+    .argument('<name>', 'Workflow project name (becomes the directory name)')
+    .description('Scaffold a new workflow project')
+    .action(async (name) => {
+    const { join: pathJoin } = await import('node:path');
+    const targetDir = pathJoin(process.cwd(), name);
+    try {
+        await initWorkflow(name, targetDir);
+        console.log(`Created: ${name}/`);
+        console.log('  workflow.yaml');
+        console.log('  schema.json');
+        console.log('  .env.example');
+        console.log('  README.md');
+        console.log('');
+        console.log(`Next: realm workflow validate ./${name}/`);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/inspect.d.ts

@@ -0,0 +1,14 @@
+import { Command } from 'commander';
+import type { RunStore, WorkflowRegistrar } from '@sensigo/realm';
+/**
+ * Formats and returns a colored inspection report for a workflow run.
+ * @param runId         The ID of the run to inspect.
+ * @param store         Store holding run records.
+ * @param workflowStore Registrar for workflow definitions.
+ * @param options       Optional rendering options (e.g. verbose tool call output).
+ */
+export declare function inspectRun(runId: string, store: RunStore, workflowStore: WorkflowRegistrar, options?: {
+    verbose?: boolean;
+}): Promise<string>;
+export declare const inspectCommand: Command;
+//# sourceMappingURL=inspect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EAER,iBAAiB,EAGlB,MAAM,gBAAgB,CAAC;AA8BxB;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,iBAAiB,EAChC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,CAiMjB;AAED,eAAO,MAAM,cAAc,SAoBvB,CAAC"}

package/dist/commands/inspect.js

@@ -0,0 +1,224 @@
+// inspect command — displays the full evidence chain and diagnostics for a run.
+import chalk from 'chalk';
+import { Command } from 'commander';
+/** Truncates a JSON-serialised summary to a readable single line. */
+function formatSummary(value, maxLength = 120) {
+    const raw = JSON.stringify(value);
+    if (raw.length <= maxLength)
+        return raw;
+    return raw.slice(0, maxLength) + chalk.dim('…');
+}
+/** Formats a diagnostics object into a readable string for the inspect output. */
+function formatDiagnostics(diag) {
+    const tokens = `~${diag.input_token_estimate} tokens`;
+    if (diag.precondition_trace.length === 0) {
+        return `${tokens} | no preconditions`;
+    }
+    const traceStr = diag.precondition_trace
+        .map((t) => `${t.expression} \u2192 ${t.passed ? 'true' : 'false'} (${String(t.resolved_value)})`)
+        .join(', ');
+    return `${tokens} | preconditions: ${traceStr}`;
+}
+/** Applies chalk color to a step status string. */
+function colorStatus(status) {
+    if (status === 'success')
+        return chalk.green(status);
+    if (status === 'error')
+        return chalk.red(status);
+    return chalk.yellow(status);
+}
+/**
+ * Formats and returns a colored inspection report for a workflow run.
+ * @param runId         The ID of the run to inspect.
+ * @param store         Store holding run records.
+ * @param workflowStore Registrar for workflow definitions.
+ * @param options       Optional rendering options (e.g. verbose tool call output).
+ */
+export async function inspectRun(runId, store, workflowStore, options) {
+    const run = await store.get(runId);
+    // Try to load workflow definition; gracefully handle missing definition.
+    let workflowLabel;
+    let definitionMissing = false;
+    try {
+        const def = await workflowStore.get(run.workflow_id);
+        workflowLabel = `${def.id} v${def.version}`;
+    }
+    catch {
+        workflowLabel = run.workflow_id;
+        definitionMissing = true;
+    }
+    // Color the phase label.
+    let phaseLabel;
+    if (run.run_phase === 'completed') {
+        phaseLabel = chalk.green(`${run.run_phase}  \u2713`);
+    }
+    else if (run.run_phase === 'failed' || run.run_phase === 'abandoned') {
+        phaseLabel = chalk.red(run.run_phase);
+    }
+    else {
+        phaseLabel = chalk.yellow(run.run_phase);
+    }
+    const lines = [];
+    lines.push(`Run: ${run.id}`);
+    lines.push(`Workflow: ${workflowLabel}`);
+    lines.push(`Phase: ${phaseLabel}`);
+    lines.push(`Completed: ${run.completed_steps.join(', ') || '(none)'}`);
+    lines.push(`In Progress: ${run.in_progress_steps.join(', ') || '(none)'}`);
+    lines.push(`Failed: ${run.failed_steps.join(', ') || '(none)'}`);
+    lines.push(`Skipped: ${run.skipped_steps.join(', ') || '(none)'}`);
+    lines.push(`Created: ${run.created_at}`);
+    lines.push(`Updated: ${run.updated_at}`);
+    if (definitionMissing) {
+        lines.push('');
+        lines.push('(workflow definition not found \u2014 showing run record only)');
+    }
+    // Group evidence snapshots by step_id, preserving first-appearance order.
+    const stepOrder = [];
+    const stepSnapshots = new Map();
+    for (const snap of run.evidence) {
+        if (!stepSnapshots.has(snap.step_id)) {
+            stepOrder.push(snap.step_id);
+            stepSnapshots.set(snap.step_id, []);
+        }
+        stepSnapshots.get(snap.step_id).push(snap);
+    }
+    // Run-level trace aggregation — summarise across all evidence snapshots.
+    const allSnaps = run.evidence;
+    const snapsWithTrace = allSnaps.filter((s) => s.trace !== undefined && s.trace.length > 0);
+    if (snapsWithTrace.length > 0) {
+        const stepsWithTrace = snapsWithTrace.length;
+        const stepsWithTraceUnique = new Set(snapsWithTrace.map((s) => s.step_id)).size;
+        const storedEntriesTotal = allSnaps.reduce((acc, s) => acc + (s.trace_summary?.stored_entries ?? 0), 0);
+        const discardedEntriesTotal = allSnaps.reduce((acc, s) => acc + (s.trace_summary?.discarded_entries ?? 0), 0);
+        const truncatedSteps = allSnaps.filter((s) => s.trace_summary?.truncated === true).length;
+        // Frequency map of events across all stored trace entries (excluding sentinel).
+        const eventFreq = new Map();
+        for (const snap of allSnaps) {
+            for (const entry of snap.trace ?? []) {
+                if (entry.event === 'trace.truncated')
+                    continue;
+                eventFreq.set(entry.event, (eventFreq.get(entry.event) ?? 0) + 1);
+            }
+        }
+        const topEvents = [...eventFreq.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([event, count]) => `${event} (${count})`);
+        lines.push('');
+        lines.push('Trace Summary:');
+        lines.push(`  steps_with_trace:        ${stepsWithTrace}`);
+        lines.push(`  steps_with_trace_unique: ${stepsWithTraceUnique}`);
+        lines.push(`  stored_entries_total:   ${storedEntriesTotal}`);
+        lines.push(`  discarded_entries_total:${discardedEntriesTotal}`);
+        lines.push(`  truncated_steps:        ${truncatedSteps}`);
+        if (topEvents.length > 0) {
+            lines.push(`  top_events:             ${topEvents.join(', ')}`);
+        }
+    }
+    lines.push('');
+    lines.push(`Evidence (${stepOrder.length} steps):`);
+    stepOrder.forEach((stepId, idx) => {
+        const snaps = stepSnapshots.get(stepId);
+        const hasAttempts = snaps.length > 1 && snaps.some((s) => s.attempt !== undefined);
+        const totalAttempts = snaps.length;
+        lines.push('');
+        if (hasAttempts) {
+            // Show step name as header, then each attempt as a sub-item.
+            lines.push(`  ${idx + 1}. ${stepId}`);
+            snaps.forEach((snap, ai) => {
+                const statusColored = colorStatus(snap.status);
+                const hashShort = chalk.dim(`hash: ${snap.evidence_hash.slice(0, 8)}`);
+                lines.push(`     (attempt ${ai + 1}/${totalAttempts})  ${statusColored}   ${snap.duration_ms}ms   ${hashShort}`);
+            });
+            // Show Input/Output/Diagnostics for the last attempt.
+            const lastSnap = snaps[snaps.length - 1];
+            lines.push(`     Input:  ${formatSummary(lastSnap.input_summary)}`);
+            if (lastSnap.resolved_params !== undefined) {
+                lines.push(`     Resolved: ${formatSummary(lastSnap.resolved_params)}`);
+            }
+            lines.push(`     Output: ${formatSummary(lastSnap.output_summary)}`);
+            if (lastSnap.trace !== undefined) {
+                lines.push(`     Trace:  ${lastSnap.trace.length} entries (not hashed).`);
+                if (lastSnap.trace_summary?.truncated) {
+                    const s = lastSnap.trace_summary;
+                    lines.push(chalk.yellow(`     ⚠ Trace truncated (${s.truncation_reason ?? 'unknown'}): ${s.stored_entries} stored, ${s.discarded_entries} discarded.`));
+                }
+            }
+            if (lastSnap.diagnostics !== undefined) {
+                lines.push(chalk.dim(`     Diagnostics: ${formatDiagnostics(lastSnap.diagnostics)}`));
+            }
+        }
+        else {
+            const snap = snaps[0];
+            const statusColored = colorStatus(snap.status);
+            const hashShort = chalk.dim(`hash: ${snap.evidence_hash.slice(0, 8)}`);
+            const kindLabel = snap.kind === 'gate_response' ? chalk.cyan(' gate_response') : '';
+            const profileLabel = snap.agent_profile !== undefined ? chalk.cyan(` [profile: ${snap.agent_profile}]`) : '';
+            lines.push(`  ${idx + 1}. ${stepId.padEnd(22)}${profileLabel}${kindLabel} ${statusColored}   ${snap.duration_ms}ms   ${hashShort}`);
+            if (snap.kind === 'gate_response') {
+                const choice = snap.input_summary['choice'] ?? snap.output_summary['choice'];
+                if (choice !== undefined) {
+                    lines.push(`     Choice:   ${String(choice)}`);
+                }
+                if (snap.gate_message !== undefined) {
+                    lines.push(`     Message:  "${snap.gate_message}"`);
+                }
+                lines.push(`     Output:   ${formatSummary(snap.output_summary)}`);
+            }
+            else {
+                lines.push(`     Input:  ${formatSummary(snap.input_summary)}`);
+                if (snap.resolved_params !== undefined) {
+                    lines.push(`     Resolved: ${formatSummary(snap.resolved_params)}`);
+                }
+                lines.push(`     Output: ${formatSummary(snap.output_summary)}`);
+                if (snap.trace !== undefined) {
+                    lines.push(`     Trace:  ${snap.trace.length} entries (not hashed).`);
+                    if (snap.trace_summary?.truncated) {
+                        const s = snap.trace_summary;
+                        lines.push(chalk.yellow(`     ⚠ Trace truncated (${s.truncation_reason ?? 'unknown'}): ${s.stored_entries} stored, ${s.discarded_entries} discarded.`));
+                    }
+                }
+                if (snap.tool_calls === undefined) {
+                    // callStep path — print nothing
+                }
+                else if (snap.tool_calls.length === 0) {
+                    lines.push('     Tools declared, none called');
+                }
+                else {
+                    lines.push(`     Tool calls (${snap.tool_calls.length}):`);
+                    for (const tc of snap.tool_calls) {
+                        const errSuffix = tc.error ? `  error: ${tc.error}` : '';
+                        lines.push(`       [${tc.server_id}:${tc.tool}]  ${tc.duration_ms}ms${errSuffix}`);
+                        if (options?.verbose) {
+                            lines.push(`         args:   ${formatSummary(tc.args)}`);
+                            const resultStr = typeof tc.result === 'string' ? tc.result : '(null)';
+                            lines.push(`         result: ${resultStr}`);
+                        }
+                    }
+                }
+                if (snap.diagnostics !== undefined) {
+                    lines.push(chalk.dim(`     Diagnostics: ${formatDiagnostics(snap.diagnostics)}`));
+                }
+            }
+        }
+    });
+    return lines.join('\n');
+}
+export const inspectCommand = new Command('inspect')
+    .argument('<run-id>', 'ID of the run to inspect')
+    .description('Display the full evidence chain and diagnostics for a run')
+    .option('--verbose', 'Show full tool call args and results')
+    .action(async (runId, cmdOpts) => {
+    const { JsonFileStore, JsonWorkflowStore } = await import('@sensigo/realm');
+    const store = new JsonFileStore();
+    const workflowStore = new JsonWorkflowStore();
+    try {
+        const output = await inspectRun(runId, store, workflowStore, cmdOpts.verbose === true ? { verbose: true } : undefined);
+        console.log(output);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+import type { RunStore, RunPhase } from '@sensigo/realm';
+/**
+ * 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 declare function formatGateAge(openedAt: string, now?: Date): string;
+/**
+ * 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 declare function listRuns(workflowId: string | undefined, store: RunStore, statusFilter?: RunPhase): Promise<string>;
+export declare const listCommand: Command;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAa,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAUpE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAa9E;AAID;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,QAAQ,EACf,YAAY,CAAC,EAAE,QAAQ,GACtB,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED,eAAO,MAAM,WAAW,SA0BpB,CAAC"}