@proletariat/cli 0.2.0 → 0.3.0

package/dist/lib/execution/storage.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Execution Storage
+ *
+ * Database operations for agent_work table.
+ */
+import Database from 'better-sqlite3';
+import { AgentWork, ExecutionStatus, ExecutorType, ExecutionEnvironment, DisplayMode } from './types.js';
+export declare class ExecutionStorage {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Create a new execution record
+     */
+    createExecution(params: {
+        ticketId: string;
+        agentName: string;
+        executor: ExecutorType;
+        environment: ExecutionEnvironment;
+        displayMode: DisplayMode;
+        sandboxed: boolean;
+        branch?: string;
+        pid?: string;
+        containerId?: string;
+        sessionId?: string;
+        host?: string;
+        logPath?: string;
+    }): AgentWork;
+    /**
+     * Get execution by ID
+     */
+    getExecution(id: string): AgentWork | null;
+    /**
+     * Update execution status
+     */
+    updateStatus(id: string, status: ExecutionStatus, exitCode?: number): void;
+    /**
+     * Update execution with process info
+     */
+    updateProcessInfo(id: string, info: {
+        pid?: string;
+        containerId?: string;
+        sessionId?: string;
+        host?: string;
+        logPath?: string;
+    }): void;
+    /**
+     * List executions with optional filters
+     */
+    listExecutions(filter?: {
+        status?: ExecutionStatus;
+        agentName?: string;
+        ticketId?: string;
+        limit?: number;
+    }): AgentWork[];
+    /**
+     * Get running execution for a ticket (if any)
+     */
+    getRunningExecution(ticketId: string): AgentWork | null;
+    /**
+     * Get all running executions for an agent
+     */
+    getAgentRunningExecutions(agentName: string): AgentWork[];
+    /**
+     * Check if agent is available (not running anything)
+     */
+    isAgentAvailable(agentName: string): boolean;
+    /**
+     * Get total execution count for an agent (historical)
+     * Used by least-busy agent selection strategy.
+     */
+    getAgentExecutionCount(agentName: string): number;
+    /**
+     * Delete execution record
+     */
+    deleteExecution(id: string): void;
+}
+export type ContainerStatus = 'running' | 'exited' | 'paused' | 'unknown' | 'removed';
+export interface Container {
+    id: string;
+    agentName: string;
+    dockerId: string;
+    dockerName: string | null;
+    image: string | null;
+    status: ContainerStatus;
+    currentExecutionId: string | null;
+    createdAt: Date;
+    lastSeenAt: Date;
+}
+export declare class ContainerStorage {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Ensure containers table exists (for existing databases)
+     */
+    private ensureTable;
+    /**
+     * Upsert a container record (create or update by docker_id)
+     */
+    upsertContainer(params: {
+        agentName: string;
+        dockerId: string;
+        dockerName?: string;
+        image?: string;
+        status?: ContainerStatus;
+        currentExecutionId?: string;
+    }): Container;
+    /**
+     * Get container by ID
+     */
+    getContainer(id: string): Container | null;
+    /**
+     * Get container by Docker ID (full or short)
+     */
+    getContainerByDockerId(dockerId: string): Container | null;
+    /**
+     * Get container for an agent (most recent)
+     */
+    getContainerForAgent(agentName: string): Container | null;
+    /**
+     * List all containers
+     */
+    listContainers(filter?: {
+        agentName?: string;
+        status?: ContainerStatus;
+        limit?: number;
+    }): Container[];
+    /**
+     * Update container status
+     */
+    updateStatus(dockerId: string, status: ContainerStatus): void;
+    /**
+     * Update container's current execution
+     */
+    setCurrentExecution(dockerId: string, executionId: string | null): void;
+    /**
+     * Mark container as removed
+     */
+    markRemoved(dockerId: string): void;
+    /**
+     * Delete container record
+     */
+    deleteContainer(id: string): void;
+    /**
+     * Sync container status from Docker
+     * Updates status for all known containers based on Docker state
+     * Wrapped in a transaction for consistency
+     */
+    syncFromDocker(dockerContainers: Array<{
+        id: string;
+        name: string;
+        image: string;
+        status: string;
+        agentName: string;
+    }>): {
+        added: number;
+        updated: number;
+        removed: number;
+    };
+}

package/dist/lib/execution/storage.js

