@proletariat/cli 0.3.94 → 0.3.96

package/dist/lib/providers/trello-provider.js

@@ -0,0 +1,381 @@
+/**
+ * Trello Ticket Provider
+ *
+ * Writes ticket operations directly to Trello via API,
+ * then updates local PMO to keep it in sync.
+ *
+ * Follows the same pattern as LinearTicketProvider:
+ * Trello is the source of truth, PMO is best-effort mirror.
+ */
+import { TrelloClient } from '../trello/client.js';
+import { TrelloMapper } from '../trello/mapper.js';
+import { getTrelloApiKey, getTrelloApiToken, loadTrelloConfig } from '../trello/config.js';
+import { listTrelloCards } from '../external-issues/trello.js';
+export class TrelloTicketProvider {
+    db;
+    storage;
+    projectId;
+    ticketStatusCategory;
+    name = 'trello';
+    constructor(db, storage, projectId, ticketStatusCategory) {
+        this.db = db;
+        this.storage = storage;
+        this.projectId = projectId;
+        this.ticketStatusCategory = ticketStatusCategory;
+    }
+    getCredentialsOrFail() {
+        const apiKey = getTrelloApiKey(this.db);
+        if (!apiKey)
+            throw new Error('Trello API key not configured');
+        const apiToken = getTrelloApiToken(this.db);
+        if (!apiToken)
+            throw new Error('Trello API token not configured');
+        return { apiKey, apiToken };
+    }
+    async moveTicket(ticketId, newState) {
+        // 1. Get Trello credentials
+        let creds;
+        try {
+            creds = this.getCredentialsOrFail();
+        }
+        catch {
+            return { success: false, provider: 'trello', error: 'Trello credentials not configured' };
+        }
+        // 2. Look up Trello mapping for this PMO ticket
+        const mapper = new TrelloMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (!mapping) {
+            return { success: false, provider: 'trello', error: `No Trello mapping for ticket ${ticketId}` };
+        }
+        const client = new TrelloClient(creds.apiKey, creds.apiToken);
+        // 3. Get the card to find its board
+        const card = await client.getCard(mapping.trelloCardId);
+        if (!card) {
+            return { success: false, provider: 'trello', error: `Trello card ${mapping.trelloCardId} not found` };
+        }
+        // 4. Get board lists and find matching list for the target state
+        let lists;
+        try {
+            lists = await client.getBoardLists(card.idBoard);
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: `Failed to get board lists: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        const targetList = findMatchingTrelloList(lists, newState);
+        if (!targetList) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: `No matching Trello list for state "${newState}". Available lists: ${lists.map(l => l.name).join(', ')}`,
+            };
+        }
+        // 5. Move the card to the target list
+        try {
+            await client.updateCard(mapping.trelloCardId, { name: card.name, idList: targetList.id });
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: `Failed to move Trello card: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        // 6. Update local PMO mirror (best-effort)
+        try {
+            await this.storage.moveTicket(this.projectId, ticketId, newState);
+        }
+        catch {
+            // Non-fatal: Trello is the source of truth
+        }
+        // 7. Post a comment about the status change (best-effort)
+        try {
+            await client.addComment(mapping.trelloCardId, `Status updated to **${newState}** (via prlt)`);
+        }
+        catch {
+            // Non-fatal: comment is informational
+        }
+        // 8. Update sync timestamp (best-effort)
+        try {
+            mapper.updateSyncTimestamp(ticketId);
+        }
+        catch {
+            // Non-fatal
+        }
+        return { success: true, provider: 'trello' };
+    }
+    async deleteTicket(ticketId) {
+        let creds;
+        try {
+            creds = this.getCredentialsOrFail();
+        }
+        catch {
+            return { success: false, provider: 'trello', error: 'Trello credentials not configured' };
+        }
+        // Look up Trello mapping
+        const mapper = new TrelloMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (mapping) {
+            // Archive the card in Trello (closed = true)
+            const client = new TrelloClient(creds.apiKey, creds.apiToken);
+            try {
+                const card = await client.getCard(mapping.trelloCardId);
+                if (card) {
+                    await client.updateCard(mapping.trelloCardId, { name: card.name, closed: true });
+                }
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    provider: 'trello',
+                    error: `Failed to archive Trello card: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        // Delete the local PMO mirror
+        try {
+            await this.storage.deleteTicket(ticketId);
+        }
+        catch {
+            // Non-fatal if Trello archive succeeded
+        }
+        return { success: true, provider: 'trello' };
+    }
+    async listTickets(projectId, filter) {
+        let creds;
+        try {
+            creds = this.getCredentialsOrFail();
+        }
+        catch {
+            return { success: false, provider: 'trello', tickets: [], error: 'Trello credentials not configured' };
+        }
+        const trelloConfig = loadTrelloConfig(this.db);
+        const boardId = trelloConfig?.boardId || process.env.PRLT_TRELLO_BOARD_ID;
+        try {
+            const envelopes = await listTrelloCards({ apiKey: creds.apiKey, apiToken: creds.apiToken, boardId }, { limit: 50, query: filter?.search });
+            let tickets = envelopes.map(envelope => ({
+                id: envelope.source.externalKey,
+                title: envelope.title,
+                description: envelope.description || undefined,
+                priority: envelope.priority || undefined,
+                category: envelope.category || undefined,
+                projectId: envelope.projectKey,
+                projectName: envelope.projectKey,
+                statusId: envelope.status,
+                statusName: envelope.status,
+                owner: envelope.assignee || undefined,
+                assignee: envelope.assignee || undefined,
+                subtasks: [],
+                labels: envelope.labels,
+                metadata: {
+                    external_source: envelope.source.name,
+                    external_key: envelope.source.externalKey,
+                    external_id: envelope.source.externalId,
+                    external_url: envelope.source.url,
+                },
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            }));
+            // Apply client-side filters
+            if (filter?.priority) {
+                tickets = tickets.filter(t => t.priority === filter.priority);
+            }
+            if (filter?.column) {
+                tickets = tickets.filter(t => t.statusName === filter.column);
+            }
+            if (filter?.category) {
+                tickets = tickets.filter(t => t.category === filter.category);
+            }
+            if (filter?.search) {
+                const term = filter.search.toLowerCase();
+                tickets = tickets.filter(t => t.title.toLowerCase().includes(term) ||
+                    (t.description || '').toLowerCase().includes(term));
+            }
+            if (filter?.label) {
+                const label = filter.label.toLowerCase();
+                tickets = tickets.filter(t => t.labels.some(l => l.toLowerCase() === label));
+            }
+            return { success: true, provider: 'trello', tickets };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                tickets: [],
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async createTicket(projectId, input) {
+        let creds;
+        try {
+            creds = this.getCredentialsOrFail();
+        }
+        catch {
+            return { success: false, provider: 'trello', error: 'Trello credentials not configured' };
+        }
+        const client = new TrelloClient(creds.apiKey, creds.apiToken);
+        const trelloConfig = loadTrelloConfig(this.db);
+        const boardId = trelloConfig?.boardId || process.env.PRLT_TRELLO_BOARD_ID;
+        if (!boardId) {
+            return { success: false, provider: 'trello', error: 'Trello board ID is required. Run "prlt trello configure" or set PRLT_TRELLO_BOARD_ID.' };
+        }
+        try {
+            // Get the first list on the board as the default target
+            const lists = await client.getBoardLists(boardId);
+            if (lists.length === 0) {
+                return { success: false, provider: 'trello', error: 'No lists found on the Trello board.' };
+            }
+            const targetList = lists[0];
+            // Create the card in Trello
+            const card = await client.createCard({
+                name: input.title,
+                desc: input.description || undefined,
+                idList: targetList.id,
+                idBoard: boardId,
+            });
+            // Create local PMO mirror ticket
+            const mirrorDescription = [
+                input.description || '',
+                '',
+                '---',
+                `_Created in Trello: [${card.name}](${card.url})_`,
+            ].join('\n').trim();
+            const pmoTicket = await this.storage.createTicket(projectId, {
+                ...input,
+                title: card.name,
+                description: mirrorDescription,
+                metadata: {
+                    ...input.metadata,
+                    'external_source': 'trello',
+                    'external_id': card.id,
+                    'external_key': card.id,
+                    'external_url': card.url,
+                },
+            });
+            // Create mapping record for sync operations
+            const mapper = new TrelloMapper(this.db);
+            mapper.createOrUpdateMapping(pmoTicket.id, card.id, card.idBoard);
+            return { success: true, provider: 'trello', ticket: pmoTicket };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async getTicket(ticketId) {
+        // Use local PMO mirror to avoid unnecessary API calls (same pattern as Linear)
+        try {
+            const ticket = await this.storage.getTicket(ticketId);
+            return { success: true, provider: 'trello', ticket };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async updateTicket(ticketId, input) {
+        let creds;
+        try {
+            creds = this.getCredentialsOrFail();
+        }
+        catch {
+            return { success: false, provider: 'trello', error: 'Trello credentials not configured' };
+        }
+        // Look up Trello mapping for this PMO ticket
+        const mapper = new TrelloMapper(this.db);
+        const mapping = mapper.getByTicketId(ticketId);
+        if (mapping) {
+            // Build Trello update payload from input fields
+            const trelloInput = {};
+            if (input.title !== undefined)
+                trelloInput.name = input.title;
+            if (input.description !== undefined)
+                trelloInput.desc = input.description ?? undefined;
+            // Only call Trello API if there are Trello-relevant fields
+            if (Object.keys(trelloInput).length > 0) {
+                const client = new TrelloClient(creds.apiKey, creds.apiToken);
+                try {
+                    // Trello updateCard requires name, so fetch current card if we don't have it
+                    if (!trelloInput.name) {
+                        const card = await client.getCard(mapping.trelloCardId);
+                        if (card)
+                            trelloInput.name = card.name;
+                    }
+                    await client.updateCard(mapping.trelloCardId, trelloInput);
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        provider: 'trello',
+                        error: `Failed to update Trello card: ${error instanceof Error ? error.message : String(error)}`,
+                    };
+                }
+            }
+            // Update sync timestamp (best-effort)
+            try {
+                mapper.updateSyncTimestamp(ticketId);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+        // Also update local PMO mirror
+        try {
+            const ticket = await this.storage.updateTicket(ticketId, input);
+            return { success: true, provider: 'trello', ticket };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async assignTicket(ticketId, assignee) {
+        // Trello assignee is via member IDs — best-effort on Trello side,
+        // always update local PMO mirror
+        try {
+            await this.storage.updateTicket(ticketId, { assignee });
+            return { success: true, provider: 'trello' };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'trello',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+/**
+ * Find the best matching Trello list for a target state name.
+ * Uses case-insensitive exact match first, then substring match.
+ */
+function findMatchingTrelloList(lists, targetState) {
+    const lower = targetState.toLowerCase();
+    // 1. Exact match (case-insensitive)
+    const exact = lists.find(l => l.name.toLowerCase() === lower);
+    if (exact)
+        return exact;
+    // 2. List name contains the target state
+    const contains = lists.find(l => l.name.toLowerCase().includes(lower));
+    if (contains)
+        return contains;
+    // 3. Target state contains the list name
+    const reverseContains = lists.find(l => lower.includes(l.name.toLowerCase()));
+    if (reverseContains)
+        return reverseContains;
+    return null;
+}
+//# sourceMappingURL=trello-provider.js.map

package/dist/lib/providers/trello-provider.js.map

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

package/dist/lib/session/heartbeat.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Agent Heartbeat
+ *
+ * Heartbeat recording and checking for agent executions.
+ * The heartbeat system has two sides:
+ *
+ * 1. Agent-side (push): Agents update their heartbeat when alive/active.
+ *    This is done by checking tmux pane liveness and JSONL file activity.
+ *
+ * 2. Host-side (pull): The watcher checks heartbeat timestamps and marks
+ *    stale executions as failed. This catches the case where the agent is
+ *    so dead it can't self-report (OOM, zombie processes).
+ */
+import { ExecutionStorage } from '../execution/storage.js';
+import type { AgentWork } from '../execution/types.js';
+/**
+ * Record a heartbeat for an execution by checking if its tmux session is alive.
+ * Uses tmux pane inspection to determine if the agent is still active.
+ *
+ * Returns the detected health state, or null if the session couldn't be found.
+ */
+export declare function recordHeartbeatFromSession(storage: ExecutionStorage, execution: AgentWork): string | null;
+/**
+ * Record heartbeats for all running executions.
+ * Returns a map of execution ID to detected state.
+ */
+export declare function recordAllHeartbeats(storage: ExecutionStorage): Map<string, string>;
+/**
+ * Information about a stale execution detected by heartbeat timeout.
+ */
+export interface StaleExecution {
+    execution: AgentWork;
+    lastHeartbeat: Date | null;
+    staleDurationMinutes: number;
+    reason: string;
+}
+/**
+ * Check for stale executions that have exceeded the heartbeat timeout.
+ */
+export declare function detectStaleExecutions(storage: ExecutionStorage, timeoutMinutes: number): StaleExecution[];
+/**
+ * Kill a Docker container by ID.
+ * Returns true if the container was killed or already stopped.
+ */
+export declare function killContainer(containerId: string): boolean;

package/dist/lib/session/heartbeat.js

@@ -0,0 +1,150 @@
+/**
+ * Agent Heartbeat
+ *
+ * Heartbeat recording and checking for agent executions.
+ * The heartbeat system has two sides:
+ *
+ * 1. Agent-side (push): Agents update their heartbeat when alive/active.
+ *    This is done by checking tmux pane liveness and JSONL file activity.
+ *
+ * 2. Host-side (pull): The watcher checks heartbeat timestamps and marks
+ *    stale executions as failed. This catches the case where the agent is
+ *    so dead it can't self-report (OOM, zombie processes).
+ */
+import { execSync } from 'node:child_process';
+import { captureTmuxPane, getHostTmuxSessionNames, getContainerTmuxSessionMap, findContainerSessionsByPrefix, findSessionForExecution, } from '../execution/session-utils.js';
+import { detectState } from '../../commands/session/health.js';
+// =============================================================================
+// Heartbeat Recording (Agent-side push)
+// =============================================================================
+/**
+ * Record a heartbeat for an execution by checking if its tmux session is alive.
+ * Uses tmux pane inspection to determine if the agent is still active.
+ *
+ * Returns the detected health state, or null if the session couldn't be found.
+ */
+export function recordHeartbeatFromSession(storage, execution) {
+    const isContainer = execution.environment === 'devcontainer' || execution.environment === 'docker';
+    let sessionId = execution.sessionId;
+    // Try to find the tmux session
+    if (isContainer && execution.containerId) {
+        const containerSessions = getContainerTmuxSessionMap();
+        const sessions = findContainerSessionsByPrefix(containerSessions, execution.containerId);
+        if (!sessions || sessions.length === 0)
+            return null;
+        if (sessionId && sessions.includes(sessionId)) {
+            // Session found by exact match
+        }
+        else {
+            // Try fuzzy match
+            const match = findSessionForExecution(execution.ticketId, execution.agentName, sessions);
+            if (match) {
+                sessionId = match;
+            }
+            else {
+                return null;
+            }
+        }
+    }
+    else {
+        const hostSessions = getHostTmuxSessionNames();
+        if (sessionId && hostSessions.includes(sessionId)) {
+            // Session found
+        }
+        else {
+            const match = findSessionForExecution(execution.ticketId, execution.agentName, hostSessions);
+            if (match) {
+                sessionId = match;
+            }
+            else {
+                return null;
+            }
+        }
+    }
+    if (!sessionId)
+        return null;
+    // Capture pane content and detect state
+    const paneContent = captureTmuxPane(sessionId, 10, isContainer ? execution.containerId : undefined);
+    const state = detectState(paneContent);
+    // If the session is alive (any state other than UNKNOWN with no content), record heartbeat
+    if (paneContent !== null) {
+        storage.updateHeartbeat(execution.id);
+        // Update lifecycle state based on detected health
+        if (state === 'WORKING') {
+            storage.updateLifecycleState(execution.id, 'healthy');
+        }
+        else if (state === 'IDLE') {
+            storage.updateLifecycleState(execution.id, 'idle');
+        }
+        else if (state === 'DONE') {
+            storage.updateLifecycleState(execution.id, 'completed');
+        }
+    }
+    return state;
+}
+/**
+ * Record heartbeats for all running executions.
+ * Returns a map of execution ID to detected state.
+ */
+export function recordAllHeartbeats(storage) {
+    const results = new Map();
+    const runningExecutions = storage.listExecutions({ status: 'running' });
+    const startingExecutions = storage.listExecutions({ status: 'starting' });
+    const activeExecutions = [...runningExecutions, ...startingExecutions];
+    for (const exec of activeExecutions) {
+        const state = recordHeartbeatFromSession(storage, exec);
+        if (state) {
+            results.set(exec.id, state);
+        }
+    }
+    return results;
+}
+/**
+ * Check for stale executions that have exceeded the heartbeat timeout.
+ */
+export function detectStaleExecutions(storage, timeoutMinutes) {
+    const staleExecutions = storage.getStaleExecutions(timeoutMinutes);
+    return staleExecutions.map(exec => {
+        const lastHeartbeat = exec.lastHeartbeat || null;
+        const referenceTime = lastHeartbeat || exec.startedAt;
+        const staleDurationMs = Date.now() - referenceTime.getTime();
+        const staleDurationMinutes = Math.floor(staleDurationMs / 60000);
+        const reason = lastHeartbeat
+            ? `No heartbeat for ${staleDurationMinutes} minutes (last: ${lastHeartbeat.toISOString()})`
+            : `No heartbeat since start ${staleDurationMinutes} minutes ago`;
+        return {
+            execution: exec,
+            lastHeartbeat,
+            staleDurationMinutes,
+            reason,
+        };
+    });
+}
+// =============================================================================
+// Container Kill
+// =============================================================================
+/**
+ * Kill a Docker container by ID.
+ * Returns true if the container was killed or already stopped.
+ */
+export function killContainer(containerId) {
+    try {
+        execSync(`docker kill ${containerId}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 30000,
+        });
+        return true;
+    }
+    catch {
+        // Container may already be stopped
+        try {
+            const status = execSync(`docker inspect --format '{{.State.Status}}' ${containerId}`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10000 }).trim();
+            return status === 'exited' || status === 'dead';
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/lib/session/heartbeat.js.map

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

package/dist/lib/session/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Session Module
+ *
+ * Agent session monitoring, heartbeat tracking, and stale detection.
+ */
+export * from './heartbeat.js';
+export * from './watcher.js';

package/dist/lib/session/index.js

@@ -0,0 +1,8 @@
+/**
+ * Session Module
+ *
+ * Agent session monitoring, heartbeat tracking, and stale detection.
+ */
+export * from './heartbeat.js';
+export * from './watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}