pando-ai 0.1.1 → 0.1.2

package/resources/tools/pando-tools.json

@@ -22,21 +22,30 @@
   "signatures": [
     "read-this-first()",
     "get-project-root()",
+    "set-enabled-languages(languages)",
     "set-project-root(root)",
-    "find-nodes(q, qMode, name, async, exported, static, private, protected, readonly, abstract, paramCount, exportedOnly, defaultOnly, symbolKinds, hasDecorator, implements, extends, returns, asOf, scopeNode, expectedHash, limit, offset, sort, lang, semanticKind, include, cursor, datalog, boundary, reachabilityDepth, reachabilityOptions)",
+    "find-nodes(lang, snapshot, scope, datalog, prefilter, include, page)",
     "find-references(to, expectedHash, boundary, includeDeclaration, includeStrings, includeComments, limit, offset, relType, sort, reachabilityDepth, reachabilityOptions, asOf)",
     "find-callers(of, expectedHash, depth, aggregate, boundary, asOf, offset, limit, relType, sort, reachabilityDepth, reachabilityOptions)",
-    "get-content(target, format, maxBytes, offset)",
     "get-db-schema(includeColumns)",
     "query-db(sql, maxRows)",
     "get-storage-content(bucket, key, offset, maxBytes, encoding, full)",
     "workspace-overview()",
     "list-exports(scope, symbolKinds, export_kinds, limit, offset)",
     "analyze-imports(groupBy, limit, offset)",
+    "clojure-namespace-graph(includeExternal, scope, namespacePrefix, edgeKinds, limit, offset)",
+    "clojure-namespace-dependencies(namespace, transitive, edgeKinds, limit, offset)",
+    "clojure-namespace-dependents(namespace, transitive, edgeKinds, limit, offset)",
+    "plan-clojure-namespace-move(namespace, newFile)",
+    "plan-clojure-namespace-rename(oldNamespace, newNamespace)",
+    "move-clojure-namespace(namespace, newFile)",
+    "rename-clojure-namespace(oldNamespace, newNamespace)",
     "rename(path, newName, expectedHash, boundary, requireConfirmation, confirmed, includeStrings, includeComments, page, reachabilityDepth, reachabilityOptions)",
     "delete(path, expectedHashes, forceDeleteReferencesMayBreakSyntax, page)",
     "insert(to, code, replaceExistingNodeAtPath, expectedHash, createFileIfMissing, newFileInitialContent, forceInsertWillBreakSyntax)",
     "replace(path, expectedHash, with, scope, forceReplaceWillBreakSyntax)",
+    "replace-body(path, expectedHash, with, forceReplaceWillBreakSyntax)",
+    "change-signature(path, expectedHash, parameters, returnType, makeAsync, makeSyncFromAsync, forceChangeWillBreakSyntax, boundary, batchSaves)",
     "filter-map-reduce(query, transforms, apply)",
     "list-snapshots(offset, limit)",
     "diff-snapshots(head, base, page)",
@@ -54,7 +63,7 @@
       "name": "read-this-first",
       "category": "pando",
       "signature": "read-this-first()",
-      "description": "Quickstart hints for Pando AST usage. Returns a short help block. Example: {}",
+      "description": "pandō tools are the required code surface for supported-language source operations in pandō benchmark runs. Use pandō for supported source-code read, search, navigation, refactor, edit, delete, insert, replace, rename, references, callers, exports, SQL index queries, and filter-map-reduce operations. Supported source languages include TypeScript, JavaScript, Python, C, C++, C#, Dart, Java, Clojure, and ClojureScript files (.cljs via the Clojure language id). Use non-pandō text/shell tools only for non-code files, unsupported languages, shell setup, builds, and tests. Current find-nodes is Datalog-only and accepts { op, lang?, snapshot?, scope, datalog, prefilter?, include?, page? }; legacy fields such as q, qMode, name, symbolKinds, scopeNode, limit, offset, and top-level cursor are rejected. Example find-nodes declaration lookup: { op:'find-nodes', lang:['ts','js'], scope:{workspace:true}, datalog:{query:'[:find ?n :where [?n :node/name \"myFunction\"]]', bindings:['?n'], result:{nodeVar:'?n'}}, include:{self:true, topN:1}, page:{limit:5} }. Then pass the returned path and hash without @ to modifying tools such as rename, replace, replace-body, insert, or delete. pandō modifying tools automatically create snapshots before and after execution; do not manually snapshot before pandō operations. If a pandō operation fails because of a stale path or hash mismatch, call find-nodes again to refresh the current path/hash and retry with pandō.",
       "parameters": {
         "type": "object",
         "properties": {},
@@ -80,6 +89,35 @@
         {}
       ]
     },
