@code-rag/core 0.1.0

package/dist/backlog/jira-reference-scanner.test.js.map

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

package/dist/backlog/types.d.ts

@@ -0,0 +1,22 @@
+export type BacklogItemType = 'epic' | 'story' | 'task' | 'bug' | 'feature';
+export interface BacklogItem {
+    id: string;
+    externalId: string;
+    title: string;
+    description: string;
+    type: BacklogItemType;
+    state: string;
+    assignedTo?: string;
+    tags: string[];
+    linkedCodePaths: string[];
+    url?: string;
+    metadata: Record<string, unknown>;
+}
+export interface BacklogQuery {
+    text?: string;
+    types?: BacklogItemType[];
+    states?: string[];
+    assignedTo?: string;
+    tags?: string[];
+    limit?: number;
+}

package/dist/backlog/types.js

@@ -0,0 +1 @@
+export {};

package/dist/backlog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backlog/types.ts"],"names":[],"mappings":""}

package/dist/chunker/ast-chunker.d.ts

@@ -0,0 +1,45 @@
+import { type Result } from 'neverthrow';
+import type { Chunker, ParsedFile } from '../types/provider.js';
+import { ChunkError } from '../types/provider.js';
+import type { Chunk } from '../types/chunk.js';
+/**
+ * Configuration for the ASTChunker.
+ */
+export interface ASTChunkerConfig {
+    /** Maximum number of tokens per chunk (approximated as content.length / 4). */
+    maxTokensPerChunk: number;
+}
+/**
+ * AST-aware chunking engine that splits parsed source files into semantically
+ * meaningful chunks based on top-level declarations extracted by tree-sitter.
+ *
+ * Strategy:
+ * 1. Walk top-level declarations from ParsedFile.declarations
+ * 2. Map each declaration to its line range in the source
+ * 3. Group consecutive non-declaration lines with adjacent declarations
+ * 4. If a single declaration exceeds maxTokensPerChunk, split it at logical
+ *    points (blank lines, closing braces)
+ * 5. Generate deterministic chunk IDs as SHA-256 hashes
+ */
+export declare class ASTChunker implements Chunker {
+    private readonly maxTokensPerChunk;
+    constructor(config: ASTChunkerConfig);
+    chunk(parsed: ParsedFile): Promise<Result<Chunk[], ChunkError>>;
+    /**
+     * Core chunking logic. Separated from `chunk()` for cleaner error handling.
+     */
+    private createChunks;
+    /**
+     * Wrap the entire file content as one or more "module" chunks.
+     */
+    private createModuleChunks;
+    /**
+     * Build one or more Chunk objects from a content block.
+     * If the content exceeds maxTokensPerChunk, split it at logical points.
+     */
+    private buildChunks;
+    /**
+     * Construct a single Chunk object with a deterministic ID.
+     */
+    private makeChunk;
+}

package/dist/chunker/ast-chunker.js

