opencode-swarm-plugin 0.44.0 → 0.44.2

package/src/eval-capture.ts

@@ -1,929 +0,0 @@
-/**
- * Eval Data Capture - Captures real swarm execution data for evals
- *
- * Records decomposition inputs, outputs, and outcomes to JSONL files
- * that can be used as ground truth for Evalite evals.
- *
- * Data flow:
- * 1. swarm_decompose captures: task, context, generated decomposition
- * 2. swarm_complete captures: outcome signals per subtask
- * 3. swarm_record_outcome captures: learning signals
- * 4. Human feedback (optional): accept/reject/modify
- * 5. Coordinator events: decisions, violations, outcomes, compaction
- * 6. Session capture: full coordinator session to ~/.config/swarm-tools/sessions/
- *
- * Event types:
- * - DECISION: strategy_selected, worker_spawned, review_completed, decomposition_complete, researcher_spawned, skill_loaded, inbox_checked, blocker_resolved, scope_change_approved, scope_change_rejected
- * - VIOLATION: coordinator_edited_file, coordinator_ran_tests, coordinator_reserved_files, no_worker_spawned
- * - OUTCOME: subtask_success, subtask_retry, subtask_failed, epic_complete, blocker_detected
- * - COMPACTION: detection_complete, prompt_generated, context_injected, resumption_started, tool_call_tracked
- *
- * @module eval-capture
- */
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { z } from "zod";
-
-// ============================================================================
-// Schemas
-// ============================================================================
-
-/**
- * Subtask outcome - what actually happened
- */
-export const SubtaskOutcomeSchema = z.object({
-  /** Subtask bead ID */
-  bead_id: z.string(),
-  /** Subtask title */
-  title: z.string(),
-  /** Planned files */
-  planned_files: z.array(z.string()),
-  /** Actual files touched */
-  actual_files: z.array(z.string()),
-  /** Duration in ms */
-  duration_ms: z.number().int().min(0),
-  /** Error count */
-  error_count: z.number().int().min(0),
-  /** Retry count */
-  retry_count: z.number().int().min(0),
-  /** Success */
-  success: z.boolean(),
-  /** Failure mode if failed */
-  failure_mode: z.string().optional(),
-});
-export type SubtaskOutcome = z.infer<typeof SubtaskOutcomeSchema>;
-
-/**
- * Complete eval record - input, output, and outcome
- */
-export const EvalRecordSchema = z.object({
-  /** Unique ID for this eval record */
-  id: z.string(),
-  /** Timestamp when decomposition was generated */
-  timestamp: z.string(), // ISO-8601
-  /** Project path */
-  project_path: z.string(),
-
-  // INPUT
-  /** Original task description */
-  task: z.string(),
-  /** Context provided (codebase info, CASS results, etc.) */
-  context: z.string().optional(),
-  /** Strategy used for decomposition */
-  strategy: z.enum(["file-based", "feature-based", "risk-based", "auto"]),
-  /** Number of subtasks generated */
-  subtask_count: z.number().int().min(1),
-
-  // OUTPUT (the decomposition)
-  /** Epic title */
-  epic_title: z.string(),
-  /** Epic description */
-  epic_description: z.string().optional(),
-  /** Generated subtasks */
-  subtasks: z.array(
-    z.object({
-      title: z.string(),
-      description: z.string().optional(),
-      files: z.array(z.string()),
-      dependencies: z.array(z.number()).optional(),
-      estimated_complexity: z.number().int().min(1).max(5).optional(),
-    }),
-  ),
-
-  // OUTCOME (what actually happened)
-  /** Subtask outcomes */
-  outcomes: z.array(SubtaskOutcomeSchema).optional(),
-  /** Overall success (all subtasks succeeded) */
-  overall_success: z.boolean().optional(),
-  /** Total duration (sum of all subtasks) */
-  total_duration_ms: z.number().int().min(0).optional(),
-  /** Total errors across all subtasks */
-  total_errors: z.number().int().min(0).optional(),
-
-  // HUMAN FEEDBACK (optional)
-  /** Human accepted the decomposition as-is */
-  human_accepted: z.boolean().optional(),
-  /** Human modified the decomposition */
-  human_modified: z.boolean().optional(),
-  /** Human feedback notes */
-  human_notes: z.string().optional(),
-
-  // COMPUTED METRICS
-  /** File overlap between subtasks (should be 0) */
-  file_overlap_count: z.number().int().min(0).optional(),
-  /** Scope accuracy: actual files / planned files */
-  scope_accuracy: z.number().min(0).max(2).optional(),
-  /** Time balance: max duration / min duration (lower is better) */
-  time_balance_ratio: z.number().min(1).optional(),
-});
-export type EvalRecord = z.infer<typeof EvalRecordSchema>;
-
-/**
- * Partial record for in-progress capture
- */
-export type PartialEvalRecord = Partial<EvalRecord> & {
-  id: string;
-  timestamp: string;
-  task: string;
-};
-
-/**
- * Coordinator Event - captures coordinator decisions, violations, outcomes, and compaction
- */
-export const CoordinatorEventSchema = z.discriminatedUnion("event_type", [
-  // DECISION events
-  z.object({
-    session_id: z.string(),
-    epic_id: z.string(),
-    timestamp: z.string(),
-    event_type: z.literal("DECISION"),
-    decision_type: z.enum([
-      "strategy_selected",
-      "worker_spawned",
-      "review_completed",
-      "decomposition_complete",
-      "researcher_spawned",
-      "skill_loaded",
-      "inbox_checked",
-      "blocker_resolved",
-      "scope_change_approved",
-      "scope_change_rejected",
-    ]),
-    payload: z.any(),
-  }),
-  // VIOLATION events
-  z.object({
-    session_id: z.string(),
-    epic_id: z.string(),
-    timestamp: z.string(),
-    event_type: z.literal("VIOLATION"),
-    violation_type: z.enum([
-      "coordinator_edited_file",
-      "coordinator_ran_tests",
-      "coordinator_reserved_files",
-      "no_worker_spawned",
-    ]),
-    payload: z.any(),
-  }),
-  // OUTCOME events
-  z.object({
-    session_id: z.string(),
-    epic_id: z.string(),
-    timestamp: z.string(),
-    event_type: z.literal("OUTCOME"),
-    outcome_type: z.enum([
-      "subtask_success",
-      "subtask_retry",
-      "subtask_failed",
-      "epic_complete",
-      "blocker_detected",
-    ]),
-    payload: z.any(),
-  }),
-  // COMPACTION events
-  z.object({
-    session_id: z.string(),
-    epic_id: z.string(),
-    timestamp: z.string(),
-    event_type: z.literal("COMPACTION"),
-    compaction_type: z.enum([
-      "detection_complete",
-      "prompt_generated",
-      "context_injected",
-      "resumption_started",
-      "tool_call_tracked",
-    ]),
-    payload: z.any(),
-  }),
-]);
-export type CoordinatorEvent = z.infer<typeof CoordinatorEventSchema>;
-
-/**
- * Coordinator Session - wraps a full coordinator session
- */
-export const CoordinatorSessionSchema = z.object({
-  session_id: z.string(),
-  epic_id: z.string(),
-  start_time: z.string(),
-  end_time: z.string().optional(),
-  events: z.array(CoordinatorEventSchema),
-});
-export type CoordinatorSession = z.infer<typeof CoordinatorSessionSchema>;
-
-// ============================================================================
-// Storage
-// ============================================================================
-
-/**
- * Default path for eval data
- */
-export const DEFAULT_EVAL_DATA_PATH = ".opencode/eval-data.jsonl";
-
-/**
- * Get the eval data file path for a project
- */
-export function getEvalDataPath(projectPath: string): string {
-  return path.join(projectPath, DEFAULT_EVAL_DATA_PATH);
-}
-
-/**
- * Ensure the eval data directory exists
- */
-export function ensureEvalDataDir(projectPath: string): void {
-  const evalPath = getEvalDataPath(projectPath);
-  const dir = path.dirname(evalPath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-}
-
-/**
- * Append an eval record to the JSONL file
- */
-export function appendEvalRecord(
-  projectPath: string,
-  record: EvalRecord | PartialEvalRecord,
-): void {
-  ensureEvalDataDir(projectPath);
-  const evalPath = getEvalDataPath(projectPath);
-  const line = `${JSON.stringify(record)}\n`;
-  fs.appendFileSync(evalPath, line, "utf-8");
-}
-
-/**
- * Read all eval records from a project
- */
-export function readEvalRecords(projectPath: string): EvalRecord[] {
-  const evalPath = getEvalDataPath(projectPath);
-  if (!fs.existsSync(evalPath)) {
-    return [];
-  }
-
-  const content = fs.readFileSync(evalPath, "utf-8");
-  const lines = content.trim().split("\n").filter(Boolean);
-
-  return lines.map((line) => {
-    const parsed = JSON.parse(line);
-    return EvalRecordSchema.parse(parsed);
-  });
-}
-
-/**
- * Read partial records (for updating in-progress records)
- */
-export function readPartialRecords(projectPath: string): PartialEvalRecord[] {
-  const evalPath = getEvalDataPath(projectPath);
-  if (!fs.existsSync(evalPath)) {
-    return [];
-  }
-
-  const content = fs.readFileSync(evalPath, "utf-8");
-  const lines = content.trim().split("\n").filter(Boolean);
-
-  return lines.map((line) => JSON.parse(line) as PartialEvalRecord);
-}
-
-/**
- * Update an existing record by ID
- */
-export function updateEvalRecord(
-  projectPath: string,
-  id: string,
-  updates: Partial<EvalRecord>,
-): boolean {
-  const records = readPartialRecords(projectPath);
-  const index = records.findIndex((r) => r.id === id);
-
-  if (index === -1) {
-    return false;
-  }
-
-  records[index] = { ...records[index], ...updates };
-
-  // Rewrite the file
-  const evalPath = getEvalDataPath(projectPath);
-  const content = `${records.map((r) => JSON.stringify(r)).join("\n")}\n`;
-  fs.writeFileSync(evalPath, content, "utf-8");
-
-  return true;
-}
-
-// ============================================================================
-// Capture Functions
-// ============================================================================
-
-/**
- * In-memory store for in-progress records (keyed by epic ID)
- */
-const inProgressRecords = new Map<string, PartialEvalRecord>();
-
-/**
- * Start capturing a decomposition
- *
- * Called when swarm_decompose generates a decomposition.
- * Creates a partial record that will be completed when outcomes arrive.
- */
-export function captureDecomposition(params: {
-  epicId: string;
-  projectPath: string;
-  task: string;
-  context?: string;
-  strategy: "file-based" | "feature-based" | "risk-based" | "auto";
-  epicTitle: string;
-  epicDescription?: string;
-  subtasks: Array<{
-    title: string;
-    description?: string;
-    files: string[];
-    dependencies?: number[];
-    estimated_complexity?: number;
-  }>;
-}): PartialEvalRecord {
-  const record: PartialEvalRecord = {
-    id: params.epicId,
-    timestamp: new Date().toISOString(),
-    project_path: params.projectPath,
-    task: params.task,
-    context: params.context,
-    strategy: params.strategy,
-    subtask_count: params.subtasks.length,
-    epic_title: params.epicTitle,
-    epic_description: params.epicDescription,
-    subtasks: params.subtasks,
-    outcomes: [],
-  };
-
-  // Store in memory for later updates
-  inProgressRecords.set(params.epicId, record);
-
-  // Also persist to disk (partial)
-  appendEvalRecord(params.projectPath, record);
-
-  return record;
-}
-
-/**
- * Capture a subtask outcome
- *
- * Called when swarm_complete finishes a subtask.
- * Updates the in-progress record with outcome data.
- */
-export function captureSubtaskOutcome(params: {
-  epicId: string;
-  projectPath: string;
-  beadId: string;
-  title: string;
-  plannedFiles: string[];
-  actualFiles: string[];
-  durationMs: number;
-  errorCount: number;
-  retryCount: number;
-  success: boolean;
-  failureMode?: string;
-}): void {
-  const outcome: SubtaskOutcome = {
-    bead_id: params.beadId,
-    title: params.title,
-    planned_files: params.plannedFiles,
-    actual_files: params.actualFiles,
-    duration_ms: params.durationMs,
-    error_count: params.errorCount,
-    retry_count: params.retryCount,
-    success: params.success,
-    failure_mode: params.failureMode,
-  };
-
-  // Update in-memory record
-  const record = inProgressRecords.get(params.epicId);
-  if (record) {
-    record.outcomes = record.outcomes || [];
-    record.outcomes.push(outcome);
-  }
-
-  // Update on disk
-  updateEvalRecord(params.projectPath, params.epicId, {
-    outcomes: record?.outcomes,
-  });
-}
-
-/**
- * Finalize an eval record
- *
- * Called when all subtasks are complete.
- * Computes aggregate metrics and marks record as complete.
- */
-export function finalizeEvalRecord(params: {
-  epicId: string;
-  projectPath: string;
-}): EvalRecord | null {
-  const record = inProgressRecords.get(params.epicId);
-  if (!record || !record.outcomes || record.outcomes.length === 0) {
-    return null;
-  }
-
-  // Compute aggregate metrics
-  const outcomes = record.outcomes;
-
-  const overallSuccess = outcomes.every((o) => o.success);
-  const totalDurationMs = outcomes.reduce((sum, o) => sum + o.duration_ms, 0);
-  const totalErrors = outcomes.reduce((sum, o) => sum + o.error_count, 0);
-
-  // File overlap: count files that appear in multiple subtasks
-  const allPlannedFiles = record.subtasks?.flatMap((s) => s.files) || [];
-  const fileOccurrences = new Map<string, number>();
-  for (const file of allPlannedFiles) {
-    fileOccurrences.set(file, (fileOccurrences.get(file) || 0) + 1);
-  }
-  const fileOverlapCount = Array.from(fileOccurrences.values()).filter(
-    (count) => count > 1,
-  ).length;
-
-  // Scope accuracy: actual files / planned files
-  const plannedFileSet = new Set(allPlannedFiles);
-  const actualFileSet = new Set(outcomes.flatMap((o) => o.actual_files));
-  const scopeAccuracy =
-    plannedFileSet.size > 0 ? actualFileSet.size / plannedFileSet.size : 1;
-
-  // Time balance: max duration / min duration
-  const durations = outcomes.map((o) => o.duration_ms).filter((d) => d > 0);
-  const timeBalanceRatio =
-    durations.length > 1 ? Math.max(...durations) / Math.min(...durations) : 1;
-
-  // Update record with computed metrics
-  const finalRecord: EvalRecord = {
-    ...(record as EvalRecord),
-    overall_success: overallSuccess,
-    total_duration_ms: totalDurationMs,
-    total_errors: totalErrors,
-    file_overlap_count: fileOverlapCount,
-    scope_accuracy: scopeAccuracy,
-    time_balance_ratio: timeBalanceRatio,
-  };
-
-  // Update on disk
-  updateEvalRecord(params.projectPath, params.epicId, finalRecord);
-
-  // Remove from in-progress
-  inProgressRecords.delete(params.epicId);
-
-  return finalRecord;
-}
-
-/**
- * Capture human feedback on a decomposition
- */
-export function captureHumanFeedback(params: {
-  epicId: string;
-  projectPath: string;
-  accepted: boolean;
-  modified: boolean;
-  notes?: string;
-}): void {
-  updateEvalRecord(params.projectPath, params.epicId, {
-    human_accepted: params.accepted,
-    human_modified: params.modified,
-    human_notes: params.notes,
-  });
-}
-
-// ============================================================================
-// Eval Data Export
-// ============================================================================
-
-/**
- * Export eval records as Evalite-compatible test cases
- *
- * Filters to only complete records with outcomes.
- */
-export function exportForEvalite(projectPath: string): Array<{
-  input: { task: string; context?: string };
-  expected: {
-    minSubtasks: number;
-    subtaskCount: number;
-    requiredFiles?: string[];
-    overallSuccess?: boolean;
-  };
-  actual: EvalRecord;
-}> {
-  const records = readEvalRecords(projectPath);
-
-  return records
-    .filter((r) => r.outcomes && r.outcomes.length > 0)
-    .map((record) => ({
-      input: {
-        task: record.task,
-        context: record.context,
-      },
-      expected: {
-        minSubtasks: 2,
-        subtaskCount: record.subtask_count,
-        requiredFiles: record.subtasks.flatMap((s) => s.files),
-        overallSuccess: record.overall_success,
-      },
-      actual: record,
-    }));
-}
-
-/**
- * Get statistics about captured eval data
- */
-export function getEvalDataStats(projectPath: string): {
-  totalRecords: number;
-  completeRecords: number;
-  successRate: number;
-  avgSubtasks: number;
-  avgDurationMs: number;
-  avgScopeAccuracy: number;
-  avgTimeBalance: number;
-} {
-  const records = readEvalRecords(projectPath);
-  const complete = records.filter((r) => r.outcomes && r.outcomes.length > 0);
-
-  if (complete.length === 0) {
-    return {
-      totalRecords: records.length,
-      completeRecords: 0,
-      successRate: 0,
-      avgSubtasks: 0,
-      avgDurationMs: 0,
-      avgScopeAccuracy: 0,
-      avgTimeBalance: 0,
-    };
-  }
-
-  const successCount = complete.filter((r) => r.overall_success).length;
-  const avgSubtasks =
-    complete.reduce((sum, r) => sum + (r.outcomes?.length || 0), 0) /
-    complete.length;
-  const avgDurationMs =
-    complete.reduce((sum, r) => sum + (r.total_duration_ms || 0), 0) /
-    complete.length;
-  const avgScopeAccuracy =
-    complete.reduce((sum, r) => sum + (r.scope_accuracy || 1), 0) /
-    complete.length;
-  const avgTimeBalance =
-    complete.reduce((sum, r) => sum + (r.time_balance_ratio || 1), 0) /
-    complete.length;
-
-  return {
-    totalRecords: records.length,
-    completeRecords: complete.length,
-    successRate: successCount / complete.length,
-    avgSubtasks,
-    avgDurationMs,
-    avgScopeAccuracy,
-    avgTimeBalance,
-  };
-}
-
-// ============================================================================
-// Coordinator Session Capture
-// ============================================================================
-
-/**
- * Get the session directory path
- */
-export function getSessionDir(): string {
-  return path.join(os.homedir(), ".config", "swarm-tools", "sessions");
-}
-
-/**
- * Get the session file path for a session ID
- */
-export function getSessionPath(sessionId: string): string {
-  return path.join(getSessionDir(), `${sessionId}.jsonl`);
-}
-
-/**
- * Ensure the session directory exists
- */
-export function ensureSessionDir(): void {
-  const sessionDir = getSessionDir();
-  if (!fs.existsSync(sessionDir)) {
-    fs.mkdirSync(sessionDir, { recursive: true });
-  }
-}
-
-/**
- * Capture a coordinator event to the session file
- *
- * Appends the event as a JSONL line to ~/.config/swarm-tools/sessions/{session_id}.jsonl
- */
-export function captureCoordinatorEvent(event: CoordinatorEvent): void {
-  // Validate event
-  CoordinatorEventSchema.parse(event);
-
-  // Ensure directory exists
-  ensureSessionDir();
-
-  // Append to session file
-  const sessionPath = getSessionPath(event.session_id);
-  const line = `${JSON.stringify(event)}\n`;
-  fs.appendFileSync(sessionPath, line, "utf-8");
-}
-
-/**
- * Capture a compaction event to the session file
- *
- * Helper for capturing COMPACTION events with automatic timestamp generation.
- * Tracks compaction hook lifecycle: detection → prompt generation → context injection → resumption.
- *
- * **Part of eval-driven development pipeline:** Compaction events are used by `compaction-prompt.eval.ts`
- * to score prompt quality (ID specificity, actionability, coordinator identity).
- *
- * **Lifecycle stages:**
- * - `detection_complete` - Compaction detected (confidence level, context type)
- * - `prompt_generated` - Continuation prompt created (FULL content stored for eval)
- * - `context_injected` - Prompt injected into OpenCode context
- * - `resumption_started` - Coordinator resumed from checkpoint
- * - `tool_call_tracked` - First tool called post-compaction (measures discipline)
- *
- * @param params - Compaction event parameters
- * @param params.session_id - Coordinator session ID
- * @param params.epic_id - Epic ID being coordinated
- * @param params.compaction_type - Stage of compaction lifecycle
- * @param params.payload - Event-specific data (full prompt content, detection results, etc.)
- *
- * @example
- * // Capture detection complete
- * captureCompactionEvent({
- *   session_id: "session-123",
- *   epic_id: "bd-456",
- *   compaction_type: "detection_complete",
- *   payload: {
- *     confidence: "high",
- *     context_type: "full",
- *     epic_id: "bd-456",
- *   },
- * });
- *
- * @example
- * // Capture prompt generated (with full content for eval)
- * captureCompactionEvent({
- *   session_id: "session-123",
- *   epic_id: "bd-456",
- *   compaction_type: "prompt_generated",
- *   payload: {
- *     prompt_length: 5000,
- *     full_prompt: "You are a coordinator...", // Full prompt, not truncated - used for quality scoring
- *     context_type: "full",
- *   },
- * });
- */
-export function captureCompactionEvent(params: {
-  session_id: string;
-  epic_id: string;
-  compaction_type:
-    | "detection_complete"
-    | "prompt_generated"
-    | "context_injected"
-    | "resumption_started"
-    | "tool_call_tracked";
-  payload: any;
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "COMPACTION",
-    compaction_type: params.compaction_type,
-    payload: params.payload,
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Capture a researcher spawned event
- *
- * Called when coordinator spawns a swarm-researcher to handle unfamiliar technology
- * or gather documentation before decomposition.
- */
-export function captureResearcherSpawned(params: {
-  session_id: string;
-  epic_id: string;
-  researcher_id: string;
-  research_topic: string;
-  tools_used?: string[];
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "DECISION",
-    decision_type: "researcher_spawned",
-    payload: {
-      researcher_id: params.researcher_id,
-      research_topic: params.research_topic,
-      tools_used: params.tools_used || [],
-    },
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Capture a skill loaded event
- *
- * Called when coordinator loads domain knowledge via skills_use().
- */
-export function captureSkillLoaded(params: {
-  session_id: string;
-  epic_id: string;
-  skill_name: string;
-  context?: string;
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "DECISION",
-    decision_type: "skill_loaded",
-    payload: {
-      skill_name: params.skill_name,
-      context: params.context,
-    },
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Capture an inbox checked event
- *
- * Called when coordinator checks swarmmail inbox for worker messages.
- * Tracks monitoring frequency and responsiveness.
- */
-export function captureInboxChecked(params: {
-  session_id: string;
-  epic_id: string;
-  message_count: number;
-  urgent_count: number;
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "DECISION",
-    decision_type: "inbox_checked",
-    payload: {
-      message_count: params.message_count,
-      urgent_count: params.urgent_count,
-    },
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Capture a blocker resolved event
- *
- * Called when coordinator successfully unblocks a worker.
- */
-export function captureBlockerResolved(params: {
-  session_id: string;
-  epic_id: string;
-  worker_id: string;
-  subtask_id: string;
-  blocker_type: string;
-  resolution: string;
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "DECISION",
-    decision_type: "blocker_resolved",
-    payload: {
-      worker_id: params.worker_id,
-      subtask_id: params.subtask_id,
-      blocker_type: params.blocker_type,
-      resolution: params.resolution,
-    },
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Capture a scope change decision event
- *
- * Called when coordinator approves or rejects a worker's scope expansion request.
- */
-export function captureScopeChangeDecision(params: {
-  session_id: string;
-  epic_id: string;
-  worker_id: string;
-  subtask_id: string;
-  approved: boolean;
-  original_scope?: string;
-  new_scope?: string;
-  requested_scope?: string;
-  rejection_reason?: string;
-  estimated_time_add?: number;
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "DECISION",
-    decision_type: params.approved ? "scope_change_approved" : "scope_change_rejected",
-    payload: params.approved
-      ? {
-          worker_id: params.worker_id,
-          subtask_id: params.subtask_id,
-          original_scope: params.original_scope,
-          new_scope: params.new_scope,
-          estimated_time_add: params.estimated_time_add,
-        }
-      : {
-          worker_id: params.worker_id,
-          subtask_id: params.subtask_id,
-          requested_scope: params.requested_scope,
-          rejection_reason: params.rejection_reason,
-        },
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Capture a blocker detected event
- *
- * Called when a worker reports being blocked (OUTCOME event, not DECISION).
- */
-export function captureBlockerDetected(params: {
-  session_id: string;
-  epic_id: string;
-  worker_id: string;
-  subtask_id: string;
-  blocker_type: string;
-  blocker_description: string;
-}): void {
-  const event: CoordinatorEvent = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    timestamp: new Date().toISOString(),
-    event_type: "OUTCOME",
-    outcome_type: "blocker_detected",
-    payload: {
-      worker_id: params.worker_id,
-      subtask_id: params.subtask_id,
-      blocker_type: params.blocker_type,
-      blocker_description: params.blocker_description,
-      reported_at: new Date().toISOString(),
-    },
-  };
-
-  captureCoordinatorEvent(event);
-}
-
-/**
- * Read all events from a session file
- */
-export function readSessionEvents(sessionId: string): CoordinatorEvent[] {
-  const sessionPath = getSessionPath(sessionId);
-  if (!fs.existsSync(sessionPath)) {
-    return [];
-  }
-
-  const content = fs.readFileSync(sessionPath, "utf-8");
-  const lines = content.trim().split("\n").filter(Boolean);
-
-  return lines.map((line) => {
-    const parsed = JSON.parse(line);
-    return CoordinatorEventSchema.parse(parsed);
-  });
-}
-
-/**
- * Save a session - wraps all events in a CoordinatorSession structure
- *
- * Reads all events from the session file and wraps them in a session object.
- * Returns null if the session file doesn't exist.
- */
-export function saveSession(params: {
-  session_id: string;
-  epic_id: string;
-}): CoordinatorSession | null {
-  const events = readSessionEvents(params.session_id);
-  if (events.length === 0) {
-    return null;
-  }
-
-  // Get timestamps from events
-  const timestamps = events.map((e) => new Date(e.timestamp).getTime());
-  const startTime = new Date(Math.min(...timestamps)).toISOString();
-  const endTime = new Date(Math.max(...timestamps)).toISOString();
-
-  const session: CoordinatorSession = {
-    session_id: params.session_id,
-    epic_id: params.epic_id,
-    start_time: startTime,
-    end_time: endTime,
-    events,
-  };
-
-  return session;
-}