@amsterdamdatalabs/enact-operator 0.1.2

package/dist/shared/workflow/continuation/continuationOrchestrator.js

@@ -0,0 +1,144 @@
+/**
+ * Atlas-equivalent continuation orchestrator (Plan 12).
+ *
+ * TWIN note: runtime/hooks/_continuation.mjs is the runtime .mjs twin of this file.
+ * If logic changes here it MUST be reflected in _continuation.mjs, and vice-versa.
+ * The .mjs twin replicates isManualTaskCloseLedgerKind and isProtectedOperatorStatePath
+ * inline (those are TS-only; cannot be imported into .mjs at runtime).
+ *
+ * Single integration sink that wires together all five predecessor surfaces so
+ * active tasks, delegated sessions, and background work survive idle / stop /
+ * compaction boundaries.
+ *
+ * Per INV-031 the main enact-agent decides and orchestrates; runtime executes
+ * explicit graph nodes only. This module is therefore legitimately
+ * exported-only: the agent runtime (session-start.mjs / pre-compact.mjs hooks
+ * and the MCP operator tools) is the authoritative external caller. It is NOT
+ * dead code — it is the integration sink those callers import at runtime.
+ *
+ * Predecessor surfaces wired here:
+ *   Slice 1 (subagent-tracker): recordSubagentStartedOnContinuation /
+ *     recordSubagentStoppedOnContinuation — now reliable because
+ *     subagent-tracker.mjs no longer crashes on SubagentStart/SubagentStop.
+ *   Slice 2 (pre-compact): hasPendingLocalTasks — detects compaction survivors
+ *     written by pre-compact.mjs's compaction-context.json write path.
+ *   Slice 8 (protected-state): all state reads route through the Operator-owned
+ *     broker (readContinuationState, readDelegatedSessionsState) rather than
+ *     raw fs access.
+ *   Slice 9 (team-transforms): captureActiveWorkflows + team-mailbox injection
+ *     and role-gating layer is applied before re-enqueueing team work.
+ *   Slice 10 (close-vocabulary): readContinuationFollowUpQueue /
+ *     enqueueContinuationFollowUp — unified close-event vocabulary so both
+ *     Factory workitem_manual_close and Operator task_manual_close unblock the
+ *     follow-up queue.
+ */
+import { readContinuationState, writeContinuationState, buildContinuationGuidance, hasPendingLocalTasks, recordSubagentStartedOnContinuation, recordSubagentStoppedOnContinuation, } from '../../../shared/workflow/continuation/continuation.js';
+import { captureActiveWorkflows } from '../../../shared/workflow/continuation/hookContinuation.js';
+import { listSessionTasks, } from '../../../shared/workflow/delegation/sessionTasks.js';
+import { buildDelegatedSessionResumePlan, reconcileDelegatedSessions, } from '../../../shared/workflow/delegation/delegatedSession.js';
+import { readContinuationFollowUpQueue, enqueueContinuationFollowUp, buildSessionIdleDedupeKey, buildDelegatedFollowUpDedupeKey, } from '../../../shared/workflow/continuation/continuationFollowUp.js';
+import { readOperatorAuthority } from '../../../shared/workflow/authority/authority.js';
+/**
+ * Orchestrate continuation state across an idle / stop / compaction boundary.
+ *
+ * This is the single integration sink referenced by the atlas plan.
+ */
+export function orchestrateContinuation(root, trigger) {
+    const capturedAt = new Date().toISOString();
+    // ── Slice 9: capture active workflows (ralph/ultrawork/autopilot/team) ────
+    const activeWorkflows = captureActiveWorkflows(root);
+    // ── Slice 8: all state reads via Operator broker (continuation + delegated) ─
+    const contState = readContinuationState(root);
+    const authority = readOperatorAuthority(root);
+    const guidance = buildContinuationGuidance(authority);
+    // ── Slice 2: detect compaction survivors ─────────────────────────────────
+    const hasCompactionSurvivors = hasPendingLocalTasks(guidance);
+    // ── Slice 1: surface active subagent IDs from continuation state ──────────
+    const activeSubagentIds = contState.activeSubagentIds ?? [];
+    // ── Gap-close: re-enqueue sessionTasks into continuation pendingTaskIds ───
+    const allSessionTasks = listSessionTasks(root);
+    const pendingSessionTasks = allSessionTasks.filter((t) => t.status === 'pending' || t.status === 'active' || t.status === 'blocked');
+    const pendingSessionTaskIds = pendingSessionTasks.map((t) => t.id);
+    // Merge sessionTask IDs into continuation state pendingTaskIds so they
+    // survive the SessionStart restore (closing the gap proven by the red test).
+    if (pendingSessionTaskIds.length > 0) {
+        const merged = Array.from(new Set([...contState.pendingTaskIds, ...pendingSessionTaskIds]));
+        writeContinuationState(root, {
+            ...contState,
+            pendingTaskIds: merged,
+        });
+    }
+    // ── Gap-close: detect + build resume plans for stale delegated sessions ───
+    const { state: delegatedState } = reconcileDelegatedSessions(root);
+    const resumableSessions = delegatedState.sessions.filter((s) => s.status === 'active' || s.status === 'stale');
+    const delegatedSessionResumePlans = resumableSessions.map((s) => buildDelegatedSessionResumePlan(root, s.continuationId));
+    // ── Slice 10: enqueue follow-ups via close-vocabulary queue ───────────────
+    let followUpQueuedCount = 0;
+    // Enqueue a session-idle follow-up for stale delegated sessions
+    for (const plan of delegatedSessionResumePlans) {
+        const lane = (contState.lane === 'none' ? 'none' : contState.lane);
+        const dedupeKey = buildDelegatedFollowUpDedupeKey(plan.continuationId, trigger);
+        const result = enqueueContinuationFollowUp(root, {
+            sessionId: contState.lastSessionId,
+            dedupeKey,
+            trigger: 'recovery',
+            lane,
+            laneId: contState.laneId,
+            prompt: `Continuation orchestrator (${trigger}): delegated session ${plan.continuationId} (${plan.session?.kind ?? 'unknown'}) needs attention. Decision: ${plan.decision}. ${plan.reason}`,
+            metadata: {
+                continuationId: plan.continuationId,
+                trigger,
+                source: 'atlas-continuation-orchestrator',
+                decision: plan.decision,
+            },
+        });
+        if (result.outcome === 'queued') {
+            followUpQueuedCount += 1;
+        }
+    }
+    // For idle/stop triggers, also enqueue a session-idle follow-up if there are
+    // pending session tasks that aren't yet covered by the guidance lane
+    if ((trigger === 'idle' || trigger === 'stop') && pendingSessionTaskIds.length > 0) {
+        const lane = (contState.lane === 'none' ? 'none' : contState.lane);
+        const dedupeKey = buildSessionIdleDedupeKey({
+            sessionId: contState.lastSessionId,
+            lane,
+            laneId: contState.laneId,
+        });
+        const sessionTaskResult = enqueueContinuationFollowUp(root, {
+            sessionId: contState.lastSessionId,
+            dedupeKey,
+            trigger: 'session-idle',
+            lane,
+            laneId: contState.laneId,
+            prompt: `Continuation orchestrator (${trigger}): ${pendingSessionTaskIds.length} pending session task(s) need re-enqueue after ${trigger} boundary. IDs: ${pendingSessionTaskIds.join(', ')}.`,
+            metadata: {
+                pendingSessionTaskIds,
+                trigger,
+                source: 'atlas-continuation-orchestrator',
+            },
+        });
+        if (sessionTaskResult.outcome === 'queued') {
+            followUpQueuedCount += 1;
+        }
+    }
+    // Read final queue state to confirm counts (Slice 10 read surface)
+    const { counts } = readContinuationFollowUpQueue(root);
+    const totalQueued = counts.queued + counts.replayed;
+    return {
+        trigger,
+        capturedAt,
+        activeWorkflows,
+        pendingSessionTaskIds,
+        delegatedSessionResumePlans,
+        hasCompactionSurvivors,
+        followUpQueuedCount: Math.max(followUpQueuedCount, totalQueued > 0 ? followUpQueuedCount : 0),
+        activeSubagentIds,
+    };
+}
+/**
+ * Convenience re-exports so callers can use the Slice 1 subagent lifecycle
+ * surfaces through the orchestrator module without a separate import.
+ */
+export { recordSubagentStartedOnContinuation, recordSubagentStoppedOnContinuation };
+//# sourceMappingURL=continuationOrchestrator.js.map

