@jcr-adk/cli 2.0.0

package/dist/lifecycle-artifacts.js

@@ -0,0 +1,160 @@
+/**
+ * Lifecycle artifact helpers — init/plan/run/sync CLI.
+ *
+ * Reuses core path resolution (`resolveAdkConfig`, `resolveSpecDir`, `joinWithinRoot`)
+ * so workspace boundary rules stay consistent with the rest of the harness.
+ */
+import { access, appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { defaultAdkConfigFile, parseAdkConfigFile, resolveAdkConfig, resolveAdkPaths, resolveSpecDir, } from "@jcr-adk/core";
+/** True when the path exists and is accessible. */
+export async function pathExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Load workspace config from disk when present; otherwise default v1 layout. */
+export async function loadWorkspaceConfig(workspaceRoot) {
+    const paths = resolveAdkPaths(workspaceRoot);
+    if (!(await pathExists(paths.configFilePath))) {
+        return resolveAdkConfig(workspaceRoot);
+    }
+    const raw = JSON.parse(await readFile(paths.configFilePath, "utf8"));
+    const parsed = parseAdkConfigFile(raw);
+    if (!parsed.ok) {
+        throw new Error(`invalid adk.json: ${parsed.message}`);
+    }
+    return resolveAdkConfig(workspaceRoot, parsed.config);
+}
+/** Resolve standard spec artifact paths under `.jcr-adk/specs/{specId}/`. */
+export function resolveSpecArtifactPaths(config, specId) {
+    const specDirResult = resolveSpecDir(config, specId);
+    if (!specDirResult.ok) {
+        throw new Error(specDirResult.message);
+    }
+    const specDir = specDirResult.absolutePath;
+    return {
+        specDir,
+        specMd: `${specDir}/spec.md`,
+        planMd: `${specDir}/plan.md`,
+        acceptanceJson: `${specDir}/acceptance.json`,
+        metadataJson: `${specDir}/metadata.json`,
+        progressJsonl: `${specDir}/progress.jsonl`,
+    };
+}
+/** Write JSON with optional overwrite (`force`). */
+export async function writeJsonArtifact(filePath, data, force) {
+    const exists = await pathExists(filePath);
+    if (exists && !force)
+        return "existing";
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+    return exists ? "written" : "created";
+}
+/** Write text with optional overwrite (`force`). */
+export async function writeTextArtifact(filePath, content, force) {
+    const exists = await pathExists(filePath);
+    if (exists && !force)
+        return "existing";
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, content.endsWith("\n") ? content : `${content}\n`, "utf8");
+    return exists ? "written" : "created";
+}
+/** Create directory when missing; returns whether it was newly created. */
+export async function ensureDir(dirPath) {
+    const exists = await pathExists(dirPath);
+    await mkdir(dirPath, { recursive: true });
+    return !exists;
+}
+/** Read and parse spec metadata.json. */
+export async function readSpecMetadata(metadataPath) {
+    return JSON.parse(await readFile(metadataPath, "utf8"));
+}
+/** Append one JSONL progress line (command-controlled write — MVP v1). */
+export async function appendProgressLine(filePath, entry) {
+    await mkdir(dirname(filePath), { recursive: true });
+    await appendFile(filePath, `${JSON.stringify(entry)}\n`, "utf8");
+}
+/** Build default v1 config file for `jcr-adk init`. */
+export function buildInitConfigFile(projectId) {
+    return defaultAdkConfigFile(projectId);
+}
+/** Standard init scaffold paths derived from workspace root. */
+export function resolveInitPaths(workspaceRoot) {
+    const paths = resolveAdkPaths(workspaceRoot);
+    return {
+        configFile: paths.configFilePath,
+        specsDir: paths.specsDir,
+        logsDir: paths.logsDir,
+        gateReportsDir: paths.gateReportsDir,
+    };
+}
+/** Template builders for `jcr-adk plan`. */
+export function buildPlanSpecMarkdown(specId, title, intent) {
+    const intentBlock = intent?.trim()
+        ? `\n## Intent\n\n${intent.trim()}\n`
+        : "\n## Intent\n\nGenerated by `jcr-adk plan` (template MVP).\n";
+    return `# ${title}
+
+> Spec ID: ${specId}
+
+${intentBlock}
+## Acceptance Criteria
+
+| ID | Description |
+|----|-------------|
+| AC-01 | Doctor diagnostics pass in workspace |
+| AC-02 | Guarded tool pipeline records audit events |
+| AC-03 | Gate PASS seals reportHash and updates metadata |
+`;
+}
+export function buildPlanMarkdown(specId) {
+    return `# Plan — ${specId}
+
+## Steps
+
+1. **Plan**: Scaffold SPEC/PLAN/AC under .jcr-adk/specs/
+2. **Run**: Execute agent via jcr-adk run (dry-run or live guarded SDK)
+3. **Sync**: Run gate with evidence-backed acceptance; update metadata
+
+## Notes
+
+- Template-based MVP plan (no LLM generation in v1).
+`;
+}
+export function buildPlanAcceptanceJson(specId) {
+    return {
+        specId,
+        items: [
+            {
+                id: "AC-01",
+                description: "Doctor diagnostics pass",
+                evidencePath: "evidence/ac-01-pass.json",
+            },
+            {
+                id: "AC-02",
+                description: "Audit events recorded for tool pipeline",
+                evidencePath: "evidence/ac-01-pass.json",
+            },
+            {
+                id: "AC-03",
+                description: "Gate PASS with reportHash",
+                evidencePath: "evidence/ac-01-pass.json",
+            },
+        ],
+    };
+}
+export function buildPlannedMetadata(specId, now = new Date()) {
+    const ts = now.toISOString();
+    return {
+        specId,
+        status: "planned",
+        createdAt: ts,
+        updatedAt: ts,
+    };
+}
+//# sourceMappingURL=lifecycle-artifacts.js.map

