codebase-context 1.6.2 → 1.8.0

package/dist/tools/detect-circular-dependencies.js

@@ -0,0 +1,117 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { InternalFileGraph } from '../utils/usage-tracker.js';
+import { RELATIONSHIPS_FILENAME } from '../constants/codebase-context.js';
+export const definition = {
+    name: 'detect_circular_dependencies',
+    description: 'Analyze the import graph to detect circular dependencies between files. ' +
+        'Circular dependencies can cause initialization issues, tight coupling, and maintenance problems. ' +
+        'Returns all detected cycles sorted by length (shorter cycles are often more problematic).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            scope: {
+                type: 'string',
+                description: "Optional path prefix to limit analysis (e.g., 'src/features', 'libs/shared')"
+            }
+        }
+    }
+};
+export async function handle(args, ctx) {
+    const { scope } = args;
+    try {
+        // Try relationships sidecar first (preferred), then intelligence
+        let graphDataSource = null;
+        let graphStats = null;
+        const relationshipsPath = path.join(path.dirname(ctx.paths.intelligence), RELATIONSHIPS_FILENAME);
+        try {
+            const relationshipsContent = await fs.readFile(relationshipsPath, 'utf-8');
+            const relationships = JSON.parse(relationshipsContent);
+            if (relationships?.graph) {
+                graphDataSource = relationships.graph;
+                graphStats = relationships.stats;
+            }
+        }
+        catch {
+            // Relationships sidecar not available, try intelligence
+        }
+        if (!graphDataSource) {
+            const intelligencePath = ctx.paths.intelligence;
+            const content = await fs.readFile(intelligencePath, 'utf-8');
+            const intelligence = JSON.parse(content);
+            if (intelligence.internalFileGraph) {
+                graphDataSource = intelligence.internalFileGraph;
+                graphStats = intelligence.internalFileGraph.stats;
+            }
+        }
+        if (!graphDataSource) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 'error',
+                            message: 'Internal file graph not found. Please run refresh_index to rebuild the index with cycle detection support.'
+                        }, null, 2)
+                    }
+                ]
+            };
+        }
+        // Reconstruct the graph from stored data
+        const graph = InternalFileGraph.fromJSON(graphDataSource, ctx.rootPath);
+        const cycles = graph.findCycles(scope);
+        const stats = graphStats || graph.getStats();
+        if (cycles.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 'success',
+                            message: scope
+                                ? `No circular dependencies detected in scope: ${scope}`
+                                : 'No circular dependencies detected in the codebase.',
+                            scope,
+                            graphStats: stats
+                        }, null, 2)
+                    }
+                ]
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'warning',
+                        message: `Found ${cycles.length} circular dependency cycle(s).`,
+                        scope,
+                        cycles: cycles.map((c) => ({
+                            files: c.files,
+                            length: c.length,
+                            severity: c.length === 2 ? 'high' : c.length <= 3 ? 'medium' : 'low'
+                        })),
+                        count: cycles.length,
+                        graphStats: stats,
+                        advice: 'Shorter cycles (length 2-3) are typically more problematic. Consider breaking the cycle by extracting shared dependencies.'
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'error',
+                        message: 'Failed to detect circular dependencies. Run indexing first.',
+                        error: error instanceof Error ? error.message : String(error)
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=detect-circular-dependencies.js.map

package/dist/tools/detect-circular-dependencies.js.map

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

