scrum4me-mcp/src/tools
Madhura68 f7f5a487ec PBI-9 + PBI-47: worktree foundation, product-worktrees, P0 fixes, PAUSED flow
Adds two interlocking PBIs:

PBI-9 — Worktree foundation + persistent product-worktrees for idea-jobs
  - src/git/worktree-paths.ts: centralised root + skip-set + lock-path helpers
  - src/git/file-lock.ts: proper-lockfile wrapper, deadlock-safe ordered acquire
  - src/git/product-worktree.ts: detached-HEAD worktree per product, .scratch/
    excluded via git rev-parse --git-path (handles linked .git file)
  - src/git/job-locks.ts: setupProductWorktrees + releaseLocksOnTerminal
  - wait-for-job.ts: idea-branch wires product-worktrees for IDEA_GRILL/MAKE_PLAN
  - update-job-status.ts + pbi-cascade.ts + stale-reset: release on all four
    server-side terminal transitions (DONE/FAILED/CANCELLED/stale)
  - cleanup-my-worktrees: skip _products/ + *.lock
  - README: worktrees section with single-host invariant + advisory-lock path

PBI-47 — Sprint-flow P0 corrections + PAUSED flow with rich pause_context
  - prisma schema: ClaudeJob.{base_sha,head_sha} + SprintRun.pause_context
  - tryClaimJob captures base_sha; prepareDoneUpdate captures head_sha
  - verify-task-against-plan diffs vs base_sha (no more origin/main fallback);
    rejects with MISSING_BASE_SHA when null — fixes per-task verify-scope P0
  - pr.ts: createPullRequest enableAutoMerge default false; new
    enableAutoMergeOnPr with --match-head-commit guard + 5-category typed
    EnableAutoMergeResult — fixes STORY auto-merge timing P0
  - src/flow/{effects,worktree-lease,pr-flow,sprint-run}.ts: pure transition
    modules + idempotent declarative effects executor
  - update-job-status: STORY auto-merge fires only on the last task of the
    story (story.status === DONE), with head_sha as merge guard; MERGE_CONFLICT
    routes to sprint-run flow which produces CREATE_CLAUDE_QUESTION +
    SET_SPRINT_RUN_STATUS effects with rich pause_context

Tests: 31 test files, 242 passing. Pure-transition tests cover STORY 3-tasks
auto-merge timing, SPRINT draft→ready, MERGE_CONFLICT pause/resume, file-lock
deadlock prevention, worktree-lease lifecycle, delete-only verify (ALIGNED),
per-job verify scope (base_sha isolation), 5-category auto-merge errors.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 21:09:48 +02:00
..
ask-user-question.ts feat: M12 idea-job support — version 0.6.0 2026-05-04 22:12:36 +02:00
cancel-question.ts feat(ST-1102): add 4 question-channel MCP tools (M11) 2026-04-28 01:00:59 +02:00
check-queue-empty.ts feat: add check_queue_empty tool (v0.3.0) 2026-05-03 17:57:17 +02:00
cleanup-my-worktrees.ts PBI-9 + PBI-47: worktree foundation, product-worktrees, P0 fixes, PAUSED flow 2026-05-06 21:09:48 +02:00
create-pbi.ts feat: auto-generate codes for PBI/Story/Task on create 2026-05-04 16:14:36 +02:00
create-story.ts feat: auto-generate codes for PBI/Story/Task on create 2026-05-04 16:14:36 +02:00
create-task.ts feat(create_task): optionele repo_url voor cross-repo tasks 2026-05-06 04:16:31 +02:00
get-claude-context.ts PBI-8: Sprint-flow MCP-orkestratie + verifier-fix 2026-05-06 16:59:58 +02:00
get-idea-context.ts feat: M12 idea-job support — version 0.6.0 2026-05-04 22:12:36 +02:00
get-question-answer.ts feat(ST-1102): add 4 question-channel MCP tools (M11) 2026-04-28 01:00:59 +02:00
get-worker-settings.ts feat(M13): get_worker_settings + worker_heartbeat tools (v0.7.0) 2026-05-06 04:23:31 +02:00
health.ts feat: M12 idea-job support — version 0.6.0 2026-05-04 22:12:36 +02:00
list-open-questions.ts feat(ST-1102): add 4 question-channel MCP tools (M11) 2026-04-28 01:00:59 +02:00
list-products.ts feat(ST-705): read tools — health, list_products, get_claude_context 2026-04-26 23:04:51 +02:00
log-commit.ts chore: sync schema with scrum4me@43a4294 + write metadata in log tools 2026-04-26 23:44:33 +02:00
log-idea-decision.ts feat: M12 idea-job support — version 0.6.0 2026-05-04 22:12:36 +02:00
log-implementation.ts chore: sync schema with scrum4me@43a4294 + write metadata in log tools 2026-04-26 23:44:33 +02:00
log-test-result.ts chore: sync schema with scrum4me@43a4294 + write metadata in log tools 2026-04-26 23:44:33 +02:00
mark-pbi-pr-merged.ts feat(mcp): set_pbi_pr + mark_pbi_pr_merged tools voor PBI-PR-gating (#18) 2026-05-03 16:25:53 +02:00
set-pbi-pr.ts feat(mcp): set_pbi_pr + mark_pbi_pr_merged tools voor PBI-PR-gating (#18) 2026-05-03 16:25:53 +02:00
update-idea-grill-md.ts feat: M12 idea-job support — version 0.6.0 2026-05-04 22:12:36 +02:00
update-idea-plan-md.ts feat: M12 idea-job support — version 0.6.0 2026-05-04 22:12:36 +02:00
update-job-status.ts PBI-9 + PBI-47: worktree foundation, product-worktrees, P0 fixes, PAUSED flow 2026-05-06 21:09:48 +02:00
update-task-plan.ts feat(ST-706): task write tools — update_task_status and update_task_plan 2026-04-26 23:05:49 +02:00
update-task-status.ts feat: wire story-promotion into update_task_status + filter done stories from get_claude_context 2026-04-30 18:22:47 +02:00
verify-task-against-plan.ts PBI-9 + PBI-47: worktree foundation, product-worktrees, P0 fixes, PAUSED flow 2026-05-06 21:09:48 +02:00
wait-for-job.ts PBI-9 + PBI-47: worktree foundation, product-worktrees, P0 fixes, PAUSED flow 2026-05-06 21:09:48 +02:00
worker-heartbeat.ts feat(M13): get_worker_settings + worker_heartbeat tools (v0.7.0) 2026-05-06 04:23:31 +02:00