@agent-teams/engineering-foundation 1.0.2 → 1.1.1

package/dist/local-mode/adapters/node/mode-inspection.js

@@ -0,0 +1,230 @@
+import { buildStatus, projectPublicTransactionStatus } from "../../application/mode-status.js";
+import { lstat, readFile, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { inspectFoundationDevOnly, inspectFoundationRegistryProvenance } from "./consumer-inspection.js";
+import { FOUNDATION_PACKAGE_NAME, LOCAL_OPERATION_LOCK, LOCAL_REGISTRY_BACKUP, LOCAL_STATE_DIRECTORY, LOCAL_STATE_FILE } from "../../application/model.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));
+}
+function isMissing(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+async function inspectLocalStateDirectory(consumerRoot, ignoreOperationLock, issues) {
+    const directory = join(consumerRoot, LOCAL_STATE_DIRECTORY);
+    let exists = false;
+    try {
+        const entry = await lstat(directory);
+        exists = true;
+        if (!entry.isDirectory() || entry.isSymbolicLink() || (await realpath(directory)) !== directory) {
+            issues.push("Local foundation state path must be a real consumer-owned directory.");
+            return false;
+        }
+    }
+    catch (error) {
+        if (!isMissing(error)) {
+            issues.push("Local foundation state directory cannot be inspected.");
+            return false;
+        }
+    }
+    if (!exists) {
+        return true;
+    }
+    let entries = [];
+    try {
+        entries = await readdir(directory);
+    }
+    catch (error) {
+        if (!isMissing(error)) {
+            issues.push("Local foundation state directory cannot be read.");
+        }
+    }
+    if (!ignoreOperationLock && entries.includes(LOCAL_OPERATION_LOCK)) {
+        issues.push("A foundation operation is currently active or interrupted.");
+    }
+    if (entries.some((entry) => entry.startsWith(`${LOCAL_STATE_FILE}.`) && entry.endsWith(".tmp"))) {
+        issues.push("An incomplete foundation state write requires recovery.");
+    }
+    return true;
+}
+async function inspectInstalledFoundation(consumerRoot, issues) {
+    try {
+        const root = await realpath(join(consumerRoot, "node_modules", FOUNDATION_PACKAGE_NAME));
+        const manifest = await readJson(join(root, "package.json"));
+        if (isRecord(manifest) &&
+            manifest.name === FOUNDATION_PACKAGE_NAME &&
+            typeof manifest.version === "string") {
+            return { root, version: manifest.version };
+        }
+        issues.push("Installed foundation package identity or version is invalid.");
+        return { root };
+    }
+    catch {
+        issues.push("Installed foundation package cannot be resolved.");
+        return {};
+    }
+}
+async function inspectLinkStateConsistency(consumerRoot, state, installed, issues) {
+    const backupPath = join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP);
+    if (resolve(state.registryBackupPath) !== backupPath) {
+        issues.push("Local state registry backup path is invalid.");
+    }
+    if (!isWithin(join(consumerRoot, "node_modules"), resolve(state.registryPackageRoot))) {
+        issues.push("Local state registry package root is outside node_modules.");
+    }
+    try {
+        const expectedBackupRoot = state.registryEntryKind === "symbolic-link"
+            ? resolve(state.registryPackageRoot)
+            : backupPath;
+        if ((await realpath(backupPath)) !== expectedBackupRoot) {
+            issues.push("Registry backup does not match local state.");
+        }
+    }
+    catch {
+        issues.push("Registry backup cannot be resolved.");
+    }
+    if (state.phase !== "LOCAL") {
+        issues.push(`Local foundation operation is incomplete: ${state.phase}.`);
+    }
+    if (resolve(state.consumerRoot) !== consumerRoot) {
+        issues.push("Local state belongs to a different consumer root.");
+    }
+    if (installed.root === undefined || resolve(state.targetPackageRoot) !== installed.root) {
+        issues.push("Installed foundation path does not match local state.");
+    }
+    if (installed.version !== undefined && state.packageVersion !== installed.version) {
+        issues.push("Installed foundation version does not match local state.");
+    }
+}
+async function inspectOrphanBackup(consumerRoot, issues) {
+    try {
+        await lstat(join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP));
+        issues.push("An orphan registry backup requires detach recovery.");
+    }
+    catch (error) {
+        if (!isMissing(error)) {
+            issues.push("Registry backup state cannot be inspected.");
+        }
+    }
+}
+async function inspectMode(readTransaction, consumerPath, options = {}) {
+    const consumerRoot = await realpath(resolve(consumerPath));
+    const issues = [];
+    const localStateDirectoryIsSafe = await inspectLocalStateDirectory(consumerRoot, options.ignoreOperationLock === true, issues);
+    const transaction = localStateDirectoryIsSafe
+        ? await readTransaction(consumerRoot)
+        : { state: "idle", diagnostics: [] };
+    const publicTransaction = projectPublicTransactionStatus(transaction);
+    const transactionDiagnostic = publicTransaction.state === "idle"
+        ? undefined
+        : publicTransaction.diagnostics[0]?.message;
+    if (transactionDiagnostic !== undefined) {
+        issues.push(transactionDiagnostic);
+    }
+    const dependencyPolicy = await inspectFoundationDevOnly(consumerRoot);
+    issues.push(...dependencyPolicy.issues);
+    const dependencySpec = dependencyPolicy.dependencySpec;
+    const provenance = await inspectFoundationRegistryProvenance(consumerRoot, dependencySpec);
+    issues.push(...provenance.issues);
+    const installed = await inspectInstalledFoundation(consumerRoot, issues);
+    const linkState = localStateDirectoryIsSafe
+        ? await readOptionalLinkState(consumerRoot, issues)
+        : undefined;
+    if (linkState !== undefined) {
+        await inspectLinkStateConsistency(consumerRoot, linkState, installed, issues);
+        return buildStatus({
+            consumerRoot,
+            ...(dependencySpec === undefined ? {} : { dependencySpec }),
+            installed,
+            ...(provenance.provenance === undefined ? {} : { provenance: provenance.provenance }),
+            linkState,
+            ...(publicTransaction.state === "idle"
+                ? {}
+                : { transaction: publicTransaction }),
+            issues
+        });
+    }
+    if (localStateDirectoryIsSafe) {
+        await inspectOrphanBackup(consumerRoot, issues);
+    }
+    if (installed.root !== undefined && !isWithin(join(consumerRoot, "node_modules"), installed.root)) {
+        issues.push("Foundation resolves outside consumer node_modules without local state.");
+    }
+    if (dependencySpec !== undefined &&
+        installed.version !== undefined &&
+        dependencySpec !== installed.version) {
+        issues.push("Installed foundation version differs from the manifest version.");
+    }
+    return buildStatus({
+        consumerRoot,
+        ...(dependencySpec === undefined ? {} : { dependencySpec }),
+        installed,
+        ...(provenance.provenance === undefined ? {} : { provenance: provenance.provenance }),
+        ...(publicTransaction.state === "idle"
+            ? {}
+            : { transaction: publicTransaction }),
+        issues
+    });
+}
+export function createNodeModeInspector(readTransaction) {
+    return (consumerPath, options = {}) => inspectMode(readTransaction, consumerPath, options);
+}
+//# sourceMappingURL=mode-inspection.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { FoundationPackageArtifactPolicy, FoundationPackageSelfCheck } from "../../application/package-metadata.js";
+export declare function inspectFoundationPackage(packageRoot: string, artifactPolicy: FoundationPackageArtifactPolicy): Promise<FoundationPackageSelfCheck>;
+//# sourceMappingURL=package-inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-inspection.d.ts","sourceRoot":"","sources":["../../../../src/local-mode/adapters/node/package-inspection.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AA8CzH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,+BAA+B,GAC9C,OAAO,CAAC,0BAA0B,CAAC,CAsCrC"}

