@orkestrel/scaffold 0.0.12 → 0.0.14

package/dist/host/claude/agents/orkestrel.md

@@ -29,44 +29,47 @@ descriptions never enter agent instruction context.
 
 | Package               | Version |
 | --------------------- | ------- |
-| @orkestrel/abort      | 0.0.3   |
-| @orkestrel/agent      | 0.0.8   |
-| @orkestrel/browser    | 0.0.3   |
-| @orkestrel/budget     | 0.0.3   |
-| @orkestrel/console    | 0.0.3   |
-| @orkestrel/contract   | 0.0.5   |
-| @orkestrel/csv        | 0.0.1   |
-| @orkestrel/database   | 0.0.5   |
-| @orkestrel/emitter    | 0.0.3   |
-| @orkestrel/guide      | 0.0.5   |
-| @orkestrel/indexeddb  | 0.0.4   |
-| @orkestrel/interpret  | 0.0.5   |
-| @orkestrel/markdown   | 0.0.5   |
-| @orkestrel/mcp        | 0.0.4   |
-| @orkestrel/middleware | 0.0.5   |
-| @orkestrel/msg        | 0.0.4   |
-| @orkestrel/ndjson     | 0.0.3   |
-| @orkestrel/ollama     | 0.0.6   |
-| @orkestrel/pool       | 0.0.3   |
-| @orkestrel/program    | 0.0.3   |
-| @orkestrel/qualifier  | 0.0.4   |
-| @orkestrel/queue      | 0.0.3   |
-| @orkestrel/rater      | 0.0.5   |
-| @orkestrel/reason     | 0.0.3   |
-| @orkestrel/relation   | 0.0.3   |
-| @orkestrel/router     | 0.0.4   |
-| @orkestrel/scaffold   | 0.0.1   |
-| @orkestrel/sea        | 0.0.3   |
-| @orkestrel/server     | 0.0.6   |
-| @orkestrel/sqlite     | 0.0.4   |
-| @orkestrel/sse        | 0.0.3   |
-| @orkestrel/template   | 0.0.1   |
-| @orkestrel/terminal   | 0.0.4   |
-| @orkestrel/timeout    | 0.0.3   |
-| @orkestrel/tool       | 0.0.3   |
-| @orkestrel/websocket  | 0.0.3   |
-| @orkestrel/worker     | 0.0.3   |
-| @orkestrel/workflow   | 0.0.6   |
+| @orkestrel/abort      | 0.0.4   |
+| @orkestrel/agent      | 0.0.11  |
+| @orkestrel/browser    | 0.0.8   |
+| @orkestrel/budget     | 0.0.4   |
+| @orkestrel/console    | 0.0.4   |
+| @orkestrel/contract   | 0.0.9   |
+| @orkestrel/csv        | 0.0.2   |
+| @orkestrel/database   | 0.0.6   |
+| @orkestrel/emitter    | 0.0.5   |
+| @orkestrel/guide      | 0.0.8   |
+| @orkestrel/html       | 0.0.1   |
+| @orkestrel/indexeddb  | 0.0.6   |
+| @orkestrel/interpret  | 0.0.7   |
+| @orkestrel/markdown   | 0.0.7   |
+| @orkestrel/mcp        | 0.0.7   |
+| @orkestrel/middleware | 0.0.6   |
+| @orkestrel/msg        | 0.0.5   |
+| @orkestrel/ndjson     | 0.0.5   |
+| @orkestrel/ollama     | 0.0.7   |
+| @orkestrel/pool       | 0.0.4   |
+| @orkestrel/program    | 0.0.6   |
+| @orkestrel/qualifier  | 0.0.7   |
+| @orkestrel/queue      | 0.0.4   |
+| @orkestrel/rater      | 0.0.8   |
+| @orkestrel/reason     | 0.0.4   |
+| @orkestrel/relation   | 0.0.6   |
+| @orkestrel/router     | 0.0.6   |
+| @orkestrel/scaffold   | 0.0.13  |
+| @orkestrel/sea        | 0.0.4   |
+| @orkestrel/server     | 0.0.7   |
+| @orkestrel/sqlite     | 0.0.6   |
+| @orkestrel/sse        | 0.0.4   |
+| @orkestrel/template   | 0.0.2   |
+| @orkestrel/terminal   | 0.0.5   |
+| @orkestrel/timeout    | 0.0.4   |
+| @orkestrel/tool       | 0.0.7   |
+| @orkestrel/toolbox    | 0.0.1   |
+| @orkestrel/websocket  | 0.0.7   |
+| @orkestrel/worker     | 0.0.4   |
+| @orkestrel/workflow   | 0.0.7   |
+| @orkestrel/workspace  | 0.0.1   |
 
 <!-- catalog:end -->
 

