@agent-teams/engineering-foundation 0.4.1 → 0.6.0

package/dist/capabilities/source-dependencies/application/policies/evaluate-source-dependency-cycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-source-dependency-cycles.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/policies/evaluate-source-dependency-cycles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAsB,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,8BAA8B,CAAC;AAoYtC,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mBAAmB,GACzB,SAAS,oBAAoB,EAAE,CAgCjC"}

package/dist/capabilities/source-dependencies/application/policies/evaluate-source-dependency-cycles.js

@@ -0,0 +1,315 @@
+import { compareBinaryStrings, compareBinaryStringSequences } from "../../../../binary-string-comparator.js";
+import { SOURCE_DEPENDENCY_RULES } from "../rules.js";
+const MAX_EVIDENCE_MEMBERS = 16;
+const MAX_EVIDENCE_WITNESS_NODES = 16;
+function diagnostic(input) {
+    return {
+        ruleId: input.rule.id,
+        severity: input.rule.severity,
+        subject: input.subject,
+        message: input.message,
+        location: { path: input.path },
+        relatedLocations: input.relatedPath === null ? [] : [{ path: input.relatedPath }],
+        evidence: input.evidence,
+        remediation: input.rule.remediation,
+        requiresArchitectureReview: input.rule.requiresArchitectureReview
+    };
+}
+function compareLogicalEdges(left, right) {
+    return (compareBinaryStrings(left.from, right.from) ||
+        compareBinaryStrings(left.to, right.to) ||
+        compareBinaryStrings(left.mode, right.mode) ||
+        compareBinaryStrings(left.sourcePath, right.sourcePath) ||
+        compareBinaryStrings(left.targetPath ?? "", right.targetPath ?? ""));
+}
+function logicalEdges(graph, scope, mode) {
+    const candidates = [];
+    for (const edge of graph.edges) {
+        // A runtime cycle may contain type-only edges. Type-only diagnostics stay
+        // strict so a purely type-level SCC is not reported as a runtime cycle.
+        if (mode === "type-only" && edge.mode !== "type-only") {
+            continue;
+        }
+        const candidate = logicalEdge(edge, scope);
+        if (candidate !== undefined && candidate.from !== candidate.to) {
+            candidates.push(candidate);
+        }
+    }
+    const unique = new Map();
+    for (const edge of candidates.toSorted(compareLogicalEdges)) {
+        const key = `${edge.from}\u0000${edge.to}`;
+        const current = unique.get(key);
+        if (current === undefined || (current.mode === "type-only" && edge.mode === "runtime")) {
+            unique.set(key, edge);
+        }
+    }
+    return Object.freeze([...unique.values()].toSorted(compareLogicalEdges));
+}
+function logicalEdge(edge, scope) {
+    if (scope === "boundary") {
+        if (edge.resolution.kind !== "local-file") {
+            return undefined;
+        }
+        if (edge.resolution.targetBoundaryId === null) {
+            return undefined;
+        }
+        return {
+            from: edge.fromBoundaryId,
+            mode: edge.mode,
+            to: edge.resolution.targetBoundaryId,
+            sourcePath: edge.fromPath,
+            targetPath: edge.resolution.path
+        };
+    }
+    switch (edge.resolution.kind) {
+        case "local-file":
+            return {
+                from: edge.fromWorkspacePackageName,
+                mode: edge.mode,
+                to: edge.resolution.workspacePackageName,
+                sourcePath: edge.fromPath,
+                targetPath: edge.resolution.path
+            };
+        case "workspace-package":
+            return {
+                from: edge.fromWorkspacePackageName,
+                mode: edge.mode,
+                to: edge.resolution.workspacePackageName,
+                sourcePath: edge.fromPath,
+                targetPath: null
+            };
+        case "builtin":
+        case "external-package":
+        case "self-workspace-package":
+        case "unresolved":
+        case "unsupported":
+            return undefined;
+    }
+}
+function adjacency(edges) {
+    const output = new Map();
+    for (const edge of edges) {
+        const from = output.get(edge.from) ?? [];
+        from.push(edge);
+        output.set(edge.from, from);
+        if (!output.has(edge.to)) {
+            output.set(edge.to, []);
+        }
+    }
+    return new Map([...output.entries()].map(([node, outgoing]) => [
+        node,
+        Object.freeze(outgoing.toSorted(compareLogicalEdges))
+    ]));
+}
+function stronglyConnectedComponents(graph) {
+    const nodes = [...graph.keys()].toSorted();
+    const visited = new Set();
+    const finished = [];
+    // Iterative DFS avoids call-stack failure on a large workspace graph.
+    for (const start of nodes) {
+        if (visited.has(start)) {
+            continue;
+        }
+        visited.add(start);
+        const stack = [{ node: start, nextEdgeIndex: 0 }];
+        while (stack.length > 0) {
+            const frame = stack[stack.length - 1];
+            if (frame === undefined) {
+                break;
+            }
+            const edge = (graph.get(frame.node) ?? [])[frame.nextEdgeIndex];
+            if (edge === undefined) {
+                finished.push(frame.node);
+                stack.pop();
+                continue;
+            }
+            frame.nextEdgeIndex += 1;
+            if (!visited.has(edge.to)) {
+                visited.add(edge.to);
+                stack.push({ node: edge.to, nextEdgeIndex: 0 });
+            }
+        }
+    }
+    const reversed = new Map(nodes.map((node) => [node, []]));
+    for (const [from, outgoing] of graph) {
+        for (const edge of outgoing) {
+            const predecessors = reversed.get(edge.to);
+            if (predecessors !== undefined) {
+                predecessors.push(from);
+            }
+        }
+    }
+    const reverseAdjacency = new Map([...reversed.entries()].map(([node, predecessors]) => [
+        node,
+        predecessors.toSorted()
+    ]));
+    const components = [];
+    visited.clear();
+    for (const start of finished.toReversed()) {
+        if (visited.has(start)) {
+            continue;
+        }
+        const component = [];
+        const stack = [start];
+        visited.add(start);
+        while (stack.length > 0) {
+            const node = stack.pop();
+            if (node === undefined) {
+                continue;
+            }
+            component.push(node);
+            for (const predecessor of reverseAdjacency.get(node) ?? []) {
+                if (!visited.has(predecessor)) {
+                    visited.add(predecessor);
+                    stack.push(predecessor);
+                }
+            }
+        }
+        if (component.length > 1) {
+            components.push(component.toSorted());
+        }
+    }
+    return Object.freeze(components.toSorted(compareBinaryStringSequences));
+}
+function shortestPath(start, target, members, graph, requiredMode) {
+    const queue = [start];
+    const previous = new Map();
+    const visited = new Set([start]);
+    for (let index = 0; index < queue.length; index += 1) {
+        const node = queue[index];
+        if (node === undefined) {
+            break;
+        }
+        for (const edge of graph.get(node) ?? []) {
+            if ((requiredMode !== undefined && edge.mode !== requiredMode) ||
+                !members.has(edge.to) ||
+                visited.has(edge.to)) {
+                continue;
+            }
+            previous.set(edge.to, edge);
+            if (edge.to === target) {
+                return reconstructPath(previous, start, target);
+            }
+            visited.add(edge.to);
+            queue.push(edge.to);
+        }
+    }
+    return undefined;
+}
+function reconstructPath(previous, start, target) {
+    const path = [];
+    let cursor = target;
+    while (cursor !== start) {
+        const step = previous.get(cursor);
+        if (step === undefined) {
+            return undefined;
+        }
+        path.push(step);
+        cursor = step.from;
+    }
+    return Object.freeze(path.toReversed());
+}
+function canonicalWitness(members, graph, mode) {
+    if (members.length === 0) {
+        return undefined;
+    }
+    const memberSet = new Set(members);
+    const candidateEdges = mode === "runtime"
+        ? members.flatMap((member) => (graph.get(member) ?? []).filter((edge) => edge.mode === "runtime" && memberSet.has(edge.to))).toSorted(compareLogicalEdges)
+        : graph.get(members[0] ?? "") ?? [];
+    if (mode === "runtime") {
+        for (const firstEdge of candidateEdges) {
+            const returnPath = shortestPath(firstEdge.to, firstEdge.from, memberSet, graph, "runtime");
+            if (returnPath !== undefined) {
+                return Object.freeze([firstEdge, ...returnPath]);
+            }
+        }
+    }
+    for (const firstEdge of candidateEdges) {
+        if (!memberSet.has(firstEdge.to)) {
+            continue;
+        }
+        const returnPath = shortestPath(firstEdge.to, firstEdge.from, memberSet, graph);
+        if (returnPath !== undefined) {
+            return Object.freeze([firstEdge, ...returnPath]);
+        }
+    }
+    return undefined;
+}
+function boundedList(values, maxItems) {
+    if (values.length <= maxItems) {
+        return values.join(", ");
+    }
+    const headCount = Math.ceil(maxItems / 2);
+    const tailCount = Math.floor(maxItems / 2);
+    return [
+        ...values.slice(0, headCount),
+        `...(+${values.length - maxItems})`,
+        ...values.slice(-tailCount)
+    ].join(", ");
+}
+function boundedWitness(edges) {
+    const nodes = [edges[0]?.from, ...edges.map((edge) => edge.to)].filter((node) => node !== undefined);
+    if (nodes.length <= MAX_EVIDENCE_WITNESS_NODES) {
+        return nodes.join(" -> ");
+    }
+    const headCount = Math.ceil(MAX_EVIDENCE_WITNESS_NODES / 2);
+    const tailCount = Math.floor(MAX_EVIDENCE_WITNESS_NODES / 2);
+    return [
+        ...nodes.slice(0, headCount),
+        "...",
+        ...nodes.slice(-tailCount)
+    ].join(" -> ");
+}
+function cycleEvidence(graph, mode) {
+    const cycles = [];
+    for (const members of stronglyConnectedComponents(graph)) {
+        const witness = canonicalWitness(members, graph, mode);
+        if (witness !== undefined) {
+            cycles.push(Object.freeze({ members: Object.freeze([...members]), witness }));
+        }
+    }
+    return Object.freeze(cycles.toSorted((left, right) => compareBinaryStringSequences(left.members, right.members)));
+}
+function ruleFor(scope, mode) {
+    if (scope === "boundary") {
+        return mode === "runtime"
+            ? SOURCE_DEPENDENCY_RULES.boundaryRuntimeCycle
+            : SOURCE_DEPENDENCY_RULES.boundaryTypeOnlyCycle;
+    }
+    return mode === "runtime"
+        ? SOURCE_DEPENDENCY_RULES.packageRuntimeCycle
+        : SOURCE_DEPENDENCY_RULES.packageTypeOnlyCycle;
+}
+export function evaluateSourceDependencyCycles(graph) {
+    const diagnostics = [];
+    for (const scope of ["boundary", "package"]) {
+        for (const mode of ["runtime", "type-only"]) {
+            const cycles = cycleEvidence(adjacency(logicalEdges(graph, scope, mode)), mode);
+            const rule = ruleFor(scope, mode);
+            for (const cycle of cycles) {
+                const firstEdge = cycle.witness[0];
+                if (firstEdge === undefined) {
+                    continue;
+                }
+                diagnostics.push(diagnostic({
+                    rule,
+                    subject: `${scope}:${cycle.members.join(",")}`,
+                    message: `Observed ${mode} ${scope} cycle: ${boundedWitness(cycle.witness)}.`,
+                    path: firstEdge.sourcePath,
+                    relatedPath: firstEdge.targetPath,
+                    evidence: [
+                        { kind: "cycle-scope", value: scope },
+                        { kind: "cycle-mode", value: mode },
+                        { kind: "cycle-members", value: boundedList(cycle.members, MAX_EVIDENCE_MEMBERS) },
+                        { kind: "cycle-size", value: String(cycle.members.length) },
+                        { kind: "cycle-witness", value: boundedWitness(cycle.witness) },
+                        { kind: "cycle-witness-edge-count", value: String(cycle.witness.length) }
+                    ]
+                }));
+            }
+        }
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=evaluate-source-dependency-cycles.js.map

package/dist/capabilities/source-dependencies/application/policies/evaluate-source-dependency-cycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-source-dependency-cycles.js","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/policies/evaluate-source-dependency-cycles.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/source-dependencies/application/rules.d.ts

@@ -8,10 +8,16 @@ export interface SourceDependencyRuleMetadata {
     readonly requiresArchitectureReview: boolean;
 }
 export declare const SOURCE_DEPENDENCY_RULES: Readonly<{
+    boundaryRuntimeCycle: SourceDependencyRuleMetadata;
+    boundaryTypeOnlyCycle: SourceDependencyRuleMetadata;
     crossPackageRelativeImport: SourceDependencyRuleMetadata;
+    crossBoundaryLocalImportNotEntrypoint: SourceDependencyRuleMetadata;
     forbiddenBoundaryDependency: SourceDependencyRuleMetadata;
     forbiddenBuiltinDependency: SourceDependencyRuleMetadata;
     forbiddenPackageDependency: SourceDependencyRuleMetadata;
+    invalidBoundaryEntrypoint: SourceDependencyRuleMetadata;
+    packageRuntimeCycle: SourceDependencyRuleMetadata;
+    packageTypeOnlyCycle: SourceDependencyRuleMetadata;
     packageSubpathNotExported: SourceDependencyRuleMetadata;
     sourceParseError: SourceDependencyRuleMetadata;
     undeclaredExternalDependency: SourceDependencyRuleMetadata;
@@ -19,6 +25,7 @@ export declare const SOURCE_DEPENDENCY_RULES: Readonly<{
     unresolvedLocalImport: SourceDependencyRuleMetadata;
     unresolvedRuntimeReference: SourceDependencyRuleMetadata;
     runtimeImportFromDevelopmentDependency: SourceDependencyRuleMetadata;
+    selfPackageImportBoundaryUnresolved: SourceDependencyRuleMetadata;
     unsupportedImportSpecifier: SourceDependencyRuleMetadata;
     unclassifiedSourceFile: SourceDependencyRuleMetadata;
 }>;

package/dist/capabilities/source-dependencies/application/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/source-dependencies/application/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;CAC9C;AAkBD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;EA0ElC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,WAAW,CACrD,MAAM,EACN,4BAA4B,CAG7B,CAAC"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/source-dependencies/application/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;CAC9C;AAkBD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAoHlC,CAAC;AAEH,eAAO,MAAM,6BAA6B,EAAE,WAAW,CACrD,MAAM,EACN,4BAA4B,CAG7B,CAAC"}

package/dist/capabilities/source-dependencies/application/rules.js

@@ -9,10 +9,16 @@ function rule(suffix, rationale, remediation, requiresArchitectureReview = false
     });
 }
 export const SOURCE_DEPENDENCY_RULES = Object.freeze({
+    boundaryRuntimeCycle: rule("boundary-runtime-cycle", "A runtime cycle between architecture boundaries prevents an independent ownership direction.", "Break the boundary cycle with a port, event, or extracted shared contract.", true),
+    boundaryTypeOnlyCycle: rule("boundary-type-only-cycle", "A type-only cycle still couples architecture boundaries and makes their public contracts mutually recursive.", "Move shared types to an explicit contract boundary or remove the cyclic type dependency.", true),
     crossPackageRelativeImport: rule("cross-package-relative-import", "Cross-package relative imports bypass package identity and public exports.", "Import the target package through an exported package subpath.", true),
+    crossBoundaryLocalImportNotEntrypoint: rule("cross-boundary-local-import-not-entrypoint", "Schema v2 requires every cross-boundary local import to use a deliberately declared target entrypoint.", "Import the target boundary through one of its declared entrypoint source files.", true),
     forbiddenBoundaryDependency: rule("forbidden-boundary-dependency", "Source boundaries must follow the consumer-owned architecture graph.", "Move the dependency behind a port or approve the boundary edge.", true),
     forbiddenBuiltinDependency: rule("forbidden-builtin-dependency", "Runtime builtins are capabilities that must be explicit per boundary.", "Move the builtin access to an adapter or approve it for this boundary.", true),
     forbiddenPackageDependency: rule("forbidden-package-dependency", "Package dependencies must be explicit per architecture boundary.", "Move the import behind a port or approve the package for this boundary.", true),
+    invalidBoundaryEntrypoint: rule("invalid-boundary-entrypoint", "Boundary entrypoints must resolve to governed source classified by the boundary that declares them.", "Correct the entrypoint path or update the boundary classification before relying on it.", true),
+    packageRuntimeCycle: rule("package-runtime-cycle", "A runtime cycle between workspace packages prevents independent package ownership and release ordering.", "Break the package cycle with an explicit contract package or directional port.", true),
+    packageTypeOnlyCycle: rule("package-type-only-cycle", "A type-only cycle between workspace packages couples their public type surfaces and release order.", "Extract shared types into a directional contract package or remove the cyclic type dependency.", true),
     packageSubpathNotExported: rule("package-subpath-not-exported", "Workspace consumers may only import explicit package exports.", "Use an existing public entrypoint or deliberately add a package export.", true),
     sourceParseError: rule("source-parse-error", "Architecture evidence cannot be trusted when governed source does not parse.", "Fix the source syntax before evaluating architecture boundaries."),
     undeclaredExternalDependency: rule("undeclared-external-dependency", "Runtime source must not rely on undeclared transitive dependencies.", "Declare the external package in dependencies, optionalDependencies, or peerDependencies."),
@@ -20,6 +26,7 @@ export const SOURCE_DEPENDENCY_RULES = Object.freeze({
     unresolvedLocalImport: rule("unresolved-local-import", "Unresolved governed imports make the observed dependency graph incomplete.", "Use a supported literal import that resolves to a governed source file."),
     unresolvedRuntimeReference: rule("unresolved-runtime-reference", "Non-literal runtime loading can hide architecture edges from static evidence.", "Centralize dynamic loading behind an approved adapter with literal module references.", true),
     runtimeImportFromDevelopmentDependency: rule("runtime-import-from-development-dependency", "Published runtime source cannot depend only on development dependencies.", "Move the dependency to an appropriate runtime dependency section."),
+    selfPackageImportBoundaryUnresolved: rule("self-package-import-boundary-unresolved", "A package-name import back into the importing workspace package does not reveal the target source boundary.", "Use a relative import governed by schema v2 entrypoints, or move the public surface into a separate workspace package.", true),
     unsupportedImportSpecifier: rule("unsupported-import-specifier", "Unsupported specifiers cannot be classified reliably by the architecture gate.", "Use relative, node builtin, declared external, or governed workspace package imports.", true),
     unclassifiedSourceFile: rule("unclassified-source-file", "Every governed source file must belong to exactly one declared architecture boundary.", "Classify the file in an existing boundary or introduce an explicitly reviewed boundary.", true)
 });

package/dist/capabilities/source-dependencies/application/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../../src/capabilities/source-dependencies/application/rules.ts"],"names":[],"mappings":"AAWA,SAAS,IAAI,CACX,MAAc,EACd,SAAiB,EACjB,WAAmB,EACnB,0BAA0B,GAAG,KAAK;IAElC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,oCAAoC,MAAM,EAAE;QAChD,QAAQ,EAAE,OAAO;QACjB,SAAS;QACT,WAAW;QACX,aAAa,EAAE,8EAA8E;QAC7F,0BAA0B;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,0BAA0B,EAAE,IAAI,CAC9B,+BAA+B,EAC/B,4EAA4E,EAC5E,gEAAgE,EAChE,IAAI,CACL;IACD,2BAA2B,EAAE,IAAI,CAC/B,+BAA+B,EAC/B,sEAAsE,EACtE,iEAAiE,EACjE,IAAI,CACL;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,uEAAuE,EACvE,wEAAwE,EACxE,IAAI,CACL;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,kEAAkE,EAClE,yEAAyE,EACzE,IAAI,CACL;IACD,yBAAyB,EAAE,IAAI,CAC7B,8BAA8B,EAC9B,+DAA+D,EAC/D,yEAAyE,EACzE,IAAI,CACL;IACD,gBAAgB,EAAE,IAAI,CACpB,oBAAoB,EACpB,8EAA8E,EAC9E,kEAAkE,CACnE;IACD,4BAA4B,EAAE,IAAI,CAChC,gCAAgC,EAChC,qEAAqE,EACrE,0FAA0F,CAC3F;IACD,6BAA6B,EAAE,IAAI,CACjC,iCAAiC,EACjC,6EAA6E,EAC7E,4EAA4E,CAC7E;IACD,qBAAqB,EAAE,IAAI,CACzB,yBAAyB,EACzB,4EAA4E,EAC5E,yEAAyE,CAC1E;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,+EAA+E,EAC/E,uFAAuF,EACvF,IAAI,CACL;IACD,sCAAsC,EAAE,IAAI,CAC1C,4CAA4C,EAC5C,0EAA0E,EAC1E,mEAAmE,CACpE;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,gFAAgF,EAChF,uFAAuF,EACvF,IAAI,CACL;IACD,sBAAsB,EAAE,IAAI,CAC1B,0BAA0B,EAC1B,uFAAuF,EACvF,yFAAyF,EACzF,IAAI,CACL;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAGtC,IAAI,GAAG,CACT,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAClF,CAAC"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../../src/capabilities/source-dependencies/application/rules.ts"],"names":[],"mappings":"AAWA,SAAS,IAAI,CACX,MAAc,EACd,SAAiB,EACjB,WAAmB,EACnB,0BAA0B,GAAG,KAAK;IAElC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,oCAAoC,MAAM,EAAE;QAChD,QAAQ,EAAE,OAAO;QACjB,SAAS;QACT,WAAW;QACX,aAAa,EAAE,8EAA8E;QAC7F,0BAA0B;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,oBAAoB,EAAE,IAAI,CACxB,wBAAwB,EACxB,8FAA8F,EAC9F,4EAA4E,EAC5E,IAAI,CACL;IACD,qBAAqB,EAAE,IAAI,CACzB,0BAA0B,EAC1B,8GAA8G,EAC9G,0FAA0F,EAC1F,IAAI,CACL;IACD,0BAA0B,EAAE,IAAI,CAC9B,+BAA+B,EAC/B,4EAA4E,EAC5E,gEAAgE,EAChE,IAAI,CACL;IACD,qCAAqC,EAAE,IAAI,CACzC,4CAA4C,EAC5C,wGAAwG,EACxG,iFAAiF,EACjF,IAAI,CACL;IACD,2BAA2B,EAAE,IAAI,CAC/B,+BAA+B,EAC/B,sEAAsE,EACtE,iEAAiE,EACjE,IAAI,CACL;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,uEAAuE,EACvE,wEAAwE,EACxE,IAAI,CACL;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,kEAAkE,EAClE,yEAAyE,EACzE,IAAI,CACL;IACD,yBAAyB,EAAE,IAAI,CAC7B,6BAA6B,EAC7B,qGAAqG,EACrG,yFAAyF,EACzF,IAAI,CACL;IACD,mBAAmB,EAAE,IAAI,CACvB,uBAAuB,EACvB,yGAAyG,EACzG,gFAAgF,EAChF,IAAI,CACL;IACD,oBAAoB,EAAE,IAAI,CACxB,yBAAyB,EACzB,oGAAoG,EACpG,gGAAgG,EAChG,IAAI,CACL;IACD,yBAAyB,EAAE,IAAI,CAC7B,8BAA8B,EAC9B,+DAA+D,EAC/D,yEAAyE,EACzE,IAAI,CACL;IACD,gBAAgB,EAAE,IAAI,CACpB,oBAAoB,EACpB,8EAA8E,EAC9E,kEAAkE,CACnE;IACD,4BAA4B,EAAE,IAAI,CAChC,gCAAgC,EAChC,qEAAqE,EACrE,0FAA0F,CAC3F;IACD,6BAA6B,EAAE,IAAI,CACjC,iCAAiC,EACjC,6EAA6E,EAC7E,4EAA4E,CAC7E;IACD,qBAAqB,EAAE,IAAI,CACzB,yBAAyB,EACzB,4EAA4E,EAC5E,yEAAyE,CAC1E;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,+EAA+E,EAC/E,uFAAuF,EACvF,IAAI,CACL;IACD,sCAAsC,EAAE,IAAI,CAC1C,4CAA4C,EAC5C,0EAA0E,EAC1E,mEAAmE,CACpE;IACD,mCAAmC,EAAE,IAAI,CACvC,yCAAyC,EACzC,6GAA6G,EAC7G,wHAAwH,EACxH,IAAI,CACL;IACD,0BAA0B,EAAE,IAAI,CAC9B,8BAA8B,EAC9B,gFAAgF,EAChF,uFAAuF,EACvF,IAAI,CACL;IACD,sBAAsB,EAAE,IAAI,CAC1B,0BAA0B,EAC1B,uFAAuF,EACvF,yFAAyF,EACzF,IAAI,CACL;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAGtC,IAAI,GAAG,CACT,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAClF,CAAC"}