package/dist/local-mode/adapters/node/package-inspection.js

@@ -0,0 +1,76 @@
+import { createRequire } from "node:module";
+import { lstat, readFile, realpath } from "node:fs/promises";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { invalidRuntimeModuleExports, missingRuntimeExport, unreadableTargetManifest, unavailableBuildOutput, unresolvableRuntimeDependency } from "../../application/inspection-failures.js";
+import { packageMetadata, validatePackageManifest } from "../../application/package-metadata.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function importUnknown(specifier) {
+    return import(specifier);
+}
+function isImportOnlyPackageResolution(error) {
+    return isRecord(error) && error.code === "ERR_PACKAGE_PATH_NOT_EXPORTED";
+}
+async function assertRequiredRuntimeExports(packageRoot) {
+    const [rootExports, localModeExports, scaffoldingExports] = await Promise.all([
+        importUnknown(pathToFileURL(join(packageRoot, "dist", "index.js")).href),
+        importUnknown(pathToFileURL(join(packageRoot, "dist", "local-mode", "index.js")).href),
+        importUnknown(pathToFileURL(join(packageRoot, "dist", "scaffolding", "index.js")).href)
+    ]);
+    if (!isRecord(rootExports) ||
+        !isRecord(localModeExports) ||
+        !isRecord(scaffoldingExports)) {
+        throw invalidRuntimeModuleExports();
+    }
+    const requiredRuntimeExports = [
+        ["FoundationError", rootExports.FoundationError],
+        ["FoundationLocalModeService", localModeExports.FoundationLocalModeService],
+        ["planScaffoldFromFile", scaffoldingExports.planScaffoldFromFile],
+        ["applyFilesystemScaffold", scaffoldingExports.applyFilesystemScaffold],
+        ["inspectFoundationMode", localModeExports.inspectFoundationMode]
+    ];
+    for (const [exportName, candidate] of requiredRuntimeExports) {
+        if (typeof candidate !== "function") {
+            throw missingRuntimeExport(exportName);
+        }
+    }
+}
+export async function inspectFoundationPackage(packageRoot, artifactPolicy) {
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8"));
+    }
+    catch (error) {
+        throw unreadableTargetManifest(error);
+    }
+    validatePackageManifest(manifest, artifactPolicy.packageFileAllowlist);
+    for (const outputPath of artifactPolicy.requiredArtifactPaths) {
+        try {
+            const metadata = await lstat(join(packageRoot, outputPath));
+            if (metadata.isSymbolicLink() || !metadata.isFile()) {
+                throw new Error("not a regular file");
+            }
+        }
+        catch (error) {
+            throw unavailableBuildOutput(outputPath, error);
+        }
+    }
+    await assertRequiredRuntimeExports(packageRoot);
+    const { selfCheck, runtimeDependencyNames } = packageMetadata(manifest);
+    const requireFromTarget = createRequire(join(await realpath(packageRoot), "package.json"));
+    for (const dependencyName of runtimeDependencyNames) {
+        try {
+            requireFromTarget.resolve(dependencyName);
+        }
+        catch (error) {
+            if (isImportOnlyPackageResolution(error)) {
+                continue;
+            }
+            throw unresolvableRuntimeDependency(dependencyName, error);
+        }
+    }
+    return selfCheck;
+}
+//# sourceMappingURL=package-inspection.js.map

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

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

