agentskeptic 0.1.1

package/dist/debugCorpus.test.js

@@ -0,0 +1,159 @@
+import { createHash } from "node:crypto";
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync, rmSync, mkdtempSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { describe, expect, it } from "vitest";
+import { CLI_OPERATIONAL_CODES } from "./cliOperationalCodes.js";
+import { DEBUG_CORPUS_CODES, isPathUnderRoot, listCorpusRunIds, loadAllCorpusRuns, loadCorpusRun, resolveCorpusRootReal, } from "./debugCorpus.js";
+import { WORKFLOW_RESULT_RUN_LEVEL_CODES_MISMATCH_MESSAGE } from "./runLevelDriftMessages.js";
+import { fileURLToPath } from "node:url";
+const root = join(fileURLToPath(import.meta.url), "..", "..");
+const negativeRoot = join(root, "test", "fixtures", "corpus-negative");
+const runOkDir = join(root, "examples", "debug-corpus", "run_ok");
+describe("debugCorpus", () => {
+    it("examples/debug-corpus has one sealed run (run_ok)", () => {
+        const corpus = join(root, "examples", "debug-corpus");
+        const outcomes = loadAllCorpusRuns(corpus);
+        expect(outcomes).toHaveLength(1);
+        const ok = outcomes.filter((o) => o.loadStatus === "ok");
+        expect(ok).toHaveLength(1);
+        expect(ok[0].runId).toBe("run_ok");
+        expect(ok[0].agentRunRecord.workflowId).toBe("wf_complete");
+    });
+    it("corpus-negative fixtures produce expected error codes", () => {
+        const rootReal = resolveCorpusRootReal(negativeRoot);
+        const bad = loadCorpusRun(rootReal, "run_bad_json");
+        expect(bad.loadStatus).toBe("error");
+        if (bad.loadStatus === "error") {
+            expect(bad.error.code).toBe(DEBUG_CORPUS_CODES.WORKFLOW_RESULT_JSON);
+        }
+        const missing = loadCorpusRun(rootReal, "run_missing_events");
+        expect(missing.loadStatus).toBe("error");
+        if (missing.loadStatus === "error") {
+            expect(missing.error.code).toBe(DEBUG_CORPUS_CODES.MISSING_EVENTS);
+        }
+        const inv = loadCorpusRun(rootReal, "run_schema_invalid");
+        expect(inv.loadStatus).toBe("error");
+        if (inv.loadStatus === "error") {
+            expect(inv.error.code).toBe(DEBUG_CORPUS_CODES.WORKFLOW_RESULT_INVALID);
+        }
+    });
+    it("rejects bundle without agent-run.json", () => {
+        const base = mkdtempSync(join(tmpdir(), "etl-corpus-"));
+        try {
+            mkdirSync(join(base, "x"), { recursive: true });
+            writeFileSync(join(base, "x", "workflow-result.json"), "{}");
+            writeFileSync(join(base, "x", "events.ndjson"), "\n");
+            const rootReal = resolveCorpusRootReal(base);
+            const o = loadCorpusRun(rootReal, "x");
+            expect(o.loadStatus).toBe("error");
+            if (o.loadStatus === "error") {
+                expect(o.error.code).toBe(DEBUG_CORPUS_CODES.MISSING_AGENT_RUN_MANIFEST);
+            }
+        }
+        finally {
+            rmSync(base, { recursive: true, force: true });
+        }
+    });
+    it("isPathUnderRoot rejects escape", () => {
+        const a = join(tmpdir(), `etl-dc-${Date.now()}`);
+        mkdirSync(a, { recursive: true });
+        const aReal = resolveCorpusRootReal(a);
+        try {
+            const outside = join(aReal, "..", "..");
+            const outsideReal = resolveCorpusRootReal(outside);
+            expect(isPathUnderRoot(aReal, outsideReal)).toBe(false);
+        }
+        finally {
+            rmSync(a, { recursive: true, force: true });
+        }
+    });
+    it("never omits a child directory from enumeration", () => {
+        const base = mkdtempSync(join(tmpdir(), "etl-corpus-"));
+        try {
+            mkdirSync(join(base, "a"), { recursive: true });
+            mkdirSync(join(base, "b"), { recursive: true });
+            writeFileSync(join(base, "a", "workflow-result.json"), "{}");
+            writeFileSync(join(base, "b", "workflow-result.json"), "{}");
+            const ids = listCorpusRunIds(base);
+            expect(ids.sort()).toEqual(["a", "b"]);
+            const out = loadAllCorpusRuns(base);
+            expect(out).toHaveLength(2);
+            expect(out.every((o) => o.loadStatus === "error")).toBe(true);
+            expect(out.every((o) => o.loadStatus === "error" && o.error.code === DEBUG_CORPUS_CODES.MISSING_AGENT_RUN_MANIFEST)).toBe(true);
+        }
+        finally {
+            rmSync(base, { recursive: true, force: true });
+        }
+    });
+    it("ARTIFACT_INTEGRITY_MISMATCH when manifest hash does not match disk", () => {
+        const base = mkdtempSync(join(tmpdir(), "etl-corpus-tamper-"));
+        try {
+            const runDir = join(base, "tampered");
+            mkdirSync(runDir, { recursive: true });
+            for (const f of ["events.ndjson", "workflow-result.json", "agent-run.json"]) {
+                copyFileSync(join(runOkDir, f), join(runDir, f));
+            }
+            const arPath = join(runDir, "agent-run.json");
+            const ar = JSON.parse(readFileSync(arPath, "utf8"));
+            ar.artifacts.events.sha256 = `${ar.artifacts.events.sha256.slice(0, -1)}0`;
+            writeFileSync(arPath, JSON.stringify(ar, null, 2));
+            const rootReal = resolveCorpusRootReal(base);
+            const o = loadCorpusRun(rootReal, "tampered");
+            expect(o.loadStatus).toBe("error");
+            if (o.loadStatus === "error") {
+                expect(o.error.code).toBe(DEBUG_CORPUS_CODES.ARTIFACT_INTEGRITY_MISMATCH);
+            }
+        }
+        finally {
+            rmSync(base, { recursive: true, force: true });
+        }
+    });
+    it("PATH_ESCAPE when resolved path leaves corpus root", () => {
+        const base = mkdtempSync(join(tmpdir(), "etl-corpus-"));
+        try {
+            const rootReal = resolveCorpusRootReal(base);
+            const o = loadCorpusRun(rootReal, "..");
+            expect(o.loadStatus).toBe("error");
+            if (o.loadStatus === "error") {
+                expect(o.error.code).toBe(DEBUG_CORPUS_CODES.PATH_ESCAPE);
+            }
+        }
+        finally {
+            rmSync(base, { recursive: true, force: true });
+        }
+    });
+    it("v9 workflow-result runLevel drift yields WORKFLOW_RESULT_RUN_LEVEL_CODES_MISMATCH", () => {
+        const base = mkdtempSync(join(tmpdir(), "etl-corpus-rl-"));
+        try {
+            const runDir = join(base, "drift");
+            mkdirSync(runDir, { recursive: true });
+            copyFileSync(join(runOkDir, "events.ndjson"), join(runDir, "events.ndjson"));
+            const wrParsed = JSON.parse(readFileSync(join(runOkDir, "workflow-result.json"), "utf8"));
+            const drifting = {
+                ...wrParsed,
+                schemaVersion: 9,
+                runLevelCodes: ["A"],
+                runLevelReasons: [{ code: "B", message: "mismatch" }],
+            };
+            const wrBody = JSON.stringify(drifting);
+            writeFileSync(join(runDir, "workflow-result.json"), wrBody);
+            const wrBuf = readFileSync(join(runDir, "workflow-result.json"));
+            const ar = JSON.parse(readFileSync(join(runOkDir, "agent-run.json"), "utf8"));
+            ar.artifacts.workflowResult.sha256 = createHash("sha256").update(wrBuf).digest("hex");
+            ar.artifacts.workflowResult.byteLength = wrBuf.length;
+            writeFileSync(join(runDir, "agent-run.json"), JSON.stringify(ar));
+            const rootReal = resolveCorpusRootReal(base);
+            const o = loadCorpusRun(rootReal, "drift");
+            expect(o.loadStatus).toBe("error");
+            if (o.loadStatus === "error") {
+                expect(o.error.code).toBe(CLI_OPERATIONAL_CODES.WORKFLOW_RESULT_RUN_LEVEL_CODES_MISMATCH);
+                expect(o.error.message).toBe(WORKFLOW_RESULT_RUN_LEVEL_CODES_MISMATCH_MESSAGE);
+            }
+        }
+        finally {
+            rmSync(base, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=debugCorpus.test.js.map

package/dist/debugCorpus.test.js.map

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

package/dist/debugFocus.d.ts

@@ -0,0 +1,16 @@
+import type { ExecutionTraceView, WorkflowResult } from "./types.js";
+export type FocusTargetKind = "seq" | "ingestIndex" | "runEventId";
+export type FocusTarget = {
+    kind: FocusTargetKind;
+    value: number | string;
+    rationale: string;
+};
+export type FocusResponse = {
+    targets: FocusTarget[];
+};
+/**
+ * Maps structured failure analysis to trace / step navigation targets.
+ * Pure: safe to test with golden vectors.
+ */
+export declare function buildFocusTargets(workflowResult: WorkflowResult, _trace: ExecutionTraceView): FocusResponse;
+//# sourceMappingURL=debugFocus.d.ts.map

package/dist/debugFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugFocus.d.ts","sourceRoot":"","sources":["../src/debugFocus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAA+B,cAAc,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,aAAa,GAAG,YAAY,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAmCF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAa3G"}

package/dist/debugFocus.js

@@ -0,0 +1,51 @@
+function pushUnique(targets, t) {
+    const key = `${t.kind}:${String(t.value)}`;
+    if (targets.some((x) => `${x.kind}:${String(x.value)}` === key))
+        return;
+    targets.push(t);
+}
+function fromEvidenceItem(ev, i) {
+    const out = [];
+    const base = `failureAnalysis.evidence[${i}]`;
+    if (ev.seq !== undefined) {
+        out.push({
+            kind: "seq",
+            value: ev.seq,
+            rationale: `${base} scope=${ev.scope} seq=${ev.seq}`,
+        });
+    }
+    if (ev.ingestIndex !== undefined) {
+        out.push({
+            kind: "ingestIndex",
+            value: ev.ingestIndex,
+            rationale: `${base} scope=${ev.scope} ingestIndex=${ev.ingestIndex}`,
+        });
+    }
+    if (ev.runEventId != null && ev.runEventId !== "") {
+        out.push({
+            kind: "runEventId",
+            value: ev.runEventId,
+            rationale: `${base} scope=${ev.scope} runEventId=${ev.runEventId}`,
+        });
+    }
+    return out;
+}
+/**
+ * Maps structured failure analysis to trace / step navigation targets.
+ * Pure: safe to test with golden vectors.
+ */
+export function buildFocusTargets(workflowResult, _trace) {
+    const fa = workflowResult.workflowTruthReport.failureAnalysis;
+    if (fa === null) {
+        return { targets: [] };
+    }
+    const targets = [];
+    for (let i = 0; i < fa.evidence.length; i++) {
+        const ev = fa.evidence[i];
+        for (const t of fromEvidenceItem(ev, i)) {
+            pushUnique(targets, t);
+        }
+    }
+    return { targets };
+}
+//# sourceMappingURL=debugFocus.js.map

package/dist/debugFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugFocus.js","sourceRoot":"","sources":["../src/debugFocus.ts"],"names":[],"mappings":"AAcA,SAAS,UAAU,CAAC,OAAsB,EAAE,CAAc;IACxD,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,CAAC;QAAE,OAAO;IACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,EAA+B,EAAE,CAAS;IAClE,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,4BAA4B,CAAC,GAAG,CAAC;IAC9C,IAAI,EAAE,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,EAAE,CAAC,GAAG;YACb,SAAS,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,GAAG,EAAE;SACrD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,EAAE,CAAC,WAAW;YACrB,SAAS,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC,KAAK,gBAAgB,EAAE,CAAC,WAAW,EAAE;SACrE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,EAAE,CAAC,UAAU;YACpB,SAAS,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC,KAAK,eAAe,EAAE,CAAC,UAAU,EAAE;SACnE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,cAA8B,EAAE,MAA0B;IAC1F,MAAM,EAAE,GAAG,cAAc,CAAC,mBAAmB,CAAC,eAAe,CAAC;IAC9D,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;YACxC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/debugFocus.test.d.ts

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

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

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

package/dist/debugFocus.test.js

@@ -0,0 +1,43 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { buildExecutionTraceView } from "./executionTrace.js";
+import { loadEventsForWorkflow } from "./loadEvents.js";
+import { buildFocusTargets } from "./debugFocus.js";
+import { normalizeToEmittedWorkflowResult } from "./workflowResultNormalize.js";
+const root = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
+describe("buildFocusTargets", () => {
+    it("returns empty targets when failureAnalysis is null (trusted complete)", () => {
+        const raw = JSON.parse(readFileSync(path.join(root, "examples", "debug-corpus", "run_ok", "workflow-result.json"), "utf8"));
+        const wr = normalizeToEmittedWorkflowResult(raw);
+        const load = loadEventsForWorkflow(path.join(root, "examples", "debug-corpus", "run_ok", "events.ndjson"), wr.workflowId);
+        const trace = buildExecutionTraceView({
+            workflowId: wr.workflowId,
+            runEvents: load.runEvents,
+            malformedEventLineCount: load.malformedEventLineCount,
+            workflowResult: wr,
+        });
+        expect(buildFocusTargets(wr, trace)).toEqual({ targets: [] });
+    });
+    it("maps failureAnalysis evidence seq to golden focus targets (wf_inconsistent fixture)", () => {
+        const raw = JSON.parse(readFileSync(path.join(root, "test", "fixtures", "wf_inconsistent_result.json"), "utf8"));
+        const wr = normalizeToEmittedWorkflowResult(raw);
+        const load = loadEventsForWorkflow(path.join(root, "examples", "events.ndjson"), wr.workflowId);
+        const trace = buildExecutionTraceView({
+            workflowId: wr.workflowId,
+            runEvents: load.runEvents,
+            malformedEventLineCount: load.malformedEventLineCount,
+            workflowResult: wr,
+        });
+        const out = buildFocusTargets(wr, trace);
+        expect(out.targets).toEqual([
+            {
+                kind: "seq",
+                value: 0,
+                rationale: "failureAnalysis.evidence[0] scope=step seq=0",
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=debugFocus.test.js.map

package/dist/debugFocus.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugFocus.test.js","sourceRoot":"","sources":["../src/debugFocus.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAGhF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAE3E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC,CAC3D,CAAC;QAC3C,MAAM,EAAE,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,qBAAqB,CAChC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,CAAC,EACtE,EAAE,CAAC,UAAU,CACd,CAAC;QACF,MAAM,KAAK,GAAG,uBAAuB,CAAC;YACpC,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,6BAA6B,CAAC,EAAE,MAAM,CAAC,CAChD,CAAC;QAC3C,MAAM,EAAE,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;QAChG,MAAM,KAAK,GAAG,uBAAuB,CAAC;YACpC,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YAC1B;gBACE,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,8CAA8C;aAC1D;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/debugPanels.d.ts

@@ -0,0 +1,13 @@
+import type { RunComparisonReport } from "./runComparison.js";
+import type { StepOutcome, WorkflowResult } from "./types.js";
+/** Trust panel / tests: observed database summary (operational-message normalized). */
+export declare function formatSqlEvidenceDetailForTrustPanel(step: StepOutcome): string;
+declare const VERIFICATION_BASIS_LINE = "Verification outcomes below are from read-only SQL reconciliation against the workflow registry and observed tool parameters\u2014not from model-reported success.";
+declare const PLAN_TRANSITION_VERIFICATION_BASIS_LINE = "Verification outcomes below are from git diff (name-status) and machine-declared plan rules (YAML front matter planValidation, body section Repository transition validation, or derived path citations as required diff surfaces)\u2014not from model-reported success.";
+declare const EXECUTION_PATH_EMPTY = "No execution-path concerns recorded for this run.";
+/** HTML fragment for Compare tab (server-side only). */
+export declare function renderComparePanelHtml(report: RunComparisonReport): string;
+/** HTML fragment for run-detail trust + execution path (server-side only). */
+export declare function renderRunTrustPanelHtml(wf: WorkflowResult): string;
+export { VERIFICATION_BASIS_LINE, PLAN_TRANSITION_VERIFICATION_BASIS_LINE, EXECUTION_PATH_EMPTY };
+//# sourceMappingURL=debugPanels.d.ts.map

package/dist/debugPanels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugPanels.d.ts","sourceRoot":"","sources":["../src/debugPanels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAY9D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAC;AAWjF,uFAAuF;AACvF,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAE9E;AAeD,QAAA,MAAM,uBAAuB,uKACoI,CAAC;AAElK,QAAA,MAAM,uCAAuC,6QAC0N,CAAC;AAExQ,QAAA,MAAM,oBAAoB,sDAAsD,CAAC;AAEjF,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAuB1E;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAkFlE;AAED,OAAO,EAAE,uBAAuB,EAAE,uCAAuC,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/debugPanels.js

@@ -0,0 +1,113 @@
+import { PLAN_TRANSITION_WORKFLOW_ID } from "./planTransitionConstants.js";
+import { formatBatchDeclaredStderrValue, formatBatchExpectedStderrValue, formatBatchObservedStateSummary, formatBatchVerificationVerdictStderrValue, RECONCILIATION_TITLE_DECLARED, RECONCILIATION_TITLE_EXPECTED, RECONCILIATION_TITLE_OBSERVED_DATABASE, RECONCILIATION_TITLE_VERIFICATION_VERDICT, } from "./reconciliationPresentation.js";
+import { HUMAN_REPORT_PLAN_TRANSITION_PHRASE, HUMAN_REPORT_RESULT_PHRASE } from "./workflowTruthReport.js";
+function escapeHtml(s) {
+    return String(s)
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Trust panel / tests: observed database summary (operational-message normalized). */
+export function formatSqlEvidenceDetailForTrustPanel(step) {
+    return formatBatchObservedStateSummary(step);
+}
+function declaredCellHtml(s, toolIdRaw) {
+    const declaredPlain = formatBatchDeclaredStderrValue(toolIdRaw, s.intendedEffect.narrative, s.observedExecution.paramsCanonical);
+    const idx = declaredPlain.indexOf("parameters_digest=");
+    if (idx <= 0) {
+        return escapeHtml(declaredPlain);
+    }
+    return `${escapeHtml(declaredPlain.slice(0, idx))}<br />${escapeHtml(declaredPlain.slice(idx))}`;
+}
+const VERIFICATION_BASIS_LINE = "Verification outcomes below are from read-only SQL reconciliation against the workflow registry and observed tool parameters—not from model-reported success.";
+const PLAN_TRANSITION_VERIFICATION_BASIS_LINE = "Verification outcomes below are from git diff (name-status) and machine-declared plan rules (YAML front matter planValidation, body section Repository transition validation, or derived path citations as required diff surfaces)—not from model-reported success.";
+const EXECUTION_PATH_EMPTY = "No execution-path concerns recorded for this run.";
+/** HTML fragment for Compare tab (server-side only). */
+export function renderComparePanelHtml(report) {
+    const ra = report.reliabilityAssessment;
+    const ch = report.compareHighlights;
+    const headline = `${ra.headlineVerdict}: ${ra.headlineRationale}`;
+    const windowLine = `Window trend: ${ra.windowTrend} (run index 0 vs run index ${report.runs.length - 1}).`;
+    const pairwiseLine = `Pairwise trend: ${ra.pairwiseTrend} (run index ${report.pairwise.priorRunIndex} vs ${report.pairwise.currentRunIndex}).`;
+    const recurrenceLine = ra.recurrenceBurden.rationale;
+    const liIntro = ch.introducedLogicalStepKeys.map((k) => `<li>${escapeHtml(k)}</li>`).join("");
+    const liRes = ch.resolvedLogicalStepKeys.map((k) => `<li>${escapeHtml(k)}</li>`).join("");
+    const liRec = ch.recurringSignatures.map((k) => `<li>${escapeHtml(k)}</li>`).join("");
+    return [
+        `<section data-etl-section="compare-result">`,
+        `<p data-etl-headline>${escapeHtml(headline)}</p>`,
+        `<p data-etl-window-trend>${escapeHtml(windowLine)}</p>`,
+        `<p data-etl-pairwise-trend>${escapeHtml(pairwiseLine)}</p>`,
+        `<p data-etl-recurrence>${escapeHtml(recurrenceLine)}</p>`,
+        `<ul data-etl-list="introduced">${liIntro}</ul>`,
+        `<ul data-etl-list="resolved">${liRes}</ul>`,
+        `<ul data-etl-list="recurring">${liRec}</ul>`,
+        `</section>`,
+    ].join("");
+}
+/** HTML fragment for run-detail trust + execution path (server-side only). */
+export function renderRunTrustPanelHtml(wf) {
+    const truthSteps = wf.workflowTruthReport.steps;
+    const engineSteps = wf.steps;
+    const truthBySeq = new Map(truthSteps.map((s) => [s.seq, s]));
+    const engineBySeq = new Map(engineSteps.map((s) => [s.seq, s]));
+    const allSeq = [...new Set([...truthBySeq.keys(), ...engineBySeq.keys()])].sort((a, b) => a - b);
+    const rows = [];
+    for (const seq of allSeq) {
+        const t = truthBySeq.get(seq);
+        const e = engineBySeq.get(seq);
+        if (t && e) {
+            const stepPhraseMap = wf.workflowId === PLAN_TRANSITION_WORKFLOW_ID
+                ? HUMAN_REPORT_PLAN_TRANSITION_PHRASE
+                : HUMAN_REPORT_RESULT_PHRASE;
+            const phrase = stepPhraseMap[t.outcomeLabel];
+            const expectedVal = formatBatchExpectedStderrValue(t.verifyTarget);
+            const verdictVal = formatBatchVerificationVerdictStderrValue(t.outcomeLabel, phrase, t.outcomeLabel !== "VERIFIED" ? t.failureCategory : undefined);
+            rows.push(`<tr data-etl-seq="${seq}">` +
+                `<td>${seq}</td>` +
+                `<td data-etl-dimension="declared">${declaredCellHtml(t, e.toolId)}</td>` +
+                `<td data-etl-dimension="expected">${escapeHtml(expectedVal)}</td>` +
+                `<td data-etl-dimension="observed_database">${escapeHtml(t.observedStateSummary)}</td>` +
+                `<td data-etl-dimension="verification_verdict">${escapeHtml(verdictVal)}</td>` +
+                `</tr>`);
+        }
+        else if (t && !e) {
+            rows.push(`<tr data-etl-alignment-warning="true"><td colspan="5">${escapeHtml("Alignment warning: step present in truth report only (missing engine step).")} seq=${seq}</td></tr>`);
+        }
+        else if (!t && e) {
+            rows.push(`<tr data-etl-alignment-warning="true"><td colspan="5">${escapeHtml("Alignment warning: step present in engine result only (missing truth step).")} seq=${seq}</td></tr>`);
+        }
+    }
+    const findings = wf.workflowTruthReport.executionPathFindings;
+    const summary = wf.workflowTruthReport.executionPathSummary.trim();
+    // "No concerns" = no path findings. `executionPathSummary` may still be non-empty for v1
+    // informational text that is not a user-facing finding list (compare/trust HTML contract).
+    const hasConcerns = findings.length > 0;
+    let executionPathInner;
+    if (!hasConcerns) {
+        executionPathInner = `<p data-etl-execution-path-empty>${escapeHtml(EXECUTION_PATH_EMPTY)}</p>`;
+    }
+    else {
+        const lis = findings
+            .map((f) => `<li data-etl-finding-code="${escapeHtml(f.code)}">${escapeHtml(f.code)}: ${escapeHtml(f.message)}</li>`)
+            .join("");
+        executionPathInner =
+            `<p data-etl-execution-path-summary>${escapeHtml(summary)}</p>` +
+                `<ol data-etl-list="execution-findings">${lis}</ol>`;
+    }
+    const basisLine = wf.workflowId === PLAN_TRANSITION_WORKFLOW_ID ? PLAN_TRANSITION_VERIFICATION_BASIS_LINE : VERIFICATION_BASIS_LINE;
+    return [
+        `<section data-etl-section="run-trust">`,
+        `<p data-etl-verification-basis>${escapeHtml(basisLine)}</p>`,
+        `<table data-etl-table="verify-evidence"><thead><tr><th scope="col">seq</th><th scope="col">${escapeHtml(RECONCILIATION_TITLE_DECLARED)}</th><th scope="col">${escapeHtml(RECONCILIATION_TITLE_EXPECTED)}</th><th scope="col">${escapeHtml(RECONCILIATION_TITLE_OBSERVED_DATABASE)}</th><th scope="col">${escapeHtml(RECONCILIATION_TITLE_VERIFICATION_VERDICT)}</th></tr></thead><tbody>`,
+        ...rows,
+        `</tbody></table>`,
+        `<section data-etl-section="execution-path">`,
+        executionPathInner,
+        `</section>`,
+        `</section>`,
+    ].join("");
+}
+export { VERIFICATION_BASIS_LINE, PLAN_TRANSITION_VERIFICATION_BASIS_LINE, EXECUTION_PATH_EMPTY };
+//# sourceMappingURL=debugPanels.js.map

package/dist/debugPanels.js.map

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

package/dist/debugPanels.test.d.ts

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

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

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