@orkestrel/scaffold 0.0.31 → 0.0.32

package/dist/src/core/index.js

@@ -139,6 +139,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
@@ -196,9 +206,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";
@@ -269,6 +281,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. */
@@ -287,17 +303,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.31",
+	"@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",
@@ -385,38 +405,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
@@ -552,6 +546,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 ?? {},
@@ -603,8 +601,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}}`,
@@ -720,6 +717,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 =>
@@ -746,9 +760,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 ?? {},
@@ -1376,112 +1387,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,
-	)
 })
 `
 	}),
@@ -1802,6 +1715,8 @@ var isBlueprint = recordOf({
 	engines: isString,
 	overrides: andOf(isCollection, arrayOf(isOverride)),
 	bin: isBoolean,
+	guides: isBoolean,
+	distribution: isBoolean,
 	integration: isBoolean,
 	conformance: isBoolean,
 	service: isBoolean,
@@ -2397,6 +2312,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.
@@ -2428,7 +2367,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},`,
@@ -3058,6 +2997,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 : {},
@@ -3083,12 +3023,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
@@ -3105,7 +3046,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";
@@ -3136,7 +3078,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"] = [
@@ -3153,8 +3098,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 = [
@@ -3186,9 +3133,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;
@@ -3359,6 +3306,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'");
@@ -3450,8 +3399,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)
 }
 ` : "";
@@ -3471,8 +3419,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");
@@ -3481,13 +3431,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(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`;
@@ -3691,15 +3646,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
@@ -3767,7 +3721,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",
@@ -3787,13 +3742,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: fillTemplate(ARTIFACT_TEMPLATES.tests.integration, {
+				imports: `${imports.join("\n")}\n`,
+				actual,
+				expected
+			})
+		});
+	}
 	return artifacts;
 }
 /**
@@ -4164,12 +4141,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.
@@ -4226,9 +4210,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();
@@ -4245,6 +4229,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.",
@@ -4752,6 +4741,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,
@@ -4782,6 +4773,6 @@ function createCompiler(options) {
 	return new Compiler(options);
 }
 //#endregion
-export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_NAME_PATTERN, EXTRA_RANGE_PATTERN, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, ScaffoldError, VERSION_PATTERN, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToGuideArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSourceArtifacts, blueprintToTestArtifacts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, createCompiler, dependenciesToQuestions, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDependency, isDependencyName, isEnvironment, isFinding, isGroup, isGroups, isHex, isMirror, isOverride, isPath, isPlan, isQuestion, isScaffoldError, isSnapshot, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesRange, nameToGuide, nameToHostArtifacts, nameToRewrite, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
+export { APP_BROWSER_DEV_DEPENDENCIES, APP_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_TEMPLATES, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, CATALOG_AGENT_PATH, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_NAME_PATTERN, EXTRA_RANGE_PATTERN, GLOBAL_SETUP_PATH, GROUPS, GUIDES_TEST_PATH, HEX_PATTERN, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MINIMUM_NODE_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, ScaffoldError, TAB_WIDTH, VERSION_PATTERN, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToGuideArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToOrchestrationArtifacts, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSourceArtifacts, blueprintToTestArtifacts, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeHash, contentToHex, createBlueprint, createCompiler, dependenciesToQuestions, extractVersion, inferDrift, inferGroup, isArtifact, isAudit, isBlueprint, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDependency, isDependencyName, isEnvironment, isFinding, isGroup, isGroups, isHex, isMirror, isOverride, isPath, isPlan, isQuestion, isScaffoldError, isSnapshot, manifestToDependencies, manifestToName, matchesDriftReachability, matchesEngines, matchesOrchestrationPath, matchesPrintWidth, matchesRange, nameToGuide, nameToHostArtifacts, nameToRewrite, overridesToQuestions, parseBlueprint, parseCompilerOptions, parseGroups, parseSnapshot, pathToCondition, planToFindings, planToHash, planToSummary, selectGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
 
 //# sourceMappingURL=index.js.map