@orkestrel/scaffold 0.0.108 → 0.0.109

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.108",
+	version: "0.0.109",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -81,7 +81,7 @@ var package_default = {
 		"test:templates": "vitest run --config vite.config.ts --no-cache --reporter=dot --project templates",
 		"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:bench": "vitest bench --config vite.config.ts --no-cache --project \"probe (bench)\" --mode benchmark",
 		"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",
@@ -103,25 +103,24 @@ var package_default = {
 		"@orkestrel/template": "^0.0.10"
 	},
 	devDependencies: {
-		"@microsoft/api-extractor": "^7.59.4",
+		"@microsoft/api-extractor": "^7.60.0",
 		"@orkestrel/browser": "^0.0.29",
 		"@orkestrel/guide": "^0.0.25",
 		"@orkestrel/html": "^0.0.12",
-		"@orkestrel/probe": "^0.0.24",
-		"@orkestrel/test": "^0.0.29",
+		"@orkestrel/probe": "^0.0.25",
+		"@orkestrel/test": "^0.0.30",
 		"@types/node": "^24.19.2",
-		"@vitest/browser-playwright": "^4.1.11",
-		"oxfmt": "^0.74.0",
-		"oxlint": "^1.89.0",
-		"playwright": "^1.63.0",
-		"typescript": "^6.0.3",
+		"@vitest/browser-playwright": "^5.0.5",
+		"oxfmt": "^0.75.0",
+		"oxlint": "^1.90.0",
+		"playwright": "^1.64.1",
+		"typescript": "^7.0.2",
 		"vite": "^8.3.5",
-		"vitest": "^4.1.12"
+		"vitest": "^5.0.5"
 	},
 	engines: { "node": ">=22.18.0" }
 };
-//#endregion
-//#region src/core/constants.ts
+// src/core/constants.ts
 /**
 * Lists the `Environment` values, frozen.
 *
@@ -440,19 +439,19 @@ var CATALOG_AGENT_PATH = ".claude/agents/orkestrel.md";
 *
 * @remarks
 * The catalog verb rewrites the region between this marker and
-* {@link CATALOG_CLOSING_MARKER} and leaves every other byte of the file alone,
+* {@link CATALOG_END_MARKER} and leaves every other byte of the file alone,
 * so the writer and every proof that reads the rendered file read the pair from
 * here rather than repeating a literal that only agrees by inspection.
 */
-var CATALOG_OPENING_MARKER = "<!-- orkestrel:catalog -->";
+var CATALOG_START_MARKER = "<!-- orkestrel:catalog -->";
 /**
 * Names the marker closing the package table inside {@link CATALOG_AGENT_PATH}.
 *
 * @remarks
-* It pairs with {@link CATALOG_OPENING_MARKER}; a file missing either marker is
+* It pairs with {@link CATALOG_START_MARKER}; a file missing either marker is
 * refused rather than rewritten.
 */
