@vibescope/mcp-server 0.4.5 → 0.4.6

package/dist/handlers/tool-docs.js

@@ -7,1328 +7,1394 @@
  * Token savings: ~8,000 tokens per schema load when this isn't bundled.
  */
 export const TOOL_INFO = {
-    start_work_session: `# start_work_session
-Initialize agent session and get assigned work.
-
-**Parameters:**
-- project_id (optional): Project UUID
-- git_url (optional): Git URL to find project
-- mode: 'lite' (default) or 'full' for complete context
-
-**Returns:** session_id, persona, project info, next_task
-
+    start_work_session: `# start_work_session
+Initialize agent session and get assigned work.
+
+**Parameters:**
+- project_id (optional): Project UUID
+- git_url (optional): Git URL to find project
+- mode: 'lite' (default) or 'full' for complete context
+
+**Returns:** session_id, persona, project info, next_task
+
 **Example:** start_work_session(git_url: "https://github.com/org/repo")`,
-    get_help: `# get_help
-Get workflow guidance on specific topics.
-
-**Parameters:**
-- topic (required): One of: getting_started, tasks, validation, deployment, git, blockers, milestones, fallback, session, tokens, topics
-
+    get_help: `# get_help
+Get workflow guidance on specific topics.
+
+**Parameters:**
+- topic (required): One of: getting_started, tasks, validation, deployment, git, blockers, milestones, fallback, session, tokens, topics
+
 **Example:** get_help(topic: "deployment")`,
-    get_token_usage: `# get_token_usage
-Get token usage statistics for current session.
-
+    get_token_usage: `# get_token_usage
+Get token usage statistics for current session.
+
 **Returns:** total calls, total tokens, breakdown by tool, averages`,
-    heartbeat: `# heartbeat
-Send heartbeat to maintain active status. Call every 30-60 seconds.
-
-**Parameters:**
-- session_id (optional): Uses current session if not provided
+    heartbeat: `# heartbeat
+Send heartbeat to maintain active status. Call every 30-60 seconds.
+
+**Parameters:**
+- session_id (optional): Uses current session if not provided
 - current_worktree_path (optional): Report your current git worktree path (e.g., "../project-task-abc123")`,
-    end_work_session: `# end_work_session
-End session and release claimed tasks.
-
-**Parameters:**
-- session_id (optional): Uses current session if not provided
-
+    end_work_session: `# end_work_session
+End session and release claimed tasks.
+
+**Parameters:**
+- session_id (optional): Uses current session if not provided
+
 **Returns:** Session summary with tasks completed, time spent`,
-    get_project_context: `# get_project_context
-Get full project context including goals, instructions, tasks, blockers, decisions.
-
-**Parameters:**
-- project_id (optional): Project UUID
-- git_url (optional): Git URL to find project
-
+    get_project_context: `# get_project_context
+Get full project context including goals, instructions, tasks, blockers, decisions.
+
+**Parameters:**
+- project_id (optional): Project UUID
+- git_url (optional): Git URL to find project
+
 Without params, lists all projects.`,
-    get_git_workflow: `# get_git_workflow
-Get git workflow config and branching instructions.
-
-**Parameters:**
-- project_id (required): Project UUID
-- task_id (optional): Include branch naming suggestion
-
+    get_git_workflow: `# get_git_workflow
+Get git workflow config and branching instructions.
+
+**Parameters:**
+- project_id (required): Project UUID
+- task_id (optional): Include branch naming suggestion
+
 **Returns:** workflow type, branch names, auto-settings`,
-    create_project: `# create_project
-Create a new project to track.
-
-**Parameters:**
-- name (required): Project display name
-- description: Brief description
-- goal: What "done" looks like
-- git_url: Repository URL
+    create_project: `# create_project
+Create a new project to track.
+
+**Parameters:**
+- name (required): Project display name
+- description: Brief description
+- goal: What "done" looks like
+- git_url: Repository URL
 - tech_stack: Array of technologies`,
-    update_project: `# update_project
-Update project settings.
-
-**Parameters:**
-- project_id (required): Project UUID
-- name, description, goal, git_url, tech_stack, status
-- git_workflow: none, trunk-based, github-flow, git-flow
+    update_project: `# update_project
+Update project settings.
+
+**Parameters:**
+- project_id (required): Project UUID
+- name, description, goal, git_url, tech_stack, status
+- git_workflow: none, trunk-based, github-flow, git-flow
 - git_main_branch, git_develop_branch, git_auto_branch, git_auto_tag`,
-    update_project_readme: `# update_project_readme
-Sync README content to the dashboard.
-
-**Parameters:**
-- project_id (required): Project UUID
+    update_project_readme: `# update_project_readme
+Sync README content to the dashboard.
+
+**Parameters:**
+- project_id (required): Project UUID
 - readme_content (required): Markdown content`,
-    get_task: `# get_task
-Get a single task by ID with optional subtasks and milestones.
-
-**Parameters:**
-- task_id (required): Task UUID
-- include_subtasks (optional): Include subtasks array (default: false)
+    get_task: `# get_task
+Get a single task by ID with optional subtasks and milestones.
+
+**Parameters:**
+- task_id (required): Task UUID
+- include_subtasks (optional): Include subtasks array (default: false)
 - include_milestones (optional): Include milestones array (default: false)`,
-    search_tasks: `# search_tasks
-Search tasks by text query. Supports pagination.
-
-**Parameters:**
-- project_id (required): Project UUID
-- query (required): Search query (min 2 chars)
-- status (optional): Array of statuses to filter
-- limit (optional): Max results per page (1-20, default: 10)
-- offset (optional): Number of results to skip (default: 0)
-
-**Returns:**
-- tasks: Array of matching tasks
-- total_matches: Total number of matching tasks
-- has_more: Whether more results exist beyond current page
-- offset: Current offset
+    search_tasks: `# search_tasks
+Search tasks by text query. Supports pagination.
+
+**Parameters:**
+- project_id (required): Project UUID
+- query (required): Search query (min 2 chars)
+- status (optional): Array of statuses to filter
+- limit (optional): Max results per page (1-20, default: 10)
+- offset (optional): Number of results to skip (default: 0)
+
+**Returns:**
+- tasks: Array of matching tasks
+- total_matches: Total number of matching tasks
+- has_more: Whether more results exist beyond current page
+- offset: Current offset
 - limit: Current limit`,
-    get_tasks_by_priority: `# get_tasks_by_priority
-Get tasks filtered by priority. Supports pagination.
-
-**Parameters:**
-- project_id (required): Project UUID
-- priority (optional): Exact priority (1-5)
-- priority_max (optional): Max priority for range query
-- status (optional): Filter by status (default: pending)
-- limit (optional): Max results per page (1-20, default: 10)
-- offset (optional): Number of results to skip (default: 0)
-
-**Returns:**
-- tasks: Array of matching tasks
-- total_count: Total number of matching tasks
-- has_more: Whether more results exist beyond current page
-- offset: Current offset
+    get_tasks_by_priority: `# get_tasks_by_priority
+Get tasks filtered by priority. Supports pagination.
+
+**Parameters:**
+- project_id (required): Project UUID
+- priority (optional): Exact priority (1-5)
+- priority_max (optional): Max priority for range query
+- status (optional): Filter by status (default: pending)
+- limit (optional): Max results per page (1-20, default: 10)
+- offset (optional): Number of results to skip (default: 0)
+
+**Returns:**
+- tasks: Array of matching tasks
+- total_count: Total number of matching tasks
+- has_more: Whether more results exist beyond current page
+- offset: Current offset
 - limit: Current limit`,
-    get_recent_tasks: `# get_recent_tasks
-Get tasks ordered by creation date. Supports pagination.
-
-**Parameters:**
-- project_id (required): Project UUID
-- order (optional): 'newest' or 'oldest' (default: newest)
-- status (optional): Filter by status
-- limit (optional): Max results per page (1-20, default: 10)
-- offset (optional): Number of results to skip (default: 0)
-
-**Returns:**
-- tasks: Array of matching tasks
-- total_count: Total number of matching tasks
-- has_more: Whether more results exist beyond current page
-- offset: Current offset
+    get_recent_tasks: `# get_recent_tasks
+Get tasks ordered by creation date. Supports pagination.
+
+**Parameters:**
+- project_id (required): Project UUID
+- order (optional): 'newest' or 'oldest' (default: newest)
+- status (optional): Filter by status
+- limit (optional): Max results per page (1-20, default: 10)
+- offset (optional): Number of results to skip (default: 0)
+
+**Returns:**
+- tasks: Array of matching tasks
+- total_count: Total number of matching tasks
+- has_more: Whether more results exist beyond current page
+- offset: Current offset
 - limit: Current limit`,
-    get_task_stats: `# get_task_stats
-Get aggregate task statistics. Most token-efficient way to understand project state.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_task_stats: `# get_task_stats
+Get aggregate task statistics. Most token-efficient way to understand project state.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Counts by status and priority, no task data`,
-    get_next_task: `# get_next_task
-Get highest priority pending task not claimed by another agent.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_next_task: `# get_next_task
+Get highest priority pending task not claimed by another agent.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** task or null, may suggest fallback activity`,
-    add_task: `# add_task
-Create a new task.
-
-**Parameters:**
-- project_id (required): Project UUID
-- title (required): Task title
-- description: Detailed description
-- priority: 1-5 (1=highest, default 3)
+    add_task: `# add_task
+Create a new task.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Task title
+- description: Detailed description
+- priority: 1-5 (1=highest, default 3)
 - estimated_minutes: Time estimate`,
-    update_task: `# update_task
-Update task status, progress, or details.
-
-**Parameters:**
-- task_id (required): Task UUID
-- status: pending, in_progress, completed, cancelled
-- progress_percentage: 0-100
-- progress_note: Brief note (auto-logged)
-- title, description, priority, estimated_minutes, git_branch
-
+    update_task: `# update_task
+Update task status, progress, or details.
+
+**Parameters:**
+- task_id (required): Task UUID
+- status: pending, in_progress, completed, cancelled
+- progress_percentage: 0-100
+- progress_note: Brief note (auto-logged)
+- title, description, priority, estimated_minutes, git_branch
+
 **Best practice:** Include progress_note with progress_percentage`,
-    complete_task: `# complete_task
-Mark task as done.
-
-**Parameters:**
-- task_id (required): Task UUID
-- summary: What was done
-
+    complete_task: `# complete_task
+Mark task as done.
+
+**Parameters:**
+- task_id (required): Task UUID
+- summary: What was done
+
 **Returns:** next_task, validation_count, blockers_count, deployment_priority`,
-    delete_task: `# delete_task
-Delete a task.
-
-**Parameters:**
+    delete_task: `# delete_task
+Delete a task.
+
+**Parameters:**
 - task_id (required): Task UUID`,
-    cancel_task: `# cancel_task
-Cancel a task with an optional reason. Use this when a task should be marked as cancelled rather than deleted (e.g., PR was closed, work was superseded). The task remains visible with a cancelled status for historical tracking.
-
-**Parameters:**
-- task_id (required): Task UUID
-- cancelled_reason (optional): One of: pr_closed, superseded, user_cancelled, validation_failed, obsolete, blocked
-- cancellation_note (optional): Additional context about the cancellation
-
-**Returns:** task_id, cancelled_reason, message, sprint info (if auto-completed)
-
+    cancel_task: `# cancel_task
+Cancel a task with an optional reason. Use this when a task should be marked as cancelled rather than deleted (e.g., PR was closed, work was superseded). The task remains visible with a cancelled status for historical tracking.
+
+**Parameters:**
+- task_id (required): Task UUID
+- cancelled_reason (optional): One of: pr_closed, superseded, user_cancelled, validation_failed, obsolete, blocked
+- cancellation_note (optional): Additional context about the cancellation
+
+**Returns:** task_id, cancelled_reason, message, sprint info (if auto-completed)
+
 **Example:** cancel_task(task_id: "abc", cancelled_reason: "pr_closed", cancellation_note: "PR was closed without merging")`,
-    release_task: `# release_task
-Release a claimed task back to pending status. Use when you need to give up a task you've started but cannot complete (e.g., context limits reached, conflicts with other work, user requested different approach).
-
-**Parameters:**
-- task_id (required): Task UUID
-- reason (optional): Explanation for releasing the task
-
-**Returns:** success, task_id, message, hint
-
-**Example:** release_task(task_id: "abc", reason: "Context limit reached, need fresh session")
-
+    release_task: `# release_task
+Release a claimed task back to pending status. Use when you need to give up a task you've started but cannot complete (e.g., context limits reached, conflicts with other work, user requested different approach).
+
+**Parameters:**
+- task_id (required): Task UUID
+- reason (optional): Explanation for releasing the task
+
+**Returns:** success, task_id, message, hint
+
+**Example:** release_task(task_id: "abc", reason: "Context limit reached, need fresh session")
+
 **Note:** Only in_progress tasks can be released. The task becomes available for other agents to claim via get_next_task().`,
-    batch_update_tasks: `# batch_update_tasks
-Update multiple tasks at once.
-
-**Parameters:**
+    batch_update_tasks: `# batch_update_tasks
+Update multiple tasks at once.
+
+**Parameters:**
 - updates (required): Array of {task_id, status?, progress_percentage?, progress_note?, priority?}`,
-    batch_complete_tasks: `# batch_complete_tasks
-Complete multiple tasks at once.
-
-**Parameters:**
+    batch_complete_tasks: `# batch_complete_tasks
+Complete multiple tasks at once.
+
+**Parameters:**
 - completions (required): Array of {task_id, summary?}`,
-    add_task_reference: `# add_task_reference
-Add a reference URL to a task.
-
-**Parameters:**
-- task_id (required): Task UUID
-- url (required): Reference URL
+    add_task_reference: `# add_task_reference
+Add a reference URL to a task.
+
+**Parameters:**
+- task_id (required): Task UUID
+- url (required): Reference URL
 - label (optional): Display label`,
-    remove_task_reference: `# remove_task_reference
-Remove a reference URL from a task.
-
-**Parameters:**
-- task_id (required): Task UUID
+    remove_task_reference: `# remove_task_reference
+Remove a reference URL from a task.
+
+**Parameters:**
+- task_id (required): Task UUID
 - url (required): URL to remove`,
-    add_milestone: `# add_milestone
-Add a milestone/step to a task.
-
-**Parameters:**
-- task_id (required): Task UUID
-- title (required): Milestone title
-- description (optional): Details
+    add_milestone: `# add_milestone
+Add a milestone/step to a task.
+
+**Parameters:**
+- task_id (required): Task UUID
+- title (required): Milestone title
+- description (optional): Details
 - order_index (optional): Position (0-based)`,
-    update_milestone: `# update_milestone
-Update a milestone.
-
-**Parameters:**
-- milestone_id (required): Milestone UUID
+    update_milestone: `# update_milestone
+Update a milestone.
+
+**Parameters:**
+- milestone_id (required): Milestone UUID
 - title, description, status (pending/in_progress/completed), order_index`,
-    complete_milestone: `# complete_milestone
-Mark milestone as completed.
-
-**Parameters:**
+    complete_milestone: `# complete_milestone
+Mark milestone as completed.
+
+**Parameters:**
 - milestone_id (required): Milestone UUID`,
-    delete_milestone: `# delete_milestone
-Delete a milestone.
-
-**Parameters:**
+    delete_milestone: `# delete_milestone
+Delete a milestone.
+
+**Parameters:**
 - milestone_id (required): Milestone UUID`,
-    get_milestones: `# get_milestones
-Get all milestones for a task.
-
-**Parameters:**
+    get_milestones: `# get_milestones
+Get all milestones for a task.
+
+**Parameters:**
 - task_id (required): Task UUID`,
-    log_progress: `# log_progress
-Record a progress update.
-
-**Parameters:**
-- project_id (required): Project UUID
-- summary (required): Brief summary
-- task_id (optional): Link to task
+    log_progress: `# log_progress
+Record a progress update.
+
+**Parameters:**
+- project_id (required): Project UUID
+- summary (required): Brief summary
+- task_id (optional): Link to task
 - details (optional): Extended notes`,
-    get_activity_feed: `# get_activity_feed
-Get combined activity feed.
-
-**Parameters:**
-- project_id (required): Project UUID
-- types (optional): Array of task, progress, blocker, decision
-- created_by (optional): agent or user
-- since (optional): ISO date string
+    get_activity_feed: `# get_activity_feed
+Get combined activity feed.
+
+**Parameters:**
+- project_id (required): Project UUID
+- types (optional): Array of task, progress, blocker, decision
+- created_by (optional): agent or user
+- since (optional): ISO date string
 - limit (optional): Max items (default 50)`,
-    add_blocker: `# add_blocker
-Record a blocker preventing progress.
-
-**Parameters:**
-- project_id (required): Project UUID
+    add_blocker: `# add_blocker
+Record a blocker preventing progress.
+
+**Parameters:**
+- project_id (required): Project UUID
 - description (required): What is blocking`,
-    resolve_blocker: `# resolve_blocker
-Mark a blocker as resolved.
-
-**Parameters:**
-- blocker_id (required): Blocker UUID
+    resolve_blocker: `# resolve_blocker
+Mark a blocker as resolved.
+
+**Parameters:**
+- blocker_id (required): Blocker UUID
 - resolution_note (optional): How it was resolved`,
-    get_blockers: `# get_blockers
-Get blockers for a project.
-
-**Parameters:**
-- project_id (required): Project UUID
+    get_blockers: `# get_blockers
+Get blockers for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
 - status (optional): open or resolved (default: open)`,
-    delete_blocker: `# delete_blocker
-Delete a blocker.
-
-**Parameters:**
+    delete_blocker: `# delete_blocker
+Delete a blocker.
+
+**Parameters:**
 - blocker_id (required): Blocker UUID`,
-    log_decision: `# log_decision
-Record an architectural decision.
-
-**Parameters:**
-- project_id (required): Project UUID
-- title (required): Decision title
-- description (required): What was decided
-- rationale (optional): Why
+    log_decision: `# log_decision
+Record an architectural decision.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Decision title
+- description (required): What was decided
+- rationale (optional): Why
 - alternatives_considered (optional): Array of alternatives`,
-    get_decisions: `# get_decisions
-Get recorded decisions.
-
-**Parameters:**
+    get_decisions: `# get_decisions
+Get recorded decisions.
+
+**Parameters:**
 - project_id (required): Project UUID`,
-    delete_decision: `# delete_decision
-Delete a decision.
-
-**Parameters:**
+    delete_decision: `# delete_decision
+Delete a decision.
+
+**Parameters:**
 - decision_id (required): Decision UUID`,
-    add_idea: `# add_idea
-Record an improvement idea.
-
-**Parameters:**
-- project_id (required): Project UUID
-- title (required): Idea title
-- description (optional): Details
+    add_idea: `# add_idea
+Record an improvement idea.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Idea title
+- description (optional): Details
 - status (optional): raw, exploring, planned, in_development, shipped`,
-    update_idea: `# update_idea
-Update an idea.
-
-**Parameters:**
-- idea_id (required): Idea UUID
+    update_idea: `# update_idea
+Update an idea.
+
+**Parameters:**
+- idea_id (required): Idea UUID
 - title, description, status, doc_url`,
-    get_ideas: `# get_ideas
-Get recorded ideas.
-
-**Parameters:**
-- project_id (required): Project UUID
+    get_ideas: `# get_ideas
+Get recorded ideas.
+
+**Parameters:**
+- project_id (required): Project UUID
 - status (optional): Filter by status`,
-    delete_idea: `# delete_idea
-Delete an idea.
-
-**Parameters:**
+    delete_idea: `# delete_idea
+Delete an idea.
+
+**Parameters:**
 - idea_id (required): Idea UUID`,
-    convert_idea_to_task: `# convert_idea_to_task
-Convert an idea to a task. Creates a new task from the idea's title and description.
-
-**Parameters:**
-- idea_id (required): Idea UUID to convert
-- priority (optional): Task priority 1-5 (default: 3)
-- estimated_minutes (optional): Estimated time
-- update_status (optional): Update idea to 'in_development' (default: true)
-
-**Returns:**
-- task_id: Created task UUID
+    convert_idea_to_task: `# convert_idea_to_task
+Convert an idea to a task. Creates a new task from the idea's title and description.
+
+**Parameters:**
+- idea_id (required): Idea UUID to convert
+- priority (optional): Task priority 1-5 (default: 3)
+- estimated_minutes (optional): Estimated time
+- update_status (optional): Update idea to 'in_development' (default: true)
+
+**Returns:**
+- task_id: Created task UUID
 - Links idea and task together`,
-    add_finding: `# add_finding
-Record an audit/review finding.
-
-**Parameters:**
-- project_id (required): Project UUID
-- title (required): Finding title
-- category: performance, security, code_quality, accessibility, documentation, architecture, testing, other
-- description: Details with impact and suggested fix
-- severity: info, low, medium, high, critical
+    add_finding: `# add_finding
+Record an audit/review finding.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Finding title
+- category: performance, security, code_quality, accessibility, documentation, architecture, testing, other
+- description: Details with impact and suggested fix
+- severity: info, low, medium, high, critical
 - file_path, line_number, related_task_id (optional)`,
-    get_findings: `# get_findings
-Get audit findings.
-
-**Parameters:**
-- project_id (required): Project UUID
-- category, severity, status (optional filters)
+    get_findings: `# get_findings
+Get audit findings.
+
+**Parameters:**
+- project_id (required): Project UUID
+- category, severity, status (optional filters)
 - limit (optional): Max items`,
-    update_finding: `# update_finding
-Update a finding.
-
-**Parameters:**
-- finding_id (required): Finding UUID
-- status: open, addressed, dismissed, wontfix
+    update_finding: `# update_finding
+Update a finding.
+
+**Parameters:**
+- finding_id (required): Finding UUID
+- status: open, addressed, dismissed, wontfix
 - resolution_note, title, description, severity`,
-    delete_finding: `# delete_finding
-Delete a finding.
-
-**Parameters:**
+    delete_finding: `# delete_finding
+Delete a finding.
+
+**Parameters:**
 - finding_id (required): Finding UUID`,
-    get_tasks_awaiting_validation: `# get_tasks_awaiting_validation
-Get completed tasks needing validation.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_tasks_awaiting_validation: `# get_tasks_awaiting_validation
+Get completed tasks needing validation.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Tasks with reviewing status (who's reviewing, when started)`,
-    claim_validation: `# claim_validation
-Claim a completed task for review. Shows "being reviewed" on dashboard.
-
-**Parameters:**
-- task_id (required): Task UUID to claim
-
+    claim_validation: `# claim_validation
+Claim a completed task for review. Shows "being reviewed" on dashboard.
+
+**Parameters:**
+- task_id (required): Task UUID to claim
+
 **Note:** Claim before reviewing to prevent duplicate work.`,
-    validate_task: `# validate_task
-Validate a completed task.
-
-**Parameters:**
-- task_id (required): Task UUID
-- approved (required): true/false
+    validate_task: `# validate_task
+Validate a completed task.
+
+**Parameters:**
+- task_id (required): Task UUID
+- approved (required): true/false
 - validation_notes: What was checked, issues found`,
-    request_deployment: `# request_deployment
-Request a deployment.
-
-**Parameters:**
-- project_id (required): Project UUID
-- environment: development, staging, production
-- version_bump: patch, minor, major
+    request_deployment: `# request_deployment
+Request a deployment.
+
+**Parameters:**
+- project_id (required): Project UUID
+- environment: development, staging, production
+- version_bump: patch, minor, major
 - notes, git_ref (optional)`,
-    claim_deployment_validation: `# claim_deployment_validation
-Claim pending deployment for validation.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    claim_deployment_validation: `# claim_deployment_validation
+Claim pending deployment for validation.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 Next: Run build+tests, then call report_validation`,
-    report_validation: `# report_validation
-Report build/test results.
-
-**Parameters:**
-- project_id (required): Project UUID
-- build_passed (required): boolean
-- tests_passed (required): boolean
+    report_validation: `# report_validation
+Report build/test results.
+
+**Parameters:**
+- project_id (required): Project UUID
+- build_passed (required): boolean
+- tests_passed (required): boolean
 - error_message (if failed)`,
-    check_deployment_status: `# check_deployment_status
-Get active deployment status.
-
-**Parameters:**
+    check_deployment_status: `# check_deployment_status
+Get active deployment status.
+
+**Parameters:**
 - project_id (required): Project UUID`,
-    start_deployment: `# start_deployment
-Start deployment (requires 'ready' status).
-
-**Parameters:**
+    start_deployment: `# start_deployment
+Start deployment (requires 'ready' status).
+
+**Parameters:**
 - project_id (required): Project UUID`,
-    complete_deployment: `# complete_deployment
-Mark deployment complete.
-
-**Parameters:**
-- project_id (required): Project UUID
-- success (required): boolean
+    complete_deployment: `# complete_deployment
+Mark deployment complete.
+
+**Parameters:**
+- project_id (required): Project UUID
+- success (required): boolean
 - summary: What was deployed or why failed`,
-    cancel_deployment: `# cancel_deployment
-Cancel active deployment.
-
-**Parameters:**
-- project_id (required): Project UUID
+    cancel_deployment: `# cancel_deployment
+Cancel active deployment.
+
+**Parameters:**
+- project_id (required): Project UUID
 - reason (optional): Why cancelled`,
-    schedule_deployment: `# schedule_deployment
-Schedule a deployment for a specific time.
-
-**Parameters:**
-- project_id (required): Project UUID
-- scheduled_at (required): ISO 8601 datetime
-- schedule_type (optional): once, daily, weekly, monthly (default: once)
-- auto_trigger (optional): Whether agents auto-trigger (default: true)
-- environment (optional): development, staging, production (default: production)
-- version_bump (optional): patch, minor, major (default: patch)
-- notes (optional): Notes about the deployment
-- git_ref (optional): Git branch or commit
-
+    schedule_deployment: `# schedule_deployment
+Schedule a deployment for a specific time.
+
+**Parameters:**
+- project_id (required): Project UUID
+- scheduled_at (required): ISO 8601 datetime
+- schedule_type (optional): once, daily, weekly, monthly (default: once)
+- auto_trigger (optional): Whether agents auto-trigger (default: true)
+- environment (optional): development, staging, production (default: production)
+- version_bump (optional): patch, minor, major (default: patch)
+- notes (optional): Notes about the deployment
+- git_ref (optional): Git branch or commit
+
 **Example:** schedule_deployment(project_id, scheduled_at: "2025-01-15T10:00:00Z", schedule_type: "weekly")`,
-    get_scheduled_deployments: `# get_scheduled_deployments
-List scheduled deployments for a project.
-
-**Parameters:**
-- project_id (required): Project UUID
+    get_scheduled_deployments: `# get_scheduled_deployments
+List scheduled deployments for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
 - include_disabled (optional): Include disabled schedules (default: false)`,
-    update_scheduled_deployment: `# update_scheduled_deployment
-Update a scheduled deployment's configuration.
-
-**Parameters:**
-- schedule_id (required): Schedule UUID
-- scheduled_at (optional): New scheduled time
-- schedule_type (optional): once, daily, weekly, monthly
-- auto_trigger (optional): Whether to auto-trigger
-- enabled (optional): Enable or disable
+    update_scheduled_deployment: `# update_scheduled_deployment
+Update a scheduled deployment's configuration.
+
+**Parameters:**
+- schedule_id (required): Schedule UUID
+- scheduled_at (optional): New scheduled time
+- schedule_type (optional): once, daily, weekly, monthly
+- auto_trigger (optional): Whether to auto-trigger
+- enabled (optional): Enable or disable
 - environment, version_bump, notes, git_ref (optional)`,
-    delete_scheduled_deployment: `# delete_scheduled_deployment
-Delete a scheduled deployment.
-
-**Parameters:**
+    delete_scheduled_deployment: `# delete_scheduled_deployment
+Delete a scheduled deployment.
+
+**Parameters:**
 - schedule_id (required): Schedule UUID`,
-    trigger_scheduled_deployment: `# trigger_scheduled_deployment
-Manually trigger a scheduled deployment.
-
-Creates a new deployment using the schedule's configuration.
-Updates schedule: last_triggered_at, trigger_count, next scheduled_at (for recurring).
-
-**Parameters:**
+    trigger_scheduled_deployment: `# trigger_scheduled_deployment
+Manually trigger a scheduled deployment.
+
+Creates a new deployment using the schedule's configuration.
+Updates schedule: last_triggered_at, trigger_count, next scheduled_at (for recurring).
+
+**Parameters:**
 - schedule_id (required): Schedule UUID`,
-    check_due_deployments: `# check_due_deployments
-Check for scheduled deployments that are due.
-
-Returns schedules where: enabled AND auto_trigger AND scheduled_at <= NOW()
-
-Use this to find deployments to trigger when working on a project.
-
-**Parameters:**
+    check_due_deployments: `# check_due_deployments
+Check for scheduled deployments that are due.
+
+Returns schedules where: enabled AND auto_trigger AND scheduled_at <= NOW()
+
+Use this to find deployments to trigger when working on a project.
+
+**Parameters:**
 - project_id (required): Project UUID`,
-    start_fallback_activity: `# start_fallback_activity
-Start background activity when no tasks.
-
-**Parameters:**
-- project_id (required): Project UUID
+    start_fallback_activity: `# start_fallback_activity
+Start background activity when no tasks.
+
+**Parameters:**
+- project_id (required): Project UUID
 - activity (required): feature_ideation, code_review, performance_audit, ux_review, cost_analysis, security_review, test_coverage, documentation_review, dependency_audit, validate_completed_tasks`,
-    stop_fallback_activity: `# stop_fallback_activity
-Stop current fallback activity.
-
-**Parameters:**
-- project_id (required): Project UUID
+    stop_fallback_activity: `# stop_fallback_activity
+Stop current fallback activity.
+
+**Parameters:**
+- project_id (required): Project UUID
 - summary (optional): What was accomplished`,
-    get_activity_history: `# get_activity_history
-Get background activity history.
-
-**Parameters:**
-- project_id (required): Project UUID
-- activity_type (optional): Filter by type
+    get_activity_history: `# get_activity_history
+Get background activity history.
+
+**Parameters:**
+- project_id (required): Project UUID
+- activity_type (optional): Filter by type
 - limit (optional): Max items`,
-    get_activity_schedules: `# get_activity_schedules
-Get activity schedules.
-
-**Parameters:**
+    get_activity_schedules: `# get_activity_schedules
+Get activity schedules.
+
+**Parameters:**
 - project_id (required): Project UUID`,
-    get_pending_requests: `# get_pending_requests
-Get unacknowledged user requests.
-
-**Parameters:**
+    get_pending_requests: `# get_pending_requests
+Get unacknowledged user requests.
+
+**Parameters:**
 - project_id (required): Project UUID`,
-    acknowledge_request: `# acknowledge_request
-Mark a request as handled.
-
-**Parameters:**
+    acknowledge_request: `# acknowledge_request
+Mark a request as handled.
+
+**Parameters:**
 - request_id (required): Request UUID`,
-    answer_question: `# answer_question
-Answer a user question from dashboard.
-
-**Parameters:**
-- request_id (required): Request UUID
+    answer_question: `# answer_question
+Answer a user question from dashboard.
+
+**Parameters:**
+- request_id (required): Request UUID
 - answer (required): Your answer`,
-    discover_tools: `# discover_tools
-List available tools by category.
-
-**Parameters:**
-- category (optional): Filter to specific category
-
-Without category, returns all categories with tool counts.
+    discover_tools: `# discover_tools
+List available tools by category.
+
+**Parameters:**
+- category (optional): Filter to specific category
+
+Without category, returns all categories with tool counts.
 With category, returns tools in that category with brief descriptions.`,
-    get_tool_info: `# get_tool_info
-Get detailed info for a specific tool.
-
-**Parameters:**
-- tool_name (required): Name of the tool
-
+    get_tool_info: `# get_tool_info
+Get detailed info for a specific tool.
+
+**Parameters:**
+- tool_name (required): Name of the tool
+
 Returns: full documentation, parameters, examples, best practices.`,
     // Organization tools
-    list_organizations: `# list_organizations
-List organizations the current user belongs to.
-
-**Parameters:** None
-
+    list_organizations: `# list_organizations
+List organizations the current user belongs to.
+
+**Parameters:** None
+
 **Returns:** Array of organizations with role and joined_at`,
-    create_organization: `# create_organization
-Create a new organization. You become the owner.
-
-**Parameters:**
-- name (required): Organization display name
-- description (optional): Brief description
-- slug (optional): URL-friendly identifier (auto-generated if not provided)
-
+    create_organization: `# create_organization
+Create a new organization. You become the owner.
+
+**Parameters:**
+- name (required): Organization display name
+- description (optional): Brief description
+- slug (optional): URL-friendly identifier (auto-generated if not provided)
+
 **Example:** create_organization(name: "Acme Corp", description: "Our development team")`,
-    update_organization: `# update_organization
-Update organization details. Requires admin role.
-
-**Parameters:**
-- organization_id (required): Organization UUID
+    update_organization: `# update_organization
+Update organization details. Requires admin role.
+
+**Parameters:**
+- organization_id (required): Organization UUID
 - name, description, logo_url (optional updates)`,
-    delete_organization: `# delete_organization
-Delete an organization. Requires owner role. Removes all shares.
-
-**Parameters:**
-- organization_id (required): Organization UUID
-
+    delete_organization: `# delete_organization
+Delete an organization. Requires owner role. Removes all shares.
+
+**Parameters:**
+- organization_id (required): Organization UUID
+
 **Warning:** This will remove all project shares with this organization.`,
-    list_org_members: `# list_org_members
-List members of an organization.
-
-**Parameters:**
-- organization_id (required): Organization UUID
-
+    list_org_members: `# list_org_members
+List members of an organization.
+
+**Parameters:**
+- organization_id (required): Organization UUID
+
 **Returns:** Array of members with role and joined_at`,
-    invite_member: `# invite_member
-Invite a user to an organization by email. Requires admin role.
-
-**Parameters:**
-- organization_id (required): Organization UUID
-- email (required): Email address to invite
-- role (optional): admin, member, or viewer (default: member)
-
+    invite_member: `# invite_member
+Invite a user to an organization by email. Requires admin role.
+
+**Parameters:**
+- organization_id (required): Organization UUID
+- email (required): Email address to invite
+- role (optional): admin, member, or viewer (default: member)
+
 **Returns:** Invite details with token`,
-    update_member_role: `# update_member_role
-Change a member's role. Requires admin role.
-
-**Parameters:**
-- organization_id (required): Organization UUID
-- user_id (required): User UUID to update
-- role (required): admin, member, or viewer
-
+    update_member_role: `# update_member_role
+Change a member's role. Requires admin role.
+
+**Parameters:**
+- organization_id (required): Organization UUID
+- user_id (required): User UUID to update
+- role (required): admin, member, or viewer
+
 **Note:** Cannot change your own role or the owner's role.`,
-    remove_member: `# remove_member
-Remove a member from an organization. Requires admin role.
-
-**Parameters:**
-- organization_id (required): Organization UUID
-- user_id (required): User UUID to remove
-
+    remove_member: `# remove_member
+Remove a member from an organization. Requires admin role.
+
+**Parameters:**
+- organization_id (required): Organization UUID
+- user_id (required): User UUID to remove
+
 **Note:** Cannot remove the owner. Their org-scoped API keys are invalidated.`,
-    leave_organization: `# leave_organization
-Leave an organization.
-
-**Parameters:**
-- organization_id (required): Organization UUID
-
+    leave_organization: `# leave_organization
+Leave an organization.
+
+**Parameters:**
+- organization_id (required): Organization UUID
+
 **Note:** Owner cannot leave. Must transfer ownership or delete organization.`,
-    share_project_with_org: `# share_project_with_org
-Share a project with an organization. You must own the project.
-
-**Parameters:**
-- project_id (required): Project UUID
-- organization_id (required): Organization UUID to share with
-- permission (optional): read, write, or admin (default: read)
-
-**Permission levels:**
-- read: View project and tasks
-- write: Add/update tasks, log progress
+    share_project_with_org: `# share_project_with_org
+Share a project with an organization. You must own the project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- organization_id (required): Organization UUID to share with
+- permission (optional): read, write, or admin (default: read)
+
+**Permission levels:**
+- read: View project and tasks
+- write: Add/update tasks, log progress
 - admin: All write permissions plus deployments`,
-    update_project_share: `# update_project_share
-Update the permission level for a project share.
-
-**Parameters:**
-- project_id (required): Project UUID
-- organization_id (required): Organization UUID
+    update_project_share: `# update_project_share
+Update the permission level for a project share.
+
+**Parameters:**
+- project_id (required): Project UUID
+- organization_id (required): Organization UUID
 - permission (required): read, write, or admin`,
-    unshare_project: `# unshare_project
-Remove a project share from an organization.
-
-**Parameters:**
-- project_id (required): Project UUID
-- organization_id (required): Organization UUID
-
+    unshare_project: `# unshare_project
+Remove a project share from an organization.
+
+**Parameters:**
+- project_id (required): Project UUID
+- organization_id (required): Organization UUID
+
 **Note:** Org members will lose access immediately.`,
-    list_project_shares: `# list_project_shares
-List all organizations a project is shared with.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    list_project_shares: `# list_project_shares
+List all organizations a project is shared with.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Array of shares with organization info and permission level`,
     // Cost monitoring tools
-    get_cost_summary: `# get_cost_summary
-Get cost summary (daily/weekly/monthly) for a project.
-
-**Parameters:**
-- project_id (required): Project UUID
-- period: 'daily' | 'weekly' | 'monthly' (default: daily)
-- limit: Max records to return (default: 30)
-
+    get_cost_summary: `# get_cost_summary
+Get cost summary (daily/weekly/monthly) for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- period: 'daily' | 'weekly' | 'monthly' (default: daily)
+- limit: Max records to return (default: 30)
+
 **Returns:** Cost summary with totals and breakdown by model`,
-    get_cost_alerts: `# get_cost_alerts
-Get cost alerts for the current user.
-
-**Parameters:**
-- project_id (optional): Filter by project
-
+    get_cost_alerts: `# get_cost_alerts
+Get cost alerts for the current user.
+
+**Parameters:**
+- project_id (optional): Filter by project
+
 **Returns:** Array of configured cost alerts`,
-    add_cost_alert: `# add_cost_alert
-Add a cost threshold alert.
-
-**Parameters:**
-- project_id (optional): Specific project or null for all
-- threshold_amount (required): Amount in USD
-- threshold_period (required): 'daily' | 'weekly' | 'monthly'
-- alert_type: 'warning' | 'critical' (default: warning)
-
+    add_cost_alert: `# add_cost_alert
+Add a cost threshold alert.
+
+**Parameters:**
+- project_id (optional): Specific project or null for all
+- threshold_amount (required): Amount in USD
+- threshold_period (required): 'daily' | 'weekly' | 'monthly'
+- alert_type: 'warning' | 'critical' (default: warning)
+
 **Example:** add_cost_alert(threshold_amount: 50, threshold_period: "daily", alert_type: "warning")`,
-    update_cost_alert: `# update_cost_alert
-Update an existing cost alert.
-
-**Parameters:**
-- alert_id (required): Alert UUID
-- threshold_amount: New amount in USD
-- threshold_period: New period
-- alert_type: New alert type
+    update_cost_alert: `# update_cost_alert
+Update an existing cost alert.
+
+**Parameters:**
+- alert_id (required): Alert UUID
+- threshold_amount: New amount in USD
+- threshold_period: New period
+- alert_type: New alert type
 - enabled: Enable/disable the alert`,
-    delete_cost_alert: `# delete_cost_alert
-Delete a cost alert.
-
-**Parameters:**
+    delete_cost_alert: `# delete_cost_alert
+Delete a cost alert.
+
+**Parameters:**
 - alert_id (required): Alert UUID to delete`,
-    get_task_costs: `# get_task_costs
-Get cost breakdown by task for a project.
-
-**Parameters:**
-- project_id (required): Project UUID
-- limit: Max tasks to return (default: 20)
-
+    get_task_costs: `# get_task_costs
+Get cost breakdown by task for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- limit: Max tasks to return (default: 20)
+
 **Returns:** Tasks sorted by estimated cost with model breakdown`,
     // Subtasks
-    add_subtask: `# add_subtask
-Add a subtask to break down a larger task.
-
-**Parameters:**
-- parent_task_id (required): UUID of the parent task
-- title (required): Subtask title
-- description (optional): Detailed description
-- priority (optional): 1-5 (defaults to parent priority)
-- estimated_minutes (optional): Time estimate
-
+    add_subtask: `# add_subtask
+Add a subtask to break down a larger task.
+
+**Parameters:**
+- parent_task_id (required): UUID of the parent task
+- title (required): Subtask title
+- description (optional): Detailed description
+- priority (optional): 1-5 (defaults to parent priority)
+- estimated_minutes (optional): Time estimate
+
 **Note:** Max depth is 1 (subtasks cannot have their own subtasks).`,
-    get_subtasks: `# get_subtasks
-Get subtasks for a parent task.
-
-**Parameters:**
-- parent_task_id (required): UUID of the parent task
-- status (optional): Filter by status
-
+    get_subtasks: `# get_subtasks
+Get subtasks for a parent task.
+
+**Parameters:**
+- parent_task_id (required): UUID of the parent task
+- status (optional): Filter by status
+
 **Returns:** Subtasks with aggregate completion stats.`,
     // Bodies of work
-    create_body_of_work: `# create_body_of_work
-Create a new body of work to group tasks into phases.
-
-**Parameters:**
-- project_id (required): Project UUID
-- title (required): Title for the body of work
-- description (optional): Description
-- auto_deploy_on_completion (optional): Auto-deploy when all tasks complete (default: false)
-- deploy_environment (optional): Target environment (default: production)
-- deploy_version_bump (optional): Version bump (default: minor)
+    create_body_of_work: `# create_body_of_work
+Create a new body of work to group tasks into phases.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Title for the body of work
+- description (optional): Description
+- auto_deploy_on_completion (optional): Auto-deploy when all tasks complete (default: false)
+- deploy_environment (optional): Target environment (default: production)
+- deploy_version_bump (optional): Version bump (default: minor)
 - deploy_trigger (optional): When to trigger auto-deploy (default: all_completed_validated)`,
-    update_body_of_work: `# update_body_of_work
-Update a body of work's settings.
-
-**Parameters:**
-- body_of_work_id (required): Body of work UUID
-- title, description (optional)
+    update_body_of_work: `# update_body_of_work
+Update a body of work's settings.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+- title, description (optional)
 - auto_deploy_on_completion, deploy_environment, deploy_version_bump, deploy_trigger (optional)`,
-    get_body_of_work: `# get_body_of_work
-Get a body of work with all its tasks organized by phase.
-
-**Parameters:**
-- body_of_work_id (required): Body of work UUID
-
+    get_body_of_work: `# get_body_of_work
+Get a body of work with all its tasks organized by phase.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+
 **Returns:** Body of work with tasks grouped by pre/core/post phases.`,
-    get_bodies_of_work: `# get_bodies_of_work
-List bodies of work for a project.
-
-**Parameters:**
-- project_id (required): Project UUID
-- status (optional): Filter by status (draft, active, completed, cancelled)
+    get_bodies_of_work: `# get_bodies_of_work
+List bodies of work for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): Filter by status (draft, active, completed, cancelled)
 - limit (optional): Max items (default 50)`,
-    delete_body_of_work: `# delete_body_of_work
-Delete a body of work. Tasks are preserved but no longer grouped.
-
-**Parameters:**
+    delete_body_of_work: `# delete_body_of_work
+Delete a body of work. Tasks are preserved but no longer grouped.
+
+**Parameters:**
 - body_of_work_id (required): Body of work UUID`,
-    add_task_to_body_of_work: `# add_task_to_body_of_work
-Add a task to a body of work in a specific phase.
-
-**Parameters:**
-- body_of_work_id (required): Body of work UUID
-- task_id (required): Task UUID to add
-- phase (optional): pre, core, or post (default: core)
+    add_task_to_body_of_work: `# add_task_to_body_of_work
+Add a task to a body of work in a specific phase.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+- task_id (required): Task UUID to add
+- phase (optional): pre, core, or post (default: core)
 - order_index (optional): Order within phase`,
-    remove_task_from_body_of_work: `# remove_task_from_body_of_work
-Remove a task from its body of work.
-
-**Parameters:**
-- task_id (required): Task UUID to remove
-
+    remove_task_from_body_of_work: `# remove_task_from_body_of_work
+Remove a task from its body of work.
+
+**Parameters:**
+- task_id (required): Task UUID to remove
+
 **Note:** The task is preserved, just no longer grouped.`,
-    activate_body_of_work: `# activate_body_of_work
-Activate a draft body of work to start execution.
-
-**Parameters:**
-- body_of_work_id (required): Body of work UUID
-
+    activate_body_of_work: `# activate_body_of_work
+Activate a draft body of work to start execution.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+
 **Note:** Requires at least one task. Once active, tasks follow phase order.`,
-    add_task_dependency: `# add_task_dependency
-Add a dependency between tasks in a body of work.
-
-**Parameters:**
-- body_of_work_id (required): Body of work UUID
-- task_id (required): Task that depends on another
-- depends_on_task_id (required): Task that must complete first
-
+    add_task_dependency: `# add_task_dependency
+Add a dependency between tasks in a body of work.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+- task_id (required): Task that depends on another
+- depends_on_task_id (required): Task that must complete first
+
 **Note:** Prevents circular dependencies.`,
-    remove_task_dependency: `# remove_task_dependency
-Remove a dependency between tasks.
-
-**Parameters:**
-- task_id (required): Task UUID
+    remove_task_dependency: `# remove_task_dependency
+Remove a dependency between tasks.
+
+**Parameters:**
+- task_id (required): Task UUID
 - depends_on_task_id (required): Dependency task UUID`,
-    get_task_dependencies: `# get_task_dependencies
-Get task dependencies for a body of work or specific task.
-
-**Parameters:**
-- body_of_work_id (optional): Body of work UUID
+    get_task_dependencies: `# get_task_dependencies
+Get task dependencies for a body of work or specific task.
+
+**Parameters:**
+- body_of_work_id (optional): Body of work UUID
 - task_id (optional): Specific task UUID`,
-    get_next_body_of_work_task: `# get_next_body_of_work_task
-Get the next available task from a body of work.
-
-**Parameters:**
-- body_of_work_id (required): Body of work UUID
-
+    get_next_body_of_work_task: `# get_next_body_of_work_task
+Get the next available task from a body of work.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+
 **Note:** Considers phase order (pre → core → post) and dependencies.`,
     // Sprints
-    create_sprint: `# create_sprint
-Create a new sprint with time bounds and velocity tracking.
-
-**Parameters:**
-- project_id (required): Project UUID
-- title (required): Sprint title (e.g., "Sprint 5")
-- start_date (required): Start date (YYYY-MM-DD)
-- end_date (required): End date (YYYY-MM-DD)
-- goal (optional): Sprint goal statement
+    create_sprint: `# create_sprint
+Create a new sprint with time bounds and velocity tracking.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Sprint title (e.g., "Sprint 5")
+- start_date (required): Start date (YYYY-MM-DD)
+- end_date (required): End date (YYYY-MM-DD)
+- goal (optional): Sprint goal statement
 - auto_deploy_on_completion, deploy_environment, deploy_version_bump (optional)`,
-    update_sprint: `# update_sprint
-Update a sprint's details.
-
-**Parameters:**
-- sprint_id (required): Sprint UUID
-- title, goal, start_date, end_date (optional)
+    update_sprint: `# update_sprint
+Update a sprint's details.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- title, goal, start_date, end_date (optional)
 - auto_deploy_on_completion, deploy_environment, deploy_version_bump (optional)`,
-    get_sprint: `# get_sprint
-Get a sprint with all its tasks organized by phase.
-
-**Parameters:**
-- sprint_id (required): Sprint UUID
-
+    get_sprint: `# get_sprint
+Get a sprint with all its tasks organized by phase.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+
 **Returns:** Sprint with progress percentage, velocity points, committed points.`,
-    get_sprints: `# get_sprints
-List sprints for a project with velocity metrics.
-
-**Parameters:**
-- project_id (required): Project UUID
-- status (optional): planning, active, in_review, retrospective, completed, cancelled
+    get_sprints: `# get_sprints
+List sprints for a project with velocity metrics.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): planning, active, in_review, retrospective, completed, cancelled
 - limit (optional): Max sprints (default 20)`,
-    delete_sprint: `# delete_sprint
-Delete a sprint. Tasks are preserved but no longer grouped.
-
-**Parameters:**
+    delete_sprint: `# delete_sprint
+Delete a sprint. Tasks are preserved but no longer grouped.
+
+**Parameters:**
 - sprint_id (required): Sprint UUID`,
-    start_sprint: `# start_sprint
-Start a sprint. Transitions from 'planning' to 'active'.
-
-**Parameters:**
-- sprint_id (required): Sprint UUID
-
+    start_sprint: `# start_sprint
+Start a sprint. Transitions from 'planning' to 'active'.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+
 **Note:** Locks committed_points at current total story points.`,
-    complete_sprint: `# complete_sprint
-Complete a sprint. Handles retrospective phase and auto-deployment.
-
-**Parameters:**
-- sprint_id (required): Sprint UUID
-- retrospective_notes (optional): Sprint retrospective notes
+    complete_sprint: `# complete_sprint
+Complete a sprint. Handles retrospective phase and auto-deployment.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- retrospective_notes (optional): Sprint retrospective notes
 - skip_retrospective (optional): Skip retrospective phase (default: false)`,
-    add_task_to_sprint: `# add_task_to_sprint
-Add a task to a sprint with optional story points.
-
-**Parameters:**
-- sprint_id (required): Sprint UUID
-- task_id (required): Task UUID to add
-- story_points (optional): Story point estimate
+    add_task_to_sprint: `# add_task_to_sprint
+Add a task to a sprint with optional story points.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- task_id (required): Task UUID to add
+- story_points (optional): Story point estimate
 - phase (optional): pre, core, or post (default: core)`,
-    remove_task_from_sprint: `# remove_task_from_sprint
-Remove a task from a sprint.
-
-**Parameters:**
-- sprint_id (required): Sprint UUID
-- task_id (required): Task UUID to remove
-
+    remove_task_from_sprint: `# remove_task_from_sprint
+Remove a task from a sprint.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- task_id (required): Task UUID to remove
+
 **Note:** Task returns to backlog.`,
-    get_sprint_backlog: `# get_sprint_backlog
-Get tasks that can be added to a sprint.
-
-**Parameters:**
-- project_id (required): Project UUID
-- sprint_id (optional): Exclude tasks already in this sprint
-
+    get_sprint_backlog: `# get_sprint_backlog
+Get tasks that can be added to a sprint.
+
+**Parameters:**
+- project_id (required): Project UUID
+- sprint_id (optional): Exclude tasks already in this sprint
+
 **Returns:** Tasks not assigned to any body of work or sprint.`,
-    get_sprint_velocity: `# get_sprint_velocity
-Get velocity metrics for completed sprints.
-
-**Parameters:**
-- project_id (required): Project UUID
-- limit (optional): Number of sprints to analyze (default 10)
-
+    get_sprint_velocity: `# get_sprint_velocity
+Get velocity metrics for completed sprints.
+
+**Parameters:**
+- project_id (required): Project UUID
+- limit (optional): Number of sprints to analyze (default 10)
+
 **Returns:** Committed vs completed points, average velocity.`,
     // Git issues
-    add_git_issue: `# add_git_issue
-Record a git-related issue (merge conflict, push failure, etc.).
-
-**Parameters:**
-- project_id (required): Project UUID
-- issue_type (required): merge_conflict, push_failed, rebase_needed, branch_diverged, pr_not_mergeable
-- branch (required): Branch where the issue occurred
+    add_git_issue: `# add_git_issue
+Record a git-related issue (merge conflict, push failure, etc.).
+
+**Parameters:**
+- project_id (required): Project UUID
+- issue_type (required): merge_conflict, push_failed, rebase_needed, branch_diverged, pr_not_mergeable
+- branch (required): Branch where the issue occurred
 - target_branch, conflicting_files, error_message, pr_url, task_id (optional)`,
-    resolve_git_issue: `# resolve_git_issue
-Mark a git issue as resolved.
-
-**Parameters:**
-- git_issue_id (required): Git issue UUID
-- resolution_note (optional): How the issue was resolved
+    resolve_git_issue: `# resolve_git_issue
+Mark a git issue as resolved.
+
+**Parameters:**
+- git_issue_id (required): Git issue UUID
+- resolution_note (optional): How the issue was resolved
 - auto_resolved (optional): Whether auto-resolved`,
-    get_git_issues: `# get_git_issues
-Get git issues for a project.
-
-**Parameters:**
-- project_id (required): Project UUID
-- status (optional): open or resolved (default: open)
-- issue_type (optional): Filter by issue type
-- branch (optional): Filter by branch
+    get_git_issues: `# get_git_issues
+Get git issues for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): open or resolved (default: open)
+- issue_type (optional): Filter by issue type
+- branch (optional): Filter by branch
 - limit (optional): Max issues (default 50)`,
-    delete_git_issue: `# delete_git_issue
-Delete a git issue.
-
-**Parameters:**
+    delete_git_issue: `# delete_git_issue
+Delete a git issue.
+
+**Parameters:**
 - git_issue_id (required): Git issue UUID`,
     // Deployment requirements
-    add_deployment_requirement: `# add_deployment_requirement
-Add a pre-deployment requirement.
-
-**Parameters:**
-- project_id (required): Project UUID
-- type (required): migration, env_var, config, manual, breaking_change, agent_task
-- title (required): Brief description
-- description (optional): Detailed instructions
-- stage (optional): preparation, deployment, or verification (default: preparation)
-- file_path (optional): File path reference
+    add_deployment_requirement: `# add_deployment_requirement
+Add a pre-deployment requirement.
+
+**Parameters:**
+- project_id (required): Project UUID
+- type (required): migration, env_var, config, manual, breaking_change, agent_task
+- title (required): Brief description
+- description (optional): Detailed instructions
+- stage (optional): preparation, deployment, or verification (default: preparation)
+- file_path (optional): File path reference
 - blocking (optional): Whether converted task blocks other work`,
-    complete_deployment_requirement: `# complete_deployment_requirement
-Mark a deployment requirement as completed.
-
-**Parameters:**
+    complete_deployment_requirement: `# complete_deployment_requirement
+Mark a deployment requirement as completed.
+
+**Parameters:**
 - requirement_id (required): Requirement UUID`,
-    get_deployment_requirements: `# get_deployment_requirements
-Get pending deployment requirements.
-
-**Parameters:**
-- project_id (required): Project UUID
-- stage (optional): preparation, deployment, verification, or all
+    get_deployment_requirements: `# get_deployment_requirements
+Get pending deployment requirements.
+
+**Parameters:**
+- project_id (required): Project UUID
+- stage (optional): preparation, deployment, verification, or all
 - status (optional): pending, completed, converted_to_task, or all (default: pending)`,
-    reorder_deployment_requirements: `# reorder_deployment_requirements
-Reorder deployment requirements within a stage.
-
-**Parameters:**
-- project_id (required): Project UUID
-- stage (required): preparation, deployment, or verification
+    reorder_deployment_requirements: `# reorder_deployment_requirements
+Reorder deployment requirements within a stage.
+
+**Parameters:**
+- project_id (required): Project UUID
+- stage (required): preparation, deployment, or verification
 - requirement_ids (required): Array of requirement UUIDs in desired order`,
     // Knowledge base
-    query_knowledge_base: `# query_knowledge_base
-Query aggregated project knowledge in a single call. Reduces token usage by combining multiple data sources.
-
-**Parameters:**
-- project_id (required): Project UUID
-- scope: 'summary' (default) or 'detailed' (includes rationales, descriptions)
-- categories: Array of categories to include (default: all)
-  - findings: Audit findings (security, performance, code quality)
-  - qa: Questions and answers
-  - decisions: Architectural decisions
-  - completed_tasks: Tasks with completion summaries
-  - blockers: Resolved blockers with resolution notes
-  - progress: Recent progress logs
-- limit: Max items per category (default: 5, max: 20)
-- search_query: Optional text search across all knowledge
-
-**Returns:**
-- project: name, goal, tech_stack
-- stats: counts for each category, findings by severity
-- Category data based on selection
-
-**Token savings:** Replaces multiple tool calls (get_findings, get_decisions, get_blockers, etc.) with one call.
-
+    query_knowledge_base: `# query_knowledge_base
+Query aggregated project knowledge in a single call. Reduces token usage by combining multiple data sources.
+
+**Parameters:**
+- project_id (required): Project UUID
+- scope: 'summary' (default) or 'detailed' (includes rationales, descriptions)
+- categories: Array of categories to include (default: all)
+  - findings: Audit findings (security, performance, code quality)
+  - qa: Questions and answers
+  - decisions: Architectural decisions
+  - completed_tasks: Tasks with completion summaries
+  - blockers: Resolved blockers with resolution notes
+  - progress: Recent progress logs
+- limit: Max items per category (default: 5, max: 20)
+- search_query: Optional text search across all knowledge
+
+**Returns:**
+- project: name, goal, tech_stack
+- stats: counts for each category, findings by severity
+- Category data based on selection
+
+**Token savings:** Replaces multiple tool calls (get_findings, get_decisions, get_blockers, etc.) with one call.
+
 **Example:** query_knowledge_base(project_id, categories: ["findings", "decisions"], limit: 10)`,
     // Session tools (additional)
-    report_token_usage: `# report_token_usage
-Report actual token usage from Claude API responses.
-
-**Parameters:**
-- session_id (optional): Session UUID (uses current session if not provided)
-- input_tokens (required): Number of input tokens
-- output_tokens (required): Number of output tokens
-- model (optional): Model used (e.g., "claude-3-opus")
-
+    report_token_usage: `# report_token_usage
+Report actual token usage from Claude API responses.
+
+**Parameters:**
+- session_id (optional): Session UUID (uses current session if not provided)
+- input_tokens (required): Number of input tokens
+- output_tokens (required): Number of output tokens
+- model (optional): Model used (e.g., "claude-3-opus")
+
 **Returns:** Updated token usage summary`,
-    signal_idle: `# signal_idle
-Signal that the agent is idle and available for work.
-
-**Parameters:**
-- session_id (optional): Session UUID (uses current session if not provided)
-
+    signal_idle: `# signal_idle
+Signal that the agent is idle and available for work.
+
+**Parameters:**
+- session_id (optional): Session UUID (uses current session if not provided)
+
 **Returns:** Idle status confirmation, may include suggested activities`,
-    confirm_agent_setup: `# confirm_agent_setup
-Confirm that agent setup is complete after following setup instructions.
-
-**Parameters:**
-- project_id (required): Project UUID
-- agent_type (required): Type of agent (e.g., "claude", "gemini")
-
+    confirm_agent_setup: `# confirm_agent_setup
+Confirm that agent setup is complete after following setup instructions.
+
+**Parameters:**
+- project_id (required): Project UUID
+- agent_type (required): Type of agent (e.g., "claude", "gemini")
+
 **Returns:** Setup confirmation status`,
     // Project tools (additional)
-    get_project_summary: `# get_project_summary
-Get unified project statistics overview in a single call.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_project_summary: `# get_project_summary
+Get unified project statistics overview in a single call.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Task counts, blocker counts, finding counts, decision counts, and more`,
     // Blocker tools (additional)
-    get_blocker: `# get_blocker
-Get a single blocker by ID.
-
-**Parameters:**
-- blocker_id (required): Blocker UUID
-
+    get_blocker: `# get_blocker
+Get a single blocker by ID.
+
+**Parameters:**
+- blocker_id (required): Blocker UUID
+
 **Returns:** Blocker details including description, status, resolution`,
-    get_blockers_stats: `# get_blockers_stats
-Get aggregate blocker statistics.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_blockers_stats: `# get_blockers_stats
+Get aggregate blocker statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Open/resolved counts, breakdown by age`,
     // Decision tools (additional)
-    get_decision: `# get_decision
-Get a single decision by ID.
-
-**Parameters:**
-- decision_id (required): Decision UUID
-
+    get_decision: `# get_decision
+Get a single decision by ID.
+
+**Parameters:**
+- decision_id (required): Decision UUID
+
 **Returns:** Decision details including title, description, rationale`,
-    get_decisions_stats: `# get_decisions_stats
-Get aggregate decision statistics.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_decisions_stats: `# get_decisions_stats
+Get aggregate decision statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Total count, recent decisions count`,
     // Idea tools (additional)
-    get_idea: `# get_idea
-Get a single idea by ID.
-
-**Parameters:**
-- idea_id (required): Idea UUID
-
+    get_idea: `# get_idea
+Get a single idea by ID.
+
+**Parameters:**
+- idea_id (required): Idea UUID
+
 **Returns:** Idea details including title, description, status`,
     // Finding tools (additional)
-    get_finding: `# get_finding
-Get a single finding by ID.
-
-**Parameters:**
-- finding_id (required): Finding UUID
-
+    get_finding: `# get_finding
+Get a single finding by ID.
+
+**Parameters:**
+- finding_id (required): Finding UUID
+
 **Returns:** Finding details including title, category, severity, status`,
-    get_findings_stats: `# get_findings_stats
-Get aggregate finding statistics.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_findings_stats: `# get_findings_stats
+Get aggregate finding statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Counts by category, severity, and status`,
     // Deployment tools (additional)
-    get_deployment_requirements_stats: `# get_deployment_requirements_stats
-Get aggregate deployment requirement statistics.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_deployment_requirements_stats: `# get_deployment_requirements_stats
+Get aggregate deployment requirement statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Counts by stage and status`,
     // Worktree tools
-    get_stale_worktrees: `# get_stale_worktrees
-Find orphaned worktrees that need cleanup.
-
-**Parameters:**
-- project_id (required): Project UUID
-- hostname (optional): Filter to worktrees created on this machine
-
+    get_stale_worktrees: `# get_stale_worktrees
+Find orphaned worktrees that need cleanup.
+
+**Parameters:**
+- project_id (required): Project UUID
+- hostname (optional): Filter to worktrees created on this machine
+
 **Returns:** List of stale worktrees with task info and cleanup commands`,
-    clear_worktree_path: `# clear_worktree_path
-Clear worktree path from a task after cleanup.
-
-**Parameters:**
-- task_id (required): Task UUID
-
+    clear_worktree_path: `# clear_worktree_path
+Clear worktree path from a task after cleanup.
+
+**Parameters:**
+- task_id (required): Task UUID
+
 **Note:** Call this AFTER running git worktree remove`,
     // Role tools
-    get_role_settings: `# get_role_settings
-Get project role settings and configuration.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_role_settings: `# get_role_settings
+Get project role settings and configuration.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Role configuration including allowed roles, default role`,
-    update_role_settings: `# update_role_settings
-Configure project role behavior.
-
-**Parameters:**
-- project_id (required): Project UUID
-- default_role (optional): Default role for new sessions
-- allowed_roles (optional): Array of allowed role names
-
+    update_role_settings: `# update_role_settings
+Configure project role behavior.
+
+**Parameters:**
+- project_id (required): Project UUID
+- default_role (optional): Default role for new sessions
+- allowed_roles (optional): Array of allowed role names
+
 **Returns:** Updated role settings`,
-    set_session_role: `# set_session_role
-Set the role for the current session.
-
-**Parameters:**
-- session_id (optional): Session UUID (uses current session)
-- role (required): Role name (e.g., "developer", "validator", "deployer")
-
+    set_session_role: `# set_session_role
+Set the role for the current session.
+
+**Parameters:**
+- session_id (optional): Session UUID (uses current session)
+- role (required): Role name (e.g., "developer", "validator", "deployer")
+
 **Returns:** Updated session with new role`,
-    get_agents_by_role: `# get_agents_by_role
-List active agents grouped by role.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_agents_by_role: `# get_agents_by_role
+List active agents grouped by role.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Agents organized by role`,
     // File checkout/lock tools
-    checkout_file: `# checkout_file
-Lock a file for editing to prevent conflicts with other agents.
-
-**Parameters:**
-- project_id (required): Project UUID
-- file_path (required): Path to the file to lock
-- reason (optional): Why you need to edit this file
-
+    checkout_file: `# checkout_file
+Lock a file for editing to prevent conflicts with other agents.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to the file to lock
+- reason (optional): Why you need to edit this file
+
 **Returns:** Checkout confirmation with expiry time`,
-    checkin_file: `# checkin_file
-Release a file lock after editing.
-
-**Parameters:**
-- project_id (required): Project UUID
-- file_path (required): Path to the file to release
-
+    checkin_file: `# checkin_file
+Release a file lock after editing.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to the file to release
+
 **Returns:** Checkin confirmation`,
-    get_file_checkouts: `# get_file_checkouts
-List current file locks.
-
-**Parameters:**
-- project_id (required): Project UUID
-- file_path (optional): Filter to specific file
-
+    get_file_checkouts: `# get_file_checkouts
+List current file locks.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (optional): Filter to specific file
+
 **Returns:** List of active file checkouts`,
-    get_file_checkouts_stats: `# get_file_checkouts_stats
-Get file checkout statistics.
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_file_checkouts_stats: `# get_file_checkouts_stats
+Get file checkout statistics.
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Active checkout count, breakdown by agent`,
-    abandon_checkout: `# abandon_checkout
-Force-release a file lock (use with caution).
-
-**Parameters:**
-- project_id (required): Project UUID
-- file_path (required): Path to the file to release
-
+    abandon_checkout: `# abandon_checkout
+Force-release a file lock (use with caution).
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to the file to release
+
 **Note:** Only use when the original agent is unreachable`,
-    is_file_available: `# is_file_available
-Check if a file is available for checkout.
-
-**Parameters:**
-- project_id (required): Project UUID
-- file_path (required): Path to check
-
+    is_file_available: `# is_file_available
+Check if a file is available for checkout.
+
+**Parameters:**
+- project_id (required): Project UUID
+- file_path (required): Path to check
+
 **Returns:** Availability status, current holder if locked`,
     // Connector tools
-    get_connectors: `# get_connectors
-List project connectors (integrations).
-
-**Parameters:**
-- project_id (required): Project UUID
-
+    get_connectors: `# get_connectors
+List project connectors (integrations).
+
+**Parameters:**
+- project_id (required): Project UUID
+
 **Returns:** Array of configured connectors`,
-    get_connector: `# get_connector
-Get connector details.
-
-**Parameters:**
-- connector_id (required): Connector UUID
-
+    get_connector: `# get_connector
+Get connector details.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+
 **Returns:** Connector configuration and status`,
-    add_connector: `# add_connector
-Create a new external integration connector.
-
-**Parameters:**
-- project_id (required): Project UUID
-- type (required): Connector type (webhook, slack, discord, etc.)
-- name (required): Display name
-- config (required): Type-specific configuration
-
+    add_connector: `# add_connector
+Create a new external integration connector.
+
+**Parameters:**
+- project_id (required): Project UUID
+- type (required): Connector type (webhook, slack, discord, etc.)
+- name (required): Display name
+- config (required): Type-specific configuration
+
 **Returns:** Created connector details`,
-    update_connector: `# update_connector
-Update connector configuration.
-
-**Parameters:**
-- connector_id (required): Connector UUID
-- name (optional): New display name
-- config (optional): Updated configuration
-- enabled (optional): Enable/disable connector
-
+    update_connector: `# update_connector
+Update connector configuration.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+- name (optional): New display name
+- config (optional): Updated configuration
+- enabled (optional): Enable/disable connector
+
 **Returns:** Updated connector details`,
-    delete_connector: `# delete_connector
-Remove a connector.
-
-**Parameters:**
-- connector_id (required): Connector UUID
-
+    delete_connector: `# delete_connector
+Remove a connector.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+
 **Returns:** Deletion confirmation`,
-    test_connector: `# test_connector
-Send a test event to verify connector configuration.
-
-**Parameters:**
-- connector_id (required): Connector UUID
-
+    test_connector: `# test_connector
+Send a test event to verify connector configuration.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+
 **Returns:** Test result with success/failure details`,
-    get_connector_events: `# get_connector_events
-Get event history for a connector.
-
-**Parameters:**
-- connector_id (required): Connector UUID
-- limit (optional): Max events to return (default: 50)
-
+    get_connector_events: `# get_connector_events
+Get event history for a connector.
+
+**Parameters:**
+- connector_id (required): Connector UUID
+- limit (optional): Max events to return (default: 50)
+
 **Returns:** Array of sent events with status`,
     // Cloud agent tools
-    update_agent_status: `# update_agent_status
-Update your status message on the dashboard. Call this after start_work_session and whenever you start a new task.
-
-**Parameters:**
-- status_message (required): Status text shown on dashboard (e.g. "Working on: Task title")
-- agent_name (required): Your agent name
-- project_id (required): Project UUID
-
+    update_agent_status: `# update_agent_status
+Update your status message on the dashboard. Call this after start_work_session and whenever you start a new task.
+
+**Parameters:**
+- status_message (required): Status text shown on dashboard (e.g. "Working on: Task title")
+- agent_name (required): Your agent name
+- project_id (required): Project UUID
+
 **Example:** update_agent_status(status_message: "Working on: Progress Report Modal", agent_name: "Leon", project_id: "...")`,
-    cleanup_stale_cloud_agents: `# cleanup_stale_cloud_agents
-Clean up stale cloud agents that failed to start or lost connection.
-
-**Parameters:**
-- project_id (required): Project UUID
-- stale_minutes (optional): Minutes of inactivity before considered stale (default: 5)
-- include_running (optional): Include running agents in cleanup (default: false)
-- dry_run (optional): Preview what would be cleaned without actually cleaning (default: false)
-
-**Returns:**
-- cleaned: Number of agents cleaned up
-- failed: Number of cleanup failures
-- agents: Array of affected agents with status
-
+    cleanup_stale_cloud_agents: `# cleanup_stale_cloud_agents
+Clean up stale cloud agents that failed to start or lost connection.
+
+**Parameters:**
+- project_id (required): Project UUID
+- stale_minutes (optional): Minutes of inactivity before considered stale (default: 5)
+- include_running (optional): Include running agents in cleanup (default: false)
+- dry_run (optional): Preview what would be cleaned without actually cleaning (default: false)
+
+**Returns:**
+- cleaned: Number of agents cleaned up
+- failed: Number of cleanup failures
+- agents: Array of affected agents with status
+
 **Example:** cleanup_stale_cloud_agents(project_id, stale_minutes: 10, dry_run: true)`,
-    list_cloud_agents: `# list_cloud_agents
-List cloud agents for a project with optional status filter.
-
-**Parameters:**
-- project_id (required): Project UUID
-- status (optional): Filter by status - starting, running, stopped, failed, or all (default: all)
-
-**Returns:**
-- agents: Array of agents with id, name, status, created_at, last_heartbeat, public_ip, ecs_task_id
-- count: Total number of agents returned
-
+    list_cloud_agents: `# list_cloud_agents
+List cloud agents for a project with optional status filter.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): Filter by status - starting, running, stopped, failed, or all (default: all)
+
+**Returns:**
+- agents: Array of agents with id, name, status, created_at, last_heartbeat, public_ip, ecs_task_id
+- count: Total number of agents returned
+
 **Example:** list_cloud_agents(project_id, status: "running")`,
     // Chat tools
-    send_project_message: `# send_project_message
-Send a message to the project chat channel for agent and user communication.
-
-**Parameters:**
-- project_id (required): Project UUID
-- message (required): Message content to send
-- author_name (optional): Name of the message sender (defaults to session persona)
-
-**Returns:**
-- message_id: UUID of the sent message
-- timestamp: When the message was sent
-
+    send_project_message: `# send_project_message
+Send a message to the project chat channel for agent and user communication.
+
+**Parameters:**
+- project_id (required): Project UUID
+- message (required): Message content to send
+- author_name (optional): Name of the message sender (defaults to session persona)
+
+**Returns:**
+- message_id: UUID of the sent message
+- timestamp: When the message was sent
+
 **Example:** send_project_message(project_id: "123e4567-e89b-12d3-a456-426614174000", message: "Deployment completed successfully")`,
-    get_project_messages: `# get_project_messages
-Read recent project chat messages to stay informed about project communication.
-
-**Parameters:**
-- project_id (required): Project UUID
-- limit (optional): Number of recent messages to retrieve (default: 20, max: 100)
-- since (optional): ISO timestamp to get messages after this time
-
-**Returns:**
-- messages: Array of messages with id, author_name, message, timestamp
-- count: Number of messages returned
-
+    get_project_messages: `# get_project_messages
+Read recent project chat messages to stay informed about project communication.
+
+**Parameters:**
+- project_id (required): Project UUID
+- limit (optional): Number of recent messages to retrieve (default: 20, max: 100)
+- since (optional): ISO timestamp to get messages after this time
+
+**Returns:**
+- messages: Array of messages with id, author_name, message, timestamp
+- count: Number of messages returned
+
 **Example:** get_project_messages(project_id: "123e4567-e89b-12d3-a456-426614174000", limit: 10)`,
     // Version management tools  
-    check_mcp_version: `# check_mcp_version
-Check for available MCP server updates and version information.
-
-**Parameters:**
-- check_remote (optional): Whether to check remote registry for updates (default: true)
-
-**Returns:**
-- current_version: Currently running MCP server version
-- latest_version: Latest available version (if check_remote is true)
-- update_available: Boolean indicating if an update is available
-- release_notes: Summary of changes in latest version (if available)
-
+    check_mcp_version: `# check_mcp_version
+Check for available MCP server updates and version information.
+
+**Parameters:**
+- check_remote (optional): Whether to check remote registry for updates (default: true)
+
+**Returns:**
+- current_version: Currently running MCP server version
+- latest_version: Latest available version (if check_remote is true)
+- update_available: Boolean indicating if an update is available
+- release_notes: Summary of changes in latest version (if available)
+
 **Example:** check_mcp_version(check_remote: true)`,
-    update_mcp_server: `# update_mcp_server
-Self-update the MCP server to the latest available version.
-
-**Parameters:**
-- version (optional): Specific version to update to (defaults to latest)
-- restart_after_update (optional): Whether to restart after update (default: true)
-- backup_config (optional): Whether to backup current config (default: true)
-
-**Returns:**
-- success: Boolean indicating if update succeeded
-- old_version: Previous version before update
-- new_version: Version after update
-- restart_required: Whether manual restart is needed
-
-**Example:** update_mcp_server()
-
+    update_mcp_server: `# update_mcp_server
+Self-update the MCP server to the latest available version.
+
+**Parameters:**
+- version (optional): Specific version to update to (defaults to latest)
+- restart_after_update (optional): Whether to restart after update (default: true)
+- backup_config (optional): Whether to backup current config (default: true)
+
+**Returns:**
+- success: Boolean indicating if update succeeded
+- old_version: Previous version before update
+- new_version: Version after update
+- restart_required: Whether manual restart is needed
+
+**Example:** update_mcp_server()
+
 **Note:** This operation may temporarily disconnect active sessions during restart.`,
+    add_feature: `# add_feature
+Create a draft feature spec. Features sit between ideas (quick thoughts) and tasks (actionable work).
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Feature title (max 200 chars)
+- body (optional): Markdown spec content — requirements, user stories, acceptance criteria, technical approach
+- priority (optional): Priority 1-5 (1 = highest, default: 2)
+
+**Returns:** Created feature object with id, status ('draft'), and timestamps.
+
+**Example:** add_feature(project_id, title: "Dark mode support", body: "## Goal\\nAdd dark mode toggle...")`,
+    update_feature: `# update_feature
+Update feature details, status, or priority.
+
+**Parameters:**
+- feature_id (required): Feature UUID
+- title (optional): Updated title
+- body (optional): Updated markdown spec content
+- status (optional): New status — draft → refining → specced → ready → building → shipped
+- priority (optional): Priority 1-5 (1 = highest)
+
+**Returns:** Updated feature object.
+
+**Example:** update_feature(feature_id, status: "specced")`,
+    get_feature: `# get_feature
+Get a single feature by ID.
+
+**Parameters:**
+- feature_id (required): Feature UUID
+
+**Returns:** Full feature object including title, body, status, priority, and timestamps.
+
+**Example:** get_feature(feature_id: "abc-123")`,
+    get_features: `# get_features
+List features for a project, optionally filtered by status.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): Filter by status — draft, refining, specced, ready, building, shipped
+- limit (optional): Max results (default: 50, max: 500)
+- offset (optional): Pagination offset (default: 0)
+- search_query (optional): Search by title or body content
+
+**Returns:** Array of feature objects with pagination metadata.
+
+**Example:** get_features(project_id, status: "specced")`,
+    delete_feature: `# delete_feature
+Delete a feature permanently.
+
+**Parameters:**
+- feature_id (required): Feature UUID
+
+**Returns:** Confirmation of deletion.
+
+**Example:** delete_feature(feature_id: "abc-123")`,
+    link_idea_to_feature: `# link_idea_to_feature
+Link an existing idea to a feature spec, creating a traceable connection.
+
+**Parameters:**
+- feature_id (required): Feature UUID
+- idea_id (required): Idea UUID to link
+
+**Returns:** Confirmation of the link creation.
+
+**Example:** link_idea_to_feature(feature_id: "abc-123", idea_id: "def-456")`,
 };