@orkestrel/scaffold 0.0.60 → 0.0.62

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.60",
+	version: "0.0.62",
 	description: "Scaffold workspaces with five commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -59,7 +59,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",
@@ -68,7 +68,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",
@@ -78,6 +78,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",
@@ -89,19 +90,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",
@@ -117,7 +118,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
@@ -131,7 +132,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
@@ -148,7 +149,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`,
@@ -178,7 +179,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
@@ -201,24 +203,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.
@@ -248,7 +251,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
@@ -294,10 +297,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
@@ -307,7 +310,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
@@ -326,7 +329,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
@@ -344,7 +347,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
@@ -352,7 +355,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
@@ -366,16 +369,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
@@ -383,22 +404,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
@@ -408,7 +435,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
@@ -418,10 +445,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
@@ -430,10 +457,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
@@ -441,44 +468,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
@@ -488,24 +518,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"],
@@ -518,19 +548,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"],
@@ -539,7 +572,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
@@ -549,7 +582,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",
@@ -559,7 +592,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
@@ -1230,8 +1263,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\`
@@ -1249,17 +1282,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
@@ -1271,7 +1304,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',
@@ -1292,10 +1325,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
@@ -1313,7 +1346,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.
@@ -1336,7 +1369,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.
  *
@@ -1359,7 +1392,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
@@ -1406,7 +1439,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.
@@ -1435,7 +1468,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.
@@ -1479,7 +1512,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.
@@ -1534,7 +1567,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
@@ -2628,7 +2661,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
@@ -2665,7 +2698,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.
@@ -2679,10 +2712,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
@@ -2698,11 +2731,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
@@ -2731,7 +2764,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.
@@ -2751,7 +2784,7 @@ var isHex = (0, _orkestrel_contract.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
@@ -2762,10 +2795,11 @@ var isHex = (0, _orkestrel_contract.stringOf)({
 */
 var isContent = (0, _orkestrel_contract.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
@@ -2784,7 +2818,7 @@ function isCollection(value) {
 	return (0, _orkestrel_contract.holds)(() => (0, _orkestrel_contract.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
@@ -2796,7 +2830,7 @@ function isCollection(value) {
 */
 var isEnvironment = (0, _orkestrel_contract.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
@@ -2807,10 +2841,10 @@ var isEnvironment = (0, _orkestrel_contract.literalOf)(ENVIRONMENTS);
 * ```
 */
 var isGroup = (0, _orkestrel_contract.literalOf)(GROUPS);