+    {
+      "name": "set-enabled-languages",
+      "category": "pando",
+      "signature": "set-enabled-languages(languages)",
+      "description": "Set or inspect the enabled indexing languages for the selected root. Call with languages omitted to return the current enabledLanguages plus availableLanguages without changing config. Call with an array of language ids to update config, purge indexed files for disabled languages, restart indexing, and return the resulting enabledLanguages plus availableLanguages. If any value is invalid, no config is changed and the response includes invalidLanguages plus availableLanguages. Example: { languages:['ts','js','python'] }",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "languages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Language ids to enable. Valid values are returned in availableLanguages when this tool is called with no languages or invalid languages. Current valid values: ts, js, python, c, cpp, csharp, dart, java, clojure."
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "languages": [
+            "ts",
+            "js",
+            "python"
+          ]
+        }
+      ]
+    },
     {
       "name": "set-project-root",
       "category": "pando",
@@ -107,183 +145,11 @@
     {
       "name": "find-nodes",
       "category": "pando",
-      "signature": "find-nodes(q, qMode, name, async, exported, static, private, protected, readonly, abstract, paramCount, exportedOnly, defaultOnly, symbolKinds, hasDecorator, implements, extends, returns, asOf, scopeNode, expectedHash, limit, offset, sort, lang, semanticKind, include, cursor, datalog, boundary, reachabilityDepth, reachabilityOptions)",
-      "description": "Search code nodes by symbolKinds/name/text/scope with optional enrichment. qMode: 'fts' searches blob/file content with SQLite FTS5 word-token semantics: quoted phrases, AND/OR/NOT, NEAR, and * are supported; punctuation is not indexed as standalone text, though literal-looking queries like foo.bar are normalized to token searches. Use q:'A|B' as shorthand for A* OR B*. qMode: 'like' uses SQL LIKE with %/_. scopeNode may be a dir, file, or node path 'src/a.ts#10-20:FD'; if it includes '#', expectedHash (no @) is required to verify. limit clamps to 100 per page; offset clamps to >= 0; use limit='all' to stream pages. include can add self/body/parents for topN<=5. Examples: { symbolKinds:['function'], name:'init', limit:10 }, { q:'\"TODO item\"', qMode:'fts', limit:10 }, { q:'register|bootstrap', qMode:'fts', limit:10 }, { scopeNode:'src/services/', limit:10 }",
+      "signature": "find-nodes(lang, snapshot, scope, datalog, prefilter, include, page)",
+      "description": "Search code nodes with per-file lazy Datalog execution. Candidate files are processed in deterministic order, one file at a time, and execution stops as soon as page.limit items have been emitted. Pagination is cursor-only via page.cursor. page.limit defaults to 5 when omitted and caps at 20. Optional prefilter.fts narrows candidate files before Datalog execution. This operation is per-file structural search only; cross-file Datalog joins are not supported here. For arbitrary unnamed AST nodes, first find a stable enclosing node such as a function/class, then re-run find-nodes with scope.node and use :node/kind, :node/parent, :node/role, :node/index-in-parent, include.self, and include.parents to disambiguate the exact child node before editing.",
       "parameters": {
         "type": "object",
         "properties": {
-          "q": {
-            "type": "string",
-            "description": "Text query. With qMode:'fts', use SQLite FTS5 token syntax over file contents; punctuation is not exact-match searchable. With qMode:'like', use a SQL LIKE pattern."
-          },
-          "qMode": {
-            "type": "string",
-            "description": "Query mode: 'fts' for content FTS or 'like' for SQL LIKE.",
-            "enum": [
-              "fts",
-              "like"
-            ]
-          },
-          "name": {
-            "anyOf": [
-              {
-                "type": "string",
-                "description": "Exact name match."
-              },
-              {
-                "type": "object",
-                "description": "Name filter helpers: like/contains/startsWith/endsWith/in.",
-                "properties": {
-                  "like": {
-                    "type": "string",
-                    "description": "SQL LIKE pattern, e.g. 'Foo%'"
-                  },
-                  "contains": {
-                    "type": "string",
-                    "description": "Substring match"
-                  },
-                  "startsWith": {
-                    "type": "string"
-                  },
-                  "endsWith": {
-                    "type": "string"
-                  },
-                  "in": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  }
-                },
-                "additionalProperties": false
-              }
-            ]
-          },
-          "async": {
-            "type": "boolean"
-          },
-          "exported": {
-            "type": "boolean"
-          },
-          "static": {
-            "type": "boolean"
-          },
-          "private": {
-            "type": "boolean"
-          },
-          "protected": {
-            "type": "boolean"
-          },
-          "readonly": {
-            "type": "boolean"
-          },
-          "abstract": {
-            "type": "boolean"
-          },
-          "paramCount": {
-            "type": "object",
-            "description": "Parameter count filter.",
-            "properties": {
-              "op": {
-                "type": "string",
-                "description": ">, <, >=, <=, =",
-                "enum": [
-                  ">",
-                  "<",
-                  ">=",
-                  "<=",
-                  "="
-                ]
-              },
-              "value": {
-                "type": "integer",
-                "description": "Non-negative parameter count.",
-                "minimum": 0
-              }
-            },
-            "additionalProperties": false
-          },
-          "exportedOnly": {
-            "type": "boolean"
-          },
-          "defaultOnly": {
-            "type": "boolean"
-          },
-          "symbolKinds": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Symbol categories (e.g., function, class)."
-          },
-          "hasDecorator": {
-            "type": "string"
-          },
-          "implements": {
-            "type": "string"
-          },
-          "extends": {
-            "type": "string"
-          },
-          "returns": {
-            "type": "string"
-          },
-          "asOf": {
-            "type": "string",
-            "description": "SnapshotId for time-travel queries."
-          },
-          "scopeNode": {
-            "type": "string",
-            "description": "Repo-relative file/dir or node path with #range:KIND."
-          },
-          "expectedHash": {
-            "type": "string",
-            "description": "Hash (no @) required when scopeNode includes '#'."
-          },
-          "limit": {
-            "anyOf": [
-              {
-                "type": "integer",
-                "minimum": 1,
-                "maximum": 100
-              },
-              {
-                "type": "string",
-                "description": "Use 'all' to page through results.",
-                "enum": [
-                  "all"
-                ]
-              }
-            ]
-          },
-          "offset": {
-            "type": "integer",
-            "minimum": 0
-          },
-          "sort": {
-            "type": "object",
-            "description": "Sort results.",
-            "properties": {
-              "by": {
-                "type": "string",
-                "description": "file | name | path",
-                "enum": [
-                  "file",
-                  "name",
-                  "path"
-                ]
-              },
-              "direction": {
-                "type": "string",
-                "description": "asc | desc",
-                "enum": [
-                  "asc",
-                  "desc"
-                ]
-              }
-            },
-            "additionalProperties": false
-          },
           "lang": {
             "anyOf": [
               {
@@ -295,65 +161,65 @@
                   "type": "string"
                 }
               }
-            ]
+            ],
+            "description": "Optional language filter. Example: ['ts', 'csharp']."
           },
