@orkestrel/scaffold 0.0.5 → 0.0.7

package/dist/src/core/index.cjs

@@ -104,9 +104,12 @@ var APP_MATRIX = Object.freeze({
 * The root docs (`AGENTS.md` / `CLAUDE.md`), `LICENSE`, `.agents`, `.claude`, `.codex`,
 * the four SessionStart hook scripts (`scripts/deps.sh` / `scripts/cursor.sh` /
 * `scripts/codex.sh` / `scripts/ollama.sh`), the repository coding-law policy module,
-* the line's seven byte-identical root dotfiles, and the two guides-grouped mirrors every repo carries: the line-wide
-* dev-tooling guide (`guides/src/guide.md`) and the
-* scaffold engine's own self-guide (`guides/src/scaffold.md`).
+* the line's seven byte-identical root dotfiles, and the two guides-grouped
+* mirror candidates: the line-wide dev-tooling guide
+* (`guides/src/guide.md`) and the scaffold engine's own self-guide
+* (`guides/src/scaffold.md`). `stageHost` vendors both; each plan carries the
+* subset selected by `selectHostPaths`, omitting the target blueprint's own
+* guide.
 */
 var HOST_PATHS = Object.freeze([
 	"AGENTS.md",
@@ -218,15 +221,15 @@ var DEFAULT_VERSION = "0.0.1";
 /** The `engines.node` range the `blueprint` builder fills. */
 var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
-var SCAFFOLD_RANGE = "^0.0.5";
+var SCAFFOLD_RANGE = "^0.0.7";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
 	"@orkestrel/guide": "^0.0.5",
 	"@orkestrel/scaffold": SCAFFOLD_RANGE,
-	"@types/node": "^26.1.1",
-	oxfmt: "^0.60.0",
-	oxlint: "^1.75.0",
+	"@types/node": "^26.1.2",
+	oxfmt: "^0.61.0",
+	oxlint: "^1.76.0",
 	typescript: "^6.0.3",
 	vite: "^8.1.5",
 	"vite-plugin-dts": "^5.0.3",
@@ -1140,6 +1143,22 @@ function snapshotOf(current) {
 	return Object.fromEntries(entries);
 }
 /**
+* Select host paths without the guide owned by the target blueprint.
+*
+* @param paths - Host artifact paths in deterministic input order.
+* @param name - The target blueprint's unscoped package name.
+* @returns Every host path except `guides/src/<name>.md`, in input order.
+*
+* @example
+* ```ts
+* selectHostPaths(['guides/src/guide.md', 'LICENSE'], 'guide') // ['LICENSE']
+* ```
+*/
+function selectHostPaths(paths, name) {
+	const guide = `guides/src/${name}.md`;
+	return paths.filter((path) => path !== guide);
+}
+/**
 * Find the first exact or portable case-insensitive path collision.
 *
 * @param paths - Portable paths in deterministic input order.
@@ -1442,6 +1461,29 @@ function manifestToDependencies(manifestText) {
 	return dependencies;
 }
 /**
+* Project a `package.json` text to its own string `name`.
+*
+* @param manifest - The `package.json` file content.
+* @returns The own string `name`, or `undefined` when the manifest exceeds its
+* byte ceiling, is malformed, has a non-object root, or has no own string
+* `name`.
+*
+* @example
+* ```ts
+* import { manifestToName } from '@orkestrel/scaffold'
+*
+* manifestToName('{"name":"@orkestrel/router"}') // '@orkestrel/router'
+* manifestToName('{}') // undefined
+* ```
+*/
+function manifestToName(manifest) {
+	if (manifest.length > 1048576 || contentByteLength(manifest) > 1048576) return;
+	const parsed = (0, _orkestrel_contract.parseJSON)(manifest);
+	if (!(0, _orkestrel_contract.isRecord)(parsed)) return void 0;
+	const name = ownDataValue(parsed, "name");
+	return typeof name === "string" ? name : void 0;
+}
+/**
 * Compare a declared range to the registry latest.
 *
 * @param range - The declared semver range.
@@ -2146,6 +2188,7 @@ var isPlan = (0, _orkestrel_contract.andOf)((0, _orkestrel_contract.andOf)((0, _
 function validatePlan(plan) {
 	const blueprintValidation = validateBlueprint(plan.blueprint);
 	const questions = [...blueprintValidation.questions];
+	const warnings = [...blueprintValidation.warnings];
 	if (!hasValidPlanBytes(plan)) questions.push({
 		field: "artifacts",
 		text: "Plan artifact content exceeds the retained byte limits",
@@ -2170,16 +2213,20 @@ function validatePlan(plan) {
 			});
 			continue;
 		}
-		if (artifact.path === "package.json") questions.push({
-			field: "overrides",
-			text: "Override path \"package.json\" targets the blueprint-owned publication boundary",
-			blocking: true
-		});
+		if (artifact.path === "package.json") {
+			questions.push({
+				field: "overrides",
+				text: "Override path \"package.json\" targets the blueprint-owned publication boundary",
+				blocking: true
+			});
+			continue;
+		}
+		warnings.push(`Override path "${item.path}" replaces its planned artifact content`);
 	}
 	return {
 		valid: questions.length === 0,
 		questions,
-		warnings: blueprintValidation.warnings
+		warnings
 	};
 }
 /** Determine whether every guide body fits the public UTF-8 artifact byte limit. */
@@ -5555,6 +5602,7 @@ function packageManifest(spec) {
 	}
 	if (spec.engine) scripts["test:src:bin"] = "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:bin";
 	if (spec.engine) scripts["test:integration"] = "vitest run --config vite.config.ts --no-cache --reporter=dot --project integration";
+	if (spec.engine) scripts["test:equivalence"] = "node -e \"const c=require('node:child_process'),n=process.platform==='win32'?'npm.cmd':'npm',r=c.spawnSync(n,['run','test:integration'],{stdio:'inherit',env:{...process.env,SCAFFOLD_BOUNDARY_EQUIVALENCE:'1'}});process.exit(r.status??1)\"";
 	if (spec.app.length > 0) {
 		scripts["test:app"] = "vitest run --config vite.config.ts --no-cache --reporter=dot " + spec.app.map((environment) => `--project ${APP_MATRIX[environment].project}`).join(" ");
 		for (const environment of spec.app) scripts[`test:app:${environment}`] = `vitest run --config vite.config.ts --no-cache --reporter=dot --project ${APP_MATRIX[environment].project}`;
@@ -5715,6 +5763,37 @@ function viteMachinery(src, app = [], engine = false) {
 	};
 }
 /**
+* Render the root Vitest project registration, preserving browser ownership
+* supplied by the caller.
+*
+* @param registrations - Ordered project factory identifiers with optional browser labels.
+* @param browser - Whether the generated configuration carries browser machinery.
+* @returns The rendered root `test` property.
+*
+* @example
+* ```ts
+* renderViteTest([{ project: 'srcCore' }], false)
+* // '\ttest: {\n\t\tprojects: [srcCore],\n\t},'
+* ```
+*/
+function renderViteTest(registrations, browser) {
+	const projects = registrations.map((registration) => registration.project);
+	const inlineProjects = `		projects: [${projects.join(", ")}],`;
+	const renderedProjects = computeColumnWidth(inlineProjects) <= 100 ? inlineProjects : `		projects: [
+${projects.map((project) => `			${project},`).join("\n")}
+		],`;
+	if (!browser) return `	test: {
+${renderedProjects}
+	},`;
+	return `	test: gateBrowserProjects(
+		[
+${registrations.map((registration) => registration.browser === void 0 ? `{ project: ${registration.project} }` : `{ project: ${registration.project}, browser: ${serializeTypeScriptString(registration.browser)} }`).map((registration) => `			${registration},`).join("\n")}
+		],
+		hasChromium,
+		process.argv,
+	),`;
+}
+/**
 * The rendered import / `resolve` header block every `rootViteConfig` shape
 * prefixes — the environment boundary and every guarantee it enforces ship
 * unconditionally; `machinery` selects only the host-specific pipelines layered
@@ -5752,6 +5831,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 		transform: {
 			order: 'pre',
 			async handler(code, id) {
+				if (!isWorkspaceBoundaryModule(id)) return null
 				const restored = /[?&]html-proxy(?:[=&]|$)/.test(id) ? restoreIgnoredHtml(code) : code
 				const target = workspacePath(id)
 				const physicalImporter = physicalPath(id)
@@ -5911,6 +5991,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 		transform: {
 			order: 'pre',
 			async handler(code, id) {
+				if (!isWorkspaceBoundaryModule(id)) return null
 				const target = workspacePath(id)
 				const physicalImporter = physicalPath(id)
 				const importerPackageRoot = trustedPackageRootFor(physicalImporter, trustedPackageRoots)
@@ -5993,6 +6074,7 @@ import { parse as parseVue } from 'vue/compiler-sfc'
 		transform: {
 			order: 'pre',
 			async handler(code, id) {
+				if (!isWorkspaceBoundaryModule(id)) return null
 				const target = workspacePath(id)
 				const physicalImporter = physicalPath(id)
 				const importerPackageRoot = trustedPackageRootFor(physicalImporter, trustedPackageRoots)
@@ -6084,6 +6166,64 @@ ${EXPORT_KEYWORD} function workspacePath(path: string): string | undefined {
 	return relativePath
 }
 
+${EXPORT_KEYWORD} function isBoundaryExemptModule(id: string): boolean {
+	const normalizedId = id.replaceAll('\\\\', '/')
+	const [path] = normalizedId.split(/[?#]/)
+	if (
+		path === undefined ||
+		normalizedId.startsWith('\\0') ||
+		normalizedId.includes('virtual:') ||
+		normalizedId === '@vite/client' ||
+		normalizedId === '@vite/env' ||
+		normalizedId.startsWith('/@id/') ||
+		normalizedId.startsWith('/@vite/') ||
+		normalizedId.startsWith('/__vite') ||
+		normalizedId.startsWith('/__vitest') ||
+		normalizedId.startsWith('@vitest/browser') ||
+		normalizedId.includes('/@vitest/browser/')
+	) {
+		return true
+	}
+	let physicalId: string | undefined
+	try {
+		physicalId = physicalPath(id).replaceAll('\\\\', '/')
+	} catch {
+		physicalId = undefined
+	}
+	for (const candidate of physicalId === undefined ? [path] : [path, physicalId]) {
+		if (candidate.split('/').some((segment) => segment.toLowerCase() === 'node_modules')) {
+			return true
+		}
+	}
+	return false
+}
+
+${EXPORT_KEYWORD} function isWorkspaceBoundaryModule(id: string): boolean {
+	if (isBoundaryExemptModule(id)) return false
+	const normalizedId = id.replaceAll('\\\\', '/')
+	const [path] = normalizedId.split(/[?#]/)
+	if (path === undefined) return false
+	let candidate = path.startsWith('/@fs/') ? path.slice('/@fs/'.length) : path
+	try {
+		if (/^file:/i.test(candidate)) candidate = fileURLToPath(candidate)
+	} catch {
+		return false
+	}
+	const rootRelative = /^\\/(?:app|src)\\/(?:core|browser|server)\\//.test(candidate)
+	const absoluteCandidate = rootRelative
+		? resolvePath(WORKSPACE_ROOT, candidate.slice(1))
+		: isAbsolute(candidate)
+			? candidate
+			: resolvePath(WORKSPACE_ROOT, candidate)
+	const relativeId = relative(WORKSPACE_ROOT, absoluteCandidate).replaceAll('\\\\', '/')
+	return (
+		relativeId !== '..' &&
+		!relativeId.startsWith('../') &&
+		!isAbsolute(relativeId) &&
+		/^(?:app|src)\\/(?:core|browser|server)\\//.test(relativeId)
+	)
+}
+
 ${EXPORT_KEYWORD} function isOutsideWorkspacePath(path: string): boolean {
 	const [pathWithoutQuery] = path.split('?')
 	if (pathWithoutQuery === undefined) return false
@@ -6722,6 +6862,7 @@ ${EXPORT_KEYWORD} function finalizeHtml(): Plugin {
 	const transformed = await transformWithOxc(code, path)
 	const visitor = new Visitor({
 		ImportExpression(node) {
+			if (emitted) return
 			let value: string | undefined
 			if (node.source.type === 'Literal' && typeof node.source.value === 'string') {
 				value = node.source.value
@@ -6820,8 +6961,8 @@ ${needsVue ? `		configureServer(server) {
 			})
 		},
 ` : ""}		async resolveId(source, importer) {
-			if (importer === undefined) return null
-			if (source.startsWith('\\0')) return null
+			if (importer === undefined || !isWorkspaceBoundaryModule(importer)) return null
+			if (isBoundaryExemptModule(source)) return null
 			const normalizedSource = source.replaceAll('\\\\', '/')
 			const sourceError = environmentSourceError(owner, normalizedSource)
 			if (sourceError !== undefined) this.error(sourceError)
@@ -6898,6 +7039,7 @@ ${needsVue ? `		configureServer(server) {
 			return null
 		},
 		async load(id) {
+			if (!isWorkspaceBoundaryModule(id)) return null
 			const physicalImporter = physicalPath(id)
 			const trustedPackageRoot = trustedPackageRootFor(physicalImporter, trustedPackageRoots)
 			const inferredPackageRoot =
@@ -6955,6 +7097,7 @@ ${needsVue ? `		configureServer(server) {
 					const physical = physicalPath(
 						isAbsolute(original) ? original : resolvePath(environmentRoot, original),
 					)
+					if (isBoundaryExemptModule(original) || isBoundaryExemptModule(physical)) continue
 					const target = workspacePath(physical)
 					if (target === undefined) {
 						if (trustedPackageRootFor(physical, trustedPackageRoots) === undefined) {
@@ -6970,6 +7113,7 @@ ${needsVue ? `		configureServer(server) {
 		buildEnd(error) {
 			if (error !== undefined) return
 			for (const id of this.getModuleIds()) {
+				if (!isWorkspaceBoundaryModule(id)) continue
 				const target = workspacePath(id)
 				if (target === undefined) {
 					if (
@@ -7026,7 +7170,58 @@ ${CONST_KEYWORD} resolve = {
 	}, {}),
 }
 
-${needsBrowser ? `${EXPORT_KEYWORD} ${CONST_KEYWORD} ENVIRONMENT_CSS = Object.freeze({
+${needsBrowser ? `${EXPORT_KEYWORD} function gateBrowserProjects(
+	registrations: readonly {
+		readonly project: () => UserConfig
+		readonly browser?: string
+	}[],
+	available: boolean,
+	argv: readonly string[],
+): NonNullable<UserConfig['test']> {
+	const projects: UserConfig[] = []
+	const gated: string[] = []
+	for (const registration of registrations) {
+		if (registration.browser !== undefined && !available) {
+			gated.push(registration.browser)
+			projects.push({
+				resolve,
+				test: {
+					name: { label: registration.browser, color: 'yellow' },
+					include: [],
+					environment: 'node',
+					browser: { enabled: false },
+				},
+			})
+			continue
+		}
+		projects.push(registration.project())
+	}
+	if (gated.length === 0) return { projects }
+	console.warn(\`browser projects skipped: Chromium absent (\${gated.join(', ')})\`)
+	const filters: string[] = []
+	let readable = true
+	for (let index = 0; index < argv.length; index += 1) {
+		const argument = argv[index]
+		if (argument === '--project') {
+			const filter = argv[index + 1]
+			if (filter === undefined) {
+				readable = false
+				continue
+			}
+			filters.push(filter)
+			index += 1
+			continue
+		}
+		if (argument?.startsWith('--project=') === true) {
+			filters.push(argument.slice('--project='.length))
+		}
+	}
+	return readable && filters.length > 0 && filters.every((filter) => gated.includes(filter))
+		? { passWithNoTests: true, projects }
+		: { projects }
+}
+
+${EXPORT_KEYWORD} ${CONST_KEYWORD} ENVIRONMENT_CSS = Object.freeze({
 	transformer: 'lightningcss',
 	lightningcss: {
 		visitor: () => {
@@ -7121,11 +7316,10 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 			},
 			test: {
 				name: { label: 'src:browser', color: 'yellow' },
-				include: hasChromium ? ['tests/src/browser/**/*.test.ts'] : [],
-				passWithNoTests: !hasChromium,
+				include: ['tests/src/browser/**/*.test.ts'],
 				setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
 				browser: {
-					enabled: hasChromium,
+					enabled: true,
 					provider: playwright(),
 					instances: [{ browser: 'chromium', headless: true }],
 				},
@@ -7154,9 +7348,15 @@ ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 
 export default defineConfig({
 	resolve,
-	test: {
-		projects: [srcBrowser, policy, guides],
-	},
+	test: gateBrowserProjects(
+		[
+			{ project: srcBrowser, browser: 'src:browser' },
+			{ project: policy },
+			{ project: guides },
+		],
+		hasChromium,
+		process.argv,
+	),
 })
 `;
 	return `${header}
@@ -7276,12 +7476,11 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 				},
 				test: {
 					name: { label: 'src:browser', color: 'yellow' },
-					include: hasChromium ? ['tests/src/browser/**/*.test.ts'] : [],
-					passWithNoTests: !hasChromium,
+					include: ['tests/src/browser/**/*.test.ts'],
 					exclude: ['tests/src/core/**/*.test.ts'],
 					setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
 					browser: {
-						enabled: hasChromium,
+						enabled: true,
 						provider: playwright(),
 						instances: [{ browser: 'chromium', headless: true }],
 					},
@@ -7379,14 +7578,15 @@ ${EXPORT_KEYWORD} const integration = (config?: UserConfig): UserConfig =>
 	)
 ` : "";
 	const blocks = nonCore.map((environment) => environment === "browser" ? browserBlock : serverBlock).join("") + binBlock;
-	const projectNames = [
-		...hasCore ? ["srcCore"] : [],
-		...nonCore.map((environment) => `src${pascalCase(environment)}`),
-		"policy",
-		"guides",
-		...engine ? ["srcBin"] : [],
-		...engine ? ["integration"] : []
-	];
+	const registrations = [];
+	if (hasCore) registrations.push({ project: "srcCore" });
+	for (const environment of nonCore) registrations.push(environment === "browser" ? {
+		project: "srcBrowser",
+		browser: SRC_MATRIX.browser.project
+	} : { project: "srcServer" });
+	registrations.push({ project: "policy" }, { project: "guides" });
+	if (engine) registrations.push({ project: "srcBin" }, { project: "integration" });
+	const renderedTest = renderViteTest(registrations, machinery.browser);
 	return `${header}
 ${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
@@ -7426,9 +7626,7 @@ ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 ${blocks}
 export default defineConfig({
 	resolve,
-	test: {
-		projects: [${projectNames.join(", ")}],
-	},
+${renderedTest}
 })
 `;
 }
@@ -7450,10 +7648,10 @@ function applicationViteConfig(src, app, engine = false) {
 	const hasSourceCore = src.includes("core");
 	const machinery = viteMachinery(src, app, engine);
 	const header = viteHeader(machinery);
-	const projects = [];
+	const registrations = [];
 	const blocks = [];
 	if (src.includes("core")) {
-		projects.push("srcCore");
+		registrations.push({ project: "srcCore" });
 		blocks.push(`
 ${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
@@ -7475,7 +7673,10 @@ ${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (src.includes("browser")) {
-		projects.push("srcBrowser");
+		registrations.push({
+			project: "srcBrowser",
+			browser: SRC_MATRIX.browser.project
+		});
 		const coreOutput = hasSourceCore ? `
 					output: { paths: { '@src/core': '../core/index.js' } },` : "";
 		const coreExternal = hasSourceCore ? `id === '@src/core' || ` : "";
@@ -7504,11 +7705,10 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 			},
 			test: {
 				name: { label: 'src:browser', color: 'yellow' },
-				include: hasChromium ? ['tests/src/browser/**/*.test.ts'] : [],
-				passWithNoTests: !hasChromium,
+				include: ['tests/src/browser/**/*.test.ts'],
 				${hasSourceCore ? "exclude: ['tests/src/core/**/*.test.ts'],\n				" : ""}setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
 				browser: {
-					enabled: hasChromium,
+					enabled: true,
 					provider: playwright(),
 					instances: [{ browser: 'chromium', headless: true }],
 				},
@@ -7520,7 +7720,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (src.includes("server")) {
-		projects.push("srcServer");
+		registrations.push({ project: "srcServer" });
 		const coreOutput = hasSourceCore ? `
 					output: [
 						{
@@ -7571,7 +7771,7 @@ ${EXPORT_KEYWORD} const srcServer = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (app.includes("core")) {
-		projects.push("appCore");
+		registrations.push({ project: "appCore" });
 		blocks.push(`
 ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
@@ -7592,7 +7792,10 @@ ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (app.includes("browser")) {
-		projects.push("appBrowser()");
+		registrations.push({
+			project: "appBrowser",
+			browser: APP_MATRIX.browser.project
+		});
 		blocks.push(`
 ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 	if (config.length > 0) {
@@ -7633,11 +7836,10 @@ ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 			name: { label: '${APP_MATRIX.browser.project}', color: 'blue' },
 			root: resolveWorkspacePath('.'),
 			dir: resolveWorkspacePath('.'),
-			include: hasChromium ? ['tests/app/browser/**/*.test.ts'] : [],
-			passWithNoTests: !hasChromium,
+			include: ['tests/app/browser/**/*.test.ts'],
 			setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
 			browser: {
-				enabled: hasChromium,
+				enabled: true,
 				provider: playwright(),
 				instances: [{ browser: 'chromium', headless: true }],
 			},
@@ -7648,7 +7850,7 @@ ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 `);
 	}
 	if (app.includes("server")) {
-		projects.push("appServer");
+		registrations.push({ project: "appServer" });
 		blocks.push(`
 ${EXPORT_KEYWORD} const appServer = (config?: UserConfig): UserConfig =>
 	mergeConfig(
@@ -7682,7 +7884,7 @@ ${EXPORT_KEYWORD} const appServer = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (engine) {
-		projects.push("srcBin", "integration");
+		registrations.push({ project: "srcBin" }, { project: "integration" });
 		blocks.push(`
 ${EXPORT_KEYWORD} const srcBin = (config?: UserConfig): UserConfig =>
 	mergeConfig(
@@ -7726,6 +7928,8 @@ ${EXPORT_KEYWORD} const integration = (config?: UserConfig): UserConfig =>
 	)
 `);
 	}
+	registrations.push({ project: "policy" }, { project: "guides" });
+	const renderedTest = renderViteTest(registrations, machinery.browser);
 	return `${header}
 ${policyViteProject()}
 ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
@@ -7746,18 +7950,12 @@ ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 ${blocks.join("")}
 export default defineConfig({
 	resolve,
-	test: {
-		projects: [${[
-		...projects,
-		"policy",
-		"guides"
-	].join(", ")}],
-	},
+${renderedTest}
 })
 `;
 }
 /**
-* `configs/src/tsconfig.core.json` — unchanged core shape.
+* `configs/src/tsconfig.core.json` — host-neutral core with web interop declarations.
 *
 * @returns The core environment `tsconfig` file content, newline-terminated.
 *
@@ -7770,7 +7968,7 @@ function coreTsconfig() {
 	return formatJson({
 		extends: "../../tsconfig.json",
 		compilerOptions: {
-			lib: ["ESNext"],
+			lib: ["ESNext", "WebWorker"],
 			types: [],
 			noEmit: false,
 			declaration: true,
@@ -7925,7 +8123,7 @@ function appTsconfig(environment, hasCore) {
 				"ESNext",
 				"DOM",
 				"DOM.Iterable"
-			] : ["ESNext"],
+			] : environment === "core" ? ["ESNext", "WebWorker"] : ["ESNext"],
 			types: environment === "browser" ? ["vite/client", "vue"] : environment === "server" ? ["node"] : []
 		},
 		include
@@ -8527,12 +8725,15 @@ function guideTests(spec, pascal) {
 }
 /**
 * Draft the `guides` group's artifacts — the package's own filled guide stub,
-* the guides index, and any vendored dependency guide mirrors.
+* the guides index, and vendored dependency guide mirrors whose paths are
+* neither the package's own guide nor already carried by the selected host
+* set.
 *
 * @param spec - The `Blueprint` to derive guide artifacts from.
 * @param pascal - The package's PascalCase entity name.
 * @param members - The blueprint's derived `Member[]`.
-* @returns The `guides` group's `Artifact[]`.
+* @returns The `guides` group's `Artifact[]`, with one contributor per guide
+* path.
 *
 * @example
 * ```ts
@@ -8585,14 +8786,16 @@ function guideArtifacts(spec, pascal, members) {
 		]]),
 		directory: alignTable(["Directory", "Guide"], sourceDirectories.map((directory) => [directory, `[\`${spec.name}.md\`](src/${spec.name}.md)`]))
 	})];
+	const guidePath = `guides/src/${spec.name}.md`;
 	for (const dep of spec.dependencies) {
 		if (!vendoredGuides.includes(dep.name)) continue;
-		const short = dep.name.replace("@orkestrel/", "");
+		const path = `guides/src/${dep.name.replace("@orkestrel/", "")}.md`;
+		if (HOST_PATHS.includes(path) || path === guidePath) continue;
 		artifacts.push({
-			path: `guides/src/${short}.md`,
+			path,
 			group: "guides",
 			origin: "host",
-			source: `guides/src/${short}.md`
+			source: path
 		});
 	}
 	return artifacts;
@@ -8628,7 +8831,7 @@ function applyOverrides(artifacts, overrides) {
 /**
 * The full pure compilation: draft a blueprint's artifacts — the manifest and
 * exports combination rules over the per-environment `SRC_MATRIX` rows, plus
-* `HOST_PATHS` and `overrides` — then pin.
+* the `selectHostPaths` selection of `HOST_PATHS` and `overrides` — then pin.
 *
 * @param blueprint - The `Blueprint` to compile.
 * @param groups - An optional `Group[]` selection (default: all groups).
@@ -8672,7 +8875,7 @@ npm install @orkestrel/${blueprint.name}
 		origin: "computed",
 		content: ciWorkflow(blueprint)
 	});
-	for (const path of HOST_PATHS) {
+	for (const path of selectHostPaths(HOST_PATHS, blueprint.name)) {
 		const group = hostGroup(path);
 		if (!selected.includes(group)) continue;
 		artifacts.push({
@@ -8795,7 +8998,10 @@ var Compiler = class Compiler {
 			this.#emitter.emit("audit", result);
 			return result;
 		}
-		const result = diffPlan(scaffolding.plan, current);
+		const result = {
+			...diffPlan(scaffolding.plan, current),
+			questions: scaffolding.questions
+		};
 		this.#emitter.emit("audit", result);
 		return result;
 	}
@@ -8859,7 +9065,16 @@ var Compiler = class Compiler {
 		const validation = validatePlan(draft);
 		const dependencyQuestions = this.#dependencyQuestions(blueprint);
 		const blocking = [...validation.questions];
-		const questions = [...blocking, ...dependencyQuestions];
+		const warningQuestions = validation.warnings.map((text) => ({
+			field: "overrides",
+			text,
+			blocking: false
+		}));
+		const questions = [
+			...blocking,
+			...warningQuestions,
+			...dependencyQuestions
+		];
 		stages.push({
 			stage: "gate",
 			input: draft,
@@ -8952,9 +9167,11 @@ var Compiler = class Compiler {
 	}
 	#pointerArtifacts(blueprint) {
 		const artifacts = [];
+		const guidePath = `guides/src/${blueprint.name}.md`;
 		for (const item of blueprint.dependencies) {
 			if (Compiler.#vendored.includes(item.name)) continue;
 			const path = `guides/src/${item.name.replace("@orkestrel/", "")}.md`;
+			if (path === guidePath || HOST_PATHS.includes(path)) continue;
 			artifacts.push({
 				path,
 				group: "guides",
@@ -9307,6 +9524,7 @@ exports.isScaffoldError = isScaffoldError;
 exports.isSyncReport = isSyncReport;
 exports.isWorkspaceName = isWorkspaceName;
 exports.manifestToDependencies = manifestToDependencies;
+exports.manifestToName = manifestToName;
 exports.member = member;
 exports.memberShape = memberShape;
 exports.override = override;
@@ -9333,8 +9551,10 @@ exports.rangeToFreshness = rangeToFreshness;
 exports.renderArray = renderArray;
 exports.renderObject = renderObject;
 exports.renderValue = renderValue;
+exports.renderViteTest = renderViteTest;
 exports.rootTsconfig = rootTsconfig;
 exports.rootViteConfig = rootViteConfig;
+exports.selectHostPaths = selectHostPaths;
 exports.serializeTypeScriptString = serializeTypeScriptString;
 exports.singleSrcViteConfig = singleSrcViteConfig;
 exports.snapshotOf = snapshotOf;