fleet-commander-ai 0.0.1

package/dist/server/services/event-collector.js

@@ -0,0 +1,299 @@
+/**
+ * Event Collector — Hook event ingestion service
+ *
+ * Receives events from Claude Code hooks (via POST /api/events),
+ * stores them in SQLite, triggers state transitions, and broadcasts
+ * via SSE. Includes throttling for high-volume tool_use events.
+ *
+ * Data flow:
+ *   Claude hook -> send_event.sh -> POST /api/events -> EventCollector
+ *     -> SQLite insert -> state machine evaluation -> SSE broadcast
+ *
+ * Throttling:
+ *   tool_use events from the same team within 5 seconds are deduplicated.
+ *   last_event_at is ALWAYS updated (heartbeat must work for stuck detection).
+ *   Non-tool_use events are NEVER throttled.
+ */
+import config from '../config.js';
+// ---------------------------------------------------------------------------
+// Throttle state — module-level, persists across requests
+// ---------------------------------------------------------------------------
+/** Track last tool_use event time per team for throttling */
+const lastToolUseByTeam = new Map();
+const subagentTrackers = new Map();
+/** Throttle window: tool_use events from the same team within this period are deduplicated */
+const TOOL_USE_THROTTLE_MS = 5000; // 5 seconds
+// ---------------------------------------------------------------------------
+// Agent name normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize agent name for consistent matching across roster and messages.
+ *
+ * - Strips `fleet-` prefix (e.g. "fleet-dev" -> "dev", "fleet-planner" -> "planner")
+ * - Maps empty/null/undefined to "team-lead" (the main CC process has no agent_type)
+ * - Returns lowercase trimmed name
+ */
+export function normalizeAgentName(name) {
+    if (!name || name.trim() === '')
+        return 'team-lead';
+    let normalized = name.trim();
+    // Strip "fleet-" prefix for consistent cross-reference
+    if (normalized.startsWith('fleet-')) {
+        normalized = normalized.slice(6);
+    }
+    return normalized;
+}
+// ---------------------------------------------------------------------------
+// Event type normalization
+// ---------------------------------------------------------------------------
+/**
+ * Normalize event type strings from hooks to canonical EventType values.
+ * Hooks may send "tool_use", "session_start", etc. (snake_case).
+ * The DB schema uses PascalCase: "ToolUse", "SessionStart", etc.
+ */
+function normalizeEventType(raw) {
+    const map = {
+        'tool_use': 'ToolUse',
+        'session_start': 'SessionStart',
+        'session_end': 'SessionEnd',
+        'stop': 'Stop',
+        'stop_failure': 'StopFailure',
+        'subagent_start': 'SubagentStart',
+        'subagent_stop': 'SubagentStop',
+        'notification': 'Notification',
+        'tool_error': 'ToolError',
+        'pre_compact': 'PreCompact',
+        'teammate_idle': 'TeammateIdle',
+    };
+    return map[raw.toLowerCase()] || raw;
+}
+// ---------------------------------------------------------------------------
+// Core processing
+// ---------------------------------------------------------------------------
+/**
+ * Process an incoming event from a Claude Code hook.
+ *
+ * Steps:
+ * 1. Look up team by worktree name
+ * 2. If team is idle or stuck, transition back to running
+ * 3. Always update last_event_at (heartbeat for stuck detection)
+ * 4. Throttle tool_use events (same team, within 5s window)
+ * 5. Insert event into DB
+ * 6. Broadcast via SSE
+ *
+ * @returns ProcessEventResult with event_id (null if deduplicated), team_id, and processed flag
+ */
+export function processEvent(payload, db, sse, messageSender) {
+    // ── Validate required fields ─────────────────────────────────────
+    if (!payload.event || !payload.team) {
+        throw new EventCollectorError('Missing required fields: event and team', 'VALIDATION_ERROR');
+    }
+    // ── Look up team ─────────────────────────────────────────────────
+    const team = db.getTeamByWorktree(payload.team);
+    if (!team) {
+        throw new EventCollectorError(`Team not found for worktree: ${payload.team}`, 'TEAM_NOT_FOUND');
+    }
+    const teamId = team.id;
+    const now = Date.now();
+    const nowIso = new Date(now).toISOString();
+    // ── State transition: idle/stuck -> running on activity events ─────
+    // Most events from an idle or stuck team prove it is alive and doing
+    // work. However, dormancy-indicating events (stop, session_end) mean
+    // the agent finished its turn or the session terminated — they must
+    // NOT reset the idle/stuck status because the agent is not actively
+    // working. Those events still update lastEventAt (line 206) so the
+    // stuck detector has accurate timing data.
+    //
+    // This MUST happen before the throttle check so that even
+    // deduplicated tool_use events trigger the recovery transition.
+    const DORMANCY_EVENTS = new Set(['stop', 'stop_failure', 'session_end']);
+    const eventNameLower = payload.event.toLowerCase();
+    if ((team.status === 'idle' || team.status === 'stuck') && !DORMANCY_EVENTS.has(eventNameLower)) {
+        db.insertTransition({
+            teamId,
+            fromStatus: team.status,
+            toStatus: 'running',
+            trigger: 'hook',
+            reason: `Activity resumed (${payload.event} event received)`,
+        });
+        db.updateTeam(teamId, {
+            status: 'running',
+        });
+        sse.broadcast('team_status_changed', {
+            team_id: teamId,
+            status: 'running',
+            previous_status: team.status,
+        }, teamId);
+    }
+    // ── State transition: launching -> running only on session_start/subagent_start
+    // Other events during launching may be noise; wait for an actual session start.
+    if (team.status === 'launching') {
+        const evt = payload.event.toLowerCase();
+        if (evt === 'session_start' || evt === 'subagent_start') {
+            db.insertTransition({
+                teamId,
+                fromStatus: 'launching',
+                toStatus: 'running',
+                trigger: 'hook',
+                reason: `First ${evt} event received`,
+            });
+            db.updateTeam(teamId, {
+                status: 'running',
+            });
+            sse.broadcast('team_status_changed', {
+                team_id: teamId,
+                status: 'running',
+                previous_status: 'launching',
+            }, teamId);
+        }
+    }
+    // ── Always update last_event_at (heartbeat) ──────────────────────
+    // Stuck detection depends on last_event_at being fresh.
+    // Even throttled/deduplicated events must update this timestamp
+    // so the stuck detector doesn't falsely flag active teams.
+    db.updateTeam(teamId, { lastEventAt: nowIso });
+    // ── Throttle tool_use events ─────────────────────────────────────
+    if (payload.event.toLowerCase() === 'tool_use') {
+        const teamKey = payload.team;
+        const lastTime = lastToolUseByTeam.get(teamKey) || 0;
+        if (now - lastTime < TOOL_USE_THROTTLE_MS) {
+            // Deduplicated: don't insert into DB or broadcast SSE.
+            // Return 200 with processed: false (not an error, just deduped).
+            return { event_id: null, team_id: teamId, processed: false };
+        }
+        // Outside throttle window: allow this event through and record time
+        lastToolUseByTeam.set(teamKey, now);
+        // Prune stale entries to prevent unbounded growth
+        for (const [k, t] of lastToolUseByTeam) {
+            if (now - t > TOOL_USE_THROTTLE_MS * 2)
+                lastToolUseByTeam.delete(k);
+        }
+    }
+    // ── Normalize event type ─────────────────────────────────────────
+    const eventType = normalizeEventType(payload.event);
+    // ── Normalize agent name ────────────────────────────────────────
+    // Strip "fleet-" prefix and map empty agent_type to "team-lead"
+    // so roster names and message sender/recipient names match.
+    const agentName = normalizeAgentName(payload.agent_type);
+    // ── Insert event into database ───────────────────────────────────
+    const inserted = db.insertEvent({
+        teamId,
+        sessionId: payload.session_id || null,
+        agentName,
+        eventType,
+        toolName: payload.tool_name || null,
+        payload: JSON.stringify(payload),
+    });
+    const eventId = inserted.id;
+    // ── Broadcast via SSE ────────────────────────────────────────────
+    sse.broadcast('team_event', {
+        event_id: eventId,
+        team_id: teamId,
+        event_type: eventType,
+        session_id: payload.session_id || null,
+        agent_name: agentName,
+        tool_name: payload.tool_name || null,
+        timestamp: payload.timestamp || nowIso,
+    });
+    // ── Subagent crash detection (advisory) ───────────────────────
+    // Track SubagentStart/SubagentStop pairs. If a subagent stops very
+    // quickly (< 2 min) with minimal events (< 5), it likely crashed.
+    // Send an advisory message to the TL so they can decide to respawn.
+    const evtLower = payload.event.toLowerCase();
+    if (evtLower === 'subagent_start') {
+        const subagentName = payload.teammate_name || payload.agent_type || 'unknown';
+        const trackerKey = `${payload.team}:${subagentName}`;
+        subagentTrackers.set(trackerKey, { startTime: now, eventCount: 0 });
+        // Record spawn as a real agent message (TL -> subagent) so the CommGraph
+        // shows data-driven edges instead of synthetic spawn lines.
+        try {
+            const senderName = normalizeAgentName(null); // TL spawns subagents
+            const recipientName = normalizeAgentName(subagentName);
+            db.insertAgentMessage({
+                teamId,
+                eventId,
+                sender: senderName,
+                recipient: recipientName,
+                summary: 'spawned agent',
+                content: null,
+                sessionId: payload.session_id || null,
+            });
+        }
+        catch {
+            // Non-critical — silently ignore insert failures
+        }
+    }
+    // Increment event count for any tracked subagent on this team
+    if (payload.agent_type || payload.teammate_name) {
+        const subagentName = payload.teammate_name || payload.agent_type || 'unknown';
+        const trackerKey = `${payload.team}:${subagentName}`;
+        const tracker = subagentTrackers.get(trackerKey);
+        if (tracker) {
+            tracker.eventCount++;
+        }
+    }
+    if (evtLower === 'subagent_stop' && messageSender) {
+        const subagentName = payload.teammate_name || payload.agent_type || 'unknown';
+        const trackerKey = `${payload.team}:${subagentName}`;
+        const tracker = subagentTrackers.get(trackerKey);
+        if (tracker) {
+            const durationMs = now - tracker.startTime;
+            const durationSec = Math.round(durationMs / 1000);
+            if (durationMs < config.earlyCrashThresholdSec * 1000 && tracker.eventCount < config.earlyCrashMinTools) {
+                const crashMsg = `Subagent '${subagentName}' appears to have crashed (${durationSec}s after start, ${tracker.eventCount} events). Consider respawning.`;
+                try {
+                    messageSender.sendMessage(teamId, crashMsg, 'fc', 'subagent_crash');
+                    console.log(`[EventCollector] Subagent crash advisory sent for ${subagentName} on team ${teamId}`);
+                }
+                catch {
+                    // Non-critical — silently ignore send failures
+                }
+            }
+            // Clean up tracker regardless of crash detection
+            subagentTrackers.delete(trackerKey);
+        }
+    }
+    // ── Capture inter-agent message routing ───────────────────────
+    // When a SendMessage tool call is received with a msg_to field,
+    // record the message in the agent_messages table for routing visibility.
+    if (payload.tool_name === 'SendMessage' && payload.msg_to) {
+        try {
+            db.insertAgentMessage({
+                teamId,
+                eventId,
+                sender: normalizeAgentName(payload.agent_type),
+                recipient: normalizeAgentName(payload.msg_to),
+                summary: payload.msg_summary || null,
+                content: payload.message || null,
+                sessionId: payload.session_id || null,
+            });
+        }
+        catch {
+            // Non-critical — silently ignore insert failures
+        }
+    }
+    return { event_id: eventId, team_id: teamId, processed: true };
+}
+// ---------------------------------------------------------------------------
+// Error class
+// ---------------------------------------------------------------------------
+export class EventCollectorError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'EventCollectorError';
+        this.code = code;
+    }
+}
+// ---------------------------------------------------------------------------
+// Utility: clear throttle state (for testing)
+// ---------------------------------------------------------------------------
+/** Reset all throttle state. Intended for use in tests only. */
+export function resetThrottleState() {
+    lastToolUseByTeam.clear();
+}
+/** Reset subagent tracking state. Intended for use in tests only. */
+export function resetSubagentTrackers() {
+    subagentTrackers.clear();
+}
+//# sourceMappingURL=event-collector.js.map

