@vinaes/succ 1.3.19

package/dist/lib/prd/codebase-context.js

@@ -0,0 +1,420 @@
+/**
+ * Codebase Context Enrichment
+ *
+ * Gathers real project context for LLM prompts during PRD generation and parsing.
+ * This ensures the LLM sees actual file structure, relevant code, memories, and docs
+ * rather than guessing the architecture.
+ *
+ * Context budget: ~8500 tokens total
+ * - File tree: ~2000 tokens
+ * - Code search: ~3000 tokens
+ * - Memories: ~2000 tokens
+ * - Brain docs: ~1500 tokens
+ */
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import { getProjectRoot, getSuccDir } from '../config.js';
+// Rough char-to-token ratio (conservative: 1 token ≈ 4 chars)
+const CHARS_PER_TOKEN = 4;
+const BUDGET = {
+    file_tree: 2000 * CHARS_PER_TOKEN, // ~8000 chars
+    code_search: 3000 * CHARS_PER_TOKEN, // ~12000 chars
+    memories: 2000 * CHARS_PER_TOKEN, // ~8000 chars
+    brain_docs: 1500 * CHARS_PER_TOKEN, // ~6000 chars
+};
+// ============================================================================
+// File Tree
+// ============================================================================
+/**
+ * Build a formatted file tree showing project structure.
+ * Shows top-level files + src/ two levels deep.
+ */
+async function gatherFileTree() {
+    const root = getProjectRoot();
+    const lines = [];
+    // Top-level entries
+    const topLevel = await glob('*', {
+        cwd: root,
+        dot: false,
+        // Exclude noise
+        ignore: ['node_modules', 'dist', '.git', '.succ', '.claude', 'coverage', '.next', '.cache'],
+    });
+    for (const entry of topLevel.sort()) {
+        const fullPath = path.join(root, entry);
+        const isDir = fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory();
+        lines.push(isDir ? `${entry}/` : entry);
+    }
+    // src/ two levels deep
+    const srcDir = path.join(root, 'src');
+    if (fs.existsSync(srcDir)) {
+        // Use a pattern that limits depth to 2 levels: */* matches exactly 2 levels
+        const srcL1 = await glob('*', { cwd: srcDir, dot: false });
+        const srcL2 = await glob('*/*', {
+            cwd: srcDir,
+            dot: false,
+            ignore: ['**/*.test.*', '**/*.spec.*'],
+        });
+        const srcEntries = [...srcL1, ...srcL2].filter((v, i, a) => a.indexOf(v) === i);
+        for (const entry of srcEntries.sort()) {
+            const fullPath = path.join(srcDir, entry);
+            const isDir = fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory();
+            lines.push(isDir ? `  src/${entry}/` : `  src/${entry}`);
+        }
+    }
+    const result = lines.join('\n');
+    return truncate(result, BUDGET.file_tree);
+}
+// ============================================================================
+// Code Search (via succ MCP tools — called externally)
+// ============================================================================
+/**
+ * Search for relevant code using succ's indexed code.
+ * Priority: 1) hybridSearchCode (semantic + BM25 with symbol boost),
+ *           2) tree-sitter AST extraction, 3) glob+read fallback.
+ */
+async function gatherCodeSearch(description) {
+    const root = getProjectRoot();
+    const keywords = extractKeywords(description);
+    const results = [];
+    const seenFiles = new Set();
+    // 1. Try indexed symbol-based search (fastest, most relevant)
+    try {
+        const { hybridSearchCode } = await import('../storage/index.js');
+        const { getEmbedding } = await import('../embeddings.js');
+        const queryEmbedding = await getEmbedding(description);
+        const codeResults = await hybridSearchCode(description, queryEmbedding, 8, 0.2);
+        if (codeResults.length > 0) {
+            for (const r of codeResults) {
+                const filePath = r.file_path.replace(/^code:/, '');
+                if (seenFiles.has(filePath))
+                    continue;
+                seenFiles.add(filePath);
+                const score = (r.similarity * 100).toFixed(0);
+                // Compact format: file path + first few lines (signature-like)
+                const firstLines = r.content.split('\n').slice(0, 5).join('\n');
+                results.push(`--- ${filePath}:${r.start_line}-${r.end_line} (${score}%) ---\n${firstLines}\n`);
+            }
+        }
+    }
+    catch {
+        // Index not available, fall through to AST/glob
+    }
+    // 2. Supplement with AST symbol extraction for keyword-matched files
+    if (results.length < 5) {
+        let extractSymbolsFn = null;
+        try {
+            const { extractSymbols: _extract } = await import('../tree-sitter/extractor.js');
+            const { parseCode } = await import('../tree-sitter/parser.js');
+            extractSymbolsFn = async (code, lang) => {
+                const tree = await parseCode(code, lang);
+                if (!tree)
+                    return [];
+                const symbols = await _extract(tree, code, lang);
+                tree.delete();
+                return symbols;
+            };
+        }
+        catch {
+            // tree-sitter not available
+        }
+        for (const keyword of keywords.slice(0, 5)) {
+            if (results.length >= 8)
+                break;
+            const matches = await glob(`src/**/*${keyword.toLowerCase()}*`, {
+                cwd: root,
+                nodir: true,
+                ignore: ['**/*.test.*', '**/*.spec.*', '**/node_modules/**'],
+            });
+            for (const match of matches.slice(0, 3)) {
+                if (seenFiles.has(match))
+                    continue;
+                seenFiles.add(match);
+                const fullPath = path.join(root, match);
+                if (!fs.existsSync(fullPath))
+                    continue;
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                // Use AST symbols if available — compact and informative
+                if (extractSymbolsFn) {
+                    const ext = path.extname(match).slice(1);
+                    const langMap = {
+                        ts: 'typescript',
+                        tsx: 'tsx',
+                        js: 'javascript',
+                        py: 'python',
+                        go: 'go',
+                        rs: 'rust',
+                        java: 'java',
+                    };
+                    const lang = langMap[ext];
+                    if (lang) {
+                        const symbols = await extractSymbolsFn(content, lang);
+                        if (symbols.length > 0) {
+                            const symbolLines = symbols
+                                .slice(0, 15)
+                                .map((s) => `  ${s.type} ${s.name}${s.signature ? `: ${s.signature}` : ''} (L${s.startRow + 1})`);
+                            results.push(`--- ${match} (${symbols.length} symbols) ---\n${symbolLines.join('\n')}\n`);
+                            continue;
+                        }
+                    }
+                }
+                // Fallback: first 50 lines
+                const lines = content.split('\n');
+                results.push(`--- ${match} ---\n${lines.slice(0, 50).join('\n')}\n`);
+            }
+        }
+    }
+    // 3. Fallback: content-based keyword search
+    if (results.length < 5) {
+        const srcFiles = await glob('src/**/*.ts', {
+            cwd: root,
+            nodir: true,
+            ignore: ['**/*.test.*', '**/*.spec.*', '**/node_modules/**', '**/dist/**'],
+        });
+        for (const keyword of keywords.slice(0, 3)) {
+            for (const file of srcFiles) {
+                if (results.length >= 8)
+                    break;
+                if (seenFiles.has(file))
+                    continue;
+                const fullPath = path.join(root, file);
+                if (!fs.existsSync(fullPath))
+                    continue;
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                if (content.toLowerCase().includes(keyword.toLowerCase())) {
+                    seenFiles.add(file);
+                    const lines = content.split('\n');
+                    const matchingLines = [];
+                    for (let i = 0; i < lines.length; i++) {
+                        if (lines[i].toLowerCase().includes(keyword.toLowerCase())) {
+                            const start = Math.max(0, i - 2);
+                            const end = Math.min(lines.length, i + 3);
+                            matchingLines.push(`  L${i + 1}: ${lines.slice(start, end).join('\n  ')}`);
+                            if (matchingLines.length >= 3)
+                                break;
+                        }
+                    }
+                    if (matchingLines.length > 0) {
+                        results.push(`--- ${file} (matches: "${keyword}") ---\n${matchingLines.join('\n')}\n`);
+                    }
+                }
+            }
+        }
+    }
+    const result = results.join('\n');
+    return truncate(result, BUDGET.code_search);
+}
+// ============================================================================
+// Memories (placeholder — actual succ_recall requires MCP or direct DB access)
+// ============================================================================
+/**
+ * Gather relevant memories from succ.
+ * In CLI context, we do a simple search of recent decisions/learnings.
+ */
+async function gatherMemories(_description) {
+    // In Phase 1, we'll use a simple approach:
+    // Check if .succ/succ.db exists, and if so, note that memories are available.
+    // Full integration with succ_recall happens when called from MCP context.
+    const succDir = getSuccDir();
+    const dbPath = path.join(succDir, 'succ.db');
+    if (!fs.existsSync(dbPath)) {
+        return '(No succ memories available — run `succ init` to enable)';
+    }
+    // For now, return a note that context is available.
+    // The actual recall will be done by the LLM agent during execution (Phase 2).
+    return '(succ memory system available — memories will be recalled during task execution)';
+}
+/**
+ * Gather relevant brain vault documentation.
+ */
+async function gatherBrainDocs(_description) {
+    const brainDir = path.join(getSuccDir(), 'brain');
+    if (!fs.existsSync(brainDir)) {
+        return '(No brain vault documentation available)';
+    }
+    // List available brain vault docs for context
+    const docs = await glob('**/*.md', {
+        cwd: brainDir,
+        nodir: true,
+    });
+    if (docs.length === 0) {
+        return '(Brain vault is empty)';
+    }
+    const lines = ['Available documentation in brain vault:'];
+    for (const doc of docs.sort().slice(0, 20)) {
+        lines.push(`  - ${doc}`);
+    }
+    return truncate(lines.join('\n'), BUDGET.brain_docs);
+}
+// ============================================================================
+// Main entry point
+// ============================================================================
+/**
+ * Gather codebase context for LLM prompts.
+ * Used by both generate.ts and parse.ts before calling LLM.
+ *
+ * @param description - The PRD description or content to gather context for
+ * @returns CodebaseContext with formatted sections
+ */
+export async function gatherCodebaseContext(description) {
+    const [file_tree, code_search_results, memories, brain_docs] = await Promise.all([
+        gatherFileTree(),
+        gatherCodeSearch(description),
+        gatherMemories(description),
+        gatherBrainDocs(description),
+    ]);
+    return { file_tree, code_search_results, memories, brain_docs };
+}
+/**
+ * Format codebase context into a string for prompt injection
+ */
+export function formatContext(ctx) {
+    const sections = [];
+    if (ctx.file_tree) {
+        sections.push(`### Project File Structure\n\`\`\`\n${ctx.file_tree}\n\`\`\``);
+    }
+    if (ctx.code_search_results && !ctx.code_search_results.startsWith('(')) {
+        sections.push(`### Relevant Source Code\n${ctx.code_search_results}`);
+    }
+    if (ctx.memories && !ctx.memories.startsWith('(')) {
+        sections.push(`### Project Memories & Decisions\n${ctx.memories}`);
+    }
+    if (ctx.brain_docs && !ctx.brain_docs.startsWith('(')) {
+        sections.push(`### Documentation\n${ctx.brain_docs}`);
+    }
+    return sections.join('\n\n');
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * Extract keywords from a description for code search.
+ * Simple approach: split on spaces, filter short/common words.
+ */
+function extractKeywords(description) {
+    const stopWords = new Set([
+        'a',
+        'an',
+        'the',
+        'is',
+        'are',
+        'was',
+        'were',
+        'be',
+        'been',
+        'being',
+        'have',
+        'has',
+        'had',
+        'do',
+        'does',
+        'did',
+        'will',
+        'would',
+        'could',
+        'should',
+        'may',
+        'might',
+        'can',
+        'shall',
+        'to',
+        'of',
+        'in',
+        'for',
+        'on',
+        'with',
+        'at',
+        'by',
+        'from',
+        'as',
+        'into',
+        'through',
+        'during',
+        'before',
+        'after',
+        'above',
+        'below',
+        'between',
+        'and',
+        'but',
+        'or',
+        'not',
+        'no',
+        'nor',
+        'so',
+        'yet',
+        'both',
+        'either',
+        'neither',
+        'each',
+        'every',
+        'all',
+        'any',
+        'few',
+        'more',
+        'most',
+        'other',
+        'some',
+        'such',
+        'than',
+        'too',
+        'very',
+        'just',
+        'also',
+        'add',
+        'implement',
+        'create',
+        'make',
+        'build',
+        'update',
+        'fix',
+        'change',
+        'new',
+        'feature',
+        'support',
+        'system',
+        'module',
+        'function',
+        // Russian stop words
+        'в',
+        'на',
+        'с',
+        'и',
+        'не',
+        'для',
+        'из',
+        'по',
+        'что',
+        'как',
+        'это',
+        'все',
+        'они',
+        'мы',
+        'он',
+        'она',
+        'его',
+        'её',
+        'их',
+        'добавить',
+        'создать',
+        'сделать',
+        'новый',
+        'систему',
+        'модуль',
+    ]);
+    return description
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length >= 3 && !stopWords.has(w))
+        .slice(0, 10);
+}
+/**
+ * Truncate a string to max chars, adding a note if truncated
+ */
+function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars) + '\n... (truncated)';
+}
+//# sourceMappingURL=codebase-context.js.map

