@orkestrel/scaffold 0.0.5 → 0.0.6

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

@@ -144,7 +144,7 @@ export declare interface ArtifactBase {
  *
  * @returns A fresh `ContractShape` describing one planned file.
  */
-export declare function artifactShape(): UnionShape<[ ObjectShape<{
+export declare function artifactShape(): UnionShape<readonly [ ObjectShape<{
     path: StringShape;
     group: LiteralShape<readonly Group[]>;
     origin: LiteralShape<readonly ["host"]>;
@@ -305,7 +305,7 @@ export declare function blueprintToMembers(spec: Blueprint): readonly Member[];
 /**
  * The full pure compilation: draft a blueprint's artifacts — the manifest and
  * exports combination rules over the per-environment `SRC_MATRIX` rows, plus
- * `HOST_PATHS` and `overrides` — then pin.
+ * the `selectHostPaths` selection of `HOST_PATHS` and `overrides` — then pin.
  *
  * @param blueprint - The `Blueprint` to compile.
  * @param groups - An optional `Group[]` selection (default: all groups).
@@ -644,7 +644,7 @@ export declare function contentToHex(content: string): string;
 export declare const CONTROL_CHARACTER_PATTERN: RegExp;
 
 /**
- * `configs/src/tsconfig.core.json` — unchanged core shape.
+ * `configs/src/tsconfig.core.json` — host-neutral core with web interop declarations.
  *
  * @returns The core environment `tsconfig` file content, newline-terminated.
  *
@@ -1042,12 +1042,15 @@ export declare function coreViteConfig(browser?: boolean): string;
 
  /**
   * Draft the `guides` group's artifacts — the package's own filled guide stub,
-  * the guides index, and any vendored dependency guide mirrors.
+  * the guides index, and vendored dependency guide mirrors whose paths are
+  * neither the package's own guide nor already carried by the selected host
+  * set.
   *
   * @param spec - The `Blueprint` to derive guide artifacts from.
   * @param pascal - The package's PascalCase entity name.
   * @param members - The blueprint's derived `Member[]`.
-  * @returns The `guides` group's `Artifact[]`.
+  * @returns The `guides` group's `Artifact[]`, with one contributor per guide
+  * path.
   *
   * @example
   * ```ts
@@ -1184,9 +1187,12 @@ export declare function coreViteConfig(browser?: boolean): string;
   * The root docs (`AGENTS.md` / `CLAUDE.md`), `LICENSE`, `.agents`, `.claude`, `.codex`,
   * the four SessionStart hook scripts (`scripts/deps.sh` / `scripts/cursor.sh` /
   * `scripts/codex.sh` / `scripts/ollama.sh`), the repository coding-law policy module,
-  * the line's seven byte-identical root dotfiles, and the two guides-grouped mirrors every repo carries: the line-wide
-  * dev-tooling guide (`guides/src/guide.md`) and the
-  * scaffold engine's own self-guide (`guides/src/scaffold.md`).
+  * the line's seven byte-identical root dotfiles, and the two guides-grouped
+  * mirror candidates: the line-wide dev-tooling guide
+  * (`guides/src/guide.md`) and the scaffold engine's own self-guide
+  * (`guides/src/scaffold.md`). `stageHost` vendors both; each plan carries the
+  * subset selected by `selectHostPaths`, omitting the target blueprint's own
+  * guide.
   */
  export declare const HOST_PATHS: readonly string[];
 
@@ -1393,6 +1399,24 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function manifestToDependencies(manifestText: string): readonly Dependency[];
 
+ /**
+  * Project a `package.json` text to its own string `name`.
+  *
+  * @param manifest - The `package.json` file content.
+  * @returns The own string `name`, or `undefined` when the manifest exceeds its
+  * byte ceiling, is malformed, has a non-object root, or has no own string
+  * `name`.
+  *
+  * @example
+  * ```ts
+  * import { manifestToName } from '@orkestrel/scaffold'
+  *
+  * manifestToName('{"name":"@orkestrel/router"}') // '@orkestrel/router'
+  * manifestToName('{}') // undefined
+  * ```
+  */
+ export declare function manifestToName(manifest: string): string | undefined;
+
  /** Maximum byte size accepted for one scaffold artifact. */
  export declare const MAX_ARTIFACT_BYTES = 5242880;
 
@@ -1493,12 +1517,13 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare const ORKESTREL_RANGE_PATTERN: RegExp;
 
  /**
-  * One caller template override.
+  * One artifact override.
   *
   * @remarks
   * `content` REPLACES the rendered artifact at `path`, never partially merges.
-  * An override whose `path` matches no planned artifact, or targets a
-  * `host`-origin path, is a BLOCKING question — never a silent add.
+  * An override whose `path` matches no planned artifact, targets a
+  * `host`-origin path, or targets `package.json` is a BLOCKING question.
+  * Accepted overrides surface as retained non-blocking advisories.
   */
  export declare interface Override {
      readonly path: string;
@@ -1931,7 +1956,7 @@ export declare function coreViteConfig(browser?: boolean): string;
          engine: BooleanShape;
      }, false>;
      groups: ArrayShape<LiteralShape<readonly Group[]>>;
-     artifacts: ArrayShape<UnionShape<[ ObjectShape<{
+     artifacts: ArrayShape<UnionShape<readonly [ ObjectShape<{
          path: StringShape;
          group: LiteralShape<readonly Group[]>;
          origin: LiteralShape<readonly ["host"]>;
@@ -2132,7 +2157,7 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare function rootViteConfig(src: readonly Environment[], engine?: boolean): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.5";
+ export declare const SCAFFOLD_RANGE = "^0.0.6";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2175,6 +2200,20 @@ export declare function coreViteConfig(browser?: boolean): string;
      readonly digest: string;
  }
 
+ /**
+  * Select host paths without the guide owned by the target blueprint.
+  *
+  * @param paths - Host artifact paths in deterministic input order.
+  * @param name - The target blueprint's unscoped package name.
+  * @returns Every host path except `guides/src/<name>.md`, in input order.
+  *
+  * @example
+  * ```ts
+  * selectHostPaths(['guides/src/guide.md', 'LICENSE'], 'guide') // ['LICENSE']
+  * ```
+  */
+ export declare function selectHostPaths(paths: readonly string[], name: string): readonly string[];
+
  /**
   * Serialize text as a single-quoted TypeScript string literal.
   *

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

@@ -144,7 +144,7 @@ export declare interface ArtifactBase {
  *
  * @returns A fresh `ContractShape` describing one planned file.
  */
-export declare function artifactShape(): UnionShape<[ ObjectShape<{
+export declare function artifactShape(): UnionShape<readonly [ ObjectShape<{
     path: StringShape;
     group: LiteralShape<readonly Group[]>;
     origin: LiteralShape<readonly ["host"]>;
@@ -305,7 +305,7 @@ export declare function blueprintToMembers(spec: Blueprint): readonly Member[];
 /**
  * The full pure compilation: draft a blueprint's artifacts — the manifest and
  * exports combination rules over the per-environment `SRC_MATRIX` rows, plus
- * `HOST_PATHS` and `overrides` — then pin.
+ * the `selectHostPaths` selection of `HOST_PATHS` and `overrides` — then pin.
  *
  * @param blueprint - The `Blueprint` to compile.
  * @param groups - An optional `Group[]` selection (default: all groups).
@@ -644,7 +644,7 @@ export declare function contentToHex(content: string): string;
 export declare const CONTROL_CHARACTER_PATTERN: RegExp;
 
 /**
- * `configs/src/tsconfig.core.json` — unchanged core shape.
+ * `configs/src/tsconfig.core.json` — host-neutral core with web interop declarations.
  *
  * @returns The core environment `tsconfig` file content, newline-terminated.
  *
@@ -1042,12 +1042,15 @@ export declare function coreViteConfig(browser?: boolean): string;
 
  /**
   * Draft the `guides` group's artifacts — the package's own filled guide stub,
-  * the guides index, and any vendored dependency guide mirrors.
+  * the guides index, and vendored dependency guide mirrors whose paths are
+  * neither the package's own guide nor already carried by the selected host
+  * set.
   *
   * @param spec - The `Blueprint` to derive guide artifacts from.
   * @param pascal - The package's PascalCase entity name.
   * @param members - The blueprint's derived `Member[]`.
-  * @returns The `guides` group's `Artifact[]`.
+  * @returns The `guides` group's `Artifact[]`, with one contributor per guide
+  * path.
   *
   * @example
   * ```ts
@@ -1184,9 +1187,12 @@ export declare function coreViteConfig(browser?: boolean): string;
   * The root docs (`AGENTS.md` / `CLAUDE.md`), `LICENSE`, `.agents`, `.claude`, `.codex`,
   * the four SessionStart hook scripts (`scripts/deps.sh` / `scripts/cursor.sh` /
   * `scripts/codex.sh` / `scripts/ollama.sh`), the repository coding-law policy module,
-  * the line's seven byte-identical root dotfiles, and the two guides-grouped mirrors every repo carries: the line-wide
-  * dev-tooling guide (`guides/src/guide.md`) and the
-  * scaffold engine's own self-guide (`guides/src/scaffold.md`).
+  * the line's seven byte-identical root dotfiles, and the two guides-grouped
+  * mirror candidates: the line-wide dev-tooling guide
+  * (`guides/src/guide.md`) and the scaffold engine's own self-guide
+  * (`guides/src/scaffold.md`). `stageHost` vendors both; each plan carries the
+  * subset selected by `selectHostPaths`, omitting the target blueprint's own
+  * guide.
   */
  export declare const HOST_PATHS: readonly string[];
 
@@ -1393,6 +1399,24 @@ export declare function coreViteConfig(browser?: boolean): string;
   */
  export declare function manifestToDependencies(manifestText: string): readonly Dependency[];
 
+ /**
+  * Project a `package.json` text to its own string `name`.
+  *
+  * @param manifest - The `package.json` file content.
+  * @returns The own string `name`, or `undefined` when the manifest exceeds its
+  * byte ceiling, is malformed, has a non-object root, or has no own string
+  * `name`.
+  *
+  * @example
+  * ```ts
+  * import { manifestToName } from '@orkestrel/scaffold'
+  *
+  * manifestToName('{"name":"@orkestrel/router"}') // '@orkestrel/router'
+  * manifestToName('{}') // undefined
+  * ```
+  */
+ export declare function manifestToName(manifest: string): string | undefined;
+
  /** Maximum byte size accepted for one scaffold artifact. */
  export declare const MAX_ARTIFACT_BYTES = 5242880;
 
@@ -1493,12 +1517,13 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare const ORKESTREL_RANGE_PATTERN: RegExp;
 
  /**
-  * One caller template override.
+  * One artifact override.
   *
   * @remarks
   * `content` REPLACES the rendered artifact at `path`, never partially merges.
-  * An override whose `path` matches no planned artifact, or targets a
-  * `host`-origin path, is a BLOCKING question — never a silent add.
+  * An override whose `path` matches no planned artifact, targets a
+  * `host`-origin path, or targets `package.json` is a BLOCKING question.
+  * Accepted overrides surface as retained non-blocking advisories.
   */
  export declare interface Override {
      readonly path: string;
@@ -1931,7 +1956,7 @@ export declare function coreViteConfig(browser?: boolean): string;
          engine: BooleanShape;
      }, false>;
      groups: ArrayShape<LiteralShape<readonly Group[]>>;
-     artifacts: ArrayShape<UnionShape<[ ObjectShape<{
+     artifacts: ArrayShape<UnionShape<readonly [ ObjectShape<{
          path: StringShape;
          group: LiteralShape<readonly Group[]>;
          origin: LiteralShape<readonly ["host"]>;
@@ -2132,7 +2157,7 @@ export declare function coreViteConfig(browser?: boolean): string;
  export declare function rootViteConfig(src: readonly Environment[], engine?: boolean): string;
 
  /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
- export declare const SCAFFOLD_RANGE = "^0.0.5";
+ export declare const SCAFFOLD_RANGE = "^0.0.6";
 
  /**
   * Carries a `ScaffoldErrorCode` + optional `context` (AGENTS §12).
@@ -2175,6 +2200,20 @@ export declare function coreViteConfig(browser?: boolean): string;
      readonly digest: string;
  }
 
+ /**
+  * Select host paths without the guide owned by the target blueprint.
+  *
+  * @param paths - Host artifact paths in deterministic input order.
+  * @param name - The target blueprint's unscoped package name.
+  * @returns Every host path except `guides/src/<name>.md`, in input order.
+  *
+  * @example
+  * ```ts
+  * selectHostPaths(['guides/src/guide.md', 'LICENSE'], 'guide') // ['LICENSE']
+  * ```
+  */
+ export declare function selectHostPaths(paths: readonly string[], name: string): readonly string[];
+
  /**
   * Serialize text as a single-quoted TypeScript string literal.
   *

package/dist/src/core/index.js

@@ -103,9 +103,12 @@ var APP_MATRIX = Object.freeze({
 * The root docs (`AGENTS.md` / `CLAUDE.md`), `LICENSE`, `.agents`, `.claude`, `.codex`,
 * the four SessionStart hook scripts (`scripts/deps.sh` / `scripts/cursor.sh` /
 * `scripts/codex.sh` / `scripts/ollama.sh`), the repository coding-law policy module,
-* the line's seven byte-identical root dotfiles, and the two guides-grouped mirrors every repo carries: the line-wide
-* dev-tooling guide (`guides/src/guide.md`) and the
-* scaffold engine's own self-guide (`guides/src/scaffold.md`).
+* the line's seven byte-identical root dotfiles, and the two guides-grouped
+* mirror candidates: the line-wide dev-tooling guide
+* (`guides/src/guide.md`) and the scaffold engine's own self-guide
+* (`guides/src/scaffold.md`). `stageHost` vendors both; each plan carries the
+* subset selected by `selectHostPaths`, omitting the target blueprint's own
+* guide.
 */
 var HOST_PATHS = Object.freeze([
 	"AGENTS.md",
@@ -217,15 +220,15 @@ var DEFAULT_VERSION = "0.0.1";
 /** The `engines.node` range the `blueprint` builder fills. */
 var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 /** The devDependency range generated packages pin `@orkestrel/scaffold` at. */
-var SCAFFOLD_RANGE = "^0.0.5";
+var SCAFFOLD_RANGE = "^0.0.6";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
 	"@orkestrel/guide": "^0.0.5",
 	"@orkestrel/scaffold": SCAFFOLD_RANGE,
-	"@types/node": "^26.1.1",
-	oxfmt: "^0.60.0",
-	oxlint: "^1.75.0",
+	"@types/node": "^26.1.2",
+	oxfmt: "^0.61.0",
+	oxlint: "^1.76.0",
 	typescript: "^6.0.3",
 	vite: "^8.1.5",
 	"vite-plugin-dts": "^5.0.3",
@@ -1139,6 +1142,22 @@ function snapshotOf(current) {
 	return Object.fromEntries(entries);
 }
 /**
+* Select host paths without the guide owned by the target blueprint.
+*
+* @param paths - Host artifact paths in deterministic input order.
+* @param name - The target blueprint's unscoped package name.
+* @returns Every host path except `guides/src/<name>.md`, in input order.
+*
+* @example
+* ```ts
+* selectHostPaths(['guides/src/guide.md', 'LICENSE'], 'guide') // ['LICENSE']
+* ```
+*/
+function selectHostPaths(paths, name) {
+	const guide = `guides/src/${name}.md`;
+	return paths.filter((path) => path !== guide);
+}
+/**
 * Find the first exact or portable case-insensitive path collision.
 *
 * @param paths - Portable paths in deterministic input order.
@@ -1441,6 +1460,29 @@ function manifestToDependencies(manifestText) {
 	return dependencies;
 }
 /**
+* Project a `package.json` text to its own string `name`.
+*
+* @param manifest - The `package.json` file content.
+* @returns The own string `name`, or `undefined` when the manifest exceeds its
+* byte ceiling, is malformed, has a non-object root, or has no own string
+* `name`.
+*
+* @example
+* ```ts
+* import { manifestToName } from '@orkestrel/scaffold'
+*
+* manifestToName('{"name":"@orkestrel/router"}') // '@orkestrel/router'
+* manifestToName('{}') // undefined
+* ```
+*/
+function manifestToName(manifest) {
+	if (manifest.length > 1048576 || contentByteLength(manifest) > 1048576) return;
+	const parsed = parseJSON(manifest);
+	if (!isRecord(parsed)) return void 0;
+	const name = ownDataValue(parsed, "name");
+	return typeof name === "string" ? name : void 0;
+}
+/**
 * Compare a declared range to the registry latest.
 *
 * @param range - The declared semver range.
@@ -2145,6 +2187,7 @@ var isPlan = andOf(andOf(createContract(planShape()).is, hasValidPlanHex), hasVa
 function validatePlan(plan) {
 	const blueprintValidation = validateBlueprint(plan.blueprint);
 	const questions = [...blueprintValidation.questions];
+	const warnings = [...blueprintValidation.warnings];
 	if (!hasValidPlanBytes(plan)) questions.push({
 		field: "artifacts",
 		text: "Plan artifact content exceeds the retained byte limits",
@@ -2169,16 +2212,20 @@ function validatePlan(plan) {
 			});
 			continue;
 		}
-		if (artifact.path === "package.json") questions.push({
-			field: "overrides",
-			text: "Override path \"package.json\" targets the blueprint-owned publication boundary",
-			blocking: true
-		});
+		if (artifact.path === "package.json") {
+			questions.push({
+				field: "overrides",
+				text: "Override path \"package.json\" targets the blueprint-owned publication boundary",
+				blocking: true
+			});
+			continue;
+		}
+		warnings.push(`Override path "${item.path}" replaces its planned artifact content`);
 	}
 	return {
 		valid: questions.length === 0,
 		questions,
-		warnings: blueprintValidation.warnings
+		warnings
 	};
 }
 /** Determine whether every guide body fits the public UTF-8 artifact byte limit. */
@@ -7096,6 +7143,7 @@ function singleSrcViteConfig(environment) {
 	const machinery = viteMachinery([environment]);
 	const header = viteHeader(machinery);
 	if (environment === "browser") return `${header}
+if (!hasChromium) console.warn('browser projects skipped: Chromium absent (${SRC_MATRIX.browser.project})')
 ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
@@ -7154,7 +7202,7 @@ ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 export default defineConfig({
 	resolve,
 	test: {
-		projects: [srcBrowser, policy, guides],
+		projects: [...(hasChromium ? [srcBrowser] : []), policy, guides],
 	},
 })
 `;
@@ -7380,14 +7428,18 @@ ${EXPORT_KEYWORD} const integration = (config?: UserConfig): UserConfig =>
 	const blocks = nonCore.map((environment) => environment === "browser" ? browserBlock : serverBlock).join("") + binBlock;
 	const projectNames = [
 		...hasCore ? ["srcCore"] : [],
-		...nonCore.map((environment) => `src${pascalCase(environment)}`),
+		...nonCore.map((environment) => environment === "browser" ? "...(hasChromium ? [srcBrowser] : [])" : `src${pascalCase(environment)}`),
 		"policy",
 		"guides",
 		...engine ? ["srcBin"] : [],
 		...engine ? ["integration"] : []
 	];
+	const inlineProjects = `		projects: [${projectNames.join(", ")}],`;
+	const renderedProjects = computeColumnWidth(inlineProjects) <= 100 ? inlineProjects : `		projects: [
+${projectNames.map((project) => `			${project},`).join("\n")}
+		],`;
 	return `${header}
-${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
+${machinery.browser ? `if (!hasChromium) console.warn('browser projects skipped: Chromium absent (${SRC_MATRIX.browser.project})')\n` : ""}${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
 			resolve,
@@ -7426,7 +7478,7 @@ ${blocks}
 export default defineConfig({
 	resolve,
 	test: {
-		projects: [${projectNames.join(", ")}],
+${renderedProjects}
 	},
 })
 `;
@@ -7474,7 +7526,7 @@ ${EXPORT_KEYWORD} const srcCore = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (src.includes("browser")) {
-		projects.push("srcBrowser");
+		projects.push("...(hasChromium ? [srcBrowser] : [])");
 		const coreOutput = hasSourceCore ? `
 					output: { paths: { '@src/core': '../core/index.js' } },` : "";
 		const coreExternal = hasSourceCore ? `id === '@src/core' || ` : "";
@@ -7591,7 +7643,7 @@ ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 `);
 	}
 	if (app.includes("browser")) {
-		projects.push("appBrowser()");
+		projects.push("...(hasChromium ? [appBrowser()] : [])");
 		blocks.push(`
 ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 	if (config.length > 0) {
@@ -7725,8 +7777,22 @@ ${EXPORT_KEYWORD} const integration = (config?: UserConfig): UserConfig =>
 	)
 `);
 	}
+	const projectNames = [
+		...projects,
+		"policy",
+		"guides"
+	];
+	const inlineProjects = `		projects: [${projectNames.join(", ")}],`;
+	const renderedProjects = computeColumnWidth(inlineProjects) <= 100 ? inlineProjects : `		projects: [
+${projectNames.map((project) => `			${project},`).join("\n")}
+		],`;
+	const browserProjects = [...src.includes("browser") ? [SRC_MATRIX.browser.project] : [], ...app.includes("browser") ? [APP_MATRIX.browser.project] : []];
+	const browserNotice = serializeTypeScriptString(`browser projects skipped: Chromium absent (${browserProjects.join(", ")})`);
+	const inlineBrowserNotice = `if (!hasChromium) console.warn(${browserNotice})`;
+	const renderedBrowserNotice = browserProjects.length === 0 ? void 0 : computeColumnWidth(inlineBrowserNotice) <= 100 ? inlineBrowserNotice : `if (!hasChromium)
+	console.warn(${browserNotice})`;
 	return `${header}
-${policyViteProject()}
+${renderedBrowserNotice === void 0 ? "" : `${renderedBrowserNotice}\n`}${policyViteProject()}
 ${EXPORT_KEYWORD} const guides = (config?: UserConfig): UserConfig =>
 	mergeConfig(
 		{
@@ -7746,17 +7812,13 @@ ${blocks.join("")}
 export default defineConfig({
 	resolve,
 	test: {
-		projects: [${[
-		...projects,
-		"policy",
-		"guides"
-	].join(", ")}],
+${renderedProjects}
 	},
 })
 `;
 }
 /**
-* `configs/src/tsconfig.core.json` — unchanged core shape.
+* `configs/src/tsconfig.core.json` — host-neutral core with web interop declarations.
 *
 * @returns The core environment `tsconfig` file content, newline-terminated.
 *
@@ -7769,7 +7831,7 @@ function coreTsconfig() {
 	return formatJson({
 		extends: "../../tsconfig.json",
 		compilerOptions: {
-			lib: ["ESNext"],
+			lib: ["ESNext", "WebWorker"],
 			types: [],
 			noEmit: false,
 			declaration: true,
@@ -7924,7 +7986,7 @@ function appTsconfig(environment, hasCore) {
 				"ESNext",
 				"DOM",
 				"DOM.Iterable"
-			] : ["ESNext"],
+			] : environment === "core" ? ["ESNext", "WebWorker"] : ["ESNext"],
 			types: environment === "browser" ? ["vite/client", "vue"] : environment === "server" ? ["node"] : []
 		},
 		include
@@ -8526,12 +8588,15 @@ function guideTests(spec, pascal) {
 }
 /**
 * Draft the `guides` group's artifacts — the package's own filled guide stub,
-* the guides index, and any vendored dependency guide mirrors.
+* the guides index, and vendored dependency guide mirrors whose paths are
+* neither the package's own guide nor already carried by the selected host
+* set.
 *
 * @param spec - The `Blueprint` to derive guide artifacts from.
 * @param pascal - The package's PascalCase entity name.
 * @param members - The blueprint's derived `Member[]`.
-* @returns The `guides` group's `Artifact[]`.
+* @returns The `guides` group's `Artifact[]`, with one contributor per guide
+* path.
 *
 * @example
 * ```ts
@@ -8584,14 +8649,16 @@ function guideArtifacts(spec, pascal, members) {
 		]]),
 		directory: alignTable(["Directory", "Guide"], sourceDirectories.map((directory) => [directory, `[\`${spec.name}.md\`](src/${spec.name}.md)`]))
 	})];
+	const guidePath = `guides/src/${spec.name}.md`;
 	for (const dep of spec.dependencies) {
 		if (!vendoredGuides.includes(dep.name)) continue;
-		const short = dep.name.replace("@orkestrel/", "");
+		const path = `guides/src/${dep.name.replace("@orkestrel/", "")}.md`;
+		if (HOST_PATHS.includes(path) || path === guidePath) continue;
 		artifacts.push({
-			path: `guides/src/${short}.md`,
+			path,
 			group: "guides",
 			origin: "host",
-			source: `guides/src/${short}.md`
+			source: path
 		});
 	}
 	return artifacts;
@@ -8627,7 +8694,7 @@ function applyOverrides(artifacts, overrides) {
 /**
 * The full pure compilation: draft a blueprint's artifacts — the manifest and
 * exports combination rules over the per-environment `SRC_MATRIX` rows, plus
-* `HOST_PATHS` and `overrides` — then pin.
+* the `selectHostPaths` selection of `HOST_PATHS` and `overrides` — then pin.
 *
 * @param blueprint - The `Blueprint` to compile.
 * @param groups - An optional `Group[]` selection (default: all groups).
@@ -8671,7 +8738,7 @@ npm install @orkestrel/${blueprint.name}
 		origin: "computed",
 		content: ciWorkflow(blueprint)
 	});
-	for (const path of HOST_PATHS) {
+	for (const path of selectHostPaths(HOST_PATHS, blueprint.name)) {
 		const group = hostGroup(path);
 		if (!selected.includes(group)) continue;
 		artifacts.push({
@@ -8794,7 +8861,10 @@ var Compiler = class Compiler {
 			this.#emitter.emit("audit", result);
 			return result;
 		}
-		const result = diffPlan(scaffolding.plan, current);
+		const result = {
+			...diffPlan(scaffolding.plan, current),
+			questions: scaffolding.questions
+		};
 		this.#emitter.emit("audit", result);
 		return result;
 	}
@@ -8858,7 +8928,16 @@ var Compiler = class Compiler {
 		const validation = validatePlan(draft);
 		const dependencyQuestions = this.#dependencyQuestions(blueprint);
 		const blocking = [...validation.questions];
-		const questions = [...blocking, ...dependencyQuestions];
+		const warningQuestions = validation.warnings.map((text) => ({
+			field: "overrides",
+			text,
+			blocking: false
+		}));
+		const questions = [
+			...blocking,
+			...warningQuestions,
+			...dependencyQuestions
+		];
 		stages.push({
 			stage: "gate",
 			input: draft,
@@ -8951,9 +9030,11 @@ var Compiler = class Compiler {
 	}
 	#pointerArtifacts(blueprint) {
 		const artifacts = [];
+		const guidePath = `guides/src/${blueprint.name}.md`;
 		for (const item of blueprint.dependencies) {
 			if (Compiler.#vendored.includes(item.name)) continue;
 			const path = `guides/src/${item.name.replace("@orkestrel/", "")}.md`;
+			if (path === guidePath || HOST_PATHS.includes(path)) continue;
 			artifacts.push({
 				path,
 				group: "guides",
@@ -9178,6 +9259,6 @@ function createBlueprint(data) {
 	return candidate;
 }
 //#endregion
-export { APP_BROWSER_DEV_DEPENDENCIES, APP_MATRIX, BASE_DEV_DEPENDENCIES, CATEGORIES, CHECKOUT_ACTION_SHA, COMPILER_ID, COMPILE_STAGES, CONST_KEYWORD, CONTROL_CHARACTER_PATTERN, Compiler, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, ENGINES_PATTERN, ENVIRONMENTS, EXPORT_KEYWORD, EXTRA_NAME_PATTERN, EXTRA_RANGE_PATTERN, FRESHNESS, FUNCTION_KEYWORD, GROUPS, HEX_PATTERN, HOST_PATHS, IMPORT_KEYWORD, INVALID_PATH_CHARACTER_PATTERN, JSON_PRINT_WIDTH, JSON_TAB_WIDTH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_COLLECTION_ITEMS, MAX_DATA_GRAPH_KEYS, MAX_DATA_GRAPH_NODES, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_SERIALIZED_INPUT_BYTES, MAX_TOTAL_ARTIFACT_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORIGINS, ORKESTREL_RANGE_PATTERN, PlanManager, SCAFFOLD_RANGE, SETUP_NODE_ACTION_SHA, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, SYNC_BASELINE_PATTERN, ScaffoldError, TEMPLATES, TYPESCRIPT_EXTENSIONS, VERSION_PATTERN, alignTable, appTsconfig, appViteConfig, applicationArtifacts, applicationViteConfig, applyOverrides, artifactShape, auditToReview, blueprint, blueprintShape, blueprintToMembers, blueprintToPlan, bytesToHex, catalogNames, catalogToBlock, ciWorkflow, compareCodeUnit, computeColumnWidth, computeHash, configArtifacts, contentByteLength, contentCodePoint, contentToBytes, contentToHex, coreTsconfig, coreViteConfig, createBlueprint, createCompiler, createPlanManager, delimiterCell, dependency, dependencyShape, devDependenciesFor, diffPlan, dualCondition, entryFields, escapeHtmlText, exportsMap, fillArtifact, findFileConflict, findPathConflict, formatJson, guideArtifacts, guideMemberTable, guideMethods, guideTests, guideUsage, hasBlueprintEnvironment, hasOnlyDataProperties, hasValidArtifactBytes, hasValidArtifactHex, hasValidAuditBytes, hasValidBlueprintBytes, hasValidOverrideBytes, hasValidPlanBytes, hasValidPlanHex, hasValidSnapshotBytes, hasValidSyncReportBytes, hostGroup, inferGroup, isArtifact, isBehind, isBlueprint, isCompilerEventHooks, isDenseDataArray, isDependency, isEmitterErrorHandler, isMember, isOverride, isPlan, isPlanManagerEventHooks, isScaffoldError, isSyncReport, isWorkspaceName, manifestToDependencies, member, memberShape, override, overrideShape, ownDataValue, packageManifest, padCell, paritySpecifiers, parseBlueprint, parseBoundedJSON, parseCompilerOptions, parsePlan, parsePlanIds, parsePlanManagerOptions, parseSyncReport, pascalCase, pinPlan, planPayload, planShape, planToReview, planToSummary, policyViteProject, rangeToFreshness, renderArray, renderObject, renderValue, rootTsconfig, rootViteConfig, serializeTypeScriptString, singleSrcViteConfig, snapshotOf, snapshotPlan, sourceArtifacts, splitTableRow, srcTsconfig, srcVariant, srcViteConfig, stableStringify, syncReportShape, syncToReview, testArtifacts, validateBlueprint, validateDependencyArray, validatePlan, viteHeader, viteMachinery };
+export { APP_BROWSER_DEV_DEPENDENCIES, APP_MATRIX, BASE_DEV_DEPENDENCIES, CATEGORIES, CHECKOUT_ACTION_SHA, COMPILER_ID, COMPILE_STAGES, CONST_KEYWORD, CONTROL_CHARACTER_PATTERN, Compiler, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, ENGINES_PATTERN, ENVIRONMENTS, EXPORT_KEYWORD, EXTRA_NAME_PATTERN, EXTRA_RANGE_PATTERN, FRESHNESS, FUNCTION_KEYWORD, GROUPS, HEX_PATTERN, HOST_PATHS, IMPORT_KEYWORD, INVALID_PATH_CHARACTER_PATTERN, JSON_PRINT_WIDTH, JSON_TAB_WIDTH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_COLLECTION_ITEMS, MAX_DATA_GRAPH_KEYS, MAX_DATA_GRAPH_NODES, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_SERIALIZED_INPUT_BYTES, MAX_TOTAL_ARTIFACT_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORIGINS, ORKESTREL_RANGE_PATTERN, PlanManager, SCAFFOLD_RANGE, SETUP_NODE_ACTION_SHA, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, SYNC_BASELINE_PATTERN, ScaffoldError, TEMPLATES, TYPESCRIPT_EXTENSIONS, VERSION_PATTERN, alignTable, appTsconfig, appViteConfig, applicationArtifacts, applicationViteConfig, applyOverrides, artifactShape, auditToReview, blueprint, blueprintShape, blueprintToMembers, blueprintToPlan, bytesToHex, catalogNames, catalogToBlock, ciWorkflow, compareCodeUnit, computeColumnWidth, computeHash, configArtifacts, contentByteLength, contentCodePoint, contentToBytes, contentToHex, coreTsconfig, coreViteConfig, createBlueprint, createCompiler, createPlanManager, delimiterCell, dependency, dependencyShape, devDependenciesFor, diffPlan, dualCondition, entryFields, escapeHtmlText, exportsMap, fillArtifact, findFileConflict, findPathConflict, formatJson, guideArtifacts, guideMemberTable, guideMethods, guideTests, guideUsage, hasBlueprintEnvironment, hasOnlyDataProperties, hasValidArtifactBytes, hasValidArtifactHex, hasValidAuditBytes, hasValidBlueprintBytes, hasValidOverrideBytes, hasValidPlanBytes, hasValidPlanHex, hasValidSnapshotBytes, hasValidSyncReportBytes, hostGroup, inferGroup, isArtifact, isBehind, isBlueprint, isCompilerEventHooks, isDenseDataArray, isDependency, isEmitterErrorHandler, isMember, isOverride, isPlan, isPlanManagerEventHooks, isScaffoldError, isSyncReport, isWorkspaceName, manifestToDependencies, manifestToName, member, memberShape, override, overrideShape, ownDataValue, packageManifest, padCell, paritySpecifiers, parseBlueprint, parseBoundedJSON, parseCompilerOptions, parsePlan, parsePlanIds, parsePlanManagerOptions, parseSyncReport, pascalCase, pinPlan, planPayload, planShape, planToReview, planToSummary, policyViteProject, rangeToFreshness, renderArray, renderObject, renderValue, rootTsconfig, rootViteConfig, selectHostPaths, serializeTypeScriptString, singleSrcViteConfig, snapshotOf, snapshotPlan, sourceArtifacts, splitTableRow, srcTsconfig, srcVariant, srcViteConfig, stableStringify, syncReportShape, syncToReview, testArtifacts, validateBlueprint, validateDependencyArray, validatePlan, viteHeader, viteMachinery };
 
 //# sourceMappingURL=index.js.map