@amsterdamdatalabs/enact-operator 0.1.2

package/dist/operator/runtime.js

@@ -0,0 +1,357 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync, readFileSync, renameSync, writeFileSync, appendFileSync } from 'node:fs';
+import { z } from 'zod';
+import { inboxFile, ledgerFile, reviewsFile } from '../shared/core/contract.js';
+import { ensureDir, readJsonFile, validateJsonFile, writeJson } from '../shared/core/json.js';
+import { dirname } from 'node:path';
+import { coalesceTaskId, withCanonicalTaskId } from '../shared/core/terminology.js';
+const RUNTIME_SCHEMA_VERSION = 1;
+// ── Ledger NDJSON migration (Phase 5 Q4) ─────────────────────────────────────
+/**
+ * One-time migration from JSON-array ledger.json to NDJSON.
+ * Uses temp-file + atomic rename + sentinel so concurrent appends are safe.
+ * Sentinel at filePath + '.migrated' prevents double-migration on restart.
+ */
+export function migrateLedgerIfNeeded(filePath) {
+    const sentinel = filePath + '.migrated';
+    if (existsSync(sentinel))
+        return; // fast-path skip
+    if (!existsSync(filePath))
+        return;
+    const raw = readFileSync(filePath, 'utf8').trimStart();
+    if (!raw.startsWith('['))
+        return; // already NDJSON or empty
+    let entries;
+    try {
+        entries = JSON.parse(raw);
+    }
+    catch {
+        // Legacy array file that picked up appended NDJSON (or other corruption): keep trailing NDJSON lines.
+        const closeIdx = raw.indexOf(']');
+        if (closeIdx >= 0) {
+            const after = raw.slice(closeIdx + 1).trimStart();
+            if (after.startsWith('{')) {
+                const ndjson = after.endsWith('\n') ? after : `${after}\n`;
+                const tmp = filePath + '.migration.tmp';
+                writeFileSync(tmp, ndjson, 'utf8');
+                renameSync(tmp, filePath);
+                writeFileSync(sentinel, '1', 'utf8');
+                return;
+            }
+        }
+        writeFileSync(filePath, '', 'utf8');
+        writeFileSync(sentinel, '1', 'utf8');
+        return;
+    }
+    if (!Array.isArray(entries)) {
+        writeFileSync(sentinel, '1', 'utf8');
+        return;
+    }
+    // Convert JSON array to NDJSON (or empty file if no entries).
+    // Empty file is the correct post-migration state: appendFileSync appends cleanly,
+    // and loadLedger treats '' as an empty ledger.
+    const ndjson = entries.length === 0 ? '' : entries.map((e) => JSON.stringify(e)).join('\n') + '\n';
+    const tmp = filePath + '.migration.tmp';
+    writeFileSync(tmp, ndjson, 'utf8');
+    renameSync(tmp, filePath); // atomic on POSIX/macOS
+    writeFileSync(sentinel, '1', 'utf8'); // sentinel last
+}
+const OperatorLedgerEntrySchema = z.object({
+    schemaVersion: z.literal(RUNTIME_SCHEMA_VERSION),
+    id: z.string(),
+    kind: z.enum([
+        'task',
+        'executor',
+        'review',
+        'session',
+        'setup',
+        'install',
+        'plugin',
+        'hook',
+        'reconcile',
+        'phase_transition',
+        'stop_verdict',
+        'stop_verdict_denied',
+        'job',
+        'task_manual_close',
+        'workitem_manual_close',
+        'task_close_deferred',
+        'subagent',
+    ]),
+    action: z.string(),
+    detail: z.string(),
+    taskId: z.string().optional(),
+    executorId: z.string().optional(),
+    actor: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()),
+    createdAt: z.string(),
+});
+const OperatorInboxItemSchema = z.object({
+    schemaVersion: z.literal(RUNTIME_SCHEMA_VERSION),
+    id: z.string(),
+    kind: z.enum(['inbox', 'review', 'blocked', 'failed', 'system']),
+    taskId: z.string().optional(),
+    subject: z.string(),
+    body: z.string(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    status: z.enum(['open', 'acknowledged', 'resolved']),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+const EvidenceHorizonSchema = z.object({
+    commitHash: z.string(),
+    verificationRunId: z.string(),
+    verificationRunTimestamp: z.string(),
+    sessionSequence: z.number(),
+});
+const OperatorReviewItemSchema = z.object({
+    schemaVersion: z.literal(RUNTIME_SCHEMA_VERSION),
+    id: z.string(),
+    taskId: z.string().optional(),
+    reviewer: z.string(),
+    status: z.enum(['pending', 'approved', 'changes_requested']),
+    summary: z.string(),
+    notes: z.array(z.string()),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    statusHint: z.enum(['current', 'stale', 'superseded']).optional(),
+    closureScope: z.enum(['lane-local', 'integration', 'repo-end-to-end']).optional(),
+    staleState: z.enum(['current', 'stale', 'superseded']).optional(),
+    supersededBy: z.string().optional(),
+    evidenceHorizon: EvidenceHorizonSchema.optional(),
+}).transform((item) => withCanonicalTaskId(item));
+function now() {
+    return new Date().toISOString();
+}
+function migrateRuntimeEntry(raw) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('runtime entry must be an object');
+    }
+    const entry = raw;
+    const schemaVersion = typeof entry.schemaVersion === 'number' ? entry.schemaVersion : 0;
+    if (schemaVersion !== 0 && schemaVersion !== RUNTIME_SCHEMA_VERSION) {
+        throw new Error(`unsupported schemaVersion ${schemaVersion}`);
+    }
+    const taskId = coalesceTaskId(entry);
+    const migrated = {
+        ...entry,
+        schemaVersion: RUNTIME_SCHEMA_VERSION,
+    };
+    if (taskId) {
+        migrated.taskId = taskId;
+    }
+    if (typeof entry.taskId === 'string' && entry.taskId.length > 0) {
+        migrated.taskId = entry.taskId;
+    }
+    if (entry.kind === 'task') {
+        migrated.kind = 'task';
+    }
+    if (typeof entry.taskId === 'string' && !migrated.taskId) {
+        migrated.taskId = entry.taskId;
+    }
+    return migrated;
+}
+function loadArray(path, schema) {
+    const raw = readJsonFile(path);
+    if (raw === undefined) {
+        return [];
+    }
+    if (!Array.isArray(raw)) {
+        throw new Error(`State at ${path} must be an array.`);
+    }
+    return raw.map((entry, index) => {
+        const migrated = migrateRuntimeEntry(entry);
+        if (schema === OperatorReviewItemSchema) {
+            const taskId = coalesceTaskId(migrated);
+            if (!taskId) {
+                throw new Error(`Review at ${path}[${index}] is missing taskId`);
+            }
+            return validateJsonFile(`${path}[${index}]`, { ...migrated, taskId }, schema);
+        }
+        return validateJsonFile(`${path}[${index}]`, migrated, schema);
+    });
+}
+function loadLedger(root) {
+    const filePath = ledgerFile(root);
+    migrateLedgerIfNeeded(filePath);
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    const raw = readFileSync(filePath, 'utf8').trim();
+    // Handle legacy empty JSON array seed '[]' — treat as empty ledger
+    if (raw === '' || raw === '[]') {
+        return [];
+    }
+    const entries = [];
+    const lines = raw.split('\n').filter(Boolean);
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (err) {
+            const preview = err instanceof Error ? err.message : String(err);
+            console.warn(`[ledger] skipping malformed line at ${filePath}:${index + 1}: ${preview}`);
+            continue;
+        }
+        entries.push(validateJsonFile(`${filePath}[${index}]`, migrateRuntimeEntry(parsed), OperatorLedgerEntrySchema));
+    }
+    return entries;
+}
+function loadInbox(root) {
+    return loadArray(inboxFile(root), OperatorInboxItemSchema);
+}
+function saveInbox(root, items) {
+    writeJson(inboxFile(root), items);
+}
+function loadReviews(root) {
+    return loadArray(reviewsFile(root), OperatorReviewItemSchema);
+}
+function saveReviews(root, items) {
+    writeJson(reviewsFile(root), items);
+}
+export function listLedger(root, limit = 50) {
+    return loadLedger(root).slice(-limit);
+}
+export function appendLedger(root, input) {
+    const taskId = coalesceTaskId(input);
+    const entry = {
+        id: `ledger_${randomUUID().slice(0, 12)}`,
+        createdAt: now(),
+        ...input,
+        kind: input.kind,
+        ...(taskId ? { taskId } : {}),
+        metadata: input.metadata ?? {},
+        schemaVersion: RUNTIME_SCHEMA_VERSION,
+    };
+    const filePath = ledgerFile(root);
+    migrateLedgerIfNeeded(filePath);
+    ensureDir(dirname(filePath));
+    appendFileSync(filePath, JSON.stringify(entry) + '\n', 'utf8');
+    return entry;
+}
+export function listInbox(root) {
+    return loadInbox(root);
+}
+export function upsertInboxItem(root, input) {
+    const items = loadInbox(root);
+    const inputTaskId = coalesceTaskId(input);
+    const index = items.findIndex((item) => coalesceTaskId(item) === inputTaskId && item.kind === input.kind);
+    const timestamp = now();
+    const next = {
+        id: index >= 0 ? items[index].id : `inbox_${randomUUID().slice(0, 12)}`,
+        createdAt: index >= 0 ? items[index].createdAt : timestamp,
+        updatedAt: timestamp,
+        ...input,
+        schemaVersion: RUNTIME_SCHEMA_VERSION,
+    };
+    if (index >= 0) {
+        items[index] = next;
+    }
+    else {
+        items.push(next);
+    }
+    saveInbox(root, items);
+    return next;
+}
+export function resolveInboxItems(root, taskId) {
+    const items = loadInbox(root);
+    let changed = false;
+    for (const item of items) {
+        if (coalesceTaskId(item) === taskId && item.status !== 'resolved') {
+            item.status = 'resolved';
+            item.updatedAt = now();
+            changed = true;
+        }
+    }
+    if (changed) {
+        saveInbox(root, items);
+    }
+}
+export function updateInboxItems(root, predicate, status) {
+    const items = loadInbox(root);
+    let changed = false;
+    for (const item of items) {
+        if (!predicate(item) || item.status === status)
+            continue;
+        item.status = status;
+        item.updatedAt = now();
+        changed = true;
+    }
+    if (changed) {
+        saveInbox(root, items);
+    }
+    return items;
+}
+export function listReviews(root) {
+    return loadReviews(root);
+}
+export function upsertReview(root, input) {
+    const items = loadReviews(root);
+    const inputTaskId = withCanonicalTaskId(input).taskId;
+    const index = items.findIndex((item) => coalesceTaskId(item) === inputTaskId && item.reviewer === input.reviewer);
+    const timestamp = now();
+    const next = {
+        id: index >= 0 ? items[index].id : `review_${randomUUID().slice(0, 12)}`,
+        createdAt: index >= 0 ? items[index].createdAt : timestamp,
+        updatedAt: timestamp,
+        ...withCanonicalTaskId(input),
+        schemaVersion: RUNTIME_SCHEMA_VERSION,
+    };
+    if (index >= 0) {
+        items[index] = next;
+    }
+    else {
+        items.push(next);
+    }
+    saveReviews(root, items);
+    return next;
+}
+export function createReview(root, input) {
+    const timestamp = now();
+    const item = {
+        id: `review_${randomUUID().slice(0, 12)}`,
+        status: input.status ?? 'pending',
+        notes: input.notes ?? [],
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        ...withCanonicalTaskId(input),
+        schemaVersion: RUNTIME_SCHEMA_VERSION,
+    };
+    const items = loadReviews(root);
+    items.push(item);
+    saveReviews(root, items);
+    return item;
+}
+export function updateReview(root, reviewId, patch) {
+    const items = loadReviews(root);
+    const index = items.findIndex((item) => item.id === reviewId);
+    if (index === -1) {
+        return null;
+    }
+    items[index] = {
+        ...items[index],
+        ...patch,
+        updatedAt: now(),
+    };
+    saveReviews(root, items);
+    return items[index];
+}
+export function pushInboxItem(root, input) {
+    const timestamp = now();
+    const item = {
+        id: `inbox_${randomUUID().slice(0, 12)}`,
+        status: input.status ?? 'open',
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        ...input,
+        schemaVersion: RUNTIME_SCHEMA_VERSION,
+    };
+    const items = loadInbox(root);
+    items.push(item);
+    saveInbox(root, items);
+    return item;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/operator/runtime.js.map

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

package/dist/shared/core/bootstrap.d.ts

@@ -0,0 +1,16 @@
+export interface SetupOptions {
+    root?: string;
+    codexHome?: string;
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface SetupResult {
+    root: string;
+    codexHome: string;
+    layoutPath: string;
+    dryRun: boolean;
+    plannedActions?: string[];
+    syncedTasks: number;
+}
+export declare function applySetup(options?: SetupOptions): SetupResult;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/shared/core/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/shared/core/bootstrap.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAoBD,wBAAgB,UAAU,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,CAuDlE"}

package/dist/shared/core/bootstrap.js

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { defaultCodexHome, ensureLayout, layoutDir, resolveOperatorCodexHome, resolveOperatorRoot, tasksFile } from '../../shared/core/contract.js';
+import { upsertInstallRegistryEntry, listInstallRegistry } from '../../shared/state/installRegistry.js';
+import { detectGitBranch, ensureActiveSession } from '../../shared/state/session.js';
+import { writeModeState } from '../../shared/state/state.js';
+function ensureRepoIgnoreEntries(root, entries) {
+    const path = join(root, '.gitignore');
+    const existing = existsSync(path) ? readFileSync(path, 'utf8') : '';
+    const lines = existing.length > 0 ? existing.split(/\r?\n/) : [];
+    const normalized = new Set(lines.map((line) => line.trim()).filter(Boolean));
+    let next = existing.replace(/\s+$/, '');
+    let changed = false;
+    for (const entry of entries) {
+        if (normalized.has(entry))
+            continue;
+        next = next.length > 0 ? `${next}\n${entry}` : `${entry}`;
+        changed = true;
+    }
+    if (!changed)
+        return;
+    writeFileSync(path, `${next}\n`, 'utf8');
+}
+export function applySetup(options = {}) {
+    const root = resolveOperatorRoot(options.root);
+    const codexHome = options.codexHome ?? (() => {
+        try {
+            return resolveOperatorCodexHome(root);
+        }
+        catch {
+            return defaultCodexHome();
+        }
+    })();
+    const dryRun = options.dryRun ?? false;
+    const layoutPath = dryRun ? layoutDir(root) : ensureLayout(root);
+    if (!dryRun) {
+        ensureRepoIgnoreEntries(root, ['.enact/', '.inject/']);
+        ensureActiveSession(root, process.cwd(), detectGitBranch(root));
+    }
+    const governanceStateCount = 0;
+    const plannedActions = [
+        `ensure operator layout -> ${layoutPath}`,
+    ];
+    if (dryRun) {
+        return {
+            root,
+            codexHome,
+            layoutPath,
+            dryRun: true,
+            plannedActions,
+            syncedTasks: governanceStateCount,
+        };
+    }
+    writeModeState(root, 'operator-runtime', {
+        initializedBy: 'enact-operator setup',
+        taskCount: governanceStateCount,
+        branch: detectGitBranch(root),
+        installRegistryEntries: listInstallRegistry(root).length,
+    });
+    upsertInstallRegistryEntry(root, {
+        kind: 'layout',
+        name: '.enact/operator',
+        targetPath: tasksFile(root),
+        ownedBy: 'enact-operator',
+        source: 'enact-operator setup',
+        installMode: 'repo-local',
+        metadata: { layoutPath },
+    });
+    return {
+        root,
+        codexHome,
+        layoutPath,
+        dryRun: false,
+        syncedTasks: governanceStateCount,
+    };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/shared/core/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/shared/core/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkBzD,SAAS,uBAAuB,CAAC,IAAY,EAAE,OAAiB;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,IAAI,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;QAC1D,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAwB,EAAE;IACnD,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE;QAC3C,IAAI,CAAC;YACH,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gBAAgB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,uBAAuB,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QACvD,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,oBAAoB,GAAG,CAAC,CAAC;IAC/B,MAAM,cAAc,GAAG;QACrB,6BAA6B,UAAU,EAAE;KAC1C,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI;YACJ,SAAS;YACT,UAAU;YACV,MAAM,EAAE,IAAI;YACZ,cAAc;YACd,WAAW,EAAE,oBAAoB;SAClC,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,IAAI,EAAE,kBAAkB,EAAE;QACvC,aAAa,EAAE,sBAAsB;QACrC,SAAS,EAAE,oBAAoB;QAC/B,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC;QAC7B,sBAAsB,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM;KACzD,CAAC,CAAC;IAEH,0BAA0B,CAAC,IAAI,EAAE;QAC/B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,iBAAiB;QACvB,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC;QAC3B,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE,sBAAsB;QAC9B,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,EAAE,UAAU,EAAE;KACzB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,SAAS;QACT,UAAU;QACV,MAAM,EAAE,KAAK;QACb,WAAW,EAAE,oBAAoB;KAClC,CAAC;AACJ,CAAC"}

package/dist/shared/core/contract.d.ts

@@ -0,0 +1,71 @@
+export declare const LAYOUT_DIRS: readonly ["cache", "jobs", "logs", "memory", "plans", "reports", "research", "sessions", "state", "team", "ultragoal"];
+export type LayoutDirName = (typeof LAYOUT_DIRS)[number];
+interface OperatorConfigSection {
+    codex_home?: string;
+    storage?: string;
+    package_path?: string;
+    hooks?: {
+        presets?: string[];
+        disabled_presets?: string[];
+    };
+}
+interface AgentConfigSection {
+    watchdog_dir?: string;
+}
+interface OperatorRootConfig {
+    operator?: OperatorConfigSection;
+    agent?: AgentConfigSection;
+    watchdog?: Record<string, unknown>;
+    hooks?: Record<string, unknown>;
+}
+export declare function readMergedOperatorConfig(startDir?: string): OperatorRootConfig | null;
+export declare function defaultCodexHome(): string;
+/** Operator layout root (configurable via `[operator].storage`). */
+export declare function resolveOperatorRoot(root?: string): string;
+export declare function requireOperatorCodexHome(): string;
+export declare function resolveOperatorCodexHome(root?: string): string;
+export declare function resolveOperatorWatchdogDir(startDir?: string): string;
+export declare function layoutDir(root?: string): string;
+export declare function layoutPath(root: string, ...segments: string[]): string;
+export declare function runtimeLayoutDir(): string;
+export declare function runtimeLayoutPath(...segments: string[]): string;
+export declare function cachePath(...segments: string[]): string;
+export declare function logsPath(...segments: string[]): string;
+export declare function memoryPath(...segments: string[]): string;
+export declare function plansPath(...segments: string[]): string;
+export declare function reportsPath(...segments: string[]): string;
+export declare function researchPath(...segments: string[]): string;
+export declare function sessionsPath(...segments: string[]): string;
+export declare function statePath(...segments: string[]): string;
+export declare function teamPath(...segments: string[]): string;
+export declare function ultragoalPath(...segments: string[]): string;
+export declare function stateFile(root: string, mode: string): string;
+export declare function tasksFile(root: string): string;
+export declare function sessionTasksFile(root: string): string;
+export declare function reviewsFile(root: string): string;
+export declare function inboxFile(root: string): string;
+export declare function ledgerFile(root: string): string;
+export declare function sessionFile(root: string): string;
+export declare function installRegistryFile(root: string): string;
+export declare function missionsFile(root: string): string;
+export declare function metricsFile(root?: string): string;
+export declare function runtimeMetricsFile(): string;
+export declare function repoCodexConfigFile(root: string): string;
+export declare function ensureLayout(root?: string): string;
+export interface StateHygieneIssue {
+    code: 'state-read-failed' | 'missing-review-record' | 'review-stale' | 'orphaned-review' | 'pending-review-outside-review-state' | 'terminal-lane-item-active' | 'review-pending-terminal' | 'active-lane-item-missing-owner' | 'review-state-missing-pending-review' | 'stale-flags-present' | 'open-inbox-terminal' | 'open-inbox-missing-lane-item' | 'open-inbox-missing-task' | 'executor-missing-lane-item' | 'executor-terminal-lane-item' | 'idle-executor-with-assignment' | 'busy-executor-no-assignment' | 'queued-terminal-lane-item' | 'active-mode-without-session' | 'unlinked-active-modes';
+    message: string;
+    taskId?: string;
+    reviewId?: string;
+    inboxId?: string;
+    executorId?: string;
+}
+export interface StateHygieneResult {
+    passed: boolean;
+    evidence: string;
+    checkedAt: string;
+    issues: StateHygieneIssue[];
+}
+export declare function runStateHygieneCheck(root: string): StateHygieneResult;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/shared/core/contract.d.ts.map

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