@orkestrel/scaffold 0.0.20 → 0.0.22

package/dist/host/manifest.json

@@ -1,5 +1,10 @@
 {
 	"entries": [
+		{
+			"storage": "agents/orchestration.md",
+			"destination": ".agents/orchestration.md",
+			"executable": false
+		},
 		{
 			"storage": "agents/skills/enterprise-bootstrap/SKILL.md",
 			"destination": ".agents/skills/enterprise-bootstrap/SKILL.md",
@@ -60,6 +65,11 @@
 			"destination": ".agents/skills/orkestrel-build-application/agents/openai.yaml",
 			"executable": false
 		},
+		{
+			"storage": "agents/skills/orkestrel-build-application/references/application.md",
+			"destination": ".agents/skills/orkestrel-build-application/references/application.md",
+			"executable": false
+		},
 		{
 			"storage": "agents/skills/orkestrel-debrief/SKILL.md",
 			"destination": ".agents/skills/orkestrel-debrief/SKILL.md",
@@ -80,6 +90,21 @@
 			"destination": ".agents/skills/orkestrel-debrief/references/instruction-audit.md",
 			"executable": false
 		},
+		{
+			"storage": "agents/skills/orkestrel-falsify/SKILL.md",
+			"destination": ".agents/skills/orkestrel-falsify/SKILL.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-falsify/references/brief.md",
+			"destination": ".agents/skills/orkestrel-falsify/references/brief.md",
+			"executable": false
+		},
+		{
+			"storage": "agents/skills/orkestrel-falsify/references/reconcile.md",
+			"destination": ".agents/skills/orkestrel-falsify/references/reconcile.md",
+			"executable": false
+		},
 		{
 			"storage": "agents/skills/orkestrel-harden-package/SKILL.md",
 			"destination": ".agents/skills/orkestrel-harden-package/SKILL.md",
@@ -125,6 +150,11 @@
 			"destination": ".agents/skills/orkestrel-polish-surface/references/capture-harness.md",
 			"executable": false
 		},
+		{
+			"storage": "claude/agents/analyst.md",
+			"destination": ".claude/agents/analyst.md",
+			"executable": false
+		},
 		{
 			"storage": "claude/agents/application.md",
 			"destination": ".claude/agents/application.md",
@@ -265,6 +295,11 @@
 			"destination": ".claude/skills/orkestrel-debrief/SKILL.md",
 			"executable": false
 		},
+		{
+			"storage": "claude/skills/orkestrel-falsify/SKILL.md",
+			"destination": ".claude/skills/orkestrel-falsify/SKILL.md",
+			"executable": false
+		},
 		{
 			"storage": "claude/skills/orkestrel-harden-package/SKILL.md",
 			"destination": ".claude/skills/orkestrel-harden-package/SKILL.md",
@@ -350,6 +385,11 @@
 			"destination": ".cursor/mcp.json",
 			"executable": false
 		},
+		{
+			"storage": "cursor/rules/orchestration.mdc",
+			"destination": ".cursor/rules/orchestration.mdc",
+			"executable": false
+		},
 		{
 			"storage": "dotfiles/editorconfig",
 			"destination": ".editorconfig",
@@ -452,9 +492,12 @@
 		".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-falsify",
+		".agents/skills/orkestrel-falsify/references",
 		".agents/skills/orkestrel-harden-package",
 		".agents/skills/orkestrel-harden-package/agents",
 		".agents/skills/orkestrel-harden-package/references",
@@ -469,14 +512,17 @@
 		".claude/skills/orkestrel-align-packages",
 		".claude/skills/orkestrel-build-application",
 		".claude/skills/orkestrel-debrief",
+		".claude/skills/orkestrel-falsify",
 		".claude/skills/orkestrel-harden-package",
 		".claude/skills/orkestrel-polish-surface",
 		".codex",
 		".codex/agents",
 		".cursor",
+		".cursor/rules",
 		"guides",
 		"guides/src",
 		"scripts",
 		"tests"
-	]
+	],
+	"digest": "e4351919e4d34e3696ee3ce77e2cce555c20acc58a29649cd9f3c489f3d0bf2b"
 }

package/dist/host/tests/setupPolicy.ts

@@ -1,6 +1,6 @@
 import { globSync, readFileSync } from 'node:fs'
 import { isBuiltin } from 'node:module'
-import { basename, join } from 'node:path'
+import { basename, extname, join } from 'node:path'
 import * as ts from 'typescript'
 
 /** Centralized source modules whose top-level declarations must all be exported. */