-var CATALOG_CLOSING_MARKER = "<!-- /orkestrel:catalog -->";
+var CATALOG_END_MARKER = "<!-- /orkestrel:catalog -->";
 /**
 * Lists the package-facing skills a target receives pointers for, frozen and alphabetical.
 *
@@ -658,7 +657,7 @@ var WORKSPACE_DEV_ENGINES = Object.freeze({ packageManager: Object.freeze({
 	version: `>=${MINIMUM_NPM_VERSION}`,
 	onFail: "error"
 }) });
-/** Holds the tooling versions scaffold and every generated workspace share. */
+/** Holds the baseline tooling versions, before framework holds apply. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@orkestrel/guide": package_default.devDependencies["@orkestrel/guide"],
 	"@orkestrel/probe": package_default.devDependencies["@orkestrel/probe"],
@@ -672,6 +671,19 @@ var BASE_DEV_DEPENDENCIES = Object.freeze({
 	vitest: package_default.devDependencies.vitest
 });
 /**
+* Holds foreign tool ranges required by selected browser frameworks, frozen.
+*
+* @remarks
+* A selected framework overrides the baseline floor with its held range. `audit` names the hold
+* where it would report a newer served major and reports a declaration past that hold. The
+* constants proof ties the held range to the baseline manifest and the framework's planned range.
+*/
+var TOOLCHAIN_HOLDS = Object.freeze({ typescript: Object.freeze({
+	framework: "vue",
+	range: "^6.0.3",
+	reason: "Vue workspaces require TypeScript 6.0.3 because no stable vue-tsc runs on TypeScript 7: @volar/typescript@2.4.30 declares peer typescript <7, and the TypeScript 7.0 announcement directs Vue projects to stay on TypeScript 6.0"
+}) });
+/**
 * Lists the development dependencies that roll declarations up for published source.
 *
 * @remarks
@@ -695,6 +707,45 @@ var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 */
 var BROWSE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/browser": package_default.devDependencies["@orkestrel/browser"] });
 /**
+* Names the development dependency a browser application's journey axis adds.
+*
+* @remarks
+* Scaffold does not install this package, so its range is a seed. The planner withholds it
+* from the workspaces {@link CAPTURE_UPSTREAM} lists.
+*
+* @example
+* ```ts
+* import { CAPTURE_DEV_DEPENDENCIES } from '@orkestrel/scaffold'
+*
+* CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.1'
+* ```
+*/
+var CAPTURE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/capture": "^0.0.1" });
+/**
+* Lists the capture package and its fleet runtime dependency closure, frozen.
+*
+* @remarks
+* The sorted list includes `@orkestrel/capture` and its transitive `@orkestrel/*` dependencies
+* and peers, read from capture's installed manifests, and moves with the capture pin.
+* A listed workspace cannot receive the capture development dependency without closing a cycle.
+* Scaffold does not install capture, so the proof checks planning against this list; the
+* installed closure-equality proof lands when scaffold installs capture.
+*
+* @example
+* ```ts
+* import { CAPTURE_UPSTREAM } from '@orkestrel/scaffold'
+*
+* CAPTURE_UPSTREAM.includes('@orkestrel/process') // true
+* ```
+*/
+var CAPTURE_UPSTREAM = Object.freeze([
+	"@orkestrel/capture",
+	"@orkestrel/contract",
+	"@orkestrel/emitter",
+	"@orkestrel/process",
+	"@orkestrel/timeout"
+]);
+/**
 * Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen.
 *
 * @remarks
@@ -750,8 +801,7 @@ var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
 	"@orkestrel/router": "^0.0.10",
 	"@orkestrel/server": "^0.0.14"
 });
-//#endregion
-//#region src/core/templates.ts
+// src/core/templates.ts
 /**
 * Holds formatter-stable template text for every configuration artifact.
 *
@@ -1249,6 +1299,7 @@ export function appJourney(
 	variant: JourneyVariant,
 	variants: readonly JourneyVariant[],
 	mode?: string,
+	override?: UserConfig,
 ): UserConfig {
 	const application = resolveApplication(mode, applications)
 	const browser = applications[application]()
@@ -1270,7 +1321,7 @@ export function appJourney(
 			},
 		},
 	}
-	return mergeOverride(project)
+	return mergeOverride(project, override)
 }
 `,
 			showcase: `
@@ -1557,8 +1608,9 @@ export function service(override?: UserConfig): UserConfig {
 	return mergeOverride(project, override)
 }
 `,
-		studies: `// Authored study proofs run installed packages through bounded subprocesses and protocol fixtures,
-// so this project is isolated in its own gate script, test:studies.
+		studies: `// The @orkestrel/study engine drives these proofs, running installed packages through bounded
+// subprocesses and protocol fixtures, so this project is isolated in its own gate script,
+// test:studies.
 export function studies(override?: UserConfig): UserConfig {
 	const project: UserConfig = {
 		resolve,
@@ -1596,9 +1648,9 @@ export function studies(override?: UserConfig): UserConfig {
 `,
 		probe: `// A workbench, not a proof. No gate selects this project. Run in test mode by the
 // \`test:probe\` script, it collects \`tmp/probes/**/*.test.ts\`. Run in benchmark mode by the
-// \`test:bench\` script, the same workbench also collects \`tests/**/*.test.ts\` for a \`bench\` block,
-// so a suite may carry a bench beside its ordinary tests without a second project. The mode
-// guard around each \`bench\` call keeps it out of test mode, so it never executes there.
+// \`test:bench\` script, it collects \`*.bench.ts\` files under \`tmp/probes\` and \`tests\`.
+// Each benchmark is a regular test that uses its context's \`bench\` fixture and awaits
+// \`bench(name, options, fn).run()\` or \`bench.compare(...)\`.
 export function probe(override?: UserConfig): UserConfig {
 	const project: UserConfig = {
 		resolve,
@@ -1611,7 +1663,7 @@ export function probe(override?: UserConfig): UserConfig {
 			fileParallelism: false,
 			sequence: { groupOrder: 1 },
 			pool: 'threads',
-			benchmark: { include: ['tmp/probes/**/*.test.ts', 'tests/**/*.test.ts'] },
+			benchmark: { include: ['tmp/probes/**/*.bench.ts', 'tests/**/*.bench.ts'] },
 		},
 	}
 	return mergeOverride(project, override)
@@ -2626,11 +2678,14 @@ export const DISTRIBUTION_NPM = process.platform === 'win32' ? 'npm.cmd' : 'npm'
 // process: the command and its plain-text diagnostics are the same across the
 // compiler majors this toolchain supports, and its in-process API is not. It is
 // resolved from the workspace under proof, so a consumer of the packed artifact is
-// checked by the same compiler that workspace's own \`check\` script runs.
+// checked by the same compiler that workspace's own \`check\` script runs. TypeScript 7 exports
+// \`package.json\` but not \`bin/tsc\`, so the path is joined from the manifest's directory.
+/** Names the TypeScript manifest installed by the workspace under proof. */
+export const DISTRIBUTION_TYPESCRIPT = createRequire(
+	join(DISTRIBUTION_ROOT, 'package.json'),
+).resolve('typescript/package.json')
 /** Names the compiler installed by the workspace under proof. */
-export const DISTRIBUTION_COMPILER = createRequire(join(DISTRIBUTION_ROOT, 'package.json')).resolve(
-	'typescript/bin/tsc',
-)
+export const DISTRIBUTION_COMPILER = join(dirname(DISTRIBUTION_TYPESCRIPT), 'bin', 'tsc')
 // Windows needs a shell to launch a \`.cmd\`: Node refuses one directly since the
 // batch-argument hardening, and \`spawnSync\` returns \`EINVAL\` with a null status
 // rather than an exit code a caller can read. Every following argument is a literal or
@@ -2898,6 +2953,50 @@ export function readDistributionManifestName(path: string): string {
 	return manifest.name
 }
 
+// A host carries a package's required peers at its own root. A consumer that carries none leaves
+// npm to place them, and npm can then resolve an optional peer of a peer to a release the
+// package's own range refuses, so the consumer declares them as a host would.
+/**
+ * Reads the peers a host must carry: every peer dependency its metadata does not mark optional.
+ *
+ * @param path - The manifest to read.
+ * @returns Each required peer's name mapped to its declared range.
+ */
+export function readDistributionPeers(path: string): Readonly<Record<string, string>> {
+	const manifest = readDistributionJSON(path)
+	if (!isDistributionRecord(manifest) || !isDistributionRecord(manifest.peerDependencies)) {
+		return {}
+	}
+	const meta = isDistributionRecord(manifest.peerDependenciesMeta)
+		? manifest.peerDependenciesMeta
+		: undefined
+	const peers = Object.entries(manifest.peerDependencies).filter(
+		(entry): entry is [string, string] => typeof entry[1] === 'string',
+	)
+	return Object.fromEntries(
+		peers.filter(([name]) => {
+			const entry = meta?.[name]
+			return !isDistributionRecord(entry) || entry.optional !== true
+		}),
+	)
+}
+
+/**
+ * Writes the consumer manifest, declaring the required peers as dependencies.
+ *
+ * @param peers - Each required peer's name mapped to its declared range.
+ * @returns The manifest text; the bare manifest when the package declares no required peer.
+ */
+export function createDistributionConsumerManifest(
+	peers: Readonly<Record<string, string>>,
+): string {
+	const manifest: unknown = JSON.parse(DISTRIBUTION_CONSUMER_MANIFEST)
+	if (Object.keys(peers).length === 0 || !isDistributionRecord(manifest)) {
+		return DISTRIBUTION_CONSUMER_MANIFEST
+	}
+	return \`\${JSON.stringify({ ...manifest, dependencies: peers })}\\n\`
+}
+
 /**
  * Writes a consumer file after creating its parent directory.
  *
@@ -3532,7 +3631,8 @@ export function buildDistributionStage(scratch: string): DistributionStage {
 	if (archives.length !== 1 || archive === undefined) {
 		throw new Error(\`npm pack wrote no single archive: \${archives.join(', ')}\`)
 	}
-	writeDistributionFile(join(consumer, 'package.json'), DISTRIBUTION_CONSUMER_MANIFEST)
+	const peers = readDistributionPeers(join(DISTRIBUTION_ROOT, 'package.json'))
+	writeDistributionFile(join(consumer, 'package.json'), createDistributionConsumerManifest(peers))
 	writeDistributionFile(join(consumer, DISTRIBUTION_ESM_DRIVER), DISTRIBUTION_ESM_DRIVER_SOURCE)
 	writeDistributionFile(join(consumer, DISTRIBUTION_CJS_DRIVER), DISTRIBUTION_CJS_DRIVER_SOURCE)
 	const install = runDistributionNpm(
@@ -4615,8 +4715,7 @@ printf '%s\\n' \\
 `
 	})
 });
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Represents the one error this package throws, carrying the coded reason it was raised.
 *