package/dist/server/services/event-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-collector.js","sourceRoot":"","sources":["../../../src/server/services/event-collector.ts"],"names":[],"mappings":"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"}

package/dist/server/services/event-service.d.ts

@@ -0,0 +1,22 @@
+export declare class EventService {
+    /**
+     * Query events with optional filters.
+     *
+     * @param filters - Optional query filters
+     * @returns Array of matching events
+     * @throws ServiceError with code VALIDATION for invalid filter values
+     */
+    queryEvents(filters: {
+        teamId?: number;
+        eventType?: string;
+        since?: string;
+        limit?: number;
+    }): unknown[];
+}
+/**
+ * Get the singleton EventService instance.
+ *
+ * @returns EventService singleton
+ */
+export declare function getEventService(): EventService;
+//# sourceMappingURL=event-service.d.ts.map

package/dist/server/services/event-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-service.d.ts","sourceRoot":"","sources":["../../../src/server/services/event-service.ts"],"names":[],"mappings":"AAeA,qBAAa,YAAY;IACvB;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,EAAE;CAmBd;AAQD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C"}

package/dist/server/services/event-service.js

@@ -0,0 +1,53 @@
+// =============================================================================
+// Fleet Commander — Event Service
+// =============================================================================
+// Wraps event queries for route consumption. The event ingestion (POST) stays
+// in the route because it involves HTTP payload parsing and queue-processing
+// side effects that are orchestration concerns.
+// =============================================================================
+import { getDatabase } from '../db.js';
+import { validationError } from './service-error.js';
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class EventService {
+    /**
+     * Query events with optional filters.
+     *
+     * @param filters - Optional query filters
+     * @returns Array of matching events
+     * @throws ServiceError with code VALIDATION for invalid filter values
+     */
+    queryEvents(filters) {
+        const { teamId, eventType, since, limit } = filters;
+        if (teamId !== undefined && (isNaN(teamId) || teamId < 1)) {
+            throw validationError('Invalid team_id');
+        }
+        if (limit !== undefined && (isNaN(limit) || limit < 1)) {
+            throw validationError('Invalid limit');
+        }
+        const db = getDatabase();
+        return db.getAllEvents({
+            teamId,
+            eventType,
+            since,
+            limit: limit ?? 100,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton
+// ---------------------------------------------------------------------------
+let _instance = null;
+/**
+ * Get the singleton EventService instance.
+ *
+ * @returns EventService singleton
+ */
+export function getEventService() {
+    if (!_instance) {
+        _instance = new EventService();
+    }
+    return _instance;
+}
+//# sourceMappingURL=event-service.js.map

package/dist/server/services/event-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-service.js","sourceRoot":"","sources":["../../../src/server/services/event-service.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAChF,8EAA8E;AAC9E,6EAA6E;AAC7E,gDAAgD;AAChD,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,OAAO,YAAY;IACvB;;;;;;OAMG;IACH,WAAW,CAAC,OAKX;QACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAEpD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACvD,MAAM,eAAe,CAAC,eAAe,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC,YAAY,CAAC;YACrB,MAAM;YACN,SAAS;YACT,KAAK;YACL,KAAK,EAAE,KAAK,IAAI,GAAG;SACpB,CAAC,CAAC;IACL,CAAC;CACF;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,IAAI,SAAS,GAAwB,IAAI,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,YAAY,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/server/services/github-poller.d.ts

@@ -0,0 +1,68 @@
+declare class GitHubPoller {
+    private interval;
+    /** Whether any team needs fast polling (pending CI or awaiting PR detection) */
+    private needsFastPoll;
+    /** Guard against concurrent poll() invocations */
+    private isPolling;
+    /**
+     * In-memory tracking of previously-blocked issues.
+     * Maps "projectId:issueNumber" -> array of blocking issue numbers.
+     * Used to detect when all blockers close so we can broadcast dependency_resolved.
+     * Lost on restart, which is acceptable since we do NOT auto-launch.
+     */
+    private previouslyBlocked;
+    /**
+     * Start the polling loop. Uses adaptive intervals:
+     * - Normal: config.githubPollIntervalMs (default 30s)
+     * - Fast: 10s when teams are awaiting PR detection or have pending CI
+     */
+    start(): void;
+    /** Schedule the next poll with adaptive interval */
+    private scheduleNextPoll;
+    /** Trigger an immediate extra poll (e.g. after a PR is detected) */
+    triggerPoll(): void;
+    /**
+     * Stop the polling loop.
+     */
+    stop(): void;
+    /**
+     * Execute a single poll cycle. Iterates over all active projects,
+     * then checks teams within each project.
+     */
+    poll(): Promise<void>;
+    private pollPR;
+    /**
+     * Check dependency resolution for issues that were previously blocked.
+     * When all blockers close, broadcasts a `dependency_resolved` SSE event
+     * and triggers processQueue() to auto-launch newly unblocked teams.
+     */
+    private checkDependencyResolution;
+    /**
+     * Register an issue as blocked by dependencies.
+     * Called externally when a launch is blocked by the dependency check.
+     */
+    trackBlockedIssue(projectId: number, issueNumber: number, blockerNumbers: number[]): void;
+    /**
+     * Remove an issue from blocked tracking (e.g. when force-launched).
+     */
+    untrackBlockedIssue(projectId: number, issueNumber: number): void;
+    /**
+     * Read the current branch from a worktree. Returns null if the worktree
+     * doesn't exist or the branch can't be determined.
+     *
+     * The agent may rename the branch after launch (e.g. from "worktree-kea-767"
+     * to "refactor/fix/767-unit-user-role-logic"), so we must check the actual
+     * git state rather than relying on the initially stored branch name.
+     */
+    private detectWorktreeBranch;
+    private detectPR;
+    private deriveCIStatus;
+    /**
+     * Execute a `gh` CLI command and return stdout, or `null` on error.
+     * Errors are logged but never thrown — the caller decides how to proceed.
+     */
+    private execGH;
+}
+export declare const githubPoller: GitHubPoller;
+export {};
+//# sourceMappingURL=github-poller.d.ts.map

package/dist/server/services/github-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-poller.d.ts","sourceRoot":"","sources":["../../../src/server/services/github-poller.ts"],"names":[],"mappings":"AA+DA,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAA+B;IAE/C,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAAS;IAE9B,kDAAkD;IAClD,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAA2F;IAEpH;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAkBb,oDAAoD;IACpD,OAAO,CAAC,gBAAgB;IAexB,oEAAoE;IACpE,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA4Fb,MAAM;IA6QpB;;;;OAIG;YACW,yBAAyB;IAsEvC;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzF;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IASjE;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,cAAc;IA4BtB;;;OAGG;IACH,OAAO,CAAC,MAAM;CAgBf;AAMD,eAAO,MAAM,YAAY,cAAqB,CAAC"}