codesift-mcp 0.1.0 → 0.2.0

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

@@ -1,8 +1,16 @@
-import type { CodeSymbol, Reference } from "../types.js";
+import type { CodeSymbol, Reference, SymbolKind } from "../types.js";
 /**
  * Retrieve a single symbol by ID with fresh source from disk.
+ * When include_related is true (default), auto-prefetches:
+ *  - children (for classes/interfaces) — saves follow-up get_symbols call
+ *  - symbols in the same file that reference this symbol — saves find_references call
  */
-export declare function getSymbol(repo: string, symbolId: string): Promise<CodeSymbol | null>;
+export declare function getSymbol(repo: string, symbolId: string, options?: {
+    include_related?: boolean;
+}): Promise<{
+    symbol: CodeSymbol;
+    related?: CodeSymbol[];
+} | null>;
 /**
  * Retrieve multiple symbols by ID with fresh source from disk.
  * Groups reads by file to minimize disk I/O.
@@ -12,7 +20,30 @@ export declare function getSymbols(repo: string, symbolIds: string[]): Promise<C
  * Find references to a symbol name across indexed files.
  * Matches whole words only using word-boundary regex.
  */
+/**
+ * Batch find references for multiple symbols in one pass.
+ * Reads each file once instead of N times — critical for large repos.
+ */
+export declare function findReferencesBatch(repo: string, symbolNames: string[], filePattern?: string): Promise<Record<string, Reference[]>>;
 export declare function findReferences(repo: string, symbolName: string, filePattern?: string): Promise<Reference[]>;
+/** Format references as compact string for MCP output. Groups by file to avoid repeating paths. */
+export declare function formatRefsCompact(refs: Reference[]): string;
+/** Format a CodeSymbol as compact text: header line + source. ~70% less tokens than JSON. */
+export declare function formatSymbolCompact(sym: CodeSymbol): string;
+/** Format multiple CodeSymbols as compact text, separated by blank lines. */
+export declare function formatSymbolsCompact(syms: CodeSymbol[]): string;
+/** Format ContextBundle as compact text. */
+export declare function formatBundleCompact(bundle: {
+    symbol: CodeSymbol;
+    imports: string[];
+    siblings: Array<{
+        name: string;
+        kind: string;
+        start_line: number;
+        end_line: number;
+    }>;
+    types_used: string[];
+}): string;
 /**
  * Search for a symbol by query and return it with full source.
  * Optionally includes references across the codebase.
@@ -21,4 +52,61 @@ export declare function findAndShow(repo: string, query: string, includeRefs?: b
     symbol: CodeSymbol;
     references?: Reference[];
 } | null>;
+export interface ContextBundle {
+    symbol: CodeSymbol;
+    imports: string[];
+    siblings: Array<{
+        name: string;
+        kind: SymbolKind;
+        start_line: number;
+        end_line: number;
+    }>;
+    types_used: string[];
+}
+/**
+ * Get a symbol with its file's imports and sibling symbols in one call.
+ * Saves 2-3 round-trips vs get_symbol + search_text(imports) + get_file_outline.
+ */
+export declare function getContextBundle(repo: string, symbolName: string): Promise<ContextBundle | null>;
+export interface DeadCodeCandidate {
+    name: string;
+    kind: SymbolKind;
+    file: string;
+    start_line: number;
+    end_line: number;
+    reason: string;
+}
+export interface DeadCodeResult {
+    candidates: DeadCodeCandidate[];
+    scanned_symbols: number;
+    scanned_files: number;
+    truncated?: boolean;
+}
+/**
+ * Find potentially dead code: exported symbols with 0 references outside their own file.
+ * Scans all indexed files for word-boundary matches of each exported symbol name.
+ */
+export declare function findDeadCode(repo: string, options?: {
+    file_pattern?: string | undefined;
+    include_tests?: boolean | undefined;
+}): Promise<DeadCodeResult>;
+export interface UnusedImport {
+    file: string;
+    line: number;
+    import_text: string;
+    imported_name: string;
+}
+export interface UnusedImportsResult {
+    unused: UnusedImport[];
+    scanned_files: number;
+    truncated?: boolean;
+}
+/**
+ * Find imports whose imported names are never referenced in the file body.
+ * Supports ES module named imports: import { A, B } from '...'
+ */
+export declare function findUnusedImports(repo: string, options?: {
+    file_pattern?: string;
+    include_tests?: boolean;
+}): Promise<UnusedImportsResult>;
 //# sourceMappingURL=symbol-tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"symbol-tools.d.ts","sourceRoot":"","sources":["../../src/tools/symbol-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAwBzD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqB5B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CA0DvB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmDtB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAqBlE"}
+{"version":3,"file":"symbol-tools.d.ts","sourceRoot":"","sources":["../../src/tools/symbol-tools.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAa,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2FhF;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACtC,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAuChE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAyDvB;AAED;;;GAGG;AACH;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAgDtC;AAwGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiEtB;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAkB3D;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAM3D;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAE/D;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAc1M;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAkBlE;AAaD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsC/B;AAwBD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAyBD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC,GACA,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAQD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3D,OAAO,CAAC,mBAAmB,CAAC,CAkF9B"}