-          "semanticKind": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              }
-            ]
+          "snapshot": {
+            "type": "string",
+            "description": "Optional snapshotId for time-travel queries."
           },
-          "include": {
+          "scope": {
             "type": "object",
-            "description": "Enrich results with node text/parents. Only first topN (max 5) are heavy-enriched.",
+            "description": "Exactly one of workspace, dir, files, or node.",
             "properties": {
-              "self": {
-                "type": "boolean",
-                "description": "Include node code/type/name."
-              },
-              "body": {
+              "workspace": {
                 "type": "boolean",
-                "description": "Include body content (if available)."
+                "description": "Search all candidate files for the selected languages."
               },
-              "parents": {
-                "type": "boolean",
-                "description": "Include parent chain metadata."
+              "dir": {
+                "type": "string",
+                "description": "Workspace-relative directory prefix."
               },
-              "topN": {
-                "type": "integer",
-                "description": "How many results to fully enrich (0-5).",
-                "minimum": 0,
-                "maximum": 5
+              "files": {
+                "type": "array",
+                "description": "Explicit workspace-relative candidate files.",
+                "items": {
+                  "type": "string"
+                }
               },
-              "maxChars": {
-                "type": "integer",
-                "description": "Max chars for body/self content before truncation.",
-                "minimum": 0
+              "node": {
+                "type": "object",
+                "description": "Restrict fact materialization to a verified node subtree/span.",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Workspace-relative node path like src/app.ts#10-40:FunctionDeclaration."
+                  },
+                  "expectedHash": {
+                    "type": "string",
+                    "description": "Hash portion only, without '@'."
+                  }
+                },
+                "required": [
+                  "path",
+                  "expectedHash"
+                ],
+                "additionalProperties": false
               }
             },
             "additionalProperties": false
           },
-          "cursor": {
-            "type": "string",
-            "description": "Opaque cursor (datalog paging)."
-          },
           "datalog": {
             "type": "object",
-            "description": "Advanced datalog query spec (bypasses standard filters).",
+            "description": "Raw Datalog query spec executed per file.",
             "properties": {
               "query": {
                 "type": "string",
-                "description": "Datalog query string."
+                "description": "Raw Datalog query string."
               },
               "bindings": {
                 "type": "array",
+                "description": "Bindings matching the :find clause.",
                 "items": {
                   "type": "string"
                 }
@@ -389,103 +255,198 @@
               },
               "result": {
                 "type": "object",
+                "description": "Maps the primary node variable and any extra projected columns.",
                 "properties": {
                   "nodeVar": {
                     "type": "string"
                   },
-                  "pathVar": {
-                    "type": "string"
-                  },
-                  "fileVar": {
-                    "type": "string"
-                  },
-                  "kindVar": {
-                    "type": "string"
-                  },
-                  "nameVar": {
-                    "type": "string"
-                  },
-                  "startVar": {
-                    "type": "string"
-                  },
-                  "endVar": {
-                    "type": "string"
+                  "columns": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "string"
+                    }
                   }
                 },
+                "required": [
+                  "nodeVar"
+                ],
                 "additionalProperties": false
               }
             },
             "required": [
-              "query"
+              "query",
+              "bindings",
+              "result"
             ],
             "additionalProperties": false
           },
-          "boundary": {
-            "type": "string",
-            "description": "Search boundary: 'project' (default), 'reachable', or 'workspace'.",
-            "enum": [
-              "project",
-              "reachable",
-              "workspace"
-            ]
-          },
-          "reachabilityDepth": {
-            "type": "integer",
-            "description": "Max depth for reachable boundary (integer >= 0).",
-            "minimum": 0
+          "prefilter": {
+            "type": "object",
+            "description": "Optional candidate-file narrowing applied before per-file Datalog execution.",
+            "properties": {
+              "fts": {
+                "type": "string",
+                "description": "SQLite FTS5 MATCH query passed through unchanged after trimming; used only to narrow candidate files."
+              }
+            },
+            "additionalProperties": false
           },
-          "reachabilityOptions": {
+          "include": {
             "type": "object",
-            "description": "Advanced reachability options for boundary='reachable' (maxDepth, includeImportEdges, etc).",
+            "description": "Optional response enrichment. Only the first topN items receive heavy enrichment.",
             "properties": {
-              "maxDepth": {
-                "type": "integer",
-                "minimum": 0
-              },
-              "includeImportEdges": {
-                "type": "boolean"
+              "self": {
+                "type": "boolean",
+                "description": "Include node code/type/name."
               },
-              "includeDevDependencies": {
-                "type": "boolean"
+              "body": {
+                "type": "boolean",
+                "description": "Include body content when available."
               },
-              "includePeerDependencies": {
-                "type": "boolean"
+              "parents": {
+                "type": "boolean",
+                "description": "Include parent chain metadata."
               },
-              "respectBoundaries": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
+              "arities": {
+                "type": "boolean",
+                "description": "Include explicit Clojure arity targets when applicable."
               },
-              "timeLimitMs": {
+              "topN": {
                 "type": "integer",
-                "minimum": 0
+                "minimum": 0,
+                "maximum": 5
               },
-              "memoryLimitBytes": {
+              "maxChars": {
                 "type": "integer",
                 "minimum": 0
               }
             },
             "additionalProperties": false
+          },
+          "page": {
+            "type": "object",
+            "description": "Cursor-only pagination.",
+            "properties": {
+              "limit": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 20
+              },
+              "cursor": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "additionalProperties": false
           }
         },
-        "required": [],
+        "required": [
+          "scope",
+          "datalog"
+        ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "type": "function",
-          "name": "init",
-          "limit": 10
+          "lang": [
+            "ts",
+            "csharp"
+          ],
+          "scope": {
+            "dir": "src"
+          },
+          "prefilter": {
+            "fts": "register*"
+          },
+          "datalog": {
+            "query": "[:find ?n :where [?n :node/kind \"IfStatement\"]]",
+            "bindings": [
+              "?n"
+            ],
+            "result": {
+              "nodeVar": "?n"
+            }
+          },
+          "page": {
+            "limit": 5,
+            "cursor": null
+          }
         },
         {
-          "q": "\"TODO\"",
-          "qMode": "fts",
-          "limit": 10
+          "lang": [
+            "ts"
+          ],
+          "scope": {
+            "node": {
+              "path": "src/app.ts#120-260:FunctionDeclaration",
+              "expectedHash": "p123:c456"
+            }
+          },
+          "datalog": {
+            "query": "[:find ?n ?c :where [?n :node/kind \"FunctionDeclaration\"] [?n :node/children ?c]]",
+            "bindings": [
+              "?n",
+              "?c"
+            ],
+            "result": {
+              "nodeVar": "?n",
+              "columns": {
+                "child": "?c"
+              }
+            }
+          },
+          "include": {
+            "self": true
+          },
+          "page": {
+            "limit": 5,
+            "cursor": null
+          }
         },
         {
-          "scopeNode": "src/services/",
-          "limit": 10
+          "lang": [
+            "ts",
+            "js"
+          ],
+          "scope": {
+            "node": {
+              "path": "src/service.ts#120-520:FunctionDeclaration",
+              "expectedHash": "p123:c456"
+            }
+          },
+          "datalog": {
+            "query": "[:find ?n ?parent ?role ?idx :where [?n :node/kind \"IfStatement\"] [?n :node/parent ?parent] [?n :node/role ?role] [?n :node/index-in-parent ?idx]]",
+            "bindings": [
+              "?n",
+              "?parent",
+              "?role",
+              "?idx"
+            ],
+            "result": {
+              "nodeVar": "?n",
+              "columns": {
+                "parent": "?parent",
+                "role": "?role",
+                "index": "?idx"
+              }
+            }
+          },
+          "include": {
+            "self": true,
+            "parents": true,
+            "topN": 5,
+            "maxChars": 4000
+          },
+          "page": {
+            "limit": 10,
+            "cursor": null
+          }
         }
       ]
     },
@@ -724,79 +685,30 @@
               "respectBoundaries": {
                 "type": "array",
                 "items": {
-                  "type": "string"
-                }
-              },
-              "timeLimitMs": {
-                "type": "number"
-              },
-              "memoryLimitBytes": {
-                "type": "number"
-              }
-            },
-            "additionalProperties": false
-          }
-        },
-        "required": [
-          "of",
-          "expectedHash"
-        ],
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "of": "src/service.ts#FD:2",
-          "expectedHash": "pabc:cdef",
-          "depth": 2
-        }
-      ]
-    },
-    {
-      "name": "get-content",
-      "category": "pando",
-      "signature": "get-content(target, format, maxBytes, offset)",
-      "description": "Read file content (repo-relative or absolute within root). maxBytes defaults to 500000 (clamped 1..2000000). format: 'raw' or 'parsed' (JSON only, offset=0, no truncation). Example: { target:'src/index.ts', maxBytes:2000 }",
-      "parameters": {
-        "type": "object",
-        "properties": {
-          "target": {
-            "type": "string",
-            "description": "Repo-relative path or absolute path under project root."
-          },
-          "format": {
-            "type": "string",
-            "description": "raw | parsed"
-          },
-          "maxBytes": {
-            "anyOf": [
-              {
-                "type": "number"
+                  "type": "string"
+                }
               },
-              {
-                "type": "string"
-              }
-            ]
-          },
-          "offset": {
-            "anyOf": [
-              {
+              "timeLimitMs": {
                 "type": "number"
               },
-              {
-                "type": "string"
+              "memoryLimitBytes": {
+                "type": "number"
               }
-            ]
+            },
+            "additionalProperties": false
           }
         },
         "required": [
-          "target"
+          "of",
+          "expectedHash"
         ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "target": "src/index.ts",
-          "maxBytes": 2000
+          "of": "src/service.ts#FD:2",
+          "expectedHash": "pabc:cdef",
+          "depth": 2
         }
       ]
     },
