@rethunk/mcp-multi-root-git 2.9.0 → 3.1.0

package/schemas/batch_commit.json

@@ -5,20 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -62,13 +51,13 @@
                         "from": {
                           "type": "integer",
                           "minimum": 1,
-                          "maximum": 9007199254740991,
+                          "maximum": 1000000,
                           "description": "Start line number (1-indexed)."
                         },
                         "to": {
                           "type": "integer",
                           "minimum": 1,
-                          "maximum": 9007199254740991,
+                          "maximum": 1000000,
                           "description": "End line number (1-indexed, inclusive)."
                         }
                       },
@@ -88,7 +77,7 @@
                 }
               ]
             },
-            "description": "Paths to stage, relative to the git root. Each can be a string path or { path, lines } for hunk-level staging. Deleted files (missing on disk but tracked in HEAD) are staged as removals via `git rm --cached`. Combining { path, lines } with a deleted file is an error."
+            "description": "Paths to stage, relative to git root. String or `{ path, lines }` for hunk-level staging. Deleted tracked files are staged via `git rm --cached`. Cannot combine `lines` with a deleted file."
           }
         },
         "required": [
@@ -97,11 +86,11 @@
         ],
         "additionalProperties": false
       },
-      "description": "Commits to create, applied in order."
+      "description": "Ordered list of commits to create."
     },
     "push": {
       "default": "never",
-      "description": "`never` (default): no push. `after`: push the current branch to its upstream once all commits succeed; fails with `push_no_upstream` if the branch has no upstream (commits are NOT rolled back). Enum reserved for future modes such as `force-with-lease`.",
+      "description": "`never` (default): no push. `after`: push current branch to upstream after all commits succeed; fails with `push_no_upstream` if no upstream (commits are NOT rolled back).",
       "type": "string",
       "enum": [
         "never",
@@ -110,12 +99,11 @@
     },
     "dryRun": {
       "default": false,
-      "description": "When true, stage files, collect preview (files staged, commit messages), return preview response without writing commits. Unstages any files that were staged for the preview. Response indicates DRY RUN mode.",
+      "description": "Stage files and return a preview without writing commits; unstages afterwards. Response is marked DRY RUN.",
       "type": "boolean"
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "commits",
     "push",

package/schemas/git_blame.json

@@ -5,15 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -35,18 +29,26 @@
       "description": "First line of the range to blame (1-based). Requires endLine.",
       "type": "integer",
       "minimum": 1,
-      "maximum": 9007199254740991
+      "maximum": 1000000
     },
     "endLine": {
       "description": "Last line of the range to blame (1-based, inclusive). Requires startLine.",
       "type": "integer",
       "minimum": 1,
-      "maximum": 9007199254740991
+      "maximum": 1000000
+    },
+    "maxLines": {
+      "default": 2000,
+      "description": "Max blamed lines to return. Default: 2000.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 10000
     }
   },
   "required": [
     "format",
-    "path"
+    "path",
+    "maxLines"
   ],
   "additionalProperties": false
 }

package/schemas/git_branch_list.json

@@ -5,15 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -24,7 +18,7 @@
     },
     "includeRemotes": {
       "default": false,
-      "description": "When true, also return remote-tracking branches from refs/remotes (excluding symbolic origin/HEAD).",
+      "description": "Include remote-tracking branches from refs/remotes (symbolic origin/HEAD excluded).",
       "type": "boolean"
     }
   },

package/schemas/git_cherry_pick.json

@@ -5,20 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -35,7 +24,7 @@
         "type": "string",
         "minLength": 1
       },