package/dist/local-mode/adapters/node/registry-links.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessRunner } from "../../application/model.js";
+import type { RegistryLinks } from "../../application/ports.js";
+export declare function createNodeRegistryLinks(runner: ProcessRunner, syncDirectory: (path: string) => Promise<void>): RegistryLinks;
+//# sourceMappingURL=registry-links.d.ts.map

package/dist/local-mode/adapters/node/registry-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-links.d.ts","sourceRoot":"","sources":["../../../../src/local-mode/adapters/node/registry-links.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAuEhE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAO5H"}

package/dist/local-mode/adapters/node/registry-links.js

@@ -0,0 +1,66 @@
+import { appendFile, lstat, mkdir, readFile, realpath, rename, rm, symlink } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { localLinkTargetMismatch, registryBackupAlreadyExists, invalidInstalledEntry, installedEntryChanged } from "../../application/inspection-failures.js";
+import { pathEntryExists, restoreRegistryEntry } from "./registry-recovery.js";
+import { FOUNDATION_PACKAGE_NAME, LOCAL_REGISTRY_BACKUP, LOCAL_STATE_DIRECTORY } from "../../application/model.js";
+async function ensureStateDirectoryIgnored(runner, consumerRoot) {
+    const result = await runner.run({
+        command: "git",
+        args: ["-C", consumerRoot, "rev-parse", "--git-path", "info/exclude"],
+        cwd: consumerRoot
+    });
+    const candidate = result.stdout.trim();
+    const excludePath = isAbsolute(candidate) ? candidate : resolve(consumerRoot, candidate);
+    await mkdir(dirname(excludePath), { recursive: true });
+    const exclude = await readFile(excludePath, "utf8").catch(() => "");
+    if (exclude.split(/\r?\n/u).includes(`${LOCAL_STATE_DIRECTORY}/`)) {
+        return;
+    }
+    const separator = exclude.length === 0 || exclude.endsWith("\n") ? "" : "\n";
+    await appendFile(excludePath, `${separator}${LOCAL_STATE_DIRECTORY}/\n`, "utf8");
+}
+async function replaceRegistryEntryWithLink(state, installedPackagePath, syncDirectory) {
+    if (state.registryEntryKind === "symbolic-link") {
+        await symlink(state.registryPackageRoot, state.registryBackupPath, process.platform === "win32" ? "junction" : "dir");
+        await syncDirectory(dirname(state.registryBackupPath));
+        await rm(installedPackagePath, { force: true });
+    }
+    else {
+        await rename(installedPackagePath, state.registryBackupPath);
+        await syncDirectory(dirname(state.registryBackupPath));
+    }
+    await syncDirectory(dirname(installedPackagePath));
+    await mkdir(dirname(installedPackagePath), { recursive: true });
+    await symlink(state.targetPackageRoot, installedPackagePath, process.platform === "win32" ? "junction" : "dir");
+    if ((await realpath(installedPackagePath)) !== state.targetPackageRoot) {
+        throw localLinkTargetMismatch();
+    }
+    await syncDirectory(dirname(installedPackagePath));
+}
+async function prepareRegistryEntry(consumerRoot, registryPackageRoot) {
+    const installedPath = join(consumerRoot, "node_modules", FOUNDATION_PACKAGE_NAME);
+    const backupPath = join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP);
+    if (await pathEntryExists(backupPath)) {
+        throw registryBackupAlreadyExists();
+    }
+    const registryEntry = await lstat(installedPath);
+    if (!registryEntry.isDirectory() && !registryEntry.isSymbolicLink()) {
+        throw invalidInstalledEntry();
+    }
+    if ((await realpath(installedPath)) !== registryPackageRoot) {
+        throw installedEntryChanged();
+    }
+    return {
+        registryBackupPath: backupPath,
+        registryEntryKind: registryEntry.isSymbolicLink() ? "symbolic-link" : "directory"
+    };
+}
+export function createNodeRegistryLinks(runner, syncDirectory) {
+    return {
+        prepare: prepareRegistryEntry,
+        ignoreLocalState: (consumerRoot) => ensureStateDirectoryIgnored(runner, consumerRoot),
+        replace: (state) => replaceRegistryEntryWithLink(state, join(state.consumerRoot, "node_modules", FOUNDATION_PACKAGE_NAME), syncDirectory),
+        restore: (consumerRoot, dependencySpec, state) => restoreRegistryEntry(consumerRoot, dependencySpec, state, syncDirectory)
+    };
+}
+//# sourceMappingURL=registry-links.js.map

