@code-rag/mcp-server 0.1.0

package/dist/tools/context.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { TokenBudgetOptimizer, } from '@code-rag/core';
+export const contextInputSchema = z.object({
+    file_path: z.string().min(1, 'file_path must not be empty').refine((s) => !s.includes('..'), 'file_path must not contain path traversal'),
+    include_tests: z.boolean().optional().default(true),
+    include_interfaces: z.boolean().optional().default(true),
+    max_tokens: z.number().int().positive().max(128000).optional().default(8000),
+});
+export async function handleContext(args, hybridSearch, contextExpander) {
+    const parsed = contextInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Invalid input',
+                        details: parsed.error.issues,
+                    }),
+                },
+            ],
+        };
+    }
+    if (!hybridSearch || !contextExpander) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        context: '',
+                        message: 'Services not initialized. Run indexing first.',
+                    }),
+                },
+            ],
+        };
+    }
+    const { file_path, max_tokens } = parsed.data;
+    try {
+        // Step 1: Search for chunks matching the file_path
+        const searchResult = await hybridSearch.search(file_path, { topK: 20 });
+        if (searchResult.isErr()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Search failed',
+                            message: searchResult.error.message,
+                        }),
+                    },
+                ],
+            };
+        }
+        // Filter to results that match the file path
+        let results = searchResult.value.filter((r) => r.chunk?.filePath?.includes(file_path));
+        // Apply optional filters for tests and interfaces
+        if (!parsed.data.include_tests) {
+            results = results.filter((r) => !r.chunk?.filePath?.includes('.test.') &&
+                !r.chunk?.filePath?.includes('.spec.') &&
+                !r.chunk?.filePath?.includes('__tests__'));
+        }
+        if (!parsed.data.include_interfaces) {
+            results = results.filter((r) => r.metadata?.chunkType !== 'interface' &&
+                r.metadata?.chunkType !== 'type_alias');
+        }
+        if (results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            context: '',
+                            message: `No chunks found for file: ${file_path}`,
+                        }),
+                    },
+                ],
+            };
+        }
+        // Step 2: Expand context via dependency graph
+        const expanded = contextExpander.expand(results);
+        // Step 3: Assemble within token budget (use caller's max_tokens)
+        const optimizer = new TokenBudgetOptimizer({ maxTokens: max_tokens });
+        const assembled = optimizer.assemble(expanded);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        context: assembled.content,
+                        token_count: assembled.tokenCount,
+                        truncated: assembled.truncated,
+                        primary_chunks: assembled.primaryChunks.length,
+                        related_chunks: assembled.relatedChunks.length,
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: 'Context assembly failed', message }),
+                },
+            ],
+        };
+    }
+}

package/dist/tools/context.js.map

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

package/dist/tools/docs.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import type { HybridSearch, ReRanker } from '@code-rag/core';
+export declare const docsInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        markdown: "markdown";
+        confluence: "confluence";
+        all: "all";
+    }>>>;
+    file_path: z.ZodOptional<z.ZodString>;
+    top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type DocsInput = z.infer<typeof docsInputSchema>;
+export interface DocsToolResult {
+    file_path: string;
+    heading: string;
+    content: string;
+    nl_summary: string;
+    score: number;
+    source: 'markdown' | 'confluence' | 'unknown';
+}
+export declare function handleDocs(args: Record<string, unknown>, hybridSearch: HybridSearch | null, reranker?: ReRanker | null): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;

