@fleettools/server 0.1.0

package/dist/server/api/src/squawk/lock-coordinator.js

@@ -0,0 +1,279 @@
+/**
+ * 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
+ */
+import { getAdapter } from '../../../../squawk/src/db/index.js';
+// ============================================================================
+// LOCK COORDINATOR CLASS
+// ============================================================================
+/**
+ * Lock Coordinator
+ * Manages file locks and prevents conflicts
+ */
+export class LockCoordinator {
+    lockQueues;
+    conflicts;
+    logger;
+    // Configuration
+    LOCK_EXPIRATION_MS = 300000; // 5 minutes
+    QUEUE_CHECK_INTERVAL_MS = 1000; // 1 second
+    /**
+     * Create new lock coordinator
+     */
+    constructor() {
+        this.lockQueues = new Map();
+        this.conflicts = new Map();
+        this.logger = console;
+        this.startQueueProcessor();
+    }
+    /**
+     * Acquire lock for file
+     */
+    async acquireLock(specialistId, filePath, durationMs, purpose = 'edit') {
+        this.logger.log(`[LockCoordinator] Acquiring lock for ${filePath} by ${specialistId}`);
+        const db = getAdapter();
+        // Check for existing lock
+        const existingLock = await db.locks.getByFile(filePath);
+        if (existingLock && existingLock.status === 'active') {
+            // Conflict detected
+            this.logger.warn(`[LockCoordinator] Lock conflict for ${filePath}: held by ${existingLock.reserved_by}`);
+            const conflict = {
+                file_path: filePath,
+                current_holder: existingLock.reserved_by,
+                current_holder_expires_at: existingLock.expires_at,
+                requestor: specialistId,
+                timestamp: Date.now(),
+            };
+            // Record conflict
+            if (!this.conflicts.has(filePath)) {
+                this.conflicts.set(filePath, []);
+            }
+            this.conflicts.get(filePath).push(conflict);
+            // Add to queue
+            return this.queueLockRequest(specialistId, filePath, durationMs, purpose);
+        }
+        // Try to acquire lock
+        try {
+            const result = await db.locks.acquire({
+                file: filePath,
+                specialist_id: specialistId,
+                timeout_ms: durationMs,
+                purpose,
+            });
+            if (result.lock) {
+                this.logger.log(`[LockCoordinator] Lock acquired for ${filePath}: ${result.lock.id}`);
+                return {
+                    success: true,
+                    lock_id: result.lock.id,
+                };
+            }
+            else if (result.existing_lock) {
+                // Conflict
+                const conflict = {
+                    file_path: filePath,
+                    current_holder: result.existing_lock.reserved_by,
+                    current_holder_expires_at: result.existing_lock.expires_at,
+                    requestor: specialistId,
+                    timestamp: Date.now(),
+                };
+                if (!this.conflicts.has(filePath)) {
+                    this.conflicts.set(filePath, []);
+                }
+                this.conflicts.get(filePath).push(conflict);
+                return this.queueLockRequest(specialistId, filePath, durationMs, purpose);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            this.logger.error(`[LockCoordinator] Error acquiring lock for ${filePath}:`, message);
+            return {
+                success: false,
+                error: message,
+            };
+        }
+        return {
+            success: false,
+            error: 'Unknown error',
+        };
+    }
+    /**
+     * Release lock
+     */
+    async releaseLock(lockId) {
+        this.logger.log(`[LockCoordinator] Releasing lock ${lockId}`);
+        const db = getAdapter();
+        try {
+            const released = await db.locks.release(lockId);
+            if (released) {
+                this.logger.log(`[LockCoordinator] Lock released: ${lockId}`);
+                return true;
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            this.logger.error(`[LockCoordinator] Error releasing lock ${lockId}:`, message);
+        }
+        return false;
+    }
+    /**
+     * Queue lock request
+     */
+    async queueLockRequest(specialistId, filePath, durationMs, purpose) {
+        this.logger.log(`[LockCoordinator] Queueing lock request for ${filePath} by ${specialistId}`);
+        if (!this.lockQueues.has(filePath)) {
+            this.lockQueues.set(filePath, []);
+        }
+        const queue = this.lockQueues.get(filePath);
+        const entry = {
+            specialist_id: specialistId,
+            file_path: filePath,
+            timestamp: Date.now(),
+            timeout_ms: durationMs,
+            purpose,
+        };
+        queue.push(entry);
+        const queuePosition = queue.length;
+        this.logger.log(`[LockCoordinator] Lock request queued at position ${queuePosition}`);
+        return {
+            success: false,
+            queued: true,
+            queue_position: queuePosition,
+            error: `Lock conflict. Queued at position ${queuePosition}`,
+        };
+    }
+    /**
+     * Process lock queues
+     */
+    async processQueues() {
+        const db = getAdapter();
+        for (const [filePath, queue] of this.lockQueues) {
+            if (queue.length === 0) {
+                continue;
+            }
+            // Check if current lock is released
+            const currentLock = await db.locks.getByFile(filePath);
+            if (!currentLock || currentLock.status !== 'active') {
+                // Lock is free, try to acquire for next in queue
+                const nextEntry = queue.shift();
+                if (nextEntry) {
+                    this.logger.log(`[LockCoordinator] Processing queue for ${filePath}, trying specialist ${nextEntry.specialist_id}`);
+                    try {
+                        const result = await db.locks.acquire({
+                            file: filePath,
+                            specialist_id: nextEntry.specialist_id,
+                            timeout_ms: nextEntry.timeout_ms,
+                            purpose: nextEntry.purpose,
+                        });
+                        if (result.lock) {
+                            this.logger.log(`[LockCoordinator] Lock acquired for queued request: ${result.lock.id}`);
+                        }
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : 'Unknown error';
+                        this.logger.error(`[LockCoordinator] Error acquiring queued lock:`, message);
+                        // Re-queue the entry
+                        queue.unshift(nextEntry);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Start queue processor
+     */
+    startQueueProcessor() {
+        setInterval(() => {
+            this.processQueues().catch(error => {
+                this.logger.error('[LockCoordinator] Error processing queues:', error);
+            });
+        }, this.QUEUE_CHECK_INTERVAL_MS);
+    }
+    /**
+     * Detect conflicts
+     */
+    async detectConflicts() {
+        const allConflicts = [];
+        for (const conflicts of this.conflicts.values()) {
+            allConflicts.push(...conflicts);
+        }
+        return allConflicts;
+    }
+    /**
+     * Get lock queue for file
+     */
+    getQueueForFile(filePath) {
+        return this.lockQueues.get(filePath) || [];
+    }
+    /**
+     * Get all queued requests
+     */
+    getAllQueued() {
+        const allQueued = [];
+        for (const queue of this.lockQueues.values()) {
+            allQueued.push(...queue);
+        }
+        return allQueued;
+    }
+    /**
+     * Get conflicts for file
+     */
+    getConflictsForFile(filePath) {
+        return this.conflicts.get(filePath) || [];
+    }
+    /**
+     * Clear old conflicts
+     */
+    clearOldConflicts(olderThanMs = 3600000) {
+        const now = Date.now();
+        for (const [filePath, conflicts] of this.conflicts) {
+            const filtered = conflicts.filter(c => now - c.timestamp < olderThanMs);
+            if (filtered.length === 0) {
+                this.conflicts.delete(filePath);
+            }
+            else {
+                this.conflicts.set(filePath, filtered);
+            }
+        }
+    }
+    /**
+     * Get coordinator status
+     */
+    getStatus() {
+        return {
+            queued_requests: Array.from(this.lockQueues.values()).reduce((sum, q) => sum + q.length, 0),
+            conflicts: Array.from(this.conflicts.values()).reduce((sum, c) => sum + c.length, 0),
+            files_with_queues: Array.from(this.lockQueues.keys()),
+        };
+    }
+}
+// ============================================================================
+// SINGLETON INSTANCE
+// ============================================================================
+let coordinatorInstance = null;
+/**
+ * Get or create lock coordinator instance
+ */
+export function getLockCoordinator() {
+    if (!coordinatorInstance) {
+        coordinatorInstance = new LockCoordinator();
+    }
+    return coordinatorInstance;
+}
+/**
+ * Reset lock coordinator instance
+ */
+export function resetLockCoordinator() {
+    coordinatorInstance = null;
+}
+//# sourceMappingURL=lock-coordinator.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function registerLockRoutes(router: any, headers: Record<string, string>): void;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../../../src/squawk/lock.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QA8F9E"}

package/dist/server/api/src/squawk/lock.js

@@ -0,0 +1,87 @@
+import { lockOps } from '../../../../squawk/src/db/index.js';
+export function registerLockRoutes(router, headers) {
+    router.post('/api/v1/lock/acquire', async (req) => {
+        try {
+            const body = await req.json();
+            const { file, specialist_id, timeout_ms = 30000 } = body;
+            if (!file || !specialist_id) {
+                return new Response(JSON.stringify({ error: 'file and specialist_id are required' }), {
+                    status: 400,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            const lock = await lockOps.acquire({
+                file,
+                reserved_by: specialist_id,
+                reserved_at: new Date().toISOString(),
+                released_at: null,
+                purpose: 'edit',
+                checksum: null,
+                timeout_ms,
+                metadata: null,
+            });
+            return new Response(JSON.stringify({ lock }), {
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            console.error('Error acquiring lock:', error);
+            return new Response(JSON.stringify({ error: 'Failed to acquire lock' }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    router.post('/api/v1/lock/release', async (req) => {
+        try {
+            const body = await req.json();
+            const { lock_id, specialist_id } = body;
+            if (!lock_id) {
+                return new Response(JSON.stringify({ error: 'lock_id is required' }), {
+                    status: 400,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            const lock = await lockOps.getById(lock_id);
+            if (!lock) {
+                return new Response(JSON.stringify({ error: 'Lock not found' }), {
+                    status: 404,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            if (lock.reserved_by !== specialist_id) {
+                return new Response(JSON.stringify({ error: 'Cannot release lock: wrong specialist' }), {
+                    status: 403,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            const updatedLock = await lockOps.release(lock_id);
+            return new Response(JSON.stringify({ lock: updatedLock }), {
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            console.error('Error releasing lock:', error);
+            return new Response(JSON.stringify({ error: 'Failed to release lock' }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    router.get('/api/v1/locks', async (req) => {
+        try {
+            const locks = lockOps.getAll();
+            return new Response(JSON.stringify({ locks }), {
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            console.error('Error listing locks:', error);
+            return new Response(JSON.stringify({ error: 'Failed to list locks' }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+}
+//# sourceMappingURL=lock.js.map

package/dist/server/api/src/squawk/lock.js.map

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

package/dist/server/api/src/squawk/mailbox.d.ts

@@ -0,0 +1,2 @@
+export declare function registerMailboxRoutes(router: any, headers: Record<string, string>): void;
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/server/api/src/squawk/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../../../src/squawk/mailbox.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAuEjF"}

package/dist/server/api/src/squawk/mailbox.js

@@ -0,0 +1,66 @@
+import { mailboxOps, eventOps } from '../../../../squawk/src/db/index.js';
+export function registerMailboxRoutes(router, headers) {
+    router.post('/api/v1/mailbox/append', async (req) => {
+        try {
+            const body = await req.json();
+            const { stream_id, events } = body;
+            if (!stream_id || !Array.isArray(events)) {
+                return new Response(JSON.stringify({ error: 'stream_id and events array are required' }), {
+                    status: 400,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            if (!(await mailboxOps.exists(stream_id))) {
+                await mailboxOps.create(stream_id);
+            }
+            const formattedEvents = events.map((e) => ({
+                type: e.type,
+                stream_id,
+                data: JSON.stringify(e.data),
+                occurred_at: new Date().toISOString(),
+                causation_id: e.causation_id || null,
+                metadata: e.metadata ? JSON.stringify(e.metadata) : null,
+            }));
+            const inserted = await eventOps.append(stream_id, formattedEvents);
+            const mailbox = await mailboxOps.getById(stream_id);
+            const mailboxEvents = await eventOps.getByMailbox(stream_id);
+            return new Response(JSON.stringify({
+                mailbox: { ...mailbox, events: mailboxEvents },
+                inserted: inserted.length
+            }), {
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            console.error('Error appending to mailbox:', error);
+            return new Response(JSON.stringify({ error: 'Failed to append to mailbox' }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+    router.get('/api/v1/mailbox/:streamId', async (req, params) => {
+        try {
+            const streamId = params.streamId;
+            const mailbox = await mailboxOps.getById(streamId);
+            if (!mailbox) {
+                return new Response(JSON.stringify({ error: 'Mailbox not found' }), {
+                    status: 404,
+                    headers: { ...headers, 'Content-Type': 'application/json' },
+                });
+            }
+            const events = await eventOps.getByMailbox(streamId);
+            return new Response(JSON.stringify({ mailbox: { ...mailbox, events } }), {
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+        catch (error) {
+            console.error('Error getting mailbox:', error);
+            return new Response(JSON.stringify({ error: 'Failed to get mailbox' }), {
+                status: 500,
+                headers: { ...headers, 'Content-Type': 'application/json' },
+            });
+        }
+    });
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/server/api/src/squawk/mailbox.js.map

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

package/dist/server/api/src/squawk/spawning.d.ts

@@ -0,0 +1,79 @@
+/**
+ * FleetTools Specialist Spawning
+ *
+ * Handles parallel and sequential spawning of specialists for sorties.
+ *
+ * Parallel Spawning:
+ * - Independent sorties spawn simultaneously
+ * - Use Task tool with run_in_background: true
+ * - Wait for all parallel sorties to complete
+ *
+ * Sequential Spawning:
+ * - Dependent sorties spawn after dependencies complete
+ * - Use Task tool with run_in_background: false
+ * - Wait for each sortie before spawning next
+ *
+ * @version 1.0.0
+ * @since 2026-01-08
+ */
+import type { Sortie, Mission } from '../../../../squawk/src/db/types.js';
+/**
+ * Sortie with dependency information
+ */
+export interface SortieWithDeps extends Sortie {
+    dependencies?: string[];
+}
+/**
+ * Spawning result
+ */
+export interface SpawningResult {
+    success: boolean;
+    parallel_groups: Sortie[][];
+    total_sorties: number;
+    completed_sorties: number;
+    failed_sorties: number;
+    errors: string[];
+}
+/**
+ * Identify independent sorties (no dependencies)
+ */
+export declare function identifyIndependentSorties(sorties: SortieWithDeps[]): Sortie[];
+/**
+ * Identify dependent sorties
+ */
+export declare function identifyDependentSorties(sorties: SortieWithDeps[]): SortieWithDeps[];
+/**
+ * Spawn sorties in parallel
+ *
+ * Independent sorties are spawned simultaneously using background tasks.
+ * The function waits for all parallel sorties to complete before returning.
+ */
+export declare function spawnParallel(sorties: Sortie[]): Promise<SpawningResult>;
+/**
+ * Spawn sorties sequentially
+ *
+ * Dependent sorties are spawned one at a time, waiting for each to complete
+ * before spawning the next. Dependencies are respected.
+ */
+export declare function spawnSequential(sorties: SortieWithDeps[]): Promise<SpawningResult>;
+/**
+ * Spawn sorties with mixed parallel and sequential groups
+ *
+ * This is the main spawning function that:
+ * 1. Identifies independent sorties (parallel group)
+ * 2. Spawns them in parallel
+ * 3. Identifies dependent sorties (sequential groups)
+ * 4. Spawns them sequentially after dependencies complete
+ */
+export declare function spawnMixed(sorties: SortieWithDeps[]): Promise<SpawningResult>;
+/**
+ * Spawn all sorties for a mission
+ *
+ * This is the main entry point that:
+ * 1. Gets all sorties for the mission
+ * 2. Determines spawning strategy (parallel, sequential, or mixed)
+ * 3. Spawns specialists for each sortie
+ * 4. Waits for completion
+ */
+export declare function spawnForMission(mission: Mission): Promise<SpawningResult>;
+//# sourceMappingURL=spawning.d.ts.map

package/dist/server/api/src/squawk/spawning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawning.d.ts","sourceRoot":"","sources":["../../../../../src/squawk/spawning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAM1E;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAE9E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAEpF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA6C9E;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAmDxF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAyCnF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAmC/E"}