@amsterdamdatalabs/enact-operator 0.1.2

package/dist/shared/workflow/authority/authority.js

@@ -0,0 +1,64 @@
+import { readdirSync } from 'node:fs';
+import { ensureLayout, layoutPath } from '../../../shared/core/contract.js';
+import { listInbox, listLedger, listReviews } from '../../../operator/runtime.js';
+import { getAutopilot } from '../../../lanes/autopilot/index.js';
+import { getRalph } from '../../../lanes/ralph/index.js';
+import { readSession } from '../../../shared/state/session.js';
+import { listModeStates, readModeState } from '../../../shared/state/state.js';
+import { listTasks } from '../../../shared/state/tasks.js';
+import { listSessionTasks } from '../../../shared/workflow/delegation/sessionTasks.js';
+import { readTeam } from '../../../lanes/team/index.js';
+import { getUltrawork } from '../../../lanes/ultrawork/index.js';
+import { readActiveOperator } from '../../../shared/workflow/activation/skillActivation.js';
+import { listMissions } from '../../../operator/missions.js';
+import { listJobs } from '../../../shared/core/jobs.js';
+const RESERVED_MODE_FILES = new Set([
+    'autopilot',
+    'inbox',
+    'install-registry',
+    'ralph',
+    'reviews',
+    'operator-active',
+    'review-handoff',
+    'tasks',
+    'session-tasks',
+    'task-state',
+    'ultrawork',
+]);
+function listUltragoalFiles(root) {
+    const dir = layoutPath(root, 'ultragoal');
+    try {
+        return readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && entry.name.endsWith('.json'))
+            .map((entry) => layoutPath(root, 'ultragoal', entry.name))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function readOperatorAuthority(root) {
+    ensureLayout(root);
+    const modes = Object.fromEntries(listModeStates(root)
+        .filter((mode) => !RESERVED_MODE_FILES.has(mode))
+        .map((mode) => [mode, readModeState(root, mode, {})]));
+    return {
+        root,
+        session: readSession(root),
+        autopilot: getAutopilot(root),
+        ralph: getRalph(root),
+        ultrawork: getUltrawork(root),
+        team: readTeam(root),
+        tasks: listTasks(root),
+        sessionTasks: listSessionTasks(root),
+        reviews: listReviews(root),
+        inbox: listInbox(root),
+        ledger: listLedger(root, Number.MAX_SAFE_INTEGER),
+        modes,
+        operatorActive: readActiveOperator(root),
+        ultragoalFiles: listUltragoalFiles(root),
+        missions: listMissions(root),
+        jobs: listJobs(root),
+    };
+}
+//# sourceMappingURL=authority.js.map

package/dist/shared/workflow/authority/authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../../../src/shared/workflow/authority/authority.ts"],"names":[],"mappings":"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"}

package/dist/shared/workflow/closure/closureManifest.d.ts

@@ -0,0 +1,39 @@
+import type { ClosureScope } from '../../../shared/state/tasks.js';
+export interface ClosureCriteria {
+    requiredCommands?: string[];
+    requiredEvents?: string[];
+    requiredUiSections?: string[];
+    requiredTests?: string[];
+    hooks?: Array<{
+        name: string;
+        command: string;
+    }>;
+}
+export interface ClosureManifest {
+    version?: number;
+    closureScope?: ClosureScope;
+    criteria?: ClosureCriteria;
+}
+export type ClosureSourceKind = 'manifest' | null;
+export interface ClosureSourceResult {
+    source: ClosureSourceKind;
+    criteria: ClosureCriteria | null;
+}
+export declare function manifestPath(root: string): string;
+export declare function readManifest(root: string): ClosureManifest | null;
+/**
+ * Returns false for cross-repo or Epic tasks that must not be auto-completed
+ * by local reviewer approval. Returns true for lane-local tasks.
+ */
+export declare function canAutoClose(task: {
+    closureScope?: ClosureScope | string;
+    kind?: string;
+} | undefined | null): boolean;
+export declare function defaultClosureScope(goalScope?: string): ClosureScope;
+/**
+ * Resolves closure criteria for a task using the three-source priority:
+ * 1. .enact/operator/manifest.yaml
+ * 2. null (strict mode: gate fails)
+ */
+export declare function resolveClosureSource(_taskId: string, root: string): Promise<ClosureSourceResult>;
+//# sourceMappingURL=closureManifest.d.ts.map

package/dist/shared/workflow/closure/closureManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closureManifest.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/closureManifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAClC;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAYjE;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAKtH;AAID,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAKpE;AAID;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAS9B"}

package/dist/shared/workflow/closure/closureManifest.js

@@ -0,0 +1,62 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import { layoutPath } from '../../../shared/core/contract.js';
+// ── Manifest path ─────────────────────────────────────────────────────────────
+export function manifestPath(root) {
+    return layoutPath(root, 'manifest.yaml');
+}
+// ── Read manifest ─────────────────────────────────────────────────────────────
+export function readManifest(root) {
+    const path = manifestPath(root);
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const parsed = parseYaml(raw);
+        return parsed ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── canAutoClose guard ────────────────────────────────────────────────────────
+/**
+ * Returns false for cross-repo or Epic tasks that must not be auto-completed
+ * by local reviewer approval. Returns true for lane-local tasks.
+ */
+export function canAutoClose(task) {
+    if (!task)
+        return true;
+    if (task.closureScope === 'repo-end-to-end')
+        return false;
+    if (task.kind === 'Epic')
+        return false;
+    return true;
+}
+// ── Default-derive closureScope from goalScope (Phase 1 defensive table) ─────
+export function defaultClosureScope(goalScope) {
+    if (goalScope === 'operator-replacement')
+        return 'repo-end-to-end';
+    if (goalScope === 'repo-delivery')
+        return 'integration';
+    if (goalScope === 'operator-runtime')
+        return 'lane-local';
+    return 'integration'; // safe default when goalScope absent
+}
+// ── Resolve closure source ────────────────────────────────────────────────────
+/**
+ * Resolves closure criteria for a task using the three-source priority:
+ * 1. .enact/operator/manifest.yaml
+ * 2. null (strict mode: gate fails)
+ */
+export async function resolveClosureSource(_taskId, root) {
+    // ── Source 1: manifest ─────────────────────────────────────────────────────
+    const manifest = readManifest(root);
+    if (manifest !== null) {
+        return { source: 'manifest', criteria: manifest.criteria ?? {} };
+    }
+    // ── Source 3: no declarative source ──────────────────────────────────────
+    return { source: null, criteria: null };
+}
+//# sourceMappingURL=closureManifest.js.map

package/dist/shared/workflow/closure/closureManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closureManifest.js","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/closureManifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AA0BvD,iFAAiF;AAEjF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AAC3C,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA2B,CAAC;QACxD,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAgF;IAC3G,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,YAAY,KAAK,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,mBAAmB,CAAC,SAAkB;IACpD,IAAI,SAAS,KAAK,sBAAsB;QAAE,OAAO,iBAAiB,CAAC;IACnE,IAAI,SAAS,KAAK,eAAe;QAAE,OAAO,aAAa,CAAC;IACxD,IAAI,SAAS,KAAK,kBAAkB;QAAE,OAAO,YAAY,CAAC;IAC1D,OAAO,aAAa,CAAC,CAAC,qCAAqC;AAC7D,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,IAAY;IAEZ,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;IACnE,CAAC;IAED,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/shared/workflow/closure/closureRequirements.d.ts

@@ -0,0 +1,12 @@
+import type { OperatorConfig } from '../../../shared/core/types.js';
+/**
+ * Returns the set of required boolean IDs for a given task type and tags,
+ * applying tag overrides from the config closure contracts.
+ */
+export declare function closureRequirements(type: string, tags: string[], config: OperatorConfig): string[];
+export declare function isClosed(type: string, tags: string[], booleans: Record<string, boolean>, config: OperatorConfig): boolean;
+/**
+ * Returns required boolean IDs that are still false (not yet satisfied).
+ */
+export declare function pendingBooleans(type: string, tags: string[], booleans: Record<string, boolean>, config: OperatorConfig): string[];
+//# sourceMappingURL=closureRequirements.d.ts.map

package/dist/shared/workflow/closure/closureRequirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closureRequirements.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/closureRequirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,cAAc,GACrB,MAAM,EAAE,CAcV;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,cAAc,GACrB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,cAAc,GACrB,MAAM,EAAE,CAEV"}

package/dist/shared/workflow/closure/closureRequirements.js

@@ -0,0 +1,30 @@
+/**
+ * Returns the set of required boolean IDs for a given task type and tags,
+ * applying tag overrides from the config closure contracts.
+ */
+export function closureRequirements(type, tags, config) {
+    const contract = config.closureContracts?.[type];
+    if (!contract)
+        return [];
+    const required = new Set(contract.required ?? []);
+    for (const tag of tags) {
+        const override = contract.tagOverrides?.[tag];
+        if (!override)
+            continue;
+        for (const id of override.addRequired ?? [])
+            required.add(id);
+        for (const id of override.removeRequired ?? [])
+            required.delete(id);
+    }
+    return [...required];
+}
+export function isClosed(type, tags, booleans, config) {
+    return closureRequirements(type, tags, config).every((id) => booleans[id] === true);
+}
+/**
+ * Returns required boolean IDs that are still false (not yet satisfied).
+ */
+export function pendingBooleans(type, tags, booleans, config) {
+    return closureRequirements(type, tags, config).filter((id) => !booleans[id]);
+}
+//# sourceMappingURL=closureRequirements.js.map

package/dist/shared/workflow/closure/closureRequirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closureRequirements.js","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/closureRequirements.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,IAAc,EACd,MAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAElD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,WAAW,IAAI,EAAE;YAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9D,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,cAAc,IAAI,EAAE;YAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,IAAc,EACd,QAAiC,EACjC,MAAsB;IAEtB,OAAO,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,IAAc,EACd,QAAiC,EACjC,MAAsB;IAEtB,OAAO,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/shared/workflow/closure/contractParity.d.ts

@@ -0,0 +1,24 @@
+export interface ContractParityCheck {
+    kind: 'command' | 'event' | 'ui' | 'test' | 'hook';
+    target: string;
+    passed: boolean;
+    evidence: string;
+}
+export interface ContractParityResult {
+    status: 'passed' | 'failed';
+    evidence: string;
+    source?: 'manifest' | null;
+    checks?: ContractParityCheck[];
+}
+/**
+ * Run the contract-parity gate for the given task.
+ *
+ * Priority:
+ * 1. External task (board work-item) → read closure criteria
+ * 2. .enact/operator/manifest.yaml → read closure criteria
+ * 3. No source → FAIL (strict mode per operator decision Q4)
+ *
+ * Static checks run ALWAYS regardless of source (when criteria validation passes).
+ */
+export declare function runContractParity(root: string, taskId: string): Promise<ContractParityResult>;
+//# sourceMappingURL=contractParity.d.ts.map

package/dist/shared/workflow/closure/contractParity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractParity.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/contractParity.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAChC;AA8MD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAuC/B"}

package/dist/shared/workflow/closure/contractParity.js

@@ -0,0 +1,238 @@
+import { readManifest, resolveClosureSource } from '../../../shared/workflow/closure/closureManifest.js';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { OPERATOR_HOOK_PRESETS } from '../../../operator/hooks/hooks.js';
+import { packagedHooksHandlersPath } from '../../../shared/core/packagePaths.js';
+import { runContextRead, runContextSearch } from '../../../shared/workflow/closure/contractParityContext.js';
+import { fileURLToPath } from 'node:url';
+const COMMAND_SURFACE_FILES = ['src/mcp/server.ts'];
+const COMMAND_SURFACE_DIR = 'src/mcp';
+const EVENT_SURFACE_FILES = [
+    'src/shared/core/events.ts',
+    'src/operator/runtime.ts',
+];
+const UI_SURFACE_FILES = [
+    'src/operator/hud.ts',
+    'src/shared/core/contract.ts',
+];
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+const operatorImplementationRoot = resolve(moduleDir, '..', '..', '..', '..');
+function implementationRoot(root) {
+    return existsSync(join(root, 'src')) ? root : operatorImplementationRoot;
+}
+function readSurface(root, relativePath) {
+    return readFileSync(join(implementationRoot(root), relativePath), 'utf8');
+}
+function walkFiles(path, matches) {
+    if (!existsSync(path))
+        return;
+    for (const entry of readdirSync(path, { withFileTypes: true })) {
+        const next = join(path, entry.name);
+        if (entry.isDirectory()) {
+            walkFiles(next, matches);
+        }
+        else if (entry.isFile()) {
+            matches.push(next);
+        }
+    }
+}
+function findTestFiles(root) {
+    const files = [];
+    const implRoot = implementationRoot(root);
+    walkFiles(join(implRoot, 'src'), files);
+    walkFiles(join(implRoot, 'tests'), files);
+    return files.filter((file) => file.endsWith('.test.ts'));
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function findCommandInMcpDir(root, patterns) {
+    const mcpDir = join(implementationRoot(root), COMMAND_SURFACE_DIR);
+    const files = [];
+    walkFiles(mcpDir, files);
+    for (const file of files.filter((f) => f.endsWith('.ts'))) {
+        try {
+            const body = readFileSync(file, 'utf8');
+            if (patterns.some((pattern) => pattern.test(body))) {
+                return file;
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return null;
+}
+async function validateCommand(root, command) {
+    const escaped = escapeRegExp(command);
+    const patterns = [
+        new RegExp(`name:\\s*'${escaped}'`),
+        new RegExp(`\\.command\\('${escaped}'\\)`),
+        new RegExp(escaped),
+    ];
+    const ctx = await runContextSearch(command, implementationRoot(root));
+    if (ctx && !ctx.text.toLowerCase().includes('no matches')) {
+        return { kind: 'command', target: command, passed: true, evidence: `${command} found via ${ctx.tool}` };
+    }
+    for (const file of COMMAND_SURFACE_FILES) {
+        const body = readSurface(root, file);
+        if (patterns.some((pattern) => pattern.test(body))) {
+            return { kind: 'command', target: command, passed: true, evidence: `${command} found in ${file}` };
+        }
+    }
+    // Fallback: walk entire src/mcp/ tree in the operator package root (CWD-independent)
+    const mcpFile = findCommandInMcpDir(root, patterns);
+    if (mcpFile) {
+        return { kind: 'command', target: command, passed: true, evidence: `${command} found in ${mcpFile}` };
+    }
+    return { kind: 'command', target: command, passed: false, evidence: `${command} not found on command/MCP/server surface` };
+}
+async function validateEvent(root, event) {
+    const declaredPattern = new RegExp(`type:\\s*'${escapeRegExp(event)}'`);
+    let declaredIn = null;
+    let usedIn = null;
+    const ctx = await runContextSearch(event, implementationRoot(root));
+    if (ctx && !ctx.text.toLowerCase().includes('no matches')) {
+        const hasEmit = /broadcastEvent|\.emit\(/.test(ctx.text);
+        if (hasEmit) {
+            return { kind: 'event', target: event, passed: true, evidence: `${event} found via ${ctx.tool}` };
+        }
+    }
+    for (const file of EVENT_SURFACE_FILES) {
+        const body = readSurface(root, file);
+        if (declaredIn === null && declaredPattern.test(body)) {
+            declaredIn = file;
+        }
+        if (usedIn === null
+            && (new RegExp(`broadcastEvent\\(\\{\\s*type:\\s*'${escapeRegExp(event)}'`).test(body)
+                || new RegExp(`\\.emit\\(\\s*'${escapeRegExp(event)}'`).test(body))) {
+            usedIn = file;
+        }
+    }
+    if (declaredIn && usedIn) {
+        return { kind: 'event', target: event, passed: true, evidence: `${event} declared in ${declaredIn} and used in ${usedIn}` };
+    }
+    return { kind: 'event', target: event, passed: false, evidence: `${event} is not both declared and used on the real event surface` };
+}
+async function validateUiSection(root, section) {
+    const needle = section.toLowerCase();
+    const ctx = await runContextSearch(section, implementationRoot(root));
+    if (ctx && !ctx.text.toLowerCase().includes('no matches')) {
+        return { kind: 'ui', target: section, passed: true, evidence: `${section} found via ${ctx.tool}` };
+    }
+    for (const file of UI_SURFACE_FILES) {
+        const body = readSurface(root, file).toLowerCase();
+        if (body.includes(needle)) {
+            return { kind: 'ui', target: section, passed: true, evidence: `${section} found in ${file}` };
+        }
+    }
+    return { kind: 'ui', target: section, passed: false, evidence: `${section} not found in implemented UI surfaces` };
+}
+async function validateRequiredTest(root, requiredTest) {
+    const implRoot = implementationRoot(root);
+    const normalized = requiredTest.replace(/^\.\//, '');
+    const ctx = await runContextSearch(requiredTest, implRoot);
+    if (ctx && !ctx.text.toLowerCase().includes('no matches')) {
+        return { kind: 'test', target: requiredTest, passed: true, evidence: `${requiredTest} found via ${ctx.tool}` };
+    }
+    const testFiles = findTestFiles(root);
+    const exact = testFiles.find((file) => file.endsWith(normalized));
+    if (exact) {
+        return { kind: 'test', target: requiredTest, passed: true, evidence: `${requiredTest} exists at ${exact}` };
+    }
+    const packageJsonPath = join(implRoot, 'package.json');
+    if (existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+            if (pkg.scripts && Object.prototype.hasOwnProperty.call(pkg.scripts, requiredTest)) {
+                return { kind: 'test', target: requiredTest, passed: true, evidence: `${requiredTest} exists as a package test script` };
+            }
+        }
+        catch {
+            // ignore malformed package.json here; the file-path check above remains authoritative
+        }
+    }
+    return { kind: 'test', target: requiredTest, passed: false, evidence: `${requiredTest} test file does not exist` };
+}
+async function validateHook(hook) {
+    const handlerName = hook.command.split('/').pop() ?? hook.command;
+    const handlerPath = join(packagedHooksHandlersPath(), handlerName);
+    const ctx = await runContextRead(handlerPath, 'lines:1-80');
+    const presetMatch = OPERATOR_HOOK_PRESETS.find((preset) => preset.id === hook.name || preset.handlers.some((handler) => handler.script === handlerName || handler.event === hook.name));
+    const passed = Boolean(presetMatch) && existsSync(handlerPath);
+    return {
+        kind: 'hook',
+        target: `${hook.name}:${hook.command}`,
+        passed,
+        evidence: passed
+            ? `${hook.name} resolved to ${handlerPath}${ctx ? ` via ${ctx.tool}` : ''}`
+            : `${hook.name}/${hook.command} does not map to a real hook preset + handler`,
+    };
+}
+// ── Criteria validation ───────────────────────────────────────────────────────
+async function validateCriteria(root, criteria) {
+    const checks = [];
+    for (const command of criteria.requiredCommands ?? [])
+        checks.push(await validateCommand(root, command));
+    for (const event of criteria.requiredEvents ?? [])
+        checks.push(await validateEvent(root, event));
+    for (const section of criteria.requiredUiSections ?? [])
+        checks.push(await validateUiSection(root, section));
+    for (const requiredTest of criteria.requiredTests ?? [])
+        checks.push(await validateRequiredTest(root, requiredTest));
+    for (const hook of criteria.hooks ?? [])
+        checks.push(await validateHook(hook));
+    const passed = checks.every((check) => check.passed);
+    const detail = checks.length === 0
+        ? 'criteria empty — nothing declared'
+        : checks.map((check) => `${check.passed ? 'OK' : 'FAIL'} ${check.kind}:${check.target}`).join('; ');
+    return { passed, checks, detail };
+}
+// ── Main gate runner ──────────────────────────────────────────────────────────
+/**
+ * Run the contract-parity gate for the given task.
+ *
+ * Priority:
+ * 1. External task (board work-item) → read closure criteria
+ * 2. .enact/operator/manifest.yaml → read closure criteria
+ * 3. No source → FAIL (strict mode per operator decision Q4)
+ *
+ * Static checks run ALWAYS regardless of source (when criteria validation passes).
+ */
+export async function runContractParity(root, taskId) {
+    const normalizedTaskId = taskId.trim();
+    const { source, criteria } = normalizedTaskId
+        ? await resolveClosureSource(normalizedTaskId, root)
+        : (() => {
+            const manifest = readManifest(root);
+            if (manifest !== null) {
+                return { source: 'manifest', criteria: manifest.criteria ?? {} };
+            }
+            return { source: null, criteria: null };
+        })();
+    // Strict mode: no declarative source → fail immediately
+    if (source === null || criteria === null) {
+        return {
+            status: 'failed',
+            source,
+            checks: [],
+            evidence: 'no external task or .enact/operator/manifest.yaml — declarative source required for contract-parity (strict mode)',
+        };
+    }
+    const criteriaResult = await validateCriteria(root, criteria);
+    if (!criteriaResult.passed) {
+        return {
+            status: 'failed',
+            source,
+            checks: criteriaResult.checks,
+            evidence: `contract-parity failed: ${criteriaResult.detail}`,
+        };
+    }
+    return {
+        source,
+        checks: criteriaResult.checks,
+        status: 'passed',
+        evidence: `source=${source}; ${criteriaResult.detail}`,
+    };
+}
+//# sourceMappingURL=contractParity.js.map

package/dist/shared/workflow/closure/contractParity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractParity.js","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/contractParity.ts"],"names":[],"mappings":"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"}

package/dist/shared/workflow/closure/contractParityContext.d.ts

@@ -0,0 +1,8 @@
+export interface ContractParityProviderEvidence {
+    source: 'enact-context-mcp';
+    tool: string;
+    text: string;
+}
+export declare function runContextSearch(pattern: string, path: string): Promise<ContractParityProviderEvidence | null>;
+export declare function runContextRead(path: string, mode?: string): Promise<ContractParityProviderEvidence | null>;
+//# sourceMappingURL=contractParityContext.d.ts.map

package/dist/shared/workflow/closure/contractParityContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractParityContext.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/contractParityContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA8CD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAGhD;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,SAAS,GACZ,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAGhD"}

package/dist/shared/workflow/closure/contractParityContext.js

@@ -0,0 +1,50 @@
+function readEnv(name) {
+    const value = process.env[name];
+    return value && value.trim() ? value.trim() : undefined;
+}
+function baseUrl() {
+    return (readEnv('ENACTCTX_BASE_URL')
+        ?? readEnv('ENACT_CONTEXT_BASE_URL')
+        ?? 'http://127.0.0.1:8080').replace(/\/$/, '');
+}
+function authHeaders() {
+    const bearer = readEnv('ENACTCTX_BEARER_TOKEN')
+        ?? readEnv('ENACT_CONTEXT_HTTP_TOKEN');
+    return bearer ? { Authorization: `Bearer ${bearer}` } : {};
+}
+async function callToolText(name, args) {
+    try {
+        const response = await fetch(`${baseUrl()}/v1/tools/call`, {
+            method: 'POST',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+                ...authHeaders(),
+            },
+            body: JSON.stringify({
+                name,
+                arguments: args,
+            }),
+        });
+        if (!response.ok)
+            return null;
+        const json = await response.json();
+        if (typeof json.result === 'string')
+            return json.result;
+        if (json.result === undefined || json.result === null)
+            return null;
+        return JSON.stringify(json.result);
+    }
+    catch {
+        return null;
+    }
+}
+export async function runContextSearch(pattern, path) {
+    const text = await callToolText('ctx_search', { pattern, path });
+    return text === null ? null : { source: 'enact-context-mcp', tool: 'ctx_search', text };
+}
+export async function runContextRead(path, mode = 'full') {
+    const text = await callToolText('ctx_read', { path, mode });
+    return text === null ? null : { source: 'enact-context-mcp', tool: 'ctx_read', text };
+}
+//# sourceMappingURL=contractParityContext.js.map

package/dist/shared/workflow/closure/contractParityContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractParityContext.js","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/contractParityContext.ts"],"names":[],"mappings":"AAMA,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,SAAS,OAAO;IACd,OAAO,CACL,OAAO,CAAC,mBAAmB,CAAC;WACzB,OAAO,CAAC,wBAAwB,CAAC;WACjC,uBAAuB,CAC3B,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,MAAM,GACV,OAAO,CAAC,uBAAuB,CAAC;WAC7B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,IAA6B;IACrE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,EAAE,gBAAgB,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,cAAc,EAAE,kBAAkB;gBAClC,GAAG,WAAW,EAAE;aACjB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI;gBACJ,SAAS,EAAE,IAAI;aAChB,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0B,CAAC;QAC3D,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,IAAY;IAEZ,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAAI,GAAG,MAAM;IAEb,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACxF,CAAC"}

package/dist/shared/workflow/closure/scopeGuard.d.ts

@@ -0,0 +1,11 @@
+export interface ScopeGuard {
+    planPath: string;
+    patterns: string[];
+}
+export interface ScopeViolation {
+    filePath: string;
+    pattern: string;
+}
+export declare function buildScopeGuard(planPath: string): ScopeGuard;
+export declare function runScopeGuard(guard: ScopeGuard, artefactDir: string): ScopeViolation[];
+//# sourceMappingURL=scopeGuard.d.ts.map

package/dist/shared/workflow/closure/scopeGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeGuard.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/closure/scopeGuard.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+BD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAK5D;AAeD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAkBtF"}