@orkestrel/scaffold 0.0.18 → 0.0.19

package/dist/host/manifest.json

@@ -1,5 +1,35 @@
 {
 	"entries": [
+		{
+			"storage": "agents/skills/enterprise-bootstrap/SKILL.md",
+			"destination": ".agents/skills/enterprise-bootstrap/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/agents/openai.yaml",
+			"destination": ".agents/skills/enterprise-bootstrap/agents/openai.yaml",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/bootstrap-reference.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/bootstrap-reference.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/components.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/components.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/frontend-design.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/frontend-design.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/enterprise-bootstrap/references/utilities.md",
+			"destination": ".agents/skills/enterprise-bootstrap/references/utilities.md",
+			"executable": false
+		},
 		{
 			"storage": "agents/skills/orkestrel-align-packages/SKILL.md",
 			"destination": ".agents/skills/orkestrel-align-packages/SKILL.md",
@@ -31,8 +61,18 @@
 			"executable": false
 		},
 		{
-			"storage": "agents/skills/orkestrel-build-application/references/application.md",
-			"destination": ".agents/skills/orkestrel-build-application/references/application.md",
+			"storage": "agents/skills/orkestrel-debrief/SKILL.md",
+			"destination": ".agents/skills/orkestrel-debrief/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-debrief/agents/openai.yaml",
+			"destination": ".agents/skills/orkestrel-debrief/agents/openai.yaml",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-debrief/references/field-testing.md",
+			"destination": ".agents/skills/orkestrel-debrief/references/field-testing.md",
 			"executable": false
 		},
 		{
@@ -66,8 +106,18 @@
 			"executable": false
 		},
 		{
-			"storage": "claude/agents/application.md",
-			"destination": ".claude/agents/application.md",
+			"storage": "agents/skills/orkestrel-polish-surface/SKILL.md",
+			"destination": ".agents/skills/orkestrel-polish-surface/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-polish-surface/agents/openai.yaml",
+			"destination": ".agents/skills/orkestrel-polish-surface/agents/openai.yaml",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-polish-surface/references/capture-harness.md",
+			"destination": ".agents/skills/orkestrel-polish-surface/references/capture-harness.md",
 			"executable": false
 		},
 		{
@@ -175,6 +225,11 @@
 			"destination": ".claude/settings.json",
 			"executable": false
 		},
+		{
+			"storage": "claude/skills/enterprise-bootstrap/SKILL.md",
+			"destination": ".claude/skills/enterprise-bootstrap/SKILL.md",
+			"executable": false
+		},
 		{
 			"storage": "claude/skills/orkestrel-align-packages/SKILL.md",
 			"destination": ".claude/skills/orkestrel-align-packages/SKILL.md",
@@ -185,19 +240,24 @@
 			"destination": ".claude/skills/orkestrel-build-application/SKILL.md",
 			"executable": false
 		},
+		{
+			"storage": "claude/skills/orkestrel-debrief/SKILL.md",
+			"destination": ".claude/skills/orkestrel-debrief/SKILL.md",
+			"executable": false
+		},
 		{
 			"storage": "claude/skills/orkestrel-harden-package/SKILL.md",
 			"destination": ".claude/skills/orkestrel-harden-package/SKILL.md",
 			"executable": false
 		},
 		{
-			"storage": "codex/agents/analyst.toml",
-			"destination": ".codex/agents/analyst.toml",
+			"storage": "claude/skills/orkestrel-polish-surface/SKILL.md",
+			"destination": ".claude/skills/orkestrel-polish-surface/SKILL.md",
 			"executable": false
 		},
 		{
-			"storage": "codex/agents/application.toml",
-			"destination": ".codex/agents/application.toml",
+			"storage": "codex/agents/analyst.toml",
+			"destination": ".codex/agents/analyst.toml",
 			"executable": false
 		},
 		{
@@ -349,22 +409,33 @@
 	"roots": [
 		".agents",
 		".agents/skills",
+		".agents/skills/enterprise-bootstrap",
+		".agents/skills/enterprise-bootstrap/agents",
+		".agents/skills/enterprise-bootstrap/references",
 		".agents/skills/orkestrel-align-packages",
 		".agents/skills/orkestrel-align-packages/agents",
 		".agents/skills/orkestrel-align-packages/references",
 		".agents/skills/orkestrel-build-application",
 		".agents/skills/orkestrel-build-application/agents",
-		".agents/skills/orkestrel-build-application/references",
+		".agents/skills/orkestrel-debrief",
+		".agents/skills/orkestrel-debrief/agents",
+		".agents/skills/orkestrel-debrief/references",
 		".agents/skills/orkestrel-harden-package",
 		".agents/skills/orkestrel-harden-package/agents",
 		".agents/skills/orkestrel-harden-package/references",
+		".agents/skills/orkestrel-polish-surface",
+		".agents/skills/orkestrel-polish-surface/agents",
+		".agents/skills/orkestrel-polish-surface/references",
 		".claude",
 		".claude/agents",
 		".claude/rules",
 		".claude/skills",
+		".claude/skills/enterprise-bootstrap",
 		".claude/skills/orkestrel-align-packages",
 		".claude/skills/orkestrel-build-application",
+		".claude/skills/orkestrel-debrief",
 		".claude/skills/orkestrel-harden-package",
+		".claude/skills/orkestrel-polish-surface",
 		".codex",
 		".codex/agents",
 		".cursor",

package/dist/src/core/index.cjs

@@ -145,6 +145,8 @@ var HOST_PATHS = Object.freeze([
 var SERVICE_SCRIPT_PATH = "scripts/service.sh";
 /** The consumer-owned Vitest global-setup module shared by its independently selected projects. */
 var GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
+/** The consumer-owned Vite wrapper whose physical presence enables the optional app showcase. */
+var SHOWCASE_CONFIG_PATH = "configs/app/vite.showcase.config.ts";
 /** The package-name RegExp — lowercase alphanumeric-with-hyphens, letter-first. */
 var NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
 /** Maximum bare workspace name length beneath the generated `@orkestrel/` scope. */
@@ -227,7 +229,7 @@ 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.18";
+var SCAFFOLD_RANGE = "^0.0.19";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
@@ -427,7 +429,7 @@ function member(name, category, summary, environment = "core") {
 * `version` / `engines` default `DEFAULT_VERSION` / `DEFAULT_ENGINES`,
 * `src` defaults `['core']`, and `app` / `keywords` / `dependencies` /
 * `peers` / `extras` / `overrides` default `[]`, and `bin` / `integration` /
-* `service` / `global` default `false`. `description` is OMITTED entirely
+* `service` / `global` / `showcase` default `false`. `description` is OMITTED entirely
 * when absent, so the result round-trips the exact-record `Blueprint` guard.
 * @returns A complete `Blueprint`.
 *
@@ -453,7 +455,8 @@ function blueprint(name, options) {
 		bin: options?.bin ?? false,
 		integration: options?.integration ?? false,
 		service: options?.service ?? false,
-		global: options?.global ?? false
+		global: options?.global ?? false,
+		showcase: options?.showcase ?? false
 	};
 	return options?.description === void 0 ? base : {
 		...base,
@@ -1361,6 +1364,11 @@ function validateBlueprint(spec) {
 		text: "At least one src or app environment is required",
 		blocking: true
 	});
+	if (spec.showcase && !spec.app.includes("browser")) questions.push({
+		field: "showcase",
+		text: "Showcase requires the app browser environment",
+		blocking: true
+	});
 	if (spec.src.length > 0) {
 		for (const environment of spec.src) if (!ENVIRONMENTS.includes(environment)) questions.push({
 			field: "src",
@@ -1824,7 +1832,8 @@ function blueprintShape() {
 		bin: (0, _orkestrel_contract.booleanShape)(),
 		integration: (0, _orkestrel_contract.booleanShape)(),
 		service: (0, _orkestrel_contract.booleanShape)(),
-		global: (0, _orkestrel_contract.booleanShape)()
+		global: (0, _orkestrel_contract.booleanShape)(),
+		showcase: (0, _orkestrel_contract.booleanShape)()
 	});
 }
 /**
@@ -5561,6 +5570,7 @@ function devDependenciesFor(spec) {
 		...dependencies,
 		...spec.src.includes("browser") ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
 		...spec.app.includes("browser") ? APP_BROWSER_DEV_DEPENDENCIES : {},
+		...spec.showcase ? { "vite-plugin-singlefile": "^2.3.3" } : {},
 		...spec.bin ? { "@vitest/browser-playwright": SOURCE_BROWSER_DEV_DEPENDENCIES["@vitest/browser-playwright"] } : {}
 	};
 }
@@ -5644,7 +5654,14 @@ function packageManifest(spec) {
 		const runtime = spec.app.filter((environment) => environment !== "core");
 		scripts["build:app"] = runtime.length > 0 ? runtime.map((environment) => `npm run build:app:${environment}`).join(" && ") : "npm run check:app:core";
 		for (const environment of runtime) scripts[`build:app:${environment}`] = `vite build --config configs/app/vite.${environment}.config.ts`;
-		if (spec.app.includes("browser")) scripts.dev = "vite --config configs/app/vite.browser.config.ts";
+		if (spec.app.includes("browser")) {
+			scripts.dev = "vite --config configs/app/vite.browser.config.ts";
+			if (spec.showcase) {
+				scripts.showcase = `vite --config ${SHOWCASE_CONFIG_PATH}`;
+				scripts["build:showcase"] = `vite build --config ${SHOWCASE_CONFIG_PATH}`;
+				scripts.show = "npm run build:showcase && npm run copy dist/showcase/index.html demo/showcase.html";
+			}
+		}
 		if (spec.app.includes("server")) {
 			scripts.serve = "node dist/app/server/main.cjs";
 			scripts["serve:build"] = "npm run build:app:server && npm run serve";
@@ -5762,20 +5779,22 @@ function rootTsconfig(src, app = []) {
 * @param src - The declared published `Environment[]`.
 * @param app - The declared application `Environment[]`, defaulting to none.
 * @param bin - Whether the workspace also builds its own executable.
+* @param showcase - Whether the workspace carries its optional app showcase.
 * @returns The machinery set the generated header renders.
 *
 * @example
 * ```ts
-* viteMachinery(['core']) // { browser: false, vue: false, output: true }
-* viteMachinery([], ['core']) // { browser: false, vue: false, output: false }
+* viteMachinery(['core']) // { browser: false, vue: false, output: true, showcase: false }
+* viteMachinery([], ['core']) // { browser: false, vue: false, output: false, showcase: false }
 * ```
 */
-function viteMachinery(src, app = [], bin = false) {
+function viteMachinery(src, app = [], bin = false, showcase = false) {
 	const unbuilt = src.length === 0 && app.length > 0 && !bin && app.every((environment) => environment === "core");
 	return {
 		browser: src.includes("browser") || app.includes("browser"),
 		vue: app.includes("browser"),
-		output: !unbuilt
+		output: !unbuilt,
+		showcase: showcase && app.includes("browser")
 	};
 }
 /**
@@ -5889,7 +5908,7 @@ ${renderedRegistrations.map((registration) => `			${registration},`).join("\n")}
 * ```
 */
 function viteHeader(machinery) {
-	const { browser: needsBrowser, vue: needsVue, output: needsOutput } = machinery;
+	const { browser: needsBrowser, vue: needsVue, output: needsOutput, showcase: needsShowcase } = machinery;
 	const playwrightTypeImports = needsBrowser ? `import type { PlaywrightProviderOptions } from '@vitest/browser-playwright'
 ` : "";
 	const playwrightImports = needsBrowser ? `import { playwright } from '@vitest/browser-playwright'
@@ -5897,6 +5916,8 @@ import { chromium } from 'playwright'
 ` : "";
 	const vueImports = needsVue ? `import vue from '@vitejs/plugin-vue'
 import { parse as parseVue } from 'vue/compiler-sfc'
+` : "";
+	const showcaseImports = needsShowcase ? `import { viteSingleFile } from 'vite-plugin-singlefile'
 ` : "";
 	const viteTypeImports = needsVue ? `import type {
 	CSSOptions,
@@ -6956,6 +6977,31 @@ ${EXPORT_KEYWORD} function finalizeHtml(): Plugin {
 	}
 }
 
+` : ""}${needsShowcase ? `${EXPORT_KEYWORD} ${CONST_KEYWORD} SHOWCASE_SECURITY_POLICY =
+	"base-uri 'none'; object-src 'none'; script-src 'self' 'unsafe-inline'; script-src-attr 'none'; style-src 'self' 'unsafe-inline'"
+
+${EXPORT_KEYWORD} function showcaseHtml(): Plugin {
+	return {
+		name: 'orkestrel-showcase-html',
+		enforce: 'post',
+		transformIndexHtml: {
+			order: 'post',
+			handler(html, context) {
+				if (!isBrowserHtmlEntry(context.filename)) return undefined
+				if (!html.includes(HTML_SECURITY_META)) {
+					throw new Error('[orkestrel-showcase] Browser HTML must retain its security policy')
+				}
+				const stamp = new Date().toISOString()
+				return html.replace(
+					HTML_SECURITY_META,
+					HTML_SECURITY_META.replace(HTML_SECURITY_POLICY, SHOWCASE_SECURITY_POLICY) +
+						\`\\n\\t\\t<meta name="build-id" content="\${stamp}" />\`,
+				)
+			},
+		},
+	}
+}
+
 ` : ""}${EXPORT_KEYWORD} async function environmentAssetSources(
 	code: string,
 	id: string,
@@ -7267,7 +7313,7 @@ ${needsBrowser ? `import {
 	resolve as resolvePath,
 	sep,
 } from 'node:path'` : `import { dirname, isAbsolute, relative, resolve as resolvePath, sep } from 'node:path'`}
-${playwrightImports}${vueImports}${needsBrowser ? `\n/** Chromium executable layouts inside a \`chromium-<revision>\` browsers-directory entry, per platform. */
+${playwrightImports}${vueImports}${showcaseImports}${needsBrowser ? `\n/** Chromium executable layouts inside a \`chromium-<revision>\` browsers-directory entry, per platform. */
 ${EXPORT_KEYWORD} ${CONST_KEYWORD} CHROMIUM_LAYOUTS = Object.freeze([
 	'chrome-linux/chrome',
 	'chrome-linux64/chrome',
@@ -8016,7 +8062,7 @@ ${renderedTest}
 */
 function applicationViteConfig(src, app, facts = {}) {
 	const hasSourceCore = src.includes("core");
-	const machinery = viteMachinery(src, app, facts.bin === true);
+	const machinery = viteMachinery(src, app, facts.bin === true, facts.showcase === true);
 	const header = viteHeader(machinery);
 	const blocks = [];
 	if (src.includes("core")) blocks.push(`
@@ -8161,8 +8207,98 @@ ${EXPORT_KEYWORD} const appCore = (config?: UserConfig): UserConfig =>
 		config ?? {},
 	)
 `);
-	if (app.includes("browser")) blocks.push(`
-${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
+	if (app.includes("browser")) blocks.push(facts.showcase === true ? `
+${FUNCTION_KEYWORD} applicationBrowser(showcase: boolean): UserConfig {
+	const output = showcase ? 'dist/showcase' : 'dist/app/browser'
+	return {
+		resolve,
+		css: ENVIRONMENT_CSS,
+		html: environmentHtml(),
+		plugins: [
+			restoreHtml(),
+			outputBoundary(output),
+			environmentBoundary('app/browser'),
+			vue(),
+			prepareHtml(),
+			finalizeHtml(),
+			...(showcase
+				? [
+						viteSingleFile({
+							removeViteModuleLoader: true,
+							useRecommendedBuildConfig: true,
+						}),
+						showcaseHtml(),
+					]
+				: []),
+		],
+		root: resolveWorkspacePath('app/browser'),
+		publicDir: false,
+		server: {
+			fs: {
+				strict: true,
+				allow: [...browserServerRoots()],
+			},
+		},
+		build: {
+			...(showcase
+				? {
+						cssMinify: 'lightningcss',
+						minify: 'oxc',
+						modulePreload: false,
+						reportCompressedSize: false,
+						sourcemap: false,
+						target: 'esnext',
+					}
+				: { assetsInlineLimit: 0 }),
+			emptyOutDir: true,
+			outDir: resolveWorkspacePath(output),
+			rolldownOptions: {
+				input: resolveWorkspacePath('${APP_MATRIX.browser.entry}'),
+			},
+		},
+		test: {
+			name: { label: '${APP_MATRIX.browser.project}', color: 'blue' },
+			root: resolveWorkspacePath('.'),
+			dir: resolveWorkspacePath('.'),
+			include: ['tests/app/browser/**/*.test.ts'],
+			setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
+			deps: {
+				optimizer: {
+					client: {
+						enabled: true,
+						include: ['vue', ...BROWSER_TEST_DEPENDENCIES],
+					},
+				},
+			},
+			browser: {
+				enabled: true,
+				provider: playwright(browserOptions),
+				instances: [{ browser: 'chromium', headless: true }],
+			},
+			fileParallelism: false,
+		},
+	}
+}
+
+${EXPORT_KEYWORD} function appBrowser(...config: never[]): UserConfig {
+	if (config.length > 0) {
+		throw new Error(
+			'[orkestrel-environment-boundary] Browser configuration overrides are not permitted by the generated boundary',
+		)
+	}
+	return applicationBrowser(false)
+}
+
+${EXPORT_KEYWORD} function appShowcase(...config: never[]): UserConfig {
+	if (config.length > 0) {
+		throw new Error(
+			'[orkestrel-environment-boundary] Showcase configuration overrides are not permitted by the generated boundary',
+		)
+	}
+	return applicationBrowser(true)
+}
+` : `
+${EXPORT_KEYWORD} function appBrowser(...config: never[]): UserConfig {
 	if (config.length > 0) {
 		throw new Error(
 			'[orkestrel-environment-boundary] Browser configuration overrides are not permitted by the generated boundary',
@@ -8642,6 +8778,17 @@ function configArtifacts(spec) {
 			});
 		}
 	}
+	if (spec.showcase) artifacts.push({
+		path: SHOWCASE_CONFIG_PATH,
+		group: "configs",
+		origin: "computed",
+		environment: "browser",
+		content: `import { defineConfig } from 'vite'
+import { appShowcase } from '../../vite.config.ts'
+
+export default defineConfig(appShowcase())
+`
+	});
 	return artifacts;
 }
 /**
@@ -9825,6 +9972,7 @@ exports.PlanManager = PlanManager;
 exports.SCAFFOLD_RANGE = SCAFFOLD_RANGE;
 exports.SERVICE_SCRIPT_PATH = SERVICE_SCRIPT_PATH;
 exports.SETUP_NODE_ACTION_SHA = SETUP_NODE_ACTION_SHA;
+exports.SHOWCASE_CONFIG_PATH = SHOWCASE_CONFIG_PATH;
 exports.SOURCE_BROWSER_DEV_DEPENDENCIES = SOURCE_BROWSER_DEV_DEPENDENCIES;
 exports.SRC_MATRIX = SRC_MATRIX;
 exports.SYNC_BASELINE_PATTERN = SYNC_BASELINE_PATTERN;