@agllama/mcp 0.6.25 → 0.7.0

package/dist/tools/help.js

@@ -5,40 +5,55 @@ export const helpToolSchema = z.object({
     topic: z
         .string()
         .optional()
-        .describe('Optional: tool name (e.g., "llama_create_issue") or category (e.g., "issues", "sprints")'),
+        .describe('Optional: tool name (e.g., "llama_create_issue") or category (e.g., "issues", "skills", "agents", "prompts")'),
 });
-// Tool documentation organized by category
 const TOOL_DOCS = {
     overview: {
         title: 'Llama MCP Tools Overview',
-        description: `Llama MCP provides 52 tools for project management. Use llama_help with a topic for details.
+        description: `Llama MCP exposes 87 tools for AI-driven project management. Use llama_help with a topic for details.
 
-**Quick Start:**
-1. llama_connect - Test your API connection
-2. llama_context - Get project snapshot (statuses, sprints, team, backlog)
-3. Use other tools with IDs from context
+**First-time setup (recommended):**
+1. llama_connect — verify auth. If the response includes \`firstTimeHint\`, the account has no projects — offer the Getting Started Pack.
+2. llama_set_context { orgSlug, projectKey } — set defaults so you don't repeat them.
+3. llama_context — full project snapshot (statuses, sprints, team, backlog).
 
-**Categories:** context, session, organizations, projects, issues, sprints, boards, backlog, comments, labels, members, links, search, plans, skills, errors, decomposition
+**Getting Started Pack:** llama_install_getting_started_pack installs 4 core skills + a board template in one step. Call once with no \`confirm\` to preview, then again with \`confirm: true\` after the user approves.
+
+**Categories:** context, session, onboarding, organizations, projects, issues, status, sprints, boards, backlog, comments, labels, members, links, search, plans, skills, agents, prompts, attachments, refinement, roadmap, rollup, errors, notifications, import, patterns
 
 **Examples:**
-- llama_help { topic: "issues" } - Learn about issue tools
-- llama_help { topic: "llama_create_issue" } - Details for a specific tool`,
+- llama_help { topic: "issues" } — list issue tools
+- llama_help { topic: "skills" } — skills + agents + prompts overview
+- llama_help { topic: "llama_create_issue" } — details for a specific tool
+- llama_help { topic: "patterns" } — common multi-tool flows`,
     },
     context: {
         title: 'Context Tools',
         tools: [
             {
                 name: 'llama_connect',
-                description: 'Test API connection and get current user info',
+                description: 'Test API connection and get current user info. Includes a firstTimeHint when the account has no projects.',
                 params: 'None',
-                use: 'Starting a session to verify authentication',
+                use: 'Starting a session to verify authentication. Watch for `firstTimeHint` in the response — that means the user is brand new and the Getting Started Pack should be offered.',
             },
             {
                 name: 'llama_context',
-                description: 'Get complete project snapshot: workflow statuses, sprints, backlog, team',
-                params: 'orgSlug (required), projectKey (required)',
-                use: 'Before creating/updating issues to get valid IDs',
-                returns: 'Project info, org info, workflow statuses, active sprint, pending sprints, backlog (first 50), team members',
+                description: 'Get complete project snapshot: workflow statuses, sprints, backlog, team. Use llama_set_context first to make orgSlug/projectKey optional.',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default), compact (optional)',
+                use: 'Before creating/updating issues to get valid status IDs, sprint IDs, and assignee IDs',
+                returns: 'Project info, org info, workflow statuses, active sprint with issues, pending sprints, backlog (first 50), team members',
+            },
+            {
+                name: 'llama_help',
+                description: 'This tool. Returns categorized docs.',
+                params: 'topic (optional)',
+                use: 'When you forget how to use a tool',
+            },
+            {
+                name: 'llama_get_user_docs',
+                description: 'Fetch full AG-Llama user documentation (quickstart + user guide).',
+                params: 'None',
+                use: 'Answering user questions about AG-Llama features, AI automation, MCP usage',
             },
         ],
     },
@@ -62,7 +77,7 @@ const TOOL_DOCS = {
             {
                 name: 'llama_save_state',
                 description: 'Checkpoint your execution state. State is replaced (not merged) on each call. Returned by llama_resume.',
-                params: 'currentIssueKey (optional), currentPhase (optional: planning|coding|review|testing|custom), storyQueue (optional: array of issue keys), completedStories (optional: array), workflowId (optional), workflowStep (optional), notes (optional: max 2000 chars)',
+                params: 'currentIssueKey (optional), currentPhase (optional: planning|coding|review|testing|custom), storyQueue (optional), completedStories (optional), workflowId (optional), workflowStep (optional), notes (optional: max 2000 chars)',
                 use: 'Call when starting a story, changing phases, completing work, or before any pause',
                 example: `{
   "currentIssueKey": "PROJ-42",
@@ -72,6 +87,42 @@ const TOOL_DOCS = {
   "notes": "Backend done, working on frontend component"
 }`,
             },
+            {
+                name: 'llama_list_sessions',
+                description: 'List active sessions for the current user',
+                params: 'None',
+                use: 'Check what other sessions exist before deleting',
+            },
+            {
+                name: 'llama_delete_session',
+                description: 'Delete a specific session by ID, or all of the current user\'s sessions',
+                params: 'sessionId (optional — omit to delete all)',
+                use: 'Clean up stale sessions',
+            },
+            {
+                name: 'llama_update_claude_session_notes',
+                description: 'Append durable notes to the current session — surfaced on next llama_resume',
+                params: 'notes (required: string, max 4000 chars)',
+                use: 'Capture in-flight work, blockers, or decisions before /clear so they survive into the next session',
+            },
+        ],
+    },
+    onboarding: {
+        title: 'Onboarding — Getting Started Pack',
+        description: 'New project or new user? Install the Getting Started Pack to get a working baseline in one step: 4 core Claude skills + a configured board.',
+        tools: [
+            {
+                name: 'llama_install_getting_started_pack',
+                description: 'Install the Getting Started Pack into a project. Two-step UX — preview first, then confirm.',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default), confirm (optional, default false)',
+                use: 'Call without confirm to preview. Show the user the preview and ask for approval. Call again with confirm=true only after they say yes. After install, write each SKILL.md file to .claude/skills/<id>/SKILL.md and tell the user to run /getting-started-walkthrough.',
+                returns: 'Step 1 (preview): requiresConfirmation=true, preview, warning. Step 2 (confirmed): skill manifest with file paths and markdown content.',
+                example: `// Step 1 — preview
+{ "orgSlug": "my-team", "projectKey": "PROJ" }
+
+// Step 2 — install (after user approves preview)
+{ "orgSlug": "my-team", "projectKey": "PROJ", "confirm": true }`,
+            },
         ],
     },
     organizations: {
@@ -133,7 +184,7 @@ Optional: description, priority (CRITICAL|HIGH|MEDIUM|LOW|TRIVIAL), assigneeId,
             },
             {
                 name: 'llama_update_issue',
-                description: 'Update issue fields. Only include fields to change. Set assigneeId/sprintId to null to unassign.',
+                description: 'Update issue fields. Only include fields to change. Set assigneeId/sprintId to null to unassign. Set statusId to transition status.',
                 params: `orgSlug (required), projectKey (required), issueKey (required)
 Optional: summary, description, type, priority, statusId, assigneeId, sprintId, estimate, labels`,
             },
@@ -142,6 +193,30 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 description: 'Soft-delete an issue (can be restored)',
                 params: 'orgSlug (required), projectKey (required), issueKey (required)',
             },
+            {
+                name: 'llama_batch_create_issues',
+                description: 'Create up to 50 issues in one call. Returns issueKeys for each created issue.',
+                params: 'orgSlug (required), projectKey (required), issues (required: array of issue objects)',
+                use: 'Bulk story creation from a plan, importing checklists',
+            },
+            {
+                name: 'llama_batch_update_issues',
+                description: 'Update up to 50 issues in one call.',
+                params: 'updates (required: array of {issueKey, ...fields})',
+                use: 'Bulk reassignment, status sweeps, sprint reshuffles',
+            },
+        ],
+    },
+    status: {
+        title: 'Workflow Status Tools',
+        description: 'Add or remove statuses (board columns) in a project workflow. Statuses are referenced by ID in llama_update_issue.',
+        tools: [
+            {
+                name: 'llama_manage_status',
+                description: 'Add or delete a workflow status (board column)',
+                params: 'action (required: add|delete), orgSlug (required), projectKey (required), workflowId (required), name/category/color (for add), statusId (for delete)',
+                use: 'Use llama_context to get workflowId first',
+            },
         ],
     },
     sprints: {
@@ -172,10 +247,22 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 description: 'Complete an active sprint',
                 params: 'sprintId (required), moveIncompleteToBacklog (optional: default true), moveIncompleteToSprintId (optional)',
             },
+            {
+                name: 'llama_reopen_sprint',
+                description: 'Reopen a completed sprint',
+                params: 'sprintId (required)',
+                use: 'Recover from accidental sprint completion',
+            },
             {
                 name: 'llama_update_sprint',
-                description: 'Update sprint name, goal, or dates',
-                params: 'sprintId (required), name (optional), goal (optional), startDate (optional), endDate (optional)',
+                description: 'Update sprint name, goal, or AI completion instructions',
+                params: 'sprintId (required), name (optional), goal (optional), aiCompletionInstructions (optional)',
+            },
+            {
+                name: 'llama_override_sprint_dates',
+                description: 'Override sprint start or end date directly (bypasses the start/complete state machine)',
+                params: 'sprintId (required), startDate (optional), endDate (optional)',
+                use: 'Fix incorrect dates without changing sprint state',
             },
             {
                 name: 'llama_delete_sprint',
@@ -187,6 +274,21 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 description: 'Move issues to a sprint. Pass null for sprintId to move to backlog.',
                 params: 'orgSlug (required), projectKey (required), issueKeys (required: array, max 20), sprintId (required: sprint ID or null for backlog)',
             },
+            {
+                name: 'llama_reorder_sprint',
+                description: 'Reorder issues within a sprint',
+                params: 'sprintId (required), issueKeys (required: array in desired order)',
+            },
+            {
+                name: 'llama_get_sprint_analytics',
+                description: 'Get burndown, completion %, and velocity for a sprint',
+                params: 'sprintId (required)',
+            },
+            {
+                name: 'llama_get_velocity',
+                description: 'Get team velocity (avg points/sprint) over recent sprints',
+                params: 'orgSlug (required), projectKey (required), sprintCount (optional: default 5)',
+            },
         ],
     },
     boards: {
@@ -209,7 +311,7 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
             },
             {
                 name: 'llama_get_board_config',
-                description: 'Get full board configuration including all column AI settings',
+                description: 'Get full board config including all column AI settings',
                 params: 'orgSlug (required), projectKey (required)',
                 use: 'View AI agent configurations for all board columns',
             },
@@ -219,6 +321,21 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 params: 'boardId (required), columnId (required), aiEnabled (optional), agentType (optional), instructions (optional), requiredActions (optional), contextHints (optional), color (optional), icon (optional)',
                 use: 'Configure AI behavior for specific board columns',
             },
+            {
+                name: 'llama_list_board_templates',
+                description: 'List available board templates with their column AI configs',
+                params: 'None',
+            },
+            {
+                name: 'llama_apply_board_template',
+                description: 'Apply a template to set up a board with pre-configured AI columns',
+                params: 'orgSlug (required), projectKey (required), boardId (required), templateId (required)',
+            },
+            {
+                name: 'llama_clone_board_config',
+                description: 'Clone full workflow + board config (statuses, transitions, columns, AI) from one project to another',
+                params: 'sourceOrgSlug (required), sourceProjectKey (required), targetOrgSlug (required), targetProjectKey (required)',
+            },
         ],
     },
     backlog: {
@@ -230,6 +347,11 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 params: 'orgSlug (required), projectKey (required)',
                 returns: 'Total count, breakdown by type, issue list',
             },
+            {
+                name: 'llama_reorder_backlog',
+                description: 'Reorder issues in the backlog',
+                params: 'orgSlug (required), projectKey (required), issueKeys (required: array in desired order)',
+            },
         ],
     },
     comments: {
@@ -239,7 +361,7 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 name: 'llama_manage_comment',
                 description: 'List, add, update, or delete comments on issues or plans',
                 params: 'action (required: list|add|update|delete), target (optional: issue|plan, default issue), issueKey (for issues), planId (for plans), commentId (for update/delete), content (for add/update)',
-                use: 'Manage comments on both issues and plans with a single tool',
+                use: 'Single tool for all comment operations on both issues and plans',
             },
         ],
     },
@@ -252,14 +374,9 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
                 params: 'orgSlug (required), projectKey (required)',
             },
             {
-                name: 'llama_create_label',
-                description: 'Create a new label',
-                params: 'orgSlug (required), projectKey (required), name (required), color (required: hex e.g., "#ff0000"), description (optional)',
-            },
-            {
-                name: 'llama_delete_label',
-                description: 'Delete a label (removes from all issues)',
-                params: 'orgSlug (required), projectKey (required), labelName (required)',
+                name: 'llama_manage_label',
+                description: 'Create or delete a project label. Delete removes from all issues.',
+                params: 'action (required: create|delete), orgSlug (required), projectKey (required), name (for create), color (for create: hex), description (optional), labelName (for delete)',
             },
         ],
     },
@@ -281,7 +398,7 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
         ],
     },
     links: {
-        title: 'Issue Link Tools',
+        title: 'Issue & Plan Link Tools',
         tools: [
             {
                 name: 'llama_manage_issue_link',
@@ -291,7 +408,7 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
             },
             {
                 name: 'llama_batch_link_issues',
-                description: 'Create multiple issue links in one call (max 50). More efficient for bulk operations.',
+                description: 'Create multiple issue links in one call (max 50)',
                 params: 'links (required: array of {sourceIssueKey, targetIssueKey, type})',
                 example: `{
   "links": [
@@ -301,6 +418,12 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
 }`,
                 use: 'Linking multiple stories to an EPIC, setting up dependency chains',
             },
+            {
+                name: 'llama_manage_plan_link',
+                description: 'Create or delete a link between an issue and a plan',
+                params: 'action (required: create|delete), issueKey (required), planId (for create), linkId (for delete)',
+                use: 'Tie implementation issues back to the plan they came from',
+            },
         ],
     },
     search: {
@@ -319,156 +442,419 @@ Optional: summary, description, type, priority, statusId, assigneeId, sprintId,
             },
         ],
     },
-    // documents - disabled (feature not ready yet)
-    // To re-enable, uncomment this block and the corresponding tools in server.ts
+    plans: {
+        title: 'Plan Tools',
+        description: 'Plans are markdown pages for product specs, PRDs, and roadmaps. Project-scoped, folder-organized, link to issues.',
+        tools: [
+            {
+                name: 'llama_list_plans',
+                description: 'List plans in a project (supports folder + search filters)',
+                params: 'orgSlug (required), projectKey (required), folderId (optional), search (optional)',
+            },
+            {
+                name: 'llama_get_plan',
+                description: 'Get a plan by ID with full content + linked issues',
+                params: 'orgSlug (required), projectKey (required), planId (required)',
+            },
+            {
+                name: 'llama_get_plan_tree',
+                description: 'Get a plan and its sub-plans recursively',
+                params: 'orgSlug (required), projectKey (required), planId (required)',
+            },
+            {
+                name: 'llama_create_plan',
+                description: 'Create a new plan',
+                params: 'orgSlug (required), projectKey (required), title (required), content (required: markdown), folderId (optional), parentPlanId (optional)',
+            },
+            {
+                name: 'llama_update_plan',
+                description: 'Update a plan\'s title, content, or folder',
+                params: 'planId (required), title (optional), content (optional), folderId (optional)',
+            },
+            {
+                name: 'llama_delete_plan',
+                description: 'Soft-delete a plan',
+                params: 'planId (required)',
+            },
+            {
+                name: 'llama_create_plan_folder',
+                description: 'Create a folder for organizing plans',
+                params: 'orgSlug (required), projectKey (required), name (required), parentFolderId (optional)',
+            },
+            {
+                name: 'llama_delete_plan_folder',
+                description: 'Delete a plan folder and its contents',
+                params: 'orgSlug (required), projectKey (required), folderId (required)',
+            },
+        ],
+    },
     skills: {
         title: 'Skill Tools',
-        description: 'Reusable Claude skills (procedures) that can be installed and executed with parameters.',
+        description: 'Skills are reusable Claude procedures (markdown SKILL.md files with optional parameters and triggers). Scopes: project | organization | personal. Install copies a skill into the project.',
         tools: [
             {
                 name: 'llama_list_skills',
-                description: 'List available skills (project-level and org-level)',
+                description: 'List skills (project-level + inherited org-level)',
                 params: 'orgSlug (required), projectKey (required), includeHidden (optional)',
             },
             {
                 name: 'llama_get_skill',
-                description: 'Get skill details including content and parameters',
+                description: 'Get skill content and parameters',
                 params: 'orgSlug (required), projectKey (required), skillId (required)',
             },
             {
                 name: 'llama_create_skill',
-                description: 'Create a new Claude skill (reusable procedure)',
+                description: 'Create a new skill',
                 params: 'orgSlug (required), name (required), content (required), scope (optional: project|organization|personal), projectKey (optional), description (optional), parameters (optional: JSON array), triggers (optional: comma-separated), isEnabled (optional)',
             },
             {
                 name: 'llama_update_skill',
-                description: 'Update an existing skill',
+                description: 'Update a skill. Change scope to promote/demote between project and org.',
                 params: 'orgSlug (required), skillId (required), projectKey (optional), name (optional), description (optional), content (optional), parameters (optional), triggers (optional), isEnabled (optional), scope (optional)',
             },
             {
                 name: 'llama_set_skill_visibility',
-                description: 'Hide or unhide a skill at user or project level',
+                description: 'Hide or unhide a skill for the user or the whole project. Works for agents too.',
                 params: 'orgSlug (required), projectKey (required), skillId (required), action (required: hide|unhide), scope (required: user|project)',
             },
             {
                 name: 'llama_install_skill',
-                description: 'Install a skill from the skill library into the current project',
+                description: 'Install a skill from the library into the current project. Returns markdown for the SKILL.md file.',
                 params: 'skillId (required), orgSlug (optional), projectKey (optional — omit to use org-level endpoint)',
                 returns: 'slug, filename, and markdown content of the installed skill',
             },
         ],
     },
-    onboarding: {
-        title: 'Onboarding Tools',
-        description: 'Set up a new project with the Getting Started Pack — 4 core skills + board configuration in one step.',
+    agents: {
+        title: 'Agent Tools',
+        description: 'Agents are sub-agents with a custom system prompt and config (model, allowed tools). Stored alongside skills in the same library; the API filters by type. Install writes a frontmatter markdown file to ~/.claude/agents/.',
         tools: [
             {
-                name: 'llama_install_getting_started_pack',
-                description: 'Install the Getting Started Pack (4 skills + board config). Two-step: preview first, then confirm.',
-                params: 'orgSlug (optional, session default), projectKey (optional, session default), confirm (optional, default false)',
-                use: 'Call without confirm to preview. Call with confirm=true only after the user approves. After install, write SKILL.md files to .claude/skills/<id>/SKILL.md and tell the user to run /getting-started-walkthrough.',
-                returns: 'Step 1 (preview): requiresConfirmation=true, preview, warning. Step 2 (confirmed): skill manifest with file paths to write.',
+                name: 'llama_list_agents',
+                description: 'List agents (project-level + inherited org-level). Returns only records with type="agent".',
+                params: 'orgSlug (required), projectKey (optional), includeHidden (optional)',
+            },
+            {
+                name: 'llama_get_agent',
+                description: 'Get agent system prompt and config. Use llama_get_skill if you have a skill ID.',
+                params: 'orgSlug (required), agentId (required), projectKey (optional)',
+            },
+            {
+                name: 'llama_create_agent',
+                description: 'Create a new agent (sub-agent definition with system prompt + config)',
+                params: 'orgSlug (required), name (required), content (required: system prompt), scope (optional: project|organization|personal), projectKey (optional), description (optional), config (optional: {model, tools, color, etc.}), triggers (optional), isEnabled (optional)',
+            },
+            {
+                name: 'llama_update_agent',
+                description: 'Update an agent. Patch name/description/content/config/scope.',
+                params: 'orgSlug (required), agentId (required), projectKey (optional), name (optional), description (optional), content (optional), config (optional), triggers (optional), isEnabled (optional), scope (optional)',
+            },
+            {
+                name: 'llama_install_agent',
+                description: 'Install an agent into ~/.claude/agents/. Returns frontmatter markdown ready to write to disk.',
+                params: 'agentId (required), orgSlug (optional), projectKey (optional)',
+                returns: 'filename and markdown content of the installed agent',
             },
         ],
     },
-    errors: {
-        title: 'Error Inbox Tools',
-        description: 'Manage errors reported by external systems. Accept errors to create BUG issues, or dismiss them.',
+    prompts: {
+        title: 'Prompt Tools',
+        description: 'Prompts are reusable markdown payloads with no parameters or triggers — Claude executes them verbatim. Scopes: organization | project | personal (resolution priority: personal > project > organization).',
         tools: [
             {
-                name: 'llama_list_errors',
-                description: 'List errors from the Error Inbox with filtering and sorting',
-                params: 'orgSlug (optional), projectKey (optional), status (optional: PENDING|ACCEPTED|DISMISSED), sortBy (optional: createdAt|lastSeenAt|occurrenceCount), sortOrder (optional: asc|desc), page (optional), limit (optional)',
-                use: 'Triage incoming errors before accepting or dismissing',
+                name: 'llama_run_prompt',
+                description: 'Fetch a prompt and return its markdown content for immediate execution',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default), promptId (uuid) OR name (one is required)',
+                returns: 'Markdown content the model should follow as instructions',
+            },
+            {
+                name: 'llama_list_prompts',
+                description: 'List prompts visible in the current scope. Returns summaries without content.',
+                params: 'orgSlug (optional), projectKey (optional), scope (optional: organization|project|personal), folderId (optional), search (optional), includeHidden (optional)',
+            },
+            {
+                name: 'llama_create_prompt',
+                description: 'Create a new prompt',
+                params: 'orgSlug (optional), projectKey (when scope=project), scope (required: organization|project|personal), name (required), description (optional), content (required: markdown), folderId (optional)',
             },
             {
-                name: 'llama_get_error',
-                description: 'Get full error details including stack trace and metadata',
-                params: 'orgSlug (optional), projectKey (optional), errorId (required)',
-                use: 'View complete error information before accepting',
+                name: 'llama_update_prompt',
+                description: 'Partial update — only fields you pass are changed',
+                params: 'promptId (required), name (optional), description (optional, null to clear), content (optional), folderId (optional, null to detach)',
             },
             {
-                name: 'llama_get_error_count',
-                description: 'Get count of pending errors needing attention',
-                params: 'orgSlug (optional), projectKey (optional)',
-                use: 'Check if there are new errors to triage',
+                name: 'llama_delete_prompt',
+                description: 'Soft-delete a prompt',
+                params: 'promptId (required)',
             },
             {
-                name: 'llama_accept_error',
-                description: 'Accept an error and create a BUG issue from it. Error details are included in the issue description.',
-                params: 'orgSlug (optional), projectKey (optional), errorId (required), priority (optional: CRITICAL|HIGH|MEDIUM|LOW|TRIVIAL), assigneeId (optional), sprintId (optional), labels (optional)',
-                use: 'Convert error into a trackable bug issue',
+                name: 'llama_manage_prompt_folder',
+                description: 'Manage prompt folders: list, create, rename, or delete',
+                params: 'action (required: list|create|rename|delete), scope (for create), folderId (for rename/delete), name (for create/rename)',
+            },
+        ],
+    },
+    attachments: {
+        title: 'Attachment Tools',
+        description: 'Upload, list, download, and delete files attached to issues. Max 10MB per file.',
+        tools: [
+            {
+                name: 'llama_attach_file',
+                description: 'Upload a local file to an issue (images, docs, archives)',
+                params: 'orgSlug (required), projectKey (required), issueKey (required), filePath (required: absolute path)',
             },
             {
-                name: 'llama_dismiss_error',
-                description: 'Dismiss a single error (hide from default view)',
-                params: 'orgSlug (optional), projectKey (optional), errorId (required)',
-                use: 'Mark noise/duplicate errors as not actionable',
+                name: 'llama_list_attachments',
+                description: 'List all attachments on an issue',
+                params: 'orgSlug (required), projectKey (required), issueKey (required)',
+            },
+            {
+                name: 'llama_download_attachment',
+                description: 'Download and view an attachment. Images returned visually, text as readable content. Files >1MB return metadata only.',
+                params: 'attachmentId (required)',
+            },
+            {
+                name: 'llama_delete_attachment',
+                description: 'Delete an attachment from an issue',
+                params: 'attachmentId (required)',
+            },
+        ],
+    },
+    refinement: {
+        title: 'Story Refinement Tools',
+        description: 'AI-assisted story refinement: structured Q&A, codebase context, optional voice transcription.',
+        tools: [
+            {
+                name: 'llama_refine_story',
+                description: 'Refine a draft story into a properly-scoped one using AI',
+                params: 'orgSlug (required), projectKey (required), summary (required), description (optional), additional context fields',
+            },
+            {
+                name: 'llama_get_refinement',
+                description: 'Get a refinement session by ID',
+                params: 'refinementId (required)',
+            },
+            {
+                name: 'llama_get_transcription',
+                description: 'Get text transcription of an uploaded voice memo (used during refinement)',
+                params: 'transcriptionId (required)',
+            },
+        ],
+    },
+    roadmap: {
+        title: 'Roadmap Tools',
+        tools: [
+            {
+                name: 'llama_get_roadmap',
+                description: 'Get a roadmap with items, milestones, and computed drift/progress. Without roadmapId returns the most recently updated.',
+                params: 'orgSlug (required), projectKey (required), roadmapId (optional)',
             },
             {
-                name: 'llama_bulk_dismiss_errors',
-                description: 'Dismiss multiple errors at once (max 100)',
-                params: 'orgSlug (optional), projectKey (optional), errorIds (required: array of error IDs)',
-                use: 'Quickly clear multiple non-actionable errors',
+                name: 'llama_manage_roadmap',
+                description: 'Create, update, or delete roadmaps. Update supports batch items/milestones/dependencies.',
+                params: 'action (required: create|update|delete), orgSlug (required), projectKey (required), roadmapId (for update/delete), name/items/milestones/dependencies (for create/update)',
             },
         ],
     },
-    decomposition: {
-        title: 'Feature Decomposition',
-        description: 'Break down features into stories/tasks. This is now a Claude Workflow - say "decompose [feature]" to trigger it.',
+    rollup: {
+        title: 'Rollup Tools',
+        description: 'Configure how parent issues (EPICs) compute aggregate metrics from their children.',
         tools: [
             {
-                name: 'Feature Decomposition Skill',
-                description: 'Use llama_list_skills or say "decompose" to trigger this skill',
-                params: 'featureTitle, featureDescription',
-                use: 'Clarifies requirements, analyzes codebase, creates EPIC with Stories/Tasks',
+                name: 'llama_configure_rollup',
+                description: 'Set rollup configuration for a project',
+                params: 'orgSlug (required), projectKey (required), config fields (estimateRollup, statusRollup, etc.)',
+            },
+        ],
+    },
+    errors: {
+        title: 'Error Inbox Tools',
+        description: 'Manage errors reported by external systems. Accept errors to create BUG issues, dismiss noise.',
+        tools: [
+            {
+                name: 'llama_manage_error',
+                description: 'Single tool for all Error Inbox actions: list, get, count, accept (creates BUG), dismiss (single or up to 100).',
+                params: 'action (required: list|get|count|accept|dismiss), orgSlug (optional), projectKey (optional), errorId / errorIds (depends on action), filters (status/sortBy/sortOrder/page/limit for list), priority/assigneeId/sprintId/labels (for accept)',
+                use: 'Triage, accept errors as bugs, or clear noise',
+                example: `// List pending errors
+{ "action": "list", "status": "PENDING" }
+
+// Accept and create BUG
+{ "action": "accept", "errorId": "err-123", "priority": "HIGH" }
+
+// Dismiss many at once
+{ "action": "dismiss", "errorIds": ["err-1", "err-2", "err-3"] }`,
+            },
+        ],
+    },
+    notifications: {
+        title: 'Notification Rule Tools',
+        description: 'Notification rules deliver Slack alerts on events (status changes, label adds, sprint lifecycle). Slack integration must be installed via the web UI first.',
+        tools: [
+            {
+                name: 'llama_manage_notification_rule',
+                description: 'Single dispatcher: list, create, update, or delete notification rules.',
+                params: 'action (required: list|create|update|delete), orgSlug (optional), name/eventTypes/deliveryMethod/deliveryConfig/scope/filters (for create), ruleId (for update/delete)',
+                tip: 'Event types: STATUS_CHANGED, ISSUE_CREATED, ISSUE_ASSIGNED, COMMENT_ADDED, LABEL_ADDED, LABEL_REMOVED, SPRINT_STARTED, SPRINT_COMPLETED. Delivery: SLACK_DM | SLACK_CHANNEL.',
+                example: `{
+  "action": "create",
+  "integrationId": "int-123",
+  "name": "Notify QA when bugs enter testing",
+  "eventTypes": "STATUS_CHANGED",
+  "deliveryMethod": "SLACK_CHANNEL",
+  "deliveryConfig": "{\\"channelId\\":\\"C123456\\"}",
+  "scope": "PROJECT",
+  "projectId": "proj-123",
+  "issueTypes": "BUG"
+}`,
+            },
+        ],
+    },
+    import: {
+        title: 'Import Tools',
+        tools: [
+            {
+                name: 'llama_import_csv',
+                description: 'Import issues from a CSV file (Jira/GitHub/generic formats supported)',
+                params: 'orgSlug (required), projectKey (required), filePath (required: absolute path), format (optional), mapping (optional)',
+            },
+        ],
+    },
+    prScorer: {
+        title: 'PR Scorer Tools',
+        description: 'Author and install PR quality-scoring rulesets. Rules are written in a small DSL; ' +
+            'call llama_get_pr_scorer_schema for the full grammar, variable table, function table, ' +
+            'and runnable examples.',
+        tools: [
+            {
+                name: 'llama_get_pr_scorer_schema',
+                description: 'Return the complete PR Scorer DSL reference: grammar (EBNF), operator table, ' +
+                    'built-in function table, variable table (EvalContext shape), hard limits, and ' +
+                    'two runnable examples. Call this before authoring or editing rules.',
+                params: 'None',
+                use: 'Read this first when you need to write, understand, or debug PR Scorer rules',
+                returns: 'Full DSL reference as text',
+            },
+            {
+                name: 'llama_get_pr_scorer_rules',
+                description: 'Fetch the current PR Scorer ruleset for a project (DSL source + enabled flag)',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default)',
+                returns: '{ source, enabled, updatedAt, updatedBy }',
+            },
+            {
+                name: 'llama_set_pr_scorer_rules',
+                description: 'Install or replace the PR Scorer ruleset. On parse failure, returns a structured ' +
+                    'parseErrors array [{ line, column, message }] — not a flattened string — so each ' +
+                    'error can be fixed by its exact position.',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default), ' +
+                    'source (required: DSL text), enabled (optional: boolean)',
+                returns: 'On success: { success: true, source, enabled, updatedAt }. ' +
+                    'On parse failure: { success: false, parseErrors: [{ line, column, message }] }',
+                example: `// Read schema first
+llama_get_pr_scorer_schema
+
+// Install a simple ruleset
+{
+  "source": "when files.any(f -> pathMatches(f.path, \\"**/*.test.ts\\")) then +1 reason \\"has tests\\"\\nwhen pr.isDraft == true then -1 reason \\"draft PR\\"",
+  "enabled": true
+}`,
+            },
+            {
+                name: 'llama_test_pr_scorer',
+                description: 'Dry-run a PR Scorer ruleset against a real PR without saving. ' +
+                    'Returns { score, grade, reasons[], flags[], trace[] }. ' +
+                    'trace[] has one entry per rule — use it to explain why a rule fired or did not fire. ' +
+                    'prId is the DevLink UUID (not the ADO PR number); use llama_get_dev_links to find it.',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default), ' +
+                    'source (required: DSL rules to test), prId (required: DevLink UUID)',
+                returns: '{ success, score, grade, reasons[], flags[], trace[{ ruleIndex, matched, delta, reason?, flag? }] }. ' +
+                    'On parse failure: { success: false, parseErrors: [{ line, column, message }] }',
+                use: 'Validate new or edited rules before calling llama_set_pr_scorer_rules',
+            },
+            {
+                name: 'llama_list_pr_scorer_history',
+                description: 'List the save history for a project\'s PR Scorer ruleset — metadata only ' +
+                    '(savedAt, updatedById, sourceLineCount, sourceLength). ' +
+                    'Full rule bodies are stripped to keep token cost low. ' +
+                    'Entry indices are 0-indexed from most-recent-first and correspond directly to ' +
+                    'the historyIndex parameter of llama_revert_pr_scorer.',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default)',
+                returns: '{ success, count, entries[{ index, savedAt, updatedById?, sourceLineCount?, sourceLength? }] }',
+                use: 'Before calling llama_revert_pr_scorer to see what history is available',
+            },
+            {
+                name: 'llama_revert_pr_scorer',
+                description: 'Revert the PR Scorer ruleset to a previous saved version. ' +
+                    'historyIndex is 0-indexed from most-recent-first (0 = most recent save before the current state). ' +
+                    'After revert, call llama_get_pr_scorer_rules to confirm the restored ruleset.',
+                params: 'orgSlug (optional, session default), projectKey (optional, session default), ' +
+                    'historyIndex (required: integer >= 0)',
+                returns: '{ success, source, enabled, updatedById, message }',
+                use: 'Undo a bad llama_set_pr_scorer_rules call. Use llama_list_pr_scorer_history first.',
             },
         ],
     },
     patterns: {
         title: 'Common Patterns',
-        description: `**Creating issues for a sprint:**
+        description: `**First-time setup:**
+1. llama_connect — if response has \`firstTimeHint\`, the account has no projects
+2. Ask user about their work; help them create an org/project (or use existing)
+3. llama_set_context { orgSlug, projectKey }
+4. llama_install_getting_started_pack (preview, then confirm) — installs 4 core skills + board
+5. After install, write the SKILL.md files to .claude/skills/<id>/SKILL.md
+6. Tell user: "Run /getting-started-walkthrough"
+
+**Creating issues for a sprint:**
 1. llama_context → get sprintId from active/pending sprints
 2. llama_create_issue → include sprintId
 
 **Moving issue through workflow:**
 1. llama_context → get status IDs from workflow.statuses
 2. llama_update_issue → set statusId for target status
+3. (or) llama_move_issue_on_board → drop into a column on a specific board
 
 **Assigning issues:**
-1. llama_find_members_by_skill → find members with specific expertise
+1. llama_find_members_by_skill → find members with the right expertise
 2. llama_update_issue → set assigneeId
 
-**Listing all members:**
-1. llama_list_members → get all user IDs and skills
-
 **Sprint planning:**
 1. llama_get_backlog → see available issues
 2. llama_create_sprint → create new sprint
-3. llama_add_to_sprint → add issues to sprint
-4. llama_start_sprint → begin the sprint
+3. llama_add_to_sprint → add issues
+4. llama_start_sprint → begin
+
+**Decomposing a feature into stories:**
+1. llama_list_skills — find a decomposition skill (e.g., create-stories-from-plan)
+2. Run that skill — it walks you through codebase analysis and story generation
+3. llama_batch_create_issues — create the resulting stories in one call
 
 **Searching for work:**
 1. llama_search → find issues by text/filters
-2. llama_get_issue → get full details for specific issue
+2. llama_get_issue → get full details
 
 **Triaging Error Inbox:**
-1. llama_get_error_count → check for pending errors
-2. llama_list_errors → view pending errors
-3. llama_get_error → view stack trace/metadata for specific error
-4. llama_accept_error → create BUG issue from error
-   OR llama_dismiss_error → mark as not actionable
+1. llama_manage_error { action: "count" } → check pending count
+2. llama_manage_error { action: "list", status: "PENDING" } → review
+3. llama_manage_error { action: "get", errorId } → see stack trace
+4. llama_manage_error { action: "accept", errorId, priority } — create BUG issue
+   OR llama_manage_error { action: "dismiss", errorIds: [...] }
 
 **Surviving /clear (session persistence):**
 1. llama_save_state → checkpoint current issue, phase, queue
 2. (user runs /clear)
 3. llama_resume → get back context, state, and live board snapshot
-4. Continue working from where you left off`,
+4. Continue working from where you left off
+
+**Running a saved prompt:**
+1. llama_list_prompts → find prompts in the current scope
+2. llama_run_prompt { name } → fetch markdown and execute it
+
+**Installing a skill or agent from the library:**
+- Skills: llama_install_skill { skillId } → write returned content to .claude/skills/<slug>/SKILL.md
+- Agents: llama_install_agent { agentId } → write returned content to ~/.claude/agents/<filename>`,
     },
 };
-// Individual tool details for deep lookup
 const TOOL_DETAILS = {};
-// Build tool details from categories
 Object.entries(TOOL_DOCS).forEach(([category, data]) => {
     if ('tools' in data && Array.isArray(data.tools)) {
         data.tools.forEach((tool) => {
@@ -478,7 +864,6 @@ Object.entries(TOOL_DOCS).forEach(([category, data]) => {
 });
 export async function executeHelp(input) {
     const { topic } = input;
-    // No topic - return overview
     if (!topic) {
         const categories = Object.keys(TOOL_DOCS)
             .filter((k) => k !== 'overview')
@@ -495,35 +880,28 @@ export async function executeHelp(input) {
             help: {
                 title: TOOL_DOCS.overview.title,
                 content: TOOL_DOCS.overview.description,
-                categories: categories,
+                categories,
                 tip: 'Use llama_help { topic: "category" } for details on a category, or llama_help { topic: "tool_name" } for a specific tool.',
             },
         });
     }
-    // Check if topic is a tool name
     const normalizedTopic = topic.toLowerCase().replace(/^llama_/, '');
     const toolName = topic.startsWith('llama_') ? topic : `llama_${normalizedTopic}`;
     if (TOOL_DETAILS[toolName]) {
         return JSON.stringify({
             success: true,
-            help: {
-                tool: TOOL_DETAILS[toolName],
-            },
+            help: { tool: TOOL_DETAILS[toolName] },
         });
     }
-    // Check if topic is a category
     const categoryKey = normalizedTopic;
     if (TOOL_DOCS[categoryKey]) {
-        const categoryData = TOOL_DOCS[categoryKey];
         return JSON.stringify({
             success: true,
-            help: categoryData,
+            help: TOOL_DOCS[categoryKey],
         });
     }
-    // Topic not found - return suggestions
     const allTools = Object.keys(TOOL_DETAILS);
     const allCategories = Object.keys(TOOL_DOCS).filter((k) => k !== 'overview');
-    // Simple fuzzy match
     const matchingTools = allTools.filter((t) => t.includes(normalizedTopic) || normalizedTopic.includes(t.replace('llama_', '')));
     const matchingCategories = allCategories.filter((c) => c.includes(normalizedTopic) || normalizedTopic.includes(c));
     return JSON.stringify({