@@ -4685,8 +4784,7 @@ var ScaffoldError = class extends Error {
 function isScaffoldError(value) {
 	return (0, _orkestrel_contract.isInstance)(value, ScaffoldError);
 }
-//#endregion
-//#region src/core/validators.ts
+// src/core/validators.ts
 /**
 * Narrows a value to a logical target-relative path.
 *
@@ -5245,8 +5343,7 @@ var isCompilerOptions = (0, _orkestrel_contract.recordOf)({
 	on: isCompilerHooks,
 	error: _orkestrel_contract.isFunction
 }, true);
-//#endregion
-//#region src/core/cloners.ts
+// src/core/cloners.ts
 /**
 * Snapshots an untrusted value into exact JSON data the caller owns.
 *
@@ -5293,8 +5390,7 @@ function cloneValue(value) {
 	const outcome = (0, _orkestrel_contract.attempt)(() => (0, _orkestrel_contract.cloneJSONValue)(value));
 	return outcome.success ? outcome.value : void 0;
 }
-//#endregion
-//#region src/core/parsers.ts
+// src/core/parsers.ts
 /**
 * Coerces an extension value or a `surface:name` selection into an extension.
 * @param value - An extension record or its selection text.
@@ -5409,8 +5505,7 @@ function parseSnapshot(value) {
 function parseCompilerOptions(value) {
 	return isCompilerOptions(value) ? value : void 0;
 }
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Encodes bytes as exact lowercase hexadecimal text.
 *
@@ -6429,9 +6524,9 @@ function manifestToDependencies(manifest) {
 function renderSkillPointer(canonical, name) {
 	const lines = canonical.split(/\r\n|\n/u);
 	if (lines[0] !== "---") return void 0;
-	const closing = lines.indexOf("---", 1);
-	if (closing === -1) return void 0;
-	return `${lines.slice(0, closing + 1).join("\n")}\n${(0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.orchestration.skill, { name })}`;
+	const end = lines.indexOf("---", 1);
+	if (end === -1) return void 0;
+	return `${lines.slice(0, end + 1).join("\n")}\n${(0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.orchestration.skill, { name })}`;
 }
 /**
 * Scans manifest text for its strings and object braces, in order.
@@ -6477,8 +6572,7 @@ function scanManifestTokens(text) {
 	}
 	return tokens;
 }
-//#endregion
-//#region src/core/compilers.ts
+// src/core/compilers.ts
 /**
 * Projects a blueprint into browser extensions restricted to occupied browser axes.
 * @param blueprint - The workspace specification.
@@ -6654,8 +6748,10 @@ function srcToExports(src) {
 * @returns The merged set, sorted by package name.
 *
 * @remarks
-* The shared toolchain is the baseline every generated workspace carries, and
-* each declared axis adds the set its host needs. A declared extra or peer is
+* The shared toolchain is the baseline every generated workspace carries.
+* A selected browser framework applies its toolchain hold before the host-specific sets.
+* Vue faces on either axis select TypeScript 6.0.3; other workspaces select TypeScript 7.0.2.
+* Each declared axis adds the set its host needs. A declared extra or peer is
 * applied after those, so a workspace that pins a range for a package the
 * conditional sets also name gets the range it declared. An extra that restates
 * a shared toolchain pin never reaches here, because the gate refuses it. A peer
@@ -6670,6 +6766,11 @@ function srcToExports(src) {
 * to drive. A workspace {@link BROWSE_UPSTREAM} names receives nothing either, because
 * `@orkestrel/browser` depends on it at runtime and the declaration would close a cycle.
 *
+* A journey axis with a browser application receives {@link CAPTURE_DEV_DEPENDENCIES}.
+* A workspace {@link CAPTURE_UPSTREAM} names receives no capture seed, because it is capture
+* itself or a member of capture's runtime closure. A browser source, styles surface, or browser
+* setup alone selects no capture dependency.
+*
 * A peer is declared here as well as under `peerDependencies`, because a peer is
 * not installed by the workspace that declares it and developing against one
 * requires it present. A runtime dependency is the opposite case and is removed:
@@ -6696,7 +6797,9 @@ function blueprintToDevDependencies(blueprint) {
 	const own = blueprint.src.length > 0 || sheets ? `@orkestrel/${blueprint.name}` : blueprint.name;
 	const prior = {
 		...BASE_DEV_DEPENDENCIES,
+		...Object.fromEntries(Object.entries(blueprintToToolchainHolds(blueprint)).map(([name, hold]) => [name, hold.range])),
 		...rendered && !BROWSE_UPSTREAM.includes(own) ? BROWSE_DEV_DEPENDENCIES : {},
+		...blueprint.journey && blueprint.app.includes("browser") && !CAPTURE_UPSTREAM.includes(own) ? CAPTURE_DEV_DEPENDENCIES : {},
 		...sheets ? STYLES_DEV_DEPENDENCIES : {},
 		...blueprint.src.length > 0 || blueprint.bin ? DECLARATION_DEV_DEPENDENCIES : {},
 		...blueprint.src.includes("browser") || blueprint.setup.includes("browser") || sheets ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
@@ -6716,6 +6819,21 @@ function blueprintToDevDependencies(blueprint) {
 	return Object.fromEntries(Object.entries(merged).filter(([name]) => name !== own && !runtime.has(name)).sort(([left], [right]) => (0, _orkestrel_contract.compareValues)(left, right)));
 }
 /**
+* Projects a blueprint into the toolchain holds its browser frameworks require.
+* @param blueprint - The workspace specification.
+* @returns The held tools for selected browser framework faces; empty without a framework.
+* @example
+* ```ts
+* import { blueprintToToolchainHolds, createBlueprint } from '@orkestrel/scaffold'
+*
+* blueprintToToolchainHolds(createBlueprint('router', { src: ['core'] })) // {}
+* ```
+*/
+function blueprintToToolchainHolds(blueprint) {
+	const frameworks = blueprintToFaces(blueprint).map((face) => face.name);
+	return Object.fromEntries(Object.entries(TOOLCHAIN_HOLDS).filter(([, hold]) => frameworks.includes(hold.framework)));
+}
+/**
 * Projects the scoped npm overrides required by a selected browser showcase.
 *
 * @param blueprint - The workspace specification.
@@ -6852,6 +6970,9 @@ function replaceManifestOverride(manifest, path, range) {
 * The configuration paths interpolated here are the same ones `SRC_MATRIX` and
 * `APP_MATRIX` list as each environment's configuration files, so a rename in
 * either matrix is a rename in both places.
+* A browser application's journey axis adds `journey` (`capture journey`) and `capture`
+* (`capture frames`) beside `test:journey`. The scoped commands take an explicit selection;
+* the whole-suite `test:journey` invocation remains in the test chain.
 *
 * @example
 * ```ts
@@ -6950,6 +7071,8 @@ function blueprintToScripts(blueprint) {
 		...blueprint.setup.includes("browser") ? { "test:setup:browser": `${vitest} --project setup:browser` } : {},
 		...blueprint.journey && blueprint.app.includes("browser") ? {
 			"test:journey": journey,
+			journey: "capture journey",
+			capture: "capture frames",
 			...Object.fromEntries(application.map((name) => [`test:journey:${name}`, `${journey} --mode ${name}`]))
 		} : {},
 		...blueprint.skills ? { "test:skills": `${vitest} --project skills` } : {},
@@ -6957,7 +7080,7 @@ function blueprintToScripts(blueprint) {
 		...blueprint.conformance ? { "test:conformance": `${vitest} --project conformance` } : {},
 		...blueprint.tree ? { "test:tree": `${vitest} --project tree` } : {},
 		"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:bench": "vitest bench --config vite.config.ts --no-cache --project \"probe (bench)\" --mode benchmark",
 		...publishes ? { "test:distribution": `${vitest} --project distribution` } : {},
 		...integrates ? { "test:integration": `${vitest} --project integration` } : {},
 		...blueprint.service ? { "test:service": `${vitest} --project service` } : {},
@@ -7022,6 +7145,8 @@ function blueprintToScripts(blueprint) {
 * rewrites, and one carrying skills adds `test:skills`. Publishing adds the pack and publication lifecycle scripts.
 * Sheet and framework faces add their check and build scripts, application frameworks add dev scripts,
 * and selected showcases and journeys add their mode scripts.
+* A browser application's journey axis also adds `journey` and `capture`. Their generated
+* commands are writable and have no predecessor forms; customized values remain caller-owned.
 * Aggregate test scripts and
 * maintainer-owned gate chains stay outside the region.
 *
@@ -7053,7 +7178,7 @@ function blueprintToWritableScripts(blueprint) {
 		const sheet = sheets.some((face) => name === `build:src:${face}` || name === `check:src:${face}`);
 		const framework = blueprintToFaces(blueprint).some((extension) => extension.surface === "browser" && extension.axes.some((axis) => name === `check:${axis}:${extension.name}` || name === `build:${axis}:${extension.name}` || axis === "app" && name === `dev:${extension.name}`));
 		const showcase = name === "showcase" || name.startsWith("showcase:") || name === "build:showcase" || name.startsWith("build:showcase:");
-		if (!direct && !sheet && !framework && !showcase) return [];
+		if (!direct && !sheet && !framework && !showcase && !(name === "journey" || name === "capture")) return [];
 		return [{
 			name,
 			command,
@@ -7278,7 +7403,8 @@ function blueprintToRootTsconfig(blueprint) {
 * Projects a blueprint into the project labels its root Vitest configuration registers.
 *
 * @param blueprint - The workspace specification.
-* @returns Project labels in registration order, including wrapper-registered sheet faces.
+* @returns Project labels in registration order, including wrapper-registered sheet faces and
+* the probe benchmark variant.
 *
 * @example
 * ```ts
@@ -7312,7 +7438,8 @@ function blueprintToProjects(blueprint) {
 		...blueprint.studies ? ["studies"] : [],
 		...blueprint.src.length > 0 || styled ? ["distribution"] : [],
 		...blueprint.integration ? ["integration"] : [],
-		"probe"
+		"probe",
+		"probe (bench)"
 	];
 }
 /**
@@ -8494,9 +8621,9 @@ function insertManifestSection(manifest, section, dependencies, present) {
 	const root = tokens.find((token) => token.text === "}" && token.depth === 0)?.index;
 	if (bounds === void 0) {
 		if (present || root === void 0) return void 0;
-		const breaking = head === void 0 ? -1 : manifest.lastIndexOf("\n", head);
-		const margin = breaking < 0 ? "" : manifest.slice(breaking + 1, head);
-		const gap = breaking < 0 || /\S/u.test(margin) ? "" : `\n${margin}`;
+		const lineBreak = head === void 0 ? -1 : manifest.lastIndexOf("\n", head);
+		const margin = lineBreak < 0 ? "" : manifest.slice(lineBreak + 1, head);
+		const gap = lineBreak < 0 || /\S/u.test(margin) ? "" : `\n${margin}`;
 		const block = `${JSON.stringify(section)}: {${lines.map((line) => `${gap === "" ? "" : `${gap}${margin}`}${line}`).join(",")}${gap}}`;
 		const tail = manifest.slice(1, root).trimEnd().length;
 		const [position, insertion] = neighbor === void 0 ? [tail + 1, manifest.charAt(tail) === "{" ? block : `,${gap}${block}`] : section === "devDependencies" ? [neighbor.close + 1, `,${gap}${block}`] : [neighbor.start, `${block},${gap}`];
@@ -8518,11 +8645,11 @@ function insertManifestSection(manifest, section, dependencies, present) {
 	const first = declarations[0];
 	const last = declarations.at(-1);
 	if (first === void 0 || last === void 0) {
-		const opening = manifest.lastIndexOf("\n", open);
-		const level = opening < 0 ? "" : /^\s*/u.exec(manifest.slice(opening + 1, open))?.[0] ?? "";
-		const separator = opening < 0 ? "" : `\n${level}${level}`;
-		const ending = opening < 0 ? "" : `\n${level}`;
-		return `${manifest.slice(0, open + 1)}${lines.map((line) => `${separator}${line}`).join(",")}${ending}${manifest.slice(close)}`;
+		const lineBreak = manifest.lastIndexOf("\n", open);
+		const level = lineBreak < 0 ? "" : /^\s*/u.exec(manifest.slice(lineBreak + 1, open))?.[0] ?? "";
+		const separator = lineBreak < 0 ? "" : `\n${level}${level}`;
+		const suffix = lineBreak < 0 ? "" : `\n${level}`;
+		return `${manifest.slice(0, open + 1)}${lines.map((line) => `${separator}${line}`).join(",")}${suffix}${manifest.slice(close)}`;
 	}
 	const newline = manifest.lastIndexOf("\n", first.start);
 	const indent = newline < 0 ? "" : manifest.slice(newline + 1, first.start);
