@orkestrel/scaffold 0.0.81 → 0.0.83

package/dist/agents/skills/orkestrel-publish/scripts/wave.js

@@ -19,6 +19,9 @@ const RUNTIME_FIELDS = ['dependencies', 'peerDependencies'];
 const RANGE_FIELDS = [...RUNTIME_FIELDS, 'devDependencies'];
 const CATALOG = '.claude/agents/orkestrel.md';
 const OFFLINE_REFUSAL = "'catalog' does not take --offline";
+// The vendored host is staged from this package's checkout, so overwriting it from the host deletes
+// and replaces its own canon.
+const SCAFFOLD = '@orkestrel/scaffold';
 const VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u;
 // The checkout runs the `.ts` sources and a built twin under `dist/agents` runs `.js` siblings.
 const EXTENSION = extname(fileURLToPath(import.meta.url));
@@ -223,10 +226,14 @@ function runOverwrite(runner, scaffoldFile, scaffoldPrefix, offline) {
         runStep(runner, 'overwrite', scaffoldFile, [...scaffoldPrefix, 'audit', ...offline], runner.target);
     }
 }
-function runVerify(runner, scaffoldFile, scaffoldPrefix, offline) {
+function runVerify(runner, scaffoldFile, scaffoldPrefix, offline, own) {
     const audit = runStep(runner, 'verify', scaffoldFile, [...scaffoldPrefix, 'audit', '--json', ...offline], runner.target);
     if (audit === undefined)
         return;
+    // The audit reads the canonical sources of scaffold's own checkout as foreign paths and exits 1.
+    if (own && audit.status === 1) {
+        replaceLastStep(runner, 0, 'foreign-path findings are expected on the scaffold checkout');
+    }
     const releases = readReleases(audit.stdout);
     if (releases === undefined) {
         replaceLastStep(runner, audit.status === null || audit.status === 0 ? 2 : audit.status, 'the audit printed no releases envelope');
@@ -327,10 +334,14 @@ function runVisit(argv) {
     if (selected.has('commit') && !failed(runner))
         runCommit(runner);
     if (selected.has('overwrite') && !failed(runner)) {
-        runOverwrite(runner, scaffoldFile, scaffoldPrefix, offline);
+        if (name === SCAFFOLD) {
+            recordStep(runner, 'overwrite', describeCommand(scaffoldFile, [...scaffoldPrefix, 'overwrite', '--json', ...offline]), `skipped with its audit: ${SCAFFOLD} is the package whose checkout the vendored host is staged from`);
+        }
+        else
+            runOverwrite(runner, scaffoldFile, scaffoldPrefix, offline);
     }
     if (selected.has('verify') && !failed(runner)) {
-        runVerify(runner, scaffoldFile, scaffoldPrefix, offline);
+        runVerify(runner, scaffoldFile, scaffoldPrefix, offline, name === SCAFFOLD);
     }
     if (selected.has('install') && !failed(runner))
         runNpmStep(runner, 'install', ['install']);

package/dist/bin/main.js

@@ -1,11 +1,131 @@
 #!/usr/bin/env node
 import { align, renderTable, strip, stripControls, width } from "@orkestrel/console";
 import { attempt, isArray, isError, isInstance, isRecord, isString, parseJSON } from "@orkestrel/contract";
-import { BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, JOURNEY_CONFIG_PATH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, SERVICE_SETUP_PATH, SHOWCASE_CONFIG_PATH, SKILLS_CONFIG_PATH, ScaffoldError, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToRootVite, blueprintToScripts, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isFloorPath, isScaffoldError, manifestToDependencies, manifestToName, nameToGuide, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
+import { AXES, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, ENVIRONMENTS, FRAMEWORKS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, JOURNEY_CONFIG_PATH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, RESERVED_SHEET_NAMES, SERVICE_SETUP_PATH, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, STYLES_ENTRY_PATH, ScaffoldError, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToFaces, blueprintToProjects, blueprintToScripts, blueprintToSheets, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isFloorPath, isScaffoldError, isSheetName, manifestToDependencies, manifestToName, nameToGuide, parseExtension, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
 import { MAX_INVENTORY_PATHS, Materializer, Upstream, filesToHost, isExactCaseFile, isPhysicalDirectory, isWorktree, listFiles, readFileText, readHostFloor, readHostManifest, readSnapshot, resolveContainedPath } from "../src/server/index.js";
 import { createMarkdown, flattenText, isTableNode } from "@orkestrel/markdown";
 import { createSession } from "@orkestrel/process/server";
+import { readdirSync } from "node:fs";
+import { normalize } from "node:path";
 import { parseArgs } from "node:util";
+var package_default = {
+	name: "@orkestrel/scaffold",
+	version: "0.0.83",
+	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
+	keywords: [
+		"audit",
+		"catalog",
+		"new",
+		"overwrite",
+		"repair"
+	],
+	homepage: "https://github.com/orkestrel/scaffold#readme",
+	bugs: "https://github.com/orkestrel/scaffold/issues",
+	license: "MIT",
+	repository: {
+		"type": "git",
+		"url": "git+https://github.com/orkestrel/scaffold.git"
+	},
+	bin: { "scaffold": "dist/bin/main.js" },
+	files: [
+		"dist/src",
+		"dist/bin",
+		"dist/host",
+		"dist/agents",
+		"README.md"
+	],
+	type: "module",
+	sideEffects: ["./src/bin/main.ts", "./dist/bin/main.js"],
+	main: "./dist/src/core/index.cjs",
+	module: "./dist/src/core/index.js",
+	exports: {
+		".": {
+			"import": {
+				"types": "./dist/src/core/index.d.ts",
+				"default": "./dist/src/core/index.js"
+			},
+			"require": {
+				"types": "./dist/src/core/index.d.cts",
+				"default": "./dist/src/core/index.cjs"
+			}
+		},
+		"./server": {
+			"import": {
+				"types": "./dist/src/server/index.d.ts",
+				"default": "./dist/src/server/index.js"
+			},
+			"require": {
+				"types": "./dist/src/server/index.d.cts",
+				"default": "./dist/src/server/index.cjs"
+			}
+		},
+		"./package.json": "./package.json"
+	},
+	publishConfig: { "access": "public" },
+	scripts: {
+		"clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+		"copy": "node -e \"const fs=require('node:fs'),p=require('node:path'),a=process.argv[1],b=process.argv[2];fs.mkdirSync(p.dirname(b),{recursive:true});fs.cpSync(a,b,{force:true});console.log('Copied: '+a+' to '+b)\"",
+		"scaffold": "node ./dist/bin/main.js",
+		"lint": "oxlint --config .oxlintrc.json --fix .",
+		"check": "tsc --noEmit --project tsconfig.json && npm run check:src && npm run check:skills",
+		"check:src": "npm run check:src:core && npm run check:src:server && npm run check:src:bin",
+		"check:src:core": "tsc --noEmit -p configs/src/tsconfig.core.json",
+		"check:src:server": "tsc --noEmit -p configs/src/tsconfig.server.json",
+		"check:src:bin": "tsc --noEmit -p configs/src/tsconfig.bin.json",
+		"check:skills": "tsc --noEmit -p configs/agents/tsconfig.skills.json",
+		"format": "oxfmt --config .oxfmtrc.json --write .",
+		"format:check": "oxfmt --config .oxfmtrc.json --check .",
+		"lint:check": "oxlint --config .oxlintrc.json --deny-warnings .",
+		"test": "npm run test:src:core && npm run test:src:server && npm run test:src:bin && npm run test:policy && npm run test:config && npm run test:setup && npm run test:skills && npm run test:guides",
+		"test:src:core": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:core",
+		"test:src:server": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:server",
+		"test:src:bin": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:bin",
+		"test:policy": "vitest run --config vite.config.ts --no-cache --reporter=dot --project policy",
+		"test:config": "vitest run --config vite.config.ts --no-cache --reporter=dot --project config",
+		"test:guides": "node --experimental-strip-types tests/guides.test.ts",
+		"test:skills": "vitest run --config vite.config.ts --no-cache --reporter=dot --project skills",
+		"test:distribution": "vitest run --config vite.config.ts --no-cache --reporter=dot --project distribution",
+		"test:probe": "vitest run --config vite.config.ts --no-cache --reporter=verbose --project probe",
+		"test:bench": "vitest bench --config vite.config.ts --no-cache --project probe",
+		"test:setup": "vitest run --config vite.config.ts --no-cache --reporter=dot --project setup",
+		"build": "npm run clean && npm run build:src && npm run build:host && npm run build:skills && npm run build:inventory",
+		"build:src": "npm run build:src:core && npm run build:src:server && npm run build:src:bin",
+		"build:src:core": "vite build --config configs/src/vite.core.config.ts && npm run copy dist/src/core/index.d.ts dist/src/core/index.d.cts",
+		"build:src:server": "vite build --config configs/src/vite.server.config.ts && npm run copy dist/src/server/index.d.ts dist/src/server/index.d.cts",
+		"build:src:bin": "vite build --config configs/src/vite.bin.config.ts",
+		"build:host": "node -e \"import('./dist/src/server/index.js').then((m)=>{const n=m.stageHost(process.cwd(),'dist/host',{report: (message) => console.error(message)}).length;console.log('build-host: staged '+n+' file(s) into dist/host')})\"",
+		"build:inventory": "node -e \"import('./dist/src/server/index.js').then((m)=>{const p=process.argv[1]??'host.json',n=m.stageInventory(process.cwd(),p).entries.length;console.log('build-inventory: staged '+n+' file(s) into '+p)})\"",
+		"build:skills": "tsc -p configs/agents/tsconfig.skills.json --noEmit false --allowImportingTsExtensions false --rewriteRelativeImportExtensions --declaration false --sourceMap false --rootDir .agents/skills --outDir dist/agents/skills && npm run copy .agents/templates/brief.md dist/agents/templates/brief.md",
+		"prepack": "npm run build",
+		"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:distribution -- --mode release"
+	},
+	dependencies: {
+		"@orkestrel/console": "^0.0.15",
+		"@orkestrel/contract": "^0.0.19",
+		"@orkestrel/emitter": "^0.0.11",
+		"@orkestrel/markdown": "^0.0.17",
+		"@orkestrel/process": "^0.0.14",
+		"@orkestrel/template": "^0.0.9"
+	},
+	devDependencies: {
+		"@microsoft/api-extractor": "^7.59.3",
+		"@orkestrel/browser": "^0.0.20",
+		"@orkestrel/guide": "^0.0.22",
+		"@orkestrel/html": "^0.0.12",
+		"@orkestrel/probe": "^0.0.19",
+		"@orkestrel/test": "^0.0.24",
+		"@types/node": "^26.6.3",
+		"@vitest/browser-playwright": "^4.1.11",
+		"oxfmt": "^0.71.0",
+		"oxlint": "^1.86.0",
+		"playwright": "^1.63.0",
+		"typescript": "^6.0.3",
+		"vite": "^8.3.2",
+		"vitest": "^4.1.11"
+	},
+	engines: { "node": ">=22.18.0" }
+};
+//#endregion
 //#region src/bin/constants.ts
 /**
 * Names the command the executable installs as.
@@ -17,6 +137,15 @@ import { parseArgs } from "node:util";
 */
 var EXECUTABLE_NAME = "scaffold";
 /**
+* Names the package this executable ships in, as its manifest declares it.
+*
+* @remarks
+* A target declaring this name is the checkout the vendored host is staged
+* from, so `repair` and `overwrite` refuse it: a write from the host would
+* replace that checkout's canon with the copy staged from it.
+*/
+var PACKAGE_NAME = package_default.name;
+/**
 * Lists the {@link Verb} values in usage order, frozen.
 *
 * @remarks
@@ -82,6 +211,13 @@ var COMMAND_OPTIONS = Object.freeze({
 	src: Object.freeze({ type: "string" }),
 	app: Object.freeze({ type: "string" }),
 	bin: Object.freeze({ type: "boolean" }),
+	styles: Object.freeze({ type: "boolean" }),
+	themes: Object.freeze({ type: "boolean" }),
+	showcase: Object.freeze({ type: "boolean" }),
+	extend: Object.freeze({
+		type: "string",
+		multiple: true
+	}),
 	deps: Object.freeze({ type: "string" }),
 	groups: Object.freeze({ type: "string" }),
 	all: Object.freeze({ type: "boolean" }),
@@ -106,6 +242,10 @@ var OPTION_SUMMARY = Object.freeze({
 	"--src <list>": "the published library environments to build: core, browser, server",
 	"--app <list>": "the private application environments to build: core, browser, server",
 	"--bin": "scaffold a command-line executable at src/bin/main.ts",
+	"--styles": "select the base styles surface",
+	"--themes": "select themes; requires --styles",
+	"--showcase": "select the showcase; requires --app browser",
+	"--extend <list>": "select surface:name extensions on the selected surfaces",
 	"--deps <list>": "the @orkestrel/* packages the workspace depends on",
 	"--groups <list>": "the artifact groups to cover; every group when absent",
 	"--all": "fetch a guide for every package the organization publishes, not the declared ones alone",
@@ -131,6 +271,10 @@ var VERB_OPTIONS = Object.freeze({
 		"--src <list>",
 		"--app <list>",
 		"--bin",
+		"--styles",
+		"--themes",
+		"--showcase",
+		"--extend <list>",
 		"--deps <list>",
 		"--offline",
 		"--from <path>",
@@ -383,6 +527,9 @@ function argvToCommand(argv) {
 	const target = isString(values.target) ? values.target : void 0;
 	const json = values.json === true;
 	const [from] = paths;
+	const extensions = isArray(values.extend) ? values.extend.filter(isString) : [];
+	if (extensions.length > 1) throw new UsageError("'new' takes --extend once; combine entries in one list.");
+	const [extension] = extensions;
 	const location = target === void 0 ? {} : { target };
 	const source = from === void 0 ? {} : { from };
 	const selection = isString(values.groups) ? { groups: values.groups } : {};
@@ -398,6 +545,10 @@ function argvToCommand(argv) {
 				...src === void 0 ? {} : { src },
 				...app === void 0 ? {} : { app },
 				...bin ? { bin } : {},
+				...values.styles === true ? { styles: true } : {},
+				...values.themes === true ? { themes: true } : {},
+				...values.showcase === true ? { showcase: true } : {},
+				...extension === void 0 ? {} : { extensions: extension },
 				...offline ? { offline } : {},
 				...dependencies === void 0 ? {} : { dependencies }
 			};
@@ -888,6 +1039,7 @@ function releasesToPins(releases, declared) {
 * Reads the literal Vitest projects, configuration paths, and npm run scripts a shell command names.
 *
 * @param script - The manifest script text to read.
+* @param wrappers - Planned wrapper paths mapped to the face projects they run.
 * @returns The named projects, configurations, and scripts, or `undefined` when the command
 * cannot be read literally.
 *
@@ -906,7 +1058,7 @@ function releasesToPins(releases, declared) {
 * // { projects: ['src:core'], configs: [], scripts: [] }
 * ```
 */
-function scriptToInvocations(script) {
+function scriptToInvocations(script, wrappers = /* @__PURE__ */ new Map()) {
 	const tokens = [];
 	let value = "";
 	let resolved = true;
@@ -983,9 +1135,19 @@ function scriptToInvocations(script) {
 	const projects = [];
 	const configs = [];
 	const scripts = [];
+	const configurations = new Map([...wrappers].map(([path, project]) => [normalize(path), project]));
+	let testing = false;
 	for (let index = 0; index < tokens.length; index += 1) {
 		const token = tokens[index];
 		if (token === void 0) return void 0;
+		if (index === 0 || [
+			"&&",
+			"||",
+			";",
+			"|",
+			"&",
+			"("
+		].includes(tokens[index - 1]?.value ?? "")) testing = token.resolved && token.value === "vitest" && tokens[index + 1]?.value === "run";
 		if (token.value === "npm" && tokens[index + 1]?.value === "run") {
 			const name = tokens[index + 2];
 			if (name === void 0 || !name.resolved || name.value.length === 0 || [
@@ -1012,14 +1174,20 @@ function scriptToInvocations(script) {
 				"(",
 				")"
 			].includes(project.value)) return void 0;
-			(token.value === "--project" ? projects : configs).push(project.value);
+			const names = token.value === "--project" ? projects : configs;
+			names.push(project.value);
+			const face = testing && names === configs ? configurations.get(normalize(project.value)) : void 0;
+			if (face !== void 0) projects.push(face);
 			index += 1;
 			continue;
 		}
 		if (token.value.startsWith("--project=") || token.value.startsWith("--config=")) {
 			const project = token.value.slice(token.value.indexOf("=") + 1);
 			if (!token.resolved || project.length === 0) return void 0;
-			(token.value.startsWith("--project=") ? projects : configs).push(project);
+			const names = token.value.startsWith("--project=") ? projects : configs;
+			names.push(project);
+			const face = testing && names === configs ? configurations.get(normalize(project)) : void 0;
+			if (face !== void 0) projects.push(face);
 			continue;
 		}
 		if (!token.resolved && /--project|--config/.test(token.value)) return void 0;
@@ -1055,6 +1223,96 @@ function targetToEnvironments(target, axis) {
 	});
 }
 /**
+* Reads the styles, themes, and showcase markers a target physically holds.
+* @param target - The target directory.
+* @returns The independent structural facts, false when their markers are absent.
+*/
+function targetToFacts(target) {
+	const styles = resolveContainedPath(target, STYLES_ENTRY_PATH);
+	const themes = resolveContainedPath(target, THEMES_ENTRY_PATH);
+	const barrel = resolveContainedPath(target, THEMES_BARREL_PATH);
+	const wrapper = resolveContainedPath(target, SHOWCASE_CONFIG_PATH);
+	const pages = resolveContainedPath(target, SHOWCASE_PAGES_PATH);
+	return {
+		styles: styles !== void 0 && isExactCaseFile(styles),
+		themes: themes !== void 0 && isExactCaseFile(themes) && barrel !== void 0 && isExactCaseFile(barrel),
+		showcase: wrapper !== void 0 && isExactCaseFile(wrapper) || pages !== void 0 && isPhysicalDirectory(pages)
+	};
+}
+/**
+* Reads browser faces and named sheet marker pairs from a target.
+* @param target - The target directory.
+* @returns Browser extensions in framework order followed by sheets in code-unit order.
+* @throws `ScaffoldError` when sheet markers name an invalid or case-colliding face, or the directory cannot be read.
+*/
+function targetToExtensions(target) {
+	const extensions = [];
+	for (const name of FRAMEWORKS) {
+		const axes = AXES.filter((axis) => {
+			const path = resolveContainedPath(target, `${axis}/${name}`);
+			return path !== void 0 && isPhysicalDirectory(path);
+		});
+		if (axes.length > 0) extensions.push({
+			surface: "browser",
+			name,
+			axes
+		});
+	}
+	const source = resolveContainedPath(target, "src");
+	if (source === void 0 || !isPhysicalDirectory(source)) return extensions;
+	const entries = readdirSync(source, { withFileTypes: true });
+	if (entries.length > MAX_INVENTORY_PATHS) throw new ScaffoldError("TARGET", "The source directory exceeds the inventory limit.");
+	const names = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of entries) {
+		if (!entry.isDirectory() || RESERVED_SHEET_NAMES.includes(entry.name)) continue;
+		const sheet = resolveContainedPath(target, `src/${entry.name}/index.scss`);
+		const marker = resolveContainedPath(target, `src/${entry.name}/${SHEET_ENTRY_NAME}`);
+		if (sheet === void 0 || marker === void 0 || !isExactCaseFile(sheet) || !isExactCaseFile(marker)) continue;
+		const folded = entry.name.toLowerCase();
+		if (seen.has(folded)) throw new ScaffoldError("TARGET", `Case-colliding sheet face '${entry.name}'.`);
+		seen.add(folded);
+		names.push(entry.name);
+	}
+	for (const name of names.sort()) {
+		if (!isSheetName(name)) throw new ScaffoldError("TARGET", `Invalid sheet face '${name}'.`);
+		extensions.push({
+			surface: "styles",
+			name
+		});
+	}
+	return extensions;
+}
+/**
+* Reads a creation extension list and assigns its selected browser axes.
+* @param selection - The comma-separated `surface:name` entries, or no selection.
+* @param axes - The axes selecting a browser environment.
+* @param styles - If `true`, admits stylesheet extensions; if `false`, refuses them.
+* @returns The validated extensions in selection order.
+* @throws `UsageError` when an entry is malformed, repeated, unsupported, or lacks its surface.
+*/
+function selectionToExtensions(selection, axes, styles) {
+	if (selection === void 0) return [];
+	const extensions = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of selection.split(",")) {
+		const extension = parseExtension(entry);
+		if (extension === void 0 || seen.has(entry)) throw new UsageError(`'--extend' refuses '${entry}': use distinct supported surface:name entries.`);
+		seen.add(entry);
+		if (extension.surface === "browser") {
+			if (axes.length === 0) throw new UsageError("A browser extension requires browser in --src or --app.");
+			extensions.push({
+				...extension,
+				axes
+			});
+		} else {
+			if (!styles) throw new UsageError("A styles extension requires --styles.");
+			extensions.push(extension);
+		}
+	}
+	return extensions;
+}
+/**
 * Reads the packages a target's catalog table listed before this run.
 *
 * @param target - The target or raw checkout directory, or a verified value host.
@@ -1396,9 +1654,17 @@ var CLI = class {
 	async #create(command) {
 		const target = command.target ?? command.name;
 		const app = selectionToEnvironments(command.app, "app");
+		const src = selectionToEnvironments(command.src, "src");
+		if (command.themes === true && command.styles !== true) throw new UsageError("--themes requires --styles.");
+		if (command.showcase === true && !app.includes("browser")) throw new UsageError("--showcase requires --app browser.");
+		const axes = AXES.filter((axis) => (axis === "src" ? src : app).includes("browser"));
 		const blueprint = createBlueprint(command.name, {
-			src: selectionToEnvironments(command.src, "src"),
+			src,
 			app,
+			extensions: selectionToExtensions(command.extensions, axes, command.styles === true),
+			styles: command.styles === true,
+			themes: command.themes === true,
+			showcase: command.showcase === true,
 			journey: app.includes("browser"),
 			bin: command.bin === true,
 			setup: [],
@@ -1900,16 +2166,17 @@ var CLI = class {
 		const conformance = resolveContainedPath(target, CONFORMANCE_TEST_PATH);
 		const service = resolveContainedPath(target, SERVICE_SETUP_PATH);
 		const global = resolveContainedPath(target, GLOBAL_SETUP_PATH);
-		const showcase = resolveContainedPath(target, SHOWCASE_CONFIG_PATH);
 		const journey = resolveContainedPath(target, JOURNEY_CONFIG_PATH);
 		const skills = resolveContainedPath(target, SKILLS_CONFIG_PATH);
 		const setup = /* @__PURE__ */ new Set();
 		if (tests !== void 0) for (const path of listFiles(tests)) {
 			if (path.includes("/") || !path.startsWith("setup") || !path.endsWith(".test.ts")) continue;
 			const proof = resolveContainedPath(tests, path);
-			if (proof !== void 0 && isExactCaseFile(proof)) setup.add(path === "setupBrowser.test.ts" ? "browser" : "node");
+			if (proof !== void 0 && isExactCaseFile(proof)) setup.add(path === "setupBrowser.test.ts" || path === "setupStyles.test.ts" ? "browser" : "node");
 		}
 		return createBlueprint(declared.slice(declared.lastIndexOf("/") + 1), {
+			...targetToFacts(target),
+			extensions: targetToExtensions(target),
 			src: targetToEnvironments(target, "src"),
 			app: targetToEnvironments(target, "app"),
 			dependencies: manifestToDependencies(manifest).runtime,
@@ -1920,7 +2187,6 @@ var CLI = class {
 			conformance: conformance !== void 0 && isExactCaseFile(conformance),
 			service: service !== void 0 && isExactCaseFile(service),
 			global: global !== void 0 && isExactCaseFile(global),
-			showcase: showcase !== void 0 && isExactCaseFile(showcase),
 			journey: journey !== void 0 && isExactCaseFile(journey),
 			skills: skills !== void 0 && isExactCaseFile(skills)
 		});
@@ -1929,7 +2195,7 @@ var CLI = class {
 		const text = this.#manifest(target);
 		const writable = writing ? manifestToWritableScripts(text, blueprint) : blueprintToWritableScripts(blueprint);
 		const manifest = replaceManifestScripts(text, writable) ?? text;
-		const planned = blueprintToRootVite(blueprint);
+		const planned = new Set(blueprintToProjects(blueprint));
 		const parsed = parseJSON(manifest);
 		const scripts = isRecord(parsed) && isRecord(parsed.scripts) ? parsed.scripts : {};
 		const gates = !isRecord(parsed) || parsed.private !== true ? ["test", "prepublishOnly"] : ["test"];
@@ -1943,7 +2209,7 @@ var CLI = class {
 				unresolved = true;
 				continue;
 			}
-			for (const project of invoked.projects) if (!planned.includes(`name: { label: '${project}',`)) absent.add(project);
+			for (const project of invoked.projects) if (!planned.has(project)) absent.add(project);
 		}
 		const projects = [...absent].sort();
 		if (unresolved) return {
@@ -1991,6 +2257,14 @@ var CLI = class {
 				if (command !== void 0) expectedLines.set(project, `"${direct}": ${JSON.stringify(command)},`);
 			}
 		}
+		const faces = /* @__PURE__ */ new Set([...blueprintToSheets(blueprint).map((name) => `src:${name}`), ...blueprintToFaces(blueprint).flatMap(({ name, axes }) => axes.map((axis) => `${axis}:${name}`))]);
+		const wrappers = /* @__PURE__ */ new Map();
+		for (const artifact of blueprintToConfigArtifacts(blueprint)) {
+			const match = /^configs\/(src|app)\/vite\.([^.]+)\.config\.ts$/u.exec(artifact.path);
+			if (match === null) continue;
+			const project = `${match[1]}:${match[2]}`;
+			if (faces.has(project)) wrappers.set(artifact.path, project);
+		}
 		const reachable = /* @__PURE__ */ new Set();
 		const chains = /* @__PURE__ */ new Map();
 		for (const gate of gates) {
@@ -2003,7 +2277,7 @@ var CLI = class {
 				visited.add(name);
 				const script = scripts[name];
 				if (!isString(script)) continue;
-				const invoked = scriptToInvocations(script);
+				const invoked = scriptToInvocations(script, wrappers);
 				if (invoked === void 0) {
 					unresolved = true;
 					continue;
@@ -2102,7 +2376,7 @@ var CLI = class {
 			if (proofs.has(`${path.slice(0, -3)}.test.ts`)) return false;
 			if (resolveContainedPath(tests, path) === void 0) return false;
 			const content = (readFileText(tests, path) ?? "").trim();
-			return content !== "" && content !== (seeds.get(`tests/${path}`) ?? "");
+			return /^export /m.test(content) && content !== (seeds.get(`tests/${path}`) ?? "");
 		}).sort();
 		if (modules.length === 0) return void 0;
 		const single = modules.length === 1;
@@ -2118,6 +2392,13 @@ var CLI = class {
 	}
 	#targetQuestions(target, blueprint, groups, writing = false) {
 		const questions = [];
+		const browser = resolveContainedPath(target, "app/browser");
+		if (browser !== void 0 && listFiles(browser).some((path) => path.endsWith(".vue"))) questions.push({
+			field: "extensions",
+			message: "Move Vue components from app/browser to app/vue before regenerating this workspace.",
+			blocking: writing,
+			groups: []
+		});
 		if (!writing) {
 			const script = this.#scriptQuestion(target, blueprint);
 			if (script !== void 0) questions.push(script);
@@ -2130,7 +2411,7 @@ var CLI = class {
 			const setup = this.#setupQuestion(target, blueprint);
 			if (setup !== void 0) questions.push(setup);
 		}
-		return questions.filter((question) => groups === void 0 || question.groups.some((group) => groups.includes(group))).map(({ field, message, blocking, candidates }) => ({
+		return questions.filter((question) => question.blocking || groups === void 0 || question.groups.some((group) => groups.includes(group))).map(({ field, message, blocking, candidates }) => ({
 			field,
 			message,
 			blocking,
@@ -2145,6 +2426,7 @@ var CLI = class {
 		};
 	}
 	#assertTarget(target, blueprint, groups) {
+		if (manifestToName(this.#manifest(target)) === PACKAGE_NAME) throw new ScaffoldError("TARGET", `The target at ${target} is the ${PACKAGE_NAME} package, whose canon the vendored host is staged from. Run repair and overwrite against a workspace that consumes it.`, { target });
 		const questions = this.#targetQuestions(target, blueprint, groups, true);
 		if (questions.length === 0) return;
 		throw new ScaffoldError("TARGET", questions.map((question) => question.message).join(" "), { target });