-/** Narrow a value to a bounded group selection. */
+/** Narrows a value to a bounded group selection. */
 var isGroups = (0, _orkestrel_contract.andOf)(isCollection, (0, _orkestrel_contract.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
@@ -2832,7 +2866,7 @@ var isDependencyName = (0, _orkestrel_contract.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
@@ -2859,7 +2893,7 @@ var isDependency = (0, _orkestrel_contract.recordOf)({
 	optional: _orkestrel_contract.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
@@ -2890,7 +2924,7 @@ var isManifestScript = (0, _orkestrel_contract.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
@@ -2908,7 +2942,7 @@ var isOverride = (0, _orkestrel_contract.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
@@ -2949,7 +2983,7 @@ var isBlueprint = (0, _orkestrel_contract.recordOf)({
 	showcase: _orkestrel_contract.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
@@ -2989,7 +3023,7 @@ var isArtifact = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.record
 	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
@@ -3005,7 +3039,7 @@ var isPlan = (0, _orkestrel_contract.andOf)((0, _orkestrel_contract.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
@@ -3021,7 +3055,7 @@ var isQuestion = (0, _orkestrel_contract.recordOf)({
 	candidates: (0, _orkestrel_contract.andOf)(isCollection, (0, _orkestrel_contract.arrayOf)(_orkestrel_contract.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,
@@ -3058,7 +3092,7 @@ var isFinding = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.recordO
 	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
@@ -3070,7 +3104,7 @@ var isAudit = (0, _orkestrel_contract.recordOf)({
 	questions: (0, _orkestrel_contract.andOf)(isCollection, (0, _orkestrel_contract.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
@@ -3091,7 +3125,7 @@ var isMirror = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.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
@@ -3108,11 +3142,11 @@ var isCatalogEntry = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.re
 	note: _orkestrel_contract.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
@@ -3138,7 +3172,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
@@ -3153,7 +3187,7 @@ var isCompilerHooks = (0, _orkestrel_contract.recordOf)({
 	destroy: _orkestrel_contract.isFunction
 }, true);
 /**
-* Narrow a value to {@link CompilerOptions}.
+* Narrows a value to {@link CompilerOptions}.
 *
 * @example
 * ```ts
@@ -3170,7 +3204,7 @@ var isCompilerOptions = (0, _orkestrel_contract.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`
@@ -3218,7 +3252,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.
@@ -3240,7 +3274,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.
@@ -3262,7 +3296,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.
@@ -3282,7 +3316,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.
@@ -3306,7 +3340,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.
@@ -3330,7 +3364,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.
@@ -3352,7 +3386,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.
@@ -3380,7 +3414,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.
@@ -3409,11 +3443,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
@@ -3438,8 +3472,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
@@ -3461,8 +3495,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
@@ -3487,7 +3521,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.
@@ -3522,7 +3606,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
@@ -3565,7 +3649,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`.
@@ -3590,10 +3674,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
@@ -3614,7 +3698,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`
@@ -3654,7 +3738,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.
@@ -3677,7 +3788,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.
@@ -3702,7 +3813,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.
@@ -3731,7 +3842,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
@@ -3773,16 +3884,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;
@@ -3790,7 +3984,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,
@@ -3838,7 +4032,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
@@ -3875,7 +4069,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
@@ -3905,7 +4099,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
@@ -3931,7 +4125,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.
@@ -3966,11 +4160,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
@@ -4023,11 +4217,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
@@ -4048,7 +4242,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,
@@ -4076,7 +4270,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.
@@ -4148,34 +4343,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.
@@ -4211,7 +4379,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
@@ -4248,7 +4416,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.
@@ -4285,7 +4453,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.
@@ -4337,7 +4505,7 @@ function blueprintToDevDependencies(blueprint) {
 	return Object.fromEntries(Object.entries(merged).filter(([name]) => name !== own && !runtime.has(name)).sort(([left], [right]) => (0, _orkestrel_contract.compareValues)(left, right)));
 }
 /**
-* 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.
@@ -4474,7 +4642,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.
@@ -4531,7 +4699,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.
@@ -4617,7 +4785,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.
@@ -4653,7 +4821,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.
@@ -4675,7 +4843,7 @@ function blueprintToRootTsconfig(blueprint) {
 	return (0, _orkestrel_template.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.
@@ -4866,7 +5034,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.
@@ -4976,7 +5144,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.
@@ -5051,7 +5219,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.
@@ -5207,10 +5375,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 = [];
@@ -5246,7 +5423,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`
@@ -5265,6 +5442,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;
@@ -5298,7 +5484,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.
@@ -5307,6 +5493,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 [];
@@ -5320,7 +5517,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
@@ -5365,7 +5562,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.
@@ -5400,7 +5597,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.
@@ -5581,7 +5778,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.
@@ -5809,7 +6006,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.
@@ -5857,7 +6054,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
@@ -5894,66 +6091,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.
@@ -5999,7 +6137,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.
@@ -6056,7 +6194,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
@@ -6196,7 +6334,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.
@@ -6253,7 +6391,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.
@@ -6317,7 +6455,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.
@@ -6382,7 +6520,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
@@ -6426,7 +6564,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
@@ -6446,12 +6584,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.
@@ -6490,7 +6628,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.
@@ -6533,7 +6671,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.
 	*
@@ -6691,6 +6829,8 @@ exports.BIN_CONFIGS = BIN_CONFIGS;
 exports.BIN_ENTRY_PATH = BIN_ENTRY_PATH;
 exports.CANON_PATHS = CANON_PATHS;
 exports.CATALOG_AGENT_PATH = CATALOG_AGENT_PATH;
+exports.CATALOG_CLOSING_MARKER = CATALOG_CLOSING_MARKER;
+exports.CATALOG_OPENING_MARKER = CATALOG_OPENING_MARKER;
 exports.CONFIG_TEMPLATES = CONFIG_TEMPLATES;
 exports.CONFORMANCE_TEST_PATH = CONFORMANCE_TEST_PATH;
 exports.CONTROL_CHARACTER_PATTERN = CONTROL_CHARACTER_PATTERN;
@@ -6791,6 +6931,7 @@ exports.isDependency = isDependency;
 exports.isDependencyName = isDependencyName;
 exports.isEnvironment = isEnvironment;
 exports.isFinding = isFinding;
+exports.isFloorPath = isFloorPath;
 exports.isGroup = isGroup;
 exports.isGroups = isGroups;
 exports.isHex = isHex;
@@ -6800,6 +6941,7 @@ exports.isOverride = isOverride;
 exports.isPath = isPath;
 exports.isPlan = isPlan;
 exports.isQuestion = isQuestion;
+exports.isRetainedPath = isRetainedPath;
 exports.isScaffoldError = isScaffoldError;
 exports.isSnapshot = isSnapshot;
 exports.manifestToDependencies = manifestToDependencies;