@@ -8633,10 +8760,10 @@ function replaceManifestScripts(manifest, scripts) {
 		}];
 	});
 	const missing = scripts.filter((script) => !written.has(script.name));
-	const opening = manifest.lastIndexOf("\n", start);
-	const level = opening < 0 ? "" : /^\s*/u.exec(manifest.slice(opening + 1, start))?.[0] ?? "";
-	const emptySeparator = opening < 0 ? "" : `\n${level}${level}`;
-	const emptyClosing = opening < 0 ? "" : `\n${level}`;
+	const lineBreak = manifest.lastIndexOf("\n", start);
+	const level = lineBreak < 0 ? "" : /^\s*/u.exec(manifest.slice(lineBreak + 1, start))?.[0] ?? "";
+	const emptySeparator = lineBreak < 0 ? "" : `\n${level}${level}`;
+	const emptySuffix = lineBreak < 0 ? "" : `\n${level}`;
 	const tail = start + manifest.slice(start, end - 1).trimEnd().length;
 	const newline = first === void 0 ? -1 : manifest.lastIndexOf("\n", first);
 	const indent = first === void 0 || newline < 0 ? "" : manifest.slice(newline + 1, first);
@@ -8652,7 +8779,7 @@ function replaceManifestScripts(manifest, scripts) {
 	const appended = missing.length === 0 ? [] : first === void 0 ? [{
 		start: start + 1,
 		end: end - 1,
-		text: `${missing.map((script) => `${emptySeparator}${JSON.stringify(script.name)}: ${JSON.stringify(script.command)}`).join(",")}${emptyClosing}`
+		text: `${missing.map((script) => `${emptySeparator}${JSON.stringify(script.name)}: ${JSON.stringify(script.command)}`).join(",")}${emptySuffix}`
 	}] : [...Map.groupBy(placements, ({ anchor }) => anchor)].map(([anchor, group]) => ({
 		start: anchor,
 		end: anchor,
@@ -9123,8 +9250,7 @@ function overridesToQuestions(overrides, artifacts) {
 		}] : []];
 	});
 }
