@orkestrel/scaffold 0.0.5 → 0.0.6

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.6";
 /** 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. */
@@ -7097,6 +7144,7 @@ function singleSrcViteConfig(environment) {
 	const machinery = viteMachinery([environment]);
 	const header = viteHeader(machinery);
 	if (environment === "browser") return `${header}
+if (!hasChromium) console.warn('browser projects skipped: Chromium absent (${SRC_MATRIX.browser.project})')
 ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
@@ -7155,7 +7203,7 @@ ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 export default defineConfig({
 	resolve,
 	test: {
-		projects: [srcBrowser, policy, guides],
+		projects: [...(hasChromium ? [srcBrowser] : []), policy, guides],
 	},
 })
 `;
@@ -7381,14 +7429,18 @@ ${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)}`),
+		...nonCore.map((environment) => environment === "browser" ? "...(hasChromium ? [srcBrowser] : [])" : `src${pascalCase(environment)}`),
 		"policy",
 		"guides",
 		...engine ? ["srcBin"] : [],
 		...engine ? ["integration"] : []
 	];
+	const inlineProjects = `		projects: [${projectNames.join(", ")}],`;
+	const renderedProjects = computeColumnWidth(inlineProjects) <= 100 ? inlineProjects : `		projects: [
+${projectNames.map((project) => `			${project},`).join("\n")}
+		],`;
 	return `${header}
-${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
+${machinery.browser ? `if (!hasChromium) console.warn('browser projects skipped: Chromium absent (${SRC_MATRIX.browser.project})')\n` : ""}${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
 			resolve,
@@ -7427,7 +7479,7 @@ ${blocks}
 export default defineConfig({
 	resolve,
 	test: {
-		projects: [${projectNames.join(", ")}],
+${renderedProjects}
 	},
 })
 `;
@@ -7475,7 +7527,7 @@ ${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (src.includes("browser")) {
-		projects.push("srcBrowser");
+		projects.push("...(hasChromium ? [srcBrowser] : [])");
 		const coreOutput = hasSourceCore ? `
 					output: { paths: { '@src/core': '../core/index.js' } },` : "";
 		const coreExternal = hasSourceCore ? `id === '@src/core' || ` : "";
@@ -7592,7 +7644,7 @@ ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (app.includes("browser")) {
-		projects.push("appBrowser()");
+		projects.push("...(hasChromium ? [appBrowser()] : [])");
 		blocks.push(`
 ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 	if (config.length > 0) {
@@ -7726,8 +7778,22 @@ ${EXPORT_KEYWORD} const integration = (config?: UserConfig): UserConfig =>
 	)
 `);
 	}
+	const projectNames = [
+		...projects,
+		"policy",
+		"guides"
+	];
+	const inlineProjects = `		projects: [${projectNames.join(", ")}],`;
+	const renderedProjects = computeColumnWidth(inlineProjects) <= 100 ? inlineProjects : `		projects: [
+${projectNames.map((project) => `			${project},`).join("\n")}
+		],`;
+	const browserProjects = [...src.includes("browser") ? [SRC_MATRIX.browser.project] : [], ...app.includes("browser") ? [APP_MATRIX.browser.project] : []];
+	const browserNotice = serializeTypeScriptString(`browser projects skipped: Chromium absent (${browserProjects.join(", ")})`);
+	const inlineBrowserNotice = `if (!hasChromium) console.warn(${browserNotice})`;
+	const renderedBrowserNotice = browserProjects.length === 0 ? void 0 : computeColumnWidth(inlineBrowserNotice) <= 100 ? inlineBrowserNotice : `if (!hasChromium)
+	console.warn(${browserNotice})`;
 	return `${header}
-${policyViteProject()}
+${renderedBrowserNotice === void 0 ? "" : `${renderedBrowserNotice}\n`}${policyViteProject()}
 ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
@@ -7747,17 +7813,13 @@ ${blocks.join("")}
 export default defineConfig({
 	resolve,
 	test: {
-		projects: [${[
-		...projects,
-		"policy",
-		"guides"
-	].join(", ")}],
+${renderedProjects}
 	},
 })
 `;
 }
 /**
-* `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 +7832,7 @@ function coreTsconfig() {
 	return formatJson({
 		extends: "../../tsconfig.json",
 		compilerOptions: {
-			lib: ["ESNext"],
+			lib: ["ESNext", "WebWorker"],
 			types: [],
 			noEmit: false,
 			declaration: true,
@@ -7925,7 +7987,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 +8589,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 +8650,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 +8695,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 +8739,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 +8862,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 +8929,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 +9031,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 +9388,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;
@@ -9335,6 +9417,7 @@ exports.renderObject = renderObject;
 exports.renderValue = renderValue;
 exports.rootTsconfig = rootTsconfig;
 exports.rootViteConfig = rootViteConfig;
+exports.selectHostPaths = selectHostPaths;
 exports.serializeTypeScriptString = serializeTypeScriptString;
 exports.singleSrcViteConfig = singleSrcViteConfig;
 exports.snapshotOf = snapshotOf;