@cluesmith/codev 1.1.0

package/dist/agent-farm/utils/orphan-handler.js

@@ -0,0 +1,127 @@
+/**
+ * Orphan Handler
+ *
+ * Detects and handles orphaned tmux sessions from previous agent-farm runs.
+ * This prevents resource leaks and ensures clean startup.
+ *
+ * IMPORTANT: Only cleans up sessions for THIS project (based on port).
+ * Sessions from other projects are left alone.
+ */
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { logger } from './logger.js';
+import { run } from './shell.js';
+import { getConfig } from './config.js';
+/**
+ * Find tmux sessions that match THIS project's agent-farm patterns
+ * Only matches sessions with this project's port to avoid killing other projects
+ */
+async function findOrphanedSessions() {
+    const config = getConfig();
+    const architectPort = config.architectPort;
+    // Project-specific patterns - only match THIS project's sessions
+    const projectPatterns = [
+        new RegExp(`^af-architect-${architectPort}$`), // Only this project's architect
+        /^builder-\d+$/, // Builder sessions (already unique per spec)
+        /^util-[A-Z0-9]+$/, // Util sessions (already unique)
+        /^af-architect$/, // Legacy pattern (no port) - safe to clean
+    ];
+    try {
+        const result = await run('tmux list-sessions -F "#{session_name}" 2>/dev/null');
+        const sessions = result.stdout.trim().split('\n').filter(Boolean);
+        const orphans = [];
+        for (const name of sessions) {
+            if (projectPatterns[0].test(name) || projectPatterns[3].test(name)) {
+                orphans.push({ name, type: 'architect' });
+            }
+            else if (projectPatterns[1].test(name)) {
+                orphans.push({ name, type: 'builder' });
+            }
+            else if (projectPatterns[2].test(name)) {
+                orphans.push({ name, type: 'util' });
+            }
+        }
+        return orphans;
+    }
+    catch {
+        // tmux not available or no sessions
+        return [];
+    }
+}
+/**
+ * Kill an orphaned tmux session
+ */
+async function killSession(name) {
+    try {
+        await run(`tmux kill-session -t "${name}" 2>/dev/null`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check for and handle orphaned sessions on startup
+ *
+ * Returns the number of sessions that were cleaned up.
+ */
+export async function handleOrphanedSessions(options = {}) {
+    const orphans = await findOrphanedSessions();
+    if (orphans.length === 0) {
+        return 0;
+    }
+    if (!options.silent) {
+        logger.warn(`Found ${orphans.length} orphaned tmux session(s) from previous run:`);
+        for (const orphan of orphans) {
+            logger.info(`  - ${orphan.name} (${orphan.type})`);
+        }
+    }
+    if (options.kill) {
+        let killed = 0;
+        for (const orphan of orphans) {
+            if (await killSession(orphan.name)) {
+                killed++;
+                if (!options.silent) {
+                    logger.debug(`  Killed: ${orphan.name}`);
+                }
+            }
+        }
+        if (!options.silent) {
+            logger.info(`Cleaned up ${killed} orphaned session(s)`);
+        }
+        return killed;
+    }
+    return 0;
+}
+/**
+ * Check for stale artifacts from bash script era
+ */
+export function checkStaleArtifacts(codevDir) {
+    const staleFiles = [
+        'builders.md', // Old bash state file
+        '.architect.pid',
+        '.architect.log',
+    ];
+    const found = [];
+    for (const file of staleFiles) {
+        const path = resolve(codevDir, file);
+        if (existsSync(path)) {
+            found.push(file);
+        }
+    }
+    return found;
+}
+/**
+ * Warn about stale artifacts if found
+ */
+export function warnAboutStaleArtifacts(codevDir) {
+    const stale = checkStaleArtifacts(codevDir);
+    if (stale.length > 0) {
+        logger.warn('Found stale artifacts from previous bash-based architect:');
+        for (const file of stale) {
+            logger.info(`  - ${file}`);
+        }
+        logger.info('These can be safely deleted. The new TypeScript implementation uses .agent-farm/');
+    }
+}
+//# sourceMappingURL=orphan-handler.js.map

package/dist/agent-farm/utils/orphan-handler.js.map

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

package/dist/agent-farm/utils/port-registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Global Port Registry
+ *
+ * Manages port block allocation across multiple repositories to prevent
+ * port conflicts when running multiple architect sessions simultaneously.
+ *
+ * Registry location: ~/.agent-farm/global.db
+ * Each repository gets a 100-port block (e.g., 4200-4299, 4300-4399, etc.)
+ *
+ * Uses SQLite with ACID transactions for proper concurrency handling.
+ */
+import { closeGlobalDb } from '../db/index.js';
+/**
+ * Clean up stale registry entries (projects that no longer exist or have dead PIDs)
+ * Note: This function is now synchronous
+ */
+export declare function cleanupStaleEntries(): {
+    removed: string[];
+    remaining: number;
+};
+/**
+ * Get or allocate a port block for a project
+ * Returns the base port for the project's block
+ * Note: This function is now synchronous and uses BEGIN IMMEDIATE for atomicity
+ */
+export declare function getPortBlock(projectRoot: string): number;
+/**
+ * Get port configuration for a project
+ * Returns all port assignments based on the project's base port
+ */
+export interface ProjectPorts {
+    basePort: number;
+    dashboardPort: number;
+    architectPort: number;
+    builderPortRange: [number, number];
+    utilPortRange: [number, number];
+    annotatePortRange: [number, number];
+}
+export declare function getProjectPorts(projectRoot: string): ProjectPorts;
+/**
+ * List all registered projects and their port blocks
+ */
+export declare function listAllocations(): Array<{
+    path: string;
+    basePort: number;
+    registered: string;
+    lastUsed?: string;
+    exists: boolean;
+    pid?: number;
+    pidAlive?: boolean;
+}>;
+/**
+ * Remove a project's port allocation
+ * Note: This function is now synchronous
+ */
+export declare function removeAllocation(projectRoot: string): boolean;
+export { closeGlobalDb };
+//# sourceMappingURL=port-registry.d.ts.map

package/dist/agent-farm/utils/port-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-registry.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/utils/port-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAe,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA6B5D;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgC9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA2CxD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAWjE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAaD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO7D;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/agent-farm/utils/port-registry.js

@@ -0,0 +1,149 @@
+/**
+ * Global Port Registry
+ *
+ * Manages port block allocation across multiple repositories to prevent
+ * port conflicts when running multiple architect sessions simultaneously.
+ *
+ * Registry location: ~/.agent-farm/global.db
+ * Each repository gets a 100-port block (e.g., 4200-4299, 4300-4399, etc.)
+ *
+ * Uses SQLite with ACID transactions for proper concurrency handling.
+ */
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { getGlobalDb, closeGlobalDb } from '../db/index.js';
+// Base port for first allocation
+const BASE_PORT = 4200;
+// Ports per project
+const PORT_BLOCK_SIZE = 100;
+// Maximum allocations (4200-9999 = ~58 projects)
+const MAX_ALLOCATIONS = 58;
+/**
+ * Check if a process is still running
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a project path still exists on disk
+ */
+function projectExists(projectPath) {
+    return existsSync(projectPath);
+}
+/**
+ * Clean up stale registry entries (projects that no longer exist or have dead PIDs)
+ * Note: This function is now synchronous
+ */
+export function cleanupStaleEntries() {
+    const db = getGlobalDb();
+    const removed = [];
+    // Get all allocations
+    const allocations = db.prepare('SELECT * FROM port_allocations').all();
+    const cleanup = db.transaction(() => {
+        for (const alloc of allocations) {
+            // Remove if project doesn't exist
+            if (!projectExists(alloc.project_path)) {
+                removed.push(alloc.project_path);
+                db.prepare('DELETE FROM port_allocations WHERE project_path = ?').run(alloc.project_path);
+                continue;
+            }
+            // Clear PID if process is stale (process no longer running)
+            // Don't remove the entry, just clear the PID - project still exists
+            if (alloc.pid && !isProcessAlive(alloc.pid)) {
+                db.prepare('UPDATE port_allocations SET pid = NULL WHERE project_path = ?').run(alloc.project_path);
+            }
+        }
+    });
+    cleanup();
+    const remaining = db.prepare('SELECT COUNT(*) as count FROM port_allocations').get();
+    return {
+        removed,
+        remaining: remaining.count,
+    };
+}
+/**
+ * Get or allocate a port block for a project
+ * Returns the base port for the project's block
+ * Note: This function is now synchronous and uses BEGIN IMMEDIATE for atomicity
+ */
+export function getPortBlock(projectRoot) {
+    // Normalize path for consistent keys
+    const normalizedPath = resolve(projectRoot);
+    const db = getGlobalDb();
+    // Use immediate transaction to prevent race conditions
+    const allocate = db.transaction(() => {
+        // Check if project already has an allocation
+        const existing = db.prepare('SELECT * FROM port_allocations WHERE project_path = ?')
+            .get(normalizedPath);
+        if (existing) {
+            // Update last used timestamp and PID
+            db.prepare(`
+        UPDATE port_allocations
+        SET last_used_at = datetime('now'), pid = ?
+        WHERE project_path = ?
+      `).run(process.pid, normalizedPath);
+            return existing.base_port;
+        }
+        // Find next available port block
+        const maxPort = db.prepare('SELECT MAX(base_port) as max FROM port_allocations').get();
+        let nextPort = (maxPort.max ?? (BASE_PORT - PORT_BLOCK_SIZE)) + PORT_BLOCK_SIZE;
+        // Ensure we don't exceed max allocations
+        if (nextPort >= BASE_PORT + (MAX_ALLOCATIONS * PORT_BLOCK_SIZE)) {
+            throw new Error('No available port blocks. Maximum allocations reached.');
+        }
+        // Insert new allocation
+        db.prepare(`
+      INSERT INTO port_allocations (project_path, base_port, pid)
+      VALUES (?, ?, ?)
+    `).run(normalizedPath, nextPort, process.pid);
+        return nextPort;
+    });
+    // Use immediate() to serialize with other writers
+    return allocate.immediate();
+}
+export function getProjectPorts(projectRoot) {
+    const basePort = getPortBlock(projectRoot);
+    return {
+        basePort,
+        dashboardPort: basePort, // 4200
+        architectPort: basePort + 1, // 4201
+        builderPortRange: [basePort + 10, basePort + 29], // 4210-4229
+        utilPortRange: [basePort + 30, basePort + 49], // 4230-4249
+        annotatePortRange: [basePort + 50, basePort + 69], // 4250-4269
+    };
+}
+/**
+ * List all registered projects and their port blocks
+ */
+export function listAllocations() {
+    const db = getGlobalDb();
+    const allocations = db.prepare('SELECT * FROM port_allocations ORDER BY base_port').all();
+    return allocations.map((alloc) => ({
+        path: alloc.project_path,
+        basePort: alloc.base_port,
+        registered: alloc.registered_at,
+        lastUsed: alloc.last_used_at,
+        exists: projectExists(alloc.project_path),
+        pid: alloc.pid ?? undefined,
+        pidAlive: alloc.pid ? isProcessAlive(alloc.pid) : undefined,
+    }));
+}
+/**
+ * Remove a project's port allocation
+ * Note: This function is now synchronous
+ */
+export function removeAllocation(projectRoot) {
+    const normalizedPath = resolve(projectRoot);
+    const db = getGlobalDb();
+    const result = db.prepare('DELETE FROM port_allocations WHERE project_path = ?').run(normalizedPath);
+    return result.changes > 0;
+}
+// Re-export closeGlobalDb for cleanup
+export { closeGlobalDb };
+//# sourceMappingURL=port-registry.js.map

package/dist/agent-farm/utils/port-registry.js.map

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

package/dist/agent-farm/utils/shell.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shell command utilities for Agent Farm
+ */
+import { type ChildProcess } from 'node:child_process';
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Execute a shell command and return output
+ */
+export declare function run(command: string, options?: {
+    cwd?: string;
+    silent?: boolean;
+}): Promise<ExecResult>;
+/**
+ * Spawn a detached process that continues after parent exits
+ */
+export declare function spawnDetached(command: string, args: string[], options?: {
+    cwd?: string;
+    logFile?: string;
+}): ChildProcess;
+/**
+ * Check if a command exists
+ * Uses spawn to avoid shell injection
+ */
+export declare function commandExists(command: string): Promise<boolean>;
+/**
+ * Find an available port starting from the given port
+ * Uses native Node socket binding instead of lsof for cross-platform support
+ */
+export declare function findAvailablePort(startPort: number): Promise<number>;
+/**
+ * Check if a process is running
+ */
+export declare function isProcessRunning(pid: number): Promise<boolean>;
+/**
+ * Kill a process tree
+ */
+export declare function killProcess(pid: number): Promise<void>;
+/**
+ * Open a URL in the default browser
+ */
+export declare function openBrowser(url: string): Promise<void>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/agent-farm/utils/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/utils/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKpE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,GAAG,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,YAAY,CASd;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB1E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5D"}

package/dist/agent-farm/utils/shell.js

@@ -0,0 +1,120 @@
+/**
+ * Shell command utilities for Agent Farm
+ */
+import { exec, spawn } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+/**
+ * Execute a shell command and return output
+ */
+export async function run(command, options = {}) {
+    try {
+        const result = await execAsync(command, {
+            cwd: options.cwd,
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+        });
+        return {
+            stdout: result.stdout.trim(),
+            stderr: result.stderr.trim(),
+        };
+    }
+    catch (error) {
+        const execError = error;
+        throw new Error(`Command failed: ${command}\n${execError.stderr || execError.message}`);
+    }
+}
+/**
+ * Spawn a detached process that continues after parent exits
+ */
+export function spawnDetached(command, args, options = {}) {
+    const child = spawn(command, args, {
+        cwd: options.cwd,
+        detached: true,
+        stdio: options.logFile ? ['ignore', 'pipe', 'pipe'] : 'ignore',
+    });
+    child.unref();
+    return child;
+}
+/**
+ * Check if a command exists
+ * Uses spawn to avoid shell injection
+ */
+export async function commandExists(command) {
+    // Sanitize: only allow alphanumeric, dash, underscore
+    const sanitized = command.replace(/[^a-zA-Z0-9_-]/g, '');
+    if (sanitized !== command) {
+        return false; // Command name contains invalid characters
+    }
+    return new Promise((resolve) => {
+        const child = spawn('which', [command], { stdio: 'ignore' });
+        child.on('close', (code) => resolve(code === 0));
+        child.on('error', () => resolve(false));
+    });
+}
+/**
+ * Find an available port starting from the given port
+ * Uses native Node socket binding instead of lsof for cross-platform support
+ */
+export async function findAvailablePort(startPort) {
+    const net = await import('node:net');
+    const isPortAvailable = (port) => {
+        return new Promise((resolve) => {
+            const server = net.createServer();
+            server.once('error', () => resolve(false));
+            server.once('listening', () => {
+                server.close(() => resolve(true));
+            });
+            server.listen(port, '127.0.0.1');
+        });
+    };
+    let port = startPort;
+    while (port < startPort + 100) {
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+        port++;
+    }
+    throw new Error(`No available port found starting from ${startPort}`);
+}
+/**
+ * Check if a process is running
+ */
+export async function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Kill a process tree
+ */
+export async function killProcess(pid) {
+    const treeKill = (await import('tree-kill')).default;
+    return new Promise((resolve, reject) => {
+        treeKill(pid, 'SIGTERM', (err) => {
+            if (err) {
+                // Try SIGKILL if SIGTERM fails
+                treeKill(pid, 'SIGKILL', (err2) => {
+                    if (err2)
+                        reject(err2);
+                    else
+                        resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+/**
+ * Open a URL in the default browser
+ */
+export async function openBrowser(url) {
+    const open = (await import('open')).default;
+    await open(url);
+}
+//# sourceMappingURL=shell.js.map

package/dist/agent-farm/utils/shell.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Codev CLI - Unified entry point for codev framework
+ */
+/**
+ * Run the CLI with given arguments
+ * Used by bin shims (af.js, consult.js) to inject commands
+ */
+export declare function run(args: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG;AA+HH;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvD"}