@orkestrel/scaffold 0.0.49 → 0.0.50

package/README.md

@@ -55,8 +55,10 @@ npx scaffold repair
 ```
 
 Restores each planned path the target is missing or has let drift, then re-audits. A file the
-workspace owns — its manifest, its source, its tests, its README — is written once at creation and
-is never rewritten here.
+workspace owns — its source, its own proofs, its README — is written once at creation and is never
+rewritten here. Two paths are not owned that way: `tests/distribution.test.ts` is restored when it
+is absent and left alone when the workspace has replaced it, and the manifest's script region is
+rewritten when its chain is the one scaffold generated and refused without a write when it is not.
 
 ### `catalog` — refresh the package table and the guide mirrors
 

package/dist/bin/main.js

@@ -3,7 +3,7 @@ import { align, renderTable, strip, stripControls, width } from "@orkestrel/cons
 import { attempt, isRecord, isString, parseJSON } from "@orkestrel/contract";
 import { createMarkdown, flattenText, isTableNode } from "@orkestrel/markdown";
 import { executeSync } from "@orkestrel/process/server";
-import { BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFORMANCE_TEST_PATH, Compiler, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENVIRONMENTS, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, INTEGRATION_TEST_PATH, MAX_MANIFEST_BYTES, SERVICE_SETUP_PATH, SHOWCASE_CONFIG_PATH, ScaffoldError, blueprintToDevDependencies, blueprintToRootVite, blueprintToScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isDeferredPath, isScaffoldError, manifestToDependencies, manifestToName, nameToGuide, replacePlanRanges } from "../src/core/index.js";
+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, MAX_MANIFEST_BYTES, SERVICE_SETUP_PATH, SHOWCASE_CONFIG_PATH, ScaffoldError, blueprintToDevDependencies, blueprintToRootVite, blueprintToScripts, blueprintToTestArtifacts, blueprintToWritableScripts, compareVersions, createBlueprint, extractRangeMajor, extractVersion, isDeferredPath, isScaffoldError, manifestToDependencies, manifestToName, nameToGuide, replaceManifestScripts, replacePlanRanges } from "../src/core/index.js";
 import { Materializer, Upstream, filesToHost, isExactCaseFile, isPhysicalDirectory, isWorktree, listFiles, readFileText, readHostFloor, readSnapshot, resolveContainedPath } from "../src/server/index.js";
 import { parseArgs } from "node:util";
 //#region src/bin/constants.ts
@@ -463,27 +463,43 @@ function auditToExit(audit) {
 	return blocked || drifted ? 1 : 0;
 }
 /**
-* Read the fleet rows and planned foreign tools a target manifest declares.
+* Read the runtime and development rows a writing verb may raise.
 *
 * @param manifest - The target manifest text.
 * @param blueprint - The workspace shape that supplies the planned tool set.
-* @returns The declared fleet rows followed by declared planned foreign rows.
+* @returns The declared fleet rows and planned foreign tools in their writable sections.
 */
-function manifestToPlannedDependencies(manifest, blueprint) {
-	const dependencies = [...dependenciesToFleet(manifestToDependencies(manifest))];
+function manifestToWritableDependencies(manifest, blueprint) {
+	const declared = manifestToDependencies(manifest);
+	const runtime = [...dependenciesToFleet(declared.runtime)];
+	const development = [...dependenciesToFleet(declared.development)];
 	const parsed = parseJSON(manifest);
-	if (!isRecord(parsed)) return dependencies;
-	const runtime = isRecord(parsed.dependencies) ? parsed.dependencies : {};
-	const development = isRecord(parsed.devDependencies) ? parsed.devDependencies : {};
+	if (!isRecord(parsed)) return {
+		runtime,
+		development
+	};
+	const runtimeRecord = isRecord(parsed.dependencies) ? parsed.dependencies : {};
+	const developmentRecord = isRecord(parsed.devDependencies) ? parsed.devDependencies : {};
 	for (const name of Object.keys(blueprintToDevDependencies(blueprint)).sort()) {
 		if (name.startsWith("@orkestrel/")) continue;
-		const range = runtime[name] ?? development[name];
-		if (isString(range)) dependencies.push({
+		const runtimeRange = runtimeRecord[name];
+		if (isString(runtimeRange)) {
+			runtime.push({
+				name,
+				range: runtimeRange
+			});
+			continue;
+		}
+		const developmentRange = developmentRecord[name];
+		if (isString(developmentRange)) development.push({
 			name,
-			range
+			range: developmentRange
 		});
 	}
-	return dependencies;
+	return {
+		runtime,
+		development
+	};
 }
 /**
 * Keep only dependencies published by the Orkestrel fleet.
@@ -730,7 +746,11 @@ var CLI = class CLI {
 		const plan = this.#compile(blueprint);
 		const manifest = plan.artifacts.find((artifact) => artifact.path === "package.json" && artifact.origin !== "host");
 		if (manifest === void 0 || manifest.origin === "host") throw new ScaffoldError("BLOCKED", "The compiled plan carries no replaceable manifest.");
-		const versions = await this.#versions(dependenciesToFleet(manifestToDependencies(manifest.content)), command.offline === true);
+		const declarations = manifestToDependencies(manifest.content);
+		const versions = await this.#versions({
+			runtime: dependenciesToFleet(declarations.runtime),
+			development: dependenciesToFleet(declarations.development)
+		}, command.offline === true);
 		this.#assertVersions(versions);
 		const resolved = replacePlanRanges(plan, versions.pins);
 		if (resolved === void 0) throw new ScaffoldError("BLOCKED", "The compiled plan ranges could not be replaced.");
@@ -760,9 +780,9 @@ var CLI = class CLI {
 		const manifest = this.#manifest(target);
 		const blueprint = this.#derive(target);
 		const groups = this.#groups(command.groups);
-		const declared = manifestToPlannedDependencies(manifest, blueprint);
+		const declared = manifestToWritableDependencies(manifest, blueprint);
 		const versions = await this.#versions(declared, command.offline === true);
-		const questions = [...this.#targetQuestions(target, blueprint), ...releasesToQuestions(versions.releases)];
+		const questions = [...this.#targetQuestions(target, blueprint, groups), ...releasesToQuestions(versions.releases)];
 		const host = await this.#host(command.from, target, command.offline === true);
 		try {
 			const [measured] = this.#survey(host.materializer, blueprint, target, groups);
@@ -794,7 +814,7 @@ var CLI = class CLI {
 		const target = command.target ?? ".";
 		const groups = this.#groups(command.groups);
 		const blueprint = this.#derive(target);
-		this.#assertTarget(target, blueprint);
+		this.#assertTarget(target, blueprint, groups);
 		const host = await this.#host(command.from, target, command.offline === true);
 		try {
 			const [audit, plan] = this.#survey(host.materializer, blueprint, target, groups);
@@ -806,9 +826,12 @@ var CLI = class CLI {
 				else this.#present(audit);
 				return 1;
 			}
-			const versions = await this.#versions(manifestToPlannedDependencies(this.#manifest(target), blueprint), command.offline === true);
+			const versions = await this.#versions(manifestToWritableDependencies(this.#manifest(target), blueprint), command.offline === true);
 			this.#assertVersions(versions);
-			const result = this.#merge(host.materializer.repair(plan, audit, target), host.materializer.declare(versions.pins, target));
+			const result = this.#merge(host.materializer.repair(plan, audit, target), host.materializer.declare({
+				pins: versions.pins,
+				scripts: blueprintToWritableScripts(blueprint)
+			}, target));
 			const [terminal] = this.#survey(host.materializer, this.#derive(target), target, groups);
 			const outcome = {
 				...result,
@@ -838,14 +861,22 @@ var CLI = class CLI {
 		if (extra.length > 0) this.#warn(`Read the data root from ${String(host)}. The other ${String(extra.length)} local root${extra.length === 1 ? "" : "s"} named by --from reach nothing this run does.`);
 		const previous = this.#previous(target);
 		const fetched = await this.#fetch(target, command.all === true);
-		const releases = this.#catalogReleases(dependenciesToFleet(manifestToDependencies(this.#manifest(target))), fetched.entries);
-		const pins = this.#pin(releases);
+		const declarations = manifestToDependencies(this.#manifest(target));
+		const writable = {
+			runtime: dependenciesToFleet(declarations.runtime),
+			development: dependenciesToFleet(declarations.development)
+		};
+		const releases = this.#catalogReleases([...writable.runtime, ...writable.development], fetched.entries);
+		const pins = this.#pin(releases, writable);
 		this.#assertFetched(fetched.entries, fetched.mirrors);
 		const guides = fetched.mirrors.length === 0 ? void 0 : fetched.mirrors.some((mirror) => mirror.lookup === "failed") ? "floor" : "live";
 		const materializer = new Materializer({ host: host ?? readHostFloor() });
 		let result;
 		try {
-			result = this.#merge(this.#publish(materializer, target, fetched.entries, fetched.mirrors), materializer.declare(pins, target));
+			result = this.#merge(this.#publish(materializer, target, fetched.entries, fetched.mirrors), materializer.declare({
+				pins,
+				scripts: []
+			}, target));
 		} finally {
 			materializer.destroy();
 		}
@@ -868,7 +899,7 @@ var CLI = class CLI {
 		const target = command.target ?? ".";
 		const groups = this.#groups(command.groups);
 		const blueprint = this.#derive(target);
-		this.#assertTarget(target, blueprint);
+		this.#assertTarget(target, blueprint, groups);
 		const worktree = this.#worktree(target);
 		if (worktree.dirty.length > 0 && command.dirty !== true) throw new ScaffoldError("TARGET", `The target at ${target} carries ${String(worktree.dirty.length)} uncommitted change${worktree.dirty.length === 1 ? "" : "s"}. Commit them, or pass --dirty to waive the refusal.`, {
 			target,
@@ -885,7 +916,10 @@ var CLI = class CLI {
 				else this.#present(audit);
 				return 1;
 			}
-			const declared = manifestToPlannedDependencies(this.#manifest(target), blueprint);
+			const declared = {
+				pins: manifestToWritableDependencies(this.#manifest(target), blueprint),
+				scripts: blueprintToWritableScripts(blueprint)
+			};
 			const repaired = host.materializer.repair(plan, audit, target);
 			const removed = host.materializer.remove(plan, audit, command.dirty === true ? {
 				tracked: worktree.tracked,
@@ -913,10 +947,13 @@ var CLI = class CLI {
 		}
 	}
 	async #offline(materializer, target, declared, host) {
-		const versions = await this.#versions(declared, true);
+		const versions = await this.#versions(declared.pins, true);
 		this.#assertVersions(versions);
 		return {
-			...materializer.declare(versions.pins, target),
+			...materializer.declare({
+				pins: versions.pins,
+				scripts: declared.scripts
+			}, target),
 			entries: [],
 			mirrors: [],
 			dropped: [],
@@ -933,7 +970,7 @@ var CLI = class CLI {
 		let releases = [];
 		let provenance = { ...host === void 0 ? {} : { host } };
 		try {
-			const versions = await this.#versions(declared, false);
+			const versions = await this.#versions(declared.pins, false);
 			releases = versions.releases;
 			provenance = {
 				...versions.baseline === void 0 ? {} : { versions: versions.baseline },
@@ -948,7 +985,10 @@ var CLI = class CLI {
 				...guides === void 0 ? {} : { guides },
 				...host === void 0 ? {} : { host }
 			};
-			const written = this.#merge(this.#publish(materializer, target, fetched.entries, fetched.mirrors), materializer.declare(versions.pins, target));
+			const written = this.#merge(this.#publish(materializer, target, fetched.entries, fetched.mirrors), materializer.declare({
+				pins: versions.pins,
+				scripts: declared.scripts
+			}, target));
 			const floors = [];
 			if (hostForced) floors.push("host");
 			if (versions.forced) floors.push("versions");
@@ -1004,54 +1044,71 @@ var CLI = class CLI {
 		}
 	}
 	async #versions(declared, offline) {
-		if (declared.length === 0) return {
+		const dependencies = [...declared.runtime, ...declared.development];
+		if (dependencies.length === 0) return {
 			releases: [],
-			pins: [],
+			pins: {
+				runtime: [],
+				development: []
+			},
 			forced: false,
 			complete: true
 		};
-		const floors = dependenciesToFloors(declared);
+		const floors = dependenciesToFloors(dependencies);
+		const floorPins = floors === void 0 ? void 0 : {
+			runtime: floors.slice(0, declared.runtime.length).map((release) => ({
+				name: release.name,
+				range: release.range
+			})),
+			development: floors.slice(declared.runtime.length).map((release) => ({
+				name: release.name,
+				range: release.range
+			}))
+		};
 		if (offline) {
-			if (floors === void 0) return {
+			if (floors === void 0 || floorPins === void 0) return {
 				releases: [],
-				pins: [],
+				pins: {
+					runtime: [],
+					development: []
+				},
 				baseline: "floor",
 				forced: false,
 				complete: false
 			};
 			return {
 				releases: floors,
-				pins: floors.map((release) => ({
-					name: release.name,
-					range: release.range
-				})),
+				pins: floorPins,
 				baseline: "floor",
 				forced: false,
 				complete: true
 			};
 		}
-		const releases = await this.#lookup(declared);
+		const releases = await this.#lookup(dependencies);
 		if (releases.filter((release) => release.lookup === "missing" || release.lookup === "unmatched").length > 0) return {
 			releases,
-			pins: [],
+			pins: {
+				runtime: [],
+				development: []
+			},
 			baseline: "live",
 			forced: false,
 			complete: false
 		};
 		if (releases.some((release) => release.lookup === "failed")) {
-			if (floors === void 0) return {
+			if (floorPins === void 0) return {
 				releases,
-				pins: [],
+				pins: {
+					runtime: [],
+					development: []
+				},
 				baseline: "floor",
 				forced: true,
 				complete: false
 			};
 			return {
 				releases,
-				pins: floors.map((release) => ({
-					name: release.name,
-					range: release.range
-				})),
+				pins: floorPins,
 				baseline: "floor",
 				forced: true,
 				complete: true
@@ -1059,7 +1116,7 @@ var CLI = class CLI {
 		}
 		return {
 			releases,
-			pins: this.#pin(releases),
+			pins: this.#pin(releases, declared),
 			baseline: "live",
 			forced: false,
 			complete: true
@@ -1100,7 +1157,12 @@ var CLI = class CLI {
 	async #fetch(target, all) {
 		const manifest = this.#manifest(target);
 		const own = manifestToName(manifest);
-		const declared = manifestToDependencies(manifest).map((dependency) => dependency.name);
+		const dependencies = manifestToDependencies(manifest);
+		const declared = [...new Set([
+			...dependencies.runtime,
+			...dependencies.development,
+			...dependencies.peer
+		].map((dependency) => dependency.name))];
 		const upstream = new Upstream(this.#upstream);
 		try {
 			const entries = await upstream.catalog();
@@ -1136,16 +1198,26 @@ var CLI = class CLI {
 		if (failed.length === 0) return;
 		throw new ScaffoldError("FETCH", `Upstream produced no complete catalog answer for ${failed.join(", ")}.`, { names: failed.length });
 	}
-	#pin(releases) {
+	#pin(releases, declared) {
 		const refused = releases.filter((release) => release.lookup !== "found");
 		if (refused.length > 0) throw new ScaffoldError("FETCH", `The registry named no release for ${refused.map((release) => release.name).join(", ")}.`, { names: refused.length });
-		return releases.map((release) => {
+		const dependencies = [...declared.runtime, ...declared.development];
+		const pins = [];
+		for (let index = 0; index < releases.length; index += 1) {
+			const release = releases[index];
+			const dependency = dependencies[index];
+			if (release === void 0 || dependency === void 0) throw new ScaffoldError("FETCH", "The release answer has no matching declaration.");
 			if (release.lookup !== "found") throw new ScaffoldError("FETCH", `The registry named no release for ${release.name}.`);
-			return {
-				name: release.name,
+			pins.push({
+				name: dependency.name,
 				range: `^${release.latest}`
-			};
-		});
+			});
+		}
+		if (pins.length !== dependencies.length) throw new ScaffoldError("FETCH", "The release answer does not match the declaration set.");
+		return {
+			runtime: pins.slice(0, declared.runtime.length),
+			development: pins.slice(declared.runtime.length)
+		};
 	}
 	#compile(blueprint, groups) {
 		const compiler = new Compiler();
@@ -1178,7 +1250,6 @@ var CLI = class CLI {
 		const bin = resolveContainedPath(target, BIN_ENTRY_PATH);
 		const tests = resolveContainedPath(target, "tests");
 		const guides = resolveContainedPath(target, GUIDES_TEST_PATH);
-		const distribution = resolveContainedPath(target, DISTRIBUTION_TEST_PATH);
 		const integration = resolveContainedPath(target, INTEGRATION_TEST_PATH);
 		const conformance = resolveContainedPath(target, CONFORMANCE_TEST_PATH);
 		const service = resolveContainedPath(target, SERVICE_SETUP_PATH);
@@ -1187,7 +1258,7 @@ var CLI = class CLI {
 		return createBlueprint(declared.slice(declared.lastIndexOf("/") + 1), {
 			src: this.#probe(target, "src"),
 			app: this.#probe(target, "app"),
-			dependencies: manifestToDependencies(manifest),
+			dependencies: manifestToDependencies(manifest).runtime,
 			bin: bin !== void 0 && isExactCaseFile(bin),
 			setup: tests !== void 0 && listFiles(tests).some((path) => {
 				if (path.includes("/") || !path.startsWith("setup") || !path.endsWith(".test.ts")) return false;
@@ -1195,7 +1266,6 @@ var CLI = class CLI {
 				return proof !== void 0 && isExactCaseFile(proof);
 			}),
 			guides: guides !== void 0 && isExactCaseFile(guides),
-			distribution: distribution !== void 0 && isExactCaseFile(distribution),
 			integration: integration !== void 0 && isExactCaseFile(integration),
 			conformance: conformance !== void 0 && isExactCaseFile(conformance),
 			service: service !== void 0 && isExactCaseFile(service),
@@ -1326,7 +1396,8 @@ var CLI = class CLI {
 		};
 	}
 	#projectQuestion(target, blueprint, writing = false) {
-		const manifest = this.#manifest(target);
+		const text = this.#manifest(target);
+		const manifest = replaceManifestScripts(text, blueprintToWritableScripts(blueprint)) ?? text;
 		const planned = blueprintToRootVite(blueprint);
 		const parsed = parseJSON(manifest);
 		const scripts = isRecord(parsed) && isRecord(parsed.scripts) ? parsed.scripts : {};
@@ -1346,13 +1417,15 @@ var CLI = class CLI {
 		const projects = [...absent].sort();
 		if (unresolved) return {
 			field: "projects",
-			message: `The manifest at ${target} contains a Vitest project expression that cannot be resolved statically.${projects.length === 0 ? "" : ` It also names projects the planned configuration does not register: ${projects.join(", ")}.`} ${writing ? "Replace it with a literal --project value or remove the script before using a scaffold writing verb." : "Replace it with a literal --project value before relying on the planned configuration."}`,
-			blocking: false
+			message: `The manifest at ${target} contains a Vitest project expression that cannot be resolved statically.${projects.length === 0 ? "" : ` It also names projects the planned vite.config.ts does not register: ${projects.join(", ")}.`} ${writing ? "The configs group is blocked. Replace the expression with a literal --project value before selecting configs, or exclude configs from --groups." : "Replace it with a literal --project value before relying on the planned configuration."}`,
+			blocking: false,
+			groups: ["configs"]
 		};
 		if (projects.length > 0) return {
 			field: "projects",
-			message: writing ? `The manifest at ${target} names ${projects.length === 1 ? "a Vitest project" : "Vitest projects"} the planned configuration does not register: ${projects.join(", ")}. To continue, remove the ${projects.length === 1 ? "script that names it" : "scripts that name them"} or do not use scaffold writing verbs on a workspace that needs ${projects.length === 1 ? "a custom Vitest project" : "custom Vitest projects"}.` : `The manifest at ${target} names ${projects.length === 1 ? "a Vitest project" : "Vitest projects"} the planned configuration does not register: ${projects.join(", ")}. Add ${projects.length === 1 ? "the project" : "each project"} to vite.config.ts or remove the ${projects.length === 1 ? "script that names it" : "scripts that name them"}.`,
-			blocking: false
+			message: writing ? `The configs group is blocked because the manifest at ${target} names ${projects.length === 1 ? "a Vitest project" : "Vitest projects"} the planned vite.config.ts does not register: ${projects.join(", ")}. Remove the ${projects.length === 1 ? "script that names it" : "scripts that name them"} before selecting configs, or exclude configs from --groups.` : `The manifest at ${target} names ${projects.length === 1 ? "a Vitest project" : "Vitest projects"} the planned configuration does not register: ${projects.join(", ")}. Add ${projects.length === 1 ? "the project" : "each project"} to vite.config.ts or remove the ${projects.length === 1 ? "script that names it" : "scripts that name them"}.`,
+			blocking: false,
+			groups: ["configs"]
 		};
 		const expected = blueprintToScripts(blueprint);
 		const expectedLines = /* @__PURE__ */ new Map();
@@ -1386,8 +1459,9 @@ var CLI = class CLI {
 		}
 		if (unresolved) return {
 			field: "projects",
-			message: `The manifest at ${target} contains a ${gateNames} chain that cannot be resolved statically. ${writing ? "Replace it with literal npm run script names before using a scaffold writing verb." : "Replace it with literal npm run script names before relying on the planned configuration."}`,
-			blocking: false
+			message: `The manifest at ${target} contains a ${gateNames} chain that cannot be resolved statically. ${writing ? "The configs group is blocked. Replace it with literal npm run script names before selecting configs, or exclude configs from --groups." : "Replace it with literal npm run script names before relying on the planned configuration."}`,
+			blocking: false,
+			groups: ["configs"]
 		};
 		const missing = [...expectedLines].filter(([project]) => !reachable.has(project)).sort(([left], [right]) => left.localeCompare(right));
 		if (missing.length === 0) return void 0;
@@ -1405,8 +1479,9 @@ var CLI = class CLI {
 		}
 		return {
 			field: "projects",
-			message: `The manifest at ${target} does not reach ${names.length === 1 ? "a Vitest project" : "Vitest projects"} the planned configuration registers: ${names.join(", ")}. No chain from ${gateNames} invokes ${names.length === 1 ? "it" : "them"}. ${remedies.join(" ")}`,
-			blocking: false
+			message: `${writing ? "The configs group is blocked because " : ""}the manifest at ${target} does not reach ${names.length === 1 ? "a Vitest project" : "Vitest projects"} the planned configuration registers: ${names.join(", ")}. No chain from ${gateNames} invokes ${names.length === 1 ? "it" : "them"}. ${remedies.join(" ")}${writing ? " Exclude configs from --groups to write another group." : ""}`,
+			blocking: false,
+			groups: ["configs"]
 		};
 	}
 	#dependencyQuestion(target, blueprint, writing = false) {
@@ -1415,8 +1490,9 @@ var CLI = class CLI {
 		const malformed = ["dependencies", "devDependencies"].filter((section) => parsed[section] !== void 0 && !isRecord(parsed[section]));
 		if (malformed.length > 0) return {
 			field: "dependencies",
-			message: `The manifest at ${target} declares ${malformed.join(" and ")} as ${malformed.length === 1 ? "a value" : "values"} that ${malformed.length === 1 ? "is" : "are"} not ${malformed.length === 1 ? "an object" : "objects"}. Replace ${malformed.length === 1 ? "it" : "them"} with ${malformed.length === 1 ? "an object" : "objects"} before ${writing ? "using a scaffold writing verb" : "relying on the planned dependency set"}.`,
-			blocking: false
+			message: `The manifest at ${target} declares ${malformed.join(" and ")} as ${malformed.length === 1 ? "a value" : "values"} that ${malformed.length === 1 ? "is" : "are"} not ${malformed.length === 1 ? "an object" : "objects"}. ${writing ? `The configs and tests groups are blocked. Replace ${malformed.length === 1 ? "it" : "them"} with ${malformed.length === 1 ? "an object" : "objects"} before selecting configs or tests, or exclude those groups from --groups.` : `Replace ${malformed.length === 1 ? "it" : "them"} with ${malformed.length === 1 ? "an object" : "objects"} before relying on the planned dependency set.`}`,
+			blocking: false,
+			groups: ["configs", "tests"]
 		};
 		const dependencies = isRecord(parsed.dependencies) ? parsed.dependencies : {};
 		const development = isRecord(parsed.devDependencies) ? parsed.devDependencies : {};
@@ -1426,20 +1502,56 @@ var CLI = class CLI {
 		const lines = missing.map(([name, range]) => `${JSON.stringify(name)}: ${JSON.stringify(range)},`);
 		return {
 			field: "dependencies",
-			message: `The manifest at ${target} does not declare ${names.length === 1 ? "a planned dependency" : "planned dependencies"}: ${names.join(", ")}. ${writing ? "To continue, add" : "Add"} ${lines.length === 1 ? "this exact dependency line" : "these exact dependency lines"} to dependencies or devDependencies in package.json: ${lines.join(" ")}`,
-			blocking: false
+			message: `The manifest at ${target} does not declare ${names.length === 1 ? "a planned dependency" : "planned dependencies"}: ${names.join(", ")}. ${writing ? "The configs and tests groups are blocked. Add" : "Add"} ${lines.length === 1 ? "this exact dependency line" : "these exact dependency lines"} to dependencies or devDependencies in package.json: ${lines.join(" ")}${writing ? " Add the dependency before selecting configs or tests, or exclude those groups from --groups." : ""}`,
+			blocking: false,
+			groups: ["configs", "tests"]
 		};
 	}
-	#targetQuestions(target, blueprint, writing = false) {
+	#setupQuestion(target, blueprint) {
+		const tests = resolveContainedPath(target, "tests");
+		if (tests === void 0) return void 0;
+		const entries = listFiles(tests).filter((path) => !path.includes("/"));
+		const proofs = new Set(entries.filter((path) => path.endsWith(".test.ts")));
+		const seeds = new Map(blueprintToTestArtifacts(blueprint).map(({ path, content }) => [path, content.trim()]));
+		const modules = entries.filter((path) => {
+			if (!path.startsWith("setup") || !path.endsWith(".ts")) return false;
+			if (path.endsWith(".test.ts") || HOST_PATHS.includes(`tests/${path}`)) return false;
+			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}`) ?? "");
+		}).sort();
+		if (modules.length === 0) return void 0;
+		const single = modules.length === 1;
+		const named = modules.map((path) => `tests/${path}`).join(", ");
+		const remedies = modules.map((path) => `tests/${path.slice(0, -3)}.test.ts`).join(", ");
+		const remedy = single ? `Add ${remedies} to cover it.` : `Add ${remedies}, each covering the module of the same name.`;
+		return {
+			field: "setup",
+			message: `The target at ${target} carries ${single ? "a test setup module" : "test setup modules"} that no proof covers: ${named}. ${remedy} The proof's subject is behavior only this workspace can assert, so scaffold does not write it.`,
+			blocking: false,
+			groups: ["tests"]
+		};
+	}
+	#targetQuestions(target, blueprint, groups, writing = false) {
 		const questions = [];
 		const project = this.#projectQuestion(target, blueprint, writing);
 		if (project !== void 0) questions.push(project);
 		const dependency = this.#dependencyQuestion(target, blueprint, writing);
 		if (dependency !== void 0) questions.push(dependency);
-		return questions;
+		if (!writing) {
+			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 }) => ({
+			field,
+			message,
+			blocking,
+			...candidates === void 0 ? {} : { candidates }
+		}));
 	}
-	#assertTarget(target, blueprint) {
-		const questions = this.#targetQuestions(target, blueprint, true);
+	#assertTarget(target, blueprint, groups) {
+		const questions = this.#targetQuestions(target, blueprint, groups, true);
 		if (questions.length === 0) return;
 		throw new ScaffoldError("TARGET", questions.map((question) => question.message).join(" "), { target });
 	}