package/dist/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-source-dependencies.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sEAAsE,CAAC;AAG7G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iFAAiF,CAAC;AAChI,OAAO,KAAK,EAGV,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAGvF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;CACzC;AA+ED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,EACrC,YAAY,EAAE,qCAAqC,GAClD,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CA4B1C"}
+{"version":3,"file":"analyze-source-dependencies.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sEAAsE,CAAC;AAE7G,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iFAAiF,CAAC;AAChI,OAAO,KAAK,EAGV,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAIvF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;CACzC;AAuHD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,EACrC,YAAY,EAAE,qCAAqC,GAClD,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAgC1C"}

package/dist/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.js

@@ -1,15 +1,45 @@
+import { compareBinaryStrings } from "../../../../binary-string-comparator.js";
+import { assertNotCancelled } from "../../../../cancellation.js";
 import { CapabilityInputError } from "../../../../capability-runtime.js";
-import { assertNotCancelled } from "../../../../strict-yaml.js";
+import { normalizeRepositoryPath, pathIsInside } from "../model/repository-path.js";
 import { evaluateSourceDependencies } from "../policies/evaluate-source-dependencies.js";
+import { buildObservedSourceGraph } from "./build-observed-source-graph.js";
 function pathInside(path, root) {
-    return path === root || path.startsWith(`${root}/`);
+    return pathIsInside(path, root);
 }
