@orkestrel/scaffold 0.0.30 → 0.0.32

package/dist/src/core/index.cjs

@@ -140,6 +140,16 @@ var HOST_PATHS = Object.freeze([
 	"guides/scaffold.md"
 ]);
 /**
+* 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
+* or replaced while present. A workspace therefore stops receiving later
+* canonical updates to them. `.gitignore` takes that trade because its correct
+* rules differ by workspace, so scaffold cannot own its bytes.
+*/
+var WORKSPACE_OWNED_PATHS = Object.freeze([".gitignore"]);
+/**
 * The vendored paths a target receives with its executable bit set, frozen.
 *
 * @remarks
@@ -197,9 +207,11 @@ var CATALOG_AGENT_PATH = ".claude/agents/orkestrel.md";
 var SERVICE_SCRIPT_PATH = "scripts/service.sh";
 /** The shared Vitest global-setup module whose presence makes a workspace `global`. */
 var GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
-/** The guide-parity proof whose physical file selects the fixed `guides` project. */
+/** The guide-parity proof whose presence selects the planned `guides` project. */
 var GUIDES_TEST_PATH = "tests/guides.test.ts";
-/** The installed-package proof whose presence makes a workspace `integration`. */
+/** The packed-package proof whose presence makes a workspace `distribution`. */
+var DISTRIBUTION_TEST_PATH = "tests/distribution.test.ts";
+/** The cross-environment composition proof whose presence makes a workspace `integration`. */
 var INTEGRATION_TEST_PATH = "tests/integration.test.ts";
 /** The official-tooling drift proof whose presence makes a workspace `conformance`. */
 var CONFORMANCE_TEST_PATH = "tests/conformance.test.ts";
@@ -270,6 +282,10 @@ var MAX_RANGE_LENGTH = 2048;
 var MAX_PATH_LENGTH = 32767;
 /** Maximum items accepted in one public collection. */
 var MAX_COLLECTION_ITEMS = 1e3;
+/** Columns one emitted line may occupy, matching `printWidth` in `.oxfmtrc.json`. */
+var PRINT_WIDTH = 100;
+/** Columns one tab occupies when the formatter measures a line, matching `tabWidth`. */
+var TAB_WIDTH = 2;
 /** Maximum findings one audit can produce from a bounded plan and snapshot. */
 var MAX_AUDIT_FINDINGS = MAX_COLLECTION_ITEMS * 2;
 /** Maximum bytes accepted for one artifact. */
@@ -288,17 +304,21 @@ var DEFAULT_VERSION = "0.0.1";
 var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 /** The tooling versions scaffold and every generated workspace share. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
-	"@microsoft/api-extractor": "^7.58.12",
-	"@orkestrel/guide": "^0.0.10",
-	"@orkestrel/scaffold": "^0.0.30",
+	"@orkestrel/guide": "^0.0.11",
+	"@orkestrel/scaffold": "^0.0.32",
+	"@orkestrel/test": "^0.0.2",
 	"@types/node": "^26.2.0",
 	oxfmt: "^0.62.0",
 	oxlint: "^1.77.0",
 	typescript: "^6.0.3",
 	vite: "~8.2.0",
-	"vite-plugin-dts": "^5.0.3",
 	vitest: "^4.1.10"
 });
+/** The development dependencies that emit declarations for published source or an executable. */
+var DECLARATION_DEV_DEPENDENCIES = Object.freeze({
+	"@microsoft/api-extractor": "^7.58.12",
+	"vite-plugin-dts": "^5.0.3"
+});
 /** The development dependencies a published browser `src` environment adds. */
 var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
 	"@vitest/browser-playwright": "^4.1.10",
