@agent-teams/engineering-foundation 0.1.0

package/dist/local-mode/consumer-policy.js

@@ -0,0 +1,227 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseDocument } from "yaml";
+import { FOUNDATION_PACKAGE_NAME } from "./types.js";
+const EXACT_SEMVER_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+const SHA512_INTEGRITY_PATTERN = /^sha512-[A-Za-z0-9+/]+={0,2}$/;
+const RUNTIME_DEPENDENCY_FIELDS = [
+    "dependencies",
+    "optionalDependencies",
+    "peerDependencies"
+];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function dependencyValue(container, dependencyName) {
+    return isRecord(container) ? container[dependencyName] : undefined;
+}
+function targetsFoundation(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return Object.keys(value).some((key) => key.includes(FOUNDATION_PACKAGE_NAME));
+}
+function hasBundledFoundation(value) {
+    return (Array.isArray(value) &&
+        value.some((candidate) => candidate === FOUNDATION_PACKAGE_NAME));
+}
+async function readJson(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+export function isExactVersion(value) {
+    return EXACT_SEMVER_PATTERN.test(value);
+}
+export async function inspectFoundationDevOnly(consumerRoot) {
+    const issues = [];
+    let manifest;
+    try {
+        const candidate = await readJson(join(consumerRoot, "package.json"));
+        if (isRecord(candidate)) {
+            manifest = candidate;
+        }
+        else {
+            issues.push("Consumer package.json must contain an object.");
+        }
+    }
+    catch {
+        issues.push("Consumer package.json cannot be read.");
+    }
+    const dependencyCandidate = dependencyValue(manifest?.devDependencies, FOUNDATION_PACKAGE_NAME);
+    const dependencySpec = typeof dependencyCandidate === "string" ? dependencyCandidate : undefined;
+    if (dependencySpec === undefined) {
+        issues.push(`${FOUNDATION_PACKAGE_NAME} must be declared in devDependencies.`);
+    }
+    else if (!isExactVersion(dependencySpec)) {
+        issues.push(`${FOUNDATION_PACKAGE_NAME} must use an exact registry version.`);
+    }
+    for (const field of RUNTIME_DEPENDENCY_FIELDS) {
+        if (dependencyValue(manifest?.[field], FOUNDATION_PACKAGE_NAME) !== undefined) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} must not be declared in ${field}.`);
+        }
+    }
+    if (hasBundledFoundation(manifest?.bundleDependencies) ||
+        hasBundledFoundation(manifest?.bundledDependencies)) {
+        issues.push(`${FOUNDATION_PACKAGE_NAME} must not be bundled for runtime.`);
+    }
+    if (targetsFoundation(manifest?.overrides)) {
+        issues.push(`${FOUNDATION_PACKAGE_NAME} must not use npm overrides.`);
+    }
+    if (targetsFoundation(manifest?.resolutions)) {
+        issues.push(`${FOUNDATION_PACKAGE_NAME} must not use dependency resolutions.`);
+    }
+    if (isRecord(manifest?.pnpm)) {
+        if (targetsFoundation(manifest.pnpm.overrides)) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} must not use pnpm overrides.`);
+        }
+        if (targetsFoundation(manifest.pnpm.patchedDependencies)) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} must not use pnpm patches.`);
+        }
+    }
+    const packageManager = typeof manifest?.packageManager === "string"
+        ? manifest.packageManager
+        : undefined;
+    if (packageManager === undefined ||
+        !/^pnpm@11\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u.test(packageManager)) {
+        issues.push("Consumer packageManager must pin an exact pnpm 11 version.");
+    }
+    return {
+        consumerRoot,
+        ...(dependencySpec === undefined ? {} : { dependencySpec }),
+        ...(packageManager === undefined ? {} : { packageManager }),
+        issues
+    };
+}
+function readLockfileObject(source) {
+    const document = parseDocument(source, {
+        uniqueKeys: true
+    });
+    if (document.errors.length > 0) {
+        throw new Error(document.errors.map((error) => error.message).join("; "));
+    }
+    const value = document.toJS({ maxAliasCount: 0 });
+    if (!isRecord(value)) {
+        throw new Error("pnpm-lock.yaml must contain an object.");
+    }
+    return value;
+}
+export async function inspectFoundationRegistryProvenance(consumerRoot, dependencySpec) {
+    const inspectLockfile = (lockfile, source) => {
+        const issues = [];
+        if (lockfile.lockfileVersion !== "9.0") {
+            issues.push(`${source} must use pnpm lockfileVersion 9.0.`);
+        }
+        if (targetsFoundation(lockfile.overrides)) {
+            issues.push(`${source} must not use lockfile overrides.`);
+        }
+        if (targetsFoundation(lockfile.patchedDependencies)) {
+            issues.push(`${source} must not use lockfile patches.`);
+        }
+        const rootImporter = isRecord(lockfile.importers)
+            ? lockfile.importers["."]
+            : undefined;
+        if (!isRecord(rootImporter)) {
+            issues.push(`${source} must contain the root importer.`);
+            return { issues };
+        }
+        for (const field of RUNTIME_DEPENDENCY_FIELDS) {
+            if (dependencyValue(rootImporter[field], FOUNDATION_PACKAGE_NAME) !==
+                undefined) {
+                issues.push(`${FOUNDATION_PACKAGE_NAME} must not resolve through ${source} ${field}.`);
+            }
+        }
+        const lockedDependency = dependencyValue(rootImporter.devDependencies, FOUNDATION_PACKAGE_NAME);
+        if (!isRecord(lockedDependency)) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} must be locked in ${source} root devDependencies.`);
+            return { issues };
+        }
+        if (dependencySpec === undefined ||
+            lockedDependency.specifier !== dependencySpec ||
+            lockedDependency.version !== dependencySpec) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} ${source} specifier and version must equal the exact manifest version.`);
+            return { issues };
+        }
+        const packageKey = `${FOUNDATION_PACKAGE_NAME}@${dependencySpec}`;
+        const packageEntry = isRecord(lockfile.packages)
+            ? lockfile.packages[packageKey]
+            : undefined;
+        if (!isRecord(packageEntry) || !isRecord(packageEntry.resolution)) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} must have an npm registry package entry in ${source}.`);
+            return { issues };
+        }
+        const resolution = packageEntry.resolution;
+        const integrity = typeof resolution.integrity === "string"
+            ? resolution.integrity
+            : undefined;
+        if (integrity === undefined || !SHA512_INTEGRITY_PATTERN.test(integrity)) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} ${source} entry must contain sha512 registry integrity.`);
+        }
+        const tarball = typeof resolution.tarball === "string" ? resolution.tarball : undefined;
+        if (tarball !== undefined &&
+            !tarball.startsWith("https://registry.npmjs.org/")) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} ${source} tarball must come from registry.npmjs.org.`);
+        }
+        for (const forbiddenField of [
+            "commit",
+            "directory",
+            "path",
+            "repo",
+            "type"
+        ]) {
+            if (resolution[forbiddenField] !== undefined) {
+                issues.push(`${FOUNDATION_PACKAGE_NAME} ${source} resolution contains forbidden field ${forbiddenField}.`);
+            }
+        }
+        if (!isRecord(lockfile.snapshots) ||
+            !isRecord(lockfile.snapshots[packageKey])) {
+            issues.push(`${FOUNDATION_PACKAGE_NAME} must have an exact snapshot entry in ${source}.`);
+        }
+        return {
+            ...(packageKey === undefined ? {} : { packageKey }),
+            ...(integrity === undefined ? {} : { integrity }),
+            issues
+        };
+    };
+    const issues = [];
+    const lockfilePath = join(consumerRoot, "pnpm-lock.yaml");
+    let lockfile;
+    try {
+        lockfile = readLockfileObject(await readFile(lockfilePath, "utf8"));
+    }
+    catch {
+        return {
+            issues: ["Consumer pnpm-lock.yaml cannot be parsed safely."]
+        };
+    }
+    const rootProvenance = inspectLockfile(lockfile, "consumer pnpm-lock.yaml");
+    issues.push(...rootProvenance.issues);
+    const virtualStoreLockfilePath = join(consumerRoot, "node_modules", ".pnpm", "lock.yaml");
+    let virtualStoreLockfile;
+    try {
+        virtualStoreLockfile = readLockfileObject(await readFile(virtualStoreLockfilePath, "utf8"));
+    }
+    catch {
+        issues.push("Installed pnpm virtual-store lockfile cannot be parsed safely.");
+        return { issues };
+    }
+    const installedProvenance = inspectLockfile(virtualStoreLockfile, "installed pnpm virtual-store lockfile");
+    issues.push(...installedProvenance.issues);
+    if (rootProvenance.packageKey !== installedProvenance.packageKey ||
+        rootProvenance.integrity !== installedProvenance.integrity) {
+        issues.push(`${FOUNDATION_PACKAGE_NAME} root and installed pnpm lockfile provenance must match.`);
+    }
+    return {
+        ...(issues.length === 0 &&
+            rootProvenance.packageKey !== undefined &&
+            rootProvenance.integrity !== undefined
+            ? {
+                provenance: {
+                    lockfilePath,
+                    packageKey: rootProvenance.packageKey,
+                    integrity: rootProvenance.integrity
+                }
+            }
+            : {}),
+        issues
+    };
+}
+//# sourceMappingURL=consumer-policy.js.map