package/dist/host/guides/src/scaffold.md

@@ -1098,7 +1098,7 @@ along the three `ViteMachinery` axes:
 | Machinery                                                         | Emitted when                         |
 | ----------------------------------------------------------------- | ------------------------------------ |
 | CSS pipeline (`ENVIRONMENT_CSS`, `preprocessCSS`, `isCSSRequest`) | a `src` or `app` browser environment |
-| Playwright provider and `hasChromium`                             | a `src` or `app` browser environment |
+| Playwright provider and `resolveChromium`                         | a `src` or `app` browser environment |
 | Vue plugin, HTML boundary, browser development server             | an `app` browser environment         |
 | Output containment (`outputBoundary`, `enforceOutputPath`)        | anything the workspace builds        |
 

package/dist/src/core/index.cjs

@@ -227,7 +227,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.12";
+var SCAFFOLD_RANGE = "^0.0.14";
 /** Tooling versions shared by scaffold and every generated workspace. */
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
@@ -5876,7 +5876,7 @@ ${renderedProjects}
 ${fitsPrintWidth(inlineRegistrations) ? inlineRegistrations : `		[
 ${renderedRegistrations.map((registration) => `			${registration},`).join("\n")}
 		],`}
-		hasChromium,
+		chromiumPath !== undefined,
 		process.argv,
 	),`;
 }
@@ -7253,11 +7253,66 @@ import {
 	fstatSync,
 	lstatSync,
 	openSync,
-	readSync,
+${needsBrowser ? "	readdirSync,\n" : ""}	readSync,
 	realpathSync,
-} from 'node:fs'
-import { dirname, isAbsolute, relative, resolve as resolvePath, sep } from 'node:path'
-${playwrightImports}${vueImports}${needsBrowser ? `\n${CONST_KEYWORD} hasChromium = existsSync(chromium.executablePath())\n` : ""}
+${needsBrowser ? "	statSync,\n" : ""}} from 'node:fs'
+import { ${needsBrowser ? "basename, " : ""}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. */
+${EXPORT_KEYWORD} ${CONST_KEYWORD} CHROMIUM_LAYOUTS = Object.freeze([
+	'chrome-linux/chrome',
+	'chrome-linux64/chrome',
+	'chrome-win/chrome.exe',
+	'chrome-win64/chrome.exe',
+	'chrome-mac/Chromium.app/Contents/MacOS/Chromium',
+	'chrome-mac-arm64/Chromium.app/Contents/MacOS/Chromium',
+])
+
+/**
+ * Resolve a launchable Chromium executable: the pinned revision when installed,
+ * otherwise a \`chromium\` / \`chromium.exe\` alias or any other \`chromium-*\`
+ * revision under the same Playwright browsers directory. A pinned-revision miss
+ * is not Chromium absence — managed containers ship one usable build (often
+ * behind a revision-agnostic alias) for many Playwright versions.
+ */
+${EXPORT_KEYWORD} function resolveChromium(pinned: string): string | undefined {
+	if (existsSync(pinned)) return pinned
+	let revisionRoot = dirname(pinned)
+	for (;;) {
+		if (/^chromium-\\d+$/.test(basename(revisionRoot))) break
+		const parent = dirname(revisionRoot)
+		if (parent === revisionRoot) return undefined
+		revisionRoot = parent
+	}
+	const browsersRoot = dirname(revisionRoot)
+	for (const alias of ['chromium', 'chromium.exe']) {
+		const candidate = resolvePath(browsersRoot, alias)
+		if (existsSync(candidate) && statSync(candidate).isFile()) return candidate
+	}
+	let entries: readonly string[]
+	try {
+		entries = readdirSync(browsersRoot)
+	} catch {
+		return undefined
+	}
+	const revisions = entries
+		.filter((entry) => /^chromium-\\d+$/.test(entry))
+		.sort((a, b) => Number(b.slice('chromium-'.length)) - Number(a.slice('chromium-'.length)))
+	for (const revision of revisions) {
+		for (const layout of CHROMIUM_LAYOUTS) {
+			const candidate = resolvePath(browsersRoot, revision, layout)
+			if (existsSync(candidate)) return candidate
+		}
+	}
+	return undefined
+}
+
+${CONST_KEYWORD} chromiumPinned = chromium.executablePath()
+${CONST_KEYWORD} chromiumPath = resolveChromium(chromiumPinned)
+${CONST_KEYWORD} chromiumOptions =
+	chromiumPath === undefined || chromiumPath === chromiumPinned
+		? {}
+		: { launchOptions: { executablePath: chromiumPath } }
+` : ""}
 ${EXPORT_KEYWORD} function resolveWorkspacePath(relativePath: string): string {
 	return fileURLToPath(new URL(relativePath, import.meta.url))
 }