-      "description": "Sources to cherry-pick: SHA, `A..B` range, or branch name. Branch sources resolve to `onto..<branch>` (only commits missing from destination)."
+      "description": "Sources: SHA, `A..B` range, or branch name (resolves to `onto..<branch>`)."
     },
     "onto": {
       "description": "Destination branch. Defaults to the currently checked-out branch.",
@@ -43,22 +32,21 @@
     },
     "deleteMergedBranches": {
       "default": false,
-      "description": "After all commits apply, delete each branch-kind source locally (`git branch -d`) when it is fully merged into the destination. Protected names always skipped; never touches remote refs.",
+      "description": "Delete branch-kind sources locally after success. Protected names and remote refs unaffected.",
       "type": "boolean"
     },
     "deleteMergedWorktrees": {
       "default": false,
-      "description": "After success, remove any local worktree attached to a branch-kind source (`git worktree remove`). Protected tails always skipped.",
+      "description": "Remove local worktrees on branch-kind sources after success. Protected tails skipped.",
       "type": "boolean"
     },
     "strictMergedRefEquality": {
       "default": false,
-      "description": "When false (default), branch deletion uses patch-id equivalence: a source branch is deleted when every commit it contains has a content-equivalent commit on the destination (same diff, different SHA — the normal cherry-pick outcome). Set to true to require strict ref ancestry (`git branch -d` semantics), which will refuse deletion after a cherry-pick because the SHA differs.",
+      "description": "false (default): delete branch when every commit is content-equivalent on destination (patch-id, normal cherry-pick outcome). true: require strict ref ancestry (`git branch -d` semantics — will refuse after cherry-pick due to SHA mismatch).",
       "type": "boolean"
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "sources",
     "deleteMergedBranches",

package/schemas/git_diff.json

@@ -5,15 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -23,19 +17,19 @@
       ]
     },
     "base": {
-      "description": "Base ref (e.g. \"main\", \"HEAD~3\"). Required for range diffs. If omitted and `staged: false`, shows unstaged changes.",
+      "description": "Base ref (e.g. \"main\", \"HEAD~3\"). Omit for unstaged changes.",
       "type": "string"
     },
     "head": {
-      "description": "Head ref (e.g. \"feature-branch\"). If omitted, defaults to HEAD. Only used if `base` is provided.",
+      "description": "Head ref (e.g. \"feature-branch\"). Defaults to HEAD. Used only when `base` is set.",
       "type": "string"
     },
     "path": {
-      "description": "Scope diff to a single file path (e.g. \"src/main.ts\"). For multiple files, prefer `paths`. If both `path` and `paths` are given, they are unioned.",
+      "description": "Scope to a single file. Unioned with `paths` if both given.",
       "type": "string"
     },
     "paths": {
-      "description": "Scope diff to multiple file paths (e.g. [\"src/a.ts\", \"src/b.ts\"]). Each path is validated and must lie within the repository root. If both `path` and `paths` are given, they are unioned.",
+      "description": "Scope to multiple files (must be within repo root). Unioned with `path` if both given.",
       "type": "array",
       "items": {
         "type": "string"
@@ -43,11 +37,11 @@
     },
     "staged": {
       "default": false,
-      "description": "If true, show staged changes (git diff --staged). Ignored if `base` is provided.",
+      "description": "Show staged changes (`git diff --staged`). Ignored if `base` is set.",
       "type": "boolean"
     },
     "unified": {
-      "description": "Number of context lines to show around each change (passed as -U<n> to git diff). Defaults to git's built-in default (3). Use 0 for no context.",
+      "description": "Context lines around each change (`-U<n>`). Default: 3. Use 0 for no context.",
       "type": "integer",
       "minimum": 0,
       "maximum": 100

package/schemas/git_diff_summary.json

@@ -5,23 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "absoluteGitRoots": {
-      "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
-      "maxItems": 256,
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -53,7 +39,7 @@
       "maximum": 500
     },
     "excludePatterns": {
-      "description": "Glob patterns to exclude. Defaults to common noise: lock files, dist, vendor, etc.",
+      "description": "Glob patterns to exclude. Default: lock files, dist, vendor, etc.",
       "type": "array",
       "items": {
         "type": "string"

package/schemas/git_fetch.json

@@ -5,15 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
     "format": {
       "default": "markdown",
       "type": "string",

package/schemas/git_inventory.json

@@ -4,28 +4,24 @@
   "description": "Parameter schema for the 'git_inventory' MCP tool.",
   "type": "object",
   "properties": {
-    "workspaceRoot": {
-      "description": "Highest-priority override.",
-      "type": "string"
-    },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
-    "absoluteGitRoots": {
-      "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
-      "maxItems": 256,
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
+    "root": {
+      "description": "Repo path, array of paths, or \"*\" for all MCP roots.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "maxItems": 256,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "string",
+          "const": "*"
+        }
+      ]
     },
     "format": {
       "default": "markdown",
@@ -65,7 +61,6 @@
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "presetMerge",
     "maxRoots"

package/schemas/git_log.json

@@ -4,32 +4,28 @@
   "description": "Parameter schema for the 'git_log' MCP tool.",
   "type": "object",
   "properties": {
-    "workspaceRoot": {
-      "description": "Highest-priority override.",
-      "type": "string"
-    },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
-    "absoluteGitRoots": {
-      "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
-      "maxItems": 256,
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
+    "root": {
+      "description": "Repo path, array of paths, or \"*\" for all MCP roots.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "maxItems": 256,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "string",
+          "const": "*"
+        }
+      ]
     },
     "format": {
       "default": "markdown",
-      "description": "`markdown` (default): headed sections per root. `json`: structured groups array. `oneline`: `<sha7> <subject>` per line, no headers (single-root) or `### repo (branch)` separator per group (multi-root). Lowest-token option for post-commit verification.",
+      "description": "`markdown` (default): headed sections per root. `json`: groups array. `oneline`: `<sha7> <subject>` per line; lowest-token option for post-commit verification.",
       "type": "string",
       "enum": [
         "markdown",
@@ -38,27 +34,27 @@
       ]
     },
     "since": {
-      "description": "Passed to `git log --since=`. Accepts ISO timestamps or git relative forms like `48.hours` or `2.weeks.ago`. Default: `7.days`.",
+      "description": "Passed to `--since=`. ISO timestamp or git relative form (`48.hours`, `2.weeks.ago`). Default: `7.days`.",
       "type": "string"
     },
     "paths": {
-      "description": "Limit to commits touching these paths (passed as `-- <paths>`).",
+      "description": "Limit to commits touching these paths (`-- <paths>`).",
       "type": "array",
       "items": {
         "type": "string"
       }
     },
     "grep": {
-      "description": "Filter commits whose message matches this regex (git `--grep`, case-insensitive).",
+      "description": "Filter by commit message regex (git `--grep`, case-insensitive).",
       "type": "string"
     },
     "author": {
-      "description": "Filter by author name or email (passed as `--author=`).",
+      "description": "Filter by author name or email (`--author=`).",
       "type": "string"
     },
     "maxCommits": {
       "default": 50,
-      "description": "Maximum commits to return per root (hard cap 500). Default 50.",
+      "description": "Max commits per root (hard cap 500, default 50).",
       "type": "integer",
       "minimum": 1,
       "maximum": 500
@@ -69,7 +65,6 @@
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "maxCommits"
   ],

package/schemas/git_merge.json

@@ -5,20 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -58,17 +47,16 @@
     },
     "deleteMergedBranches": {
       "default": false,
-      "description": "After all sources merge cleanly, delete each source branch locally (`git branch -d`). Protected names always skipped. Never affects remote branches.",
+      "description": "Delete each source branch locally after clean merge (`git branch -d`). Protected names and remote refs unaffected.",
       "type": "boolean"
     },
     "deleteMergedWorktrees": {
       "default": false,
-      "description": "After all sources merge cleanly, remove any local worktree currently checked out on a source branch (`git worktree remove`). Protected tails always skipped.",
+      "description": "Remove local worktrees on source branches after clean merge (`git worktree remove`). Protected tails skipped.",
       "type": "boolean"
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "sources",
     "strategy",

package/schemas/git_parity.json

@@ -4,28 +4,24 @@
   "description": "Parameter schema for the 'git_parity' MCP tool.",
   "type": "object",
   "properties": {
-    "workspaceRoot": {
-      "description": "Highest-priority override.",
-      "type": "string"
-    },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
-    "absoluteGitRoots": {
-      "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
-      "maxItems": 256,
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
+    "root": {
+      "description": "Repo path, array of paths, or \"*\" for all MCP roots.",
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "maxItems": 256,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        {
+          "type": "string",
+          "const": "*"
+        }
+      ]
     },
     "format": {
       "default": "markdown",
@@ -66,7 +62,6 @@
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "presetMerge"
   ],

package/schemas/git_push.json

@@ -5,20 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -42,7 +31,6 @@
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "setUpstream"
   ],

package/schemas/git_reflog.json

@@ -5,15 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
     "format": {
       "default": "markdown",
       "type": "string",

package/schemas/git_reset_soft.json

@@ -5,20 +5,9 @@
   "type": "object",
   "properties": {
     "workspaceRoot": {
-      "description": "Highest-priority override.",
+      "description": "Repo path. Default: first MCP root / cwd.",
       "type": "string"
     },
-    "rootIndex": {
-      "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
-      "type": "integer",
-      "minimum": 0,
-      "maximum": 9007199254740991
-    },
-    "allWorkspaceRoots": {
-      "default": false,
-      "description": "Fan out across all MCP file roots.",
-      "type": "boolean"
-    },
     "format": {
       "default": "markdown",
       "type": "string",
@@ -30,11 +19,10 @@
     "ref": {
       "type": "string",
       "minLength": 1,
-      "description": "Commit to reset to. Accepts ancestor notation (`HEAD~1`, `HEAD~3`), branch names, or full SHAs."
+      "description": "Commit to reset to: ancestor notation (`HEAD~1`, `HEAD~3`), branch name, or SHA."
     }
   },
   "required": [
-    "allWorkspaceRoots",
     "format",
     "ref"
   ],