@vinaes/succ 1.3.19

package/dist/lib/temporal.js.map

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

package/dist/lib/token-budget.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Token Budget Tracker
+ *
+ * Tracks cumulative token usage per daemon session for:
+ * - Smarter observer extraction triggers (real tokens vs byte estimate)
+ * - Cost reporting (extraction + synthesis LLM calls)
+ * - Session-level analytics
+ *
+ * State is ephemeral (in-memory per daemon process).
+ * Persisted to .succ/session-tokens.json on flush.
+ */
+export interface TokenBudgetEntry {
+    /** Tokens in transcript since last observation */
+    transcriptTokens: number;
+    /** Tokens consumed by LLM extraction calls */
+    extractionInputTokens: number;
+    /** Tokens generated by LLM extraction */
+    extractionOutputTokens: number;
+    /** Tokens consumed by LLM synthesis calls */
+    synthesisInputTokens: number;
+    /** Tokens generated by LLM synthesis */
+    synthesisOutputTokens: number;
+    /** Number of facts extracted */
+    factsExtracted: number;
+    /** Number of facts saved (after dedup/quality filter) */
+    factsSaved: number;
+    /** Timestamp of last update */
+    lastUpdate: number;
+}
+/**
+ * Get or create budget for a session.
+ */
+export declare function getBudget(sessionId: string): TokenBudgetEntry;
+/**
+ * Record new transcript content tokens.
+ * Called by the observer when reading new transcript content.
+ */
+export declare function recordTranscriptTokens(sessionId: string, text: string): number;
+/**
+ * Record extraction LLM usage.
+ * Called after extractSessionSummary completes.
+ */
+export declare function recordExtraction(sessionId: string, inputTokens: number, outputTokens: number, factsExtracted: number, factsSaved: number): void;
+/**
+ * Record synthesis LLM usage.
+ * Called after reflection synthesis completes.
+ */
+export declare function recordSynthesis(sessionId: string, inputTokens: number, outputTokens: number): void;
+/**
+ * Get total LLM tokens consumed by this session (input + output).
+ */
+export declare function getTotalLLMTokens(sessionId: string): number;
+/**
+ * Check if a session has reached the transcript token threshold.
+ * Used by the observer to decide when to extract.
+ */
+export declare function hasReachedTokenThreshold(sessionId: string, threshold: number): boolean;
+/**
+ * Reset transcript token counter after extraction.
+ * Called by the observer after successful extraction.
+ */
+export declare function resetTranscriptCounter(sessionId: string): void;
+/**
+ * Flush all session budgets to disk for persistence across daemon restarts.
+ */
+export declare function flushBudgets(): void;
+/**
+ * Load budgets from disk (daemon startup).
+ */
+export declare function loadBudgets(): void;
+/**
+ * Remove budget for a session (session ended).
+ */
+export declare function removeBudget(sessionId: string): void;
+/**
+ * Get all active session budgets (for status reporting).
+ */
+export declare function getAllBudgets(): Map<string, TokenBudgetEntry>;
+//# sourceMappingURL=token-budget.d.ts.map

package/dist/lib/token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../src/lib/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAK7D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAYnC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAalC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE7D"}

package/dist/lib/token-budget.js