package/dist/local-mode/consumer-policy.js.map

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

package/dist/local-mode/index.d.ts

@@ -0,0 +1,7 @@
+export { inspectFoundationDevOnly, inspectFoundationMode, inspectFoundationRegistryProvenance, isExactVersion } from "./inspection.js";
+export { NodeProcessRunner } from "./process-runner.js";
+export { FoundationLocalModeService } from "./service.js";
+export type { FoundationLocalModeServiceOptions } from "./service.js";
+export { FOUNDATION_PACKAGE_NAME, FOUNDATION_LOCAL_MODE_PROTOCOL_VERSION, LOCAL_OPERATION_LOCK, LOCAL_REGISTRY_BACKUP, LOCAL_STATE_DIRECTORY, LOCAL_STATE_FILE } from "./types.js";
+export type { AttachResult, FoundationDevOnlyStatus, FoundationLinkPhase, FoundationLinkState, FoundationMode, FoundationRegistryProvenance, FoundationStatus, ProcessRequest, ProcessResult, ProcessRunner } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/local-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/local-mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mCAAmC,EACnC,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,uBAAuB,EACvB,sCAAsC,EACtC,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,4BAA4B,EAC5B,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC"}

package/dist/local-mode/index.js

@@ -0,0 +1,5 @@
+export { inspectFoundationDevOnly, inspectFoundationMode, inspectFoundationRegistryProvenance, isExactVersion } from "./inspection.js";
+export { NodeProcessRunner } from "./process-runner.js";
+export { FoundationLocalModeService } from "./service.js";
+export { FOUNDATION_PACKAGE_NAME, FOUNDATION_LOCAL_MODE_PROTOCOL_VERSION, LOCAL_OPERATION_LOCK, LOCAL_REGISTRY_BACKUP, LOCAL_STATE_DIRECTORY, LOCAL_STATE_FILE } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/local-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/local-mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,mCAAmC,EACnC,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EACL,uBAAuB,EACvB,sCAAsC,EACtC,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/local-mode/inspection.d.ts

