pando-ai 0.0.19 → 0.1.0

package/resources/tools/pando-tools.json

@@ -23,30 +23,20 @@
     "read-this-first()",
     "get-project-root()",
     "set-project-root(root)",
-    "get-enabled-languages()",
-    "set-enabled-languages(languages)",
     "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-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)",
@@ -64,7 +54,7 @@
       "name": "read-this-first",
       "category": "pando",
       "signature": "read-this-first()",
-      "description": "pandō tools primary advantage: AST-based and each operation creates a semantic snapshot. AST-based tools are faster, cheaper, and more accurate for code operations (search, refactor). Supported languages: Typescript, Javascript, Python, C/C++, C#, Clojure, ClojureScript pandō snapshots are taken after any pandō modifying operation automatically and thus capture the full repo state before and after the operation (the initial snapshot is always created when you start the extension), making recovery trivial without manual commit text. Important: strongly prefer to and fearlessly use pandō tools (e.g., rename, delete, filter-map-reduce) even across many items and NEVER ask for permission for pando ops; undo is a single restore snapshot away. Modifying pandō tools intentionally do not have dry-run modes because auto-snapshots are the safety net. You can always use pando revert-snapshot since it is safe, it simply creates a new snapshot. Group changes across the repo into logical groups. Use pando_snapshot_worktree ONLY when you are NOT using pando tools (pando tools create snapshots automatically). This applies equally to MCP server actions. Backend auto-populates snapshot trailers for pando_snapshot_worktree with agent context (Agent-Mode, Agent-Thread-Id, Agent-Request-Id, Agent-Model, Agent-Source, plus AST-Op/AST-Params) and preserves any trailers you supply. Non-pando Skip pandō tools only 1. After you exhausted all options to use them AND 2. When they are too cumbersome or unusable (e.g., unsupported languages, non-code files, indexing is not working) or text-based tools would simply work better. Source code files larger than 1MB are NOT indexed by pando; if you need to work with them, use text-based tools (if at all). 2-step workflow example (find-nodes → rename): Find the declaration (get a stable path + expectedHash): { \"tool\": \"find-nodes\", \"args\": { \"symbolKinds\": [\"function\"], \"name\": \"myFunction\", \"include\": { \"self\": true, \"topN\": 1 } } } Rename exactly that symbol (hash-verified, snapshots automatically): { \"tool\": \"rename\", \"args\": { \"path\": \"src/app.ts#FD:0\", \"expectedHash\": \"p123:c456\", \"newName\": \"myNewFunction\" } } Workflow Comparison: Renaming myFunction to myNewFunction Traditional text tools scan the whole repo to find (O(n)) and then replace (still tied to O(n) file touching). pandō does an indexed lookup (effectively O(1)) to identify the exact declaration + references, then applies targeted edits proportional to the number of actual references (O(m)), with automatic snapshots as the safety net.",
+      "description": "Quickstart hints for Pando AST usage. Returns a short help block. Example: {}",
       "parameters": {
         "type": "object",
         "properties": {},
@@ -114,66 +104,11 @@
         }
       ]
     },
-    {
-      "name": "get-enabled-languages",
-      "category": "pando",
-      "signature": "get-enabled-languages()",
-      "description": "Return the currently enabled indexing languages for the selected root, plus the full list of language ids that can be set. Example: {}",
-      "parameters": {
-        "type": "object",
-        "properties": {},
-        "required": [],
-        "additionalProperties": false
-      },
-      "examples": [
-        {}
-      ]
-    },
-    {
-      "name": "set-enabled-languages",
-      "category": "pando",
-      "signature": "set-enabled-languages(languages)",
-      "description": "Persist the enabled indexing languages for the selected root. The provided array becomes the supported language list. Example: { languages: ['clojure'] }",
-      "parameters": {
-        "type": "object",
-        "properties": {
-          "languages": {
-            "type": "array",
-            "description": "Language ids to keep enabled for indexing.",
-            "items": {
-              "type": "string",
-              "enum": [
-                "ts",
-                "js",
-                "python",
-                "c",
-                "cpp",
-                "csharp",
-                "dart",
-                "java",
-                "clojure"
-              ]
-            }
-          }
-        },
-        "required": [
-          "languages"
-        ],
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "languages": [
-            "clojure"
-          ]
-        }
-      ]
-    },
     {
       "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' (SQLite MATCH syntax) or 'like' (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/arities for topN<=5. Examples: { symbolKinds:['function'], name:'init', limit:10 }, { q:'\"TODO\"', qMode:'fts', limit:10 }, { scopeNode:'src/services/', limit:10 }",
+      "description": "Search code nodes by symbolKinds/name/text/scope with optional enrichment. qMode: 'fts' (SQLite MATCH syntax) or 'like' (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\"', qMode:'fts', limit:10 }, { scopeNode:'src/services/', limit:10 }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -391,10 +326,6 @@
                 "type": "boolean",
                 "description": "Include parent chain metadata."
               },