-//#endregion
-//#region src/core/factories.ts
+// src/core/factories.ts
 /**
 * Constructs a {@link Blueprint} from a name and the fields that differ from the defaults.
 *
@@ -9201,8 +9327,7 @@ function createBlueprint(name, input) {
 	if (blueprint === void 0) throw new ScaffoldError("INVALID", "The filled record is not a blueprint.", { name });
 	return blueprint;
 }
-//#endregion
-//#region src/core/Compiler.ts
+// src/core/Compiler.ts
 /**
 * Represents the compile spine: draft, gate, pin, run in that order over a blueprint.
 *
@@ -9214,7 +9339,7 @@ function createBlueprint(name, input) {
 * records the coded reason beside them; the stages after a failed one never run,
 * so the records stop where the compile stopped.
 *
-* The compile fails closed on one rule: a scaffolding carries a plan exactly
+* The compile fails closed on one rule: a compile result carries a plan exactly
 * when no question blocks. A refused blueprint is answered rather than raised,
 * so a caller reads the refusal from the value it asked for.
 *
@@ -9239,10 +9364,10 @@ function createBlueprint(name, input) {
 * import { Compiler, createBlueprint } from '@orkestrel/scaffold'
 *
 * const compiler = new Compiler()
-* const scaffolding = compiler.compile(createBlueprint('router', { src: ['core'] }))
+* const result = compiler.compile(createBlueprint('router', { src: ['core'] }))
 *
-* scaffolding.plan?.artifacts // every planned file, in group order
-* scaffolding.stages // one CompileRecord per stage that ran
+* result.plan?.artifacts // every planned file, in group order
+* result.stages // one CompileRecord per stage that ran
 * compiler.destroy()
 * ```
 */