package/dist/lib/prd/codebase-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-context.js","sourceRoot":"","sources":["../../../src/lib/prd/codebase-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1D,8DAA8D;AAC9D,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,MAAM,GAAG;IACb,SAAS,EAAE,IAAI,GAAG,eAAe,EAAE,cAAc;IACjD,WAAW,EAAE,IAAI,GAAG,eAAe,EAAE,eAAe;IACpD,QAAQ,EAAE,IAAI,GAAG,eAAe,EAAE,cAAc;IAChD,UAAU,EAAE,IAAI,GAAG,eAAe,EAAE,cAAc;CACnD,CAAC;AAEF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;GAGG;AACH,KAAK,UAAU,cAAc;IAC3B,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oBAAoB;IACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE;QAC/B,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,KAAK;QACV,gBAAgB;QAChB,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC5F,CAAC,CAAC;IAEH,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,uBAAuB;IACvB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,4EAA4E;QAC5E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE;YAC9B,GAAG,EAAE,MAAM;YACX,GAAG,EAAE,KAAK;YACV,MAAM,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC;SACvC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhF,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAE/E;;;;GAIG;AACH,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACjD,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,8DAA8D;IAC9D,IAAI,CAAC;QACH,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACjE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAEhF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACnD,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBACtC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAExB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC9C,+DAA+D;gBAC/D,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChE,OAAO,CAAC,IAAI,CACV,OAAO,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,WAAW,UAAU,IAAI,CACjF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,gBAAgB,GAaT,IAAI,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;YACjF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;YAC/D,gBAAgB,GAAG,KAAK,EAAE,IAAY,EAAE,IAAY,EAAE,EAAE;gBACtD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACzC,IAAI,CAAC,IAAI;oBAAE,OAAO,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;gBAAE,MAAM;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC9D,GAAG,EAAE,IAAI;gBACT,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,CAAC;aAC7D,CAAC,CAAC;YAEH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACxC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACnC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBAEvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAEnD,yDAAyD;gBACzD,IAAI,gBAAgB,EAAE,CAAC;oBACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACzC,MAAM,OAAO,GAA2B;wBACtC,EAAE,EAAE,YAAY;wBAChB,GAAG,EAAE,KAAK;wBACV,EAAE,EAAE,YAAY;wBAChB,EAAE,EAAE,QAAQ;wBACZ,EAAE,EAAE,IAAI;wBACR,EAAE,EAAE,MAAM;wBACV,IAAI,EAAE,MAAM;qBACb,CAAC;oBACF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC1B,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;wBACtD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACvB,MAAM,WAAW,GAAG,OAAO;iCACxB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iCACZ,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,CACvF,CAAC;4BACJ,OAAO,CAAC,IAAI,CACV,OAAO,KAAK,KAAK,OAAO,CAAC,MAAM,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC5E,CAAC;4BACF,SAAS;wBACX,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,2BAA2B;gBAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE;YACzC,GAAG,EAAE,IAAI;YACT,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,CAAC;SAC3E,CAAC,CAAC;QAEH,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;oBAAE,MAAM;gBAC/B,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBAEvC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC1D,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClC,MAAM,aAAa,GAAa,EAAE,CAAC;oBACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;4BAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;4BACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;4BAC1C,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;4BAC3E,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC;gCAAE,MAAM;wBACvC,CAAC;oBACH,CAAC;oBACD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC7B,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,eAAe,OAAO,WAAW,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACzF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAE/E;;;GAGG;AACH,KAAK,UAAU,cAAc,CAAC,YAAoB;IAChD,2CAA2C;IAC3C,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,0DAA0D,CAAC;IACpE,CAAC;IAED,oDAAoD;IACpD,8EAA8E;IAC9E,OAAO,kFAAkF,CAAC;AAC5F,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,YAAoB;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,0CAA0C,CAAC;IACpD,CAAC;IAED,8CAA8C;IAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE;QACjC,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB;IAC7D,MAAM,CAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/E,cAAc,EAAE;QAChB,gBAAgB,CAAC,WAAW,CAAC;QAC7B,cAAc,CAAC,WAAW,CAAC;QAC3B,eAAe,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC;IAEH,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB;IAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,uCAAuC,GAAG,CAAC,SAAS,UAAU,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,GAAG,CAAC,mBAAmB,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,qCAAqC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,eAAe,CAAC,WAAmB;IAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;QACxB,GAAG;QACH,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,MAAM;QACN,IAAI;QACJ,MAAM;QACN,OAAO;QACP,MAAM;QACN,KAAK;QACL,KAAK;QACL,IAAI;QACJ,MAAM;QACN,KAAK;QACL,MAAM;QACN,OAAO;QACP,OAAO;QACP,QAAQ;QACR,KAAK;QACL,OAAO;QACP,KAAK;QACL,OAAO;QACP,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,MAAM;QACN,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,OAAO;QACP,OAAO;QACP,SAAS;QACT,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,MAAM;QACN,QAAQ;QACR,SAAS;QACT,MAAM;QACN,OAAO;QACP,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,WAAW;QACX,QAAQ;QACR,MAAM;QACN,OAAO;QACP,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,KAAK;QACL,SAAS;QACT,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,qBAAqB;QACrB,GAAG;QACH,IAAI;QACJ,GAAG;QACH,GAAG;QACH,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,UAAU;QACV,SAAS;QACT,SAAS;QACT,OAAO;QACP,SAAS;QACT,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO,WAAW;SACf,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACjD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,mBAAmB,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * PRD Task Context Gatherer
+ *
+ * Gathers context from succ memory system before executing a task.
+ * This provides the agent with relevant memories, dead-end warnings,
+ * and documentation context.
+ *
+ * Uses the storage abstraction (hybridSearchMemories) which works with
+ * SQLite, PostgreSQL, and Qdrant backends transparently.
+ */
+import type { Task } from './types.js';
+export interface TaskContext {
+    recalled_memories: string;
+    dead_end_warnings: string;
+    progress_so_far: string;
+}
+/**
+ * Gather context for a task before execution.
+ *
+ * Queries hybridSearchMemories for relevant memories and dead-ends based on
+ * the task's context_queries and description.
+ */
+export declare function gatherTaskContext(task: Task, prdId: string): Promise<TaskContext>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC,MAAM,WAAW,WAAW;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsDvF"}