@@ -0,0 +1,425 @@
+/**
+ * Execution Storage
+ *
+ * Database operations for agent_work table.
+ */
+import { PMO_TABLES } from '../pmo/schema.js';
+const T = PMO_TABLES;
+// =============================================================================
+// Type Conversion
+// =============================================================================
+function rowToAgentWork(row) {
+    return {
+        id: row.id,
+        ticketId: row.ticket_id,
+        agentName: row.agent_name,
+        executor: row.executor,
+        environment: (row.environment || 'host'),
+        displayMode: (row.display_mode || 'terminal'),
+        sandboxed: row.sandboxed === 1,
+        status: row.status,
+        branch: row.branch || undefined,
+        pid: row.pid || undefined,
+        containerId: row.container_id || undefined,
+        sessionId: row.session_id || undefined,
+        host: row.host || undefined,
+        logPath: row.log_path || undefined,
+        startedAt: new Date(row.started_at),
+        completedAt: row.completed_at ? new Date(row.completed_at) : undefined,
+        exitCode: row.exit_code ?? undefined,
+    };
+}
+// =============================================================================
+// ID Generation
+// =============================================================================
+function generateWorkId(db) {
+    const result = db
+        .prepare(`SELECT COUNT(*) as count FROM ${T.agent_work}`)
+        .get();
+    const num = (result?.count || 0) + 1;
+    return `WORK-${String(num).padStart(3, '0')}`;
+}
+// =============================================================================
+// Execution Storage Class
+// =============================================================================
+export class ExecutionStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a new execution record
+     */
+    createExecution(params) {
+        const id = generateWorkId(this.db);
+        const now = Date.now();
+        this.db.prepare(`
+      INSERT INTO ${T.agent_work} (
+        id, ticket_id, agent_name, executor, environment, display_mode, sandboxed,
+        status, branch, pid, container_id, session_id, host, log_path, started_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, 'starting', ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, params.ticketId, params.agentName, params.executor, params.environment, params.displayMode, params.sandboxed ? 1 : 0, params.branch || null, params.pid || null, params.containerId || null, params.sessionId || null, params.host || null, params.logPath || null, now);
+        return this.getExecution(id);
+    }
+    /**
+     * Get execution by ID
+     */
+    getExecution(id) {
+        const row = this.db
+            .prepare(`SELECT * FROM ${T.agent_work} WHERE id = ?`)
+            .get(id);
+        return row ? rowToAgentWork(row) : null;
+    }
+    /**
+     * Update execution status
+     */
+    updateStatus(id, status, exitCode) {
+        const completedAt = ['completed', 'failed', 'stopped'].includes(status) ? Date.now() : null;
+        if (exitCode !== undefined) {
+            this.db.prepare(`
+        UPDATE ${T.agent_work}
+        SET status = ?, completed_at = ?, exit_code = ?
+        WHERE id = ?
+      `).run(status, completedAt, exitCode, id);
+        }
+        else {
+            this.db.prepare(`
+        UPDATE ${T.agent_work}
+        SET status = ?, completed_at = ?
+        WHERE id = ?
+      `).run(status, completedAt, id);
+        }
+    }
+    /**
+     * Update execution with process info
+     */
+    updateProcessInfo(id, info) {
+        const updates = [];
+        const params = [];
+        if (info.pid !== undefined) {
+            updates.push('pid = ?');
+            params.push(info.pid);
+        }
+        if (info.containerId !== undefined) {
+            updates.push('container_id = ?');
+            params.push(info.containerId);
+        }
+        if (info.sessionId !== undefined) {
+            updates.push('session_id = ?');
+            params.push(info.sessionId);
+        }
+        if (info.host !== undefined) {
+            updates.push('host = ?');
+            params.push(info.host);
+        }
+        if (info.logPath !== undefined) {
+            updates.push('log_path = ?');
+            params.push(info.logPath);
+        }
+        if (updates.length > 0) {
+            params.push(id);
+            this.db.prepare(`
+        UPDATE ${T.agent_work}
+        SET ${updates.join(', ')}
+        WHERE id = ?
+      `).run(...params);
+        }
+    }
+    /**
+     * List executions with optional filters
+     */
+    listExecutions(filter) {
+        let query = `SELECT * FROM ${T.agent_work} WHERE 1=1`;
+        const params = [];
+        if (filter?.status) {
+            query += ` AND status = ?`;
+            params.push(filter.status);
+        }
+        if (filter?.agentName) {
+            query += ` AND agent_name = ?`;
+            params.push(filter.agentName);
+        }
+        if (filter?.ticketId) {
+            query += ` AND ticket_id = ?`;
+            params.push(filter.ticketId);
+        }
+        query += ` ORDER BY started_at DESC`;
+        if (filter?.limit) {
+            query += ` LIMIT ?`;
+            params.push(filter.limit);
+        }
+        const rows = this.db.prepare(query).all(...params);
+        return rows.map(rowToAgentWork);
+    }
+    /**
+     * Get running execution for a ticket (if any)
+     */
+    getRunningExecution(ticketId) {
+        const row = this.db
+            .prepare(`
+        SELECT * FROM ${T.agent_work}
+        WHERE ticket_id = ? AND status IN ('starting', 'running')
+        ORDER BY started_at DESC
+        LIMIT 1
+      `)
+            .get(ticketId);
+        return row ? rowToAgentWork(row) : null;
+    }
+    /**
+     * Get all running executions for an agent
+     */
+    getAgentRunningExecutions(agentName) {
+        const rows = this.db
+            .prepare(`
+        SELECT * FROM ${T.agent_work}
+        WHERE agent_name = ? AND status IN ('starting', 'running')
+        ORDER BY started_at DESC
+      `)
+            .all(agentName);
+        return rows.map(rowToAgentWork);
+    }
+    /**
+     * Check if agent is available (not running anything)
+     */
+    isAgentAvailable(agentName) {
+        const count = this.db
+            .prepare(`
+        SELECT COUNT(*) as count FROM ${T.agent_work}
+        WHERE agent_name = ? AND status IN ('starting', 'running')
+      `)
+            .get(agentName);
+        return count.count === 0;
+    }
+    /**
+     * Get total execution count for an agent (historical)
+     * Used by least-busy agent selection strategy.
+     */
+    getAgentExecutionCount(agentName) {
+        const result = this.db
+            .prepare(`
+        SELECT COUNT(*) as count FROM ${T.agent_work}
+        WHERE agent_name = ?
+      `)
+            .get(agentName);
+        return result?.count || 0;
+    }
+    /**
+     * Delete execution record
+     */
+    deleteExecution(id) {
+        this.db.prepare(`DELETE FROM ${T.agent_work} WHERE id = ?`).run(id);
+    }
+}
+function rowToContainer(row) {
+    return {
+        id: row.id,
+        agentName: row.agent_name,
+        dockerId: row.docker_id,
+        dockerName: row.docker_name,
+        image: row.image,
+        status: row.status,
+        currentExecutionId: row.current_execution_id,
+        createdAt: new Date(row.created_at),
+        lastSeenAt: new Date(row.last_seen_at),
+    };
+}
+// =============================================================================
+// Container Storage Class
+// =============================================================================
+export class ContainerStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+        this.ensureTable();
+    }
+    /**
+     * Ensure containers table exists (for existing databases)
+     */
+    ensureTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${T.containers} (
+        id TEXT PRIMARY KEY,
+        agent_name TEXT NOT NULL,
+        docker_id TEXT NOT NULL,
+        docker_name TEXT,
+        image TEXT,
+        status TEXT NOT NULL DEFAULT 'unknown',
+        current_execution_id TEXT,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        last_seen_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY (agent_name) REFERENCES agents(name) ON DELETE CASCADE,
+        FOREIGN KEY (current_execution_id) REFERENCES ${T.agent_work}(id) ON DELETE SET NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_containers_agent ON ${T.containers}(agent_name);
+      CREATE INDEX IF NOT EXISTS idx_containers_docker_id ON ${T.containers}(docker_id);
+      CREATE INDEX IF NOT EXISTS idx_containers_status ON ${T.containers}(status);
+    `);
+    }
+    /**
+     * Upsert a container record (create or update by docker_id)
+     */
+    upsertContainer(params) {
+        const now = Date.now();
+        // Check if container exists by docker_id
+        const existing = this.getContainerByDockerId(params.dockerId);
+        if (existing) {
+            // Update existing container
+            this.db.prepare(`
+        UPDATE ${T.containers}
+        SET agent_name = ?, docker_name = ?, image = ?, status = ?,
+            current_execution_id = ?, last_seen_at = ?
+        WHERE docker_id = ?
+      `).run(params.agentName, params.dockerName || existing.dockerName, params.image || existing.image, params.status || existing.status, params.currentExecutionId ?? existing.currentExecutionId, now, params.dockerId);
+            return this.getContainerByDockerId(params.dockerId);
+        }
+        else {
+            // Create new container
+            const id = `CNT-${params.dockerId.substring(0, 12)}`;
+            this.db.prepare(`
+        INSERT INTO ${T.containers} (
+          id, agent_name, docker_id, docker_name, image, status,
+          current_execution_id, created_at, last_seen_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(id, params.agentName, params.dockerId, params.dockerName || null, params.image || null, params.status || 'unknown', params.currentExecutionId || null, now, now);
+            return this.getContainer(id);
+        }
+    }
+    /**
+     * Get container by ID
+     */
+    getContainer(id) {
+        const row = this.db
+            .prepare(`SELECT * FROM ${T.containers} WHERE id = ?`)
+            .get(id);
+        return row ? rowToContainer(row) : null;
+    }
+    /**
+     * Get container by Docker ID (full or short)
+     */
+    getContainerByDockerId(dockerId) {
+        // Match by prefix (supports short IDs like 226eda1721d3)
+        const row = this.db
+            .prepare(`SELECT * FROM ${T.containers} WHERE docker_id LIKE ? || '%'`)
+            .get(dockerId);
+        return row ? rowToContainer(row) : null;
+    }
+    /**
+     * Get container for an agent (most recent)
+     */
+    getContainerForAgent(agentName) {
+        const row = this.db
+            .prepare(`
+        SELECT * FROM ${T.containers}
+        WHERE agent_name = ?
+        ORDER BY last_seen_at DESC
+        LIMIT 1
+      `)
+            .get(agentName);
+        return row ? rowToContainer(row) : null;
+    }
+    /**
+     * List all containers
+     */
+    listContainers(filter) {
+        let query = `SELECT * FROM ${T.containers} WHERE 1=1`;
+        const params = [];
+        if (filter?.agentName) {
+            query += ` AND agent_name = ?`;
+            params.push(filter.agentName);
+        }
+        if (filter?.status) {
+            query += ` AND status = ?`;
+            params.push(filter.status);
+        }
+        query += ` ORDER BY last_seen_at DESC`;
+        if (filter?.limit) {
+            query += ` LIMIT ?`;
+            params.push(filter.limit);
+        }
+        const rows = this.db.prepare(query).all(...params);
+        return rows.map(rowToContainer);
+    }
+    /**
+     * Update container status
+     */
+    updateStatus(dockerId, status) {
+        const now = Date.now();
+        this.db.prepare(`
+      UPDATE ${T.containers}
+      SET status = ?, last_seen_at = ?
+      WHERE docker_id LIKE ? || '%'
+    `).run(status, now, dockerId);
+    }
+    /**
+     * Update container's current execution
+     */
+    setCurrentExecution(dockerId, executionId) {
+        const now = Date.now();
+        this.db.prepare(`
+      UPDATE ${T.containers}
+      SET current_execution_id = ?, last_seen_at = ?
+      WHERE docker_id LIKE ? || '%'
+    `).run(executionId, now, dockerId);
+    }
+    /**
+     * Mark container as removed
+     */
+    markRemoved(dockerId) {
+        this.updateStatus(dockerId, 'removed');
+    }
+    /**
+     * Delete container record
+     */
+    deleteContainer(id) {
+        this.db.prepare(`DELETE FROM ${T.containers} WHERE id = ?`).run(id);
+    }
+    /**
+     * Sync container status from Docker
+     * Updates status for all known containers based on Docker state
+     * Wrapped in a transaction for consistency
+     */
+    syncFromDocker(dockerContainers) {
+        const now = Date.now();
+        let added = 0, updated = 0, removed = 0;
+        // Create a set of docker IDs currently running
+        const activeDockerIds = new Set(dockerContainers.map(c => c.id.substring(0, 12)));
+        // Wrap all operations in a transaction for atomicity
+        const syncTransaction = this.db.transaction(() => {
+            // Update or add containers from Docker
+            for (const dc of dockerContainers) {
+                const status = dc.status.startsWith('Up') ? 'running' :
+                    dc.status.includes('Paused') ? 'paused' : 'exited';
+                const existing = this.getContainerByDockerId(dc.id);
+                if (existing) {
+                    this.db.prepare(`
+            UPDATE ${T.containers}
+            SET docker_name = ?, image = ?, status = ?, last_seen_at = ?
+            WHERE docker_id LIKE ? || '%'
+          `).run(dc.name, dc.image, status, now, dc.id);
+                    updated++;
+                }
+                else {
+                    this.upsertContainer({
+                        agentName: dc.agentName,
+                        dockerId: dc.id,
+                        dockerName: dc.name,
+                        image: dc.image,
+                        status,
+                    });
+                    added++;
+                }
+            }
+            // Mark containers not in Docker as removed
+            const knownContainers = this.listContainers();
+            for (const container of knownContainers) {
+                if (!activeDockerIds.has(container.dockerId.substring(0, 12)) &&
+                    container.status !== 'removed') {
+                    this.markRemoved(container.dockerId);
+                    removed++;
+                }
+            }
+        });
+        syncTransaction();
+        return { added, updated, removed };
+    }
+}