claudehq 1.0.3 → 1.0.5

package/lib/core/claude-events.js

@@ -175,12 +175,13 @@ function loadEventsFromFile() {
     console.log(`  Loaded ${claudeEvents.length} Claude events from: ${EVENTS_FILE}`);
 
     // Discover sessions from loaded events (process unique session IDs)
+    // Pass skipAutoUnhide: true to prevent unhiding sessions during initialization
     if (sessionUpdateCallback) {
       const sessionIds = new Set();
       for (const event of claudeEvents) {
         if (event.sessionId && !sessionIds.has(event.sessionId)) {
           sessionIds.add(event.sessionId);
-          sessionUpdateCallback(event);
+          sessionUpdateCallback(event, { skipAutoUnhide: true });
         }
       }
     }

package/lib/core/config.js

@@ -16,7 +16,6 @@ const TODOS_DIR = path.join(CLAUDE_DIR, 'todos');
 const PLANS_DIR = path.join(CLAUDE_DIR, 'plans');
 const PROJECTS_DIR = path.join(CLAUDE_DIR, 'projects');
 const EVENTS_DIR = path.join(CLAUDE_DIR, 'tasks-board');
-const ORCHESTRATIONS_DIR = path.join(CLAUDE_DIR, 'tasks-board', 'orchestrations');
 
 // Data files
 const CUSTOM_NAMES_FILE = path.join(TASKS_DIR, 'session-names.json');
@@ -36,7 +35,20 @@ const SESSION_STATUS = {
   OFFLINE: 'offline'
 };
 
-// Agent status constants (for orchestration)
+// Timeouts and intervals
+const HEALTH_CHECK_INTERVAL = 5000; // 5 seconds
+const WORKING_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+const PERMISSION_POLL_INTERVAL = 1000; // 1 second
+const EVENT_DEBOUNCE_DELAY = 100; // 100ms
+
+// Limits
+const MAX_EVENTS_IN_MEMORY = 1000;
+const MAX_EVENTS_TO_BROADCAST = 500;
+
+// Orchestration directories and status
+const ORCHESTRATIONS_DIR = path.join(EVENTS_DIR, 'orchestrations');
+
+// Agent status constants
 const AGENT_STATUS = {
   PENDING: 'pending',
   SPAWNING: 'spawning',
@@ -51,20 +63,17 @@ const AGENT_STATUS = {
 const ORCHESTRATION_STATUS = {
   DRAFT: 'draft',
   RUNNING: 'running',
-  PAUSED: 'paused',
   COMPLETED: 'completed',
-  FAILED: 'failed'
+  FAILED: 'failed',
+  PAUSED: 'paused'
 };
 
-// Timeouts and intervals
-const HEALTH_CHECK_INTERVAL = 5000; // 5 seconds
-const WORKING_TIMEOUT = 5 * 60 * 1000; // 5 minutes
-const PERMISSION_POLL_INTERVAL = 1000; // 1 second
-const EVENT_DEBOUNCE_DELAY = 100; // 100ms
-
-// Limits
-const MAX_EVENTS_IN_MEMORY = 1000;
-const MAX_EVENTS_TO_BROADCAST = 500;
+// Spawner configuration
+const SPAWNER_CONFIG = {
+  SESSION_PREFIX: 'tasks-board',
+  MAX_TRACKED_PROJECTS: 100,
+  MAX_AUTOCOMPLETE_RESULTS: 15
+};
 
 module.exports = {
   // Directories
@@ -74,7 +83,6 @@ module.exports = {
   PLANS_DIR,
   PROJECTS_DIR,
   EVENTS_DIR,
-  ORCHESTRATIONS_DIR,
 
   // Files
   CUSTOM_NAMES_FILE,
@@ -88,8 +96,6 @@ module.exports = {
 
   // Status
   SESSION_STATUS,
-  AGENT_STATUS,
-  ORCHESTRATION_STATUS,
 
   // Timing
   HEALTH_CHECK_INTERVAL,
@@ -99,5 +105,13 @@ module.exports = {
 
   // Limits
   MAX_EVENTS_IN_MEMORY,
-  MAX_EVENTS_TO_BROADCAST
+  MAX_EVENTS_TO_BROADCAST,
+
+  // Orchestration
+  ORCHESTRATIONS_DIR,
+  AGENT_STATUS,
+  ORCHESTRATION_STATUS,
+
+  // Spawner
+  SPAWNER_CONFIG
 };

package/lib/core/event-bus.js

@@ -46,24 +46,6 @@ const EventTypes = {
   // Attention events
   ATTENTION_NEEDED: 'attention:needed',
   ATTENTION_CLEARED: 'attention:cleared',
-
-  // Orchestration events
-  ORCHESTRATION_CREATED: 'orchestration:created',
-  ORCHESTRATION_UPDATED: 'orchestration:updated',
-  ORCHESTRATION_STARTED: 'orchestration:started',
-  ORCHESTRATION_PAUSED: 'orchestration:paused',
-  ORCHESTRATION_COMPLETED: 'orchestration:completed',
-  ORCHESTRATION_FAILED: 'orchestration:failed',
-  ORCHESTRATION_DELETED: 'orchestration:deleted',
-
-  // Agent events (within orchestrations)
-  AGENT_CREATED: 'agent:created',
-  AGENT_SPAWNED: 'agent:spawned',
-  AGENT_STATUS_CHANGED: 'agent:status_changed',
-  AGENT_OUTPUT: 'agent:output',
-  AGENT_COMPLETED: 'agent:completed',
-  AGENT_FAILED: 'agent:failed',
-  AGENT_KILLED: 'agent:killed',
 };
 
 class EventBus {

package/lib/index.js

@@ -25,13 +25,18 @@ const tasks = require('./data/tasks');
 const todos = require('./data/todos');
 const plans = require('./data/plans');
 const conversation = require('./data/conversation');
-const orchestrationData = require('./data/orchestration');
-
-// Orchestration
-const orchestrationExecutor = require('./orchestration/executor');
 
 // Routes
 const { createRoutes } = require('./routes/api');
+const { createSpawnerRoutes } = require('./routes/spawner');
+const { createOrchestrationRoutes } = require('./routes/orchestration');
+
+// Spawner
+const { createSessionSpawner } = require('./spawner');
+
+// Orchestration
+const orchestrationData = require('./data/orchestration');
+const orchestrationExecutor = require('./orchestration/executor');
 
 // =============================================================================
 // Module Wiring - Connect modules that need callbacks from other modules
@@ -174,14 +179,37 @@ const routes = createRoutes({
   updatePlan: plans.updatePlan,
   loadConversation: conversation.loadConversation,
 
-  // Orchestration
-  orchestrationData,
-  orchestrationExecutor,
-
   // Utils
   sendToTmux: sessionManager.sendToTmux
 });
 
+// =============================================================================
+// Session Spawner Setup
+// =============================================================================
+
+// Create session spawner instance
+const spawner = createSessionSpawner({
+  dataDir: config.EVENTS_DIR
+});
+
+// Wire spawner to session manager broadcasts
+spawner.setOnSessionUpdate((sessions) => {
+  broadcastUpdate('spawned_sessions', { sessions });
+});
+
+spawner.setOnPermissionDetected((sessionId, permission) => {
+  broadcastUpdate('spawner_permission', { sessionId, permission });
+});
+
+// Create spawner routes
+const spawnerRoutes = createSpawnerRoutes({ spawner });
+
+// Create orchestration routes
+const orchestrationRoutes = createOrchestrationRoutes({
+  orchestrationData,
+  orchestrationExecutor
+});
+
 // =============================================================================
 // HTTP Server
 // =============================================================================
@@ -330,101 +358,175 @@ const server = http.createServer((req, res) => {
     return routes.handleRenameSession(req, res, renameMatch[1]);
   }
 
-  // Orchestration routes
-  if (url.pathname === '/api/orchestrations' && req.method === 'GET') {
-    return routes.handleGetOrchestrations(req, res);
+  // Task routes
+  const taskMatch = url.pathname.match(/^\/api\/tasks\/([^/]+)\/(\d+)$/);
+  if (taskMatch && req.method === 'PATCH') {
+    return routes.handleUpdateTask(req, res, taskMatch[1], taskMatch[2]);
   }
-  if (url.pathname === '/api/orchestrations' && req.method === 'POST') {
-    return routes.handleCreateOrchestration(req, res);
+
+  const createMatch = url.pathname.match(/^\/api\/tasks\/([^/]+)$/);
+  if (createMatch && req.method === 'POST') {
+    return routes.handleCreateTask(req, res, createMatch[1]);
   }
 
-  const orchestrationMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)$/);
-  if (orchestrationMatch && req.method === 'GET') {
-    return routes.handleGetOrchestration(req, res, orchestrationMatch[1]);
+  // ==========================================================================
+  // Spawner Routes - New session spawning API
+  // ==========================================================================
+
+  // Sessions
+  if (url.pathname === '/api/spawner/sessions' && req.method === 'POST') {
+    return spawnerRoutes.handleSpawnSession(req, res);
   }
-  if (orchestrationMatch && req.method === 'PATCH') {
-    return routes.handleUpdateOrchestration(req, res, orchestrationMatch[1]);
+  if (url.pathname === '/api/spawner/sessions' && req.method === 'GET') {
+    return spawnerRoutes.handleListSessions(req, res);
   }
-  if (orchestrationMatch && req.method === 'DELETE') {
-    return routes.handleDeleteOrchestration(req, res, orchestrationMatch[1]);
+  if (url.pathname === '/api/spawner/refresh' && req.method === 'POST') {
+    return spawnerRoutes.handleRefresh(req, res);
   }
 
-  const orchestrationStartMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/start$/);
-  if (orchestrationStartMatch && req.method === 'POST') {
-    return routes.handleStartOrchestration(req, res, orchestrationStartMatch[1]);
+  const spawnerSessionMatch = url.pathname.match(/^\/api\/spawner\/sessions\/([^/]+)$/);
+  if (spawnerSessionMatch && req.method === 'GET') {
+    return spawnerRoutes.handleGetSession(req, res, spawnerSessionMatch[1]);
+  }
+  if (spawnerSessionMatch && req.method === 'PATCH') {
+    return spawnerRoutes.handleUpdateSession(req, res, spawnerSessionMatch[1]);
+  }
+  if (spawnerSessionMatch && req.method === 'DELETE') {
+    return spawnerRoutes.handleKillSession(req, res, spawnerSessionMatch[1]);
   }
 
-  const orchestrationStopMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/stop$/);
-  if (orchestrationStopMatch && req.method === 'POST') {
-    return routes.handleStopOrchestration(req, res, orchestrationStopMatch[1]);
+  const spawnerRestartMatch = url.pathname.match(/^\/api\/spawner\/sessions\/([^/]+)\/restart$/);
+  if (spawnerRestartMatch && req.method === 'POST') {
+    return spawnerRoutes.handleRestartSession(req, res, spawnerRestartMatch[1]);
   }
 
-  // Agent routes
-  const agentsMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents$/);
-  if (agentsMatch && req.method === 'POST') {
-    return routes.handleAddAgent(req, res, agentsMatch[1]);
+  const spawnerPromptMatch = url.pathname.match(/^\/api\/spawner\/sessions\/([^/]+)\/prompt$/);
+  if (spawnerPromptMatch && req.method === 'POST') {
+    return spawnerRoutes.handleSendPrompt(req, res, spawnerPromptMatch[1]);
   }
 
-  const agentMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)$/);
-  if (agentMatch && req.method === 'PATCH') {
-    return routes.handleUpdateAgent(req, res, agentMatch[1], agentMatch[2]);
+  const spawnerCancelMatch = url.pathname.match(/^\/api\/spawner\/sessions\/([^/]+)\/cancel$/);
+  if (spawnerCancelMatch && req.method === 'POST') {
+    return spawnerRoutes.handleCancelSession(req, res, spawnerCancelMatch[1]);
   }
-  if (agentMatch && req.method === 'DELETE') {
-    return routes.handleRemoveAgent(req, res, agentMatch[1], agentMatch[2]);
+
+  const spawnerPermissionMatch = url.pathname.match(/^\/api\/spawner\/sessions\/([^/]+)\/permission$/);
+  if (spawnerPermissionMatch && req.method === 'POST') {
+    return spawnerRoutes.handlePermissionResponse(req, res, spawnerPermissionMatch[1]);
   }
 
-  const agentSpawnMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)\/spawn$/);
-  if (agentSpawnMatch && req.method === 'POST') {
-    return routes.handleSpawnAgent(req, res, agentSpawnMatch[1], agentSpawnMatch[2]);
+  // Projects
+  if (url.pathname === '/api/spawner/projects' && req.method === 'GET') {
+    return spawnerRoutes.handleListProjects(req, res, url);
+  }
+  if (url.pathname === '/api/spawner/projects' && req.method === 'POST') {
+    return spawnerRoutes.handleTrackProject(req, res);
+  }
+  if (url.pathname === '/api/spawner/projects' && req.method === 'DELETE') {
+    return spawnerRoutes.handleRemoveProject(req, res);
+  }
+  if (url.pathname === '/api/spawner/projects/autocomplete' && req.method === 'GET') {
+    return spawnerRoutes.handleAutocomplete(req, res, url);
+  }
+  if (url.pathname === '/api/spawner/projects/common' && req.method === 'GET') {
+    return spawnerRoutes.handleGetCommonDirectories(req, res);
   }
 
-  const agentKillMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)\/kill$/);
-  if (agentKillMatch && req.method === 'POST') {
-    return routes.handleKillAgent(req, res, agentKillMatch[1], agentKillMatch[2]);
+  // ==========================================================================
+  // Orchestration Routes
+  // ==========================================================================
+
+  // Orchestrations CRUD
+  if (url.pathname === '/api/orchestrations' && req.method === 'GET') {
+    return orchestrationRoutes.handleListOrchestrations(req, res);
+  }
+  if (url.pathname === '/api/orchestrations' && req.method === 'POST') {
+    return orchestrationRoutes.handleCreateOrchestration(req, res);
   }
 
-  const agentPromptMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)\/prompt$/);
-  if (agentPromptMatch && req.method === 'POST') {
-    return routes.handleSendPromptToAgent(req, res, agentPromptMatch[1], agentPromptMatch[2]);
+  const orchIdMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)$/);
+  if (orchIdMatch && req.method === 'GET') {
+    return orchestrationRoutes.handleGetOrchestration(req, res, orchIdMatch[1]);
+  }
+  if (orchIdMatch && req.method === 'PATCH') {
+    return orchestrationRoutes.handleUpdateOrchestration(req, res, orchIdMatch[1]);
+  }
+  if (orchIdMatch && req.method === 'DELETE') {
+    return orchestrationRoutes.handleDeleteOrchestration(req, res, orchIdMatch[1]);
+  }
+
+  // Orchestration execution
+  const orchStartMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/start$/);
+  if (orchStartMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleStartOrchestration(req, res, orchStartMatch[1]);
+  }
+
+  const orchStopMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/stop$/);
+  if (orchStopMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleStopOrchestration(req, res, orchStopMatch[1]);
   }
 
-  const agentStatusMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)\/status$/);
+  const orchStatsMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/stats$/);
+  if (orchStatsMatch && req.method === 'GET') {
+    return orchestrationRoutes.handleGetStats(req, res, orchStatsMatch[1]);
+  }
+
+  // Agent routes
+  const agentAddMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents$/);
+  if (agentAddMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleAddAgent(req, res, agentAddMatch[1]);
+  }
+
+  const agentIdMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)$/);
+  if (agentIdMatch && req.method === 'PATCH') {
+    return orchestrationRoutes.handleUpdateAgent(req, res, agentIdMatch[1], agentIdMatch[2]);
+  }
+  if (agentIdMatch && req.method === 'DELETE') {
+    return orchestrationRoutes.handleRemoveAgent(req, res, agentIdMatch[1], agentIdMatch[2]);
+  }
+
+  const agentStatusMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)\/status$/);
   if (agentStatusMatch && req.method === 'GET') {
-    return routes.handleGetAgentStatus(req, res, agentStatusMatch[1], agentStatusMatch[2]);
+    return orchestrationRoutes.handleGetAgentStatus(req, res, agentStatusMatch[1], agentStatusMatch[2]);
   }
 
