@orkestrel/scaffold 0.0.60 → 0.0.62

package/dist/src/core/index.d.cts

@@ -4,14 +4,15 @@ import { EmitterInterface } from '@orkestrel/emitter';
 import { Guard } from '@orkestrel/contract';
 import { JSONValue } from '@orkestrel/contract';
 
-/** The development dependencies a private Vue browser application adds. */
+/** Lists the development dependencies a private Vue browser application adds. */
 export declare const APP_BROWSER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
-/** The development dependency every private `app` environment adds. */
+/** Names the development dependency every private `app` environment adds. */
 export declare const APP_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
 /**
- * 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
@@ -20,10 +21,13 @@ export declare const APP_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
  */
 export declare const APP_MATRIX: Readonly<Record<Environment, AppDefinition>>;
 
-/** The development dependencies a private server application adds. */
+/** Lists the development dependencies a private server application adds. */
 export declare const APP_SERVER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
-/** The configuration and runtime-entry settings one private `app` environment contributes. */
+/**
+ * Describes the configuration and runtime-entry settings one private `app` environment
+ * contributes.
+ */
 export declare interface AppDefinition {
     readonly configs: readonly string[];
     readonly project: string;
@@ -31,7 +35,7 @@ export declare interface AppDefinition {
 }
 
 /**
- * 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.
@@ -56,7 +60,8 @@ export declare interface AppDefinition {
 export declare function applyOverrides(artifacts: readonly Artifact[], overrides: readonly Override[]): readonly Artifact[];
 
 /**
- * One file in a plan, discriminated by how its content is produced and what scaffold claims of it.
+ * Represents one file in a plan, discriminated by how its content is produced and what
+ * scaffold claims of it.
  *
  * @remarks
  * Every branch that claims `content` ownership carries the bytes to back it:
@@ -66,7 +71,7 @@ export declare function applyOverrides(artifacts: readonly Artifact[], overrides
 export declare type Artifact = HostArtifact | HydratedArtifact | ContentArtifact;
 
 /**
- * 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
@@ -119,7 +124,7 @@ export declare const ARTIFACT_TEMPLATES: Readonly<{
     }>;
 }>;
 
-/** The fields every planned file carries. */
+/** Describes the fields every planned file carries. */
 export declare interface ArtifactBase {
     readonly path: string;
     readonly group: Group;
@@ -128,7 +133,7 @@ export declare interface ArtifactBase {
 }
 
 /**
- * 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.
@@ -156,7 +161,7 @@ export declare interface ArtifactBase {
 export declare function artifactsToQuestions(artifacts: readonly Artifact[]): readonly Question[];
 
 /**
- * Project one planned artifact and the bytes found at its path into a verdict.
+ * 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
@@ -188,7 +193,7 @@ export declare function artifactsToQuestions(artifacts: readonly Artifact[]): re
 export declare function artifactToFinding(artifact: Artifact, observed?: string): Finding;
 
 /**
- * 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.
@@ -215,7 +220,7 @@ export declare function artifactToFinding(artifact: Artifact, observed?: string)
 export declare function artifactToHex(artifact: Artifact): string | undefined;
 
 /**
- * The whole comparison of a plan against a target's current content.
+ * Represents the whole comparison of a plan against a target's current content.
  *
  * @remarks
  * A blocking question means the gate refused the blueprint, so `findings` is
@@ -228,17 +233,17 @@ export declare interface Audit {
     readonly questions: readonly Question[];
 }
 
-/** The tooling versions scaffold and every generated workspace share. */
+/** Holds the tooling versions scaffold and every generated workspace share. */
 export declare const BASE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
-/** 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. */
 export declare const BIN_CONFIGS: readonly string[];
 
-/** The executable entry whose presence makes a workspace `bin`. */
+/** Names the executable entry whose presence makes a workspace `bin`. */
 export declare const BIN_ENTRY_PATH = "src/bin/main.ts";
 
 /**
- * The closed, JSON-serializable workspace specification.
+ * Represents the closed, JSON-serializable workspace specification.
  *
  * @remarks
  * `src` selects published library environments and `app` selects private
@@ -287,7 +292,7 @@ export declare interface Blueprint {
 }
 
 /**
- * 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.
@@ -304,7 +309,7 @@ export declare interface Blueprint {
 export declare function blueprintToConfigArtifacts(blueprint: Blueprint): readonly Artifact[];
 
 /**
- * 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.
@@ -342,7 +347,7 @@ export declare function blueprintToConfigArtifacts(blueprint: Blueprint): readon
 export declare function blueprintToDevDependencies(blueprint: Blueprint): Readonly<Record<string, string>>;
 
 /**
- * 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`
@@ -361,19 +366,37 @@ export declare function blueprintToDevDependencies(blueprint: Blueprint): Readon
  * 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']
+ * ```
  */
 export declare function blueprintToDocumentArtifacts(blueprint: Blueprint): readonly ContentArtifact[];
 
 /**
- * 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'
+ * ```
  */
 export declare function blueprintToGuideArtifacts(blueprint: Blueprint): readonly ContentArtifact[];
 
 /**
- * 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.
@@ -402,7 +425,7 @@ export declare function blueprintToGuideArtifacts(blueprint: Blueprint): readonl
 export declare function blueprintToMachinery(blueprint: Blueprint): ViteMachinery;
 
 /**
- * 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.
@@ -439,7 +462,7 @@ export declare function blueprintToMachinery(blueprint: Blueprint): ViteMachiner
 export declare function blueprintToManifest(blueprint: Blueprint): string;
 
 /**
- * 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.
@@ -448,11 +471,22 @@ export declare function blueprintToManifest(blueprint: Blueprint): string;
  * 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'
+ * ```
  */
 export declare function blueprintToOrchestrationArtifacts(blueprint: Blueprint): readonly ContentArtifact[];
 
 /**
- * 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
@@ -498,7 +532,7 @@ export declare function blueprintToOrchestrationArtifacts(blueprint: Blueprint):
 export declare function blueprintToQuestions(blueprint: Blueprint): readonly Question[];
 
 /**
- * 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.
@@ -515,7 +549,7 @@ export declare function blueprintToQuestions(blueprint: Blueprint): readonly Que
 export declare function blueprintToRootTsconfig(blueprint: Blueprint): string;
 
 /**
- * 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.
@@ -537,7 +571,7 @@ export declare function blueprintToRootTsconfig(blueprint: Blueprint): string;
 export declare function blueprintToRootVite(blueprint: Blueprint): string;
 
 /**
- * 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.
@@ -575,7 +609,7 @@ export declare function blueprintToRootVite(blueprint: Blueprint): string;
 export declare function blueprintToScripts(blueprint: Blueprint): Readonly<Record<string, string>>;
 
 /**
- * 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.
@@ -600,7 +634,7 @@ export declare function blueprintToScripts(blueprint: Blueprint): Readonly<Recor
 export declare function blueprintToSourceArtifacts(blueprint: Blueprint): readonly ContentArtifact[];
 
 /**
- * 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.
@@ -637,7 +671,7 @@ export declare function blueprintToSourceArtifacts(blueprint: Blueprint): readon
 export declare function blueprintToTestArtifacts(blueprint: Blueprint): readonly ContentArtifact[];
 
 /**
- * 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.
@@ -667,11 +701,11 @@ export declare function blueprintToTestArtifacts(blueprint: Blueprint): readonly
  */
 export declare function blueprintToWritableScripts(blueprint: Blueprint): readonly ManifestScript[];
 
-/** One module format a published library environment builds. */
+/** Names one module format a published library environment builds. */
 export declare type BuildFormat = 'es' | 'cjs';
 
 /**
- * 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.
@@ -692,7 +726,7 @@ export declare type BuildFormat = 'es' | 'cjs';
 export declare function bytesToHex(bytes: Uint8Array): string;
 
 /**
- * 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
@@ -725,7 +759,7 @@ export declare function bytesToHex(bytes: Uint8Array): string;
 export declare const CANON_PATHS: readonly string[];
 
 /**
- * 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
@@ -741,7 +775,27 @@ export declare const CANON_PATHS: readonly string[];
 export declare const CATALOG_AGENT_PATH = ".claude/agents/orkestrel.md";
 
 /**
- * One package row of the fleet 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.
+ */
+export declare const CATALOG_CLOSING_MARKER = "<!-- /orkestrel:catalog -->";
+
+/**
+ * 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.
+ */
+export declare const CATALOG_OPENING_MARKER = "<!-- orkestrel:catalog -->";
+
+/**
+ * Represents one package row of the fleet catalog.
  *
  * @remarks
  * A row whose lookup did not find a version carries the cause instead. It is
@@ -772,7 +826,7 @@ export declare type CatalogEntry = {
 };
 
 /**
- * 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,
@@ -804,7 +858,7 @@ export declare type CatalogEntry = {
 export declare function catalogToLayers(entries: readonly CatalogEntry[]): ReadonlyArray<readonly string[]>;
 
 /**
- * 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`
@@ -848,7 +902,7 @@ export declare function catalogToLayers(entries: readonly CatalogEntry[]): Reado
 export declare function cloneValue(value: unknown): JSONValue | undefined;
 
 /**
- * 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.
@@ -870,14 +924,14 @@ export declare function cloneValue(value: unknown): JSONValue | undefined;
  */
 export declare function compareVersions(left: string, right: string): number;
 
-/** The coded reason one compile stage failed. */
+/** Represents the coded reason one compile stage failed. */
 export declare interface CompileFailure {
     readonly code: ScaffoldErrorCode;
     readonly message: string;
 }
 
 /**
- * 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
@@ -920,7 +974,7 @@ export declare interface CompileFailure {
 export declare class Compiler implements CompilerInterface {
     #private;
     /**
-     * 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
@@ -933,10 +987,10 @@ export declare class Compiler implements CompilerInterface {
          * at construction instead of never firing.
          */
      constructor(options?: CompilerOptions);
-     /** The compiler's observation channel. */
+     /** Exposes the compiler's observation channel. */
      get emitter(): EmitterInterface<CompilerEventMap>;
      /**
-      * 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.
@@ -968,7 +1022,7 @@ export declare class Compiler implements CompilerInterface {
           */
       compile(blueprint: Blueprint, groups?: readonly Group[]): 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.
@@ -999,7 +1053,7 @@ export declare class Compiler implements CompilerInterface {
            */
        audit(blueprint: Blueprint, current: Snapshot, groups?: readonly Group[]): Audit;
        /**
-        * 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.
         *
@@ -1016,7 +1070,7 @@ export declare class Compiler implements CompilerInterface {
       }
 
       /**
-       * The input and output snapshot of one compile stage.
+       * Holds the input and output snapshot of one compile stage.
        *
        * @remarks
        * `failure` is present exactly when the stage failed.
@@ -1028,7 +1082,7 @@ export declare class Compiler implements CompilerInterface {
           readonly failure?: CompileFailure;
       }
 
-      /** The compiler's observation channel. */
+      /** Represents the compiler's observation channel. */
       export declare type CompilerEventMap = {
           readonly compile: readonly [scaffolding: Scaffolding];
           readonly audit: readonly [audit: Audit];
@@ -1037,11 +1091,11 @@ export declare class Compiler implements CompilerInterface {
           readonly destroy: readonly [];
       };
 
-      /** The compilation contract: pure, synchronous, and host-independent. */
+      /** Describes the compilation contract: pure, synchronous, and host-independent. */
       export declare interface CompilerInterface {
           readonly emitter: EmitterInterface<CompilerEventMap>;
           /**
-           * 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.
@@ -1049,7 +1103,7 @@ export declare class Compiler implements CompilerInterface {
            */
           compile(blueprint: Blueprint, groups?: readonly Group[]): 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.
@@ -1058,24 +1112,24 @@ export declare class Compiler implements CompilerInterface {
            */
           audit(blueprint: Blueprint, current: Snapshot, groups?: readonly Group[]): Audit;
           /**
-           * 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.
            */
           destroy(): void;
       }
 
-      /** Options for the compiler. */
+      /** Represents the options for the compiler. */
       export declare interface CompilerOptions {
           readonly on?: EmitterHooks<CompilerEventMap>;
           readonly error?: EmitterErrorHandler;
       }
 
-      /** The compile phases, in the order they run. */
+      /** Names the compile phases, in the order they run. */
       export declare type CompileStage = 'draft' | 'gate' | 'pin';
 
       /**
-       * 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.
@@ -1097,7 +1151,7 @@ export declare class Compiler implements CompilerInterface {
       export declare function computeBytes(content: string): number;
 
       /**
-       * 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.
@@ -1123,7 +1177,7 @@ export declare class Compiler implements CompilerInterface {
       export declare function computeHash(text: string): string;
 
       /**
-       * 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
@@ -1193,13 +1247,13 @@ export declare class Compiler implements CompilerInterface {
                   showcase: "import { defineConfig } from 'vite'\nimport { appShowcase } from '../../vite.config.ts'\n\nexport default defineConfig(appShowcase())\n";
               }>;
           }>;
-          browsers: "// A generated browser workspace resolves its own Chromium here rather than in\n// `configs/helpers.ts`, because that leaf is vendored byte-identical to every\n// workspace and most of them declare no `playwright` to import.\n\nimport type { PlaywrightProviderOptions } from '@vitest/browser-playwright'\nimport { chromium } from 'playwright'\nimport { accessSync, constants as FS_CONSTANTS, globSync, readdirSync, statSync } from 'node:fs'\nimport { basename, dirname, join, resolve as resolvePath } from 'node:path'\n\n/**\n * Chromium executable layouts inside a `chromium-<revision>` browsers-directory entry, per\n * platform.\n *\n * @remarks\n * The current Playwright build ships Chrome for Testing on macOS. The trailing `Chromium.app`\n * layouts are what earlier builds shipped, so the list spans Playwright versions instead of\n * pinning to the installed one.\n */\nexport const CHROMIUM_LAYOUTS = Object.freeze([\n\t'chrome-linux/chrome',\n\t'chrome-linux64/chrome',\n\t'chrome-win/chrome.exe',\n\t'chrome-win64/chrome.exe',\n\t'chrome-mac-x64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',\n\t'chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',\n\t'chrome-mac/Chromium.app/Contents/MacOS/Chromium',\n\t'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium',\n])\n\n/** The `chromium-<revision>` entry name Playwright installs one managed build into. */\nexport const CHROMIUM_ENTRY_PATTERN = /^chromium-\\d+$/\n\n/** The revision number carried by any path containing a `chromium-<revision>` segment. */\nexport const CHROMIUM_REVISION_PATTERN = /chromium-(\\d+)/\n\n/** The directory a managed Linux container installs its bundled Playwright browsers into. */\nexport const BUNDLED_BROWSERS_ROOT = '/opt/pw-browsers'\n\n/**\n * Bundled Chromium layouts under the managed-container browsers root, as glob patterns.\n *\n * @remarks\n * The revision directory and its inner layout both drift across Playwright builds, and the\n * container also carries a top-level `chromium` alias, so every known shape is globbed.\n */\nexport const BUNDLED_CHROMIUM_LAYOUTS = Object.freeze([\n\t'chromium',\n\t'chromium-*/chrome-linux64/chrome',\n\t'chromium-*/chrome-linux/chrome',\n])\n\n/** Stable Playwright Chromium channels and their standard executable layouts. */\nexport const SYSTEM_BROWSER_CHANNELS = Object.freeze([\n\tObject.freeze({\n\t\tchannel: 'chrome',\n\t\tlayouts: Object.freeze({\n\t\t\tlinux: '/opt/google/chrome/chrome',\n\t\t\tdarwin: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n\t\t\twin32: Object.freeze(['Google', 'Chrome', 'Application', 'chrome.exe']),\n\t\t}),\n\t}),\n\tObject.freeze({\n\t\tchannel: 'msedge',\n\t\tlayouts: Object.freeze({\n\t\t\tlinux: '/opt/microsoft/msedge/msedge',\n\t\t\tdarwin: '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',\n\t\t\twin32: Object.freeze(['Microsoft', 'Edge', 'Application', 'msedge.exe']),\n\t\t}),\n\t}),\n])\n\n/**\n * Determine whether a path identifies an executable regular file.\n *\n * @param path - The filesystem path to inspect.\n * @returns Whether the path is a regular file with execute access.\n *\n * @example\n * ```ts\n * isBrowserExecutable('/opt/google/chrome/chrome')\n * ```\n */\nexport function isBrowserExecutable(path: string): boolean {\n\ttry {\n\t\tif (!statSync(path).isFile()) return false\n\t\taccessSync(path, FS_CONSTANTS.X_OK)\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n\n/**\n * Order two Chromium paths so the highest revision sorts first.\n *\n * @param left - The first path or directory entry to compare.\n * @param right - The second path or directory entry to compare.\n * @returns A negative number when `left` sorts first, positive when `right` does.\n *\n * @remarks\n * Revisions are numbers, so `chromium-1200` outranks `chromium-999` despite sorting below it\n * lexically. A path carrying no revision falls back to descending name order.\n *\n * @example\n * ```ts\n * ['chromium-999', 'chromium-1200'].sort(compareRevisions)\n * ```\n */\nexport function compareRevisions(left: string, right: string): number {\n\tconst leftRevision = CHROMIUM_REVISION_PATTERN.exec(left)?.[1]\n\tconst rightRevision = CHROMIUM_REVISION_PATTERN.exec(right)?.[1]\n\tif (leftRevision === undefined || rightRevision === undefined) return right.localeCompare(left)\n\treturn Number(rightRevision) - Number(leftRevision)\n}\n\n/**\n * Read the executable path of Playwright's pinned Chromium revision.\n *\n * @returns The pinned executable path, or `undefined` when this platform has none.\n *\n * @remarks\n * Playwright throws rather than returning a path when the current platform carries no initialized\n * executable, and an unguarded call would fail configuration evaluation for every project.\n *\n * @example\n * ```ts\n * resolvePinnedBrowser()\n * ```\n */\nexport function resolvePinnedBrowser(): string | undefined {\n\ttry {\n\t\tconst pinned = chromium.executablePath()\n\t\treturn pinned.length === 0 ? undefined : pinned\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/**\n * Resolve a launchable Playwright-managed Chromium executable: the pinned revision when installed,\n * otherwise a `chromium` / `chromium.exe` alias or any other `chromium-*` revision under the same\n * Playwright browsers directory. A pinned-revision miss is not Chromium absence — managed\n * containers ship one usable build, often behind a revision-agnostic alias, for many Playwright\n * versions.\n *\n * @param pinned - The executable path for Playwright's pinned Chromium revision.\n * @returns The managed executable path, or `undefined` when none is executable.\n *\n * @example\n * ```ts\n * resolveManagedBrowser('/root/.cache/ms-playwright/chromium-1234/chrome-linux64/chrome')\n * ```\n */\nexport function resolveManagedBrowser(pinned: string): string | undefined {\n\tif (isBrowserExecutable(pinned)) return pinned\n\tlet revisionRoot = dirname(pinned)\n\tfor (;;) {\n\t\tif (CHROMIUM_ENTRY_PATTERN.test(basename(revisionRoot))) break\n\t\tconst parent = dirname(revisionRoot)\n\t\tif (parent === revisionRoot) return undefined\n\t\trevisionRoot = parent\n\t}\n\tconst browsersRoot = dirname(revisionRoot)\n\tfor (const alias of ['chromium', 'chromium.exe']) {\n\t\tconst candidate = resolvePath(browsersRoot, alias)\n\t\tif (isBrowserExecutable(candidate)) return candidate\n\t}\n\tlet entries: readonly string[]\n\ttry {\n\t\tentries = readdirSync(browsersRoot)\n\t} catch {\n\t\treturn undefined\n\t}\n\tconst revisions = entries\n\t\t.filter((entry) => CHROMIUM_ENTRY_PATTERN.test(entry))\n\t\t.sort(compareRevisions)\n\tfor (const revision of revisions) {\n\t\tfor (const layout of CHROMIUM_LAYOUTS) {\n\t\t\tconst candidate = resolvePath(browsersRoot, revision, layout)\n\t\t\tif (isBrowserExecutable(candidate)) return candidate\n\t\t}\n\t}\n\treturn undefined\n}\n\n/**\n * Resolve the Chromium a managed Linux container bundles outside the Playwright cache.\n *\n * @param platform - The Node platform the container runs on.\n * @param root - The bundled browsers directory to search.\n * @returns The highest matching executable path, or `undefined` when none is executable.\n *\n * @example\n * ```ts\n * resolveBundledBrowser('linux', BUNDLED_BROWSERS_ROOT)\n * ```\n */\nexport function resolveBundledBrowser(platform: NodeJS.Platform, root: string): string | undefined {\n\tif (platform !== 'linux') return undefined\n\tfor (const layout of BUNDLED_CHROMIUM_LAYOUTS) {\n\t\tlet matches: readonly string[]\n\t\ttry {\n\t\t\tmatches = globSync(layout, { cwd: root })\n\t\t} catch {\n\t\t\treturn undefined\n\t\t}\n\t\tfor (const match of [...matches].sort(compareRevisions)) {\n\t\t\tconst candidate = resolvePath(root, match)\n\t\t\tif (isBrowserExecutable(candidate)) return candidate\n\t\t}\n\t}\n\treturn undefined\n}\n\n/**\n * Resolve the first installed stable system Chromium channel.\n *\n * @param platform - The Node platform whose standard layouts this call probes.\n * @param environment - The process environment supplying Windows installation roots.\n * @returns `chrome`, then `msedge`, or `undefined` when neither is executable.\n *\n * @example\n * ```ts\n * resolveSystemBrowser(process.platform, process.env)\n * ```\n */\nexport function resolveSystemBrowser(\n\tplatform: NodeJS.Platform,\n\tenvironment: NodeJS.ProcessEnv,\n): string | undefined {\n\tif (platform !== 'linux' && platform !== 'darwin' && platform !== 'win32') return undefined\n\tconst roots = new Set<string>()\n\tif (platform === 'win32') {\n\t\tfor (const root of [\n\t\t\tenvironment.LOCALAPPDATA,\n\t\t\tenvironment.PROGRAMFILES,\n\t\t\tenvironment['PROGRAMFILES(X86)'],\n\t\t]) {\n\t\t\tif (root !== undefined && root.length > 0) roots.add(root)\n\t\t}\n\t\tconst homeDrive = environment.HOMEDRIVE\n\t\tif (homeDrive !== undefined && homeDrive.length > 0) {\n\t\t\troots.add(join(homeDrive, 'Program Files'))\n\t\t\troots.add(join(homeDrive, 'Program Files (x86)'))\n\t\t}\n\t}\n\tfor (const browser of SYSTEM_BROWSER_CHANNELS) {\n\t\tif (platform === 'win32') {\n\t\t\tfor (const root of roots) {\n\t\t\t\tif (isBrowserExecutable(join(root, ...browser.layouts.win32))) return browser.channel\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tif (isBrowserExecutable(browser.layouts[platform])) return browser.channel\n\t}\n\treturn undefined\n}\n\n/**\n * Resolve Playwright provider options for whatever browser this host can actually launch.\n *\n * @param pinned - The executable path for Playwright's pinned Chromium revision, when it has one.\n * @param platform - The Node platform whose standard layouts this call probes.\n * @param environment - The process environment supplying operator overrides and Windows roots.\n * @param root - The managed-container bundled browsers directory to search.\n * @returns Provider options naming an executable, a WebSocket endpoint, or a channel.\n *\n * @remarks\n * Precedence, most important first: `PLAYWRIGHT_EXECUTABLE_PATH`, `PLAYWRIGHT_WS_ENDPOINT`,\n * `PLAYWRIGHT_CHANNEL`, the managed Playwright Chromium, the container's bundled Chromium, a\n * verified system channel, then the platform default channel. An operator override outranks\n * discovery and is returned exactly as given: none of those environment values is checked\n * against the filesystem, because verifying an override would defeat the override. The pinned\n * managed revision outranks anything found on the host because it is deterministic. The installed\n * pinned revision returns empty options so Playwright keeps its own default launch semantics. Only\n * a discovered system channel is verified before it is named. The platform default is unverified\n * as well and exists only as a last resort: Windows takes `msedge`, which ships with the OS and\n * never collides with a foreground Chrome.\n *\n * @example\n * ```ts\n * resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n * ```\n */\nexport function resolveBrowser(\n\tpinned: string | undefined,\n\tplatform: NodeJS.Platform,\n\tenvironment: NodeJS.ProcessEnv,\n\troot: string = BUNDLED_BROWSERS_ROOT,\n): PlaywrightProviderOptions {\n\tconst executable = environment.PLAYWRIGHT_EXECUTABLE_PATH\n\tif (executable !== undefined && executable.length > 0) {\n\t\treturn { launchOptions: { executablePath: executable } }\n\t}\n\tconst endpoint = environment.PLAYWRIGHT_WS_ENDPOINT\n\tif (endpoint !== undefined && endpoint.length > 0) {\n\t\treturn { connectOptions: { wsEndpoint: endpoint } }\n\t}\n\tconst requested = environment.PLAYWRIGHT_CHANNEL\n\tif (requested !== undefined && requested.length > 0) {\n\t\treturn { launchOptions: { channel: requested } }\n\t}\n\tconst managed = pinned === undefined ? undefined : resolveManagedBrowser(pinned)\n\tif (managed !== undefined) {\n\t\treturn managed === pinned ? {} : { launchOptions: { executablePath: managed } }\n\t}\n\tconst bundled = resolveBundledBrowser(platform, root)\n\tif (bundled !== undefined) return { launchOptions: { executablePath: bundled } }\n\tconst fallback = platform === 'win32' ? 'msedge' : 'chrome'\n\treturn { launchOptions: { channel: resolveSystemBrowser(platform, environment) ?? fallback } }\n}\n";
+          browsers: "// A generated browser workspace resolves its own Chromium here rather than in\n// `configs/helpers.ts`, because that leaf is vendored byte-identical to every\n// workspace and most of them declare no `playwright` to import.\n\nimport type { PlaywrightProviderOptions } from '@vitest/browser-playwright'\nimport { chromium } from 'playwright'\nimport { accessSync, constants as FS_CONSTANTS, globSync, readdirSync, statSync } from 'node:fs'\nimport { basename, dirname, join, resolve as resolvePath } from 'node:path'\n\n/**\n * Lists the Chromium executable layouts inside a `chromium-<revision>` browsers-directory\n * entry, per platform.\n *\n * @remarks\n * The current Playwright build ships Chrome for Testing on macOS. The trailing `Chromium.app`\n * layouts are what earlier builds shipped, so the list spans Playwright versions instead of\n * pinning to the installed one.\n */\nexport const CHROMIUM_LAYOUTS = Object.freeze([\n\t'chrome-linux/chrome',\n\t'chrome-linux64/chrome',\n\t'chrome-win/chrome.exe',\n\t'chrome-win64/chrome.exe',\n\t'chrome-mac-x64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',\n\t'chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing',\n\t'chrome-mac/Chromium.app/Contents/MacOS/Chromium',\n\t'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium',\n])\n\n/** Matches the `chromium-<revision>` entry name Playwright installs one managed build into. */\nexport const CHROMIUM_ENTRY_PATTERN = /^chromium-\\d+$/\n\n/** Matches the revision number carried by any path containing a `chromium-<revision>` segment. */\nexport const CHROMIUM_REVISION_PATTERN = /chromium-(\\d+)/\n\n/** Names the directory a managed Linux container installs its bundled Playwright browsers into. */\nexport const BUNDLED_BROWSERS_ROOT = '/opt/pw-browsers'\n\n/**\n * Lists the bundled Chromium layouts under the managed-container browsers root, as glob patterns.\n *\n * @remarks\n * The revision directory and its inner layout both drift across Playwright builds, and the\n * container also carries a top-level `chromium` alias, so every known shape is globbed.\n */\nexport const BUNDLED_CHROMIUM_LAYOUTS = Object.freeze([\n\t'chromium',\n\t'chromium-*/chrome-linux64/chrome',\n\t'chromium-*/chrome-linux/chrome',\n])\n\n/** Lists the stable Playwright Chromium channels and their standard executable layouts. */\nexport const SYSTEM_BROWSER_CHANNELS = Object.freeze([\n\tObject.freeze({\n\t\tchannel: 'chrome',\n\t\tlayouts: Object.freeze({\n\t\t\tlinux: '/opt/google/chrome/chrome',\n\t\t\tdarwin: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n\t\t\twin32: Object.freeze(['Google', 'Chrome', 'Application', 'chrome.exe']),\n\t\t}),\n\t}),\n\tObject.freeze({\n\t\tchannel: 'msedge',\n\t\tlayouts: Object.freeze({\n\t\t\tlinux: '/opt/microsoft/msedge/msedge',\n\t\t\tdarwin: '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',\n\t\t\twin32: Object.freeze(['Microsoft', 'Edge', 'Application', 'msedge.exe']),\n\t\t}),\n\t}),\n])\n\n/**\n * Determines whether a path identifies an executable regular file.\n *\n * @param path - The filesystem path to inspect.\n * @returns True if the path is a regular file with execute access; false otherwise.\n *\n * @example\n * ```ts\n * isBrowserExecutable('/opt/google/chrome/chrome')\n * ```\n */\nexport function isBrowserExecutable(path: string): boolean {\n\ttry {\n\t\tif (!statSync(path).isFile()) return false\n\t\taccessSync(path, FS_CONSTANTS.X_OK)\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n\n/**\n * Orders two Chromium paths so the highest revision sorts first.\n *\n * @param left - The first path or directory entry to compare.\n * @param right - The second path or directory entry to compare.\n * @returns A negative number when `left` sorts first, positive when `right` does.\n *\n * @remarks\n * Revisions are numbers, so `chromium-1200` outranks `chromium-999` despite sorting below it\n * lexically. A path carrying no revision falls back to descending name order.\n *\n * @example\n * ```ts\n * ['chromium-999', 'chromium-1200'].sort(compareRevisions)\n * ```\n */\nexport function compareRevisions(left: string, right: string): number {\n\tconst leftRevision = CHROMIUM_REVISION_PATTERN.exec(left)?.[1]\n\tconst rightRevision = CHROMIUM_REVISION_PATTERN.exec(right)?.[1]\n\tif (leftRevision === undefined || rightRevision === undefined) return right.localeCompare(left)\n\treturn Number(rightRevision) - Number(leftRevision)\n}\n\n/**\n * Reads the executable path of Playwright's pinned Chromium revision.\n *\n * @returns The pinned executable path, or `undefined` when this platform has none.\n *\n * @remarks\n * Playwright throws rather than returning a path when the current platform carries no initialized\n * executable, and an unguarded call would fail configuration evaluation for every project.\n *\n * @example\n * ```ts\n * resolvePinnedBrowser()\n * ```\n */\nexport function resolvePinnedBrowser(): string | undefined {\n\ttry {\n\t\tconst pinned = chromium.executablePath()\n\t\treturn pinned.length === 0 ? undefined : pinned\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/**\n * Resolves a launchable Playwright-managed Chromium executable: the pinned revision when installed,\n * otherwise a `chromium` / `chromium.exe` alias or any other `chromium-*` revision under the same\n * Playwright browsers directory. A pinned-revision miss is not Chromium absence — managed\n * containers ship one usable build, often behind a revision-agnostic alias, for many Playwright\n * versions.\n *\n * @param pinned - The executable path for Playwright's pinned Chromium revision.\n * @returns The managed executable path, or `undefined` when none is executable.\n *\n * @example\n * ```ts\n * resolveManagedBrowser('/root/.cache/ms-playwright/chromium-1234/chrome-linux64/chrome')\n * ```\n */\nexport function resolveManagedBrowser(pinned: string): string | undefined {\n\tif (isBrowserExecutable(pinned)) return pinned\n\tlet revisionRoot = dirname(pinned)\n\tfor (;;) {\n\t\tif (CHROMIUM_ENTRY_PATTERN.test(basename(revisionRoot))) break\n\t\tconst parent = dirname(revisionRoot)\n\t\tif (parent === revisionRoot) return undefined\n\t\trevisionRoot = parent\n\t}\n\tconst browsersRoot = dirname(revisionRoot)\n\tfor (const alias of ['chromium', 'chromium.exe']) {\n\t\tconst candidate = resolvePath(browsersRoot, alias)\n\t\tif (isBrowserExecutable(candidate)) return candidate\n\t}\n\tlet entries: readonly string[]\n\ttry {\n\t\tentries = readdirSync(browsersRoot)\n\t} catch {\n\t\treturn undefined\n\t}\n\tconst revisions = entries\n\t\t.filter((entry) => CHROMIUM_ENTRY_PATTERN.test(entry))\n\t\t.sort(compareRevisions)\n\tfor (const revision of revisions) {\n\t\tfor (const layout of CHROMIUM_LAYOUTS) {\n\t\t\tconst candidate = resolvePath(browsersRoot, revision, layout)\n\t\t\tif (isBrowserExecutable(candidate)) return candidate\n\t\t}\n\t}\n\treturn undefined\n}\n\n/**\n * Resolves the Chromium a managed Linux container bundles outside the Playwright cache.\n *\n * @param platform - The Node platform the container runs on.\n * @param root - The bundled browsers directory to search.\n * @returns The highest matching executable path, or `undefined` when none is executable.\n *\n * @example\n * ```ts\n * resolveBundledBrowser('linux', BUNDLED_BROWSERS_ROOT)\n * ```\n */\nexport function resolveBundledBrowser(platform: NodeJS.Platform, root: string): string | undefined {\n\tif (platform !== 'linux') return undefined\n\tfor (const layout of BUNDLED_CHROMIUM_LAYOUTS) {\n\t\tlet matches: readonly string[]\n\t\ttry {\n\t\t\tmatches = globSync(layout, { cwd: root })\n\t\t} catch {\n\t\t\treturn undefined\n\t\t}\n\t\tfor (const match of [...matches].sort(compareRevisions)) {\n\t\t\tconst candidate = resolvePath(root, match)\n\t\t\tif (isBrowserExecutable(candidate)) return candidate\n\t\t}\n\t}\n\treturn undefined\n}\n\n/**\n * Resolves the first installed stable system Chromium channel.\n *\n * @param platform - The Node platform whose standard layouts this call probes.\n * @param environment - The process environment supplying Windows installation roots.\n * @returns `chrome`, then `msedge`, or `undefined` when neither is executable.\n *\n * @example\n * ```ts\n * resolveSystemBrowser(process.platform, process.env)\n * ```\n */\nexport function resolveSystemBrowser(\n\tplatform: NodeJS.Platform,\n\tenvironment: NodeJS.ProcessEnv,\n): string | undefined {\n\tif (platform !== 'linux' && platform !== 'darwin' && platform !== 'win32') return undefined\n\tconst roots = new Set<string>()\n\tif (platform === 'win32') {\n\t\tfor (const root of [\n\t\t\tenvironment.LOCALAPPDATA,\n\t\t\tenvironment.PROGRAMFILES,\n\t\t\tenvironment['PROGRAMFILES(X86)'],\n\t\t]) {\n\t\t\tif (root !== undefined && root.length > 0) roots.add(root)\n\t\t}\n\t\tconst homeDrive = environment.HOMEDRIVE\n\t\tif (homeDrive !== undefined && homeDrive.length > 0) {\n\t\t\troots.add(join(homeDrive, 'Program Files'))\n\t\t\troots.add(join(homeDrive, 'Program Files (x86)'))\n\t\t}\n\t}\n\tfor (const browser of SYSTEM_BROWSER_CHANNELS) {\n\t\tif (platform === 'win32') {\n\t\t\tfor (const root of roots) {\n\t\t\t\tif (isBrowserExecutable(join(root, ...browser.layouts.win32))) return browser.channel\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tif (isBrowserExecutable(browser.layouts[platform])) return browser.channel\n\t}\n\treturn undefined\n}\n\n/**\n * Resolves Playwright provider options for whatever browser this host can actually launch.\n *\n * @param pinned - The executable path for Playwright's pinned Chromium revision, when it has one.\n * @param platform - The Node platform whose standard layouts this call probes.\n * @param environment - The process environment supplying operator overrides and Windows roots.\n * @param root - The managed-container bundled browsers directory to search.\n * @returns Provider options naming an executable, a WebSocket endpoint, or a channel.\n *\n * @remarks\n * Precedence, most important first: `PLAYWRIGHT_EXECUTABLE_PATH`, `PLAYWRIGHT_WS_ENDPOINT`,\n * `PLAYWRIGHT_CHANNEL`, the managed Playwright Chromium, the container's bundled Chromium, a\n * verified system channel, then the platform default channel. An operator override outranks\n * discovery and is returned exactly as given: none of those environment values is checked\n * against the filesystem, because verifying an override would defeat the override. The pinned\n * managed revision outranks anything found on the host because it is deterministic. The installed\n * pinned revision returns empty options so Playwright keeps its own default launch semantics. Only\n * a discovered system channel is verified before it is named. The platform default is unverified\n * as well and exists only as a last resort: Windows takes `msedge`, which ships with the OS and\n * never collides with a foreground Chrome.\n *\n * @example\n * ```ts\n * resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n * ```\n */\nexport function resolveBrowser(\n\tpinned: string | undefined,\n\tplatform: NodeJS.Platform,\n\tenvironment: NodeJS.ProcessEnv,\n\troot: string = BUNDLED_BROWSERS_ROOT,\n): PlaywrightProviderOptions {\n\tconst executable = environment.PLAYWRIGHT_EXECUTABLE_PATH\n\tif (executable !== undefined && executable.length > 0) {\n\t\treturn { launchOptions: { executablePath: executable } }\n\t}\n\tconst endpoint = environment.PLAYWRIGHT_WS_ENDPOINT\n\tif (endpoint !== undefined && endpoint.length > 0) {\n\t\treturn { connectOptions: { wsEndpoint: endpoint } }\n\t}\n\tconst requested = environment.PLAYWRIGHT_CHANNEL\n\tif (requested !== undefined && requested.length > 0) {\n\t\treturn { launchOptions: { channel: requested } }\n\t}\n\tconst managed = pinned === undefined ? undefined : resolveManagedBrowser(pinned)\n\tif (managed !== undefined) {\n\t\treturn managed === pinned ? {} : { launchOptions: { executablePath: managed } }\n\t}\n\tconst bundled = resolveBundledBrowser(platform, root)\n\tif (bundled !== undefined) return { launchOptions: { executablePath: bundled } }\n\tconst fallback = platform === 'win32' ? 'msedge' : 'chrome'\n\treturn { launchOptions: { channel: resolveSystemBrowser(platform, environment) ?? fallback } }\n}\n";
       }>;
 
-      /** The official-tooling drift proof whose presence makes a workspace `conformance`. */
+      /** Names the official-tooling drift proof whose presence makes a workspace `conformance`. */
       export declare const CONFORMANCE_TEST_PATH = "tests/conformance.test.ts";
 
-      /** A text file produced by the template or computed compilation path. */
+      /** Represents a text file produced by the template or computed compilation path. */
       export declare interface ContentArtifact extends ArtifactBase {
           readonly origin: 'template' | 'computed';
           readonly content: string;
@@ -1208,7 +1262,7 @@ export declare class Compiler implements CompilerInterface {
       }
 
       /**
-       * 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.
@@ -1228,11 +1282,14 @@ export declare class Compiler implements CompilerInterface {
        */
       export declare function contentToHex(content: string): string;
 
-      /** 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.
+       */
       export declare const CONTROL_CHARACTER_PATTERN: RegExp;
 
       /**
-       * 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.
@@ -1270,17 +1327,20 @@ export declare class Compiler implements CompilerInterface {
            */
        export declare function createBlueprint(name: string, input?: Partial<Omit<Blueprint, 'name'>>): Blueprint;
 
-       /** 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.
+        */
        export declare const DECLARATION_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
-       /** The `engines.node` range a workspace starts with. */
+       /** Names the `engines.node` range a workspace starts with. */
        export declare const DEFAULT_ENGINES = ">=22.12.0";
 
-       /** The version a workspace starts at. */
+       /** Names the version a workspace starts at. */
        export declare const DEFAULT_VERSION = "0.0.1";
 
        /**
-        * 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.
@@ -1316,7 +1376,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function dependenciesToQuestions(dependencies: readonly Dependency[], field: string, name: RegExp, range: RegExp): readonly Question[];
 
        /**
-        * One runtime `@orkestrel/*` dependency of a generated workspace.
+        * Represents one runtime `@orkestrel/*` dependency of a generated workspace.
         *
         * @remarks
         * `optional` is meaningful only on a blueprint's `peers`, where it emits a
@@ -1329,7 +1389,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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
@@ -1339,17 +1399,17 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const DEPENDENCY_NAME_PATTERN: RegExp;
 
-       /** The dependency sections a range-writing operation may change. */
+       /** Describes the dependency sections a range-writing operation may change. */
        export declare interface DependencyPinSet {
            readonly runtime: readonly Dependency[];
            readonly development: readonly Dependency[];
        }
 
-       /** The generated packed-package proof every publishing workspace is planned at. */
+       /** Names the generated packed-package proof every publishing workspace is planned at. */
        export declare const DISTRIBUTION_TEST_PATH = "tests/distribution.test.ts";
 
        /**
-        * How one target path compares to the artifact planned for it.
+        * Names how one target path compares to the artifact planned for it.
         *
         * @remarks
         * `foreign` is a path the plan does not own at all. It is also the set
@@ -1358,14 +1418,14 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare type Drift = 'aligned' | 'stale' | 'missing' | 'foreign';
 
-       /** The minimum-Node engine syntax a blueprint declares. */
+       /** Matches the minimum-Node engine syntax a blueprint declares. */
        export declare const ENGINES_PATTERN: RegExp;
 
-       /** One environment a generated workspace selects on its `src` or `app` axis. */
+       /** Names one environment a generated workspace selects on its `src` or `app` axis. */
        export declare type Environment = 'core' | 'browser' | 'server';
 
        /**
-        * The `Environment` values, frozen.
+        * Lists the `Environment` values, frozen.
         *
         * @remarks
         * A blueprint's `src` and `app` axes are caller-supplied, so the gate measures
@@ -1376,7 +1436,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const ENVIRONMENTS: readonly Environment[];
 
        /**
-        * 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
@@ -1390,11 +1450,11 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const EXECUTABLE_PATHS: readonly string[];
 
-       /** 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. */
        export declare const EXTRA_RANGE_PATTERN: RegExp;
 
        /**
-        * 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
@@ -1417,7 +1477,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function extractRangeMajor(range: string): number | undefined;
 
        /**
-        * 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
@@ -1439,7 +1499,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function extractVersion(version: string): readonly [major: number, minor: number, patch: number] | undefined;
 
        /**
-        * One drift verdict against a target path.
+        * Represents one drift verdict against a target path.
         *
         * @remarks
         * `observed` carries the destination's exact bytes and is the precondition the
@@ -1494,7 +1554,7 @@ export declare class Compiler implements CompilerInterface {
        };
 
        /**
-        * 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
@@ -1504,7 +1564,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const FLOOR_RANGE_PATTERN: RegExp;
 
        /**
-        * 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
@@ -1515,14 +1575,14 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const FOREIGN_NAME_PATTERN: RegExp;
 
-       /** 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`. */
        export declare const GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
 
-       /** The artifact group a plan selects over. */
+       /** Names the artifact group a plan selects over. */
        export declare type Group = 'manifest' | 'configs' | 'source' | 'tests' | 'guides' | 'docs' | 'orchestration';
 
        /**
-        * 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
@@ -1531,29 +1591,30 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const GROUPS: readonly Group[];
 
-       /** The guide-parity proof whose presence selects the planned `guides` project. */
+       /** Names the guide-parity proof whose presence selects the planned `guides` project. */
        export declare const GUIDES_TEST_PATH = "tests/guides.test.ts";
 
-       /** 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. */
        export declare const HEX_PATTERN: RegExp;
 
-       /** 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. */
        export declare const HOST_INVENTORY_PATH = "host.json";
 
        /**
-        * 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.
@@ -1563,7 +1624,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const HOST_PATHS: readonly string[];
 
        /**
-        * A file byte-copied from the vendored data root, planned before its bytes are read.
+        * Represents a file byte-copied from the vendored data root, planned before its bytes are read.
         *
         * @remarks
         * `source` falls back to `path` when absent. The pure core face cannot read the
@@ -1584,7 +1645,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * One vendored file read from the repository, beside the target bytes it answers for.
+        * Represents one vendored file read from the repository, beside the target bytes it answers for.
         *
         * @remarks
         * `path` is the target-relative path, which is also the checkout-relative path
@@ -1614,7 +1675,7 @@ export declare class Compiler implements CompilerInterface {
        };
 
        /**
-        * A vendored file whose exact bytes have been read, so its content can be compared.
+        * Represents a vendored file whose exact bytes have been read, so its content can be compared.
         *
         * @remarks
         * `hex` is the canonical lowercase byte pairs of the vendored source. It is
@@ -1632,7 +1693,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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
@@ -1670,7 +1731,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function inferDrift(artifact: Artifact, observed?: string): Exclude<Drift, 'foreign'>;
 
        /**
-        * Infer the {@link Group} a path belongs to.
+        * Infers the {@link Group} a path belongs to.
         *
         * @param path - The target-relative path to classify.
         * @returns The group that owns the path.
@@ -1695,14 +1756,17 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare function inferGroup(path: string): Group;
 
-       /** The cross-environment composition proof whose presence makes a workspace `integration`. */
+       /**
+        * Names the cross-environment composition proof whose presence makes a workspace
+        * `integration`.
+        */
        export declare const INTEGRATION_TEST_PATH = "tests/integration.test.ts";
 
-       /** 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. */
        export declare const INVALID_PATH_CHARACTER_PATTERN: RegExp;
 
        /**
-        * 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
@@ -1721,7 +1785,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isArtifact: Guard<Artifact>;
 
        /**
-        * 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
@@ -1731,7 +1795,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isAudit: Guard<Audit>;
 
        /**
-        * 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
@@ -1752,8 +1816,8 @@ export declare class Compiler implements CompilerInterface {
         * 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
@@ -1777,7 +1841,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function isCanonPath(path: string): boolean;
 
        /**
-        * 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
@@ -1786,10 +1850,11 @@ export declare class Compiler implements CompilerInterface {
        export declare const isCatalogEntry: Guard<CatalogEntry>;
 
        /**
-        * 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
@@ -1807,7 +1872,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function isCollection(value: unknown): value is readonly unknown[];
 
        /**
-        * 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
@@ -1817,7 +1882,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isCompilerHooks: Guard<EmitterHooks<CompilerEventMap>>;
 
        /**
-        * Narrow a value to {@link CompilerOptions}.
+        * Narrows a value to {@link CompilerOptions}.
         *
         * @example
         * ```ts
@@ -1830,7 +1895,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isCompilerOptions: Guard<CompilerOptions>;
 
        /**
-        * 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
@@ -1845,8 +1910,8 @@ export declare class Compiler implements CompilerInterface {
         * 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
@@ -1864,7 +1929,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function isDeferredPath(path: string): boolean;
 
        /**
-        * 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
@@ -1882,7 +1947,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isDependency: Guard<Dependency>;
 
        /**
-        * 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
@@ -1902,7 +1967,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isDependencyName: Guard<string>;
 
        /**
-        * Narrow a value to one {@link Environment} a workspace may select.
+        * Narrows a value to one {@link Environment} a workspace may select.
         *
         * @example
         * ```ts
@@ -1915,7 +1980,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isEnvironment: Guard<Environment>;
 
        /**
-        * 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,
@@ -1931,7 +1996,32 @@ export declare class Compiler implements CompilerInterface {
        export declare const isFinding: Guard<Finding>;
 
        /**
-        * Narrow a value to one {@link Group} a plan selects over.
+        * 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
+        * ```
+        */
+       export declare function isFloorPath(path: string): boolean;
+
+       /**
+        * Narrows a value to one {@link Group} a plan selects over.
         *
         * @example
         * ```ts
@@ -1943,11 +2033,11 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const isGroup: Guard<Group>;
 
-       /** Narrow a value to a bounded group selection. */
+       /** Narrows a value to a bounded group selection. */
        export declare const isGroups: Guard<readonly Group[]>;
 
        /**
-        * 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.
@@ -1965,7 +2055,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isHex: Guard<string>;
 
        /**
-        * 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
@@ -1984,7 +2074,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isManifestScript: Guard<ManifestScript>;
 
        /**
-        * 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
@@ -1994,7 +2084,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isMirror: Guard<Mirror>;
 
        /**
-        * 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
@@ -2010,11 +2100,11 @@ export declare class Compiler implements CompilerInterface {
        export declare const isOverride: Guard<Override>;
 
        /**
-        * 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
@@ -2036,7 +2126,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function isPath(value: unknown): value is string;
 
        /**
-        * 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
@@ -2048,7 +2138,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const isPlan: Guard<Plan>;
 
        /**
-        * Narrow a value to a {@link Question}.
+        * Narrows a value to a {@link Question}.
         *
         * @example
         * ```ts
@@ -2060,10 +2150,33 @@ export declare class Compiler implements CompilerInterface {
        export declare const isQuestion: Guard<Question>;
 
        /**
-        * Narrow a caught value to a {@link ScaffoldError}.
+        * 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
+        * ```
+        */
+       export declare function isRetainedPath(path: string): boolean;
+
+       /**
+        * 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
@@ -2076,11 +2189,11 @@ export declare class Compiler implements CompilerInterface {
        export declare function isScaffoldError(value: unknown): value is ScaffoldError;
 
        /**
-        * 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
@@ -2099,7 +2212,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function isSnapshot(value: unknown): value is Snapshot;
 
        /**
-        * Whether an upstream lookup produced an answer.
+        * Names whether an upstream lookup produced an answer.
         *
         * @remarks
         * `found` carries the answer. `missing` is an upstream `404`, which is a
@@ -2112,10 +2225,10 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare type Lookup = 'found' | 'missing' | 'unmatched' | 'failed';
 
-       /** The manifest path every compiler plan emits with birth ownership. */
+       /** Names the manifest path every compiler plan emits with birth ownership. */
        export declare const MANIFEST_PATH = "package.json";
 
-       /** The dependency sections read from an existing package manifest. */
+       /** Describes the dependency sections read from an existing package manifest. */
        export declare interface ManifestDependencySet {
            readonly runtime: readonly Dependency[];
            readonly development: readonly Dependency[];
@@ -2123,7 +2236,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * The manifest regions a writing operation may change.
+        * Describes the manifest regions a writing operation may change.
         *
         * @remarks
         * Each region is written in place, so every byte outside the named ranges
@@ -2136,7 +2249,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * One manifest script a region-writing operation may replace.
+        * Represents one manifest script a region-writing operation may replace.
         *
         * @remarks
         * `command` is the value the write lands. `accepted` is the closed set of
@@ -2153,7 +2266,8 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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.
@@ -2178,7 +2292,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function manifestToDependencies(manifest: string): ManifestDependencySet;
 
        /**
-        * 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,
@@ -2200,25 +2314,49 @@ export declare class Compiler implements CompilerInterface {
        export declare function manifestToName(manifest: string): string | undefined;
 
        /**
-        * Test whether {@link inferDrift} could have produced a finding for an ownership.
+        * 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
+        * ```
         */
        export declare function matchesDriftReachability(ownership: Ownership, finding: Finding): boolean;
 
        /**
-        * 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
@@ -2237,11 +2375,11 @@ export declare class Compiler implements CompilerInterface {
        export declare function matchesEngines(engines: string): boolean;
 
        /**
-        * 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
@@ -2261,10 +2399,10 @@ export declare class Compiler implements CompilerInterface {
        export declare function matchesOrchestrationPath(path: string): boolean;
 
        /**
-        * 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
@@ -2284,11 +2422,11 @@ export declare class Compiler implements CompilerInterface {
        export declare function matchesPrintWidth(line: string): boolean;
 
        /**
-        * 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
@@ -2328,26 +2466,26 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare function matchesRange(range: string, latest: string): boolean;
 
-       /** Maximum bytes accepted for one artifact. */
+       /** Caps the bytes accepted for one artifact. */
        export declare const 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. */
        export declare const MAX_ARTIFACT_HEX_LENGTH: number;
 
-       /** 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. */
        export declare const MAX_AUDIT_FINDINGS: number;
 
-       /** Maximum items accepted in one public collection. */
+       /** Caps the items accepted in one public collection. */
        export declare const MAX_COLLECTION_ITEMS = 1000;
 
-       /** 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. */
        export declare const MAX_DEPENDENCY_NAME_LENGTH = 214;
 
-       /** Maximum bytes accepted for one package or vendored-host manifest. */
+       /** Caps the bytes accepted for one package or vendored-host manifest. */
        export declare const MAX_MANIFEST_BYTES = 1048576;
 
        /**
-        * 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
@@ -2355,14 +2493,14 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const MAX_NAME_LENGTH = 203;
 
-       /** 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. */
        export declare const MAX_PATH_LENGTH = 32767;
 
-       /** Maximum length of one declared package range. */
+       /** Caps the length of one declared package range. */
        export declare const MAX_RANGE_LENGTH = 2048;
 
        /**
-        * 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
@@ -2372,14 +2510,14 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const MAX_REGISTRY_BYTES = 33554432;
 
-       /** Maximum length of one manifest script name or command. */
+       /** Caps the length of one manifest script name or command. */
        export declare const MAX_SCRIPT_LENGTH = 4096;
 
-       /** Maximum bytes retained across one whole plan or audit. */
+       /** Caps the bytes retained across one whole plan or audit. */
        export declare const MAX_TOTAL_ARTIFACT_BYTES = 104857600;
 
        /**
-        * 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
@@ -2387,11 +2525,11 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const MAX_TOTAL_REGISTRY_BYTES = 100663296;
 
-       /** The oldest Node version the generated toolchain supports. */
+       /** Names the oldest Node version the generated toolchain supports. */
        export declare const MINIMUM_NODE_VERSION = "22.12.0";
 
        /**
-        * One dependency guide fetched from upstream, beside the local mirror it answers for.
+        * Represents one dependency guide fetched from upstream, beside the local mirror it answers for.
         *
         * @remarks
         * A found lookup carries the fetched bytes; one that produced no answer carries
@@ -2420,11 +2558,11 @@ export declare class Compiler implements CompilerInterface {
            readonly content?: never;
        };
 
-       /** The bare workspace name syntax: lowercase alphanumeric with hyphens, letter first. */
+       /** Matches the bare workspace name syntax: lowercase alphanumeric with hyphens, letter first. */
        export declare const NAME_PATTERN: RegExp;
 
        /**
-        * 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`.
@@ -2448,7 +2586,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function nameToGuide(name: string): string;
 
        /**
-        * 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
@@ -2487,7 +2625,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function nameToHostArtifacts(name: string): readonly Artifact[];
 
        /**
-        * 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`
@@ -2517,7 +2655,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function nameToRewrite(name: string): string;
 
        /**
-        * 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
@@ -2526,7 +2664,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const ORCHESTRATION_PATH_NAMES: readonly string[];
 
        /**
-        * 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
@@ -2538,7 +2676,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const ORCHESTRATION_PATH_PREFIXES: readonly string[];
 
        /**
-        * How an artifact's content is produced.
+        * Names how an artifact's content is produced.
         *
         * @remarks
         * `host` is byte-copied from this package's vendored data root. `template` is
@@ -2549,7 +2687,7 @@ export declare class Compiler implements CompilerInterface {
        export declare type Origin = 'host' | 'template' | 'computed';
 
        /**
-        * 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
@@ -2560,7 +2698,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const ORKESTREL_RANGE_PATTERN: RegExp;
 
        /**
-        * One artifact override.
+        * Represents one artifact override.
         *
         * @remarks
         * `content` replaces the rendered artifact at `path` and never partially
@@ -2575,7 +2713,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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.
@@ -2602,7 +2740,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function overridesToQuestions(overrides: readonly Override[], artifacts: readonly Artifact[]): readonly Question[];
 
        /**
-        * What scaffold claims at an artifact's path.
+        * Names what scaffold claims at an artifact's path.
         *
         * @remarks
         * `content` claims the bytes: audit compares them, and a write restores a
@@ -2615,7 +2753,7 @@ export declare class Compiler implements CompilerInterface {
        export declare type Ownership = 'content' | 'presence' | 'birth';
 
        /**
-        * 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.
@@ -2636,7 +2774,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function parseBlueprint(value: unknown): Blueprint | undefined;
 
        /**
-        * 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.
@@ -2657,7 +2795,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function parseCompilerOptions(value: unknown): CompilerOptions | undefined;
 
        /**
-        * 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.
@@ -2678,7 +2816,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function parseGroups(value: unknown): readonly Group[] | undefined;
 
        /**
-        * 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.
@@ -2697,7 +2835,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function parseSnapshot(value: unknown): Snapshot | undefined;
 
        /**
-        * 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.
@@ -2721,7 +2859,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function pathToCondition(path: string, formats: readonly BuildFormat[]): Readonly<Record<string, unknown>>;
 
        /**
-        * The compiled, ordered artifact list and the selection it covers.
+        * Holds the compiled, ordered artifact list and the selection it covers.
         *
         * @remarks
         * `hash` is the plan's content identity and is absent until the pin stage
@@ -2736,7 +2874,7 @@ export declare class Compiler implements CompilerInterface {
            readonly hash?: string;
        }
 
-       /** The tally of one plan by artifact origin. */
+       /** Represents the tally of one plan by artifact origin. */
        export declare interface PlanSummary {
            readonly name: string;
            readonly src: readonly Environment[];
@@ -2748,7 +2886,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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.
@@ -2776,7 +2914,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function planToFindings(plan: Plan, current: Snapshot): readonly Finding[];
 
        /**
-        * 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
@@ -2806,7 +2944,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function planToHash(plan: Plan): string | undefined;
 
        /**
-        * 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
@@ -2827,11 +2965,11 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare function planToSummary(plan: Plan): PlanSummary;
 
-       /** Columns one emitted line may occupy, matching `printWidth` in `.oxfmtrc.json`. */
+       /** Caps the columns one emitted line may occupy, matching `printWidth` in `.oxfmtrc.json`. */
        export declare const PRINT_WIDTH = 100;
 
        /**
-        * One validation issue raised against a blueprint or a plan.
+        * Represents one validation issue raised against a blueprint or a plan.
         *
         * @remarks
         * A blocking question fails the gate closed. A non-blocking question is an
@@ -2846,7 +2984,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * One declared dependency range measured against a registry release.
+        * Represents one declared dependency range measured against a registry release.
         *
         * @remarks
         * `range` is the declared range, and `latest` is the version the producer
@@ -2871,7 +3009,7 @@ export declare class Compiler implements CompilerInterface {
        };
 
        /**
-        * 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
@@ -2881,7 +3019,7 @@ export declare class Compiler implements CompilerInterface {
        export declare const RELEASE_PROOF_COMMAND = "npm run test:distribution -- --mode release";
 
        /**
-        * 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.
@@ -2911,7 +3049,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function replaceManifestRanges(manifest: string, pins: DependencyPinSet): string | undefined;
 
        /**
-        * 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.
@@ -2950,7 +3088,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function replaceManifestScripts(manifest: string, scripts: readonly ManifestScript[]): string | undefined;
 
        /**
-        * 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.
@@ -2973,7 +3111,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function replacePlanRanges(plan: Plan, pins: DependencyPinSet): Plan | undefined;
 
        /**
-        * 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
@@ -3010,7 +3148,7 @@ export declare class Compiler implements CompilerInterface {
            readonly code: ScaffoldErrorCode;
            readonly context?: unknown;
            /**
-            * 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.
@@ -3019,11 +3157,11 @@ export declare class Compiler implements CompilerInterface {
            constructor(code: ScaffoldErrorCode, message: string, context?: unknown);
        }
 
-       /** The coded reasons a scaffold error is raised. */
+       /** Names the coded reasons a scaffold error is raised. */
        export declare type ScaffoldErrorCode = 'INVALID' | 'BLOCKED' | 'DESTROYED' | 'TARGET' | 'WRITE' | 'FETCH';
 
        /**
-        * The replayable outcome of one compile.
+        * Represents the replayable outcome of one compile.
         *
         * @remarks
         * `plan` is present exactly when the compile completed, so it is also the
@@ -3040,7 +3178,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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.
@@ -3063,7 +3201,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function selectGroups(groups?: readonly Group[]): readonly Group[];
 
        /**
-        * Select the host paths a named workspace vendors.
+        * 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.
@@ -3084,7 +3222,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function selectHostPaths(paths: readonly string[], name: string): readonly string[];
 
        /**
-        * 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
@@ -3104,20 +3242,23 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare function serializeTypeScriptString(value: string): string;
 
-       /** The provisioner skeleton a workspace with declared service vendors is given once. */
+       /** Names the provisioner skeleton a workspace with declared service vendors is given once. */
        export declare const SERVICE_SCRIPT_PATH = "scripts/service.sh";
 
-       /** The live-service readiness module whose presence makes a workspace `service`. */
+       /** Names the live-service readiness module whose presence makes a workspace `service`. */
        export declare const 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.
+        */
        export declare const 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`. */
        export declare const SHOWCASE_CONFIG_PATH = "configs/app/vite.showcase.config.ts";
 
        /**
-        * 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
@@ -3128,14 +3269,14 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const SHOWCASE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
-       /** Exact lowercase hexadecimal target bytes keyed by artifact-relative path. */
+       /** Holds exact lowercase hexadecimal target bytes keyed by artifact-relative path. */
        export declare type Snapshot = Readonly<Record<string, string>>;
 
-       /** The development dependencies a published browser `src` environment adds. */
+       /** Lists the development dependencies a published browser `src` environment adds. */
        export declare const SOURCE_BROWSER_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
 
        /**
-        * 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`,
@@ -3146,7 +3287,7 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare const SRC_MATRIX: Readonly<Record<Environment, SrcDefinition>>;
 
-       /** The build and export settings one published `src` environment contributes. */
+       /** Describes the build and export settings one published `src` environment contributes. */
        export declare interface SrcDefinition {
            readonly configs: readonly string[];
            readonly project: string;
@@ -3155,7 +3296,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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
@@ -3183,7 +3324,7 @@ export declare class Compiler implements CompilerInterface {
        };
 
        /**
-        * 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.
@@ -3208,7 +3349,7 @@ export declare class Compiler implements CompilerInterface {
        export declare function srcToExports(src: readonly Environment[]): Readonly<Record<string, unknown>>;
 
        /**
-        * Select the single published environment a package root points at.
+        * 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
@@ -3232,14 +3373,14 @@ export declare class Compiler implements CompilerInterface {
         */
        export declare function srcToRoot(src: readonly Environment[]): Environment | undefined;
 
-       /** 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`. */
        export declare const TAB_WIDTH = 2;
 
-       /** The exact `major.minor.patch` version syntax a blueprint declares. */
+       /** Matches the exact `major.minor.patch` version syntax a blueprint declares. */
        export declare const VERSION_PATTERN: RegExp;
 
        /**
-        * Which host-specific pipelines a generated root Vite configuration carries.
+        * Names which host-specific pipelines a generated root Vite configuration carries.
         *
         * @remarks
         * Boundary guarantees never vary by blueprint, so they are not selected here:
@@ -3258,7 +3399,7 @@ export declare class Compiler implements CompilerInterface {
        }
 
        /**
-        * 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