@vinaes/succ 1.3.19

package/dist/lib/prd/parse.js

@@ -0,0 +1,270 @@
+/**
+ * PRD Parser
+ *
+ * Parses a PRD markdown document into executable Task[] via LLM.
+ * Enriches the LLM prompt with real codebase context before parsing.
+ */
+import { callLLM, callLLMWithFallback, getLLMConfig } from '../llm.js';
+import { logWarn } from '../fault-logger.js';
+import { PRD_PARSE_PROMPT } from '../../prompts/prd.js';
+import { gatherCodebaseContext, formatContext } from './codebase-context.js';
+import { createTask } from './types.js';
+import { ValidationError } from '../errors.js';
+// ============================================================================
+// Main entry point
+// ============================================================================
+/**
+ * Parse a PRD markdown into tasks.
+ *
+ * @param prdContent - The PRD markdown content
+ * @param prdId - The PRD ID to assign to tasks
+ * @param description - Original description (for codebase context search)
+ * @returns ParseResult with tasks and any validation warnings
+ */
+export async function parsePrd(prdContent, prdId, description) {
+    const warnings = [];
+    // 1. Gather codebase context
+    const context = await gatherCodebaseContext(description);
+    const contextStr = formatContext(context);
+    // 2. Build prompt
+    const prompt = PRD_PARSE_PROMPT.replace('{codebase_context}', contextStr).replace('{prd_content}', prdContent);
+    const llmOpts = {
+        maxTokens: 8000,
+        temperature: 0.2, // Low temperature for structured output
+        timeout: 120_000, // Parsing needs more time than default 30s
+    };
+    // 3. Call LLM (with backend fallback on transport errors)
+    let response = await callLLMWithFallback(prompt, llmOpts);
+    // 4. Extract JSON from response
+    let rawTasks = extractJson(response);
+    // 4b. Retry once with corrective prompt if extraction failed
+    if (!rawTasks) {
+        logWarn('prd', 'JSON extraction failed, retrying with corrective prompt...');
+        const retryPrompt = `Your previous response was not valid JSON. Here is what you returned:
+
+${response.slice(0, 1000)}
+
+Return ONLY a valid JSON array starting with [ and ending with ]. No markdown, no explanation, no prose. Each element must have: sequence, title, description, priority, depends_on, acceptance_criteria, files_to_modify, relevant_files.`;
+        response = await callLLMWithFallback(retryPrompt, llmOpts);
+        rawTasks = extractJson(response);
+    }
+    // 4c. If local LLM can't produce JSON, escalate to a stronger backend
+    if (!rawTasks) {
+        const currentBackend = getLLMConfig().backend;
+        const escalateBackends = ['api', 'claude'].filter((b) => b !== currentBackend);
+        for (const backend of escalateBackends) {
+            try {
+                logWarn('prd', `Escalating PRD parse to '${backend}' backend after local LLM failed to produce valid JSON`);
+                response = await callLLM(prompt, llmOpts, { backend });
+                rawTasks = extractJson(response);
+                if (rawTasks)
+                    break;
+            }
+            catch {
+                // Backend unavailable — try next
+            }
+        }
+    }
+    if (!rawTasks) {
+        throw new ValidationError('Failed to parse LLM response as JSON task array after retry. Response:\n' +
+            response.slice(0, 500));
+    }
+    // 5. Validate and normalize
+    const tasks = normalizeTasks(rawTasks, prdId, warnings);
+    // 6. Run validation checks
+    validateTasks(tasks, warnings);
+    return { tasks, warnings };
+}
+// ============================================================================
+// JSON Extraction
+// ============================================================================
+/**
+ * Try to parse a value as a RawTask array.
+ * Handles both direct arrays and object wrappers like {"tasks": [...]}.
+ */
+function asTaskArray(parsed) {
+    if (Array.isArray(parsed))
+        return parsed;
+    // Object wrapper — find the first array value
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+        const values = Object.values(parsed);
+        const arr = values.find((v) => Array.isArray(v));
+        if (arr)
+            return arr;
+    }
+    return null;
+}
+/**
+ * Fix common JSON malformations from local LLMs:
+ * - Trailing commas before ] or }
+ * - Single-line // comments
+ */
+function fixMalformedJson(text) {
+    // Remove single-line // comments that appear outside of JSON strings.
+    // Only strip // that follows whitespace, comma, or line start — avoids breaking URLs.
+    let fixed = text.replace(/^(\s*)\/\/[^\n]*/gm, ''); // Line-start comments
+    fixed = fixed.replace(/,(\s*)\/\/[^\n]*/g, ','); // After-comma comments
+    // Remove trailing commas before ] or }
+    fixed = fixed.replace(/,\s*([}\]])/g, '$1');
+    return fixed;
+}
+/**
+ * Try to JSON.parse text, with malformation fix as fallback.
+ */
+function tryParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // Try with malformation fixes
+        try {
+            return JSON.parse(fixMalformedJson(text));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Extract a JSON array from LLM response.
+ * Handles: direct JSON, markdown code blocks, object wrappers,
+ * trailing commas, and embedded arrays in prose.
+ */
+function extractJson(response) {
+    const trimmed = response.trim();
+    // Strategy 1: Direct parse
+    const direct = tryParse(trimmed);
+    if (direct) {
+        const arr = asTaskArray(direct);
+        if (arr)
+            return arr;
+    }
+    // Strategy 2: Extract from markdown code block
+    const codeBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (codeBlockMatch) {
+        const blockContent = tryParse(codeBlockMatch[1].trim());
+        if (blockContent) {
+            const arr = asTaskArray(blockContent);
+            if (arr)
+                return arr;
+        }
+    }
+    // Strategy 3: Find array in response (first [ to last ])
+    const firstBracket = trimmed.indexOf('[');
+    const lastBracket = trimmed.lastIndexOf(']');
+    if (firstBracket >= 0 && lastBracket > firstBracket) {
+        const slice = trimmed.slice(firstBracket, lastBracket + 1);
+        const sliceContent = tryParse(slice);
+        if (sliceContent) {
+            const arr = asTaskArray(sliceContent);
+            if (arr)
+                return arr;
+        }
+    }
+    return null;
+}
+// ============================================================================
+// Normalization
+// ============================================================================
+/**
+ * Convert raw LLM output into proper Task objects
+ */
+function normalizeTasks(rawTasks, prdId, warnings) {
+    return rawTasks.map((raw, index) => {
+        const sequence = raw.sequence ?? index + 1;
+        // Normalize depends_on: convert sequence numbers to task IDs
+        const dependsOn = (raw.depends_on ?? []).map((dep) => {
+            // If it's already a task ID (task_XXX format), keep it
+            if (typeof dep === 'string' && dep.startsWith('task_'))
+                return dep;
+            // If it's a number or numeric string, convert to task ID
+            const num = typeof dep === 'number' ? dep : parseInt(dep, 10);
+            if (!isNaN(num))
+                return `task_${String(num).padStart(3, '0')}`;
+            return dep;
+        });
+        if (!raw.title) {
+            warnings.push(`Task ${sequence}: missing title`);
+        }
+        if (!raw.files_to_modify || raw.files_to_modify.length === 0) {
+            warnings.push(`Task ${sequence} "${raw.title}": no files_to_modify — may conflict with other tasks`);
+        }
+        return createTask({
+            prd_id: prdId,
+            sequence,
+            title: raw.title || `Task ${sequence}`,
+            description: raw.description || '',
+            priority: raw.priority,
+            depends_on: dependsOn,
+            acceptance_criteria: raw.acceptance_criteria,
+            files_to_modify: raw.files_to_modify,
+            relevant_files: raw.relevant_files,
+            context_queries: raw.context_queries,
+        });
+    });
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validate task list for common issues
+ */
+function validateTasks(tasks, warnings) {
+    // Task count check
+    if (tasks.length < 3) {
+        warnings.push(`Only ${tasks.length} tasks — PRD may be under-decomposed`);
+    }
+    if (tasks.length > 25) {
+        warnings.push(`${tasks.length} tasks — PRD may be over-decomposed or scope too large`);
+    }
+    // Check for circular dependencies
+    const visited = new Set();
+    const inStack = new Set();
+    function hasCycle(taskId) {
+        if (inStack.has(taskId))
+            return true;
+        if (visited.has(taskId))
+            return false;
+        visited.add(taskId);
+        inStack.add(taskId);
+        const task = tasks.find((t) => t.id === taskId);
+        if (task) {
+            for (const dep of task.depends_on) {
+                if (hasCycle(dep))
+                    return true;
+            }
+        }
+        inStack.delete(taskId);
+        return false;
+    }
+    for (const task of tasks) {
+        if (hasCycle(task.id)) {
+            warnings.push(`Circular dependency detected involving task ${task.id}`);
+            break;
+        }
+    }
+    // Check for file overlap without dependency
+    const taskIds = new Set(tasks.map((t) => t.id));
+    for (let i = 0; i < tasks.length; i++) {
+        for (let j = i + 1; j < tasks.length; j++) {
+            const a = tasks[i];
+            const b = tasks[j];
+            const overlap = a.files_to_modify.filter((f) => b.files_to_modify.includes(f));
+            if (overlap.length > 0) {
+                const hasDep = a.depends_on.includes(b.id) || b.depends_on.includes(a.id);
+                if (!hasDep) {
+                    warnings.push(`Tasks ${a.id} and ${b.id} both modify ${overlap.join(', ')} but have no dependency — potential conflict`);
+                }
+            }
+        }
+    }
+    // Check for invalid dependency references
+    for (const task of tasks) {
+        for (const dep of task.depends_on) {
+            if (!taskIds.has(dep)) {
+                warnings.push(`Task ${task.id} depends on non-existent task ${dep}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=parse.js.map

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

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

package/dist/lib/prd/prompt-builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PRD Task Prompt Builder
+ *
+ * Assembles the full prompt for a Claude Code agent executing a task.
+ * Uses TASK_EXECUTION_PROMPT template and fills in context.
+ */
+import type { Task, Prd } from './types.js';
+import type { TaskContext } from './context.js';
+/**
+ * Build the full prompt for executing a task.
+ */
+export declare function buildTaskPrompt(task: Task, prd: Prd, context: TaskContext): string;
+/**
+ * Append failure context to a prompt for retry attempts.
+ * Gives the agent info about what went wrong in the previous attempt.
+ */
+export declare function appendFailureContext(prompt: string, attemptNumber: number, gateOutput: string, agentOutput: string): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/lib/prd/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA8BlF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAsBR"}

package/dist/lib/prd/prompt-builder.js

@@ -0,0 +1,61 @@
+/**
+ * PRD Task Prompt Builder
+ *
+ * Assembles the full prompt for a Claude Code agent executing a task.
+ * Uses TASK_EXECUTION_PROMPT template and fills in context.
+ */
+import { TASK_EXECUTION_PROMPT } from '../../prompts/prd.js';
+// ============================================================================
+// Build the agent prompt
+// ============================================================================
+/**
+ * Build the full prompt for executing a task.
+ */
+export function buildTaskPrompt(task, prd, context) {
+    const acceptanceCriteria = task.acceptance_criteria.length > 0
+        ? task.acceptance_criteria.map((c, i) => `${i + 1}. ${c}`).join('\n')
+        : '(No specific acceptance criteria — use your best judgment)';
+    const filesToModify = task.files_to_modify.length > 0
+        ? task.files_to_modify.map((f) => `- ${f}`).join('\n')
+        : '(No specific files predicted — determine from context)';
+    const relevantFiles = task.relevant_files.length > 0
+        ? task.relevant_files.map((f) => `- ${f}`).join('\n')
+        : '(None specified)';
+    const qualityGates = prd.quality_gates.length > 0
+        ? prd.quality_gates.map((g) => `   - ${g.type}: \`${g.command}\``).join('\n')
+        : '   (No quality gates configured)';
+    return TASK_EXECUTION_PROMPT.replace('{task_title}', `${task.id}: ${task.title}`)
+        .replace('{task_description}', task.description)
+        .replace('{acceptance_criteria}', acceptanceCriteria)
+        .replace('{files_to_modify}', filesToModify)
+        .replace('{relevant_files}', relevantFiles)
+        .replace('{recalled_memories}', context.recalled_memories)
+        .replace('{dead_end_warnings}', context.dead_end_warnings)
+        .replace('{progress_so_far}', context.progress_so_far)
+        .replace('{quality_gates}', qualityGates);
+}
+/**
+ * Append failure context to a prompt for retry attempts.
+ * Gives the agent info about what went wrong in the previous attempt.
+ */
+export function appendFailureContext(prompt, attemptNumber, gateOutput, agentOutput) {
+    // Strip any previous failure context to prevent prompt bloat across retries
+    const stripped = prompt.replace(/\n\n## Previous Attempt.*$/s, '');
+    const truncatedGate = gateOutput.slice(-2000) || '(No gate output)';
+    const truncatedAgent = agentOutput.slice(-1000) || '(No output)';
+    return (stripped +
+        `\n\n## Previous Attempt (${attemptNumber}) Failed
+
+### Gate Failures
+${truncatedGate}
+
+### Agent Output (last 1000 chars)
+${truncatedAgent}
+
+### Instructions for Retry
+- Fix the issues identified above
+- Do NOT repeat the same approach if it clearly failed
+- If the task seems impossible, explain why with "BLOCKED:" prefix
+`);
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/lib/prd/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../src/lib/prd/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,GAAQ,EAAE,OAAoB;IACxE,MAAM,kBAAkB,GACtB,IAAI,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrE,CAAC,CAAC,4DAA4D,CAAC;IAEnE,MAAM,aAAa,GACjB,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,wDAAwD,CAAC;IAE/D,MAAM,aAAa,GACjB,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrD,CAAC,CAAC,kBAAkB,CAAC;IAEzB,MAAM,YAAY,GAChB,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;QAC1B,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7E,CAAC,CAAC,kCAAkC,CAAC;IAEzC,OAAO,qBAAqB,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;SAC9E,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC,WAAW,CAAC;SAC/C,OAAO,CAAC,uBAAuB,EAAE,kBAAkB,CAAC;SACpD,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC;SAC3C,OAAO,CAAC,kBAAkB,EAAE,aAAa,CAAC;SAC1C,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,iBAAiB,CAAC;SACzD,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,iBAAiB,CAAC;SACzD,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,eAAe,CAAC;SACrD,OAAO,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,aAAqB,EACrB,UAAkB,EAClB,WAAmB;IAEnB,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC;IACpE,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;IAEjE,OAAO,CACL,QAAQ;QACR,4BAA4B,aAAa;;;EAG3C,aAAa;;;EAGb,cAAc;;;;;;CAMf,CACE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * PRD Runner — Orchestration Loop
+ *
+ * Manages the full execution lifecycle:
+ * 1. Branch setup (git checkout -b prd/{id})
+ * 2. Iterate tasks in topological order
+ * 3. For each task: gather context -> build prompt -> execute -> run gates -> commit
+ * 4. Branch teardown (return to original branch)
+ *
+ * NOTE: execSync is used for git commands with internally-generated arguments
+ * (prd IDs are hex-only from crypto.randomBytes, branch names are controlled).
+ */
+import type { Prd } from './types.js';
+export interface RunOptions {
+    mode?: 'loop' | 'team';
+    concurrency?: number;
+    resume?: boolean;
+    taskId?: string;
+    dryRun?: boolean;
+    maxIterations?: number;
+    noBranch?: boolean;
+    model?: string;
+    force?: boolean;
+}
+export interface RunResult {
+    prd: Prd;
+    success: boolean;
+    tasksCompleted: number;
+    tasksFailed: number;
+    branch?: string;
+}
+/**
+ * Check if a process with the given PID is still running.
+ */
+export declare function isProcessRunning(pid: number): boolean;
+/**
+ * Built-in tools + succ MCP tools that workers can use.
+ * Workers can recall memories, record learnings, and flag dead-ends.
+ */
+export declare const WORKER_ALLOWED_TOOLS: string[];
+/**
+ * Build MCP server config for spawned claude processes.
+ * Since user-scope MCP servers aren't inherited by spawned processes,
+ * we pass the succ MCP server config explicitly via --mcp-config.
+ */
+export declare function buildMcpConfig(): Record<string, {
+    command: string;
+    args?: string[];
+}>;
+/**
+ * Run a PRD — execute its tasks in order with quality gates.
+ */
+export declare function runPrd(prdId: string, options?: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwBH,OAAO,KAAK,EAAE,GAAG,EAAmC,MAAM,YAAY,CAAC;AAOvE,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrD;AAqBD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAYhC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAIrF;AAMD;;GAEG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAqRxF"}