@@ -386,38 +406,12 @@ var CONFIG_TEMPLATES = Object.freeze({
 		vite: `import type { {{viteTypes}} } from 'vite'
 {{imports}}import { defineConfig, mergeConfig } from 'vitest/config'
 import tsconfig from './tsconfig.json' with { type: 'json' }
-{{helpers}}{{browsers}}import { lstatSync, readdirSync, realpathSync } from 'node:fs'
-import { basename, join, parse, relative, resolve as resolvePath, sep } from 'node:path'
-import { fileURLToPath, URL } from 'node:url'
+{{helpers}}{{browsers}}import { fileURLToPath, URL } from 'node:url'
 
 {{options}}export function resolveWorkspacePath(relativePath: string): string {
 	return fileURLToPath(new URL(relativePath, import.meta.url))
 }
 
-// A generated root config must classify its own fixed proof without importing
-// package source, so the exact-case check stays self-contained over Node APIs.
-function isExactCaseFile(path: string): boolean {
-	const full = resolvePath(path)
-	try {
-		const status = lstatSync(full)
-		if (!status.isFile() || status.isSymbolicLink() || status.nlink !== 1) return false
-		const root = parse(full).root
-		const segments = relative(root, full).split(sep)
-		let parent = root
-		for (const segment of segments) {
-			try {
-				if (!readdirSync(parent).includes(segment)) return false
-			} catch {
-				if (basename(realpathSync.native(join(parent, segment))) !== segment) return false
-			}
-			parent = join(parent, segment)
-		}
-		return true
-	} catch {
-		return false
-	}
-}
-
 const resolve = {
 	alias: Object.entries(tsconfig.compilerOptions.paths).reduce((aliases, [key, values]) => {
 		const [path] = values
@@ -553,6 +547,10 @@ const resolve = {
 				setupFiles: ['./tests/setup.ts', './tests/setupServer.ts'],
 				environment: 'node',
 				browser: { enabled: false },
+				// A bin test drives the real executable over a real temporary repository, so it
+				// spends seconds in process startup and filesystem work rather than milliseconds.
+				// Vitest's five-second default clears one alone and times out under a full suite.
+				testTimeout: 15_000,
 			},
 		},
 		options ?? {},
@@ -604,8 +602,7 @@ const resolve = {
 	}
 }
 
-export function appBrowser(...options: never[]): UserConfig {
-	if (options.length > 0) throw new Error('Browser configuration overrides are not permitted')
+export function appBrowser(): UserConfig {
 	return applicationBrowser(false)
 }
 {{showcaseFactory}}`,
@@ -721,6 +718,23 @@ export const service = (options?: UserConfig): UserConfig =>
 		},
 		options ?? {},
 	)
+`,
+		distribution: `export const distribution = (options?: UserConfig): UserConfig =>
+	mergeConfig(
+		{
+			resolve,
+			test: {
+				name: { label: 'distribution', color: 'cyan' },
+				include: ['${DISTRIBUTION_TEST_PATH}'],
+				setupFiles: ['./tests/setup.ts'],
+				environment: 'node',
+				testTimeout: 120_000,
+				hookTimeout: 120_000,
+				fileParallelism: false,
+			},
+		},
+		options ?? {},
+	)
 `,
 		probe: `// A workbench, not a proof. No gate selects this project.
 export const probe = (options?: UserConfig): UserConfig =>
@@ -747,9 +761,6 @@ export const probe = (options?: UserConfig): UserConfig =>
 				include: ['${INTEGRATION_TEST_PATH}'],
 				setupFiles: ['./tests/setup.ts'],
 {{global}}				environment: 'node',
-				testTimeout: 120_000,
-				hookTimeout: 120_000,
-				fileParallelism: false,
 			},
 		},
 		options ?? {},