package/dist/lifecycle-artifacts.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI entrypoint — `jcr-adk` command dispatcher.
+ *
+ * Core-stage commands:
+ *   doctor  read-only diagnostics (CMD-02R)
+ *   gate    verifier-controlled mutation (G-02)
+ *   tool    guarded tool execution via GuardedToolExecutor (M5)
+ *
+ * MVP Full lifecycle commands:
+ *   init    scaffold `.jcr-adk` layout
+ *   plan    template SPEC/PLAN/AC/metadata
+ *   run     guarded SDK runner (dry-run default, live opt-in)
+ *   sync    gate PASS → metadata/progress/sync-summary
+ *   audit   read-only event/gate/policy summary (CMD-03R)
+ *   replay  read-only JSONL run replay (SR-09)
+ *   explain-fail  read-only failure explanation (DAC-008)
+ *   handoff  read-only handoff package (DAC-006)
+ *   review-pack  read-only reviewer evidence bundle (DAC-007)
+ */
+export interface RunCliOptions {
+    readonly stdout?: (line: string) => void;
+    readonly stderr?: (line: string) => void;
+    readonly env?: Record<string, string | undefined>;
+}
+/**
+ * Run the CLI and return a process exit code.
+ * Does not call process.exit — safe for tests.
+ */
+export declare function runCli(argv: readonly string[], options?: RunCliOptions): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAoDH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoFlG"}

package/dist/main.js