@@ -18,6 +18,7 @@ export const CENTRAL_SOURCE_FILES: readonly string[] = Object.freeze([
 	'middlewares.ts',
 	'parsers.ts',
 	'relations.ts',
+	'routes.ts',
 	'schemas.ts',
 	'seeders.ts',
 	'shapers.ts',
@@ -39,6 +40,7 @@ export const FUNCTION_SOURCE_FILES: readonly string[] = Object.freeze([
 	'middlewares.ts',
 	'parsers.ts',
 	'relations.ts',
+	'routes.ts',
 	'schemas.ts',
 	'seeders.ts',
 	'shapers.ts',
@@ -51,12 +53,16 @@ export const DATA_SOURCE_FILES: readonly string[] = Object.freeze([
 	'constants.ts',
 	'contracts.ts',
 	'relations.ts',
+	'routes.ts',
 	'schemas.ts',
 	'shapers.ts',
 	'templates.ts',
 	'validators.ts',
 ])
 
+/** Domain folders whose modules each export one named function rather than one class. */
+export const FUNCTION_DOMAIN_FOLDERS: readonly string[] = Object.freeze(['app/browser/composables'])
+
 /** Worker-only value globals that WebWorker typing must not expose to core implementations. */
 export const WORKER_SCOPE_VALUE_GLOBALS: readonly string[] = Object.freeze([
 	'name',
@@ -90,6 +96,22 @@ export const WORKER_SCOPE_VALUE_GLOBALS: readonly string[] = Object.freeze([
 	'removeEventListener',
 ])
 
+/** Source extensions inspected by the repository coding-law sweep. */
+export const CODING_SOURCE_EXTENSIONS: readonly string[] = Object.freeze([
+	'cjs',
+	'cts',
+	'js',
+	'jsx',
+	'mjs',
+	'mts',
+	'ts',
+	'tsx',
+	'vue',
+])
+
+/** Production-source glob derived from the complete inspected extension vocabulary. */
+export const CODING_SOURCE_GLOB = `{app,src}/**/*.{${CODING_SOURCE_EXTENSIONS.join(',')}}`
+
 /** Virtual source text used while binding one policy-inspected module. */
 export const POLICY_SOURCE_TEXTS: Map<string, string> = new Map()
 
@@ -109,6 +131,39 @@ export function normalizePolicyPath(path: string): string {
 	return path.replaceAll('\\', '/').replace(/\/+/gu, '/')
 }
 
+/** Whether a path belongs to the production-source coding-law corpus. */
+export function isCodingSourcePath(path: string): boolean {
+	const normalized = normalizePolicyPath(path)
+	const extension = normalized.split('.').pop()
+	return (
+		(normalized.startsWith('app/') || normalized.startsWith('src/')) &&
+		extension !== undefined &&
+		CODING_SOURCE_EXTENSIONS.includes(extension)
+	)
+}
+
+/**
+ * Whether a path is an eligible function-domain module.
+ *
+ * @param path - The workspace-relative source path to inspect
+ * @returns `true` when the path is a direct module of a registered function domain
+ */
+export function isFunctionDomainPath(path: string): boolean {
+	const normalized = normalizePolicyPath(path)
+	const file = basename(normalized)
+	const separator = normalized.lastIndexOf('/')
+	const parent = separator < 0 ? '' : normalized.slice(0, separator)
+	return (
+		FUNCTION_DOMAIN_FOLDERS.includes(parent) &&
+		/^[a-z][A-Za-z0-9]*\.ts$/u.test(file) &&
+		file !== 'index.ts' &&
+		file !== 'main.ts' &&
+		!CENTRAL_SOURCE_FILES.includes(file) &&
+		!FUNCTION_SOURCE_FILES.includes(file) &&
+		!DATA_SOURCE_FILES.includes(file)
+	)
+}
+
 /** Whether a declaration carries an explicit export modifier. */
 export function hasExportModifier(node: ts.Node): boolean {
 	return (
@@ -416,6 +471,31 @@ export function inspectVueCodingLaw(
 	return violations
 }
 
+/** Inspect one production source through the shared coding-law route. */
+export function inspectCodingSource(
+	path: string,
+	content: string,
+	vueScripts?: VueScriptExtractorInterface,
+): readonly string[] {
+	const normalizedPath = normalizePolicyPath(path)
+	if (!normalizedPath.endsWith('.vue')) return inspectCodingLaw(normalizedPath, content)
+	const violations: string[] = []
+	if (!normalizedPath.startsWith('app/browser/')) {
+		violations.push(`${normalizedPath} Vue components belong in app/browser`)
+	}
+	// A missing extractor is reported, never absorbed. Returning [] here would make
+	// every SFC's script block silently unchecked while the surrounding sweep still
+	// reported success — an instrument claiming a coverage it does not have.
+	if (vueScripts === undefined) {
+		violations.push(
+			`${normalizedPath} requires a Vue script extractor; its script blocks were not inspected`,
+		)
+		return violations
+	}
+	violations.push(...inspectVueCodingLaw(normalizedPath, vueScripts(normalizedPath, content)))
+	return violations
+}
+
 /** Add syntax-wide coding-law violations while traversing one source tree. */
 export function inspectCodingNode(
 	path: string,
@@ -490,6 +570,34 @@ export function inspectCodingNode(
 	ts.forEachChild(node, (child) => inspectCodingNode(path, child, violations, checker))
 }
 
+/**
+ * Inspect one eligible function-domain module for its required declaration shape.
+ *
+ * @param path - The source path used in diagnostics
+ * @param source - The parsed source file to inspect
+ * @returns A shape violation when the module is not imports plus one matching named export
+ */
+export function inspectFunctionModule(path: string, source: ts.SourceFile): readonly string[] {
+	const file = basename(normalizePolicyPath(path))
+	const declarations = source.statements.filter(ts.isFunctionDeclaration)
+	const functions = declarations.filter((declaration) => declaration.body !== undefined)
+	const invalid = source.statements.filter(
+		(statement) => !ts.isImportDeclaration(statement) && !ts.isFunctionDeclaration(statement),
+	)
+	const declaration = functions[0]
+	if (
+		functions.length === 1 &&
+		invalid.length === 0 &&
+		declarations.every((candidate) => candidate.name?.text === file.slice(0, -3)) &&
+		declaration !== undefined &&
+		hasExportModifier(declaration) &&
+		!hasModifier(declaration, ts.SyntaxKind.DefaultKeyword)
+	) {
+		return []
+	}
+	return [`${path} declarations do not form one matching exported function implementation`]
+}
+
 /** Inspect one TypeScript source module for repository coding-law violations. */
 export function inspectCodingLaw(path: string, content: string): readonly string[] {
 	const violations: string[] = []
@@ -498,6 +606,8 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 	if (source === undefined) throw new Error(`Policy source was not bound at ${path}`)
 	const checker = program.getTypeChecker()
 	const file = basename(path)
+	const stem = basename(file, extname(file))
+	const functionModule = isFunctionDomainPath(path)
 	const placementExempt =
 		!CENTRAL_SOURCE_FILES.includes(file) &&
 		!FUNCTION_SOURCE_FILES.includes(file) &&
@@ -507,6 +617,9 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 	if (/\.[cm]?jsx?$/u.test(path)) {
 		violations.push(`${path} production modules use TypeScript source extensions`)
 	}
+	if (FUNCTION_DOMAIN_FOLDERS.some((folder) => basename(folder) === stem)) {
+		violations.push(`${path} names a function domain, which belongs in a folder rather than a file`)
+	}
 	if (/@ts-(?:expect-error|ignore|nocheck)|eslint-disable|oxlint-disable/u.test(content)) {
 		violations.push(`${path} forbids suppression directives`)
 	}
@@ -552,6 +665,7 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 		}
 		if (
 			!placementExempt &&
+			!functionModule &&
 			ts.isFunctionDeclaration(statement) &&
 			!FUNCTION_SOURCE_FILES.includes(file)
 		) {
@@ -559,6 +673,7 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 		}
 		if (
 			!placementExempt &&
+			!functionModule &&
 			ts.isVariableStatement(statement) &&
 			!DATA_SOURCE_FILES.includes(file)
 		) {
@@ -600,6 +715,10 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 		}
 	}
 
+	if (functionModule) {
+		violations.push(...inspectFunctionModule(path, source))
+	}
+
 	if (/^[A-Z][A-Za-z0-9]*\.ts$/u.test(file)) {
 		const classes = source.statements.filter(ts.isClassDeclaration)
 		const invalid = source.statements.filter(
@@ -627,25 +746,24 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 	return violations
 }
 
-/** Inspect every production TypeScript module under one workspace. */
+/**
+ * Inspect every production source under one workspace.
+ *
+ * @remarks
+ * `vueScripts` is required whenever the workspace contains a `.vue` file: script
+ * blocks cannot be read without it, and omitting it is reported as a violation
+ * against each SFC rather than passing silently.
+ */
 export function inspectCodingWorkspace(
 	root: string,
 	vueScripts?: VueScriptExtractorInterface,
 ): readonly string[] {
 	const violations: string[] = []
-	for (const path of globSync('{app,src}/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx,vue}', {
+	for (const path of globSync(CODING_SOURCE_GLOB, {
 		cwd: root,
 	})) {
 		const content = readFileSync(join(root, path), 'utf8')
-		const normalizedPath = normalizePolicyPath(path)
-		if (path.endsWith('.vue') && !normalizedPath.startsWith('app/browser/')) {
-			violations.push(`${normalizedPath} Vue components belong in app/browser`)
-		}
-		violations.push(
-			...(path.endsWith('.vue')
-				? inspectVueCodingLaw(normalizedPath, vueScripts?.(normalizedPath, content))
-				: inspectCodingLaw(normalizedPath, content)),
-		)
+		violations.push(...inspectCodingSource(path, content, vueScripts))
 	}
 	return violations
 }