agentskeptic 0.1.1

package/dist/failureExplanation.js

@@ -0,0 +1,389 @@
+import { buildFailureAnalysis } from "./failureAnalysis.js";
+import { formatOperationalMessage } from "./failureCatalog.js";
+import { RUN_LEVEL_CODE_TO_ORIGIN } from "./failureOriginCatalog.js";
+import { userPhraseForReasonCode } from "./verificationUserPhrases.js";
+export class FailureExplanationInvariantError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "FailureExplanationInvariantError";
+    }
+}
+const POLICY_INVALID_MESSAGE = "Verification policy is missing or invalid for failure explanation.";
+const EMPTY_CODES_MESSAGE = "Primary failure analysis evidence had empty codes.";
+const EFFECT_SCOPE_MESSAGE = "Primary failure analysis evidence must not be scope effect.";
+const STEP_TRUTH_MISMATCH_MESSAGE = "Truth report step missing for failure explanation driver step.";
+const RUN_CONTEXT_INDEX_MESSAGE = "Run-context failure explanation requires ingestIndex on primary evidence.";
+const NO_STEPS_FOR_WORKFLOW = "NO_STEPS_FOR_WORKFLOW";
+const MULTI_EFFECT_ROLLUP_CODES = new Set([
+    "MULTI_EFFECT_PARTIAL",
+    "MULTI_EFFECT_ALL_FAILED",
+    "MULTI_EFFECT_INCOMPLETE",
+    "MULTI_EFFECT_UNCERTAIN_WITHIN_WINDOW",
+]);
+function parseEffects(evidenceSummary) {
+    const raw = evidenceSummary.effects;
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const row of raw) {
+        if (typeof row !== "object" || row === null)
+            continue;
+        const o = row;
+        if (typeof o.id !== "string" || typeof o.status !== "string" || !Array.isArray(o.reasons))
+            continue;
+        out.push({
+            id: o.id,
+            status: o.status,
+            reasons: o.reasons,
+        });
+    }
+    return out;
+}
+function sortUniqueCodes(codes) {
+    return [...new Set(codes)].sort((a, b) => a.localeCompare(b));
+}
+function minLex(codes) {
+    return sortUniqueCodes(codes)[0];
+}
+function normMessage(s) {
+    const t = s.replace(/\r\n|\r|\n/g, " ").replace(/ +/g, " ").trim();
+    if (t.length === 0)
+        return "(no message)";
+    return formatOperationalMessage(t);
+}
+function fillTemplate(template, vars) {
+    let out = template;
+    for (const [k, v] of Object.entries(vars)) {
+        out = out.split(`<${k}>`).join(v);
+    }
+    return out;
+}
+function scalarToDetail(v) {
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "object")
+        return JSON.stringify(v);
+    return String(v);
+}
+/** Exported for doc parity tests; placeholders use angle brackets in the string. */
+export const FE_RUN_LEVEL_EXPECTED = "Verification expected a valid captured run for workflowId=<workflowId> under policy [<P>] with no run-level ingest or planning failures.";
+export const FE_RUN_LEVEL_OBSERVED = "Run-level failure: code=<firstCode> detail=<detail>.";
+export const FE_RUN_LEVEL_DIVERGENCE = "Divergence at run_level: code=<firstCode> meaning=<meaning>";
+export const FE_EVENT_SEQUENCE_EXPECTED = "Verification expected monotonic, well-formed event capture for workflowId=<workflowId> under policy [<P>].";
+export const FE_EVENT_SEQUENCE_OBSERVED = "Event-sequence irregularity: code=<firstCode> detail=<detail>.";
+export const FE_EVENT_SEQUENCE_DIVERGENCE = "Divergence at event_sequence: code=<firstCode> meaning=<meaning>";
+export const FE_RUN_CONTEXT_EXPECTED = "Verification expected upstream run context through ingest_index=<ingestIndex> to allow fair evaluation of the failing tool observation under policy [<P>].";
+export const FE_RUN_CONTEXT_OBSERVED = "Run-context signal before the failing observation: code=<C> <detail>.";
+export const FE_RUN_CONTEXT_DIVERGENCE = "Divergence at run_context before the failing tool observation: code=<C> meaning=<meaning>";
+export const FE_STEP_EXPECTED = "Verification expected post-execution database state to satisfy verify_target \"<verifyTargetOrLiteralNull>\" and intended_effect \"<narrative>\" for seq=<seq> toolId=<toolId> under policy [<P>].";
+export const FE_STEP_OBSERVED = "Step verification outcome: code=<primaryCode> detail=<detail><suffix>";
+export const FE_STEP_DIVERGENCE = "Divergence at step seq=<seq> toolId=<toolId>: primary_code=<primaryCode> meaning=<meaning>";
+export const FE_NO_STEPS_OBSERVED = "No tool_observed steps were produced for workflowId=<workflowId>.";
+export const FE_NO_STEPS_DIVERGENCE = "Divergence: no steps to verify against the database under policy [<P>]";
+/** All branch template literals (doc fences must match these). */
+export const FAILURE_EXPLANATION_BRANCH_TEMPLATES = {
+    runLevel: { expected: FE_RUN_LEVEL_EXPECTED, observed: FE_RUN_LEVEL_OBSERVED, divergence: FE_RUN_LEVEL_DIVERGENCE },
+    eventSequence: {
+        expected: FE_EVENT_SEQUENCE_EXPECTED,
+        observed: FE_EVENT_SEQUENCE_OBSERVED,
+        divergence: FE_EVENT_SEQUENCE_DIVERGENCE,
+    },
+    runContext: {
+        expected: FE_RUN_CONTEXT_EXPECTED,
+        observed: FE_RUN_CONTEXT_OBSERVED,
+        divergence: FE_RUN_CONTEXT_DIVERGENCE,
+    },
+    step: { expected: FE_STEP_EXPECTED, observed: FE_STEP_OBSERVED, divergence: FE_STEP_DIVERGENCE },
+    noSteps: {
+        expected: FE_RUN_LEVEL_EXPECTED,
+        observed: FE_NO_STEPS_OBSERVED,
+        divergence: FE_NO_STEPS_DIVERGENCE,
+    },
+};
+const KNOWN_FACT_ORDER = [
+    "trust_summary",
+    "workflow_status",
+    "verification_policy",
+    "primary_origin",
+    "classification_confidence",
+    "failure_analysis_summary",
+    "primary_scope",
+    "primary_codes",
+    "primary_ingest_index",
+    "primary_tool_id",
+    "primary_source",
+    "primary_run_event_id",
+    "primary_seq",
+    "primary_effect_id",
+    "verify_target",
+    "intended_effect_narrative",
+    "evidence_summary_field",
+    "evidence_summary_expected",
+    "evidence_summary_actual",
+    "evidence_summary_row_count",
+];
+export function policyFragment(engine) {
+    const p = engine.verificationPolicy;
+    if (p === undefined || p === null) {
+        throw new FailureExplanationInvariantError("EXPLANATION_VERIFICATION_POLICY_INVALID", POLICY_INVALID_MESSAGE);
+    }
+    const { consistencyMode, verificationWindowMs, pollIntervalMs } = p;
+    if (consistencyMode !== "strong" && consistencyMode !== "eventual") {
+        throw new FailureExplanationInvariantError("EXPLANATION_VERIFICATION_POLICY_INVALID", POLICY_INVALID_MESSAGE);
+    }
+    if (typeof verificationWindowMs !== "number" || !Number.isFinite(verificationWindowMs)) {
+        throw new FailureExplanationInvariantError("EXPLANATION_VERIFICATION_POLICY_INVALID", POLICY_INVALID_MESSAGE);
+    }
+    if (typeof pollIntervalMs !== "number" || !Number.isFinite(pollIntervalMs)) {
+        throw new FailureExplanationInvariantError("EXPLANATION_VERIFICATION_POLICY_INVALID", POLICY_INVALID_MESSAGE);
+    }
+    return `consistencyMode=${consistencyMode}; verificationWindowMs=${verificationWindowMs}; pollIntervalMs=${pollIntervalMs}`;
+}
+function buildRunContextDetail(ctx, ingestIndex, C) {
+    if (C === "RETRIEVAL_ERROR") {
+        const row = ctx.retrievalEvents.find((e) => e.ingestIndex === ingestIndex && e.status === "error");
+        if (row === undefined)
+            return "run_context_record_missing=true";
+        return `source=${row.source} status=error`;
+    }
+    if (C.startsWith("MODEL_TURN_")) {
+        const suffix = C.slice("MODEL_TURN_".length).toLowerCase();
+        const status = suffix;
+        const row = ctx.modelTurnEvents.find((e) => e.ingestIndex === ingestIndex && e.status === status);
+        if (row === undefined)
+            return "run_context_record_missing=true";
+        return `status=${row.status}`;
+    }
+    if (C === "CONTROL_INTERRUPT") {
+        const row = ctx.controlEvents.find((e) => e.ingestIndex === ingestIndex && e.controlKind === "interrupt");
+        if (row === undefined)
+            return "run_context_record_missing=true";
+        return "controlKind=interrupt";
+    }
+    if (C === "CONTROL_BRANCH_SKIPPED") {
+        const row = ctx.controlEvents.find((e) => e.ingestIndex === ingestIndex &&
+            e.controlKind === "branch" &&
+            e.decision === "skipped");
+        if (row === undefined)
+            return "run_context_record_missing=true";
+        return "controlKind=branch decision=skipped";
+    }
+    if (C === "CONTROL_GATE_SKIPPED") {
+        const row = ctx.controlEvents.find((e) => e.ingestIndex === ingestIndex && e.controlKind === "gate" && e.decision === "skipped");
+        if (row === undefined)
+            return "run_context_record_missing=true";
+        return "controlKind=gate decision=skipped";
+    }
+    if (C === "TOOL_SKIPPED") {
+        const row = ctx.toolSkippedEvents.find((e) => e.ingestIndex === ingestIndex);
+        if (row === undefined)
+            return "run_context_record_missing=true";
+        return `toolId=${row.toolId}`;
+    }
+    return "run_context_record_missing=true";
+}
+function msgReasonForDriverStep(driver, primaryCode) {
+    const rollup = driver.reasons[0]?.code;
+    if (rollup !== undefined && MULTI_EFFECT_ROLLUP_CODES.has(rollup) && primaryCode !== rollup) {
+        const effects = parseEffects(driver.evidenceSummary);
+        const failing = effects
+            .filter((e) => e.status !== "verified")
+            .sort((a, b) => a.id.localeCompare(b.id))[0];
+        if (failing?.reasons[0] !== undefined)
+            return failing.reasons[0];
+    }
+    return driver.reasons[0] ?? { code: primaryCode, message: "" };
+}
+function evidenceSummarySuffix(evidenceSummary) {
+    const parts = [];
+    const order = ["field", "expected", "actual", "rowCount"];
+    for (const k of order) {
+        if (Object.prototype.hasOwnProperty.call(evidenceSummary, k)) {
+            parts.push(`${k}=${scalarToDetail(evidenceSummary[k])}`);
+        }
+    }
+    if (parts.length === 0)
+        return "";
+    return `; ${parts.join("; ")}`;
+}
+function buildUnknowns(fa) {
+    const out = [];
+    const unknownRows = fa.unknownReasonCodes.map((c) => ({
+        id: "unknown_reason_code",
+        value: `code=${c}|meaning=${userPhraseForReasonCode(c)}`,
+    }));
+    unknownRows.sort((a, b) => a.value.localeCompare(b.value));
+    out.push(...unknownRows);
+    if (fa.confidence === "medium" || fa.confidence === "low") {
+        out.push({ id: "classification_confidence_band", value: fa.confidence });
+    }
+    if (fa.alternativeHypotheses !== undefined) {
+        for (const alt of fa.alternativeHypotheses) {
+            out.push({
+                id: "competing_hypothesis",
+                value: `origin=${alt.primaryOrigin}|rationale=${normMessage(alt.rationale)}`,
+            });
+        }
+    }
+    return out;
+}
+function assembleKnownFacts(map) {
+    const out = [];
+    for (const id of KNOWN_FACT_ORDER) {
+        const v = map.get(id);
+        if (v !== undefined)
+            out.push({ id, value: v });
+    }
+    return out;
+}
+function addPrimaryEvidenceFacts(map, e0, fa) {
+    map.set("primary_scope", e0.scope);
+    if (e0.codes !== undefined && e0.codes.length > 0) {
+        map.set("primary_codes", sortUniqueCodes(e0.codes).join(","));
+    }
+    if (e0.ingestIndex !== undefined)
+        map.set("primary_ingest_index", String(e0.ingestIndex));
+    if (e0.toolId !== undefined)
+        map.set("primary_tool_id", e0.toolId);
+    if (e0.source !== undefined)
+        map.set("primary_source", e0.source);
+    if (e0.runEventId !== undefined)
+        map.set("primary_run_event_id", e0.runEventId === null ? "null" : e0.runEventId);
+    if (e0.seq !== undefined)
+        map.set("primary_seq", String(e0.seq));
+    const e1 = fa.evidence[1];
+    if (e1?.scope === "effect" && e1.effectId !== undefined) {
+        map.set("primary_effect_id", e1.effectId);
+    }
+}
+export function buildFailureExplanation(engine, truth) {
+    if (engine.status === "complete")
+        return null;
+    const P = policyFragment(engine);
+    const fa = buildFailureAnalysis(engine);
+    if (fa === null) {
+        throw new FailureExplanationInvariantError("EXPLANATION_EVIDENCE_CODES_EMPTY", EMPTY_CODES_MESSAGE);
+    }
+    const e0 = fa.evidence[0];
+    if (e0.scope === "effect") {
+        throw new FailureExplanationInvariantError("EXPLANATION_PRIMARY_EVIDENCE_SCOPE_EFFECT", EFFECT_SCOPE_MESSAGE);
+    }
+    if (!e0.codes || e0.codes.length === 0) {
+        throw new FailureExplanationInvariantError("EXPLANATION_EVIDENCE_CODES_EMPTY", EMPTY_CODES_MESSAGE);
+    }
+    const primaryCode = minLex(e0.codes);
+    const workflowId = engine.workflowId;
+    const baseMap = new Map();
+    baseMap.set("trust_summary", truth.trustSummary);
+    baseMap.set("workflow_status", truth.workflowStatus);
+    baseMap.set("verification_policy", P);
+    baseMap.set("primary_origin", fa.primaryOrigin);
+    baseMap.set("classification_confidence", fa.confidence);
+    baseMap.set("failure_analysis_summary", normMessage(fa.summary));
+    addPrimaryEvidenceFacts(baseMap, e0, fa);
+    let expected;
+    let observed;
+    let divergence;
+    if (e0.scope === "run_level") {
+        const U = sortUniqueCodes(e0.codes);
+        const knownOnly = U.filter((c) => c in RUN_LEVEL_CODE_TO_ORIGIN);
+        const firstCode = knownOnly.length > 0 ? minLex(knownOnly) : minLex(U);
+        const R = engine.runLevelReasons.find((r) => r.code === firstCode);
+        const detail = normMessage(R?.message ?? "");
+        const meaning = userPhraseForReasonCode(firstCode);
+        expected = fillTemplate(FE_RUN_LEVEL_EXPECTED, { workflowId, P });
+        observed = fillTemplate(FE_RUN_LEVEL_OBSERVED, { firstCode, detail });
+        divergence = fillTemplate(FE_RUN_LEVEL_DIVERGENCE, { firstCode, meaning });
+    }
+    else if (e0.scope === "event_sequence") {
+        const U = sortUniqueCodes(e0.codes);
+        const firstCode = minLex(U);
+        const reasons = engine.eventSequenceIntegrity.kind === "irregular" ? engine.eventSequenceIntegrity.reasons : [];
+        const R = reasons.find((r) => r.code === firstCode);
+        const detail = normMessage(R?.message ?? "");
+        const meaning = userPhraseForReasonCode(firstCode);
+        expected = fillTemplate(FE_EVENT_SEQUENCE_EXPECTED, { workflowId, P });
+        observed = fillTemplate(FE_EVENT_SEQUENCE_OBSERVED, { firstCode, detail });
+        divergence = fillTemplate(FE_EVENT_SEQUENCE_DIVERGENCE, { firstCode, meaning });
+    }
+    else if (e0.scope === "run_context") {
+        if (e0.ingestIndex === undefined) {
+            throw new FailureExplanationInvariantError("EXPLANATION_RUN_CONTEXT_INDEX_MISSING", RUN_CONTEXT_INDEX_MESSAGE);
+        }
+        const ingestIndex = String(e0.ingestIndex);
+        const C = minLex(e0.codes);
+        const detail = buildRunContextDetail(engine.verificationRunContext, e0.ingestIndex, C);
+        const meaning = userPhraseForReasonCode(C);
+        expected = fillTemplate(FE_RUN_CONTEXT_EXPECTED, { ingestIndex, P });
+        observed = fillTemplate(FE_RUN_CONTEXT_OBSERVED, { C, detail });
+        divergence = fillTemplate(FE_RUN_CONTEXT_DIVERGENCE, { C, meaning });
+    }
+    else if (e0.scope === "step") {
+        if (primaryCode === NO_STEPS_FOR_WORKFLOW) {
+            expected = fillTemplate(FE_RUN_LEVEL_EXPECTED, { workflowId, P });
+            observed = fillTemplate(FE_NO_STEPS_OBSERVED, { workflowId });
+            divergence = fillTemplate(FE_NO_STEPS_DIVERGENCE, { P });
+        }
+        else {
+            if (e0.seq === undefined || e0.toolId === undefined) {
+                throw new FailureExplanationInvariantError("EXPLANATION_STEP_TRUTH_MISMATCH", STEP_TRUTH_MISMATCH_MESSAGE);
+            }
+            const driver = engine.steps.find((s) => s.seq === e0.seq && s.toolId === e0.toolId);
+            if (driver === undefined) {
+                throw new FailureExplanationInvariantError("EXPLANATION_STEP_TRUTH_MISMATCH", STEP_TRUTH_MISMATCH_MESSAGE);
+            }
+            const truthStep = truth.steps.find((s) => s.seq === e0.seq && s.toolId === e0.toolId);
+            if (truthStep === undefined) {
+                throw new FailureExplanationInvariantError("EXPLANATION_STEP_TRUTH_MISMATCH", STEP_TRUTH_MISMATCH_MESSAGE);
+            }
+            const seq = String(e0.seq);
+            const toolId = e0.toolId;
+            const verifyTargetOrLiteralNull = truthStep.verifyTarget === null ? "null" : normMessage(truthStep.verifyTarget);
+            const narrative = normMessage(truthStep.intendedEffect.narrative);
+            const mr = msgReasonForDriverStep(driver, primaryCode);
+            const detail = normMessage(mr.message);
+            const suffix = evidenceSummarySuffix(driver.evidenceSummary);
+            const meaning = userPhraseForReasonCode(primaryCode);
+            expected = fillTemplate(FE_STEP_EXPECTED, {
+                verifyTargetOrLiteralNull,
+                narrative,
+                seq,
+                toolId,
+                P,
+            });
+            observed = fillTemplate(FE_STEP_OBSERVED, { primaryCode, detail, suffix });
+            divergence = fillTemplate(FE_STEP_DIVERGENCE, { seq, toolId, primaryCode, meaning });
+            baseMap.set("verify_target", truthStep.verifyTarget === null ? "null" : truthStep.verifyTarget);
+            baseMap.set("intended_effect_narrative", narrative);
+            const es = driver.evidenceSummary;
+            if (Object.prototype.hasOwnProperty.call(es, "field")) {
+                baseMap.set("evidence_summary_field", scalarToDetail(es.field));
+            }
+            if (Object.prototype.hasOwnProperty.call(es, "expected")) {
+                baseMap.set("evidence_summary_expected", scalarToDetail(es.expected));
+            }
+            if (Object.prototype.hasOwnProperty.call(es, "actual")) {
+                baseMap.set("evidence_summary_actual", scalarToDetail(es.actual));
+            }
+            if (Object.prototype.hasOwnProperty.call(es, "rowCount")) {
+                baseMap.set("evidence_summary_row_count", scalarToDetail(es.rowCount));
+            }
+        }
+    }
+    else {
+        throw new Error(`Unreachable failure explanation branch: scope=${String(e0.scope)}`);
+    }
+    const knownFacts = assembleKnownFacts(baseMap);
+    const unknowns = buildUnknowns(fa);
+    return {
+        schemaVersion: 1,
+        expected: formatOperationalMessage(expected),
+        observed: formatOperationalMessage(observed),
+        divergence: formatOperationalMessage(divergence),
+        knownFacts,
+        unknowns,
+    };
+}
+//# sourceMappingURL=failureExplanation.js.map

