@agent-teams/engineering-foundation 0.2.1 → 0.4.0

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

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

package/dist/capabilities/source-dependencies/application/model/source-workspace.js

@@ -0,0 +1,13 @@
+const SOURCE_DEPENDENCY_KINDS = [
+    "commonjs",
+    "dynamic",
+    "export",
+    "export-type",
+    "import-equals",
+    "import-equals-type",
+    "static",
+    "static-type",
+    "type-query"
+];
+export {};
+//# sourceMappingURL=source-workspace.js.map

package/dist/capabilities/source-dependencies/application/model/source-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-workspace.js","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/model/source-workspace.ts"],"names":[],"mappings":"AAGA,MAAM,uBAAuB,GAAG;IAC9B,UAAU;IACV,SAAS;IACT,QAAQ;IACR,aAAa;IACb,eAAe;IACf,oBAAoB;IACpB,QAAQ;IACR,aAAa;IACb,YAAY;CACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { FoundationDiagnostic } from "../../../../check-contract.js";
+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, SourceArchitecturePolicy } from "../model/source-workspace.js";
+import type { SourceDependencyResolver } from "../ports/source-dependency-resolver.js";
+interface EvaluationInput {
+    readonly policy: SourceArchitecturePolicy;
+    readonly inventory: WorkspaceInventory;
+    readonly allSourceFiles: readonly SourceFileSnapshot[];
+    readonly classifiedFiles: readonly ClassifiedSourceFile[];
+    readonly resolver: SourceDependencyResolver;
+}
+export declare function evaluateSourceDependencies(input: EvaluationInput): readonly FoundationDiagnostic[];
+export {};
+//# sourceMappingURL=evaluate-source-dependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-source-dependencies.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/policies/evaluate-source-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wEAAwE,CAAC;AACjH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0EAA0E,CAAC;AACnH,OAAO,KAAK,EAEV,oBAAoB,EAEpB,wBAAwB,EAEzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAMvF,UAAU,eAAe;IACvB,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,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;CAC7C;AAqMD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,eAAe,GACrB,SAAS,oBAAoB,EAAE,CAiEjC"}

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