@@ -7597,7 +7652,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 						}),
 				browser: {
 					enabled: true,
-					provider: playwright(),
+					provider: playwright(chromiumOptions),
 					instances: [{ browser: 'chromium', headless: true }],
 				},
 				fileParallelism: false,
@@ -7730,7 +7785,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 							}),
 					browser: {
 						enabled: true,
-						provider: playwright(),
+						provider: playwright(chromiumOptions),
 						instances: [{ browser: 'chromium', headless: true }],
 					},
 					fileParallelism: false,
@@ -7896,7 +7951,7 @@ ${EXPORT_KEYWORD} const srcBrowser = (config?: UserConfig): UserConfig =>
 						}),
 				browser: {
 					enabled: true,
-					provider: playwright(),
+					provider: playwright(chromiumOptions),
 					instances: [{ browser: 'chromium', headless: true }],
 				},
 				fileParallelism: false,
@@ -8025,7 +8080,7 @@ ${EXPORT_KEYWORD} function appBrowser(...config: readonly never[]): UserConfig {
 			},
 			browser: {
 				enabled: true,
-				provider: playwright(),
+				provider: playwright(chromiumOptions),
 				instances: [{ browser: 'chromium', headless: true }],
 			},
 			fileParallelism: false,
@@ -8598,8 +8653,8 @@ ${EXPORT_KEYWORD} ${FUNCTION_KEYWORD} exportsFor(specifier: string): readonly st
 function testArtifacts(spec, pascal) {
 	const hasBrowser = spec.src.includes("browser") || spec.app.includes("browser");
 	const hasVue = spec.app.includes("browser");
-	const browserPolicySpecifier = hasBrowser ? ", existsSync" : "";
-	const browserPolicyImport = hasBrowser ? "import { chromium } from 'playwright'" : "";
+	const browserPolicySpecifier = hasBrowser ? ", accessSync, constants as FS_CONSTANTS, statSync" : "";
+	const browserPolicyImport = hasBrowser ? "import { chromium } from 'playwright'\nimport { resolveChromium } from '../vite.config.js'" : "";
 	const vuePolicyImport = hasVue ? "import { parse as parseVue } from 'vue/compiler-sfc'" : "";
 	const workspacePolicyAssertion = hasVue ? `expect(
 			inspectCodingWorkspace(process.cwd(), (path, content) => {
@@ -8611,12 +8666,13 @@ function testArtifacts(spec, pascal) {
 			}),
 		).toEqual([])` : "expect(inspectCodingWorkspace(process.cwd())).toEqual([])";
 	const browserPolicyTest = hasBrowser ? `
-	it.skipIf(!existsSync(chromium.executablePath()))(
-		'runs browser suites only when the real Chromium executable is installed',
-		() => {
-			expect(existsSync(chromium.executablePath())).toBe(true)
-		},
-	)` : "";
+	it('resolves Chromium only to a real executable file', () => {
+		const chromiumPath = resolveChromium(chromium.executablePath())
+		if (chromiumPath === undefined) return
+
+		expect(statSync(chromiumPath).isFile()).toBe(true)
+		expect(() => accessSync(chromiumPath, FS_CONSTANTS.X_OK)).not.toThrow()
+	})` : "";
 	const artifacts = [fillArtifact("tests/setup.ts", "tests", "setup", {}), fillArtifact("tests/policy.test.ts", "tests", "policyTest", {
 		browserPolicySpecifier,
 		browserPolicyImport,