package/dist/failureExplanation.js.map

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

package/dist/failureExplanationDocumentationParity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=failureExplanationDocumentationParity.test.d.ts.map

package/dist/failureExplanationDocumentationParity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failureExplanationDocumentationParity.test.d.ts","sourceRoot":"","sources":["../src/failureExplanationDocumentationParity.test.ts"],"names":[],"mappings":""}

package/dist/failureExplanationDocumentationParity.test.js

@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import * as failureExplanation from "./failureExplanation.js";
+const root = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+const docPath = path.join(root, "docs", "agentskeptic.md");
+const FE_TEMPLATE_EXPORT_NAMES = [
+    "FE_RUN_LEVEL_EXPECTED",
+    "FE_RUN_LEVEL_OBSERVED",
+    "FE_RUN_LEVEL_DIVERGENCE",
+    "FE_EVENT_SEQUENCE_EXPECTED",
+    "FE_EVENT_SEQUENCE_OBSERVED",
+    "FE_EVENT_SEQUENCE_DIVERGENCE",
+    "FE_RUN_CONTEXT_EXPECTED",
+    "FE_RUN_CONTEXT_OBSERVED",
+    "FE_RUN_CONTEXT_DIVERGENCE",
+    "FE_STEP_EXPECTED",
+    "FE_STEP_OBSERVED",
+    "FE_STEP_DIVERGENCE",
+    "FE_NO_STEPS_OBSERVED",
+    "FE_NO_STEPS_DIVERGENCE",
+];
+function extractFailureExplanationFence(docText, exportName) {
+    const open = `\`\`\`text failureExplanation.ts ${exportName}`;
+    const start = docText.indexOf(open);
+    if (start === -1) {
+        throw new Error(`Missing fence opening for ${exportName}`);
+    }
+    const nl = docText.indexOf("\n", start);
+    if (nl === -1)
+        throw new Error(`Malformed fence for ${exportName}`);
+    const contentStart = nl + 1;
+    const close = docText.indexOf("\n```", contentStart);
+    if (close === -1)
+        throw new Error(`Missing fence close for ${exportName}`);
+    return docText
+        .slice(contentStart, close)
+        .replace(/\r\n/g, "\n")
+        .replace(/\r/g, "")
+        .replace(/\n+$/, "");
+}
+describe("failureExplanation documentation template parity", () => {
+    it("agentskeptic.md fenced templates match failureExplanation.ts exports", () => {
+        const docText = readFileSync(docPath, "utf8");
+        const mod = failureExplanation;
+        for (const name of FE_TEMPLATE_EXPORT_NAMES) {
+            const fromDoc = extractFailureExplanationFence(docText, name);
+            const fromCode = mod[name];
+            expect(fromCode, `export ${name} must exist`).toBeDefined();
+            expect(typeof fromCode, `export ${name} must be a string template`).toBe("string");
+            expect(fromDoc).toBe(fromCode);
+        }
+    });
+});
+//# sourceMappingURL=failureExplanationDocumentationParity.test.js.map