package/dist/shared/workflow/continuation/continuationOrchestrator.js.map

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

package/dist/shared/workflow/continuation/hookContinuation.d.ts

@@ -0,0 +1,44 @@
+export interface RalphSnapshot {
+    id: string;
+    phase: string;
+    active: boolean;
+    goal: string;
+    updatedAt: string;
+    gatesPassed: number;
+    gatesTotal: number;
+    pendingGateIds: string[];
+}
+export interface UltraworkSnapshot {
+    id: string;
+    phase: string;
+    route: string;
+    active: boolean;
+    intent: string;
+    updatedAt: string;
+}
+export interface AutopilotSnapshot {
+    id: string;
+    phase: string;
+    route: string;
+    active: boolean;
+    intent: string;
+    updatedAt: string;
+}
+export interface TeamSnapshot {
+    id: string;
+    name: string;
+    active: boolean;
+    executorCount: number;
+    queuedTaskCount: number;
+    updatedAt: string;
+}
+export interface ActiveWorkflowSnapshot {
+    autopilot: AutopilotSnapshot | null;
+    ralph: RalphSnapshot | null;
+    team: TeamSnapshot | null;
+    ultrawork: UltraworkSnapshot | null;
+    capturedAt: string;
+}
+export declare function captureActiveWorkflows(root: string): ActiveWorkflowSnapshot;
+export declare function formatContinuationContext(snapshot: ActiveWorkflowSnapshot): string;
+//# sourceMappingURL=hookContinuation.d.ts.map

