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

package/tool-parameters.schema.json

@@ -0,0 +1,812 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "@rethunk/mcp-multi-root-git tool parameter schemas",
+  "description": "JSON Schema snapshots generated from registered FastMCP tool parameter schemas.",
+  "generatedBy": "scripts/generate-tool-parameters-schema.ts",
+  "tools": {
+    "git_status": {
+      "$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"
+          ]
+        },
+        "includeSubmodules": {
+          "default": true,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "allWorkspaceRoots",
+        "format",
+        "includeSubmodules"
+      ],
+      "additionalProperties": false
+    },
+    "git_inventory": {
+      "$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"
+          ]
+        },
+        "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
+    },
+    "git_parity": {
+      "$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"
+          ]
+        },
+        "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
+    },
+    "list_presets": {
+      "$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"
+          ]
+        }
+      },
+      "required": [
+        "allWorkspaceRoots",
+        "format"
+      ],
+      "additionalProperties": false
+    },
+    "git_log": {
+      "$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"
+          ]
+        },
+        "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
+    },
+    "git_diff_summary": {
+      "$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"
+          ]
+        },
+        "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
+    },
+    "git_worktree_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
+    },
+    "batch_commit": {
+      "$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"
+        },
+        "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": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "description": "Paths to stage, relative to the git root."
+              }
+            },
+            "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"
+          ]
+        }
+      },
+      "required": [
+        "allWorkspaceRoots",
+        "format",
+        "commits",
+        "push"
+      ],
+      "additionalProperties": false
+    },
+    "git_push": {
+      "$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"
+        },
+        "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
+    },
+    "git_merge": {
+      "$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"
+        },
+        "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
+    },
+    "git_cherry_pick": {
+      "$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"
+        },
+        "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
+    },
+    "git_reset_soft": {
+      "$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"
+        },
+        "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
+    },
+    "git_worktree_add": {
+      "$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"
+        },
+        "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
+    },
+    "git_worktree_remove": {
+      "$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"
+        },
+        "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
+    }
+  }
+}