pm-orchestrator-runner 1.0.0

package/dist/supervisor/executor-supervisor.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * Executor Supervisor
+ * Monitors task execution and handles retries/timeouts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutorSupervisor = void 0;
+const events_1 = require("events");
+const enums_1 = require("../models/enums");
+/**
+ * Executor Supervisor class
+ * Monitors L2 executor and handles automatic retries
+ */
+class ExecutorSupervisor extends events_1.EventEmitter {
+    runner;
+    config;
+    state;
+    checkInterval = null;
+    timeoutTimer = null;
+    constructor(runner, config) {
+        super();
+        this.runner = runner;
+        this.config = {
+            checkIntervalMs: config.checkIntervalMs || 5000,
+            maxRetries: config.maxRetries || 3,
+            timeoutMs: config.timeoutMs || 300000, // 5 minutes default
+            autoRetry: config.autoRetry ?? true,
+        };
+        this.state = {
+            isRunning: false,
+            retryCount: 0,
+            startTime: null,
+            lastCheckTime: null,
+            currentTaskId: null,
+        };
+    }
+    /**
+     * Start monitoring
+     */
+    start() {
+        if (this.state.isRunning) {
+            return;
+        }
+        this.state.isRunning = true;
+        this.state.startTime = Date.now();
+        this.state.retryCount = 0;
+        // Start periodic check
+        this.checkInterval = setInterval(() => {
+            this.check();
+        }, this.config.checkIntervalMs);
+        // Start timeout timer
+        this.timeoutTimer = setTimeout(() => {
+            this.handleTimeout();
+        }, this.config.timeoutMs);
+        this.emit('started', { startTime: this.state.startTime });
+    }
+    /**
+     * Stop monitoring
+     */
+    stop() {
+        if (!this.state.isRunning) {
+            return;
+        }
+        this.state.isRunning = false;
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+        if (this.timeoutTimer) {
+            clearTimeout(this.timeoutTimer);
+            this.timeoutTimer = null;
+        }
+        this.emit('stopped', {
+            duration: this.state.startTime ? Date.now() - this.state.startTime : 0,
+            retryCount: this.state.retryCount,
+        });
+    }
+    /**
+     * Periodic check
+     */
+    async check() {
+        if (!this.state.isRunning) {
+            return;
+        }
+        this.state.lastCheckTime = Date.now();
+        try {
+            const sessionState = this.runner.getSessionState();
+            const overallStatus = this.runner.getOverallStatus();
+            const taskResults = this.runner.getTaskResults();
+            if (!sessionState || !sessionState.session_id) {
+                this.emit('check', { status: 'no_state' });
+                return;
+            }
+            this.emit('check', {
+                status: overallStatus,
+                phase: sessionState.current_phase,
+                tasksCompleted: taskResults?.filter((t) => t.status === 'completed').length || 0,
+                tasksTotal: taskResults?.length || 0,
+            });
+            // Handle different statuses
+            switch (overallStatus) {
+                case enums_1.OverallStatus.COMPLETE:
+                    this.handleComplete();
+                    break;
+                case enums_1.OverallStatus.ERROR:
+                    await this.handleError();
+                    break;
+                case enums_1.OverallStatus.INCOMPLETE:
+                    // Still running, continue monitoring
+                    break;
+                case enums_1.OverallStatus.NO_EVIDENCE:
+                    await this.handleNoEvidence();
+                    break;
+                case enums_1.OverallStatus.INVALID:
+                    await this.handleInvalid();
+                    break;
+            }
+        }
+        catch (err) {
+            this.emit('error', { error: err.message });
+        }
+    }
+    /**
+     * Handle complete status
+     */
+    handleComplete() {
+        this.emit('complete', {
+            duration: this.state.startTime ? Date.now() - this.state.startTime : 0,
+            retryCount: this.state.retryCount,
+        });
+        this.stop();
+    }
+    /**
+     * Handle error status
+     */
+    async handleError() {
+        if (!this.config.autoRetry) {
+            this.emit('error', { reason: 'Task failed, auto-retry disabled' });
+            this.stop();
+            return;
+        }
+        if (this.state.retryCount >= this.config.maxRetries) {
+            this.emit('max_retries', {
+                retryCount: this.state.retryCount,
+                maxRetries: this.config.maxRetries,
+            });
+            this.stop();
+            return;
+        }
+        // Attempt retry
+        this.state.retryCount++;
+        this.emit('retry', {
+            attempt: this.state.retryCount,
+            maxRetries: this.config.maxRetries,
+        });
+        try {
+            // Retry by resuming execution
+            // The runner should handle retry logic internally
+            const sessionState = this.runner.getSessionState();
+            if (sessionState && sessionState.session_id) {
+                await this.runner.resume(sessionState.session_id);
+            }
+        }
+        catch (err) {
+            this.emit('retry_failed', { error: err.message });
+        }
+    }
+    /**
+     * Handle no evidence status
+     */
+    async handleNoEvidence() {
+        this.emit('no_evidence', {
+            message: 'Task completed without evidence',
+        });
+        // Don't stop - wait for evidence to be collected
+    }
+    /**
+     * Handle invalid status
+     */
+    async handleInvalid() {
+        this.emit('invalid', {
+            message: 'Task state is invalid',
+        });
+        this.stop();
+    }
+    /**
+     * Handle timeout
+     */
+    handleTimeout() {
+        this.emit('timeout', {
+            duration: this.state.startTime ? Date.now() - this.state.startTime : 0,
+            retryCount: this.state.retryCount,
+            status: enums_1.OverallStatus.INCOMPLETE,
+        });
+        this.stop();
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Check if running
+     */
+    isRunning() {
+        return this.state.isRunning;
+    }
+}
+exports.ExecutorSupervisor = ExecutorSupervisor;
+//# sourceMappingURL=executor-supervisor.js.map

package/dist/supervisor/executor-supervisor.js.map

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

package/dist/supervisor/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Supervisor Module Index
+ */
+export { ExecutorSupervisor, SupervisorConfig, SupervisorState } from './executor-supervisor';
+//# sourceMappingURL=index.d.ts.map

package/dist/supervisor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/supervisor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/supervisor/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Supervisor Module Index
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutorSupervisor = void 0;
+var executor_supervisor_1 = require("./executor-supervisor");
+Object.defineProperty(exports, "ExecutorSupervisor", { enumerable: true, get: function () { return executor_supervisor_1.ExecutorSupervisor; } });
+//# sourceMappingURL=index.js.map

package/dist/supervisor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/supervisor/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6DAA8F;AAArF,yHAAA,kBAAkB,OAAA"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "pm-orchestrator-runner",
+  "version": "1.0.0",
+  "description": "CLI tool that enforces controlled execution of Claude Code through mandatory orchestration",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "pm": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "mocha --require ts-node/register 'test/**/*.test.ts'",
+    "test:unit": "mocha --require ts-node/register 'test/unit/**/*.test.ts'",
+    "test:property": "mocha --require ts-node/register 'test/property/**/*.test.ts'",
+    "test:integration": "mocha --require ts-node/register 'test/integration/**/*.test.ts'",
+    "coverage": "nyc npm test",
+    "lint": "eslint src/**/*.ts test/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "llm:sentinel": "ts-node src/cli/llm-sentinel.ts",
+    "llm:test:real": "LLM_TEST_MODE=1 mocha --require ts-node/register 'test/integration/real-llm-mediation.test.ts' 'test/integration/verdict-gate-open.test.ts'",
+    "llm:test:verdict": "mocha --require ts-node/register 'test/unit/mediation/verdict-reporter.test.ts'"
+  },
+  "keywords": [
+    "pm-orchestrator",
+    "claude-code",
+    "runner"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/minimatch": "^5.1.2",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^20.10.0",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "chai": "^6.2.2",
+    "eslint": "^8.55.0",
+    "fast-check": "^3.15.0",
+    "mocha": "^10.2.0",
+    "nyc": "^15.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.2"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "yaml": "^2.8.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}