@@ -804,7 +716,7 @@
       "name": "get-db-schema",
       "category": "pando",
       "signature": "get-db-schema(includeColumns)",
-      "description": "Return the logical unified index schema only (aggregated across all index chunks, no per-chunk details). includeColumns defaults to true. Example: { includeColumns:true }",
+      "description": "Return the logical unified index schema only (aggregated across all index chunks, no per-chunk details). Use this before query-db to discover the real tables and columns available in the current index. For relationships, expect node_references plus dict_kinds/nodes rather than a generic cross-file relationships table. includeColumns defaults to true. Example: { includeColumns:true }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -826,7 +738,7 @@
       "name": "query-db",
       "category": "pando",
       "signature": "query-db(sql, maxRows)",
-      "description": "Execute passthrough SQL against all index chunks (readonly), then globally merge and apply ORDER BY/LIMIT/OFFSET semantics in code. Chunk identity is intentionally hidden from results. Example: { sql:'SELECT * FROM nodes LIMIT 20' }",
+      "description": "Execute passthrough SQL against all index chunks (readonly), then globally merge and apply ORDER BY/LIMIT/OFFSET semantics in code. Chunk identity is intentionally hidden from results. Use get-db-schema first when exploring. For relationship mining, inspect node_references plus dict_kinds; non-TS find-references/find-callers often resolve at query time via target_symbol_key or target_node_id rather than a generic relationships table. Grouped ORDER BY queries must include an explicit LIMIT. Example: { sql:'SELECT * FROM nodes LIMIT 20' }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -916,136 +828,400 @@
           }
         },
         "required": [
-          "bucket",
-          "key"
+          "bucket",
+          "key"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "bucket": "tool-results",
+          "key": "threads/123/tool-results/abc.json",
+          "maxBytes": 200000,
+          "encoding": "base64"
+        },
+        {
+          "bucket": "tool-results",
+          "key": "threads/123/tool-results/abc.json",
+          "maxBytes": 400000
+        }
+      ]
+    },
+    {
+      "name": "workspace-overview",
+      "category": "pando",
+      "signature": "workspace-overview()",
+      "description": "Summarize workspace files, node counts, modules, artifacts, and indexing status. IMPORTANT: All modifying pando operations (insert, replace, delete, rename, filter-map-reduce, etc.) automatically create snapshots before and after execution - you do NOT need to manually call snapshot-worktree before pando operations. Only use snapshot-worktree for non-pando file modifications (e.g., when using Write, Edit, or Bash tools to modify files). Example: {}",
+      "parameters": {
+        "type": "object",
+        "properties": {},
+        "required": [],
+        "additionalProperties": false
+      },
+      "examples": [
+        {}
+      ]
+    },
+    {
+      "name": "list-exports",
+      "category": "pando",
+      "signature": "list-exports(scope, symbolKinds, export_kinds, limit, offset)",
+      "description": "List exports with optional scope and filters. limit clamps to 100; offset clamps to >= 0. Example: { scope:'packages/ui/', limit:20 }",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "scope": {
+            "type": "string",
+            "description": "Path prefix to filter by module path."
+          },
+          "symbolKinds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Symbol categories (e.g., function, class)."
+          },
+          "export_kinds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Export kinds (e.g., named, default, reexport, star)."
+          },
+          "limit": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "offset": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "scope": "packages/ui/",
+          "limit": 20
+        }
+      ]
+    },
+    {
+      "name": "analyze-imports",
+      "category": "pando",
+      "signature": "analyze-imports(groupBy, limit, offset)",
+      "description": "Analyze imports and group by 'module' (default) or 'file'. limit clamps to 100; offset clamps to >= 0. Example: { groupBy:'module' }",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "groupBy": {
+            "type": "string",
+            "description": "module | file"
+          },
+          "limit": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "offset": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "groupBy": "module"
+        }
+      ]
+    },
+    {
+      "name": "clojure-namespace-graph",
+      "category": "pando",
+      "signature": "clojure-namespace-graph(includeExternal, scope, namespacePrefix, edgeKinds, limit, offset)",
+      "description": "Get the Clojure namespace dependency graph for the current workspace. Results are paged and can be filtered by repo-relative path scope, namespacePrefix, and edge kind. scope filters by file path prefix such as 'src/metabase/tracing/', while namespacePrefix filters by namespace name such as 'metabase.tracing'. Returns namespaces and edges with kinds like 'require', 'refer', 'refer-all', 'require-macros', 'refer-macros', 'refer-all-macros', and 'use'. Useful for understanding namespace structure and dependencies before refactoring.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "includeExternal": {
+            "type": "boolean",
+            "description": "Include external dependencies like clojure.* namespaces. Default: false (project namespaces only)."
+          },
+          "scope": {
+            "type": "string",
+            "description": "Optional repo-relative path prefix filter, e.g. 'src/metabase/tracing/'."
+          },
+          "namespacePrefix": {
+            "type": "string",
+            "description": "Optional namespace-name prefix filter, e.g. 'metabase.tracing'."
+          },
+          "edgeKinds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Optional edge kind filter, e.g. ['require', 'refer', 'refer-macros']."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Maximum number of namespaces and edges to return per page. Default: 100."
+          },
+          "offset": {
+            "type": "number",
+            "description": "Pagination offset for both namespaces and edges. Default: 0."
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "scope": "src/metabase/tracing/",
+          "namespacePrefix": "metabase.tracing",
+          "includeExternal": false,
+          "limit": 20,
+          "offset": 0
+        }
+      ]
+    },
+    {
+      "name": "clojure-namespace-dependencies",
+      "category": "pando",
+      "signature": "clojure-namespace-dependencies(namespace, transitive, edgeKinds, limit, offset)",
+      "description": "Get namespaces that the given Clojure namespace depends on. Returns the traversal root, discovered namespaces, and traversed edges. By default this is transitive; set transitive=false for direct dependencies only.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "namespace": {
+            "type": "string",
+            "description": "The fully-qualified namespace (e.g., 'myapp.core')."
+          },
+          "transitive": {
+            "type": "boolean",
+            "description": "When false, return only direct dependencies. Default: true."
+          },
+          "edgeKinds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Optional edge kind filter, e.g. ['require', 'refer', 'refer-macros']."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Maximum number of namespaces and edges to return per page. Default: 100."
+          },
+          "offset": {
+            "type": "number",
+            "description": "Pagination offset for both namespaces and edges. Default: 0."
+          }
+        },
+        "required": [
+          "namespace"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "namespace": "myapp.core",
+          "transitive": false,
+          "edgeKinds": [
+            "require",
+            "refer"
+          ],
+          "limit": 100,
+          "offset": 0
+        }
+      ]
+    },
+    {
+      "name": "clojure-namespace-dependents",
+      "category": "pando",
+      "signature": "clojure-namespace-dependents(namespace, transitive, edgeKinds, limit, offset)",
+      "description": "Get namespaces that depend on the given Clojure namespace. Returns the traversal root, discovered namespaces, and traversed edges. By default this is transitive; set transitive=false for direct dependents only.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "namespace": {
+            "type": "string",
+            "description": "The fully-qualified namespace (e.g., 'myapp.util')."
+          },
+          "transitive": {
+            "type": "boolean",
+            "description": "When false, return only direct dependents. Default: true."
+          },
+          "edgeKinds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Optional edge kind filter, e.g. ['require', 'refer', 'refer-macros']."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Maximum number of namespaces and edges to return per page. Default: 100."
+          },
+          "offset": {
+            "type": "number",
+            "description": "Pagination offset for both namespaces and edges. Default: 0."
+          }
+        },
+        "required": [
+          "namespace"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "namespace": "myapp.util",
+          "transitive": true,
+          "limit": 100,
+          "offset": 0
+        }
+      ]
+    },
+    {
+      "name": "plan-clojure-namespace-move",
+      "category": "pando",
+      "signature": "plan-clojure-namespace-move(namespace, newFile)",
+      "description": "Plan moving a Clojure namespace to a new file location. Returns a detailed plan including the new namespace name (derived from file path), affected files, and required changes to require statements. Does NOT execute the move - returns a plan only.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "namespace": {
+            "type": "string",
+            "description": "The current fully-qualified namespace (e.g., 'myapp.old.location')."
+          },
+          "newFile": {
+            "type": "string",
+            "description": "The new file path (e.g., 'src/myapp/new/location.clj'). The new namespace will be derived from this path."
+          }
+        },
+        "required": [
+          "namespace",
+          "newFile"
         ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "bucket": "tool-results",
-          "key": "threads/123/tool-results/abc.json",
-          "maxBytes": 200000,
-          "encoding": "base64"
-        },
-        {
-          "bucket": "tool-results",
-          "key": "threads/123/tool-results/abc.json",
-          "maxBytes": 400000
+          "namespace": "myapp.old.location",
+          "newFile": "src/myapp/new/location.clj"
         }
       ]
     },
     {
-      "name": "workspace-overview",
+      "name": "plan-clojure-namespace-rename",
       "category": "pando",
-      "signature": "workspace-overview()",
-      "description": "Summarize workspace files, node counts, modules, artifacts, and indexing status. Example: {}",
+      "signature": "plan-clojure-namespace-rename(oldNamespace, newNamespace)",
+      "description": "Plan renaming a Clojure namespace (keeping the same file). Returns affected files and required changes to require statements. Does NOT execute the rename; apply the planned changes manually.",
       "parameters": {
         "type": "object",
-        "properties": {},
-        "required": [],
+        "properties": {
+          "oldNamespace": {
+            "type": "string",
+            "description": "The current fully-qualified namespace (e.g., 'myapp.util')."
+          },
+          "newNamespace": {
+            "type": "string",
+            "description": "The new fully-qualified namespace (e.g., 'myapp.helpers')."
+          }
+        },
+        "required": [
+          "oldNamespace",
+          "newNamespace"
+        ],
         "additionalProperties": false
       },
       "examples": [
-        {}
+        {
+          "oldNamespace": "myapp.util",
+          "newNamespace": "myapp.helpers"
+        }
       ]
     },
     {
-      "name": "list-exports",
+      "name": "move-clojure-namespace",
       "category": "pando",
-      "signature": "list-exports(scope, symbolKinds, export_kinds, limit, offset)",
-      "description": "List exports with optional scope and filters. limit clamps to 100; offset clamps to >= 0. Example: { scope:'packages/ui/', limit:20 }",
+      "signature": "move-clojure-namespace(namespace, newFile)",
+      "description": "Rename a Clojure namespace and move its defining file. This uses the indexed namespace graph to plan dependent updates, applies the namespace rename, and then moves the file to newFile.",
       "parameters": {
         "type": "object",
         "properties": {
-          "scope": {
+          "namespace": {
             "type": "string",
-            "description": "Path prefix to filter by module path."
-          },
-          "symbolKinds": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Symbol categories (e.g., function, class)."
-          },
-          "export_kinds": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Export kinds (e.g., named, default, reexport, star)."
-          },
-          "limit": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "string"
-              }
-            ]
+            "description": "The current fully-qualified namespace (e.g., 'myapp.old.location')."
           },