package/dist/tools/get-codebase-metadata.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext, ToolResponse } from './types.js';
+export declare const definition: Tool;
+export declare function handle(_args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-codebase-metadata.d.ts.map

package/dist/tools/get-codebase-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-codebase-metadata.d.ts","sourceRoot":"","sources":["../../src/tools/get-codebase-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,eAAO,MAAM,UAAU,EAAE,IASxB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,YAAY,CAAC,CA8CvB"}

package/dist/tools/get-codebase-metadata.js

@@ -0,0 +1,53 @@
+import { promises as fs } from 'fs';
+import { CodebaseIndexer } from '../core/indexer.js';
+export const definition = {
+    name: 'get_codebase_metadata',
+    description: 'Get codebase metadata including framework information, dependencies, architecture patterns, ' +
+        'and project statistics.',
+    inputSchema: {
+        type: 'object',
+        properties: {}
+    }
+};
+export async function handle(_args, ctx) {
+    const indexer = new CodebaseIndexer({ rootPath: ctx.rootPath });
+    const metadata = await indexer.detectMetadata();
+    // Load team patterns from intelligence file
+    let teamPatterns = {};
+    try {
+        const intelligencePath = ctx.paths.intelligence;
+        const intelligenceContent = await fs.readFile(intelligencePath, 'utf-8');
+        const intelligence = JSON.parse(intelligenceContent);
+        if (intelligence.patterns) {
+            teamPatterns = {
+                dependencyInjection: intelligence.patterns.dependencyInjection,
+                stateManagement: intelligence.patterns.stateManagement,
+                componentInputs: intelligence.patterns.componentInputs
+            };
+        }
+    }
+    catch (_error) {
+        // No intelligence file or parsing error
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    status: 'success',
+                    metadata: {
+                        name: metadata.name,
+                        framework: metadata.framework,
+                        languages: metadata.languages,
+                        dependencies: metadata.dependencies.slice(0, 20),
+                        architecture: metadata.architecture,
+                        projectStructure: metadata.projectStructure,
+                        statistics: metadata.statistics,
+                        teamPatterns
+                    }
+                }, null, 2)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=get-codebase-metadata.js.map

package/dist/tools/get-codebase-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-codebase-metadata.js","sourceRoot":"","sources":["../../src/tools/get-codebase-metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,8FAA8F;QAC9F,yBAAyB;IAC3B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAA8B,EAC9B,GAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,4CAA4C;IAC5C,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC;QAChD,MAAM,mBAAmB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAErD,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC1B,YAAY,GAAG;gBACb,mBAAmB,EAAE,YAAY,CAAC,QAAQ,CAAC,mBAAmB;gBAC9D,eAAe,EAAE,YAAY,CAAC,QAAQ,CAAC,eAAe;gBACtD,eAAe,EAAE,YAAY,CAAC,QAAQ,CAAC,eAAe;aACvD,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,wCAAwC;IAC1C,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,MAAM,EAAE,SAAS;oBACjB,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;wBAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;wBAC7B,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;wBAChD,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;wBAC3C,UAAU,EAAE,QAAQ,CAAC,UAAU;wBAC/B,YAAY;qBACb;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-indexing-status.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext, ToolResponse } from './types.js';
+export declare const definition: Tool;
+export declare function handle(_args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-indexing-status.d.ts.map

package/dist/tools/get-indexing-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-indexing-status.d.ts","sourceRoot":"","sources":["../../src/tools/get-indexing-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,eAAO,MAAM,UAAU,EAAE,IASxB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,YAAY,CAAC,CAsCvB"}

package/dist/tools/get-indexing-status.js

@@ -0,0 +1,44 @@
+export const definition = {
+    name: 'get_indexing_status',
+    description: 'Get current indexing status: state, statistics, and progress. ' +
+        'Use refresh_index to manually trigger re-indexing when needed.',
+    inputSchema: {
+        type: 'object',
+        properties: {}
+    }
+};
+export async function handle(_args, ctx) {
+    const progress = ctx.indexState.indexer?.getProgress();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    status: ctx.indexState.status,
+                    rootPath: ctx.rootPath,
+                    lastIndexed: ctx.indexState.lastIndexed?.toISOString(),
+                    stats: ctx.indexState.stats
+                        ? {
+                            totalFiles: ctx.indexState.stats.totalFiles,
+                            indexedFiles: ctx.indexState.stats.indexedFiles,
+                            totalChunks: ctx.indexState.stats.totalChunks,
+                            duration: `${(ctx.indexState.stats.duration / 1000).toFixed(2)}s`,
+                            incremental: ctx.indexState.stats.incremental
+                        }
+                        : undefined,
+                    progress: progress
+                        ? {
+                            phase: progress.phase,
+                            percentage: progress.percentage,
+                            filesProcessed: progress.filesProcessed,
+                            totalFiles: progress.totalFiles
+                        }
+                        : undefined,
+                    error: ctx.indexState.error,
+                    hint: 'Use refresh_index to manually trigger re-indexing when needed.'
+                }, null, 2)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=get-indexing-status.js.map

