@jcr-adk/cli 2.0.0

package/dist/handlers.js

@@ -0,0 +1,257 @@
+/**
+ * CLI command handler skeletons — E6 / CMD-02R.
+ *
+ * Core-stage handlers:
+ *   - `doctor`:  read-only, no state mutation.
+ *   - `gate`:    verifier-controlled mutation only (runs gate, may update status).
+ *   - `audit`:   read-only event/gate/policy summary (CMD-03R / F-12).
+ *   - `replay`:       read-only JSONL replay summary (SR-09 / F-02).
+ *   - `explain-fail`: read-only failure explanation (DAC-008).
+ *   - `handoff`:    read-only handoff package (DAC-006).
+ *   - `review-pack`: read-only reviewer evidence bundle (DAC-007).
+ *
+ * Lifecycle init/plan/run/sync are in commands/*.ts.
+ */
+import { gateAllowsMutation, runGate } from "@jcr-adk/verifier";
+import { readFile } from "node:fs/promises";
+import { buildAuditSummary } from "./audit-summary.js";
+import { filterEvents, readWorkspaceEvents } from "./event-reader.js";
+import { loadWorkspaceConfig, pathExists, readSpecMetadata, resolveSpecArtifactPaths, } from "./lifecycle-artifacts.js";
+import { checkReadReportMutationDeny } from "./permissions.js";
+import { buildExplainFailSummary } from "./explain-fail-summary.js";
+import { buildHandoffPackage, renderHandoffMarkdown, } from "./handoff-summary.js";
+import { buildReviewPackBundle, extractSpecGoal, parseAcceptanceFile, renderReviewPackMarkdown, } from "./review-pack-summary.js";
+import { buildReplaySummary } from "./replay-summary.js";
+/**
+ * `jcr-adk doctor` handler — read-only.
+ * Guards against any lifecycle state mutation attempts (CMD-02R).
+ */
+export function runDoctorHandler(input) {
+    // CMD-02R: read/report command must not mutate state.
+    // The doctor handler itself never mutates, but we assert that explicitly
+    // so any future code adding mutation can be caught at review.
+    const check = checkReadReportMutationDeny("jcr-adk doctor");
+    if (check.allowed) {
+        // Handler was reclassified as mutating — this is a programming error.
+        throw new Error(`CMD-02R invariant violated: jcr-adk doctor was reclassified as a mutating command.`);
+    }
+    return { ok: input.report.ok, report: input.report };
+}
+/**
+ * `jcr-adk gate` handler — verifier-controlled mutation.
+ * Runs the gate, and:
+ *   - PASS  → caller may proceed with lifecycle mutation (G-02 check passes).
+ *   - FAIL/TIMEOUT/ERROR → blocks mutation and returns reason.
+ *
+ * The handler itself does NOT write to the event store; it returns the run
+ * result so the caller can emit policy.denied / gate.completed events in the
+ * correct EVENT_FIRST_WRITE_ORDERING.
+ */
+export async function runGateHandler(input) {
+    const run = await runGate(input);
+    if (!run.ok || !gateAllowsMutation(run.result)) {
+        const reason = run.ok ? `gate returned ${run.result}` : run.reason;
+        return {
+            ok: false,
+            gateResult: run.result,
+            reason,
+        };
+    }
+    return { ok: true, gateResult: "PASS", gateRun: run };
+}
+function assertReadOnlyCommand(command) {
+    const check = checkReadReportMutationDeny(command);
+    if (check.allowed) {
+        throw new Error(`CMD-02R invariant violated: ${command} was reclassified as mutating.`);
+    }
+}
+/** `jcr-adk audit` — read-only event/gate/policy summary. */
+export async function runAuditHandler(input) {
+    assertReadOnlyCommand("jcr-adk audit");
+    const read = await readWorkspaceEvents(input.workspaceRoot);
+    const filtered = filterEvents(read.events, {
+        specId: input.specId,
+        runId: input.runId,
+    });
+    const summary = buildAuditSummary(input.workspaceRoot, read.eventsPath, filtered, {
+        specId: input.specId,
+        runId: input.runId,
+    });
+    // Fail-closed: a corrupt/unreadable log must not report a clean empty summary.
+    if (!read.ok) {
+        return { ok: false, summary, error: read.error };
+    }
+    return { ok: true, summary };
+}
+/** `jcr-adk replay` — reconstruct run summary from JSONL events. */
+export async function runReplayHandler(input) {
+    assertReadOnlyCommand("jcr-adk replay");
+    const read = await readWorkspaceEvents(input.workspaceRoot);
+    const summary = buildReplaySummary(read.events, input.runId, input.specId);
+    // Fail-closed: distinguish a corrupt log from a genuinely unknown runId.
+    if (!read.ok) {
+        return { ok: false, summary, reason: "READ_ERROR", error: read.error };
+    }
+    if (summary.eventCount === 0) {
+        return { ok: false, summary, reason: "NO_EVENTS" };
+    }
+    return { ok: true, summary };
+}
+/** `jcr-adk explain-fail` — structured failure explanation from JSONL events. */
+export async function runExplainFailHandler(input) {
+    assertReadOnlyCommand("jcr-adk explain-fail");
+    const read = await readWorkspaceEvents(input.workspaceRoot);
+    if (!read.ok) {
+        return { ok: false, reason: "READ_ERROR", error: read.error };
+    }
+    const built = buildExplainFailSummary(read.events, input.targetId, input.workspaceRoot, input.specId);
+    if (built === null) {
+        return { ok: false, reason: "NOT_FOUND" };
+    }
+    return { ok: true, summary: built };
+}
+/** `jcr-adk handoff` — build context package from spec artifacts + JSONL audit. */
+export async function runHandoffHandler(input) {
+    assertReadOnlyCommand("jcr-adk handoff");
+    const config = await loadWorkspaceConfig(input.workspaceRoot);
+    let paths;
+    try {
+        paths = resolveSpecArtifactPaths(config, input.specId);
+    }
+    catch {
+        return { ok: false, reason: "SPEC_NOT_FOUND" };
+    }
+    if (!(await pathExists(paths.metadataJson))) {
+        return { ok: false, reason: "SPEC_NOT_FOUND" };
+    }
+    const read = await readWorkspaceEvents(input.workspaceRoot);
+    if (!read.ok) {
+        return { ok: false, reason: "READ_ERROR", error: read.error };
+    }
+    let metadata;
+    try {
+        metadata = await readSpecMetadata(paths.metadataJson);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: "ARTIFACT_READ_ERROR",
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    let specMd = "";
+    if (await pathExists(paths.specMd)) {
+        try {
+            specMd = await readFile(paths.specMd, "utf8");
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: "ARTIFACT_READ_ERROR",
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    let acceptanceRaw = { items: [] };
+    if (await pathExists(paths.acceptanceJson)) {
+        try {
+            acceptanceRaw = JSON.parse(await readFile(paths.acceptanceJson, "utf8"));
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: "ARTIFACT_READ_ERROR",
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    const specRelative = `.jcr-adk/specs/${input.specId}`;
+    const pkg = buildHandoffPackage(input.specId, input.workspaceRoot, {
+        specGoal: extractSpecGoal(specMd, input.specId),
+        currentStatus: metadata.status,
+        acceptance: parseAcceptanceFile(acceptanceRaw),
+        relatedFiles: [
+            `${specRelative}/spec.md`,
+            `${specRelative}/plan.md`,
+            `${specRelative}/acceptance.json`,
+            `${specRelative}/metadata.json`,
+        ],
+        lastRunId: metadata.lastGateRunId,
+        reportHash: metadata.reportHash,
+    }, filterEvents(read.events, { specId: input.specId }));
+    return { ok: true, package: pkg, markdown: renderHandoffMarkdown(pkg) };
+}
+/** `jcr-adk review-pack` — reviewer evidence bundle from spec + JSONL audit. */
+export async function runReviewPackHandler(input) {
+    assertReadOnlyCommand("jcr-adk review-pack");
+    const config = await loadWorkspaceConfig(input.workspaceRoot);
+    let paths;
+    try {
+        paths = resolveSpecArtifactPaths(config, input.specId);
+    }
+    catch {
+        return { ok: false, reason: "SPEC_NOT_FOUND" };
+    }
+    if (!(await pathExists(paths.metadataJson))) {
+        return { ok: false, reason: "SPEC_NOT_FOUND" };
+    }
+    const read = await readWorkspaceEvents(input.workspaceRoot);
+    if (!read.ok) {
+        return { ok: false, reason: "READ_ERROR", error: read.error };
+    }
+    let metadata;
+    try {
+        metadata = await readSpecMetadata(paths.metadataJson);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: "ARTIFACT_READ_ERROR",
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    let specMd = "";
+    if (await pathExists(paths.specMd)) {
+        try {
+            specMd = await readFile(paths.specMd, "utf8");
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: "ARTIFACT_READ_ERROR",
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    let acceptanceRaw = { items: [] };
+    if (await pathExists(paths.acceptanceJson)) {
+        try {
+            acceptanceRaw = JSON.parse(await readFile(paths.acceptanceJson, "utf8"));
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: "ARTIFACT_READ_ERROR",
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    const specRelative = `.jcr-adk/specs/${input.specId}`;
+    const specEvents = filterEvents(read.events, { specId: input.specId });
+    const bundle = buildReviewPackBundle({
+        specId: input.specId,
+        requirementsSummary: extractSpecGoal(specMd, input.specId),
+        currentStatus: metadata.status,
+        acceptance: parseAcceptanceFile(acceptanceRaw),
+        artifactPaths: [
+            `${specRelative}/spec.md`,
+            `${specRelative}/plan.md`,
+            `${specRelative}/acceptance.json`,
+            `${specRelative}/metadata.json`,
+        ],
+        events: specEvents,
+        reportHash: metadata.reportHash,
+    });
+    return { ok: true, bundle, markdown: renderReviewPackMarkdown(bundle) };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

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

package/dist/handoff-summary.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Handoff package builder — DAC-006 / Recovery plane read-only context artifact.
+ *
+ * Aggregates spec artifacts + JSONL audit data. Does not mutate SpecStatus (CMD-02R).
+ * SEC-16: package is context for humans/agents — not a completion verdict.
+ */
+import type { PersistedAdkEvent } from "@jcr-adk/state";
+export interface HandoffFailedGate {
+    readonly gateId: string;
+    readonly runId: string;
+    readonly result: string;
+    readonly reportHash?: string;
+    readonly timestamp: string;
+}
+export interface HandoffAcceptanceItem {
+    readonly id: string;
+    readonly description: string;
+    readonly evidencePath: string;
+    readonly status: "pending" | "evidence_defined";
+}
+export interface HandoffPackage {
+    readonly specId: string;
+    readonly generatedAt: string;
+    readonly specGoal: string;
+    readonly currentStatus: string;
+    readonly failedGates: readonly HandoffFailedGate[];
+    readonly acceptance: readonly HandoffAcceptanceItem[];
+    readonly relatedFiles: readonly string[];
+    readonly nextCommands: readonly string[];
+    readonly prohibitions: readonly string[];
+    readonly lastRunId?: string;
+    readonly reportHash?: string;
+    /** Set when metadata status and JSONL gate outcomes may disagree (SEC-16). */
+    readonly statusNote?: string;
+    /** `observed` = from artifacts/JSONL; `inferred` = heuristic guidance */
+    readonly evidenceLabel: "observed" | "inferred";
+}
+export interface HandoffSpecArtifacts {
+    readonly specGoal: string;
+    readonly currentStatus: string;
+    readonly acceptance: readonly HandoffAcceptanceItem[];
+    readonly relatedFiles: readonly string[];
+    readonly lastRunId?: string;
+    readonly reportHash?: string;
+}
+/** Extract goal text from plan scaffold spec.md. */
+export declare function extractSpecGoal(specMd: string, specId: string): string;
+export declare function parseAcceptanceFile(raw: unknown): HandoffAcceptanceItem[];
+/** Collect gateIds whose latest gate.report outcome is non-PASS for a spec. */
+export declare function collectFailedGates(events: readonly PersistedAdkEvent[], specId: string): HandoffFailedGate[];
+export declare function buildNextCommands(input: {
+    readonly workspaceRoot: string;
+    readonly specId: string;
+    readonly currentStatus: string;
+    readonly failedGates: readonly HandoffFailedGate[];
+    readonly lastRunId?: string;
+}): string[];
+/** Build handoff package from spec artifacts and optional workspace events. */
+export declare function buildHandoffPackage(specId: string, workspaceRoot: string, artifacts: HandoffSpecArtifacts, events: readonly PersistedAdkEvent[]): HandoffPackage;
+/** Render handoff package as markdown for human/agent handoff. */
+export declare function renderHandoffMarkdown(pkg: HandoffPackage): string;
+//# sourceMappingURL=handoff-summary.d.ts.map

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

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

package/dist/handoff-summary.js

@@ -0,0 +1,170 @@
+/**
+ * Handoff package builder — DAC-006 / Recovery plane read-only context artifact.
+ *
+ * Aggregates spec artifacts + JSONL audit data. Does not mutate SpecStatus (CMD-02R).
+ * SEC-16: package is context for humans/agents — not a completion verdict.
+ */
+const DEFAULT_PROHIBITIONS = [
+    "Do not set metadata status to verified without a gate PASS and sealed reportHash (G-02)",
+    "Do not mutate lifecycle state via read/report commands (audit/replay/handoff/explain-fail/review-pack) — CMD-02R",
+    "Do not bypass policy with spoofed tool args or unapproved destructive shell commands (AC-008)",
+    "Do not mark acceptance items passed without non-empty evidence paths (G-03)",
+];
+function payloadOf(event) {
+    return event.payload;
+}
+/** Extract goal text from plan scaffold spec.md. */
+export function extractSpecGoal(specMd, specId) {
+    const lines = specMd.split("\n");
+    const titleLine = lines.find((line) => line.startsWith("# "));
+    const title = titleLine?.slice(2).trim();
+    const intentIdx = lines.findIndex((line) => /^##\s+Intent\b/i.test(line.trim()));
+    if (intentIdx >= 0) {
+        const intentParts = [];
+        for (let i = intentIdx + 1; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.startsWith("## "))
+                break;
+            const trimmed = line.trim();
+            if (trimmed)
+                intentParts.push(trimmed);
+        }
+        if (intentParts.length > 0)
+            return intentParts.join(" ");
+    }
+    return title ?? `Spec ${specId}`;
+}
+export function parseAcceptanceFile(raw) {
+    const data = raw;
+    if (!Array.isArray(data.items))
+        return [];
+    return data.items.map((item) => {
+        const evidencePath = typeof item.evidencePath === "string" ? item.evidencePath : "";
+        return {
+            id: typeof item.id === "string" ? item.id : "UNKNOWN",
+            description: typeof item.description === "string" ? item.description : "",
+            evidencePath,
+            status: evidencePath.trim() ? "evidence_defined" : "pending",
+        };
+    });
+}
+/** Collect gateIds whose latest gate.report outcome is non-PASS for a spec. */
+export function collectFailedGates(events, specId) {
+    const latestByGateId = new Map();
+    for (const event of events) {
+        if (event.specId !== specId || event.kind !== "gate.report")
+            continue;
+        const payload = payloadOf(event);
+        const result = String(payload.result ?? "UNKNOWN");
+        const gateId = typeof payload.gateId === "string" ? payload.gateId : "UNKNOWN-GATE";
+        const entry = {
+            gateId,
+            runId: event.runId,
+            result,
+            reportHash: typeof payload.reportHash === "string" ? payload.reportHash : undefined,
+            timestamp: event.timestamp,
+        };
+        const existing = latestByGateId.get(gateId);
+        if (!existing || event.timestamp >= existing.timestamp) {
+            latestByGateId.set(gateId, entry);
+        }
+    }
+    return [...latestByGateId.values()]
+        .filter((entry) => entry.result !== "PASS")
+        .sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+}
+export function buildNextCommands(input) {
+    const w = `--workspace ${JSON.stringify(input.workspaceRoot)}`;
+    const commands = [
+        `jcr-adk audit ${input.specId} ${w}`,
+        `jcr-adk doctor ${w}`,
+    ];
+    if (input.lastRunId) {
+        commands.push(`jcr-adk replay ${input.lastRunId} --spec-id ${input.specId} ${w}`);
+    }
+    if (input.failedGates.length > 0) {
+        const latest = input.failedGates.at(-1);
+        commands.push(`jcr-adk explain-fail ${latest.gateId} --spec-id ${input.specId} ${w}`, `jcr-adk gate ${input.specId} --gate-id ${latest.gateId} --acceptance-file .jcr-adk/specs/${input.specId}/acceptance.json ${w}`);
+    }
+    else if (input.currentStatus !== "verified") {
+        commands.push(`jcr-adk run --spec-id ${input.specId} --dry-run ${w}`, `jcr-adk sync ${input.specId} --acceptance-file .jcr-adk/specs/${input.specId}/acceptance.json ${w}`);
+    }
+    return commands;
+}
+/** Build handoff package from spec artifacts and optional workspace events. */
+export function buildHandoffPackage(specId, workspaceRoot, artifacts, events) {
+    const failedGates = collectFailedGates(events, specId);
+    const evidencePaths = artifacts.acceptance
+        .map((item) => item.evidencePath.trim())
+        .filter((path) => path.length > 0);
+    const relatedFiles = [...new Set([...artifacts.relatedFiles, ...evidencePaths])].sort();
+    return {
+        specId,
+        generatedAt: new Date().toISOString(),
+        specGoal: artifacts.specGoal,
+        currentStatus: artifacts.currentStatus,
+        failedGates,
+        acceptance: artifacts.acceptance,
+        relatedFiles,
+        nextCommands: buildNextCommands({
+            workspaceRoot,
+            specId,
+            currentStatus: artifacts.currentStatus,
+            failedGates,
+            lastRunId: artifacts.lastRunId,
+        }),
+        prohibitions: [...DEFAULT_PROHIBITIONS],
+        lastRunId: artifacts.lastRunId,
+        reportHash: artifacts.reportHash,
+        statusNote: artifacts.currentStatus === "verified" && failedGates.length > 0
+            ? "metadata.json is verified but JSONL records newer non-PASS gate — lifecycle status unchanged; inspect failedGates for audit drift"
+            : undefined,
+        evidenceLabel: "observed",
+    };
+}
+/** Render handoff package as markdown for human/agent handoff. */
+export function renderHandoffMarkdown(pkg) {
+    const failedSection = pkg.failedGates.length === 0
+        ? "_No failed gate recorded in JSONL audit log._\n"
+        : pkg.failedGates
+            .map((gate) => `- **${gate.gateId}** (${gate.result}) runId=\`${gate.runId}\` at ${gate.timestamp}`)
+            .join("\n");
+    const acceptanceSection = pkg.acceptance
+        .map((item) => `- **${item.id}** [${item.status}]: ${item.description} — \`${item.evidencePath || "(no path)"}\``)
+        .join("\n");
+    const nextSection = pkg.nextCommands.map((cmd) => `- \`${cmd}\``).join("\n");
+    const prohibitSection = pkg.prohibitions.map((rule) => `- ${rule}`).join("\n");
+    const filesSection = pkg.relatedFiles.map((file) => `- \`${file}\``).join("\n");
+    return `# Handoff — ${pkg.specId}
+
+> Generated: ${pkg.generatedAt}  
+> Status: **${pkg.currentStatus}**  
+> Evidence label: ${pkg.evidenceLabel}
+${pkg.statusNote ? `\n> **Note:** ${pkg.statusNote}\n` : ""}
+
+## SPEC Goal
+
+${pkg.specGoal}
+
+## Failed Gates
+
+${failedSection}
+
+## Acceptance
+
+${acceptanceSection || "_No acceptance items found._"}
+
+## Related Files
+
+${filesSection || "_No related files listed._"}
+
+## Next Recommended Commands
+
+${nextSection}
+
+## Prohibitions
+
+${prohibitSection}
+`;
+}
+//# sourceMappingURL=handoff-summary.js.map

package/dist/handoff-summary.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { CommandType, CommandPermission, CommandCheckResult } from "./permissions.js";
+export { COMMAND_PERMISSION_MATRIX, getCommandPermission, isReadReportCommand, checkReadReportMutationDeny, } from "./permissions.js";
+export type { DoctorHandlerInput, DoctorHandlerResult, GateHandlerInput, GateHandlerResult } from "./handlers.js";
+export { runDoctorHandler, runGateHandler } from "./handlers.js";
+export type { ParsedArgv } from "./argv.js";
+export { parseArgv, flagString, flagBoolean } from "./argv.js";
+export type { CliSession, CreateCliSessionInput } from "./session.js";
+export { createCliSession } from "./session.js";
+export { runCli } from "./main.js";
+export type { RunCliOptions } from "./main.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEjE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/D,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { COMMAND_PERMISSION_MATRIX, getCommandPermission, isReadReportCommand, checkReadReportMutationDeny, } from "./permissions.js";
+export { runDoctorHandler, runGateHandler } from "./handlers.js";
+export { parseArgv, flagString, flagBoolean } from "./argv.js";
+export { createCliSession } from "./session.js";
+export { runCli } from "./main.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC"}

package/dist/lifecycle-artifacts.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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 { type AdkConfig } from "@jcr-adk/core";
+export type WriteOutcome = "created" | "existing" | "written";
+export interface SpecArtifactPaths {
+    readonly specDir: string;
+    readonly specMd: string;
+    readonly planMd: string;
+    readonly acceptanceJson: string;
+    readonly metadataJson: string;
+    readonly progressJsonl: string;
+}
+export interface SpecMetadata {
+    readonly specId: string;
+    readonly status: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly lastGateRunId?: string;
+    readonly reportHash?: string;
+}
+/** True when the path exists and is accessible. */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/** Load workspace config from disk when present; otherwise default v1 layout. */
+export declare function loadWorkspaceConfig(workspaceRoot: string): Promise<AdkConfig>;
+/** Resolve standard spec artifact paths under `.jcr-adk/specs/{specId}/`. */
+export declare function resolveSpecArtifactPaths(config: AdkConfig, specId: string): SpecArtifactPaths;
+/** Write JSON with optional overwrite (`force`). */
+export declare function writeJsonArtifact(filePath: string, data: unknown, force: boolean): Promise<WriteOutcome>;
+/** Write text with optional overwrite (`force`). */
+export declare function writeTextArtifact(filePath: string, content: string, force: boolean): Promise<WriteOutcome>;
+/** Create directory when missing; returns whether it was newly created. */
+export declare function ensureDir(dirPath: string): Promise<boolean>;
+/** Read and parse spec metadata.json. */
+export declare function readSpecMetadata(metadataPath: string): Promise<SpecMetadata>;
+/** Append one JSONL progress line (command-controlled write — MVP v1). */
+export declare function appendProgressLine(filePath: string, entry: Record<string, unknown>): Promise<void>;
+/** Build default v1 config file for `jcr-adk init`. */
+export declare function buildInitConfigFile(projectId?: string): import("@jcr-adk/core").AdkConfigFileV1;
+/** Standard init scaffold paths derived from workspace root. */
+export declare function resolveInitPaths(workspaceRoot: string): {
+    configFile: string;
+    specsDir: string;
+    logsDir: string;
+    gateReportsDir: string;
+};
+/** Template builders for `jcr-adk plan`. */
+export declare function buildPlanSpecMarkdown(specId: string, title: string, intent?: string): string;
+export declare function buildPlanMarkdown(specId: string): string;
+export declare function buildPlanAcceptanceJson(specId: string): {
+    specId: string;
+    items: {
+        id: string;
+        description: string;
+        evidencePath: string;
+    }[];
+};
+export declare function buildPlannedMetadata(specId: string, now?: Date): SpecMetadata;
+//# sourceMappingURL=lifecycle-artifacts.d.ts.map

package/dist/lifecycle-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-artifacts.d.ts","sourceRoot":"","sources":["../src/lifecycle-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mDAAmD;AACnD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,iFAAiF;AACjF,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAYnF;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAc7F;AAED,oDAAoD;AACpD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED,oDAAoD;AACpD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED,2EAA2E;AAC3E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAED,yCAAyC;AACzC,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAElF;AAED,0EAA0E;AAC1E,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxG;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,2CAErD;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM;;;;;EAQrD;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAaxD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM;;;;;;;EAqBrD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,YAAY,CAQnF"}