@jcr-adk/cli 2.0.0

package/dist/commands/handoff.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface HandoffCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk handoff <specId>` — read-only handoff package (DAC-006). */
+export declare function runHandoffCommand(parsed: ParsedArgv): Promise<HandoffCommandResult>;
+//# sourceMappingURL=handoff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/commands/handoff.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqEzF"}

package/dist/commands/handoff.js

@@ -0,0 +1,61 @@
+import { join } from "node:path";
+import { flagBoolean, flagString } from "../argv.js";
+import { runHandoffHandler } from "../handlers.js";
+import { loadWorkspaceConfig, writeJsonArtifact, writeTextArtifact } from "../lifecycle-artifacts.js";
+/** `jcr-adk handoff <specId>` — read-only handoff package (DAC-006). */
+export async function runHandoffCommand(parsed) {
+    const workspaceRoot = flagString(parsed.flags, "workspace", "w") ?? process.cwd();
+    const specId = flagString(parsed.flags, "spec-id", "s") ?? parsed.positional[0];
+    const writeArtifacts = flagBoolean(parsed.flags, "write");
+    const includeMarkdown = flagBoolean(parsed.flags, "markdown") || flagBoolean(parsed.flags, "m");
+    if (!specId) {
+        return {
+            exitCode: 2,
+            output: "usage: jcr-adk handoff <specId> [--workspace <path>] [--write] [--markdown]",
+        };
+    }
+    const result = await runHandoffHandler({ workspaceRoot, specId });
+    if (!result.ok) {
+        const reason = result.reason === "READ_ERROR"
+            ? "event log is corrupt or unreadable (fail-closed)"
+            : result.reason === "ARTIFACT_READ_ERROR"
+                ? "spec artifact is corrupt or unreadable (fail-closed)"
+                : result.reason === "SPEC_NOT_FOUND"
+                    ? "spec artifacts not found (fail-closed)"
+                    : "handoff failed (fail-closed)";
+        return {
+            exitCode: 1,
+            output: JSON.stringify({
+                ok: false,
+                command: "handoff",
+                specId,
+                reason,
+                ...(result.error !== undefined ? { error: result.error } : {}),
+            }, null, 2),
+        };
+    }
+    const writtenPaths = [];
+    if (writeArtifacts && result.package) {
+        const config = await loadWorkspaceConfig(workspaceRoot);
+        const handoffDir = join(config.adkDir, "handoffs");
+        const jsonPath = join(handoffDir, `handoff-${specId}.json`);
+        await writeJsonArtifact(jsonPath, result.package, true);
+        writtenPaths.push(jsonPath);
+        if (includeMarkdown && result.markdown) {
+            const mdPath = join(handoffDir, `handoff-${specId}.md`);
+            await writeTextArtifact(mdPath, result.markdown, true);
+            writtenPaths.push(mdPath);
+        }
+    }
+    return {
+        exitCode: 0,
+        output: JSON.stringify({
+            ok: true,
+            command: "handoff",
+            package: result.package,
+            ...(includeMarkdown && result.markdown ? { markdown: result.markdown } : {}),
+            ...(writtenPaths.length > 0 ? { writtenPaths } : {}),
+        }, null, 2),
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/commands/handoff.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface InitCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk init` — scaffold `.jcr-adk` layout. */
+export declare function runInitCommand(parsed: ParsedArgv): Promise<InitCommandResult>;
+//# 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":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,mDAAmD;AACnD,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4CnF"}

package/dist/commands/init.js

