@deksden-com/dd-flow-cli 0.3.1 → 0.4.1

package/dist/services/protocols.js

@@ -15,6 +15,7 @@ import { ensureRuntimeProtocolFiles, readPlanFile, readStateFile, writeState } f
 import { activeCodexSessionBindingsForProject, activeFlowSessionBindingsForProject, codexHomeProfilesForProject, codexHookEventsForProject, hookStatusForProject } from "./hooks.js";
 import { buildProtocolFlowGuidance } from "./flow-guidance.js";
 import { lifecycleIsTerminalFailure, lifecycleIsTerminalSuccess, normalizeProtocolLifecycle } from "./protocol-lifecycle.js";
+import { getProtocolBranchContext } from "./branch-context.js";
 export function registerProtocol(context, input) {
     const projectRoot = resolveProjectRoot(input.projectRoot);
     const project = requireProjectByRoot(context, projectRoot);
@@ -31,7 +32,7 @@ export function registerProtocol(context, input) {
         workspacePath,
         now
     });
-    const existing = findProtocol(context, protocolId);
+    const existing = findProtocol(context, protocolId, project.id);
     const params = [
         protocolId,
         input.handshakeId,
@@ -54,7 +55,7 @@ export function registerProtocol(context, input) {
        route_json, workspace_json, blockers_json, active_def_json, state_path, plan_path,
        created_at, updated_at)
      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT(id) DO UPDATE SET
+     ON CONFLICT(project_id, id) DO UPDATE SET
        handshake_id = excluded.handshake_id,
        project_id = excluded.project_id,
        project_root = excluded.project_root,
@@ -80,15 +81,16 @@ export function registerProtocol(context, input) {
             runtime_dir: runtimeDir
         }
     });
