@proletariat/cli 0.3.105 → 0.3.110

package/dist/lib/work-lifecycle/container-cleanup-hook.d.ts

@@ -1,21 +1,31 @@
 /**
- * Container Cleanup Lifecycle Hook
+ * Agent Cleanup Lifecycle Hook
  *
  * Subscribes to agent lifecycle events on the global EventBus and
- * automatically cleans up Docker containers when agents complete work.
+ * automatically runs the full cascading cleanup when agents stop.
  *
- * This is a triggered cleanup (not TTL-based): containers are removed
- * when the agent:stopped event fires or when stale executions are detected.
+ * This is Tier 1 of the cleanup system: event-driven cleanup that handles
+ * the ~90% case when agents stop normally (manual stop, completion, error).
+ *
+ * The cascade order follows the ticket spec:
+ *   1. CC/Claude session → 2. Tmux → 3. Container → 4. Worktree
+ *   5. Agent directory → 6. Git branch → 7. Execution records → 8. DB status
  */
 /**
  * ContainerCleanupHook listens for agent completion events and
- * removes the associated Docker container.
+ * runs the full cascading cleanup.
  *
  * Cleanup is fire-and-forget: failures are logged but never block
  * the event emission chain.
  */
 export declare class ContainerCleanupHook {
     private unsubscribers;
+    private hqPath;
+    /**
+     * Set the HQ path for full cascade cleanup (branch deletion, DB ops).
+     * If not set, only container-level cleanup runs.
+     */
+    setHqPath(hqPath: string): void;
     /**
      * Start listening for agent lifecycle events.
      */
@@ -25,7 +35,7 @@ export declare class ContainerCleanupHook {
      */
     stop(): void;
     /**
-     * Handle agent:stopped by cleaning up the agent's container.
+     * Handle agent:stopped by running cascading cleanup.
      * Extracts agent name from the session ID or event data.
      */
     private handleAgentStopped;
@@ -34,7 +44,7 @@ export declare class ContainerCleanupHook {
  * Initialize and start the container cleanup hook.
  * Safe to call multiple times — subsequent calls are no-ops.
  */
-export declare function initContainerCleanupHook(): ContainerCleanupHook;
+export declare function initContainerCleanupHook(hqPath?: string): ContainerCleanupHook;
 /**
  * Stop the container cleanup hook (primarily for testing).
  */

package/dist/lib/work-lifecycle/container-cleanup-hook.js

@@ -1,29 +1,42 @@
 /**
- * Container Cleanup Lifecycle Hook
+ * Agent Cleanup Lifecycle Hook
  *
  * Subscribes to agent lifecycle events on the global EventBus and
- * automatically cleans up Docker containers when agents complete work.
+ * automatically runs the full cascading cleanup when agents stop.
  *
- * This is a triggered cleanup (not TTL-based): containers are removed
- * when the agent:stopped event fires or when stale executions are detected.
+ * This is Tier 1 of the cleanup system: event-driven cleanup that handles
+ * the ~90% case when agents stop normally (manual stop, completion, error).
+ *
+ * The cascade order follows the ticket spec:
+ *   1. CC/Claude session → 2. Tmux → 3. Container → 4. Worktree
+ *   5. Agent directory → 6. Git branch → 7. Execution records → 8. DB status
  */
 import { getEventBus } from '../events/event-bus.js';
 import { cleanupAgentContainer } from '../execution/container-cleanup.js';
+import { executeCascade } from '../gc/cascade.js';
 /**
  * ContainerCleanupHook listens for agent completion events and
- * removes the associated Docker container.
+ * runs the full cascading cleanup.
  *
  * Cleanup is fire-and-forget: failures are logged but never block
  * the event emission chain.
  */
 export class ContainerCleanupHook {
     unsubscribers = [];
+    hqPath;
+    /**
+     * Set the HQ path for full cascade cleanup (branch deletion, DB ops).
+     * If not set, only container-level cleanup runs.
+     */
+    setHqPath(hqPath) {
+        this.hqPath = hqPath;
+    }
     /**
      * Start listening for agent lifecycle events.
      */
     start() {
         const bus = getEventBus();
-        // Clean up container when an agent is stopped
+        // Clean up agent resources when stopped
         this.unsubscribers.push(bus.on('agent:stopped', (payload) => {
             this.handleAgentStopped(payload);
         }));
@@ -38,7 +51,7 @@ export class ContainerCleanupHook {
         this.unsubscribers = [];
     }
     /**
-     * Handle agent:stopped by cleaning up the agent's container.
+     * Handle agent:stopped by running cascading cleanup.
      * Extracts agent name from the session ID or event data.
      */
     handleAgentStopped(eventData) {
@@ -48,15 +61,36 @@ export class ContainerCleanupHook {
             const sessionId = eventData.sessionId;
             if (!sessionId)
                 return;
+            // Skip if this is from stale-cleanup to avoid recursive loops
+            const runner = eventData.runner;
+            if (runner === 'cascade-cleanup')
+                return;
             // Extract agent name from session ID
             // Format: TKT-123-implement-agent-name or similar
             const agentName = extractAgentNameFromSessionId(sessionId);
-            if (!agentName)
+            if (!agentName) {
+                // Fall back to container-only cleanup if we can't extract agent name
+                cleanupAgentContainer(agentName ?? sessionId);
                 return;
-            cleanupAgentContainer(agentName);
+            }
+            // If we have hqPath, run the full cascade
+            if (this.hqPath) {
+                const target = {
+                    agentName,
+                    sessionId,
+                    hqPath: this.hqPath,
+                };
+                // Try to resolve container ID from agent name
+                target.containerId = findContainerIdForAgent(agentName);
+                executeCascade(target, { execute: true });
+            }
+            else {
+                // Minimal cleanup: just remove the container (backward compatible)
+                cleanupAgentContainer(agentName);
+            }
         }
         catch {
-            // Container cleanup errors are non-fatal
+            // Cleanup errors are non-fatal
         }
     }
 }
@@ -71,6 +105,20 @@ function extractAgentNameFromSessionId(sessionId) {
     const match = sessionId.match(/^(?:TKT-\d+|[A-Z]+-\d+)-\w+-(.+)$/);
     return match ? match[1] : null;
 }
+/**
+ * Find the Docker container ID for an agent by name.
+ * Returns null if no container is found.
+ */
+function findContainerIdForAgent(agentName) {
+    try {
+        const { execSync } = require('node:child_process');
+        const output = execSync(`docker ps -a --filter "name=prlt-agent-${agentName}" --format "{{.ID}}"`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 5000 }).trim();
+        return output || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 // =============================================================================
 // Singleton
 // =============================================================================
@@ -79,11 +127,16 @@ let _hook;
  * Initialize and start the container cleanup hook.
  * Safe to call multiple times — subsequent calls are no-ops.
  */
-export function initContainerCleanupHook() {
+export function initContainerCleanupHook(hqPath) {
     if (!_hook) {
         _hook = new ContainerCleanupHook();
+        if (hqPath)
+            _hook.setHqPath(hqPath);
         _hook.start();
     }
+    else if (hqPath) {
+        _hook.setHqPath(hqPath);
+    }
     return _hook;
 }
 /**

package/dist/lib/work-lifecycle/container-cleanup-hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"container-cleanup-hook.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/container-cleanup-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACvB,aAAa,GAAsB,EAAE,CAAA;IAE7C;;OAEG;IACH,KAAK;QACH,MAAM,GAAG,GAAG,WAAW,EAAE,CAAA;QAEzB,8CAA8C;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,GAAG,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,kBAAkB,CAAC,OAA6C,CAAC,CAAA;QACxE,CAAC,CAAC,CACH,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,KAAK,EAAE,CAAA;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;IACzB,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,SAAkC;QAC3D,IAAI,CAAC;YACH,2DAA2D;YAC3D,+CAA+C;YAC/C,MAAM,SAAS,GAAG,SAAS,CAAC,SAA+B,CAAA;YAC3D,IAAI,CAAC,SAAS;gBAAE,OAAM;YAEtB,qCAAqC;YACrC,kDAAkD;YAClD,MAAM,SAAS,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAA;YAC1D,IAAI,CAAC,SAAS;gBAAE,OAAM;YAEtB,qBAAqB,CAAC,SAAS,CAAC,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,6BAA6B,CAAC,SAAiB;IACtD,qDAAqD;IACrD,iEAAiE;IACjE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAClE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChC,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,IAAI,KAAuC,CAAA;AAE3C;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QAClC,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,EAAE,CAAA;QACZ,KAAK,GAAG,SAAS,CAAA;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"container-cleanup-hook.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/container-cleanup-hook.ts"],"names":[],"mappings":"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"}

package/dist/lib/work-lifecycle/hooks/executor.d.ts

@@ -5,10 +5,30 @@
  * work lifecycle events fire. Each action type has its own execution logic.
  *
  * Shell commands receive event data as environment variables prefixed with
- * PRLT_HOOK_. Webhook actions POST event data as JSON. Log actions print
- * interpolated messages to stdout.
+ * PRLT_HOOK_. A PRLT_HOOK_JSON variable carries the full payload as valid
+ * JSON so hooks can parse it reliably. Webhook actions POST event data as
+ * JSON. Log actions print interpolated messages to stdout.
  */
 import type { WorkHookConfig, HookExecutionResult } from './types.js';
+/**
+ * JSON replacer that converts Date objects to ISO-8601 strings.
+ * Prevents [object Object] or invalid serialisation for non-primitive values.
+ */
+export declare function safeJsonReplacer(_key: string, value: unknown): unknown;
+/**
+ * Safely serialise event data to a JSON string.
+ * Returns a valid JSON string even when the payload contains Date objects
+ * or other non-primitive values.  On serialisation failure returns a
+ * minimal fallback so hooks always receive parseable JSON.
+ */
+export declare function safeJsonStringify(eventName: string, eventData: Record<string, unknown>): string;
+/**
+ * Build environment variables from event data for shell hook execution.
+ * All keys are uppercased and prefixed with PRLT_HOOK_.
+ *
+ * PRLT_HOOK_JSON contains the full event payload as valid JSON.
+ */
+export declare function buildEnvVars(eventName: string, eventData: Record<string, unknown>): Record<string, string>;
 /**
  * Execute a single hook action and return the result.
  */

package/dist/lib/work-lifecycle/hooks/executor.js

@@ -5,17 +5,45 @@
  * work lifecycle events fire. Each action type has its own execution logic.
  *
  * Shell commands receive event data as environment variables prefixed with
- * PRLT_HOOK_. Webhook actions POST event data as JSON. Log actions print
- * interpolated messages to stdout.
+ * PRLT_HOOK_. A PRLT_HOOK_JSON variable carries the full payload as valid
+ * JSON so hooks can parse it reliably. Webhook actions POST event data as
+ * JSON. Log actions print interpolated messages to stdout.
  */
 import { execSync } from 'node:child_process';
+/**
+ * JSON replacer that converts Date objects to ISO-8601 strings.
+ * Prevents [object Object] or invalid serialisation for non-primitive values.
+ */
+export function safeJsonReplacer(_key, value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    return value;
+}
+/**
+ * Safely serialise event data to a JSON string.
+ * Returns a valid JSON string even when the payload contains Date objects
+ * or other non-primitive values.  On serialisation failure returns a
+ * minimal fallback so hooks always receive parseable JSON.
+ */
+export function safeJsonStringify(eventName, eventData) {
+    try {
+        return JSON.stringify({ event: eventName, ...eventData }, safeJsonReplacer);
+    }
+    catch {
+        // Fallback: emit at least the event name so consumers always get valid JSON
+        return JSON.stringify({ event: eventName, error: 'payload_serialization_failed' });
+    }
+}
 /**
  * Build environment variables from event data for shell hook execution.
  * All keys are uppercased and prefixed with PRLT_HOOK_.
+ *
+ * PRLT_HOOK_JSON contains the full event payload as valid JSON.
  */
-function buildEnvVars(eventName, eventData) {
+export function buildEnvVars(eventName, eventData) {
     const env = {
         PRLT_HOOK_EVENT: eventName,
+        PRLT_HOOK_JSON: safeJsonStringify(eventName, eventData),
     };
     for (const [key, value] of Object.entries(eventData)) {
         if (value === null || value === undefined)
@@ -24,6 +52,15 @@ function buildEnvVars(eventName, eventData) {
         if (value instanceof Date) {
             env[envKey] = value.toISOString();
         }
+        else if (typeof value === 'object') {
+            // Serialize objects/arrays as JSON instead of [object Object]
+            try {
+                env[envKey] = JSON.stringify(value, safeJsonReplacer);
+            }
+            catch {
+                env[envKey] = String(value);
+            }
+        }
         else {
             env[envKey] = String(value);
         }
@@ -63,16 +100,17 @@ export function executeHook(hook, eventName, eventData) {
                 break;
             }
             case 'webhook': {
-                // Fire-and-forget POST to the configured URL
+                // Fire-and-forget POST to the configured URL.
+                // Uses safeJsonReplacer so Date objects become ISO strings.
                 const body = JSON.stringify({
                     event: eventName,
                     data: eventData,
                     hook: { id: hook.id, name: hook.name },
                     timestamp: new Date().toISOString(),
-                });
-                // Use synchronous fetch via execSync to keep it simple
-                // This avoids async complexity in the event handler
-                execSync(`curl -s -X POST -H "Content-Type: application/json" -d '${body.replace(/'/g, "'\\''")}' '${hook.actionValue}'`, { timeout: 10_000, stdio: 'pipe' });
+                }, safeJsonReplacer);
+                // Pass JSON via stdin to avoid shell-escaping issues that
+                // caused invalid JSON on abnormal termination (PRLT-1260).
+                execSync(`curl -s -X POST -H "Content-Type: application/json" -d @- '${hook.actionValue.replace(/'/g, "'\\''")}' `, { input: body, timeout: 10_000, stdio: ['pipe', 'pipe', 'pipe'] });
                 break;
             }
             case 'log': {

package/dist/lib/work-lifecycle/hooks/executor.js.map

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

package/dist/lib/work-lifecycle/hooks/manager.d.ts

@@ -4,7 +4,7 @@
  * The single hook execution system for the entire application.
  * Subscribes to work lifecycle events on the global EventBus and
  * executes matching hook configurations from the database with
- * mode-aware behavior (auto/confirm/notify/off).
+ * mode-aware behavior (auto/confirm/notify/llm/human/off).
  *
  * Used by both the interactive CLI (with default auto mode) and
  * the orchestrate daemon (with full mode/callback support).
@@ -14,7 +14,8 @@
  * emission chain.
  */
 import type Database from 'better-sqlite3';
-import { type HookExecutionResult, type HookActionHandler, type WorkHookConfig } from './types.js';
+import { type HookExecutionResult, type HookActionHandler, type WorkHookConfig, type LlmDecision } from './types.js';
+import { type EscalationContext, type EscalationReason, type PendingLlmDecision, type PendingHumanEscalation } from '../../orchestrate/escalation.js';
 /**
  * Options for creating a HookManager.
  */
@@ -27,6 +28,25 @@ export interface HookManagerOptions {
     onConfirm?: (hookName: string, event: string, action: string) => Promise<boolean>;
     /** Callback for notifications (notify-mode hooks) */
     onNotify?: (hookName: string, event: string, action: string, result: HookExecutionResult) => void;
+    /**
+     * Callback for LLM-mode hooks (Tier 2).
+     * Receives escalation context, returns LLM decision: approve/deny/escalate.
+     * If not provided, LLM decisions are queued in pendingLlmDecisions.
+     */
+    onLlmDecision?: (context: EscalationContext) => Promise<LlmDecision>;
+    /**
+     * Callback for human-mode hooks (Tier 3).
+     * Called when a hook needs human approval — either directly (mode=human/confirm)
+     * or via escalation from LLM tier.
+     * Returns true to approve, false to deny.
+     * If not provided, human escalations are queued in pendingHumanEscalations.
+     */
+    onHumanEscalation?: (context: EscalationContext, reason: EscalationReason) => Promise<boolean>;
+    /**
+     * Timeout in ms for LLM decisions before auto-escalating to human.
+     * Defaults to DEFAULT_LLM_TIMEOUT_MS (5 minutes).
+     */
+    llmTimeoutMs?: number;
     /**
      * Built-in action handlers (e.g., merge-pr, spawn-agent).
      * When a hook's action resolves to a key in this map, the handler
@@ -53,8 +73,13 @@ export declare class HookManager {
     private log;
     private onConfirm?;
     private onNotify?;
+    private onLlmDecision?;
+    private onHumanEscalation?;
+    private llmTimeoutMs;
     private actionHandlers;
     private _pendingConfirmations;
+    private _pendingLlmDecisions;
+    private _pendingHumanEscalations;
     constructor(options: HookManagerOptions);
     /**
      * Start listening for hookable events on the global EventBus.
@@ -82,6 +107,40 @@ export declare class HookManager {
      * Deny a pending confirmation.
      */
     denyConfirmation(index: number): boolean;
+    /**
+     * Get pending LLM decisions for hooks in llm mode.
+     */
+    getPendingLlmDecisions(): PendingLlmDecision[];
+    /**
+     * Approve a pending LLM decision and execute it.
+     */
+    approveLlmDecision(index: number): Promise<HookExecutionResult | null>;
+    /**
+     * Deny a pending LLM decision.
+     */
+    denyLlmDecision(index: number): boolean;
+    /**
+     * Escalate a pending LLM decision to human tier.
+     * Removes from LLM queue and adds to human escalation queue.
+     */
+    escalateLlmDecision(index: number): boolean;
+    /**
+     * Check for timed-out LLM decisions and auto-escalate them to human tier.
+     * Returns the number of decisions that were escalated.
+     */
+    escalateTimedOutLlmDecisions(): number;
+    /**
+     * Get pending human escalations.
+     */
+    getPendingHumanEscalations(): PendingHumanEscalation[];
+    /**
+     * Approve a pending human escalation and execute it.
+     */
+    approveHumanEscalation(index: number): Promise<HookExecutionResult | null>;
+    /**
+     * Deny a pending human escalation.
+     */
+    denyHumanEscalation(index: number): boolean;
     /**
      * Build a context object from raw event data.
      * Normalizes common field names for built-in action handlers.
@@ -101,7 +160,7 @@ export declare class HookManager {
     static resolveActionName(hook: WorkHookConfig, knownActions?: Record<string, unknown>): string;
     /**
      * Handle an event by finding and executing all matching enabled hooks.
-     * Supports mode-aware execution: auto, confirm, notify, off.
+     * Supports mode-aware execution: auto, confirm, notify, llm, human, off.
      */
     private handleEvent;
     /**