pm-orchestrator-runner 1.0.0

package/dist/executor/deterministic-executor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Deterministic Executor for CLI_TEST_MODE
+ *
+ * Per spec 10_REPL_UX.md Section 11 and spec 06_CORRECTNESS_PROPERTIES.md Property 37:
+ * When CLI_TEST_MODE=1, use deterministic stub instead of Claude Code CLI.
+ *
+ * This executor:
+ * - Parses natural language prompts for file creation patterns
+ * - Creates actual files on disk (verified_files exists=true)
+ * - Performs filesBefore/filesAfter 2-scan (Property 31)
+ * - Returns immediately without spawning subprocess
+ */
+import type { IExecutor, ExecutorTask, ExecutorResult } from './claude-code-executor';
+/**
+ * DeterministicExecutor - For CLI_TEST_MODE=1
+ *
+ * Creates actual files on disk without spawning Claude Code CLI.
+ * Performs proper filesBefore/filesAfter 2-scan per Property 31.
+ */
+export declare class DeterministicExecutor implements IExecutor {
+    isClaudeCodeAvailable(): Promise<boolean>;
+    execute(task: ExecutorTask): Promise<ExecutorResult>;
+    /**
+     * List all files in a directory (recursively)
+     */
+    private listFiles;
+    /**
+     * Detect files that were modified or created
+     */
+    private detectModifiedFiles;
+}
+/**
+ * Check if deterministic mode is enabled
+ */
+export declare function isDeterministicMode(): boolean;
+/**
+ * Create appropriate executor based on environment
+ */
+export declare function createExecutorForEnvironment(): IExecutor | null;
+//# sourceMappingURL=deterministic-executor.d.ts.map

package/dist/executor/deterministic-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-executor.d.ts","sourceRoot":"","sources":["../../src/executor/deterministic-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EAEf,MAAM,wBAAwB,CAAC;AA8DhC;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,SAAS;IAC/C,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IA0F1D;;OAEG;YACW,SAAS;IAsCvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAwB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,SAAS,GAAG,IAAI,CAK/D"}

