claudecode-omc 4.3.4

package/dist/hooks/swarm/index.js

@@ -0,0 +1,485 @@
+/**
+ * Swarm Coordination System
+ *
+ * SQLite-based multi-agent task coordination.
+ * Enables N agents to claim and work on tasks from a shared pool
+ * with atomic claiming, lease-based ownership, and heartbeat monitoring.
+ *
+ * Usage:
+ * ```typescript
+ * import { startSwarm, claimTask, completeTask, stopSwarm } from './swarm';
+ *
+ * // Initialize swarm with tasks
+ * await startSwarm({
+ *   agentCount: 5,
+ *   tasks: ['fix error in auth.ts', 'add tests for api.ts', ...],
+ *   cwd: process.cwd()
+ * });
+ *
+ * // Each agent claims and works on tasks
+ * const claim = claimTask('agent-1');
+ * if (claim.success) {
+ *   // Do work...
+ *   completeTask('agent-1', claim.taskId!, 'Fixed the bug');
+ * }
+ *
+ * // Check status
+ * const status = getSwarmStatus();
+ *
+ * // Clean up when done
+ * stopSwarm();
+ * ```
+ */
+import { randomUUID } from 'crypto';
+import { existsSync, statSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_SWARM_CONFIG } from './types.js';
+import { initDb, closeDb, deleteDb, isDbInitialized, initSession, loadState, saveState, addTasks, getTasks, getTasksByStatus, getTasksByWave, getTask, getStats, getHeartbeats, clearAllData, writeSwarmSummary, getNextTaskId } from './state.js';
+import { claimTask as claimTaskInternal, releaseTask as releaseTaskInternal, completeTask as completeTaskInternal, failTask as failTaskInternal, heartbeat as heartbeatInternal, cleanupStaleClaims as cleanupStaleClaimsInternal, getTasksClaimedBy, hasPendingTasks, allTasksComplete, getActiveAgentCount, reclaimFailedTask, setSwarmCwd, claimTaskForFiles as claimTaskForFilesInternal } from './claiming.js';
+import { canStartMode, createModeMarker, removeModeMarker } from '../mode-registry/index.js';
+// Current working directory for the swarm
+let currentCwd = null;
+// Cleanup interval handle
+let cleanupIntervalHandle = null;
+/**
+ * Clean up resources on initialization failure
+ * Called when startSwarm fails after partial initialization
+ */
+function cleanupOnFailure(cwd) {
+    // Stop cleanup timer if started
+    if (cleanupIntervalHandle) {
+        clearInterval(cleanupIntervalHandle);
+        cleanupIntervalHandle = null;
+    }
+    // Close database
+    closeDb();
+    // Remove marker file
+    removeModeMarker('swarm', cwd);
+    // Reset state
+    currentCwd = null;
+}
+/**
+ * Start a new swarm session
+ *
+ * Initializes the SQLite database, creates the task pool,
+ * and starts the stale claim cleanup timer.
+ *
+ * @param config - Swarm configuration
+ * @returns true if swarm was started successfully
+ */
+export async function startSwarm(config) {
+    const { agentCount, tasks, cwd = process.cwd(), leaseTimeout = DEFAULT_SWARM_CONFIG.leaseTimeout } = config;
+    if (tasks.length === 0) {
+        console.error('Cannot start swarm with no tasks');
+        return false;
+    }
+    if (agentCount < 1) {
+        console.error('Agent count must be at least 1');
+        return false;
+    }
+    // Mutual exclusion check via mode-registry
+    const canStart = canStartMode('swarm', cwd);
+    if (!canStart.allowed) {
+        console.error(canStart.message);
+        return false;
+    }
+    // Initialize database
+    const dbInitialized = await initDb(cwd);
+    if (!dbInitialized) {
+        console.error('Failed to initialize swarm database');
+        return false;
+    }
+    // Create marker file to indicate swarm is active
+    createModeMarker('swarm', cwd, {
+        agentCount,
+        taskCount: tasks.length
+    });
+    currentCwd = cwd;
+    // Set cwd in claiming module for summary writes
+    setSwarmCwd(cwd);
+    // Clear any existing data
+    clearAllData();
+    // Create session
+    const sessionId = randomUUID();
+    if (!initSession(sessionId, agentCount)) {
+        console.error('Failed to initialize swarm session');
+        cleanupOnFailure(cwd);
+        return false;
+    }
+    // Add tasks to pool
+    const taskRecords = tasks.map((description, index) => ({
+        id: `task-${index + 1}`,
+        description
+    }));
+    if (!addTasks(taskRecords)) {
+        console.error('Failed to add tasks to pool');
+        cleanupOnFailure(cwd);
+        return false;
+    }
+    // Start cleanup timer (runs every minute)
+    cleanupIntervalHandle = setInterval(() => {
+        cleanupStaleClaimsInternal(leaseTimeout);
+    }, 60 * 1000);
+    // Write initial summary
+    writeSwarmSummary(cwd);
+    return true;
+}
+/**
+ * Stop the swarm and clean up resources
+ *
+ * Stops the cleanup timer and optionally deletes the database.
+ *
+ * @param deleteDatabase - Whether to delete the database file (default: false)
+ * @returns true if swarm was stopped successfully
+ */
+export function stopSwarm(deleteDatabase = false) {
+    // Stop cleanup timer
+    if (cleanupIntervalHandle) {
+        clearInterval(cleanupIntervalHandle);
+        cleanupIntervalHandle = null;
+    }
+    // Mark session as inactive
+    saveState({ active: false, completedAt: Date.now() });
+    // Write final summary
+    if (currentCwd) {
+        writeSwarmSummary(currentCwd);
+    }
+    // Close database
+    closeDb();
+    // Optionally delete database
+    if (deleteDatabase && currentCwd) {
+        deleteDb(currentCwd);
+    }
+    // Remove marker file
+    if (currentCwd) {
+        removeModeMarker('swarm', currentCwd);
+    }
+    currentCwd = null;
+    return true;
+}
+/**
+ * Get the current swarm status
+ *
+ * @returns SwarmState or null if swarm is not active
+ */
+export function getSwarmStatus() {
+    return loadState();
+}
+/**
+ * Get swarm statistics
+ *
+ * @returns SwarmStats with task counts and timing info
+ */
+export function getSwarmStats() {
+    return getStats();
+}
+/**
+ * Claim the next available task
+ *
+ * @param agentId - Unique identifier for the claiming agent
+ * @returns ClaimResult with success status and task details
+ */
+export function claimTask(agentId) {
+    return claimTaskInternal(agentId);
+}
+/**
+ * Release a claimed task back to the pool
+ *
+ * @param agentId - Agent releasing the task
+ * @param taskId - Task to release
+ * @returns true if release was successful
+ */
+export function releaseTask(agentId, taskId) {
+    return releaseTaskInternal(agentId, taskId);
+}
+/**
+ * Mark a task as completed
+ *
+ * @param agentId - Agent that completed the task
+ * @param taskId - Completed task ID
+ * @param result - Optional result/output from the task
+ * @returns true if completion was recorded
+ */
+export function completeTask(agentId, taskId, result) {
+    const success = completeTaskInternal(agentId, taskId, result);
+    // Check if all tasks are complete
+    if (success && allTasksComplete()) {
+        saveState({ completedAt: Date.now() });
+    }
+    return success;
+}
+/**
+ * Mark a task as failed
+ *
+ * @param agentId - Agent that failed the task
+ * @param taskId - Failed task ID
+ * @param error - Error message/reason for failure
+ * @returns true if failure was recorded
+ */
+export function failTask(agentId, taskId, error) {
+    return failTaskInternal(agentId, taskId, error);
+}
+/**
+ * Send a heartbeat to indicate the agent is still alive
+ *
+ * Agents should call this every 60 seconds while working on tasks.
+ *
+ * @param agentId - Agent sending heartbeat
+ * @returns true if heartbeat was recorded
+ */
+export function heartbeat(agentId) {
+    return heartbeatInternal(agentId);
+}
+/**
+ * Clean up stale claims from dead agents
+ *
+ * Called automatically by the cleanup timer, but can also be called manually.
+ *
+ * @param leaseTimeout - Lease timeout in milliseconds (default: 5 minutes)
+ * @returns Number of tasks released
+ */
+export function cleanupStaleClaims(leaseTimeout) {
+    return cleanupStaleClaimsInternal(leaseTimeout);
+}
+/**
+ * Check if there are pending tasks
+ *
+ * @returns true if there are tasks waiting to be claimed
+ */
+export function hasPendingWork() {
+    return hasPendingTasks();
+}
+/**
+ * Check if all tasks are complete
+ *
+ * @returns true if all tasks are done or failed
+ */
+export function isSwarmComplete() {
+    return allTasksComplete();
+}
+/**
+ * Get the number of active agents
+ *
+ * @returns Number of agents with recent heartbeats
+ */
+export function getActiveAgents() {
+    return getActiveAgentCount();
+}
+/**
+ * Get all tasks
+ *
+ * @returns Array of all tasks in the swarm
+ */
+export function getAllTasks() {
+    return getTasks();
+}
+/**
+ * Get tasks by status
+ *
+ * @param status - Task status to filter by
+ * @returns Array of tasks with the given status
+ */
+export function getTasksWithStatus(status) {
+    return getTasksByStatus(status);
+}
+/**
+ * Get a specific task
+ *
+ * @param taskId - Task ID to retrieve
+ * @returns Task or null if not found
+ */
+export function getTaskById(taskId) {
+    return getTask(taskId);
+}
+/**
+ * Get tasks claimed by a specific agent
+ *
+ * @param agentId - Agent to query
+ * @returns Array of tasks claimed by the agent
+ */
+export function getAgentTasks(agentId) {
+    return getTasksClaimedBy(agentId);
+}
+/**
+ * Get all agent heartbeats
+ *
+ * @returns Array of agent heartbeat records
+ */
+export function getAllHeartbeats() {
+    return getHeartbeats();
+}
+/**
+ * Retry a failed task
+ *
+ * @param agentId - Agent attempting to retry
+ * @param taskId - Failed task to retry
+ * @returns ClaimResult
+ */
+export function retryTask(agentId, taskId) {
+    return reclaimFailedTask(agentId, taskId);
+}
+/**
+ * Claim a task matching the agent's file scope
+ *
+ * @param agentId - Agent claiming the task
+ * @param agentFilePatterns - Glob patterns for files this agent handles
+ * @returns ClaimResult
+ */
+export function claimTaskForFiles(agentId, agentFilePatterns) {
+    return claimTaskForFilesInternal(agentId, agentFilePatterns);
+}
+/**
+ * Add additional tasks to a running swarm
+ * Used for dynamic task addition during wave-based execution
+ *
+ * @param tasks - Array of task definitions with optional metadata
+ * @returns Object with count of added tasks and starting ID
+ */
+export function addMoreTasks(tasks) {
+    if (!isDbInitialized()) {
+        return { added: 0, startingId: -1 };
+    }
+    // Get the highest existing task ID number from database
+    const startingId = getNextTaskId();
+    const taskRecords = tasks.map((task, index) => ({
+        id: `task-${startingId + index}`,
+        description: task.description,
+        priority: task.priority,
+        wave: task.wave,
+        ownedFiles: task.ownedFiles,
+        filePatterns: task.filePatterns,
+    }));
+    const success = addTasks(taskRecords);
+    if (!success) {
+        return { added: 0, startingId: -1 };
+    }
+    // Write updated summary
+    if (currentCwd) {
+        writeSwarmSummary(currentCwd);
+    }
+    return { added: tasks.length, startingId };
+}
+/**
+ * Get available slots for spawning new agents
+ * Simple calculation from existing stats
+ *
+ * @param maxConcurrent - Maximum concurrent agents (default: 5)
+ * @returns Number of available slots
+ */
+export function getAvailableSlots(maxConcurrent = 5) {
+    const stats = getSwarmStats();
+    if (!stats)
+        return 0;
+    return Math.max(0, maxConcurrent - stats.claimedTasks);
+}
+/**
+ * Get tasks for a specific wave
+ *
+ * @param wave - Wave number to filter by
+ * @returns Array of tasks in that wave
+ */
+export function getTasksForWave(wave) {
+    return getTasksByWave(wave);
+}
+/**
+ * Check if swarm database is initialized
+ *
+ * @returns true if database is ready
+ */
+export function isSwarmReady() {
+    return isDbInitialized();
+}
+/**
+ * Initialize database without starting a swarm
+ *
+ * Useful for agents that join an existing swarm.
+ *
+ * @param cwd - Working directory
+ * @returns true if database was initialized
+ */
+export async function connectToSwarm(cwd) {
+    if (isDbInitialized()) {
+        return true;
+    }
+    const success = await initDb(cwd);
+    if (success) {
+        currentCwd = cwd;
+        setSwarmCwd(cwd);
+    }
+    return success;
+}
+/**
+ * Disconnect from swarm without stopping it
+ *
+ * @returns true if disconnected successfully
+ */
+export function disconnectFromSwarm() {
+    closeDb();
+    currentCwd = null;
+    return true;
+}
+/**
+ * Check if swarm is currently active
+ *
+ * Used by cancel skill to detect active swarm.
+ * Checks if database exists and session is active.
+ *
+ * @param cwd - Working directory to check
+ * @returns true if swarm is active
+ */
+export function isSwarmActive(cwd) {
+    // If database is already connected, check state directly
+    if (isDbInitialized()) {
+        const state = loadState();
+        return state !== null && state.active === true;
+    }
+    // Otherwise, check if database file exists and is non-empty
+    const dbPath = join(cwd, '.omc', 'state', 'swarm.db');
+    if (!existsSync(dbPath)) {
+        return false;
+    }
+    try {
+        const stats = statSync(dbPath);
+        return stats.size > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Cancel active swarm
+ *
+ * Used by cancel skill to stop swarm cleanly.
+ *
+ * @param cwd - Working directory
+ * @returns CancelResult with success status and message
+ */
+export async function cancelSwarm(cwd) {
+    // Connect if not already connected
+    if (!isDbInitialized()) {
+        const connected = await connectToSwarm(cwd);
+        if (!connected) {
+            return {
+                success: false,
+                message: 'Failed to connect to swarm database'
+            };
+        }
+    }
+    const state = getSwarmStatus();
+    if (!state || !state.active) {
+        return {
+            success: false,
+            message: 'No active swarm session found'
+        };
+    }
+    const stats = getSwarmStats();
+    // Stop the swarm (preserves database for analysis)
+    stopSwarm(false);
+    return {
+        success: true,
+        message: `Swarm cancelled. ${stats?.doneTasks ?? 0}/${stats?.totalTasks ?? 0} tasks completed.`,
+        stats
+    };
+}
+export { DEFAULT_SWARM_CONFIG } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/swarm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/swarm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAS5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,MAAM,EACN,OAAO,EACP,QAAQ,EACR,eAAe,EACf,WAAW,EACX,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,SAAS,IAAI,iBAAiB,EAC9B,WAAW,IAAI,mBAAmB,EAClC,YAAY,IAAI,oBAAoB,EACpC,QAAQ,IAAI,gBAAgB,EAC5B,SAAS,IAAI,iBAAiB,EAC9B,kBAAkB,IAAI,0BAA0B,EAChD,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,IAAI,yBAAyB,EAC/C,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7F,0CAA0C;AAC1C,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,0BAA0B;AAC1B,IAAI,qBAAqB,GAA0C,IAAI,CAAC;AAExE;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,gCAAgC;IAChC,IAAI,qBAAqB,EAAE,CAAC;QAC1B,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACrC,qBAAqB,GAAG,IAAI,CAAC;IAC/B,CAAC;IACD,iBAAiB;IACjB,OAAO,EAAE,CAAC;IACV,qBAAqB;IACrB,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC/B,cAAc;IACd,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAmB;IAClD,MAAM,EACJ,UAAU,EACV,KAAK,EACL,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACnB,YAAY,GAAG,oBAAoB,CAAC,YAAY,EACjD,GAAG,MAAM,CAAC;IAEX,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sBAAsB;IACtB,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iDAAiD;IACjD,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;QAC7B,UAAU;QACV,SAAS,EAAE,KAAK,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,UAAU,GAAG,GAAG,CAAC;IAEjB,gDAAgD;IAChD,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjB,0BAA0B;IAC1B,YAAY,EAAE,CAAC;IAEf,iBAAiB;IACjB,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,EAAE,EAAE,QAAQ,KAAK,GAAG,CAAC,EAAE;QACvB,WAAW;KACZ,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0CAA0C;IAC1C,qBAAqB,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAEd,wBAAwB;IACxB,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,iBAA0B,KAAK;IACvD,qBAAqB;IACrB,IAAI,qBAAqB,EAAE,CAAC;QAC1B,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACrC,qBAAqB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEtD,sBAAsB;IACtB,IAAI,UAAU,EAAE,CAAC;QACf,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,iBAAiB;IACjB,OAAO,EAAE,CAAC;IAEV,6BAA6B;IAC7B,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;QACjC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IAED,qBAAqB;IACrB,IAAI,UAAU,EAAE,CAAC;QACf,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,GAAG,IAAI,CAAC;IAClB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAc;IACzD,OAAO,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAc,EAAE,MAAe;IAC3E,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9D,kCAAkC;IAClC,IAAI,OAAO,IAAI,gBAAgB,EAAE,EAAE,CAAC;QAClC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,MAAc,EAAE,KAAa;IACrE,OAAO,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAqB;IACtD,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,mBAAmB,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC5D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc;IACvD,OAAO,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,iBAA2B;IAC5E,OAAO,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAuH;IAEvH,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,wDAAwD;IACxD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9C,EAAE,EAAE,QAAQ,UAAU,GAAG,KAAK,EAAE;QAChC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,wBAAwB;IACxB,IAAI,UAAU,EAAE,CAAC;QACf,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,gBAAwB,CAAC;IACzD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,IAAI,eAAe,EAAE,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,EAAE,CAAC;QACZ,UAAU,GAAG,GAAG,CAAC;QACjB,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,EAAE,CAAC;IACV,UAAU,GAAG,IAAI,CAAC;IAClB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,yDAAyD;IACzD,IAAI,eAAe,EAAE,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;IACjD,CAAC;IAED,4DAA4D;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAK3C,mCAAmC;IACnC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,qCAAqC;aAC/C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,+BAA+B;SACzC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAE9B,mDAAmD;IACnD,SAAS,CAAC,KAAK,CAAC,CAAC;IAEjB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,oBAAoB,KAAK,EAAE,SAAS,IAAI,CAAC,IAAI,KAAK,EAAE,UAAU,IAAI,CAAC,mBAAmB;QAC/F,KAAK;KACN,CAAC;AACJ,CAAC;AAaD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/swarm/state.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Swarm State Management
+ *
+ * SQLite-based persistent state for swarm coordination.
+ * Uses better-sqlite3 for synchronous operations with transaction support.
+ * All state is stored in .omc/state/swarm.db
+ */
+import type BetterSqlite3 from "better-sqlite3";
+import type { SwarmTask, SwarmState, AgentHeartbeat, SwarmStats } from "./types.js";
+/**
+ * SwarmSummary interface for the JSON sidecar
+ */
+export interface SwarmSummary {
+    session_id: string;
+    started_at: string;
+    updated_at: string;
+    task_count: number;
+    tasks_pending: number;
+    tasks_claimed: number;
+    tasks_done: number;
+    active: boolean;
+    project_path?: string;
+}
+/**
+ * Initialize the SQLite database
+ * Creates tables if they don't exist
+ */
+export declare function initDb(cwd: string): Promise<boolean>;
+/**
+ * Close the database connection
+ */
+export declare function closeDb(): void;
+/**
+ * Delete the database file (for cleanup)
+ */
+export declare function deleteDb(cwd: string): boolean;
+/**
+ * Check if database is initialized and connected
+ */
+export declare function isDbInitialized(): boolean;
+/**
+ * Initialize a new swarm session
+ */
+export declare function initSession(sessionId: string, agentCount: number): boolean;
+/**
+ * Load the current swarm state
+ */
+export declare function loadState(): SwarmState | null;
+/**
+ * Save swarm state (updates session info only, tasks are updated individually)
+ */
+export declare function saveState(state: Partial<SwarmState>): boolean;
+/**
+ * Add a task to the pool
+ */
+export declare function addTask(id: string, description: string, options?: {
+    priority?: number;
+    wave?: number;
+    ownedFiles?: string[];
+    filePatterns?: string[];
+}): boolean;
+/**
+ * Add multiple tasks in a transaction
+ */
+export declare function addTasks(tasks: Array<{
+    id: string;
+    description: string;
+    priority?: number;
+    wave?: number;
+    ownedFiles?: string[];
+    filePatterns?: string[];
+}>): boolean;
+/**
+ * Get all tasks
+ */
+export declare function getTasks(): SwarmTask[];
+/**
+ * Get tasks by status
+ */
+export declare function getTasksByStatus(status: SwarmTask["status"]): SwarmTask[];
+/**
+ * Get tasks by wave number
+ */
+export declare function getTasksByWave(wave: number): SwarmTask[];
+/**
+ * Get the next available task ID number
+ * Uses MAX(id) from database to prevent ID collisions after deletions
+ */
+export declare function getNextTaskId(): number;
+/**
+ * Get a specific task by ID
+ */
+export declare function getTask(taskId: string): SwarmTask | null;
+/**
+ * Update a task's status and metadata
+ */
+export declare function updateTask(taskId: string, updates: Partial<Omit<SwarmTask, "id" | "description">>): boolean;
+/**
+ * Get swarm statistics
+ */
+export declare function getStats(): SwarmStats | null;
+/**
+ * Record an agent heartbeat
+ */
+export declare function recordHeartbeat(agentId: string, currentTaskId: string | null): boolean;
+/**
+ * Get all agent heartbeats
+ */
+export declare function getHeartbeats(): AgentHeartbeat[];
+/**
+ * Remove an agent's heartbeat record
+ */
+export declare function removeHeartbeat(agentId: string): boolean;
+/**
+ * Clear all data (for reset)
+ */
+export declare function clearAllData(): boolean;
+/**
+ * Run a function within a transaction
+ */
+export declare function runTransaction<T>(fn: () => T): T | null;
+/**
+ * Get the raw database instance (for advanced use)
+ */
+export declare function getDb(): BetterSqlite3.Database | null;
+/**
+ * Write swarm summary to .omc/state/swarm-summary.json
+ * This provides a lightweight JSON sidecar for external monitoring
+ */
+export declare function writeSwarmSummary(cwd: string): boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/hooks/swarm/state.d.ts.map

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