-          "offset": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "string"
-              }
-            ]
+          "newFile": {
+            "type": "string",
+            "description": "The destination file path (e.g., 'src/myapp/new/location.clj')."
           }
         },
-        "required": [],
+        "required": [
+          "namespace",
+          "newFile"
+        ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "scope": "packages/ui/",
-          "limit": 20
+          "namespace": "myapp.old.location",
+          "newFile": "src/myapp/new/location.clj"
         }
       ]
     },
     {
-      "name": "analyze-imports",
+      "name": "rename-clojure-namespace",
       "category": "pando",
-      "signature": "analyze-imports(groupBy, limit, offset)",
-      "description": "Analyze imports and group by 'module' (default) or 'file'. limit clamps to 100; offset clamps to >= 0. Example: { groupBy:'module' }",
+      "signature": "rename-clojure-namespace(oldNamespace, newNamespace)",
+      "description": "Rename a Clojure namespace across the workspace using the normal rename machinery. This updates the namespace declaration and dependent references, but does not move the file.",
       "parameters": {
         "type": "object",
         "properties": {
-          "groupBy": {
+          "oldNamespace": {
             "type": "string",
-            "description": "module | file"
-          },
-          "limit": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "string"
-              }
-            ]
+            "description": "The current fully-qualified namespace (e.g., 'myapp.util')."
           },
-          "offset": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "string"
-              }
-            ]
+          "newNamespace": {
+            "type": "string",
+            "description": "The new fully-qualified namespace (e.g., 'myapp.helpers')."
           }
         },
