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

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
+}

package/schemas/git_push.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_push",
+  "description": "Parameter schema for the 'git_push' 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"
+      ]
+    },
+    "remote": {
+      "description": "Remote to push to. Defaults to the remote inferred from the current upstream tracking ref, or `origin` when `setUpstream` is true.",
+      "type": "string"
+    },
+    "branch": {
+      "description": "Branch to push. Defaults to the currently checked-out branch. Rejected when HEAD is detached.",
+      "type": "string"
+    },
+    "setUpstream": {
+      "default": false,
+      "description": "Set the upstream tracking reference (`git push -u`). Use when the branch has not been pushed yet. Remote defaults to `origin`.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "setUpstream"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_reset_soft.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git: git_reset_soft",
+  "description": "Parameter schema for the 'git_reset_soft' 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"
+      ]
+    },
+    "ref": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Commit to reset to. Accepts ancestor notation (`HEAD~1`, `HEAD~3`), branch names, or full SHAs."
+    }
+  },
+  "required": [
+    "allWorkspaceRoots",
+    "format",
+    "ref"
+  ],
+  "additionalProperties": false
+}

package/schemas/git_show.json

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

package/schemas/git_stash_apply.json

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

package/schemas/git_stash_list.json

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

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

package/schemas/git_tag.json

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