@orkestrel/scaffold 0.0.60 → 0.0.62

package/dist/src/core/index.js

@@ -3,7 +3,7 @@ import { fillTemplate } from "@orkestrel/template";
 import { Emitter } from "@orkestrel/emitter";
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.60",
+	version: "0.0.62",
 	description: "Scaffold workspaces with five commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -58,7 +58,7 @@ var package_default = {
 		"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 --deny-warnings .",
+		"lint": "oxlint --config .oxlintrc.json --fix .",
 		"check": "tsc --noEmit --project tsconfig.json && npm run check:src",
 		"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",
@@ -67,7 +67,7 @@ var package_default = {
 		"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:guides",
+		"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: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",
@@ -77,6 +77,7 @@ var package_default = {
 		"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: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",
@@ -88,19 +89,19 @@ var package_default = {
 		"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.11",
-		"@orkestrel/contract": "^0.0.15",
-		"@orkestrel/emitter": "^0.0.8",
-		"@orkestrel/markdown": "^0.0.12",
-		"@orkestrel/process": "^0.0.9",
-		"@orkestrel/template": "^0.0.5"
+		"@orkestrel/console": "^0.0.12",
+		"@orkestrel/contract": "^0.0.16",
+		"@orkestrel/emitter": "^0.0.9",
+		"@orkestrel/markdown": "^0.0.13",
+		"@orkestrel/process": "^0.0.10",
+		"@orkestrel/template": "^0.0.6"
 	},
 	devDependencies: {
 		"@microsoft/api-extractor": "^7.59.0",
-		"@orkestrel/guide": "^0.0.15",
-		"@orkestrel/html": "^0.0.7",
+		"@orkestrel/guide": "^0.0.16",
+		"@orkestrel/html": "^0.0.8",
 		"@orkestrel/probe": "^0.0.11",
-		"@orkestrel/test": "^0.0.12",
+		"@orkestrel/test": "^0.0.13",
 		"@types/node": "^26.4.0",
 		"@vitest/browser-playwright": "^4.1.11",
 		"oxfmt": "^0.65.0",
@@ -116,7 +117,7 @@ var package_default = {
 //#endregion
 //#region src/core/constants.ts
 /**
-* The `Environment` values, frozen.
+* Lists the `Environment` values, frozen.
 *
 * @remarks
 * A blueprint's `src` and `app` axes are caller-supplied, so the gate measures
@@ -130,7 +131,7 @@ var ENVIRONMENTS = Object.freeze([
 	"server"
 ]);
 /**
-* The `Group` values in plan order, frozen.
+* Lists the `Group` values in plan order, frozen.
 *
 * @remarks
 * A compile that names no groups covers every one of them, so this list is the
@@ -147,7 +148,7 @@ var GROUPS = Object.freeze([
 	"orchestration"
 ]);
 /**
-* The build and export settings each published `src` environment contributes, frozen.
+* Holds the build and export settings each published `src` environment contributes, frozen.
 *
 * @remarks
 * Per environment: the thin configuration files it adds under `configs/src`,
@@ -177,7 +178,8 @@ var SRC_MATRIX = Object.freeze({
 	})
 });
 /**
-* The configuration and runtime-entry settings each private `app` environment contributes, frozen.
+* Holds the configuration and runtime-entry settings each private `app` environment
+* contributes, frozen.
 *
 * @remarks
 * An application environment declares no exports, so it carries a runtime
@@ -200,24 +202,25 @@ var APP_MATRIX = Object.freeze({
 		entry: "app/server/main.ts"
 	})
 });
-/** The configuration files a workspace that ships its own executable adds, frozen. */
+/** Lists the configuration files a workspace that ships its own executable adds, frozen. */
 var BIN_CONFIGS = Object.freeze(["configs/src/vite.bin.config.ts", "configs/src/tsconfig.bin.json"]);
-/** The executable entry whose presence makes a workspace `bin`. */
+/** Names the executable entry whose presence makes a workspace `bin`. */
 var BIN_ENTRY_PATH = "src/bin/main.ts";
 /**
-* The paths a target receives from the vendored data root, frozen.
+* Lists the paths a target receives from the vendored data root, frozen.
 *
 * @remarks
-* These are the files the fleet shares verbatim and every target holds a copy
-* of: the licence, the harness permission file, 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.
+* These are the files the fleet shares verbatim, and each target holds a copy
+* of the paths it selects: the licence, the harness permission file, the
+* session-start hooks, the shared policy register, the shared policy proof,
+* the shared policy plugin, the shared configuration leaf and its proof, the
+* byte-identical root dotfiles, and the guide mirrors a generated workspace
+* starts from. A directory entry vendors everything beneath it.
 *
 * A plan carries the subset its target selects, which is why the list is a
 * candidate set rather than a plan: a workspace never mirrors its own guide.
 *
-* Neither the instruction canon nor the harness wiring is here. A target reads
+* Neither the instruction canon nor the bench and MCP wiring is here. A target reads
 * its rules, its skills, its agent roles, its bench configuration, and its MCP
 * registrations from {@link CANON_PATHS} inside the installed package, so no
 * file scaffold leaves in a target names a path the target does not hold.
@@ -247,7 +250,7 @@ var HOST_PATHS = Object.freeze([
 	"guides/scaffold.md"
 ]);
 /**
-* The instruction-canon paths staged for reading rather than for a target, frozen.
+* Lists the instruction-canon paths staged for reading rather than for a target, frozen.
 *
 * @remarks
 * The root instruction documents, the orchestration contract every harness
@@ -293,10 +296,10 @@ var CANON_PATHS = Object.freeze([
 	".cursor/mcp.json",
 	".cursor/rules"
 ]);
-/** The repository-relative path where the committed vendored-file inventory is served. */
+/** Names the repository-relative path where the committed vendored-file inventory is served. */
 var HOST_INVENTORY_PATH = "host.json";
 /**
-* The vendored paths whose present bytes belong to each workspace, frozen.
+* Lists the vendored paths whose present bytes belong to each workspace, frozen.
 *
 * @remarks
 * These paths are copied into a workspace when absent and are never compared
@@ -306,7 +309,7 @@ var HOST_INVENTORY_PATH = "host.json";
 */
 var WORKSPACE_OWNED_PATHS = Object.freeze([".gitignore"]);
 /**
-* The vendored paths a target receives with its executable bit set, frozen.
+* Lists the vendored paths a target receives with its executable bit set, frozen.
 *
 * @remarks
 * Declared rather than read from the staging host's filesystem, because that
@@ -325,7 +328,7 @@ var EXECUTABLE_PATHS = Object.freeze([
 	"scripts/ollama.sh"
 ]);
 /**
-* The path prefixes whose contents instruct or wire an agent, frozen.
+* Lists the path prefixes whose contents instruct or wire an agent, frozen.
 *
 * @remarks
 * A path is grouped by what it governs rather than by where it sits: anything
@@ -343,7 +346,7 @@ var ORCHESTRATION_PATH_PREFIXES = Object.freeze([
 	"scripts/"
 ]);
 /**
-* The exact root filenames that wire an agent bench rather than the toolchain, frozen.
+* Lists the exact root filenames that wire an agent bench rather than the toolchain, frozen.
 *
 * @remarks
 * `.mcp.json` registers MCP servers for the harness. It sits among the root
@@ -351,7 +354,7 @@ var ORCHESTRATION_PATH_PREFIXES = Object.freeze([
 */
 var ORCHESTRATION_PATH_NAMES = Object.freeze([".mcp.json"]);
 /**
-* The agent file whose marker-bounded package table the catalog verb alone owns.
+* Names the agent file whose marker-bounded package table the catalog verb alone owns.
 *
 * @remarks
 * A plan claims it at a canon path, because the catalog verb refuses a target
@@ -365,16 +368,34 @@ var ORCHESTRATION_PATH_NAMES = Object.freeze([".mcp.json"]);
 * inside the markers.
 */
 var CATALOG_AGENT_PATH = ".claude/agents/orkestrel.md";
-/** The provisioner skeleton a workspace with declared service vendors is given once. */
+/**
+* Names the marker opening the package table inside {@link CATALOG_AGENT_PATH}.
+*
+* @remarks
+* The catalog verb rewrites the region between this marker and
+* {@link CATALOG_CLOSING_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 -->";
+/**
+* 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
+* refused rather than rewritten.
+*/
+var CATALOG_CLOSING_MARKER = "<!-- /orkestrel:catalog -->";
+/** Names the provisioner skeleton a workspace with declared service vendors is given once. */
 var SERVICE_SCRIPT_PATH = "scripts/service.sh";
-/** The shared Vitest global-setup module whose presence makes a workspace `global`. */
+/** Names the shared Vitest global-setup module whose presence makes a workspace `global`. */
 var GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
-/** The guide-parity proof whose presence selects the planned `guides` project. */
+/** Names the guide-parity proof whose presence selects the planned `guides` project. */
 var GUIDES_TEST_PATH = "tests/guides.test.ts";
-/** The generated packed-package proof every publishing workspace is planned at. */
+/** Names the generated packed-package proof every publishing workspace is planned at. */
 var DISTRIBUTION_TEST_PATH = "tests/distribution.test.ts";
 /**
-* The `prepublishOnly` row that runs the packed-package proof against a real registry.
+* Names the `prepublishOnly` row that runs the packed-package proof against a real registry.
 *
 * @remarks
 * The proof reads `import.meta.env.MODE`, so without `--mode release` it passes
@@ -382,22 +403,28 @@ var DISTRIBUTION_TEST_PATH = "tests/distribution.test.ts";
 * and both the script compiler and the manifest region writer read it from here.
 */
 var RELEASE_PROOF_COMMAND = "npm run test:distribution -- --mode release";
-/** The cross-environment composition proof whose presence makes a workspace `integration`. */
+/**
+* Names the cross-environment composition proof whose presence makes a workspace
+* `integration`.
+*/
 var INTEGRATION_TEST_PATH = "tests/integration.test.ts";
-/** The manifest path every compiler plan emits with birth ownership. */
+/** Names the manifest path every compiler plan emits with birth ownership. */
 var MANIFEST_PATH = "package.json";
-/** The official-tooling drift proof whose presence makes a workspace `conformance`. */
+/** Names the official-tooling drift proof whose presence makes a workspace `conformance`. */
 var CONFORMANCE_TEST_PATH = "tests/conformance.test.ts";
-/** The live-service readiness module whose presence makes a workspace `service`. */
+/** Names the live-service readiness module whose presence makes a workspace `service`. */
 var SERVICE_SETUP_PATH = "tests/setupService.ts";
-/** The include the live-service project covers, which is a directory rather than one proof. */
+/**
+* Names the include the live-service project covers, which is a directory rather than
+* one proof.
+*/
 var SERVICE_TEST_INCLUDE = "tests/service/**/*.test.ts";
-/** The Vite wrapper whose presence makes a workspace `showcase`. */
+/** Names the Vite wrapper whose presence makes a workspace `showcase`. */
 var SHOWCASE_CONFIG_PATH = "configs/app/vite.showcase.config.ts";
-/** The bare workspace name syntax: lowercase alphanumeric with hyphens, letter first. */
+/** Matches the bare workspace name syntax: lowercase alphanumeric with hyphens, letter first. */
 var NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
 /**
-* The runtime dependency name syntax: the `@orkestrel` scope and a bare name.
+* Matches the runtime dependency name syntax: the `@orkestrel` scope and a bare name.
 *
 * @remarks
 * A dependency name reaches a path, because a workspace's guide mirror is
@@ -407,7 +434,7 @@ var NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
 */
 var DEPENDENCY_NAME_PATTERN = /^@orkestrel\/[a-z][a-z0-9-]*$/;
 /**
-* The package name syntax for a dependency this package does not publish.
+* Matches the package name syntax for a dependency this package does not publish.
 *
 * @remarks
 * A foreign package is one this package does not publish, so its name reaches
@@ -417,10 +444,10 @@ 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 `major.minor.patch` version syntax a blueprint declares. */
+/** Matches 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.
+* Matches the exact caret-pinned pre-1.0 range accepted for an `@orkestrel/*` runtime dependency.
 *
 * @remarks
 * Pre-1.0 means any `0.x`, not `0.0.x`. The narrower form would refuse the first
@@ -429,10 +456,10 @@ var VERSION_PATTERN = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
 * workspace that had already been pinned to it.
 */
 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. */
+/** Matches 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 `major.minor.patch` floor accepted for a foreign peer's range.
+* Matches 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
@@ -440,44 +467,47 @@ var EXTRA_RANGE_PATTERN = /^(?:\^|~)?(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\
 * supplies. Either obligation may change without changing the other.
 */
 var FLOOR_RANGE_PATTERN = /^>=(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
-/** The minimum-Node engine syntax a blueprint declares. */
+/** Matches the minimum-Node engine syntax a blueprint declares. */
 var ENGINES_PATTERN = /^>=(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
-/** Exact lowercase hexadecimal bytes: two digits per byte, and empty content is valid. */
+/** Matches exact lowercase hexadecimal bytes: two digits per byte, and empty content is valid. */
 var HEX_PATTERN = /^(?:[0-9a-f]{2})*$/;
-/** Unicode controls, formatting controls, and line and paragraph separators rejected in text. */
+/**
+* Matches the Unicode controls, formatting controls, and line and paragraph separators
+* rejected in text.
+*/
 var CONTROL_CHARACTER_PATTERN = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u;
-/** Visible characters a target-relative path and a Markdown path cell both forbid. */
+/** Matches the visible characters a target-relative path and a Markdown path cell both forbid. */
 var INVALID_PATH_CHARACTER_PATTERN = /[<>:"|?*\\]/;
 /**
-* Maximum bare workspace name length.
+* Caps the bare workspace name length.
 *
 * @remarks
 * The registry caps a whole package name at 214 characters and the generated
 * scope `@orkestrel/` spends 11 of them.
 */
 var MAX_NAME_LENGTH = 203;
-/** Maximum dependency package name length, scope included, as the registry caps it. */
+/** Sets the maximum dependency package name length, scope included, as the registry caps it. */
 var MAX_DEPENDENCY_NAME_LENGTH = 214;
-/** Maximum length of one declared package range. */
+/** Caps the length of one declared package range. */
 var MAX_RANGE_LENGTH = 2048;
-/** Maximum length of one manifest script name or command. */
+/** Caps the length of one manifest script name or command. */
 var MAX_SCRIPT_LENGTH = 4096;
-/** Maximum length of one path, matching the longest a supported filesystem accepts. */
+/** Caps the length of one path, matching the longest a supported filesystem accepts. */
 var MAX_PATH_LENGTH = 32767;
-/** Maximum items accepted in one public collection. */
+/** Caps the items accepted in one public collection. */
 var MAX_COLLECTION_ITEMS = 1e3;
-/** Columns one emitted line may occupy, matching `printWidth` in `.oxfmtrc.json`. */
+/** Caps the columns one emitted line may occupy, matching `printWidth` in `.oxfmtrc.json`. */
 var PRINT_WIDTH = 100;
-/** Columns one tab occupies when the formatter measures a line, matching `tabWidth`. */
+/** Sets the columns one tab occupies when the formatter measures a line, matching `tabWidth`. */
 var TAB_WIDTH = 2;
-/** Maximum findings one audit can produce from a bounded plan and snapshot. */
+/** Caps the findings one audit can produce from a bounded plan and snapshot. */
 var MAX_AUDIT_FINDINGS = MAX_COLLECTION_ITEMS * 2;
-/** Maximum bytes accepted for one artifact. */
+/** Caps the bytes accepted for one artifact. */
 var MAX_ARTIFACT_BYTES = 5242880;
-/** Maximum length of the hexadecimal string carrying one artifact's bytes. */
+/** Caps the length of the hexadecimal string carrying one artifact's bytes. */
 var MAX_ARTIFACT_HEX_LENGTH = MAX_ARTIFACT_BYTES * 2;
 /**
-* Maximum decoded bytes accepted from one registry response.
+* Caps the decoded bytes accepted from one registry response.
 *
 * @remarks
 * The 2026-08-21 abbreviated-packument measurements were 8,647,138 bytes for
@@ -487,24 +517,24 @@ var MAX_ARTIFACT_HEX_LENGTH = MAX_ARTIFACT_BYTES * 2;
 */
 var MAX_REGISTRY_BYTES = 33554432;
 /**
-* Maximum decoded bytes accepted across one registry-reading call.
+* Caps the decoded bytes accepted across one registry-reading call.
 *
 * @remarks
 * The 2026-08-21 browser-workspace registry set measured about 24 MiB. The
 * bound leaves headroom for that set to grow without making a call unbounded.
 */
 var MAX_TOTAL_REGISTRY_BYTES = 100663296;
-/** Maximum bytes accepted for one package or vendored-host manifest. */
+/** Caps the bytes accepted for one package or vendored-host manifest. */
 var MAX_MANIFEST_BYTES = 1048576;
-/** Maximum bytes retained across one whole plan or audit. */
+/** Caps the bytes retained across one whole plan or audit. */
 var MAX_TOTAL_ARTIFACT_BYTES = 104857600;
-/** The oldest Node version the generated toolchain supports. */
+/** Names the oldest Node version the generated toolchain supports. */
 var MINIMUM_NODE_VERSION = "22.12.0";
-/** The version a workspace starts at. */
+/** Names the version a workspace starts at. */
 var DEFAULT_VERSION = "0.0.1";
-/** The `engines.node` range a workspace starts with. */
+/** Names the `engines.node` range a workspace starts with. */
 var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
-/** The tooling versions scaffold and every generated workspace share. */
+/** Holds the tooling versions scaffold and every generated workspace share. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@orkestrel/guide": package_default.devDependencies["@orkestrel/guide"],
 	"@orkestrel/probe": package_default.devDependencies["@orkestrel/probe"],
@@ -517,19 +547,22 @@ var BASE_DEV_DEPENDENCIES = Object.freeze({
 	vite: package_default.devDependencies.vite,
 	vitest: package_default.devDependencies.vitest
 });
-/** The development dependencies that emit declarations for published source or an executable. */
+/**
+* Lists the development dependencies that emit declarations for published source or an
+* executable.
+*/
 var DECLARATION_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": package_default.devDependencies["@microsoft/api-extractor"],
 	"vite-plugin-dts": package_default.devDependencies["vite-plugin-dts"]
 });
-/** The development dependencies a published browser `src` environment adds. */
+/** Lists the development dependencies a published browser `src` environment adds. */
 var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 	"@vitest/browser-playwright": package_default.devDependencies["@vitest/browser-playwright"],
 	playwright: package_default.devDependencies.playwright
 });
-/** The development dependency every private `app` environment adds. */
+/** Names the development dependency every private `app` environment adds. */
 var APP_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/contract": package_default.dependencies["@orkestrel/contract"] });
-/** The development dependencies a private Vue browser application adds. */
+/** Lists the development dependencies a private Vue browser application adds. */
 var APP_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 	...SOURCE_BROWSER_DEV_DEPENDENCIES,
 	"@orkestrel/html": package_default.devDependencies["@orkestrel/html"],
@@ -538,7 +571,7 @@ var APP_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 	"vue-tsc": "^3.3.7"
 });
 /**
-* The development dependency used only by the optional single-file showcase build.
+* Names the development dependency used only by the optional single-file showcase build.
 *
 * @example
 * ```ts
@@ -548,7 +581,7 @@ var APP_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 * ```
 */
 var SHOWCASE_DEV_DEPENDENCIES = Object.freeze({ "vite-plugin-singlefile": "^2.3.3" });
-/** The development dependencies a private server application adds. */
+/** Lists the development dependencies a private server application adds. */
 var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
 	"@orkestrel/emitter": package_default.dependencies["@orkestrel/emitter"],
 	"@orkestrel/middleware": "^0.0.16",
@@ -558,7 +591,7 @@ var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
 //#endregion
 //#region src/core/templates.ts
 /**
-* Formatter-stable template text for every configuration artifact.
+* Holds formatter-stable template text for every configuration artifact.
 *
 * @remarks
 * Builders in `compilers.ts` fill these definitions through
@@ -1229,8 +1262,8 @@ import { accessSync, constants as FS_CONSTANTS, globSync, readdirSync, statSync
 import { basename, dirname, join, resolve as resolvePath } from 'node:path'
 
 /**
- * Chromium executable layouts inside a \`chromium-<revision>\` browsers-directory entry, per
- * platform.
+ * Lists the Chromium executable layouts inside a \`chromium-<revision>\` browsers-directory
+ * entry, per platform.
  *
  * @remarks
  * The current Playwright build ships Chrome for Testing on macOS. The trailing \`Chromium.app\`
@@ -1248,17 +1281,17 @@ export const CHROMIUM_LAYOUTS = Object.freeze([
 	'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium',
 ])
 
-/** The \`chromium-<revision>\` entry name Playwright installs one managed build into. */
+/** Matches the \`chromium-<revision>\` entry name Playwright installs one managed build into. */
 export const CHROMIUM_ENTRY_PATTERN = /^chromium-\\d+$/
 
-/** The revision number carried by any path containing a \`chromium-<revision>\` segment. */
+/** Matches the revision number carried by any path containing a \`chromium-<revision>\` segment. */
 export const CHROMIUM_REVISION_PATTERN = /chromium-(\\d+)/
 
-/** The directory a managed Linux container installs its bundled Playwright browsers into. */
+/** Names the directory a managed Linux container installs its bundled Playwright browsers into. */
 export const BUNDLED_BROWSERS_ROOT = '/opt/pw-browsers'
 
 /**
- * Bundled Chromium layouts under the managed-container browsers root, as glob patterns.
+ * Lists the bundled Chromium layouts under the managed-container browsers root, as glob patterns.
  *
  * @remarks
  * The revision directory and its inner layout both drift across Playwright builds, and the
@@ -1270,7 +1303,7 @@ export const BUNDLED_CHROMIUM_LAYOUTS = Object.freeze([
 	'chromium-*/chrome-linux/chrome',
 ])
 
