@amsterdamdatalabs/enact-operator 0.1.2

package/dist/shared/state/state.js

@@ -0,0 +1,91 @@
+import { existsSync, readdirSync, rmSync } from 'node:fs';
+import { z } from 'zod';
+import { layoutDir, ensureLayout, stateFile } from '../../shared/core/contract.js';
+import { readJsonFile, validateJsonFile, writeJson } from '../../shared/core/json.js';
+const MODE_STATE_SCHEMA_VERSION = 1;
+const OperatorModeStateSchema = z.object({
+    schemaVersion: z.literal(MODE_STATE_SCHEMA_VERSION),
+    mode: z.string(),
+    data: z.unknown(),
+    updatedAt: z.string(),
+});
+function migrateModeState(mode, fallback, raw) {
+    // Legacy migration: older builds persisted some mode states as a bare top-level array
+    // (e.g. the raw workItems list) before the envelope schema existed. Wrap such a value as
+    // `data` instead of throwing, so stale on-disk state self-heals on the next write rather
+    // than hard-failing every operator hook (SessionStart/Stop/etc.).
+    if (Array.isArray(raw)) {
+        return {
+            schemaVersion: MODE_STATE_SCHEMA_VERSION,
+            mode,
+            data: raw,
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    if (raw === null || typeof raw !== 'object') {
+        throw new Error(`Mode state for ${mode} must be an object.`);
+    }
+    const state = raw;
+    const schemaVersion = typeof state.schemaVersion === 'number' ? state.schemaVersion : 0;
+    if (schemaVersion !== 0 && schemaVersion !== MODE_STATE_SCHEMA_VERSION) {
+        throw new Error(`Unsupported schemaVersion ${schemaVersion} for mode ${mode}.`);
+    }
+    return {
+        schemaVersion: MODE_STATE_SCHEMA_VERSION,
+        mode: typeof state.mode === 'string' ? state.mode : mode,
+        data: (state.data ?? fallback),
+        updatedAt: typeof state.updatedAt === 'string' ? state.updatedAt : new Date().toISOString(),
+    };
+}
+export function readModeState(root, mode, fallback) {
+    ensureLayout(root);
+    const path = stateFile(root, mode);
+    const raw = readJsonFile(path);
+    if (raw === undefined) {
+        return {
+            schemaVersion: MODE_STATE_SCHEMA_VERSION,
+            mode,
+            data: fallback,
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    return validateJsonFile(path, migrateModeState(mode, fallback, raw), OperatorModeStateSchema);
+}
+export function writeModeState(root, mode, data, options = {}) {
+    ensureLayout(root);
+    const existing = readModeState(root, mode, data);
+    const merged = options.replace
+        ? data
+        : typeof existing.data === 'object'
+            && existing.data !== null
+            && !Array.isArray(existing.data)
+            && typeof data === 'object'
+            && data !== null
+            && !Array.isArray(data)
+            ? { ...existing.data, ...data }
+            : data;
+    const next = {
+        schemaVersion: MODE_STATE_SCHEMA_VERSION,
+        mode,
+        data: merged,
+        updatedAt: new Date().toISOString(),
+    };
+    writeJson(stateFile(root, mode), next);
+    return next;
+}
+export function clearModeState(root, mode) {
+    ensureLayout(root);
+    const path = stateFile(root, mode);
+    const cleared = existsSync(path);
+    rmSync(path, { force: true });
+    return { mode, cleared };
+}
+export function listModeStates(root) {
+    ensureLayout(root);
+    const stateDir = `${layoutDir(root)}/state`;
+    return readdirSync(stateDir, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith('.json'))
+        .map((entry) => entry.name.replace(/\.json$/, ''))
+        .sort();
+}
+//# sourceMappingURL=state.js.map

package/dist/shared/state/state.js.map

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

package/dist/shared/state/tasks.d.ts

@@ -0,0 +1,113 @@
+export type OperatorTaskStatus = 'pending' | 'queued' | 'in_progress' | 'blocked' | 'review' | 'superseded' | 'completed' | 'failed' | 'cancelled';
+export interface OperatorTaskEvent {
+    status: OperatorTaskStatus;
+    at: string;
+    by?: string;
+    note?: string;
+}
+export type ClosureScope = 'lane-local' | 'integration' | 'repo-end-to-end';
+export interface OperatorTask {
+    schemaVersion: 1;
+    id: string;
+    externalId: string;
+    /** Optional factory/board assignment reference (opaque). */
+    assignmentRef?: string;
+    title: string;
+    kind: string;
+    phase: string;
+    status: OperatorTaskStatus;
+    priority: 'low' | 'medium' | 'high';
+    owner?: string;
+    worktree?: {
+        branchName?: string;
+        worktreePath?: string;
+        ownerAgent?: string;
+        leaseExpiresAt?: string;
+    };
+    verify: string[];
+    notes: string[];
+    metadata: Record<string, unknown>;
+    dependencies: string[];
+    blockers: string[];
+    reviewStatus: 'none' | 'pending' | 'approved' | 'changes_requested';
+    /** Phase 5: additive convergence metadata. */
+    reviewStale?: boolean;
+    blockerStale?: boolean;
+    evidenceOutdated?: boolean;
+    claimedAt?: string;
+    completedAt?: string;
+    result?: string;
+    history: OperatorTaskEvent[];
+    createdAt: string;
+    updatedAt: string;
+    /** Phase 3: closure scope. Stored independently — never re-derived at read time. */
+    closureScope?: ClosureScope;
+}
+export interface CreateTaskInput {
+    title: string;
+    kind?: string;
+    phase?: string;
+    priority?: OperatorTask['priority'];
+    verify?: string[];
+    notes?: string[];
+    metadata?: Record<string, unknown>;
+    dependencies?: string[];
+}
+export type LaneTrackerMode = 'autopilot' | 'ralph' | 'ultrawork' | 'team';
+export interface LaneTrackerTaskOptions {
+    title: string;
+    ownerMode: LaneTrackerMode;
+    ownerStateId: string;
+    phase?: string;
+    priority?: OperatorTask['priority'];
+    initialStatus?: OperatorTaskStatus;
+    closureScope?: ClosureScope;
+    goalScope?: string;
+    gateProfile?: string;
+}
+export interface UpsertOperatorTaskInput {
+    externalId: string;
+    /** Optional factory/board assignment reference (opaque). */
+    assignmentRef?: string;
+    title: string;
+    kind?: string;
+    phase?: string;
+    status: OperatorTaskStatus;
+    priority?: OperatorTask['priority'];
+    owner?: string;
+    worktree?: OperatorTask['worktree'];
+    verify?: string[];
+    notes?: string[];
+    metadata?: Record<string, unknown>;
+    dependencies?: string[];
+    blockers?: string[];
+    reviewStatus?: OperatorTask['reviewStatus'];
+    closureScope?: ClosureScope;
+}
+export declare function createTask(root: string, input: CreateTaskInput): OperatorTask;
+export declare function isLaneTrackerTask(task: OperatorTask, ownerMode?: LaneTrackerMode, ownerStateId?: string): boolean;
+export declare function createLaneTrackerTask(root: string, options: LaneTrackerTaskOptions): OperatorTask;
+export declare function syncLaneTrackerTasks(root: string, options: {
+    ownerMode: LaneTrackerMode;
+    ownerStateId: string;
+    taskIds: string[];
+    status?: OperatorTaskStatus;
+    title?: string;
+    result?: string;
+    closureScope?: ClosureScope;
+}): OperatorTask[];
+export declare function getTask(root: string, taskId: string): OperatorTask | null;
+export declare function updateTask(root: string, taskId: string, patch: Partial<Omit<OperatorTask, 'id' | 'createdAt' | 'history'>>, actor?: string): OperatorTask | null;
+export declare function listTasks(root: string, status?: OperatorTaskStatus): OperatorTask[];
+export declare function deleteTask(root: string, taskId: string): {
+    taskId: string;
+    deleted: boolean;
+};
+export declare function clearTasks(root: string): {
+    cleared: number;
+};
+export declare function upsertTask(root: string, input: UpsertOperatorTaskInput, actor?: string): {
+    task: OperatorTask;
+    previous: OperatorTask | null;
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/shared/state/tasks.d.ts.map

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

package/dist/shared/state/tasks.js

@@ -0,0 +1,274 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { tasksFile } from '../../shared/core/contract.js';
+import { readJsonFile, validateJsonFile, writeJson } from '../../shared/core/json.js';
+import { emitEvent } from '../../shared/observability/emit.js';
+const TASK_SCHEMA_VERSION = 1;
+const OperatorTaskEventSchema = z.object({
+    status: z.enum(['pending', 'queued', 'in_progress', 'blocked', 'review', 'superseded', 'completed', 'failed', 'cancelled']),
+    at: z.string(),
+    by: z.string().optional(),
+    note: z.string().optional(),
+});
+const OperatorTaskWorktreeSchema = z.object({
+    branchName: z.string().optional(),
+    worktreePath: z.string().optional(),
+    ownerAgent: z.string().optional(),
+    leaseExpiresAt: z.string().optional(),
+});
+const OperatorTaskSchema = z.object({
+    schemaVersion: z.literal(TASK_SCHEMA_VERSION),
+    id: z.string(),
+    externalId: z.string(),
+    assignmentRef: z.string().optional(),
+    title: z.string(),
+    kind: z.string(),
+    phase: z.string(),
+    status: z.enum(['pending', 'queued', 'in_progress', 'blocked', 'review', 'superseded', 'completed', 'failed', 'cancelled']),
+    priority: z.enum(['low', 'medium', 'high']),
+    owner: z.string().optional(),
+    worktree: OperatorTaskWorktreeSchema.optional(),
+    verify: z.array(z.string()),
+    notes: z.array(z.string()),
+    metadata: z.record(z.string(), z.unknown()),
+    dependencies: z.array(z.string()),
+    blockers: z.array(z.string()),
+    reviewStatus: z.enum(['none', 'pending', 'approved', 'changes_requested']),
+    reviewStale: z.boolean().optional(),
+    blockerStale: z.boolean().optional(),
+    evidenceOutdated: z.boolean().optional(),
+    claimedAt: z.string().optional(),
+    completedAt: z.string().optional(),
+    result: z.string().optional(),
+    history: z.array(OperatorTaskEventSchema),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    closureScope: z.enum(['lane-local', 'integration', 'repo-end-to-end']).optional(),
+});
+function now() {
+    return new Date().toISOString();
+}
+function migrateTaskRecord(raw) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('task record must be an object');
+    }
+    const record = raw;
+    const schemaVersion = typeof record.schemaVersion === 'number' ? record.schemaVersion : 0;
+    if (schemaVersion !== 0 && schemaVersion !== TASK_SCHEMA_VERSION) {
+        throw new Error(`unsupported schemaVersion ${schemaVersion}`);
+    }
+    return {
+        ...record,
+        schemaVersion: TASK_SCHEMA_VERSION,
+    };
+}
+function load(root) {
+    const path = tasksFile(root);
+    const raw = readJsonFile(path);
+    if (raw === undefined) {
+        return [];
+    }
+    if (!Array.isArray(raw)) {
+        throw new Error(`task state at ${path} must be an array.`);
+    }
+    return raw.map((entry, index) => validateJsonFile(`${path}[${index}]`, migrateTaskRecord(entry), OperatorTaskSchema));
+}
+function save(root, tasks) {
+    writeJson(tasksFile(root), tasks);
+}
+export function createTask(root, input) {
+    const createdAt = now();
+    const id = `task_${randomUUID().slice(0, 12)}`;
+    const task = {
+        schemaVersion: TASK_SCHEMA_VERSION,
+        id,
+        externalId: id,
+        title: input.title,
+        kind: input.kind ?? 'general',
+        phase: input.phase ?? 'default',
+        status: 'pending',
+        priority: input.priority ?? 'medium',
+        verify: input.verify ?? [],
+        notes: input.notes ?? [],
+        metadata: input.metadata ?? {},
+        dependencies: input.dependencies ?? [],
+        blockers: [],
+        reviewStatus: 'none',
+        history: [{ status: 'pending', at: createdAt, note: 'task created' }],
+        createdAt,
+        updatedAt: createdAt,
+    };
+    const tasks = load(root);
+    tasks.push(task);
+    save(root, tasks);
+    return task;
+}
+export function isLaneTrackerTask(task, ownerMode, ownerStateId) {
+    const trackerKind = task.metadata?.['trackerKind'];
+    const trackerMode = task.metadata?.['ownerMode'];
+    const trackerStateId = task.metadata?.['ownerStateId'];
+    if (trackerKind !== 'lane-bootstrap')
+        return false;
+    if (ownerMode && trackerMode !== ownerMode)
+        return false;
+    if (ownerStateId && trackerStateId !== ownerStateId)
+        return false;
+    return true;
+}
+export function createLaneTrackerTask(root, options) {
+    const created = createTask(root, {
+        title: options.title,
+        kind: 'lane-tracker',
+        phase: options.phase ?? options.ownerMode,
+        priority: options.priority ?? 'medium',
+        metadata: {
+            trackerKind: 'lane-bootstrap',
+            localOnly: true,
+            ownerMode: options.ownerMode,
+            ownerStateId: options.ownerStateId,
+            ...(options.goalScope ? { goalScope: options.goalScope } : {}),
+            ...(options.gateProfile ? { gateProfile: options.gateProfile } : {}),
+        },
+    });
+    const initialStatus = options.initialStatus ?? 'pending';
+    if (initialStatus === 'pending' && options.closureScope === undefined) {
+        return created;
+    }
+    return updateTask(root, created.id, {
+        status: initialStatus,
+        ...(options.closureScope ? { closureScope: options.closureScope } : {}),
+    }, 'enact-operator') ?? created;
+}
+export function syncLaneTrackerTasks(root, options) {
+    const ids = new Set(options.taskIds);
+    const trackers = listTasks(root).filter((task) => ids.has(task.id)
+        && isLaneTrackerTask(task, options.ownerMode, options.ownerStateId));
+    return trackers
+        .map((task) => updateTask(root, task.id, {
+        ...(options.status ? { status: options.status } : {}),
+        ...(options.title ? { title: options.title } : {}),
+        ...(options.result ? { result: options.result } : {}),
+        ...(options.closureScope ? { closureScope: options.closureScope } : {}),
+    }, 'enact-operator'))
+        .filter((task) => task !== null);
+}
+export function getTask(root, taskId) {
+    return load(root).find((task) => task.id === taskId) ?? null;
+}
+export function updateTask(root, taskId, patch, actor) {
+    const tasks = load(root);
+    const index = tasks.findIndex((task) => task.id === taskId);
+    if (index === -1) {
+        return null;
+    }
+    const current = tasks[index];
+    const nextStatus = patch.status ?? current.status;
+    const history = nextStatus !== current.status
+        ? [
+            ...current.history,
+            {
+                status: nextStatus,
+                at: now(),
+                by: actor,
+                note: typeof patch.result === 'string' ? patch.result : undefined,
+            },
+        ]
+        : current.history;
+    const next = {
+        ...current,
+        ...patch,
+        schemaVersion: TASK_SCHEMA_VERSION,
+        history,
+        updatedAt: now(),
+    };
+    tasks[index] = next;
+    save(root, tasks);
+    if (nextStatus !== current.status) {
+        void emitEvent({
+            schema_version: 'enact.raw.v1',
+            source: 'enact-operator',
+            event_type: 'state.transition',
+            session_id: (typeof next.metadata?.sessionId === 'string' && next.metadata.sessionId)
+                || 'unknown',
+            run_id: next.assignmentRef ?? next.id,
+            ts: now(),
+            payload: {
+                'openinference.span.kind': 'CHAIN',
+                'enact.entity': 'task',
+                'enact.entity_id': next.id,
+                'enact.from_state': current.status,
+                'enact.to_state': next.status,
+                'enact.actor': actor ?? 'system',
+            },
+        });
+    }
+    return next;
+}
+export function listTasks(root, status) {
+    const tasks = load(root);
+    return status ? tasks.filter((task) => task.status === status) : tasks;
+}
+export function deleteTask(root, taskId) {
+    const tasks = load(root);
+    const next = tasks.filter((task) => task.id !== taskId);
+    const deleted = next.length !== tasks.length;
+    if (deleted) {
+        save(root, next);
+    }
+    return { taskId, deleted };
+}
+export function clearTasks(root) {
+    const tasks = load(root);
+    save(root, []);
+    return { cleared: tasks.length };
+}
+export function upsertTask(root, input, actor) {
+    const tasks = load(root);
+    const index = tasks.findIndex((task) => task.externalId === input.externalId);
+    const previous = index >= 0 ? tasks[index] : null;
+    const timestamp = now();
+    const statusChanged = previous ? previous.status !== input.status : true;
+    const history = previous
+        ? statusChanged
+            ? [
+                ...previous.history,
+                { status: input.status, at: timestamp, by: actor, note: input.notes?.[0] },
+            ]
+            : previous.history
+        : [
+            { status: input.status, at: timestamp, by: actor, note: input.notes?.[0] },
+        ];
+    const next = {
+        schemaVersion: TASK_SCHEMA_VERSION,
+        id: previous?.id ?? `operator_task_${randomUUID().slice(0, 12)}`,
+        externalId: input.externalId,
+        assignmentRef: input.assignmentRef ?? previous?.assignmentRef,
+        title: input.title,
+        kind: input.kind ?? previous?.kind ?? 'operator-lane',
+        phase: input.phase ?? previous?.phase ?? 'operator',
+        status: input.status,
+        priority: input.priority ?? previous?.priority ?? 'medium',
+        owner: input.owner ?? previous?.owner,
+        worktree: input.worktree ?? previous?.worktree,
+        verify: input.verify ?? previous?.verify ?? [],
+        notes: input.notes ?? previous?.notes ?? [],
+        metadata: input.metadata ?? previous?.metadata ?? {},
+        dependencies: input.dependencies ?? previous?.dependencies ?? [],
+        blockers: input.blockers ?? previous?.blockers ?? [],
+        reviewStatus: input.reviewStatus ?? previous?.reviewStatus ?? 'none',
+        history,
+        createdAt: previous?.createdAt ?? timestamp,
+        updatedAt: timestamp,
+        completedAt: input.status === 'completed' ? timestamp : previous?.completedAt,
+        closureScope: input.closureScope ?? previous?.closureScope,
+    };
+    if (index >= 0) {
+        tasks[index] = next;
+    }
+    else {
+        tasks.push(next);
+    }
+    save(root, tasks);
+    return { task: next, previous };
+}
+//# sourceMappingURL=tasks.js.map

package/dist/shared/state/tasks.js.map

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

package/dist/shared/workflow/activation/activeSkill.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export declare const KNOWN_SKILLS: readonly ["ralph", "ralplan", "team", "ultrawork", "autopilot", "ultragoal", "ultraqa"];
+export type KnownSkill = (typeof KNOWN_SKILLS)[number];
+export declare function isKnownSkill(name: string): name is KnownSkill;
+export declare const ActiveSkillStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    skill: z.ZodNullable<z.ZodEnum<{
+        autopilot: "autopilot";
+        ralph: "ralph";
+        ultrawork: "ultrawork";
+        team: "team";
+        ralplan: "ralplan";
+        ultragoal: "ultragoal";
+        ultraqa: "ultraqa";
+    }>>;
+    activeSkills: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        autopilot: "autopilot";
+        ralph: "ralph";
+        ultrawork: "ultrawork";
+        team: "team";
+        ralplan: "ralplan";
+        ultragoal: "ultragoal";
+        ultraqa: "ultraqa";
+    }>>>;
+    since: z.ZodNullable<z.ZodString>;
+    setBy: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ActiveSkillState = z.infer<typeof ActiveSkillStateSchema>;
+/**
+ * Read and validate the active-skill state file.
+ * Returns null-skill default when file is absent, corrupt, or schema version mismatches.
+ */
+export declare function readActiveSkill(root: string): ActiveSkillState;
+/**
+ * Write the active-skill state file atomically.
+ * Validates skill against the known enum — throws on unknown skill name.
+ */
+export declare function writeActiveSkill(root: string, skill: string | null, setBy: string): void;
+/**
+ * Clear the active skill (sets skill=null). Convenience wrapper around writeActiveSkill.
+ */
+export declare function clearActiveSkill(root: string, setBy: string): void;
+export declare function activateActiveSkill(root: string, skill: KnownSkill, setBy: string): ActiveSkillState;
+export declare function deactivateActiveSkill(root: string, setBy: string, skill?: KnownSkill | null): ActiveSkillState;
+export declare function listActiveSkills(state: ActiveSkillState): KnownSkill[];
+//# sourceMappingURL=activeSkill.d.ts.map

package/dist/shared/workflow/activation/activeSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeSkill.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/activation/activeSkill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,YAAY,yFAAsH,CAAC;AAEhJ,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,UAAU,CAE7D;AAMD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;iBAMjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAoBtE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA6B9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAgBxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAapG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,gBAAgB,CAqC9G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAEtE"}