@agent-teams/engineering-foundation 0.20.0 → 1.0.0

package/dist/capabilities/source-dependencies/adapters/outbound/node/pnpm-source-workspace-topology-inspector.js

@@ -0,0 +1,131 @@
+import { compareBinaryStrings } from "../../../../../binary-string-comparator.js";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+import { buildSelectedPackageSourceTopology, rootOutsideSelectedPackages, sourceWorkspaceDiscoveryLimits } from "./selected-package-source-discovery.js";
+import { readGovernedSourceFiles } from "./selected-package-source-snapshot-reader.js";
+import { capturePnpmSourceWorkspaceSnapshot } from "./pnpm-source-workspace-snapshot.js";
+import { createSourceWorkspaceFileSystem } from "./source-workspace-filesystem.js";
+import { inspectUniqueRoots, revalidateRoots } from "./source-workspace-root-snapshot.js";
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "source-workspace-topology",
+        retryable: false
+    });
+}
+function boundaryRootPaths(roots) {
+    return roots
+        .toSorted((left, right) => compareBinaryStrings(left.path, right.path) ||
+        compareBinaryStrings(left.boundaryId, right.boundaryId))
+        .map((root) => root.path);
+}
+export class PnpmSourceWorkspaceTopologyInspector {
+    #dependencies;
+    #fileSystem;
+    #limits;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+        this.#fileSystem = createSourceWorkspaceFileSystem(dependencies.fileSystem);
+        this.#limits = sourceWorkspaceDiscoveryLimits(dependencies.limits);
+    }
+    async inspect(input) {
+        const { canonicalConsumerRoot, configuredPackageRoots, consumerRootSnapshot, discovered, inventory, packageTypeScopes, selectedManifestPaths, selectedPackages } = await capturePnpmSourceWorkspaceSnapshot({
+            fileSystem: this.#fileSystem,
+            input,
+            inventoryReader: this.#dependencies.inventoryReader,
+            limits: this.#limits,
+            ...(this.#dependencies.hooks === undefined
+                ? {}
+                : { hooks: this.#dependencies.hooks }),
+            ...(this.#dependencies.workspaceManifestLoader === undefined
+                ? {}
+                : { workspaceManifestLoader: this.#dependencies.workspaceManifestLoader })
+        });
+        const outsideRoot = [
+            ...input.governedRoots,
+            ...input.boundaryRoots.map(({ path }) => path)
+        ]
+            .toSorted(compareBinaryStrings)
+            .find((root) => rootOutsideSelectedPackages(root, selectedPackages, selectedManifestPaths));
+        if (outsideRoot !== undefined) {
+            inputError("SOURCE_ROOT_OUTSIDE_WORKSPACE", `Governed or architecture boundary root is outside the schema v2 packageRoots contract: ${outsideRoot}.`);
+        }
+        const packageRoots = await inspectUniqueRoots({
+            canonicalConsumerRoot,
+            expectedKind: "directory",
+            label: "Workspace package roots",
+            operations: this.#fileSystem,
+            roots: selectedPackages.map((workspacePackage) => workspacePackage.rootPath),
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+        const governedRoots = await inspectUniqueRoots({
+            canonicalConsumerRoot,
+            expectedKind: "directory",
+            label: "Governed roots",
+            operations: this.#fileSystem,
+            roots: input.governedRoots,
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+        const boundaryRoots = await inspectUniqueRoots({
+            canonicalConsumerRoot,
+            expectedKind: "source",
+            label: "Architecture boundary roots",
+            operations: this.#fileSystem,
+            roots: boundaryRootPaths(input.boundaryRoots),
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+        const symbolicLink = discovered.symbolicLinkPaths[0];
+        if (symbolicLink !== undefined) {
+            inputError("SOURCE_SYMLINK_PROHIBITED", `Selected workspace source cannot contain symbolic links: ${symbolicLink}.`);
+        }
+        const packageRootIdentities = new Map(packageRoots.map((root) => [
+            root.repositoryPath,
+            Object.freeze({
+                device: String(root.canonicalMetadata.dev),
+                inode: String(root.canonicalMetadata.ino)
+            })
+        ]));
+        const packages = buildSelectedPackageSourceTopology(selectedPackages, discovered.sourcePaths, selectedManifestPaths).map((workspacePackage) => Object.freeze({
+            ...workspacePackage,
+            filesystemIdentity: packageRootIdentities.get(workspacePackage.rootPath) ??
+                inputError("SOURCE_FILESYSTEM_CHANGED", `Workspace package root identity is missing: ${workspacePackage.rootPath}.`)
+        }));
+        const unownedSourcePath = discovered.sourcePaths.find((path) => rootOutsideSelectedPackages(path, selectedPackages, selectedManifestPaths));
+        if (unownedSourcePath !== undefined) {
+            inputError("SOURCE_OUTSIDE_PACKAGE", `Source below a configured package root belongs to no package: ${unownedSourcePath}.`);
+        }
+        const selectedSourcePaths = packages
+            .flatMap((workspacePackage) => workspacePackage.sourcePaths)
+            .toSorted(compareBinaryStrings);
+        const sourceFiles = await readGovernedSourceFiles(canonicalConsumerRoot, selectedSourcePaths, input.governedRoots, {
+            fileSystem: this.#fileSystem,
+            limits: this.#limits,
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+        await revalidateRoots({
+            canonicalConsumerRoot,
+            operations: this.#fileSystem,
+            roots: [
+                consumerRootSnapshot,
+                ...discovered.directorySnapshots,
+                ...configuredPackageRoots,
+                ...packageRoots,
+                ...governedRoots,
+                ...boundaryRoots
+            ],
+            ...(input.signal === undefined ? {} : { signal: input.signal })
+        });
+        return Object.freeze({
+            canonicalConsumerRoot,
+            consumerRootIdentity: Object.freeze({
+                device: String(consumerRootSnapshot.canonicalMetadata.dev),
+                inode: String(consumerRootSnapshot.canonicalMetadata.ino)
+            }),
+            inventory,
+            packageTypeScopes,
+            packages,
+            sourceFiles
+        });
+    }
+}
+//# sourceMappingURL=pnpm-source-workspace-topology-inspector.js.map

package/dist/capabilities/source-dependencies/adapters/outbound/node/pnpm-source-workspace-topology-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-source-workspace-topology-inspector.js","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/pnpm-source-workspace-topology-inspector.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-discovery.d.ts

@@ -0,0 +1,31 @@
+import type { WorkspacePackage } from "../../../../../workspace-inventory/application/model/workspace-inventory.js";
+import type { SourceWorkspacePackageTopology } from "../../../application/model/source-workspace-topology.js";
+import { type SourceWorkspaceFileSystem, type StableRepositoryPath } from "./source-workspace-filesystem.js";
+export interface SourceWorkspaceDiscoveryLimits {
+    readonly maxDirectoryEntries: number;
+    readonly maxManifestFiles: number;
+    readonly maxSourceFileBytes: number;
+    readonly maxSourceFiles: number;
+    readonly maxTotalSourceBytes: number;
+}
+export interface SourceWorkspaceDiscoveryHooks {
+    readonly afterDirectoryRead?: (repositoryPath: string) => Promise<void> | void;
+}
+export interface DiscoveredSourceWorkspacePaths {
+    readonly directorySnapshots: readonly StableRepositoryPath[];
+    readonly manifestPaths: readonly string[];
+    readonly sourcePaths: readonly string[];
+    readonly symbolicLinkPaths: readonly string[];
+}
+export declare function sourceWorkspaceDiscoveryLimits(overrides?: Partial<SourceWorkspaceDiscoveryLimits> | undefined): SourceWorkspaceDiscoveryLimits;
+export declare function discoverSourceWorkspacePaths(canonicalConsumerRoot: string, options: {
+    readonly repositoryRoots: readonly string[];
+    readonly selectedPackageRoots?: readonly string[];
+    readonly fileSystem?: Partial<SourceWorkspaceFileSystem>;
+    readonly hooks?: SourceWorkspaceDiscoveryHooks;
+    readonly limits?: Partial<SourceWorkspaceDiscoveryLimits>;
+    readonly signal?: AbortSignal;
+}): Promise<DiscoveredSourceWorkspacePaths>;
+export declare function buildSelectedPackageSourceTopology(packages: readonly WorkspacePackage[], sourcePaths: readonly string[], allManifestPaths: readonly string[]): readonly Omit<SourceWorkspacePackageTopology, "filesystemIdentity">[];
+export declare function rootOutsideSelectedPackages(repositoryPath: string, packages: readonly WorkspacePackage[], allManifestPaths: readonly string[]): boolean;
+//# sourceMappingURL=selected-package-source-discovery.d.ts.map

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selected-package-source-discovery.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-discovery.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6EAA6E,CAAC;AAEpH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yDAAyD,CAAC;AAC9G,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAmB1C,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAUD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAgCD,wBAAgB,8BAA8B,CAC5C,SAAS,GAAE,OAAO,CAAC,8BAA8B,CAAC,GAAG,SAAc,GAClE,8BAA8B,CAahC;AAkKD,wBAAsB,4BAA4B,CAChD,qBAAqB,EAAE,MAAM,EAC7B,OAAO,EAAE;IACP,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,6BAA6B,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GACA,OAAO,CAAC,8BAA8B,CAAC,CAuGzC;AAkDD,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,SAAS,IAAI,CAAC,8BAA8B,EAAE,oBAAoB,CAAC,EAAE,CA+BvE;AAED,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,OAAO,CAQT"}

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-discovery.js

@@ -0,0 +1,298 @@
+import { join, posix } from "node:path";
+import { compareBinaryStrings } from "../../../../../binary-string-comparator.js";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+import { assertNotCancelled } from "../../../../../strict-yaml.js";
+import { portableRepositoryPathIdentity } from "../../../application/model/repository-path.js";
+import { assertSafeRepositoryPath, captureStableRepositoryPath, createSourceWorkspaceFileSystem, revalidateStableRepositoryPath } from "./source-workspace-filesystem.js";
+const SOURCE_EXTENSIONS = new Set([
+    ".cjs",
+    ".cts",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".mts",
+    ".ts",
+    ".tsx"
+]);
+const IGNORED_DIRECTORY_NAMES = new Set([
+    ".git",
+    "coverage",
+    "dist",
+    "node_modules"
+]);
+const DEFAULT_SOURCE_WORKSPACE_DISCOVERY_LIMITS = Object.freeze({
+    maxDirectoryEntries: 500_000,
+    maxManifestFiles: 5_000,
+    maxSourceFileBytes: 4 * 1024 * 1024,
+    maxSourceFiles: 100_000,
+    maxTotalSourceBytes: 512 * 1024 * 1024
+});
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "source-workspace-topology",
+        retryable: false
+    });
+}
+export function sourceWorkspaceDiscoveryLimits(overrides = {}) {
+    const limits = {
+        ...DEFAULT_SOURCE_WORKSPACE_DISCOVERY_LIMITS,
+        ...overrides
+    };
+    if (Object.values(limits).some((value) => !Number.isSafeInteger(value) || value < 1)) {
+        throw new TypeError("Source workspace discovery limits must be positive safe integers.");
+    }
+    return Object.freeze(limits);
+}
+function assertSafeDirectoryEntryName(name) {
+    if (name.length === 0 ||
+        name === "." ||
+        name === ".." ||
+        name.includes("/") ||
+        name.includes("\\")) {
+        inputError("SOURCE_DISCOVERY_PATH_INVALID", "Source workspace discovery produced an unsafe directory entry.");
+    }
+}
+function recordEntry(budget, limits) {
+    if (budget.entries >= limits.maxDirectoryEntries) {
+        inputError("SOURCE_DISCOVERY_LIMIT_EXCEEDED", `Selected workspace package discovery exceeds ${limits.maxDirectoryEntries} filesystem entries.`);
+    }
+    budget.entries += 1;
+}
+function recordPath(path, paths, kind, budget, limits) {
+    if (paths.has(path)) {
+        return;
+    }
+    const current = kind === "manifest" ? budget.manifests : budget.sourceFiles;
+    const maximum = kind === "manifest" ? limits.maxManifestFiles : limits.maxSourceFiles;
+    if (current >= maximum) {
+        inputError(kind === "manifest"
+            ? "WORKSPACE_LIMIT_EXCEEDED"
+            : "SOURCE_FILE_LIMIT_EXCEEDED", kind === "manifest"
+            ? `Workspace contains more than ${maximum} package manifests.`
+            : `Selected workspace packages contain more than ${maximum} source files.`);
+    }
+    paths.add(path);
+    if (kind === "manifest") {
+        budget.manifests += 1;
+    }
+    else {
+        budget.sourceFiles += 1;
+    }
+}
+async function readStableDirectoryEntries(input) {
+    const captured = await captureStableRepositoryPath(input.canonicalConsumerRoot, input.cursor.repositoryPath, "directory", input.operations, input.signal);
+    if (captured.traversesSymbolicLink) {
+        inputError("SOURCE_SYMLINK_PROHIBITED", `Selected workspace source cannot traverse symbolic links: ${input.cursor.repositoryPath}.`);
+    }
+    assertNotCancelled(input.signal);
+    let directory;
+    try {
+        directory = await input.operations.opendir(captured.absolutePath, input.signal);
+    }
+    catch {
+        assertNotCancelled(input.signal);
+        inputError("SOURCE_DIRECTORY_UNAVAILABLE", `Selected workspace source directory is unavailable: ${input.cursor.repositoryPath}.`);
+    }
+    const iterator = directory[Symbol.asyncIterator]();
+    const entries = [];
+    let completed = false;
+    try {
+        for (;;) {
+            assertNotCancelled(input.signal);
+            let result;
+            try {
+                result = await iterator.next();
+            }
+            catch {
+                assertNotCancelled(input.signal);
+                inputError("SOURCE_DIRECTORY_UNAVAILABLE", `Selected workspace source directory is unavailable: ${input.cursor.repositoryPath}.`);
+            }
+            assertNotCancelled(input.signal);
+            if (result.done === true) {
+                completed = true;
+                break;
+            }
+            recordEntry(input.budget, input.limits);
+            assertSafeDirectoryEntryName(result.value.name);
+            entries.push(result.value);
+        }
+    }
+    finally {
+        if (!completed && typeof iterator.return === "function") {
+            try {
+                await iterator.return();
+            }
+            catch {
+                // Preserve the cancellation, limit, or filesystem failure that stopped
+                // traversal rather than replacing it with iterator cleanup noise.
+            }
+        }
+    }
+    await input.hooks.afterDirectoryRead?.(input.cursor.repositoryPath);
+    await revalidateStableRepositoryPath(input.canonicalConsumerRoot, captured, input.operations, input.signal);
+    return {
+        captured,
+        entries: entries.toSorted((left, right) => compareBinaryStrings(left.name, right.name))
+    };
+}
+function childRepositoryPath(parent, name) {
+    return parent === "." ? name : posix.join(parent, name);
+}
+function assertPortablePaths(paths, kind) {
+    const identities = new Map();
+    for (const path of paths) {
+        const identity = portableRepositoryPathIdentity(path);
+        const existing = identities.get(identity);
+        if (existing !== undefined && existing !== path) {
+            inputError(kind.startsWith("source")
+                ? "SOURCE_PATH_CASE_COLLISION"
+                : "PACKAGE_PATH_CASE_COLLISION", `${kind} paths differ only by portable identity: ${existing} and ${path}.`);
+        }
+        identities.set(identity, path);
+    }
+}
+export async function discoverSourceWorkspacePaths(canonicalConsumerRoot, options) {
+    const operations = createSourceWorkspaceFileSystem(options.fileSystem);
+    const limits = sourceWorkspaceDiscoveryLimits(options.limits);
+    const hooks = options.hooks ?? {};
+    const budget = { entries: 0, manifests: 0, sourceFiles: 0 };
+    const manifestPaths = new Set();
+    const sourcePaths = new Set();
+    const symbolicLinkPaths = new Set();
+    const directorySnapshots = [];
+    const selectedPackageRootIdentities = new Set((options.selectedPackageRoots ?? []).map(portableRepositoryPathIdentity));
+    const isSelectedPackageRootOrAncestor = (repositoryPath) => {
+        const identity = portableRepositoryPathIdentity(repositoryPath);
+        return [...selectedPackageRootIdentities].some((selected) => selected === identity || selected.startsWith(`${identity}/`));
+    };
+    const directories = options.repositoryRoots
+        .toSorted(compareBinaryStrings)
+        .toReversed()
+        .map((repositoryPath) => {
+        assertSafeRepositoryPath(repositoryPath);
+        return {
+            absolutePath: repositoryPath === "."
+                ? canonicalConsumerRoot
+                : join(canonicalConsumerRoot, repositoryPath),
+            repositoryPath
+        };
+    });
+    while (directories.length > 0) {
+        assertNotCancelled(options.signal);
+        const cursor = directories.pop();
+        if (cursor === undefined) {
+            break;
+        }
+        const { captured, entries } = await readStableDirectoryEntries({
+            budget,
+            canonicalConsumerRoot,
+            cursor,
+            hooks,
+            limits,
+            operations,
+            ...(options.signal === undefined ? {} : { signal: options.signal })
+        });
+        directorySnapshots.push(captured);
+        const childDirectories = [];
+        for (const entry of entries) {
+            assertNotCancelled(options.signal);
+            const repositoryPath = childRepositoryPath(cursor.repositoryPath, entry.name);
+            if (IGNORED_DIRECTORY_NAMES.has(entry.name) &&
+                !isSelectedPackageRootOrAncestor(repositoryPath)) {
+                if (entry.name === "dist" && entry.isSymbolicLink()) {
+                    symbolicLinkPaths.add(repositoryPath);
+                }
+                continue;
+            }
+            assertSafeRepositoryPath(repositoryPath);
+            const absolutePath = join(cursor.absolutePath, entry.name);
+            if (entry.isSymbolicLink()) {
+                symbolicLinkPaths.add(repositoryPath);
+            }
+            else if (entry.isDirectory()) {
+                childDirectories.push({ absolutePath, repositoryPath });
+            }
+            else if (entry.isFile()) {
+                if (entry.name === "package.json") {
+                    recordPath(repositoryPath, manifestPaths, "manifest", budget, limits);
+                }
+                if (SOURCE_EXTENSIONS.has(posix.extname(entry.name))) {
+                    recordPath(repositoryPath, sourcePaths, "source", budget, limits);
+                }
+            }
+        }
+        directories.push(...childDirectories.toReversed());
+    }
+    const manifests = [...manifestPaths].toSorted(compareBinaryStrings);
+    const sources = [...sourcePaths].toSorted(compareBinaryStrings);
+    const symbolicLinks = [...symbolicLinkPaths].toSorted(compareBinaryStrings);
+    const directoryPaths = directorySnapshots.map(({ repositoryPath }) => repositoryPath);
+    assertPortablePaths(directoryPaths, "source directory");
+    assertPortablePaths(manifests, "Workspace package manifest");
+    assertPortablePaths(sources, "source");
+    assertPortablePaths(symbolicLinks, "source");
+    return Object.freeze({
+        directorySnapshots: Object.freeze(directorySnapshots),
+        manifestPaths: Object.freeze(manifests),
+        sourcePaths: Object.freeze(sources),
+        symbolicLinkPaths: Object.freeze(symbolicLinks)
+    });
+}
+function packageByPortableRoot(packages) {
+    const byRoot = new Map();
+    for (const workspacePackage of packages) {
+        const identity = portableRepositoryPathIdentity(workspacePackage.rootPath);
+        const existing = byRoot.get(identity);
+        if (existing !== undefined) {
+            inputError("WORKSPACE_PACKAGE_ROOT_DUPLICATE", `Workspace package roots share a portable identity: ${existing.rootPath} and ${workspacePackage.rootPath}.`);
+        }
+        byRoot.set(identity, workspacePackage);
+    }
+    return byRoot;
+}
+function packageRootIdentities(manifestPaths) {
+    return new Set(manifestPaths.map((manifestPath) => portableRepositoryPathIdentity(manifestPath === "package.json" ? "." : posix.dirname(manifestPath))));
+}
+function owningPackage(path, packagesByRoot, ownershipRoots) {
+    let candidate = portableRepositoryPathIdentity(path);
+    for (;;) {
+        if (ownershipRoots.has(candidate)) {
+            return packagesByRoot.get(candidate);
+        }
+        if (candidate === ".") {
+            return undefined;
+        }
+        const separator = candidate.lastIndexOf("/");
+        candidate = separator === -1 ? "." : candidate.slice(0, separator);
+    }
+}
+export function buildSelectedPackageSourceTopology(packages, sourcePaths, allManifestPaths) {
+    const packagesByRoot = packageByPortableRoot(packages);
+    const ownershipRoots = packageRootIdentities(allManifestPaths);
+    const pathsByRoot = new Map();
+    for (const workspacePackage of packages) {
+        pathsByRoot.set(portableRepositoryPathIdentity(workspacePackage.rootPath), []);
+    }
+    for (const path of sourcePaths) {
+        const workspacePackage = owningPackage(path, packagesByRoot, ownershipRoots);
+        if (workspacePackage !== undefined) {
+            pathsByRoot
+                .get(portableRepositoryPathIdentity(workspacePackage.rootPath))
+                ?.push(path);
+        }
+    }
+    return Object.freeze(packages
+        .toSorted((left, right) => compareBinaryStrings(left.rootPath, right.rootPath))
+        .map((workspacePackage) => Object.freeze({
+        manifestPath: workspacePackage.manifestPath,
+        name: workspacePackage.name,
+        rootPath: workspacePackage.rootPath,
+        sourcePaths: Object.freeze((pathsByRoot.get(portableRepositoryPathIdentity(workspacePackage.rootPath)) ?? []).toSorted(compareBinaryStrings))
+    })));
+}
+export function rootOutsideSelectedPackages(repositoryPath, packages, allManifestPaths) {
+    return (owningPackage(repositoryPath, packageByPortableRoot(packages), packageRootIdentities(allManifestPaths)) === undefined);
+}
+//# sourceMappingURL=selected-package-source-discovery.js.map

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selected-package-source-discovery.js","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-discovery.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-snapshot-reader.d.ts

@@ -0,0 +1,9 @@
+import type { SourceFileSnapshot } from "../../../../../source-inventory/application/model/source-file-snapshot.js";
+import { type SourceWorkspaceDiscoveryLimits } from "./selected-package-source-discovery.js";
+import { type SourceWorkspaceFileSystem } from "./source-workspace-filesystem.js";
+export declare function readGovernedSourceFiles(canonicalConsumerRoot: string, sourcePaths: readonly string[], governedRoots: readonly string[], options?: {
+    readonly fileSystem?: Partial<SourceWorkspaceFileSystem>;
+    readonly limits?: Partial<SourceWorkspaceDiscoveryLimits>;
+    readonly signal?: AbortSignal;
+}): Promise<readonly SourceFileSnapshot[]>;
+//# sourceMappingURL=selected-package-source-snapshot-reader.d.ts.map

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-snapshot-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selected-package-source-snapshot-reader.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-snapshot-reader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2EAA2E,CAAC;AAEpH,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAuC1C,wBAAsB,uBAAuB,CAC3C,qBAAqB,EAAE,MAAM,EAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,OAAO,GAAE;IACP,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC1B,GACL,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAsCxC"}

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-snapshot-reader.js

@@ -0,0 +1,67 @@
+import { resolve } from "node:path";
+import { compareBinaryStrings } from "../../../../../binary-string-comparator.js";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+import { ContainedFileReadError } from "../../../../../filesystem-path-safety.js";
+import { assertNotCancelled } from "../../../../../strict-yaml.js";
+import { portablePathIsInside } from "../../../application/model/repository-path.js";
+import { sourceWorkspaceDiscoveryLimits } from "./selected-package-source-discovery.js";
+import { assertSafeRepositoryPath, createSourceWorkspaceFileSystem } from "./source-workspace-filesystem.js";
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "source-workspace-topology",
+        retryable: false
+    });
+}
+function sourceReadError(path, error) {
+    if (error.failure === "escape") {
+        inputError("SOURCE_DIRECTORY_ESCAPE", `Source file escapes the consumer repository: ${path}.`);
+    }
+    if (error.failure === "symlink") {
+        inputError("SOURCE_SYMLINK_PROHIBITED", `Selected workspace source cannot contain symbolic links: ${path}.`);
+    }
+    if (error.failure === "changed") {
+        inputError("SOURCE_FILESYSTEM_CHANGED", `Source file changed while it was read: ${path}.`);
+    }
+    if (error.failure === "invalid") {
+        inputError("SOURCE_FILE_INVALID", `Source file is not a regular file within the supported size limit: ${path}.`);
+    }
+    inputError("SOURCE_FILE_UNAVAILABLE", `Source file is unavailable: ${path}.`);
+}
+export async function readGovernedSourceFiles(canonicalConsumerRoot, sourcePaths, governedRoots, options = {}) {
+    const operations = createSourceWorkspaceFileSystem(options.fileSystem);
+    const limits = sourceWorkspaceDiscoveryLimits(options.limits);
+    const selectedPaths = sourcePaths
+        .filter((path) => governedRoots.some((root) => portablePathIsInside(path, root)))
+        .toSorted(compareBinaryStrings);
+    const snapshots = [];
+    let totalBytes = 0;
+    for (const path of selectedPaths) {
+        assertNotCancelled(options.signal);
+        assertSafeRepositoryPath(path);
+        const candidate = resolve(canonicalConsumerRoot, path);
+        let bytes;
+        try {
+            bytes = await operations.readContainedFile({
+                candidate,
+                maxBytes: limits.maxSourceFileBytes,
+                root: canonicalConsumerRoot
+            });
+        }
+        catch (error) {
+            if (error instanceof ContainedFileReadError) {
+                sourceReadError(path, error);
+            }
+            throw error;
+        }
+        assertNotCancelled(options.signal);
+        if (totalBytes > limits.maxTotalSourceBytes - bytes.length) {
+            inputError("SOURCE_TOTAL_BYTES_EXCEEDED", `Selected workspace sources exceed ${limits.maxTotalSourceBytes} total bytes.`);
+        }
+        totalBytes += bytes.length;
+        snapshots.push(Object.freeze({ path, source: bytes.toString("utf8") }));
+    }
+    return Object.freeze(snapshots);
+}
+//# sourceMappingURL=selected-package-source-snapshot-reader.js.map

package/dist/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-snapshot-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selected-package-source-snapshot-reader.js","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/selected-package-source-snapshot-reader.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/source-dependencies/adapters/outbound/node/source-workspace-filesystem.d.ts

@@ -0,0 +1,38 @@
+import type { Dirent } from "node:fs";
+interface SourceFilesystemMetadata {
+    readonly ctimeMs: bigint | number;
+    readonly dev: bigint | number;
+    readonly ino: bigint | number;
+    readonly mode: bigint | number;
+    readonly mtimeMs: bigint | number;
+    readonly size: bigint | number;
+    isDirectory(): boolean;
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+}
+interface SourceDirectory extends AsyncIterable<Dirent> {
+}
+export interface SourceWorkspaceFileSystem {
+    lstat(path: string): Promise<SourceFilesystemMetadata>;
+    opendir(path: string, signal?: AbortSignal): Promise<SourceDirectory>;
+    realpath(path: string): Promise<string>;
+    readContainedFile(input: {
+        readonly candidate: string;
+        readonly maxBytes: number;
+        readonly root: string;
+    }): Promise<Buffer>;
+    stat(path: string): Promise<SourceFilesystemMetadata>;
+}
+export interface StableRepositoryPath {
+    readonly absolutePath: string;
+    readonly canonicalMetadata: SourceFilesystemMetadata;
+    readonly lexicalMetadata: SourceFilesystemMetadata;
+    readonly repositoryPath: string;
+    readonly traversesSymbolicLink: boolean;
+}
+export declare function createSourceWorkspaceFileSystem(overrides?: Partial<SourceWorkspaceFileSystem> | undefined): SourceWorkspaceFileSystem;
+export declare function assertSafeRepositoryPath(repositoryPath: string): void;
+export declare function captureStableRepositoryPath(canonicalConsumerRoot: string, repositoryPath: string, expectedKind: "directory" | "source", operations: SourceWorkspaceFileSystem, signal?: AbortSignal): Promise<StableRepositoryPath>;
+export declare function revalidateStableRepositoryPath(canonicalConsumerRoot: string, captured: StableRepositoryPath, operations: SourceWorkspaceFileSystem, signal?: AbortSignal): Promise<void>;
+export {};
+//# sourceMappingURL=source-workspace-filesystem.d.ts.map

package/dist/capabilities/source-dependencies/adapters/outbound/node/source-workspace-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-workspace-filesystem.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/source-workspace-filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAgBtC,UAAU,wBAAwB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;IAClB,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED,UAAU,eAAgB,SAAQ,aAAa,CAAC,MAAM,CAAC;CAAG;AAE1D,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,iBAAiB,CAAC,KAAK,EAAE;QACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAWD,wBAAgB,+BAA+B,CAC7C,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,SAAc,GAC7D,yBAAyB,CAS3B;AAUD,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOrE;AAuDD,wBAAsB,2BAA2B,CAC/C,qBAAqB,EAAE,MAAM,EAC7B,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,WAAW,GAAG,QAAQ,EACpC,UAAU,EAAE,yBAAyB,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CA4E/B;AAED,wBAAsB,8BAA8B,CAClD,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,EAAE,yBAAyB,EACrC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAmCf"}