@cluesmith/codev 1.1.0

package/dist/agent-farm/commands/util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Util command - spawns a utility terminal
+ *
+ * When the dashboard is running, this creates a tab in the dashboard.
+ * When the dashboard is not running, it spawns the terminal directly.
+ */
+interface UtilOptions {
+    name?: string;
+}
+/**
+ * Spawn a utility terminal
+ */
+export declare function util(options?: UtilOptions): Promise<void>;
+export {};
+//# sourceMappingURL=util.d.ts.map

package/dist/agent-farm/commands/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAuCD;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEnE"}

package/dist/agent-farm/commands/util.js

@@ -0,0 +1,108 @@
+/**
+ * Util command - spawns a utility terminal
+ *
+ * When the dashboard is running, this creates a tab in the dashboard.
+ * When the dashboard is not running, it spawns the terminal directly.
+ */
+import { getConfig, getResolvedCommands } from '../utils/index.js';
+import { logger, fatal } from '../utils/logger.js';
+import { spawnDetached, commandExists, findAvailablePort, openBrowser } from '../utils/shell.js';
+import { loadState, addUtil } from '../state.js';
+/**
+ * Try to create a shell tab via the dashboard API
+ * Returns true if successful, false if dashboard not available
+ */
+async function tryDashboardApi(name) {
+    const state = loadState();
+    // Dashboard runs on architectPort + 1
+    if (!state.architect) {
+        return false;
+    }
+    const config = getConfig();
+    const dashboardPort = config.architectPort + 1;
+    try {
+        const response = await fetch(`http://localhost:${dashboardPort}/api/tabs/shell`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name }),
+        });
+        if (response.ok) {
+            const result = await response.json();
+            logger.success(`Shell opened in dashboard tab`);
+            logger.kv('Name', result.name);
+            return true;
+        }
+        // Dashboard returned an error, fall through to direct spawn
+        return false;
+    }
+    catch {
+        // Dashboard not available
+        return false;
+    }
+}
+/**
+ * Spawn a utility terminal
+ */
+export async function util(options = {}) {
+    const config = getConfig();
+    // Try to use dashboard API first (if dashboard is running)
+    const dashboardOpened = await tryDashboardApi(options.name);
+    if (dashboardOpened) {
+        return;
+    }
+    // Fall back to direct spawn
+    // Check for ttyd
+    if (!(await commandExists('ttyd'))) {
+        fatal('ttyd not found. Install with: brew install ttyd');
+    }
+    // Generate ID and name
+    const id = generateUtilId();
+    const name = options.name || `util-${id}`;
+    // Find available port
+    const port = await findAvailablePort(config.utilPortRange[0]);
+    // Get shell command from config (hierarchy: CLI > config.json > default)
+    const commands = getResolvedCommands();
+    const shell = commands.shell;
+    logger.header(`Spawning Utility Terminal`);
+    logger.kv('ID', id);
+    logger.kv('Name', name);
+    logger.kv('Port', port);
+    // Start ttyd
+    const ttydArgs = [
+        '-W',
+        '-p', String(port),
+        '-t', `titleFixed=${name}`,
+        '-t', 'fontSize=14',
+        '-t', 'rightClickSelectsWord=true', // Enable word selection on right-click for better UX
+        shell,
+    ];
+    const ttydProcess = spawnDetached('ttyd', ttydArgs, {
+        cwd: config.projectRoot,
+    });
+    if (!ttydProcess.pid) {
+        fatal('Failed to start ttyd process for utility terminal');
+    }
+    // Create util record
+    const utilTerminal = {
+        id,
+        name,
+        port,
+        pid: ttydProcess.pid,
+    };
+    addUtil(utilTerminal);
+    logger.blank();
+    logger.success(`Utility terminal spawned!`);
+    logger.kv('Terminal', `http://localhost:${port}`);
+    // Open in browser if not using dashboard
+    const url = `http://localhost:${port}`;
+    await openBrowser(url);
+}
+/**
+ * Generate a unique utility ID
+ */
+function generateUtilId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 4);
+    return `U${timestamp.slice(-3)}${random}`.toUpperCase();
+}
+//# sourceMappingURL=util.js.map