-        "required": [],
+        "required": [
+          "oldNamespace",
+          "newNamespace"
+        ],
         "additionalProperties": false
       },
       "examples": [
         {
-          "groupBy": "module"
+          "oldNamespace": "myapp.util",
+          "newNamespace": "myapp.helpers"
         }
       ]
     },
@@ -1343,7 +1519,7 @@
       "name": "replace",
       "category": "pando",
       "signature": "replace(path, expectedHash, with, scope, forceReplaceWillBreakSyntax)",
-      "description": "Replace a node. scope='node' replaces the entire node (default). scope='body' replaces only the inner body (no braces) and fails if the target has no body. Requires expectedHash (no @). Example: { path:'src/app.ts#FD:0', expectedHash:'p123:c456', with:'function x() {}' }",
+      "description": "Replace a node. scope='node' replaces the entire node (default). scope='body' replaces only the inner body span and fails if the target has no body. For scope='body', provide body contents only, not enclosing delimiters; body replacement is pass-through and preserves the exact whitespace you provide. Requires expectedHash (no @). Example: { path:'src/app.ts#FD:0', expectedHash:'p123:c456', with:'function x() {}' }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -1361,7 +1537,7 @@
           },
           "scope": {
             "type": "string",
-            "description": "Replacement scope: 'node' (default) or 'body' (inner body only).",
+            "description": "Replacement scope: 'node' (default) or 'body' (inner body only, no enclosing delimiters).",
             "enum": [
               "node",
               "body"
@@ -1393,11 +1569,223 @@
         }
       ]
     },