package/dist/tools/docs.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+export const docsInputSchema = z.object({
+    query: z.string().min(1, 'query must not be empty'),
+    source: z.enum(['markdown', 'confluence', 'all']).optional().default('all'),
+    file_path: z.string().refine((s) => !s.includes('..'), 'file_path must not contain path traversal').optional(),
+    top_k: z.number().int().positive().max(100).optional().default(10),
+});
+function inferSource(filePath) {
+    if (filePath.endsWith('.md') || filePath.endsWith('.mdx')) {
+        return 'markdown';
+    }
+    if (filePath.startsWith('confluence://') || filePath.includes('/confluence/')) {
+        return 'confluence';
+    }
+    return 'unknown';
+}
+function formatDocResult(result) {
+    const filePath = result.chunk?.filePath ?? '';
+    return {
+        file_path: filePath,
+        heading: result.metadata?.docTitle ?? result.metadata?.name ?? '',
+        content: result.content,
+        nl_summary: result.nlSummary,
+        score: result.score,
+        source: inferSource(filePath),
+    };
+}
+export async function handleDocs(args, hybridSearch, reranker = null) {
+    const parsed = docsInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Invalid input',
+                        details: parsed.error.issues,
+                    }),
+                },
+            ],
+        };
+    }
+    if (!hybridSearch) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        results: [],
+                        message: 'Search index not initialized. Run indexing first.',
+                    }),
+                },
+            ],
+        };
+    }
+    const { query, source, file_path, top_k } = parsed.data;
+    try {
+        const searchResult = await hybridSearch.search(query, { topK: top_k });
+        if (searchResult.isErr()) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Search failed',
+                            message: searchResult.error.message,
+                        }),
+                    },
+                ],
+            };
+        }
+        let results = searchResult.value;
+        // Filter to doc chunks only
+        results = results.filter((r) => r.metadata?.chunkType === 'doc');
+        // Filter by source type
+        if (source !== 'all') {
+            results = results.filter((r) => {
+                const filePath = r.chunk?.filePath ?? '';
+                const detectedSource = inferSource(filePath);
+                return detectedSource === source;
+            });
+        }
+        // Filter by file path
+        if (file_path) {
+            results = results.filter((r) => r.chunk?.filePath?.includes(file_path));
+        }
+        // Re-rank results if reranker is available
+        if (reranker && results.length > 0) {
+            const rerankResult = await reranker.rerank(query, results);
+            if (rerankResult.isOk()) {
+                results = rerankResult.value;
+            }
+            // If reranking fails, fall back to original results (don't fail the search)
+        }
+        const formatted = results.map(formatDocResult);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ results: formatted }) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: 'Docs search failed', message }),
+                },
+            ],
+        };
+    }
+}

package/dist/tools/docs.js.map

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

package/dist/tools/docs.test.d.ts

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

package/dist/tools/docs.test.js