@@ -0,0 +1,48 @@
+import { writeFile } from "node:fs/promises";
+import { flagBoolean, flagString } from "../argv.js";
+import { buildInitConfigFile, ensureDir, pathExists, resolveInitPaths, writeJsonArtifact, } from "../lifecycle-artifacts.js";
+/** `jcr-adk init` — scaffold `.jcr-adk` layout. */
+export async function runInitCommand(parsed) {
+    const workspaceRoot = flagString(parsed.flags, "workspace", "w") ?? process.cwd();
+    const projectId = flagString(parsed.flags, "project-id");
+    const force = flagBoolean(parsed.flags, "force");
+    const paths = resolveInitPaths(workspaceRoot);
+    const created = [];
+    const existing = [];
+    const configExists = await pathExists(paths.configFile);
+    if (configExists && !force) {
+        existing.push(paths.configFile);
+    }
+    else {
+        const config = buildInitConfigFile(projectId);
+        if (configExists && force) {
+            await writeFile(paths.configFile, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+            created.push(paths.configFile);
+        }
+        else {
+            const outcome = await writeJsonArtifact(paths.configFile, config, true);
+            if (outcome === "created" || outcome === "written")
+                created.push(paths.configFile);
+            else
+                existing.push(paths.configFile);
+        }
+    }
+    for (const dir of [paths.specsDir, paths.logsDir, paths.gateReportsDir]) {
+        const wasNew = await ensureDir(dir);
+        if (wasNew)
+            created.push(dir);
+        else
+            existing.push(dir);
+    }
+    const ok = created.length > 0 || existing.length > 0;
+    return {
+        exitCode: ok ? 0 : 1,
+        output: JSON.stringify({
+            ok,
+            workspaceRoot,
+            created,
+            existing,
+        }, null, 2),
+    };
+}
+//# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAOnC,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAkB;IACrD,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClF,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACxE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;;gBAC9E,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YACzB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACrD,OAAO;QACL,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,SAAS,CACpB;YACE,EAAE;YACF,aAAa;YACb,OAAO;YACP,QAAQ;SACT,EACD,IAAI,EACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface PlanCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk plan` — template-based SPEC/PLAN/AC/metadata scaffold. */
+export declare function runPlanCommand(parsed: ParsedArgv): Promise<PlanCommandResult>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAa7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAWD,sEAAsE;AACtE,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8DnF"}

package/dist/commands/plan.js

@@ -0,0 +1,55 @@
+import { readFile } from "node:fs/promises";
+import { generateSpecId } from "@jcr-adk/core";
+import { flagBoolean, flagString } from "../argv.js";
+import { buildPlanAcceptanceJson, buildPlanMarkdown, buildPlannedMetadata, buildPlanSpecMarkdown, loadWorkspaceConfig, resolveSpecArtifactPaths, writeJsonArtifact, writeTextArtifact, } from "../lifecycle-artifacts.js";
+async function resolveIntent(parsed) {
+    const inline = flagString(parsed.flags, "intent");
+    const filePath = flagString(parsed.flags, "intent-file");
+    if (filePath) {
+        return (await readFile(filePath, "utf8")).trim();
+    }
+    return inline?.trim() || undefined;
+}
+/** `jcr-adk plan` — template-based SPEC/PLAN/AC/metadata scaffold. */
+export async function runPlanCommand(parsed) {
+    const workspaceRoot = flagString(parsed.flags, "workspace", "w") ?? process.cwd();
+    const specId = flagString(parsed.flags, "spec-id") ?? generateSpecId();
+    const title = flagString(parsed.flags, "title") ?? specId;
+    const force = flagBoolean(parsed.flags, "force");
+    try {
+        const config = await loadWorkspaceConfig(workspaceRoot);
+        const paths = resolveSpecArtifactPaths(config, specId);
+        const intent = await resolveIntent(parsed);
+        const artifacts = {};
+        const created = [];
+        const existing = [];
+        const specOutcome = await writeTextArtifact(paths.specMd, buildPlanSpecMarkdown(specId, title, intent), force);
+        artifacts.specMd = paths.specMd;
+        (specOutcome === "existing" ? existing : created).push(paths.specMd);
+        const planOutcome = await writeTextArtifact(paths.planMd, buildPlanMarkdown(specId), force);
+        artifacts.planMd = paths.planMd;
+        (planOutcome === "existing" ? existing : created).push(paths.planMd);
+        const acceptanceOutcome = await writeJsonArtifact(paths.acceptanceJson, buildPlanAcceptanceJson(specId), force);
+        artifacts.acceptanceJson = paths.acceptanceJson;
+        (acceptanceOutcome === "existing" ? existing : created).push(paths.acceptanceJson);
+        const metadataOutcome = await writeJsonArtifact(paths.metadataJson, buildPlannedMetadata(specId), force);
+        artifacts.metadataJson = paths.metadataJson;
+        (metadataOutcome === "existing" ? existing : created).push(paths.metadataJson);
+        return {
+            exitCode: 0,
+            output: JSON.stringify({
+                ok: true,
+                workspaceRoot,
+                specId,
+                status: "planned",
+                artifacts,
+                created,
+                existing,
+            }, null, 2),
+        };
+    }
+    catch (err) {
+        return { exitCode: 1, output: String(err) };
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/replay.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface ReplayCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk replay <runId>` — read-only JSONL replay summary (SR-09). */
+export declare function runReplayCommand(parsed: ParsedArgv): Promise<ReplayCommandResult>;
+//# 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":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yEAAyE;AACzE,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+CvF"}

package/dist/commands/replay.js

@@ -0,0 +1,39 @@
+import { flagString } from "../argv.js";
+import { runReplayHandler } from "../handlers.js";
+/** `jcr-adk replay <runId>` — read-only JSONL replay summary (SR-09). */
+export async function runReplayCommand(parsed) {
+    const workspaceRoot = flagString(parsed.flags, "workspace", "w") ?? process.cwd();
+    const runId = flagString(parsed.flags, "run-id") ?? parsed.positional[0];
+    const specId = flagString(parsed.flags, "spec-id", "s");
+    if (!runId) {
+        return {
+            exitCode: 2,
+            output: "usage: jcr-adk replay <runId> [--spec-id <id>] [--workspace <path>]",
+        };
+    }
+    const result = await runReplayHandler({ workspaceRoot, runId, specId });
+    if (!result.ok) {
+        const reason = result.reason === "READ_ERROR"
+            ? "event log is corrupt or unreadable (fail-closed)"
+            : "no events found for runId (fail-closed)";
+        return {
+            exitCode: 1,
+            output: JSON.stringify({
+                ok: false,
+                command: "replay",
+                runId,
+                reason,
+                ...(result.error !== undefined ? { error: result.error } : {}),
+            }, null, 2),
+        };
+    }
+    return {
+        exitCode: 0,
+        output: JSON.stringify({
+            ok: true,
+            command: "replay",
+            summary: result.summary,
+        }, null, 2),
+    };
+}
+//# 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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOlD,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAkB;IACvD,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAClF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAExD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,qEAAqE;SAC9E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAExE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,YAAY;YAC5B,CAAC,CAAC,kDAAkD;YACpD,CAAC,CAAC,yCAAyC,CAAC;QAChD,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,IAAI,CAAC,SAAS,CACpB;gBACE,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,QAAQ;gBACjB,KAAK;gBACL,MAAM;gBACN,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,EACD,IAAI,EACJ,CAAC,CACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,IAAI,CAAC,SAAS,CACpB;YACE,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,EACD,IAAI,EACJ,CAAC,CACF;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/review-pack.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface ReviewPackCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk review-pack <specId>` — read-only reviewer evidence bundle (DAC-007). */
+export declare function runReviewPackCommand(parsed: ParsedArgv): Promise<ReviewPackCommandResult>;
+//# sourceMappingURL=review-pack.d.ts.map

package/dist/commands/review-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-pack.d.ts","sourceRoot":"","sources":["../../src/commands/review-pack.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAwE/F"}

package/dist/commands/review-pack.js

@@ -0,0 +1,64 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { flagBoolean, flagString } from "../argv.js";
+import { runReviewPackHandler } from "../handlers.js";
+import { loadWorkspaceConfig } from "../lifecycle-artifacts.js";
+/** `jcr-adk review-pack <specId>` — read-only reviewer evidence bundle (DAC-007). */
+export async function runReviewPackCommand(parsed) {
+    const workspaceRoot = flagString(parsed.flags, "workspace", "w") ?? process.cwd();
+    const specId = flagString(parsed.flags, "spec-id", "s") ?? parsed.positional[0];
+    const writeArtifacts = flagBoolean(parsed.flags, "write");
+    const includeMarkdown = flagBoolean(parsed.flags, "markdown") || flagBoolean(parsed.flags, "m");
+    if (!specId) {
+        return {
+            exitCode: 2,
+            output: "usage: jcr-adk review-pack <specId> [--workspace <path>] [--write] [--markdown]",
+        };
+    }
+    const result = await runReviewPackHandler({ workspaceRoot, specId });
+    if (!result.ok) {
+        const reason = result.reason === "READ_ERROR"
+            ? "event log is corrupt or unreadable (fail-closed)"
+            : result.reason === "ARTIFACT_READ_ERROR"
+                ? "spec artifact is corrupt or unreadable (fail-closed)"
+                : result.reason === "SPEC_NOT_FOUND"
+                    ? "spec artifacts not found (fail-closed)"
+                    : "review-pack failed (fail-closed)";
+        return {
+            exitCode: 1,
+            output: JSON.stringify({
+                ok: false,
+                command: "review-pack",
+                specId,
+                reason,
+                ...(result.error !== undefined ? { error: result.error } : {}),
+            }, null, 2),
+        };
+    }
+    const writtenPaths = [];
+    let bundleDir;
+    if (writeArtifacts && result.bundle) {
+        const config = await loadWorkspaceConfig(workspaceRoot);
+        bundleDir = join(config.adkDir, "review-packs", `review-pack-${specId}`);
+        await mkdir(bundleDir, { recursive: true });
+        const jsonPath = join(bundleDir, "bundle.json");
+        await writeFile(jsonPath, `${JSON.stringify(result.bundle, null, 2)}\n`, "utf8");
+        writtenPaths.push(jsonPath);
+        if (result.markdown) {
+            const mdPath = join(bundleDir, "README.md");
+            await writeFile(mdPath, result.markdown.endsWith("\n") ? result.markdown : `${result.markdown}\n`, "utf8");
+            writtenPaths.push(mdPath);
+        }
+    }
+    return {
+        exitCode: 0,
+        output: JSON.stringify({
+            ok: true,
+            command: "review-pack",
+            bundle: result.bundle,
+            ...(includeMarkdown && result.markdown ? { markdown: result.markdown } : {}),
+            ...(bundleDir ? { bundleDir, writtenPaths } : {}),
+        }, null, 2),
+    };
+}
+//# sourceMappingURL=review-pack.js.map

package/dist/commands/review-pack.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface RunCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk run` — guarded SDK runner (live) or dry-run mock pipeline. */
+export declare function runRunCommand(parsed: ParsedArgv, env?: Record<string, string | undefined>): Promise<RunCommandResult>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA6CD,0EAA0E;AAC1E,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,OAAO,CAAC,gBAAgB,CAAC,CAiM3B"}

package/dist/commands/run.js

@@ -0,0 +1,205 @@
+import { readFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { createCorrelationIds, generateRunId } from "@jcr-adk/core";
+import { isLiveSdkAvailable, resolveCursorApiKey } from "@jcr-adk/runner-sdk";
+import { runGuardedCursorAgent } from "@jcr-adk/runtime";
+import { flagBoolean, flagString } from "../argv.js";
+import { createCliSession } from "../session.js";
+import { clearCurrentRunSession, markRunSessionBlocked, markRunSessionCompleted, } from "../session-run.js";
+async function resolvePrompt(parsed) {
+    const inline = flagString(parsed.flags, "prompt");
+    const filePath = flagString(parsed.flags, "prompt-file");
+    if (filePath) {
+        return (await readFile(filePath, "utf8")).trim();
+    }
+    return inline?.trim() || undefined;
+}
+function flagPositiveInteger(parsed, key) {
+    const value = flagString(parsed.flags, key);
+    if (value === undefined)
+        return undefined;
+    const parsedValue = Number(value);
+    if (!Number.isInteger(parsedValue) || parsedValue < 0) {
+        throw new Error(`--${key} must be a non-negative integer`);
+    }
+    return parsedValue;
+}
+function buildRunBlockedEvent(input) {
+    return {
+        id: `EVT-${randomUUID()}`,
+        kind: "run.failed",
+        timestamp: new Date().toISOString(),
+        specId: input.specId,
+        runId: input.runId,
+        requestId: input.requestId,
+        payload: {
+            status: "BLOCKED",
+            ruleId: "AC-009",
+            reason: `max iteration exceeded: iteration ${input.iteration} > max ${input.maxIterations}`,
+            iteration: input.iteration,
+            maxIterations: input.maxIterations,
+        },
+    };
+}
+/** `jcr-adk run` — guarded SDK runner (live) or dry-run mock pipeline. */
+export async function runRunCommand(parsed, env = process.env) {
+    const workspaceRoot = flagString(parsed.flags, "workspace", "w") ?? process.cwd();
+    const specId = flagString(parsed.flags, "spec-id", "s");
+    if (!specId) {
+        return { exitCode: 2, output: "missing required flag: --spec-id" };
+    }
+    // run owns runId generation. An explicit --run-id is honored, otherwise we
+    // always mint a fresh runId so a new run never silently reuses a stale one.
+    // The session is recorded as completed ONLY after a successful run below, so
+    // a failed run cannot satisfy sync's reuse-or-fail gate (NP-01 fail-closed).
+    const runId = flagString(parsed.flags, "run-id") ?? generateRunId();
+    await clearCurrentRunSession(workspaceRoot);
+    const liveRequested = flagBoolean(parsed.flags, "live") || env["JCR_LIVE_ADK"] === "1";
+    const dryRunRequested = flagBoolean(parsed.flags, "dry-run");
+    let iteration;
+    let maxIterations;
+    try {
+        iteration = flagPositiveInteger(parsed, "iteration");
+        maxIterations = flagPositiveInteger(parsed, "max-iterations");
+    }
+    catch (err) {
+        return { exitCode: 2, output: err instanceof Error ? err.message : String(err) };
+    }
+    if (liveRequested && dryRunRequested) {
+        return {
+            exitCode: 2,
+            output: "cannot combine --live and --dry-run",
+        };
+    }
+    if ((iteration !== undefined && maxIterations === undefined) ||
+        (iteration === undefined && maxIterations !== undefined)) {
+        return {
+            exitCode: 2,
+            output: "AC-009 requires both --iteration and --max-iterations (fail-closed)",
+        };
+    }
+    const mode = liveRequested ? "live" : "dry-run";
+    if (iteration !== undefined && maxIterations !== undefined && iteration > maxIterations) {
+        const session = await createCliSession({ workspaceRoot, specId, runId });
+        const appendOutcome = await session.store.append(buildRunBlockedEvent({
+            specId: session.correlation.specId,
+            runId: session.correlation.runId,
+            requestId: session.correlation.requestId,
+            iteration,
+            maxIterations,
+        }));
+        if (!appendOutcome.ok) {
+            return {
+                exitCode: 2,
+                output: `failed to record AC-009 run.failed audit event: ${appendOutcome.message}`,
+            };
+        }
+        await markRunSessionBlocked(workspaceRoot, { specId, runId: session.correlation.runId });
+        return {
+            exitCode: 1,
+            output: JSON.stringify({
+                ok: false,
+                mode,
+                specId,
+                runId: session.correlation.runId,
+                status: "BLOCKED",
+                ruleId: "AC-009",
+                reason: `max iteration exceeded: iteration ${iteration} > max ${maxIterations}`,
+                iteration,
+                maxIterations,
+            }, null, 2),
+        };
+    }
+    if (mode === "live") {
+        const apiKey = resolveCursorApiKey({ env });
+        if (!apiKey) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({
+                    ok: false,
+                    mode: "live",
+                    error: "CURSOR_API_KEY is required for live SDK runs (fail-closed, OI-014)",
+                }, null, 2),
+            };
+        }
+        const prompt = (await resolvePrompt(parsed)) ?? "Execute the planned ADK workflow using guarded custom tools.";
+        const correlation = createCorrelationIds({ specId, runId });
+        try {
+            const result = await runGuardedCursorAgent({
+                workspaceRoot,
+                specId,
+                runId,
+                prompt,
+                env,
+                apiKey,
+                correlation,
+            });
+            if (result.ok) {
+                await markRunSessionCompleted(workspaceRoot, { specId, runId });
+            }
+            return {
+                exitCode: result.ok ? 0 : 1,
+                output: JSON.stringify({
+                    ok: result.ok,
+                    mode: "live",
+                    specId,
+                    runId: result.correlation?.runId ?? runId,
+                    requestId: result.correlation?.requestId,
+                    agentRunId: result.agentRunId,
+                    status: result.status,
+                    result: result.result,
+                    error: result.error,
+                }, null, 2),
+            };
+        }
+        catch (err) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({ ok: false, mode: "live", error: String(err) }, null, 2),
+            };
+        }
+    }
+    // dry-run: guarded session + minimal tool pipeline (no live SDK)
+    try {
+        const session = await createCliSession({ workspaceRoot, specId, runId });
+        const readResult = await session.executor.execute({
+            toolName: "adk_spec_read",
+            args: { specId: session.correlation.specId },
+            correlation: session.correlation,
+        });
+        if (!readResult.ok) {
+            return {
+                exitCode: 1,
+                output: JSON.stringify({
+                    ok: false,
+                    mode: "dry-run",
+                    stage: readResult.stage,
+                    ruleId: readResult.ruleId,
+                    reason: readResult.reason,
+                }, null, 2),
+            };
+        }
+        const prompt = (await resolvePrompt(parsed)) ?? "dry-run guarded pipeline";
+        await markRunSessionCompleted(workspaceRoot, { specId, runId });
+        return {
+            exitCode: 0,
+            output: JSON.stringify({
+                ok: true,
+                mode: "dry-run",
+                specId: session.correlation.specId,
+                runId: session.correlation.runId,
+                requestId: session.correlation.requestId,
+                prompt,
+                toolOutput: readResult.output,
+                liveSdkAvailable: isLiveSdkAvailable(env),
+            }, null, 2),
+        };
+    }
+    catch (err) {
+        return {
+            exitCode: 1,
+            output: JSON.stringify({ ok: false, mode: "dry-run", error: String(err) }, null, 2),
+        };
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgv } from "../argv.js";
+export interface SyncCommandResult {
+    readonly exitCode: number;
+    readonly output: string;
+}
+/** `jcr-adk sync` — gate PASS 후 metadata/progress/sync-summary 갱신. */
+export declare function runSyncCommand(parsed: ParsedArgv): Promise<SyncCommandResult>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAY7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAuBD,sEAAsE;AACtE,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsInF"}