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

package/schemas/batch_commit.json

@@ -0,0 +1,125 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: batch_commit",
+  "description": "Parameter schema for the 'batch_commit' 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"
+      ]
+    },
+    "commits": {
+      "minItems": 1,
+      "maxItems": 50,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Commit message."
+          },
+          "files": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "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. Each can be a string path or { path, lines } for hunk-level staging."
+          }
+        },
+        "required": [
+          "message",
+          "files"
+        ],
+        "additionalProperties": false
+      },
+      "description": "Commits to create, applied in order."
+    },
+    "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`.",
+      "type": "string",
+      "enum": [
+        "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",
+    "dryRun"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_cherry_pick.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_cherry_pick",
+  "description": "Parameter schema for the 'git_cherry_pick' 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"
+      ]
+    },
+    "sources": {
+      "minItems": 1,
+      "maxItems": 50,
+      "type": "array",
+      "items": {
+        "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)."
+    },
+    "onto": {
+      "description": "Destination branch. Defaults to the currently checked-out branch.",
+      "type": "string"
+    },
+    "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.",
+      "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.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "sources",
+    "deleteMergedBranches",
+    "deleteMergedWorktrees"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_diff.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_diff",
+  "description": "Parameter schema for the 'git_diff' 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"
+      ]
+    },
+    "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
+}

package/schemas/git_diff_summary.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_diff_summary",
+  "description": "Parameter schema for the 'git_diff_summary' 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"
+      ]
+    },
+    "range": {
+      "description": "Diff range. Examples: \"staged\", \"HEAD~3..HEAD\", \"main...feature\". Default: unstaged changes.",
+      "type": "string"
+    },
+    "fileFilter": {
+      "description": "Glob pattern to restrict output to matching files, e.g. \"*.ts\", \"src/**\".",
+      "type": "string"
+    },
+    "maxLinesPerFile": {
+      "default": 50,
+      "description": "Max diff lines to include per file. Default: 50.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 2000
+    },
+    "maxFiles": {
+      "default": 30,
+      "description": "Max files to include in output. Default: 30.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500
+    },
+    "excludePatterns": {
+      "description": "Glob patterns to exclude. Defaults to common noise: lock files, dist, vendor, etc.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "maxLinesPerFile",
+    "maxFiles"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_fetch.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_fetch",
+  "description": "Parameter schema for the 'git_fetch' 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"
+      ]
+    },
+    "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
+}

package/schemas/git_inventory.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_inventory",
+  "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"
+      }
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    },
+    "nestedRoots": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "preset": {
+      "type": "string"
+    },
+    "presetMerge": {
+      "default": false,
+      "description": "Merge with preset instead of replacing.",
+      "type": "boolean"
+    },
+    "remote": {
+      "description": "Pair with `branch`.",
+      "type": "string"
+    },
+    "branch": {
+      "description": "Pair with `remote`.",
+      "type": "string"
+    },
+    "maxRoots": {
+      "default": 64,
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 256
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "presetMerge",
+    "maxRoots"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_log.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_log",
+  "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"
+      }
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    },
+    "since": {
+      "description": "Passed to `git log --since=`. Accepts ISO timestamps or git relative forms like `48.hours` or `2.weeks.ago`. Default: `7.days`.",
+      "type": "string"
+    },
+    "paths": {
+      "description": "Limit to commits touching these paths (passed as `-- <paths>`).",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "grep": {
+      "description": "Filter commits whose message matches this regex (git `--grep`, case-insensitive).",
+      "type": "string"
+    },
+    "author": {
+      "description": "Filter by author name or email (passed as `--author=`).",
+      "type": "string"
+    },
+    "maxCommits": {
+      "default": 50,
+      "description": "Maximum commits to return per root (hard cap 500). Default 50.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500
+    },
+    "branch": {
+      "description": "Ref/branch to log from. Default: HEAD.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "maxCommits"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_merge.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_merge",
+  "description": "Parameter schema for the 'git_merge' 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"
+      ]
+    },
+    "sources": {
+      "minItems": 1,
+      "maxItems": 20,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "description": "Branches to merge into the destination, in order."
+    },
+    "into": {
+      "description": "Destination branch. Defaults to the currently checked-out branch.",
+      "type": "string"
+    },
+    "strategy": {
+      "default": "auto",
+      "description": "`auto` (default): cascade fast-forward → rebase → merge-commit per source. `ff-only`: only fast-forward, fail if diverged. `rebase`: rebase source onto destination, then fast-forward (no merge-commit fallback). `merge`: always create a merge commit (no fast-forward).",
+      "type": "string",
+      "enum": [
+        "auto",
+        "ff-only",
+        "rebase",
+        "merge"
+      ]
+    },
+    "message": {
+      "description": "Merge commit message (used only when a merge commit is created).",
+      "type": "string"
+    },
+    "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.",
+      "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.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "sources",
+    "strategy",
+    "deleteMergedBranches",
+    "deleteMergedWorktrees"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_parity.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_parity",
+  "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"
+      }
+    },
+    "format": {
+      "default": "markdown",
+      "type": "string",
+      "enum": [
+        "markdown",
+        "json"
+      ]
+    },
+    "pairs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "left": {
+            "type": "string"
+          },
+          "right": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "left",
+          "right"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "preset": {
+      "type": "string"
+    },
+    "presetMerge": {
+      "default": false,
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "presetMerge"
+  ],
+  "additionalProperties": false
+}