@vinaes/succ 1.3.19

package/dist/lib/prd/team-runner.js

@@ -0,0 +1,261 @@
+/**
+ * Team Runner — Parallel Task Execution
+ *
+ * Orchestrates concurrent Claude processes, each in an isolated git worktree.
+ * - Parallel dispatch with configurable concurrency limit
+ * - File conflict prevention via files_to_modify overlap check
+ * - Serial merge back to PRD branch after each task completes
+ * - Quality gates per task (run in the worktree)
+ * - Deadlock detection and critical task abort
+ */
+import { LoopExecutor, WSExecutor } from './executor.js';
+import { getClaudeMode } from '../llm.js';
+import { allDependenciesMet } from './scheduler.js';
+import { runAllGates, allRequiredPassed, formatGateResults } from './gates.js';
+import { gatherTaskContext } from './context.js';
+import { buildTaskPrompt } from './prompt-builder.js';
+import { WORKER_ALLOWED_TOOLS, buildMcpConfig } from './runner.js';
+import { saveTasks, savePrd, saveExecution, appendProgress, appendTaskLog, getTaskLogPath, } from './state.js';
+import { computeStats } from './types.js';
+import { createWorktree, mergeWorktreeChanges, removeWorktree, cleanupAllWorktrees, } from './worktree.js';
+// ============================================================================
+// Ready task selection
+// ============================================================================
+/**
+ * Get tasks that can be dispatched right now.
+ *
+ * A task is ready when:
+ * 1. status is 'pending'
+ * 2. all dependencies are met (completed/skipped)
+ * 3. no files_to_modify overlap with currently running tasks
+ * 4. hasn't exhausted max_attempts
+ */
+export function getReadyTasks(tasks, runningTasks) {
+    // Collect all files being modified by running tasks
+    const runningFiles = new Set();
+    for (const rt of runningTasks) {
+        for (const f of rt.task.files_to_modify) {
+            runningFiles.add(f);
+        }
+    }
+    return tasks.filter((task) => {
+        if (task.status !== 'pending')
+            return false;
+        if (!allDependenciesMet(task, tasks))
+            return false;
+        if (task.attempts.length >= task.max_attempts)
+            return false;
+        // File conflict check
+        if (runningFiles.size > 0 && task.files_to_modify.length > 0) {
+            const hasConflict = task.files_to_modify.some((f) => runningFiles.has(f));
+            if (hasConflict)
+                return false;
+        }
+        return true;
+    });
+}
+// ============================================================================
+// Main parallel dispatch loop
+// ============================================================================
+/**
+ * Run tasks in parallel with worktree isolation.
+ */
+export async function runTeam(tasks, options) {
+    const { concurrency, model, prdId, root, prd, execution } = options;
+    const running = [];
+    execution.concurrency = concurrency;
+    saveExecution(execution);
+    appendProgress(prdId, `Team mode — concurrency: ${concurrency}`);
+    console.log(`\n[team] Parallel execution — max ${concurrency} workers\n`);
+    try {
+        while (true) {
+            // Check if all done
+            const allDone = tasks.every((t) => t.status === 'completed' || t.status === 'skipped' || t.status === 'failed');
+            if (allDone)
+                break;
+            // Find and dispatch ready tasks
+            const ready = getReadyTasks(tasks, running);
+            const slotsAvailable = concurrency - running.length;
+            const toDispatch = ready.slice(0, slotsAvailable);
+            for (const task of toDispatch) {
+                const rt = dispatchTask(task, prd, execution, model, root, prdId);
+                running.push(rt);
+            }
+            // Deadlock: nothing running, nothing ready, but tasks remain
+            if (running.length === 0 && toDispatch.length === 0) {
+                const pending = tasks.filter((t) => t.status === 'pending');
+                if (pending.length === 0)
+                    break;
+                // Skip tasks with failed dependencies
+                let skipped = false;
+                for (const t of pending) {
+                    const hasFailedDep = t.depends_on.some((depId) => {
+                        const dep = tasks.find((d) => d.id === depId);
+                        return dep && dep.status === 'failed';
+                    });
+                    if (hasFailedDep) {
+                        t.status = 'skipped';
+                        t.updated_at = new Date().toISOString();
+                        appendProgress(prdId, `Skipped ${t.id} "${t.title}" — dependency failed`);
+                        console.log(`  [-] Skipping ${t.id}: dependency failed`);
+                        skipped = true;
+                    }
+                }
+                if (skipped)
+                    continue; // Re-evaluate after skipping
+                // True deadlock: pending tasks exist but none can start
+                appendProgress(prdId, `DEADLOCK: ${pending.length} tasks cannot proceed`);
+                console.log(`\n[!] Deadlock: ${pending.length} tasks stuck`);
+                break;
+            }
+            // Wait for any worker to complete
+            if (running.length > 0) {
+                const { completed, index } = await raceWorkers(running);
+                running.splice(index, 1);
+                // Handle completion (serial: one at a time)
+                await handleTaskCompletion(completed, tasks, prd, execution, root, prdId);
+                // Save state after each completion
+                saveTasks(prdId, tasks);
+                prd.stats = computeStats(tasks);
+                savePrd(prd);
+                // Critical task failure: abort all running workers
+                if (completed.task.status === 'failed' && completed.task.priority === 'critical') {
+                    appendProgress(prdId, `PAUSED — critical task ${completed.task.id} failed`);
+                    console.log(`\n[!] Critical task ${completed.task.id} failed. Aborting.`);
+                    for (const rt of running) {
+                        rt.executor.abort();
+                        removeWorktree(rt.task.id, root);
+                        rt.task.status = 'pending';
+                        rt.task.updated_at = new Date().toISOString();
+                    }
+                    running.length = 0;
+                    break;
+                }
+            }
+        }
+    }
+    finally {
+        // Clean up any remaining worktrees
+        for (const rt of running) {
+            rt.executor.abort();
+            removeWorktree(rt.task.id, root);
+        }
+        cleanupAllWorktrees(root);
+    }
+}
+// ============================================================================
+// Dispatch a single task to a worker
+// ============================================================================
+function dispatchTask(task, prd, execution, model, root, prdId) {
+    console.log(`  [>] Dispatching ${task.id}: ${task.title}`);
+    task.status = 'in_progress';
+    task.updated_at = new Date().toISOString();
+    appendProgress(prdId, `Dispatched ${task.id} "${task.title}"`);
+    // Create isolated worktree
+    const wt = createWorktree(task.id, execution.branch, root);
+    // Create attempt record
+    const taskAttempt = {
+        attempt_number: task.attempts.length + 1,
+        started_at: new Date().toISOString(),
+        completed_at: null,
+        status: 'running',
+        gate_results: [],
+        files_actually_modified: [],
+        memories_recalled: 0,
+        memories_created: 0,
+        dead_ends_recorded: 0,
+        error: null,
+        output_log: getTaskLogPath(prdId, task.id),
+    };
+    task.attempts.push(taskAttempt);
+    // Spawn executor — context gathering happens synchronously before spawn
+    const executor = getClaudeMode() === 'ws' ? new WSExecutor() : new LoopExecutor();
+    // Build a promise that gathers context, builds prompt, then executes
+    const promise = (async () => {
+        const context = await gatherTaskContext(task, prdId);
+        const prompt = buildTaskPrompt(task, prd, context);
+        const executeOptions = {
+            cwd: wt.path, // worker runs in its own worktree
+            timeout_ms: 900_000, // 15 minutes
+            model,
+            permissionMode: 'acceptEdits',
+            allowedTools: WORKER_ALLOWED_TOOLS,
+            mcpConfig: buildMcpConfig(),
+            onOutput: (chunk) => appendTaskLog(prdId, task.id, chunk),
+        };
+        const result = await executor.execute(prompt, executeOptions);
+        return { task, result, worktreePath: wt.path };
+    })();
+    return { task, executor, promise, worktreePath: wt.path };
+}
+// ============================================================================
+// Handle task completion
+// ============================================================================
+async function handleTaskCompletion(completed, allTasks, prd, _execution, root, prdId) {
+    const { task, result, worktreePath } = completed;
+    const attempt = task.attempts[task.attempts.length - 1];
+    attempt.completed_at = new Date().toISOString();
+    // Check BLOCKED response
+    if (result.output.includes('BLOCKED:')) {
+        attempt.status = 'failed';
+        attempt.error = result.output.match(/BLOCKED:(.*)/)?.[1]?.trim() ?? 'Agent reported blocked';
+        console.log(`  [x] ${task.id} BLOCKED: ${attempt.error}`);
+        appendProgress(prdId, `${task.id} BLOCKED: ${attempt.error}`);
+        task.status = 'failed';
+        removeWorktree(task.id, root);
+        return;
+    }
+    if (!result.success) {
+        attempt.status = 'failed';
+        attempt.error = `Exit code: ${result.exit_code}`;
+        console.log(`  [x] ${task.id} failed (exit ${result.exit_code})`);
+        appendProgress(prdId, `${task.id} failed (exit ${result.exit_code})`);
+        task.status = task.attempts.length >= task.max_attempts ? 'failed' : 'pending';
+        removeWorktree(task.id, root);
+        return;
+    }
+    // Run quality gates in the worktree
+    if (prd.quality_gates.length > 0) {
+        console.log(`  [~] ${task.id}: running quality gates...`);
+        const gateResults = runAllGates(prd.quality_gates, worktreePath);
+        attempt.gate_results = gateResults;
+        if (!allRequiredPassed(gateResults)) {
+            attempt.status = 'failed';
+            const failedGates = gateResults.filter((r) => !r.passed && r.gate.required);
+            attempt.error = `Gates failed: ${failedGates.map((r) => r.gate.type).join(', ')}`;
+            console.log(`  [x] ${task.id} gates failed:\n${formatGateResults(gateResults)}`);
+            appendProgress(prdId, `${task.id} gates failed: ${attempt.error}`);
+            task.status = task.attempts.length >= task.max_attempts ? 'failed' : 'pending';
+            removeWorktree(task.id, root);
+            return;
+        }
+        console.log(`  [+] ${task.id}: all gates passed`);
+    }
+    // Merge worktree changes back to PRD branch
+    const commitMsg = `prd(${prdId}): ${task.id} — ${task.title}`;
+    const merge = mergeWorktreeChanges(worktreePath, root, commitMsg);
+    if (merge.success) {
+        attempt.status = 'passed';
+        task.status = 'completed';
+        task.updated_at = new Date().toISOString();
+        console.log(`  [+] ${task.id} completed and merged`);
+        appendProgress(prdId, `Completed ${task.id} "${task.title}"`);
+    }
+    else {
+        // Merge conflict — task needs retry
+        attempt.status = 'failed';
+        attempt.error = `Merge conflict: ${merge.conflictFiles?.join(', ') ?? 'unknown'}`;
+        console.log(`  [x] ${task.id} merge conflict: ${attempt.error}`);
+        appendProgress(prdId, `${task.id} merge conflict: ${attempt.error}`);
+        task.status = task.attempts.length >= task.max_attempts ? 'failed' : 'pending';
+    }
+    removeWorktree(task.id, root);
+}
+// ============================================================================
+// Promise.race with index tracking
+// ============================================================================
+async function raceWorkers(running) {
+    const indexed = running.map((rt, i) => rt.promise.then((result) => ({ completed: result, index: i })));
+    return Promise.race(indexed);
+}
+//# sourceMappingURL=team-runner.js.map