package/dist/local-mode/adapters/node/registry-links.js.map

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

package/dist/local-mode/adapters/node/registry-recovery.d.ts

@@ -0,0 +1,5 @@
+import type { FoundationLinkState } from "../../application/model.js";
+export declare function pathEntryExists(path: string): Promise<boolean>;
+export declare function restoreRegistryEntry(consumerRoot: string, dependencySpec: string, state: FoundationLinkState | undefined, syncDirectory: (path: string) => Promise<void>): Promise<void>;
+export declare function resolveTargetPackageRoot(targetPath: string): Promise<string>;
+//# sourceMappingURL=registry-recovery.d.ts.map

package/dist/local-mode/adapters/node/registry-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-recovery.d.ts","sourceRoot":"","sources":["../../../../src/local-mode/adapters/node/registry-recovery.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAgCtE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAwCD,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlF"}

package/dist/local-mode/adapters/node/registry-recovery.js

@@ -0,0 +1,111 @@
+import { lstat, mkdir, readFile, realpath, rename, rm, stat } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { invalidRecoveryManifest, recoveryPathsOutsideConsumer, invalidRegistryBackup, unprovenRegistryEntry, missingTargetPackage } from "../../application/inspection-failures.js";
+import { FOUNDATION_PACKAGE_NAME, LOCAL_REGISTRY_BACKUP, LOCAL_STATE_DIRECTORY } from "../../application/model.js";
+async function readPackageManifest(path) {
+    const value = JSON.parse(await readFile(join(path, "package.json"), "utf8"));
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw invalidRecoveryManifest(path);
+    }
+    return value;
+}
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function pathEntryExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+async function readPackageEntry(path) {
+    const packageRoot = await realpath(path);
+    return { manifest: await readPackageManifest(packageRoot), packageRoot };
+}
+function isWithin(parent, candidate) {
+    const path = relative(parent, candidate);
+    return path === "" || (!path.startsWith(`..${sep}`) && path !== ".." && !isAbsolute(path));
+}
+function assertRecoveryStatePaths(consumerRoot, state) {
+    const backupPath = join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP);
+    if (resolve(state.consumerRoot) !== consumerRoot ||
+        resolve(state.registryBackupPath) !== backupPath ||
+        !isWithin(join(consumerRoot, "node_modules"), resolve(state.registryPackageRoot))) {
+        throw recoveryPathsOutsideConsumer();
+    }
+}
+function backupRootExpected(consumerRoot, backupRoot, backupPath, state) {
+    if (state === undefined) {
+        return backupRoot === backupPath || isWithin(join(consumerRoot, "node_modules"), backupRoot);
+    }
+    return backupRoot === (state.registryEntryKind === "directory"
+        ? backupPath
+        : resolve(state.registryPackageRoot));
+}
+export async function restoreRegistryEntry(consumerRoot, dependencySpec, state, syncDirectory) {
+    const installedPath = join(consumerRoot, "node_modules", FOUNDATION_PACKAGE_NAME);
+    const backupPath = join(consumerRoot, LOCAL_STATE_DIRECTORY, LOCAL_REGISTRY_BACKUP);
+    if (state !== undefined) {
+        assertRecoveryStatePaths(consumerRoot, state);
+    }
+    if (await pathEntryExists(backupPath)) {
+        const backup = await readPackageEntry(backupPath);
+        if (backup.manifest.name !== FOUNDATION_PACKAGE_NAME ||
+            backup.manifest.version !== dependencySpec ||
+            !backupRootExpected(consumerRoot, backup.packageRoot, backupPath, state)) {
+            throw invalidRegistryBackup();
+        }
+        await rm(installedPath, { force: true, recursive: true });
+        await mkdir(dirname(installedPath), { recursive: true });
+        await rename(backupPath, installedPath);
+        await syncDirectory(dirname(installedPath));
+        await syncDirectory(dirname(backupPath));
+        return;
+    }
+    if (await pathEntryExists(installedPath)) {
+        const installed = await readPackageEntry(installedPath).catch(() => { });
+        const expectedRoot = state === undefined
+            ? installed !== undefined && isWithin(join(consumerRoot, "node_modules"), installed.packageRoot)
+            : installed?.packageRoot === resolve(state.registryPackageRoot);
+        if (installed !== undefined &&
+            expectedRoot &&
+            installed.manifest.name === FOUNDATION_PACKAGE_NAME &&
+            installed.manifest.version === dependencySpec) {
+            return;
+        }
+    }
+    throw unprovenRegistryEntry();
+}
+export async function resolveTargetPackageRoot(targetPath) {
+    const root = await realpath(resolve(targetPath));
+    if (await pathExists(join(root, "package.json"))) {
+        const manifest = await readPackageManifest(root);
+        if (manifest.name === FOUNDATION_PACKAGE_NAME) {
+            return root;
+        }
+    }
+    const workspacePackage = join(root, "packages", "engineering-foundation");
+    if (await pathExists(join(workspacePackage, "package.json"))) {
+        const manifest = await readPackageManifest(workspacePackage);
+        if (manifest.name === FOUNDATION_PACKAGE_NAME) {
+            return await realpath(workspacePackage);
+        }
+    }
+    throw missingTargetPackage();
+}
+//# sourceMappingURL=registry-recovery.js.map