@@ -1377,112 +1388,14 @@ describe('bin entry', () => {
 	})
 })
 `,
-		integration: `import { spawnSync } from 'node:child_process'
-import { globSync, mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { tmpdir } from 'node:os'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-import { describe, expect, it } from 'vitest'
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
-const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm'
-const registry =
-	spawnSync(npm, ['ping', '--fetch-retries=0', '--fetch-timeout=1000', '--loglevel=silent'], {
-		cwd: root,
-		stdio: 'ignore',
-		timeout: 5_000,
-		windowsHide: true,
-	}).status === 0
+		integration: `{{imports}}import { describe, expect, it } from 'vitest'
 
-describe('installed package consumer', () => {
-	it('loads the built package from a process outside the workspace', () => {
-		const workspace = mkdtempSync(join(tmpdir(), 'orkestrel-integration-driver-'))
-		try {
-			const manifest: unknown = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'))
-			if (typeof manifest !== 'object' || manifest === null) {
-				throw new Error('The package manifest is not a record')
-			}
-			const module: unknown = Object.getOwnPropertyDescriptor(manifest, 'module')?.value
-			if (typeof module !== 'string')
-				throw new Error('The package manifest carries no module entry')
-			const entry = pathToFileURL(resolve(root, module)).href
-			const missing = pathToFileURL(resolve(root, 'dist/outside-integration-control.js')).href
-			const control = spawnSync(
-				process.execPath,
-				['--input-type=module', '--eval', 'await import(' + JSON.stringify(missing) + ')'],
-				{ cwd: workspace, encoding: 'utf8', windowsHide: true },
-			)
-			expect(control.status).not.toBe(0)
-			const driven = spawnSync(
-				process.execPath,
-				['--input-type=module', '--eval', 'await import(' + JSON.stringify(entry) + ')'],
-				{ cwd: workspace, encoding: 'utf8', windowsHide: true },
-			)
-			expect(driven.status).toBe(0)
-			expect(driven.stderr).toBe('')
-		} finally {
-			rmSync(workspace, { recursive: true, force: true })
-		}
+describe('workspace integration', () => {
+	it('loads every selected public barrel together as a composition seed', () => {
+		// Replace this empty-barrel seed with one observable flow that passes one
+		// environment's public result into another.
+		{{actual}}{{expected}})
 	})
-
-	it.skipIf(!registry)(
-		'installs the packed package into an outside consumer [requires a reachable npm registry]',
-		() => {
-			const workspace = mkdtempSync(join(tmpdir(), 'orkestrel-integration-install-'))
-			const packed = join(workspace, 'packed')
-			const consumer = join(workspace, 'consumer')
-			try {
-				mkdirSync(packed, { recursive: true })
-				mkdirSync(consumer, { recursive: true })
-				const pack = spawnSync(
-					npm,
-					['pack', '--json', '--ignore-scripts', '--pack-destination', packed],
-					{ cwd: root, encoding: 'utf8', windowsHide: true },
-				)
-				expect(pack.status).toBe(0)
-				const archives = globSync('*.tgz', { cwd: packed })
-				expect(archives).toHaveLength(1)
-				const archive = archives[0]
-				if (archive === undefined) throw new Error('The package archive was not written')
-				writeFileSync(
-					join(consumer, 'package.json'),
-					'{"name":"outside-consumer","private":true,"type":"module"}\\n',
-				)
-				const install = spawnSync(
-					npm,
-					['install', '--ignore-scripts', '--no-audit', '--no-fund', join(packed, archive)],
-					{ cwd: consumer, encoding: 'utf8', windowsHide: true },
-				)
-				expect(install.status).toBe(0)
-				const manifest: unknown = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'))
-				if (typeof manifest !== 'object' || manifest === null) {
-					throw new Error('The package manifest is not a record')
-				}
-				const name: unknown = Object.getOwnPropertyDescriptor(manifest, 'name')?.value
-				if (typeof name !== 'string') throw new Error('The package manifest carries no name')
-				const control = spawnSync(
-					process.execPath,
-					[
-						'--input-type=module',
-						'--eval',
-						'await import(' + JSON.stringify(name + '/outside-integration-control') + ')',
-					],
-					{ cwd: consumer, encoding: 'utf8', windowsHide: true },
-				)
-				expect(control.status).not.toBe(0)
-				const driven = spawnSync(
-					process.execPath,
-					['--input-type=module', '--eval', 'await import(' + JSON.stringify(name) + ')'],
-					{ cwd: consumer, encoding: 'utf8', windowsHide: true },
-				)
-				expect(driven.status).toBe(0)
-				expect(driven.stderr).toBe('')
-			} finally {
-				rmSync(workspace, { recursive: true, force: true })
-			}
-		},
-		300_000,
-	)
 })
 `
 	}),