@@ -0,0 +1,159 @@
+/**
+ * CLI entrypoint — `jcr-adk` command dispatcher.
+ *
+ * Core-stage commands:
+ *   doctor  read-only diagnostics (CMD-02R)
+ *   gate    verifier-controlled mutation (G-02)
+ *   tool    guarded tool execution via GuardedToolExecutor (M5)
+ *
+ * MVP Full lifecycle commands:
+ *   init    scaffold `.jcr-adk` layout
+ *   plan    template SPEC/PLAN/AC/metadata
+ *   run     guarded SDK runner (dry-run default, live opt-in)
+ *   sync    gate PASS → metadata/progress/sync-summary
+ *   audit   read-only event/gate/policy summary (CMD-03R)
+ *   replay  read-only JSONL run replay (SR-09)
+ *   explain-fail  read-only failure explanation (DAC-008)
+ *   handoff  read-only handoff package (DAC-006)
+ *   review-pack  read-only reviewer evidence bundle (DAC-007)
+ */
+import { parseArgv } from "./argv.js";
+import { runAuditCommand } from "./commands/audit.js";
+import { runDoctorCommand } from "./commands/doctor.js";
+import { runGateCommand } from "./commands/gate.js";
+import { runInitCommand } from "./commands/init.js";
+import { runPlanCommand } from "./commands/plan.js";
+import { runRunCommand } from "./commands/run.js";
+import { runReplayCommand } from "./commands/replay.js";
+import { runExplainFailCommand } from "./commands/explain-fail.js";
+import { runHandoffCommand } from "./commands/handoff.js";
+import { runReviewPackCommand } from "./commands/review-pack.js";
+import { runSyncCommand } from "./commands/sync.js";
+import { runToolCommand } from "./commands/tool.js";
+import { fileURLToPath } from "node:url";
+const HELP = `jcr-adk — Cursor ADK Core CLI
+
+Usage:
+  jcr-adk init [--workspace <path>] [--project-id <id>] [--force]
+  jcr-adk plan [--workspace <path>] [--spec-id <id>] [--title <text>] [--intent <text>] [--force]
+  jcr-adk run --spec-id <id> [--workspace <path>] [--run-id <id>] [--dry-run] [--live] [--prompt <text>]
+  jcr-adk sync <specId> [--run-id <id>] [--acceptance-file <path>]
+  jcr-adk audit [specId] [--run-id <id>] [--workspace <path>]
+  jcr-adk replay <runId> [--spec-id <id>] [--workspace <path>]
+  jcr-adk explain-fail <gateId|runId> [--spec-id <id>] [--workspace <path>]
+  jcr-adk handoff <specId> [--workspace <path>] [--write] [--markdown]
+  jcr-adk review-pack <specId> [--workspace <path>] [--write] [--markdown]
+  jcr-adk doctor [--workspace <path>]
+  jcr-adk gate <specId> [--gate-id <id>] [--run-id <id>] [--acceptance <json>]
+  jcr-adk tool <toolName> --spec-id <id> [--target-path <path>] [--shell-command <cmd>] [--args <json>]
+
+Global flags:
+  --workspace, -w   Workspace root (default: cwd)
+  --help, -h        Show this help
+
+Examples:
+  jcr-adk init
+  jcr-adk plan --spec-id SPEC-001 --title "Hello ADK"
+  jcr-adk run --spec-id SPEC-001 --dry-run
+  jcr-adk sync SPEC-001 --acceptance-file acceptance/gate-items.json
+  jcr-adk audit SPEC-001
+  jcr-adk replay RUN-001 --spec-id SPEC-001
+  jcr-adk explain-fail GATE-SPEC-001 --spec-id SPEC-001
+  jcr-adk handoff SPEC-001
+  jcr-adk review-pack SPEC-001 --write
+  jcr-adk doctor
+  jcr-adk gate SPEC-001 --acceptance '[{"id":"A1","description":"ok","evidencePath":"fixtures/a1.json","passed":true}]'
+  jcr-adk tool adk_spec_read --spec-id SPEC-001
+`;
+/**
+ * Run the CLI and return a process exit code.
+ * Does not call process.exit — safe for tests.
+ */
+export async function runCli(argv, options = {}) {
+    const writeOut = options.stdout ?? ((line) => console.log(line));
+    const writeErr = options.stderr ?? ((line) => console.error(line));
+    const env = options.env ?? process.env;
+    const parsed = parseArgv(argv);
+    if (parsed.flags.help === true || parsed.flags.h === true || parsed.command === "help") {
+        writeOut(HELP.trimEnd());
+        return 0;
+    }
+    if (!parsed.command) {
+        writeErr("error: missing command\n");
+        writeErr(HELP.trimEnd());
+        return 2;
+    }
+    switch (parsed.command) {
+        case "init": {
+            const result = await runInitCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "plan": {
+            const result = await runPlanCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "run": {
+            const result = await runRunCommand(parsed, env);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "sync": {
+            const result = await runSyncCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "audit": {
+            const result = await runAuditCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "replay": {
+            const result = await runReplayCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "explain-fail": {
+            const result = await runExplainFailCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "handoff": {
+            const result = await runHandoffCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "review-pack": {
+            const result = await runReviewPackCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "doctor": {
+            const result = runDoctorCommand(parsed, env);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "gate": {
+            const result = await runGateCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        case "tool": {
+            const result = await runToolCommand(parsed);
+            writeOut(result.output);
+            return result.exitCode;
+        }
+        default: {
+            writeErr(`error: unknown command '${parsed.command}'\n`);
+            writeErr(HELP.trimEnd());
+            return 2;
+        }
+    }
+}
+/** Direct execution: `node --import tsx src/main.ts ...` or `pnpm jcr-adk ...` */
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    const code = await runCli(process.argv.slice(2));
+    process.exit(code);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/permissions.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Command Permission Matrix — CMD-02A/B/02R / DF-09
+ * SSOT: 22-command-specification-design.md §Permission Matrix
+ *
+ * Ported from spikes/core-p0-verify/src/lib/command-permission-matrix.ts (PR-009).
+ */
+/** High-level command classification. */
+export type CommandType = "read/report" | "report" | "verifier" | "lifecycle";
+/** One row in the permission matrix. */
+export interface CommandPermission {
+    readonly command: string;
+    readonly type: CommandType;
+    /** True = command may write lifecycle artifacts. */
+    readonly mutatesState: boolean;
+    /** True = verifier gate must run before command completes. */
+    readonly requiresGate: boolean;
+    /** True = human approval required before execution. */
+    readonly requiresApproval: boolean;
+    readonly output: string;
+}
+/**
+ * Canonical command permission matrix.
+ * All `read/report` commands must have mutatesState=false (CMD-02B invariant).
+ */
+export declare const COMMAND_PERMISSION_MATRIX: readonly CommandPermission[];
+/** Look up permission entry for a command. Returns undefined for unknown commands. */
+export declare function getCommandPermission(command: string): CommandPermission | undefined;
+/** True when command is a read-only / report command (must not mutate state). */
+export declare function isReadReportCommand(command: string): boolean;
+export type CommandCheckResult = {
+    readonly allowed: true;
+} | {
+    readonly allowed: false;
+    readonly reason: string;
+    readonly ruleId: "CMD-02R" | "CMD-UNKNOWN";
+};
+/**
+ * DF-09 / CMD-02R: read/report commands must not mutate lifecycle state.
+ * Returns allowed when the command is permitted to mutate, denied otherwise.
+ */
+export declare function checkReadReportMutationDeny(command: string): CommandCheckResult;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yCAAyC;AACzC,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9E,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,iBAAiB,EAajE,CAAC;AAIF,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnF;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAA;CAAE,CAAC;AAErG;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAoB/E"}

package/dist/permissions.js

@@ -0,0 +1,57 @@
+/**
+ * Command Permission Matrix — CMD-02A/B/02R / DF-09
+ * SSOT: 22-command-specification-design.md §Permission Matrix
+ *
+ * Ported from spikes/core-p0-verify/src/lib/command-permission-matrix.ts (PR-009).
+ */
+/**
+ * Canonical command permission matrix.
+ * All `read/report` commands must have mutatesState=false (CMD-02B invariant).
+ */
+export const COMMAND_PERMISSION_MATRIX = [
+    { command: "jcr-adk audit", type: "read/report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "audit summary" },
+    { command: "jcr-adk replay", type: "read/report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "replay summary" },
+    { command: "jcr-adk handoff", type: "report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "handoff package" },
+    { command: "jcr-adk review-pack", type: "report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "evidence bundle" },
+    { command: "jcr-adk explain-fail", type: "report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "failure explanation" },
+    { command: "jcr-adk debug-bundle", type: "report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "debug bundle" },
+    { command: "jcr-adk doctor", type: "read/report", mutatesState: false, requiresGate: false, requiresApproval: false, output: "diagnostic report" },
+    { command: "jcr-adk gate", type: "verifier", mutatesState: true, requiresGate: true, requiresApproval: false, output: "gate report" },
+    { command: "jcr-adk sync", type: "lifecycle", mutatesState: true, requiresGate: true, requiresApproval: true, output: "sync report" },
+    { command: "jcr-adk init", type: "lifecycle", mutatesState: true, requiresGate: false, requiresApproval: false, output: "lifecycle artifacts" },
+    { command: "jcr-adk plan", type: "lifecycle", mutatesState: true, requiresGate: false, requiresApproval: false, output: "lifecycle artifacts" },
+    { command: "jcr-adk run", type: "lifecycle", mutatesState: true, requiresGate: false, requiresApproval: false, output: "lifecycle artifacts" },
+];
+const _matrixByCommand = new Map(COMMAND_PERMISSION_MATRIX.map((row) => [row.command, row]));
+/** Look up permission entry for a command. Returns undefined for unknown commands. */
+export function getCommandPermission(command) {
+    return _matrixByCommand.get(command);
+}
+/** True when command is a read-only / report command (must not mutate state). */
+export function isReadReportCommand(command) {
+    const perm = getCommandPermission(command);
+    return perm !== undefined && !perm.mutatesState;
+}
+/**
+ * DF-09 / CMD-02R: read/report commands must not mutate lifecycle state.
+ * Returns allowed when the command is permitted to mutate, denied otherwise.
+ */
+export function checkReadReportMutationDeny(command) {
+    const perm = getCommandPermission(command);
+    if (!perm) {
+        return {
+            allowed: false,
+            reason: `Unknown command: ${command}`,
+            ruleId: "CMD-UNKNOWN",
+        };
+    }
+    if (!perm.mutatesState) {
+        return {
+            allowed: false,
+            reason: `Read/report command '${command}' must not mutate lifecycle state (CMD-02R).`,
+            ruleId: "CMD-02R",
+        };
+    }
+    return { allowed: true };
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

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

package/dist/replay-summary.d.ts

@@ -0,0 +1,28 @@
+/**
+ * JSONL replay summary — F-02 / SR-09 read-only reconstruction.
+ */
+import type { PersistedAdkEvent } from "@jcr-adk/state";
+export type ReplayStatus = "completed" | "failed" | "in_progress" | "unknown";
+export interface ReplayTimelineEntry {
+    readonly seq: number;
+    readonly kind: string;
+    readonly timestamp: string;
+    readonly specId: string;
+    readonly runId: string;
+    readonly detail?: string;
+}
+export interface ReplaySummary {
+    readonly runId: string;
+    readonly specId?: string;
+    readonly eventCount: number;
+    readonly status: ReplayStatus;
+    readonly timeline: readonly ReplayTimelineEntry[];
+    readonly toolsInvoked: readonly string[];
+    readonly gateResults: readonly {
+        readonly result: string;
+        readonly reportHash?: string;
+    }[];
+    readonly policyDenialCount: number;
+}
+export declare function buildReplaySummary(events: readonly PersistedAdkEvent[], runId: string, specId?: string): ReplaySummary;
+//# sourceMappingURL=replay-summary.d.ts.map

package/dist/replay-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-summary.d.ts","sourceRoot":"","sources":["../src/replay-summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3F,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAmBD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,CAqDf"}

package/dist/replay-summary.js

@@ -0,0 +1,73 @@
+/**
+ * JSONL replay summary — F-02 / SR-09 read-only reconstruction.
+ */
+function timelineDetail(event) {
+    const payload = event.payload;
+    if (event.kind === "tool.invoked" || event.kind === "tool.completed" || event.kind === "tool.failed") {
+        const toolName = payload.toolName;
+        return typeof toolName === "string" ? toolName : undefined;
+    }
+    if (event.kind === "gate.report") {
+        const result = payload.result;
+        return typeof result === "string" ? `gate:${result}` : undefined;
+    }
+    if (event.kind === "policy.denied") {
+        const ruleId = payload.ruleId;
+        return typeof ruleId === "string" ? `deny:${ruleId}` : "deny";
+    }
+    return undefined;
+}
+export function buildReplaySummary(events, runId, specId) {
+    const filtered = events.filter((event) => {
+        if (event.runId !== runId)
+            return false;
+        if (specId && event.specId !== specId)
+            return false;
+        return true;
+    });
+    const toolsInvoked = new Set();
+    const gateResults = [];
+    let policyDenialCount = 0;
+    let status = "unknown";
+    const timeline = filtered.map((event) => {
+        const payload = event.payload;
+        if (event.kind === "tool.invoked" && typeof payload.toolName === "string") {
+            toolsInvoked.add(payload.toolName);
+        }
+        if (event.kind === "gate.report") {
+            gateResults.push({
+                result: String(payload.result ?? "UNKNOWN"),
+                reportHash: typeof payload.reportHash === "string" ? payload.reportHash : undefined,
+            });
+        }
+        if (event.kind === "policy.denied") {
+            policyDenialCount += 1;
+        }
+        if (event.kind === "run.completed")
+            status = "completed";
+        if (event.kind === "run.failed")
+            status = "failed";
+        if (event.kind === "run.started" && status === "unknown")
+            status = "in_progress";
+        return {
+            seq: event.seq,
+            kind: event.kind,
+            timestamp: event.timestamp,
+            specId: event.specId,
+            runId: event.runId,
+            detail: timelineDetail(event),
+        };
+    });
+    const resolvedSpecId = specId ?? filtered[0]?.specId;
+    return {
+        runId,
+        specId: resolvedSpecId,
+        eventCount: filtered.length,
+        status,
+        timeline,
+        toolsInvoked: [...toolsInvoked].sort(),
+        gateResults,
+        policyDenialCount,
+    };
+}
+//# sourceMappingURL=replay-summary.js.map

package/dist/replay-summary.js.map

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