@deepseek-ai/dsh-app-boot 0.1.6-alpha.2 → 0.1.7-alpha.2

package/lib/worker/profile-resolution-bootstrap.js

@@ -1,6 +1,6 @@
 import { createRequire, isBuiltin } from "node:module";
 import { getEnvironmentData } from "node:worker_threads";
-import { existsSync, lstatSync, readFileSync, readlinkSync, realpathSync, statSync } from "node:fs";
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 //#region ../../../node_modules/.pnpm/resolve.exports@2.0.3/node_modules/resolve.exports/dist/index.mjs
@@ -41,70 +41,6 @@ function f(e, r, t) {
 	if (e.imports) return n(e.name, e.imports, r, t);
 }
 //#endregion
-//#region lib/types/profile-resolution/legacy-links.js
-/** Legacy profile-link inspection shared by the disk materializer and runtime resolver. */
-/** Profile-private package links projected into its pnpm-managed node_modules. */
-const PROFILE_MODULE_FALLBACK_DIR = ".dsh-module-fallback";
-/**
-* Return whether the process reads application modules from pkg's virtual filesystem.
-* @returns whether pkg owns the module filesystem.
-*/
-function isPackagedExecutable() {
-	return process.pkg !== void 0;
-}
-/**
-* Resolve a directory through the active carrier's filesystem implementation.
-* @param path - directory path to canonicalize.
-* @returns the canonical directory path.
-*/
-function realModuleDirectory(path) {
-	return isPackagedExecutable() ? realpathSync(path) : realpathSync.native(path);
-}
-/**
-* Resolve a link target without following the final path component.
-* @param path - candidate path whose parent is canonicalized.
-* @returns the canonical candidate, or undefined when its parent is absent.
-*/
-function canonicalLinkPath(path) {
-	try {
-		return join(realModuleDirectory(dirname(path)), basename(path));
-	} catch (error) {
-		/* v8 ignore next 2 -- a non-ENOENT realpath failure requires a host filesystem fault */
-		if (error.code === "ENOENT") return void 0;
-		/* v8 ignore next -- see the host-filesystem exception above */
-		throw error;
-	}
-}
-/**
-* Return whether a symlink or junction points at the same path as `target`.
-* @param link - symlink or junction to inspect.
-* @param target - expected target path.
-* @returns whether both paths identify the same entry.
-*/
-function symlinkPointsTo(link, target) {
-	const canonicalActual = canonicalLinkPath(resolve(dirname(link), readlinkSync(link)));
-	const canonicalTarget = canonicalLinkPath(resolve(target));
-	return canonicalActual !== void 0 && canonicalActual === canonicalTarget;
-}
-/**
-* Return whether an observed profile package must not claim local precedence.
-* @param profileDir - profile directory containing the package projection.
-* @param packageName - bare package name to inspect.
-* @returns whether the entry is a managed fallback link or disappeared during inspection.
-*/
-function isProfileModuleFallbackLink(profileDir, packageName) {
-	const link = join(profileDir, "node_modules", packageName);
-	const target = join(profileDir, PROFILE_MODULE_FALLBACK_DIR, "node_modules", packageName);
-	try {
-		return lstatSync(link).isSymbolicLink() && symlinkPointsTo(link, target);
-	} catch (error) {
-		/* v8 ignore next 2 -- a vanished candidate cannot claim local precedence */
-		if (error.code === "ENOENT") return true;
-		/* v8 ignore next -- non-ENOENT lstat/readlink failures require a host filesystem fault */
-		throw error;
-	}
-}
-//#endregion
 //#region lib/types/profile-resolution/resolver.js
 /** In-memory profile package routing for Node's default ESM and CommonJS loaders. */
 const EMPTY_ATTRIBUTES = Object.freeze({});
@@ -133,27 +69,68 @@ function prefixes(path) {
 	const canonical = canonicalPath(path) + sep;
 	return canonical === configured ? [configured] : [configured, canonical];
 }
