pm-orchestrator-runner 1.0.0

package/dist/config/configuration-manager.js

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * Configuration Manager
+ * Based on 04_COMPONENTS.md L52-82
+ *
+ * Responsible for:
+ * - Loading and validating project configuration
+ * - Enforcing configuration schema
+ * - Applying default values
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationManager = exports.ConfigurationError = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const error_codes_1 = require("../errors/error-codes");
+/**
+ * Configuration error
+ */
+class ConfigurationError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message || (0, error_codes_1.getErrorMessage)(code));
+        this.name = 'ConfigurationError';
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+/**
+ * Default configuration values
+ */
+const DEFAULTS = {
+    task_limits: {
+        files: 5,
+        tests: 10,
+        seconds: 300,
+    },
+    parallel_limits: {
+        subagents: 9,
+        executors: 4,
+    },
+    timeouts: {
+        deadlock_timeout_seconds: 60,
+        operation_timeout_seconds: 120,
+    },
+    evidence_settings: {
+        retention_days: 30,
+        compression_enabled: true,
+    },
+};
+/**
+ * Validation ranges
+ */
+const RANGES = {
+    task_limits: {
+        files: { min: 1, max: 20 },
+        tests: { min: 1, max: 50 },
+        seconds: { min: 30, max: 900 },
+    },
+    parallel_limits: {
+        subagents: { min: 1, max: 9 },
+        executors: { min: 1, max: 4 },
+    },
+};
+/**
+ * Configuration Manager class
+ */
+class ConfigurationManager {
+    /**
+     * Load configuration from project path
+     * @throws ConfigurationError if configuration is invalid
+     */
+    loadConfiguration(projectPath) {
+        // Validate project path exists
+        if (!fs.existsSync(projectPath)) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E102_INVALID_PROJECT_PATH, `Project path does not exist: ${projectPath}`, { projectPath });
+        }
+        // Check for .claude directory
+        const claudeDir = path.join(projectPath, '.claude');
+        if (!fs.existsSync(claudeDir)) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E101_MISSING_CLAUDE_DIRECTORY, `Missing .claude directory in project path: ${projectPath}`, { projectPath, expectedPath: claudeDir });
+        }
+        // Check required files and directories
+        this.validateRequiredStructure(claudeDir);
+        // Load and parse settings.json
+        const settingsPath = path.join(claudeDir, 'settings.json');
+        const rawSettings = this.loadSettingsJson(settingsPath);
+        // Validate and apply configuration
+        const config = this.buildConfiguration(rawSettings, projectPath, claudeDir);
+        return config;
+    }
+    /**
+     * Validate required project structure
+     */
+    validateRequiredStructure(claudeDir) {
+        const requiredFiles = ['CLAUDE.md', 'settings.json'];
+        const requiredDirs = ['agents', 'rules'];
+        for (const file of requiredFiles) {
+            const filePath = path.join(claudeDir, file);
+            if (!fs.existsSync(filePath)) {
+                throw new ConfigurationError(error_codes_1.ErrorCode.E103_CONFIGURATION_FILE_MISSING, `Missing required file: ${file} in .claude directory`, { missingFile: file, claudeDir });
+            }
+        }
+        for (const dir of requiredDirs) {
+            const dirPath = path.join(claudeDir, dir);
+            if (!fs.existsSync(dirPath)) {
+                throw new ConfigurationError(error_codes_1.ErrorCode.E103_CONFIGURATION_FILE_MISSING, `Missing required directory: ${dir} in .claude directory`, { missingDir: dir, claudeDir });
+            }
+        }
+    }
+    /**
+     * Load and parse settings.json
+     */
+    loadSettingsJson(settingsPath) {
+        try {
+            const content = fs.readFileSync(settingsPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw new ConfigurationError(error_codes_1.ErrorCode.E105_CRITICAL_CONFIGURATION_CORRUPTION, `Malformed JSON in settings.json: ${error.message}`, { settingsPath, parseError: error.message });
+            }
+            throw new ConfigurationError(error_codes_1.ErrorCode.E103_CONFIGURATION_FILE_MISSING, `Failed to read settings.json: ${error.message}`, { settingsPath });
+        }
+    }
+    /**
+     * Build and validate configuration
+     */
+    buildConfiguration(rawSettings, projectPath, claudeDir) {
+        // Apply defaults and merge with provided settings
+        const taskLimits = {
+            files: rawSettings.task_limits?.files ?? DEFAULTS.task_limits.files,
+            tests: rawSettings.task_limits?.tests ?? DEFAULTS.task_limits.tests,
+            seconds: rawSettings.task_limits?.seconds ?? DEFAULTS.task_limits.seconds,
+        };
+        const parallelLimits = {
+            subagents: rawSettings.parallel_limits?.subagents ?? DEFAULTS.parallel_limits.subagents,
+            executors: rawSettings.parallel_limits?.executors ?? DEFAULTS.parallel_limits.executors,
+        };
+        const timeouts = {
+            deadlock_timeout_seconds: rawSettings.timeouts?.deadlock_timeout_seconds ??
+                DEFAULTS.timeouts.deadlock_timeout_seconds,
+            operation_timeout_seconds: rawSettings.timeouts?.operation_timeout_seconds ??
+                DEFAULTS.timeouts.operation_timeout_seconds,
+        };
+        const evidenceSettings = {
+            retention_days: rawSettings.evidence_settings?.retention_days ??
+                DEFAULTS.evidence_settings.retention_days,
+            compression_enabled: rawSettings.evidence_settings?.compression_enabled ??
+                DEFAULTS.evidence_settings.compression_enabled,
+        };
+        // Validate ranges
+        this.validateTaskLimits(taskLimits);
+        this.validateParallelLimits(parallelLimits);
+        return {
+            task_limits: taskLimits,
+            parallel_limits: parallelLimits,
+            timeouts,
+            evidence_settings: evidenceSettings,
+            project_path: projectPath,
+            claude_dir: claudeDir,
+        };
+    }
+    /**
+     * Validate task limits are within range
+     */
+    validateTaskLimits(limits) {
+        const { files, tests, seconds } = limits;
+        const ranges = RANGES.task_limits;
+        if (files < ranges.files.min || files > ranges.files.max) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E104_CONFIGURATION_SCHEMA_VALIDATION_FAILURE, `task_limits.files must be between ${ranges.files.min} and ${ranges.files.max}, got ${files}`, { field: 'task_limits.files', value: files, range: ranges.files });
+        }
+        if (tests < ranges.tests.min || tests > ranges.tests.max) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E104_CONFIGURATION_SCHEMA_VALIDATION_FAILURE, `task_limits.tests must be between ${ranges.tests.min} and ${ranges.tests.max}, got ${tests}`, { field: 'task_limits.tests', value: tests, range: ranges.tests });
+        }
+        if (seconds < ranges.seconds.min || seconds > ranges.seconds.max) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E104_CONFIGURATION_SCHEMA_VALIDATION_FAILURE, `task_limits.seconds must be between ${ranges.seconds.min} and ${ranges.seconds.max}, got ${seconds}`, { field: 'task_limits.seconds', value: seconds, range: ranges.seconds });
+        }
+    }
+    /**
+     * Validate parallel limits are within range
+     */
+    validateParallelLimits(limits) {
+        const { subagents, executors } = limits;
+        const ranges = RANGES.parallel_limits;
+        if (subagents < ranges.subagents.min || subagents > ranges.subagents.max) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E104_CONFIGURATION_SCHEMA_VALIDATION_FAILURE, `parallel_limits.subagents must be between ${ranges.subagents.min} and ${ranges.subagents.max}, got ${subagents}`, { field: 'parallel_limits.subagents', value: subagents, range: ranges.subagents });
+        }
+        if (executors < ranges.executors.min || executors > ranges.executors.max) {
+            throw new ConfigurationError(error_codes_1.ErrorCode.E104_CONFIGURATION_SCHEMA_VALIDATION_FAILURE, `parallel_limits.executors must be between ${ranges.executors.min} and ${ranges.executors.max}, got ${executors}`, { field: 'parallel_limits.executors', value: executors, range: ranges.executors });
+        }
+    }
+    /**
+     * Get default configuration
+     */
+    getDefaults() {
+        return { ...DEFAULTS };
+    }
+    /**
+     * Get validation ranges
+     */
+    getRanges() {
+        return { ...RANGES };
+    }
+}
+exports.ConfigurationManager = ConfigurationManager;
+//# sourceMappingURL=configuration-manager.js.map