package/dist/shared/workflow/continuation/hookContinuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookContinuation.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/continuation/hookContinuation.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CA2D3E;AAOD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAwClF"}

package/dist/shared/workflow/continuation/hookContinuation.js

@@ -0,0 +1,85 @@
+import { getAutopilot } from '../../../lanes/autopilot/index.js';
+import { getRalph } from '../../../lanes/ralph/index.js';
+import { readTeam } from '../../../lanes/team/index.js';
+import { getUltrawork } from '../../../lanes/ultrawork/index.js';
+export function captureActiveWorkflows(root) {
+    const autopilotState = getAutopilot(root);
+    const ralphState = getRalph(root);
+    const teamState = readTeam(root);
+    const ultraworkState = getUltrawork(root);
+    const autopilot = autopilotState && autopilotState.active
+        ? {
+            id: autopilotState.id,
+            phase: autopilotState.phase,
+            route: autopilotState.route,
+            active: autopilotState.active,
+            intent: autopilotState.intent,
+            updatedAt: autopilotState.updatedAt,
+        }
+        : null;
+    const ralph = ralphState && ralphState.active
+        ? {
+            id: ralphState.id,
+            phase: ralphState.phase,
+            active: ralphState.active,
+            goal: ralphState.goal,
+            updatedAt: ralphState.updatedAt,
+            gatesPassed: ralphState.verificationGates.filter((g) => g.status === 'passed').length,
+            gatesTotal: ralphState.verificationGates.length,
+            pendingGateIds: ralphState.verificationGates
+                .filter((g) => g.status !== 'passed')
+                .map((g) => g.id),
+        }
+        : null;
+    const team = teamState && teamState.active
+        ? {
+            id: teamState.id,
+            name: teamState.name,
+            active: teamState.active,
+            executorCount: teamState.executors.length,
+            queuedTaskCount: teamState.taskQueue.length,
+            updatedAt: teamState.updatedAt,
+        }
+        : null;
+    const ultrawork = ultraworkState && ultraworkState.active
+        ? {
+            id: ultraworkState.id,
+            phase: ultraworkState.phase,
+            route: ultraworkState.route,
+            active: ultraworkState.active,
+            intent: ultraworkState.intent,
+            updatedAt: ultraworkState.updatedAt,
+        }
+        : null;
+    return { autopilot, ralph, team, ultrawork, capturedAt: new Date().toISOString() };
+}
+function truncate(text, limit = 80) {
+    if (text.length <= limit)
+        return text;
+    return `${text.slice(0, limit - 1)}…`;
+}
+export function formatContinuationContext(snapshot) {
+    const { autopilot, ralph, team, ultrawork } = snapshot;
+    if (!autopilot && !ralph && !team && !ultrawork) {
+        return 'No active workflows.';
+    }
+    const parts = [];
+    if (autopilot) {
+        parts.push(`Autopilot: ${autopilot.phase} (route=${autopilot.route}). Intent: "${truncate(autopilot.intent)}".`);
+    }
+    if (ralph) {
+        const gateSummary = ralph.gatesTotal > 0
+            ? `gates ${ralph.gatesPassed}/${ralph.gatesTotal} passed`
+            : 'no gates registered';
+        const pendingSummary = ralph.pendingGateIds.length > 0 ? `, pending: ${ralph.pendingGateIds.join(', ')}` : '';
+        parts.push(`Ralph: ${ralph.phase} (${gateSummary}${pendingSummary}). Goal: "${truncate(ralph.goal)}".`);
+    }
+    if (ultrawork) {
+        parts.push(`Ultrawork: ${ultrawork.phase} (route=${ultrawork.route}). Intent: "${truncate(ultrawork.intent)}".`);
+    }
+    if (team) {
+        parts.push(`Team: "${truncate(team.name)}" (executors=${team.executorCount}, queuedTasks=${team.queuedTaskCount}).`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=hookContinuation.js.map

package/dist/shared/workflow/continuation/hookContinuation.js.map

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

package/dist/shared/workflow/continuation/stopPolicy.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Phase 7 — Stop-hook closure gate.
+ * Pure evaluator: reads OperatorAuthority and returns a StopVerdict.
+ * No side effects; call from hook, MCP, or CLI for dry-run checks.
+ *
+ * Phase A+B scope: Ralph (B), Ultrawork (C), Team (G), task closure (I).
+ * Phase C/D scope now also enforces autopilot continuity, executor/reviewer handoff, ultragoal
+ * continuity, and staged wrapper skills through the existing durable activation
+ * log + review-handoff artifact + task/review/inbox state.
+ */
+import type { OperatorAuthority } from '../../../shared/workflow/authority/authority.js';
+import { type EvidenceHorizon } from '../../../shared/core/events.js';
+export type StopOutcome = 'allow' | 'deny';
+export type BlockerCategory = 'gate-pending' | 'phase-not-terminal' | 'open-tasks' | 'open-reviews' | 'open-inbox' | 'closure-evidence-missing' | 'job-pending';
+export type StopLane = 'ralph' | 'ultrawork' | 'autopilot' | 'team' | 'session' | 'executor' | 'reviewer' | 'ultragoal' | 'pipeline';
+export interface StopReason {
+    lane: StopLane;
+    laneId?: string;
+    blocker: string;
+    blockerCategory?: BlockerCategory;
+}
+export interface StopVerdict {
+    outcome: StopOutcome;
+    reasons: StopReason[];
+    capturedAt: string;
+    evidenceHorizon: EvidenceHorizon;
+    /**
+     * transportCanBlock: true — verified in interactive Codex TUI on 2026-05-16.
+     * The minimal blocking Stop-hook payload shape is:
+     * { decision:"block", reason:"..." }.
+     */
+    transportCanBlock: boolean;
+}
+export declare function evaluateStopPolicy(input: {
+    authority: OperatorAuthority;
+    root: string;
+}): StopVerdict;
+//# sourceMappingURL=stopPolicy.d.ts.map

package/dist/shared/workflow/continuation/stopPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopPolicy.d.ts","sourceRoot":"","sources":["../../../../src/shared/workflow/continuation/stopPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAGlF,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAOtF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,oBAAoB,GACpB,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,0BAA0B,GAC1B,aAAa,CAAC;AAElB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAErI,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAkcD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,WAAW,CAiDd"}