-  const agentDependencyMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)\/dependencies$/);
-  if (agentDependencyMatch && req.method === 'POST') {
-    return routes.handleAddAgentDependency(req, res, agentDependencyMatch[1], agentDependencyMatch[2]);
+  const agentSpawnMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)\/spawn$/);
+  if (agentSpawnMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleSpawnAgent(req, res, agentSpawnMatch[1], agentSpawnMatch[2]);
   }
 
-  const agentDependencyRemoveMatch = url.pathname.match(/^\/api\/orchestrations\/([^/]+)\/agents\/([^/]+)\/dependencies\/([^/]+)$/);
-  if (agentDependencyRemoveMatch && req.method === 'DELETE') {
-    return routes.handleRemoveAgentDependency(req, res, agentDependencyRemoveMatch[1], agentDependencyRemoveMatch[2], agentDependencyRemoveMatch[3]);
+  const agentKillMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)\/kill$/);
+  if (agentKillMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleKillAgent(req, res, agentKillMatch[1], agentKillMatch[2]);
   }
 
-  // Orchestration template routes
-  if (url.pathname === '/api/orchestration-templates' && req.method === 'GET') {
-    return routes.handleGetTemplates(req, res);
+  const agentPromptMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)\/prompt$/);
+  if (agentPromptMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleSendAgentPrompt(req, res, agentPromptMatch[1], agentPromptMatch[2]);
   }
 
