codebase-context 1.6.2 → 1.8.0

package/dist/eval/types.d.ts

@@ -0,0 +1,59 @@
+import type { SearchOptions, CodebaseSearcher } from '../core/search.js';
+export interface EvalQuery {
+    id: number;
+    query: string;
+    category: string;
+    expectedPatterns?: string[];
+    expectedNotPatterns?: string[];
+    expectedTopFiles?: string[];
+    expectedNotTopFiles?: string[];
+    notes?: string;
+}
+export interface EvalFixture {
+    description?: string;
+    codebase?: string;
+    repository?: string;
+    frozenDate?: string;
+    notes?: string;
+    queries: EvalQuery[];
+}
+export interface EvalResult {
+    queryId: number;
+    query: string;
+    category: string;
+    expectedPatterns: string[];
+    expectedNotPatterns: string[];
+    topFile: string | null;
+    top3Files: string[];
+    top1Correct: boolean;
+    top3Recall: boolean;
+    specContaminated: boolean;
+    score: number;
+}
+export interface EvalSummary {
+    total: number;
+    top1Correct: number;
+    top1Accuracy: number;
+    top3RecallCount: number;
+    top3Recall: number;
+    specContaminatedCount: number;
+    specContaminationRate: number;
+    avgTopScore: number;
+    gateThreshold: number;
+    passesGate: boolean;
+    results: EvalResult[];
+}
+export interface EvaluateFixtureParams {
+    fixture: EvalFixture;
+    searcher: CodebaseSearcher;
+    limit?: number;
+    searchOptions?: SearchOptions;
+}
+export type EvalGate = number;
+export interface FormatEvalReportParams {
+    codebaseLabel: string;
+    fixturePath: string;
+    summary: EvalSummary;
+    redactPaths?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/eval/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/eval/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/eval/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/eval/types.js.map

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

package/dist/grammars/manifest.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Curated language-to-wasm mapping. Only these grammars are shipped as package assets.
+ * Adding a language here requires the corresponding wasm to be available in tree-sitter-wasms.
+ */
+export declare const CURATED_LANGUAGE_TO_WASM: Record<string, string>;
+/**
+ * Returns true if the given language has a curated Tree-sitter grammar.
+ */
+export declare function supportsCuratedTreeSitter(language: string): boolean;
+/**
+ * Resolves the directory containing packaged grammar wasm files.
+ *
+ * - Honors `CODEBASE_CONTEXT_TS_GRAMMAR_DIR` env override.
+ * - Otherwise resolves to `{packageRoot}/grammars` using the caller's `import.meta.url`.
+ */
+export declare function resolveGrammarDir(moduleUrl: string): string;
+/**
+ * Resolves the full path to a grammar wasm file for a given language.
+ *
+ * @returns `{ wasmFile, wasmPath }` or throws if the language is not curated.
+ */
+export declare function resolveGrammarPath(language: string, moduleUrl: string): {
+    wasmFile: string;
+    wasmPath: string;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/grammars/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/grammars/manifest.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAoB3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQxC"}

package/dist/grammars/manifest.js

@@ -0,0 +1,64 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Curated language-to-wasm mapping. Only these grammars are shipped as package assets.
+ * Adding a language here requires the corresponding wasm to be available in tree-sitter-wasms.
+ */
+export const CURATED_LANGUAGE_TO_WASM = {
+    javascript: 'tree-sitter-javascript.wasm',
+    typescript: 'tree-sitter-typescript.wasm',
+    typescriptreact: 'tree-sitter-tsx.wasm',
+    python: 'tree-sitter-python.wasm',
+    go: 'tree-sitter-go.wasm',
+    rust: 'tree-sitter-rust.wasm',
+    java: 'tree-sitter-java.wasm',
+    c: 'tree-sitter-c.wasm',
+    cpp: 'tree-sitter-cpp.wasm',
+    csharp: 'tree-sitter-c_sharp.wasm',
+    kotlin: 'tree-sitter-kotlin.wasm'
+};
+/**
+ * Returns true if the given language has a curated Tree-sitter grammar.
+ */
+export function supportsCuratedTreeSitter(language) {
+    return language in CURATED_LANGUAGE_TO_WASM;
+}
+/**
+ * Resolves the directory containing packaged grammar wasm files.
+ *
+ * - Honors `CODEBASE_CONTEXT_TS_GRAMMAR_DIR` env override.
+ * - Otherwise resolves to `{packageRoot}/grammars` using the caller's `import.meta.url`.
+ */
+export function resolveGrammarDir(moduleUrl) {
+    const override = process.env.CODEBASE_CONTEXT_TS_GRAMMAR_DIR;
+    if (override) {
+        return path.resolve(override);
+    }
+    // moduleUrl is expected to be somewhere inside {packageRoot}/dist/ or {packageRoot}/src/
+    const thisFile = fileURLToPath(moduleUrl);
+    // Walk up from the file to find the package root (parent of src/ or dist/)
+    let dir = path.dirname(thisFile);
+    while (dir !== path.dirname(dir)) {
+        const base = path.basename(dir);
+        if (base === 'src' || base === 'dist') {
+            return path.join(path.dirname(dir), 'grammars');
+        }
+        dir = path.dirname(dir);
+    }
+    // Fallback: sibling grammars/ relative to file
+    return path.join(path.dirname(thisFile), '..', '..', 'grammars');
+}
+/**
+ * Resolves the full path to a grammar wasm file for a given language.
+ *
+ * @returns `{ wasmFile, wasmPath }` or throws if the language is not curated.
+ */
+export function resolveGrammarPath(language, moduleUrl) {
+    const wasmFile = CURATED_LANGUAGE_TO_WASM[language];
+    if (!wasmFile) {
+        throw new Error(`No curated grammar for language '${language}'.`);
+    }
+    const grammarDir = resolveGrammarDir(moduleUrl);
+    return { wasmFile, wasmPath: path.join(grammarDir, wasmFile) };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/grammars/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/grammars/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,UAAU,EAAE,6BAA6B;IACzC,UAAU,EAAE,6BAA6B;IACzC,eAAe,EAAE,sBAAsB;IACvC,MAAM,EAAE,yBAAyB;IACjC,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,uBAAuB;IAC7B,CAAC,EAAE,oBAAoB;IACvB,GAAG,EAAE,sBAAsB;IAC3B,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,yBAAyB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,QAAQ,IAAI,wBAAwB,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;IAC7D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,yFAAyF;IACzF,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1C,2EAA2E;IAC3E,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;QAClD,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,+CAA+C;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,24 @@
 #!/usr/bin/env node
+/**
+ * MCP Server for Codebase Context
+ * Provides codebase indexing and semantic search capabilities
+ */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import { CodebaseIndexer } from './core/indexer.js';
 import type { IndexingStats } from './types/index.js';
+import { TOOLS } from './tools/index.js';
 declare function resolveRootPath(): string;
+export declare const INDEX_CONSUMING_TOOL_NAMES: readonly ["search_codebase", "get_symbol_references", "detect_circular_dependencies", "get_team_patterns", "get_codebase_metadata"];
+export declare const INDEX_CONSUMING_RESOURCE_NAMES: readonly ["Codebase Intelligence"];
+type IndexStatus = 'ready' | 'rebuild-required' | 'indexing' | 'unknown';
+type IndexConfidence = 'high' | 'low';
+type IndexAction = 'served' | 'rebuild-started' | 'rebuilt-and-served' | 'rebuild-failed';
+export type IndexSignal = {
+    status: IndexStatus;
+    confidence: IndexConfidence;
+    action: IndexAction;
+    reason?: string;
+};
 export interface IndexState {
     status: 'idle' | 'indexing' | 'ready' | 'error';
     lastIndexed?: Date;
@@ -12,7 +27,6 @@ export interface IndexState {
     indexer?: CodebaseIndexer;
 }
 declare const server: Server;
-declare const TOOLS: Tool[];
 declare function performIndexing(incrementalOnly?: boolean): Promise<void>;
 declare function shouldReindex(): Promise<boolean>;
 export { server, performIndexing, resolveRootPath, shouldReindex, TOOLS };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAKL,IAAI,EAEL,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,kBAAkB,CAAC;AAqC1B,iBAAS,eAAe,IAAI,MAAM,CAejC;AAmFD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAWD,QAAA,MAAM,MAAM,EAAE,MAWb,CAAC;AAEF,QAAA,MAAM,KAAK,EAAE,IAAI,EA+OhB,CAAC;AAiOF,iBAAe,eAAe,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDvE;AAED,iBAAe,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ/C;AAo3CD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AASnE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,kBAAkB,CAAC;AAuB1B,OAAO,EAAE,KAAK,EAAkC,MAAM,kBAAkB,CAAC;AAMzE,iBAAS,eAAe,IAAI,MAAM,CAejC;AAmBD,eAAO,MAAM,0BAA0B,qIAM7B,CAAC;AAEX,eAAO,MAAM,8BAA8B,oCAAqC,CAAC;AAEjF,KAAK,WAAW,GAAG,OAAO,GAAG,kBAAkB,GAAG,UAAU,GAAG,SAAS,CAAC;AACzE,KAAK,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AACtC,KAAK,WAAW,GAAG,QAAQ,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkIF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAaD,QAAA,MAAM,MAAM,EAAE,MAWb,CAAC;AA+SF,iBAAe,eAAe,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAavE;AAED,iBAAe,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ/C;AA2LD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC"}