-    return { ok: true, protocol: protocolStatusPayload(requireProtocol(context, protocolId)), state };
+    return { ok: true, protocol: protocolStatusPayload(requireProtocol(context, protocolId, project.id)), state };
 }
 export function getProtocolStatus(context, input) {
-    const protocol = requireProtocol(context, input.protocolId);
+    const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
+    const protocol = requireProtocol(context, input.protocolId, project.id);
     const runtime = readProtocolRuntimeState(context, protocol);
     const state = runtime.state;
     const plan = readPlanFile(protocol.plan_path);
     const runDiagnostics = protocolRunDiagnostics(context, protocol, state);
-    const queue = context.db.get("SELECT * FROM merge_queue WHERE protocol_id = ?", [protocol.id]);
+    const queue = context.db.get("SELECT * FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]);
     const lifecycle = normalizeProtocolLifecycle({ state, queueStatus: queue?.status ?? null });
     return {
         ok: true,
@@ -99,14 +101,15 @@ export function getProtocolStatus(context, input) {
         state,
         plan: plan ? summarizePlan(plan) : state.plan,
         merge_queue: queue,
+        branch_context: getProtocolBranchContext(context, { protocolId: protocol.id, projectRoot: project.root }).branch_context,
         flow_guidance: buildProtocolFlowGuidance({ state, latestRun: runDiagnostics.latest_run, queueStatus: queue?.status ?? null }),
-        worktree: context.db.get("SELECT * FROM worktree_records WHERE protocol_id = ?", [protocol.id]),
+        worktree: context.db.get("SELECT * FROM worktree_records WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]),
         hook_status: hookStatusForProject(context, protocol.project_id),
         codex_home_profiles: codexHomeProfilesForProject(context, protocol.project_id),
         flow_sessions: activeFlowSessionBindingsForProject(context, protocol.project_id).filter((session) => session.protocol_id === protocol.id),
         codex_session_bindings: activeCodexSessionBindingsForProject(context, protocol.project_id).filter((binding) => binding.protocol_id === protocol.id),
         codex_hook_events: codexHookEventsForProject(context, protocol.project_id).filter((event) => event.protocol_id === protocol.id),
-        audit: getAuditEvents(context, protocol.id)
+        audit: getAuditEvents(context, protocol.project_id, protocol.id)
     };
 }
 export function getReadyProtocols(context, input) {
@@ -126,7 +129,7 @@ export function getReadyProtocols(context, input) {
 }
 export function getProtocolBlockers(context, input) {
     const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
-    const document = requireProtocolDocument(project.root, input.protocolId);
+    const document = requireProtocolDocument(context, project.root, input.protocolId);
     const blockers = document.blocked_by_protocols.map((id) => blockerStatus(context, project.id, project.root, id));
     return {
         ok: true,
@@ -141,13 +144,13 @@ export function getProtocolBlockers(context, input) {
 }
 export function implementProtocol(context, input) {
     const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
-    const document = requireProtocolDocument(project.root, input.protocolId);
-    const protocol = findProtocol(context, document.id);
+    const document = requireProtocolDocument(context, project.root, input.protocolId);
+    const protocol = findProtocol(context, document.id, project.id);
     const runtime = protocol ? readProtocolRuntimeState(context, protocol) : null;
     const state = runtime?.state ?? null;
     const terminal = protocolTerminalStatus(context, project.id, project.root, document.id, state);
     const activeSessions = activeFlowSessionBindingsForProject(context, project.id).filter((session) => session.protocol_id === document.id);
-    const queue = context.db.get("SELECT status, claimed_by_session_id FROM merge_queue WHERE protocol_id = ?", [document.id]);
+    const queue = context.db.get("SELECT status, claimed_by_session_id FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [project.id, document.id]);
     const blockers = document.blocked_by_protocols.map((id) => blockerStatus(context, project.id, project.root, id));
     const unresolved = blockers.filter((blocker) => !blocker.resolved);
     const diagnostics = [
@@ -203,6 +206,7 @@ export function implementProtocol(context, input) {
         blockers,
         active_sessions: activeSessions,
         merge_queue: queue ?? null,
+        branch_context: protocol ? getProtocolBranchContext(context, { protocolId: protocol.id, projectRoot: project.root }).branch_context : null,
         lifecycle,
         terminal,
         related_context: document.related_context,
@@ -239,7 +243,8 @@ export function implementProtocol(context, input) {
     };
 }
 export function transitionProtocol(context, input) {
-    const protocol = requireProtocol(context, input.protocolId);
+    const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
+    const protocol = requireProtocol(context, input.protocolId, project.id);
     const state = readProtocolRuntimeState(context, protocol).state;
     const flowContract = flowContractForState(state);
     const from = requireStage(state.stage, flowContract);
@@ -273,10 +278,11 @@ export function transitionProtocol(context, input) {
         payload: { from, to, payload, flow_contract_id: flowContract.id, flow_contract_version: flowContract.version }
     });
     const runDiagnostics = protocolRunDiagnostics(context, protocol, nextState);
-    const queue = context.db.get("SELECT * FROM merge_queue WHERE protocol_id = ?", [protocol.id]);
+    const queue = context.db.get("SELECT * FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]);
     return {
         ok: true,
         protocol_id: protocol.id,
+        project_root: project.root,
         from,
         to,
         forced: input.force,
@@ -286,13 +292,15 @@ export function transitionProtocol(context, input) {
     };
 }
 export function readyForMerge(context, input) {
-    const protocol = requireProtocol(context, input.protocolId);
+    const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
+    const protocol = requireProtocol(context, input.protocolId, project.id);
     const state = readProtocolRuntimeState(context, protocol).state;
     const flowContract = flowContractForState(state);
     const stage = requireStage(state.stage, flowContract);
     const runDiagnostics = protocolRunDiagnostics(context, protocol, state);
-    const existingQueueJob = context.db.get("SELECT status FROM merge_queue WHERE protocol_id = ?", [
-        protocol.id
+    const branchContext = getProtocolBranchContext(context, { protocolId: protocol.id, projectRoot: project.root }).branch_context;
+    const existingQueueJob = context.db.get("SELECT status FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [
+        protocol.project_id, protocol.id
     ]);
     if (existingQueueJob && ["claimed", "merged", "cancelled", "failed"].includes(existingQueueJob.status)) {
         appendAudit(context, {
@@ -304,8 +312,10 @@ export function readyForMerge(context, input) {
         return {
             ok: true,
             protocol_id: protocol.id,
+            project_root: project.root,
             queue_status: existingQueueJob.status,
             state,
+            branch_context: branchContext,
             lifecycle: normalizeProtocolLifecycle({ state, queueStatus: existingQueueJob.status }),
             flow_guidance: buildProtocolFlowGuidance({ state, latestRun: runDiagnostics.latest_run, queueStatus: existingQueueJob.status })
         };
@@ -341,7 +351,7 @@ export function readyForMerge(context, input) {
     context.db.run(`INSERT INTO merge_queue
        (protocol_id, project_id, status, claimed_by_session_id, claimed_at, completed_at, created_at, updated_at)
      VALUES (?, ?, ?, NULL, NULL, NULL, ?, ?)
-     ON CONFLICT(protocol_id) DO UPDATE SET
+     ON CONFLICT(project_id, protocol_id) DO UPDATE SET
        status = excluded.status,
        claimed_by_session_id = NULL,
        claimed_at = NULL,
@@ -356,14 +366,17 @@ export function readyForMerge(context, input) {
     return {
         ok: true,
         protocol_id: protocol.id,
+        project_root: project.root,
         queue_status: "ready",
         state: nextState,
+        branch_context: branchContext,
         lifecycle: normalizeProtocolLifecycle({ state: nextState, queueStatus: "ready" }),
         flow_guidance: buildProtocolFlowGuidance({ state: nextState, latestRun: runDiagnostics.latest_run, queueStatus: "ready" })
     };
 }
 export function syncProtocolFromRun(context, input) {
-    const protocol = requireProtocol(context, input.protocolId);
+    const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
+    const protocol = requireProtocol(context, input.protocolId, project.id);
     const state = readProtocolRuntimeState(context, protocol).state;
     const run = resolveLinkedRun(context, protocol, input.runId);
     if (run.subject_type !== "protocol" || run.subject_id !== protocol.id) {
@@ -400,7 +413,7 @@ export function syncProtocolFromRun(context, input) {
             context.db.run(`INSERT INTO merge_queue
            (protocol_id, project_id, status, claimed_by_session_id, claimed_at, completed_at, created_at, updated_at)
          VALUES (?, ?, ?, NULL, NULL, NULL, ?, ?)
-         ON CONFLICT(protocol_id) DO UPDATE SET
+         ON CONFLICT(project_id, protocol_id) DO UPDATE SET
            status = CASE WHEN merge_queue.status IN ('merged', 'cancelled', 'failed') THEN merge_queue.status ELSE excluded.status END,
            updated_at = excluded.updated_at`, [protocol.id, protocol.project_id, "ready", now, now]);
         }
@@ -410,7 +423,7 @@ export function syncProtocolFromRun(context, input) {
              last_reason = COALESCE(last_reason, ?),
              completed_at = COALESCE(completed_at, ?),
              updated_at = ?
-         WHERE protocol_id = ?`, [`synced from ${run.id}`, now, now, protocol.id]);
+         WHERE project_id = ? AND protocol_id = ?`, [`synced from ${run.id}`, now, now, protocol.project_id, protocol.id]);
         }
         appendAudit(context, {
             protocolId: protocol.id,
@@ -435,6 +448,7 @@ export function syncProtocolFromRun(context, input) {
     return {
         ok: true,
         protocol_id: protocol.id,
+        project_root: project.root,
         run_id: run.id,
         from: state.stage,
         to: targetStage,
@@ -452,14 +466,15 @@ export function syncProtocolFromRun(context, input) {
     };
 }
 export function cancelProtocol(context, input) {
-    const protocol = requireProtocol(context, input.protocolId);
+    const project = requireProjectByRoot(context, resolveProjectRoot(input.projectRoot));
+    const protocol = requireProtocol(context, input.protocolId, project.id);
     const reason = input.reason.trim();
     if (!reason) {
         throw new AppError("validation", "protocol cancel requires --reason", 2);
     }
     const state = readProtocolRuntimeState(context, protocol).state;
     const now = context.now();
-    const worktree = context.db.get("SELECT worktree_path, status FROM worktree_records WHERE protocol_id = ?", [protocol.id]);
+    const worktree = context.db.get("SELECT worktree_path, status FROM worktree_records WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]);
     const worktreeRemoval = input.worktree === "remove" ? removeProtocolWorktreeBeforeCancel(protocol, state, worktree, input.force) : undefined;
     context.db.exec("BEGIN IMMEDIATE");
     try {
@@ -492,7 +507,7 @@ export function cancelProtocol(context, input) {
             const nextWorktreeStatus = worktreeRemoval?.status ?? "removed";
             const result = worktree
                 ? context.db.run(`UPDATE worktree_records SET status = ?, updated_at = ?, closed_at = ?
-             WHERE protocol_id = ? AND status = 'active'`, [nextWorktreeStatus, now, now, protocol.id])
+             WHERE project_id = ? AND protocol_id = ? AND status = 'active'`, [nextWorktreeStatus, now, now, protocol.project_id, protocol.id])
                 : { changes: 0 };
             worktreeOutcome = {
                 ok: true,
@@ -527,12 +542,13 @@ export function cancelProtocol(context, input) {
         return {
             ok: true,
             protocol_id: protocol.id,
+            project_root: project.root,
             state: nextState,
             queue: cancelledQueue,
             closed_sessions: closedSessions,
             lock_release: lockRelease,
             worktree_outcome: worktreeOutcome,
-            worktree: context.db.get("SELECT * FROM worktree_records WHERE protocol_id = ?", [protocol.id]) ?? null
+            worktree: context.db.get("SELECT * FROM worktree_records WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]) ?? null
         };
     }
     catch (error) {
@@ -540,15 +556,23 @@ export function cancelProtocol(context, input) {
         throw error;
     }
 }
-export function requireProtocol(context, protocolId) {
-    const protocol = findProtocol(context, protocolId);
-    if (!protocol) {
+export function requireProtocol(context, protocolId, projectId) {
+    const matches = projectId
+        ? context.db.all("SELECT * FROM protocols WHERE project_id = ? AND id = ?", [projectId, protocolId])
+        : context.db.all("SELECT * FROM protocols WHERE id = ? ORDER BY project_id", [protocolId]);
+    if (matches.length === 0) {
         throw new AppError("not_found", `Protocol is not registered: ${protocolId}`, 1);
     }
-    return protocol;
+    if (matches.length > 1) {
+        throw new AppError("ambiguous_protocol", `Protocol id is ambiguous without project context: ${protocolId}`, 1, {
+            protocol_id: protocolId,
+            candidates: matches.map((protocol) => ({ project_id: protocol.project_id, project_root: protocol.project_root }))
+        });
+    }
+    return matches[0];
 }
 function cancelQueueForProtocol(context, protocol, reason, force) {
-    const job = context.db.get("SELECT id, status, claimed_by_session_id FROM merge_queue WHERE protocol_id = ?", [protocol.id]);
+    const job = context.db.get("SELECT id, status, claimed_by_session_id FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]);
     if (!job) {
         return { ok: true, skipped: true, reason: "no_queue_job" };
     }
@@ -673,7 +697,7 @@ function removeLocalFeatureBranch(projectRoot, branch, force) {
 function releaseRelatedMergeLocks(context, protocol, reason) {
     const workers = context.db.all(`SELECT DISTINCT worker_id FROM flow_sessions
      WHERE project_id = ? AND protocol_id = ? AND worker_id IS NOT NULL`, [protocol.project_id, protocol.id]).map((row) => row.worker_id).filter((workerId) => Boolean(workerId));
-    const job = context.db.get("SELECT claimed_by_session_id FROM merge_queue WHERE protocol_id = ?", [protocol.id]);
+    const job = context.db.get("SELECT claimed_by_session_id FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]);
     if (job?.claimed_by_session_id) {
         workers.push(job.claimed_by_session_id);
     }
@@ -715,7 +739,7 @@ export function readProtocolRuntimeState(context, protocol) {
                 recommended_action: "legacy protocol state_path was moved to stable runtime storage"
             });
             const stablePlanPath = runtimePlanJsonPath(context.ddFlowHome, protocol.project_id, protocol.id);
-            context.db.run("UPDATE protocols SET state_path = ?, plan_path = ? WHERE id = ?", [stableStatePath, stablePlanPath, protocol.id]);
+            context.db.run("UPDATE protocols SET state_path = ?, plan_path = ? WHERE project_id = ? AND id = ?", [stableStatePath, stablePlanPath, protocol.project_id, protocol.id]);
             protocol.state_path = stableStatePath;
             protocol.plan_path = stablePlanPath;
             return { state: readStateFile(stableStatePath, protocol.id), diagnostics };
@@ -728,7 +752,7 @@ export function readProtocolRuntimeState(context, protocol) {
             recommended_action: "runtime state reconstructed from SQLite; run cleanup scan/apply if this persists"
         });
     }
-    const plan = context.db.get("SELECT plan_json FROM plans WHERE protocol_id = ?", [protocol.id]);
+    const plan = context.db.get("SELECT plan_json FROM plans WHERE project_id = ? AND protocol_id = ?", [protocol.project_id, protocol.id]);
     const planSummary = plan
         ? planSummaryForState(JSON.parse(plan.plan_json))
         : { plan_id: null, total: 0, done: 0, blocked: 0 };
@@ -752,7 +776,7 @@ export function readProtocolRuntimeState(context, protocol) {
     const stablePlanPath = runtimePlanJsonPath(context.ddFlowHome, protocol.project_id, protocol.id);
     ensureDir(path.dirname(stableStatePath));
     writeState(stableStatePath, state);
-    context.db.run("UPDATE protocols SET state_path = ?, plan_path = ? WHERE id = ?", [stableStatePath, stablePlanPath, protocol.id]);
+    context.db.run("UPDATE protocols SET state_path = ?, plan_path = ? WHERE project_id = ? AND id = ?", [stableStatePath, stablePlanPath, protocol.project_id, protocol.id]);
     const repairedFrom = protocol.state_path;
     protocol.state_path = stableStatePath;
     protocol.plan_path = stablePlanPath;
@@ -797,7 +821,7 @@ export function persistProtocolState(context, protocol, state) {
     context.db.run(`UPDATE protocols SET
        status = ?, stage = ?, next_action = ?, route_json = ?, workspace_json = ?,
        blockers_json = ?, active_def_json = ?, updated_at = ?
-     WHERE id = ?`, [
+     WHERE project_id = ? AND id = ?`, [
         state.status,
         state.stage,
         state.next_action,
@@ -806,6 +830,7 @@ export function persistProtocolState(context, protocol, state) {
         JSON.stringify(state.blockers),
         JSON.stringify(state.active_def),
         state.updated_at,
+        protocol.project_id,
         protocol.id
     ]);
     if (state.status === "closed" || state.stage === "closed") {
@@ -817,8 +842,12 @@ export function persistProtocolState(context, protocol, state) {
          AND status IN ('pending', 'active', 'waiting_user', 'blocked', 'stopping')`, [now, now, protocol.project_id, protocol.id]);
     }
 }
-function findProtocol(context, protocolId) {
-    return context.db.get("SELECT * FROM protocols WHERE id = ?", [protocolId]);
+function findProtocol(context, protocolId, projectId) {
+    if (projectId) {
+        return context.db.get("SELECT * FROM protocols WHERE project_id = ? AND id = ?", [projectId, protocolId]);
+    }
+    const matches = context.db.all("SELECT * FROM protocols WHERE id = ? ORDER BY project_id", [protocolId]);
+    return matches.length === 1 ? matches[0] : undefined;
 }
 function protocolDocumentsForProject(projectRoot) {
     const protocolRoot = path.join(projectRoot, ".memory-bank", "protocol");
@@ -831,12 +860,19 @@ function protocolDocumentsForProject(projectRoot) {
         .filter((document) => Boolean(document))
         .sort((a, b) => a.id.localeCompare(b.id));
 }
-function requireProtocolDocument(projectRoot, protocolId) {
-    const file = path.join(projectRoot, ".memory-bank", "protocol", `${protocolId}.md`);
+function requireProtocolDocument(context, projectRoot, protocolId) {
+    const project = requireProjectByRoot(context, resolveProjectRoot(projectRoot));
+    const protocol = findProtocol(context, protocolId, project.id);
+    const workspace = protocol ? JSON.parse(protocol.workspace_json).worktree_path : null;
+    const workspaceFile = typeof workspace === "string" ? path.join(workspace, ".memory-bank", "protocol", `${protocolId}.md`) : null;
+    const file = workspaceFile && fs.existsSync(workspaceFile)
+        ? workspaceFile
+        : path.join(projectRoot, ".memory-bank", "protocol", `${protocolId}.md`);
     if (!fs.existsSync(file)) {
         throw new AppError("protocol_file_not_found", `Protocol markdown is not found: ${protocolId}`, 1, {
             protocol_id: protocolId,
-            expected_path: file
+            expected_path: file,
+            workspace_path: workspace
         });
     }
     const document = readProtocolDocument(file);
@@ -912,9 +948,9 @@ function protocolDocumentDiagnostics(document) {
     return diagnostics;
 }
 function protocolSetMemberStatus(context, projectId, document) {
-    const runtime = findProtocol(context, document.id);
+    const runtime = findProtocol(context, document.id, projectId);
     const state = runtime ? readProtocolRuntimeState(context, runtime).state : null;
-    const queue = context.db.get("SELECT status, claimed_by_session_id FROM merge_queue WHERE protocol_id = ?", [document.id]);
+    const queue = context.db.get("SELECT status, claimed_by_session_id FROM merge_queue WHERE project_id = ? AND protocol_id = ?", [projectId, document.id]);
     const activeSessions = activeFlowSessionBindingsForProject(context, projectId).filter((session) => session.protocol_id === document.id);
     const projectRoot = projectRootFromProtocolFile(document.path);
     const blockers = document.blocked_by_protocols.map((id) => blockerStatus(context, projectId, projectRoot, id));
@@ -978,7 +1014,7 @@ export function protocolSetBoardForProtocol(context, projectId, projectRoot, pro
     return protocolSetBoardsForProject(context, projectId, projectRoot).find((board) => board.protocol_set === document.protocol_set) ?? null;
 }
 function blockerStatus(context, projectId, projectRoot, blockerId) {
-    const runtime = findProtocol(context, blockerId);
+    const runtime = findProtocol(context, blockerId, projectId);
     const state = runtime ? readProtocolRuntimeState(context, runtime).state : null;
     const terminal = protocolTerminalStatus(context, projectId, projectRoot, blockerId, state);
     const lifecycle = normalizeProtocolLifecycle({ state, rawStage: runtime?.stage, rawStatus: runtime?.status });

package/dist/services/run-projection.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
+export function refreshRunSessionProjection(context, projectId, runId) {
+    const run = context.db.get("SELECT id, runtime_path, run_index_path, index_json FROM flow_runs WHERE project_id = ? AND id = ?", [projectId, runId]);
+    if (!run)
+        return;
+    const index = JSON.parse(run.index_json);
+    const sessions = context.db.all(`SELECT session_id, parent_session_id, role, session_kind, worker_id, current_stage, status,
+            created_at, updated_at, stopped_at, coverage_units_json
+       FROM flow_sessions WHERE project_id = ? AND run_id = ? ORDER BY created_at, session_id`, [projectId, runId]).map(sessionProjection);
+    if (JSON.stringify(index.sessions ?? []) === JSON.stringify(sessions))
+        return;
+    index.sessions = sessions;
+    index.updated_at = context.now();
+    const runtimeRevision = typeof index.runtime_revision === "number" ? index.runtime_revision + 1 : 1;
+    index.runtime_revision = runtimeRevision;
+    const runtime = readJson(run.runtime_path);
+    if (runtime) {
+        runtime.sessions = sessions;
+        runtime.updated_at = index.updated_at;
+        runtime.runtime_revision = runtimeRevision;
+    }
+    writeJson(run.run_index_path, index);
+    writeJson(run.runtime_path, runtime ?? index);
+    context.db.run("UPDATE flow_runs SET index_json = ?, updated_at = ? WHERE project_id = ? AND id = ?", [JSON.stringify(index), index.updated_at, projectId, runId]);
+}
+function sessionProjection(row) {
+    return {
+        session_id: row.session_id,
+        parent_session_id: row.parent_session_id,
+        role: row.role,
+        session_kind: row.session_kind,
+        worker_id: row.worker_id,
+        current_stage: row.current_stage,
+        status: row.status,
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+        stopped_at: row.stopped_at,
+        coverage_units: parseCoverageUnits(row.coverage_units_json)
+    };
+}
+function parseCoverageUnits(value) {
+    if (!value)
+        return [];
+    try {
+        const parsed = JSON.parse(value);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.flatMap((item) => {
+            if (!item || typeof item !== "object" || Array.isArray(item))
+                return [];
+            const object = item;
+            if (typeof object.unit_id !== "string" || object.unit_id.length === 0)
+                return [];
+            return [{
+                    unit_id: object.unit_id,
+                    group_id: typeof object.group_id === "string" ? object.group_id : null,
+                    job_id: typeof object.job_id === "string" ? object.job_id : null,
+                    kind: typeof object.kind === "string" ? object.kind : null
+                }];
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function readJson(file) {
+    try {
+        return fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, "utf8")) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeJson(file, value) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const temporary = `${file}.tmp-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(temporary, `${JSON.stringify(value, null, 2)}\n`);
+    fs.renameSync(temporary, file);
+}