-              "arities": {
-                "type": "boolean",
-                "description": "For Clojure, include explicit multi-arity clause targets with path/hash/ref so body edits can target a single arity."
-              },
               "topN": {
                 "type": "integer",
                 "description": "How many results to fully enrich (0-5).",
@@ -820,11 +751,60 @@
         }
       ]
     },
+    {
+      "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"
+              }
+            ]
+          },
+          "offset": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": [
+          "target"
+        ],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "target": "src/index.ts",
+          "maxBytes": 2000
+        }
+      ]
+    },
     {
       "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). 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 }",
+      "description": "Return the logical unified index schema only (aggregated across all index chunks, no per-chunk details). includeColumns defaults to true. Example: { includeColumns:true }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -846,7 +826,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. 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' }",
+      "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' }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -959,7 +939,7 @@
       "name": "workspace-overview",
       "category": "pando",
       "signature": "workspace-overview()",
-      "description": "Summarize workspace files, node counts, modules, artifacts, indexing status, and storage paths. The result includes `storage.pandoDataDir`, `storage.chunkDbs`, and `storage.historyDir`. 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: {}",
+      "description": "Summarize workspace files, node counts, modules, artifacts, and indexing status. Example: {}",
       "parameters": {
         "type": "object",
         "properties": {},
@@ -1069,270 +1049,6 @@
         }
       ]
     },
-    {
-      "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": [
-        {
-          "namespace": "myapp.old.location",
-          "newFile": "src/myapp/new/location.clj"
-        }
-      ]
-    },
-    {
-      "name": "plan-clojure-namespace-rename",
-      "category": "pando",
-      "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": {
-          "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": "move-clojure-namespace",
-      "category": "pando",
-      "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": {
-          "namespace": {
-            "type": "string",
-            "description": "The current fully-qualified namespace (e.g., 'myapp.old.location')."
-          },
-          "newFile": {
-            "type": "string",
-            "description": "The destination file path (e.g., 'src/myapp/new/location.clj')."
-          }
-        },
-        "required": [
-          "namespace",
-          "newFile"
-        ],
-        "additionalProperties": false
-      },
-      "examples": [
-        {
-          "namespace": "myapp.old.location",
-          "newFile": "src/myapp/new/location.clj"
-        }
-      ]
-    },
-    {
-      "name": "rename-clojure-namespace",
-      "category": "pando",
-      "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": {
-          "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": "rename",
       "category": "pando",
@@ -1627,7 +1343,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 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() {}' }",
+      "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() {}' }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -1645,7 +1361,7 @@
           },
           "scope": {
             "type": "string",
-            "description": "Replacement scope: 'node' (default) or 'body' (inner body only, no enclosing delimiters).",
+            "description": "Replacement scope: 'node' (default) or 'body' (inner body only).",
             "enum": [
               "node",
               "body"
@@ -1677,223 +1393,11 @@
         }
       ]
     },
-    {
-      "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). 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:{ symbolKinds:['function'], name:'foo' }, transforms:[{ op:'insert', to:{ bodyEndOf:'$MATCH' }, code:'\\nreturn 1;', replaceExistingNodeAtPath:false }] }",
+      "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 }] }",
       "parameters": {
         "type": "object",
         "properties": {
@@ -2274,7 +1778,7 @@
       "name": "snapshot-worktree",
       "category": "pando",
       "signature": "snapshot-worktree(message, trailers)",
-      "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' } }",
+      "description": "Snapshot current git worktree changes. If no changes, returns snapshotSkipped=true. message and trailers are optional. Example: { message:'checkpoint', trailers:{ ticket:'ABC-123' } }",
       "parameters": {
         "type": "object",
         "properties": {