package/dist/failureExplanationDocumentationParity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failureExplanationDocumentationParity.test.js","sourceRoot":"","sources":["../src/failureExplanationDocumentationParity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE3D,MAAM,wBAAwB,GAAG;IAC/B,uBAAuB;IACvB,uBAAuB;IACvB,yBAAyB;IACzB,4BAA4B;IAC5B,4BAA4B;IAC5B,8BAA8B;IAC9B,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,sBAAsB;IACtB,wBAAwB;CAChB,CAAC;AAEX,SAAS,8BAA8B,CAAC,OAAe,EAAE,UAAkB;IACzE,MAAM,IAAI,GAAG,oCAAoC,UAAU,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IAC3E,OAAO,OAAO;SACX,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC;SAC1B,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,kBAAwD,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,wBAAwB,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,QAAQ,EAAE,UAAU,IAAI,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5D,MAAM,CAAC,OAAO,QAAQ,EAAE,UAAU,IAAI,4BAA4B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnF,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/failureOriginCatalog.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Single source of truth for code → FailureOrigin mappings.
+ * FailureOrigin literals: generated `failureOriginTypes.generated.ts` (schema sync). Operational values: `operationalDisposition.ts`.
+ */
+import { type OperationalCode } from "./cliOperationalCodes.js";
+import type { FailureOrigin } from "./failureOriginTypes.js";
+export type { FailureOrigin } from "./failureOriginTypes.js";
+export { FAILURE_ORIGINS } from "./failureOriginTypes.js";
+/** Sentinel for steps with empty reasons (should not occur in production). */
+export declare const STEP_NO_REASON_CODE: "STEP_NO_REASON";
+/** Test-only reason from aggregate tests; not emitted by verification pipeline. */
+export declare const TEST_BLOCKING_CODE: "TEST_BLOCKING_CODE";
+/**
+ * Step-level verification reason codes → primary FailureOrigin (before P5b effect override).
+ * Every production-emitted step reason code must appear here.
+ */
+export declare const REASON_CODE_TO_ORIGIN: Record<string, FailureOrigin>;
+export declare const RUN_LEVEL_CODE_TO_ORIGIN: Record<string, FailureOrigin>;
+export declare const EVENT_SEQUENCE_CODE_TO_ORIGIN: Record<string, FailureOrigin>;
+/** Every CLI_OPERATIONAL_CODES value → FailureOrigin. */
+export declare const OPERATIONAL_CODE_TO_ORIGIN: Record<OperationalCode, FailureOrigin>;
+/** Short operational diagnosis summaries (single line, truncation-safe). */
+export declare const OPERATIONAL_CODE_TO_SUMMARY: Record<OperationalCode, string>;
+export declare function originForStepReasonCode(code: string): FailureOrigin;
+export declare function originForRunLevelCode(code: string): FailureOrigin;
+export declare function originForEventSequenceCode(code: string): FailureOrigin;
+export declare function originForOperationalCode(code: string): FailureOrigin;
+/** Union of every production step reason code the exhaustiveness test must cover. */
+export declare const PRODUCTION_STEP_REASON_CODES: ReadonlySet<string>;
+//# sourceMappingURL=failureOriginCatalog.d.ts.map

