audit-tools 0.32.16 → 0.32.18

package/dist/audit/cli/conceptualDispatch.d.ts

@@ -1,4 +1,4 @@
-import type { DispatchModelHint, DispatchModelTier, SessionConfig } from "audit-tools/shared";
+import { type DispatchModelHint, type DispatchModelTier, type SessionConfig } from "audit-tools/shared";
 import type { ArtifactBundle } from "../io/artifacts.js";
 export interface ConceptualReviewSettings {
     max_units?: number;
@@ -9,6 +9,14 @@ export interface ConceptualReviewSettings {
      * `"standard"`; the judge always routes `"deep"`.
      */
     perspective_tier?: DispatchModelTier;
+    /**
+     * True when any confirmed charter is low-confidence (Phase A conceptual spine):
+     * a review depending on a low-confidence charter must "flag for human intent
+     * input, never opine" (`charterReviewDisposition`). Absent/false when no charters
+     * are present or all are confident. The charter-aware prompt path consumes this
+     * (Phase C); until then it records the disposition on the settings contract.
+     */
+    flag_for_human?: boolean;
 }
 /**
  * Resolve the conceptual-review depth + fan-out count just before dispatch.

package/dist/audit/cli/conceptualDispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conceptualDispatch.d.ts","sourceRoot":"","sources":["../../../src/audit/cli/conceptualDispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,aAAa,GAC3B,wBAAwB,CAU1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,YAAY,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE,CAAC;CAC5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,wBAAwB,CAAC;IACnC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmI9B"}
+{"version":3,"file":"conceptualDispatch.d.ts","sourceRoot":"","sources":["../../../src/audit/cli/conceptualDispatch.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,aAAa,GAC3B,wBAAwB,CAc1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,YAAY,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE,CAAC;CAC5E;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,wBAAwB,CAAC;IACnC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmI9B"}

package/dist/audit/cli/conceptualDispatch.js

@@ -1,5 +1,6 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
+import { charterReviewDisposition, } from "audit-tools/shared";
 import { renderConceptualReviewPrompt, renderConceptualPerspectivePrompt, renderConceptualJudgePrompt, selectPerspectives, } from "../orchestrator/designReviewPrompt.js";
 /**
  * Resolve the conceptual-review depth + fan-out count just before dispatch.
@@ -10,11 +11,13 @@ import { renderConceptualReviewPrompt, renderConceptualPerspectivePrompt, render
 export function resolveConceptualReviewSettings(bundle, sessionConfig) {
     const checkpoint = bundle.intent_checkpoint?.design_review;
     const cfg = sessionConfig.design_review;
+    const flagForHuman = (checkpoint?.charters ?? []).some((charter) => charterReviewDisposition(charter) === "flag_for_human");
     return {
         max_units: cfg?.max_units,
         conceptual_depth: checkpoint?.conceptual_depth ?? cfg?.conceptual_depth ?? "shallow",
         perspectives: checkpoint?.perspectives ?? cfg?.perspectives,
         perspective_tier: cfg?.perspective_tier,
+        ...(flagForHuman ? { flag_for_human: true } : {}),
     };
 }
 /**

package/dist/audit/cli/conceptualDispatch.js.map

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

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

@@ -38,6 +38,7 @@ export declare const WorkerFindingSchema: z.ZodObject<{
     likelihood: z.ZodOptional<z.ZodString>;
     systemic: z.ZodOptional<z.ZodBoolean>;
     theme_id: z.ZodOptional<z.ZodString>;
+    blast_radius: z.ZodOptional<z.ZodNumber>;
     evidence_grounded: z.ZodOptional<z.ZodBoolean>;
     executable_anchor: z.ZodOptional<z.ZodObject<{
         command: z.ZodArray<z.ZodString, "many">;
@@ -168,6 +169,7 @@ export declare const WorkerFindingSchema: z.ZodObject<{
     systemic?: boolean | undefined;
     related_findings?: string[] | undefined;
     theme_id?: string | undefined;
+    blast_radius?: number | undefined;
     evidence_grounded?: boolean | undefined;
     grounding?: {
         status: "grounded" | "ungrounded" | "refuted";
@@ -215,6 +217,7 @@ export declare const WorkerFindingSchema: z.ZodObject<{
     systemic?: boolean | undefined;
     related_findings?: string[] | undefined;
     theme_id?: string | undefined;
+    blast_radius?: number | undefined;
     evidence_grounded?: boolean | undefined;
     grounding?: {
         status: "grounded" | "ungrounded" | "refuted";
@@ -362,6 +365,7 @@ export declare const WorkerAuditResultSchema: z.ZodObject<{
         likelihood: z.ZodOptional<z.ZodString>;
         systemic: z.ZodOptional<z.ZodBoolean>;
         theme_id: z.ZodOptional<z.ZodString>;
+        blast_radius: z.ZodOptional<z.ZodNumber>;
         evidence_grounded: z.ZodOptional<z.ZodBoolean>;
         executable_anchor: z.ZodOptional<z.ZodObject<{
             command: z.ZodArray<z.ZodString, "many">;
@@ -492,6 +496,7 @@ export declare const WorkerAuditResultSchema: z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -539,6 +544,7 @@ export declare const WorkerAuditResultSchema: z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -737,6 +743,7 @@ export declare const WorkerAuditResultSchema: z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -834,6 +841,7 @@ export declare const WorkerAuditResultSchema: z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -942,6 +950,7 @@ export declare const WorkerAuditResultsSchema: z.ZodArray<z.ZodObject<{
         likelihood: z.ZodOptional<z.ZodString>;
         systemic: z.ZodOptional<z.ZodBoolean>;
         theme_id: z.ZodOptional<z.ZodString>;
+        blast_radius: z.ZodOptional<z.ZodNumber>;
         evidence_grounded: z.ZodOptional<z.ZodBoolean>;
         executable_anchor: z.ZodOptional<z.ZodObject<{
             command: z.ZodArray<z.ZodString, "many">;
@@ -1072,6 +1081,7 @@ export declare const WorkerAuditResultsSchema: z.ZodArray<z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -1119,6 +1129,7 @@ export declare const WorkerAuditResultsSchema: z.ZodArray<z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -1317,6 +1328,7 @@ export declare const WorkerAuditResultsSchema: z.ZodArray<z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";
@@ -1414,6 +1426,7 @@ export declare const WorkerAuditResultsSchema: z.ZodArray<z.ZodObject<{
         systemic?: boolean | undefined;
         related_findings?: string[] | undefined;
         theme_id?: string | undefined;
+        blast_radius?: number | undefined;
         evidence_grounded?: boolean | undefined;
         grounding?: {
             status: "grounded" | "ungrounded" | "refuted";

package/dist/audit/contracts/workerSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workerSchemas.d.ts","sourceRoot":"","sources":["../../../src/audit/contracts/workerSchemas.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,kFAAkF;AAClF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;EAG7B,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrB,CAAC;AAEZ,wFAAwF;AACxF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBvB,CAAC;AAMZ;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAazB,CAAC;AAEZ,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAA0C,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN;IAAE,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAaxC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBhF"}
+{"version":3,"file":"workerSchemas.d.ts","sourceRoot":"","sources":["../../../src/audit/contracts/workerSchemas.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,kFAAkF;AAClF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;EAG7B,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrB,CAAC;AAEZ,wFAAwF;AACxF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBvB,CAAC;AAMZ;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAazB,CAAC;AAEZ,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAA0C,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN;IAAE,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAaxC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBhF"}

package/dist/audit/decompose/buildStructureDecomposition.d.ts

@@ -0,0 +1,14 @@
+import type { FileDisposition, GraphBundle } from "audit-tools/shared";
+import type { RepoManifest } from "../types.js";
+import type { StructureDecomposition } from "../types/structureDecomposition.js";
+export interface BuildStructureDecompositionParams {
+    /** Repo root (absolute); when absent, comment/doc extraction is skipped. */
+    root?: string;
+    repoManifest: RepoManifest;
+    disposition: FileDisposition;
+    graphBundle: GraphBundle;
+    /** Injectable file reader (tests supply a map-backed reader). */
+    readFileText?: (absPath: string) => Promise<string | undefined>;
+}
+export declare function buildStructureDecomposition(params: BuildStructureDecompositionParams): Promise<StructureDecomposition>;
+//# sourceMappingURL=buildStructureDecomposition.d.ts.map

