dsh-code-review-graph 0.0.0-stage → 0.1.1

package/capabilities.json

@@ -0,0 +1,1790 @@
+{
+  "tools": [
+    {
+      "name": "build_or_update_graph_tool",
+      "description": "Build or incrementally update the code knowledge graph.\n\nCall this first to initialize the graph, or after making changes.\nBy default performs an incremental update (only changed files).\nSet full_rebuild=True to re-parse every file.\n\nRuns the blocking full_build / incremental_update work on a worker\nthread via ``_offload`` so the stdio event loop stays responsive.\nWithout that, long builds deadlocked on Windows because\n``ProcessPoolExecutor`` (used by parallel parsing) interacted badly\nwith the sync handler blocking the only event-loop thread. See:\n#46, #136, #262.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "full_rebuild": {
+            "default": false,
+            "type": "boolean",
+            "description": "If True, re-parse all files. Default: False (incremental)."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected from current directory if omitted."
+          },
+          "base": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Git ref to diff against for incremental updates. When omitted,\nresolves automatically to the commit the graph was last built at,\nso one update catches everything since the last sync (not just the\nlatest commit). Pass an explicit ref to override."
+          },
+          "postprocess": {
+            "default": "full",
+            "type": "string",
+            "description": "Post-processing level: \"full\" (default), \"minimal\" (signatures+FTS only),\n         or \"none\" (skip all post-processing). Use \"minimal\" for faster builds."
+          },
+          "recurse_submodules": {
+            "anyOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "If True, include files from git submodules.\nWhen None (default), falls back to CRG_RECURSE_SUBMODULES env var."
+          },
+          "embedding_provider": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Exact provider for an explicit post-build embedding\nrefresh. Must be supplied with embedding_model. Default: disabled."
+          },
+          "embedding_model": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Exact model for an explicit post-build embedding\nrefresh. Must be supplied with embedding_provider. Default: disabled."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "run_postprocess_tool",
+      "description": "Run post-processing on existing graph (flows, communities, FTS index).\n\nUse after building with postprocess=\"none\" or \"minimal\", or to re-run\nexpensive steps independently. Signatures are always computed.\n\nOffloaded via ``_offload`` so community detection on large graphs\ndoes not block the MCP event loop. See: #46, #136, #262.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "flows": {
+            "default": true,
+            "type": "boolean",
+            "description": "Run flow detection. Default: True."
+          },
+          "communities": {
+            "default": true,
+            "type": "boolean",
+            "description": "Run community detection. Default: True."
+          },
+          "fts": {
+            "default": true,
+            "type": "boolean",
+            "description": "Rebuild FTS index. Default: True."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "embedding_provider": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Exact provider for an explicit embedding refresh.\nMust be supplied with embedding_model. Default: disabled."
+          },
+          "embedding_model": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Exact model for an explicit embedding refresh.\nMust be supplied with embedding_provider. Default: disabled."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_minimal_context_tool",
+      "description": "Get ultra-compact context for any task (~100 tokens). Always call this first.\n\nReturns graph stats, risk score, top communities/flows, and suggested\nnext tools in a single compact response. Use this as the entry point\nbefore any other graph tool to minimize token usage. Returns\n``status: not_ready`` with a build suggestion when the graph is missing,\nempty, or known to have been built at a different Git commit.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "task": {
+            "default": "",
+            "type": "string",
+            "description": "What you are doing (e.g. \"review PR #42\", \"debug login timeout\")."
+          },
+          "changed_files": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Explicit list of changed files. Auto-detected if omitted."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "base": {
+            "default": "HEAD~1",
+            "type": "string",
+            "description": "Git ref for diff comparison. Default: HEAD~1."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_impact_radius_tool",
+      "description": "Analyze the blast radius of changed files in the codebase.\n\nShows which functions, classes, and files are impacted by changes.\nAuto-detects changed files from git if not specified.\n\nAn impacted node that calls or references the changed code directly also\ncarries the ``call_site`` (file and line) it does so at, and\n``unresolved_call_sites`` counts call sites that name a changed symbol but\nwere never bound to it, so an empty radius is not mistaken for proof.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "changed_files": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "List of changed file paths (relative to repo root). Auto-detected if omitted."
+          },
+          "max_depth": {
+            "default": 2,
+            "type": "integer",
+            "description": "Number of hops to traverse in the dependency graph. Default: 2."
+          },
+          "max_results": {
+            "default": 500,
+            "type": "integer",
+            "description": "How many impacted nodes to traverse to. Default: 500. Each\nlist in the response also has a fixed ceiling (100 nodes, 150\nedges, 200 files) so the response size does not grow with the\nrepository; the omitted counts report the rest."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "base": {
+            "default": "HEAD~1",
+            "type": "string",
+            "description": "Git ref for auto-detecting changes. Default: HEAD~1."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full output, \"minimal\" for compact summary. Default: standard."
+          },
+          "resolution": {
+            "default": "all",
+            "type": "string",
+            "description": "\"all\" (default) or \"direct\" to traverse only calls bound to an indexed node."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "query_graph_tool",
+      "description": "Run a predefined graph query to explore code relationships.\n\nAvailable patterns:\n- callers_of: Find functions that call the target\n- references_to: Find nodes that reference the target\n- callees_of: Find functions called by the target\n- imports_of: Find what the target imports\n- importers_of: Find files that import the target\n- children_of: Find nodes contained in a file or class\n- tests_for: Find tests for the target\n- inheritors_of: Find classes inheriting from the target\n- triggers_of: Find methods invoked by a scheduler or other trigger\n- triggered_by: Find schedulers or other triggers that invoke the target\n- publishers_of: Find methods that publish an event\n- listeners_of: Find methods that listen for an event\n- handlers_of: Find methods that handle an endpoint\n- endpoints_for: Find endpoints handled by a method\n- consumers_of: Find classes that consume a Spring configuration property\n- file_summary: Get all nodes in a file\n\ncallers_of, callees_of and references_to return one row per call site, each\ncarrying the ``call_site`` (file and line) the call is written at, plus a\n``resolution_split`` saying how many of those call sites are bound to an\nindexed node and how many are bare-name matches.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pattern": {
+            "type": "string",
+            "description": "Query pattern name (see above)."
+          },
+          "target": {
+            "type": "string",
+            "description": "Node name, qualified name, or file path to query."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full output, \"minimal\" for compact summary. Default: standard."
+          },
+          "max_results": {
+            "default": 100,
+            "type": "integer",
+            "description": "Maximum results to return. Default: 100."
+          },
+          "resolution": {
+            "default": "all",
+            "type": "string",
+            "description": "\"all\" (default), \"direct\" for only calls bound to an indexed\nnode, or \"unresolved\" for only the bare-name matches."
+          }
+        },
+        "required": [
+          "pattern",
+          "target"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_review_context_tool",
+      "description": "Generate a focused, token-efficient review context for code changes.\n\nCombines impact analysis with source snippets and review guidance.\nUse this for comprehensive code reviews.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "changed_files": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Files to review. Auto-detected from git diff if omitted."
+          },
+          "max_depth": {
+            "default": 2,
+            "type": "integer",
+            "description": "Impact radius depth. Default: 2."
+          },
+          "include_source": {
+            "default": true,
+            "type": "boolean",
+            "description": "Include source code snippets. Default: True."
+          },
+          "max_lines_per_file": {
+            "default": 200,
+            "type": "integer",
+            "description": "Max source lines per file. Default: 200."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "base": {
+            "default": "HEAD~1",
+            "type": "string",
+            "description": "Git ref for change detection. Default: HEAD~1."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full output, \"minimal\" for\ntoken-efficient summary. Default: standard."
+          },
+          "max_results": {
+            "default": 100,
+            "type": "integer",
+            "description": "Maximum graph nodes per list and edges to return.\nDefault: 50. Each list reports its untruncated ``*_total``."
+          },
+          "max_files": {
+            "default": 25,
+            "type": "integer",
+            "description": "Maximum files listed and given source snippets.\nDefault: 25. Snippets share an 800-line budget."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "semantic_search_nodes_tool",
+      "description": "Search for code entities by name, keyword, or semantic similarity.\n\nUses vector embeddings for semantic search when available (run embed_graph_tool\nfirst, with a provider of your choice: \"local\" needs sentence-transformers,\n\"openai\" / \"google\" / \"minimax\" / \"voyage\" need their respective env vars).\nFalls back to FTS5 / keyword matching when no matching embeddings exist for\nthe given provider.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search string to match against node names."
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Optional filter: File, Class, Function, Type, or Test."
+          },
+          "limit": {
+            "default": 20,
+            "type": "integer",
+            "description": "Maximum results. Default: 20."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "model": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Embedding model for query vectors. Must match the model used\n   during embed_graph. Falls back to CRG_EMBEDDING_MODEL env var\n   (local), CRG_OPENAI_MODEL (openai), or CRG_VOYAGE_MODEL (voyage)."
+          },
+          "provider": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Embedding provider: \"local\" (default), \"openai\", \"google\",\n      \"minimax\", or \"voyage\". Must match the provider used during\n      embed_graph."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full output, \"minimal\" for compact summary. Default: standard."
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "embed_graph_tool",
+      "description": "Compute vector embeddings for all graph nodes to enable semantic search.\n\nRequires: pip install code-review-graph[embeddings] (local provider only;\ncloud providers use stdlib urllib).\nDefault provider: local. Default model: all-MiniLM-L6-v2.\nOverride provider via `provider` param, model via `model` param or\nCRG_EMBEDDING_MODEL / CRG_OPENAI_MODEL / CRG_VOYAGE_MODEL env vars.\nChanging the model or provider re-embeds all nodes automatically.\n\nAfter running this, semantic_search_nodes_tool will use vector similarity\ninstead of keyword matching for much better results.\n\nRuns the blocking sentence-transformers / Gemini / HTTP inference on a\nworker thread via ``_offload`` so the stdio event loop stays\nresponsive — without that, embedding a large graph would silently hang\nthe MCP server on Windows. See: #46, #136, #262.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "model": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Embedding model. For local: HuggingFace ID/path; for openai:\n   model ID (e.g. \"text-embedding-3-small\"); for google: Gemini\n   model ID; for voyage: Voyage model ID (e.g. \"voyage-code-3\").\n   Falls back to CRG_EMBEDDING_MODEL / CRG_OPENAI_MODEL /\n   CRG_VOYAGE_MODEL env vars as appropriate."
+          },
+          "provider": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "\"local\" (default), \"openai\", \"google\", \"minimax\", or \"voyage\".\n      \"openai\" requires CRG_OPENAI_BASE_URL + CRG_OPENAI_API_KEY +\n      CRG_OPENAI_MODEL env vars and accepts any OpenAI-compatible\n      endpoint (real OpenAI, Azure, new-api, LiteLLM, vLLM, etc.).\n      \"voyage\" requires VOYAGE_API_KEY and defaults to voyage-code-3\n      unless a model arg or CRG_VOYAGE_MODEL is supplied."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "list_graph_stats_tool",
+      "description": "Get aggregate statistics about the code knowledge graph.\n\nShows total nodes, edges, languages, files, and last update time.\nUseful for checking if the graph is built and up to date.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_docs_section_tool",
+      "description": "Get a specific section from the LLM-optimized documentation reference.\n\nReturns only the requested section content for minimal token usage.\nUse this before answering any user question about the plugin.\n\nOne of the two tools that stay synchronous: it reads one bundled\nMarkdown file and touches neither the graph database nor Git, so there\nis nothing here that can hold the event loop for seconds. See\n``_offload`` for the tools that do.\n\nAvailable sections: usage, review-delta, review-pr, commands, legal,\nwatch, embeddings, languages, troubleshooting.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "section_name": {
+            "type": "string",
+            "description": "The section to retrieve (e.g. \"review-delta\", \"usage\")."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          }
+        },
+        "required": [
+          "section_name"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "find_large_functions_tool",
+      "description": "Find functions, classes, or files exceeding a line-count threshold.\n\nUseful for decomposition audits, code quality checks, and enforcing\nsize limits during code review. Results are ordered by line count.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "min_lines": {
+            "default": 50,
+            "type": "integer",
+            "description": "Minimum line count to flag. Default: 50."
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Optional filter: Function, Class, File, or Test."
+          },
+          "file_path_pattern": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Filter by file path substring (e.g. \"components/\")."
+          },
+          "limit": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum results. Default: 50."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "list_flows_tool",
+      "description": "List execution flows in the codebase, sorted by criticality.\n\nEach flow represents a call chain starting from an entry point\n(HTTP handler, CLI command, test function, etc.). Use this to\nunderstand the main execution paths through the codebase.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sort_by": {
+            "default": "criticality",
+            "type": "string",
+            "description": "Sort column: criticality, depth, node_count, file_count, or name."
+          },
+          "limit": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum flows to return. Default: 50."
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Optional filter by entry point kind (e.g. \"Test\", \"Function\")."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" (default) returns full flow data; \"minimal\"\n          returns only name, criticality, and node_count per flow."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_flow_tool",
+      "description": "Get detailed information about a single execution flow.\n\nReturns the full call path with each step's function name, file, and\nline numbers. Optionally includes source code snippets for each step.\n\nProvide either flow_id (from list_flows_tool) or flow_name to search by name.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "flow_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Database ID of the flow."
+          },
+          "flow_name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Name to search for (partial match). Ignored if flow_id given."
+          },
+          "include_source": {
+            "default": false,
+            "type": "boolean",
+            "description": "Include source code snippets for each step. Default: False."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "max_steps": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum steps to return; flow.total_steps reports the\nfull count. Default: 50."
+          },
+          "max_source_lines": {
+            "default": 400,
+            "type": "integer",
+            "description": "Total source lines across all steps when\ninclude_source is set. Default: 400."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_affected_flows_tool",
+      "description": "Find execution flows affected by changed files.\n\nIdentifies which execution flows pass through nodes in the changed files.\nUseful during code review to understand which user-facing or critical paths\nare impacted by a change. Auto-detects changed files from git if not specified.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "changed_files": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "List of changed file paths (relative to repo root). Auto-detected if omitted."
+          },
+          "base": {
+            "default": "HEAD~1",
+            "type": "string",
+            "description": "Git ref for auto-detecting changes. Default: HEAD~1."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full step details, \"minimal\" for per-flow\nmetadata only. Default: standard."
+          },
+          "max_flows": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum flows to return; total reports the full count.\nDefault: 50. Pass 0 for no caller limit. Standard mode\nadditionally caps visible flows at 25 and minimal mode at 500,\nbecause a standard flow costs ~980 tokens against ~18 minimal."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "list_communities_tool",
+      "description": "List detected code communities in the codebase.\n\nEach community represents a cluster of related code entities (functions,\nclasses) detected via the Leiden algorithm or file-based grouping.\nUse this to understand the high-level structure of the codebase.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sort_by": {
+            "default": "size",
+            "type": "string",
+            "description": "Sort column: size, cohesion, or name."
+          },
+          "min_size": {
+            "default": 0,
+            "type": "integer",
+            "description": "Minimum community size to include. Default: 0."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" (default) returns full community data;\n          \"minimal\" returns only name, size, and cohesion\n          per community."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "max_results": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum communities to return; total reports the full\ncount. Default: 50."
+          },
+          "max_members": {
+            "default": 10,
+            "type": "integer",
+            "description": "Maximum member names listed per community in standard\nmode. Each community's size still reports its true member\ncount. Default: 10."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_community_tool",
+      "description": "Get detailed information about a single code community.\n\nReturns community metadata including size, cohesion, dominant language,\nand member list. Optionally includes full node details for each member.\n\nProvide either community_id (from list_communities_tool) or community_name\nto search by name.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "community_name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Name to search for (partial match). Ignored if community_id given."
+          },
+          "community_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Database ID of the community."
+          },
+          "include_members": {
+            "default": false,
+            "type": "boolean",
+            "description": "Include full member node details. Default: False."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "max_members": {
+            "default": 25,
+            "type": "integer",
+            "description": "Maximum member entries to include; the community's\nsize still reports its true member count and\nmembers_truncated marks the cut. Default: 25."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_architecture_overview_tool",
+      "description": "Generate an architecture overview based on community structure.\n\nBuilds a high-level view of the codebase architecture by analyzing\ncommunity boundaries and cross-community coupling. Includes warnings\nfor high coupling between communities.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "minimal",
+            "type": "string",
+            "description": "\"minimal\" (default) drops community member lists\n          and aggregates cross-community edges to one row per\n          community pair (typical reduction: 600KB -> <5KB);\n          \"standard\" returns full per-edge detail."
+          },
+          "max_results": {
+            "default": 100,
+            "type": "integer",
+            "description": "Maximum cross-community rows and warnings to return;\ncross_community_edges_total reports the full count. Default: 100."
+          },
+          "max_members": {
+            "default": 10,
+            "type": "integer",
+            "description": "Maximum member names per community in standard mode.\nDefault: 10."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "detect_changes_tool",
+      "description": "Detect changes and produce risk-scored, priority-ordered review guidance.\n\nPrimary tool for code review. Maps git diffs to affected functions,\nflows, communities, and test coverage gaps. Returns risk scores and\nprioritized review items. Replaces get_review_context for change-aware reviews.\n\nOffloaded via ``_offload`` — runs `git diff` subprocesses and BFS\ntraversals that can take several seconds on large repos, and honours\n``CRG_TOOL_TIMEOUT``. See: #46, #136, #262.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "base": {
+            "default": "HEAD~1",
+            "type": "string",
+            "description": "Git ref to diff against. Default: HEAD~1."
+          },
+          "changed_files": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "List of changed file paths (relative to repo root). Auto-detected if omitted."
+          },
+          "include_source": {
+            "default": false,
+            "type": "boolean",
+            "description": "Include source code snippets for changed functions. Default: False."
+          },
+          "max_depth": {
+            "default": 2,
+            "type": "integer",
+            "description": "Impact radius depth for BFS traversal. Default: 2."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full output, \"minimal\" for\ntoken-efficient summary. Default: standard."
+          },
+          "max_results": {
+            "default": 25,
+            "type": "integer",
+            "description": "Maximum changed functions, test gaps, and changed files\nto return; the matching *_total fields report the full counts.\nDefault: 25."
+          },
+          "max_flows": {
+            "default": 20,
+            "type": "integer",
+            "description": "Maximum affected flows to embed. Embedded flows carry\nper-flow metadata only — use get_affected_flows_tool for step\ndetail. Default: 20."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "refactor_tool",
+      "description": "Graph-powered refactoring operations.\n\nUnified entry point for rename previews, dead code detection, and\nrefactoring suggestions.\n\nModes:\n- rename: Preview renaming a symbol. Returns an edit list and a refactor_id\n  to pass to apply_refactor_tool. Requires old_name and new_name.\n- dead_code: Find unreferenced functions/classes (no callers, tests, or\n  importers, and not entry points).\n- suggest: Get community-driven refactoring suggestions (move misplaced\n  functions, remove dead code).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "default": "rename",
+            "type": "string",
+            "description": "Operation mode: \"rename\", \"dead_code\", or \"suggest\"."
+          },
+          "old_name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "(rename) Current symbol name to rename."
+          },
+          "new_name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "(rename) Desired new name for the symbol."
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "(dead_code) Optional filter: Function or Class."
+          },
+          "file_pattern": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "(dead_code) Filter by file path substring."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "max_results": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum edits/symbols/suggestions in the response;\ntotal reports the full count. The stored rename preview keeps\nevery edit, so apply_refactor_tool still applies them all.\nDefault: 50."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full records, \"minimal\" for\nidentifying fields only. Default: standard."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "apply_refactor_tool",
+      "description": "Apply a previously previewed refactoring to source files.\n\nTakes a refactor_id from a prior refactor_tool(mode=\"rename\") call and\napplies the exact string replacements to the target files. Previews\nexpire after 10 minutes.\n\nSecurity: All edit paths are validated to be within the repo root.\nOnly exact string replacements are performed (no regex, no eval).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "refactor_id": {
+            "type": "string",
+            "description": "The refactor ID from refactor_tool's response."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "dry_run": {
+            "default": false,
+            "type": "boolean",
+            "description": "If True, return a unified diff of what would change\nwithout touching any files. The refactor_id remains valid so\nthe same preview can be applied in a follow-up call without\ndry_run. Use this for a human-in-the-loop review before\ncommitting changes to disk. See: #176"
+          },
+          "max_diff_files": {
+            "default": 25,
+            "type": "integer",
+            "description": "Maximum per-file diffs to include in a dry run.\nwould_modify still lists every file. Default: 25."
+          }
+        },
+        "required": [
+          "refactor_id"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_refactor_edit_plan_tool",
+      "description": "Return a complete read-only UTF-8 edit plan for a host-controlled commit.\n\nEach file includes path, before_sha256, after_content and edit_count.\nPlans are not truncated. Hosts must recheck paths and byte hashes and\nobtain filesystem permission before applying; no source files are written.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "refactor_id": {
+            "type": "string"
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null
+          }
+        },
+        "required": [
+          "refactor_id"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "generate_wiki_tool",
+      "description": "Generate a markdown wiki from the code community structure.\n\nCreates a wiki page for each detected community and an index page.\nPages are written to .code-review-graph/wiki/ inside the repository.\nOnly regenerates pages whose content has changed unless force=True.\n\nOffloaded via ``_offload`` — on large graphs the page-generation loop\ntouches every community and issues many SQLite reads, which would\nblock the MCP event loop. See: #46, #136, #262.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "force": {
+            "default": false,
+            "type": "boolean",
+            "description": "If True, regenerate all pages even if content unchanged. Default: False."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_wiki_page_tool",
+      "description": "Retrieve a specific wiki page by community name.\n\nReturns the markdown content of the wiki page for the given community.\nThe wiki must have been generated first via generate_wiki_tool.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "community_name": {
+            "type": "string",
+            "description": "Community name to look up."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "max_chars": {
+            "default": 20000,
+            "type": "integer",
+            "description": "Maximum characters of page content to return;\ntotal_chars reports the real length. Default: 20000."
+          }
+        },
+        "required": [
+          "community_name"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_hub_nodes_tool",
+      "description": "Find the most connected nodes in the codebase (architectural hotspots).\n\nHub nodes have the highest total degree (in + out edges). Changes to\nthem have disproportionate blast radius. Excludes File nodes.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "top_n": {
+            "default": 10,
+            "type": "integer",
+            "description": "Number of top hubs to return (capped at 100). Default: 10."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full node data, \"minimal\" for name,\nkind, and total_degree only. Default: standard."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_bridge_nodes_tool",
+      "description": "Find architectural chokepoints via betweenness centrality.\n\nBridge nodes sit on shortest paths between many node pairs.\nIf they break, multiple code regions lose connectivity.\nUses sampling approximation for graphs > 5000 nodes.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "top_n": {
+            "default": 10,
+            "type": "integer",
+            "description": "Number of top bridges to return (capped at 100). Default: 10."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full node data, \"minimal\" for name,\nkind, and betweenness only. Default: standard."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_knowledge_gaps_tool",
+      "description": "Identify structural weaknesses in the codebase graph.\n\nFinds isolated nodes (disconnected), thin communities (< 3 members),\nuntested hotspots (high-degree nodes without test coverage), and\nsingle-file communities.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "max_per_category": {
+            "default": 15,
+            "type": "integer",
+            "description": "Maximum entries per gap category; summary and\ntotal_gaps still report the untruncated counts. Default: 15."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full gap records, \"minimal\" to drop\nfile paths. Default: standard."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_surprising_connections_tool",
+      "description": "Find unexpected architectural coupling via composite surprise scoring.\n\nScores edges by: cross-community (+0.3), cross-language (+0.2),\nperipheral-to-hub (+0.2), cross-test-boundary (+0.15), and\nunusual edge kinds (+0.15).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "top_n": {
+            "default": 15,
+            "type": "integer",
+            "description": "Number of top surprises to return (capped at 100). Default: 15."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          },
+          "detail_level": {
+            "default": "standard",
+            "type": "string",
+            "description": "\"standard\" for full edge records, \"minimal\" for\nsource, target, kind, and score only. Default: standard."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "get_suggested_questions_tool",
+      "description": "Auto-generate review questions from graph analysis.\n\nProduces prioritized questions about: bridge nodes needing tests,\nuntested hub nodes, surprising cross-community coupling, thin\ncommunities, and untested hotspots.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          }
+        },
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "traverse_graph_tool",
+      "description": "BFS/DFS traversal from best-matching node with token budget.\n\nFree-form graph exploration: finds the node best matching your\nquery, then traverses outward via BFS or DFS up to the given\ndepth, collecting connected nodes within the token budget.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search string to find the starting node."
+          },
+          "mode": {
+            "default": "bfs",
+            "type": "string",
+            "description": "Traversal mode: \"bfs\" (breadth-first) or \"dfs\"\n(depth-first). Default: bfs."
+          },
+          "depth": {
+            "default": 3,
+            "type": "integer",
+            "description": "Max traversal depth (1-6). Default: 3."
+          },
+          "token_budget": {
+            "default": 2000,
+            "type": "integer",
+            "description": "Approximate token limit for results.\nDefault: 2000."
+          },
+          "repo_root": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Repository root path. Auto-detected if omitted."
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "list_repos_tool",
+      "description": "List all registered repositories in the multi-repo registry.\n\nReturns the list of repos registered at ~/.code-review-graph/registry.json.\nUse the CLI 'register' command to add repos.\n\nStays synchronous: one small JSON read, no graph database and no Git.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "cross_repo_search_tool",
+      "description": "Search for code entities across registered repositories.\n\nRuns hybrid search on each searched repo's graph database and interleaves\nresults by repository-local rank. Equal ranks follow registry order, and up\nto ``limit`` results per searched repo may be returned. Register repos first\nwith the CLI 'register' command.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search string to match against node names."
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Optional filter: File, Class, Function, Type, or Test."
+          },
+          "limit": {
+            "default": 20,
+            "type": "integer",
+            "description": "Maximum results per repo. Default: 20."
+          },
+          "max_results": {
+            "default": 50,
+            "type": "integer",
+            "description": "Maximum merged results across searched repos; total\nreports the untruncated merged count. Default: 50."
+          },
+          "repos": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Optional repo aliases or folder names to search. Default: every\nregistered repo. Use it when the registry spans unrelated products\nand only some of them can answer the question. Matching is exact\nand case-sensitive, and paths are not accepted. Names matching no\nregistry entry come back in ``unknown``; a name matching several\nentries selects all of them and is listed in ``ambiguous``."
+          }
+        },
+        "required": [
+          "query"
+        ],
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    }
+  ],
+  "prompts": [
+    {
+      "name": "review_changes",
+      "description": "Pre-commit review workflow using detect_changes, affected_flows, and test gaps.\n\nProduces a structured code review with risk levels and actionable findings.",
+      "arguments": [
+        {
+          "name": "base",
+          "description": "Git ref to diff against. Default: HEAD~1.\n\nProvide as a JSON string matching the following schema: {\"type\":\"string\"}",
+          "required": false
+        }
+      ],
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "architecture_map",
+      "description": "Architecture documentation using communities, flows, and Mermaid diagrams.\n\nGenerates a comprehensive architecture map with module summaries and coupling warnings.",
+      "arguments": [],
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "debug_issue",
+      "description": "Guided debugging using search, flow tracing, and recent changes.\n\nSystematic debugging workflow that traces execution paths and identifies root causes.",
+      "arguments": [
+        {
+          "name": "description",
+          "description": "Description of the issue to debug.\n\nProvide as a JSON string matching the following schema: {\"type\":\"string\"}",
+          "required": false
+        }
+      ],
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "onboard_developer",
+      "description": "New developer orientation using stats, architecture, and critical flows.\n\nCreates an onboarding guide covering codebase structure, key modules, and patterns.",
+      "arguments": [],
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    },
+    {
+      "name": "pre_merge_check",
+      "description": "PR readiness check with risk scoring, test gaps, and dead code detection.\n\nProduces a merge readiness report with risk assessment and recommendations.",
+      "arguments": [
+        {
+          "name": "base",
+          "description": "Git ref to diff against. Default: HEAD~1.\n\nProvide as a JSON string matching the following schema: {\"type\":\"string\"}",
+          "required": false
+        }
+      ],
+      "_meta": {
+        "fastmcp": {
+          "tags": []
+        }
+      }
+    }
+  ]
+}