-function deepestBoundary(file, boundaries) {
-    return boundaries
-        .filter((boundary) => boundary.roots.some((root) => pathInside(file.path, root)))
-        .toSorted((left, right) => Math.max(...right.roots.map((root) => root.length)) -
-        Math.max(...left.roots.map((root) => root.length)) ||
-        left.id.localeCompare(right.id))[0];
+function matchingBoundarySpecificity(path, boundary) {
+    const matchingRoots = boundary.roots
+        .filter((root) => pathInside(path, root))
+        .map((root) => normalizeRepositoryPath(root).length);
+    return matchingRoots.length === 0 ? undefined : Math.max(...matchingRoots);
+}
+function selectBoundary(file, policy) {
+    const matches = [];
+    for (const boundary of policy.boundaries) {
+        const specificity = matchingBoundarySpecificity(file.path, boundary);
+        if (specificity !== undefined) {
+            matches.push({ boundary, specificity });
+        }
+    }
+    if (matches.length === 0) {
+        return undefined;
+    }
+    const highestSpecificity = Math.max(...matches.map((match) => match.specificity));
+    const mostSpecific = matches
+        .filter((match) => match.specificity === highestSpecificity)
+        .toSorted((left, right) => compareBinaryStrings(left.boundary.id, right.boundary.id));
+    if (policy.schemaVersion === 2 && mostSpecific.length > 1) {
+        const candidateIds = mostSpecific.map((match) => match.boundary.id).join(", ");
+        throw new CapabilityInputError({
+            code: "SOURCE_BOUNDARY_AMBIGUOUS",
+            message: `Source file matches multiple equally specific architecture boundaries: ${file.path} (${candidateIds}).`,
+            phase: "source-boundary-classification",
+            retryable: false
+        });
+    }
+    // Schema v1 did not reject ties. Retain its deterministic lexical fallback
+    // while still fixing the non-matching-root ranking bug for both versions.
+    return mostSpecific[0]?.boundary;
 }
 function containingPackage(path, packages) {
     return packages
@@ -17,22 +47,26 @@ function containingPackage(path, packages) {
         ? true
         : pathInside(path, workspacePackage.rootPath))
         .toSorted((left, right) => right.rootPath.length - left.rootPath.length ||
-        left.name.localeCompare(right.name))[0];
+        compareBinaryStrings(left.name, right.name))[0];
 }
 function classifyFiles(files, policy, packages, parser, signal) {
     const classified = [];
     for (const file of files) {
         assertNotCancelled(signal);
-        const boundary = deepestBoundary(file, policy.boundaries);
-        const workspacePackage = containingPackage(file.path, packages);
+        const normalizedFile = {
+            ...file,
+            path: normalizeRepositoryPath(file.path)
+        };
+        const boundary = selectBoundary(normalizedFile, policy);
+        const workspacePackage = containingPackage(normalizedFile.path, packages);
         if (boundary === undefined || workspacePackage === undefined) {
             continue;
         }
         classified.push({
-            ...file,
+            ...normalizedFile,
             boundary,
             workspacePackage,
-            parsed: parser.parse(file)
+            parsed: parser.parse(normalizedFile)
         });
     }
     return classified;
@@ -58,12 +92,16 @@ export async function analyzeSourceDependencies(input, dependencies) {
     ]);
     assertInventoryUsable(inventory.packages);
     const classifiedFiles = classifyFiles(sourceFiles, input.policy, inventory.packages, dependencies.parser, input.signal);