package/dist/local-mode/adapters/node/registry-recovery.js.map

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

package/dist/local-mode/adapters/node/target-reader.d.ts

@@ -0,0 +1,5 @@
+import { type FoundationPackageSelfCheck } from "../../application/package-metadata.js";
+import type { ProcessRunner } from "../../application/model.js";
+import type { LocalTargetReader } from "../../application/ports.js";
+export declare function createNodeLocalTargetReader(runner: ProcessRunner, inspectPackage: (packageRoot: string) => Promise<FoundationPackageSelfCheck>): LocalTargetReader;
+//# sourceMappingURL=target-reader.d.ts.map

package/dist/local-mode/adapters/node/target-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-reader.d.ts","sourceRoot":"","sources":["../../../../src/local-mode/adapters/node/target-reader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmC,KAAK,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAEzH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAgDpE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,0BAA0B,CAAC,GAAG,iBAAiB,CAKlK"}

package/dist/local-mode/adapters/node/target-reader.js

@@ -0,0 +1,48 @@
+import { join } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { targetIsConsumer, invalidTargetSelfCheck, targetSelfCheckMismatch } from "../../application/inspection-failures.js";
+import { parseFoundationPackageSelfCheck } from "../../application/package-metadata.js";
+import { resolveTargetPackageRoot } from "./registry-recovery.js";
+async function verifyTargetPackage(runner, consumerRoot, targetPath, inspectPackage) {
+    const targetPackageRoot = await resolveTargetPackageRoot(targetPath);
+    if (targetPackageRoot === consumerRoot) {
+        throw targetIsConsumer();
+    }
+    const expected = await inspectPackage(targetPackageRoot);
+    const result = await runner.run({
+        command: process.execPath,
+        args: [join(targetPackageRoot, "dist", "cli.js"), "self-check", "--json"],
+        cwd: targetPackageRoot
+    });
+    let actual;
+    try {
+        actual = parseFoundationPackageSelfCheck(JSON.parse(result.stdout));
+    }
+    catch (error) {
+        throw invalidTargetSelfCheck(error);
+    }
+    if (!isDeepStrictEqual(actual, expected)) {
+        throw targetSelfCheckMismatch();
+    }
+    return { targetPackageRoot, packageVersion: expected.packageVersion };
+}
+async function readGitEvidence(runner, consumerRoot, targetPackageRoot) {
+    const gitCommit = (await runner.run({
+        command: "git",
+        args: ["-C", targetPackageRoot, "rev-parse", "HEAD"],
+        cwd: consumerRoot
+    })).stdout.trim();
+    const gitDirty = (await runner.run({
+        command: "git",
+        args: ["-C", targetPackageRoot, "status", "--porcelain"],
+        cwd: consumerRoot
+    })).stdout.trim().length > 0;
+    return { gitCommit, gitDirty };
+}
+export function createNodeLocalTargetReader(runner, inspectPackage) {
+    return {
+        verify: (consumerRoot, targetPath) => verifyTargetPackage(runner, consumerRoot, targetPath, inspectPackage),
+        git: (consumerRoot, targetPackageRoot) => readGitEvidence(runner, consumerRoot, targetPackageRoot)
+    };
+}
+//# sourceMappingURL=target-reader.js.map

