fix(shim): disambiguate claim tool from item(action=claim) in denial messages

[getappz]

Auto-opened on item done for 9GKcV18rG8FdKWjc1eCVx.

Summary by CodeRabbit

• Documentation
  • Clarified that standalone claims provide path-scoped locks only and do not create worktrees, branches, or directories.
  • Updated guidance to use the item claim workflow when an isolated worktree is needed.
  • Improved protected-branch and worktree denial messages with clearer next steps.

[coderabbitai]

📝 Walkthrough

Walkthrough

The changes update Git denial messages and MCP claim tool descriptions. They distinguish path-scoped locks from worktree provisioning and direct worktree claims to item(action="claim").

Changes

Claim and worktree guidance

Layer / File(s)	Summary
Git denial guidance crates/flare-git-core/src/classify.rs, src/cli/git.rs	Git denial messages now explain that standalone claims do not provision worktrees and direct users to the item claim workflow.
Claim tool descriptions src/mcp_server.rs, src/mcp_server/builtin_tools.rs	MCP claim descriptions now document path-scoped locks, supported actions, and worktree provisioning through item(action="claim").

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• getappz/agentflare#185: Modifies the MCP claim tool interface.
• getappz/agentflare#279: Modifies Git classification and claim/worktree interfaces.
• getappz/agentflare#320: Modifies denial handling in classify.rs.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description contains only an automation note and omits the required summary, test plan, and reviewer notes.	Add the required Summary, Test plan, and Notes for reviewers sections with relevant details and test results.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly identifies the main change: separating the standalone claim tool from item(action=claim) in denial messages.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch task/424

---

_{Comment @coderabbitai help to get the list of available commands.}