@agent-teams/engineering-foundation 0.21.0 → 1.0.0

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"}

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

@@ -0,0 +1,139 @@
+import { lstat as nodeLstat, opendir as nodeOpendir, realpath as nodeRealpath, stat as nodeStat } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { CapabilityInputError } from "../../../../../capability-runtime.js";
+import { readContainedRegularFile } from "../../../../../filesystem-path-safety.js";
+import { assertNotCancelled } from "../../../../../strict-yaml.js";
+import { portableRepositoryPathProblem } from "../../../application/model/repository-path.js";
+function inputError(code, message) {
+    throw new CapabilityInputError({
+        code,
+        message,
+        phase: "source-workspace-topology",
+        retryable: false
+    });
+}
+export function createSourceWorkspaceFileSystem(overrides = {}) {
+    const defaults = {
+        lstat: (path) => nodeLstat(path, { bigint: true }),
+        opendir: (path) => nodeOpendir(path),
+        realpath: (path) => nodeRealpath(path),
+        readContainedFile: readContainedRegularFile,
+        stat: (path) => nodeStat(path, { bigint: true })
+    };
+    return { ...defaults, ...overrides };
+}
+function pathIsContained(parent, candidate) {
+    const relation = relative(parent, candidate);
+    return (relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`)));
+}
+export function assertSafeRepositoryPath(repositoryPath) {
+    if (portableRepositoryPathProblem(repositoryPath) !== undefined) {
+        inputError("SOURCE_DISCOVERY_PATH_INVALID", "Source workspace discovery produced a non-contained repository path.");
+    }
+}
+function sameValue(left, right) {
+    return String(left) === String(right);
+}
+function sameFilesystemIdentity(left, right) {
+    return sameValue(left.dev, right.dev) && sameValue(left.ino, right.ino);
+}
+function sameFilesystemSnapshot(left, right) {
+    return (sameFilesystemIdentity(left, right) &&
+        sameValue(left.mode, right.mode) &&
+        sameValue(left.size, right.size) &&
+        sameValue(left.mtimeMs, right.mtimeMs) &&
+        sameValue(left.ctimeMs, right.ctimeMs));
+}
+async function pathTraversesSymbolicLink(canonicalConsumerRoot, absolutePath, operations, signal) {
+    const relation = relative(canonicalConsumerRoot, absolutePath);
+    if (isAbsolute(relation) || relation === ".." || relation.startsWith(`..${sep}`)) {
+        return false;
+    }
+    let current = canonicalConsumerRoot;
+    for (const segment of relation.split(sep).filter((value) => value.length > 0)) {
+        assertNotCancelled(signal);
+        current = join(current, segment);
+        const metadata = await operations.lstat(current).catch(() => {
+            assertNotCancelled(signal);
+            return inputError("SOURCE_DIRECTORY_UNAVAILABLE", "A required schema v2 source path is unavailable.");
+        });
+        assertNotCancelled(signal);
+        if (metadata.isSymbolicLink()) {
+            return true;
+        }
+    }
+    return false;
+}
+export async function captureStableRepositoryPath(canonicalConsumerRoot, repositoryPath, expectedKind, operations, signal) {
+    assertNotCancelled(signal);
+    assertSafeRepositoryPath(repositoryPath);
+    const absolutePath = repositoryPath === "."
+        ? canonicalConsumerRoot
+        : resolve(canonicalConsumerRoot, repositoryPath);
+    if (!pathIsContained(canonicalConsumerRoot, absolutePath)) {
+        inputError("SOURCE_DIRECTORY_ESCAPE", `Schema v2 source path escapes the consumer repository: ${repositoryPath}.`);
+    }
+    const lexicalMetadata = await operations.lstat(absolutePath).catch(() => {
+        assertNotCancelled(signal);
+        return inputError("SOURCE_DIRECTORY_UNAVAILABLE", `Required schema v2 source path is unavailable: ${repositoryPath}.`);
+    });
+    assertNotCancelled(signal);
+    const traversesSymbolicLink = await pathTraversesSymbolicLink(canonicalConsumerRoot, absolutePath, operations, signal);
+    const canonicalPath = await operations.realpath(absolutePath).catch(() => {
+        assertNotCancelled(signal);
+        return inputError("SOURCE_DIRECTORY_UNAVAILABLE", `Required schema v2 source path is unavailable: ${repositoryPath}.`);
+    });
+    assertNotCancelled(signal);
+    if (!pathIsContained(canonicalConsumerRoot, canonicalPath)) {
+        inputError("SOURCE_DIRECTORY_ESCAPE", `Schema v2 source path escapes the consumer repository: ${repositoryPath}.`);
+    }
+    const canonicalMetadata = await operations.stat(canonicalPath).catch(() => {
+        assertNotCancelled(signal);
+        return inputError("SOURCE_DIRECTORY_UNAVAILABLE", `Required schema v2 source path is unavailable: ${repositoryPath}.`);
+    });
+    assertNotCancelled(signal);
+    if ((expectedKind === "directory" && !canonicalMetadata.isDirectory()) ||
+        (expectedKind === "source" &&
+            !canonicalMetadata.isDirectory() &&
+            !canonicalMetadata.isFile())) {
+        inputError("SOURCE_DIRECTORY_INVALID", `Schema v2 source path has an invalid filesystem kind: ${repositoryPath}.`);
+    }
+    if (!traversesSymbolicLink &&
+        !sameFilesystemIdentity(lexicalMetadata, canonicalMetadata)) {
+        inputError("SOURCE_FILESYSTEM_CHANGED", `Schema v2 source path changed while it was inspected: ${repositoryPath}.`);
+    }
+    return Object.freeze({
+        absolutePath,
+        canonicalMetadata,
+        lexicalMetadata,
+        repositoryPath,
+        traversesSymbolicLink
+    });
+}
+export async function revalidateStableRepositoryPath(canonicalConsumerRoot, captured, operations, signal) {
+    assertNotCancelled(signal);
+    try {
+        const lexicalMetadata = await operations.lstat(captured.absolutePath);
+        const traversesSymbolicLink = await pathTraversesSymbolicLink(canonicalConsumerRoot, captured.absolutePath, operations, signal);
+        const canonicalPath = await operations.realpath(captured.absolutePath);
+        if (!pathIsContained(canonicalConsumerRoot, canonicalPath)) {
+            throw new Error("escape");
+        }
+        const canonicalMetadata = await operations.stat(canonicalPath);
+        if (traversesSymbolicLink !== captured.traversesSymbolicLink ||
+            !sameFilesystemSnapshot(lexicalMetadata, captured.lexicalMetadata) ||
+            !sameFilesystemSnapshot(canonicalMetadata, captured.canonicalMetadata)) {
+            throw new Error("changed");
+        }
+        assertNotCancelled(signal);
+    }
+    catch (error) {
+        if (error instanceof CapabilityInputError &&
+            error.problem.code === "EXECUTION_CANCELLED") {
+            throw error;
+        }
+        inputError("SOURCE_FILESYSTEM_CHANGED", `Schema v2 source path changed while it was inspected: ${captured.repositoryPath}.`);
+    }
+}
+//# sourceMappingURL=source-workspace-filesystem.js.map

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

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

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

@@ -0,0 +1,20 @@
+import { type SourceWorkspaceFileSystem, type StableRepositoryPath } from "./source-workspace-filesystem.js";
+interface InspectUniqueRootsInput {
+    readonly canonicalConsumerRoot: string;
+    readonly expectedKind: "directory" | "source";
+    readonly label: string;
+    readonly operations: SourceWorkspaceFileSystem;
+    readonly roots: readonly string[];
+    readonly signal?: AbortSignal;
+    readonly symbolicLinkCode?: string;
+}
+interface RevalidateRootsInput {
+    readonly canonicalConsumerRoot: string;
+    readonly operations: SourceWorkspaceFileSystem;
+    readonly roots: readonly StableRepositoryPath[];
+    readonly signal?: AbortSignal;
+}
+export declare function inspectUniqueRoots(input: InspectUniqueRootsInput): Promise<readonly StableRepositoryPath[]>;
+export declare function revalidateRoots(input: RevalidateRootsInput): Promise<void>;
+export {};
+//# sourceMappingURL=source-workspace-root-snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-workspace-root-snapshot.d.ts","sourceRoot":"","sources":["../../../../../../src/capabilities/source-dependencies/adapters/outbound/node/source-workspace-root-snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAE1C,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAeD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CA8B1C;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CASf"}