@@ -0,0 +1,146 @@
+/**
+ * Token Budget Tracker
+ *
+ * Tracks cumulative token usage per daemon session for:
+ * - Smarter observer extraction triggers (real tokens vs byte estimate)
+ * - Cost reporting (extraction + synthesis LLM calls)
+ * - Session-level analytics
+ *
+ * State is ephemeral (in-memory per daemon process).
+ * Persisted to .succ/session-tokens.json on flush.
+ */
+import fs from 'fs';
+import path from 'path';
+import { countTokens } from './token-counter.js';
+import { getSuccDir } from './config.js';
+// In-memory state: sessionId → budget
+const budgets = new Map();
+function createEmptyBudget() {
+    return {
+        transcriptTokens: 0,
+        extractionInputTokens: 0,
+        extractionOutputTokens: 0,
+        synthesisInputTokens: 0,
+        synthesisOutputTokens: 0,
+        factsExtracted: 0,
+        factsSaved: 0,
+        lastUpdate: Date.now(),
+    };
+}
+/**
+ * Get or create budget for a session.
+ */
+export function getBudget(sessionId) {
+    if (!budgets.has(sessionId)) {
+        budgets.set(sessionId, createEmptyBudget());
+    }
+    return budgets.get(sessionId);
+}
+/**
+ * Record new transcript content tokens.
+ * Called by the observer when reading new transcript content.
+ */
+export function recordTranscriptTokens(sessionId, text) {
+    const budget = getBudget(sessionId);
+    const tokens = countTokens(text);
+    budget.transcriptTokens += tokens;
+    budget.lastUpdate = Date.now();
+    return tokens;
+}
+/**
+ * Record extraction LLM usage.
+ * Called after extractSessionSummary completes.
+ */
+export function recordExtraction(sessionId, inputTokens, outputTokens, factsExtracted, factsSaved) {
+    const budget = getBudget(sessionId);
+    budget.extractionInputTokens += inputTokens;
+    budget.extractionOutputTokens += outputTokens;
+    budget.factsExtracted += factsExtracted;
+    budget.factsSaved += factsSaved;
+    budget.lastUpdate = Date.now();
+}
+/**
+ * Record synthesis LLM usage.
+ * Called after reflection synthesis completes.
+ */
+export function recordSynthesis(sessionId, inputTokens, outputTokens) {
+    const budget = getBudget(sessionId);
+    budget.synthesisInputTokens += inputTokens;
+    budget.synthesisOutputTokens += outputTokens;
+    budget.lastUpdate = Date.now();
+}
+/**
+ * Get total LLM tokens consumed by this session (input + output).
+ */
+export function getTotalLLMTokens(sessionId) {
+    const budget = getBudget(sessionId);
+    return (budget.extractionInputTokens +
+        budget.extractionOutputTokens +
+        budget.synthesisInputTokens +
+        budget.synthesisOutputTokens);
+}
+/**
+ * Check if a session has reached the transcript token threshold.
+ * Used by the observer to decide when to extract.
+ */
+export function hasReachedTokenThreshold(sessionId, threshold) {
+    const budget = getBudget(sessionId);
+    return budget.transcriptTokens >= threshold;
+}
+/**
+ * Reset transcript token counter after extraction.
+ * Called by the observer after successful extraction.
+ */
+export function resetTranscriptCounter(sessionId) {
+    const budget = getBudget(sessionId);
+    budget.transcriptTokens = 0;
+    budget.lastUpdate = Date.now();
+}
+/**
+ * Flush all session budgets to disk for persistence across daemon restarts.
+ */
+export function flushBudgets() {
+    try {
+        const succDir = getSuccDir();
+        const filePath = path.join(succDir, 'session-tokens.json');
+        const data = {};
+        for (const [sessionId, budget] of budgets) {
+            data[sessionId] = budget;
+        }
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+    }
+    catch {
+        // Non-critical — budgets are ephemeral
+    }
+}
+/**
+ * Load budgets from disk (daemon startup).
+ */
+export function loadBudgets() {
+    try {
+        const succDir = getSuccDir();
+        const filePath = path.join(succDir, 'session-tokens.json');
+        if (fs.existsSync(filePath)) {
+            const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            for (const [sessionId, budget] of Object.entries(data)) {
+                budgets.set(sessionId, budget);
+            }
+        }
+    }
+    catch {
+        // Non-critical
+    }
+}
+/**
+ * Remove budget for a session (session ended).
+ */
+export function removeBudget(sessionId) {
+    budgets.delete(sessionId);
+}
+/**
+ * Get all active session budgets (for status reporting).
+ */
+export function getAllBudgets() {
+    return new Map(budgets);
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/lib/token-budget.js.map

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

package/dist/lib/token-counter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Simple token counter utility.
+ *
+ * Uses Anthropic's recommended heuristic: ~3.5 characters per token.
+ * This balances accuracy across English (~4), code (~3.5), and other languages (~2).
+ *
+ * Reference: https://platform.claude.com/docs/en/build-with-claude/token-counting
+ */
+/**
+ * Estimate token count for a string.
+ * Uses ~3.5 chars/token (Anthropic's recommended heuristic).
+ */
+export declare function countTokens(text: string): number;
+/**
+ * Estimate token count for an array of strings.
+ */
+export declare function countTokensArray(texts: string[]): number;
+/**
+ * Format token count for display (e.g., "1.2M", "45K", "890").
+ */
+export declare function formatTokens(tokens: number): string;
+/**
+ * Calculate compression ratio (how much was saved).
+ * Returns "99.98% saved" style string.
+ */
+export declare function compressionPercent(original: number, compressed: number): string;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/lib/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/lib/token-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ/E"}

package/dist/lib/token-counter.js

@@ -0,0 +1,52 @@
+/**
+ * Simple token counter utility.
+ *
+ * Uses Anthropic's recommended heuristic: ~3.5 characters per token.
+ * This balances accuracy across English (~4), code (~3.5), and other languages (~2).
+ *
+ * Reference: https://platform.claude.com/docs/en/build-with-claude/token-counting
+ */
+// Anthropic's recommended heuristic for mixed content
+const CHARS_PER_TOKEN = 3.5;
+/**
+ * Estimate token count for a string.
+ * Uses ~3.5 chars/token (Anthropic's recommended heuristic).
+ */
+export function countTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+/**
+ * Estimate token count for an array of strings.
+ */
+export function countTokensArray(texts) {
+    return texts.reduce((sum, text) => sum + countTokens(text), 0);
+}
+/**
+ * Format token count for display (e.g., "1.2M", "45K", "890").
+ */
+export function formatTokens(tokens) {
+    if (tokens >= 1_000_000) {
+        return `${(tokens / 1_000_000).toFixed(1)}M`;
+    }
+    if (tokens >= 1_000) {
+        return `${(tokens / 1_000).toFixed(0)}K`;
+    }
+    return tokens.toString();
+}
+/**
+ * Calculate compression ratio (how much was saved).
+ * Returns "99.98% saved" style string.
+ */
+export function compressionPercent(original, compressed) {
+    if (original === 0)
+        return '0% saved';
+    const saved = ((original - compressed) / original) * 100;
+    // Avoid showing 100.0% - use more precision for high compression
+    if (saved >= 99.9 && saved < 100) {
+        return `${saved.toFixed(2)}% saved`;
+    }
+    return `${saved.toFixed(1)}% saved`;
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/lib/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../src/lib/token-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sDAAsD;AACtD,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,UAAkB;IACrE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC;IACzD,iEAAiE;IACjE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QACjC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC"}

package/dist/lib/tree-sitter/chunker-ts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AST-based code chunker using tree-sitter.
+ *
+ * Produces chunks aligned to symbol boundaries (functions, classes, methods)
+ * with metadata (symbolName, symbolType, signature, docComment).
+ *
+ * Falls back to null if tree-sitter is unavailable for the given file,
+ * signaling the caller to use the regex/line-based fallback.
+ */
+import type { TreeSitterChunk } from './types.js';
+/**
+ * Chunk source code using tree-sitter AST analysis.
+ *
+ * Strategy:
+ * 1. Parse the file with tree-sitter
+ * 2. Extract all top-level symbols (functions, classes, etc.)
+ * 3. Create a chunk per symbol, including leading comments/whitespace
+ * 4. Collect any "orphan" lines between symbols into separate chunks
+ * 5. Split oversized chunks to fit model context limits
+ *
+ * @returns Array of chunks with metadata, or null if tree-sitter unavailable
+ */
+export declare function chunkCodeWithTreeSitter(content: string, filePath: string): Promise<TreeSitterChunk[] | null>;
+//# sourceMappingURL=chunker-ts.d.ts.map

package/dist/lib/tree-sitter/chunker-ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker-ts.d.ts","sourceRoot":"","sources":["../../../src/lib/tree-sitter/chunker-ts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,YAAY,CAAC;AAQ9D;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAqFnC"}

package/dist/lib/tree-sitter/chunker-ts.js

@@ -0,0 +1,206 @@
+/**
+ * AST-based code chunker using tree-sitter.
+ *
+ * Produces chunks aligned to symbol boundaries (functions, classes, methods)
+ * with metadata (symbolName, symbolType, signature, docComment).
+ *
+ * Falls back to null if tree-sitter is unavailable for the given file,
+ * signaling the caller to use the regex/line-based fallback.
+ */
+import { getLanguageForExtension } from './types.js';
+import { parseFile } from './parser.js';
+import { extractSymbols } from './extractor.js';
+/** Max chunk size in characters (match existing chunker limit) */
+const MAX_CHUNK_CHARS = 4000;
+/**
+ * Chunk source code using tree-sitter AST analysis.
+ *
+ * Strategy:
+ * 1. Parse the file with tree-sitter
+ * 2. Extract all top-level symbols (functions, classes, etc.)
+ * 3. Create a chunk per symbol, including leading comments/whitespace
+ * 4. Collect any "orphan" lines between symbols into separate chunks
+ * 5. Split oversized chunks to fit model context limits
+ *
+ * @returns Array of chunks with metadata, or null if tree-sitter unavailable
+ */
+export async function chunkCodeWithTreeSitter(content, filePath) {
+    // Check if language is recognized
+    const ext = filePath.split('.').pop() || '';
+    const language = getLanguageForExtension(ext);
+    if (!language)
+        return null;
+    // Parse the file
+    const [tree, lang] = await parseFile(filePath, content);
+    if (!tree || !lang)
+        return null;
+    try {
+        // Extract symbols
+        const symbols = await extractSymbols(tree, content, lang);
+        const lines = content.split('\n');
+        if (symbols.length === 0) {
+            // No symbols found — return entire file as one chunk (or split if too large)
+            return splitLargeChunk({
+                content,
+                startLine: 1,
+                endLine: lines.length,
+            });
+        }
+        // Sort symbols by start position
+        const sorted = [...symbols].sort((a, b) => a.startRow - b.startRow);
+        const chunks = [];
+        let lastEndRow = 0; // 0-based, exclusive
+        for (const symbol of sorted) {
+            // Collect any orphan lines before this symbol (imports, comments, blank lines)
+            const gapStart = lastEndRow;
+            const symbolStartWithDoc = findChunkStart(symbol, lines, gapStart);
+            if (symbolStartWithDoc > gapStart) {
+                // There are orphan lines between the previous symbol and this one
+                const orphanContent = lines.slice(gapStart, symbolStartWithDoc).join('\n');
+                if (orphanContent.trim().length > 20) {
+                    chunks.push({
+                        content: orphanContent,
+                        startLine: gapStart + 1, // 1-based
+                        endLine: symbolStartWithDoc,
+                    });
+                }
+            }
+            // Create chunk for this symbol
+            const chunkStartRow = symbolStartWithDoc;
+            const chunkEndRow = symbol.endRow + 1; // exclusive, 0-based
+            const symbolContent = lines.slice(chunkStartRow, chunkEndRow).join('\n');
+            chunks.push({
+                content: symbolContent,
+                startLine: chunkStartRow + 1, // 1-based
+                endLine: chunkEndRow,
+                symbolName: symbol.name,
+                symbolType: symbol.type,
+                signature: symbol.signature,
+                docComment: symbol.docComment,
+            });
+            lastEndRow = Math.max(lastEndRow, chunkEndRow);
+        }
+        // Remaining lines after the last symbol
+        if (lastEndRow < lines.length) {
+            const remainingContent = lines.slice(lastEndRow).join('\n');
+            if (remainingContent.trim().length > 20) {
+                chunks.push({
+                    content: remainingContent,
+                    startLine: lastEndRow + 1,
+                    endLine: lines.length,
+                });
+            }
+        }
+        // Filter empty chunks and split oversized ones
+        const filtered = chunks.filter((c) => c.content.trim().length > 0);
+        return filtered.flatMap(splitLargeChunk);
+    }
+    finally {
+        // Free the tree to avoid memory leaks
+        tree.delete();
+    }
+}
+/**
+ * Find where a chunk should start, including leading doc comments
+ * and decorators that belong to this symbol.
+ *
+ * Walks backward from the symbol's start to include:
+ * - Adjacent comment lines (doc comments)
+ * - Decorator lines (e.g., @decorator)
+ * - Blank lines between decorator/comment groups and the definition
+ */
+function findChunkStart(symbol, lines, minRow) {
+    let start = symbol.startRow;
+    // Walk backward to include comments and decorators
+    while (start > minRow) {
+        const prevLine = lines[start - 1]?.trim();
+        if (!prevLine) {
+            // Blank line — check if there's a comment/decorator above it
+            if (start - 2 >= minRow) {
+                const lineAboveBlank = lines[start - 2]?.trim();
+                if (lineAboveBlank &&
+                    (lineAboveBlank.startsWith('//') ||
+                        lineAboveBlank.startsWith('/*') ||
+                        lineAboveBlank.startsWith('*') ||
+                        lineAboveBlank.startsWith('#') ||
+                        lineAboveBlank.startsWith('@') ||
+                        lineAboveBlank.startsWith('///'))) {
+                    start--;
+                    continue;
+                }
+            }
+            break;
+        }
+        if (prevLine.startsWith('//') ||
+            prevLine.startsWith('/*') ||
+            prevLine.startsWith('*') ||
+            prevLine.startsWith('*/') ||
+            prevLine.startsWith('#') ||
+            prevLine.startsWith('@') ||
+            prevLine.startsWith('///') ||
+            prevLine.startsWith('"""') ||
+            prevLine.startsWith("'''")) {
+            start--;
+        }
+        else {
+            break;
+        }
+    }
+    return start;
+}
+/**
+ * Split a chunk that exceeds MAX_CHUNK_CHARS into smaller pieces.
+ * Preserves metadata on the first sub-chunk.
+ */
+function splitLargeChunk(chunk) {
+    if (chunk.content.length <= MAX_CHUNK_CHARS) {
+        return [chunk];
+    }
+    const lines = chunk.content.split('\n');
+    const result = [];
+    let currentLines = [];
+    let currentSize = 0;
+    let currentStartLine = chunk.startLine;
+    let isFirst = true;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineSize = line.length + 1;
+        if (currentSize + lineSize > MAX_CHUNK_CHARS && currentLines.length > 0) {
+            const subChunk = {
+                content: currentLines.join('\n'),
+                startLine: currentStartLine,
+                endLine: currentStartLine + currentLines.length - 1,
+            };
+            // Copy metadata only to the first sub-chunk
+            if (isFirst) {
+                subChunk.symbolName = chunk.symbolName;
+                subChunk.symbolType = chunk.symbolType;
+                subChunk.signature = chunk.signature;
+                subChunk.docComment = chunk.docComment;
+                isFirst = false;
+            }
+            result.push(subChunk);
+            currentLines = [];
+            currentSize = 0;
+            currentStartLine = chunk.startLine + i;
+        }
+        currentLines.push(line);
+        currentSize += lineSize;
+    }
+    if (currentLines.length > 0) {
+        const subChunk = {
+            content: currentLines.join('\n'),
+            startLine: currentStartLine,
+            endLine: currentStartLine + currentLines.length - 1,
+        };
+        if (isFirst) {
+            subChunk.symbolName = chunk.symbolName;
+            subChunk.symbolType = chunk.symbolType;
+            subChunk.signature = chunk.signature;
+            subChunk.docComment = chunk.docComment;
+        }
+        result.push(subChunk);
+    }
+    return result;
+}
+//# sourceMappingURL=chunker-ts.js.map

package/dist/lib/tree-sitter/chunker-ts.js.map

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

package/dist/lib/tree-sitter/extractor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AST symbol extraction using tree-sitter queries.
+ *
+ * Shared infrastructure used by chunker, bm25, analyze, PRD context, quality scoring.
+ * Extracts functions, classes, interfaces, types with metadata (name, signature, docstring).
+ */
+import type { Tree, Node } from 'web-tree-sitter';
+import type { SymbolInfo } from './types.js';
+/**
+ * Extract all symbols from a parsed tree.
+ *
+ * @param tree - Parsed tree-sitter Tree
+ * @param sourceCode - Original source code
+ * @param language - Tree-sitter language name
+ * @returns Array of extracted symbols with metadata
+ */
+export declare function extractSymbols(tree: Tree, sourceCode: string, language: string): Promise<SymbolInfo[]>;
+/**
+ * Extract only function/method definitions.
+ */
+export declare function extractFunctions(tree: Tree, sourceCode: string, language: string): Promise<SymbolInfo[]>;
+/**
+ * Extract only class definitions.
+ */
+export declare function extractClasses(tree: Tree, sourceCode: string, language: string): Promise<SymbolInfo[]>;
+/**
+ * Extract only interface/trait definitions.
+ */
+export declare function extractInterfaces(tree: Tree, sourceCode: string, language: string): Promise<SymbolInfo[]>;
+/**
+ * Extract only type definitions (type aliases, enums, structs).
+ */
+export declare function extractTypes(tree: Tree, sourceCode: string, language: string): Promise<SymbolInfo[]>;
+/**
+ * Extract all identifier names from source code (for BM25 tokenization).
+ * This is a lightweight extraction that doesn't need full query matching.
+ */
+export declare function extractIdentifiers(rootNode: Node): string[];
+/**
+ * Reset the query cache (useful for testing).
+ */
+export declare function resetQueryCache(): void;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/lib/tree-sitter/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/lib/tree-sitter/extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAuB,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAwLzD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAoDvB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,EAAE,CAwB3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAUtC"}