@@ -0,0 +1,292 @@
+import { createHash } from 'node:crypto';
+import { ok, err } from 'neverthrow';
+import { ChunkError } from '../types/provider.js';
+/**
+ * Approximate number of tokens in a string using the simple heuristic of
+ * `content.length / 4`.
+ */
+function approximateTokens(content) {
+    return Math.ceil(content.length / 4);
+}
+/**
+ * Generate a deterministic chunk ID as a SHA-256 hash of
+ * `filePath + startLine + content`.
+ */
+function generateChunkId(filePath, startLine, content) {
+    return createHash('sha256')
+        .update(`${filePath}${startLine}${content}`)
+        .digest('hex');
+}
+/**
+ * Infer a ChunkType from a declaration name and surrounding content.
+ * This is a best-effort heuristic since ParsedFile.declarations only gives us
+ * names, not AST node types.
+ */
+function inferChunkType(content) {
+    const trimmed = content.trimStart();
+    // Order matters: check more specific patterns first
+    if (/^(export\s+)?(abstract\s+)?class\s+/m.test(trimmed))
+        return 'class';
+    if (/^(export\s+)?interface\s+/m.test(trimmed))
+        return 'interface';
+    if (/^(export\s+)?type\s+\w+/m.test(trimmed))
+        return 'type_alias';
+    if (/^(export\s+)?(async\s+)?function\s+/m.test(trimmed))
+        return 'function';
+    if (/^(export\s+)?(const|let|var)\s+\w+\s*=\s*(async\s+)?\(/m.test(trimmed))
+        return 'function';
+    if (/^(export\s+)?(const|let|var)\s+\w+\s*=\s*(async\s+)?function/m.test(trimmed))
+        return 'function';
+    if (/^(export\s+)?(const|let|var)\s+/m.test(trimmed))
+        return 'module';
+    if (/^import\s+/m.test(trimmed))
+        return 'import_block';
+    if (/^(def|async\s+def)\s+/m.test(trimmed))
+        return 'function';
+    if (/^class\s+/m.test(trimmed))
+        return 'class';
+    if (/^(func|fn|pub\s+fn)\s+/m.test(trimmed))
+        return 'function';
+    if (/^(struct|impl|trait|enum)\s+/m.test(trimmed))
+        return 'class';
+    return 'module';
+}
+/**
+ * Find the line ranges of declarations by scanning the file content
+ * for lines that start with the declaration name in typical declaration patterns.
+ * Returns regions sorted by startLine.
+ */
+function findDeclarationRegions(content, declarations) {
+    if (declarations.length === 0)
+        return [];
+    const lines = content.split('\n');
+    const regions = [];
+    // For each declaration name, find its start line and compute its end line.
+    // We track found lines to handle ordering.
+    const foundStarts = [];
+    for (const declName of declarations) {
+        // Search for the line that declares this name.
+        // Look for patterns like: function name, class name, const name, def name, etc.
+        const escapedName = declName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const pattern = new RegExp(`(?:^|\\s|export\\s+(?:default\\s+)?|async\\s+)(?:function\\*?|class|interface|type|const|let|var|enum|def|async\\s+def|fn|pub\\s+fn|func|struct|impl|trait|mod)\\s+${escapedName}\\b` +
+            `|(?:^|\\s)${escapedName}\\s*(?:=|\\(|<|:)`);
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (line !== undefined && pattern.test(line)) {
+                // Avoid duplicating a start line already assigned
+                const alreadyUsed = foundStarts.some((f) => f.startLine === i);
+                if (!alreadyUsed) {
+                    foundStarts.push({ name: declName, startLine: i });
+                    break;
+                }
+            }
+        }
+    }
+    // Sort by start line
+    foundStarts.sort((a, b) => a.startLine - b.startLine);
+    // Compute end lines: each declaration extends until the line before the next,
+    // or to the end of the file for the last one.
+    for (let i = 0; i < foundStarts.length; i++) {
+        const current = foundStarts[i];
+        if (!current)
+            continue;
+        const next = foundStarts[i + 1];
+        const endLine = next ? next.startLine - 1 : lines.length - 1;
+        regions.push({
+            name: current.name,
+            startLine: current.startLine,
+            endLine,
+        });
+    }
+    return regions;
+}
+/**
+ * Extract lines from content by 0-based line indices (inclusive).
+ */
+function extractLines(content, startLine, endLine) {
+    const lines = content.split('\n');
+    return lines.slice(startLine, endLine + 1).join('\n');
+}
+/**
+ * Split a large content block at logical points (blank lines, closing braces)
+ * into sub-blocks that each fit within the token limit.
+ */
+function splitAtLogicalPoints(content, maxTokens) {
+    const lines = content.split('\n');
+    const chunks = [];
+    let currentLines = [];
+    for (const line of lines) {
+        currentLines.push(line);
+        const currentContent = currentLines.join('\n');
+        if (approximateTokens(currentContent) >= maxTokens) {
+            // Try to split at the last blank line or closing brace in currentLines
+            let splitIndex = -1;
+            // Walk backwards to find a good split point
+            for (let i = currentLines.length - 2; i >= 0; i--) {
+                const candidate = currentLines[i];
+                if (candidate !== undefined && (candidate.trim() === '' || candidate.trim() === '}' || candidate.trim() === '};')) {
+                    splitIndex = i;
+                    break;
+                }
+            }
+            if (splitIndex > 0) {
+                // Split at the found point
+                const firstPart = currentLines.slice(0, splitIndex + 1).join('\n');
+                if (firstPart.trim().length > 0) {
+                    chunks.push(firstPart);
+                }
+                currentLines = currentLines.slice(splitIndex + 1);
+            }
+            else {
+                // No good split point found; force split at current position
+                const forcedContent = currentLines.join('\n');
+                if (forcedContent.trim().length > 0) {
+                    chunks.push(forcedContent);
+                }
+                currentLines = [];
+            }
+        }
+    }
+    // Remaining lines
+    if (currentLines.length > 0) {
+        const remaining = currentLines.join('\n');
+        if (remaining.trim().length > 0) {
+            chunks.push(remaining);
+        }
+    }
+    return chunks;
+}
+/**
+ * AST-aware chunking engine that splits parsed source files into semantically
+ * meaningful chunks based on top-level declarations extracted by tree-sitter.
+ *
+ * Strategy:
+ * 1. Walk top-level declarations from ParsedFile.declarations
+ * 2. Map each declaration to its line range in the source
+ * 3. Group consecutive non-declaration lines with adjacent declarations
+ * 4. If a single declaration exceeds maxTokensPerChunk, split it at logical
+ *    points (blank lines, closing braces)
+ * 5. Generate deterministic chunk IDs as SHA-256 hashes
+ */
+export class ASTChunker {
+    maxTokensPerChunk;
+    constructor(config) {
+        this.maxTokensPerChunk = config.maxTokensPerChunk;
+    }
+    async chunk(parsed) {
+        try {
+            const chunks = this.createChunks(parsed);
+            return ok(chunks);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return err(new ChunkError(`Failed to chunk ${parsed.filePath}: ${message}`));
+        }
+    }
+    /**
+     * Core chunking logic. Separated from `chunk()` for cleaner error handling.
+     */
+    createChunks(parsed) {
+        const { filePath, language, content, declarations } = parsed;
+        // Empty file produces no chunks
+        if (content.trim().length === 0) {
+            return [];
+        }
+        // No declarations: wrap entire file as a single "module" chunk
+        if (declarations.length === 0) {
+            return this.createModuleChunks(filePath, language, content);
+        }
+        // Find declaration regions in the source
+        const regions = findDeclarationRegions(content, declarations);
+        // If no regions were matched (declarations listed but not found in source),
+        // treat as a module chunk
+        if (regions.length === 0) {
+            return this.createModuleChunks(filePath, language, content);
+        }
+        const lines = content.split('\n');
+        const chunks = [];
+        // Handle any preamble (lines before the first declaration)
+        const firstRegion = regions[0];
+        if (firstRegion && firstRegion.startLine > 0) {
+            const preambleContent = extractLines(content, 0, firstRegion.startLine - 1);
+            if (preambleContent.trim().length > 0) {
+                const preambleChunks = this.buildChunks(filePath, language, preambleContent, 0, [], 'import_block');
+                chunks.push(...preambleChunks);
+            }
+        }
+        // Process each declaration region
+        for (const region of regions) {
+            const regionContent = extractLines(content, region.startLine, region.endLine);
+            // Trim trailing empty lines from the region content
+            const trimmedContent = regionContent.replace(/\n+$/, '');
+            if (trimmedContent.trim().length === 0)
+                continue;
+            const chunkType = inferChunkType(trimmedContent);
+            const regionChunks = this.buildChunks(filePath, language, trimmedContent, region.startLine, [region.name], chunkType);
+            chunks.push(...regionChunks);
+        }
+        // Handle any trailing content after the last declaration region
+        const lastRegion = regions[regions.length - 1];
+        if (lastRegion && lastRegion.endLine < lines.length - 1) {
+            const trailingContent = extractLines(content, lastRegion.endLine + 1, lines.length - 1);
+            if (trailingContent.trim().length > 0) {
+                const trailingChunks = this.buildChunks(filePath, language, trailingContent, lastRegion.endLine + 1, [], 'module');
+                chunks.push(...trailingChunks);
+            }
+        }
+        return chunks;
+    }
+    /**
+     * Wrap the entire file content as one or more "module" chunks.
+     */
+    createModuleChunks(filePath, language, content) {
+        return this.buildChunks(filePath, language, content, 0, [], 'module');
+    }
+    /**
+     * Build one or more Chunk objects from a content block.
+     * If the content exceeds maxTokensPerChunk, split it at logical points.
+     */
+    buildChunks(filePath, language, content, baseStartLine, declarations, chunkType) {
+        const tokens = approximateTokens(content);
+        if (tokens <= this.maxTokensPerChunk) {
+            const lineCount = content.split('\n').length;
+            return [
+                this.makeChunk(filePath, language, content, baseStartLine, baseStartLine + lineCount - 1, declarations, chunkType),
+            ];
+        }
+        // Content exceeds limit: split at logical points
+        const parts = splitAtLogicalPoints(content, this.maxTokensPerChunk);
+        const chunks = [];
+        let currentLine = baseStartLine;
+        for (const part of parts) {
+            const lineCount = part.split('\n').length;
+            const endLine = currentLine + lineCount - 1;
+            chunks.push(this.makeChunk(filePath, language, part, currentLine, endLine, declarations, chunkType));
+            currentLine = endLine + 1;
+        }
+        return chunks;
+    }
+    /**
+     * Construct a single Chunk object with a deterministic ID.
+     */
+    makeChunk(filePath, language, content, startLine, endLine, declarations, chunkType) {
+        const id = generateChunkId(filePath, startLine, content);
+        const name = declarations.length > 0 ? declarations.join(', ') : '(module)';
+        return {
+            id,
+            content,
+            nlSummary: '',
+            filePath,
+            startLine,
+            endLine,
+            language,
+            metadata: {
+                chunkType,
+                name,
+                declarations,
+                imports: [],
+                exports: [],
+            },
+        };
+    }
+}

package/dist/chunker/ast-chunker.js.map

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

package/dist/chunker/ast-chunker.test.d.ts

@@ -0,0 +1 @@
+export {};