package/dist/tools/get-indexing-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-indexing-status.js","sourceRoot":"","sources":["../../src/tools/get-indexing-status.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,gEAAgE;QAChE,gEAAgE;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAA8B,EAC9B,GAAgB;IAEhB,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,MAAM;oBAC7B,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE;oBACtD,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK;wBACzB,CAAC,CAAC;4BACE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU;4BAC3C,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY;4BAC/C,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW;4BAC7C,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;4BACjE,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW;yBAC9C;wBACH,CAAC,CAAC,SAAS;oBACb,QAAQ,EAAE,QAAQ;wBAChB,CAAC,CAAC;4BACE,KAAK,EAAE,QAAQ,CAAC,KAAK;4BACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;4BAC/B,cAAc,EAAE,QAAQ,CAAC,cAAc;4BACvC,UAAU,EAAE,QAAQ,CAAC,UAAU;yBAChC;wBACH,CAAC,CAAC,SAAS;oBACb,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK;oBAC3B,IAAI,EAAE,gEAAgE;iBACvE,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-memory.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext, ToolResponse } from './types.js';
+export declare const definition: Tool;
+export declare function handle(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-memory.d.ts.map

package/dist/tools/get-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-memory.d.ts","sourceRoot":"","sources":["../../src/tools/get-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS5D,eAAO,MAAM,UAAU,EAAE,IAyBxB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,YAAY,CAAC,CAkFvB"}

package/dist/tools/get-memory.js

@@ -0,0 +1,89 @@
+import { readMemoriesFile, filterMemories, applyUnfilteredLimit, withConfidence } from '../memory/store.js';
+export const definition = {
+    name: 'get_memory',
+    description: 'Retrieves team conventions, architectural decisions, and known gotchas.\n' +
+        'CALL BEFORE suggesting patterns, libraries, or architecture.\n\n' +
+        'Filters: category (tooling/architecture/testing/dependencies/conventions), type (convention/decision/gotcha), query (keyword search).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                description: 'Filter by category',
+                enum: ['tooling', 'architecture', 'testing', 'dependencies', 'conventions']
+            },
+            type: {
+                type: 'string',
+                description: 'Filter by memory type',
+                enum: ['convention', 'decision', 'gotcha', 'failure']
+            },
+            query: {
+                type: 'string',
+                description: 'Keyword search across memory and reason'
+            }
+        }
+    }
+};
+export async function handle(args, ctx) {
+    const { category, type, query } = args;
+    try {
+        const memoryPath = ctx.paths.memory;
+        const allMemories = await readMemoriesFile(memoryPath);
+        if (allMemories.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: 'success',
+                            message: "No team conventions recorded yet. Use 'remember' to build tribal knowledge or memory when the user corrects you over a repeatable pattern.",
+                            memories: [],
+                            count: 0
+                        }, null, 2)
+                    }
+                ]
+            };
+        }
+        const filtered = filterMemories(allMemories, { category, type, query });
+        const limited = applyUnfilteredLimit(filtered, { category, type, query }, 20);
+        // Enrich with confidence decay
+        const enriched = withConfidence(limited.memories);
+        const staleCount = enriched.filter((m) => m.stale).length;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'success',
+                        count: enriched.length,
+                        totalCount: limited.totalCount,
+                        truncated: limited.truncated,
+                        ...(staleCount > 0 && {
+                            staleCount,
+                            staleNote: `${staleCount} memor${staleCount === 1 ? 'y' : 'ies'} below 30% confidence. Consider reviewing or removing.`
+                        }),
+                        message: limited.truncated
+                            ? 'Showing 20 most recent. Use filters (category/type/query) for targeted results.'
+                            : undefined,
+                        memories: enriched
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'error',
+                        message: 'Failed to retrieve memories.',
+                        error: error instanceof Error ? error.message : String(error)
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=get-memory.js.map

package/dist/tools/get-memory.js.map

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

