@orkestrel/scaffold 0.0.44 → 0.0.46

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 //#region src/core/constants.ts
 /**
-* The three `Environment` values, frozen.
+* The `Environment` values, frozen.
 *
 * @remarks
 * A blueprint's `src` and `app` axes are caller-supplied, so the gate measures
@@ -18,7 +18,7 @@ var ENVIRONMENTS = Object.freeze([
 	"server"
 ]);
 /**
-* The seven `Group` values in plan order, frozen.
+* The `Group` values in plan order, frozen.
 *
 * @remarks
 * A compile that names no groups covers every one of them, so this list is the
@@ -70,7 +70,7 @@ var SRC_MATRIX = Object.freeze({
 * @remarks
 * An application environment declares no exports, so it carries a runtime
 * entry instead of a subpath and formats. Core carries none because it is
-* shared logic the other two import rather than a host that runs.
+* shared logic the other environments import rather than a host that runs.
 */
 var APP_MATRIX = Object.freeze({
 	core: Object.freeze({
@@ -98,8 +98,8 @@ var BIN_ENTRY_PATH = "src/bin/main.ts";
 * @remarks
 * These are the files the fleet shares verbatim: the root instruction
 * documents, the licence, the canonical orchestration contract every harness
-* bridge points at, the four harness directories, the session hook scripts,
-* the shared policy register, the byte-identical root dotfiles, and the two
+* bridge points at, the harness directories, the session hook scripts,
+* the shared policy register, the byte-identical root dotfiles, and the
 * guide mirrors a generated workspace starts from. A directory entry vendors
 * everything beneath it.
 *
@@ -245,7 +245,7 @@ var DEPENDENCY_NAME_PATTERN = /^@orkestrel\/[a-z][a-z0-9-]*$/;
 * is admitted, so the shape cannot express a traversal.
 */
 var FOREIGN_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
-/** The exact three-component version syntax a blueprint declares. */
+/** The exact `major.minor.patch` version syntax a blueprint declares. */
 var VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 /**
 * The exact caret-pinned pre-1.0 range accepted for an `@orkestrel/*` runtime dependency.
@@ -260,7 +260,7 @@ var ORKESTREL_RANGE_PATTERN = /^\^0\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 /** The registry-only semver subset accepted for a development extra's range. */
 var EXTRA_RANGE_PATTERN = /^(?:\^|~)?(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?$/;
 /**
-* The exact three-component floor accepted for a foreign peer's range.
+* The exact `major.minor.patch` floor accepted for a foreign peer's range.
 *
 * @remarks
 * This is independent from {@link ENGINES_PATTERN}. An engine floors the Node
@@ -315,14 +315,15 @@ var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 /** The tooling versions scaffold and every generated workspace share. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@orkestrel/guide": "^0.0.12",
-	"@orkestrel/scaffold": "^0.0.44",
+	"@orkestrel/probe": "^0.0.1",
+	"@orkestrel/scaffold": "^0.0.46",
 	"@orkestrel/test": "^0.0.7",
 	"@types/node": "^26.2.0",
-	oxfmt: "^0.62.0",
-	oxlint: "^1.77.0",
+	oxfmt: "^0.64.0",
+	oxlint: "^1.79.0",
 	typescript: "^6.0.3",
-	vite: "~8.2.0",
-	vitest: "^4.1.10"
+	vite: "~8.2.1",
+	vitest: "^4.1.11"
 });
 /** The development dependencies that emit declarations for published source or an executable. */
 var DECLARATION_DEV_DEPENDENCIES = Object.freeze({
@@ -331,7 +332,7 @@ var DECLARATION_DEV_DEPENDENCIES = Object.freeze({
 });
 /** The development dependencies a published browser `src` environment adds. */
 var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
-	"@vitest/browser-playwright": "^4.1.10",
+	"@vitest/browser-playwright": "^4.1.11",
 	playwright: "^1.62.1"
 });
 /** The development dependency every private `app` environment adds. */
@@ -358,9 +359,9 @@ var SHOWCASE_DEV_DEPENDENCIES = Object.freeze({ "vite-plugin-singlefile": "^2.3.
 /** The development dependencies a private server application adds. */
 var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
 	"@orkestrel/emitter": "^0.0.7",
-	"@orkestrel/middleware": "^0.0.13",
+	"@orkestrel/middleware": "^0.0.16",
 	"@orkestrel/router": "^0.0.10",
-	"@orkestrel/server": "^0.0.13"
+	"@orkestrel/server": "^0.0.14"
 });
 //#endregion
 //#region src/core/templates.ts
@@ -462,6 +463,7 @@ const resolve = {
 				emptyOutDir: true,
 				sourcemap: true,
 				minify: false,
+				rolldownOptions: { onLog: enforceBuildLog },
 			},
 			test: {
 				name: { label: 'src:core', color: 'magenta' },
@@ -491,6 +493,7 @@ const resolve = {
 				},
 				outDir: 'dist/src/browser',
 				rolldownOptions: {
+					onLog: enforceBuildLog,
 					{{external}}
 {{output}}
 				},
@@ -529,6 +532,7 @@ const resolve = {
 				outDir: 'dist/src/server',
 				target: 'node22',
 				rolldownOptions: {
+					onLog: enforceBuildLog,
 					platform: 'node',
 					{{external}}
 {{output}}
@@ -563,6 +567,7 @@ const resolve = {
 				outDir: 'dist/bin',
 				target: 'node22',
 				rolldownOptions: {
+					onLog: enforceBuildLog,
 					external: (id: string) =>
 						id.startsWith('node:') ||
 						id.startsWith('@orkestrel/') ||
@@ -613,7 +618,10 @@ const resolve = {
 		build: {
 {{showcaseBuild}}			emptyOutDir: true,
 			outDir: resolveWorkspacePath(output),
-			rolldownOptions: { input: resolveWorkspacePath('app/browser/index.html') },
+			rolldownOptions: {
+				onLog: enforceBuildLog,
+				input: resolveWorkspacePath('app/browser/index.html'),
+			},
 		},
 		test: {
 			name: { label: 'app:browser', color: 'blue' },
@@ -650,7 +658,10 @@ export function appBrowser(): UserConfig {
 				},
 				outDir: resolveWorkspacePath('dist/app/server'),
 				target: 'node22',
-				rolldownOptions: { external: (id: string) => id.startsWith('node:') },
+				rolldownOptions: {
+					onLog: enforceBuildLog,
+					external: (id: string) => id.startsWith('node:'),
+				},
 			},
 			test: {
 				name: { label: 'app:server', color: 'green' },
@@ -1034,7 +1045,7 @@ export default defineConfig(
 import { srcBin } from '../../vite.config.ts'
 
 // The \`scaffold\` executable build — a single ESM lib file, no declarations (an
-// executable ships no types), with the \`#!/usr/bin/env node\` shebang re-emitted via
+// executable ships no types), with the \`#!/usr/bin/env node\` shebang re-emitted through
 // \`output.banner\` (rolldown strips shebangs from source during bundling), and
 // \`output.paths\` rewriting the externalized \`@src/*\` specifiers to the built sibling
 // src environments (relative to \`dist/bin/\`), so the emitted bin resolves at runtime.
@@ -1286,7 +1297,7 @@ export function resolveBundledBrowser(platform: NodeJS.Platform, root: string):
 /**
  * Resolve the first installed stable system Chromium channel.
  *
- * @param platform - The Node platform whose standard layouts should be probed.
+ * @param platform - The Node platform whose standard layouts this call probes.
  * @param environment - The process environment supplying Windows installation roots.
  * @returns \`chrome\`, then \`msedge\`, or \`undefined\` when neither is executable.
  *
@@ -1331,7 +1342,7 @@ export function resolveSystemBrowser(
  * Resolve Playwright provider options for whatever browser this host can actually launch.
  *
  * @param pinned - The executable path for Playwright's pinned Chromium revision, when it has one.
- * @param platform - The Node platform whose standard layouts should be probed.
+ * @param platform - The Node platform whose standard layouts this call probes.
  * @param environment - The process environment supplying operator overrides and Windows roots.
  * @param root - The managed-container bundled browsers directory to search.
  * @returns Provider options naming an executable, a WebSocket endpoint, or a channel.
@@ -1340,7 +1351,7 @@ export function resolveSystemBrowser(
  * Precedence, most important first: \`PLAYWRIGHT_EXECUTABLE_PATH\`, \`PLAYWRIGHT_WS_ENDPOINT\`,
  * \`PLAYWRIGHT_CHANNEL\`, the managed Playwright Chromium, the container's bundled Chromium, a
  * verified system channel, then the platform default channel. An operator override outranks
- * discovery and is returned exactly as given: none of those three environment values is checked
+ * discovery and is returned exactly as given: none of those environment values is checked
  * against the filesystem, because verifying an override would defeat the override. The pinned
  * managed revision outranks anything found on the host because it is deterministic. The installed
  * pinned revision returns empty options so Playwright keeps its own default launch semantics. Only
@@ -1617,7 +1628,7 @@ var isHex = (0, _orkestrel_contract.stringOf)({
 * The bound is a code-unit ceiling rather than a byte count, because a string
 * of more code units than {@link MAX_ARTIFACT_BYTES} cannot encode within that
 * budget under any encoding this package writes. The exact UTF-8 measurement
-* belongs to the compiler and the writer, which are the two places the bytes
+* belongs to the compiler and the writer, which are the places the bytes
 * are actually produced.
 */
 var isContent = (0, _orkestrel_contract.stringOf)({ max: MAX_ARTIFACT_BYTES });
@@ -1890,7 +1901,7 @@ var isFinding = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.recordO
 *
 * @remarks
 * An audit reaches the writer and the destructive verb, so it is guarded as
-* strictly as the plan beside it. Findings use the sum of the two producer
+* strictly as the plan beside it. Findings use the sum of the producer
 * bounds: one per planned artifact, then one per unplanned snapshot path.
 */
 var isAudit = (0, _orkestrel_contract.recordOf)({
@@ -1902,7 +1913,7 @@ var isAudit = (0, _orkestrel_contract.recordOf)({
 *
 * @remarks
 * `content` is the fetched guide text and `observed` is the local mirror's
-* exact bytes, so the two carry different laws: one is content this package
+* exact bytes, so they carry different laws: one is content this package
 * writes, the other is the precondition that write is held to.
 */
 var isMirror = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.recordOf)({
@@ -2269,7 +2280,7 @@ function matchesOrchestrationPath(path) {
 * @returns The group that owns the path.
 *
 * @remarks
-* A path is grouped by what it governs rather than by where it sits. The two
+* A path is grouped by what it governs rather than by where it sits. The
 * manifest files are named exactly; anything
 * {@link matchesOrchestrationPath} accepts is orchestration; `src` and `app`
 * are source; `tests`, `guides`, and `docs` carry their own names; the licence
@@ -2401,7 +2412,7 @@ function matchesPrintWidth(line) {
 * module's own relative depth, so a nested module emits a path that escapes
 * `dist/src` and a flat one resolves only by luck. Both faces rewrite the same
 * relative core path to the package's published root export, so the branch is
-* derived once here. The extension alternation is what the two permitted import
+* derived once here. The extension alternation is what the permitted import
 * spellings produce: an `@src/core` alias resolves to the core source module and
 * prints `.ts`, while a relative import prints the `.js` specifier it was
 * written with. The formatter keeps the call on one line only while the line it
@@ -2581,8 +2592,8 @@ function matchesDriftReachability(ownership, finding) {
 *
 * The order matters because these packages are `0.0.x`, where a caret pins one
 * exact release. Publishing a dependent before its dependency leaves the
-* dependent pinned to the older release, and two ranges that disagree install
-* two copies of one package that the compiler reads as two distinct types.
+* dependent pinned to the older release, and ranges that disagree install
+* duplicate copies of one package that the compiler reads as distinct types.
 *
 * A cycle cannot be published in rounds, so its members are omitted rather than
 * placed in an order that would be wrong. An absent name is the report: compare
@@ -2651,11 +2662,11 @@ function planToSummary(plan) {
 	};
 }
 /**
-* Extract the three numeric components of an exact version.
+* Extract the major, minor, and patch components of an exact version.
 *
 * @param version - The candidate version text.
 * @returns The major, minor, and patch numbers, or `undefined` when the text is
-* not the exact three-component syntax.
+* not the exact `major.minor.patch` syntax.
 *
 * @remarks
 * Deliberately narrow: a prerelease or build suffix is not extracted, because
@@ -2725,10 +2736,10 @@ function compareVersions(left, right) {
 * @remarks
 * The one place this comparison is made. A `Release` records the declared range
 * and the reported version and stores no verdict beside them, because a stored
-* verdict could only disagree with the two fields it sits next to.
+* verdict could only disagree with the fields it sits next to.
 *
 * Readability is decided first, and it is `EXTRA_RANGE_PATTERN`: an optional
-* caret or tilde over three numeric components and an optional prerelease
+* caret or tilde over `major.minor.patch` and an optional prerelease
 * suffix. That pattern already covers every `ORKESTREL_RANGE_PATTERN` range and
 * every `VERSION_PATTERN` version, so the subset is stated once rather than
 * assembled here. Text outside it is never admitted, including text handed in on
@@ -3035,7 +3046,7 @@ function srcToExports(src) {
 * 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:
 * it is already installed, so a second declaration would state one fact twice
-* and the two ranges would be free to disagree.
+* and the ranges would be free to disagree.
 *
 * A workspace never declares itself, so its own package name is removed. That
 * matters for a workspace named after a package the baseline already carries:
@@ -3219,7 +3230,7 @@ function blueprintToScripts(blueprint) {
 * artifact serialized directly.
 *
 * The artifact carrying this text is claimed by birth. A workspace owns its own
-* manifest once it exists: its description, its keywords, and any script it
+* manifest after it exists: its description, its keywords, and any script it
 * added are the consumer's, so a repair that replaced the file would take them.
 * The one part scaffold keeps current afterwards is the declared `@orkestrel/*`
 * range set, and that is a region with its own writer rather than a claim over
@@ -3289,7 +3300,7 @@ function blueprintToManifest(blueprint) {
 * Derive the host-specific machinery a generated root Vite configuration carries.
 *
 * @param blueprint - The workspace specification.
-* @returns The four pipelines the generated configuration selects.
+* @returns The pipelines the generated configuration selects.
 *
 * @remarks
 * The sole derivation of that set: every renderer reads it rather than
@@ -3520,11 +3531,15 @@ export function appShowcase(): UserConfig {
 ${projects.map((project) => `\t\t\t${project},`).join("\n")}
 	\t],`;
 	const body = `${factories.join("\n")}\n`;
-	const boundaries = ["environmentBoundary", "outputBoundary"].filter((boundary) => body.includes(boundary));
+	const helpers = [
+		"enforceBuildLog",
+		"environmentBoundary",
+		"outputBoundary"
+	].filter((helper) => body.includes(helper));
 	return (0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.root.vite, {
 		viteTypes: machinery.showcase ? "PluginOption, UserConfig" : "UserConfig",
 		imports: imports.length === 0 ? "" : `${imports.join("\n")}\n`,
-		helpers: boundaries.length === 0 ? "" : `import { ${boundaries.join(", ")} } from './configs/helpers.js'\n`,
+		helpers: helpers.length === 0 ? "" : `import { ${helpers.join(", ")} } from './configs/helpers.js'\n`,
 		browsers: machinery.browser ? "import { resolveBrowser, resolvePinnedBrowser } from './configs/browsers.js'\n" : "",
 		options: machinery.browser ? "const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n\n" : "",
 		factories: body,
@@ -3649,7 +3664,7 @@ ${paths.join("\n")}
 *
 * @remarks
 * The barrels and every runtime entry intentionally hold nothing. A generated
-* sample entity is too easy to mistake for package implementation, so the
+* sample entity would read as package implementation, so the
 * scaffold establishes only the selected environment boundaries. An application
 * entry is empty for the same reason the bin entry is, and because the vendored
 * lint config refuses an unassigned import outside a stylesheet, so the entry
@@ -4019,9 +4034,9 @@ function applyOverrides(artifacts, overrides) {
 *
 * @example
 * ```ts
-* import { createBlueprint, createCompiler, planToHash } from '@orkestrel/scaffold'
+* import { Compiler, createBlueprint, planToHash } from '@orkestrel/scaffold'
 *
-* const { plan } = createCompiler().compile(createBlueprint('router', { src: ['core'] }))
+* const { plan } = new Compiler().compile(createBlueprint('router', { src: ['core'] }))
 *
 * plan === undefined ? undefined : planToHash(plan)?.length // 16
 * ```
@@ -4050,7 +4065,7 @@ function planToHash(plan) {
 * destination has no bytes to record, and every other verdict records the bytes
 * it was given, which is the precondition the mutation that follows is held to.
 * Ownership is copied rather than inferred from drift because aligned findings
-* span all three ownership tiers.
+* span every ownership tier.
 *
 * `foreign` is not answerable here, because it describes a path no artifact was
 * planned for.
@@ -4113,9 +4128,9 @@ function artifactToFinding(artifact, observed) {
 *
 * @example
 * ```ts
-* import { createBlueprint, createCompiler, planToFindings } from '@orkestrel/scaffold'
+* import { Compiler, createBlueprint, planToFindings } from '@orkestrel/scaffold'
 *
-* const { plan } = createCompiler().compile(createBlueprint('router', { src: ['core'] }))
+* const { plan } = new Compiler().compile(createBlueprint('router', { src: ['core'] }))
 *
 * plan === undefined ? [] : planToFindings(plan, { 'AGENTS.md': '68690a' })
 * ```
@@ -4151,7 +4166,7 @@ function planToFindings(plan, current) {
 * range, in list order.
 *
 * @remarks
-* The declared lists and peer partitions differ only in the two syntaxes they
+* The declared lists and peer partitions differ only in the syntaxes they
 * accept, so the rules live here once and each caller supplies its own patterns.
 * A runtime dependency name reaches a path through its guide mirror and is
 * fixed to the `@orkestrel` scope. A foreign peer or development extra reaches
@@ -4208,14 +4223,14 @@ function dependenciesToQuestions(dependencies, field, name, range) {
 * Only the laws a blueprint answers alone are here. The structural record and
 * its bounds are already settled by `isBlueprint`, which refuses a value that is
 * not a blueprint at all; what remains is the syntax of a name, a version, a
-* range, and an engines floor, the combinations the two environment axes admit,
-* and the overlaps between the three declared package lists. The laws that need
+* range, and an engines floor, the combinations the environment axes admit,
+* and the overlaps between the declared package lists. The laws that need
 * a drafted plan belong to {@link artifactsToQuestions} and
 * {@link overridesToQuestions}.
 *
 * A question blocks when it describes a workspace this package cannot generate.
-* Three do not, because each describes a workspace it can describe honestly and
-* should not create: a published axis of several environments without core,
+* These do not, because each describes a workspace it can describe honestly but
+* will not create: a published axis of several environments without core,
 * whose manifest names a core build the workspace never runs; a showcase flag
 * whose required browser axis is absent, which emits nothing; and an
 * integration flag over fewer than two environments, whose seed does emit and
@@ -4462,6 +4477,72 @@ function overridesToQuestions(overrides, artifacts) {
 	return questions;
 }
 //#endregion
+//#region src/core/factories.ts
+/**
+* Construct a {@link Blueprint} from a name and the fields that differ from the defaults.
+*
+* @param name - The bare workspace name.
+* @param input - The fields to set; every omitted field takes its default.
+* @returns The filled blueprint, owned by the caller and sharing nothing with `input`.
+* @throws {@link ScaffoldError} coded `INVALID` when the filled record is not a
+* blueprint.
+*
+* @remarks
+* A blueprint is a closed record, and most of its fields have one sensible
+* starting value: an empty list, a cleared flag, `DEFAULT_VERSION`, and
+* `DEFAULT_ENGINES`. Filling them here is what lets a caller state only what its
+* workspace actually declares.
+*
+* This is the construction door, and {@link parseBlueprint} is the coercing one.
+* They differ in every part: this fills the defaults and takes a
+* partial specification, where the parser fills nothing and takes an untrusted
+* value; and this refuses by throwing, where the parser refuses by answering
+* `undefined`. What they share is the law — both accept exactly what
+* `isBlueprint` accepts.
+*
+* That law is structural only. Whether the name is a name, the version a
+* version, and the environment axes a combination this package can generate
+* are the gate's laws, and the gate answers them with {@link Question}s carrying
+* their accepted candidates. Deciding them here as well would restate that law
+* and let the answers disagree, so a blueprint the gate will
+* refuse is still constructible.
+*
+* @example
+* ```ts
+* import { createBlueprint } from '@orkestrel/scaffold'
+*
+* createBlueprint('router', { src: ['core'] }).version // '0.0.1'
+* createBlueprint('Router').name // 'Router' — the gate refuses it, this does not
+* ```
+*/
+function createBlueprint(name, input) {
+	const blueprint = parseBlueprint(cloneValue({
+		name,
+		...input?.description === void 0 ? {} : { description: input.description },
+		keywords: input?.keywords ?? [],
+		src: input?.src ?? [],
+		app: input?.app ?? [],
+		dependencies: input?.dependencies ?? [],
+		peers: input?.peers ?? [],
+		extras: input?.extras ?? [],
+		version: input?.version ?? "0.0.1",
+		engines: input?.engines ?? DEFAULT_ENGINES,
+		overrides: input?.overrides ?? [],
+		bin: input?.bin ?? false,
+		setup: input?.setup ?? false,
+		guides: input?.guides ?? false,
+		distribution: input?.distribution ?? false,
+		integration: input?.integration ?? false,
+		conformance: input?.conformance ?? false,
+		service: input?.service ?? false,
+		vendors: input?.vendors ?? [],
+		global: input?.global ?? false,
+		showcase: input?.showcase ?? false
+	}));
+	if (blueprint === void 0) throw new ScaffoldError("INVALID", "The filled record is not a blueprint.", { name });
+	return blueprint;
+}
+//#endregion
 //#region src/core/Compiler.ts
 /**
 * The compile spine: draft, gate, pin, run in that order over a blueprint.
@@ -4484,7 +4565,7 @@ function overridesToQuestions(overrides, artifacts) {
 * `INVALID`. Structure raises; the laws a well-formed blueprint can still break
 * are the gate's, and they answer with questions.
 *
-* Two consequences of that order are worth stating, because they are the ones a
+* The consequences of that order are worth stating, because they are the ones a
 * JavaScript caller meets first. A property backed by an accessor is refused
 * rather than read, which is what closes the race a guard cannot close from
 * inside; the accessor never runs. And an optional field present with the value
@@ -4546,21 +4627,21 @@ var Compiler = class {
 	* carries no plan, then `compile` with the whole outcome either way, so an
 	* observer reads every compile from one event and the refusals from the other.
 	*
-	* A plan says the blueprint can be built. It does not say the blueprint should
-	* be created, and the questions beside it are what this compiler could not
-	* settle. A caller creating a fresh workspace answers them first and writes
-	* nothing while any remains, which is the rule the `new` verb applies; a caller
-	* describing or repairing an existing target carries them through instead.
-	* Nothing downstream repeats that check, because only the caller knows which of
-	* the two it is.
+	* A plan says the blueprint can be built. It does not decide whether to create
+	* it, and the questions beside it are what this compiler could not settle. A
+	* caller creating a fresh workspace answers them first and writes nothing while
+	* any remains, which is the rule the `new` verb applies; a caller describing or
+	* repairing an existing target carries them through instead.
+	* Nothing downstream repeats that check, because only the caller knows which
+	* case it is.
 	*
 	* @example
 	* ```ts
-	* import { createBlueprint, createCompiler } from '@orkestrel/scaffold'
+	* import { Compiler, createBlueprint } from '@orkestrel/scaffold'
 	*
 	* const blueprint = createBlueprint('router', { src: ['core'] })
 	*
-	* createCompiler().compile(blueprint, ['manifest']).plan?.artifacts.length // 1
+	* new Compiler().compile(blueprint, ['manifest']).plan?.artifacts.length // 1
 	* ```
 	*/
 	compile(blueprint, groups) {
@@ -4593,12 +4674,12 @@ var Compiler = class {
 	*
 	* @example
 	* ```ts
-	* import { createBlueprint, createCompiler } from '@orkestrel/scaffold'
+	* import { Compiler, createBlueprint } from '@orkestrel/scaffold'
 	*
 	* const blueprint = createBlueprint('router', { src: ['core'] })
 	*
-	* createCompiler().audit(blueprint, {}, ['manifest']).findings[0]?.drift // 'aligned'
-	* createCompiler().audit(blueprint, {}, ['configs']).findings[0]?.drift // 'missing'
+	* new Compiler().audit(blueprint, {}, ['manifest']).findings[0]?.drift // 'aligned'
+	* new Compiler().audit(blueprint, {}, ['configs']).findings[0]?.drift // 'missing'
 	* ```
 	*/
 	audit(blueprint, current, groups) {
@@ -4621,9 +4702,9 @@ var Compiler = class {
 	*
 	* @example
 	* ```ts
-	* import { createCompiler } from '@orkestrel/scaffold'
+	* import { Compiler } from '@orkestrel/scaffold'
 	*
-	* const compiler = createCompiler()
+	* const compiler = new Compiler()
 	* compiler.destroy()
 	* compiler.emitter.destroyed // true
 	* ```
@@ -4763,91 +4844,6 @@ var Compiler = class {
 	}
 };
 //#endregion
-//#region src/core/factories.ts
-/**
-* Construct a {@link Blueprint} from a name and the fields that differ from the defaults.
-*
-* @param name - The bare workspace name.
-* @param input - The fields to set; every omitted field takes its default.
-* @returns The filled blueprint, owned by the caller and sharing nothing with `input`.
-* @throws {@link ScaffoldError} coded `INVALID` when the filled record is not a
-* blueprint.
-*
-* @remarks
-* A blueprint is a closed record, and most of its fields have one sensible
-* starting value: an empty list, a cleared flag, `DEFAULT_VERSION`, and
-* `DEFAULT_ENGINES`. Filling them here is what lets a caller state only what its
-* workspace actually declares.
-*
-* This is the construction door, and {@link parseBlueprint} is the coercing one.
-* They differ in all three of their parts: this fills the defaults and takes a
-* partial specification, where the parser fills nothing and takes an untrusted
-* value; and this refuses by throwing, where the parser refuses by answering
-* `undefined`. What they share is the law — both accept exactly what
-* `isBlueprint` accepts.
-*
-* That law is structural only. Whether the name is a name, the version a
-* version, and the two environment axes a combination this package can generate
-* are the gate's laws, and the gate answers them with {@link Question}s carrying
-* their accepted candidates. Deciding them here as well would state one law in
-* two places and let the two answers disagree, so a blueprint the gate will
-* refuse is still constructible.
-*
-* @example
-* ```ts
-* import { createBlueprint } from '@orkestrel/scaffold'
-*
-* createBlueprint('router', { src: ['core'] }).version // '0.0.1'
-* createBlueprint('Router').name // 'Router' — the gate refuses it, this does not
-* ```
-*/
-function createBlueprint(name, input) {
-	const blueprint = parseBlueprint(cloneValue({
-		name,
-		...input?.description === void 0 ? {} : { description: input.description },
-		keywords: input?.keywords ?? [],
-		src: input?.src ?? [],
-		app: input?.app ?? [],
-		dependencies: input?.dependencies ?? [],
-		peers: input?.peers ?? [],
-		extras: input?.extras ?? [],
-		version: input?.version ?? "0.0.1",
-		engines: input?.engines ?? DEFAULT_ENGINES,
-		overrides: input?.overrides ?? [],
-		bin: input?.bin ?? false,
-		setup: input?.setup ?? false,
-		guides: input?.guides ?? false,
-		distribution: input?.distribution ?? false,
-		integration: input?.integration ?? false,
-		conformance: input?.conformance ?? false,
-		service: input?.service ?? false,
-		vendors: input?.vendors ?? [],
-		global: input?.global ?? false,
-		showcase: input?.showcase ?? false
-	}));
-	if (blueprint === void 0) throw new ScaffoldError("INVALID", "The filled record is not a blueprint.", { name });
-	return blueprint;
-}
-/**
-* Construct a {@link Compiler}.
-*
-* @param options - The initial listeners and the listener-error handler.
-* @returns The compiler, typed as the contract consumers program against.
-* @throws {@link ScaffoldError} coded `INVALID` when `options` is present but is
-* not an option bag the compiler accepts.
-*
-* @example
-* ```ts
-* import { createCompiler } from '@orkestrel/scaffold'
-*
-* const compiler = createCompiler({ on: { block: (questions) => report(questions) } })
-* compiler.destroy()
-* ```
-*/
-function createCompiler(options) {
-	return new Compiler(options);
-}
-//#endregion
 exports.APP_BROWSER_DEV_DEPENDENCIES = APP_BROWSER_DEV_DEPENDENCIES;
 exports.APP_DEV_DEPENDENCIES = APP_DEV_DEPENDENCIES;
 exports.APP_MATRIX = APP_MATRIX;
@@ -4931,7 +4927,6 @@ exports.computeBytes = computeBytes;
 exports.computeHash = computeHash;
 exports.contentToHex = contentToHex;
 exports.createBlueprint = createBlueprint;
-exports.createCompiler = createCompiler;
 exports.dependenciesToQuestions = dependenciesToQuestions;
 exports.extractVersion = extractVersion;
 exports.inferDrift = inferDrift;