@@ -9279,7 +9404,7 @@ var Compiler = class {
 	*
 	* @param blueprint - The workspace specification to compile.
 	* @param groups - The artifact groups to cover; every group when absent.
-	* @returns The scaffolding, carrying a plan only when the gate passed.
+	* @returns The compile result, carrying a plan only when the gate passed.
 	* @throws {@link ScaffoldError} coded `INVALID` when an argument is not the
 	* exact shape, and `DESTROYED` when the compiler has been torn down.
 	*
@@ -9308,10 +9433,10 @@ var Compiler = class {
 	compile(blueprint, groups) {
 		this.#assertAlive();
 		const accepted = this.#accept(blueprint, parseBlueprint, "blueprint");
-		const scaffolding = this.#scaffold(accepted, this.#select(groups));
-		if (scaffolding.plan === void 0) this.#emitter.emit("block", scaffolding.questions);
-		this.#emitter.emit("compile", scaffolding);
-		return scaffolding;
+		const result = this.#scaffold(accepted, this.#select(groups));
+		if (result.plan === void 0) this.#emitter.emit("block", result.questions);
+		this.#emitter.emit("compile", result);
+		return result;
 	}
 	/**
 	* Compiles a blueprint and compares its plan to a target's current content.
@@ -9347,11 +9472,11 @@ var Compiler = class {
 		this.#assertAlive();
 		const accepted = this.#accept(blueprint, parseBlueprint, "blueprint");
 		const observed = this.#accept(current, parseSnapshot, "current");
-		const scaffolding = this.#scaffold(accepted, this.#select(groups));
-		if (scaffolding.plan === void 0) this.#emitter.emit("block", scaffolding.questions);
+		const compiled = this.#scaffold(accepted, this.#select(groups));
+		if (compiled.plan === void 0) this.#emitter.emit("block", compiled.questions);
 		const result = {
-			findings: scaffolding.plan === void 0 ? [] : planToFindings(scaffolding.plan, observed),
-			questions: scaffolding.questions
+			findings: compiled.plan === void 0 ? [] : planToFindings(compiled.plan, observed),
+			questions: compiled.questions
 		};
 		this.#emitter.emit("audit", result);
 		return result;
@@ -9502,7 +9627,6 @@ var Compiler = class {
 		return error;
 	}
 };
-//#endregion
 exports.APP_BROWSER_DEV_DEPENDENCIES = APP_BROWSER_DEV_DEPENDENCIES;
 exports.APP_DEV_DEPENDENCIES = APP_DEV_DEPENDENCIES;
 exports.APP_MATRIX = APP_MATRIX;
@@ -9516,9 +9640,11 @@ exports.BIN_OUTPUT_PATH = BIN_OUTPUT_PATH;
 exports.BROWSE_DEV_DEPENDENCIES = BROWSE_DEV_DEPENDENCIES;
 exports.BROWSE_UPSTREAM = BROWSE_UPSTREAM;
 exports.CANON_PATHS = CANON_PATHS;
+exports.CAPTURE_DEV_DEPENDENCIES = CAPTURE_DEV_DEPENDENCIES;
+exports.CAPTURE_UPSTREAM = CAPTURE_UPSTREAM;
 exports.CATALOG_AGENT_PATH = CATALOG_AGENT_PATH;
-exports.CATALOG_CLOSING_MARKER = CATALOG_CLOSING_MARKER;
-exports.CATALOG_OPENING_MARKER = CATALOG_OPENING_MARKER;
+exports.CATALOG_END_MARKER = CATALOG_END_MARKER;
+exports.CATALOG_START_MARKER = CATALOG_START_MARKER;
 exports.CONFIG_TEMPLATES = CONFIG_TEMPLATES;
 exports.CONFORMANCE_TEST_PATH = CONFORMANCE_TEST_PATH;
 exports.CONTROL_CHARACTER_PATTERN = CONTROL_CHARACTER_PATTERN;
@@ -9591,6 +9717,7 @@ exports.TAB_WIDTH = TAB_WIDTH;
 exports.TARGET_SKILL_NAMES = TARGET_SKILL_NAMES;
 exports.THEMES_BARREL_PATH = THEMES_BARREL_PATH;
 exports.THEMES_ENTRY_PATH = THEMES_ENTRY_PATH;
+exports.TOOLCHAIN_HOLDS = TOOLCHAIN_HOLDS;
 exports.TREE_TEST_PATH = TREE_TEST_PATH;
 exports.VERSION_PATTERN = VERSION_PATTERN;
 exports.WORKSPACE_DEV_ENGINES = WORKSPACE_DEV_ENGINES;
@@ -9619,6 +9746,7 @@ exports.blueprintToScripts = blueprintToScripts;
 exports.blueprintToSheets = blueprintToSheets;
 exports.blueprintToSourceArtifacts = blueprintToSourceArtifacts;
 exports.blueprintToTestArtifacts = blueprintToTestArtifacts;
+exports.blueprintToToolchainHolds = blueprintToToolchainHolds;
 exports.blueprintToWritableScripts = blueprintToWritableScripts;
 exports.bytesToHex = bytesToHex;
 exports.catalogToLayers = catalogToLayers;