package/dist/audit/decompose/buildStructureDecomposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildStructureDecomposition.d.ts","sourceRoot":"","sources":["../../../src/audit/decompose/buildStructureDecomposition.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EAEZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAgBjF,MAAM,WAAW,iCAAiC;IAChD,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACjE;AAmBD,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,sBAAsB,CAAC,CA+EjC"}

package/dist/audit/decompose/buildStructureDecomposition.js

@@ -0,0 +1,107 @@
+// Top-level Phase B orchestration: gather the structure-layer sources (behavior
+// graphs + the two new intent extractors), run the overlay-and-delta operator,
+// emit the non-co-localization findings, and assemble the
+// structure_decomposition.json artifact. The single async entry point the
+// executor calls; the pure pieces it composes are individually tested.
+import { clustersFromPartitions, decompose } from "audit-tools/shared";
+import { deriveCommentDecomposition, deriveDocGroups, } from "../extractors/commentDecomposition.js";
+import { buildStructureSources } from "./sources.js";
+import { detectNonColocalization } from "./findings.js";
+const DOC_EXTENSION = /\.(md|markdown|adoc|rst|txt)$/i;
+/** Threshold at which an intent source's partitions collapse into boundary groups. */
+const INTENT_BOUNDARY_FRACTION = 0.5;
+function toPosix(path) {
+    return path.replace(/\\/g, "/");
+}
+/** Convert a partition into its non-trivial member groups (size ≥ 2). */
+function partitionGroups(partition) {
+    const byComm = new Map();
+    for (const [node, comm] of partition) {
+        const list = byComm.get(comm);
+        if (list)
+            list.push(node);
+        else
+            byComm.set(comm, [node]);
+    }
+    const groups = [];
+    for (const members of byComm.values()) {
+        if (members.length >= 2) {
+            groups.push([...members].sort((a, b) => a.localeCompare(b)));
+        }
+    }
+    return groups;
+}
+export async function buildStructureDecomposition(params) {
+    // In-scope code universe = disposition-included files; doc files (prose intent)
+    // are the doc_only status plus markdown/asciidoc/rst by extension.
+    const universe = [];
+    const docFiles = [];
+    for (const item of params.disposition.files) {
+        const path = toPosix(item.path);
+        if (item.status === "included")
+            universe.push(path);
+        if (item.status === "doc_only" || DOC_EXTENSION.test(path)) {
+            if (item.status !== "excluded" && item.status !== "binary") {
+                docFiles.push(path);
+            }
+        }
+    }
+    const sortedUniverse = [...new Set(universe)].sort((a, b) => a.localeCompare(b));
+    const sortedDocs = [...new Set(docFiles)].sort((a, b) => a.localeCompare(b));
+    // Async intent extraction (skipped without a root — degrades to empty).
+    const commentResult = params.root
+        ? await deriveCommentDecomposition({
+            root: params.root,
+            files: sortedUniverse,
+            readFileText: params.readFileText,
+        })
+        : { edges: [], scannedFiles: 0 };
+    const docGroups = params.root
+        ? await deriveDocGroups({
+            root: params.root,
+            docFiles: sortedDocs,
+            codeFiles: sortedUniverse,
+            readFileText: params.readFileText,
+        })
+        : [];
+    const sources = buildStructureSources({
+        universe: sortedUniverse,
+        graphBundle: params.graphBundle,
+        commentEdges: commentResult.edges,
+        docGroups,
+    });
+    const result = decompose(sources, "structure");
+    // Finding inputs: pooled behavior partitions, all intent-declared boundaries,
+    // and the stated-purpose subset (docs + comments) for the smeared-purpose side.
+    const behaviorPartitions = sources
+        .filter((s) => s.family === "behavior")
+        .flatMap((s) => s.partitions);
+    const intentBoundaries = [];
+    const purposeGroups = [];
+    for (const source of sources) {
+        if (source.family !== "intent")
+            continue;
+        const groups = source.partitions.length === 1
+            ? partitionGroups(source.partitions[0])
+            : clustersFromPartitions(source.partitions, INTENT_BOUNDARY_FRACTION);
+        intentBoundaries.push(...groups);
+        if (source.id === "docs" || source.id === "comments") {
+            purposeGroups.push(...groups);
+        }
+    }
+    const findings = detectNonColocalization({
+        behaviorPartitions,
+        intentBoundaries,
+        purposeGroups,
+    });
+    return {
+        generated_at: new Date().toISOString(),
+        target: result.target,
+        node_universe_size: sortedUniverse.length,
+        source_ids: sources.map((s) => s.id),
+        consensus: result.consensus,
+        contested: result.contested,
+        findings,
+    };
+}
+//# sourceMappingURL=buildStructureDecomposition.js.map