package/dist/executor/deterministic-executor.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Deterministic Executor for CLI_TEST_MODE
+ *
+ * Per spec 10_REPL_UX.md Section 11 and spec 06_CORRECTNESS_PROPERTIES.md Property 37:
+ * When CLI_TEST_MODE=1, use deterministic stub instead of Claude Code CLI.
+ *
+ * This executor:
+ * - Parses natural language prompts for file creation patterns
+ * - Creates actual files on disk (verified_files exists=true)
+ * - Performs filesBefore/filesAfter 2-scan (Property 31)
+ * - Returns immediately without spawning subprocess
+ */
+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.DeterministicExecutor = void 0;
+exports.isDeterministicMode = isDeterministicMode;
+exports.createExecutorForEnvironment = createExecutorForEnvironment;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * File creation patterns detected from natural language
+ */
+const FILE_CREATION_PATTERNS = [
+    // README patterns
+    /readme/i,
+    /create\s+readme/i,
+    /作.*readme/i,
+    // General file creation
+    /create\s+(?:a\s+)?(?:file\s+)?(?:named?\s+)?(\S+\.\w+)/i,
+    /make\s+(?:a\s+)?(?:file\s+)?(?:named?\s+)?(\S+\.\w+)/i,
+    /write\s+(?:a\s+)?(?:file\s+)?(?:named?\s+)?(\S+\.\w+)/i,
+    /生成\s*(\S+\.\w+)/i,
+    /作成\s*(\S+\.\w+)/i,
+];
+/**
+ * Extract filename from prompt
+ */
+function extractFilename(prompt) {
+    const lowerPrompt = prompt.toLowerCase();
+    // README detection
+    if (lowerPrompt.includes('readme')) {
+        return 'README.md';
+    }
+    // Generic file pattern matching
+    for (const pattern of FILE_CREATION_PATTERNS) {
+        const match = prompt.match(pattern);
+        if (match && match[1]) {
+            return match[1];
+        }
+    }
+    return null;
+}
+/**
+ * Generate default content based on filename
+ */
+function generateContent(filename, prompt) {
+    const basename = path.basename(filename, path.extname(filename));
+    const ext = path.extname(filename).toLowerCase();
+    switch (ext) {
+        case '.md':
+            return `# ${basename}\n\nGenerated by deterministic executor.\n\nTask: ${prompt}\n`;
+        case '.json':
+            return JSON.stringify({ name: basename, generated: true }, null, 2);
+        case '.txt':
+            return `${basename}\n\nGenerated by deterministic executor.\nTask: ${prompt}\n`;
+        case '.ts':
+        case '.js':
+            return `// ${basename}\n// Generated by deterministic executor\n\nexport const generated = true;\n`;
+        default:
+            return `Generated file: ${filename}\nTask: ${prompt}\n`;
+    }
+}
+/**
+ * DeterministicExecutor - For CLI_TEST_MODE=1
+ *
+ * Creates actual files on disk without spawning Claude Code CLI.
+ * Performs proper filesBefore/filesAfter 2-scan per Property 31.
+ */
+class DeterministicExecutor {
+    async isClaudeCodeAvailable() {
+        // In deterministic mode, we don't need Claude Code CLI
+        return true;
+    }
+    async execute(task) {
+        const startTime = Date.now();
+        const cwd = task.workingDir;
+        // Step 1: filesBefore scan (Property 31)
+        const filesBefore = await this.listFiles(cwd);
+        // Step 2: Detect file creation from prompt
+        const filename = extractFilename(task.prompt);
+        // Step 3: Create file if detected
+        const filesCreated = [];
+        if (filename) {
+            const fullPath = path.join(cwd, filename);
+            const content = generateContent(filename, task.prompt);
+            // Ensure parent directory exists
+            const dir = path.dirname(fullPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // Write file
+            fs.writeFileSync(fullPath, content, 'utf-8');
+            filesCreated.push(filename);
+        }
+        // Step 4: filesAfter scan (Property 31)
+        const filesAfter = await this.listFiles(cwd);
+        // Step 5: Detect modified/created files via diff
+        const files_modified = this.detectModifiedFiles(filesBefore, filesAfter, cwd);
+        // Step 6: Build verified_files with actual disk verification
+        const verified_files = [];
+        const detectedAt = new Date().toISOString();
+        // Verify all detected files
+        for (const relPath of files_modified) {
+            const fullPath = path.join(cwd, relPath);
+            try {
+                if (fs.existsSync(fullPath)) {
+                    const stat = fs.statSync(fullPath);
+                    let content_preview;
+                    if (stat.size < 10000) {
+                        try {
+                            const content = fs.readFileSync(fullPath, 'utf-8');
+                            content_preview = content.substring(0, 100);
+                        }
+                        catch {
+                            // Binary or encoding issue
+                        }
+                    }
+                    verified_files.push({
+                        path: relPath,
+                        exists: true,
+                        size: stat.size,
+                        content_preview,
+                    });
+                }
+            }
+            catch {
+                // File access error - skip
+            }
+        }
+        // Step 7: Determine status
+        const hasVerifiedFiles = verified_files.some((vf) => vf.exists);
+        let status = hasVerifiedFiles ? 'COMPLETE' : 'NO_EVIDENCE';
+        // If no file creation was detected but prompt was processed, still mark as complete
+        if (!filename && !hasVerifiedFiles) {
+            // No file creation detected - informational response only
+            status = 'COMPLETE';
+        }
+        const duration_ms = Date.now() - startTime;
+        return {
+            executed: true,
+            output: filename
+                ? `Created ${filename} successfully (deterministic mode)`
+                : 'No file creation detected in prompt (deterministic mode)',
+            files_modified,
+            duration_ms,
+            status,
+            cwd,
+            verified_files,
+            unverified_files: [],
+        };
+    }
+    /**
+     * List all files in a directory (recursively)
+     */
+    async listFiles(dir) {
+        const files = new Map();
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                // Skip hidden files and node_modules
+                if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+                    continue;
+                }
+                if (entry.isFile()) {
+                    try {
+                        const stat = fs.statSync(fullPath);
+                        files.set(fullPath, {
+                            mtime: stat.mtimeMs,
+                            size: stat.size,
+                        });
+                    }
+                    catch {
+                        // File may have been deleted during scan
+                    }
+                }
+                else if (entry.isDirectory()) {
+                    const subFiles = await this.listFiles(fullPath);
+                    for (const [key, value] of subFiles) {
+                        files.set(key, value);
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory may not exist or be inaccessible
+        }
+        return files;
+    }
+    /**
+     * Detect files that were modified or created
+     */
+    detectModifiedFiles(before, after, baseDir) {
+        const modified = [];
+        for (const [filePath, afterStat] of after) {
+            const beforeStat = before.get(filePath);
+            // New file
+            if (!beforeStat) {
+                modified.push(path.relative(baseDir, filePath));
+                continue;
+            }
+            // Modified file (mtime or size changed)
+            if (beforeStat.mtime !== afterStat.mtime || beforeStat.size !== afterStat.size) {
+                modified.push(path.relative(baseDir, filePath));
+            }
+        }
+        return modified;
+    }
+}
+exports.DeterministicExecutor = DeterministicExecutor;
+/**
+ * Check if deterministic mode is enabled
+ */
+function isDeterministicMode() {
+    return process.env.CLI_TEST_MODE === '1';
+}
+/**
+ * Create appropriate executor based on environment
+ */
+function createExecutorForEnvironment() {
+    if (isDeterministicMode()) {
+        return new DeterministicExecutor();
+    }
+    return null; // Let caller use default ClaudeCodeExecutor
+}
+//# sourceMappingURL=deterministic-executor.js.map

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

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

package/dist/lifecycle/lifecycle-controller.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Lifecycle Controller
+ * Based on 04_COMPONENTS.md L34-81
+ *
+ * Responsible for:
+ * - 7-phase lifecycle management
+ * - Phase transitions with gate validation
+ * - Fail-closed behavior
+ * - Overall status determination
+ * - Event emission (observable pattern)
+ * - State persistence
+ * - Parallel execution control
+ * - Error recovery with retry
+ */
+import { EventEmitter } from 'events';
+import { LifecyclePhase, PhaseStatus, OverallStatus, TaskStatus } from '../models/enums';
+import { ErrorCode } from '../errors/error-codes';
+/**
+ * Lifecycle Controller Error
+ */
+export declare class LifecycleError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>);
+}
+/**
+ * Phase completion input
+ */
+interface PhaseCompletionInput {
+    evidence: Record<string, unknown> | null;
+    status: PhaseStatus;
+}
+/**
+ * Phase info
+ */
+interface PhaseInfo {
+    phase: LifecyclePhase;
+    status: PhaseStatus;
+    started_at?: string;
+    completed_at?: string;
+    duration_seconds: number;
+    retry_count: number;
+    evidence?: Record<string, unknown>;
+}
+/**
+ * Gate validation result
+ */
+interface GateResult {
+    passed: boolean;
+    failures: string[];
+}
+/**
+ * Task update input
+ */
+interface TaskUpdate {
+    task_id: string;
+    status: TaskStatus;
+    started_at?: string;
+    completed_at?: string;
+    evidence?: Record<string, unknown>;
+}
+/**
+ * Task info
+ */
+interface TaskInfo {
+    task_id: string;
+    status: TaskStatus;
+    started_at?: string;
+    completed_at?: string;
+    evidence?: Record<string, unknown>;
+}
+/**
+ * Parallel task completion input
+ */
+interface ParallelTaskCompletion {
+    status: TaskStatus;
+    evidence: Record<string, unknown>;
+}
+/**
+ * Parallel execution info
+ */
+interface ParallelExecutionInfo {
+    active_count: number;
+    active_tasks: string[];
+    max_parallel: number;
+}
+/**
+ * Final report structure
+ */
+interface FinalReport {
+    session_id: string;
+    phases: Array<{
+        name: string;
+        status: PhaseStatus;
+        started_at?: string;
+        completed_at?: string;
+        duration_seconds: number;
+    }>;
+    overall_status: OverallStatus;
+    completed_at: string;
+}
+/**
+ * Serialized lifecycle state
+ */
+interface SerializedState {
+    session_id: string;
+    current_phase: LifecyclePhase;
+    phases: Record<string, PhaseInfo>;
+    overall_status: OverallStatus;
+    tasks: Record<string, TaskInfo>;
+    parallel_tasks: string[];
+    status_flags: {
+        is_error: boolean;
+        is_incomplete: boolean;
+        is_no_evidence: boolean;
+        is_invalid: boolean;
+    };
+}
+/**
+ * Lifecycle Controller class
+ */
+export declare class LifecycleController extends EventEmitter {
+    private sessionId;
+    private currentPhase;
+    private phases;
+    private tasks;
+    private registeredTasks;
+    private parallelTasks;
+    private phaseTimeouts;
+    private phaseStartTimes;
+    private executorLimit;
+    private maxRetries;
+    private isError;
+    private isIncomplete;
+    private isNoEvidence;
+    private isInvalid;
+    private isCompleted;
+    /**
+     * Create a new LifecycleController
+     */
+    constructor();
+    /**
+     * Get all lifecycle phases
+     */
+    getAllPhases(): LifecyclePhase[];
+    /**
+     * Initialize the lifecycle with a session ID
+     */
+    initialize(sessionId: string): void;
+    /**
+     * Get current phase
+     */
+    getCurrentPhase(): LifecyclePhase;
+    /**
+     * Get phase status
+     */
+    getPhaseStatus(phase: LifecyclePhase): PhaseStatus;
+    /**
+     * Get phase info
+     */
+    getPhaseInfo(phase: LifecyclePhase): PhaseInfo;
+    /**
+     * Complete current phase and transition to next
+     * @throws LifecycleError if evidence is missing or invalid
+     */
+    completeCurrentPhase(input: PhaseCompletionInput): void;
+    /**
+     * Transition to a specific phase
+     * @throws LifecycleError if transition is invalid
+     */
+    transitionTo(targetPhase: LifecyclePhase): void;
+    /**
+     * Validate gate conditions for a phase
+     */
+    validateGate(phase: LifecyclePhase, input: {
+        evidence: Record<string, unknown>;
+    }): GateResult;
+    /**
+     * Handle critical error
+     */
+    handleCriticalError(error: Error): void;
+    /**
+     * Handle recoverable error (with retry)
+     * @throws LifecycleError if max retries exceeded
+     */
+    handleRecoverableError(phase: LifecyclePhase, error: Error): void;
+    /**
+     * Set max retries for recoverable errors
+     */
+    setMaxRetries(count: number): void;
+    /**
+     * Get overall status
+     */
+    getOverallStatus(): OverallStatus;
+    /**
+     * Check if lifecycle is complete
+     */
+    isComplete(): boolean;
+    /**
+     * Mark lifecycle as incomplete
+     */
+    markIncomplete(reason: string): void;
+    /**
+     * Mark lifecycle as no evidence
+     */
+    markNoEvidence(reason: string): void;
+    /**
+     * Mark lifecycle as invalid
+     */
+    markInvalid(reason: string): void;
+    /**
+     * Update task status (for EXECUTION phase)
+     */
+    updateTaskStatus(update: TaskUpdate): void;
+    /**
+     * Get task info
+     */
+    getTaskInfo(taskId: string): TaskInfo;
+    /**
+     * Get incomplete tasks
+     */
+    private getIncompleteTasks;
+    /**
+     * Generate final report
+     */
+    generateFinalReport(): FinalReport;
+    /**
+     * Set phase timeout
+     */
+    setPhaseTimeout(phase: LifecyclePhase, seconds: number): void;
+    /**
+     * Set phase start time (for testing)
+     */
+    setPhaseStartTimeForTesting(phase: LifecyclePhase, timestamp: number): void;
+    /**
+     * Check if phase is timed out
+     */
+    isPhaseTimedOut(phase: LifecyclePhase): boolean;
+    /**
+     * Check and handle timeout
+     */
+    checkAndHandleTimeout(): void;
+    /**
+     * Start parallel tasks
+     */
+    startParallelTasks(taskIds: string[]): void;
+    /**
+     * Start a single parallel task
+     * @throws LifecycleError if executor limit exceeded
+     */
+    startParallelTask(taskId: string): void;
+    /**
+     * Complete a parallel task
+     */
+    completeParallelTask(taskId: string, completion: ParallelTaskCompletion): void;
+    /**
+     * Get parallel execution info
+     */
+    getParallelExecutionInfo(): ParallelExecutionInfo;
+    /**
+     * Serialize lifecycle state
+     */
+    serialize(): SerializedState;
+    /**
+     * Deserialize lifecycle state
+     */
+    static deserialize(state: SerializedState): LifecycleController;
+}
+export {};
+//# sourceMappingURL=lifecycle-controller.d.ts.map

package/dist/lifecycle/lifecycle-controller.d.ts.map

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