-function compileGeneration(generation) {
-	const profilePaths = prefixes(generation.profilesDir);
-	const profile = generation.profileDir === void 0 ? [] : prefixes(generation.profileDir);
+function compileResolution(resolution) {
 	return {
-		entries: new Map(generation.entries.map((entry) => [entry.name, entry])),
-		profilesDir: generation.profilesDir,
-		profileDir: generation.profileDir,
-		profilePaths,
-		profileUrls: profilePaths.map((path) => pathToFileURL(path).href),
-		profile,
-		activeProfileUrls: profile.map((path) => pathToFileURL(path).href),
-		localPackageNames: new Set(generation.localPackageNames),
-		shared: new Set(profilePaths.map((prefix) => join(prefix, "node_modules"))),
+		entries: new Map(resolution.entries.map((entry) => [entry.name, entry])),
+		profilesDir: resolution.profilesDir,
+		profileDir: resolution.profileDir,
+		profilePaths: prefixes(resolution.profilesDir),
+		profile: resolution.profileDir === void 0 ? [] : prefixes(resolution.profileDir),
+		installationPaths: [...new Set(resolution.entries.filter((entry) => entry.scope === "installation").flatMap((entry) => prefixes(entry.packageDir)))],
+		linkedPaths: resolution.linkedRoots.flatMap((root) => prefixes(root.realPath)),
+		localPackageNames: new Set(resolution.localPackageNames),
 		esmRoutes: /* @__PURE__ */ new Map(),
 		cjsRoutes: /* @__PURE__ */ new Map()
 	};
 }
+/**
+* The interception layer of a profile is `<profileParent>/node_modules`: an entry occupies its name there, so its
+* subpath misses continue above it, and a name without an entry continues at it.
+*/
+function computeProfileLayer(dir, active) {
+	const profileParent = dirname(dir);
+	return {
+		kind: "profile",
+		active,
+		localPrefix: dir + sep,
+		nativeAfter: join(profileParent, "package.json"),
+		after: join(dirname(profileParent), "package.json")
+	};
+}
+/** The interception layer of a module path: from its profile directory inside a profiles tree, or its linked root. */
+function findInterceptionLayer(path, resolution) {
+	const treeRoot = resolution.profilePaths.find((prefix) => path.startsWith(prefix));
+	const activeProfile = resolution.profile.find((prefix) => path.startsWith(prefix));
+	const dir = treeRoot !== void 0 ? profileChild(path, treeRoot) : activeProfile?.slice(0, -1);
+	if (dir !== void 0) return computeProfileLayer(dir, activeProfile !== void 0);
+	if (!startsWithin(path, resolution.linkedPaths)) return void 0;
+	if (startsWithin(path, resolution.installationPaths)) return void 0;
+	return { kind: "linked" };
+}
+/** Package names a directory's current manifest lists as peers; an unreadable manifest lists none. */
+function readPeerNames(directory) {
+	try {
+		const peers = JSON.parse(readFileSync(join(directory, "package.json"), "utf8")).peerDependencies;
+		return new Set(peers !== null && typeof peers === "object" ? Object.keys(peers) : []);
+	} catch (_error) {
+		return /* @__PURE__ */ new Set();
+	}
+}
 function startsWithin(path, roots) {
 	for (const root of roots) if (path.startsWith(root)) return true;
 	return false;
 }
+/**
+* The profile directory owning a module inside the profiles tree: the first path segment below the tree root.
+* @param path - module path below `treePrefix`.
+* @param treePrefix - profiles directory with a trailing separator.
+* @returns the profile directory without a trailing separator.
+*/
+function profileChild(path, treePrefix) {
+	const rest = path.slice(treePrefix.length);
+	const end = rest.indexOf(sep);
+	return treePrefix + (end < 0 ? rest : rest.slice(0, end));
+}
 function nativePackageDir(parent, name) {
 	for (const searchPath of createRequire(parent).resolve.paths(name)) {
 		const candidate = join(searchPath, name);
@@ -167,10 +144,7 @@ function localPackageCandidate(searchPath, name, flavor) {
 		".js",
 		".json",
 		".node"
-	].some((extension) => existsSync(candidate + extension))) ? {
-		packageDir: candidate,
-		canBeManagedLink: stat !== void 0
-	} : void 0;
+	].some((extension) => existsSync(candidate + extension))) ? candidate : void 0;
 }
 function selfReferenceName(parent) {
 	let current = dirname(parent);
@@ -227,7 +201,7 @@ function packageImportsTarget(parent, request, conditions) {
 }
 function packageSearchPaths(entry, request, cjs) {
 	const name = barePackageName(request);
-	/* v8 ignore next -- fallback routes are created only for bare package requests */
+	/* v8 ignore next -- interception routes are created only for bare package requests */
 	if (name === void 0) return cjs._nodeModulePaths(dirname(entry.declarer));
 	const suffix = sep + name.split("/").join(sep);
 	return entry.packageDir.endsWith(suffix) ? [entry.packageDir.slice(0, -suffix.length)] : cjs._nodeModulePaths(dirname(entry.declarer));
@@ -258,62 +232,100 @@ function isUnselectedPackageMiss(error) {
 }
 function sameResolution(left, right) {
 	if (left === right) return true;
-	const leftPath = left.startsWith("file:") ? fileURLToPath(left) : left;
-	const rightPath = right.startsWith("file:") ? fileURLToPath(right) : right;
-	return canonicalPath(leftPath) === canonicalPath(rightPath);
+	return canonicalPath(left) === canonicalPath(right);
 }
-/** One mutable pointer to immutable generation data. */
+/** One mutable pointer to the immutable runtime resolution. */
 var ResolutionRouter = class {
+	nodeModulePaths;
 	current;
-	constructor(generation) {
-		this.current = compileGeneration(generation);
+	linkedTargets;
+	constructor(resolution, nodeModulePaths) {
+		this.nodeModulePaths = nodeModulePaths;
+		this.current = compileResolution(resolution);
+		this.linkedTargets = new Map(resolution.linkedRoots.map((root) => [root.name, root.realPath]));
 	}
-	replace(generation) {
-		const entries = new Map(generation.entries.map((entry) => [entry.name, entry]));
-		if (generation.profilesDir !== this.current.profilesDir || generation.profileDir !== this.current.profileDir) throw new Error("profile resolution: a generation cannot change its profile scope");
+	replace(successor) {
+		const entries = new Map(successor.entries.map((entry) => [entry.name, entry]));
+		if (successor.profilesDir !== this.current.profilesDir || successor.profileDir !== this.current.profileDir) throw new Error("profile resolution: a successor cannot change its profile scope");
 		for (const [name, current] of this.current.entries) {
 			const next = entries.get(name);
 			if (next === void 0 || !sameResolution(current.packageDir, next.packageDir) || !sameResolution(current.declarer, next.declarer) || current.version !== next.version || current.scope !== next.scope) throw new Error(`profile resolution: replacing ${JSON.stringify(name)} requires a process restart`);
 		}
-		const localPackageNames = new Set(generation.localPackageNames);
+		const localPackageNames = new Set(successor.localPackageNames);
 		for (const name of this.current.localPackageNames) if (!localPackageNames.has(name)) throw new Error(`profile resolution: removing local package ${JSON.stringify(name)} requires a process restart`);
 		for (const name of localPackageNames) if (!this.current.localPackageNames.has(name) && this.current.entries.has(name)) throw new Error(`profile resolution: overriding ${JSON.stringify(name)} locally requires a process restart`);
-		this.current = compileGeneration(generation);
+		for (const root of successor.linkedRoots) {
+			const previous = this.linkedTargets.get(root.name);
+			if (previous !== void 0 && !sameResolution(previous, root.realPath)) throw new Error(`profile resolution: relinking ${JSON.stringify(root.name)} requires a process restart`);
+		}
+		const next = compileResolution(successor);
+		for (const { name, realPath } of successor.linkedRoots) if (!this.linkedTargets.has(name)) this.linkedTargets.set(name, realPath);
+		this.current = next;
+	}
+	/** Whether a module path has an interception layer: it lies in the profiles tree, the active profile, or a linked root. */
+	hasInterceptionLayerForPath(path) {
+		return findInterceptionLayer(path, this.current) !== void 0;
+	}
+	/** Whether an importer URL is scoped; the answer is memoized with the importer's routes. */
+	hasInterceptionLayerForUrl(parentURL) {
+		return this.getOrCreateParentRoutesForUrl(parentURL) !== false;
+	}
+	createParentRoutes(parent, resolution) {
+		const layer = findInterceptionLayer(parent, resolution);
+		return layer === void 0 ? void 0 : {
+			parent,
+			layer,
+			requests: /* @__PURE__ */ new Map()
+		};
 	}
-	routeScoped(request, parentRoutes, generation, flavor, nativeResolve, cacheable = false) {
-		const { parent, profilesDir, requests } = parentRoutes;
+	getOrCreateParentRoutesForUrl(parentURL) {
+		const resolution = this.current;
+		let parentRoutes = resolution.esmRoutes.get(parentURL);
+		if (parentRoutes !== void 0) return parentRoutes;
+		let parent;
+		try {
+			parent = fileURLToPath(parentURL);
+		} catch {
+			parent = void 0;
+		}
+		parentRoutes = parent === void 0 ? false : this.createParentRoutes(parent, resolution) ?? false;
+		resolution.esmRoutes.set(parentURL, parentRoutes);
+		return parentRoutes;
+	}
+	routeScoped(request, parentRoutes, resolution, flavor, cjs) {
+		const { parent, layer, requests } = parentRoutes;
+		const memo = layer.kind === "profile" && (cjs === void 0 || cjs.cacheable);
 		const name = barePackageName(request);
 		if (name === void 0) return void 0;
-		if (parentRoutes.selfReferenceName === void 0) parentRoutes.selfReferenceName = selfReferenceName(parent);
+		if (parentRoutes.selfReferenceName === void 0 || !memo) parentRoutes.selfReferenceName = selfReferenceName(parent);
 		if (parentRoutes.selfReferenceName === name || parentRoutes.selfReferenceName === null) {
 			const state = { route: { kind: "native" } };
-			requests.set(request, state);
+			if (memo) requests.set(request, state);
 			return state;
 		}
-		const target = generation.entries.get(name);
+		if (layer.kind === "linked") return this.routeLinked(request, name, parent, resolution, flavor, cjs);
+		const target = resolution.entries.get(name);
 		const candidates = [];
 		const localSearchPaths = [];
 		for (const searchPath of createRequire(parent).resolve.paths(name)) {
-			if (generation.shared.has(resolve(searchPath))) break;
+			if (!searchPath.startsWith(layer.localPrefix)) break;
 			localSearchPaths.push(searchPath);
 			const candidate = localPackageCandidate(searchPath, name, flavor);
-			if (candidate !== void 0) {
-				if (!(candidate.canBeManagedLink && generation.profile.some((prefix) => candidate.packageDir === join(prefix, "node_modules", name) && isProfileModuleFallbackLink(prefix.slice(0, -1), name)))) candidates.push(candidate);
-			}
+			if (candidate !== void 0) candidates.push(candidate);
 		}
-		if (candidates.length > 0) if (flavor === "cjs" && nativeResolve !== void 0) try {
-			const resolved = nativeResolve(localSearchPaths);
-			const selected = candidates.find((candidate) => localCandidateOwnsResolution(candidate.packageDir, resolved, request, name));
+		if (candidates.length > 0) if (cjs !== void 0) try {
+			const resolved = cjs.resolveNative(localSearchPaths);
+			const selected = candidates.find((candidate) => localCandidateOwnsResolution(candidate, resolved, request, name));
 			if (selected !== void 0) {
 				const state = {
 					route: {
 						kind: "native",
-						packageDir: selected.packageDir
+						packageDir: selected
 					},
-					packageDir: selected.packageDir,
-					...cacheable ? { cjs: resolved } : {}
+					packageDir: selected,
+					cjs: resolved
 				};
-				requests.set(request, state);
+				if (memo) requests.set(request, state);
 				return state;
 			}
 		} catch (error) {
@@ -324,122 +336,120 @@ var ResolutionRouter = class {
 			const state = {
 				route: {
 					kind: "native",
-					packageDir: selected.packageDir
+					packageDir: selected
 				},
-				packageDir: selected.packageDir
+				packageDir: selected
 			};
 			requests.set(request, state);
 			return state;
 		}
-		const eligible = target?.scope === "installation" || target?.scope === "profile" && parentRoutes.activeProfile;
-		const after = join(dirname(profilesDir), "package.json");
-		const route = eligible ? {
-			kind: "fallback",
+		const route = target !== void 0 && (target.scope === "installation" || layer.active) ? {
+			kind: "interception",
 			entry: target,
-			after
+			after: layer.after
 		} : {
-			kind: "after-fallback",
-			parent: after
+			kind: "native-after-interception",
+			parent: layer.nativeAfter
 		};
 		const state = { route };
-		if (route.kind === "fallback") requests.set(request, state);
+		if (route.kind === "interception" && memo) requests.set(request, state);
 		return state;
 	}
-	routeLocalPackage(request, parentRoutes, generation) {
+	routeLinked(request, name, parent, resolution, flavor, cjs) {
+		const target = resolution.entries.get(name);
+		if (target === void 0) return { route: { kind: "native" } };
+		const ancestors = this.nodeModulePaths(dirname(parent));
+		const ancestorSet = new Set(ancestors);
+		const searchPaths = flavor === "esm" ? ancestors : createRequire(parent).resolve.paths(name);
+		for (const searchPath of searchPaths) {
+			const directory = dirname(searchPath);
+			if (ancestorSet.has(searchPath) && readPeerNames(directory).has(name)) {
+				const route = {
+					kind: "interception",
+					entry: target,
+					after: join(dirname(directory), "package.json")
+				};
+				if (cjs === void 0) return { route };
+				try {
+					const resolved = cjs.resolveEntry(target, route.after);
+					if (localCandidateOwnsResolution(target.packageDir, resolved, request, name)) return {
+						route,
+						packageDir: target.packageDir,
+						cjs: resolved
+					};
+				} catch (error) {
+					if (!isUnselectedPackageMiss(error)) throw error;
+				}
+				continue;
+			}
+			const candidate = localPackageCandidate(searchPath, name, flavor);
+			if (candidate === void 0) continue;
+			if (cjs === void 0) return {
+				route: {
+					kind: "native",
+					packageDir: candidate
+				},
+				packageDir: candidate
+			};
+			try {
+				const resolved = cjs.resolveNative([searchPath]);
+				if (localCandidateOwnsResolution(candidate, resolved, request, name)) return {
+					route: {
+						kind: "native",
+						packageDir: candidate
+					},
+					packageDir: candidate,
+					cjs: resolved
+				};
+			} catch (error) {
+				if (!isUnselectedPackageMiss(error)) throw error;
+			}
+		}
+		return cjs === void 0 ? { route: { kind: "native" } } : {
+			route: { kind: "native" },
+			cjs: cjs.resolveNative([])
+		};
+	}
+	routeLocalPackage(request, parentRoutes, resolution) {
 		const name = barePackageName(request);
-		if (name === void 0 || !parentRoutes.activeProfile || !generation.localPackageNames.has(name)) return void 0;
+		const { layer } = parentRoutes;
+		if (name === void 0 || layer.kind !== "profile" || !layer.active || !resolution.localPackageNames.has(name)) return void 0;
 		const state = { route: { kind: "native" } };
 		parentRoutes.requests.set(request, state);
 		return state;
 	}
 	routeUrl(request, parentURL) {
-		const generation = this.current;
-		let parentRoutes = generation.esmRoutes.get(parentURL);
+		const resolution = this.current;
+		const parentRoutes = this.getOrCreateParentRoutesForUrl(parentURL);
 		if (parentRoutes === false) return void 0;
-		const cached = parentRoutes?.requests.get(request);
+		const cached = parentRoutes.requests.get(request);
 		if (cached !== void 0) return cached;
-		if (parentRoutes === void 0) {
-			const profileIndex = generation.profileUrls.findIndex((prefix) => parentURL.startsWith(prefix));
-			const activeProfileIndex = generation.activeProfileUrls.findIndex((prefix) => parentURL.startsWith(prefix));
-			if (profileIndex < 0 && activeProfileIndex < 0) {
-				generation.esmRoutes.set(parentURL, false);
-				return;
-			}
-			let parent;
-			try {
-				parent = fileURLToPath(parentURL);
-			} catch {
-				generation.esmRoutes.set(parentURL, false);
-				return;
-			}
-			const profileRoot = profileIndex >= 0 ? generation.profilePaths[profileIndex] : generation.profile[activeProfileIndex];
-			/* v8 ignore next -- one matching index was established above */
-			if (profileRoot === void 0) return void 0;
-			parentRoutes = {
-				parent,
-				profilesDir: profileRoot.slice(0, -1),
-				activeProfile: activeProfileIndex >= 0,
-				requests: /* @__PURE__ */ new Map()
-			};
-			generation.esmRoutes.set(parentURL, parentRoutes);
-		}
-		const local = this.routeLocalPackage(request, parentRoutes, generation);
+		const local = this.routeLocalPackage(request, parentRoutes, resolution);
 		if (local !== void 0) return local;
-		return this.routeScoped(request, parentRoutes, generation, "esm");
+		return this.routeScoped(request, parentRoutes, resolution, "esm");
 	}
-	routePath(request, parent, nativeResolve, cacheable = false) {
-		const generation = this.current;
-		let parentRoutes = generation.cjsRoutes.get(parent);
+	routePath(request, parent, cjs) {
+		const resolution = this.current;
+		let parentRoutes = resolution.cjsRoutes.get(parent);
 		if (parentRoutes === false) return void 0;
-		const cached = parentRoutes?.requests.get(request);
+		const cached = cjs.cacheable ? parentRoutes?.requests.get(request) : void 0;
 		if (cached !== void 0) return cached;
 		if (parentRoutes === void 0) {
-			const profilesDir = generation.profilePaths.find((prefix) => parent.startsWith(prefix));
-			const activeProfile = generation.profile.find((prefix) => parent.startsWith(prefix));
-			if (profilesDir !== void 0 || activeProfile !== void 0) {
-				const profileRoot = profilesDir ?? activeProfile;
-				/* v8 ignore next -- one matching root was established above */
-				if (profileRoot === void 0) return void 0;
-				parentRoutes = {
-					parent,
-					profilesDir: profileRoot.slice(0, -1),
-					activeProfile: activeProfile !== void 0,
-					requests: /* @__PURE__ */ new Map()
-				};
-				generation.cjsRoutes.set(parent, parentRoutes);
-			}
+			parentRoutes = this.createParentRoutes(parent, resolution) ?? false;
+			resolution.cjsRoutes.set(parent, parentRoutes);
+			if (parentRoutes === false) return void 0;
 		}
-		if (parentRoutes === void 0) {
-			generation.cjsRoutes.set(parent, false);
-			return;
-		}
-		return this.routeScoped(request, parentRoutes, generation, "cjs", nativeResolve, cacheable);
-	}
-	explicitRoute(request, paths) {
-		if (barePackageName(request) === void 0) return void 0;
-		for (const [index, path] of paths.entries()) {
-			const parent = join(resolve(path), ".dsh-profile-resolution.cjs");
-			if (startsWithin(parent, this.current.profilePaths) || startsWithin(parent, this.current.profile)) return {
-				index,
-				parent
-			};
-		}
-	}
-	nativeSelfReference(request, parent) {
-		const name = barePackageName(request);
-		if (name === void 0) return false;
-		const self = selfReferenceName(parent);
-		return self === name || self === null;
+		return this.routeScoped(request, parentRoutes, resolution, "cjs", cjs);
 	}
 	packageDir(specifier, parentURL) {
 		const name = barePackageName(specifier);
 		if (name === void 0) return void 0;
-		const state = this.routeUrl(specifier, parentURL);
-		if (state?.route.kind === "fallback") return state.route.entry.packageDir;
+		const state = this.routeUrl(name, parentURL);
+		if (state?.route.kind === "interception") return state.route.entry.packageDir;
 		if (state?.packageDir !== void 0) return state.packageDir;
 		let parent;
 		try {
-			parent = state?.route.kind === "after-fallback" ? state.route.parent : fileURLToPath(parentURL);
+			parent = state?.route.kind === "native-after-interception" ? state.route.parent : fileURLToPath(parentURL);
 		} catch {
 			return;
 		}
@@ -500,46 +510,21 @@ function throwWithoutCjsAnchor(error, anchor) {
 	}
 	throw error;
 }
-function assertEquivalent(actual, expected, request, parent) {
-	if (sameResolution(actual, expected)) return;
-	throw new Error(`profile resolution mismatch for ${JSON.stringify(request)} from ${parent}: disk resolved ${actual}, generation resolved ${expected}`);
-}
-function assertOptionalEquivalent(actual, expected, request, parent) {
-	if (actual === void 0 && expected === void 0) return;
-	if (actual !== void 0 && expected !== void 0 && sameResolution(actual, expected)) return;
-	throw new Error(`profile resolution mismatch for ${JSON.stringify(request)} from ${parent}: disk selected ${actual ?? "nothing"}, generation selected ${expected ?? "nothing"}`);
-}
 /**
-* Install one profile generation on Node's default ESM and CommonJS resolvers.
-* @param generation - complete package table and profile scope.
-* @param behavior - enforce the generation, or verify a materialized generation.
-* @returns a registration that replaces the generation or restores the native methods.
+* Install one runtime resolution as the interception on Node's default ESM and CommonJS resolvers.
+* @param resolution - complete package table and profile scope.
+* @returns an interception that publishes a successor or restores the native methods.
 */
-function installProfileResolution(generation, behavior = "enforce") {
-	const router = new ResolutionRouter(generation);
+function installRuntimeInterception(resolution) {
 	const { esm, esmDefaultResolve, esmConditions, cjs, cjsConditions, modern } = internalModules();
-	const esmScope = /* @__PURE__ */ new Map();
-	const profilePaths = [...prefixes(generation.profilesDir), ...generation.profileDir === void 0 ? [] : prefixes(generation.profileDir)];
-	const profileUrls = profilePaths.map((path) => pathToFileURL(path).href);
-	let recentEsmParent;
-	let recentEsmScoped = false;
+	const router = new ResolutionRouter(resolution, (directory) => cjs._nodeModulePaths(directory));
 	let delegatedEsm;
 	const adaptEsm = (native) => {
 		const adapted = (request, parent, attributes) => {
 			const delegated = delegatedEsm;
 			/* v8 ignore next -- reentry requires a separate synchronous Node hook; supported launches install none */
 			if (delegated !== void 0 && delegated.parent === parent && delegated.request === request) return native(request, parent, attributes);
-			if (parent === void 0) return native(request, parent, attributes);
-			let scoped = recentEsmParent === parent ? recentEsmScoped : esmScope.get(parent);
-			if (scoped === void 0) {
-				scoped = startsWithin(parent, profileUrls);
-				esmScope.set(parent, scoped);
-			}
-			if (recentEsmParent !== parent) {
-				recentEsmParent = parent;
-				recentEsmScoped = scoped;
-			}
-			if (!scoped) return native(request, parent, attributes);
+			if (parent === void 0 || !router.hasInterceptionLayerForUrl(parent)) return native(request, parent, attributes);
 			const state = router.routeUrl(request, parent);
 			if (state === void 0) {
 				const target = request[0] === "#" ? packageImportsTarget(fileURLToPath(parent), request, esmConditions) : void 0;
@@ -553,16 +538,7 @@ function installProfileResolution(generation, behavior = "enforce") {
 				} catch (error) {
 					return restoreImporter(error);
 				}
-				if (behavior === "enforce") return expected;
-				const actual = native(request, parent, attributes);
-				/* v8 ignore start -- Node 22 is the asynchronous adapter and is covered by the external version matrix */
-				if (expected instanceof Promise || actual instanceof Promise) return Promise.all([actual, expected]).then(([resolved, wanted]) => {
-					assertEquivalent(resolved.url, wanted.url, request, parent);
-					return resolved;
-				});
-				/* v8 ignore stop */
-				assertEquivalent(actual.url, expected.url, request, parent);
-				return actual;
+				return expected;
 			}
 			const cacheable = attributes === EMPTY_ATTRIBUTES || Object.keys(attributes).length === 0;
 			if (cacheable && state.esm !== void 0) return state.esm;
@@ -572,30 +548,7 @@ function installProfileResolution(generation, behavior = "enforce") {
 				if (cacheable && !(result instanceof Promise)) state.esm = result;
 				return result;
 			}
-			const routedParent = pathToFileURL(route.kind === "fallback" ? route.entry.declarer : route.parent).href;
-			if (behavior === "enforce") {
-				const previous = delegatedEsm;
-				delegatedEsm = {
-					parent: routedParent,
-					request
-				};
-				const restoreImporter = (error) => throwWithImporter(error, routedParent, parent);
-				try {
-					let result;
-					try {
-						result = native(request, routedParent, attributes);
-					} catch (error) {
-						return restoreImporter(error);
-					}
-					/* v8 ignore next -- Node 24+ resolves synchronously; the Node 22 matrix covers its Promise result */
-					if (result instanceof Promise) return result.catch(restoreImporter);
-					if (cacheable) state.esm = result;
-					return result;
-				} finally {
-					delegatedEsm = previous;
-				}
-			}
-			const actual = native(request, parent, attributes);
+			const routedParent = pathToFileURL(route.kind === "interception" ? route.entry.declarer : route.parent).href;
 			const previous = delegatedEsm;
 			delegatedEsm = {
 				parent: routedParent,
@@ -603,25 +556,16 @@ function installProfileResolution(generation, behavior = "enforce") {
 			};
 			const restoreImporter = (error) => throwWithImporter(error, routedParent, parent);
 			try {
-				let expected;
+				let result;
 				try {
-					const result = native(request, routedParent, attributes);
-					expected = result;
-					/* v8 ignore next -- Node 24+ resolves synchronously; the Node 22 matrix covers its Promise result */
-					if (result instanceof Promise) expected = result.catch(restoreImporter);
+					result = native(request, routedParent, attributes);
 				} catch (error) {
 					return restoreImporter(error);
 				}
-				/* v8 ignore start -- Node 22 is the asynchronous adapter and is covered by the external version matrix */
-				if (expected instanceof Promise || actual instanceof Promise) return Promise.all([actual, expected]).then(([resolved, wanted]) => {
-					assertEquivalent(resolved.url, wanted.url, request, parent);
-					if (cacheable) state.esm = resolved;
-					return resolved;
-				});
-				/* v8 ignore stop */
-				assertEquivalent(actual.url, expected.url, request, parent);
-				if (cacheable) state.esm = actual;
-				return actual;
+				/* v8 ignore next -- Node 24+ resolves synchronously; the Node 22 matrix covers its Promise result */
+				if (result instanceof Promise) return result.catch(restoreImporter);
+				if (cacheable) state.esm = result;
+				return result;
 			} finally {
 				delegatedEsm = previous;
 			}
@@ -644,7 +588,7 @@ function installProfileResolution(generation, behavior = "enforce") {
 		]) : resolveRequest(request.specifier, parent, request.attributes ?? EMPTY_ATTRIBUTES);
 		loader.resolveSync = wrapped;
 		restoreEsm = () => {
-			/* v8 ignore else -- registrations are disposed in reverse installation order */
+			/* v8 ignore else -- interceptions are disposed in reverse installation order */
 			if (loader.resolveSync === wrapped) loader.resolveSync = original;
 		};
 	} else {
@@ -665,11 +609,11 @@ function installProfileResolution(generation, behavior = "enforce") {
 	const originalFilename = Reflect.get(cjs, "_resolveFilename");
 	let delegatedCjs = 0;
 	const resolveRoutedCjs = (request, routed, parent, main, options) => {
-		const anchor = routed.kind === "fallback" ? routed.entry.declarer : routed.parent;
+		const anchor = routed.kind === "interception" ? routed.entry.declarer : routed.parent;
 		const synthetic = new cjs(anchor);
 		synthetic.parent = parent;
 		synthetic.filename = anchor;
-		synthetic.paths = routed.kind === "fallback" ? packageSearchPaths(routed.entry, request, cjs) : cjs._nodeModulePaths(dirname(anchor));
+		synthetic.paths = routed.kind === "interception" ? packageSearchPaths(routed.entry, request, cjs) : cjs._nodeModulePaths(dirname(anchor));
 		try {
 			return originalFilename.call(cjs, request, synthetic, main, options);
 		} catch (error) {
@@ -678,7 +622,7 @@ function installProfileResolution(generation, behavior = "enforce") {
 	};
 	const resolveNativeCjs = (request, searchPaths, parent, parentFilename, main, conditions) => {
 		const synthetic = new cjs(parentFilename);
-		synthetic.parent = parent;
+		if (parent.parent !== void 0) synthetic.parent = parent.parent;
 		synthetic.filename = parentFilename;
 		synthetic.paths = [...searchPaths];
 		const options = conditions === void 0 ? void 0 : { conditions };
@@ -694,93 +638,58 @@ function installProfileResolution(generation, behavior = "enforce") {
 		if (state === void 0) return resolveFrom(target.parentURL);
 		if (state.route.kind === "native") return resolveFrom(target.parentURL);
 		const route = state.route;
-		if (route.kind === "after-fallback") return resolveFrom(pathToFileURL(route.parent).href);
+		if (route.kind === "native-after-interception") return resolveFrom(pathToFileURL(route.parent).href);
 		return resolveFrom(pathToFileURL(route.entry.declarer).href);
 	};
 	const wrappedFilename = (request, parent, main, options) => {
-		if (delegatedCjs || !parent?.filename) return originalFilename.call(cjs, request, parent, main, options);
+		if (delegatedCjs || !parent?.filename || options?.paths !== void 0) return originalFilename.call(cjs, request, parent, main, options);
 		const parentFilename = parent.filename;
-		const cacheable = options?.paths === void 0 && options?.conditions === void 0;
-		const explicitPaths = Array.isArray(options?.paths) ? options.paths : void 0;
-		if (explicitPaths !== void 0 && router.nativeSelfReference(request, parentFilename)) return originalFilename.call(cjs, request, parent, main, options);
-		const explicit = explicitPaths === void 0 ? void 0 : router.explicitRoute(request, explicitPaths);
-		if (options?.paths !== void 0 && explicit === void 0) return originalFilename.call(cjs, request, parent, main, options);
-		if (explicit !== void 0 && explicitPaths !== void 0 && explicit.index > 0) try {
-			return originalFilename.call(cjs, request, parent, main, {
-				...options,
-				paths: explicitPaths.slice(0, explicit.index)
-			});
-		} catch (error) {
-			if (!isUnselectedPackageMiss(error)) throw error;
-		}
-		const state = router.routePath(request, explicit?.parent ?? parentFilename, (searchPaths) => resolveNativeCjs(request, searchPaths, parent, parentFilename, main, options?.conditions), explicit === void 0 && cacheable);
+		const cacheable = options?.conditions === void 0;
+		const routedOptions = options?.conditions === void 0 ? void 0 : { conditions: options.conditions };
+		const state = router.routePath(request, parentFilename, {
+			cacheable,
+			resolveNative: (searchPaths) => resolveNativeCjs(request, searchPaths, parent, parentFilename, main, options?.conditions),
+			resolveEntry: (entry, after) => {
+				delegatedCjs++;
+				try {
+					return resolveRoutedCjs(request, {
+						kind: "interception",
+						entry,
+						after
+					}, parent, main, routedOptions);
+				} finally {
+					delegatedCjs--;
+				}
+			}
+		});
 		if (state === void 0) {
-			const scoped = startsWithin(parentFilename, profilePaths);
+			const scoped = router.hasInterceptionLayerForPath(parentFilename);
 			const conditions = options?.conditions ?? cjsConditions;
 			const target = request[0] === "#" && scoped ? packageImportsTarget(parentFilename, request, conditions) : void 0;
 			if (target === void 0) return originalFilename.call(cjs, request, parent, main, options);
-			const expected = resolvePackageImportCjs(target, conditions);
-			if (behavior === "enforce") return expected;
-			const actual = originalFilename.call(cjs, request, parent, main, options);
-			assertEquivalent(actual, expected, request, parentFilename);
-			return actual;
+			return resolvePackageImportCjs(target, conditions);
 		}
-		if (cacheable && state.cjs !== void 0) return state.cjs;
+		if (state.cjs !== void 0) return state.cjs;
 		const route = state.route;
 		if (route.kind === "native") {
 			const result = originalFilename.call(cjs, request, parent, main, options);
 			if (cacheable) state.cjs = result;
 			return result;
 		}
-		if (route.kind === "after-fallback" && explicit !== void 0 && explicitPaths !== void 0) try {
-			return originalFilename.call(cjs, request, parent, main, {
-				...options,
-				paths: [dirname(route.parent)]
-			});
-		} catch (error) {
-			if (!isUnselectedPackageMiss(error)) throw error;
-			const remaining = explicitPaths.slice(explicit.index + 1);
-			if (remaining.length === 0) throw error;
-			return wrappedFilename(request, parent, main, {
-				...options,
-				paths: remaining
-			});
-		}
 		delegatedCjs++;
 		try {
-			const routedOptions = options?.conditions === void 0 ? void 0 : { conditions: options.conditions };
 			let expected;
 			try {
 				expected = resolveRoutedCjs(request, route, parent, main, routedOptions);
 			} catch (error) {
-				if (route.kind !== "fallback" || !isUnselectedPackageMiss(error)) throw error;
-				try {
-					expected = resolveRoutedCjs(request, {
-						kind: "after-fallback",
-						parent: route.after
-					}, parent, main, routedOptions);
-				} catch (afterError) {
-					const remaining = explicit === void 0 || explicitPaths === void 0 ? [] : explicitPaths.slice(explicit.index + 1);
-					if (!isUnselectedPackageMiss(afterError) || remaining.length === 0) throw afterError;
-					delegatedCjs--;
-					try {
-						return wrappedFilename(request, parent, main, {
-							...options,
-							paths: remaining
-						});
-					} finally {
-						delegatedCjs++;
-					}
-				}
+				if (route.kind !== "interception" || !isUnselectedPackageMiss(error)) throw error;
+				expected = resolveRoutedCjs(request, {
+					kind: "native-after-interception",
+					parent: route.after
+				}, parent, main, routedOptions);
 			}
-			if (behavior === "enforce") {
-				if (cacheable) state.cjs = expected;
-				return expected;
-			}
-			const actual = originalFilename.call(cjs, request, parent, main, options);
-			assertEquivalent(actual, expected, request, parentFilename);
-			if (cacheable) state.cjs = actual;
-			return actual;
+			if (cacheable) state.cjs = expected;
+			return expected;
 		} finally {
 			delegatedCjs--;
 		}
@@ -788,24 +697,13 @@ function installProfileResolution(generation, behavior = "enforce") {
 	cjs._resolveFilename = wrappedFilename;
 	return {
 		packageDir(specifier, parentURL) {
-			const expected = router.packageDir(specifier, parentURL);
-			if (behavior !== "verify" || !startsWithin(parentURL, profileUrls)) return expected;
-			const name = barePackageName(specifier);
-			if (name === void 0) return expected;
-			let parent;
-			try {
-				parent = fileURLToPath(parentURL);
-			} catch {
-				return expected;
-			}
-			assertOptionalEquivalent(nativePackageDir(parent, name), expected, specifier, parentURL);
-			return expected;
+			return router.packageDir(specifier, parentURL);
 		},
 		replace(next) {
 			router.replace(next);
 		},
 		dispose() {
-			/* v8 ignore else -- registrations are disposed in reverse installation order */
+			/* v8 ignore else -- interceptions are disposed in reverse installation order */
 			if (cjs._resolveFilename === wrappedFilename) cjs._resolveFilename = originalFilename;
 			restoreEsm();
 		}
@@ -813,8 +711,8 @@ function installProfileResolution(generation, behavior = "enforce") {
 }
 //#endregion
 //#region lib/types/profile-resolution/worker-bootstrap.js
-/** Install an inherited profile resolution generation in one Harness-owned Worker. */
+/** Install the inherited runtime resolution in one Harness-owned Worker. */
 const registration = getEnvironmentData("@deepseek-ai/dsh-app-boot/profile-resolution");
-if (registration !== void 0) installProfileResolution(registration.generation, registration.behavior);
+if (registration !== void 0) installRuntimeInterception(registration.resolution);
 //#endregion
 export {};