package/dist/audit/decompose/buildStructureDecomposition.js.map

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

package/dist/audit/decompose/findings.d.ts

@@ -0,0 +1,23 @@
+import type { Finding } from "../types.js";
+import type { Partition } from "audit-tools/shared";
+export interface NonColocalizationInput {
+    /** Pooled behavior partitions (every resolution of every behavior source). */
+    behaviorPartitions: Partition[];
+    /** All intent-declared boundaries (directory + docs + comments groups). */
+    intentBoundaries: string[][];
+    /** Explicit stated-purpose groups (docs + comments only — not directory). */
+    purposeGroups: string[][];
+    agreementThreshold?: number;
+    overlapThreshold?: number;
+    /** Minimum behavior-cluster size to report a no-purpose finding. */
+    minClusterSize?: number;
+    /** Cap on findings emitted per kind (deterministic top-by-size). */
+    maxPerKind?: number;
+}
+/**
+ * Emit the two non-co-localization finding kinds. Deterministic: clusters/groups
+ * are processed largest-first (ties by first member), and ids are a stable
+ * instance-scoped SD-### sequence.
+ */
+export declare function detectNonColocalization(input: NonColocalizationInput): Finding[];
+//# sourceMappingURL=findings.d.ts.map

package/dist/audit/decompose/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../../src/audit/decompose/findings.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA8BpD,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,kBAAkB,EAAE,SAAS,EAAE,CAAC;IAChC,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,EAAE,CA+EX"}

