@orkestrel/scaffold 0.0.21 → 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. */
@@ -60,6 +60,9 @@ export const DATA_SOURCE_FILES: readonly string[] = Object.freeze([
 	'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',
@@ -139,6 +142,28 @@ export function isCodingSourcePath(path: string): boolean {
 	)
 }
 
+/**
+ * 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 (
@@ -458,7 +483,16 @@ export function inspectCodingSource(
 	if (!normalizedPath.startsWith('app/browser/')) {
 		violations.push(`${normalizedPath} Vue components belong in app/browser`)
 	}
-	violations.push(...inspectVueCodingLaw(normalizedPath, vueScripts?.(normalizedPath, content)))
+	// 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
 }
 
@@ -536,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[] = []
@@ -544,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) &&
@@ -553,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`)
 	}
@@ -598,6 +665,7 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 		}
 		if (
 			!placementExempt &&
+			!functionModule &&
 			ts.isFunctionDeclaration(statement) &&
 			!FUNCTION_SOURCE_FILES.includes(file)
 		) {
@@ -605,6 +673,7 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 		}
 		if (
 			!placementExempt &&
+			!functionModule &&
 			ts.isVariableStatement(statement) &&
 			!DATA_SOURCE_FILES.includes(file)
 		) {
@@ -646,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(
@@ -673,7 +746,14 @@ export function inspectCodingLaw(path: string, content: string): readonly string
 	return violations
 }
 
-/** Inspect every production source 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,