@amsterdamdatalabs/enact-operator 0.1.2

package/dist/shared/core/jobs.js

@@ -0,0 +1,137 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, renameSync, writeFileSync } from 'node:fs';
+import { appendLedger } from '../../operator/runtime.js';
+import { layoutPath } from '../../shared/core/contract.js';
+import { readJson } from '../../shared/core/json.js';
+/** Maximum number of history entries kept in memory per job. Oldest entries are dropped first. */
+const HISTORY_CAP = 50;
+function jobsFile(root) {
+    return layoutPath(root, 'jobs', 'index.json');
+}
+function ensureJobsDir(root) {
+    const dir = layoutPath(root, 'jobs');
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function loadJobs(root) {
+    ensureJobsDir(root);
+    return readJson(jobsFile(root), []);
+}
+function saveJobs(root, jobs) {
+    ensureJobsDir(root);
+    const filePath = jobsFile(root);
+    const tmp = filePath + '.tmp';
+    writeFileSync(tmp, JSON.stringify(jobs, null, 2), 'utf8');
+    renameSync(tmp, filePath);
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+export function createJob(root, partial) {
+    const at = nowIso();
+    const job = {
+        id: `job_${randomUUID().slice(0, 12)}`,
+        createdAt: at,
+        updatedAt: at,
+        history: [{ at, event: 'created' }],
+        ...partial,
+    };
+    const jobs = loadJobs(root);
+    jobs.push(job);
+    saveJobs(root, jobs);
+    appendLedger(root, {
+        kind: 'job',
+        action: 'job_created',
+        detail: `Job "${job.id}" created (kind=${job.kind}, status=${job.status})`,
+        metadata: { jobId: job.id, status: job.status, kind: job.kind },
+    });
+    return job;
+}
+export function getJob(root, id) {
+    const jobs = loadJobs(root);
+    return jobs.find((j) => j.id === id) ?? null;
+}
+export function listJobs(root, filter) {
+    let jobs = loadJobs(root);
+    if (!filter)
+        return jobs;
+    if (filter.kind !== undefined) {
+        jobs = jobs.filter((j) => j.kind === filter.kind);
+    }
+    if (filter.status !== undefined) {
+        jobs = jobs.filter((j) => j.status === filter.status);
+    }
+    if (filter.linkage !== undefined) {
+        const lf = filter.linkage;
+        jobs = jobs.filter((j) => {
+            if (!j.linkage)
+                return false;
+            for (const [key, val] of Object.entries(lf)) {
+                if (val !== undefined && j.linkage[key] !== val)
+                    return false;
+            }
+            return true;
+        });
+    }
+    return jobs;
+}
+export function updateJob(root, id, patch) {
+    const jobs = loadJobs(root);
+    const idx = jobs.findIndex((j) => j.id === id);
+    if (idx === -1)
+        throw new Error(`Job "${id}" not found.`);
+    const prev = jobs[idx];
+    const at = nowIso();
+    const updated = { ...prev, ...patch, updatedAt: at };
+    // Append history entry when status changes, capped at HISTORY_CAP
+    if (patch.status !== undefined && patch.status !== prev.status) {
+        const event = patch.status;
+        const detail = patch.detail;
+        const newEntry = { at, event, ...(detail !== undefined ? { detail } : {}) };
+        const uncapped = [...prev.history, newEntry];
+        if (uncapped.length > HISTORY_CAP) {
+            const dropped = uncapped.length - HISTORY_CAP;
+            updated.history = uncapped.slice(dropped);
+            updated.historyTruncatedCount = (prev.historyTruncatedCount ?? 0) + dropped;
+        }
+        else {
+            updated.history = uncapped;
+            updated.historyTruncatedCount = prev.historyTruncatedCount;
+        }
+    }
+    else {
+        updated.history = prev.history;
+        updated.historyTruncatedCount = prev.historyTruncatedCount;
+    }
+    jobs[idx] = updated;
+    saveJobs(root, jobs);
+    const action = patch.status !== undefined ? `job_${patch.status}` : 'job_updated';
+    appendLedger(root, {
+        kind: 'job',
+        action,
+        detail: `Job "${id}" updated (status=${updated.status})`,
+        metadata: { jobId: id, status: updated.status, kind: updated.kind },
+    });
+    return updated;
+}
+export function deleteJob(root, id) {
+    const jobs = loadJobs(root);
+    const idx = jobs.findIndex((j) => j.id === id);
+    if (idx === -1)
+        return false;
+    // Append cancelled history entry before removal
+    const at = nowIso();
+    const job = jobs[idx];
+    job.history = [...job.history, { at, event: 'cancelled' }];
+    jobs.splice(idx, 1);
+    saveJobs(root, jobs);
+    appendLedger(root, {
+        kind: 'job',
+        action: 'job_cancelled',
+        detail: `Job "${id}" deleted/cancelled`,
+        metadata: { jobId: id, status: 'cancelled', kind: job.kind },
+    });
+    return true;
+}
+//# sourceMappingURL=jobs.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { ZodType } from 'zod';
+export declare function ensureDir(path: string): void;
+export declare class OperatorStateError extends Error {
+    readonly path: string;
+    readonly detail?: string | undefined;
+    constructor(message: string, path: string, detail?: string | undefined);
+}
+export declare function readJson<T>(path: string, fallback: T): T;
+export declare function writeJson(path: string, value: unknown): void;
+export declare function readJsonFile(path: string): unknown | undefined;
+export declare function validateJsonFile<T>(path: string, raw: unknown, schema: ZodType<T>): T;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/shared/core/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBAFxB,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAUxD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAc9D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAUrF"}

package/dist/shared/core/json.js

@@ -0,0 +1,52 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+export function ensureDir(path) {
+    mkdirSync(path, { recursive: true });
+}
+export class OperatorStateError extends Error {
+    path;
+    detail;
+    constructor(message, path, detail) {
+        super(detail ? `${message}: ${detail}` : message);
+        this.path = path;
+        this.detail = detail;
+        this.name = 'OperatorStateError';
+    }
+}
+export function readJson(path, fallback) {
+    if (!existsSync(path)) {
+        return fallback;
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+export function writeJson(path, value) {
+    ensureDir(dirname(path));
+    writeFileSync(path, JSON.stringify(value, null, 2), 'utf8');
+}
+export function readJsonFile(path) {
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        throw new OperatorStateError(`Malformed JSON in ${path}`, path, error instanceof Error ? error.message : String(error));
+    }
+}
+export function validateJsonFile(path, raw, schema) {
+    const parsed = schema.safeParse(raw);
+    if (parsed.success) {
+        return parsed.data;
+    }
+    const detail = parsed.error.issues
+        .map((issue) => `${issue.path.join('.') || '(root)'} ${issue.message}`)
+        .join('; ');
+    throw new OperatorStateError(`Schema validation failed for ${path}`, path, detail);
+}
+//# sourceMappingURL=json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/shared/core/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGhC;IACA;IAHX,YACE,OAAe,EACN,IAAY,EACZ,MAAe;QAExB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAHzC,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAS;QAGxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CAAI,IAAY,EAAE,QAAW;IACnD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACpD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,qBAAqB,IAAI,EAAE,EAC3B,IAAI,EACJ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAI,IAAY,EAAE,GAAY,EAAE,MAAkB;IAChF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;SAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACrF,CAAC"}

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

@@ -0,0 +1,11 @@
+export declare const LEGACY_OPERATOR_LAYOUT_SEGMENTS: readonly [".enact", "operator"];
+export declare function legacyOperatorLayoutPath(root: string): string;
+/**
+ * One-time merge from `.enact/operator/` into the canonical layout root.
+ * Copies each file only when the target is missing or the legacy file is newer.
+ */
+export declare function migrateLegacyOperatorLayout(root: string, targetLayout: string): {
+    copied: number;
+    legacyPath: string;
+};
+//# sourceMappingURL=layoutMigration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layoutMigration.d.ts","sourceRoot":"","sources":["../../../src/shared/core/layoutMigration.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,+BAA+B,iCAAkC,CAAC;AAE/E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAkCD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAUtH"}

package/dist/shared/core/layoutMigration.js

@@ -0,0 +1,56 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export const LEGACY_OPERATOR_LAYOUT_SEGMENTS = ['.enact', 'operator'];
+export function legacyOperatorLayoutPath(root) {
+    return join(root, ...LEGACY_OPERATOR_LAYOUT_SEGMENTS);
+}
+function shouldCopySource(sourcePath, targetPath) {
+    if (!existsSync(targetPath))
+        return true;
+    try {
+        const sourceStat = statSync(sourcePath);
+        const targetStat = statSync(targetPath);
+        return sourceStat.mtimeMs > targetStat.mtimeMs;
+    }
+    catch {
+        return false;
+    }
+}
+function mergeLegacyTree(sourceDir, targetDir) {
+    if (!existsSync(sourceDir))
+        return 0;
+    mkdirSync(targetDir, { recursive: true });
+    let copied = 0;
+    for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+        const sourcePath = join(sourceDir, entry.name);
+        const targetPath = join(targetDir, entry.name);
+        if (entry.isDirectory()) {
+            copied += mergeLegacyTree(sourcePath, targetPath);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (!shouldCopySource(sourcePath, targetPath))
+            continue;
+        mkdirSync(dirname(targetPath), { recursive: true });
+        cpSync(sourcePath, targetPath);
+        copied += 1;
+    }
+    return copied;
+}
+/**
+ * One-time merge from `.enact/operator/` into the canonical layout root.
+ * Copies each file only when the target is missing or the legacy file is newer.
+ */
+export function migrateLegacyOperatorLayout(root, targetLayout) {
+    const legacyPath = legacyOperatorLayoutPath(root);
+    if (!existsSync(legacyPath)) {
+        return { copied: 0, legacyPath };
+    }
+    if (resolve(legacyPath) === resolve(targetLayout)) {
+        return { copied: 0, legacyPath };
+    }
+    const copied = mergeLegacyTree(legacyPath, targetLayout);
+    return { copied, legacyPath };
+}
+//# sourceMappingURL=layoutMigration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layoutMigration.js","sourceRoot":"","sources":["../../../src/shared/core/layoutMigration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAU,CAAC;AAE/E,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,+BAA+B,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,UAAkB;IAC9D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,SAAiB;IAC3D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC;YAAE,SAAS;QACxD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,YAAoB;IAC5E,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,61 @@
+import { type PhaseTransitionEvent } from '../../shared/core/events.js';
+import { type GateProfile, type GoalScope } from '../../shared/workflow/activation/gateProfiles.js';
+export interface LifecycleHistoryEntryBase<Phase extends string> {
+    phase: Phase;
+    at: string;
+    by?: string;
+    note?: string;
+}
+export declare function lifecycleNow(): string;
+export declare function buildLifecycleCore<Phase extends string, HistoryEntry extends LifecycleHistoryEntryBase<string>>(args: {
+    id: string;
+    phase: Phase;
+    history: HistoryEntry[];
+    goalScope?: GoalScope;
+    gateProfile?: GateProfile;
+}): {
+    id: string;
+    active: boolean;
+    phase: Phase;
+    history: HistoryEntry[];
+    goalScope: GoalScope | undefined;
+    gateProfile: GateProfile | undefined;
+    createdAt: string;
+    updatedAt: string;
+};
+export declare function resolveLifecycleStartScopeAndProfile(root: string, args: {
+    text: string;
+    explicitGoalScope?: GoalScope;
+    explicitGateProfile?: GateProfile;
+    contextLabel: string;
+    hint: string;
+}): {
+    resolvedProfile: GateProfile | undefined;
+    resolvedScope: GoalScope;
+};
+export declare function resolveLifecycleRetargetScopeAndProfile(root: string, args: {
+    text: string;
+    explicitGoalScope?: GoalScope;
+    explicitGateProfile?: GateProfile;
+    currentGoalScope?: GoalScope;
+    currentGateProfile?: GateProfile;
+    contextLabel: string;
+}): {
+    resolvedProfile: GateProfile | undefined;
+    resolvedScope: GoalScope;
+};
+export declare function assertLifecycleTransitionAllowed<Phase extends string>(label: string, id: string, currentPhase: Phase, nextPhase: Phase, transitions: Record<Phase, Phase[]>): void;
+export declare function recordLifecyclePhaseTransition(root: string, args: {
+    modeType: PhaseTransitionEvent['modeType'];
+    laneId: string;
+    fromPhase: string;
+    toPhase: string;
+    trigger?: PhaseTransitionEvent['trigger'];
+    sessionAction: string;
+    sessionDetail: string;
+    sessionMetadata?: Record<string, unknown>;
+    actor?: string;
+    sessionId?: string;
+    runId?: string;
+}): void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/shared/core/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG3F,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,8CAA8C,CAAC;AAEtD,MAAM,WAAW,yBAAyB,CAAC,KAAK,SAAS,MAAM;IAC7D,KAAK,EAAE,KAAK,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,MAAM,EAAE,YAAY,SAAS,yBAAyB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE;IACrH,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;;;;;;;;;EAYA;AAeD,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,mBAAmB,CAAC,EAAE,WAAW,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;;;EA0BA;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,mBAAmB,CAAC,EAAE,WAAW,CAAC;IAClC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,kBAAkB,CAAC,EAAE,WAAW,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;;;EAiBA;AAED,wBAAgB,gCAAgC,CAAC,KAAK,SAAS,MAAM,EACnE,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,KAAK,EAChB,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,QAQpC;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACjE,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,QA8CA"}

package/dist/shared/core/lifecycle.js

@@ -0,0 +1,123 @@
+import { randomUUID } from 'node:crypto';
+import { createEvidenceHorizon } from '../../shared/core/events.js';
+import { appendLedger } from '../../operator/runtime.js';
+import { emitEvent } from '../../shared/observability/emit.js';
+import { defaultGoalScopeForRoot, inferGateProfile, isOperatorRepo, } from '../../shared/workflow/activation/gateProfiles.js';
+export function lifecycleNow() {
+    return new Date().toISOString();
+}
+export function buildLifecycleCore(args) {
+    const timestamp = lifecycleNow();
+    return {
+        id: args.id,
+        active: true,
+        phase: args.phase,
+        history: args.history,
+        goalScope: args.goalScope,
+        gateProfile: args.gateProfile,
+        createdAt: timestamp,
+        updatedAt: timestamp,
+    };
+}
+function refineScope(root, scope, profile) {
+    if (scope !== undefined) {
+        return scope;
+    }
+    let resolvedScope = defaultGoalScopeForRoot(root);
+    if (profile === 'operator-runtime') {
+        resolvedScope = 'operator-runtime';
+    }
+    else if (profile === 'operator-replacement') {
+        resolvedScope = 'operator-replacement';
+    }
+    return resolvedScope;
+}
+export function resolveLifecycleStartScopeAndProfile(root, args) {
+    let resolvedProfile = args.explicitGateProfile;
+    if (resolvedProfile === undefined) {
+        const inferred = inferGateProfile(args.text, root);
+        if (inferred !== null) {
+            resolvedProfile = inferred;
+        }
+        else if (isOperatorRepo(root)) {
+            throw Object.assign(new Error(`${args.contextLabel}: cannot infer gate profile for "${args.text}" in the enact-operator repo. ` +
+                `Please provide an explicit gateProfile ('repo-delivery', 'operator-runtime', or 'operator-replacement').`), {
+                code: 'GATE_PROFILE_REQUIRED',
+                root,
+                text: args.text,
+                hint: args.hint,
+            });
+        }
+    }
+    return {
+        resolvedProfile,
+        resolvedScope: refineScope(root, args.explicitGoalScope, resolvedProfile),
+    };
+}
+export function resolveLifecycleRetargetScopeAndProfile(root, args) {
+    let resolvedProfile = args.explicitGateProfile ?? args.currentGateProfile;
+    if (args.explicitGateProfile === undefined) {
+        const inferred = inferGateProfile(args.text, root);
+        if (inferred !== null) {
+            resolvedProfile = inferred;
+        }
+        else if (resolvedProfile === undefined && isOperatorRepo(root)) {
+            throw new Error(`${args.contextLabel}: cannot infer gate profile for "${args.text}" in the enact-operator repo. Provide an explicit gateProfile.`);
+        }
+    }
+    return {
+        resolvedProfile,
+        resolvedScope: refineScope(root, args.explicitGoalScope ?? args.currentGoalScope, resolvedProfile),
+    };
+}
+export function assertLifecycleTransitionAllowed(label, id, currentPhase, nextPhase, transitions) {
+    const allowed = transitions[currentPhase];
+    if (!allowed.includes(nextPhase)) {
+        throw new Error(`Invalid transition for ${label} "${id}": "${currentPhase}" → "${nextPhase}" is not allowed. Allowed targets: [${allowed.join(', ') || 'none'}].`);
+    }
+}
+export function recordLifecyclePhaseTransition(root, args) {
+    appendLedger(root, {
+        kind: 'session',
+        action: args.sessionAction,
+        detail: args.sessionDetail,
+        actor: args.actor,
+        metadata: args.sessionMetadata,
+    });
+    const phaseEvent = {
+        kind: 'phase_transition',
+        action: 'phase_transition',
+        schemaVersion: 1,
+        correlationId: `phase_${randomUUID().slice(0, 12)}`,
+        modeType: args.modeType,
+        modeId: args.laneId,
+        fromPhase: args.fromPhase,
+        toPhase: args.toPhase,
+        trigger: args.trigger ?? 'operator',
+        evidenceHorizon: createEvidenceHorizon(root),
+    };
+    appendLedger(root, {
+        kind: 'phase_transition',
+        action: phaseEvent.action,
+        detail: `Phase transition ${args.modeType} "${args.laneId}": "${args.fromPhase}" → "${args.toPhase}"`,
+        metadata: phaseEvent,
+    });
+    void emitEvent({
+        schema_version: 'enact.raw.v1',
+        source: 'enact-operator',
+        event_type: 'state.transition',
+        session_id: args.sessionId ?? 'unknown',
+        run_id: args.runId ?? args.sessionId ?? args.laneId,
+        ts: lifecycleNow(),
+        payload: {
+            'openinference.span.kind': 'CHAIN',
+            'enact.entity': args.modeType,
+            'enact.entity_id': args.laneId,
+            'enact.from_state': args.fromPhase,
+            'enact.to_state': args.toPhase,
+            'enact.actor': args.actor ?? 'system',
+            'enact.hook_event': args.trigger ?? 'operator',
+        },
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function packagedHooksHandlersPath(): string;
+//# sourceMappingURL=packagePaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packagePaths.d.ts","sourceRoot":"","sources":["../../../src/shared/core/packagePaths.ts"],"names":[],"mappings":"AAOA,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}

package/dist/shared/core/packagePaths.js

@@ -0,0 +1,9 @@
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function packageRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+}
+export function packagedHooksHandlersPath() {
+    return join(packageRoot(), 'runtime', 'hooks');
+}
+//# sourceMappingURL=packagePaths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packagePaths.js","sourceRoot":"","sources":["../../../src/shared/core/packagePaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * ENACT operator vocabulary (operator runtime only).
+ *
+ * - **OperatorTask** (`state/tasks.json`): local operator task; id prefix `task_*`.
+ * - **Session task** (`state/session-tasks.json`): MCP/session-scoped work units.
+ * - **assignmentRef**: opaque factory/board reference on mode state (never AzDO sync here).
+ * - **taskId** on reviews/inbox/ledger/team: always a OperatorTask id or externalId link.
+ *
+ * Factory-owned tasks live in enact-factory only.
+ */
+export type OperatorAssignmentRef = string;
+export type TaskIdCarrier = {
+    taskId?: string;
+};
+export declare function coalesceTaskId(carrier: TaskIdCarrier | undefined | null): string | undefined;
+export declare function withCanonicalTaskId<T extends TaskIdCarrier>(record: T): T & {
+    taskId: string;
+};
+export type AssignmentRefCarrier = {
+    assignmentRef?: string;
+};
+export declare function coalesceAssignmentRef(carrier: AssignmentRefCarrier | undefined | null): string | undefined;
+export declare function withCanonicalAssignmentRef<T extends AssignmentRefCarrier>(record: T): T & {
+    assignmentRef: string;
+};
+export declare const CANONICAL_LEDGER_KINDS: {
+    readonly task: "task";
+    readonly taskManualClose: "task_manual_close";
+    /** Factory alias: factory_workitem_acknowledge_close emits this kind; treated as task_manual_close by stop-policy. */
+    readonly workitemManualClose: "workitem_manual_close";
+    readonly taskCloseDeferred: "task_close_deferred";
+};
+export declare function isManualTaskCloseLedgerKind(kind: string): boolean;
+export declare function isTaskCloseDeferredLedgerKind(kind: string): boolean;
+export declare function ledgerEntryTaskId(entry: TaskIdCarrier & {
+    metadata?: Record<string, unknown>;
+}): string | undefined;
+//# sourceMappingURL=terminology.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminology.d.ts","sourceRoot":"","sources":["../../../src/shared/core/terminology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAG5F;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAM9F;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAG1G;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,oBAAoB,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAMnH;AAED,eAAO,MAAM,sBAAsB;;;IAGjC,sHAAsH;;;CAG9G,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAInH"}

package/dist/shared/core/terminology.js

@@ -0,0 +1,54 @@
+/**
+ * ENACT operator vocabulary (operator runtime only).
+ *
+ * - **OperatorTask** (`state/tasks.json`): local operator task; id prefix `task_*`.
+ * - **Session task** (`state/session-tasks.json`): MCP/session-scoped work units.
+ * - **assignmentRef**: opaque factory/board reference on mode state (never AzDO sync here).
+ * - **taskId** on reviews/inbox/ledger/team: always a OperatorTask id or externalId link.
+ *
+ * Factory-owned tasks live in enact-factory only.
+ */
+export function coalesceTaskId(carrier) {
+    if (!carrier)
+        return undefined;
+    return typeof carrier.taskId === 'string' && carrier.taskId.length > 0 ? carrier.taskId : undefined;
+}
+export function withCanonicalTaskId(record) {
+    const taskId = coalesceTaskId(record);
+    if (!taskId) {
+        throw new Error('taskId is required');
+    }
+    return { ...record, taskId };
+}
+export function coalesceAssignmentRef(carrier) {
+    if (!carrier)
+        return undefined;
+    return typeof carrier.assignmentRef === 'string' && carrier.assignmentRef.length > 0 ? carrier.assignmentRef : undefined;
+}
+export function withCanonicalAssignmentRef(record) {
+    const assignmentRef = coalesceAssignmentRef(record);
+    if (!assignmentRef) {
+        throw new Error('assignmentRef is required');
+    }
+    return { ...record, assignmentRef };
+}
+export const CANONICAL_LEDGER_KINDS = {
+    task: 'task',
+    taskManualClose: 'task_manual_close',
+    /** Factory alias: factory_workitem_acknowledge_close emits this kind; treated as task_manual_close by stop-policy. */
+    workitemManualClose: 'workitem_manual_close',
+    taskCloseDeferred: 'task_close_deferred',
+};
+export function isManualTaskCloseLedgerKind(kind) {
+    return kind === CANONICAL_LEDGER_KINDS.taskManualClose
+        || kind === CANONICAL_LEDGER_KINDS.workitemManualClose;
+}
+export function isTaskCloseDeferredLedgerKind(kind) {
+    return kind === CANONICAL_LEDGER_KINDS.taskCloseDeferred;
+}
+export function ledgerEntryTaskId(entry) {
+    return coalesceTaskId(entry) ?? (typeof entry.metadata?.taskId === 'string'
+        ? entry.metadata.taskId
+        : undefined);
+}
+//# sourceMappingURL=terminology.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminology.js","sourceRoot":"","sources":["../../../src/shared/core/terminology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,UAAU,cAAc,CAAC,OAAyC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAA0B,MAAS;IACpE,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAID,MAAM,UAAU,qBAAqB,CAAC,OAAgD;IACpF,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAiC,MAAS;IAClF,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM;IACZ,eAAe,EAAE,mBAAmB;IACpC,sHAAsH;IACtH,mBAAmB,EAAE,uBAAuB;IAC5C,iBAAiB,EAAE,qBAAqB;CAChC,CAAC;AAEX,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,OAAO,IAAI,KAAK,sBAAsB,CAAC,eAAe;WACjD,IAAI,KAAK,sBAAsB,CAAC,mBAAmB,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,OAAO,IAAI,KAAK,sBAAsB,CAAC,iBAAiB,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA6D;IAC7F,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,QAAQ;QACzE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM;QACvB,CAAC,CAAC,SAAS,CAAC,CAAC;AACjB,CAAC"}