@proletariat/cli 0.3.78 → 0.3.80

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

@@ -0,0 +1,98 @@
+/**
+ * Container Cleanup Lifecycle Hook
+ *
+ * Subscribes to agent lifecycle events on the global EventBus and
+ * automatically cleans up Docker containers when agents complete work.
+ *
+ * This is a triggered cleanup (not TTL-based): containers are removed
+ * when the agent:stopped event fires or when stale executions are detected.
+ */
+import { getEventBus } from '../events/event-bus.js';
+import { cleanupAgentContainer } from '../execution/container-cleanup.js';
+/**
+ * ContainerCleanupHook listens for agent completion events and
+ * removes the associated Docker container.
+ *
+ * Cleanup is fire-and-forget: failures are logged but never block
+ * the event emission chain.
+ */
+export class ContainerCleanupHook {
+    unsubscribers = [];
+    /**
+     * Start listening for agent lifecycle events.
+     */
+    start() {
+        const bus = getEventBus();
+        // Clean up container when an agent is stopped
+        this.unsubscribers.push(bus.on('agent:stopped', (payload) => {
+            this.handleAgentStopped(payload);
+        }));
+    }
+    /**
+     * Stop listening and clean up subscriptions.
+     */
+    stop() {
+        for (const unsub of this.unsubscribers) {
+            unsub();
+        }
+        this.unsubscribers = [];
+    }
+    /**
+     * Handle agent:stopped by cleaning up the agent's container.
+     * Extracts agent name from the session ID or event data.
+     */
+    handleAgentStopped(eventData) {
+        try {
+            // The sessionId format is: {ticketId}-{action}-{agentName}
+            // We need the agent name to find the container
+            const sessionId = eventData.sessionId;
+            if (!sessionId)
+                return;
+            // Extract agent name from session ID
+            // Format: TKT-123-implement-agent-name or similar
+            const agentName = extractAgentNameFromSessionId(sessionId);
+            if (!agentName)
+                return;
+            cleanupAgentContainer(agentName);
+        }
+        catch {
+            // Container cleanup errors are non-fatal
+        }
+    }
+}
+/**
+ * Extract agent name from a session ID.
+ * Session IDs follow the format: {ticketId}-{action}-{agentName}
+ * e.g., "TKT-100-implement-bold-turing" → "bold-turing"
+ */
+function extractAgentNameFromSessionId(sessionId) {
+    // Match pattern: TKT-NNN-action-agentname or similar
+    // Agent names are typically two hyphenated words: adjective-noun
+    const match = sessionId.match(/^(?:TKT-\d+|[A-Z]+-\d+)-\w+-(.+)$/);
+    return match ? match[1] : null;
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let _hook;
+/**
+ * Initialize and start the container cleanup hook.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ */
+export function initContainerCleanupHook() {
+    if (!_hook) {
+        _hook = new ContainerCleanupHook();
+        _hook.start();
+    }
+    return _hook;
+}
+/**
+ * Stop the container cleanup hook (primarily for testing).
+ */
+export function stopContainerCleanupHook() {
+    if (_hook) {
+        _hook.stop();
+        _hook = undefined;
+    }
+}
+//# sourceMappingURL=container-cleanup-hook.js.map

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

@@ -0,0 +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"}

package/dist/lib/work-lifecycle/index.d.ts

@@ -12,3 +12,4 @@ export { handlePostExecutionTransition, type PostExecutionContext, type PostExec
 export { validateCommits, tryValidateCommits, type CommitValidationResult, } from '../execution/commit-validation.js';
 export { WorkflowRuleEvaluator, initWorkflowRuleEvaluator, stopWorkflowRuleEvaluator, } from './rule-evaluator.js';
 export { ActionChainingHandler, initActionChaining, stopActionChaining, } from './action-chaining.js';
+export { ContainerCleanupHook, initContainerCleanupHook, stopContainerCleanupHook, } from './container-cleanup-hook.js';

package/dist/lib/work-lifecycle/index.js

@@ -11,4 +11,5 @@ export { handlePostExecutionTransition, } from './post-execution.js';
 export { validateCommits, tryValidateCommits, } from '../execution/commit-validation.js';
 export { WorkflowRuleEvaluator, initWorkflowRuleEvaluator, stopWorkflowRuleEvaluator, } from './rule-evaluator.js';
 export { ActionChainingHandler, initActionChaining, stopActionChaining, } from './action-chaining.js';
+export { ContainerCleanupHook, initContainerCleanupHook, stopContainerCleanupHook, } from './container-cleanup-hook.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/work-lifecycle/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,6BAA6B,GAG9B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,eAAe,EACf,kBAAkB,GAEnB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/work-lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,6BAA6B,GAG9B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,eAAe,EACf,kBAAkB,GAEnB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,6BAA6B,CAAA"}