@orkestrel/scaffold 0.0.48 → 0.0.49

package/dist/host/tests/config.test.ts

@@ -15,7 +15,7 @@ import {
 import { createRequire } from 'node:module'
 import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
-import { build, loadConfigFromFile } from 'vite'
+import { build, createServer, loadConfigFromFile } from 'vite'
 import { RuleTester } from 'oxlint/plugins-dev'
 import * as configHelpers from '../configs/helpers.js'
 import { MOCKING_RULE, NESTED_RULE, PRIVACY_RULE } from '../configs/policy.js'
@@ -513,6 +513,108 @@ describe('root configuration', () => {
 		)
 	})
 
+	it('keeps the committed host inventory aligned with the vendored checkout bytes', async () => {
+		// Run this gate against a quiescent checkout. It compares two reads and cannot
+		// distinguish stale committed data from a source edit made while it runs.
+		const packageValue: unknown = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'))
+		if (typeof packageValue !== 'object' || packageValue === null) {
+			throw new Error('The package manifest is not a record')
+		}
+		const scripts: unknown = Object.getOwnPropertyDescriptor(packageValue, 'scripts')?.value
+		if (typeof scripts !== 'object' || scripts === null) {
+			throw new Error('The package manifest carries no scripts')
+		}
+		const generator: unknown = Object.getOwnPropertyDescriptor(scripts, 'build:inventory')?.value
+		expect(generator === undefined || typeof generator === 'string').toBe(true)
+		if (generator === undefined) {
+			if (existsSync(resolve(root, 'host.json'))) {
+				throw new Error('A committed host inventory exists without a generator')
+			}
+			return
+		}
+		if (typeof generator !== 'string') {
+			throw new Error('The host inventory generator is not a script')
+		}
+		const committed = resolve(root, 'host.json')
+		if (!existsSync(committed)) {
+			throw new Error('The committed host inventory is absent at host.json')
+		}
+		const helper = resolve(root, 'src/server/helpers.ts')
+		if (!existsSync(helper)) {
+			throw new Error('The committed host inventory has no server stager')
+		}
+		const server = await createServer({
+			configFile: false,
+			root,
+			...(configuration.resolve === undefined ? {} : { resolve: configuration.resolve }),
+			server: { middlewareMode: true },
+		})
+		try {
+			const loaded: unknown = await server.ssrLoadModule(helper)
+			if (typeof loaded !== 'object' || loaded === null) {
+				throw new Error('The server helper module did not load')
+			}
+			const stage: unknown = Reflect.get(loaded, 'stageInventory')
+			if (typeof stage !== 'function') {
+				throw new Error('The server helper module exports no stageInventory function')
+			}
+			const workspace = mkdtempSync(join(root, 'host-inventory-'))
+			try {
+				const generated = join(workspace, 'host.json')
+				Reflect.apply(stage, undefined, [root, generated])
+				const generatedText = readFileSync(generated, 'utf8')
+				const committedText = readFileSync(committed, 'utf8')
+				const values: readonly unknown[] = [JSON.parse(generatedText), JSON.parse(committedText)]
+				const indexes: Array<Map<string, string>> = []
+				for (const value of values) {
+					if (typeof value !== 'object' || value === null) {
+						throw new Error('A host inventory is not a record')
+					}
+					const entries: unknown = Object.getOwnPropertyDescriptor(value, 'entries')?.value
+					if (!Array.isArray(entries)) throw new Error('A host inventory carries no entry list')
+					const index = new Map<string, string>()
+					for (const entry of entries) {
+						if (typeof entry !== 'object' || entry === null) {
+							throw new Error('A host inventory carries a malformed entry')
+						}
+						const destination: unknown = Object.getOwnPropertyDescriptor(
+							entry,
+							'destination',
+						)?.value
+						const digest: unknown = Object.getOwnPropertyDescriptor(entry, 'digest')?.value
+						if (typeof destination !== 'string' || typeof digest !== 'string') {
+							throw new Error('A host inventory entry carries no destination digest')
+						}
+						index.set(destination, digest)
+					}
+					indexes.push(index)
+				}
+				const generatedIndex = indexes[0]
+				const committedIndex = indexes[1]
+				if (generatedIndex === undefined || committedIndex === undefined) {
+					throw new Error('The host inventories were not indexed')
+				}
+				if (generatedText !== committedText) {
+					const stale: string[] = []
+					for (const [destination, digest] of generatedIndex) {
+						if (committedIndex.get(destination) !== digest) stale.push(destination)
+					}
+					for (const destination of committedIndex.keys()) {
+						if (!generatedIndex.has(destination)) stale.push(destination)
+					}
+					throw new Error(
+						`The committed host inventory is stale at ${stale.length > 0 ? stale.sort().join(', ') : 'host.json'}`,
+					)
+				}
+				console.info(`host-inventory: entries=${generatedIndex.size}`)
+			} finally {
+				rmSync(workspace, { recursive: true, force: true })
+			}
+		} finally {
+			await server.close()
+		}
+	})
+
 	it('keeps policy rules active across every linted workspace path', () => {
 		const parsed: unknown = JSON.parse(readFileSync(resolve(root, '.oxlintrc.json'), 'utf8'))
 		expect(inspectPolicyConfiguration(parsed)).toEqual([])

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.48",
+	version: "0.0.49",
 	description: "Scaffold workspaces with five commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",
@@ -84,6 +84,7 @@ var package_default = {
 		"build:src:server": "vite build --config configs/src/vite.server.config.ts && npm run copy dist/src/server/index.d.ts dist/src/server/index.d.cts",
 		"build:src:bin": "vite build --config configs/src/vite.bin.config.ts",
 		"build:host": "node -e \"import('./dist/src/server/index.js').then((m)=>{const n=m.stageHost(process.cwd(),'dist/host').length;console.log('build-host: staged '+n+' file(s) into dist/host')})\"",
+		"build:inventory": "node -e \"import('./dist/src/server/index.js').then((m)=>{const p=process.argv[1]??'host.json',n=m.stageInventory(process.cwd(),p).entries.length;console.log('build-inventory: staged '+n+' file(s) into '+p)})\"",
 		"prepack": "npm run build",
 		"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:distribution -- --mode release"
 	},
@@ -100,7 +101,7 @@ var package_default = {
 		"@orkestrel/guide": "^0.0.12",
 		"@orkestrel/html": "^0.0.4",
 		"@orkestrel/probe": "^0.0.2",
-		"@orkestrel/test": "^0.0.9",
+		"@orkestrel/test": "^0.0.10",
 		"@types/node": "^26.2.0",
 		"@vitest/browser-playwright": "^4.1.11",
 		"oxfmt": "^0.64.0",
@@ -252,6 +253,8 @@ var HOST_PATHS = Object.freeze([
 	"guides/guide.md",
 	"guides/scaffold.md"
 ]);
+/** The repository-relative path where the committed vendored-file inventory is served. */
+var HOST_INVENTORY_PATH = "host.json";
 /**
 * The vendored paths whose present bytes belong to each workspace, frozen.
 *
@@ -2062,7 +2065,7 @@ var isMirror = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.recordOf
 }, ["observed"]), (0, _orkestrel_contract.recordOf)({
 	name: isDependencyName,
 	path: isPath,
-	lookup: (0, _orkestrel_contract.literalOf)("missing", "failed"),
+	lookup: (0, _orkestrel_contract.literalOf)("missing", "unmatched", "failed"),
 	note: _orkestrel_contract.isString,
 	observed: isHex
 }, ["observed"]));
@@ -2080,7 +2083,7 @@ var isCatalogEntry = (0, _orkestrel_contract.unionOf)((0, _orkestrel_contract.re
 	dependencies: (0, _orkestrel_contract.andOf)(isCollection, (0, _orkestrel_contract.arrayOf)(isDependency))
 }), (0, _orkestrel_contract.recordOf)({
 	name: isDependencyName,
-	lookup: (0, _orkestrel_contract.literalOf)("missing", "failed"),
+	lookup: (0, _orkestrel_contract.literalOf)("missing", "unmatched", "failed"),
 	note: _orkestrel_contract.isString
 }));
 /**
@@ -2411,6 +2414,29 @@ function matchesOrchestrationPath(path) {
 	return ORCHESTRATION_PATH_PREFIXES.some((prefix) => path.startsWith(prefix));
 }
 /**
+* Checks whether another surface owns the vendored bytes at a path.
+*
+* @param path - The target-relative vendored path to test.
+* @returns `true` for the catalog agent file and for a Markdown guide mirror;
+* `false` otherwise.
+*
+* @remarks
+* The materializer keeps these paths presence-owned because the catalog or
+* mirror surface writes their bytes. A live host fill therefore keeps the
+* installed floor's bytes for them and requests only the host-owned paths.
+*
+* @example
+* ```ts
+* import { isDeferredPath } from '@orkestrel/scaffold'
+*
+* isDeferredPath('guides/router.md') // true
+* isDeferredPath('AGENTS.md') // false
+* ```
+*/
+function isDeferredPath(path) {
+	return path === ".claude/agents/orkestrel.md" || path.startsWith("guides/") && path.endsWith(".md");
+}
+/**
 * Infer the {@link Group} a path belongs to.
 *
 * @param path - The target-relative path to classify.
@@ -5263,6 +5289,7 @@ exports.GLOBAL_SETUP_PATH = GLOBAL_SETUP_PATH;
 exports.GROUPS = GROUPS;
 exports.GUIDES_TEST_PATH = GUIDES_TEST_PATH;
 exports.HEX_PATTERN = HEX_PATTERN;
+exports.HOST_INVENTORY_PATH = HOST_INVENTORY_PATH;
 exports.HOST_PATHS = HOST_PATHS;
 exports.INTEGRATION_TEST_PATH = INTEGRATION_TEST_PATH;
 exports.INVALID_PATH_CHARACTER_PATTERN = INVALID_PATH_CHARACTER_PATTERN;
@@ -5333,6 +5360,7 @@ exports.isCollection = isCollection;
 exports.isCompilerHooks = isCompilerHooks;
 exports.isCompilerOptions = isCompilerOptions;
 exports.isContent = isContent;
+exports.isDeferredPath = isDeferredPath;
 exports.isDependency = isDependency;
 exports.isDependencyName = isDependencyName;
 exports.isEnvironment = isEnvironment;