package/dist/agent-farm/commands/util.js.map

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

package/dist/agent-farm/db/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Database Error Handling Utilities
+ *
+ * Provides retry logic for SQLITE_BUSY errors and clear error messages
+ */
+/**
+ * Execute a function with retry logic for SQLITE_BUSY errors
+ *
+ * The busy_timeout pragma handles most cases, but this provides an additional
+ * layer of retry logic for extreme contention scenarios.
+ */
+export declare function withRetry<T>(fn: () => T, maxRetries?: number): T;
+/**
+ * Check if better-sqlite3 is available and provide helpful error messages
+ */
+export declare function checkDatabaseAvailability(): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/agent-farm/db/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,SAAI,GAAG,CAAC,CAc3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAahD"}

package/dist/agent-farm/db/errors.js

@@ -0,0 +1,46 @@
+/**
+ * Database Error Handling Utilities
+ *
+ * Provides retry logic for SQLITE_BUSY errors and clear error messages
+ */
+/**
+ * Execute a function with retry logic for SQLITE_BUSY errors
+ *
+ * The busy_timeout pragma handles most cases, but this provides an additional
+ * layer of retry logic for extreme contention scenarios.
+ */
+export function withRetry(fn, maxRetries = 3) {
+    for (let i = 0; i < maxRetries; i++) {
+        try {
+            return fn();
+        }
+        catch (err) {
+            const sqliteErr = err;
+            if (sqliteErr.code === 'SQLITE_BUSY' && i < maxRetries - 1) {
+                console.warn(`[warn] Database busy, retrying (${i + 1}/${maxRetries})...`);
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw new Error('Unreachable');
+}
+/**
+ * Check if better-sqlite3 is available and provide helpful error messages
+ */
+export function checkDatabaseAvailability() {
+    try {
+        require('better-sqlite3');
+    }
+    catch (err) {
+        const loadErr = err;
+        console.error('[error] better-sqlite3 failed to load. Native compilation may have failed.');
+        console.error('[error] Error:', loadErr.message);
+        console.error('[error] Try the following:');
+        console.error('[error]   1. npm rebuild better-sqlite3');
+        console.error('[error]   2. npm install better-sqlite3 --build-from-source');
+        console.error('[error]   3. Ensure build tools are installed (Xcode on macOS, build-essential on Linux)');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/agent-farm/db/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/agent-farm/db/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,EAAW,EAAE,UAAU,GAAG,CAAC;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,GAAkB,CAAC;YACrC,IAAI,SAAS,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,GAAG,CAAC,IAAI,UAAU,MAAM,CAAC,CAAC;gBAC3E,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,IAAI,CAAC;QACH,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAY,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC5F,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,KAAK,CAAC,0FAA0F,CAAC,CAAC;QAC1G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/agent-farm/db/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SQLite Database Module
+ *
+ * Provides singleton database access for both local state and global registry.
+ * Uses better-sqlite3 for synchronous operations with proper concurrency handling.
+ */
+import Database from 'better-sqlite3';
+/**
+ * Get the local database instance (state.db)
+ * Creates and initializes the database if it doesn't exist
+ */
+export declare function getDb(): Database.Database;
+/**
+ * Get the global database instance (global.db)
+ * Creates and initializes the database if it doesn't exist
+ */
+export declare function getGlobalDb(): Database.Database;
+/**
+ * Close the local database connection
+ */
+export declare function closeDb(): void;
+/**
+ * Close the global database connection
+ */
+export declare function closeGlobalDb(): void;
+/**
+ * Close all database connections
+ */
+export declare function closeAllDbs(): void;
+/**
+ * Get the path to the local database
+ */
+export declare function getDbPath(): string;
+/**
+ * Get the path to the global database
+ */
+export declare function getGlobalDbPath(): string;
+export { LOCAL_SCHEMA, GLOBAL_SCHEMA } from './schema.js';
+export { withRetry } from './errors.js';
+export type { DbArchitect, DbBuilder, DbUtil, DbAnnotation, DbPortAllocation, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-farm/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAyCtC;;;GAGG;AACH,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAKzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAK/C;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAuFD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/agent-farm/db/index.js

@@ -0,0 +1,168 @@
+/**
+ * SQLite Database Module
+ *
+ * Provides singleton database access for both local state and global registry.
+ * Uses better-sqlite3 for synchronous operations with proper concurrency handling.
+ */
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync, copyFileSync, unlinkSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { LOCAL_SCHEMA, GLOBAL_SCHEMA } from './schema.js';
+import { migrateLocalFromJson, migrateGlobalFromJson } from './migrate.js';
+import { getConfig } from '../utils/index.js';
+// Singleton instances
+let _localDb = null;
+let _globalDb = null;
+/**
+ * Ensure a directory exists
+ */
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Configure database pragmas for optimal concurrency and durability
+ */
+function configurePragmas(db) {
+    // Enable WAL mode for better concurrency (readers don't block writers)
+    const journalMode = db.pragma('journal_mode = WAL', { simple: true });
+    if (journalMode !== 'wal') {
+        console.warn('[warn] WAL mode unavailable, using DELETE mode (concurrency limited)');
+    }
+    // NORMAL synchronous mode balances safety and performance
+    db.pragma('synchronous = NORMAL');
+    // 5 second timeout when waiting for locks
+    db.pragma('busy_timeout = 5000');
+    // Enable foreign key constraints
+    db.pragma('foreign_keys = ON');
+}
+/**
+ * Get the local database instance (state.db)
+ * Creates and initializes the database if it doesn't exist
+ */
+export function getDb() {
+    if (!_localDb) {
+        _localDb = ensureLocalDatabase();
+    }
+    return _localDb;
+}
+/**
+ * Get the global database instance (global.db)
+ * Creates and initializes the database if it doesn't exist
+ */
+export function getGlobalDb() {
+    if (!_globalDb) {
+        _globalDb = ensureGlobalDatabase();
+    }
+    return _globalDb;
+}
+/**
+ * Close the local database connection
+ */
+export function closeDb() {
+    if (_localDb) {
+        _localDb.close();
+        _localDb = null;
+    }
+}
+/**
+ * Close the global database connection
+ */
+export function closeGlobalDb() {
+    if (_globalDb) {
+        _globalDb.close();
+        _globalDb = null;
+    }
+}
+/**
+ * Close all database connections
+ */
+export function closeAllDbs() {
+    closeDb();
+    closeGlobalDb();
+}
+/**
+ * Get the path to the local database
+ */
+export function getDbPath() {
+    const config = getConfig();
+    return resolve(config.stateDir, 'state.db');
+}
+/**
+ * Get the path to the global database
+ */
+export function getGlobalDbPath() {
+    return resolve(homedir(), '.agent-farm', 'global.db');
+}
+/**
+ * Initialize the local database (state.db)
+ */
+function ensureLocalDatabase() {
+    const config = getConfig();
+    const dbPath = resolve(config.stateDir, 'state.db');
+    const jsonPath = resolve(config.stateDir, 'state.json');
+    // Ensure directory exists
+    ensureDir(config.stateDir);
+    // Create/open database
+    const db = new Database(dbPath);
+    configurePragmas(db);
+    // Run schema (creates tables if they don't exist)
+    db.exec(LOCAL_SCHEMA);
+    // Check if migration is needed
+    const migrated = db.prepare('SELECT version FROM _migrations WHERE version = 1').get();
+    if (!migrated && existsSync(jsonPath)) {
+        // Migrate from JSON
+        migrateLocalFromJson(db, jsonPath);
+        // Record migration
+        db.prepare('INSERT INTO _migrations (version) VALUES (1)').run();
+        // Backup original JSON and remove it
+        copyFileSync(jsonPath, jsonPath + '.bak');
+        unlinkSync(jsonPath);
+        console.log('[info] Migrated state.json to state.db (backup at state.json.bak)');
+    }
+    else if (!migrated) {
+        // Fresh install, just mark migration as done
+        db.prepare('INSERT OR IGNORE INTO _migrations (version) VALUES (1)').run();
+        console.log('[info] Created new state.db at', dbPath);
+    }
+    return db;
+}
+/**
+ * Initialize the global database (global.db)
+ */
+function ensureGlobalDatabase() {
+    const globalDir = resolve(homedir(), '.agent-farm');
+    const dbPath = resolve(globalDir, 'global.db');
+    const jsonPath = resolve(globalDir, 'ports.json');
+    // Ensure directory exists
+    ensureDir(globalDir);
+    // Create/open database
+    const db = new Database(dbPath);
+    configurePragmas(db);
+    // Run schema (creates tables if they don't exist)
+    db.exec(GLOBAL_SCHEMA);
+    // Check if migration is needed
+    const migrated = db.prepare('SELECT version FROM _migrations WHERE version = 1').get();
+    if (!migrated && existsSync(jsonPath)) {
+        // Migrate from JSON
+        migrateGlobalFromJson(db, jsonPath);
+        // Record migration
+        db.prepare('INSERT INTO _migrations (version) VALUES (1)').run();
+        // Backup original JSON and remove it
+        copyFileSync(jsonPath, jsonPath + '.bak');
+        unlinkSync(jsonPath);
+        console.log('[info] Migrated ports.json to global.db (backup at ports.json.bak)');
+    }
+    else if (!migrated) {
+        // Fresh install, just mark migration as done
+        db.prepare('INSERT OR IGNORE INTO _migrations (version) VALUES (1)').run();
+        console.log('[info] Created new global.db at', dbPath);
+    }
+    return db;
+}
+// Re-export types and utilities
+export { LOCAL_SCHEMA, GLOBAL_SCHEMA } from './schema.js';
+export { withRetry } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/agent-farm/db/index.js.map

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

package/dist/agent-farm/db/migrate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Migration Functions
+ *
+ * Handles migration from JSON files to SQLite databases
+ */
+import type Database from 'better-sqlite3';
+/**
+ * Migrate local state from JSON to SQLite
+ */
+export declare function migrateLocalFromJson(db: Database.Database, jsonPath: string): void;
+/**
+ * Migrate global port registry from JSON to SQLite
+ */
+export declare function migrateGlobalFromJson(db: Database.Database, jsonPath: string): void;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/agent-farm/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAkB3C;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAoFlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CA4CnF"}

package/dist/agent-farm/db/migrate.js

@@ -0,0 +1,137 @@
+/**
+ * Migration Functions
+ *
+ * Handles migration from JSON files to SQLite databases
+ */
+import { readFileSync } from 'node:fs';
+/**
+ * Migrate local state from JSON to SQLite
+ */
+export function migrateLocalFromJson(db, jsonPath) {
+    const jsonContent = readFileSync(jsonPath, 'utf-8');
+    const state = JSON.parse(jsonContent);
+    // Wrap in transaction for atomicity
+    const migrate = db.transaction(() => {
+        // Migrate architect
+        if (state.architect) {
+            db.prepare(`
+        INSERT INTO architect (id, pid, port, cmd, started_at, tmux_session)
+        VALUES (1, @pid, @port, @cmd, @startedAt, @tmuxSession)
+      `).run({
+                pid: state.architect.pid,
+                port: state.architect.port,
+                cmd: state.architect.cmd,
+                startedAt: state.architect.startedAt,
+                tmuxSession: state.architect.tmuxSession ?? null,
+            });
+        }
+        // Migrate builders
+        for (const builder of state.builders || []) {
+            db.prepare(`
+        INSERT INTO builders (
+          id, name, port, pid, status, phase, worktree, branch,
+          tmux_session, type, task_text, protocol_name
+        )
+        VALUES (
+          @id, @name, @port, @pid, @status, @phase, @worktree, @branch,
+          @tmuxSession, @type, @taskText, @protocolName
+        )
+      `).run({
+                id: builder.id,
+                name: builder.name,
+                port: builder.port,
+                pid: builder.pid,
+                status: builder.status,
+                phase: builder.phase,
+                worktree: builder.worktree,
+                branch: builder.branch,
+                tmuxSession: builder.tmuxSession ?? null,
+                type: builder.type,
+                taskText: builder.taskText ?? null,
+                protocolName: builder.protocolName ?? null,
+            });
+        }
+        // Migrate utils
+        for (const util of state.utils || []) {
+            db.prepare(`
+        INSERT INTO utils (id, name, port, pid, tmux_session)
+        VALUES (@id, @name, @port, @pid, @tmuxSession)
+      `).run({
+                id: util.id,
+                name: util.name,
+                port: util.port,
+                pid: util.pid,
+                tmuxSession: util.tmuxSession ?? null,
+            });
+        }
+        // Migrate annotations
+        for (const annotation of state.annotations || []) {
+            db.prepare(`
+        INSERT INTO annotations (id, file, port, pid, parent_type, parent_id)
+        VALUES (@id, @file, @port, @pid, @parentType, @parentId)
+      `).run({
+                id: annotation.id,
+                file: annotation.file,
+                port: annotation.port,
+                pid: annotation.pid,
+                parentType: annotation.parent.type,
+                parentId: annotation.parent.id ?? null,
+            });
+        }
+    });
+    try {
+        migrate();
+    }
+    catch (err) {
+        console.error('[error] Migration failed. JSON file preserved.');
+        console.error('[error] Manual recovery: delete state.db and restart');
+        throw err;
+    }
+}
+/**
+ * Migrate global port registry from JSON to SQLite
+ */
+export function migrateGlobalFromJson(db, jsonPath) {
+    const jsonContent = readFileSync(jsonPath, 'utf-8');
+    const data = JSON.parse(jsonContent);
+    // Handle both formats: versioned ({ version, entries }) and legacy (direct entries)
+    let entries;
+    if (data.version && data.entries) {
+        // New versioned format
+        entries = data.entries;
+    }
+    else {
+        // Legacy format - the object itself is the entries
+        // Filter out any non-entry fields
+        entries = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (typeof value === 'object' && value !== null && 'basePort' in value) {
+                entries[key] = value;
+            }
+        }
+    }
+    // Wrap in transaction for atomicity
+    const migrate = db.transaction(() => {
+        for (const [projectPath, entry] of Object.entries(entries)) {
+            db.prepare(`
+        INSERT INTO port_allocations (project_path, base_port, pid, registered_at, last_used_at)
+        VALUES (@projectPath, @basePort, @pid, @registeredAt, @lastUsedAt)
+      `).run({
+                projectPath,
+                basePort: entry.basePort,
+                pid: entry.pid ?? null,
+                registeredAt: entry.registered,
+                lastUsedAt: entry.lastUsed ?? entry.registered,
+            });
+        }
+    });
+    try {
+        migrate();
+    }
+    catch (err) {
+        console.error('[error] Port registry migration failed. JSON file preserved.');
+        console.error('[error] Manual recovery: delete global.db and restart');
+        throw err;
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/agent-farm/db/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/agent-farm/db/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAiBvC;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAqB,EAAE,QAAgB;IAC1E,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,KAAK,GAAmB,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEtD,oCAAoC;IACpC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAClC,oBAAoB;QACpB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,EAAE,CAAC,OAAO,CAAC;;;OAGV,CAAC,CAAC,GAAG,CAAC;gBACL,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG;gBACxB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI;gBAC1B,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG;gBACxB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS;gBACpC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,IAAI,IAAI;aACjD,CAAC,CAAC;QACL,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC3C,EAAE,CAAC,OAAO,CAAC;;;;;;;;;OASV,CAAC,CAAC,GAAG,CAAC;gBACL,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;gBACxC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;aAC3C,CAAC,CAAC;QACL,CAAC;QAED,gBAAgB;QAChB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACrC,EAAE,CAAC,OAAO,CAAC;;;OAGV,CAAC,CAAC,GAAG,CAAC;gBACL,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;aACtC,CAAC,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YACjD,EAAE,CAAC,OAAO,CAAC;;;OAGV,CAAC,CAAC,GAAG,CAAC;gBACL,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,GAAG,EAAE,UAAU,CAAC,GAAG;gBACnB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI;gBAClC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAqB,EAAE,QAAgB;IAC3E,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,IAAI,GAAuB,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEzD,oFAAoF;IACpF,IAAI,OAAwC,CAAC;IAE7C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,uBAAuB;QACvB,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,mDAAmD;QACnD,kCAAkC;QAClC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;gBACvE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAwB,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAClC,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,EAAE,CAAC,OAAO,CAAC;;;OAGV,CAAC,CAAC,GAAG,CAAC;gBACL,WAAW;gBACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,IAAI;gBACtB,YAAY,EAAE,KAAK,CAAC,UAAU;gBAC9B,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,UAAU;aAC/C,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/agent-farm/db/schema.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SQLite Schema Definitions
+ *
+ * Defines the schema for both local state (state.db) and global registry (global.db)
+ */
+/**
+ * Local state schema (state.db)
+ * Stores dashboard state: architect, builders, utils, annotations
+ */
+export declare const LOCAL_SCHEMA = "\n-- Schema versioning\nCREATE TABLE IF NOT EXISTS _migrations (\n  version INTEGER PRIMARY KEY,\n  applied_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Architect session (singleton)\nCREATE TABLE IF NOT EXISTS architect (\n  id INTEGER PRIMARY KEY CHECK (id = 1),\n  pid INTEGER NOT NULL,\n  port INTEGER NOT NULL,\n  cmd TEXT NOT NULL,\n  started_at TEXT NOT NULL DEFAULT (datetime('now')),\n  tmux_session TEXT\n);\n\n-- Builder sessions\nCREATE TABLE IF NOT EXISTS builders (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  port INTEGER NOT NULL UNIQUE,\n  pid INTEGER NOT NULL,\n  status TEXT NOT NULL DEFAULT 'spawning'\n    CHECK(status IN ('spawning', 'implementing', 'blocked', 'pr-ready', 'complete')),\n  phase TEXT NOT NULL DEFAULT '',\n  worktree TEXT NOT NULL,\n  branch TEXT NOT NULL,\n  tmux_session TEXT,\n  type TEXT NOT NULL DEFAULT 'spec'\n    CHECK(type IN ('spec', 'task', 'protocol', 'shell', 'worktree')),\n  task_text TEXT,\n  protocol_name TEXT,\n  started_at TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes for common queries\nCREATE INDEX IF NOT EXISTS idx_builders_status ON builders(status);\nCREATE INDEX IF NOT EXISTS idx_builders_port ON builders(port);\n\n-- Utility terminals\nCREATE TABLE IF NOT EXISTS utils (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  port INTEGER NOT NULL UNIQUE,\n  pid INTEGER NOT NULL,\n  tmux_session TEXT,\n  started_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Annotations (file viewers)\nCREATE TABLE IF NOT EXISTS annotations (\n  id TEXT PRIMARY KEY,\n  file TEXT NOT NULL,\n  port INTEGER NOT NULL UNIQUE,\n  pid INTEGER NOT NULL,\n  parent_type TEXT NOT NULL CHECK(parent_type IN ('architect', 'builder', 'util')),\n  parent_id TEXT,\n  started_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Trigger to update updated_at on builders\nCREATE TRIGGER IF NOT EXISTS builders_updated_at\n  AFTER UPDATE ON builders\n  FOR EACH ROW\n  BEGIN\n    UPDATE builders SET updated_at = datetime('now') WHERE id = NEW.id;\n  END;\n";
+/**
+ * Global registry schema (global.db)
+ * Stores port allocations across all projects
+ */
+export declare const GLOBAL_SCHEMA = "\n-- Schema versioning\nCREATE TABLE IF NOT EXISTS _migrations (\n  version INTEGER PRIMARY KEY,\n  applied_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Port allocations\nCREATE TABLE IF NOT EXISTS port_allocations (\n  project_path TEXT PRIMARY KEY,\n  base_port INTEGER NOT NULL UNIQUE\n    CHECK(base_port >= 4200 AND base_port % 100 = 0),\n  pid INTEGER,\n  registered_at TEXT NOT NULL DEFAULT (datetime('now')),\n  last_used_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_port_allocations_base_port ON port_allocations(base_port);\n";
+//# sourceMappingURL=schema.d.ts.map

package/dist/agent-farm/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/db/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,siEAqExB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,wkBAkBzB,CAAC"}