package/dist/config/configuration-manager.js.map

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

package/dist/continuation/continuation-control-manager.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Continuation Control Manager
+ * Based on 04_COMPONENTS.md L156-166
+ *
+ * Responsible for:
+ * - Automatic progression prevention
+ * - Explicit approval requirement
+ * - Continuation condition validation
+ * - Meaningless continuation rejection
+ * - next_action determination
+ */
+import { OverallStatus } from '../models/enums';
+import { ErrorCode } from '../errors/error-codes';
+/**
+ * Continuation Control Manager Error
+ */
+export declare class ContinuationControlError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>);
+}
+/**
+ * Session state interface for continuation checks
+ */
+interface SessionState {
+    session_id: string;
+    overall_status: OverallStatus;
+    tasks_completed: number;
+    tasks_total: number;
+    has_explicit_approval?: boolean;
+    evidence_valid?: boolean;
+    no_critical_errors?: boolean;
+    current_phase?: string;
+    remaining_work?: string[];
+    continuation_in_progress?: boolean;
+}
+/**
+ * Approval record interface
+ */
+interface ApprovalRecord {
+    session_id: string;
+    approved_by: string;
+    timestamp: string;
+}
+/**
+ * Validation result interface
+ */
+interface ValidationResult {
+    valid: boolean;
+    failed_conditions: string[];
+}
+/**
+ * Continuation request interface
+ */
+interface ContinuationRequest {
+    request_id: string;
+    session_id: string;
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    requested_at: string;
+    approved_at?: string;
+    rejection_reason?: string;
+}
+/**
+ * Next action determination interface
+ */
+interface NextAction {
+    next_action: boolean;
+    next_action_reason: string;
+}
+/**
+ * Incomplete task reason interface
+ */
+interface IncompleteTaskReason {
+    task_id: string;
+    reason: string;
+    timestamp: string;
+}
+/**
+ * Continuation Control Manager class
+ */
+export declare class ContinuationControlManager {
+    private requests;
+    private requestTimes;
+    private incompleteReasons;
+    private approvals;
+    /**
+     * Create a new ContinuationControlManager
+     */
+    constructor();
+    /**
+     * Check if continuation is allowed based on session state
+     */
+    canContinue(sessionState: SessionState): boolean;
+    /**
+     * Check if phase progression is allowed
+     */
+    canProgressPhase(sessionState: SessionState): boolean;
+    /**
+     * Check if approval is required
+     */
+    requiresApproval(sessionState: SessionState): boolean;
+    /**
+     * Record an approval
+     * @throws ContinuationControlError with E201 if session ID is missing
+     */
+    recordApproval(sessionId: string, approvedBy: string): ApprovalRecord;
+    /**
+     * Validate all continuation conditions
+     */
+    validateContinuationConditions(sessionState: SessionState): ValidationResult;
+    /**
+     * Request continuation
+     * @throws ContinuationControlError with E207 if continuation is meaningless
+     */
+    requestContinuation(sessionState: SessionState): void;
+    /**
+     * Create a continuation request
+     */
+    createContinuationRequest(sessionState: SessionState): ContinuationRequest;
+    /**
+     * Approve a continuation request
+     */
+    approveContinuationRequest(requestId: string): ContinuationRequest;
+    /**
+     * Reject a continuation request
+     */
+    rejectContinuationRequest(requestId: string, reason: string): ContinuationRequest;
+    /**
+     * Set request time for testing purposes
+     */
+    setRequestTimeForTesting(requestId: string, timestamp: number): void;
+    /**
+     * Expire old pending requests
+     */
+    expireOldRequests(timeoutMs: number): void;
+    /**
+     * Get a continuation request by ID
+     */
+    getContinuationRequest(requestId: string): ContinuationRequest;
+    /**
+     * Determine next action based on session state
+     */
+    determineNextAction(sessionState: SessionState): NextAction;
+    /**
+     * Record a reason for incomplete task
+     */
+    recordIncompleteReason(taskId: string, reason: string): void;
+    /**
+     * Get all incomplete task reasons
+     */
+    getIncompleteTaskReasons(): IncompleteTaskReason[];
+}
+export {};
+//# sourceMappingURL=continuation-control-manager.d.ts.map

package/dist/continuation/continuation-control-manager.d.ts.map

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