@fleettools/server 0.1.0

package/dist/server/api/src/squawk/dispatch-orchestrator.js

@@ -0,0 +1,296 @@
+/**
+ * FleetTools Dispatch Orchestrator
+ *
+ * The Dispatch Orchestrator manages the lifecycle of specialist agents working on sorties.
+ * It coordinates:
+ * - Specialist spawning (parallel and sequential)
+ * - Progress monitoring
+ * - Blocker resolution
+ * - File lock coordination
+ * - Checkpoint creation
+ * - Completion handling
+ *
+ * @version 1.0.0
+ * @since 2026-01-08
+ */
+import { randomUUID } from 'crypto';
+import { getAdapter } from '../../../../squawk/src/db/index.js';
+// ============================================================================
+// DISPATCH ORCHESTRATOR CLASS
+// ============================================================================
+/**
+ * Dispatch Orchestrator
+ * Manages specialist spawning and coordination
+ */
+export class DispatchOrchestrator {
+    state;
+    config;
+    logger;
+    /**
+     * Create new orchestrator
+     */
+    constructor(missionId, config) {
+        this.state = {
+            mission_id: missionId,
+            status: 'idle',
+            specialists: new Map(),
+            active_sorties: new Map(),
+            pending_sorties: [],
+            completed_sorties: [],
+            failed_sorties: [],
+            checkpoints: [],
+            last_checkpoint_time: Date.now(),
+        };
+        this.config = {
+            max_concurrent: config?.max_concurrent || 5,
+            heartbeat_timeout_ms: config?.heartbeat_timeout_ms || 300000, // 5 minutes
+            checkpoint_interval_ms: config?.checkpoint_interval_ms || 60000, // 1 minute
+            auto_recovery: config?.auto_recovery !== false,
+        };
+        this.logger = console;
+    }
+    /**
+     * Initialize orchestrator
+     */
+    async initialize() {
+        this.logger.log(`[Orchestrator] Initializing for mission ${this.state.mission_id}`);
+        this.state.status = 'running';
+    }
+    /**
+     * Spawn specialists for mission
+     */
+    async spawnSpecialists(mission) {
+        this.logger.log(`[Orchestrator] Spawning specialists for mission ${mission.id}`);
+        const db = getAdapter();
+        // Get all sorties for mission
+        const sorties = await db.sorties.getByMission(mission.id);
+        this.state.pending_sorties = sorties.filter(s => s.status === 'pending');
+        const spawnedSpecialists = [];
+        // Spawn one specialist per sortie
+        for (const sortie of this.state.pending_sorties) {
+            const specialistId = `specialist-${randomUUID().substring(0, 8)}`;
+            // Register specialist
+            const specialist = await db.specialists.register({
+                id: specialistId,
+                name: `Specialist-${specialistId.substring(0, 8)}`,
+                capabilities: ['code-review', 'testing', 'implementation'],
+            });
+            // Track specialist
+            this.state.specialists.set(specialistId, {
+                id: specialistId,
+                name: specialist.name,
+                sortie_id: sortie.id,
+                status: 'spawned',
+                progress_percent: 0,
+                last_heartbeat: Date.now(),
+                blockers: [],
+            });
+            // Add to active sorties
+            this.state.active_sorties.set(sortie.id, sortie);
+            spawnedSpecialists.push(specialist);
+            this.logger.log(`[Orchestrator] Spawned specialist ${specialistId} for sortie ${sortie.id}`);
+        }
+        return spawnedSpecialists;
+    }
+    /**
+     * Monitor specialist progress
+     */
+    async monitorProgress() {
+        this.logger.log(`[Orchestrator] Monitoring progress for ${this.state.specialists.size} specialists`);
+        const db = getAdapter();
+        const now = Date.now();
+        // Check each specialist
+        for (const [specialistId, specialist] of this.state.specialists) {
+            // Check heartbeat
+            const timeSinceHeartbeat = now - specialist.last_heartbeat;
+            if (timeSinceHeartbeat > this.config.heartbeat_timeout_ms) {
+                this.logger.warn(`[Orchestrator] Specialist ${specialistId} heartbeat timeout`);
+                specialist.status = 'failed';
+                continue;
+            }
+            // Get specialist from DB
+            const dbSpecialist = await db.specialists.getById(specialistId);
+            if (dbSpecialist) {
+                specialist.last_heartbeat = now;
+            }
+        }
+        // Check if checkpoint needed
+        const timeSinceCheckpoint = now - this.state.last_checkpoint_time;
+        if (timeSinceCheckpoint > this.config.checkpoint_interval_ms) {
+            await this.createCheckpoint('progress');
+            this.state.last_checkpoint_time = now;
+        }
+    }
+    /**
+     * Resolve blocker
+     */
+    async resolveBlocker(specialistId, blocker) {
+        this.logger.log(`[Orchestrator] Resolving blocker for specialist ${specialistId}:`, blocker);
+        const specialist = this.state.specialists.get(specialistId);
+        if (!specialist) {
+            this.logger.error(`[Orchestrator] Specialist ${specialistId} not found`);
+            return;
+        }
+        // Record blocker
+        specialist.blockers.push({
+            type: blocker.type,
+            description: blocker.description,
+            timestamp: Date.now(),
+        });
+        // Handle based on type
+        switch (blocker.type) {
+            case 'lock_timeout':
+                this.logger.log(`[Orchestrator] Lock timeout for specialist ${specialistId}, retrying...`);
+                // Retry logic would be implemented here
+                break;
+            case 'api_error':
+                this.logger.log(`[Orchestrator] API error for specialist ${specialistId}, retrying...`);
+                // Retry logic would be implemented here
+                break;
+            case 'dependency':
+                this.logger.log(`[Orchestrator] Dependency blocker for specialist ${specialistId}, waiting...`);
+                // Wait for dependency logic would be implemented here
+                break;
+            case 'other':
+                this.logger.warn(`[Orchestrator] Manual intervention needed for specialist ${specialistId}`);
+                specialist.status = 'blocked';
+                break;
+        }
+    }
+    /**
+     * Coordinate file locks
+     */
+    async coordinateLocks(sorties) {
+        this.logger.log(`[Orchestrator] Coordinating locks for ${sorties.length} sorties`);
+        const db = getAdapter();
+        // Get all active locks
+        const activeLocks = await db.locks.getActive();
+        // Check for conflicts
+        const fileToSorties = new Map();
+        for (const sortie of sorties) {
+            if (sortie.files) {
+                for (const file of sortie.files) {
+                    if (!fileToSorties.has(file)) {
+                        fileToSorties.set(file, []);
+                    }
+                    fileToSorties.get(file).push(sortie.id);
+                }
+            }
+        }
+        // Log conflicts
+        for (const [file, sortieIds] of fileToSorties) {
+            if (sortieIds.length > 1) {
+                this.logger.warn(`[Orchestrator] File conflict detected: ${file} used by ${sortieIds.length} sorties`);
+            }
+        }
+    }
+    /**
+     * Create checkpoint
+     */
+    async createCheckpoint(trigger) {
+        this.logger.log(`[Orchestrator] Creating checkpoint (trigger: ${trigger})`);
+        const db = getAdapter();
+        // Calculate progress
+        const totalSorties = this.state.pending_sorties.length + this.state.completed_sorties.length + this.state.failed_sorties.length;
+        const completedSorties = this.state.completed_sorties.length;
+        const progressPercent = totalSorties > 0 ? (completedSorties / totalSorties) * 100 : 0;
+        // Create checkpoint
+        const checkpoint = await db.checkpoints.save({
+            mission_id: this.state.mission_id,
+            trigger,
+            progress_percent: progressPercent,
+            created_by: 'dispatch-orchestrator',
+            sorties: this.state.completed_sorties.map(s => ({
+                id: s.id,
+                status: s.status,
+                assigned_to: s.assigned_to,
+                files: s.files,
+                started_at: s.started_at,
+                progress: s.progress,
+                progress_notes: s.progress_notes,
+            })),
+            active_locks: [],
+            pending_messages: [],
+            recovery_context: {
+                last_action: `Checkpoint created with trigger: ${trigger}`,
+                next_steps: this.state.pending_sorties.map(s => `Complete sortie: ${s.title}`),
+                blockers: Array.from(this.state.specialists.values())
+                    .flatMap(s => s.blockers.map(b => `${b.type}: ${b.description}`)),
+                files_modified: [],
+                mission_summary: `Mission ${this.state.mission_id}: ${completedSorties}/${totalSorties} sorties completed`,
+                elapsed_time_ms: Date.now() - (this.state.checkpoints[0]?.timestamp ? new Date(this.state.checkpoints[0].timestamp).getTime() : Date.now()),
+                last_activity_at: new Date().toISOString(),
+            },
+        });
+        this.state.checkpoints.push(checkpoint);
+        return checkpoint;
+    }
+    /**
+     * Handle specialist completion
+     */
+    async onSpecialistComplete(specialistId, result) {
+        this.logger.log(`[Orchestrator] Specialist ${specialistId} completed`);
+        const specialist = this.state.specialists.get(specialistId);
+        if (!specialist) {
+            this.logger.error(`[Orchestrator] Specialist ${specialistId} not found`);
+            return;
+        }
+        // Update specialist status
+        specialist.status = 'completed';
+        specialist.progress_percent = 100;
+        // Get sortie
+        const db = getAdapter();
+        const sortie = await db.sorties.getById(specialist.sortie_id);
+        if (sortie) {
+            // Move to completed
+            this.state.active_sorties.delete(sortie.id);
+            this.state.completed_sorties.push(sortie);
+            this.logger.log(`[Orchestrator] Sortie ${sortie.id} completed`);
+        }
+        // Release locks
+        const activeLocks = await db.locks.getActive();
+        for (const lock of activeLocks) {
+            if (lock.reserved_by === specialistId) {
+                await db.locks.release(lock.id);
+                this.logger.log(`[Orchestrator] Released lock ${lock.id}`);
+            }
+        }
+    }
+    /**
+     * Get orchestrator status
+     */
+    getStatus() {
+        return {
+            ...this.state,
+            specialists: new Map(this.state.specialists),
+            active_sorties: new Map(this.state.active_sorties),
+        };
+    }
+    /**
+     * Shutdown orchestrator
+     */
+    async shutdown() {
+        this.logger.log(`[Orchestrator] Shutting down for mission ${this.state.mission_id}`);
+        this.state.status = 'completed';
+    }
+}
+// ============================================================================
+// SINGLETON INSTANCE
+// ============================================================================
+let orchestratorInstance = null;
+/**
+ * Get or create orchestrator instance
+ */
+export function getOrchestrator(missionId, config) {
+    if (!orchestratorInstance) {
+        orchestratorInstance = new DispatchOrchestrator(missionId, config);
+    }
+    return orchestratorInstance;
+}
+/**
+ * Reset orchestrator instance
+ */
+export function resetOrchestrator() {
+    orchestratorInstance = null;
+}
+//# sourceMappingURL=dispatch-orchestrator.js.map