package/dist/failureOriginCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failureOriginCatalog.d.ts","sourceRoot":"","sources":["../src/failureOriginCatalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAE7D,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAOhE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAkC/D,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIlE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAGvE,CAAC;AAkBF,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAc,CAAC;AAE7F,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAe,CAAC;AAExF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAMnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAMjE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAMtE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKpE;AAED,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAI3D,CAAC"}

package/dist/failureOriginCatalog.js

@@ -0,0 +1,106 @@
+/**
+ * Single source of truth for code → FailureOrigin mappings.
+ * FailureOrigin literals: generated `failureOriginTypes.generated.ts` (schema sync). Operational values: `operationalDisposition.ts`.
+ */
+import { CLI_OPERATIONAL_CODES } from "./cliOperationalCodes.js";
+import { OPERATIONAL_DISPOSITION } from "./operationalDisposition.js";
+import { RESOLVE_FAILURE_CODES } from "./resolveFailureCodes.js";
+import { SQL_VERIFICATION_OUTCOME_CODE } from "./wireReasonCodes.js";
+export { FAILURE_ORIGINS } from "./failureOriginTypes.js";
+/** Sentinel for steps with empty reasons (should not occur in production). */
+export const STEP_NO_REASON_CODE = "STEP_NO_REASON";
+/** Test-only reason from aggregate tests; not emitted by verification pipeline. */
+export const TEST_BLOCKING_CODE = "TEST_BLOCKING_CODE";
+const DOWNSTREAM = "downstream_system_state";
+const INPUTS = "inputs";
+const TOOL_USE = "tool_use";
+const WORKFLOW_FLOW = "workflow_flow";
+/**
+ * Step-level verification reason codes → primary FailureOrigin (before P5b effect override).
+ * Every production-emitted step reason code must appear here.
+ */
+export const REASON_CODE_TO_ORIGIN = {
+    [STEP_NO_REASON_CODE]: WORKFLOW_FLOW,
+    [TEST_BLOCKING_CODE]: WORKFLOW_FLOW,
+    [SQL_VERIFICATION_OUTCOME_CODE.ROW_ABSENT]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.RELATED_ROWS_ABSENT]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.RELATIONAL_EXPECTATION_MISMATCH]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.RELATIONAL_SCALAR_UNUSABLE]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.DUPLICATE_ROWS]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.VALUE_MISMATCH]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.ROW_NOT_OBSERVED_WITHIN_WINDOW]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.MULTI_EFFECT_UNCERTAIN_WITHIN_WINDOW]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.ROW_PRESENT_WHEN_FORBIDDEN]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.ORPHAN_ROW_DETECTED]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.FORBIDDEN_ROWS_STILL_PRESENT_WITHIN_WINDOW]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.CONNECTOR_ERROR]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.ROW_SHAPE_MISMATCH]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.UNREADABLE_VALUE]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.UNKNOWN_TOOL]: TOOL_USE,
+    [SQL_VERIFICATION_OUTCOME_CODE.RETRY_OBSERVATIONS_DIVERGE]: TOOL_USE,
+    [SQL_VERIFICATION_OUTCOME_CODE.MULTI_EFFECT_PARTIAL]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.MULTI_EFFECT_ALL_FAILED]: DOWNSTREAM,
+    [SQL_VERIFICATION_OUTCOME_CODE.MULTI_EFFECT_INCOMPLETE]: DOWNSTREAM,
+    PLAN_RULE_ROW_KIND_MISMATCH: WORKFLOW_FLOW,
+    PLAN_RULE_FORBIDDEN_ROW: WORKFLOW_FLOW,
+    PLAN_RULE_REQUIRED_ROW_MISSING: WORKFLOW_FLOW,
+    PLAN_RULE_ALLOWLIST_VIOLATION: WORKFLOW_FLOW,
+    PLAN_RULE_RENAME_MISMATCH: WORKFLOW_FLOW,
+    ...Object.fromEntries([...RESOLVE_FAILURE_CODES].map((c) => [c, INPUTS])),
+};
+export const RUN_LEVEL_CODE_TO_ORIGIN = {
+    MALFORMED_EVENT_LINE: INPUTS,
+    NO_STEPS_FOR_WORKFLOW: WORKFLOW_FLOW,
+    [TEST_BLOCKING_CODE]: WORKFLOW_FLOW,
+};
+export const EVENT_SEQUENCE_CODE_TO_ORIGIN = {
+    CAPTURE_ORDER_NOT_MONOTONIC_IN_SEQ: WORKFLOW_FLOW,
+    TIMESTAMP_NOT_MONOTONIC_WITH_SEQ_SORT_ORDER: WORKFLOW_FLOW,
+};
+function operationalMaps() {
+    const origin = {};
+    const summary = {};
+    for (const code of Object.values(CLI_OPERATIONAL_CODES)) {
+        const row = OPERATIONAL_DISPOSITION[code];
+        origin[code] = row.origin;
+        summary[code] = row.summary;
+    }
+    return { origin, summary };
+}
+const _op = operationalMaps();
+/** Every CLI_OPERATIONAL_CODES value → FailureOrigin. */
+export const OPERATIONAL_CODE_TO_ORIGIN = _op.origin;
+/** Short operational diagnosis summaries (single line, truncation-safe). */
+export const OPERATIONAL_CODE_TO_SUMMARY = _op.summary;
+export function originForStepReasonCode(code) {
+    const o = REASON_CODE_TO_ORIGIN[code];
+    if (o === undefined) {
+        throw new Error(`REASON_CODE_TO_ORIGIN missing required code: ${code}`);
+    }
+    return o;
+}
+export function originForRunLevelCode(code) {
+    const o = RUN_LEVEL_CODE_TO_ORIGIN[code];
+    if (o === undefined) {
+        throw new Error(`RUN_LEVEL_CODE_TO_ORIGIN missing required code: ${code}`);
+    }
+    return o;
+}
+export function originForEventSequenceCode(code) {
+    const o = EVENT_SEQUENCE_CODE_TO_ORIGIN[code];
+    if (o === undefined) {
+        throw new Error(`EVENT_SEQUENCE_CODE_TO_ORIGIN missing required code: ${code}`);
+    }
+    return o;
+}
+export function originForOperationalCode(code) {
+    if (!(code in OPERATIONAL_CODE_TO_ORIGIN)) {
+        throw new Error(`OPERATIONAL_CODE_TO_ORIGIN missing required code: ${code}`);
+    }
+    return OPERATIONAL_CODE_TO_ORIGIN[code];
+}
+/** Union of every production step reason code the exhaustiveness test must cover. */
+export const PRODUCTION_STEP_REASON_CODES = new Set([
+    ...Object.keys(REASON_CODE_TO_ORIGIN).filter((c) => c !== STEP_NO_REASON_CODE && c !== TEST_BLOCKING_CODE),
+]);
+//# sourceMappingURL=failureOriginCatalog.js.map

package/dist/failureOriginCatalog.js.map

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

package/dist/failureOriginCatalog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=failureOriginCatalog.test.d.ts.map

package/dist/failureOriginCatalog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failureOriginCatalog.test.d.ts","sourceRoot":"","sources":["../src/failureOriginCatalog.test.ts"],"names":[],"mappings":""}