package/dist/local-mode/adapters/node/target-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-reader.js","sourceRoot":"","sources":["../../../../src/local-mode/adapters/node/target-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAC7H,OAAO,EAAE,+BAA+B,EAAmC,MAAM,uCAAuC,CAAC;AACzH,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,KAAK,UAAU,mBAAmB,CAChC,MAAqB,EACrB,YAAoB,EACpB,UAAkB,EAClB,cAA4E;IAE5E,MAAM,iBAAiB,GAAG,MAAM,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACrE,IAAI,iBAAiB,KAAK,YAAY,EAAE,CAAC;QACvC,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,IAAI,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC;QACzE,GAAG,EAAE,iBAAiB;KACvB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAY,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,uBAAuB,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;AACxE,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAqB,EACrB,YAAoB,EACpB,iBAAyB;IAEzB,MAAM,SAAS,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC;QAClC,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,CAAC;QACpD,GAAG,EAAE,YAAY;KAClB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAClB,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC;QACjC,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,CAAC;QACxD,GAAG,EAAE,YAAY;KAClB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAqB,EAAE,cAA4E;IAC7I,OAAO;QACL,MAAM,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,CAAC;QAC3G,GAAG,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC;KACnG,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,9 @@
+export { createFoundationPackageArtifactPolicy } from "./application/package-metadata.js";
+export type { FoundationPackageSelfCheck } from "./application/package-metadata.js";
+export type { FoundationStatus, FoundationTransactionAwareStatus, ProcessRunner } from "./application/model.js";
+export type { LocalPackageLifecyclePorts } from "./application/ports.js";
+export { LocalPackageLifecycle } from "./application/service.js";
+export type { FoundationLocalModeServiceOptions } from "./application/ports.js";
+export type { AttachResult, FoundationDevOnlyStatus } from "./application/model.js";
+export { isExactVersion } from "../semantic-version.js";
+//# sourceMappingURL=api.d.ts.map