@rethunk/mcp-multi-root-git 2.3.4 → 2.5.0

package/tool-parameters.schema.json

@@ -266,10 +266,12 @@
         },
         "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.",
           "type": "string",
           "enum": [
             "markdown",
-            "json"
+            "json",
+            "oneline"
           ]
         },
         "since": {
@@ -383,6 +385,103 @@
       ],
       "additionalProperties": false
     },
+    "git_diff": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "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"
+          }
+        },
+        "format": {
+          "default": "markdown",
+          "type": "string",
+          "enum": [
+            "markdown",
+            "json"
+          ]
+        },
+        "base": {
+          "description": "Base ref (e.g. \"main\", \"HEAD~3\"). Required for range diffs. If omitted and `staged: false`, shows unstaged changes.",
+          "type": "string"
+        },
+        "head": {
+          "description": "Head ref (e.g. \"feature-branch\"). If omitted, defaults to HEAD. Only used if `base` is provided.",
+          "type": "string"
+        },
+        "path": {
+          "description": "Scope diff to a single file path (e.g. \"src/main.ts\").",
+          "type": "string"
+        },
+        "staged": {
+          "default": false,
+          "description": "If true, show staged changes (git diff --staged). Ignored if `base` is provided.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "allWorkspaceRoots",
+        "format",
+        "staged"
+      ],
+      "additionalProperties": false
+    },
+    "git_show": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "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
+        },
+        "format": {
+          "default": "markdown",
+          "type": "string",
+          "enum": [
+            "markdown",
+            "json"
+          ]
+        },
+        "ref": {
+          "type": "string",
+          "description": "Commit reference (SHA, branch, tag, or any git rev-spec)."
+        },
+        "path": {
+          "description": "Optional file path to inspect at the ref. If provided, shows that path's content at the ref instead of the diff.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "format",
+        "ref"
+      ],
+      "additionalProperties": false
+    },
     "git_worktree_list": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
@@ -411,6 +510,84 @@
       ],
       "additionalProperties": false
     },
+    "git_stash_list": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "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
+        },
+        "format": {
+          "default": "markdown",
+          "type": "string",
+          "enum": [
+            "markdown",
+            "json"
+          ]
+        }
+      },
+      "required": [
+        "format"
+      ],
+      "additionalProperties": false
+    },
+    "git_fetch": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "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
+        },
+        "format": {
+          "default": "markdown",
+          "type": "string",
+          "enum": [
+            "markdown",
+            "json"
+          ]
+        },
+        "remote": {
+          "default": "origin",
+          "description": "Remote to fetch from (default: origin).",
+          "type": "string"
+        },
+        "branch": {
+          "description": "If specified: fetch only this branch (e.g. 'main').",
+          "type": "string"
+        },
+        "prune": {
+          "default": false,
+          "description": "Pass --prune to remove deleted remote branches (default: false).",
+          "type": "boolean"
+        },
+        "tags": {
+          "default": false,
+          "description": "Pass --tags to also fetch all tags (default: false).",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "format",
+        "remote",
+        "prune",
+        "tags"
+      ],
+      "additionalProperties": false
+    },
     "batch_commit": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
@@ -454,10 +631,52 @@
                 "minItems": 1,
                 "type": "array",
                 "items": {
-                  "type": "string",
-                  "minLength": 1
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "path": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "File path relative to git root."
+                        },
+                        "lines": {
+                          "type": "object",
+                          "properties": {
+                            "from": {
+                              "type": "integer",
+                              "minimum": 1,
+                              "maximum": 9007199254740991,
+                              "description": "Start line number (1-indexed)."
+                            },
+                            "to": {
+                              "type": "integer",
+                              "minimum": 1,
+                              "maximum": 9007199254740991,
+                              "description": "End line number (1-indexed, inclusive)."
+                            }
+                          },
+                          "required": [
+                            "from",
+                            "to"
+                          ],
+                          "additionalProperties": false,
+                          "description": "Line range to stage. Only hunks overlapping [from, to] are staged."
+                        }
+                      },
+                      "required": [
+                        "path",
+                        "lines"
+                      ],
+                      "additionalProperties": false
+                    }
+                  ]
                 },
-                "description": "Paths to stage, relative to the git root."
+                "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."
               }
             },
             "required": [
@@ -476,13 +695,19 @@
             "never",
             "after"
           ]
+        },
+        "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.",
+          "type": "boolean"
         }
       },
       "required": [
         "allWorkspaceRoots",
         "format",
         "commits",
-        "push"
+        "push",
+        "dryRun"
       ],
       "additionalProperties": false
     },
@@ -661,6 +886,11 @@
           "default": false,
           "description": "After success, remove any local worktree attached to a branch-kind source (`git worktree remove`). Protected tails always 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.",
+          "type": "boolean"
         }
       },
       "required": [
@@ -668,7 +898,8 @@
         "format",
         "sources",
         "deleteMergedBranches",
-        "deleteMergedWorktrees"
+        "deleteMergedWorktrees",
+        "strictMergedRefEquality"
       ],
       "additionalProperties": false
     },
@@ -712,6 +943,54 @@
       ],
       "additionalProperties": false
     },
+    "git_tag": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "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
+        },
+        "format": {
+          "default": "markdown",
+          "type": "string",
+          "enum": [
+            "markdown",
+            "json"
+          ]
+        },
+        "tag": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Tag name (e.g. 'v1.2.3')."
+        },
+        "message": {
+          "description": "If provided, create an annotated tag with this message. If absent, create a lightweight tag.",
+          "type": "string"
+        },
+        "ref": {
+          "description": "Commit/ref to tag (default: HEAD). Ignored if `delete` is true.",
+          "type": "string"
+        },
+        "delete": {
+          "default": false,
+          "description": "If true, delete the named tag instead of creating it.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "format",
+        "tag",
+        "delete"
+      ],
+      "additionalProperties": false
+    },
     "git_worktree_add": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
@@ -807,6 +1086,48 @@
         "force"
       ],
       "additionalProperties": false
+    },
+    "git_stash_apply": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "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
+        },
+        "format": {
+          "default": "markdown",
+          "type": "string",
+          "enum": [
+            "markdown",
+            "json"
+          ]
+        },
+        "index": {
+          "default": 0,
+          "description": "Stash index (defaults to 0 for stash@{0}).",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "pop": {
+          "default": false,
+          "description": "If true, runs `git stash pop` instead of `git stash apply` (removes stash after applying).",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "format",
+        "index",
+        "pop"
+      ],
+      "additionalProperties": false
     }
   }
 }