audit-tools 0.30.2 → 0.30.4

package/dist/audit/contracts/wrapperResponse.d.ts

@@ -58,12 +58,12 @@ export declare const AuditCodeResponseSchema: z.ZodObject<{
             suggested_path: z.ZodString;
             description: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            description: string;
             flag: "--batch-results" | "--results" | "--updates" | "--external-analyzer-results";
+            description: string;
             suggested_path: string;
         }, {
-            description: string;
             flag: "--batch-results" | "--results" | "--updates" | "--external-analyzer-results";
+            description: string;
             suggested_path: string;
         }>, "many">;
         suggested_commands: z.ZodArray<z.ZodString, "many">;
@@ -76,15 +76,15 @@ export declare const AuditCodeResponseSchema: z.ZodObject<{
             audit_results_path: z.ZodString;
             worker_command: z.ZodArray<z.ZodString, "many">;
         }, "strict", z.ZodTypeAny, {
-            worker_command: string[];
             run_id: string;
+            worker_command: string[];
             audit_results_path: string;
             task_path: string;
             prompt_path: string;
             pending_audit_tasks_path?: string | undefined;
         }, {
-            worker_command: string[];
             run_id: string;
+            worker_command: string[];
             audit_results_path: string;
             task_path: string;
             prompt_path: string;
@@ -150,15 +150,15 @@ export declare const AuditCodeResponseSchema: z.ZodObject<{
         };
         pending_obligations: string[];
         suggested_inputs: {
-            description: string;
             flag: "--batch-results" | "--results" | "--updates" | "--external-analyzer-results";
+            description: string;
             suggested_path: string;
         }[];
         suggested_commands: string[];
         interactive_provider_hint: string | null;
         active_review_run?: {
-            worker_command: string[];
             run_id: string;
+            worker_command: string[];
             audit_results_path: string;
             task_path: string;
             prompt_path: string;
@@ -187,15 +187,15 @@ export declare const AuditCodeResponseSchema: z.ZodObject<{
         };
         pending_obligations: string[];
         suggested_inputs: {
-            description: string;
             flag: "--batch-results" | "--results" | "--updates" | "--external-analyzer-results";
+            description: string;
             suggested_path: string;
         }[];
         suggested_commands: string[];
         interactive_provider_hint: string | null;
         active_review_run?: {
-            worker_command: string[];
             run_id: string;
+            worker_command: string[];
             audit_results_path: string;
             task_path: string;
             prompt_path: string;
@@ -244,15 +244,15 @@ export declare const AuditCodeResponseSchema: z.ZodObject<{
         };
         pending_obligations: string[];
         suggested_inputs: {
-            description: string;
             flag: "--batch-results" | "--results" | "--updates" | "--external-analyzer-results";
+            description: string;
             suggested_path: string;
         }[];
         suggested_commands: string[];
         interactive_provider_hint: string | null;
         active_review_run?: {
-            worker_command: string[];
             run_id: string;
+            worker_command: string[];
             audit_results_path: string;
             task_path: string;
             prompt_path: string;
@@ -301,15 +301,15 @@ export declare const AuditCodeResponseSchema: z.ZodObject<{
         };
         pending_obligations: string[];
         suggested_inputs: {
-            description: string;
             flag: "--batch-results" | "--results" | "--updates" | "--external-analyzer-results";
+            description: string;
             suggested_path: string;
         }[];
         suggested_commands: string[];
         interactive_provider_hint: string | null;
         active_review_run?: {
-            worker_command: string[];
             run_id: string;
+            worker_command: string[];
             audit_results_path: string;
             task_path: string;
             prompt_path: string;

package/dist/audit/orchestrator/artifactFreshness.d.ts

@@ -1,4 +1,5 @@
-export declare function stableStringify(value: unknown): string;
+import { stableStringify } from "../../shared/stableStringify.js";
+export { stableStringify };
 export declare function normalizeForMetadataHash(artifactName: string, value: unknown): unknown;
 export declare function hashArtifactValue(artifactName: string, value: unknown): string;
 //# sourceMappingURL=artifactFreshness.d.ts.map

package/dist/audit/orchestrator/artifactFreshness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifactFreshness.d.ts","sourceRoot":"","sources":["../../../src/audit/orchestrator/artifactFreshness.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CActD;AA8ED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,OAAO,CAgBT;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,MAAM,CAIR"}
+{"version":3,"file":"artifactFreshness.d.ts","sourceRoot":"","sources":["../../../src/audit/orchestrator/artifactFreshness.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,CAAC;AA8E3B,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,OAAO,CAgBT;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,GACb,MAAM,CAIR"}

package/dist/audit/orchestrator/artifactFreshness.js

@@ -1,19 +1,9 @@
 import { createHash } from "node:crypto";
-export function stableStringify(value) {
-    if (value === undefined) {
-        return "null";
-    }
-    if (value === null || typeof value !== "object") {
-        return JSON.stringify(value);
-    }
-    if (Array.isArray(value)) {
-        return `[${value.map((item) => stableStringify(item ?? null)).join(",")}]`;
-    }
-    const entries = Object.entries(value)
-        .filter(([, item]) => item !== undefined)
-        .sort(([a], [b]) => a.localeCompare(b));
-    return `{${entries.map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`).join(",")}}`;
-}
+// Single-sourced in src/shared/stableStringify.ts (INV-CK-2). Re-exported here so
+// existing callers (and the single-serializer property) are preserved — there is
+// exactly one serializer.
+import { stableStringify } from "../../shared/stableStringify.js";
+export { stableStringify };
 // Non-semantic top-level fields stripped before hashing, per artifact. These
 // are provenance (wall-clock stamps, run ids), NOT content: two rebuilds with
 // identical data but different stamps must hash equal, or the artifact's

package/dist/audit/orchestrator/artifactFreshness.js.map

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

package/dist/audit/orchestrator/executorRunners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executorRunners.d.ts","sourceRoot":"","sources":["../../../src/audit/orchestrator/executorRunners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAyBlE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAahC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAsHhE,CAAC"}
+{"version":3,"file":"executorRunners.d.ts","sourceRoot":"","sources":["../../../src/audit/orchestrator/executorRunners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAyBlE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAahC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAuHhE,CAAC"}

package/dist/audit/orchestrator/executorRunners.js

@@ -83,12 +83,13 @@ export const EXECUTOR_RUNNERS = {
     },
     auto_fix_executor: async (bundle, { options }) => runAutoFixExecutor(bundle, requireRoot(options.root, "auto_fix_executor")),
     syntax_resolution_executor: async (bundle, { options }) => runSyntaxResolutionExecutor(bundle, requireRoot(options.root, "syntax_resolution_executor")),
-    // Terminal friction close-out (parity with remediate-code). Fires the shared,
-    // run_id-keyed friction persist via `decideAuditFrictionCloseout`: degrade-clean
-    // (a zero-friction record satisfies the obligation) and idempotent (a record
-    // already present short-circuits, so it never re-fires). The artifacts dir
-    // defaults to the standard `.audit-tools/audit` location; the run id mirrors the
-    // operator-handoff default of "run" when the caller has no explicit run id.
+    // Terminal friction-TRIAGE close-out (parity with remediate-code; single-sourced
+    // in `audit-tools/shared`). The blocking triage stays unsatisfied ("dispose")
+    // until every captured mechanical event AND every surfaced agent-feedback
+    // reflection carries a disposition; an empty set is trivially "disposed". The
+    // artifacts dir defaults to the standard `.audit-tools/audit` location; the run id
+    // mirrors the operator-handoff default of "run" when the caller has no explicit
+    // run id.
     friction_capture_executor: async (bundle, { options }) => {
         const artifactsDir = options.artifactsDir ??
             auditArtifactsDir(requireRoot(options.root, "friction_capture_executor"));
@@ -96,9 +97,9 @@ export const EXECUTOR_RUNNERS = {
         return {
             updated: bundle,
             artifacts_written: ["friction/run.json"],
-            progress_summary: decision.action === "capture"
-                ? "Friction close-out captured (degrade-clean record persisted)."
-                : "Friction close-out already captured this run.",
+            progress_summary: decision.action === "disposed"
+                ? "Friction triage disposed (all captured items have a disposition)."
+                : `Friction triage blocked: ${decision.pending.length} item(s) await a disposition.`,
         };
     },
 };

package/dist/audit/orchestrator/executorRunners.js.map

@@ -1 +1 @@
-{"version":3,"file":"executorRunners.js","sourceRoot":"","sources":["../../../src/audit/orchestrator/executorRunners.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,mCAAmC,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAsB/C;;;GAGG;AACH,SAAS,WAAW,CAAC,IAAwB,EAAE,YAAoB;IACjE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,gBAAgB,YAAY,gBAAgB,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwC;IACnE,8BAA8B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAC5D,mCAAmC,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;IAC3D,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAC7C,iBAAiB,CACf,MAAM,EACN,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAC5C,OAAO,CAAC,YAAY,CACrB;IACH,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CACxD,+BAA+B,CAC7B,MAAM,EACN,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,4BAA4B,CAAC,EACvD,OAAO,CAAC,KAAK,CACd;IACH,6EAA6E;IAC7E,kCAAkC;IAClC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAChD,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;IAC5C,yBAAyB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CACvD,0BAA0B,CAAC,MAAM,EAAE;QACjC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,gBAAgB,EAAE,OAAO,CAAC,qBAAqB;QAC/C,aAAa,EAAE,OAAO,CAAC,oBAAoB;KAC5C,CAAC;IACJ,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAC3C,2BAA2B,CAAC,MAAM,CAAC;IACrC,sBAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CACvC,2BAA2B,CAAC,MAAM,EAAE,UAAU,CAAC;IACjD,wBAAwB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CACzC,2BAA2B,CAAC,MAAM,EAAE,YAAY,CAAC;IACnD,qCAAqC;IACrC,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC;IAC5E,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/E,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/E,GAAG,CAAC,KAAK,CAAC;YACR,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,OAAO;YACb,aAAa;YACb,UAAU,EAAE,UAAU,IAAI,SAAS;YACnC,IAAI,EACF,YAAY,CAAC,IAAI,KAAK,OAAO;gBAC3B,CAAC,CAAC,eAAe,YAAY,CAAC,KAAK,KAAK,YAAY,CAAC,UAAU,CAAC,MAAM,cAAc,YAAY,CAAC,cAAc,CAAC,MAAM,+CAA+C;gBACrK,CAAC,CAAC,kBAAkB;SACzB,CAAC,CAAC;QACH,OAAO,mBAAmB,CACxB,MAAM,EACN,IAAI,EACJ,OAAO,CAAC,SAAS,IAAI,EAAE,EACvB,OAAO,CAAC,SAAS,EACjB,YAAY,CACb,CAAC;IACJ,CAAC;IACD,yBAAyB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CACvD,0BAA0B,CACxB,MAAM,EACN,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,CACnD;IACH,2BAA2B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CACzD,4BAA4B,CAC1B,MAAM,EACN,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,6BAA6B,CAAC,CACzD;IACH,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAChD,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;IACpD,4BAA4B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAC1D,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC;IACjE,kCAAkC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAChE,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,kCAAkC,CACvC,MAAM,EACN,OAAO,CAAC,wBAAwB,CACjC,CAAC;IACJ,CAAC;IACD,iCAAiC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC/D,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,iCAAiC,CACtC,MAAM,EACN,OAAO,CAAC,uBAAuB,CAChC,CAAC;IACJ,CAAC;IACD,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAC/C,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAC5E,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CACxD,2BAA2B,CACzB,MAAM,EACN,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,4BAA4B,CAAC,CACxD;IACH,8EAA8E;IAC9E,iFAAiF;IACjF,6EAA6E;IAC7E,2EAA2E;IAC3E,iFAAiF;IACjF,4EAA4E;IAC5E,yBAAyB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACvD,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;YACpB,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,MAAM;YACf,iBAAiB,EAAE,CAAC,mBAAmB,CAAC;YACxC,gBAAgB,EACd,QAAQ,CAAC,MAAM,KAAK,SAAS;gBAC3B,CAAC,CAAC,+DAA+D;gBACjE,CAAC,CAAC,+CAA+C;SACtD,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"executorRunners.js","sourceRoot":"","sources":["../../../src/audit/orchestrator/executorRunners.ts"],"names":[],"mappings":"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"}

package/dist/audit/orchestrator/ingestionExecutors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingestionExecutors.d.ts","sourceRoot":"","sources":["../../../src/audit/orchestrator/ingestionExecutors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAkB5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAqF7D,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,WAAW,EAAE,GACrB,iBAAiB,CAmGnB;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CA0E5B;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,uBAAuB,GAC/B,iBAAiB,CAkCnB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,uBAAuB,GACvC,iBAAiB,CAkBnB"}
+{"version":3,"file":"ingestionExecutors.d.ts","sourceRoot":"","sources":["../../../src/audit/orchestrator/ingestionExecutors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAmB5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAqF7D,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,WAAW,EAAE,GACrB,iBAAiB,CAsGnB;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CA0E5B;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,uBAAuB,GAC/B,iBAAiB,CAkCnB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,uBAAuB,GACvC,iBAAiB,CAkBnB"}

package/dist/audit/orchestrator/ingestionExecutors.js

@@ -3,6 +3,7 @@ import { buildFlowCoverage } from "./flowCoverage.js";
 import { buildRequeuePayload } from "./requeueCommand.js";
 import { buildRuntimeValidationTasks, mergeRuntimeValidationReport, } from "./runtimeValidation.js";
 import { ingestAuditResults, updateAuditTaskStatuses, } from "./resultIngestion.js";
+import { appendResultsToLedger } from "./ledger.js";
 import { buildAuditPlanMetrics, sizeIndexFromManifest, } from "./reviewPackets.js";
 import { updateRuntimeValidationReport } from "./runtimeValidationUpdate.js";
 import { buildSelectiveDeepeningTasks } from "./selectiveDeepening.js";
@@ -88,7 +89,10 @@ export function runResultIngestionExecutor(bundle, results) {
     const runtimeValidationReport = runtimeValidationTasks
         ? mergeRuntimeValidationReport(runtimeValidationTasks, bundle.runtime_validation_report)
         : bundle.runtime_validation_report;
-    const mergedResults = [...(bundle.audit_results ?? []), ...results];
+    // Append-only, instance-keyed, IDEMPOTENT on idempotency_key (O2): a replay of
+    // an already-ingested logical result is a no-op; distinct results sharing a
+    // coordinate (base vs. deepening/steward) both persist. Never a naive concat.
+    const mergedResults = appendResultsToLedger(bundle.audit_results, results);
     const completedAuditTasks = updateAuditTaskStatuses(bundle.audit_tasks, mergedResults);
     const baseUpdatedBundle = {
         ...bundle,

package/dist/audit/orchestrator/ingestionExecutors.js.map

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

package/dist/audit/orchestrator/intentCheckpointGate.d.ts

@@ -0,0 +1,129 @@
+import type { IntentCheckpoint } from 'audit-tools/shared';
+/** A gate verdict over a (prior, new) intent_checkpoint pair. */
+export type IntentCheckpointVerdict = 'unchanged' | 'changed';
+/**
+ * The bounded LLM judge. Returns `true` iff the two normalized intent values are
+ * semantically EQUIVALENT. A judge that is uncertain, errors, or returns a
+ * non-boolean is treated as `changed` by the caller (fail-safe) — the judge
+ * itself need not encode that policy. Provider-agnostic: the host supplies the
+ * actual LLM call; the gate never reaches for a specific backend.
+ */
+export type SemanticEquivalenceJudge = (input: {
+    priorNormalized: string;
+    newNormalized: string;
+}) => Promise<boolean> | boolean;
+/**
+ * Deterministic normalization config. Bumping any field bumps `gate_version` and
+ * invalidates every cached verdict. Kept as data (not code) so the version hash
+ * captures the active policy, not the module's source text.
+ */
+export interface NormalizeConfig {
+    /** Schema/recipe version of the normalization itself. Bump on any change. */
+    readonly version: string;
+    /**
+     * Checkpoint fields that carry SEMANTIC intent and participate in the normal
+     * form. Volatile/provenance fields (timestamps, confirmed_by, schema_version)
+     * are excluded so a benign re-confirm normalizes identically.
+     */
+    readonly semanticFields: readonly (keyof IntentCheckpoint)[];
+}
+/** The single active normalization config (INV-O2-inv-5 input). */
+export declare const DEFAULT_NORMALIZE_CONFIG: NormalizeConfig;
+/** Static prompt-template version — bump on any judge-prompt change. */
+export declare const INTENT_GATE_PROMPT_TEMPLATE_VERSION = "intent-checkpoint-judge-prompt/v1";
+/**
+ * Deterministically normalize an intent_checkpoint value to its semantic normal
+ * form. Only `config.semanticFields` participate; values are canonically
+ * serialized (stable key order) so reordering/whitespace is invisible. An absent
+ * checkpoint normalizes to a stable empty marker so present-vs-absent is a real
+ * difference, not a crash.
+ */
+export declare function normalizeCheckpointValue(checkpoint: IntentCheckpoint | undefined, config?: NormalizeConfig): string;
+/**
+ * Compute the LOCALLY-resolved `gate_version` cache key component:
+ * `hash(normalizeConfig) + judge-id token + prompt-template version`.
+ *
+ * NO network/API probe (INV-O2-inv-6): the judge id is a caller-supplied LOCAL
+ * token (e.g. a configured model id string already known to the host, or a
+ * sentinel like `'host'`), never a live capability query. Bumping the normalize
+ * config, the judge id, or the prompt template deterministically invalidates the
+ * verdict cache.
+ */
+export declare function computeGateVersion(input: {
+    normalizeConfig?: NormalizeConfig;
+    /** Locally-resolved judge id token. No probe; supplied by the host. */
+    judgeId: string;
+    promptTemplateVersion?: string;
+}): string;
+/** A cached verdict keyed on (priorNormalized, newNormalized, gate_version). */
+export interface VerdictCache {
+    get(key: string): IntentCheckpointVerdict | undefined;
+    set(key: string, verdict: IntentCheckpointVerdict): void;
+}
+/** Build the deterministic verdict-cache key from the version-keyed trio. */
+export declare function verdictCacheKey(priorNormalized: string, newNormalized: string, gateVersion: string): string;
+/**
+ * The normalize-then-bounded-LLM-judge equivalence gate.
+ *
+ * 1. Normalize both values; equal normal forms ⟹ `unchanged`, no judge call.
+ * 2. Cache hit on (priorNormalized, newNormalized, gate_version) ⟹ cached verdict.
+ * 3. Otherwise run the bounded judge; FAIL-SAFE — uncertain/errored/non-boolean
+ *    ⟹ `'changed'`. Cache and return.
+ *
+ * Pure decision: holds no lock and does no artifact IO. The lock-interleave
+ * discipline lives in `runIntentCheckpointGate`.
+ */
+export declare function intentCheckpointEquivalenceGate(input: {
+    prior: IntentCheckpoint | undefined;
+    next: IntentCheckpoint | undefined;
+    judge: SemanticEquivalenceJudge;
+    judgeId: string;
+    normalizeConfig?: NormalizeConfig;
+    promptTemplateVersion?: string;
+    cache?: VerdictCache;
+}): Promise<{
+    verdict: IntentCheckpointVerdict;
+    gateVersion: string;
+    judged: boolean;
+}>;
+/**
+ * A monotonic ledger/version token capturing the artifact-tree state at read.
+ * Any interleaved append moves it; comparing the read-time token to the
+ * post-judge token detects an interleave that must force a re-derive.
+ */
+export type LedgerVersionToken = string;
+/**
+ * Run the intent_checkpoint gate under the O2 lock-interleave discipline.
+ *
+ * The judge is SLOW and runs OUTSIDE the held lock. Sequence per attempt:
+ *  1. Acquire the lock; read the current ledger/version token; release.
+ *  2. Run the bounded equivalence gate (judge) UNLOCKED.
+ *  3. Re-acquire the lock; read the token again. If unchanged, COMMIT the verdict
+ *     under the lock and return. If an interleaved append moved the token,
+ *     release and re-derive (bounded to `maxAttempts`).
+ *  4. On attempt exhaustion, take the lock ACROSS the judge for one final
+ *     guaranteed-committing derivation, recording the fallback firing through the
+ *     best-effort friction sink (CE-010 residual — never blocks the commit).
+ *
+ * `withLock` is the artifact-tree lock wrapper (e.g. `withFileLock` bound to the
+ * artifact-tree lock path); `commit` persists the decided verdict under the held
+ * lock and is the single mutation point.
+ */
+export declare function runIntentCheckpointGate<T>(deps: {
+    withLock: <R>(fn: () => Promise<R>) => Promise<R>;
+    readLedgerToken: () => Promise<LedgerVersionToken>;
+    gate: () => Promise<{
+        verdict: IntentCheckpointVerdict;
+        gateVersion: string;
+    }>;
+    commit: (verdict: IntentCheckpointVerdict) => Promise<T>;
+    /** Best-effort friction recording of the lock-across-judge fallback firing. */
+    artifactsDir?: string;
+    runId?: string;
+    maxAttempts?: number;
+}): Promise<{
+    verdict: IntentCheckpointVerdict;
+    committed: T;
+    usedFallback: boolean;
+}>;
+//# sourceMappingURL=intentCheckpointGate.d.ts.map

package/dist/audit/orchestrator/intentCheckpointGate.d.ts.map

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

package/dist/audit/orchestrator/intentCheckpointGate.js

@@ -0,0 +1,193 @@
+/**
+ * O2 — the intent_checkpoint semantic-equivalence gate.
+ *
+ * The ONE place that decides whether a re-confirmed intent_checkpoint value is
+ * semantically EQUIVALENT to the prior one (so dependents need not re-stale) or
+ * CHANGED (so the `intent_checkpoint_current` obligation must re-fire and
+ * downstream artifacts re-derive). A raw byte/JSON compare over-stales: a host
+ * re-confirming the same intent with reordered keys, whitespace, or a benign
+ * rephrase would needlessly invalidate the whole planning tree. A pure structural
+ * compare under-stales: a genuine intent change phrased to hash-collide on the
+ * normalized form would be silently dropped. So the gate is
+ * normalize-then-bounded-LLM-judge:
+ *
+ *  1. NORMALIZE both values deterministically (`normalizeCheckpointValue`). Equal
+ *     normal forms ⟹ `unchanged` with no judge call (the common, free case).
+ *  2. Otherwise a BOUNDED LLM judge decides semantic equivalence. The judge is
+ *     FAIL-SAFE: any uncertain / errored / malformed verdict resolves to
+ *     `'changed'` (INV-O2-fail-3) — the gate never silently treats an
+ *     unverified pair as equivalent.
+ *
+ * VERSION-KEYED VERDICT CACHE (INV-O2-inv-5): a judge verdict is cached on
+ * `(priorValue, newValue, gate_version)`. `gate_version` is a LOCALLY-resolved
+ * token — `hash(normalizeConfig) + judge-id token + prompt-template version` —
+ * computed with NO network/API probe (INV-O2-inv-6). Bumping the normalize
+ * config, swapping the locally-resolved judge, or revising the prompt template
+ * invalidates every cached verdict deterministically; an unchanged trio is a
+ * cache hit so a re-confirm never re-pays the judge.
+ *
+ * LOCK INTERLEAVE DISCIPLINE (INV-O2-inv-7 / inv-8, the O2 lock contract): the
+ * judge is SLOW and MUST run OUTSIDE the artifact-tree lock. `runIntentCheckpointGate`
+ * therefore: reads a ledger/version token under the lock, releases, runs the
+ * judge unlocked, then RE-ACQUIRES the lock and compares the token captured at
+ * read against the token now. Any interleaved append (token moved) forces a
+ * re-derive — bounded to N attempts. On exhaustion it falls back to taking the
+ * lock ACROSS the judge for one final guaranteed-committing derivation, and
+ * records that fallback firing through the best-effort friction sink (CE-010
+ * residual: a contended friction append under the held non-reentrant lock is
+ * swallowed best-effort, never blocking the commit).
+ */
+import { captureFrictionEvent, hashContent, stableStringify } from 'audit-tools/shared';
+/** The single active normalization config (INV-O2-inv-5 input). */
+export const DEFAULT_NORMALIZE_CONFIG = {
+    version: 'intent-checkpoint-normalize/v1',
+    semanticFields: ['scope_summary', 'intent_summary', 'free_form_intent', 'constraint_clauses'],
+};
+/** Static prompt-template version — bump on any judge-prompt change. */
+export const INTENT_GATE_PROMPT_TEMPLATE_VERSION = 'intent-checkpoint-judge-prompt/v1';
+/**
+ * Deterministically normalize an intent_checkpoint value to its semantic normal
+ * form. Only `config.semanticFields` participate; values are canonically
+ * serialized (stable key order) so reordering/whitespace is invisible. An absent
+ * checkpoint normalizes to a stable empty marker so present-vs-absent is a real
+ * difference, not a crash.
+ */
+export function normalizeCheckpointValue(checkpoint, config = DEFAULT_NORMALIZE_CONFIG) {
+    if (!checkpoint)
+        return stableStringify({ __absent: true });
+    const projection = {};
+    for (const field of config.semanticFields) {
+        const value = checkpoint[field];
+        if (value !== undefined) {
+            // free_form_intent is whitespace-insensitive at the edges; clauses/objects
+            // are compared structurally via the stable serializer.
+            projection[field] =
+                typeof value === 'string' ? value.trim() : value;
+        }
+    }
+    return stableStringify(projection);
+}
+/**
+ * Compute the LOCALLY-resolved `gate_version` cache key component:
+ * `hash(normalizeConfig) + judge-id token + prompt-template version`.
+ *
+ * NO network/API probe (INV-O2-inv-6): the judge id is a caller-supplied LOCAL
+ * token (e.g. a configured model id string already known to the host, or a
+ * sentinel like `'host'`), never a live capability query. Bumping the normalize
+ * config, the judge id, or the prompt template deterministically invalidates the
+ * verdict cache.
+ */
+export function computeGateVersion(input) {
+    const normalizeConfig = input.normalizeConfig ?? DEFAULT_NORMALIZE_CONFIG;
+    const promptTemplateVersion = input.promptTemplateVersion ?? INTENT_GATE_PROMPT_TEMPLATE_VERSION;
+    const configHash = hashContent(stableStringify(normalizeConfig), { length: 16 });
+    return `${configHash}:${input.judgeId}:${promptTemplateVersion}`;
+}
+/** Build the deterministic verdict-cache key from the version-keyed trio. */
+export function verdictCacheKey(priorNormalized, newNormalized, gateVersion) {
+    return hashContent(stableStringify([priorNormalized, newNormalized, gateVersion]));
+}
+/**
+ * The normalize-then-bounded-LLM-judge equivalence gate.
+ *
+ * 1. Normalize both values; equal normal forms ⟹ `unchanged`, no judge call.
+ * 2. Cache hit on (priorNormalized, newNormalized, gate_version) ⟹ cached verdict.
+ * 3. Otherwise run the bounded judge; FAIL-SAFE — uncertain/errored/non-boolean
+ *    ⟹ `'changed'`. Cache and return.
+ *
+ * Pure decision: holds no lock and does no artifact IO. The lock-interleave
+ * discipline lives in `runIntentCheckpointGate`.
+ */
+export async function intentCheckpointEquivalenceGate(input) {
+    const config = input.normalizeConfig ?? DEFAULT_NORMALIZE_CONFIG;
+    const priorNormalized = normalizeCheckpointValue(input.prior, config);
+    const newNormalized = normalizeCheckpointValue(input.next, config);
+    const gateVersion = computeGateVersion({
+        normalizeConfig: config,
+        judgeId: input.judgeId,
+        promptTemplateVersion: input.promptTemplateVersion,
+    });
+    if (priorNormalized === newNormalized) {
+        return { verdict: 'unchanged', gateVersion, judged: false };
+    }
+    const cacheKey = verdictCacheKey(priorNormalized, newNormalized, gateVersion);
+    const cached = input.cache?.get(cacheKey);
+    if (cached !== undefined) {
+        return { verdict: cached, gateVersion, judged: false };
+    }
+    let verdict;
+    try {
+        const equivalent = await input.judge({ priorNormalized, newNormalized });
+        // FAIL-SAFE: only an explicit `true` resolves to unchanged; anything else
+        // (false, non-boolean, undefined) is treated as changed.
+        verdict = equivalent === true ? 'unchanged' : 'changed';
+    }
+    catch {
+        // FAIL-SAFE: a judge error never silently passes as equivalent.
+        verdict = 'changed';
+    }
+    input.cache?.set(cacheKey, verdict);
+    return { verdict, gateVersion, judged: true };
+}
+/**
+ * Run the intent_checkpoint gate under the O2 lock-interleave discipline.
+ *
+ * The judge is SLOW and runs OUTSIDE the held lock. Sequence per attempt:
+ *  1. Acquire the lock; read the current ledger/version token; release.
+ *  2. Run the bounded equivalence gate (judge) UNLOCKED.
+ *  3. Re-acquire the lock; read the token again. If unchanged, COMMIT the verdict
+ *     under the lock and return. If an interleaved append moved the token,
+ *     release and re-derive (bounded to `maxAttempts`).
+ *  4. On attempt exhaustion, take the lock ACROSS the judge for one final
+ *     guaranteed-committing derivation, recording the fallback firing through the
+ *     best-effort friction sink (CE-010 residual — never blocks the commit).
+ *
+ * `withLock` is the artifact-tree lock wrapper (e.g. `withFileLock` bound to the
+ * artifact-tree lock path); `commit` persists the decided verdict under the held
+ * lock and is the single mutation point.
+ */
+export async function runIntentCheckpointGate(deps) {
+    const maxAttempts = deps.maxAttempts ?? 3;
+    for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+        // (1) Capture the read-time token under the lock, then release.
+        const readToken = await deps.withLock(() => deps.readLedgerToken());
+        // (2) Run the slow judge UNLOCKED.
+        const { verdict } = await deps.gate();
+        // (3) Re-acquire; if no interleave, commit under the lock.
+        const outcome = await deps.withLock(async () => {
+            const nowToken = await deps.readLedgerToken();
+            if (nowToken !== readToken) {
+                // Interleaved append — bail out of this attempt and re-derive.
+                return { committed: undefined, interleaved: true };
+            }
+            const committed = await deps.commit(verdict);
+            return { committed, interleaved: false };
+        });
+        if (!outcome.interleaved) {
+            return { verdict, committed: outcome.committed, usedFallback: false };
+        }
+        // else: token moved during the unlocked judge — loop and re-derive.
+    }
+    // (4) Attempts exhausted under repeated contention: take the lock ACROSS the
+    // judge for one final guaranteed-committing derivation. Record the fallback
+    // firing best-effort (CE-010 residual: a contended friction append under the
+    // held non-reentrant lock is swallowed best-effort, never blocking the commit).
+    return deps.withLock(async () => {
+        if (deps.artifactsDir && deps.runId) {
+            // Fire-and-forget but awaited: captureFrictionEvent is itself best-effort
+            // and never throws, so it can never block the commit below.
+            await captureFrictionEvent(deps.artifactsDir, deps.runId, {
+                id: `intent-gate-lock-across-judge-fallback:${deps.runId}`,
+                category: 'trap',
+                severity: 'low',
+                area: 'intent_checkpoint gate',
+                note: 'intent_checkpoint gate fell back to taking the lock across the LLM judge after ' +
+                    `${maxAttempts} interleaved re-derive attempts; one guaranteed-committing derivation ran under the held lock.`,
+            }, 'audit-code');
+        }
+        const { verdict } = await deps.gate();
+        const committed = await deps.commit(verdict);
+        return { verdict, committed, usedFallback: true };
+    });
+}
+//# sourceMappingURL=intentCheckpointGate.js.map