@@ -1803,6 +1716,8 @@ var isBlueprint = (0, _orkestrel_contract.recordOf)({
 	engines: _orkestrel_contract.isString,
 	overrides: (0, _orkestrel_contract.andOf)(isCollection, (0, _orkestrel_contract.arrayOf)(isOverride)),
 	bin: _orkestrel_contract.isBoolean,
+	guides: _orkestrel_contract.isBoolean,
+	distribution: _orkestrel_contract.isBoolean,
 	integration: _orkestrel_contract.isBoolean,
 	conformance: _orkestrel_contract.isBoolean,
 	service: _orkestrel_contract.isBoolean,
@@ -2398,6 +2313,30 @@ function nameToGuide(name) {
 	return `guides/${name.slice(name.lastIndexOf("/") + 1)}.md`;
 }
 /**
+* Test whether one emitted line fits the vendored formatter width.
+*
+* @param line - One emitted line, leading tabs included.
+* @returns `true` when the expanded line fits.
+*
+* @remarks
+* A generator writes source the formatter then reads back, so a line packed
+* past the vendored width is rewrapped on the next `format` run and the emitted
+* bytes stop matching the plan the audit compares against. The generator
+* therefore measures a candidate line and chooses the shape the formatter would
+* have chosen. Tabs are expanded first because the formatter counts them as
+* `TAB_WIDTH` columns rather than as one character.
+*
+* @example
+* ```ts
+* import { matchesPrintWidth } from '@orkestrel/scaffold'
+*
+* matchesPrintWidth('\t\tprojects: [core],') // true
+* ```
+*/
+function matchesPrintWidth(line) {
+	return line.replaceAll("	", " ".repeat(2)).length <= 100;
+}
+/**
 * Derive the declaration rewrite a published face's `beforeWriteFile` applies.
 *
 * @param name - The workspace's own bare package name.
@@ -2429,7 +2368,7 @@ function nameToRewrite(name) {
 	const specifier = serializeTypeScriptString(`@orkestrel/${name}`);
 	const pattern = "/(?:\\.\\.\\/)+core\\/index\\.[jt]s/g";
 	const joined = `\t\t\t\t\t\t? content.replaceAll(${pattern}, ${specifier})`;
-	if (joined.replaceAll("	", "  ").length <= 100) return joined;
+	if (matchesPrintWidth(joined)) return joined;
 	return [
 		"						? content.replaceAll(",
 		`\t\t\t\t\t\t\t\t${pattern},`,
@@ -3059,6 +2998,7 @@ function srcToExports(src) {
 function blueprintToDevDependencies(blueprint) {
 	const merged = {
 		...BASE_DEV_DEPENDENCIES,
+		...blueprint.src.length > 0 || blueprint.bin ? DECLARATION_DEV_DEPENDENCIES : {},
 		...blueprint.src.includes("browser") ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
 		...blueprint.app.length > 0 ? APP_DEV_DEPENDENCIES : {},
 		...blueprint.app.includes("browser") ? APP_BROWSER_DEV_DEPENDENCIES : {},
@@ -3084,12 +3024,13 @@ function blueprintToDevDependencies(blueprint) {
 * proofs every workspace can pass before it has a public API, and one build per
 * target that actually builds.
 *
-* A proof leaves `test` when a real service or a real install answers it. The
-* installed-package integration proof and the live-service proof therefore run
-* from `prepublishOnly` instead. The conformance proof stays in `test`, because
-* it measures this package against official tooling and drives nothing external:
-* a conformance run may start a server, but it starts its own and reaches it
-* over loopback, so the run stays hermetic.
+* A publishing workspace isolates distribution and live-service proofs from
+* `test` and runs them from `prepublishOnly` instead. A private workspace has
+* no publish lifecycle, so it omits distribution and runs a live-service proof
+* from `test`. Integration and conformance stay in `test` because they neither
+* pack nor install the workspace and drive no external service. A conformance
+* run may start a server, but it starts its own and reaches it over loopback,
+* so the run stays hermetic.
 *
 * The configuration paths interpolated here are the same ones `SRC_MATRIX` and
 * `APP_MATRIX` list as each environment's configuration files, so a rename in
@@ -3106,7 +3047,8 @@ function blueprintToDevDependencies(blueprint) {
 */
 function blueprintToScripts(blueprint) {
 	const publishes = blueprint.src.length > 0;
-	const integrates = publishes && blueprint.integration;
+	const distributes = blueprint.distribution && publishes;
+	const integrates = blueprint.integration;
 	const compiles = publishes || blueprint.bin;
 	const runtime = blueprint.app.filter((environment) => environment !== "core");
 	const vitest = "vitest run --config vite.config.ts --no-cache --reporter=dot";
@@ -3137,7 +3079,10 @@ function blueprintToScripts(blueprint) {
 		...blueprint.app.length > 0 ? ["npm run test:app"] : [],
 		"npm run test:policy",
 		"npm run test:config",
-		...blueprint.conformance ? ["npm run test:conformance"] : []
+		...blueprint.guides ? ["npm run test:guides"] : [],
+		...blueprint.conformance ? ["npm run test:conformance"] : [],
+		...integrates ? ["npm run test:integration"] : [],
+		...!publishes && blueprint.service ? ["npm run test:service"] : []
 	].join(" && ");
 	if (compiles) {
 		scripts["test:src"] = [
@@ -3154,8 +3099,10 @@ function blueprintToScripts(blueprint) {
 	}
 	scripts["test:policy"] = `${vitest} --project policy`;
 	scripts["test:config"] = `${vitest} --project config`;
+	if (blueprint.guides) scripts["test:guides"] = `${vitest} --project guides`;
 	if (blueprint.conformance) scripts["test:conformance"] = `${vitest} --project conformance`;
 	scripts["test:probe"] = "vitest run --config vite.config.ts --no-cache --reporter=verbose --project probe";
+	if (distributes) scripts["test:distribution"] = `${vitest} --project distribution`;
 	if (integrates) scripts["test:integration"] = `${vitest} --project integration`;
 	if (blueprint.service) scripts["test:service"] = `${vitest} --project service`;
 	scripts.build = [
@@ -3187,9 +3134,9 @@ function blueprintToScripts(blueprint) {
 		scripts.serve = "node dist/app/server/main.cjs";
 		scripts["serve:build"] = "npm run build:app:server && npm run serve";
 	}
-	scripts.prepublishOnly = [
+	if (publishes) scripts.prepublishOnly = [
 		"npm run format:check && npm run lint:check && npm run check && npm run build && npm test",
-		...integrates ? ["npm run test:integration"] : [],
+		...distributes ? ["npm run test:distribution -- --mode release"] : [],
 		...blueprint.service ? ["npm run test:service"] : []
 	].join(" && ");
 	return scripts;
@@ -3360,6 +3307,8 @@ function blueprintToRootTsconfig(blueprint) {
 */
 function blueprintToRootVite(blueprint) {
 	const machinery = blueprintToMachinery(blueprint);
+	const publishes = blueprint.src.length > 0;
+	const distributes = blueprint.distribution && publishes;
 	const imports = [];
 	if (machinery.browser) imports.push("import { playwright } from '@vitest/browser-playwright'");
 	if (machinery.vue) imports.push("import vue from '@vitejs/plugin-vue'");
@@ -3451,8 +3400,7 @@ function blueprintToRootVite(blueprint) {
 				: { assetsInlineLimit: 0 }),
 ` : "			assetsInlineLimit: 0,\n";
 		const showcaseFactory = machinery.showcase ? `
-export function appShowcase(...options: never[]): UserConfig {
-	if (options.length > 0) throw new Error('Showcase configuration overrides are not permitted')
+export function appShowcase(): UserConfig {
 	return applicationBrowser(true)
 }
 ` : "";
@@ -3472,8 +3420,10 @@ export function appShowcase(...options: never[]): UserConfig {
 	projects.push("policy");
 	factories.push(CONFIG_TEMPLATES.factories.config);
 	projects.push("config");
-	factories.push(CONFIG_TEMPLATES.factories.guides);
-	projects.push(`...(isExactCaseFile(resolveWorkspacePath('${GUIDES_TEST_PATH}')) ? [guides] : [])`);
+	if (blueprint.guides) {
+		factories.push(CONFIG_TEMPLATES.factories.guides);
+		projects.push("guides");
+	}
 	if (blueprint.conformance) {
 		factories.push(CONFIG_TEMPLATES.factories.conformance);
 		projects.push("conformance");
@@ -3482,13 +3432,18 @@ export function appShowcase(...options: never[]): UserConfig {
 		factories.push(CONFIG_TEMPLATES.factories.service);
 		projects.push("service");
 	}
-	if (blueprint.src.length > 0 && blueprint.integration) {
+	if (distributes) {
+		factories.push(CONFIG_TEMPLATES.factories.distribution);
+		projects.push("distribution");
+	}
+	if (blueprint.integration) {
 		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.integration, { global: blueprint.global ? "				globalSetup: ['./tests/setupGlobal.ts'],\n" : "" }));
 		projects.push("integration");
 	}
 	factories.push(CONFIG_TEMPLATES.factories.probe);
 	projects.push("probe");
-	const projectRows = `\t\tprojects: [
+	const joinedProjects = `\t\tprojects: [${projects.join(", ")}],`;
+	const projectRows = matchesPrintWidth(joinedProjects) ? joinedProjects : `\t\tprojects: [
 ${projects.map((project) => `\t\t\t${project},`).join("\n")}
 	\t],`;
 	const body = `${factories.join("\n")}\n`;
@@ -3692,15 +3647,14 @@ function blueprintToSourceArtifacts(blueprint) {
 * Compile 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 install proof.
+* @returns Shared setup modules, axis tests, and the optional integration seed.
 *
 * @remarks
 * `tests/setupPolicy.ts`, `tests/policy.test.ts`, and `tests/config.test.ts` are
 * fleet-invariant host artifacts and therefore do not appear here. A guide
 * proof is not emitted while the workspace intentionally has empty barrels and
-* no package guide. The install proof is meaningful only for a published
-* workspace and therefore follows the `src` axis as well as its structural
-* flag.
+* no package guide. The integration seed follows its structural flag and loads
+* every selected environment through its public barrel.
 *
 * The conformance proof is not emitted either, for the reason the guide proof
 * is not: it names an official artifact only the package knows, so a generated
@@ -3768,7 +3722,8 @@ function blueprintToTestArtifacts(blueprint) {
 	});
 	if (blueprint.bin) {
 		const specifier = serializeTypeScriptString("../../../src/bin/main.js");
-		const statement = specifier.length <= 68 ? `\t\tconst entry = await import(${specifier})` : `\t\tconst entry =\n\t\t\tawait import(${specifier})`;
+		const joined = `\t\tconst entry = await import(${specifier})`;
+		const statement = matchesPrintWidth(joined) ? joined : `\t\tconst entry =\n\t\t\tawait import(${specifier})`;
 		artifacts.push({
 			path: "tests/src/bin/main.test.ts",
 			group: "tests",
@@ -3788,13 +3743,35 @@ function blueprintToTestArtifacts(blueprint) {
 			label: serializeTypeScriptString(`app ${environment} entry`)
 		})
 	});
-	if (blueprint.src.length > 0 && blueprint.integration) artifacts.push({
-		path: INTEGRATION_TEST_PATH,
-		group: "tests",
-		ownership: "birth",
-		origin: "template",
-		content: ARTIFACT_TEMPLATES.tests.integration
-	});
+	if (blueprint.integration) {
+		const imports = [];
+		const entries = [];
+		for (const environment of blueprint.src) {
+			const entry = environment === "core" ? "srcCore" : environment === "browser" ? "srcBrowser" : "srcServer";
+			imports.push(`import * as ${entry} from '@src/${environment}'`);
+			entries.push(entry);
+		}
+		for (const environment of blueprint.app) {
+			const entry = environment === "core" ? "appCore" : environment === "browser" ? "appBrowser" : "appServer";
+			imports.push(`import * as ${entry} from '@app/${environment}'`);
+			entries.push(entry);
+		}
+		const joined = `expect([${entries.map((entry) => `Object.keys(${entry})`).join(", ")}]).toStrictEqual(`;
+		const actual = matchesPrintWidth(`\t\t${joined}[`) ? joined : `expect([\n${entries.map((entry) => `\t\t\tObject.keys(${entry}),`).join("\n")}\n\t\t]).toStrictEqual(`;
+		const expectedInline = `[${entries.map(() => "[]").join(", ")}]`;
+		const expected = actual !== joined || matchesPrintWidth(`\t\t${joined}${expectedInline})`) ? expectedInline : `[\n${entries.map(() => "			[],").join("\n")}\n\t\t]`;
+		artifacts.push({
+			path: INTEGRATION_TEST_PATH,
+			group: "tests",
+			ownership: "birth",
+			origin: "template",
+			content: (0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.tests.integration, {
+				imports: `${imports.join("\n")}\n`,
+				actual,
+				expected
+			})
+		});
+	}
 	return artifacts;
 }
 /**
@@ -4165,12 +4142,19 @@ function dependenciesToQuestions(dependencies, field, name, range) {
 *
 * A question blocks when it describes a workspace this package cannot generate.
 * Three do not, because each describes a workspace it can describe honestly and
-* should not create: a published axis of several environments without core, whose
-* manifest names a core build the workspace never runs, and a structural flag
-* whose required axis is absent, which emits nothing. Blocking those closed the
-* gate for every verb, and the verbs that read an existing workspace need the
-* plan the gate refused. The caller that chooses the shape refuses the advisory;
-* the callers that read one report it.
+* should not create: a published axis of several environments without core,
+* whose manifest names a core build the workspace never runs; a showcase flag
+* whose required browser axis is absent, which emits nothing; and an
+* integration flag over fewer than two environments, whose seed does emit and
+* has nothing to compose across. Blocking any of them closed the gate for every
+* verb. The verbs that read an existing workspace need the plan the gate
+* refused. The caller that chooses the shape refuses the advisory; the callers
+* that read one report it.
+*
+* The integration advisory counts both axes together, because the proof it
+* seeds spans environments rather than published ones: an application of two
+* environments composes, and a package publishing one does not. Reading either
+* axis alone withdrew the proof from a workspace that does compose.
 *
 * An environment question carries `ENVIRONMENTS` as its candidates, so a caller
 * reads the accepted values from the question instead of from the documentation.
@@ -4227,9 +4211,9 @@ function blueprintToQuestions(blueprint) {
 			candidates: ENVIRONMENTS
 		});
 	}
-	if (blueprint.integration && blueprint.src.length === 0) questions.push({
+	if (blueprint.integration && blueprint.src.length + blueprint.app.length < 2) questions.push({
 		field: "integration",
-		message: "integration projects a published src, and this workspace declares none, so it emits nothing.",
+		message: "integration drives features across environments, and this workspace declares fewer than two, so its seed composes nothing.",
 		blocking: false
 	});
 	const vendors = /* @__PURE__ */ new Set();
@@ -4246,6 +4230,11 @@ function blueprintToQuestions(blueprint) {
 		});
 		vendors.add(vendor);
 	}
+	if (blueprint.distribution && blueprint.src.length === 0) questions.push({
+		field: "distribution",
+		message: "distribution packs the published source, and this workspace declares none, so it emits nothing.",
+		blocking: false
+	});
 	if (blueprint.showcase && !blueprint.app.includes("browser")) questions.push({
 		field: "showcase",
 		message: "showcase projects a browser app, and this workspace declares none, so it emits nothing.",
@@ -4753,6 +4742,8 @@ function createBlueprint(name, input) {
 		engines: input?.engines ?? DEFAULT_ENGINES,
 		overrides: input?.overrides ?? [],
 		bin: input?.bin ?? false,
+		guides: input?.guides ?? false,
+		distribution: input?.distribution ?? false,
 		integration: input?.integration ?? false,
 		conformance: input?.conformance ?? false,
 		service: input?.service ?? false,
@@ -4796,9 +4787,11 @@ exports.CONFIG_TEMPLATES = CONFIG_TEMPLATES;
 exports.CONFORMANCE_TEST_PATH = CONFORMANCE_TEST_PATH;
 exports.CONTROL_CHARACTER_PATTERN = CONTROL_CHARACTER_PATTERN;
 exports.Compiler = Compiler;
+exports.DECLARATION_DEV_DEPENDENCIES = DECLARATION_DEV_DEPENDENCIES;
 exports.DEFAULT_ENGINES = DEFAULT_ENGINES;
 exports.DEFAULT_VERSION = DEFAULT_VERSION;
 exports.DEPENDENCY_NAME_PATTERN = DEPENDENCY_NAME_PATTERN;
+exports.DISTRIBUTION_TEST_PATH = DISTRIBUTION_TEST_PATH;
 exports.ENGINES_PATTERN = ENGINES_PATTERN;
 exports.ENVIRONMENTS = ENVIRONMENTS;
 exports.EXECUTABLE_PATHS = EXECUTABLE_PATHS;
@@ -4826,6 +4819,7 @@ exports.NAME_PATTERN = NAME_PATTERN;
 exports.ORCHESTRATION_PATH_NAMES = ORCHESTRATION_PATH_NAMES;
 exports.ORCHESTRATION_PATH_PREFIXES = ORCHESTRATION_PATH_PREFIXES;
 exports.ORKESTREL_RANGE_PATTERN = ORKESTREL_RANGE_PATTERN;
+exports.PRINT_WIDTH = PRINT_WIDTH;
 exports.SERVICE_SCRIPT_PATH = SERVICE_SCRIPT_PATH;
 exports.SERVICE_SETUP_PATH = SERVICE_SETUP_PATH;
 exports.SERVICE_TEST_INCLUDE = SERVICE_TEST_INCLUDE;
@@ -4834,7 +4828,9 @@ exports.SHOWCASE_DEV_DEPENDENCIES = SHOWCASE_DEV_DEPENDENCIES;
 exports.SOURCE_BROWSER_DEV_DEPENDENCIES = SOURCE_BROWSER_DEV_DEPENDENCIES;
 exports.SRC_MATRIX = SRC_MATRIX;
 exports.ScaffoldError = ScaffoldError;
+exports.TAB_WIDTH = TAB_WIDTH;
 exports.VERSION_PATTERN = VERSION_PATTERN;
+exports.WORKSPACE_OWNED_PATHS = WORKSPACE_OWNED_PATHS;
 exports.applyOverrides = applyOverrides;
 exports.artifactToFinding = artifactToFinding;
 exports.artifactToHex = artifactToHex;
@@ -4892,6 +4888,7 @@ exports.manifestToName = manifestToName;
 exports.matchesDriftReachability = matchesDriftReachability;
 exports.matchesEngines = matchesEngines;
 exports.matchesOrchestrationPath = matchesOrchestrationPath;
+exports.matchesPrintWidth = matchesPrintWidth;
 exports.matchesRange = matchesRange;
 exports.nameToGuide = nameToGuide;
 exports.nameToHostArtifacts = nameToHostArtifacts;