@rethunk/mcp-multi-root-git 2.8.0 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/AGENTS.md +2 -2
  2. package/CHANGELOG.md +8 -0
  3. package/HUMANS.md +1 -1
  4. package/dist/server/batch-commit-tool.js +9 -14
  5. package/dist/server/git-branch-list-tool.js +2 -4
  6. package/dist/server/git-cherry-pick-tool.js +11 -21
  7. package/dist/server/git-diff-summary-tool.js +3 -4
  8. package/dist/server/git-diff-tool.js +8 -16
  9. package/dist/server/git-log-tool.js +8 -14
  10. package/dist/server/git-merge-tool.js +6 -10
  11. package/dist/server/git-reset-soft-tool.js +3 -6
  12. package/dist/server/git-stash-tool.js +3 -5
  13. package/dist/server/git-worktree-tool.js +6 -9
  14. package/dist/server/schemas.js +4 -4
  15. package/dist/server/tools.js +66 -25
  16. package/docs/install.md +1 -0
  17. package/docs/mcp-tools.md +2 -1
  18. package/package.json +9 -12
  19. package/tool-parameters.schema.json +94 -94
package/tool-parameters.schema.json CHANGED
@@ -9,22 +9,22 @@
9
9
  "type": "object",
10
10
  "properties": {
11
11
  "workspaceRoot": {
12
- "description": "Highest-priority override.",
12
+ "description": "Highest-priority root override.",
13
13
  "type": "string"
14
14
  },
15
15
  "rootIndex": {
16
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
16
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
17
17
  "type": "integer",
18
18
  "minimum": 0,
19
19
  "maximum": 9007199254740991
20
20
  },
21
21
  "allWorkspaceRoots": {
22
22
  "default": false,
23
- "description": "Fan out across all MCP file roots.",
23
+ "description": "Fan out across all MCP roots.",
24
24
  "type": "boolean"
25
25
  },
26
26
  "absoluteGitRoots": {
27
- "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
27
+ "description": "Absolute paths to git repo roots; use for sibling clones under a non-git parent.",
28
28
  "maxItems": 256,
29
29
  "type": "array",
30
30
  "items": {
@@ -56,22 +56,22 @@
56
56
  "type": "object",
57
57
  "properties": {
58
58
  "workspaceRoot": {
59
- "description": "Highest-priority override.",
59
+ "description": "Highest-priority root override.",
60
60
  "type": "string"
61
61
  },
62
62
  "rootIndex": {
63
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
63
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
64
64
  "type": "integer",
65
65
  "minimum": 0,
66
66
  "maximum": 9007199254740991
67
67
  },
68
68
  "allWorkspaceRoots": {
69
69
  "default": false,
70
- "description": "Fan out across all MCP file roots.",
70
+ "description": "Fan out across all MCP roots.",
71
71
  "type": "boolean"
72
72
  },
73
73
  "absoluteGitRoots": {
74
- "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
74
+ "description": "Absolute paths to git repo roots; use for sibling clones under a non-git parent.",
75
75
  "maxItems": 256,
76
76
  "type": "array",
77
77
  "items": {
@@ -128,22 +128,22 @@
128
128
  "type": "object",
129
129
  "properties": {
130
130
  "workspaceRoot": {
131
- "description": "Highest-priority override.",
131
+ "description": "Highest-priority root override.",
132
132
  "type": "string"
133
133
  },
134
134
  "rootIndex": {
135
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
135
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
136
136
  "type": "integer",
137
137
  "minimum": 0,
138
138
  "maximum": 9007199254740991
139
139
  },
140
140
  "allWorkspaceRoots": {
141
141
  "default": false,
142
- "description": "Fan out across all MCP file roots.",
142
+ "description": "Fan out across all MCP roots.",
143
143
  "type": "boolean"
144
144
  },
145
145
  "absoluteGitRoots": {
146
- "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
146
+ "description": "Absolute paths to git repo roots; use for sibling clones under a non-git parent.",
147
147
  "maxItems": 256,
148
148
  "type": "array",
149
149
  "items": {
@@ -200,22 +200,22 @@
200
200
  "type": "object",
201
201
  "properties": {
202
202
  "workspaceRoot": {
203
- "description": "Highest-priority override.",
203
+ "description": "Highest-priority root override.",
204
204
  "type": "string"
205
205
  },
206
206
  "rootIndex": {
207
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
207
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
208
208
  "type": "integer",
209
209
  "minimum": 0,
210
210
  "maximum": 9007199254740991
211
211
  },
212
212
  "allWorkspaceRoots": {
213
213
  "default": false,
214
- "description": "Fan out across all MCP file roots.",
214
+ "description": "Fan out across all MCP roots.",
215
215
  "type": "boolean"
216
216
  },
217
217
  "absoluteGitRoots": {
218
- "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
218
+ "description": "Absolute paths to git repo roots; use for sibling clones under a non-git parent.",
219
219
  "maxItems": 256,
220
220
  "type": "array",
221
221
  "items": {
@@ -242,22 +242,22 @@
242
242
  "type": "object",
243
243
  "properties": {
244
244
  "workspaceRoot": {
245
- "description": "Highest-priority override.",
245
+ "description": "Highest-priority root override.",
246
246
  "type": "string"
247
247
  },
248
248
  "rootIndex": {
249
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
249
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
250
250
  "type": "integer",
251
251
  "minimum": 0,
252
252
  "maximum": 9007199254740991
253
253
  },
254
254
  "allWorkspaceRoots": {
255
255
  "default": false,
256
- "description": "Fan out across all MCP file roots.",
256
+ "description": "Fan out across all MCP roots.",
257
257
  "type": "boolean"
258
258
  },
259
259
  "absoluteGitRoots": {
260
- "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
260
+ "description": "Absolute paths to git repo roots; use for sibling clones under a non-git parent.",
261
261
  "maxItems": 256,
262
262
  "type": "array",
263
263
  "items": {
@@ -266,7 +266,7 @@
266
266
  },
267
267
  "format": {
268
268
  "default": "markdown",
269
- "description": "`markdown` (default): headed sections per root. `json`: structured groups array. `oneline`: `<sha7> <subject>` per line, no headers (single-root) or `### repo (branch)` separator per group (multi-root). Lowest-token option for post-commit verification.",
269
+ "description": "`markdown` (default): headed sections per root. `json`: groups array. `oneline`: `<sha7> <subject>` per line; lowest-token option for post-commit verification.",
270
270
  "type": "string",
271
271
  "enum": [
272
272
  "markdown",
@@ -275,27 +275,27 @@
275
275
  ]
276
276
  },
277
277
  "since": {
278
- "description": "Passed to `git log --since=`. Accepts ISO timestamps or git relative forms like `48.hours` or `2.weeks.ago`. Default: `7.days`.",
278
+ "description": "Passed to `--since=`. ISO timestamp or git relative form (`48.hours`, `2.weeks.ago`). Default: `7.days`.",
279
279
  "type": "string"
280
280
  },
281
281
  "paths": {
282
- "description": "Limit to commits touching these paths (passed as `-- <paths>`).",
282
+ "description": "Limit to commits touching these paths (`-- <paths>`).",
283
283
  "type": "array",
284
284
  "items": {
285
285
  "type": "string"
286
286
  }
287
287
  },
288
288
  "grep": {
289
- "description": "Filter commits whose message matches this regex (git `--grep`, case-insensitive).",
289
+ "description": "Filter by commit message regex (git `--grep`, case-insensitive).",
290
290
  "type": "string"
291
291
  },
292
292
  "author": {
293
- "description": "Filter by author name or email (passed as `--author=`).",
293
+ "description": "Filter by author name or email (`--author=`).",
294
294
  "type": "string"
295
295
  },
296
296
  "maxCommits": {
297
297
  "default": 50,
298
- "description": "Maximum commits to return per root (hard cap 500). Default 50.",
298
+ "description": "Max commits per root (hard cap 500, default 50).",
299
299
  "type": "integer",
300
300
  "minimum": 1,
301
301
  "maximum": 500
@@ -317,17 +317,17 @@
317
317
  "type": "object",
318
318
  "properties": {
319
319
  "workspaceRoot": {
320
- "description": "Highest-priority override.",
320
+ "description": "Highest-priority root override.",
321
321
  "type": "string"
322
322
  },
323
323
  "rootIndex": {
324
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
324
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
325
325
  "type": "integer",
326
326
  "minimum": 0,
327
327
  "maximum": 9007199254740991
328
328
  },
329
329
  "absoluteGitRoots": {
330
- "description": "Absolute paths to git repo roots. Use for many sibling clones under a non-git parent directory.",
330
+ "description": "Absolute paths to git repo roots; use for sibling clones under a non-git parent.",
331
331
  "maxItems": 256,
332
332
  "type": "array",
333
333
  "items": {
@@ -365,7 +365,7 @@
365
365
  "maximum": 500
366
366
  },
367
367
  "excludePatterns": {
368
- "description": "Glob patterns to exclude. Defaults to common noise: lock files, dist, vendor, etc.",
368
+ "description": "Glob patterns to exclude. Default: lock files, dist, vendor, etc.",
369
369
  "type": "array",
370
370
  "items": {
371
371
  "type": "string"
@@ -384,11 +384,11 @@
384
384
  "type": "object",
385
385
  "properties": {
386
386
  "workspaceRoot": {
387
- "description": "Highest-priority override.",
387
+ "description": "Highest-priority root override.",
388
388
  "type": "string"
389
389
  },
390
390
  "rootIndex": {
391
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
391
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
392
392
  "type": "integer",
393
393
  "minimum": 0,
394
394
  "maximum": 9007199254740991
@@ -402,19 +402,19 @@
402
402
  ]
403
403
  },
404
404
  "base": {
405
- "description": "Base ref (e.g. \"main\", \"HEAD~3\"). Required for range diffs. If omitted and `staged: false`, shows unstaged changes.",
405
+ "description": "Base ref (e.g. \"main\", \"HEAD~3\"). Omit for unstaged changes.",
406
406
  "type": "string"
407
407
  },
408
408
  "head": {
409
- "description": "Head ref (e.g. \"feature-branch\"). If omitted, defaults to HEAD. Only used if `base` is provided.",
409
+ "description": "Head ref (e.g. \"feature-branch\"). Defaults to HEAD. Used only when `base` is set.",
410
410
  "type": "string"
411
411
  },
412
412
  "path": {
413
- "description": "Scope diff to a single file path (e.g. \"src/main.ts\"). For multiple files, prefer `paths`. If both `path` and `paths` are given, they are unioned.",
413
+ "description": "Scope to a single file. Unioned with `paths` if both given.",
414
414
  "type": "string"
415
415
  },
416
416
  "paths": {
417
- "description": "Scope diff to multiple file paths (e.g. [\"src/a.ts\", \"src/b.ts\"]). Each path is validated and must lie within the repository root. If both `path` and `paths` are given, they are unioned.",
417
+ "description": "Scope to multiple files (must be within repo root). Unioned with `path` if both given.",
418
418
  "type": "array",
419
419
  "items": {
420
420
  "type": "string"
@@ -422,11 +422,11 @@
422
422
  },
423
423
  "staged": {
424
424
  "default": false,
425
- "description": "If true, show staged changes (git diff --staged). Ignored if `base` is provided.",
425
+ "description": "Show staged changes (`git diff --staged`). Ignored if `base` is set.",
426
426
  "type": "boolean"
427
427
  },
428
428
  "unified": {
429
- "description": "Number of context lines to show around each change (passed as -U<n> to git diff). Defaults to git's built-in default (3). Use 0 for no context.",
429
+ "description": "Context lines around each change (`-U<n>`). Default: 3. Use 0 for no context.",
430
430
  "type": "integer",
431
431
  "minimum": 0,
432
432
  "maximum": 100
@@ -443,11 +443,11 @@
443
443
  "type": "object",
444
444
  "properties": {
445
445
  "workspaceRoot": {
446
- "description": "Highest-priority override.",
446
+ "description": "Highest-priority root override.",
447
447
  "type": "string"
448
448
  },
449
449
  "rootIndex": {
450
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
450
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
451
451
  "type": "integer",
452
452
  "minimum": 0,
453
453
  "maximum": 9007199254740991
@@ -492,11 +492,11 @@
492
492
  "type": "object",
493
493
  "properties": {
494
494
  "workspaceRoot": {
495
- "description": "Highest-priority override.",
495
+ "description": "Highest-priority root override.",
496
496
  "type": "string"
497
497
  },
498
498
  "rootIndex": {
499
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
499
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
500
500
  "type": "integer",
501
501
  "minimum": 0,
502
502
  "maximum": 9007199254740991
@@ -520,11 +520,11 @@
520
520
  "type": "object",
521
521
  "properties": {
522
522
  "workspaceRoot": {
523
- "description": "Highest-priority override.",
523
+ "description": "Highest-priority root override.",
524
524
  "type": "string"
525
525
  },
526
526
  "rootIndex": {
527
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
527
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
528
528
  "type": "integer",
529
529
  "minimum": 0,
530
530
  "maximum": 9007199254740991
@@ -548,11 +548,11 @@
548
548
  "type": "object",
549
549
  "properties": {
550
550
  "workspaceRoot": {
551
- "description": "Highest-priority override.",
551
+ "description": "Highest-priority root override.",
552
552
  "type": "string"
553
553
  },
554
554
  "rootIndex": {
555
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
555
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
556
556
  "type": "integer",
557
557
  "minimum": 0,
558
558
  "maximum": 9007199254740991
@@ -598,11 +598,11 @@
598
598
  "type": "object",
599
599
  "properties": {
600
600
  "workspaceRoot": {
601
- "description": "Highest-priority override.",
601
+ "description": "Highest-priority root override.",
602
602
  "type": "string"
603
603
  },
604
604
  "rootIndex": {
605
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
605
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
606
606
  "type": "integer",
607
607
  "minimum": 0,
608
608
  "maximum": 9007199254740991
@@ -648,11 +648,11 @@
648
648
  "type": "object",
649
649
  "properties": {
650
650
  "workspaceRoot": {
651
- "description": "Highest-priority override.",
651
+ "description": "Highest-priority root override.",
652
652
  "type": "string"
653
653
  },
654
654
  "rootIndex": {
655
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
655
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
656
656
  "type": "integer",
657
657
  "minimum": 0,
658
658
  "maximum": 9007199254740991
@@ -667,7 +667,7 @@
667
667
  },
668
668
  "includeRemotes": {
669
669
  "default": false,
670
- "description": "When true, also return remote-tracking branches from refs/remotes (excluding symbolic origin/HEAD).",
670
+ "description": "Include remote-tracking branches from refs/remotes (symbolic origin/HEAD excluded).",
671
671
  "type": "boolean"
672
672
  }
673
673
  },
@@ -682,11 +682,11 @@
682
682
  "type": "object",
683
683
  "properties": {
684
684
  "workspaceRoot": {
685
- "description": "Highest-priority override.",
685
+ "description": "Highest-priority root override.",
686
686
  "type": "string"
687
687
  },
688
688
  "rootIndex": {
689
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
689
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
690
690
  "type": "integer",
691
691
  "minimum": 0,
692
692
  "maximum": 9007199254740991
@@ -724,18 +724,18 @@
724
724
  "type": "object",
725
725
  "properties": {
726
726
  "workspaceRoot": {
727
- "description": "Highest-priority override.",
727
+ "description": "Highest-priority root override.",
728
728
  "type": "string"
729
729
  },
730
730
  "rootIndex": {
731
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
731
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
732
732
  "type": "integer",
733
733
  "minimum": 0,
734
734
  "maximum": 9007199254740991
735
735
  },
736
736
  "allWorkspaceRoots": {
737
737
  "default": false,
738
- "description": "Fan out across all MCP file roots.",
738
+ "description": "Fan out across all MCP roots.",
739
739
  "type": "boolean"
740
740
  },
741
741
  "format": {
@@ -807,7 +807,7 @@
807
807
  }
808
808
  ]
809
809
  },
810
- "description": "Paths to stage, relative to the git root. Each can be a string path or { path, lines } for hunk-level staging. Deleted files (missing on disk but tracked in HEAD) are staged as removals via `git rm --cached`. Combining { path, lines } with a deleted file is an error."
810
+ "description": "Paths to stage, relative to git root. String or `{ path, lines }` for hunk-level staging. Deleted tracked files are staged via `git rm --cached`. Cannot combine `lines` with a deleted file."
811
811
  }
812
812
  },
813
813
  "required": [
@@ -816,11 +816,11 @@
816
816
  ],
817
817
  "additionalProperties": false
818
818
  },
819
- "description": "Commits to create, applied in order."
819
+ "description": "Ordered list of commits to create."
820
820
  },
821
821
  "push": {
822
822
  "default": "never",
823
- "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`.",
823
+ "description": "`never` (default): no push. `after`: push current branch to upstream after all commits succeed; fails with `push_no_upstream` if no upstream (commits are NOT rolled back).",
824
824
  "type": "string",
825
825
  "enum": [
826
826
  "never",
@@ -829,7 +829,7 @@
829
829
  },
830
830
  "dryRun": {
831
831
  "default": false,
832
- "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.",
832
+ "description": "Stage files and return a preview without writing commits; unstages afterwards. Response is marked DRY RUN.",
833
833
  "type": "boolean"
834
834
  }
835
835
  },
@@ -847,18 +847,18 @@
847
847
  "type": "object",
848
848
  "properties": {
849
849
  "workspaceRoot": {
850
- "description": "Highest-priority override.",
850
+ "description": "Highest-priority root override.",
851
851
  "type": "string"
852
852
  },
853
853
  "rootIndex": {
854
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
854
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
855
855
  "type": "integer",
856
856
  "minimum": 0,
857
857
  "maximum": 9007199254740991
858
858
  },
859
859
  "allWorkspaceRoots": {
860
860
  "default": false,
861
- "description": "Fan out across all MCP file roots.",
861
+ "description": "Fan out across all MCP roots.",
862
862
  "type": "boolean"
863
863
  },
864
864
  "format": {
@@ -895,18 +895,18 @@
895
895
  "type": "object",
896
896
  "properties": {
897
897
  "workspaceRoot": {
898
- "description": "Highest-priority override.",
898
+ "description": "Highest-priority root override.",
899
899
  "type": "string"
900
900
  },
901
901
  "rootIndex": {
902
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
902
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
903
903
  "type": "integer",
904
904
  "minimum": 0,
905
905
  "maximum": 9007199254740991
906
906
  },
907
907
  "allWorkspaceRoots": {
908
908
  "default": false,
909
- "description": "Fan out across all MCP file roots.",
909
+ "description": "Fan out across all MCP roots.",
910
910
  "type": "boolean"
911
911
  },
912
912
  "format": {
@@ -948,12 +948,12 @@
948
948
  },
949
949
  "deleteMergedBranches": {
950
950
  "default": false,
951
- "description": "After all sources merge cleanly, delete each source branch locally (`git branch -d`). Protected names always skipped. Never affects remote branches.",
951
+ "description": "Delete each source branch locally after clean merge (`git branch -d`). Protected names and remote refs unaffected.",
952
952
  "type": "boolean"
953
953
  },
954
954
  "deleteMergedWorktrees": {
955
955
  "default": false,
956
- "description": "After all sources merge cleanly, remove any local worktree currently checked out on a source branch (`git worktree remove`). Protected tails always skipped.",
956
+ "description": "Remove local worktrees on source branches after clean merge (`git worktree remove`). Protected tails skipped.",
957
957
  "type": "boolean"
958
958
  }
959
959
  },
@@ -972,18 +972,18 @@
972
972
  "type": "object",
973
973
  "properties": {
974
974
  "workspaceRoot": {
975
- "description": "Highest-priority override.",
975
+ "description": "Highest-priority root override.",
976
976
  "type": "string"
977
977
  },
978
978
  "rootIndex": {
979
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
979
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
980
980
  "type": "integer",
981
981
  "minimum": 0,
982
982
  "maximum": 9007199254740991
983
983
  },
984
984
  "allWorkspaceRoots": {
985
985
  "default": false,
986
- "description": "Fan out across all MCP file roots.",
986
+ "description": "Fan out across all MCP roots.",
987
987
  "type": "boolean"
988
988
  },
989
989
  "format": {
@@ -1002,7 +1002,7 @@
1002
1002
  "type": "string",
1003
1003
  "minLength": 1
1004
1004
  },
1005
- "description": "Sources to cherry-pick: SHA, `A..B` range, or branch name. Branch sources resolve to `onto..<branch>` (only commits missing from destination)."
1005
+ "description": "Sources: SHA, `A..B` range, or branch name (resolves to `onto..<branch>`)."
1006
1006
  },
1007
1007
  "onto": {
1008
1008
  "description": "Destination branch. Defaults to the currently checked-out branch.",
@@ -1010,17 +1010,17 @@
1010
1010
  },
1011
1011
  "deleteMergedBranches": {
1012
1012
  "default": false,
1013
- "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.",
1013
+ "description": "Delete branch-kind sources locally after success. Protected names and remote refs unaffected.",
1014
1014
  "type": "boolean"
1015
1015
  },
1016
1016
  "deleteMergedWorktrees": {
1017
1017
  "default": false,
1018
- "description": "After success, remove any local worktree attached to a branch-kind source (`git worktree remove`). Protected tails always skipped.",
1018
+ "description": "Remove local worktrees on branch-kind sources after success. Protected tails skipped.",
1019
1019
  "type": "boolean"
1020
1020
  },
1021
1021
  "strictMergedRefEquality": {
1022
1022
  "default": false,
1023
- "description": "When false (default), branch deletion uses patch-id equivalence: a source branch is deleted when every commit it contains has a content-equivalent commit on the destination (same diff, different SHA — the normal cherry-pick outcome). Set to true to require strict ref ancestry (`git branch -d` semantics), which will refuse deletion after a cherry-pick because the SHA differs.",
1023
+ "description": "false (default): delete branch when every commit is content-equivalent on destination (patch-id, normal cherry-pick outcome). true: require strict ref ancestry (`git branch -d` semantics — will refuse after cherry-pick due to SHA mismatch).",
1024
1024
  "type": "boolean"
1025
1025
  }
1026
1026
  },
@@ -1039,18 +1039,18 @@
1039
1039
  "type": "object",
1040
1040
  "properties": {
1041
1041
  "workspaceRoot": {
1042
- "description": "Highest-priority override.",
1042
+ "description": "Highest-priority root override.",
1043
1043
  "type": "string"
1044
1044
  },
1045
1045
  "rootIndex": {
1046
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
1046
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
1047
1047
  "type": "integer",
1048
1048
  "minimum": 0,
1049
1049
  "maximum": 9007199254740991
1050
1050
  },
1051
1051
  "allWorkspaceRoots": {
1052
1052
  "default": false,
1053
- "description": "Fan out across all MCP file roots.",
1053
+ "description": "Fan out across all MCP roots.",
1054
1054
  "type": "boolean"
1055
1055
  },
1056
1056
  "format": {
@@ -1064,7 +1064,7 @@
1064
1064
  "ref": {
1065
1065
  "type": "string",
1066
1066
  "minLength": 1,
1067
- "description": "Commit to reset to. Accepts ancestor notation (`HEAD~1`, `HEAD~3`), branch names, or full SHAs."
1067
+ "description": "Commit to reset to: ancestor notation (`HEAD~1`, `HEAD~3`), branch name, or SHA."
1068
1068
  }
1069
1069
  },
1070
1070
  "required": [
@@ -1079,11 +1079,11 @@
1079
1079
  "type": "object",
1080
1080
  "properties": {
1081
1081
  "workspaceRoot": {
1082
- "description": "Highest-priority override.",
1082
+ "description": "Highest-priority root override.",
1083
1083
  "type": "string"
1084
1084
  },
1085
1085
  "rootIndex": {
1086
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
1086
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
1087
1087
  "type": "integer",
1088
1088
  "minimum": 0,
1089
1089
  "maximum": 9007199254740991
@@ -1127,18 +1127,18 @@
1127
1127
  "type": "object",
1128
1128
  "properties": {
1129
1129
  "workspaceRoot": {
1130
- "description": "Highest-priority override.",
1130
+ "description": "Highest-priority root override.",
1131
1131
  "type": "string"
1132
1132
  },
1133
1133
  "rootIndex": {
1134
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
1134
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
1135
1135
  "type": "integer",
1136
1136
  "minimum": 0,
1137
1137
  "maximum": 9007199254740991
1138
1138
  },
1139
1139
  "allWorkspaceRoots": {
1140
1140
  "default": false,
1141
- "description": "Fan out across all MCP file roots.",
1141
+ "description": "Fan out across all MCP roots.",
1142
1142
  "type": "boolean"
1143
1143
  },
1144
1144
  "format": {
@@ -1152,15 +1152,15 @@
1152
1152
  "path": {
1153
1153
  "type": "string",
1154
1154
  "minLength": 1,
1155
- "description": "Filesystem path for the new worktree. Relative paths are resolved from the git toplevel."
1155
+ "description": "Filesystem path for the new worktree (relative paths resolved from git toplevel)."
1156
1156
  },
1157
1157
  "branch": {
1158
1158
  "type": "string",
1159
1159
  "minLength": 1,
1160
- "description": "Branch to check out in the new worktree. Created from `baseRef` if absent."
1160
+ "description": "Branch to check out; created from `baseRef` if it doesn't exist."
1161
1161
  },
1162
1162
  "baseRef": {
1163
- "description": "Commit-ish to base the new branch on when it does not yet exist. Default: HEAD.",
1163
+ "description": "Commit-ish to base the new branch on. Default: HEAD.",
1164
1164
  "type": "string"
1165
1165
  }
1166
1166
  },
@@ -1177,18 +1177,18 @@
1177
1177
  "type": "object",
1178
1178
  "properties": {
1179
1179
  "workspaceRoot": {
1180
- "description": "Highest-priority override.",
1180
+ "description": "Highest-priority root override.",
1181
1181
  "type": "string"
1182
1182
  },
1183
1183
  "rootIndex": {
1184
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
1184
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
1185
1185
  "type": "integer",
1186
1186
  "minimum": 0,
1187
1187
  "maximum": 9007199254740991
1188
1188
  },
1189
1189
  "allWorkspaceRoots": {
1190
1190
  "default": false,
1191
- "description": "Fan out across all MCP file roots.",
1191
+ "description": "Fan out across all MCP roots.",
1192
1192
  "type": "boolean"
1193
1193
  },
1194
1194
  "format": {
@@ -1206,7 +1206,7 @@
1206
1206
  },
1207
1207
  "force": {
1208
1208
  "default": false,
1209
- "description": "Pass `--force` to allow removal of worktrees with uncommitted changes.",
1209
+ "description": "Allow removal of worktrees with uncommitted changes (`--force`).",
1210
1210
  "type": "boolean"
1211
1211
  }
1212
1212
  },
@@ -1223,11 +1223,11 @@
1223
1223
  "type": "object",
1224
1224
  "properties": {
1225
1225
  "workspaceRoot": {
1226
- "description": "Highest-priority override.",
1226
+ "description": "Highest-priority root override.",
1227
1227
  "type": "string"
1228
1228
  },
1229
1229
  "rootIndex": {
1230
- "description": "0-based index into the MCP file roots list; ignored when workspaceRoot is set.",
1230
+ "description": "0-based index into MCP roots; ignored if workspaceRoot set.",
1231
1231
  "type": "integer",
1232
1232
  "minimum": 0,
1233
1233
  "maximum": 9007199254740991
@@ -1249,7 +1249,7 @@
1249
1249
  },
1250
1250
  "pop": {
1251
1251
  "default": false,
1252
- "description": "If true, runs `git stash pop` instead of `git stash apply` (removes stash after applying).",
1252
+ "description": "Run `git stash pop` instead of `git stash apply` (removes stash after applying).",
1253
1253
  "type": "boolean"
1254
1254
  }
1255
1255
  },