@@ -0,0 +1,223 @@
+import { SOURCE_DEPENDENCY_RULES } from "../rules.js";
+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 === undefined ? [] : [{ path: input.relatedPath }],
+        evidence: input.evidence ?? [],
+        remediation: input.rule.remediation,
+        requiresArchitectureReview: input.rule.requiresArchitectureReview
+    };
+}
+function boundaryForPath(path, files) {
+    return files.find((file) => file.path === path)?.boundary;
+}
+function declarationDiagnostics(input) {
+    if (input.declaration === "runtime") {
+        return [];
+    }
+    const rule = input.declaration === "development"
+        ? SOURCE_DEPENDENCY_RULES.runtimeImportFromDevelopmentDependency
+        : input.workspace
+            ? SOURCE_DEPENDENCY_RULES.undeclaredWorkspaceDependency
+            : SOURCE_DEPENDENCY_RULES.undeclaredExternalDependency;
+    return [
+        diagnostic({
+            rule,
+            subject: `${input.file.workspacePackage.name}->${input.packageName}`,
+            message: input.declaration === "development"
+                ? `Runtime source imports development-only dependency ${input.packageName}.`
+                : `Runtime source imports undeclared dependency ${input.packageName}.`,
+            path: input.file.path,
+            relatedPath: input.file.workspacePackage.manifestPath,
+            evidence: [{ kind: "specifier", value: input.reference.specifier }]
+        })
+    ];
+}
+function evaluateResolved(input) {
+    const { file, reference, resolved } = input;
+    switch (resolved.kind) {
+        case "builtin":
+            return file.boundary.allowedBuiltins.includes(resolved.specifier)
+                ? []
+                : [
+                    diagnostic({
+                        rule: SOURCE_DEPENDENCY_RULES.forbiddenBuiltinDependency,
+                        subject: `${file.boundary.id}->${resolved.specifier}`,
+                        message: `Boundary ${file.boundary.id} cannot import ${resolved.specifier}.`,
+                        path: file.path,
+                        evidence: [{ kind: "specifier", value: reference.specifier }]
+                    })
+                ];
+        case "external-package":
+            return [
+                ...(file.boundary.allowedPackages.includes(resolved.packageName)
+                    ? []
+                    : [
+                        diagnostic({
+                            rule: SOURCE_DEPENDENCY_RULES.forbiddenPackageDependency,
+                            subject: `${file.boundary.id}->${resolved.packageName}`,
+                            message: `Boundary ${file.boundary.id} cannot import package ${resolved.packageName}.`,
+                            path: file.path,
+                            evidence: [{ kind: "specifier", value: reference.specifier }]
+                        })
+                    ]),
+                ...declarationDiagnostics({
+                    file,
+                    reference,
+                    packageName: resolved.packageName,
+                    declaration: resolved.declaration,
+                    workspace: false
+                })
+            ];
+        case "local-file": {
+            if (resolved.workspacePackage.name !== file.workspacePackage.name) {
+                return [
+                    diagnostic({
+                        rule: SOURCE_DEPENDENCY_RULES.crossPackageRelativeImport,
+                        subject: `${file.workspacePackage.name}->${resolved.workspacePackage.name}`,
+                        message: `Relative import crosses from ${file.workspacePackage.name} into ${resolved.workspacePackage.name}.`,
+                        path: file.path,
+                        relatedPath: resolved.path,
+                        evidence: [{ kind: "specifier", value: reference.specifier }]
+                    })
+                ];
+            }
+            const targetBoundary = boundaryForPath(resolved.path, input.classifiedFiles);
+            if (targetBoundary === undefined ||
+                targetBoundary.id === file.boundary.id ||
+                file.boundary.allowedBoundaries.includes(targetBoundary.id)) {
+                return [];
+            }
+            return [
+                diagnostic({
+                    rule: SOURCE_DEPENDENCY_RULES.forbiddenBoundaryDependency,
+                    subject: `${file.boundary.id}->${targetBoundary.id}`,
+                    message: `Boundary dependency is not allowed: ${file.boundary.id} -> ${targetBoundary.id}.`,
+                    path: file.path,
+                    relatedPath: resolved.path,
+                    evidence: [{ kind: "specifier", value: reference.specifier }]
+                })
+            ];
+        }
+        case "unsupported":
+            return [
+                diagnostic({
+                    rule: SOURCE_DEPENDENCY_RULES.unsupportedImportSpecifier,
+                    subject: `${file.path}:${reference.specifier}`,
+                    message: `Import specifier cannot be classified: ${resolved.reason}.`,
+                    path: file.path,
+                    evidence: [{ kind: "specifier", value: reference.specifier }]
+                })
+            ];
+        case "unresolved":
+            return [
+                diagnostic({
+                    rule: SOURCE_DEPENDENCY_RULES.unresolvedLocalImport,
+                    subject: `${file.path}:${reference.specifier}`,
+                    message: `Import could not be resolved: ${resolved.reason}.`,
+                    path: file.path,
+                    evidence: [{ kind: "specifier", value: reference.specifier }]
+                })
+            ];
+        case "workspace-package":
+            return [
+                ...(resolved.workspacePackage.name === file.workspacePackage.name ||
+                    file.boundary.allowedPackages.includes(resolved.workspacePackage.name)
+                    ? []
+                    : [
+                        diagnostic({
+                            rule: SOURCE_DEPENDENCY_RULES.forbiddenPackageDependency,
+                            subject: `${file.boundary.id}->${resolved.workspacePackage.name}`,
+                            message: `Boundary ${file.boundary.id} cannot import workspace package ${resolved.workspacePackage.name}.`,
+                            path: file.path,
+                            relatedPath: resolved.workspacePackage.manifestPath,
+                            evidence: [{ kind: "specifier", value: reference.specifier }]
+                        })
+                    ]),
+                ...(resolved.workspacePackage.name === file.workspacePackage.name
+                    ? []
+                    : declarationDiagnostics({
+                        file,
+                        reference,
+                        packageName: resolved.workspacePackage.name,
+                        declaration: resolved.declaration,
+                        workspace: true
+                    })),
+                ...(resolved.exported
+                    ? []
+                    : [
+                        diagnostic({
+                            rule: SOURCE_DEPENDENCY_RULES.packageSubpathNotExported,
+                            subject: `${resolved.workspacePackage.name}:${resolved.subpath}`,
+                            message: `Workspace package subpath is not exported: ${reference.specifier}.`,
+                            path: file.path,
+                            relatedPath: resolved.workspacePackage.manifestPath,
+                            evidence: [{ kind: "subpath", value: resolved.subpath }]
+                        })
+                    ])
+            ];
+    }
+}
+export function evaluateSourceDependencies(input) {
+    const diagnostics = [];
+    const classifiedPaths = new Set(input.classifiedFiles.map((file) => file.path));
+    const governedFilePaths = new Set(input.allSourceFiles.map((file) => file.path));
+    for (const sourceFile of input.allSourceFiles) {
+        if (!classifiedPaths.has(sourceFile.path)) {
+            diagnostics.push(diagnostic({
+                rule: SOURCE_DEPENDENCY_RULES.unclassifiedSourceFile,
+                subject: sourceFile.path,
+                message: "Governed source file does not belong to an architecture boundary.",
+                path: sourceFile.path
+            }));
+        }
+    }
+    for (const file of input.classifiedFiles) {
+        if (file.parsed.parseErrorCount > 0) {
+            diagnostics.push(diagnostic({
+                rule: SOURCE_DEPENDENCY_RULES.sourceParseError,
+                subject: file.path,
+                message: `Source parser reported ${file.parsed.parseErrorCount} error(s).`,
+                path: file.path,
+                evidence: [
+                    { kind: "parse-error-count", value: String(file.parsed.parseErrorCount) }
+                ]
+            }));
+            continue;
+        }
+        for (const unresolvedReference of file.parsed.unresolved) {
+            if (file.boundary.allowedRuntimeReferences.includes(unresolvedReference.kind)) {
+                continue;
+            }
+            diagnostics.push(diagnostic({
+                rule: SOURCE_DEPENDENCY_RULES.unresolvedRuntimeReference,
+                subject: `${file.path}:${unresolvedReference.kind}:${unresolvedReference.start}`,
+                message: `Non-literal ${unresolvedReference.kind} reference hides a dependency edge.`,
+                path: file.path,
+                evidence: [
+                    { kind: "reference-kind", value: unresolvedReference.kind },
+                    { kind: "offset", value: String(unresolvedReference.start) }
+                ]
+            }));
+        }
+        for (const reference of file.parsed.references) {
+            diagnostics.push(...evaluateResolved({
+                file,
+                reference,
+                resolved: input.resolver.resolve({
+                    file,
+                    governedFilePaths,
+                    inventory: input.inventory,
+                    reference
+                }),
+                classifiedFiles: input.classifiedFiles
+            }));
+        }
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=evaluate-source-dependencies.js.map

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

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

package/dist/capabilities/source-dependencies/application/ports/source-dependency-parser.d.ts

@@ -0,0 +1,6 @@
+import type { SourceFileSnapshot } from "../../../../source-inventory/application/model/source-file-snapshot.js";
+import type { ParsedSourceDependencies } from "../model/source-workspace.js";
+export interface SourceDependencyParser {
+    parse(file: SourceFileSnapshot): ParsedSourceDependencies;
+}
+//# sourceMappingURL=source-dependency-parser.d.ts.map

package/dist/capabilities/source-dependencies/application/ports/source-dependency-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-dependency-parser.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/ports/source-dependency-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wEAAwE,CAAC;AACjH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE7E,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,wBAAwB,CAAC;CAC3D"}

package/dist/capabilities/source-dependencies/application/ports/source-dependency-parser.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-dependency-parser.js.map

package/dist/capabilities/source-dependencies/application/ports/source-dependency-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-dependency-parser.js","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/ports/source-dependency-parser.ts"],"names":[],"mappings":""}

package/dist/capabilities/source-dependencies/application/ports/source-dependency-resolver.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceInventory } from "../../../../workspace-inventory/application/model/workspace-inventory.js";
+import type { ClassifiedSourceFile, ResolvedSourceDependency, SourceDependencyReference } from "../model/source-workspace.js";
+export interface ResolveSourceDependencyInput {
+    readonly file: ClassifiedSourceFile;
+    readonly governedFilePaths: ReadonlySet<string>;
+    readonly inventory: WorkspaceInventory;
+    readonly reference: SourceDependencyReference;
+}
+export interface SourceDependencyResolver {
+    resolve(input: ResolveSourceDependencyInput): ResolvedSourceDependency;
+}
+//# sourceMappingURL=source-dependency-resolver.d.ts.map

package/dist/capabilities/source-dependencies/application/ports/source-dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-dependency-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/ports/source-dependency-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0EAA0E,CAAC;AACnH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,KAAK,EAAE,4BAA4B,GAAG,wBAAwB,CAAC;CACxE"}

package/dist/capabilities/source-dependencies/application/ports/source-dependency-resolver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-dependency-resolver.js.map

package/dist/capabilities/source-dependencies/application/ports/source-dependency-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-dependency-resolver.js","sourceRoot":"","sources":["../../../../../src/capabilities/source-dependencies/application/ports/source-dependency-resolver.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,26 @@
+import type { DiagnosticSeverity } from "../../../check-contract.js";
+export interface SourceDependencyRuleMetadata {
+    readonly id: string;
+    readonly severity: DiagnosticSeverity;
+    readonly rationale: string;
+    readonly remediation: string;
+    readonly documentation: string;
+    readonly requiresArchitectureReview: boolean;
+}
+export declare const SOURCE_DEPENDENCY_RULES: Readonly<{
+    crossPackageRelativeImport: SourceDependencyRuleMetadata;
+    forbiddenBoundaryDependency: SourceDependencyRuleMetadata;
+    forbiddenBuiltinDependency: SourceDependencyRuleMetadata;
+    forbiddenPackageDependency: SourceDependencyRuleMetadata;
+    packageSubpathNotExported: SourceDependencyRuleMetadata;
+    sourceParseError: SourceDependencyRuleMetadata;
+    undeclaredExternalDependency: SourceDependencyRuleMetadata;
+    undeclaredWorkspaceDependency: SourceDependencyRuleMetadata;
+    unresolvedLocalImport: SourceDependencyRuleMetadata;
+    unresolvedRuntimeReference: SourceDependencyRuleMetadata;
+    runtimeImportFromDevelopmentDependency: SourceDependencyRuleMetadata;
+    unsupportedImportSpecifier: SourceDependencyRuleMetadata;
+    unclassifiedSourceFile: SourceDependencyRuleMetadata;
+}>;
+export declare const SOURCE_DEPENDENCY_RULES_BY_ID: ReadonlyMap<string, SourceDependencyRuleMetadata>;
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,27 @@
+function rule(suffix, rationale, remediation, requiresArchitectureReview = false) {
+    return Object.freeze({
+        id: `architecture.source-dependencies.${suffix}`,
+        severity: "error",
+        rationale,
+        remediation,
+        documentation: "docs/architecture/executable-capabilities.md#architecturesource-dependencies",
+        requiresArchitectureReview
+    });
+}
+export const SOURCE_DEPENDENCY_RULES = Object.freeze({
+    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),
+    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),
+    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."),
+    undeclaredWorkspaceDependency: rule("undeclared-workspace-dependency", "An allowed architecture edge still requires an explicit package dependency.", "Declare the workspace package with the package manager workspace protocol."),
+    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."),
+    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)
+});
+export const SOURCE_DEPENDENCY_RULES_BY_ID = new Map(Object.values(SOURCE_DEPENDENCY_RULES).map((metadata) => [metadata.id, metadata]));
+//# sourceMappingURL=rules.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,19 @@
+import type { FoundationDiagnostic } from "../../../../check-contract.js";
+import type { SourceTreeReader } from "../../../../source-inventory/application/ports/source-tree-reader.js";
+import type { WorkspaceInventoryReader } from "../../../../workspace-inventory/application/ports/workspace-inventory-reader.js";
+import type { SourceArchitecturePolicy } from "../model/source-workspace.js";
+import type { SourceDependencyParser } from "../ports/source-dependency-parser.js";
+import type { SourceDependencyResolver } from "../ports/source-dependency-resolver.js";
+export interface AnalyzeSourceDependenciesInput {
+    readonly consumerRoot: string;
+    readonly policy: SourceArchitecturePolicy;
+    readonly signal?: AbortSignal;
+}
+export interface AnalyzeSourceDependenciesDependencies {
+    readonly inventoryReader: WorkspaceInventoryReader;
+    readonly parser: SourceDependencyParser;
+    readonly resolver: SourceDependencyResolver;
+    readonly sourceReader: SourceTreeReader;
+}
+export declare function analyzeSourceDependencies(input: AnalyzeSourceDependenciesInput, dependencies: AnalyzeSourceDependenciesDependencies): Promise<readonly FoundationDiagnostic[]>;
+//# sourceMappingURL=analyze-source-dependencies.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,69 @@
+import { CapabilityInputError } from "../../../../capability-runtime.js";
+import { assertNotCancelled } from "../../../../strict-yaml.js";
+import { evaluateSourceDependencies } from "../policies/evaluate-source-dependencies.js";
+function pathInside(path, root) {
+    return path === root || path.startsWith(`${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 containingPackage(path, packages) {
+    return packages
+        .filter((workspacePackage) => workspacePackage.rootPath === "."
+        ? true
+        : pathInside(path, workspacePackage.rootPath))
+        .toSorted((left, right) => right.rootPath.length - left.rootPath.length ||
+        left.name.localeCompare(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);
+        if (boundary === undefined || workspacePackage === undefined) {
+            continue;
+        }
+        classified.push({
+            ...file,
+            boundary,
+            workspacePackage,
+            parsed: parser.parse(file)
+        });
+    }
+    return classified;
+}
+function assertInventoryUsable(packages) {
+    const names = new Set();
+    for (const workspacePackage of packages) {
+        if (workspacePackage.name.startsWith("<unnamed:") || names.has(workspacePackage.name)) {
+            throw new CapabilityInputError({
+                code: "WORKSPACE_IDENTITY_INVALID",
+                message: "Source architecture requires unique named workspace packages.",
+                phase: "source-workspace-inventory",
+                retryable: false
+            });
+        }
+        names.add(workspacePackage.name);
+    }
+}
+export async function analyzeSourceDependencies(input, dependencies) {
+    const [inventory, sourceFiles] = await Promise.all([
+        dependencies.inventoryReader.read(input.consumerRoot, input.policy.workspaceManifestPath, input.signal),
+        dependencies.sourceReader.read(input.consumerRoot, input.policy.governedRoots, input.signal)
+    ]);
+    assertInventoryUsable(inventory.packages);
+    const classifiedFiles = classifyFiles(sourceFiles, input.policy, inventory.packages, dependencies.parser, input.signal);
+    return evaluateSourceDependencies({
+        policy: input.policy,
+        inventory,
+        allSourceFiles: sourceFiles,
+        classifiedFiles,
+        resolver: dependencies.resolver
+    });
+}
+//# sourceMappingURL=analyze-source-dependencies.js.map

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

@@ -0,0 +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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"}

package/dist/capabilities/source-dependencies/contract/config.d.ts

@@ -0,0 +1,5 @@
+import type { SourceArchitecturePolicy } from "../application/model/source-workspace.js";
+export declare const CAPABILITY_ID: "architecture.source-dependencies";
+export declare const CAPABILITY_CONFIG_SCHEMA_VERSION: 1;
+export declare function loadCapabilityConfig(consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<SourceArchitecturePolicy>;
+//# sourceMappingURL=config.d.ts.map

package/dist/capabilities/source-dependencies/contract/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/source-dependencies/contract/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,wBAAwB,EACzB,MAAM,0CAA0C,CAAC;AAElD,eAAO,MAAM,aAAa,EAAG,kCAA2C,CAAC;AACzE,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAuG3D,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CA4BnC"}

package/dist/capabilities/source-dependencies/contract/config.js

@@ -0,0 +1,108 @@
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { loadStrictYamlFile } from "../../../strict-yaml.js";
+export const CAPABILITY_ID = "architecture.source-dependencies";
+export const CAPABILITY_CONFIG_SCHEMA_VERSION = 1;
+function inputError(message) {
+    throw new CapabilityInputError({
+        code: "SOURCE_ARCHITECTURE_CONFIG_INVALID",
+        message,
+        phase: "source-architecture-config",
+        retryable: false
+    });
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function record(value, field) {
+    if (!isRecord(value)) {
+        inputError(`${field} must be an object.`);
+    }
+    return value;
+}
+function strings(value, field) {
+    if (!Array.isArray(value)) {
+        inputError(`${field} must be an array of strings.`);
+    }
+    const output = [];
+    for (const entry of value) {
+        if (typeof entry !== "string") {
+            inputError(`${field} must be an array of strings.`);
+        }
+        output.push(entry);
+    }
+    return output;
+}
+function string(value, field) {
+    if (typeof value !== "string") {
+        inputError(`${field} must be a string.`);
+    }
+    return value;
+}
+function pathInside(path, root) {
+    return path === root || path.startsWith(`${root}/`);
+}
+function validatePolicy(policy) {
+    const boundaryIds = new Set();
+    const boundaryRoots = new Set();
+    for (const boundary of policy.boundaries) {
+        if (boundaryIds.has(boundary.id)) {
+            inputError(`Architecture boundary ID is duplicated: ${boundary.id}.`);
+        }
+        boundaryIds.add(boundary.id);
+        for (const root of boundary.roots) {
+            if (boundaryRoots.has(root)) {
+                inputError(`Architecture boundary root is duplicated: ${root}.`);
+            }
+            if (!policy.governedRoots.some((governedRoot) => pathInside(root, governedRoot))) {
+                inputError(`Architecture boundary root is outside governed roots: ${root}.`);
+            }
+            boundaryRoots.add(root);
+        }
+    }
+    for (const boundary of policy.boundaries) {
+        for (const target of boundary.allowedBoundaries) {
+            if (target === boundary.id || !boundaryIds.has(target)) {
+                inputError(`Boundary edge must target another declared boundary: ${boundary.id} -> ${target}.`);
+            }
+        }
+    }
+    for (const governedRoot of policy.governedRoots) {
+        if (![...boundaryRoots].some((root) => pathInside(root, governedRoot))) {
+            inputError(`Governed root has no architecture boundary: ${governedRoot}.`);
+        }
+    }
+}
+function mapBoundary(value, index) {
+    const boundary = record(value, `boundaries[${index}]`);
+    const allow = record(boundary["allow"], `boundaries[${index}].allow`);
+    return Object.freeze({
+        id: string(boundary["id"], `boundaries[${index}].id`),
+        roots: Object.freeze(strings(boundary["roots"], `boundaries[${index}].roots`)),
+        allowedBoundaries: Object.freeze(strings(allow["boundaries"], `boundaries[${index}].allow.boundaries`)),
+        allowedPackages: Object.freeze(strings(allow["packages"], `boundaries[${index}].allow.packages`)),
+        allowedBuiltins: Object.freeze(strings(allow["builtins"], `boundaries[${index}].allow.builtins`)),
+        allowedRuntimeReferences: Object.freeze(strings(allow["runtimeReferences"], `boundaries[${index}].allow.runtimeReferences`))
+    });
+}
+export async function loadCapabilityConfig(consumerRoot, configPath, signal) {
+    const input = await loadStrictYamlFile(consumerRoot, configPath, "source-architecture-config", signal);
+    await assertSchema("architecture-source-dependencies/v1", input, "source-architecture-config");
+    const root = record(input, "source architecture config");
+    const workspace = record(root["workspace"], "workspace");
+    const boundaryInput = root["boundaries"];
+    if (!Array.isArray(boundaryInput)) {
+        inputError("boundaries must be an array.");
+    }
+    if (workspace["kind"] !== "pnpm" || workspace["manifest"] !== "pnpm-workspace.yaml") {
+        inputError("workspace must select pnpm-workspace.yaml.");
+    }
+    const policy = Object.freeze({
+        workspaceManifestPath: "pnpm-workspace.yaml",
+        governedRoots: Object.freeze(strings(root["governedRoots"], "governedRoots")),
+        boundaries: Object.freeze(boundaryInput.map(mapBoundary))
+    });
+    validatePolicy(policy);
+    return policy;
+}
+//# sourceMappingURL=config.js.map