@@ -0,0 +1,7 @@
+import type { FoundationStatus } from "./types.js";
+export declare function inspectFoundationMode(consumerPath: string, options?: {
+    readonly ignoreOperationLock?: boolean;
+}): Promise<FoundationStatus>;
+export { inspectFoundationDevOnly, inspectFoundationRegistryProvenance } from "./consumer-policy.js";
+export { isExactVersion } from "./consumer-policy.js";
+//# sourceMappingURL=inspection.d.ts.map

package/dist/local-mode/inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/local-mode/inspection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAyFpB,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,OAAO,CAAC,gBAAgB,CAAC,CAgN3B;AAED,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/local-mode/inspection.js

@@ -0,0 +1,224 @@
+import { lstat, readFile, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { inspectFoundationDevOnly, inspectFoundationRegistryProvenance } from "./consumer-policy.js";
+import { FOUNDATION_PACKAGE_NAME, LOCAL_OPERATION_LOCK, LOCAL_REGISTRY_BACKUP, LOCAL_STATE_DIRECTORY, LOCAL_STATE_FILE } from "./types.js";
+async function readJson(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseLinkState(value) {
+    if (!isRecord(value) ||
+        value.schemaVersion !== 1 ||
+        !["ATTACHING", "DETACHING", "LOCAL"].includes(typeof value.phase === "string" ? value.phase : "") ||
+        typeof value.consumerRoot !== "string" ||
+        typeof value.targetPackageRoot !== "string" ||
+        typeof value.registryBackupPath !== "string" ||
+        !["directory", "symbolic-link"].includes(typeof value.registryEntryKind === "string"
+            ? value.registryEntryKind
+            : "") ||
+        typeof value.registryPackageRoot !== "string" ||
+        typeof value.packageVersion !== "string" ||
+        typeof value.gitCommit !== "string" ||
+        typeof value.gitDirty !== "boolean" ||
+        typeof value.attachedAt !== "string") {
+        return undefined;
+    }
+    return {
+        schemaVersion: 1,
+        phase: value.phase,
+        consumerRoot: value.consumerRoot,
+        targetPackageRoot: value.targetPackageRoot,
+        registryBackupPath: value.registryBackupPath,
+        registryEntryKind: value.registryEntryKind,
+        registryPackageRoot: value.registryPackageRoot,
+        packageVersion: value.packageVersion,
+        gitCommit: value.gitCommit,
+        gitDirty: value.gitDirty,
+        attachedAt: value.attachedAt
+    };
+}
+async function readOptionalLinkState(consumerRoot, issues) {
+    const path = join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_STATE_FILE);
+    try {
+        const state = parseLinkState(await readJson(path));
+        if (state === undefined) {
+            issues.push("Local foundation state exists but is invalid.");
+        }
+        return state;
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return undefined;
+        }
+        issues.push("Local foundation state cannot be read.");
+        return undefined;
+    }
+}
+function isWithin(parent, candidate) {
+    const path = relative(parent, candidate);
+    return path === "" || (!path.startsWith(`..${sep}`) && path !== ".." && !isAbsolute(path));
+}
+export async function inspectFoundationMode(consumerPath, options = {}) {
+    const consumerRoot = await realpath(resolve(consumerPath));
+    const issues = [];
+    const localStateDirectory = join(consumerRoot, LOCAL_STATE_DIRECTORY);
+    let localStateDirectoryIsSafe = true;
+    let localStateDirectoryExists = false;
+    try {
+        const stateEntry = await lstat(localStateDirectory);
+        localStateDirectoryExists = true;
+        if (!stateEntry.isDirectory() ||
+            stateEntry.isSymbolicLink() ||
+            (await realpath(localStateDirectory)) !== localStateDirectory) {
+            localStateDirectoryIsSafe = false;
+            issues.push("Local foundation state path must be a real consumer-owned directory.");
+        }
+    }
+    catch (error) {
+        if (!(error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT")) {
+            localStateDirectoryIsSafe = false;
+            issues.push("Local foundation state directory cannot be inspected.");
+        }
+    }
+    let localEntries = [];
+    if (localStateDirectoryExists && localStateDirectoryIsSafe) {
+        try {
+            localEntries = await readdir(localStateDirectory);
+        }
+        catch (error) {
+            if (!(error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT")) {
+                issues.push("Local foundation state directory cannot be read.");
+            }
+        }
+    }
+    if (options.ignoreOperationLock !== true &&
+        localEntries.includes(LOCAL_OPERATION_LOCK)) {
+        issues.push("A foundation operation is currently active or interrupted.");
+    }
+    if (localEntries.some((entry) => entry.startsWith(`${LOCAL_STATE_FILE}.`) && entry.endsWith(".tmp"))) {
+        issues.push("An incomplete foundation state write requires recovery.");
+    }
+    const dependencyPolicy = await inspectFoundationDevOnly(consumerRoot);
+    issues.push(...dependencyPolicy.issues);
+    const dependencySpec = dependencyPolicy.dependencySpec;
+    const provenance = await inspectFoundationRegistryProvenance(consumerRoot, dependencySpec);
+    issues.push(...provenance.issues);
+    let installedPackageRoot;
+    let installedVersion;
+    try {
+        installedPackageRoot = await realpath(join(consumerRoot, "node_modules", FOUNDATION_PACKAGE_NAME));
+        const installedManifest = await readJson(join(installedPackageRoot, "package.json"));
+        if (isRecord(installedManifest) &&
+            installedManifest.name === FOUNDATION_PACKAGE_NAME &&
+            typeof installedManifest.version === "string") {
+            installedVersion = installedManifest.version;
+        }
+        else {
+            issues.push("Installed foundation package identity or version is invalid.");
+        }
+    }
+    catch {
+        issues.push("Installed foundation package cannot be resolved.");
+    }
+    const linkState = localStateDirectoryIsSafe
+        ? await readOptionalLinkState(consumerRoot, issues)
+        : undefined;
+    if (linkState !== undefined) {
+        const expectedBackupPath = join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP);
+        if (resolve(linkState.registryBackupPath) !== expectedBackupPath) {
+            issues.push("Local state registry backup path is invalid.");
+        }
+        if (!isWithin(join(consumerRoot, "node_modules"), resolve(linkState.registryPackageRoot))) {
+            issues.push("Local state registry package root is outside node_modules.");
+        }
+        try {
+            const expectedBackupRoot = linkState.registryEntryKind === "symbolic-link"
+                ? resolve(linkState.registryPackageRoot)
+                : expectedBackupPath;
+            if ((await realpath(expectedBackupPath)) !== expectedBackupRoot) {
+                issues.push("Registry backup does not match local state.");
+            }
+        }
+        catch {
+            issues.push("Registry backup cannot be resolved.");
+        }
+        if (linkState.phase !== "LOCAL") {
+            issues.push(`Local foundation operation is incomplete: ${linkState.phase}.`);
+        }
+        if (resolve(linkState.consumerRoot) !== consumerRoot) {
+            issues.push("Local state belongs to a different consumer root.");
+        }
+        if (installedPackageRoot === undefined ||
+            resolve(linkState.targetPackageRoot) !== installedPackageRoot) {
+            issues.push("Installed foundation path does not match local state.");
+        }
+        if (installedVersion !== undefined &&
+            linkState.packageVersion !== installedVersion) {
+            issues.push("Installed foundation version does not match local state.");
+        }
+        return {
+            mode: issues.length === 0 ? "LOCAL" : "INVALID",
+            consumerRoot,
+            ...(dependencySpec === undefined ? {} : { dependencySpec }),
+            ...(installedPackageRoot === undefined ? {} : { installedPackageRoot }),
+            ...(installedVersion === undefined ? {} : { installedVersion }),
+            ...(provenance.provenance === undefined
+                ? {}
+                : {
+                    lockfilePath: provenance.provenance.lockfilePath,
+                    lockfilePackageKey: provenance.provenance.packageKey,
+                    registryIntegrity: provenance.provenance.integrity
+                }),
+            linkState,
+            issues
+        };
+    }
+    if (localStateDirectoryIsSafe) {
+        try {
+            await lstat(join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP));
+            issues.push("An orphan registry backup requires detach recovery.");
+        }
+        catch (error) {
+            if (!(error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT")) {
+                issues.push("Registry backup state cannot be inspected.");
+            }
+        }
+    }
+    if (installedPackageRoot !== undefined &&
+        !isWithin(join(consumerRoot, "node_modules"), installedPackageRoot)) {
+        issues.push("Foundation resolves outside consumer node_modules without local state.");
+    }
+    if (dependencySpec !== undefined &&
+        installedVersion !== undefined &&
+        dependencySpec !== installedVersion) {
+        issues.push("Installed foundation version differs from the manifest version.");
+    }
+    return {
+        mode: issues.length === 0 ? "REGISTRY" : "INVALID",
+        consumerRoot,
+        ...(dependencySpec === undefined ? {} : { dependencySpec }),
+        ...(installedPackageRoot === undefined ? {} : { installedPackageRoot }),
+        ...(installedVersion === undefined ? {} : { installedVersion }),
+        ...(provenance.provenance === undefined
+            ? {}
+            : {
+                lockfilePath: provenance.provenance.lockfilePath,
+                lockfilePackageKey: provenance.provenance.packageKey,
+                registryIntegrity: provenance.provenance.integrity
+            }),
+        issues
+    };
+}
+export { inspectFoundationDevOnly, inspectFoundationRegistryProvenance } from "./consumer-policy.js";
+export { isExactVersion } from "./consumer-policy.js";
+//# sourceMappingURL=inspection.js.map

package/dist/local-mode/inspection.js.map

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

package/dist/local-mode/process-runner.d.ts

@@ -0,0 +1,5 @@
+import type { ProcessRequest, ProcessResult, ProcessRunner } from "./types.js";
+export declare class NodeProcessRunner implements ProcessRunner {
+    run(request: ProcessRequest): Promise<ProcessResult>;
+}
+//# sourceMappingURL=process-runner.d.ts.map

package/dist/local-mode/process-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../../src/local-mode/process-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBzD;CACF"}

package/dist/local-mode/process-runner.js

@@ -0,0 +1,20 @@
+import { execFile } from "node:child_process";
+import { FoundationError } from "../errors.js";
+export class NodeProcessRunner {
+    async run(request) {
+        return await new Promise((resolve, reject) => {
+            execFile(request.command, [...request.args], {
+                cwd: request.cwd,
+                encoding: "utf8",
+                maxBuffer: 4 * 1024 * 1024
+            }, (error, stdout, stderr) => {
+                if (error !== null) {
+                    reject(new FoundationError("PROCESS_FAILED", `${request.command} ${request.args.join(" ")} failed: ${stderr.trim() || error.message}`, { cause: error }));
+                    return;
+                }
+                resolve({ stdout, stderr });
+            });
+        });
+    }
+}
+//# sourceMappingURL=process-runner.js.map

package/dist/local-mode/process-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.js","sourceRoot":"","sources":["../../src/local-mode/process-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,GAAG,CAAC,OAAuB;QAC/B,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,QAAQ,CACN,OAAO,CAAC,OAAO,EACf,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EACjB;gBACE,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,QAAQ,EAAE,MAAM;gBAChB,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;aAC3B,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACxB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,CACJ,IAAI,eAAe,CACjB,gBAAgB,EAChB,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EACxF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9B,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/local-mode/service.d.ts

@@ -0,0 +1,16 @@
+import type { AttachResult, FoundationDevOnlyStatus, FoundationStatus, ProcessRunner } from "./types.js";
+export interface FoundationLocalModeServiceOptions {
+    readonly runner: ProcessRunner;
+    readonly now?: () => Date;
+}
+export declare function acquireFoundationOperationLock(consumerRoot: string): Promise<() => Promise<void>>;
+export declare class FoundationLocalModeService {
+    #private;
+    constructor(options: FoundationLocalModeServiceOptions);
+    status(consumerPath: string): Promise<FoundationStatus>;
+    attach(consumerPath: string, targetPath: string): Promise<AttachResult>;
+    detach(consumerPath: string): Promise<FoundationStatus>;
+    assertRegistry(consumerPath: string): Promise<FoundationStatus>;
+    assertDevOnly(consumerPath: string): Promise<FoundationDevOnlyStatus>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/local-mode/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/local-mode/service.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EAEvB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAcpB,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAmPD,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAmC9B;AAED,qBAAa,0BAA0B;;IAIrC,YAAY,OAAO,EAAE,iCAAiC,EAGrD;IA4HK,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE5D;IAEK,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CA2NvB;IAEK,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6C5D;IAEK,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CASpE;IAEK,aAAa,CACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAUlC;CACF"}