@openrig/cli 0.1.12 → 0.3.0

package/dist/commands/restore-check.js

@@ -0,0 +1,234 @@
+import { Command } from "commander";
+import { DaemonClient } from "../client.js";
+import { getDaemonStatus, getDaemonUrl } from "../daemon-lifecycle.js";
+import { realDeps } from "./daemon.js";
+const STATUS_SYMBOLS = {
+    green: "✓",
+    yellow: "⚠",
+    red: "✗",
+};
+const STATUS_COLORS = {
+    green: "",
+    yellow: "",
+    red: "",
+};
+export function restoreCheckCommand(depsOverride) {
+    const cmd = new Command("restore-check")
+        .description("Check restore readiness across running rigs")
+        .addHelpText("after", `
+Examples:
+  rig restore-check                    Check all rigs
+  rig restore-check --rig openrig-pm   Check one rig
+  rig restore-check --no-queue         Skip queue file checks
+  rig restore-check --no-hooks         Skip hook checks
+  rig restore-check --json             JSON output for agents
+
+Exit codes:
+  0  Restorable (or restorable with caveats)
+  1  Not restorable (red blockers found)
+  2  Unknown / probe error`);
+    const getDepsF = () => depsOverride ?? { lifecycleDeps: realDeps(), clientFactory: (url) => new DaemonClient(url) };
+    cmd
+        .option("--json", "JSON output for agents")
+        .option("--rig <name>", "Check one rig only")
+        .option("--no-queue", "Skip queue file checks")
+        .option("--no-hooks", "Skip hook checks")
+        .action(async (opts) => {
+        const deps = getDepsF();
+        const status = await getDaemonStatus(deps.lifecycleDeps);
+        if (status.state !== "running" || status.healthy === false) {
+            // Daemon down — produce a structured not_restorable result
+            const result = localRestoreResult({
+                verdict: "not_restorable",
+                checks: [{
+                        check: "daemon.reachable",
+                        status: "red",
+                        evidence: "Daemon is not running",
+                        remediation: "Start the daemon with: rig daemon start",
+                    }],
+                repairPacket: [{
+                        step: 1,
+                        command: "Start the daemon with: rig daemon start",
+                        rationale: "Daemon is not running",
+                        safe: false, // mutating: starts a daemon process
+                        blocking: true,
+                    }],
+                recovery: {
+                    status: "blocked",
+                    summary: "No exact rig recovery action is known until the daemon is running.",
+                    actions: [],
+                    blocked: [{
+                            scope: "host",
+                            reason: "Daemon is not running; rig state could not be inspected for recovery planning.",
+                        }],
+                    unknown: [],
+                },
+            });
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                printHuman(result);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        const client = deps.clientFactory(getDaemonUrl(status));
+        try {
+            const params = new URLSearchParams();
+            if (opts.rig)
+                params.set("rig", opts.rig);
+            if (opts.queue === false)
+                params.set("noQueue", "true");
+            if (opts.hooks === false)
+                params.set("noHooks", "true");
+            const query = params.toString();
+            const path = `/api/restore-check${query ? `?${query}` : ""}`;
+            const response = await client.get(path);
+            if (response.status >= 500) {
+                const result = localRestoreResult({
+                    verdict: "unknown",
+                    checks: [{
+                            check: "probe.error",
+                            status: "red",
+                            evidence: `Daemon returned HTTP ${response.status}`,
+                            remediation: "Check daemon logs with: rig daemon logs",
+                        }],
+                    repairPacket: [{
+                            step: 1,
+                            command: "Check daemon logs with: rig daemon logs",
+                            rationale: `Daemon returned HTTP ${response.status}`,
+                            safe: true,
+                            blocking: true,
+                        }],
+                    recovery: {
+                        status: "unknown",
+                        summary: `Recovery status could not be inspected because daemon returned HTTP ${response.status}.`,
+                        actions: [],
+                        blocked: [],
+                        unknown: [{
+                                scope: "host",
+                                reason: `Daemon returned HTTP ${response.status}`,
+                            }],
+                    },
+                });
+                if (opts.json) {
+                    console.log(JSON.stringify(result, null, 2));
+                }
+                else {
+                    printHuman(result);
+                }
+                process.exitCode = 2;
+                return;
+            }
+            const result = response.data;
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                printHuman(result);
+            }
+            // Exit codes: 0 for restorable/restorable_with_caveats; 1 for not_restorable; 2 for unknown
+            if (result.verdict === "not_restorable") {
+                process.exitCode = 1;
+            }
+            else if (result.verdict === "unknown") {
+                process.exitCode = 2;
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+            console.error("Fix: check daemon status with: rig daemon status");
+            process.exitCode = 2;
+        }
+    });
+    return cmd;
+}
+function printHuman(result) {
+    const verdictLabel = result.verdict.replace(/_/g, " ").toUpperCase();
+    console.log(`RESTORE CHECK — ${verdictLabel}`);
+    console.log(`${result.counts.green} green | ${result.counts.yellow} yellow | ${result.counts.red} red`);
+    const readinessLabel = result.readiness.status.replace(/_/g, " ");
+    console.log(`READINESS: ${readinessLabel} (${result.readiness.reason})`);
+    console.log(`CONTINUITY: ${result.continuity.status.replace(/_/g, " ")}`);
+    if (result.hostInfra) {
+        console.log(`Host bootstrap/autostart: ${result.hostInfra.status} — ${result.hostInfra.evidence}`);
+    }
+    console.log(`RECOVERY: ${result.recovery.status.replace(/_/g, " ").toUpperCase()}`);
+    console.log(result.recovery.summary);
+    for (const action of result.recovery.actions) {
+        console.log(`  Action: ${action.command}`);
+    }
+    for (const issue of result.recovery.blocked) {
+        console.log(`  Blocked: ${issue.reason}`);
+    }
+    for (const issue of result.recovery.unknown) {
+        console.log(`  Unknown: ${issue.reason}`);
+    }
+    if (result.rigs && result.rigs.length > 0) {
+        console.log();
+        console.log("Per-rig summary:");
+        console.log(`${"rig".padEnd(24)} ${"status".padEnd(16)} ${"ready".padEnd(9)} ${"blocked".padEnd(8)} caveats`);
+        for (const rig of result.rigs) {
+            console.log(`${rig.rigName.slice(0, 24).padEnd(24)} ${rig.status.padEnd(16)} ` +
+                `${`${rig.runningReadyNodes}/${rig.expectedNodes}`.padEnd(9)} ${String(rig.blockedNodes).padEnd(8)} ${rig.caveatNodes}`);
+        }
+    }
+    console.log();
+    for (const check of result.checks) {
+        const sym = STATUS_SYMBOLS[check.status] ?? "?";
+        console.log(`  ${sym} ${check.check}: ${check.evidence}`);
+        if (check.remediation) {
+            console.log(`    Fix: ${check.remediation}`);
+        }
+    }
+    if (result.repairPacket && result.repairPacket.length > 0) {
+        const blockers = result.repairPacket.filter((s) => s.blocking).length;
+        const caveats = result.repairPacket.filter((s) => !s.blocking).length;
+        console.log();
+        console.log(`Repair steps: ${result.repairPacket.length} (${blockers} blocking, ${caveats} caveats)`);
+        if (blockers > 0) {
+            console.log("Resolve blocking steps before restoring.");
+        }
+    }
+    else if (result.counts.red > 0) {
+        console.log();
+        console.log("Blockers found. Resolve red items before restoring.");
+    }
+    else if (result.counts.yellow > 0) {
+        console.log();
+        console.log("Restorable with caveats. Yellow items are non-blocking but worth reviewing.");
+    }
+}
+function localRestoreResult(input) {
+    const red = input.checks.filter((c) => c.status === "red").length;
+    const yellow = input.checks.filter((c) => c.status === "yellow").length;
+    const green = input.checks.filter((c) => c.status === "green").length;
+    const unknown = input.verdict === "unknown";
+    return {
+        verdict: input.verdict,
+        readiness: {
+            status: unknown ? "unknown" : "not_ready",
+            reason: unknown ? "unknown_probe_state" : "blockers_present",
+            blockingRigCount: 0,
+            caveatRigCount: 0,
+            unknownRigCount: 0,
+        },
+        continuity: {
+            status: "not_proven",
+            evidence: "Strict same-session/provider-context resume is not verified by restore-check v1.",
+            provenCapabilities: [],
+            unprovenCapabilities: ["provider_session_resume", "context_window_preservation", "interrupted_work_functional_resume"],
+        },
+        rigs: [],
+        hostInfra: {
+            status: "unknown",
+            evidence: "Host bootstrap/autostart source could not be inspected because restore-check did not receive daemon route evidence",
+        },
+        counts: { red, yellow, green },
+        checks: input.checks,
+        repairPacket: input.repairPacket,
+        recovery: input.recovery,
+    };
+}
+//# sourceMappingURL=restore-check.js.map

package/dist/commands/restore-check.js.map

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

package/dist/commands/restore-packet.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import { DaemonClient } from "../client.js";
+import { type LifecycleDeps } from "../daemon-lifecycle.js";
+export interface RestorePacketDeps {
+    lifecycleDeps?: LifecycleDeps;
+    clientFactory?: (url: string) => DaemonClient;
+}
+export declare function restorePacketCommand(depsOverride?: RestorePacketDeps): Command;
+//# sourceMappingURL=restore-packet.d.ts.map

package/dist/commands/restore-packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-packet.d.ts","sourceRoot":"","sources":["../../src/commands/restore-packet.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAqB3F,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC;CAC/C;AA+JD,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAyU9E"}

package/dist/commands/restore-packet.js

@@ -0,0 +1,383 @@
+// restore-packet.ts — `rig restore-packet {write,read,validate}` CLI command.
+//
+// M2a: command shape + mutual-exclusion + read/validate stubs.
+// M2b: source-adapter wiring (codex-jsonl-parser, claude-transcript-parser,
+//      runtime-detect, redaction, omitted-records).
+// M2c-CLI: write action full impl using packet-writer.ts; --source-jsonl
+//          + --source-session adapter wiring; CLI flag defaults for the
+//          ~11 contract-required fields not derivable from the parser.
+// M2c-Daemon: full-read transcript route + auth + redaction + tests.
+// M3: real read + validate implementations replacing the stubs.
+import { Command } from "commander";
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { resolve as resolvePath, join as joinPath } from "node:path";
+import { DaemonClient } from "../client.js";
+import { getDaemonStatus, getDaemonUrl } from "../daemon-lifecycle.js";
+import { realDeps } from "./daemon.js";
+import { detectRuntime } from "../restore-packet/runtime-detect.js";
+import { parseCodexJsonl } from "../restore-packet/codex-jsonl-parser.js";
+import { parseClaudeTranscript } from "../restore-packet/claude-transcript-parser.js";
+import { writePacket } from "../restore-packet/packet-writer.js";
+import { validateRestoreSummary, } from "../restore-packet/schema-validator.js";
+// Per M1 contract § 1: 4 required packet files. Used by validate's
+// packet-shape check and by read for transcript-presence detection.
+const REQUIRED_PACKET_FILES = [
+    "restore-instructions.md",
+    "transcript-latest.md",
+    "touched-files.md",
+    "restore-summary.json",
+];
+/**
+ * R2: derive canonical (source_session_id, source_rig) per honest-fallback
+ * policy. Override flags > parsed session_meta (jsonl) > supplied --source-session.
+ *
+ * Returns either the derived pair (with no exception) OR throws an Error
+ * containing the explicit operator-facing guidance message. The action
+ * caller catches and routes to reportFailure().
+ */
+function deriveProvenance(opts, parsedSessionId, hasJsonl) {
+    // Step 1: source_session_id — override > parsed > --source-session arg.
+    let sourceSessionId;
+    if (typeof opts.sourceSessionIdOverride === "string" && opts.sourceSessionIdOverride.length > 0) {
+        sourceSessionId = opts.sourceSessionIdOverride;
+    }
+    else if (hasJsonl) {
+        if (!parsedSessionId) {
+            throw new Error("no session_meta record in source JSONL; supply --source-session-id-override <id> AND --source-rig-override <rig> to set provenance explicitly. Silent fallback to file-path-as-session-id is not allowed (M2c-CLI R2 honest-provenance policy).");
+        }
+        sourceSessionId = parsedSessionId;
+    }
+    else {
+        // hasSession path: operator-named session is authoritative.
+        sourceSessionId = opts.sourceSession;
+    }
+    // Step 2: source_rig — override > <seat>@<rig> split.
+    let sourceRig;
+    if (typeof opts.sourceRigOverride === "string" && opts.sourceRigOverride.length > 0) {
+        sourceRig = opts.sourceRigOverride;
+    }
+    else {
+        const m = /^[^@]+@([^@]+)$/.exec(sourceSessionId);
+        const captured = m?.[1];
+        if (!captured) {
+            throw new Error(`could not derive source_rig from session id '${sourceSessionId}' (does not match <seat>@<rig> shape); supply --source-rig-override <rig> explicitly. Silent fallback to source_rig:"unknown" is not allowed (M2c-CLI R2 honest-provenance policy).`);
+        }
+        sourceRig = captured;
+    }
+    return { sourceSessionId, sourceRig };
+}
+function reportFailure(message) {
+    console.error(`rig restore-packet write: ${message}`);
+    process.exitCode = 2;
+}
+function isValidRuntime(value) {
+    return value === "codex" || value === "claude-code";
+}
+async function fetchSourceTranscriptViaDaemon(session, deps) {
+    const lifecycleDeps = deps?.lifecycleDeps ?? realDeps();
+    const status = await getDaemonStatus(lifecycleDeps);
+    if (status.state !== "running" || typeof status.port !== "number") {
+        throw new Error("daemon not running; start it with: rig daemon start");
+    }
+    const url = getDaemonUrl(status);
+    const client = (deps?.clientFactory ?? ((u) => new DaemonClient(u)))(url);
+    // M2c-Daemon will define this route. M2c-CLI calls it; M2c-CLI tests
+    // mock the daemon (compact-plan.test.ts:166-176 pattern). The path is
+    // a draft — M2c-Daemon may pick a different naming convention; if so,
+    // M2c-Daemon will land that change in restore-packet.ts the same commit
+    // that adds the daemon route.
+    const path = `/api/transcripts/${encodeURIComponent(session)}/full`;
+    const response = await client.get(path);
+    if (response.status >= 400 || !response.data) {
+        throw new Error(`daemon transcript fetch failed: HTTP ${response.status}: ${typeof response.data === "object" && response.data !== null
+            ? JSON.stringify(response.data)
+            : "(no body)"}`);
+    }
+    return {
+        content: response.data.content ?? "",
+        sourceCwd: response.data.cwd ?? null,
+    };
+}
+function buildWritePacketOptions(opts, structured, sourceRuntime, sourceCwdFallback, sourceSessionId, sourceRig) {
+    const trustRankingDefault = "rig_whoami,bounded_latest_transcript";
+    const trustRankingRaw = opts.sourceTrustRanking ?? trustRankingDefault;
+    const trustRanking = trustRankingRaw
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    return {
+        targetDir: resolvePath(opts.target),
+        structured,
+        sourceRuntime,
+        targetRig: opts.targetRig ?? "openrig-velocity",
+        targetRuntime: isValidRuntime(opts.targetRuntime) ? opts.targetRuntime : "claude-code",
+        targetWorkspaceRoot: opts.targetWorkspaceRoot ?? structured.sessionMeta?.cwd ?? sourceCwdFallback,
+        defaultTargetRepo: opts.defaultTargetRepo ?? null,
+        rolePointer: opts.rolePointer ?? `rigs/${opts.targetRig ?? "openrig-velocity"}/state/velocity/role.md`,
+        currentWorkSummary: opts.currentWorkSummary ?? "Cross-runtime restore packet generated by rig restore-packet write.",
+        nextOwner: opts.nextOwner ?? "self",
+        caveats: opts.caveat ?? [],
+        authorityBoundaries: opts.authorityBoundaries ?? "Restored seat authority per source session role.",
+        sourceTrustRanking: trustRanking,
+        sourceSessionId,
+        sourceRig,
+        sourceCwd: structured.sessionMeta?.cwd ?? sourceCwdFallback,
+        generatorVersion: opts.generatorVersion ?? "rig-restore-packet@0.1.0",
+        includeFullTranscript: structured.messages.length > 0,
+    };
+}
+export function restorePacketCommand(depsOverride) {
+    const cmd = new Command("restore-packet")
+        .description("Generate, read, and validate cross-runtime restore packets per the v0 standard");
+    cmd.command("write")
+        .description("Generate a restore packet from a source session or JSONL file")
+        .option("--source-session <session>", "Source session name (daemon-backed)")
+        .option("--source-jsonl <path>", "Source Codex/Claude JSONL transcript file (direct)")
+        .option("--source-runtime <runtime>", "Force source runtime (claude-code | codex); auto-detected if omitted")
+        .requiredOption("--target <dir>", "Target packet directory (must not exist; created atomically)")
+        .option("--target-rig <rig>", "Target rig name for the restored seat")
+        .option("--target-runtime <runtime>", "Target runtime (claude-code | codex)")
+        .option("--target-workspace-root <path>", "Target workspace root absolute path")
+        .option("--default-target-repo <path>", "Default target repo absolute path or null")
+        .option("--role-pointer <path>", "Role guidance pointer path or URI for the restored seat")
+        .option("--current-work-summary <text>", "One-paragraph summary of the source seat's current work")
+        .option("--next-owner <name>", 'Who the restored seat hands off to next (default: "self")')
+        .option("--caveat <text>", "Caveat to include in the packet (repeatable)", (value, prev = []) => prev.concat([value]), [])
+        .option("--authority-boundaries <text>", "Explicit statement of restored-seat authority")
+        .option("--source-trust-ranking <csv>", "Comma-separated source-trust ranking; default: rig_whoami,bounded_latest_transcript")
+        .option("--generator-version <version>", 'Generator version identifier (default: "rig-restore-packet@0.1.0")')
+        .option("--source-session-id-override <id>", "Operator override for source_session_id (R2; required when JSONL has no session_meta record)")
+        .option("--source-rig-override <rig>", "Operator override for source_rig (R2; required when canonical session id is bare with no <seat>@<rig> shape)")
+        .action(async (opts) => {
+        const hasSession = typeof opts.sourceSession === "string" && opts.sourceSession.length > 0;
+        const hasJsonl = typeof opts.sourceJsonl === "string" && opts.sourceJsonl.length > 0;
+        if (hasSession && hasJsonl) {
+            reportFailure("--source-session and --source-jsonl are mutually exclusive; supply exactly one.");
+            return;
+        }
+        if (!hasSession && !hasJsonl) {
+            reportFailure("exactly one of --source-session or --source-jsonl is required.");
+            return;
+        }
+        try {
+            let content;
+            let sourceCwdFallback;
+            if (hasJsonl) {
+                const jsonlPath = resolvePath(opts.sourceJsonl);
+                content = readFileSync(jsonlPath, "utf-8");
+                sourceCwdFallback = "/";
+            }
+            else {
+                const session = opts.sourceSession;
+                const fetched = await fetchSourceTranscriptViaDaemon(session, depsOverride);
+                content = fetched.content;
+                sourceCwdFallback = fetched.sourceCwd ?? "/";
+            }
+            let runtime = null;
+            if (isValidRuntime(opts.sourceRuntime)) {
+                runtime = opts.sourceRuntime;
+            }
+            else if (typeof opts.sourceRuntime === "string" && opts.sourceRuntime.length > 0) {
+                reportFailure(`--source-runtime must be 'codex' or 'claude-code'; got '${opts.sourceRuntime}'.`);
+                return;
+            }
+            else {
+                runtime = detectRuntime(content);
+                if (runtime === null) {
+                    reportFailure("could not auto-detect source runtime; pass --source-runtime <claude-code|codex> explicitly.");
+                    return;
+                }
+            }
+            const structured = runtime === "codex"
+                ? parseCodexJsonl(content)
+                : parseClaudeTranscript(content);
+            // R2: derive (source_session_id, source_rig) honestly. Override
+            // flags > parsed session_meta (jsonl) > supplied --source-session
+            // arg. Throws an Error with explicit operator guidance when the
+            // honest-provenance policy can't be satisfied.
+            let provenance;
+            try {
+                provenance = deriveProvenance(opts, structured.sessionMeta?.sessionId ?? null, hasJsonl);
+            }
+            catch (err) {
+                reportFailure(err.message);
+                return;
+            }
+            const writeOpts = buildWritePacketOptions(opts, structured, runtime, sourceCwdFallback, provenance.sourceSessionId, provenance.sourceRig);
+            const result = await writePacket(writeOpts);
+            // Per Quality Lesson v9: log only metadata, NOT transcript content.
+            console.log(`packet: ${result.targetDir}`);
+            console.log(`files: ${result.files.length}`);
+            for (const f of result.files) {
+                console.log(`  - ${f}`);
+            }
+            console.log(`messages: ${structured.messageCount}`);
+            console.log(`omitted-classes: ${Object.entries(structured.omittedCounts).filter(([, v]) => v > 0).map(([k, v]) => `${k}=${v}`).join(",") || "(none)"}`);
+        }
+        catch (err) {
+            reportFailure(err.message);
+        }
+    });
+    cmd.command("read")
+        .description("Render a restore packet contents (human or --json)")
+        .argument("<packet-dir>", "Packet directory path")
+        .option("--json", "Emit machine-readable JSON output")
+        .action(async (packetDir, opts) => {
+        const dir = resolvePath(packetDir);
+        const summaryPath = joinPath(dir, "restore-summary.json");
+        if (!existsSync(summaryPath)) {
+            console.error(`rig restore-packet read: restore-summary.json not found at ${summaryPath}.`);
+            process.exitCode = 2;
+            return;
+        }
+        let summary;
+        try {
+            summary = JSON.parse(readFileSync(summaryPath, "utf-8"));
+        }
+        catch (err) {
+            console.error(`rig restore-packet read: restore-summary.json is not valid JSON: ${err.message}.`);
+            process.exitCode = 2;
+            return;
+        }
+        if (opts.json) {
+            // Per IMPL § M3: --json emits raw restore-summary.json content
+            // verbatim; round-trippable.
+            console.log(JSON.stringify(summary, null, 2));
+            return;
+        }
+        // Human output: restore-instructions body + summary metadata + transcript digest.
+        const instructionsPath = joinPath(dir, "restore-instructions.md");
+        if (existsSync(instructionsPath)) {
+            console.log(readFileSync(instructionsPath, "utf-8"));
+        }
+        else {
+            console.log("(restore-instructions.md absent in packet directory)");
+        }
+        console.log("--- Summary metadata ---");
+        const metadataKeys = [
+            "source_session_id",
+            "source_rig",
+            "source_cwd",
+            "source_runtime",
+            "target_rig",
+            "target_runtime",
+            "generator_version",
+        ];
+        for (const k of metadataKeys) {
+            const v = summary[k];
+            console.log(`${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`);
+        }
+        const blt = summary.bounded_latest_transcript;
+        if (blt) {
+            console.log(`bounded_latest_transcript.bound: ${blt.bound}`);
+            console.log(`bounded_latest_transcript.message_count: ${blt.message_count}`);
+        }
+        const omittedClasses = summary.omitted_classes;
+        console.log(`omitted_classes: ${Array.isArray(omittedClasses) ? omittedClasses.join(",") || "(none)" : "(unknown)"}`);
+        // Transcript digest line (per IMPL § M3 + contract § 1 parity rule).
+        const transcriptPath = joinPath(dir, "transcript.md");
+        const hasFullTranscriptKey = Object.prototype.hasOwnProperty.call(summary, "full_transcript");
+        if (existsSync(transcriptPath)) {
+            const sz = statSync(transcriptPath).size;
+            console.log(`transcript.md: ${sz} bytes`);
+            if (!hasFullTranscriptKey) {
+                console.log("(parity warning: transcript.md present but full_transcript summary key absent)");
+            }
+        }
+        else {
+            if (hasFullTranscriptKey) {
+                console.log("(parity warning: full_transcript summary key present but transcript.md absent)");
+            }
+            else {
+                console.log("transcript.md absent (full_transcript key absent in summary; valid per parity rule)");
+            }
+        }
+    });
+    cmd.command("validate")
+        .description("Validate a restore packet against the v0 schema")
+        .argument("<packet-dir>", "Packet directory path")
+        .option("--json", "Emit machine-readable validation report")
+        .action(async (packetDir, opts) => {
+        const dir = resolvePath(packetDir);
+        const errors = [];
+        // Packet-shape check: 4 required files per contract § 1.
+        for (const required of REQUIRED_PACKET_FILES) {
+            const p = joinPath(dir, required);
+            if (!existsSync(p)) {
+                errors.push({
+                    field: required,
+                    value: "<missing>",
+                    rule: `packet-shape: required file missing at ${p}`,
+                    severity: "error",
+                });
+            }
+        }
+        // Schema validation if restore-summary.json exists.
+        let summary = null;
+        const summaryPath = joinPath(dir, "restore-summary.json");
+        if (existsSync(summaryPath)) {
+            try {
+                summary = JSON.parse(readFileSync(summaryPath, "utf-8"));
+            }
+            catch (err) {
+                errors.push({
+                    field: "restore-summary.json",
+                    value: "<invalid-json>",
+                    rule: `restore-summary.json parse failed: ${err.message}`,
+                    severity: "error",
+                });
+            }
+            if (summary) {
+                const schemaResult = validateRestoreSummary(summary);
+                for (const e of schemaResult.errors)
+                    errors.push(e);
+            }
+        }
+        // Parity check (per contract § 1 + § 8): full_transcript summary key
+        // ↔ transcript.md presence.
+        if (summary) {
+            const hasFullTranscriptKey = Object.prototype.hasOwnProperty.call(summary, "full_transcript");
+            const transcriptExists = existsSync(joinPath(dir, "transcript.md"));
+            if (hasFullTranscriptKey && !transcriptExists) {
+                errors.push({
+                    field: "full_transcript",
+                    value: "<key-present-file-absent>",
+                    rule: "parity: full_transcript summary key present but transcript.md absent at packet directory",
+                    severity: "error",
+                });
+            }
+            if (!hasFullTranscriptKey && transcriptExists) {
+                errors.push({
+                    field: "transcript.md",
+                    value: "<file-present-key-absent>",
+                    rule: "parity: transcript.md present but full_transcript summary key absent",
+                    severity: "error",
+                });
+            }
+        }
+        const hasErrorSeverity = errors.some((e) => e.severity === "error");
+        const valid = !hasErrorSeverity;
+        if (opts.json) {
+            console.log(JSON.stringify({ valid, errors }, null, 2));
+        }
+        else {
+            if (errors.length === 0) {
+                console.log(`valid: packet at ${dir} passed all checks.`);
+            }
+            else {
+                console.log(`${valid ? "valid (with warnings)" : "invalid"}: ${errors.length} issue(s) at ${dir}`);
+                for (const e of errors) {
+                    const tag = e.severity === "warning" ? "WARNING" : "ERROR";
+                    console.log(`  [${tag}] ${e.field}: ${e.rule} (value: ${e.value})`);
+                }
+            }
+        }
+        // Per contract § 8: required-field violations / parity violations →
+        // exit nonzero. Optional-field warnings → exit 0.
+        if (hasErrorSeverity) {
+            process.exitCode = 2;
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=restore-packet.js.map