-/** Stable Playwright Chromium channels and their standard executable layouts. */
+/** Lists the stable Playwright Chromium channels and their standard executable layouts. */
 export const SYSTEM_BROWSER_CHANNELS = Object.freeze([
 	Object.freeze({
 		channel: 'chrome',
@@ -1291,10 +1324,10 @@ export const SYSTEM_BROWSER_CHANNELS = Object.freeze([
 ])
 
 /**
- * Determine whether a path identifies an executable regular file.
+ * Determines whether a path identifies an executable regular file.
  *
  * @param path - The filesystem path to inspect.
- * @returns Whether the path is a regular file with execute access.
+ * @returns True if the path is a regular file with execute access; false otherwise.
  *
  * @example
  * \`\`\`ts
@@ -1312,7 +1345,7 @@ export function isBrowserExecutable(path: string): boolean {
 }
 
 /**
- * Order two Chromium paths so the highest revision sorts first.
+ * Orders two Chromium paths so the highest revision sorts first.
  *
  * @param left - The first path or directory entry to compare.
  * @param right - The second path or directory entry to compare.
@@ -1335,7 +1368,7 @@ export function compareRevisions(left: string, right: string): number {
 }
 
 /**
- * Read the executable path of Playwright's pinned Chromium revision.
+ * Reads the executable path of Playwright's pinned Chromium revision.
  *
  * @returns The pinned executable path, or \`undefined\` when this platform has none.
  *
@@ -1358,7 +1391,7 @@ export function resolvePinnedBrowser(): string | undefined {
 }
 
 /**
- * Resolve a launchable Playwright-managed Chromium executable: the pinned revision when installed,
+ * Resolves a launchable Playwright-managed Chromium executable: the pinned revision when installed,
  * otherwise a \`chromium\` / \`chromium.exe\` alias or any other \`chromium-*\` revision under the same
  * Playwright browsers directory. A pinned-revision miss is not Chromium absence — managed
  * containers ship one usable build, often behind a revision-agnostic alias, for many Playwright
@@ -1405,7 +1438,7 @@ export function resolveManagedBrowser(pinned: string): string | undefined {
 }
 
 /**
- * Resolve the Chromium a managed Linux container bundles outside the Playwright cache.
+ * Resolves the Chromium a managed Linux container bundles outside the Playwright cache.
  *
  * @param platform - The Node platform the container runs on.
  * @param root - The bundled browsers directory to search.
@@ -1434,7 +1467,7 @@ export function resolveBundledBrowser(platform: NodeJS.Platform, root: string):
 }
 
 /**
- * Resolve the first installed stable system Chromium channel.
+ * Resolves the first installed stable system Chromium channel.
  *
  * @param platform - The Node platform whose standard layouts this call probes.
  * @param environment - The process environment supplying Windows installation roots.
@@ -1478,7 +1511,7 @@ export function resolveSystemBrowser(
 }
 
 /**
- * Resolve Playwright provider options for whatever browser this host can actually launch.
+ * Resolves 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 this call probes.
@@ -1533,7 +1566,7 @@ export function resolveBrowser(
 `
 });
 /**
-* Formatter-stable template text for source, test, document, guide, and service artifacts.
+* Holds formatter-stable template text for source, test, document, guide, and service artifacts.
 *
 * @remarks
 * Builders in `compilers.ts` fill every varying span through
@@ -2627,7 +2660,7 @@ printf '%s\\n' \\
 //#endregion
 //#region src/core/errors.ts
 /**
-* The one error this package throws, carrying the coded reason it was raised.
+* Represents the one error this package throws, carrying the coded reason it was raised.
 *
 * @remarks
 * Each code names one cause: `INVALID` for off-contract input, `DESTROYED` for
@@ -2664,7 +2697,7 @@ var ScaffoldError = class extends Error {
 	code;
 	context;
 	/**
-	* Construct a coded scaffold error.
+	* Constructs a coded scaffold error.
 	*
 	* @param code - The coded reason the error is raised.
 	* @param message - What went wrong, in one sentence.
@@ -2678,10 +2711,10 @@ var ScaffoldError = class extends Error {
 	}
 };
 /**
-* Narrow a caught value to a {@link ScaffoldError}.
+* Narrows a caught value to a {@link ScaffoldError}.
 *
 * @param value - The caught value to narrow.
-* @returns `true` when `value` is a {@link ScaffoldError}.
+* @returns True if `value` is a {@link ScaffoldError}; false otherwise.
 *
 * @example
 * ```ts
@@ -2697,11 +2730,11 @@ function isScaffoldError(value) {
 //#endregion
 //#region src/core/validators.ts
 /**
-* Narrow a value to a logical target-relative path.
+* Narrows a value to a logical target-relative path.
 *
 * @param value - The candidate path.
-* @returns `true` for a bounded relative path with no traversal, empty segment,
-* control character, or reserved syntax character.
+* @returns True if the value is a bounded relative path with no traversal, empty
+* segment, control character, or reserved syntax character; false otherwise.
 *
 * @remarks
 * Every path this package reads or writes passes here, so one law covers a
@@ -2730,7 +2763,7 @@ function isPath(value) {
 	});
 }
 /**
-* Narrow a value to exact lowercase hexadecimal bytes within one artifact's limit.
+* Narrows a value to exact lowercase hexadecimal bytes within one artifact's limit.
 *
 * @remarks
 * Two digits per byte, so an odd length is refused and empty content is valid.
@@ -2750,7 +2783,7 @@ var isHex = stringOf({
 	pattern: HEX_PATTERN
 });
 /**
-* Narrow a value to text this package will accept as one artifact's content.
+* Narrows a value to text this package will accept as one artifact's content.
 *
 * @remarks
 * The bound is a code-unit ceiling rather than a byte count, because a string
@@ -2761,10 +2794,11 @@ var isHex = stringOf({
 */
 var isContent = stringOf({ max: MAX_ARTIFACT_BYTES });
 /**
-* Narrow a value to an array within the limit one public collection accepts.
+* Narrows a value to an array within the limit one public collection accepts.
 *
 * @param value - The candidate collection.
-* @returns `true` for an array of no more than `MAX_COLLECTION_ITEMS` items.
+* @returns True if the value is an array of no more than
+* `MAX_COLLECTION_ITEMS` items; false otherwise.
 *
 * @remarks
 * Compose this ahead of an element guard so the item count is settled before
@@ -2783,7 +2817,7 @@ function isCollection(value) {
 	return holds(() => isArray(value) && value.length <= 1e3);
 }
 /**
-* Narrow a value to one {@link Environment} a workspace may select.
+* Narrows a value to one {@link Environment} a workspace may select.
 *
 * @example
 * ```ts
@@ -2795,7 +2829,7 @@ function isCollection(value) {
 */
 var isEnvironment = literalOf(ENVIRONMENTS);
 /**
-* Narrow a value to one {@link Group} a plan selects over.
+* Narrows a value to one {@link Group} a plan selects over.
 *
 * @example
 * ```ts
@@ -2806,10 +2840,10 @@ var isEnvironment = literalOf(ENVIRONMENTS);
 * ```
 */
 var isGroup = literalOf(GROUPS);
-/** Narrow a value to a bounded group selection. */
+/** Narrows a value to a bounded group selection. */
 var isGroups = andOf(isCollection, arrayOf(isGroup));
 /**
-* Narrow a value to the scoped package name a runtime dependency carries.
+* Narrows a value to the scoped package name a runtime dependency carries.
 *
 * @remarks
 * A dependency name reaches a path, because a workspace's guide mirror is
@@ -2831,7 +2865,7 @@ var isDependencyName = stringOf({
 	pattern: DEPENDENCY_NAME_PATTERN
 });
 /**
-* Narrow a value to a {@link Dependency}.
+* Narrows a value to a {@link Dependency}.
 *
 * @remarks
 * Structural and bounded: which names and ranges a blueprint may declare is a
@@ -2858,7 +2892,7 @@ var isDependency = recordOf({
 	optional: isBoolean
 }, ["optional"]);
 /**
-* Narrow a value to a {@link ManifestScript}.
+* Narrows a value to a {@link ManifestScript}.
 *
 * @remarks
 * Structural and bounded, exactly as {@link isDependency} is: a script name
@@ -2889,7 +2923,7 @@ var isManifestScript = recordOf({
 	})))
 });
 /**
-* Narrow a value to an {@link Override}.
+* Narrows a value to an {@link Override}.
 *
 * @remarks
 * Whether the path names a planned artifact is a gate law; whether it names a
@@ -2907,7 +2941,7 @@ var isOverride = recordOf({
 	content: isContent
 });
 /**
-* Narrow a value to a {@link Blueprint}.
+* Narrows a value to a {@link Blueprint}.
 *
 * @remarks
 * The whole closed record, its literal axes, and the count and length bounds
@@ -2948,7 +2982,7 @@ var isBlueprint = recordOf({
 	showcase: isBoolean
 }, ["description"]);
 /**
-* Narrow a value to an {@link Artifact}.
+* Narrows a value to an {@link Artifact}.
 *
 * @remarks
 * One branch per way content is produced, discriminated by `origin` and
@@ -2988,7 +3022,7 @@ var isArtifact = unionOf(recordOf({
 	content: isContent
 }, ["environment"]));
 /**
-* Narrow a value to a {@link Plan}.
+* Narrows a value to a {@link Plan}.
 *
 * @remarks
 * A plan reaches the writer, and the writer has no question channel, so this
@@ -3004,7 +3038,7 @@ var isPlan = andOf(recordOf({
 	hash: isHex
 }, ["hash"]), (plan) => plan.artifacts.every((artifact) => artifact.path !== "package.json" || artifact.ownership === "birth"));
 /**
-* Narrow a value to a {@link Question}.
+* Narrows a value to a {@link Question}.
 *
 * @example
 * ```ts
@@ -3020,7 +3054,7 @@ var isQuestion = recordOf({
 	candidates: andOf(isCollection, arrayOf(isString))
 }, ["candidates"]);
 /**
-* Narrow a value to a {@link Finding}.
+* Narrows a value to a {@link Finding}.
 *
 * @remarks
 * `observed` is required exactly where the mutation it precedes is held to it,
@@ -3057,7 +3091,7 @@ var isFinding = unionOf(recordOf({
 	observed: isHex
 }, ["observed"]));
 /**
-* Narrow a value to an {@link Audit}.
+* Narrows a value to an {@link Audit}.
 *
 * @remarks
 * An audit reaches the writer and the destructive verb, so it is guarded as
@@ -3069,7 +3103,7 @@ var isAudit = recordOf({
 	questions: andOf(isCollection, arrayOf(isQuestion))
 });
 /**
-* Narrow a value to a {@link Mirror}.
+* Narrows a value to a {@link Mirror}.
 *
 * @remarks
 * `content` is the fetched guide text and `observed` is the local mirror's
@@ -3090,7 +3124,7 @@ var isMirror = unionOf(recordOf({
 	observed: isHex
 }, ["observed"]));
 /**
-* Narrow a value to a {@link CatalogEntry}.
+* Narrows a value to a {@link CatalogEntry}.
 *
 * @remarks
 * A row that found no version carries the cause instead, and neither branch may
@@ -3107,11 +3141,11 @@ var isCatalogEntry = unionOf(recordOf({
 	note: isString
 }));
 /**
-* Narrow a value to a {@link Snapshot}.
+* Narrows a value to a {@link Snapshot}.
 *
 * @param value - The candidate target snapshot.
-* @returns `true` for a bounded plain record whose every key is a path and
-* whose every value is exact lowercase hexadecimal bytes.
+* @returns True if the value is a bounded plain record whose every key is a path and
+* whose every value is exact lowercase hexadecimal bytes; false otherwise.
 *
 * @remarks
 * Read through the shared total key lens, so a hostile `ownKeys` trap and a
@@ -3137,7 +3171,7 @@ function isSnapshot(value) {
 	});
 }
 /**
-* Narrow a value to the compiler's initial listener record.
+* Narrows a value to the compiler's initial listener record.
 *
 * @remarks
 * Every event is optional and every declared value is a function. A key outside
@@ -3152,7 +3186,7 @@ var isCompilerHooks = recordOf({
 	destroy: isFunction
 }, true);
 /**
-* Narrow a value to {@link CompilerOptions}.
+* Narrows a value to {@link CompilerOptions}.
 *
 * @example
 * ```ts
@@ -3169,7 +3203,7 @@ var isCompilerOptions = recordOf({
 //#endregion
 //#region src/core/cloners.ts
 /**
-* Snapshot an untrusted value into exact JSON data the caller owns.
+* Snapshots an untrusted value into exact JSON data the caller owns.
 *
 * @param value - The untrusted value to take ownership of.
 * @returns A deeply frozen copy sharing nothing with `value`, or `undefined`
@@ -3217,7 +3251,7 @@ function cloneValue(value) {
 //#endregion
 //#region src/core/parsers.ts
 /**
-* Coerce an untrusted value to a {@link Blueprint}.
+* Coerces an untrusted value to a {@link Blueprint}.
 *
 * @param value - The value to parse.
 * @returns The blueprint, or `undefined` when the value is not one.
@@ -3239,7 +3273,7 @@ function parseBlueprint(value) {
 	return isBlueprint(value) ? value : void 0;
 }
 /**
-* Coerce an untrusted value to a group selection.
+* Coerces an untrusted value to a group selection.
 *
 * @param value - The value to parse.
 * @returns The selection, or `undefined` when the value is not one.
@@ -3261,7 +3295,7 @@ function parseGroups(value) {
 	return isGroups(value) ? value : void 0;
 }
 /**
-* Coerce an untrusted value to a {@link Snapshot}.
+* Coerces an untrusted value to a {@link Snapshot}.
 *
 * @param value - The value to parse.
 * @returns The snapshot, or `undefined` when the value is not one.
@@ -3281,7 +3315,7 @@ function parseSnapshot(value) {
 	return isSnapshot(value) ? value : void 0;
 }
 /**
-* Coerce an untrusted value to {@link CompilerOptions}.
+* Coerces an untrusted value to {@link CompilerOptions}.
 *
 * @param value - The value to parse.
 * @returns The options, or `undefined` when the value is not an option bag.
@@ -3305,7 +3339,7 @@ function parseCompilerOptions(value) {
 //#endregion
 //#region src/core/helpers.ts
 /**
-* Encode bytes as exact lowercase hexadecimal text.
+* Encodes bytes as exact lowercase hexadecimal text.
 *
 * @param bytes - The bytes to encode.
 * @returns Two lowercase hexadecimal digits per input byte, and `''` for no bytes.
@@ -3329,7 +3363,7 @@ function bytesToHex(bytes) {
 	return hex;
 }
 /**
-* Encode text as the exact lowercase hexadecimal form of its UTF-8 bytes.
+* Encodes text as the exact lowercase hexadecimal form of its UTF-8 bytes.
 *
 * @param content - The text to encode.
 * @returns The hexadecimal form of the text's exact UTF-8 bytes.
@@ -3351,7 +3385,7 @@ function contentToHex(content) {
 	return bytesToHex(new TextEncoder().encode(content));
 }
 /**
-* Count the UTF-8 bytes text encodes to.
+* Counts the UTF-8 bytes text encodes to.
 *
 * @param content - The text to measure.
 * @returns The exact number of UTF-8 bytes.
@@ -3379,7 +3413,7 @@ function computeBytes(content) {
 	return bytes;
 }
 /**
-* Compute the deterministic content identity of text.
+* Computes the deterministic content identity of text.
 *
 * @param text - The text to digest.
 * @returns Sixteen lowercase hexadecimal digits.
@@ -3408,11 +3442,11 @@ function computeHash(text) {
 	return hash.toString(16).padStart(16, "0");
 }
 /**
-* Test whether a path instructs or wires an agent rather than the toolchain.
+* Tests whether a path instructs or wires an agent rather than the toolchain.
 *
 * @param path - The target-relative path to test.
-* @returns `true` when the path is beneath a harness directory or is one of the
-* exact root filenames that wires an agent bench.
+* @returns True if the path is beneath a harness directory or is one of the exact
+* root filenames that wires an agent bench; false otherwise.
 *
 * @remarks
 * The one home of the orchestration membership rule. A vendored path and a
@@ -3437,8 +3471,8 @@ function matchesOrchestrationPath(path) {
 * Checks whether another surface owns the vendored bytes at a path.
 *
 * @param path - The target-relative vendored path to test.
-* @returns `true` for the catalog agent file and for a Markdown guide mirror;
-* `false` otherwise.
+* @returns True if the path is the catalog agent file or a Markdown guide
+* mirror; false otherwise.
 *
 * @remarks
 * The materializer keeps these paths presence-owned because the catalog or
@@ -3460,8 +3494,8 @@ function isDeferredPath(path) {
 * Checks whether a path belongs to the instruction canon a target reads rather than holds.
 *
 * @param path - The target-relative path to test.
-* @returns `true` for a {@link CANON_PATHS} member and for any path beneath a
-* member that is a directory; `false` otherwise.
+* @returns True if the path is a {@link CANON_PATHS} member or sits beneath a
+* member that is a directory; false otherwise.
 *
 * @remarks
 * The one reading of canon membership, so the live overlay and the executable's
@@ -3486,7 +3520,57 @@ function isCanonPath(path) {
 	return CANON_PATHS.some((canon) => path === canon || path.startsWith(`${canon}/`));
 }
 /**
-* Infer the {@link Group} a path belongs to.
+* Checks whether a target's present bytes at a path are owned by another surface.
+*
+* @param path - The target-relative path to test.
+* @returns True if the path is a {@link WORKSPACE_OWNED_PATHS} member or a
+* deferred path; false otherwise.
+*
+* @remarks
+* The one reading of presence ownership. A workspace-owned path carries bytes
+* the consumer's own workspace writes, and a deferred path carries bytes the
+* catalog or mirror surface writes, so a vendored expansion plans either by
+* presence rather than reading and claiming its content.
+*
+* @example
+* ```ts
+* import { isRetainedPath } from '@orkestrel/scaffold'
+*
+* isRetainedPath('.gitignore') // true
+* isRetainedPath('LICENSE') // false
+* ```
+*/
+function isRetainedPath(path) {
+	return WORKSPACE_OWNED_PATHS.includes(path) || isDeferredPath(path);
+}
+/**
+* Checks whether a destination's floor bytes survive a live overlay.
+*
+* @param path - The target-relative destination to test.
+* @returns True if the path is deferred or belongs to the instruction
+* canon; false otherwise.
+*
+* @remarks
+* The one reading of what a live fill does not replace, so the overlay assembler
+* and the executable's fetch list never disagree about a destination. A deferred
+* path's bytes belong to the catalog or mirror verb, and a canon destination is
+* staged for reading rather than for a target, so the installed floor's bytes
+* stand for both. A reader that requested either would spend a round trip on
+* bytes the overlay would not take.
+*
+* @example
+* ```ts
+* import { isFloorPath } from '@orkestrel/scaffold'
+*
+* isFloorPath('AGENTS.md') // true
+* isFloorPath('scripts/codex.sh') // false
+* ```
+*/
+function isFloorPath(path) {
+	return isDeferredPath(path) || isCanonPath(path);
+}
+/**
+* Infers the {@link Group} a path belongs to.
 *
 * @param path - The target-relative path to classify.
 * @returns The group that owns the path.
@@ -3521,7 +3605,7 @@ function inferGroup(path) {
 	return "configs";
 }
 /**
-* Serialize one string as a single-quoted TypeScript literal.
+* Serializes one string as a single-quoted TypeScript literal.
 *
 * @param value - The string to serialize.
 * @returns A complete single-quoted literal with line-breaking and delimiter
@@ -3564,7 +3648,7 @@ function serializeTypeScriptString(value) {
 	return `${serialized}'`;
 }
 /**
-* Derive the guide mirror path a package name answers for.
+* Derives the guide mirror path a package name answers for.
 *
 * @param name - A bare or `@orkestrel`-scoped package name.
 * @returns The mirror path, `guides/<bare name>.md`.
@@ -3589,10 +3673,10 @@ function nameToGuide(name) {
 	return `guides/${name.slice(name.lastIndexOf("/") + 1)}.md`;
 }
 /**
-* Test whether one emitted line fits the vendored formatter width.
+* Tests whether one emitted line fits the vendored formatter width.
 *
 * @param line - One emitted line, leading tabs included.
-* @returns `true` when the expanded line fits.
+* @returns True if the expanded line fits; false otherwise.
 *
 * @remarks
 * A generator writes source the formatter then reads back, so a line packed
@@ -3613,7 +3697,7 @@ function matchesPrintWidth(line) {
 	return line.replaceAll("	", " ".repeat(2)).length <= 100;
 }
 /**
-* Derive the declaration rewrite a published face's `beforeWriteFile` applies.
+* Derives the declaration rewrite a published face's `beforeWriteFile` applies.
 *
 * @param name - The workspace's own bare package name.
 * @returns The ternary consequent an emitted `vite.{browser,server}.config.ts`
@@ -3653,7 +3737,34 @@ function nameToRewrite(name) {
 	].join("\n");
 }
 /**
-* Select the host paths a named workspace vendors.
+* Selects the single published environment a package root points at.
+*
+* @param src - The declared published environments.
+* @returns That environment, or `undefined` when the selection declares none or
+* several.
+*
+* @remarks
+* A workspace publishing exactly one environment puts it at the package root,
+* so its entry fields and its `'.'` export condition both name that
+* environment's build. A workspace publishing several puts core at the root and
+* gives every other environment a subpath, so there is no single root to name.
+* Both callers read the same answer, which is why the branch is decided once
+* here rather than twice.
+*
+* @example
+* ```ts
+* import { srcToRoot } from '@orkestrel/scaffold'
+*
+* srcToRoot(['browser']) // 'browser'
+* srcToRoot(['core', 'server']) // undefined
+* ```
+*/
+function srcToRoot(src) {
+	if (src.length !== 1) return void 0;
+	return src[0];
+}
+/**
+* Selects the host paths a named workspace vendors.
 *
 * @param paths - The candidate host paths, in their declared order.
 * @param name - The target workspace's own bare package name.
@@ -3676,7 +3787,7 @@ function selectHostPaths(paths, name) {
 	return paths.filter((path) => path !== guide);
 }
 /**
-* Select the groups a compile covers, in plan order.
+* Selects the groups a compile covers, in plan order.
 *
 * @param groups - The requested selection; every group when absent.
 * @returns The requested groups in `GROUPS` order, without repeats.
@@ -3701,7 +3812,7 @@ function selectGroups(groups) {
 	return GROUPS.filter((group) => selection.includes(group));
 }
 /**
-* Project an artifact to the exact bytes it claims, as hexadecimal.
+* Projects an artifact to the exact bytes it claims, as hexadecimal.
 *
 * @param artifact - The planned artifact to read.
 * @returns The claimed bytes, or `undefined` when the artifact claims none.
@@ -3730,7 +3841,7 @@ function artifactToHex(artifact) {
 	return artifact.hex;
 }
 /**
-* Infer how one target path compares to the artifact planned for it.
+* Infers how one target path compares to the artifact planned for it.
 *
 * @param artifact - The planned artifact.
 * @param observed - The destination's exact bytes as hexadecimal; absent when
@@ -3772,16 +3883,99 @@ function inferDrift(artifact, observed) {
 	return observed === artifactToHex(artifact) ? "aligned" : "stale";
 }
 /**
-* Test whether {@link inferDrift} could have produced a finding for an ownership.
+* Projects one planned artifact and the bytes found at its path into a verdict.
+*
+* @param artifact - The planned artifact.
+* @param observed - The destination's exact bytes as hexadecimal; absent when
+* the destination holds no file.
+* @returns The finding, carrying the artifact's ownership and `observed`
+* exactly where bytes were read.
+*
+* @remarks
+* The comparison itself is {@link inferDrift}'s, so ownership decides it here
+* exactly as it does everywhere else. This adds only the shape: a missing
+* 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 every ownership tier.
+*
+* `foreign` is not answerable here, because it describes a path no artifact was
+* planned for.
+*
+* @example
+* ```ts
+* import { artifactToFinding } from '@orkestrel/scaffold'
+*
+* artifactToFinding(
+* 	{ path: 'README.md', group: 'docs', ownership: 'content', origin: 'computed', content: 'hi\n' },
+* 	'6279650a',
+* ) // { path: 'README.md', group: 'docs', ownership: 'content', drift: 'stale', observed: '6279650a' }
+* ```
+*/
+function artifactToFinding(artifact, observed) {
+	const path = artifact.path;
+	const group = artifact.group;
+	const ownership = artifact.ownership;
+	if (observed === void 0) return inferDrift(artifact) === "aligned" ? {
+		path,
+		group,
+		ownership,
+		drift: "aligned"
+	} : {
+		path,
+		group,
+		ownership,
+		drift: "missing"
+	};
+	return inferDrift(artifact, observed) === "stale" ? {
+		path,
+		group,
+		ownership,
+		drift: "stale",
+		observed
+	} : {
+		path,
+		group,
+		ownership,
+		drift: "aligned",
+		observed
+	};
+}
+/**
+* Tests whether {@link inferDrift} could have produced a finding for an ownership.
 *
 * @param ownership - What scaffold claims at the planned path.
 * @param finding - The audit verdict to test.
-* @returns Whether the ownership and verdict are reachable through {@link inferDrift}.
+* @returns True if the ownership and verdict are reachable through
+* {@link inferDrift}; false otherwise.
 *
 * @remarks
 * This predicate keeps the comparison law beside the reachability law it
 * restates. A mutation uses it so a refusal can distinguish an impossible
 * verdict from a target that genuinely moved after its audit.
+*
+* @example
+* ```ts
+* import type { Finding } from '@orkestrel/scaffold'
+* import { matchesDriftReachability } from '@orkestrel/scaffold'
+*
+* const aligned: Finding = {
+* 	path: 'README.md',
+* 	group: 'docs',
+* 	ownership: 'birth',
+* 	drift: 'aligned',
+* }
+* const stale: Finding = {
+* 	path: 'README.md',
+* 	group: 'docs',
+* 	ownership: 'birth',
+* 	drift: 'stale',
+* 	observed: '6279650a',
+* }
+*
+* matchesDriftReachability('birth', aligned) // true
+* matchesDriftReachability('birth', stale) // false
+* ```
 */
 function matchesDriftReachability(ownership, finding) {
 	if (finding.drift === "aligned") return ownership === "birth" || finding.observed !== void 0;
@@ -3789,7 +3983,7 @@ function matchesDriftReachability(ownership, finding) {
 	return finding.drift === "stale" && ownership === "content";
 }
 /**
-* Project a catalog into the layers it publishes in.
+* Projects a catalog into the layers it publishes in.
 *
 * @param entries - The catalog rows to order.
 * @returns One layer per round, each holding the names publishable together,
@@ -3837,7 +4031,7 @@ function catalogToLayers(entries) {
 	return layers;
 }
 /**
-* Project a plan into its tally by artifact origin.
+* Projects a plan into its tally by artifact origin.
 *
 * @param plan - The plan to summarize.
 * @returns The workspace's name, both environment axes, the covered groups, and
@@ -3874,7 +4068,7 @@ function planToSummary(plan) {
 	};
 }
 /**
-* Extract the major, minor, and patch components of an exact version.
+* Extracts 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
@@ -3904,7 +4098,7 @@ function extractVersion(version) {
 	];
 }
 /**
-* Extract the major component of an admitted dependency range.
+* Extracts the major component of an admitted dependency range.
 *
 * @param range - The candidate range text.
 * @returns The major number, or `undefined` when the text is not a canonical
@@ -3930,7 +4124,7 @@ function extractRangeMajor(range) {
 	return major === void 0 ? void 0 : Number(major);
 }
 /**
-* Compare two versions by their numeric components.
+* Compares two versions by their numeric components.
 *
 * @param left - The version ordered first when it compares lower.
 * @param right - The version compared against.
@@ -3965,11 +4159,11 @@ function compareVersions(left, right) {
 	return 0;
 }
 /**
-* Test whether a declared range already admits a published version.
+* Tests whether a declared range already admits a published version.
 *
 * @param range - The declared dependency range.
 * @param latest - The version the registry reported as latest.
-* @returns `true` when the range admits that version.
+* @returns True if the range admits that version; false otherwise.
 *
 * @remarks
 * The one place this comparison is made. A `Release` records the declared range
@@ -4022,11 +4216,11 @@ function matchesRange(range, latest) {
 	return compareVersions(latest, declared) >= 0;
 }
 /**
-* Test whether a declared engines floor is at or above the supported minimum.
+* Tests whether a declared engines floor is at or above the supported minimum.
 *
 * @param engines - The declared `engines.node` range.
-* @returns `true` when the range is the accepted syntax and its floor is at or
-* above `MINIMUM_NODE_VERSION`.
+* @returns True if the range is the accepted syntax and its floor is at or above
+* `MINIMUM_NODE_VERSION`; false otherwise.
 *
 * @remarks
 * The declaration states a floor, so the comparison is against the oldest Node
@@ -4047,7 +4241,7 @@ function matchesEngines(engines) {
 	return compareVersions(engines.slice(2), MINIMUM_NODE_VERSION) >= 0;
 }
 /**
-* Project a package manifest's text to its own name.
+* Projects a package manifest's text to its own name.
 *
 * @param manifest - The `package.json` text.
 * @returns The declared name, or `undefined` when the text is oversized,
@@ -4075,7 +4269,8 @@ function manifestToName(manifest) {
 	return name;
 }
 /**
-* Project a package manifest's text to the `@orkestrel/*` packages each dependency section declares.
+* Projects a package manifest's text to the `@orkestrel/*` packages each dependency
+* section declares.
 *
 * @param manifest - The `package.json` text.
 * @returns The runtime, development, and peer declarations as separate lists.
@@ -4147,34 +4342,7 @@ function manifestToDependencies(manifest) {
 //#endregion
 //#region src/core/compilers.ts
 /**
-* Select the single published environment a package root points at.
-*
-* @param src - The declared published environments.
-* @returns That environment, or `undefined` when the selection declares none or
-* several.
-*
-* @remarks
-* A workspace publishing exactly one environment puts it at the package root,
-* so its entry fields and its `'.'` export condition both name that
-* environment's build. A workspace publishing several puts core at the root and
-* gives every other environment a subpath, so there is no single root to name.
-* Both callers read the same answer, which is why the branch is decided once
-* here rather than twice.
-*
-* @example
-* ```ts
-* import { srcToRoot } from '@orkestrel/scaffold'
-*
-* srcToRoot(['browser']) // 'browser'
-* srcToRoot(['core', 'server']) // undefined
-* ```
-*/
-function srcToRoot(src) {
-	if (src.length !== 1) return void 0;
-	return src[0];
-}
-/**
-* Build one `exports` condition block for a built environment.
+* Builds one `exports` condition block for a built environment.
 *
 * @param path - The extensionless `dist` path both conditions point at.
 * @param formats - The module formats that environment builds.
@@ -4210,7 +4378,7 @@ function pathToCondition(path, formats) {
 	};
 }
 /**
-* Project a published selection into the manifest's entry fields.
+* Projects a published selection into the manifest's entry fields.
 *
 * @param src - The declared published environments.
 * @returns The `main` and `module` fields, plus `types` when one environment
@@ -4247,7 +4415,7 @@ function srcToEntry(src) {
 	};
 }
 /**
-* Project a published selection into the manifest's `exports` map.
+* Projects a published selection into the manifest's `exports` map.
 *
 * @param src - The declared published environments.
 * @returns The map, keyed by subpath in `ENVIRONMENTS` order.
@@ -4284,7 +4452,7 @@ function srcToExports(src) {
 	return map;
 }
 /**
-* Project a blueprint into the development dependencies its manifest declares.
+* Projects a blueprint into the development dependencies its manifest declares.
 *
 * @param blueprint - The workspace specification.
 * @returns The merged set, sorted by package name.
@@ -4336,7 +4504,7 @@ function blueprintToDevDependencies(blueprint) {
 	return Object.fromEntries(Object.entries(merged).filter(([name]) => name !== own && !runtime.has(name)).sort(([left], [right]) => compareValues(left, right)));
 }
 /**
-* Project a blueprint into the scripts its manifest declares.
+* Projects a blueprint into the scripts its manifest declares.
 *
 * @param blueprint - The workspace specification.
 * @returns The scripts, in the order the manifest lists them.
@@ -4473,7 +4641,7 @@ function blueprintToScripts(blueprint) {
 	return scripts;
 }
 /**
-* Project a blueprint into the manifest scripts a region write may replace.
+* Projects a blueprint into the manifest scripts a region write may replace.
 *
 * @param blueprint - The workspace specification.
 * @returns One entry per writable script.
@@ -4530,7 +4698,7 @@ function blueprintToWritableScripts(blueprint) {
 	return writable;
 }
 /**
-* Compile a blueprint into its `package.json` content.
+* Compiles a blueprint into its `package.json` content.
 *
 * @param blueprint - The workspace specification.
 * @returns The manifest text, newline-terminated.
@@ -4616,7 +4784,7 @@ function blueprintToManifest(blueprint) {
 	return `${JSON.stringify(manifest, void 0, "	")}\n`;
 }
 /**
-* Derive the host-specific machinery a generated root Vite configuration carries.
+* Derives the host-specific machinery a generated root Vite configuration carries.
 *
 * @param blueprint - The workspace specification.
 * @returns The pipelines the generated configuration selects.
@@ -4652,7 +4820,7 @@ function blueprintToMachinery(blueprint) {
 	};
 }
 /**
-* Compile the root TypeScript configuration for a blueprint.
+* Compiles the root TypeScript configuration for a blueprint.
 *
 * @param blueprint - The workspace specification.
 * @returns Formatter-stable `tsconfig.json` text.
@@ -4674,7 +4842,7 @@ function blueprintToRootTsconfig(blueprint) {
 	return fillTemplate(CONFIG_TEMPLATES.root.tsconfig, { paths });
 }
 /**
-* Compile the root Vite and Vitest configuration for a blueprint.
+* Compiles the root Vite and Vitest configuration for a blueprint.
 *
 * @param blueprint - The workspace specification.
 * @returns Formatter-stable `vite.config.ts` text.
@@ -4865,7 +5033,7 @@ ${projects.map((project) => `\t\t\t${project},`).join("\n")}
 	});
 }
 /**
-* Compile every artifact in the `configs` group.
+* Compiles every artifact in the `configs` group.
 *
 * @param blueprint - The workspace specification.
 * @returns Root and selected wrapper artifacts in matrix order.
@@ -4975,7 +5143,7 @@ ${paths.join("\n")}
 	return artifacts;
 }
 /**
-* Compile every artifact in the `source` group.
+* Compiles every artifact in the `source` group.
 *
 * @param blueprint - The workspace specification.
 * @returns Empty published barrels, selected application entries, and the optional bin entry.
@@ -5050,7 +5218,7 @@ function blueprintToSourceArtifacts(blueprint) {
 	return artifacts;
 }
 /**
-* Compile every artifact in the `tests` group that is not vendored from the host.
+* Compiles every artifact in the `tests` group that is not vendored from the host.
 *
 * @param blueprint - The workspace specification.
 * @returns Shared setup modules, axis tests, and the optional integration seed.
@@ -5206,10 +5374,19 @@ function blueprintToTestArtifacts(blueprint) {
 	return artifacts;
 }
 /**
-* Compile the generated workspace's guide index.
+* Compiles the generated workspace's guide index.
 *
 * @param blueprint - The workspace specification.
 * @returns One birth-owned guide index carrying the concept and directory views.
+*
+* @example
+* ```ts
+* import { blueprintToGuideArtifacts, createBlueprint } from '@orkestrel/scaffold'
+*
+* const blueprint = createBlueprint('router', { src: ['core'] })
+*
+* blueprintToGuideArtifacts(blueprint)[0]?.path // 'guides/README.md'
+* ```
 */
 function blueprintToGuideArtifacts(blueprint) {
 	const source = [];
@@ -5245,7 +5422,7 @@ function blueprintToGuideArtifacts(blueprint) {
 	}];
 }
 /**
-* Compile the generated workspace's root documentation.
+* Compiles the generated workspace's root documentation.
 *
 * @param blueprint - The workspace specification.
 * @returns The birth-owned package front page and the content-owned `AGENTS.md`
@@ -5264,6 +5441,15 @@ function blueprintToGuideArtifacts(blueprint) {
 * Neither pointer carries a varying span, so neither is filled: a workspace's
 * name never reaches the text, and the paths a reader follows are the same in
 * every target.
+*
+* @example
+* ```ts
+* import { blueprintToDocumentArtifacts, createBlueprint } from '@orkestrel/scaffold'
+*
+* const blueprint = createBlueprint('router', { src: ['core'] })
+*
+* blueprintToDocumentArtifacts(blueprint).map((artifact) => artifact.path) // ['README.md', 'AGENTS.md', 'CLAUDE.md']
+* ```
 */
 function blueprintToDocumentArtifacts(blueprint) {
 	const publishes = blueprint.src.length > 0;
@@ -5297,7 +5483,7 @@ function blueprintToDocumentArtifacts(blueprint) {
 	];
 }
 /**
-* Compile the blueprint-dependent orchestration artifacts.
+* Compiles the blueprint-dependent orchestration artifacts.
 *
 * @param blueprint - The workspace specification.
 * @returns A vendor inventory script when vendors are declared, otherwise none.
@@ -5306,6 +5492,17 @@ function blueprintToDocumentArtifacts(blueprint) {
 * A vendor name does not describe startup, readiness, or cleanup. The script
 * therefore records only the declared inventory and does not invent a service
 * runner or test project.
+*
+* @example
+* ```ts
+* import { blueprintToOrchestrationArtifacts, createBlueprint } from '@orkestrel/scaffold'
+*
+* const plain = createBlueprint('router', { src: ['core'] })
+* const served = createBlueprint('router', { src: ['core'], vendors: ['ollama'] })
+*
+* blueprintToOrchestrationArtifacts(plain) // []
+* blueprintToOrchestrationArtifacts(served)[0]?.path // 'scripts/service.sh'
+* ```
 */
 function blueprintToOrchestrationArtifacts(blueprint) {
 	if (blueprint.vendors.length === 0) return [];
@@ -5319,7 +5516,7 @@ function blueprintToOrchestrationArtifacts(blueprint) {
 	}];
 }
 /**
-* Compile the vendored host artifacts a named workspace plans.
+* Compiles the vendored host artifacts a named workspace plans.
 *
 * @param name - The target workspace's own bare package name.
 * @returns One artifact per vendored path in `HOST_PATHS` order, then the
@@ -5364,7 +5561,7 @@ function nameToHostArtifacts(name) {
 	}));
 }
 /**
-* Replace the content of every drafted artifact an override names.
+* Replaces the content of every drafted artifact an override names.
 *
 * @param artifacts - The drafted artifacts.
 * @param overrides - The blueprint's overrides.
@@ -5399,7 +5596,7 @@ function applyOverrides(artifacts, overrides) {
 	});
 }
 /**
-* Replace declared dependency ranges in package manifest text.
+* Replaces declared dependency ranges in package manifest text.
 *
 * @param manifest - The manifest text to compile.
 * @param pins - The runtime and development names and replacement ranges.
@@ -5580,7 +5777,7 @@ function replaceManifestRanges(manifest, pins) {
 	return declaredRuntime && declaredDevelopment ? compiled : void 0;
 }
 /**
-* Replace named script values in package manifest text.
+* Replaces named script values in package manifest text.
 *
 * @param manifest - The manifest text to compile.
 * @param scripts - The scripts to write, each with the predecessors it accepts.
@@ -5808,7 +6005,7 @@ function replaceManifestScripts(manifest, scripts) {
 	return compiled;
 }
 /**
-* Replace dependency ranges in a plan's manifest and recompute its identity.
+* Replaces dependency ranges in a plan's manifest and recomputes its identity.
 *
 * @param plan - The plan carrying the manifest artifact to compile.
 * @param pins - The runtime and development names and replacement ranges.
@@ -5856,7 +6053,7 @@ function replacePlanRanges(plan, pins) {
 	};
 }
 /**
-* Compute a plan's content identity.
+* Computes a plan's content identity.
 *
 * @param plan - The plan to identify.
 * @returns Sixteen lowercase hexadecimal digits, or `undefined` when the plan
@@ -5893,66 +6090,7 @@ function planToHash(plan) {
 	return computeHash(outcome.value);
 }
 /**
-* Project one planned artifact and the bytes found at its path into a verdict.
-*
-* @param artifact - The planned artifact.
-* @param observed - The destination's exact bytes as hexadecimal; absent when
-* the destination holds no file.
-* @returns The finding, carrying the artifact's ownership and `observed`
-* exactly where bytes were read.
-*
-* @remarks
-* The comparison itself is {@link inferDrift}'s, so ownership decides it here
-* exactly as it does everywhere else. This adds only the shape: a missing
-* 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 every ownership tier.
-*
-* `foreign` is not answerable here, because it describes a path no artifact was
-* planned for.
-*
-* @example
-* ```ts
-* import { artifactToFinding } from '@orkestrel/scaffold'
-*
-* artifactToFinding(
-* 	{ path: 'README.md', group: 'docs', ownership: 'content', origin: 'computed', content: 'hi\n' },
-* 	'6279650a',
-* ) // { path: 'README.md', group: 'docs', ownership: 'content', drift: 'stale', observed: '6279650a' }
-* ```
-*/
-function artifactToFinding(artifact, observed) {
-	const path = artifact.path;
-	const group = artifact.group;
-	const ownership = artifact.ownership;
-	if (observed === void 0) return inferDrift(artifact) === "aligned" ? {
-		path,
-		group,
-		ownership,
-		drift: "aligned"
-	} : {
-		path,
-		group,
-		ownership,
-		drift: "missing"
-	};
-	return inferDrift(artifact, observed) === "stale" ? {
-		path,
-		group,
-		ownership,
-		drift: "stale",
-		observed
-	} : {
-		path,
-		group,
-		ownership,
-		drift: "aligned",
-		observed
-	};
-}
-/**
-* Compare a plan against a target's current content.
+* Compares a plan against a target's current content.
 *
 * @param plan - The compiled plan.
 * @param current - The target's exact bytes, keyed by artifact-relative path.
@@ -5998,7 +6136,7 @@ function planToFindings(plan, current) {
 	return findings;
 }
 /**
-* Measure one declared package list against the name and range syntax it accepts.
+* Measures one declared package list against the name and range syntax it accepts.
 *
 * @param dependencies - The declared list.
 * @param field - The blueprint field the list came from, reported on each question.
@@ -6055,7 +6193,7 @@ function dependenciesToQuestions(dependencies, field, name, range) {
 	return questions;
 }
 /**
-* Measure a blueprint against every law its own fields decide.
+* Measures a blueprint against every law its own fields decide.
 *
 * @param blueprint - The workspace specification.
 * @returns One question per rejected field, in blueprint field order, with the
@@ -6195,7 +6333,7 @@ function blueprintToQuestions(blueprint) {
 	return questions;
 }
 /**
-* Measure a drafted artifact list against the laws a whole plan decides.
+* Measures a drafted artifact list against the laws a whole plan decides.
 *
 * @param artifacts - The drafted artifacts.
 * @returns One blocking question per colliding path and per exceeded ceiling.
@@ -6252,7 +6390,7 @@ function artifactsToQuestions(artifacts) {
 	return questions;
 }
 /**
-* Measure a blueprint's overrides against the artifacts drafted for it.
+* Measures a blueprint's overrides against the artifacts drafted for it.
 *
 * @param overrides - The blueprint's overrides.
 * @param artifacts - The drafted artifacts, before overrides are applied.
@@ -6316,7 +6454,7 @@ function overridesToQuestions(overrides, artifacts) {
 //#endregion
 //#region src/core/factories.ts
 /**
-* Construct a {@link Blueprint} from a name and the fields that differ from the defaults.
+* Constructs 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.
@@ -6381,7 +6519,7 @@ function createBlueprint(name, input) {
 //#endregion
 //#region src/core/Compiler.ts
 /**
-* The compile spine: draft, gate, pin, run in that order over a blueprint.
+* Represents the compile spine: draft, gate, pin, run in that order over a blueprint.
 *
 * @remarks
 * The draft stage assembles the artifacts the selected groups cover. The gate
@@ -6425,7 +6563,7 @@ var Compiler = class {
 	#emitter;
 	#destroyed = false;
 	/**
-	* Construct a compiler.
+	* Constructs a compiler.
 	*
 	* @param options - The initial listeners and the listener-error handler.
 	* @throws {@link ScaffoldError} coded `INVALID` when `options` is present but
@@ -6445,12 +6583,12 @@ var Compiler = class {
 			...accepted?.error === void 0 ? {} : { error: accepted.error }
 		});
 	}
-	/** The compiler's observation channel. */
+	/** Exposes the compiler's observation channel. */
 	get emitter() {
 		return this.#emitter;
 	}
 	/**
-	* Compile a blueprint into a plan through the draft, gate, and pin stages.
+	* Compiles a blueprint into a plan through the draft, gate, and pin stages.
 	*
 	* @param blueprint - The workspace specification to compile.
 	* @param groups - The artifact groups to cover; every group when absent.
@@ -6489,7 +6627,7 @@ var Compiler = class {
 		return scaffolding;
 	}
 	/**
-	* Compile a blueprint and compare its plan to a target's current content.
+	* Compiles a blueprint and compares its plan to a target's current content.
 	*
 	* @param blueprint - The workspace specification to compile.
 	* @param current - The target's exact bytes, keyed by artifact-relative path.
@@ -6532,7 +6670,7 @@ var Compiler = class {
 		return result;
 	}
 	/**
-	* Tear the compiler down. Every later call throws, and teardown is idempotent.
+	* Tears the compiler down. Every later call throws, and teardown is idempotent.
 	*
 	* @returns Nothing.
 	*
@@ -6680,6 +6818,6 @@ var Compiler = class {
 	}
 };
 //#endregion
-export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, CANON_PATHS, CATALOG_AGENT_PATH, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_INVENTORY_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, MANIFEST_PATH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_SCRIPT_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, RELEASE_PROOF_COMMAND, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, ScaffoldError, TAB_WIDTH, VERSION_PATTERN, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToGuideArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSourceArtifacts, blueprintToTestArtifacts, blueprintToWritableScripts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, dependenciesToQuestions, extractRangeMajor, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isCanonPath, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDeferredPath, isDependency, isDependencyName, isEnvironment, isFinding, isGroup, isGroups, isHex, isManifestScript, isMirror, isOverride, isPath, isPlan, isQuestion, isScaffoldError, isSnapshot, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, nameToHostArtifacts, nameToRewrite, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, replaceManifestRanges, replaceManifestScripts, replacePlanRanges, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
+export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_CLOSING_MARKER, CATALOG_OPENING_MARKER, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_INVENTORY_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, MANIFEST_PATH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_SCRIPT_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, RELEASE_PROOF_COMMAND, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, ScaffoldError, TAB_WIDTH, VERSION_PATTERN, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToGuideArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSourceArtifacts, blueprintToTestArtifacts, blueprintToWritableScripts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, dependenciesToQuestions, extractRangeMajor, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isCanonPath, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDeferredPath, isDependency, isDependencyName, isEnvironment, isFinding, isFloorPath, isGroup, isGroups, isHex, isManifestScript, isMirror, isOverride, isPath, isPlan, isQuestion, isRetainedPath, isScaffoldError, isSnapshot, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, nameToHostArtifacts, nameToRewrite, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, replaceManifestRanges, replaceManifestScripts, replacePlanRanges, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
 
 //# sourceMappingURL=index.js.map