package/dist/audit/decompose/findings.js

@@ -0,0 +1,121 @@
+// The two non-co-localization findings (Phase B; design of record
+// spec/conceptual-design-review-design.md §"The two non-co-localizations are
+// first-class findings"). When structure-consensus (behavior) and the
+// intent-declared boundaries FAIL to coincide:
+//   - behavioral cluster with no coherent purpose → accidental complexity / dead
+//     subsystem (a coupling cluster no declared boundary owns).
+//   - a purpose with no behavioral cluster → a goal smeared across the codebase,
+//     never modularized (often the highest-value refactor).
+//
+// Deterministic LEADS, not verdicts (confidence: low): they mark where the
+// behavior graphs and the human-declared boundaries disagree, for the Phase C
+// charter pass to confirm against real charters. blast_radius is left unset
+// (Phase C populates goal-graph linkage).
+import { clustersFromPartitions } from "audit-tools/shared";
+/** Structural boundary-integrity findings carry the architecture lens. */
+const LENS = "architecture";
+function createIdGenerator() {
+    let n = 1;
+    return () => `SD-${String(n++).padStart(3, "0")}`;
+}
+/** |subset ∩ group| / |subset|. */
+function overlapFraction(subset, group) {
+    if (subset.length === 0)
+        return 0;
+    let hit = 0;
+    for (const m of subset)
+        if (group.has(m))
+            hit += 1;
+    return hit / subset.length;
+}
+/** Best fraction of `members` contained in any single group. */
+function bestContainment(members, groups) {
+    let best = 0;
+    for (const group of groups) {
+        const set = new Set(group);
+        const frac = overlapFraction(members, set);
+        if (frac > best)
+            best = frac;
+    }
+    return best;
+}
+const DEFAULT_AGREEMENT = 0.5;
+const DEFAULT_OVERLAP = 0.6;
+const DEFAULT_MIN_CLUSTER = 3;
+const DEFAULT_MAX_PER_KIND = 20;
+/**
+ * Emit the two non-co-localization finding kinds. Deterministic: clusters/groups
+ * are processed largest-first (ties by first member), and ids are a stable
+ * instance-scoped SD-### sequence.
+ */
+export function detectNonColocalization(input) {
+    const agreementThreshold = input.agreementThreshold ?? DEFAULT_AGREEMENT;
+    const overlapThreshold = input.overlapThreshold ?? DEFAULT_OVERLAP;
+    const minClusterSize = input.minClusterSize ?? DEFAULT_MIN_CLUSTER;
+    const maxPerKind = input.maxPerKind ?? DEFAULT_MAX_PER_KIND;
+    const nextId = createIdGenerator();
+    const bySizeThenFirst = (a, b) => b.length - a.length || (a[0] ?? "").localeCompare(b[0] ?? "");
+    const findings = [];
+    // One clustering pass shared by both detectors: the full set for the
+    // purpose-side containment check, the size-filtered set for the no-purpose one.
+    const allBehaviorClusters = clustersFromPartitions(input.behaviorPartitions, agreementThreshold);
+    // --- Behavioral cluster with no coherent purpose ---
+    const behaviorClusters = allBehaviorClusters
+        .filter((c) => c.length >= minClusterSize)
+        .sort(bySizeThenFirst);
+    for (const cluster of behaviorClusters.slice(0, maxPerKind)) {
+        const best = bestContainment(cluster, input.intentBoundaries);
+        if (best + 1e-12 >= overlapThreshold)
+            continue; // aligns to a declared boundary
+        findings.push({
+            id: nextId(),
+            title: `Behavioral cluster spans declared boundaries: ${cluster.length} files`,
+            category: "non_colocalization_behavioral",
+            severity: "low",
+            confidence: "low",
+            lens: LENS,
+            summary: `These ${cluster.length} files are tightly coupled by behavior (call/import, ` +
+                `co-change, and/or shared state) yet no single declared boundary ` +
+                `(directory, doc, or comment grouping) contains most of them ` +
+                `(best overlap ${(best * 100).toFixed(0)}%). A coupling cluster no ` +
+                `declared purpose owns is accidental complexity or a dead subsystem — a ` +
+                `lead for the conceptual charter pass to confirm.`,
+            affected_files: cluster.map((path) => ({ path })),
+            evidence: [
+                `Behavioral coupling consensus across ${input.behaviorPartitions.length} resolution levels.`,
+                `Best containment in any declared boundary: ${(best * 100).toFixed(0)}% (threshold ${(overlapThreshold * 100).toFixed(0)}%).`,
+            ],
+            systemic: true,
+        });
+    }
+    // --- A purpose with no behavioral cluster (smeared) ---
+    const purposeGroups = [...input.purposeGroups]
+        .filter((g) => g.length >= 2)
+        .sort(bySizeThenFirst);
+    for (const group of purposeGroups.slice(0, maxPerKind)) {
+        const best = bestContainment(group, allBehaviorClusters);
+        if (best + 1e-12 >= overlapThreshold)
+            continue; // the purpose IS a behavior cluster
+        findings.push({
+            id: nextId(),
+            title: `Declared purpose is behaviorally smeared: ${group.length} files`,
+            category: "non_colocalization_purpose",
+            severity: "low",
+            confidence: "low",
+            lens: LENS,
+            summary: `A doc/comment grouping declares these ${group.length} files a unit, but ` +
+                `they do not form a behavioral cluster — no single coupling cluster ` +
+                `contains most of them (best overlap ${(best * 100).toFixed(0)}%). A ` +
+                `purpose smeared across the codebase and never modularized is often the ` +
+                `highest-value refactor — a lead for the conceptual charter pass.`,
+            affected_files: group.map((path) => ({ path })),
+            evidence: [
+                `Declared as one unit by an intent-declared source (doc/comment).`,
+                `Best containment in any behavioral cluster: ${(best * 100).toFixed(0)}% (threshold ${(overlapThreshold * 100).toFixed(0)}%).`,
+            ],
+            systemic: true,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=findings.js.map

package/dist/audit/decompose/findings.js.map

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

package/dist/audit/decompose/sources.d.ts

@@ -0,0 +1,21 @@
+import type { DecompositionSource, GraphBundle } from "audit-tools/shared";
+import { type CouplingEdge } from "../extractors/dataStateCoupling.js";
+export interface StructureSourcesInput {
+    /** In-scope files (posix, sorted, unique) — the shared node universe. */
+    universe: string[];
+    graphBundle: GraphBundle;
+    /** Comment cross-reference edges from deriveCommentDecomposition. */
+    commentEdges: CouplingEdge[];
+    /** Doc-declared groups from deriveDocGroups. */
+    docGroups: string[][];
+    resolutions?: readonly number[];
+    /** Directory depths for the intent directory family (default [1,2,3]). */
+    directoryDepths?: number[];
+}
+/**
+ * Build the structure-layer decomposition sources. Behavior sources with no edges
+ * and intent sources with no non-trivial grouping are omitted so an empty source
+ * never dilutes the agreement mean.
+ */
+export declare function buildStructureSources(input: StructureSourcesInput): DecompositionSource[];
+//# sourceMappingURL=sources.d.ts.map

package/dist/audit/decompose/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../src/audit/decompose/sources.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EAEZ,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAqF5C,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,qEAAqE;IACrE,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,gDAAgD;IAChD,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,GAC3B,mBAAmB,EAAE,CAmFvB"}