@@ -0,0 +1,357 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { ok, err } from 'neverthrow';
+import { handleDocs, docsInputSchema } from './docs.js';
+import { EmbedError } from '@coderag/core';
+// --- Helpers ---
+function makeDocResult(overrides = {}) {
+    return {
+        chunkId: 'doc-chunk-1',
+        content: '## Getting Started\n\nInstall with `pnpm install`.',
+        nlSummary: 'Instructions for getting started with the project',
+        score: 0.9,
+        method: 'hybrid',
+        metadata: {
+            chunkType: 'doc',
+            name: 'Getting Started',
+            declarations: [],
+            imports: [],
+            exports: [],
+            docTitle: 'Getting Started',
+        },
+        chunk: {
+            id: 'doc-chunk-1',
+            content: '## Getting Started\n\nInstall with `pnpm install`.',
+            nlSummary: 'Instructions for getting started with the project',
+            filePath: 'docs/README.md',
+            startLine: 1,
+            endLine: 5,
+            language: 'markdown',
+            metadata: {
+                chunkType: 'doc',
+                name: 'Getting Started',
+                declarations: [],
+                imports: [],
+                exports: [],
+                docTitle: 'Getting Started',
+            },
+        },
+        ...overrides,
+    };
+}
+function makeConfluenceResult(overrides = {}) {
+    return {
+        chunkId: 'confluence-chunk-1',
+        content: '# API Reference\n\nEndpoint documentation.',
+        nlSummary: 'API reference documentation from Confluence',
+        score: 0.85,
+        method: 'hybrid',
+        metadata: {
+            chunkType: 'doc',
+            name: 'API Reference',
+            declarations: [],
+            imports: [],
+            exports: [],
+            docTitle: 'API Reference',
+        },
+        chunk: {
+            id: 'confluence-chunk-1',
+            content: '# API Reference\n\nEndpoint documentation.',
+            nlSummary: 'API reference documentation from Confluence',
+            filePath: 'confluence://spaces/DEV/pages/12345',
+            startLine: 1,
+            endLine: 3,
+            language: 'markdown',
+            metadata: {
+                chunkType: 'doc',
+                name: 'API Reference',
+                declarations: [],
+                imports: [],
+                exports: [],
+                docTitle: 'API Reference',
+            },
+        },
+        ...overrides,
+    };
+}
+function makeCodeResult() {
+    return {
+        chunkId: 'code-chunk-1',
+        content: 'function hello() {}',
+        nlSummary: 'A greeting function',
+        score: 0.8,
+        method: 'hybrid',
+        metadata: {
+            chunkType: 'function',
+            name: 'hello',
+            declarations: [],
+            imports: [],
+            exports: [],
+        },
+        chunk: {
+            id: 'code-chunk-1',
+            content: 'function hello() {}',
+            nlSummary: 'A greeting function',
+            filePath: 'src/hello.ts',
+            startLine: 1,
+            endLine: 1,
+            language: 'typescript',
+            metadata: {
+                chunkType: 'function',
+                name: 'hello',
+                declarations: [],
+                imports: [],
+                exports: [],
+            },
+        },
+    };
+}
+function parseResponse(response) {
+    return JSON.parse(response.content[0].text);
+}
+// --- Input Schema Validation ---
+describe('docsInputSchema', () => {
+    it('should accept valid input with just query', () => {
+        const result = docsInputSchema.safeParse({ query: 'getting started' });
+        expect(result.success).toBe(true);
+    });
+    it('should reject empty query', () => {
+        const result = docsInputSchema.safeParse({ query: '' });
+        expect(result.success).toBe(false);
+    });
+    it('should reject missing query', () => {
+        const result = docsInputSchema.safeParse({});
+        expect(result.success).toBe(false);
+    });
+    it('should apply default source of all', () => {
+        const result = docsInputSchema.parse({ query: 'test' });
+        expect(result.source).toBe('all');
+    });
+    it('should accept markdown source', () => {
+        const result = docsInputSchema.parse({ query: 'test', source: 'markdown' });
+        expect(result.source).toBe('markdown');
+    });
+    it('should accept confluence source', () => {
+        const result = docsInputSchema.parse({ query: 'test', source: 'confluence' });
+        expect(result.source).toBe('confluence');
+    });
+    it('should reject invalid source', () => {
+        const result = docsInputSchema.safeParse({ query: 'test', source: 'wiki' });
+        expect(result.success).toBe(false);
+    });
+    it('should reject file_path with path traversal', () => {
+        const result = docsInputSchema.safeParse({ query: 'test', file_path: '../../etc/passwd' });
+        expect(result.success).toBe(false);
+    });
+    it('should accept valid file_path', () => {
+        const result = docsInputSchema.safeParse({ query: 'test', file_path: 'docs/guide.md' });
+        expect(result.success).toBe(true);
+    });
+    it('should apply default top_k of 10', () => {
+        const result = docsInputSchema.parse({ query: 'test' });
+        expect(result.top_k).toBe(10);
+    });
+    it('should reject top_k greater than 100', () => {
+        const result = docsInputSchema.safeParse({ query: 'test', top_k: 101 });
+        expect(result.success).toBe(false);
+    });
+    it('should reject non-positive top_k', () => {
+        const result = docsInputSchema.safeParse({ query: 'test', top_k: 0 });
+        expect(result.success).toBe(false);
+    });
+});
+// --- Handler Tests ---
+describe('handleDocs', () => {
+    let mockHybridSearch;
+    let mockReranker;
+    beforeEach(() => {
+        mockHybridSearch = {
+            search: vi.fn(),
+        };
+        mockReranker = {
+            rerank: vi.fn(),
+        };
+    });
+    it('should return validation error for invalid input', async () => {
+        const response = await handleDocs({}, mockHybridSearch, mockReranker);
+        const parsed = parseResponse(response);
+        expect(parsed.error).toBe('Invalid input');
+    });
+    it('should return graceful message when search engine is null', async () => {
+        const response = await handleDocs({ query: 'test' }, null, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toEqual([]);
+        expect(parsed.message).toContain('not initialized');
+    });
+    it('should search and return only doc type chunks', async () => {
+        const docResult = makeDocResult();
+        const codeResult = makeCodeResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([docResult, codeResult]));
+        const response = await handleDocs({ query: 'getting started' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(mockHybridSearch.search).toHaveBeenCalledWith('getting started', { topK: 10 });
+        expect(parsed.results).toHaveLength(1);
+        expect(parsed.results[0].file_path).toBe('docs/README.md');
+    });
+    it('should filter by markdown source', async () => {
+        const mdResult = makeDocResult();
+        const confluenceResult = makeConfluenceResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([mdResult, confluenceResult]));
+        const response = await handleDocs({ query: 'docs', source: 'markdown' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toHaveLength(1);
+        expect(parsed.results[0].source).toBe('markdown');
+    });
+    it('should filter by confluence source', async () => {
+        const mdResult = makeDocResult();
+        const confluenceResult = makeConfluenceResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([mdResult, confluenceResult]));
+        const response = await handleDocs({ query: 'api', source: 'confluence' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toHaveLength(1);
+        expect(parsed.results[0].source).toBe('confluence');
+    });
+    it('should return all sources when source is all', async () => {
+        const mdResult = makeDocResult();
+        const confluenceResult = makeConfluenceResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([mdResult, confluenceResult]));
+        const response = await handleDocs({ query: 'docs', source: 'all' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toHaveLength(2);
+    });
+    it('should filter by file_path', async () => {
+        const guideResult = makeDocResult({
+            chunk: {
+                id: 'doc-guide',
+                content: 'Guide content',
+                nlSummary: 'A guide',
+                filePath: 'docs/guide.md',
+                startLine: 1,
+                endLine: 3,
+                language: 'markdown',
+                metadata: {
+                    chunkType: 'doc',
+                    name: 'Guide',
+                    declarations: [],
+                    imports: [],
+                    exports: [],
+                },
+            },
+        });
+        const readmeResult = makeDocResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([guideResult, readmeResult]));
+        const response = await handleDocs({ query: 'docs', file_path: 'guide.md' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toHaveLength(1);
+        expect(parsed.results[0].file_path).toBe('docs/guide.md');
+    });
+    it('should return empty results when no docs match', async () => {
+        const codeResult = makeCodeResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([codeResult]));
+        const response = await handleDocs({ query: 'test' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toHaveLength(0);
+    });
+    it('should handle search API errors gracefully', async () => {
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(err(new EmbedError('Connection refused')));
+        const response = await handleDocs({ query: 'test' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.error).toBe('Search failed');
+        expect(parsed.message).toContain('Connection refused');
+    });
+    it('should handle thrown exceptions', async () => {
+        vi.mocked(mockHybridSearch.search).mockRejectedValue(new Error('Unexpected'));
+        const response = await handleDocs({ query: 'test' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.error).toBe('Docs search failed');
+        expect(parsed.message).toBe('Unexpected');
+    });
+    it('should format doc results with heading and source', async () => {
+        const docResult = makeDocResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([docResult]));
+        const response = await handleDocs({ query: 'getting started' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results[0].file_path).toBe('docs/README.md');
+        expect(parsed.results[0].heading).toBe('Getting Started');
+        expect(parsed.results[0].content).toContain('pnpm install');
+        expect(parsed.results[0].nl_summary).toContain('getting started');
+        expect(parsed.results[0].score).toBe(0.9);
+        expect(parsed.results[0].source).toBe('markdown');
+    });
+    it('should apply custom top_k', async () => {
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([]));
+        await handleDocs({ query: 'test', top_k: 5 }, mockHybridSearch, null);
+        expect(mockHybridSearch.search).toHaveBeenCalledWith('test', { topK: 5 });
+    });
+    it('should re-rank results when reranker is available', async () => {
+        const docResult1 = makeDocResult({ score: 0.7 });
+        const docResult2 = makeDocResult({
+            chunkId: 'doc-chunk-2',
+            score: 0.9,
+            content: '## Advanced\n\nAdvanced usage.',
+            metadata: {
+                chunkType: 'doc',
+                name: 'Advanced',
+                declarations: [],
+                imports: [],
+                exports: [],
+                docTitle: 'Advanced',
+            },
+            chunk: {
+                id: 'doc-chunk-2',
+                content: '## Advanced\n\nAdvanced usage.',
+                nlSummary: 'Advanced usage guide',
+                filePath: 'docs/advanced.md',
+                startLine: 1,
+                endLine: 3,
+                language: 'markdown',
+                metadata: {
+                    chunkType: 'doc',
+                    name: 'Advanced',
+                    declarations: [],
+                    imports: [],
+                    exports: [],
+                    docTitle: 'Advanced',
+                },
+            },
+        });
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([docResult1, docResult2]));
+        // Reranker reverses order
+        vi.mocked(mockReranker.rerank).mockResolvedValue(ok([docResult2, docResult1]));
+        const response = await handleDocs({ query: 'advanced' }, mockHybridSearch, mockReranker);
+        const parsed = parseResponse(response);
+        expect(mockReranker.rerank).toHaveBeenCalled();
+        expect(parsed.results[0].heading).toBe('Advanced');
+    });
+    it('should fall back to original results when reranking fails', async () => {
+        const docResult = makeDocResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([docResult]));
+        vi.mocked(mockReranker.rerank).mockResolvedValue(err(new EmbedError('Rerank failed')));
+        const response = await handleDocs({ query: 'test' }, mockHybridSearch, mockReranker);
+        const parsed = parseResponse(response);
+        expect(parsed.results).toHaveLength(1);
+        expect(parsed.results[0].file_path).toBe('docs/README.md');
+    });
+    it('should not invoke reranker when no doc results remain after filtering', async () => {
+        const codeResult = makeCodeResult();
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([codeResult]));
+        await handleDocs({ query: 'test' }, mockHybridSearch, mockReranker);
+        expect(mockReranker.rerank).not.toHaveBeenCalled();
+    });
+    it('should use name as heading fallback when docTitle is missing', async () => {
+        const docResult = makeDocResult({
+            metadata: {
+                chunkType: 'doc',
+                name: 'Section Name',
+                declarations: [],
+                imports: [],
+                exports: [],
+                // No docTitle
+            },
+        });
+        vi.mocked(mockHybridSearch.search).mockResolvedValue(ok([docResult]));
+        const response = await handleDocs({ query: 'test' }, mockHybridSearch, null);
+        const parsed = parseResponse(response);
+        expect(parsed.results[0].heading).toBe('Section Name');
+    });
+});
+//# sourceMappingURL=docs.test.js.map

package/dist/tools/docs.test.js.map

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