clinkx 0.3.0 → 1.0.0

package/clinkx-workflows/dist/plan-review/publication.js

@@ -0,0 +1,182 @@
+import { createHash } from "node:crypto";
+import { mkdir, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { z } from "zod";
+import { readContainedRelativeFile } from "../contained-file.js";
+import { CouncilPlanReviewResultSchema, MAX_RESULT_ENVELOPE_BYTES, PlanReviewErrorReasonSchema, } from "./contract.js";
+const SHA256_PATTERN = /^[0-9a-f]{64}$/;
+const RUN_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+export const PLAN_REVIEW_RESULT_RELPATH = "results/council-plan-review-result.json";
+/** Atomic state marker written only by the later Track-C publication path. */
+export const PlanReviewPublicationMarkerSchema = z
+    .discriminatedUnion("committed", [
+    z.object({ committed: z.literal(false) }).strict(),
+    z
+        .object({
+        committed: z.literal(true),
+        sidecar_relpath: z.string().min(1),
+        sidecar_sha256: z.string().regex(SHA256_PATTERN),
+        bytes: z.number().int().min(0).max(MAX_RESULT_ENVELOPE_BYTES).finite(),
+    })
+        .strict(),
+]);
+export const CouncilPlanReviewErrorSchema = z
+    .object({
+    schema_version: z.literal("council-plan-review-error-v1"),
+    run_id: z.string().regex(RUN_ID_PATTERN),
+    execution_status: z.enum(["succeeded", "failed", "cancelled"]),
+    stage: z.enum([
+        "snapshot",
+        "digest",
+        "context_preflight",
+        "execution_contract",
+        "publication",
+    ]),
+    error: z
+        .object({
+        reason: PlanReviewErrorReasonSchema,
+        detail: z.string().max(2_048).optional(),
+    })
+        .strict(),
+})
+    .strict();
+function boundedDetail(detail) {
+    return detail.slice(0, 2_048);
+}
+export function createPlanReviewPublicationError(runId, executionStatus, reason, detail) {
+    return CouncilPlanReviewErrorSchema.parse({
+        schema_version: "council-plan-review-error-v1",
+        run_id: runId,
+        execution_status: executionStatus,
+        stage: "publication",
+        error: { reason, detail: boundedDetail(detail) },
+    });
+}
+/** Canonical transport/sidecar bytes. The envelope schema owns the 1 MiB cap. */
+export function serializePlanReviewResult(value) {
+    const validated = CouncilPlanReviewResultSchema.parse(value);
+    const serialized = JSON.stringify(validated);
+    if (Buffer.byteLength(serialized, "utf-8") > MAX_RESULT_ENVELOPE_BYTES) {
+        throw new Error(`Serialized result envelope exceeds ${String(MAX_RESULT_ENVELOPE_BYTES)} bytes`);
+    }
+    return serialized;
+}
+/**
+ * Atomically publish bytes already produced by the validated terminal
+ * projector. Re-parse and canonicalize only as a fail-closed assertion: the
+ * exact supplied bytes are what reach disk.
+ */
+export async function writeSerializedPlanReviewResultSidecar(runDir, serialized) {
+    let decoded;
+    try {
+        decoded = JSON.parse(serialized);
+    }
+    catch (err) {
+        throw new Error(`Serialized result envelope is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const canonical = serializePlanReviewResult(CouncilPlanReviewResultSchema.parse(decoded));
+    if (canonical !== serialized) {
+        throw new Error("Serialized result envelope does not match canonical validated bytes");
+    }
+    const bytes = Buffer.byteLength(serialized, "utf-8");
+    const absolutePath = join(runDir, PLAN_REVIEW_RESULT_RELPATH);
+    const tmpPath = `${absolutePath}.tmp`;
+    await mkdir(dirname(absolutePath), { recursive: true });
+    await writeFile(tmpPath, serialized, "utf-8");
+    await rename(tmpPath, absolutePath);
+    return PlanReviewPublicationMarkerSchema.parse({
+        committed: true,
+        sidecar_relpath: PLAN_REVIEW_RESULT_RELPATH,
+        sidecar_sha256: createHash("sha256").update(serialized, "utf-8").digest("hex"),
+        bytes,
+    });
+}
+/**
+ * Validate already-admitted plan-review sidecar bytes without performing any
+ * filesystem access. Callers with a different trust root (the dashboard) must
+ * contain/read first, then reuse these producer-owned size/hash/schema checks.
+ */
+export function validatePlanReviewPublicationBytes(runId, executionStatus, publication, body) {
+    const bytes = publication.bytes;
+    const failure = (reason, detail) => ({
+        result_available: false,
+        result_bytes: bytes,
+        ...(executionStatus === undefined
+            ? {}
+            : {
+                error: createPlanReviewPublicationError(runId, executionStatus, reason, detail),
+            }),
+    });
+    if (body.byteLength !== bytes) {
+        return failure("schema_mismatch", "Plan-review result sidecar failed its committed size check.");
+    }
+    const actualHash = createHash("sha256").update(body).digest("hex");
+    if (actualHash !== publication.sidecar_sha256) {
+        return failure("schema_mismatch", "Plan-review result sidecar failed its SHA-256 check.");
+    }
+    const text = Buffer.from(body).toString("utf-8");
+    let decoded;
+    try {
+        decoded = JSON.parse(text);
+    }
+    catch (err) {
+        return failure("invalid_output", `Plan-review result sidecar is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const parsed = CouncilPlanReviewResultSchema.safeParse(decoded);
+    if (!parsed.success) {
+        return failure("schema_mismatch", `Plan-review result sidecar failed schema validation: ${parsed.error.issues
+            .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+            .join("; ")}`);
+    }
+    return {
+        result_available: true,
+        result_bytes: bytes,
+        result: text,
+    };
+}
+/**
+ * Inspect the committed sidecar. Cheap mode opens/stats/contains the file but
+ * never reads its body; authoritative mode performs exactly one bounded read.
+ */
+export async function inspectPlanReviewPublication(runDir, runId, executionStatus, publication, includeResult) {
+    const bytes = publication?.committed === true ? publication.bytes : 0;
+    if (publication === undefined) {
+        return { result_available: false, result_bytes: 0 };
+    }
+    if (!publication.committed) {
+        return {
+            result_available: false,
+            result_bytes: 0,
+            ...(executionStatus === undefined
+                ? {}
+                : {
+                    error: createPlanReviewPublicationError(runId, executionStatus, "no_artifact", "Plan-review result publication was not committed."),
+                }),
+        };
+    }
+    try {
+        const read = await readContainedRelativeFile(runDir, publication.sidecar_relpath, {
+            ...(includeResult ? { wantBytes: true } : {}),
+            requireRegular: true,
+            maxBytes: MAX_RESULT_ENVELOPE_BYTES,
+            containerLabel: "run directory",
+            pathLabel: "sidecar_relpath",
+        });
+        if (!includeResult) {
+            return { result_available: true, result_bytes: bytes };
+        }
+        return validatePlanReviewPublicationBytes(runId, executionStatus, publication, read.bytes);
+    }
+    catch (err) {
+        return {
+            result_available: false,
+            result_bytes: bytes,
+            ...(executionStatus === undefined
+                ? {}
+                : {
+                    error: createPlanReviewPublicationError(runId, executionStatus, "no_artifact", `Plan-review result sidecar is missing, unreadable, or uncontained: ${err instanceof Error ? err.message : String(err)}`),
+                }),
+        };
+    }
+}
+//# sourceMappingURL=publication.js.map

package/clinkx-workflows/dist/plan-review/publication.js.map

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

package/clinkx-workflows/dist/plan-review/ranking-reducer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Deterministic plan-review ranking reducer (B-5).
+ *
+ * Runs in place of an LLM call for the `ranking_analysis` stage. It consumes the
+ * frozen `cross_review` output contract (A-3): one advisory call per roster
+ * seat, opaque `cross_000…` call IDs, peers anonymized to opaque ordinals.
+ *
+ * Why this is not `council_ranking_v1`. The generic council reducer is retained
+ * unchanged for the five existing councils, but it is not compatible here:
+ *
+ * - It reads scores only from the council collection keys
+ *   (`member_evaluations`, `per_review_feedback`, …) on a 0-100 integer scale.
+ *   The plan-review domain quantity is the `review-receipt-v1` `score`: a finite
+ *   0-10 number. Reshaping the plan cross-review to `overall_score_100` would
+ *   contort the domain to fit the reducer.
+ * - Its `quorum.total_reviewers` is `artifacts.length` — it conflates "artifacts
+ *   present" with "reviewers", and its output schema has no way to record a
+ *   degenerate no-op cross-review, which the FIXED-cardinality A-3 composition
+ *   makes an expected, first-class outcome rather than an anomaly.
+ *
+ * Determinism and fail-closed rules:
+ *
+ * - An artifact that does not parse as a plan-review cross-review is SKIPPED and
+ *   counted in `participation.cross_reviews_unreadable`. It is never repaired,
+ *   guessed at, or fabricated.
+ * - Zero artifacts is a valid input: it yields empty rankings and zeroed
+ *   participation, not an error.
+ * - The output is advisory. It carries no verdict, score override, or receipt,
+ *   so it cannot upgrade a candidate (D2).
+ * - All ordering is by explicit numeric comparison then code-unit comparison of
+ *   `candidate_id`; no locale-dependent collation.
+ */
+import type { ArtifactRecord } from "../artifacts.js";
+export declare function planReviewRankingReducer(artifacts: readonly ArtifactRecord[]): string;

package/clinkx-workflows/dist/plan-review/ranking-reducer.js

@@ -0,0 +1,139 @@
+/**
+ * Deterministic plan-review ranking reducer (B-5).
+ *
+ * Runs in place of an LLM call for the `ranking_analysis` stage. It consumes the
+ * frozen `cross_review` output contract (A-3): one advisory call per roster
+ * seat, opaque `cross_000…` call IDs, peers anonymized to opaque ordinals.
+ *
+ * Why this is not `council_ranking_v1`. The generic council reducer is retained
+ * unchanged for the five existing councils, but it is not compatible here:
+ *
+ * - It reads scores only from the council collection keys
+ *   (`member_evaluations`, `per_review_feedback`, …) on a 0-100 integer scale.
+ *   The plan-review domain quantity is the `review-receipt-v1` `score`: a finite
+ *   0-10 number. Reshaping the plan cross-review to `overall_score_100` would
+ *   contort the domain to fit the reducer.
+ * - Its `quorum.total_reviewers` is `artifacts.length` — it conflates "artifacts
+ *   present" with "reviewers", and its output schema has no way to record a
+ *   degenerate no-op cross-review, which the FIXED-cardinality A-3 composition
+ *   makes an expected, first-class outcome rather than an anomaly.
+ *
+ * Determinism and fail-closed rules:
+ *
+ * - An artifact that does not parse as a plan-review cross-review is SKIPPED and
+ *   counted in `participation.cross_reviews_unreadable`. It is never repaired,
+ *   guessed at, or fabricated.
+ * - Zero artifacts is a valid input: it yields empty rankings and zeroed
+ *   participation, not an error.
+ * - The output is advisory. It carries no verdict, score override, or receipt,
+ *   so it cannot upgrade a candidate (D2).
+ * - All ordering is by explicit numeric comparison then code-unit comparison of
+ *   `candidate_id`; no locale-dependent collation.
+ */
+import { PlanReviewCrossReviewOutputSchema, PlanReviewRankingReducerOutputSchema, } from "../validators/plan-review.js";
+/** Locale-independent, code-unit ordering. `localeCompare` is not deterministic across ICU data. */
+function compareCandidateIds(a, b) {
+    if (a < b)
+        return -1;
+    if (a > b)
+        return 1;
+    return 0;
+}
+/** Keep the first entry per candidate; a model may rank one candidate twice at different ranks. */
+function dedupeByCandidate(entries) {
+    const seen = new Set();
+    const deduped = [];
+    for (const entry of entries) {
+        if (seen.has(entry.candidate_id))
+            continue;
+        seen.add(entry.candidate_id);
+        deduped.push(entry);
+    }
+    return deduped;
+}
+export function planReviewRankingReducer(artifacts) {
+    const rankingsByArtifact = [];
+    const scoresByCandidate = new Map();
+    const agreementByCandidate = new Map();
+    let present = 0;
+    let unreadable = 0;
+    let degenerate = 0;
+    for (const artifact of artifacts) {
+        const parsed = PlanReviewCrossReviewOutputSchema.safeParse(artifact.parsed);
+        if (!parsed.success) {
+            unreadable += 1;
+            continue;
+        }
+        present += 1;
+        const body = parsed.data;
+        if (body.peer_assessments.length === 0 && body.ranking.length === 0) {
+            degenerate += 1;
+        }
+        const ranking = dedupeByCandidate(body.ranking);
+        if (ranking.length > 0) {
+            rankingsByArtifact.push(ranking);
+        }
+        for (const assessment of body.peer_assessments) {
+            const scores = scoresByCandidate.get(assessment.candidate_id) ?? [];
+            scores.push(assessment.assessment_score);
+            scoresByCandidate.set(assessment.candidate_id, scores);
+            const counts = agreementByCandidate.get(assessment.candidate_id) ?? {
+                agree: 0,
+                partial: 0,
+                disagree: 0,
+            };
+            counts[assessment.agreement_level] += 1;
+            agreementByCandidate.set(assessment.candidate_id, counts);
+        }
+    }
+    const candidateSet = new Set();
+    for (const ranking of rankingsByArtifact) {
+        for (const entry of ranking)
+            candidateSet.add(entry.candidate_id);
+    }
+    const candidateCount = candidateSet.size;
+    const bordaScores = new Map();
+    for (const candidate of candidateSet)
+        bordaScores.set(candidate, 0);
+    for (const ranking of rankingsByArtifact) {
+        for (const entry of ranking) {
+            // Rank 1 scores `candidateCount` points, rank N scores 1. A rank beyond
+            // the candidate count scores 0 rather than going negative.
+            const points = Math.max(candidateCount - entry.rank + 1, 0);
+            bordaScores.set(entry.candidate_id, (bordaScores.get(entry.candidate_id) ?? 0) + points);
+        }
+    }
+    const consensusRanking = [...bordaScores.entries()]
+        .sort((a, b) => b[1] !== a[1] ? b[1] - a[1] : compareCandidateIds(a[0], b[0]))
+        .map(([candidate_id, borda_score], index) => ({
+        candidate_id,
+        borda_score,
+        rank: index + 1,
+    }));
+    const scoreSummary = [...scoresByCandidate.entries()]
+        .sort((a, b) => compareCandidateIds(a[0], b[0]))
+        .map(([candidate_id, scores]) => ({
+        candidate_id,
+        mean_score: scores.reduce((sum, score) => sum + score, 0) / scores.length,
+        score_count: scores.length,
+        spread: Math.max(...scores) - Math.min(...scores),
+    }));
+    const agreementSummary = [...agreementByCandidate.entries()]
+        .sort((a, b) => compareCandidateIds(a[0], b[0]))
+        .map(([candidate_id, counts]) => ({ candidate_id, ...counts }));
+    const output = {
+        schema_version: "plan-review-ranking-v1",
+        consensus_ranking: consensusRanking,
+        score_summary: scoreSummary,
+        agreement_summary: agreementSummary,
+        participation: {
+            cross_reviews_present: present,
+            cross_reviews_with_rankings: rankingsByArtifact.length,
+            degenerate_no_op_cross_reviews: degenerate,
+            cross_reviews_unreadable: unreadable,
+        },
+    };
+    // Fail closed rather than emit an artifact the registered validator would reject.
+    return JSON.stringify(PlanReviewRankingReducerOutputSchema.parse(output), null, 2);
+}
+//# sourceMappingURL=ranking-reducer.js.map

package/clinkx-workflows/dist/plan-review/ranking-reducer.js.map

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

package/clinkx-workflows/dist/plan-review/resume.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A-5 — resume fidelity.
+ *
+ * The persisted plan-review contract + immutable snapshot are the SOLE resume
+ * inputs. This module never reads `plan_file` and never sees caller input: it
+ * decodes, hash-verifies, and RECOMPUTES the digest of the persisted contract,
+ * re-verifies the persisted snapshot, and reconstructs the per-call bindings —
+ * all BEFORE the engine exists.
+ *
+ * Every failure here is a post-state pre-seat failure with
+ * `stage:"execution_contract"` (or `snapshot`/`digest` for the snapshot leg) —
+ * a `failed` RunState with no result sidecar, NOT the pre-mutex `-32602` that
+ * a type-(a) admission mismatch produces.
+ */
+import { type CouncilPlanReviewExecutionContract } from "./execution-contract.js";
+import { type PlanReviewCallBinding, type PlanReviewRunState } from "./run-state.js";
+import { type CanonicalPlanSnapshot } from "./snapshot.js";
+export interface RestoredPlanReviewRun {
+    readonly state: PlanReviewRunState;
+    readonly contract: CouncilPlanReviewExecutionContract;
+    readonly execution_contract_digest: string;
+    readonly call_bindings: readonly PlanReviewCallBinding[];
+    readonly snapshot_absolute_path: string;
+    /**
+     * The re-verified canonical snapshot, from the SAME read that verified it.
+     * Resume needs the text to check what a persisted prepared retry will
+     * actually dispatch (D9); re-reading it later would reopen the TOCTOU that
+     * read-and-verify-once exists to close.
+     */
+    readonly snapshot: CanonicalPlanSnapshot;
+}
+/**
+ * Restore + verify a plan-review run from persisted artifacts alone.
+ *
+ * @param chairmanCallId the chairman stage's call id from the persisted,
+ *   hash-verified workflow snapshot — the contract does not carry it.
+ */
+export declare function restorePlanReviewRun(runDir: string, persisted: unknown, chairmanCallId: string): Promise<RestoredPlanReviewRun>;

package/clinkx-workflows/dist/plan-review/resume.js

@@ -0,0 +1,122 @@
+/**
+ * A-5 — resume fidelity.
+ *
+ * The persisted plan-review contract + immutable snapshot are the SOLE resume
+ * inputs. This module never reads `plan_file` and never sees caller input: it
+ * decodes, hash-verifies, and RECOMPUTES the digest of the persisted contract,
+ * re-verifies the persisted snapshot, and reconstructs the per-call bindings —
+ * all BEFORE the engine exists.
+ *
+ * Every failure here is a post-state pre-seat failure with
+ * `stage:"execution_contract"` (or `snapshot`/`digest` for the snapshot leg) —
+ * a `failed` RunState with no result sidecar, NOT the pre-mutex `-32602` that
+ * a type-(a) admission mismatch produces.
+ */
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { z } from "zod";
+import { readContainedRelativeFile } from "../contained-file.js";
+import { CouncilPlanReviewExecutionContractSchema, computeCouncilPlanReviewExecutionContractDigest, } from "./execution-contract.js";
+import { PlanReviewCallBindingSchema, parsePlanReviewRunState, reconstructPlanReviewCallBindings, } from "./run-state.js";
+import { MAX_EXECUTION_CONTRACT_BYTES, verifyPersistedPlanSnapshot, } from "./snapshot.js";
+import { PlanReviewStageError } from "./stage-error.js";
+function contractFailure(message, reason) {
+    throw new PlanReviewStageError("execution_contract", message, reason);
+}
+/** Key-order-independent serialization for call-binding equality. */
+function canonicalBindings(bindings) {
+    return JSON.stringify(z.array(PlanReviewCallBindingSchema).parse([...bindings]));
+}
+/**
+ * Restore + verify a plan-review run from persisted artifacts alone.
+ *
+ * @param chairmanCallId the chairman stage's call id from the persisted,
+ *   hash-verified workflow snapshot — the contract does not carry it.
+ */
+export async function restorePlanReviewRun(runDir, persisted, chairmanCallId) {
+    // 1. The subtree itself must be strictly valid — a corrupt subtree cannot be
+    //    trusted to name the artifacts we are about to verify against.
+    let state;
+    try {
+        state = parsePlanReviewRunState(persisted);
+    }
+    catch (err) {
+        contractFailure(`Persisted plan_review_state failed validation: ${err instanceof Error ? err.message : String(err)}`, "schema_mismatch");
+    }
+    // 2. Decode the persisted contract through the contained no-follow reader.
+    let bytes;
+    try {
+        const read = await readContainedRelativeFile(runDir, state.execution_contract_path, {
+            wantBytes: true,
+            requireRegular: true,
+            maxBytes: MAX_EXECUTION_CONTRACT_BYTES,
+        });
+        bytes = read.bytes;
+    }
+    catch (err) {
+        contractFailure(`Persisted execution contract at ${state.execution_contract_path} is unreadable: ${err instanceof Error ? err.message : String(err)}`, "no_artifact");
+    }
+    // 3. Hash-verify the FILE BYTES before parsing them.
+    const sha256 = createHash("sha256").update(bytes).digest("hex");
+    if (sha256 !== state.execution_contract_sha256) {
+        contractFailure(`Persisted execution contract at ${state.execution_contract_path} failed its hash check`, "schema_mismatch");
+    }
+    let decoded;
+    try {
+        decoded = JSON.parse(bytes.toString("utf-8"));
+    }
+    catch (err) {
+        contractFailure(`Persisted execution contract is not valid JSON: ${err instanceof Error ? err.message : String(err)}`, "invalid_output");
+    }
+    const parsed = CouncilPlanReviewExecutionContractSchema.safeParse(decoded);
+    if (!parsed.success) {
+        contractFailure(`Persisted execution contract failed schema validation: ${parsed.error.issues
+            .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+            .join("; ")}`, "schema_mismatch");
+    }
+    // 4. RECOMPUTE the identity digest. A matching file hash only proves the file
+    //    did not rot; recomputation proves the contract still normalizes to the
+    //    identity this run was admitted under.
+    let recomputed;
+    try {
+        recomputed = computeCouncilPlanReviewExecutionContractDigest(parsed.data);
+    }
+    catch (err) {
+        contractFailure(`Persisted execution contract could not be canonicalized: ${err instanceof Error ? err.message : String(err)}`, "invalid_output");
+    }
+    if (recomputed.digest !== state.execution_contract_digest) {
+        contractFailure(`Recomputed execution_contract_digest ${recomputed.digest} does not match the persisted ${state.execution_contract_digest}`, "schema_mismatch");
+    }
+    // 5. The contract must still agree with the persisted snapshot binding.
+    if (recomputed.contract.context_evidence_policy.snapshot_digest !== state.plan_digest) {
+        contractFailure("Persisted execution contract snapshot_digest does not match the persisted plan snapshot digest", "schema_mismatch");
+    }
+    // 6. Re-verify the immutable snapshot from run-owned storage (never plan_file).
+    const snapshot = await verifyPersistedPlanSnapshot(runDir, state.snapshot_path, state.snapshot_sha256, state.plan_digest);
+    // 7. Reconstruct the per-call bindings from the verified contract and require
+    //    them to reproduce what was persisted — a resumed run that would dispatch
+    //    a call to a different (or absent) provider fails closed here (D3).
+    let bindings;
+    try {
+        bindings = reconstructPlanReviewCallBindings(recomputed.contract, chairmanCallId);
+    }
+    catch (err) {
+        contractFailure(`Per-call bindings could not be reconstructed: ${err instanceof Error ? err.message : String(err)}`, "schema_mismatch");
+    }
+    // Normalize BOTH sides through the same schema before comparing: a Zod parse
+    // emits keys in schema order, so a raw JSON.stringify of a reconstructed
+    // literal would differ from the persisted-and-parsed value purely by key
+    // order — a false mismatch that would brick every resume.
+    if (canonicalBindings(bindings) !== canonicalBindings(state.call_bindings)) {
+        contractFailure("Reconstructed per-call bindings do not match the persisted bindings", "schema_mismatch");
+    }
+    return {
+        state,
+        contract: recomputed.contract,
+        execution_contract_digest: recomputed.digest,
+        call_bindings: bindings,
+        snapshot_absolute_path: join(runDir, state.snapshot_path),
+        snapshot,
+    };
+}
+//# sourceMappingURL=resume.js.map

package/clinkx-workflows/dist/plan-review/resume.js.map

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

package/clinkx-workflows/dist/plan-review/rubric.d.ts

@@ -0,0 +1,7 @@
+/** Canonical machine-readable identity of the rubric baked into reviewer.txt. */
+export declare const PACKAGED_PLAN_REVIEW_RUBRIC: {
+    readonly schema_version: "plan-review-rubric-v1";
+    readonly dimensions: readonly ["scope_and_non_goals", "evidence_anchors", "cross_repo_ownership", "dependency_graph", "runnable_verification", "rollback_where_relevant", "risks", "undisguised_blockers"];
+    readonly rules: readonly ["unverified_is_not_approved", "deliberation_is_advisory", "chairman_is_not_approval"];
+};
+export declare const PACKAGED_PLAN_REVIEW_RUBRIC_DIGEST: string;

package/clinkx-workflows/dist/plan-review/rubric.js

@@ -0,0 +1,24 @@
+import { createHash } from "node:crypto";
+/** Canonical machine-readable identity of the rubric baked into reviewer.txt. */
+export const PACKAGED_PLAN_REVIEW_RUBRIC = {
+    schema_version: "plan-review-rubric-v1",
+    dimensions: [
+        "scope_and_non_goals",
+        "evidence_anchors",
+        "cross_repo_ownership",
+        "dependency_graph",
+        "runnable_verification",
+        "rollback_where_relevant",
+        "risks",
+        "undisguised_blockers",
+    ],
+    rules: [
+        "unverified_is_not_approved",
+        "deliberation_is_advisory",
+        "chairman_is_not_approval",
+    ],
+};
+export const PACKAGED_PLAN_REVIEW_RUBRIC_DIGEST = createHash("sha256")
+    .update(JSON.stringify(PACKAGED_PLAN_REVIEW_RUBRIC), "utf-8")
+    .digest("hex");
+//# sourceMappingURL=rubric.js.map

package/clinkx-workflows/dist/plan-review/rubric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rubric.js","sourceRoot":"","sources":["../../src/plan-review/rubric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,cAAc,EAAE,uBAAuB;IACvC,UAAU,EAAE;QACV,qBAAqB;QACrB,kBAAkB;QAClB,sBAAsB;QACtB,kBAAkB;QAClB,uBAAuB;QACvB,yBAAyB;QACzB,OAAO;QACP,sBAAsB;KACvB;IACD,KAAK,EAAE;QACL,4BAA4B;QAC5B,0BAA0B;QAC1B,0BAA0B;KAC3B;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,kCAAkC,GAAG,UAAU,CAAC,QAAQ,CAAC;KACnE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,EAAE,OAAO,CAAC;KAC5D,MAAM,CAAC,KAAK,CAAC,CAAC"}