codesift-mcp 0.2.6 → 0.2.8

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

@@ -1 +1 @@
-{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../src/register-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuCxB,iFAAiF;AACjF,eAAO,MAAM,IAAI,yIAQF,CAAC;AAQhB,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAEzC;AAMD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC7B;AAMD,eAAO,MAAM,aAAa;IACxB,wCAAwC;;IAGxC,oBAAoB;;IAGpB,uBAAuB;;IAGvB,iBAAiB;;IAGjB,sBAAsB;;IAGtB,uBAAuB;;IAGvB,sBAAsB;;IAGtB,yBAAyB;;IAGzB,qBAAqB;;;;;;;;;;;;IAarB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,qBAAqB;;IAGrB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,uBAAuB;;IAGvB,oBAAoB;;;;;;;;;IAMpB,oBAAoB;;;;;;;;IAMpB,kBAAkB;;;;IAGlB,iBAAiB;;;;CAET,CAAC;AAEX,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,SAAS,GACT,OAAO,GACP,KAAK,GACL,cAAc,GACd,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe,GACf,UAAU,GACV,WAAW,GACX,YAAY,GACZ,MAAM,CAAC;AAmBX,sDAAsD;AACtD,wBAAgB,kBAAkB,IAAI,SAAS,cAAc,EAAE,CAE9D;AA6xCD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzE,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAqBlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAmDA;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAiF3F"}
+{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../src/register-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwCxB,iFAAiF;AACjF,eAAO,MAAM,IAAI,yIAQF,CAAC;AAQhB,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAEzC;AAMD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC7B;AAMD,eAAO,MAAM,aAAa;IACxB,wCAAwC;;IAGxC,oBAAoB;;IAGpB,uBAAuB;;IAGvB,iBAAiB;;IAGjB,sBAAsB;;IAGtB,uBAAuB;;IAGvB,sBAAsB;;IAGtB,yBAAyB;;IAGzB,qBAAqB;;;;;;;;;;;;IAarB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,qBAAqB;;IAGrB,kBAAkB;;IAGlB,mBAAmB;;IAGnB,uBAAuB;;IAGvB,oBAAoB;;;;;;;;;IAMpB,oBAAoB;;;;;;;;IAMpB,kBAAkB;;;;IAGlB,iBAAiB;;;;CAET,CAAC;AAEX,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,SAAS,GACT,OAAO,GACP,KAAK,GACL,cAAc,GACd,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,eAAe,GACf,UAAU,GACV,WAAW,GACX,YAAY,GACZ,MAAM,CAAC;AAmBX,sDAAsD;AACtD,wBAAgB,kBAAkB,IAAI,SAAS,cAAc,EAAE,CAE9D;AAuzCD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzE,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAqBlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAmDA;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAiF3F"}

package/dist/register-tools.js

@@ -27,6 +27,7 @@ import { scanSecrets } from "./tools/secret-tools.js";
 import { consolidateMemories, readMemory } from "./tools/memory-tools.js";
 import { createAnalysisPlan, writeScratchpad, readScratchpad, listScratchpad, updateStepStatus, getPlan, listPlans } from "./tools/coordinator-tools.js";
 import { frequencyAnalysis } from "./tools/frequency-tools.js";
+import { analyzeProject, getExtractorVersions } from "./tools/project-tools.js";
 import { reviewDiff } from "./tools/review-diff-tools.js";
 import { formatSnapshot, getContext, getSessionState } from "./storage/session-state.js";
 import { formatComplexityCompact, formatComplexityCounts, formatClonesCompact, formatClonesCounts, formatHotspotsCompact, formatHotspotsCounts, formatTraceRouteCompact, formatTraceRouteCounts } from "./formatters-shortening.js";
@@ -168,7 +169,7 @@ const TOOL_DEFINITIONS = [
         category: "indexing",
         searchHint: "list indexed repositories repos available",
         outputSchema: OutputSchemas.repoList,
-        description: "List indexed repos. Set compact=false for full metadata. Cached per session.",
+        description: "List indexed repos. Only needed for multi-repo discovery — single-repo tools auto-resolve from CWD. Set compact=false for full metadata.",
         schema: {
             compact: zBool().describe("true=names only (default), false=full metadata"),
         },
@@ -180,7 +181,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "clear cache invalidate re-index refresh",
         description: "Clear the index cache for a repository, forcing full re-index on next use",
         schema: {
-            repo: z.string().describe("Repository identifier (e.g. local/my-project)"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
         },
         handler: (args) => invalidateCache(args.repo),
     },
@@ -202,7 +203,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.searchResults,
         description: "Search symbols by name/signature. detail_level: compact (~15 tok), standard (default), full.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             query: z.string().describe("Search query string"),
             kind: z.string().optional().describe("Filter by symbol kind (function, class, etc.)"),
             file_pattern: z.string().optional().describe("Glob pattern to filter files"),
@@ -233,7 +234,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "AST tree-sitter query structural pattern matching code shape",
         description: "Search AST patterns via tree-sitter S-expressions. Finds code by structural shape.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             query: z.string().describe("Tree-sitter query in S-expression syntax"),
             language: z.string().describe("Tree-sitter grammar: typescript, javascript, python, go, rust, java, ruby, php"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
@@ -254,7 +255,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "semantic meaning intent concept embedding vector natural language",
         description: "Search code by meaning using embeddings. For intent-based queries: 'error handling', 'auth flow'. Requires indexed embeddings.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             query: z.string().describe("Natural language query describing what you're looking for"),
             top_k: zNum().describe("Number of results (default: 10)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
@@ -280,7 +281,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "full-text search grep regex keyword content files",
         description: "Full-text search across all files. For conceptual queries use semantic_search.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             query: z.string().describe("Search query or regex pattern"),
             regex: zBool().describe("Treat query as a regex pattern"),
             context_lines: zNum().describe("Number of context lines around each match"),
@@ -308,7 +309,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.fileTree,
         description: "File tree with symbol counts. compact=true for flat list (10-50x less output). Cached 5min.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             path_prefix: z.string().optional().describe("Filter to a subtree by path prefix"),
             name_pattern: z.string().optional().describe("Glob pattern to filter file names"),
             depth: zNum().describe("Maximum directory depth to traverse"),
@@ -333,7 +334,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.fileOutline,
         description: "Get the symbol outline of a single file (functions, classes, exports)",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_path: z.string().describe("Relative file path within the repository"),
         },
         handler: async (args) => {
@@ -347,7 +348,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "repository outline overview directory structure high-level",
         description: "Get a high-level outline of the entire repository grouped by directory",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
         },
         handler: async (args) => {
             const result = await getRepoOutline(args.repo);
@@ -360,7 +361,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "suggest queries explore unfamiliar repo onboarding first call",
         description: "Suggest queries for exploring a new repo. Returns top files, kind distribution, examples.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
         },
         handler: async (args) => {
             const result = await suggestQueries(args.repo);
@@ -375,7 +376,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.symbol,
         description: "Get symbol by ID with source. Auto-prefetches children for classes. For batch: get_symbols. For context: get_context_bundle.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_id: z.string().describe("Unique symbol identifier"),
             include_related: zBool().describe("Include children/related symbols (default: true)"),
         },
@@ -399,7 +400,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "batch get multiple symbols by IDs",
         description: "Retrieve multiple symbols by ID in a single batch call",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_ids: z.union([
                 z.array(z.string()),
                 z.string().transform((s) => JSON.parse(s)),
@@ -416,7 +417,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "find symbol by name show source code references",
         description: "Find a symbol by name and show its source, optionally including references",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             query: z.string().describe("Symbol name or query to search for"),
             include_refs: zBool().describe("Include locations that reference this symbol"),
         },
@@ -437,7 +438,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "context bundle symbol imports siblings callers one call",
         description: "Symbol + imports + siblings in one call. Saves 2-3 round-trips.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().describe("Symbol name to find"),
         },
         handler: async (args) => {
@@ -455,7 +456,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.references,
         description: "Find all references to a symbol. Pass symbol_names array for batch search.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().optional().describe("Name of the symbol to find references for"),
             symbol_names: z.union([z.array(z.string()), z.string().transform((s) => JSON.parse(s))]).optional()
                 .describe("Array of symbol names for batch search (reads each file once). Can be JSON string."),
@@ -478,7 +479,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.callTree,
         description: "Trace call chain: callers or callees. output_format='mermaid' for diagram.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().describe("Name of the symbol to trace"),
             direction: z.enum(["callers", "callees"]).describe("Trace direction"),
             depth: zNum().describe("Maximum depth to traverse the call graph (default: 1)"),
@@ -503,7 +504,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.impactAnalysis,
         description: "Blast radius of git changes — affected symbols and files.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             since: z.string().describe("Git ref to compare from (e.g. HEAD~3, commit SHA, branch)"),
             depth: zNum().describe("Depth of dependency traversal"),
             until: z.string().optional().describe("Git ref to compare to (defaults to HEAD)"),
@@ -524,7 +525,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "trace HTTP route handler API endpoint service database NestJS Express Next.js",
         description: "Trace HTTP route → handler → service → DB. NestJS, Next.js, Express.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             path: z.string().describe("URL path to trace (e.g. '/api/users', '/api/projects/:id')"),
             output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (sequence diagram)"),
         },
@@ -540,7 +541,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.definition,
         description: "Go to the definition of a symbol. Uses LSP when available for type-safe precision, falls back to index search.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().describe("Symbol name to find definition of"),
             file_path: z.string().optional().describe("File containing the symbol reference (for LSP precision)"),
             line: zNum().describe("0-based line number of the reference"),
@@ -561,7 +562,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.typeInfo,
         description: "Get type info via LSP hover (return type, params, docs). Hint if LSP unavailable.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().describe("Symbol name to get type info for"),
             file_path: z.string().optional().describe("File containing the symbol"),
             line: zNum().describe("0-based line number"),
@@ -576,7 +577,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.renameResult,
         description: "Rename symbol across all files via LSP. Type-safe, updates imports/refs.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().describe("Current name of the symbol to rename"),
             new_name: z.string().describe("New name for the symbol"),
             file_path: z.string().optional().describe("File containing the symbol"),
@@ -592,7 +593,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.callHierarchy,
         description: "LSP call hierarchy: incoming + outgoing calls. Complements trace_call_chain.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             symbol_name: z.string().describe("Symbol name to get call hierarchy for"),
             file_path: z.string().optional().describe("File containing the symbol (for LSP precision)"),
             line: zNum().describe("0-based line number"),
@@ -630,7 +631,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "community detection clusters modules Louvain import graph boundaries",
         description: "Louvain community detection on import graph. Discovers module boundaries.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             focus: z.string().optional().describe("Path substring to filter files (e.g. 'src/lib')"),
             resolution: zNum().describe("Louvain resolution: higher = more smaller communities, lower = fewer larger (default: 1.0)"),
             output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (graph diagram)"),
@@ -646,7 +647,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "circular dependency cycle import loop detection",
         description: "Detect circular dependencies in the import graph via DFS. Returns file-level cycles.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             max_cycles: zNum().describe("Maximum cycles to report (default: 50)"),
         },
@@ -674,7 +675,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "boundary rules architecture enforcement imports CI gate hexagonal onion",
         description: "Check architecture boundary rules against imports. Path substring matching.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             rules: z.union([
                 z.array(z.object({
                     from: z.string().describe("Path substring matching source files (e.g. 'src/domain')"),
@@ -696,7 +697,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "classify roles entry core utility dead leaf symbol architecture",
         description: "Classify symbol roles (entry/core/utility/dead/leaf) by call graph connectivity.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             include_tests: zBool().describe("Include test files (default: false)"),
             top_n: zNum().describe("Maximum number of symbols to return (default: 100)"),
@@ -718,7 +719,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "assemble context token budget L0 L1 L2 L3 source signatures summaries",
         description: "Assemble code context within token budget. L0=source, L1=signatures, L2=files, L3=dirs.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             query: z.string().describe("Natural language query describing what context is needed"),
             token_budget: zNum().describe("Maximum tokens for the assembled context"),
             level: z.enum(["L0", "L1", "L2", "L3"]).optional().describe("L0=source (default), L1=signatures, L2=files, L3=dirs"),
@@ -735,7 +736,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "knowledge map module dependency graph architecture overview mermaid",
         description: "Get the module dependency map showing how files and directories relate",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             focus: z.string().optional().describe("Focus on a specific module or directory"),
             depth: zNum().describe("Maximum depth of the dependency graph"),
             output_format: z.enum(["json", "mermaid"]).optional().describe("Output format: 'json' (default) or 'mermaid' (dependency diagram)"),
@@ -752,7 +753,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "diff outline structural changes git refs compare",
         description: "Get a structural outline of what changed between two git refs",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             since: z.string().describe("Git ref to compare from"),
             until: z.string().optional().describe("Git ref to compare to (defaults to HEAD)"),
         },
@@ -767,7 +768,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "changed symbols added modified removed git diff",
         description: "List symbols that were added, modified, or removed between two git refs",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             since: z.string().describe("Git ref to compare from"),
             until: z.string().optional().describe("Git ref to compare to (defaults to HEAD)"),
             include_diff: zBool().describe("Include unified diff per changed file (truncated to 500 chars)"),
@@ -787,7 +788,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "generate CLAUDE.md project summary documentation",
         description: "Generate a CLAUDE.md project summary file from the repository index",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             output_path: z.string().optional().describe("Custom output file path"),
         },
         handler: (args) => generateClaudeMd(args.repo, args.output_path),
@@ -800,7 +801,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.batchResults,
         description: "Batch multi-query retrieval with shared token budget. Supports symbols/text/semantic/hybrid.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             queries: z
                 .union([
                 z.array(z.object({ type: z.string() }).passthrough()),
@@ -830,7 +831,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.deadCode,
         description: "Find dead code: exported symbols with zero external references.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             include_tests: zBool().describe("Include test files in scan (default: false)"),
         },
@@ -848,7 +849,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "unused imports dead cleanup lint",
         description: "Find imported names never referenced in the file body. Complements find_dead_code.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             include_tests: zBool().describe("Include test files in scan (default: false)"),
         },
@@ -877,7 +878,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.complexity,
         description: "Top N most complex functions by cyclomatic complexity, nesting, lines.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             top_n: zNum().describe("Return top N most complex functions (default: 30)"),
             min_complexity: zNum().describe("Minimum cyclomatic complexity to include (default: 1)"),
@@ -900,7 +901,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.clones,
         description: "Find code clones: similar function pairs via hash bucketing + line-similarity.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             min_similarity: zNum().describe("Minimum similarity threshold 0-1 (default: 0.7)"),
             min_lines: zNum().describe("Minimum normalized lines to consider (default: 10)"),
@@ -922,7 +923,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "frequency analysis common patterns AST shape clusters",
         description: "Group functions by normalized AST shape. Finds emergent patterns invisible to regex.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             top_n: zNum().optional().describe("Number of clusters to return (default: 30)"),
             min_nodes: zNum().optional().describe("Minimum AST nodes in a subtree to include (default: 5)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
@@ -945,7 +946,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "hotspots git churn bug-prone change frequency complexity",
         description: "Git churn hotspots: change frequency × complexity. Higher score = more bug-prone.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             since_days: zNum().describe("Look back N days (default: 90)"),
             top_n: zNum().describe("Return top N hotspots (default: 30)"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
@@ -1001,7 +1002,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "search patterns anti-patterns CQ violations useEffect empty-catch console-log",
         description: "Search structural patterns/anti-patterns. Built-in or custom regex.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             pattern: z.string().describe("Built-in pattern name or custom regex"),
             file_pattern: z.string().optional().describe("Filter to files matching this path substring"),
             include_tests: zBool().describe("Include test files (default: false)"),
@@ -1031,7 +1032,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "generate HTML report complexity dead code hotspots architecture browser",
         description: "Generate a standalone HTML report with complexity, dead code, hotspots, and architecture. Opens in any browser.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
         },
         handler: (args) => generateReport(args.repo),
     },
@@ -1099,7 +1100,7 @@ const TOOL_DEFINITIONS = [
         outputSchema: OutputSchemas.secrets,
         description: "Scan for hardcoded secrets (API keys, tokens, passwords). ~1,100 rules.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             file_pattern: z.string().optional().describe("Glob pattern to filter scanned files"),
             min_confidence: z.enum(["high", "medium", "low"]).optional().describe("Minimum confidence level (default: medium)"),
             exclude_tests: zBool().describe("Exclude test file findings (default: true)"),
@@ -1255,7 +1256,7 @@ const TOOL_DEFINITIONS = [
         searchHint: "review diff static analysis git changes secrets breaking-changes complexity dead-code blast-radius",
         description: "Run 9 parallel static analysis checks on a git diff: secrets, breaking changes, coupling gaps, complexity, dead-code, blast-radius, bug-patterns, test-gaps, hotspots. Returns a scored verdict (pass/warn/fail) with tiered findings.",
         schema: {
-            repo: z.string().describe("Repository identifier"),
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
             since: z.string().optional().describe("Base git ref (default: HEAD~1)"),
             until: z.string().optional().describe("Target ref. Default: HEAD. Special: WORKING, STAGED"),
             checks: z.string().optional().describe("Comma-separated check names (default: all)"),
@@ -1332,6 +1333,31 @@ const TOOL_DEFINITIONS = [
             return getContext(args.repo, includeStale);
         },
     },
+    // --- Project Analysis ---
+    {
+        name: "analyze_project",
+        category: "analysis",
+        searchHint: "project profile stack conventions middleware routes rate-limits auth detection",
+        description: "Analyze a repository to extract stack, file classifications, and framework-specific conventions. Returns a structured project profile (schema v1.0) with file:line evidence for convention-level facts.",
+        schema: {
+            repo: z.string().optional().describe("Repository identifier (default: auto-detected from CWD)"),
+            force: zBool().describe("Ignore cached results and re-analyze"),
+        },
+        handler: async (args) => {
+            const result = await analyzeProject(args.repo, {
+                force: args.force,
+            });
+            return result;
+        },
+    },
+    {
+        name: "get_extractor_versions",
+        category: "meta",
+        searchHint: "extractor version cache invalidation profile",
+        description: "Return current extractor versions without triggering analysis. Used for cache invalidation.",
+        schema: {},
+        handler: async () => getExtractorVersions(),
+    },
 ];
 function buildToolSummaries() {
     return TOOL_DEFINITIONS.map((t) => ({