@proletariat/cli 0.3.95 → 0.3.97

package/dist/lib/session/watcher.js

@@ -6,13 +6,14 @@
  * that can't self-report (OOM kills, zombie processes, container crashes).
  *
  * Architecture:
- * 1. Poll: Check all running executions for heartbeat timeout
- * 2. Update: Record heartbeats for alive agents (tmux pane inspection)
- * 3. Detect: Find stale executions that exceeded the timeout
- * 4. Act: Mark failed, kill containers, fire events
+ * Phase 0: Tmux server health check — detect full server crashes (PRLT-1115)
+ * Phase 1: Record heartbeats for alive agents (tmux pane inspection)
+ * Phase 2: Detect stale executions that exceeded the timeout
+ * Phase 3: Act on stale executions — mark failed, kill containers, fire events
  */
 import { ExecutionStorage } from '../execution/storage.js';
 import { recordAllHeartbeats, detectStaleExecutions, killContainer, } from './heartbeat.js';
+import { TmuxWatchdog, formatCrashNotification, sendDesktopNotification, } from './tmux-watchdog.js';
 // =============================================================================
 // Session Watcher
 // =============================================================================
@@ -22,18 +23,40 @@ export class SessionWatcher {
     intervalMinutes;
     timeoutMinutes;
     autoKill;
+    autoRecover;
     log;
     onStaleDetected;
+    onCrashDetected;
     timer = null;
     running = false;
+    watchdog;
+    isFirstCycle = true;
     constructor(options) {
         this.db = options.db;
         this.storage = new ExecutionStorage(options.db);
         this.intervalMinutes = options.intervalMinutes ?? 5;
         this.timeoutMinutes = options.timeoutMinutes ?? 15;
         this.autoKill = options.autoKill ?? true;
+        this.autoRecover = options.autoRecover ?? true;
         this.log = options.log ?? (() => { });
         this.onStaleDetected = options.onStaleDetected;
+        this.onCrashDetected = options.onCrashDetected;
+        this.watchdog = new TmuxWatchdog({
+            storage: this.storage,
+            autoRecover: this.autoRecover,
+            log: this.log,
+            onCrashDetected: async (event) => {
+                // Send desktop notification
+                const notification = formatCrashNotification(event);
+                this.log(notification);
+                sendDesktopNotification('prlt: tmux server crash', `${event.affectedExecutions.length} agent(s) affected. ` +
+                    `${event.recoveredSessions.length} recovered.`);
+                // Fire user callback
+                if (this.onCrashDetected) {
+                    await this.onCrashDetected(event);
+                }
+            },
+        });
     }
     /**
      * Run a single watch cycle.
@@ -45,7 +68,25 @@ export class SessionWatcher {
             heartbeatsUpdated: 0,
             staleExecutions: [],
             containersKilled: 0,
+            crashEvents: [],
+            crashRecoveries: 0,
         };
+        // Phase 0: Tmux server health check (PRLT-1115)
+        // Detect full server crashes before doing individual heartbeat checks.
+        // On the first cycle, seed the watchdog state without triggering crash detection.
+        if (this.isFirstCycle) {
+            const activeExecs = [
+                ...this.storage.listExecutions({ status: 'running' }),
+                ...this.storage.listExecutions({ status: 'starting' }),
+            ];
+            this.watchdog.seedServerState(activeExecs);
+            this.isFirstCycle = false;
+        }
+        else {
+            const watchdogResult = await this.watchdog.checkAndRecover();
+            result.crashEvents = watchdogResult.crashEvents;
+            result.crashRecoveries = watchdogResult.totalRecovered;
+        }
         // Phase 1: Record heartbeats for all active executions
         // This is the "push" side — we check tmux panes and update heartbeats
         const heartbeats = recordAllHeartbeats(this.storage);
@@ -88,7 +129,8 @@ export class SessionWatcher {
         if (this.running)
             return;
         this.running = true;
-        this.log(`[watcher] Starting session watcher (interval: ${this.intervalMinutes}m, timeout: ${this.timeoutMinutes}m, auto-kill: ${this.autoKill})`);
+        this.log(`[watcher] Starting session watcher (interval: ${this.intervalMinutes}m, timeout: ${this.timeoutMinutes}m, ` +
+            `auto-kill: ${this.autoKill}, auto-recover: ${this.autoRecover})`);
         // Run initial cycle
         void this.runCycleWithErrorHandling();
         // Start polling
@@ -124,14 +166,30 @@ export class SessionWatcher {
             intervalMinutes: this.intervalMinutes,
             timeoutMinutes: this.timeoutMinutes,
             autoKill: this.autoKill,
+            autoRecover: this.autoRecover,
         };
     }
+    /**
+     * Get the tmux watchdog instance (for testing/diagnostics).
+     */
+    getWatchdog() {
+        return this.watchdog;
+    }
     async runCycleWithErrorHandling() {
         try {
             const result = await this.runCycle();
-            if (result.staleExecutions.length > 0) {
-                this.log(`[watcher] Cycle complete: ${result.checked} checked, ${result.heartbeatsUpdated} heartbeats, ` +
-                    `${result.staleExecutions.length} stale, ${result.containersKilled} killed`);
+            if (result.staleExecutions.length > 0 || result.crashEvents.length > 0) {
+                const parts = [
+                    `${result.checked} checked`,
+                    `${result.heartbeatsUpdated} heartbeats`,
+                    `${result.staleExecutions.length} stale`,
+                    `${result.containersKilled} killed`,
+                ];
+                if (result.crashEvents.length > 0) {
+                    parts.push(`${result.crashEvents.length} crash(es)`);
+                    parts.push(`${result.crashRecoveries} recovered`);
+                }
+                this.log(`[watcher] Cycle complete: ${parts.join(', ')}`);
             }
         }
         catch (error) {

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

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

package/dist/lib/sync/daemon-process.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Daemon Process
+ *
+ * This is the background process spawned by `prlt sync start`.
+ * It runs a sync cycle and merge queue cycle on a configurable interval.
+ *
+ * Args: [hqPath, intervalSeconds]
+ */
+export {};

package/dist/lib/sync/daemon-process.js

@@ -0,0 +1,184 @@
+/**
+ * Daemon Process
+ *
+ * This is the background process spawned by `prlt sync start`.
+ * It runs a sync cycle and merge queue cycle on a configurable interval.
+ *
+ * Args: [hqPath, intervalSeconds]
+ */
+import * as fs from 'node:fs';
+import { openWorkspaceDatabase } from '../database/index.js';
+import { getPMOContext } from '../pmo/pmo-context.js';
+import { runSyncCycle } from './engine.js';
+import { runMergeQueueCycle } from './merge-queue.js';
+import { removeDaemonPid, getDaemonLogPath } from './daemon.js';
+import { GCScheduler, collectGCCandidates, executeGC, } from '../gc/index.js';
+const args = process.argv.slice(2);
+const hqPath = args[0];
+const intervalSeconds = parseInt(args[1] || '60', 10);
+if (!hqPath) {
+    console.error('Usage: daemon-process <hqPath> [intervalSeconds]');
+    process.exit(1);
+}
+const logPath = getDaemonLogPath(hqPath);
+function log(msg) {
+    const timestamp = new Date().toISOString();
+    const line = `[${timestamp}] ${msg}\n`;
+    fs.appendFileSync(logPath, line);
+}
+async function getProjectId() {
+    const context = await getPMOContext();
+    const projects = await context.storage.listProjects();
+    await context.storage.close();
+    if (projects.length === 0) {
+        throw new Error('No projects found');
+    }
+    return projects[0].id;
+}
+// GC scheduler with 1-hour grace period — persists across daemon cycles
+const gcScheduler = new GCScheduler(60 * 60 * 1000);
+/** Map ticket priority strings to numeric values (lower = higher priority). */
+function priorityToNumber(priority) {
+    switch (priority) {
+        case 'P0': return 0;
+        case 'P1': return 1;
+        case 'P2': return 2;
+        case 'P3': return 3;
+        default: return 3;
+    }
+}
+async function cycle() {
+    let db;
+    try {
+        db = openWorkspaceDatabase(hqPath);
+        const context = await getPMOContext();
+        const projectId = await getProjectId();
+        const storage = context.storage;
+        // Phase 1: Reconciliation — sync ticket state with PR state
+        const report = await runSyncCycle(db, storage, projectId, {
+            cwd: hqPath,
+            log,
+        });
+        if (report.applied.length > 0) {
+            log(`Applied ${report.applied.length} correction(s)`);
+        }
+        if (report.failed.length > 0) {
+            log(`Failed ${report.failed.length} correction(s)`);
+        }
+        // Phase 2: Merge Queue — sequential rebase-test-merge pipeline
+        try {
+            // Build priority map from tickets for queue ordering
+            const branchPriorities = new Map();
+            const startedTickets = await storage.listTickets(projectId, { statusCategory: 'started' });
+            for (const ticket of startedTickets) {
+                if (ticket.branch) {
+                    branchPriorities.set(ticket.branch, priorityToNumber(ticket.priority));
+                }
+            }
+            const mqResult = runMergeQueueCycle({
+                hqPath,
+                cwd: hqPath,
+                log,
+                branchPriorities,
+            });
+            if (mqResult.action !== 'none' && mqResult.action !== 'paused') {
+                log(`Merge queue: ${mqResult.action}${mqResult.prNumber ? ` PR #${mqResult.prNumber}` : ''}${mqResult.reason ? ` — ${mqResult.reason}` : ''}`);
+            }
+        }
+        catch (mqErr) {
+            const mqMsg = mqErr instanceof Error ? mqErr.message : String(mqErr);
+            log(`Merge queue error: ${mqMsg}`);
+        }
+        // Phase 3: Garbage Collection — schedule cleanup for merged PRs, run ready cleanups
+        try {
+            // Schedule GC for any tickets that just moved to Done (PR merged)
+            const mergedActions = report.applied.filter(a => a.type === 'move_to_done');
+            if (mergedActions.length > 0) {
+                const completedTickets = await storage.listTickets(projectId, { statusCategory: 'completed' });
+                for (const action of mergedActions) {
+                    const ticket = completedTickets.find(t => t.id === action.ticketId);
+                    if (ticket?.branch) {
+                        gcScheduler.schedule(ticket.branch);
+                        log(`GC: Scheduled cleanup for branch ${ticket.branch} (1hr grace period)`);
+                    }
+                }
+            }
+            // Process any ready cleanups (grace period expired)
+            const readyBranches = gcScheduler.getReady();
+            if (readyBranches.length > 0) {
+                log(`GC: Processing ${readyBranches.length} cleanup(s) past grace period`);
+                const candidates = collectGCCandidates({
+                    hqPath,
+                    staleDays: 7,
+                    log,
+                });
+                // Only clean up the branches that are ready
+                const readySet = new Set(readyBranches);
+                const readyCandidates = candidates.filter(c => readySet.has(c.branch));
+                if (readyCandidates.length > 0) {
+                    const result = executeGC(readyCandidates, {
+                        hqPath,
+                        execute: true,
+                        log,
+                    });
+                    if (result.worktreesRemoved.length > 0) {
+                        log(`GC: Removed ${result.worktreesRemoved.length} worktree(s), ${result.containersRemoved.length} container(s), ${result.branchesPruned.length} branch(es)`);
+                    }
+                    if (result.errors.length > 0) {
+                        log(`GC: ${result.errors.length} error(s): ${result.errors.join('; ')}`);
+                    }
+                }
+                // Mark as completed regardless of whether cleanup was needed
+                for (const branch of readyBranches) {
+                    gcScheduler.complete(branch);
+                }
+            }
+        }
+        catch (gcErr) {
+            const gcMsg = gcErr instanceof Error ? gcErr.message : String(gcErr);
+            log(`GC error: ${gcMsg}`);
+        }
+        await context.storage.close();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`Error: ${msg}`);
+    }
+    finally {
+        if (db) {
+            try {
+                db.close();
+            }
+            catch { }
+        }
+    }
+}
+// Signal handling
+process.on('SIGTERM', () => {
+    log('Received SIGTERM — shutting down');
+    removeDaemonPid(hqPath);
+    process.exit(0);
+});
+process.on('SIGINT', () => {
+    log('Received SIGINT — shutting down');
+    removeDaemonPid(hqPath);
+    process.exit(0);
+});
+// Main loop
+log(`Daemon started (PID ${process.pid}, interval ${intervalSeconds}s)`);
+async function run() {
+    // Run initial cycle immediately
+    await cycle();
+    // Then schedule periodic runs
+    setInterval(() => {
+        cycle().catch(err => {
+            log(`Unhandled error in cycle: ${err}`);
+        });
+    }, intervalSeconds * 1000);
+}
+run().catch(err => {
+    log(`Fatal: ${err}`);
+    removeDaemonPid(hqPath);
+    process.exit(1);
+});
+//# sourceMappingURL=daemon-process.js.map

package/dist/lib/sync/daemon-process.js.map

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

package/dist/lib/sync/daemon.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Sync Daemon
+ *
+ * Manages a background process that periodically runs the sync engine.
+ * Uses a PID file in the HQ directory to track the daemon process.
+ */
+export interface DaemonInfo {
+    pid: number;
+    startedAt: string;
+    intervalSeconds: number;
+}
+/**
+ * Get the path to the daemon PID file.
+ */
+export declare function getDaemonPidPath(hqPath: string): string;
+/**
+ * Get the path to the daemon log file.
+ */
+export declare function getDaemonLogPath(hqPath: string): string;
+/**
+ * Read daemon info from PID file.
+ */
+export declare function getDaemonInfo(hqPath: string): DaemonInfo | null;
+/**
+ * Write daemon info to PID file.
+ */
+export declare function writeDaemonInfo(hqPath: string, info: DaemonInfo): void;
+/**
+ * Remove daemon PID file.
+ */
+export declare function removeDaemonPid(hqPath: string): void;
+/**
+ * Check if a daemon process is alive by PID.
+ */
+export declare function isDaemonRunning(hqPath: string): boolean;
+/**
+ * Stop the daemon process.
+ */
+export declare function stopDaemon(hqPath: string): boolean;

package/dist/lib/sync/daemon.js

@@ -0,0 +1,91 @@
+/**
+ * Sync Daemon
+ *
+ * Manages a background process that periodically runs the sync engine.
+ * Uses a PID file in the HQ directory to track the daemon process.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DAEMON_PID_FILE = 'sync-daemon.pid';
+const DAEMON_LOG_FILE = 'sync-daemon.log';
+/**
+ * Get the path to the daemon PID file.
+ */
+export function getDaemonPidPath(hqPath) {
+    return path.join(hqPath, '.proletariat', DAEMON_PID_FILE);
+}
+/**
+ * Get the path to the daemon log file.
+ */
+export function getDaemonLogPath(hqPath) {
+    return path.join(hqPath, '.proletariat', DAEMON_LOG_FILE);
+}
+/**
+ * Read daemon info from PID file.
+ */
+export function getDaemonInfo(hqPath) {
+    const pidPath = getDaemonPidPath(hqPath);
+    try {
+        const content = fs.readFileSync(pidPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write daemon info to PID file.
+ */
+export function writeDaemonInfo(hqPath, info) {
+    const pidPath = getDaemonPidPath(hqPath);
+    fs.writeFileSync(pidPath, JSON.stringify(info, null, 2));
+}
+/**
+ * Remove daemon PID file.
+ */
+export function removeDaemonPid(hqPath) {
+    const pidPath = getDaemonPidPath(hqPath);
+    try {
+        fs.unlinkSync(pidPath);
+    }
+    catch {
+        // File may not exist
+    }
+}
+/**
+ * Check if a daemon process is alive by PID.
+ */
+export function isDaemonRunning(hqPath) {
+    const info = getDaemonInfo(hqPath);
+    if (!info)
+        return false;
+    try {
+        // Sending signal 0 checks if process exists without killing it
+        process.kill(info.pid, 0);
+        return true;
+    }
+    catch {
+        // Process doesn't exist — clean up stale PID file
+        removeDaemonPid(hqPath);
+        return false;
+    }
+}
+/**
+ * Stop the daemon process.
+ */
+export function stopDaemon(hqPath) {
+    const info = getDaemonInfo(hqPath);
+    if (!info)
+        return false;
+    try {
+        process.kill(info.pid, 'SIGTERM');
+        removeDaemonPid(hqPath);
+        return true;
+    }
+    catch {
+        // Process may already be dead
+        removeDaemonPid(hqPath);
+        return false;
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/lib/sync/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../../src/lib/sync/daemon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,MAAM,eAAe,GAAG,iBAAiB,CAAA;AACzC,MAAM,eAAe,GAAG,iBAAiB,CAAA;AAQzC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAgB;IAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAEvB,IAAI,CAAC;QACH,+DAA+D;QAC/D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,eAAe,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAEvB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACjC,eAAe,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;QAC9B,eAAe,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/lib/sync/engine.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Sync Engine
+ *
+ * Orchestrates the reconciliation process: gathers ticket state and PR state,
+ * runs the reconciler, and applies corrective actions through providers.
+ *
+ * This is the "run once" engine. The daemon wraps this with a polling loop.
+ */
+import type Database from 'better-sqlite3';
+import type { ProviderStorage } from '../providers/types.js';
+import type { PMOStorage } from '../pmo/types.js';
+import { type ReconcileAction, type ReconcileResult } from './reconciler.js';
+export interface SyncEngineOptions {
+    /** Working directory for git/gh operations */
+    cwd?: string;
+    /** Callback for logging */
+    log?: (msg: string) => void;
+    /** If true, don't actually move tickets — just report what would happen */
+    dryRun?: boolean;
+}
+export interface SyncReport {
+    result: ReconcileResult;
+    applied: ReconcileAction[];
+    skipped: ReconcileAction[];
+    failed: Array<{
+        action: ReconcileAction;
+        error: string;
+    }>;
+}
+/**
+ * Run a single reconciliation cycle.
+ *
+ * 1. List all tickets in started/review states
+ * 2. For each, check PR status
+ * 3. Run reconciler to determine actions
+ * 4. Apply actions through providers
+ */
+export declare function runSyncCycle(db: Database.Database, storage: PMOStorage & ProviderStorage, projectId: string, options?: SyncEngineOptions): Promise<SyncReport>;