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

package/schemas/git_worktree_add.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_worktree_add",
+  "description": "Parameter schema for the 'git_worktree_add' 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"
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Filesystem path for the new worktree. Relative paths are resolved from the git toplevel."
+    },
+    "branch": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Branch to check out in the new worktree. Created from `baseRef` if absent."
+    },
+    "baseRef": {
+      "description": "Commit-ish to base the new branch on when it does not yet exist. Default: HEAD.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "path",
+    "branch"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_worktree_list.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_worktree_list",
+  "description": "Parameter schema for the 'git_worktree_list' 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
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    }
+  },
+  "required": [
+    "format"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_worktree_remove.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_worktree_remove",
+  "description": "Parameter schema for the 'git_worktree_remove' 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"
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Path of the worktree to remove. Must not be the main worktree."
+    },
+    "force": {
+      "default": false,
+      "description": "Pass `--force` to allow removal of worktrees with uncommitted changes.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "path",
+    "force"
+  ],
+  "additionalProperties": false
+}

package/schemas/index.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git tool schemas index",
+  "description": "Index of all available MCP tool parameter schemas.",
+  "generatedBy": "scripts/generate-individual-schemas.ts",
+  "tools": [
+    {
+      "name": "git_status",
+      "file": "git_status.json",
+      "description": "Parameter schema for the 'git_status' MCP tool."
+    },
+    {
+      "name": "git_inventory",
+      "file": "git_inventory.json",
+      "description": "Parameter schema for the 'git_inventory' MCP tool."
+    },
+    {
+      "name": "git_parity",
+      "file": "git_parity.json",
+      "description": "Parameter schema for the 'git_parity' MCP tool."
+    },
+    {
+      "name": "list_presets",
+      "file": "list_presets.json",
+      "description": "Parameter schema for the 'list_presets' MCP tool."
+    },
+    {
+      "name": "git_log",
+      "file": "git_log.json",
+      "description": "Parameter schema for the 'git_log' MCP tool."
+    },
+    {
+      "name": "git_diff_summary",
+      "file": "git_diff_summary.json",
+      "description": "Parameter schema for the 'git_diff_summary' MCP tool."
+    },
+    {
+      "name": "git_diff",
+      "file": "git_diff.json",
+      "description": "Parameter schema for the 'git_diff' MCP tool."
+    },
+    {
+      "name": "git_show",
+      "file": "git_show.json",
+      "description": "Parameter schema for the 'git_show' MCP tool."
+    },
+    {
+      "name": "git_worktree_list",
+      "file": "git_worktree_list.json",
+      "description": "Parameter schema for the 'git_worktree_list' MCP tool."
+    },
+    {
+      "name": "git_stash_list",
+      "file": "git_stash_list.json",
+      "description": "Parameter schema for the 'git_stash_list' MCP tool."
+    },
+    {
+      "name": "git_fetch",
+      "file": "git_fetch.json",
+      "description": "Parameter schema for the 'git_fetch' MCP tool."
+    },
+    {
+      "name": "batch_commit",
+      "file": "batch_commit.json",
+      "description": "Parameter schema for the 'batch_commit' MCP tool."
+    },
+    {
+      "name": "git_push",
+      "file": "git_push.json",
+      "description": "Parameter schema for the 'git_push' MCP tool."
+    },
+    {
+      "name": "git_merge",
+      "file": "git_merge.json",
+      "description": "Parameter schema for the 'git_merge' MCP tool."
+    },
+    {
+      "name": "git_cherry_pick",
+      "file": "git_cherry_pick.json",
+      "description": "Parameter schema for the 'git_cherry_pick' MCP tool."
+    },
+    {
+      "name": "git_reset_soft",
+      "file": "git_reset_soft.json",
+      "description": "Parameter schema for the 'git_reset_soft' MCP tool."
+    },
+    {
+      "name": "git_tag",
+      "file": "git_tag.json",
+      "description": "Parameter schema for the 'git_tag' MCP tool."
+    },
+    {
+      "name": "git_worktree_add",
+      "file": "git_worktree_add.json",
+      "description": "Parameter schema for the 'git_worktree_add' MCP tool."
+    },
+    {
+      "name": "git_worktree_remove",
+      "file": "git_worktree_remove.json",
+      "description": "Parameter schema for the 'git_worktree_remove' MCP tool."
+    },
+    {
+      "name": "git_stash_apply",
+      "file": "git_stash_apply.json",
+      "description": "Parameter schema for the 'git_stash_apply' MCP tool."
+    }
+  ]
+}

package/schemas/list_presets.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: list_presets",
+  "description": "Parameter schema for the 'list_presets' 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"
+      }
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format"
+  ],
+  "additionalProperties": false
+}

package/tool-parameters.schema.json

@@ -383,6 +383,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 +508,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 +629,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."
               }
             },
             "required": [
@@ -476,13 +693,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
     },
@@ -712,6 +935,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 +1078,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
     }
   }
 }