package/dist/lib/prd/team-runner.js.map

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

package/dist/lib/prd/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * PRD-to-Task Pipeline — Type Definitions
+ *
+ * Core types for the PRD pipeline: generate PRD → parse into tasks → execute.
+ * Inspired by Ralph (iterative loop), Anthropic best practices (git commits,
+ * quality gates), and Claude Code Teams protocol.
+ */
+export type PrdStatus = 'draft' | 'ready' | 'in_progress' | 'completed' | 'archived' | 'failed';
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+export type ExecutionMode = 'loop' | 'team';
+export type GateType = 'typecheck' | 'test' | 'lint' | 'build' | 'custom';
+export interface Prd {
+    id: string;
+    version: number;
+    title: string;
+    description: string;
+    status: PrdStatus;
+    execution_mode: ExecutionMode;
+    source_file: string;
+    goals: string[];
+    out_of_scope: string[];
+    quality_gates: QualityGate[];
+    created_at: string;
+    updated_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+    stats: PrdStats;
+}
+export interface PrdStats {
+    total_tasks: number;
+    completed_tasks: number;
+    failed_tasks: number;
+    skipped_tasks: number;
+    total_attempts: number;
+    total_duration_ms: number;
+}
+export interface Task {
+    id: string;
+    prd_id: string;
+    sequence: number;
+    title: string;
+    description: string;
+    status: TaskStatus;
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    depends_on: string[];
+    acceptance_criteria: string[];
+    files_to_modify: string[];
+    relevant_files: string[];
+    context_queries: string[];
+    attempts: TaskAttempt[];
+    max_attempts: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface TaskAttempt {
+    attempt_number: number;
+    started_at: string;
+    completed_at: string | null;
+    status: 'running' | 'passed' | 'failed';
+    gate_results: GateResult[];
+    files_actually_modified: string[];
+    memories_recalled: number;
+    memories_created: number;
+    dead_ends_recorded: number;
+    error: string | null;
+    output_log: string;
+}
+export interface GateResult {
+    gate: QualityGate;
+    passed: boolean;
+    output: string;
+    duration_ms: number;
+}
+export interface QualityGate {
+    type: GateType;
+    command: string;
+    required: boolean;
+    timeout_ms: number;
+}
+export interface PrdExecution {
+    prd_id: string;
+    mode: ExecutionMode;
+    branch: string;
+    original_branch: string;
+    started_at: string;
+    current_task_id: string | null;
+    iteration: number;
+    max_iterations: number;
+    pid: number | null;
+    team_name: string | null;
+    concurrency: number | null;
+    log_file: string;
+}
+export interface PrdIndexEntry {
+    id: string;
+    title: string;
+    status: PrdStatus;
+    execution_mode: ExecutionMode;
+    created_at: string;
+    updated_at: string;
+}
+export interface CodebaseContext {
+    file_tree: string;
+    code_search_results: string;
+    memories: string;
+    brain_docs: string;
+}
+/**
+ * Generate a unique PRD ID: "prd_" + 8 hex chars
+ */
+export declare function generatePrdId(): string;
+/**
+ * Generate a task ID: "task_001", "task_002", etc.
+ */
+export declare function generateTaskId(sequence: number): string;
+/**
+ * Create an empty PrdStats object
+ */
+export declare function emptyPrdStats(): PrdStats;
+/**
+ * Create a default QualityGate
+ */
+export declare function createGate(type: GateType, command: string, required?: boolean, timeout_ms?: number): QualityGate;
+/**
+ * Create a new Prd object with defaults
+ */
+export declare function createPrd(opts: {
+    title: string;
+    description: string;
+    execution_mode?: ExecutionMode;
+    goals?: string[];
+    out_of_scope?: string[];
+    quality_gates?: QualityGate[];
+}): Prd;
+/**
+ * Create a new Task object with defaults
+ */
+export declare function createTask(opts: {
+    prd_id: string;
+    sequence: number;
+    title: string;
+    description: string;
+    priority?: 'critical' | 'high' | 'medium' | 'low';
+    depends_on?: string[];
+    acceptance_criteria?: string[];
+    files_to_modify?: string[];
+    relevant_files?: string[];
+    context_queries?: string[];
+    max_attempts?: number;
+}): Task;
+/**
+ * Create a PrdExecution object for starting a run
+ */
+export declare function createExecution(opts: {
+    prd_id: string;
+    mode: ExecutionMode;
+    branch: string;
+    original_branch: string;
+    max_iterations?: number;
+}): PrdExecution;
+/**
+ * Convert a Prd to an index entry
+ */
+export declare function prdToIndexEntry(prd: Prd): PrdIndexEntry;
+/**
+ * Compute updated PrdStats from tasks
+ */
+export declare function computeStats(tasks: Task[]): PrdStats;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/prd/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAChG,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAM1E,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,cAAc,EAAE,aAAa,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAMD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,cAAc,EAAE,aAAa,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CASxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,UAAO,EACf,UAAU,SAAU,GACnB,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;CAC/B,GAAG,GAAG,CAoBN;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAoBP;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,YAAY,CAef;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CASvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,CAiBpD"}

package/dist/lib/prd/types.js

@@ -0,0 +1,143 @@
+/**
+ * PRD-to-Task Pipeline — Type Definitions
+ *
+ * Core types for the PRD pipeline: generate PRD → parse into tasks → execute.
+ * Inspired by Ralph (iterative loop), Anthropic best practices (git commits,
+ * quality gates), and Claude Code Teams protocol.
+ */
+import crypto from 'crypto';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Generate a unique PRD ID: "prd_" + 8 hex chars
+ */
+export function generatePrdId() {
+    return `prd_${crypto.randomBytes(4).toString('hex')}`;
+}
+/**
+ * Generate a task ID: "task_001", "task_002", etc.
+ */
+export function generateTaskId(sequence) {
+    return `task_${String(sequence).padStart(3, '0')}`;
+}
+/**
+ * Create an empty PrdStats object
+ */
+export function emptyPrdStats() {
+    return {
+        total_tasks: 0,
+        completed_tasks: 0,
+        failed_tasks: 0,
+        skipped_tasks: 0,
+        total_attempts: 0,
+        total_duration_ms: 0,
+    };
+}
+/**
+ * Create a default QualityGate
+ */
+export function createGate(type, command, required = true, timeout_ms = 120_000) {
+    return { type, command, required, timeout_ms };
+}
+/**
+ * Create a new Prd object with defaults
+ */
+export function createPrd(opts) {
+    const id = generatePrdId();
+    const now = new Date().toISOString();
+    return {
+        id,
+        version: 1,
+        title: opts.title,
+        description: opts.description,
+        status: 'draft',
+        execution_mode: opts.execution_mode ?? 'loop',
+        source_file: 'prd.md',
+        goals: opts.goals ?? [],
+        out_of_scope: opts.out_of_scope ?? [],
+        quality_gates: opts.quality_gates ?? [],
+        created_at: now,
+        updated_at: now,
+        started_at: null,
+        completed_at: null,
+        stats: emptyPrdStats(),
+    };
+}
+/**
+ * Create a new Task object with defaults
+ */
+export function createTask(opts) {
+    const now = new Date().toISOString();
+    return {
+        id: generateTaskId(opts.sequence),
+        prd_id: opts.prd_id,
+        sequence: opts.sequence,
+        title: opts.title,
+        description: opts.description,
+        status: 'pending',
+        priority: opts.priority ?? 'medium',
+        depends_on: opts.depends_on ?? [],
+        acceptance_criteria: opts.acceptance_criteria ?? [],
+        files_to_modify: opts.files_to_modify ?? [],
+        relevant_files: opts.relevant_files ?? [],
+        context_queries: opts.context_queries ?? [],
+        attempts: [],
+        max_attempts: opts.max_attempts ?? 3,
+        created_at: now,
+        updated_at: now,
+    };
+}
+/**
+ * Create a PrdExecution object for starting a run
+ */
+export function createExecution(opts) {
+    return {
+        prd_id: opts.prd_id,
+        mode: opts.mode,
+        branch: opts.branch,
+        original_branch: opts.original_branch,
+        started_at: new Date().toISOString(),
+        current_task_id: null,
+        iteration: 0,
+        max_iterations: opts.max_iterations ?? 3,
+        pid: null,
+        team_name: null,
+        concurrency: null,
+        log_file: '',
+    };
+}
+/**
+ * Convert a Prd to an index entry
+ */
+export function prdToIndexEntry(prd) {
+    return {
+        id: prd.id,
+        title: prd.title,
+        status: prd.status,
+        execution_mode: prd.execution_mode,
+        created_at: prd.created_at,
+        updated_at: prd.updated_at,
+    };
+}
+/**
+ * Compute updated PrdStats from tasks
+ */
+export function computeStats(tasks) {
+    return {
+        total_tasks: tasks.length,
+        completed_tasks: tasks.filter((t) => t.status === 'completed').length,
+        failed_tasks: tasks.filter((t) => t.status === 'failed').length,
+        skipped_tasks: tasks.filter((t) => t.status === 'skipped').length,
+        total_attempts: tasks.reduce((sum, t) => sum + t.attempts.length, 0),
+        total_duration_ms: tasks.reduce((sum, t) => {
+            return (sum +
+                t.attempts.reduce((aSum, a) => {
+                    if (!a.completed_at)
+                        return aSum;
+                    return aSum + (new Date(a.completed_at).getTime() - new Date(a.started_at).getTime());
+                }, 0));
+        }, 0),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/lib/prd/types.js.map

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

package/dist/lib/prd/worktree.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Git Worktree Manager
+ *
+ * Manages isolated working directories for parallel task execution.
+ * Each task gets its own worktree checked out from the PRD branch,
+ * preventing concurrent Claude processes from interfering with each other.
+ *
+ * Note: Uses execSync for git commands (same pattern as runner.ts).
+ * All inputs are internally generated (task IDs, branch names) — not user-supplied.
+ */
+export interface WorktreeInfo {
+    taskId: string;
+    path: string;
+    baseBranch: string;
+}
+export interface MergeResult {
+    success: boolean;
+    commitSha?: string;
+    conflictFiles?: string[];
+}
+/**
+ * Get the base directory for all worktrees: .succ/worktrees/
+ */
+export declare function getWorktreesDir(): string;
+/**
+ * Create an isolated worktree for a task.
+ *
+ * Uses `git worktree add --detach` so no new branch is created.
+ * The worktree starts at the same commit as the PRD branch HEAD.
+ * After creation, symlinks node_modules into the worktree (junction on Windows)
+ * so quality gates that require dependencies (tsc, vitest, etc.) work.
+ */
+export declare function createWorktree(taskId: string, prdBranch: string, projectRoot: string): WorktreeInfo;
+/**
+ * Merge worktree changes back to the PRD branch.
+ *
+ * Strategy:
+ * 1. In the worktree: stage and commit all changes
+ * 2. In the main repo: cherry-pick that commit onto the PRD branch
+ *
+ * On conflict: abort cherry-pick, report conflicting files.
+ */
+export declare function mergeWorktreeChanges(worktreePath: string, projectRoot: string, commitMessage: string): MergeResult;
+/**
+ * Remove a single worktree.
+ * Always does git worktree remove + fallback rmSync + prune.
+ * Retries rmSync on Windows (EBUSY / EPERM from delayed file deletion).
+ */
+export declare function removeWorktree(taskId: string, projectRoot: string): void;
+/**
+ * Clean up all task worktrees. Called during resume or after completion.
+ */
+export declare function cleanupAllWorktrees(projectRoot: string): void;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/lib/prd/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,YAAY,CA4Bd;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,WAAW,CAkEb;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA0CxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAyB7D"}