package/dist/tools/get-style-guide.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext, ToolResponse } from './types.js';
+export declare const definition: Tool;
+export declare function handle(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-style-guide.d.ts.map

package/dist/tools/get-style-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-style-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-style-guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,eAAO,MAAM,UAAU,EAAE,IAiBxB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,YAAY,CAAC,CA4JvB"}

package/dist/tools/get-style-guide.js

@@ -0,0 +1,151 @@
+import { promises as fs } from 'fs';
+import { glob } from 'glob';
+import path from 'path';
+export const definition = {
+    name: 'get_style_guide',
+    description: 'Query style guide rules and architectural patterns from project documentation.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Query for specific style guide rules (e.g., "component naming", "service patterns")'
+            },
+            category: {
+                type: 'string',
+                description: 'Filter by category (naming, structure, patterns, testing)'
+            }
+        }
+    }
+};
+export async function handle(args, ctx) {
+    const { query, category } = args;
+    const queryStr = typeof query === 'string' ? query.trim() : '';
+    const queryLower = queryStr.toLowerCase();
+    const queryTerms = queryLower.split(/\s+/).filter(Boolean);
+    const categoryLower = typeof category === 'string' ? category.trim().toLowerCase() : '';
+    const limitedMode = queryTerms.length === 0;
+    const LIMITED_MAX_FILES = 3;
+    const LIMITED_MAX_SECTIONS_PER_FILE = 2;
+    const styleGuidePatterns = [
+        'STYLE_GUIDE.md',
+        'CODING_STYLE.md',
+        'ARCHITECTURE.md',
+        'CONTRIBUTING.md',
+        'docs/style-guide.md',
+        'docs/coding-style.md',
+        'docs/ARCHITECTURE.md'
+    ];
+    const foundGuides = [];
+    for (const pattern of styleGuidePatterns) {
+        try {
+            const files = await glob(pattern, {
+                cwd: ctx.rootPath,
+                absolute: true
+            });
+            for (const file of files) {
+                try {
+                    // Normalize line endings to \n for consistent output
+                    const rawContent = await fs.readFile(file, 'utf-8');
+                    const content = rawContent.replace(/\r\n/g, '\n');
+                    const relativePath = path.relative(ctx.rootPath, file);
+                    // Find relevant sections based on query
+                    const sections = content.split(/^##\s+/m);
+                    const relevantSections = [];
+                    if (limitedMode) {
+                        const headings = (content.match(/^##\s+.+$/gm) || [])
+                            .map((h) => h.trim())
+                            .filter(Boolean)
+                            .slice(0, LIMITED_MAX_SECTIONS_PER_FILE);
+                        if (headings.length > 0) {
+                            relevantSections.push(...headings);
+                        }
+                        else {
+                            const words = content.split(/\s+/).filter(Boolean);
+                            if (words.length > 0) {
+                                relevantSections.push(`Overview: ${words.slice(0, 80).join(' ')}...`);
+                            }
+                        }
+                    }
+                    else {
+                        for (const section of sections) {
+                            const sectionLower = section.toLowerCase();
+                            const isRelevant = queryTerms.some((term) => sectionLower.includes(term));
+                            if (isRelevant) {
+                                // Limit section size to ~500 words
+                                const words = section.split(/\s+/);
+                                const truncated = words.slice(0, 500).join(' ');
+                                relevantSections.push('## ' + (words.length > 500 ? truncated + '...' : section.trim()));
+                            }
+                        }
+                    }
+                    const categoryMatch = !categoryLower ||
+                        relativePath.toLowerCase().includes(categoryLower) ||
+                        relevantSections.some((section) => section.toLowerCase().includes(categoryLower));
+                    if (!categoryMatch) {
+                        continue;
+                    }
+                    if (relevantSections.length > 0) {
+                        foundGuides.push({
+                            file: relativePath,
+                            content: content.slice(0, 200) + '...',
+                            relevantSections: relevantSections.slice(0, limitedMode ? LIMITED_MAX_SECTIONS_PER_FILE : 3)
+                        });
+                    }
+                }
+                catch (_e) {
+                    // Skip unreadable files
+                }
+            }
+        }
+        catch (_e) {
+            // Pattern didn't match, continue
+        }
+    }
+    const results = limitedMode ? foundGuides.slice(0, LIMITED_MAX_FILES) : foundGuides;
+    if (results.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'no_results',
+                        message: limitedMode
+                            ? 'No style guide files found in the default locations.'
+                            : `No style guide content found matching: ${queryStr}`,
+                        searchedPatterns: styleGuidePatterns,
+                        hint: limitedMode
+                            ? "Run get_style_guide with a query or category (e.g. category: 'testing') for targeted results."
+                            : "Try broader terms like 'naming', 'patterns', 'testing', 'components'"
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    status: 'success',
+                    query: queryStr || undefined,
+                    category,
+                    limited: limitedMode,
+                    notice: limitedMode
+                        ? 'No query provided. Results are capped. Provide query and/or category for targeted guidance.'
+                        : undefined,
+                    resultLimits: limitedMode
+                        ? {
+                            maxFiles: LIMITED_MAX_FILES,
+                            maxSectionsPerFile: LIMITED_MAX_SECTIONS_PER_FILE
+                        }
+                        : undefined,
+                    results,
+                    totalFiles: results.length,
+                    totalMatches: foundGuides.length
+                }, null, 2)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=get-style-guide.js.map

package/dist/tools/get-style-guide.js.map

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

package/dist/tools/get-symbol-references.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext, ToolResponse } from './types.js';
+export declare const definition: Tool;
+export declare function handle(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-symbol-references.d.ts.map

package/dist/tools/get-symbol-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-symbol-references.d.ts","sourceRoot":"","sources":["../../src/tools/get-symbol-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,eAAO,MAAM,UAAU,EAAE,IAmBxB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,YAAY,CAAC,CAiEvB"}

package/dist/tools/get-symbol-references.js

@@ -0,0 +1,70 @@
+import { findSymbolReferences } from '../core/symbol-references.js';
+export const definition = {
+    name: 'get_symbol_references',
+    description: 'Find concrete references to a symbol in indexed chunks. Returns total usageCount and top usage snippets.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            symbol: {
+                type: 'string',
+                description: 'Symbol name to find references for (for example: parseConfig or UserService)'
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of usage snippets to return (default: 10)',
+                default: 10
+            }
+        },
+        required: ['symbol']
+    }
+};
+export async function handle(args, ctx) {
+    const { symbol, limit } = args;
+    const normalizedSymbol = typeof symbol === 'string' ? symbol.trim() : '';
+    const normalizedLimit = typeof limit === 'number' && Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 10;
+    if (!normalizedSymbol) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'error',
+                        message: "Invalid params: 'symbol' is required and must be a non-empty string."
+                    }, null, 2)
+                }
+            ],
+            isError: true
+        };
+    }
+    const result = await findSymbolReferences(ctx.rootPath, normalizedSymbol, normalizedLimit);
+    if (result.status === 'error') {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'error',
+                        symbol: normalizedSymbol,
+                        message: result.message
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    status: 'success',
+                    symbol: result.symbol,
+                    usageCount: result.usageCount,
+                    usages: result.usages,
+                    confidence: result.confidence,
+                    isComplete: result.isComplete
+                }, null, 2)
+            }
+        ]
+    };
+}
+//# sourceMappingURL=get-symbol-references.js.map

package/dist/tools/get-symbol-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-symbol-references.js","sourceRoot":"","sources":["../../src/tools/get-symbol-references.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,0GAA0G;IAC5G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8EAA8E;aAC5F;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;gBACvE,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAA6B,EAC7B,GAAgB;IAEhB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAA6C,CAAC;IACxE,MAAM,gBAAgB,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,eAAe,GACnB,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5F,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,MAAM,EAAE,OAAO;wBACf,OAAO,EAAE,sEAAsE;qBAChF,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAE3F,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,MAAM,EAAE,OAAO;wBACf,MAAM,EAAE,gBAAgB;wBACxB,OAAO,EAAE,MAAM,CAAC,OAAO;qBACxB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-team-patterns.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext, ToolResponse } from './types.js';
+export declare const definition: Tool;
+export declare function handle(args: Record<string, unknown>, ctx: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=get-team-patterns.d.ts.map

package/dist/tools/get-team-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-team-patterns.d.ts","sourceRoot":"","sources":["../../src/tools/get-team-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ5D,eAAO,MAAM,UAAU,EAAE,IAexB,CAAC;AAEF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,YAAY,CAAC,CAuIvB"}