+    {
+      "name": "replace-body",
+      "category": "pando",
+      "signature": "replace-body(path, expectedHash, with, forceReplaceWillBreakSyntax)",
+      "description": "Replace only a node body. This is equivalent to pando_replace with scope='body', but exposed as a dedicated tool for callers that need an explicit replace-body operation. Provide body contents only, not enclosing delimiters; the replacement text is written as-is, including indentation and leading/trailing whitespace. Requires expectedHash (no @). Example: { path:'src/app.ts#FD:0', expectedHash:'p123:c456', with:'console.log(1);' }",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Node path (file#nodePath) without @hash."
+          },
+          "expectedHash": {
+            "type": "string",
+            "description": "Hash portion only (no @)."
+          },
+          "with": {
+            "type": "string",
+            "description": "Replacement text for the inner body only. Do not include enclosing delimiters; whitespace is preserved exactly as provided."
+          },
+          "forceReplaceWillBreakSyntax": {
+            "type": "boolean",
+            "description": "Allow syntax errors after replacement."
+          }
+        },
+        "required": [
+          "path",
+          "expectedHash",
+          "with"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "path": "src/app.ts#FD:0",
+          "expectedHash": "p123:c456",
+          "with": "console.log(1);"
+        }
+      ]
+    },
+    {
+      "name": "change-signature",
+      "category": "pando",
+      "signature": "change-signature(path, expectedHash, parameters, returnType, makeAsync, makeSyncFromAsync, forceChangeWillBreakSyntax, boundary, batchSaves)",
+      "description": "Modify a function or method signature with best-effort call-site updates. Supports parameter add/remove/modify/reorder, return type changes, and async/sync conversion. Requires path and expectedHash (no @). Writes create automatic snapshots before and after the operation.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Node path without @hash (file#nodePath)."
+          },
+          "expectedHash": {
+            "type": "string",
+            "description": "Hash portion only (no @)."
+          },
+          "parameters": {
+            "type": "object",
+            "description": "Parameter changes to apply.",
+            "properties": {
+              "add": {
+                "type": "array",
+                "description": "Parameters to insert. position defaults to the end.",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "defaultValue": {
+                      "type": "string"
+                    },
+                    "position": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "callSiteArg": {
+                      "type": "string",
+                      "description": "Optional expression to insert at rewritten call sites for the new parameter."
+                    }
+                  },
+                  "required": [
+                    "name"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "remove": {
+                "type": "array",
+                "description": "Parameters to remove by name or zero-based index.",
+                "items": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "integer",
+                      "minimum": 0
+                    }
+                  ]
+                }
+              },
+              "modify": {
+                "type": "array",
+                "description": "Parameters to modify by name or zero-based index.",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "target": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "integer",
+                          "minimum": 0
+                        }
+                      ]
+                    },
+                    "newName": {
+                      "type": "string"
+                    },
+                    "newType": {
+                      "type": "string"
+                    },
+                    "newDefaultValue": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "target"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "reorder": {
+                "type": "array",
+                "description": "New parameter order by zero-based indices.",
+                "items": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              }
+            },
+            "additionalProperties": false
+          },
+          "returnType": {
+            "type": "string",
+            "description": "New declared return type."
+          },
+          "makeAsync": {
+            "type": "boolean",
+            "description": "Set the target function to async."
+          },
+          "makeSyncFromAsync": {
+            "type": "boolean",
+            "description": "Attempt to remove async from the target function."
+          },
+          "forceChangeWillBreakSyntax": {
+            "type": "boolean",
+            "description": "Allow syntax-breaking changes without rollback."
+          },
+          "boundary": {
+            "type": "string",
+            "description": "Search boundary: 'project' (default), 'reachable', or 'workspace'.",
+            "enum": [
+              "project",
+              "reachable",
+              "workspace"
+            ]
+          },
+          "batchSaves": {
+            "type": "boolean",
+            "description": "Batch writes until the operation completes."
+          }
+        },
+        "required": [
+          "path",
+          "expectedHash"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "path": "src/app.ts#FD:0",
+          "expectedHash": "p123:c456",
+          "parameters": {
+            "add": [
+              {
+                "name": "options",
+                "type": "Options",
+                "position": 1
+              }
+            ]
+          }
+        },
+        {
+          "path": "src/app.ts#FD:0",
+          "expectedHash": "p123:c456",
+          "parameters": {
+            "remove": [
+              "oldParam",
+              1
+            ]
+          },
+          "returnType": "Promise<void>"
+        }
+      ]
+    },
     {
       "name": "filter-map-reduce",
       "category": "pando",
       "signature": "filter-map-reduce(query, transforms, apply)",
-      "description": "Batch apply transforms to matches selected by the query. query accepts the same parameters as find-nodes; see find-nodes documentation. Supported transforms: insert, delete, replace (use scope:'body' for body-only). Transforms must NOT include expectedHash (hashes are derived from matches). Matches are applied per-file in descending start offset order to reduce drift. Anchors accept $MATCH, $LABEL(name), and $CREATED[idx] (negative idx allowed). apply.pageSize clamps to 100. apply.maxMatches can cap total matches. Example: { query:{ symbolKinds:['function'], name:'foo' }, transforms:[{ op:'insert', to:{ bodyEndOf:'$MATCH' }, code:'\\nreturn 1;', replaceExistingNodeAtPath:false }] }",
+      "description": "Batch apply transforms to matches selected by query. query uses the same current Datalog-only shape as find-nodes: { op?, lang?, snapshot?, scope, datalog, prefilter?, include?, page? }. Do not use legacy query fields such as type, name, q, qMode, symbolKinds, scopeNode, limit, offset, or cursor at top level. Supported transforms: insert, delete, replace (use scope:'body' for body-only). filter-map-reduce does NOT take caller-supplied hashes: do NOT pass expectedHash or expectedHashes anywhere in this request or inside transforms. Hashes are derived automatically from matched nodes. Matches are applied per-file in descending start offset order to reduce drift. Anchors accept $MATCH, $LABEL(name), and $CREATED[idx] (negative idx allowed). apply.pageSize clamps to 100. apply.maxMatches can cap total matches. Example: { query:{ op:'find-nodes', lang:['ts','js'], scope:{workspace:true}, datalog:{query:'[:find ?n :where [?n :node/name \"foo\"]]', bindings:['?n'], result:{nodeVar:'?n'}} }, transforms:[{ op:'insert', to:{ bodyEndOf:'$MATCH' }, code:'\\nreturn 1;', replaceExistingNodeAtPath:false }] }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -1595,8 +1983,23 @@
       "examples": [
         {
           "query": {
-            "type": "function",
-            "name": "foo"
+            "op": "find-nodes",
+            "lang": [
+              "ts",
+              "js"
+            ],
+            "scope": {
+              "workspace": true
+            },
+            "datalog": {
+              "query": "[:find ?n :where [?n :node/name \"foo\"]]",
+              "bindings": [
+                "?n"
+              ],
+              "result": {
+                "nodeVar": "?n"
+              }
+            }
           },
           "transforms": [
             {
@@ -1778,7 +2181,7 @@
       "name": "snapshot-worktree",
       "category": "pando",
       "signature": "snapshot-worktree(message, trailers)",
-      "description": "Snapshot current git worktree changes. If no changes, returns snapshotSkipped=true. message and trailers are optional. Example: { message:'checkpoint', trailers:{ ticket:'ABC-123' } }",
+      "description": "Manually snapshot current git worktree changes. Use ONLY for non-pando file modifications (e.g., when using Write, Edit, or Bash tools). DO NOT use before pando operations (insert, replace, delete, rename, filter-map-reduce) - they automatically create snapshots before and after. If no changes, returns snapshotSkipped=true. message and trailers are optional. Example: { message:'checkpoint', trailers:{ ticket:'ABC-123' } }",
       "parameters": {
         "type": "object",
         "properties": {