package/dist/server/api/src/squawk/dispatch-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-orchestrator.js","sourceRoot":"","sources":["../../../../../src/squawk/dispatch-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AA2DhE,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,KAAK,CAAoB;IACzB,MAAM,CAA+B;IACrC,MAAM,CAAU;IAExB;;OAEG;IACH,YAAY,SAAiB,EAAE,MAA2B;QACxD,IAAI,CAAC,KAAK,GAAG;YACX,UAAU,EAAE,SAAS;YACrB,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,IAAI,GAAG,EAAE;YACtB,cAAc,EAAE,IAAI,GAAG,EAAE;YACzB,eAAe,EAAE,EAAE;YACnB,iBAAiB,EAAE,EAAE;YACrB,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE;YACf,oBAAoB,EAAE,IAAI,CAAC,GAAG,EAAE;SACjC,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,CAAC;YAC3C,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,IAAI,MAAM,EAAE,YAAY;YAC1E,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,IAAI,KAAK,EAAE,WAAW;YAC5E,aAAa,EAAE,MAAM,EAAE,aAAa,KAAK,KAAK;SAC/C,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2CAA2C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAgB;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mDAAmD,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAEjF,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QAExB,8BAA8B;QAC9B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAEzE,MAAM,kBAAkB,GAAiB,EAAE,CAAC;QAE5C,kCAAkC;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,cAAc,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAElE,sBAAsB;YACtB,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC;gBAC/C,EAAE,EAAE,YAAY;gBAChB,IAAI,EAAE,cAAc,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBAClD,YAAY,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,gBAAgB,CAAC;aAC3D,CAAC,CAAC;YAEH,mBAAmB;YACnB,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE;gBACvC,EAAE,EAAE,YAAY;gBAChB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,SAAS,EAAE,MAAM,CAAC,EAAE;gBACpB,MAAM,EAAE,SAAS;gBACjB,gBAAgB,EAAE,CAAC;gBACnB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;gBAC1B,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;YAEH,wBAAwB;YACxB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAEjD,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,qCAAqC,YAAY,eAAe,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0CAA0C,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,cAAc,CAAC,CAAC;QAErG,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,wBAAwB;QACxB,KAAK,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAChE,kBAAkB;YAClB,MAAM,kBAAkB,GAAG,GAAG,GAAG,UAAU,CAAC,cAAc,CAAC;YAC3D,IAAI,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;gBAC1D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,YAAY,oBAAoB,CAAC,CAAC;gBAChF,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,yBAAyB;YACzB,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAChE,IAAI,YAAY,EAAE,CAAC;gBACjB,UAAU,CAAC,cAAc,GAAG,GAAG,CAAC;YAClC,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC;QAClE,IAAI,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;YAC7D,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,GAAG,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,YAAoB,EAAE,OAAY;QACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mDAAmD,YAAY,GAAG,EAAE,OAAO,CAAC,CAAC;QAE7F,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,YAAY,YAAY,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,iBAAiB;QACjB,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YACvB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,uBAAuB;QACvB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,cAAc;gBACjB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8CAA8C,YAAY,eAAe,CAAC,CAAC;gBAC3F,wCAAwC;gBACxC,MAAM;YAER,KAAK,WAAW;gBACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2CAA2C,YAAY,eAAe,CAAC,CAAC;gBACxF,wCAAwC;gBACxC,MAAM;YAER,KAAK,YAAY;gBACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oDAAoD,YAAY,cAAc,CAAC,CAAC;gBAChG,sDAAsD;gBACtD,MAAM;YAER,KAAK,OAAO;gBACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4DAA4D,YAAY,EAAE,CAAC,CAAC;gBAC7F,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC;gBAC9B,MAAM;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAiB;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,yCAAyC,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;QAEnF,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QAExB,uBAAuB;QACvB,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAE/C,sBAAsB;QACtB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;QAClD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAChC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7B,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC9B,CAAC;oBACD,aAAa,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,IAAI,YAAY,SAAS,CAAC,MAAM,UAAU,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAwC;QAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gDAAgD,OAAO,GAAG,CAAC,CAAC;QAE5E,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QAExB,qBAAqB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QAChI,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAC7D,MAAM,eAAe,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvF,oBAAoB;QACpB,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;YAC3C,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,OAAO;YACP,gBAAgB,EAAE,eAAe;YACjC,UAAU,EAAE,uBAAuB;YACnC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9C,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,cAAc,EAAE,CAAC,CAAC,cAAc;aACjC,CAAC,CAAC;YACH,YAAY,EAAE,EAAE;YAChB,gBAAgB,EAAE,EAAE;YACpB,gBAAgB,EAAE;gBAChB,WAAW,EAAE,oCAAoC,OAAO,EAAE;gBAC1D,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC9E,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;qBAClD,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBACnE,cAAc,EAAE,EAAE;gBAClB,eAAe,EAAE,WAAW,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,gBAAgB,IAAI,YAAY,oBAAoB;gBAC1G,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3I,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC3C;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,YAAoB,EAAE,MAAW;QAC1D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,6BAA6B,YAAY,YAAY,CAAC,CAAC;QAEvE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,YAAY,YAAY,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,2BAA2B;QAC3B,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC;QAChC,UAAU,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAElC,aAAa;QACb,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,oBAAoB;YACpB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;QAClE,CAAC;QAED,gBAAgB;QAChB,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;gBACtC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,GAAG,IAAI,CAAC,KAAK;YACb,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YAC5C,cAAc,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;SACnD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,4CAA4C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;IAClC,CAAC;CACF;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,IAAI,oBAAoB,GAAgC,IAAI,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAA2B;IAC5E,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,oBAAoB,GAAG,IAAI,CAAC;AAC9B,CAAC"}