package/dist/lib/prd/context.js

@@ -0,0 +1,68 @@
+/**
+ * PRD Task Context Gatherer
+ *
+ * Gathers context from succ memory system before executing a task.
+ * This provides the agent with relevant memories, dead-end warnings,
+ * and documentation context.
+ *
+ * Uses the storage abstraction (hybridSearchMemories) which works with
+ * SQLite, PostgreSQL, and Qdrant backends transparently.
+ */
+import { loadProgress } from './state.js';
+/**
+ * Gather context for a task before execution.
+ *
+ * Queries hybridSearchMemories for relevant memories and dead-ends based on
+ * the task's context_queries and description.
+ */
+export async function gatherTaskContext(task, prdId) {
+    const recalled = [];
+    const deadEnds = [];
+    // 1. Search memories via storage abstraction (works with SQLite, PG, Qdrant)
+    try {
+        const { hybridSearchMemories } = await import('../storage/index.js');
+        const { getEmbedding } = await import('../embeddings.js');
+        // Build a combined query from task context
+        const queries = [
+            ...task.context_queries,
+            task.title,
+            ...task.files_to_modify.map((f) => f.split('/').pop() ?? f),
+        ];
+        // Deduplicate results across queries
+        const seen = new Set();
+        for (const query of queries.slice(0, 5)) {
+            try {
+                const queryEmbedding = await getEmbedding(query);
+                const memories = await hybridSearchMemories(query, queryEmbedding, 3, 0.3);
+                for (const m of memories) {
+                    if (seen.has(m.id))
+                        continue;
+                    seen.add(m.id);
+                    const tag = m.type === 'dead_end' ? '[DEAD-END]' : `[${m.type ?? 'observation'}]`;
+                    const line = `${tag} ${m.content}`;
+                    if (m.type === 'dead_end') {
+                        deadEnds.push(line);
+                    }
+                    else {
+                        recalled.push(line);
+                    }
+                }
+            }
+            catch {
+                // Query failed — skip this query
+            }
+        }
+    }
+    catch {
+        // Storage not available — that's fine, we just won't have memory context
+        recalled.push('(No succ memories available — storage not initialized)');
+    }
+    // 2. Load progress so far
+    const progress = loadProgress(prdId);
+    return {
+        recalled_memories: recalled.length > 0 ? recalled.join('\n') : '(No relevant memories found)',
+        dead_end_warnings: deadEnds.length > 0 ? deadEnds.join('\n') : '(No dead-ends recorded for this area)',
+        progress_so_far: progress || '(No progress recorded yet)',
+    };
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/lib/prd/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAU,EAAE,KAAa;IAC/D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,6EAA6E;IAC7E,IAAI,CAAC;QACH,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACrE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAE1D,2CAA2C;QAC3C,MAAM,OAAO,GAAG;YACd,GAAG,IAAI,CAAC,eAAe;YACvB,IAAI,CAAC,KAAK;YACV,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;SAC5D,CAAC;QAEF,qCAAqC;QACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAE3E,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;wBAAE,SAAS;oBAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAEf,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,aAAa,GAAG,CAAC;oBAClF,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBACnC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,QAAQ,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAC1E,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO;QACL,iBAAiB,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,8BAA8B;QAC7F,iBAAiB,EACf,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,uCAAuC;QACrF,eAAe,EAAE,QAAQ,IAAI,4BAA4B;KAC1D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * Agent Executor
+ *
+ * Thin abstraction over cross-spawn for running Claude Code CLI.
+ * Uses `-p --no-session-persistence` with SUCC_SERVICE_SESSION env marker,
+ * matching the canonical pattern from llm.ts (buildClaudeArgs / CLAUDE_SPAWN_OPTIONS).
+ * Prompt is piped via stdin to avoid shell escaping issues.
+ */
+export interface ExecuteOptions {
+    cwd: string;
+    timeout_ms: number;
+    model?: string;
+    permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions';
+    allowedTools?: string[];
+    mcpConfig?: Record<string, {
+        command: string;
+        args?: string[];
+    }>;
+    onOutput?: (chunk: string) => void;
+}
+export interface ExecuteResult {
+    success: boolean;
+    output: string;
+    duration_ms: number;
+    exit_code: number;
+}
+export interface AgentExecutor {
+    execute(prompt: string, options: ExecuteOptions): Promise<ExecuteResult>;
+    abort(): void;
+}
+/**
+ * Executes tasks via `claude --print` — one-shot CLI invocation.
+ * Prompt is piped via stdin. Stdout is captured as the result.
+ */
+export declare class LoopExecutor implements AgentExecutor {
+    private process;
+    private aborted;
+    execute(prompt: string, options: ExecuteOptions): Promise<ExecuteResult>;
+    abort(): void;
+}
+/**
+ * Executes tasks via WebSocket transport to Claude CLI.
+ * Uses the persistent ClaudeWSTransport singleton — no process-per-call overhead.
+ *
+ * Protocol based on reverse-engineering by The-Vibe-Company/companion:
+ * https://github.com/The-Vibe-Company/companion
+ */
+export declare class WSExecutor implements AgentExecutor {
+    execute(prompt: string, options: ExecuteOptions): Promise<ExecuteResult>;
+    abort(): void;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,mBAAmB,CAAC;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzE,KAAK,IAAI,IAAI,CAAC;CACf;AAMD;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAS;IAElB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAmG9E,KAAK,IAAI,IAAI;CAMd;AAMD;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,aAAa;IACxC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB9E,KAAK,IAAI,IAAI;CAGd"}