-  const templateMatch = url.pathname.match(/^\/api\/orchestration-templates\/([^/]+)$/);
-  if (templateMatch && req.method === 'GET') {
-    return routes.handleGetTemplate(req, res, templateMatch[1]);
+  // Dependencies
+  const depAddMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)\/dependencies$/);
+  if (depAddMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleAddDependency(req, res, depAddMatch[1], depAddMatch[2]);
   }
-  if (templateMatch && req.method === 'POST') {
-    return routes.handleCreateFromTemplate(req, res, templateMatch[1]);
+
+  const depRemoveMatch = url.pathname.match(/^\/api\/orchestrations\/([a-z0-9-]+)\/agents\/([a-z0-9-]+)\/dependencies\/([a-z0-9-]+)$/);
+  if (depRemoveMatch && req.method === 'DELETE') {
+    return orchestrationRoutes.handleRemoveDependency(req, res, depRemoveMatch[1], depRemoveMatch[2], depRemoveMatch[3]);
   }
 
-  // Task routes
-  const taskMatch = url.pathname.match(/^\/api\/tasks\/([^/]+)\/(\d+)$/);
-  if (taskMatch && req.method === 'PATCH') {
-    return routes.handleUpdateTask(req, res, taskMatch[1], taskMatch[2]);
+  // Templates
+  if (url.pathname === '/api/orchestration-templates' && req.method === 'GET') {
+    return orchestrationRoutes.handleListTemplates(req, res);
   }
 
-  const createMatch = url.pathname.match(/^\/api\/tasks\/([^/]+)$/);
-  if (createMatch && req.method === 'POST') {
-    return routes.handleCreateTask(req, res, createMatch[1]);
+  const templateIdMatch = url.pathname.match(/^\/api\/orchestration-templates\/([a-z0-9-]+)$/);
+  if (templateIdMatch && req.method === 'GET') {
+    return orchestrationRoutes.handleGetTemplate(req, res, templateIdMatch[1]);
+  }
+  if (templateIdMatch && req.method === 'POST') {
+    return orchestrationRoutes.handleCreateFromTemplate(req, res, templateIdMatch[1]);
   }
 
   // Serve HTML
@@ -453,14 +555,11 @@ function start() {
     registerAllHandlers();
     console.log(`  EventBus initialized with ${eventBus.getHandlerCount()} handlers`);
 
-    // Initialize Claude events module
-    claudeEvents.init();
-
-    // Initialize session manager
+    // Initialize session manager (must be before claudeEvents so sessions are loaded before discovery)
     sessionManager.init();
 
-    // Initialize orchestration executor
-    orchestrationExecutor.init();
+    // Initialize Claude events module
+    claudeEvents.init();
 
     // Set up file watchers
     setupWatchers();
@@ -468,12 +567,20 @@ function start() {
     // Build plan session cache
     plans.buildPlanSessionCache();
 
+    // Initialize session spawner
+    spawner.init();
+    console.log(`  Session spawner initialized`);
+
+    // Initialize orchestration executor
+    orchestrationExecutor.init();
+    console.log(`  Orchestration executor initialized`);
+
     console.log(`  Press Ctrl+C to stop\n`);
   });
 }
 
 // Export for testing
-module.exports = { server, start };
+module.exports = { server, start, spawner };
 
 // Start if run directly
 if (require.main === module) {