package/dist/server/api/src/squawk/lock-coordinator.d.ts

@@ -0,0 +1,118 @@
+/**
+ * FleetTools Lock Coordinator
+ *
+ * Coordinates file locks across specialists to prevent conflicts.
+ * Features:
+ * - Lock acquisition with timeout
+ * - Lock release
+ * - Conflict detection
+ * - Conflict resolution (queue)
+ * - Lock expiration
+ * - Integration with CTK (file system)
+ *
+ * @version 1.0.0
+ * @since 2026-01-08
+ */
+/**
+ * Lock queue entry
+ */
+export interface LockQueueEntry {
+    specialist_id: string;
+    file_path: string;
+    timestamp: number;
+    timeout_ms: number;
+    purpose: 'edit' | 'read' | 'delete';
+}
+/**
+ * Lock conflict
+ */
+export interface LockConflict {
+    file_path: string;
+    current_holder: string;
+    current_holder_expires_at: string;
+    requestor: string;
+    timestamp: number;
+}
+/**
+ * Lock acquisition result
+ */
+export interface LockAcquisitionResult {
+    success: boolean;
+    lock_id?: string;
+    conflict?: LockConflict;
+    queued?: boolean;
+    queue_position?: number;
+    error?: string;
+}
+/**
+ * Lock Coordinator
+ * Manages file locks and prevents conflicts
+ */
+export declare class LockCoordinator {
+    private lockQueues;
+    private conflicts;
+    private logger;
+    private readonly LOCK_EXPIRATION_MS;
+    private readonly QUEUE_CHECK_INTERVAL_MS;
+    /**
+     * Create new lock coordinator
+     */
+    constructor();
+    /**
+     * Acquire lock for file
+     */
+    acquireLock(specialistId: string, filePath: string, durationMs: number, purpose?: 'edit' | 'read' | 'delete'): Promise<LockAcquisitionResult>;
+    /**
+     * Release lock
+     */
+    releaseLock(lockId: string): Promise<boolean>;
+    /**
+     * Queue lock request
+     */
+    private queueLockRequest;
+    /**
+     * Process lock queues
+     */
+    private processQueues;
+    /**
+     * Start queue processor
+     */
+    private startQueueProcessor;
+    /**
+     * Detect conflicts
+     */
+    detectConflicts(): Promise<LockConflict[]>;
+    /**
+     * Get lock queue for file
+     */
+    getQueueForFile(filePath: string): LockQueueEntry[];
+    /**
+     * Get all queued requests
+     */
+    getAllQueued(): LockQueueEntry[];
+    /**
+     * Get conflicts for file
+     */
+    getConflictsForFile(filePath: string): LockConflict[];
+    /**
+     * Clear old conflicts
+     */
+    clearOldConflicts(olderThanMs?: number): void;
+    /**
+     * Get coordinator status
+     */
+    getStatus(): {
+        queued_requests: number;
+        conflicts: number;
+        files_with_queues: string[];
+    };
+}
+/**
+ * Get or create lock coordinator instance
+ */
+export declare function getLockCoordinator(): LockCoordinator;
+/**
+ * Reset lock coordinator instance
+ */
+export declare function resetLockCoordinator(): void;
+//# sourceMappingURL=lock-coordinator.d.ts.map

package/dist/server/api/src/squawk/lock-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-coordinator.d.ts","sourceRoot":"","sources":["../../../../../src/squawk/lock-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,MAAM,CAAU;IAGxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAEhD;;OAEG;;IAQH;;OAEG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,QAAiB,GAC3C,OAAO,CAAC,qBAAqB,CAAC;IA6EjC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBnD;;OAEG;YACW,gBAAgB;IAkC9B;;OAEG;YACW,aAAa;IAuC3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAUhD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAInD;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE;IAUhC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE;IAIrD;;OAEG;IACH,iBAAiB,CAAC,WAAW,GAAE,MAAgB,GAAG,IAAI;IActD;;OAEG;IACH,SAAS,IAAI;QACX,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B;CAOF;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}