@claudexor/review 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 joi-lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @claudexor/review
+
+Internal package of [Claudexor](https://github.com/razzant/claudexor) — Deterministic gates, cross-family review, finding revalidation, route proof, convergence, readiness-debt.
+
+Published as part of the Claudexor toolchain; it follows the monorepo's
+lockstep version and has no separate semver contract. Use the `claudexor`
+CLI (or `@claudexor/cli`) as the supported entry point.

package/dist/convergence.d.ts

@@ -0,0 +1,22 @@
+import type { ConvergencePredicate, GateResult, ReviewFinding } from "@claudexor/schema";
+export interface ConvergenceInput {
+    predicate: ConvergencePredicate;
+    gates: GateResult[];
+    findings: ReviewFinding[];
+    /** A cross-family clean review exists for the final diff. */
+    finalReviewClean: boolean;
+    /** The final diff has not changed since the final review (not stale). */
+    diffStableAfterReview: boolean;
+}
+export interface ConvergenceResult {
+    converged: boolean;
+    reasons: string[];
+    openBlockers: ReviewFinding[];
+}
+/**
+ * Evaluate the convergence predicate. Convergence does NOT mean "no model can
+ * invent any new nit" — it means no accepted important finding remains open,
+ * required gates pass, and the final scope-valid review is clean/stable.
+ */
+export declare function evaluateConvergence(input: ConvergenceInput): ConvergenceResult;
+//# sourceMappingURL=convergence.d.ts.map

package/dist/convergence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convergence.d.ts","sourceRoot":"","sources":["../src/convergence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIzF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,aAAa,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CA4B9E"}

package/dist/convergence.js

@@ -0,0 +1,35 @@
+import { isBlocking } from "@claudexor/schema";
+import { gatesPassed } from "./gates.js";
+/**
+ * Evaluate the convergence predicate. Convergence does NOT mean "no model can
+ * invent any new nit" — it means no accepted important finding remains open,
+ * required gates pass, and the final scope-valid review is clean/stable.
+ */
+export function evaluateConvergence(input) {
+    const reasons = [];
+    const p = input.predicate;
+    const openBlockers = input.findings.filter((f) => isBlocking(f));
+    if (p.require_tests_pass && !gatesPassed(input.gates)) {
+        reasons.push("required gates are not all passing");
+    }
+    if (p.require_no_accepted_block_open && openBlockers.some((f) => f.severity === "BLOCK")) {
+        reasons.push("an accepted BLOCK finding is open");
+    }
+    if (p.require_no_accepted_fix_first_open && openBlockers.some((f) => f.severity === "FIX_FIRST")) {
+        reasons.push("an accepted FIX_FIRST finding is open");
+    }
+    // An accepted NEEDS_HUMAN escalation blocks convergence on its own. Without
+    // this, a run with cross-family clean review disabled could converge to
+    // success with an open NEEDS_HUMAN (the v0.8 hole), bypassing the human gate.
+    if (p.require_no_accepted_needs_human_open && openBlockers.some((f) => f.severity === "NEEDS_HUMAN")) {
+        reasons.push("an accepted NEEDS_HUMAN escalation is open");
+    }
+    if (p.require_final_cross_family_clean_review && !input.finalReviewClean) {
+        reasons.push("no final cross-family clean review");
+    }
+    if (p.require_final_diff_stable_after_review && !input.diffStableAfterReview) {
+        reasons.push("diff changed after final review (review is stale)");
+    }
+    return { converged: reasons.length === 0, reasons, openBlockers };
+}
+//# sourceMappingURL=convergence.js.map

package/dist/convergence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convergence.js","sourceRoot":"","sources":["../src/convergence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBzC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjE,IAAI,CAAC,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,CAAC,8BAA8B,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,CAAC,kCAAkC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,EAAE,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACxD,CAAC;IACD,4EAA4E;IAC5E,wEAAwE;IACxE,8EAA8E;IAC9E,IAAI,CAAC,CAAC,oCAAoC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,aAAa,CAAC,EAAE,CAAC;QACrG,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,CAAC,uCAAuC,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,CAAC,sCAAsC,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC"}

package/dist/findings.d.ts

@@ -0,0 +1,22 @@
+import type { ReviewFinding, RouteProofStatus } from "@claudexor/schema";
+/** Extract JSON payloads from a reviewer's free-text output (fenced or bare). */
+export declare function extractJsonBlocks(text: string): unknown[];
+export interface ReviewerInfo {
+    harness_id: string;
+    requested_model?: string | null;
+    requested_effort?: string | null;
+    observed_model?: string | null;
+    route_proof_status?: RouteProofStatus;
+}
+export declare function parseFindingsDetailed(text: string, reviewer: ReviewerInfo): {
+    findings: ReviewFinding[];
+    malformed: number;
+};
+/**
+ * Merge near-duplicate findings (same category + claim + file set), keeping the
+ * most severe. NEEDS_HUMAN is an orthogonal human-gate, not a severity rung — it
+ * is never collapsed into (or replaced by) another finding, so a same-key BLOCK
+ * from a second reviewer can never silently swallow a human-approval escalation.
+ */
+export declare function dedupeFindings(findings: ReviewFinding[]): ReviewFinding[];
+//# sourceMappingURL=findings.d.ts.map

package/dist/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAY,MAAM,mBAAmB,CAAC;AAKnF,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CA2HzD;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,GACrB;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAkDlD;AAgBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAwBzE"}

package/dist/findings.js

@@ -0,0 +1,239 @@
+import { ReviewFinding as ReviewFindingSchema } from "@claudexor/schema";
+import { newId } from "@claudexor/util";
+/** Extract JSON payloads from a reviewer's free-text output (fenced or bare). */
+export function extractJsonBlocks(text) {
+    const results = [];
+    const isRecord = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+    const isSingleFindingObject = (value) => "severity" in value && ("claim" in value || "message" in value || "evidence" in value);
+    const isReviewPayload = (value, allowSingleObject) => {
+        if (Array.isArray(value))
+            return true;
+        if (!isRecord(value))
+            return false;
+        if (Array.isArray(value.findings))
+            return true;
+        return allowSingleObject && isSingleFindingObject(value);
+    };
+    const tryParse = (candidate, allowSingleObject = false) => {
+        const trimmed = candidate.trim();
+        if (!trimmed)
+            return false;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (!isReviewPayload(parsed, allowSingleObject))
+                return false;
+            results.push(parsed);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const findBalancedJsonEnd = (source, start) => {
+        const open = source[start];
+        if (open !== "[" && open !== "{")
+            return null;
+        const stack = [open];
+        let inString = false;
+        let escaped = false;
+        for (let i = start + 1; i < source.length; i += 1) {
+            const ch = source[i] ?? "";
+            if (inString) {
+                if (escaped) {
+                    escaped = false;
+                }
+                else if (ch === "\\") {
+                    escaped = true;
+                }
+                else if (ch === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (ch === '"') {
+                inString = true;
+                continue;
+            }
+            if (ch === "[" || ch === "{") {
+                stack.push(ch);
+                continue;
+            }
+            if (ch === "]" || ch === "}") {
+                const expected = ch === "]" ? "[" : "{";
+                if (stack.pop() !== expected)
+                    return null;
+                if (stack.length === 0)
+                    return i + 1;
+            }
+        }
+        return null;
+    };
+    const isWhitespaceOnly = (source, start) => {
+        for (let i = start; i < source.length; i += 1) {
+            const ch = source[i] ?? "";
+            if (ch !== " " && ch !== "\t" && ch !== "\n" && ch !== "\r")
+                return false;
+        }
+        return true;
+    };
+    const jsonLineStarts = (source, open) => {
+        const starts = [];
+        let lineStart = 0;
+        for (let i = 0; i <= source.length; i += 1) {
+            if (i < source.length && source[i] !== "\n")
+                continue;
+            const lineEnd = i > lineStart && source[i - 1] === "\r" ? i - 1 : i;
+            let first = lineStart;
+            while (first < lineEnd) {
+                const ch = source[first] ?? "";
+                if (ch !== " " && ch !== "\t")
+                    break;
+                first += 1;
+            }
+            const ch = source[first] ?? "";
+            if (first < lineEnd && ch === open)
+                starts.push(first);
+            lineStart = i + 1;
+        }
+        return starts;
+    };
+    const fence = /```(?:json)?\s*([\s\S]*?)```/g;
+    let m;
+    let found = false;
+    while ((m = fence.exec(text)) !== null) {
+        found = tryParse(m[1] ?? "", true) || found;
+    }
+    if (!found) {
+        const trimmed = text.trim();
+        if (!tryParse(trimmed, true)) {
+            const arrayStarts = jsonLineStarts(trimmed, "[");
+            const starts = arrayStarts.length > 0 ? arrayStarts : jsonLineStarts(trimmed, "{");
+            for (let i = starts.length - 1; i >= 0; i -= 1) {
+                const start = starts[i] ?? 0;
+                const end = findBalancedJsonEnd(trimmed, start);
+                if (end === null)
+                    continue;
+                const candidate = trimmed.slice(start, end);
+                if (isWhitespaceOnly(trimmed, end)) {
+                    if (tryParse(candidate, true))
+                        break;
+                    continue;
+                }
+                // Some native transcripts duplicate status text after the model's final
+                // JSON block. Prefer the last complete line-start JSON block over
+                // discarding an otherwise valid reviewer response.
+                if (tryParse(candidate, true))
+                    break;
+            }
+        }
+        const lines = trimmed.split(/\r?\n/);
+        if (results.length === 0) {
+            for (const line of lines) {
+                const candidate = line.trim();
+                if ((candidate.startsWith("[") && candidate.endsWith("]")) ||
+                    (candidate.startsWith("{") && candidate.endsWith("}"))) {
+                    if (tryParse(candidate, true))
+                        break;
+                }
+            }
+        }
+    }
+    return results;
+}
+export function parseFindingsDetailed(text, reviewer) {
+    const raw = [];
+    for (const block of extractJsonBlocks(text)) {
+        if (Array.isArray(block))
+            raw.push(...block);
+        else if (block && typeof block === "object") {
+            const candidate = block;
+            if (Array.isArray(candidate.findings))
+                raw.push(...candidate.findings);
+            else
+                raw.push(block);
+        }
+    }
+    const out = [];
+    let malformed = 0;
+    for (const r of raw) {
+        if (!r || typeof r !== "object") {
+            malformed += 1;
+            continue;
+        }
+        // A finding WITHOUT a severity is malformed, not "WARN by default": the
+        // fail-closed verdict parse must never silently downgrade what might have
+        // been a blocker into a non-blocking level (the one lenient branch this
+        // parser used to have).
+        if (r.severity === undefined || r.severity === null) {
+            malformed += 1;
+            continue;
+        }
+        try {
+            out.push(ReviewFindingSchema.parse({
+                id: r.id ?? newId("f"),
+                severity: r.severity,
+                category: r.category ?? "correctness",
+                claim: String(r.claim ?? r.message ?? "(no claim)"),
+                linked_acceptance_criteria: r.linked_acceptance_criteria ?? [],
+                evidence: r.evidence ?? {},
+                proposed_fix: r.proposed_fix ?? null,
+                reviewer: {
+                    harness_id: reviewer.harness_id,
+                    requested_model: reviewer.requested_model ?? null,
+                    requested_effort: reviewer.requested_effort ?? null,
+                    observed_model: reviewer.observed_model ?? null,
+                    route_proof_status: reviewer.route_proof_status ?? "unverified",
+                },
+                status: "proposed",
+            }));
+        }
+        catch {
+            malformed += 1;
+        }
+    }
+    return { findings: out, malformed };
+}
+const SEVERITY_ORDER = [
+    "INSUFFICIENT_EVIDENCE",
+    "NIT",
+    "OUT_OF_SCOPE",
+    "WARN",
+    "NEEDS_HUMAN",
+    "FIX_FIRST",
+    "BLOCK",
+];
+function severityRank(s) {
+    return SEVERITY_ORDER.indexOf(s);
+}
+/**
+ * Merge near-duplicate findings (same category + claim + file set), keeping the
+ * most severe. NEEDS_HUMAN is an orthogonal human-gate, not a severity rung — it
+ * is never collapsed into (or replaced by) another finding, so a same-key BLOCK
+ * from a second reviewer can never silently swallow a human-approval escalation.
+ */
+export function dedupeFindings(findings) {
+    const seen = new Map();
+    const humanGates = [];
+    const insufficientEvidence = [];
+    for (const f of findings) {
+        if (f.severity === "NEEDS_HUMAN") {
+            humanGates.push(f);
+            continue;
+        }
+        if (f.severity === "INSUFFICIENT_EVIDENCE") {
+            insufficientEvidence.push(f);
+            continue;
+        }
+        const files = f.evidence.files
+            .map((x) => x.path)
+            .sort()
+            .join(",");
+        const key = `${f.category}|${f.claim.toLowerCase().slice(0, 120)}|${files}`;
+        const existing = seen.get(key);
+        if (!existing || severityRank(f.severity) > severityRank(existing.severity)) {
+            seen.set(key, f);
+        }
+    }
+    return [...seen.values(), ...humanGates, ...insufficientEvidence];
+}
+//# sourceMappingURL=findings.js.map

package/dist/findings.js.map

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

package/dist/gates.d.ts

@@ -0,0 +1,19 @@
+import type { GateResult } from "@claudexor/schema";
+export interface GateSpec {
+    id: string;
+    command: string;
+    required?: boolean;
+}
+export interface RunGatesOptions {
+    cwd: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    /** Cancellation: checked between gates AND passed into each gate's process
+     * (a cancel must not wait out a 600s gate before acknowledging). */
+    signal?: AbortSignal;
+}
+/** Run one deterministic gate. Outcome is decided by exit code, never by parsing text. */
+export declare function runGate(spec: GateSpec, opts: RunGatesOptions): Promise<GateResult>;
+export declare function runGates(specs: GateSpec[], opts: RunGatesOptions): Promise<GateResult[]>;
+export declare function gatesPassed(gates: GateResult[]): boolean;
+//# sourceMappingURL=gates.d.ts.map

package/dist/gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../src/gates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;wEACoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,0FAA0F;AAC1F,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAuCxF;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAS9F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAExD"}

package/dist/gates.js

@@ -0,0 +1,72 @@
+import { GateResult as GateResultSchema } from "@claudexor/schema";
+import { runCapture } from "@claudexor/core";
+import { redactSecrets } from "@claudexor/util";
+const GATE_OUTPUT_TAIL_CHARS = 12_000;
+/** Run one deterministic gate. Outcome is decided by exit code, never by parsing text. */
+export async function runGate(spec, opts) {
+    const start = Date.now();
+    let code = null;
+    let timedOut = false;
+    let stdout = "";
+    let stderr = "";
+    try {
+        const r = await runCapture("sh", ["-c", spec.command], {
+            cwd: opts.cwd,
+            env: opts.env,
+            timeoutMs: opts.timeoutMs ?? 600_000,
+            abortSignal: opts.signal,
+        });
+        code = r.code;
+        stdout = r.stdout;
+        stderr = r.stderr;
+        if (r.signal === "SIGKILL")
+            timedOut = true;
+    }
+    catch (err) {
+        // A gate whose SPAWN itself throws is still an honest `failed`, but the
+        // reason must survive as evidence — exit_code:null with empty tails is
+        // undiagnosable ("evidence beats summaries").
+        code = null;
+        stderr = `gate spawn failed: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    const status = timedOut ? "timed_out" : code === 0 ? "passed" : "failed";
+    const includeOutput = status !== "passed";
+    const stdoutEvidence = includeOutput ? outputTail(stdout) : EMPTY_OUTPUT_TAIL;
+    const stderrEvidence = includeOutput ? outputTail(stderr) : EMPTY_OUTPUT_TAIL;
+    return GateResultSchema.parse({
+        id: spec.id,
+        command: spec.command,
+        exit_code: code,
+        status,
+        duration_ms: Date.now() - start,
+        required: spec.required ?? true,
+        stdout_tail: stdoutEvidence.tail,
+        stderr_tail: stderrEvidence.tail,
+        output_truncated: stdoutEvidence.truncated || stderrEvidence.truncated,
+    });
+}
+export async function runGates(specs, opts) {
+    const out = [];
+    for (const spec of specs) {
+        // Abort between gates: remaining gates are simply not run (the attempt is
+        // being cancelled; burning their full timeouts would delay the ack).
+        if (opts.signal?.aborted)
+            break;
+        out.push(await runGate(spec, opts));
+    }
+    return out;
+}
+export function gatesPassed(gates) {
+    return gates.filter((g) => g.required).every((g) => g.status === "passed");
+}
+const EMPTY_OUTPUT_TAIL = { tail: null, truncated: false };
+function outputTail(text) {
+    const redacted = redactSecrets(text).trimEnd();
+    if (!redacted)
+        return EMPTY_OUTPUT_TAIL;
+    return {
+        tail: redacted.slice(-GATE_OUTPUT_TAIL_CHARS),
+        truncated: redacted.length > GATE_OUTPUT_TAIL_CHARS,
+    };
+}
+//# sourceMappingURL=gates.js.map

package/dist/gates.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./gates.js";
+export * from "./route.js";
+export * from "./findings.js";
+export * from "./revalidate.js";
+export * from "./convergence.js";
+export * from "./readiness.js";
+export * from "./reviewEngine.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,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./gates.js";
+export * from "./route.js";
+export * from "./findings.js";
+export * from "./revalidate.js";
+export * from "./convergence.js";
+export * from "./readiness.js";
+export * from "./reviewEngine.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":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/readiness.d.ts

@@ -0,0 +1,20 @@
+export interface ReadinessDebt {
+    signature: string;
+    count: number;
+    lastReason: string;
+}
+/**
+ * Tracks "commit-readiness debts" to detect thrashing. When a
+ * failure signature repeats, the loop should change strategy (in
+ * until_clean) or stop and ask (in adversarial-review), rather than
+ * re-running the same failing approach.
+ */
+export declare class ReadinessLedger {
+    private readonly debts;
+    recordRound(signature: string, reason: string): void;
+    /** True when the same failure signature has recurred >= threshold times. */
+    isStalled(signature: string, threshold?: number): boolean;
+}
+/** Stable signature for a set of failure reasons, for thrash detection. */
+export declare function failureSignature(reasons: string[]): string;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUpD,4EAA4E;IAC5E,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,OAAO;CAGrD;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE1D"}

package/dist/readiness.js

@@ -0,0 +1,28 @@
+/**
+ * Tracks "commit-readiness debts" to detect thrashing. When a
+ * failure signature repeats, the loop should change strategy (in
+ * until_clean) or stop and ask (in adversarial-review), rather than
+ * re-running the same failing approach.
+ */
+export class ReadinessLedger {
+    debts = new Map();
+    recordRound(signature, reason) {
+        const debt = this.debts.get(signature);
+        if (debt) {
+            debt.count += 1;
+            debt.lastReason = reason;
+        }
+        else {
+            this.debts.set(signature, { signature, count: 1, lastReason: reason });
+        }
+    }
+    /** True when the same failure signature has recurred >= threshold times. */
+    isStalled(signature, threshold = 2) {
+        return (this.debts.get(signature)?.count ?? 0) >= threshold;
+    }
+}
+/** Stable signature for a set of failure reasons, for thrash detection. */
+export function failureSignature(reasons) {
+    return reasons.slice().map((r) => r.toLowerCase()).sort().join(" | ");
+}
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D,WAAW,CAAC,SAAiB,EAAE,MAAc;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAChB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,SAAS,CAAC,SAAiB,EAAE,SAAS,GAAG,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,IAAI,SAAS,CAAC;IAC9D,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,OAAiB;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC"}

package/dist/revalidate.d.ts

@@ -0,0 +1,22 @@
+import type { FindingStatus, ReviewFinding } from "@claudexor/schema";
+export interface RevalidateDecision {
+    status: FindingStatus;
+    note?: string;
+}
+export interface RevalidateOptions {
+    candidateRoot?: string;
+    evidenceDir?: string;
+}
+/**
+ * Deterministic revalidation (no LLM): enforces the evidence invariants that
+ * always hold — no evidence -> cannot block; out-of-scope/insufficient pass
+ * through; a NEEDS_HUMAN escalation stays a blocking human gate.
+ */
+export declare function deterministicDecision(f: ReviewFinding, options?: RevalidateOptions): RevalidateDecision;
+/**
+ * Revalidate every finding deterministically. Each finding's status is recorded;
+ * the evidence-free BLOCK/FIX_FIRST invariant is applied so a reviewer cannot
+ * leave an evidence-free finding in a blocking state.
+ */
+export declare function revalidateFindings(findings: ReviewFinding[], options?: RevalidateOptions): Promise<ReviewFinding[]>;
+//# sourceMappingURL=revalidate.d.ts.map

package/dist/revalidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate.d.ts","sourceRoot":"","sources":["../src/revalidate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8DD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,aAAa,EAChB,OAAO,GAAE,iBAAsB,GAC9B,kBAAkB,CAuBpB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAQ1B"}