-    return evaluateSourceDependencies({
-        policy: input.policy,
+    const graph = buildObservedSourceGraph({
         inventory,
         allSourceFiles: sourceFiles,
         classifiedFiles,
-        resolver: dependencies.resolver
+        resolver: dependencies.resolver,
+        ...(input.signal === undefined ? {} : { signal: input.signal })
+    });
+    return evaluateSourceDependencies({
+        policy: input.policy,
+        graph
     });
 }
 //# sourceMappingURL=analyze-source-dependencies.js.map

package/dist/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-source-dependencies.js","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze-source-dependencies.js","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/source-dependencies/application/use-cases/build-observed-source-graph.d.ts

@@ -0,0 +1,17 @@
+import type { SourceFileSnapshot } from "../../../../source-inventory/application/model/source-file-snapshot.js";
+import type { WorkspaceInventory } from "../../../../workspace-inventory/application/model/workspace-inventory.js";
+import type { ClassifiedSourceFile, ObservedSourceGraph } from "../model/source-workspace.js";
+import type { SourceDependencyResolver } from "../ports/source-dependency-resolver.js";
+export interface BuildObservedSourceGraphInput {
+    readonly inventory: WorkspaceInventory;
+    readonly allSourceFiles: readonly SourceFileSnapshot[];
+    readonly classifiedFiles: readonly ClassifiedSourceFile[];
+    readonly resolver: SourceDependencyResolver;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Collects all static evidence once. Later policies only inspect this immutable
+ * graph and do not invoke the parser or resolver again.
+ */
+export declare function buildObservedSourceGraph(input: BuildObservedSourceGraphInput): ObservedSourceGraph;
+//# sourceMappingURL=build-observed-source-graph.d.ts.map

package/dist/capabilities/source-dependencies/application/use-cases/build-observed-source-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-observed-source-graph.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/use-cases/build-observed-source-graph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wEAAwE,CAAC;AACjH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0EAA0E,CAAC;AAInH,OAAO,KAAK,EACV,oBAAoB,EAGpB,mBAAmB,EAMpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAEvF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvD,QAAQ,CAAC,eAAe,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AA8JD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,mBAAmB,CA8GrB"}