feat: initial scaffold of @rethunk/mcp-multi-root-git v1.0.0

Generic MCP stdio server with three read-only git tools (git_status,
git_inventory, git_parity). Workspace root resolved from MCP roots,
not cwd. Named presets from .rethunk/git-mcp-presets.json. TypeScript,
Biome, Node >=22, CI on Node 24 + 22.

Author: AlbinoGeek

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    name: Node ${{ matrix.node }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: [24, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+      - run: npm ci
+      - run: npm run check
+      - run: npm run build

.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.env
+*.log

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rethunk-AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,95 @@
+# @rethunk/mcp-multi-root-git
+
+MCP stdio server providing three read-only git tools for any workspace. No `cwd` in MCP config — workspace root comes from the client's MCP roots (provided at `initialize`).
+
+## Tools
+
+MCP clients expose these as `{serverName}_{toolName}` (e.g. `rethunk-git_git_status`). Register the server with name `rethunk-git` (or any name you choose); the tools' registered short ids are:
+
+| Registered id   | Purpose |
+|-----------------|---------|
+| `git_status`    | `git status --short -b` for workspace root + optional submodules |
+| `git_inventory` | Status + ahead/behind per listed root; ordered for push prep |
+| `git_parity`    | Compare `git rev-parse HEAD` for left/right path pairs |
+
+## Workspace preset file
+
+For multi-root repos, commit a file at **`.rethunk/git-mcp-presets.json`** in your workspace root:
+
+```json
+{
+  "push-prep": {
+    "nestedRoots": ["path/to/package-a", "path/to/package-b"],
+    "parityPairs": [
+      { "left": "core/packages/shared", "right": "edge/packages/shared", "label": "shared" }
+    ]
+  }
+}
+```
+
+Then call tools with `"preset": "push-prep"` instead of passing paths inline.
+
+**This file is not part of the npm package.** Each repo that needs named presets commits its own file.
+
+### Schema
+
+```jsonc
+// .rethunk/git-mcp-presets.json
+{
+  "<preset-name>": {
+    "nestedRoots": ["<relative-path>", ...],   // for git_inventory
+    "parityPairs": [                             // for git_parity
+      { "left": "<rel>", "right": "<rel>", "label": "<display>" }
+    ]
+  }
+}
+```
+
+## Installation
+
+```bash
+npm install -g @rethunk/mcp-multi-root-git
+# or use via npx (no install required):
+npx -y @rethunk/mcp-multi-root-git
+```
+
+## Cursor user-level MCP config
+
+Add to `~/.cursor/mcp.json` (no `cwd` needed — Cursor supplies workspace roots automatically):
+
+```json
+{
+  "mcpServers": {
+    "rethunk-git": {
+      "command": "npx",
+      "args": ["-y", "@rethunk/mcp-multi-root-git"]
+    }
+  }
+}
+```
+
+## Workspace root resolution
+
+1. Explicit `workspaceRoot` arg in the tool call (overrides everything).
+2. First `file://` root from the MCP `initialize` / `roots/list_changed` (Cursor, Claude Desktop, etc. send these automatically).
+3. `process.cwd()` as a last resort (useful in CI and test harnesses that pass explicit `workspaceRoot`).
+
+When a client sends multiple roots, the first valid `file://` root wins. Document tie-breaking in your own skill if you need a different policy.
+
+## Development
+
+Requires **Node ≥ 22**. Develop on **Node 24**.
+
+```bash
+npm install
+npm run build      # tsc → dist/
+npm run check      # Biome lint + format check
+npm run check:fix  # Auto-fix Biome issues
+```
+
+## Publishing
+
+```bash
+npm run prepublishOnly  # build + check
+npm publish             # publishes @rethunk/mcp-multi-root-git@1.0.0
+```

biome.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.10/schema.json",
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100,
+    "lineEnding": "lf"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "all",
+      "bracketSpacing": true,
+      "arrowParentheses": "always"
+    }
+  },
+  "files": {
+    "includes": ["src/**/*", "*.json", "*.md"]
+  }
+}