@opvs-ai/mcp 0.5.0 → 0.5.2

package/dist/index.js

@@ -176,7 +176,7 @@ const TOOLS = [
     },
     {
         name: "get_task",
-        description: "Get full details of a single task including description, agent instructions, comments, assignees, labels, and metadata. If the task has stages (has_stages=true), use list_stages to see the stage workflow and check the active stage for your current instructions.",
+        description: "Get full details of a single task including description, agent instructions, comments, assignees, labels, and metadata.",
         inputSchema: {
             type: "object",
             properties: {
@@ -284,405 +284,669 @@ const TOOLS = [
             required: ["task_id"],
         },
     },
-    // ── Stages & Handoff ──
+    // ── Comments ──
     {
-        name: "list_stages",
-        description: "List all stages for a task, ordered by position. Stages are sequential in-card steps. Check this BEFORE starting work on a task to see if it has a multi-stage workflow. Returns stage IDs, titles, statuses (pending/active/done/skipped), agent instructions, and handoff reports from previous stages.",
+        name: "add_comment",
+        description: "Add a comment to a task. Use for progress updates, notes, questions, or deliverables. Supports markdown formatting.",
         inputSchema: {
             type: "object",
             properties: {
                 task_id: { type: "string", description: "Task UUID" },
+                content: {
+                    type: "string",
+                    description: "Comment text (markdown supported)",
+                },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id"],
+            required: ["task_id", "content"],
         },
     },
     {
-        name: "create_stage",
-        description: "Create a stage inside a task. Stages define sequential steps within a single card. The FIRST stage created on a task auto-activates immediately. Subsequent stages start as 'pending' and activate when the previous stage hands off.",
+        name: "list_comments",
+        description: "List comments on a task, ordered newest first. Returns comment content, author, and timestamps.",
         inputSchema: {
             type: "object",
             properties: {
                 task_id: { type: "string", description: "Task UUID" },
-                title: { type: "string", description: "Stage title" },
-                description: { type: "string", description: "Stage description" },
-                assignee_user_id: { type: "string", description: "User UUID to assign this stage to" },
-                assignee_agent_id: { type: "string", description: "Agent UUID to assign this stage to" },
-                agent_instructions: { type: "string", description: "Detailed instructions for the agent working this stage" },
-                agent_context: { type: "object", description: "Structured context data for the agent (key-value pairs)" },
-                position: { type: "number", description: "Position in stage order (auto-assigned if omitted)" },
+                limit: { type: "number", description: "Max results (default 25)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "title"],
+            required: ["task_id"],
         },
     },
+    // ── Views (agent-optimized) ──
     {
-        name: "update_stage",
-        description: "Update a stage's fields. Only pending or active stages can be updated — done and skipped stages are immutable. Provide only the fields you want to change.",
+        name: "get_board_session",
+        description: "RECOMMENDED FIRST CALL when starting work on a board. Returns everything in one call: board info, all columns with their UUIDs and names (needed for move_task), and your assigned tasks. Much more efficient than calling get_board + list_tasks separately.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                stage_id: { type: "string", description: "Stage UUID" },
-                title: { type: "string", description: "New title" },
-                description: { type: "string", description: "New description" },
-                assignee_user_id: { type: "string", description: "New user assignee UUID" },
-                assignee_agent_id: { type: "string", description: "New agent assignee UUID" },
-                agent_instructions: { type: "string", description: "New agent instructions" },
-                agent_context: { type: "object", description: "New structured context data" },
+                board_id: { type: "string", description: "Board UUID" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "stage_id"],
+            required: ["board_id"],
         },
     },
     {
-        name: "delete_stage",
-        description: "Delete a pending stage from a task. Cannot delete active or completed stages.",
+        name: "get_board_overview",
+        description: "Get board overview with column structure, task counts per column, and board metadata. Lighter than get_board_session (no task details).",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                stage_id: { type: "string", description: "Stage UUID" },
+                board_id: { type: "string", description: "Board UUID" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "stage_id"],
+            required: ["board_id"],
         },
     },
+    // ── Session ──
     {
-        name: "reorder_stages",
-        description: "Reorder the pending stages within a task. Pass all pending stage UUIDs in the desired order. Active and completed stages cannot be reordered.",
+        name: "get_session",
+        description: "Get your assigned tasks across all boards. Use this to find what you should work on. For a specific board's full context (columns, tasks), use get_board_session instead.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                order: {
+                board_id: {
+                    type: "string",
+                    description: "Optional: scope to a specific board",
+                },
+                ...WORKSPACE_PROP,
+            },
+        },
+    },
+    // ── Activity ──
+    {
+        name: "list_activity",
+        description: "Get recent activity feed (who did what, when). Provide exactly ONE of board_id or task_id. Shows task creation, status changes, comments, assignments, and moves. Ordered newest first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                board_id: { type: "string", description: "Board UUID — activity for the whole board" },
+                task_id: { type: "string", description: "Task UUID — activity for a single task" },
+                limit: { type: "number", description: "Max results (default 25)" },
+                ...WORKSPACE_PROP,
+            },
+        },
+    },
+    // ── Metrics ──
+    {
+        name: "get_board_summary",
+        description: "Get board KPIs: task counts by status, workload by assignee, priority distribution, and recent activity stats. Useful for reporting and understanding board health.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                board_id: { type: "string", description: "Board UUID" },
+                days: { type: "number", description: "Time window in days (default 7)" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["board_id"],
+        },
+    },
+    {
+        name: "get_task_velocity",
+        description: "Get task velocity: tasks created vs completed per day over time. Useful for tracking team throughput and trends.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                days: { type: "number", description: "Time window in days (default 30)" },
+                ...WORKSPACE_PROP,
+            },
+        },
+    },
+    // ── Columns ──
+    {
+        name: "list_columns",
+        description: "List all columns on a board with their IDs, names, and positions. Use this to find column IDs needed by move_task and create_task (or just pass column names directly).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                board_id: { type: "string", description: "Board UUID" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["board_id"],
+        },
+    },
+    {
+        name: "create_column",
+        description: "Create a new column on a board. New column is added at the end. Use reorder_columns to change position.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                board_id: { type: "string", description: "Board UUID" },
+                name: { type: "string", description: "Column name (e.g. 'In Review', 'Blocked')" },
+                color: { type: "string", description: "Column color hex (e.g. '#3B82F6')" },
+                wip_limit: { type: "number", description: "Max tasks allowed in this column" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["board_id", "name"],
+        },
+    },
+    {
+        name: "reorder_columns",
+        description: "Set the order of columns on a board. Pass ALL column UUIDs in the desired order — any omitted columns will be removed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                board_id: { type: "string", description: "Board UUID" },
+                column_ids: {
                     type: "array",
                     items: { type: "string" },
-                    description: "Stage UUIDs in desired order",
+                    description: "ALL column UUIDs in desired left-to-right order",
                 },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "order"],
+            required: ["board_id", "column_ids"],
         },
     },
+    // ── Files ──
     {
-        name: "submit_handoff",
-        description: "Submit a handoff report for the currently ACTIVE stage of a task. This is how you complete your current stage and pass work to the next owner.\n\nWORKFLOW: When working on a task with stages, call this after finishing your stage's work.\n- resolution='hand_off' (default): Marks your stage as done, activates the NEXT pending stage. You MUST provide next_owner_context to brief the next person.\n- resolution='resolve': Marks your stage AND the entire task as done. Use when you're on the last stage or want to finish early.\n\nIMPORTANT: Always include detailed what_was_done (min 10 chars) and output. The next_owner_context field is critical for knowledge transfer — explain what the next person needs to know to continue.",
+        name: "list_files",
+        description: "List file attachments on a task. Returns file names, sizes, types, and IDs. Use get_file for download URLs.",
         inputSchema: {
             type: "object",
             properties: {
                 task_id: { type: "string", description: "Task UUID" },
-                stage_id: { type: "string", description: "Stage UUID (must be the currently active stage)" },
-                what_was_done: { type: "string", description: "Summary of work completed (minimum 10 characters)" },
-                output: { type: "string", description: "Deliverable or output from this stage" },
-                next_owner_context: { type: "string", description: "Context for the next stage owner — what they need to know to continue. Required when resolution is 'hand_off'." },
-                resolution: { type: "string", description: "hand_off (pass to next stage, default) or resolve (complete entire task)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "stage_id", "what_was_done", "output"],
+            required: ["task_id"],
         },
     },
     {
-        name: "resolve_task",
-        description: "Resolve a task with a final handoff report. Works with or without stages. Use this to formally complete a task with a structured report, instead of just setting status='done'.\n\n- resolution='resolve' (default): Marks the task as done with your final report.\n- resolution='spawn_linked_card': Marks the task as done AND creates a new follow-up task linked to this one with a 'spawned' link. The next_owner_context becomes the new task's description.\n\nReturns the task status and, if spawned, the new spawned_task_id.",
+        name: "get_file",
+        description: "Get file metadata including name, size, MIME type, and download URL. Note: file upload is only available via the CLI (opvs files upload).",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                what_was_done: { type: "string", description: "Summary of all work completed (minimum 10 characters)" },
-                output: { type: "string", description: "Final deliverable or output" },
-                next_owner_context: { type: "string", description: "Context for follow-up work. Required when resolution is 'spawn_linked_card'." },
-                resolution: { type: "string", description: "resolve (complete task, default) or spawn_linked_card (complete + create follow-up task)" },
+                file_id: { type: "string", description: "File UUID" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "what_was_done", "output"],
+            required: ["file_id"],
         },
     },
-    // ── Task Links ──
+    // ── Docs ──
     {
-        name: "list_task_links",
-        description: "List all links for a task — both incoming and outgoing. Returns link type (spawned, blocked_by, related), source/target task IDs and titles. Use to understand task dependencies and relationships.",
+        name: "list_docs",
+        description: "List all AgentDocs documentation projects in your workspace. Returns project names, slugs, and page counts.",
+        inputSchema: {
+            type: "object",
+            properties: { ...WORKSPACE_PROP },
+        },
+    },
+    {
+        name: "get_doc",
+        description: "Get a documentation page by project and slug. The project parameter accepts a slug (e.g. 'platform-core-docs') or UUID.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
+                project: { type: "string", description: "Project slug or UUID (e.g. 'platform-core-docs')" },
+                slug: { type: "string", description: "Page slug" },
+                version: { type: "number", description: "Specific version number (optional, defaults to latest)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id"],
+            required: ["project", "slug"],
         },
     },
     {
-        name: "create_task_link",
-        description: "Create a typed link between two tasks. Link types: 'spawned' (target was created from source), 'blocked_by' (source blocked until target completes), 'related' (informational cross-reference). The source is the task_id you provide, the target is the other task.",
+        name: "create_doc",
+        description: "Create a new documentation page in a project. Content supports full markdown. Each page has a unique slug within its project.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Source task UUID" },
-                target_task_id: { type: "string", description: "Target task UUID to link to" },
-                link_type: { type: "string", description: "Link type: spawned, blocked_by, or related (default: related)" },
+                project: { type: "string", description: "Project slug or UUID" },
+                title: { type: "string", description: "Page title" },
+                slug: { type: "string", description: "Page slug (URL-friendly, must be unique in project)" },
+                content: { type: "string", description: "Page content (markdown)" },
+                message: { type: "string", description: "Commit message (default: 'Created via MCP')" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "target_task_id"],
+            required: ["project", "title", "slug"],
         },
     },
     {
-        name: "delete_task_link",
-        description: "Delete a task link by its link ID. Use list_task_links to find link IDs.",
+        name: "update_doc",
+        description: "Update a documentation page's content. Creates a new version — previous versions are preserved and accessible by version number.",
         inputSchema: {
             type: "object",
             properties: {
-                link_id: { type: "string", description: "Link UUID" },
+                project: { type: "string", description: "Project slug or UUID" },
+                slug: { type: "string", description: "Page slug" },
+                content: { type: "string", description: "New content (markdown)" },
+                title: { type: "string", description: "New title (optional)" },
+                message: { type: "string", description: "Commit message (default: 'Updated via MCP')" },
                 ...WORKSPACE_PROP,
             },
-            required: ["link_id"],
+            required: ["project", "slug", "content"],
         },
     },
-    // ── Comments ──
     {
-        name: "add_comment",
-        description: "Add a comment to a task. Use for progress updates, notes, questions, or deliverables. Supports markdown formatting.",
+        name: "search_docs",
+        description: "Full-text search across documentation. Searches page titles and content. Optionally scope to a single project.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
-                content: {
-                    type: "string",
-                    description: "Comment text (markdown supported)",
-                },
+                query: { type: "string", description: "Search query (searches titles and content)" },
+                project: { type: "string", description: "Project slug or UUID to scope search (optional)" },
+                limit: { type: "number", description: "Max results (default 10)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id", "content"],
+            required: ["query"],
         },
     },
+    // ── Docs: Project CRUD ──
     {
-        name: "list_comments",
-        description: "List comments on a task, ordered newest first. Returns comment content, author, and timestamps.",
+        name: "create_project",
+        description: "Create a new documentation project. Returns the project with its ID and slug.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: { type: "string", description: "Task UUID" },
+                name: { type: "string", description: "Project name" },
+                description: { type: "string", description: "Project description" },
+                visibility: { type: "string", description: "public or private (default: public)" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "update_project",
+        description: "Update a documentation project's name, description, or visibility. Brand admin only.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug or UUID" },
+                name: { type: "string", description: "New name" },
+                description: { type: "string", description: "New description" },
+                visibility: { type: "string", description: "public or private" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["project"],
+        },
+    },
+    {
+        name: "delete_project",
+        description: "Soft-delete a documentation project. Brand admin only.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug or UUID" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["project"],
+        },
+    },
+    // ── Docs: Page Operations ──
+    {
+        name: "list_pages",
+        description: "List pages in a documentation project. Use view='tree' for nested structure with children.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug or UUID" },
+                view: { type: "string", description: "flat or tree (default: flat)" },
+                limit: { type: "number", description: "Max results (default 100)" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["project"],
+        },
+    },
+    {
+        name: "move_page",
+        description: "Move a page to a new path or change sort order within its folder. Does not create a revision.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug or UUID" },
+                slug: { type: "string", description: "Page slug" },
+                path: { type: "string", description: "New tree path (e.g. '/guides')" },
+                sort_order: { type: "number", description: "New sort order within folder" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["project", "slug"],
+        },
+    },
+    {
+        name: "delete_page",
+        description: "Soft-delete a documentation page.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug or UUID" },
+                slug: { type: "string", description: "Page slug" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["project", "slug"],
+        },
+    },
+    // ── Docs: Revision History ──
+    {
+        name: "page_history",
+        description: "Get revision history for a page. Returns all past versions with dates and authors.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page_id: { type: "string", description: "Page UUID" },
                 limit: { type: "number", description: "Max results (default 25)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id"],
+            required: ["page_id"],
         },
     },
-    // ── Views (agent-optimized) ──
     {
-        name: "get_board_session",
-        description: "RECOMMENDED FIRST CALL when starting work on a board. Returns everything in one call: board info, all columns with their UUIDs and names (needed for move_task), and your assigned tasks. Much more efficient than calling get_board + list_tasks separately.",
+        name: "page_diff",
+        description: "Compute unified diff between two revisions. Omit 'from' for parent comparison.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID" },
+                page_id: { type: "string", description: "Page UUID" },
+                from_rev: { type: "string", description: "From revision ID (optional — defaults to parent)" },
+                to_rev: { type: "string", description: "To revision ID (optional — defaults to latest)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["board_id"],
+            required: ["page_id"],
         },
     },
     {
-        name: "get_board_overview",
-        description: "Get board overview with column structure, task counts per column, and board metadata. Lighter than get_board_session (no task details).",
+        name: "page_rollback",
+        description: "Rollback a page to a previous revision. Non-destructive — creates a new revision with the old content.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID" },
+                page_id: { type: "string", description: "Page UUID" },
+                revision_id: { type: "string", description: "Target revision ID to restore" },
+                message: { type: "string", description: "Commit message (default: 'Rollback via MCP')" },
                 ...WORKSPACE_PROP,
             },
-            required: ["board_id"],
+            required: ["page_id", "revision_id"],
         },
     },
-    // ── Session ──
+    // ── Docs: Media ──
     {
-        name: "get_session",
-        description: "Get your assigned tasks across all boards. Use this to find what you should work on. For a specific board's full context (columns, tasks), use get_board_session instead.",
+        name: "list_media",
+        description: "List media files in a documentation project. Returns filenames, sizes, URLs, and markdown embed snippets.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: {
-                    type: "string",
-                    description: "Optional: scope to a specific board",
+                project: { type: "string", description: "Project slug or UUID" },
+                limit: { type: "number", description: "Max results (default 25)" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["project"],
+        },
+    },
+    // ── Docs: Bulk & Export ──
+    {
+        name: "bulk_create_pages",
+        description: "Bulk create or update multiple pages at once. Used for multi-page writes. Each page needs title, slug, content_md, commit_message.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug or UUID" },
+                pages: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            title: { type: "string" },
+                            slug: { type: "string" },
+                            content_md: { type: "string" },
+                            commit_message: { type: "string" },
+                            path: { type: "string" },
+                        },
+                        required: ["title", "slug", "content_md", "commit_message"],
+                    },
+                    description: "Array of page objects",
                 },
+                branch: { type: "string", description: "Target branch (default: main)" },
                 ...WORKSPACE_PROP,
             },
+            required: ["project", "pages"],
         },
     },
-    // ── Activity ──
+    // ── Agent Optimization ──
     {
-        name: "list_activity",
-        description: "Get recent activity feed (who did what, when). Provide exactly ONE of board_id or task_id. Shows task creation, status changes, comments, assignments, and moves. Ordered newest first.",
+        name: "agent_my_tasks",
+        description: "Get tasks assigned to you across ALL boards in one call. More comprehensive than list_tasks with self=true — aggregates from every board and includes board names.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID — activity for the whole board" },
-                task_id: { type: "string", description: "Task UUID — activity for a single task" },
-                limit: { type: "number", description: "Max results (default 25)" },
+                board_id: { type: "string", description: "Scope to a specific board (optional)" },
+                status: { type: "string", description: "Filter: pending, assigned, in_progress, review, done, failed" },
+                limit: { type: "number", description: "Max results" },
                 ...WORKSPACE_PROP,
             },
         },
     },
-    // ── Metrics ──
     {
-        name: "get_board_summary",
-        description: "Get board KPIs: task counts by status, workload by assignee, priority distribution, and recent activity stats. Useful for reporting and understanding board health.",
+        name: "agent_my_delegations",
+        description: "List tasks you delegated to other agents. Complement to agent_my_tasks — shows tasks you handed off, not tasks assigned to you.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                days: { type: "number", description: "Time window in days (default 7)" },
+                status: { type: "string", description: "Filter: pending, assigned, in_progress, review, done, failed" },
+                limit: { type: "number", description: "Max results" },
                 ...WORKSPACE_PROP,
             },
-            required: ["board_id"],
         },
     },
     {
-        name: "get_task_velocity",
-        description: "Get task velocity: tasks created vs completed per day over time. Useful for tracking team throughput and trends.",
+        name: "agent_batch_create_tasks",
+        description: "Create multiple tasks at once. Each task needs board_id and title. Returns list of created IDs and any errors.",
         inputSchema: {
             type: "object",
             properties: {
-                days: { type: "number", description: "Time window in days (default 30)" },
+                tasks: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            board_id: { type: "string", description: "Board UUID" },
+                            title: { type: "string", description: "Task title" },
+                            description: { type: "string", description: "Task description" },
+                            priority: { type: "string", description: "low, medium, high, critical" },
+                            column_id: { type: "string", description: "Column UUID or name" },
+                            agent_instructions: { type: "string", description: "Agent instructions" },
+                        },
+                        required: ["board_id", "title"],
+                    },
+                    description: "Array of task objects to create",
+                },
                 ...WORKSPACE_PROP,
             },
+            required: ["tasks"],
         },
     },
-    // ── Columns ──
     {
-        name: "list_columns",
-        description: "List all columns on a board with their IDs, names, and positions. Use this to find column IDs needed by move_task and create_task (or just pass column names directly).",
+        name: "agent_report_progress",
+        description: "Report progress on a task. Updates metadata and adds a progress comment. Use this for long-running tasks to keep stakeholders informed.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID" },
+                task_id: { type: "string", description: "Task UUID" },
+                percent: { type: "number", description: "Progress percentage (0-100)" },
+                message: { type: "string", description: "Progress message" },
+                current_operation: { type: "string", description: "What you're currently doing" },
                 ...WORKSPACE_PROP,
             },
-            required: ["board_id"],
+            required: ["task_id", "percent"],
         },
     },
     {
-        name: "create_column",
-        description: "Create a new column on a board. New column is added at the end. Use reorder_columns to change position.",
+        name: "agent_complete_task",
+        description: "Mark a task as done or failed. Automatically walks through intermediate status transitions (pending→assigned→in_progress→done). Adds a completion comment.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                name: { type: "string", description: "Column name (e.g. 'In Review', 'Blocked')" },
-                color: { type: "string", description: "Column color hex (e.g. '#3B82F6')" },
-                wip_limit: { type: "number", description: "Max tasks allowed in this column" },
+                task_id: { type: "string", description: "Task UUID" },
+                status: { type: "string", description: "done or failed (default: done)" },
+                summary: { type: "string", description: "Completion summary (added as comment)" },
+                result_data: {
+                    type: "object",
+                    description: "Structured result data (JSON object)",
+                },
                 ...WORKSPACE_PROP,
             },
-            required: ["board_id", "name"],
+            required: ["task_id"],
         },
     },
     {
-        name: "reorder_columns",
-        description: "Set the order of columns on a board. Pass ALL column UUIDs in the desired order — any omitted columns will be removed.",
+        name: "agent_delegate_task",
+        description: "Reassign a task to another agent by their slug (e.g. 'maya', 'grant'). Resolves the slug to a UUID, updates assignment, and adds a delegation comment.",
         inputSchema: {
             type: "object",
             properties: {
-                board_id: { type: "string", description: "Board UUID" },
-                column_ids: {
+                task_id: { type: "string", description: "Task UUID" },
+                agent_slug: { type: "string", description: "Target agent's slug (e.g. 'maya')" },
+                instructions: { type: "string", description: "Instructions for the target agent" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["task_id", "agent_slug"],
+        },
+    },
+    {
+        name: "search_tasks",
+        description: "Full-text search across all tasks/cards. Searches titles, descriptions, and comments.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                board_id: { type: "string", description: "Scope to a specific board (optional)" },
+                limit: { type: "number", description: "Max results (default 25)" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "batch_get_tasks",
+        description: "Get multiple tasks by IDs in one call (max 50). More efficient than calling get_task multiple times.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ids: {
                     type: "array",
                     items: { type: "string" },
-                    description: "ALL column UUIDs in desired left-to-right order",
+                    description: "Array of task UUIDs (max 50)",
                 },
                 ...WORKSPACE_PROP,
             },
-            required: ["board_id", "column_ids"],
+            required: ["ids"],
+        },
+    },
+    // ── Stages ──
+    {
+        name: "list_stages",
+        description: "List stages (sequential in-card steps) for a task. Stages enable multi-agent handoff workflows within a single task.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task_id: { type: "string", description: "Task UUID" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["task_id"],
         },
     },
-    // ── Files ──
     {
-        name: "list_files",
-        description: "List file attachments on a task. Returns file names, sizes, types, and IDs. Use get_file for download URLs.",
+        name: "create_stage",
+        description: "Create a stage on a task. The first stage auto-activates. Subsequent stages stay pending until the previous one is completed via handoff.",
         inputSchema: {
             type: "object",
             properties: {
                 task_id: { type: "string", description: "Task UUID" },
+                title: { type: "string", description: "Stage title" },
+                description: { type: "string", description: "Stage description" },
+                assignee_agent_id: { type: "string", description: "Agent UUID to assign this stage to" },
+                agent_instructions: { type: "string", description: "Instructions for the agent handling this stage" },
+                position: { type: "number", description: "Position in stage order" },
                 ...WORKSPACE_PROP,
             },
-            required: ["task_id"],
+            required: ["task_id", "title"],
         },
     },
     {
-        name: "get_file",
-        description: "Get file metadata including name, size, MIME type, and download URL. Note: file upload is only available via the CLI (opvs files upload).",
+        name: "update_stage",
+        description: "Update a stage (pending or active only). Provide only the fields you want to change.",
         inputSchema: {
             type: "object",
             properties: {
-                file_id: { type: "string", description: "File UUID" },
+                task_id: { type: "string", description: "Task UUID" },
+                stage_id: { type: "string", description: "Stage UUID" },
+                title: { type: "string", description: "New title" },
+                description: { type: "string", description: "New description" },
+                assignee_agent_id: { type: "string", description: "New agent assignment" },
+                agent_instructions: { type: "string", description: "New agent instructions" },
                 ...WORKSPACE_PROP,
             },
-            required: ["file_id"],
+            required: ["task_id", "stage_id"],
         },
     },
-    // ── Docs ──
     {
-        name: "list_docs",
-        description: "List all AgentDocs documentation projects in your workspace. Returns project names, slugs, and page counts.",
+        name: "complete_stage",
+        description: "Complete a stage and hand off to the next one. Adds a handoff comment. If this is the last stage, the task can be completed.",
         inputSchema: {
             type: "object",
-            properties: { ...WORKSPACE_PROP },
+            properties: {
+                task_id: { type: "string", description: "Task UUID" },
+                stage_id: { type: "string", description: "Stage UUID to complete" },
+                comment: { type: "string", description: "Handoff comment for the next stage's assignee" },
+                ...WORKSPACE_PROP,
+            },
+            required: ["task_id", "stage_id"],
         },
     },
     {
-        name: "get_doc",
-        description: "Get a documentation page by project and slug. The project parameter accepts a slug (e.g. 'platform-core-docs') or UUID.",
+        name: "reorder_stages",
+        description: "Reorder pending stages on a task. Active and completed stages cannot be reordered.",
         inputSchema: {
             type: "object",
             properties: {
-                project: { type: "string", description: "Project slug or UUID (e.g. 'platform-core-docs')" },
-                slug: { type: "string", description: "Page slug" },
-                version: { type: "number", description: "Specific version number (optional, defaults to latest)" },
+                task_id: { type: "string", description: "Task UUID" },
+                order: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Stage UUIDs in desired order",
+                },
                 ...WORKSPACE_PROP,
             },
-            required: ["project", "slug"],
+            required: ["task_id", "order"],
         },
     },
+    // ── Task Links ──
     {
-        name: "create_doc",
-        description: "Create a new documentation page in a project. Content supports full markdown. Each page has a unique slug within its project.",
+        name: "list_task_links",
+        description: "List all links for a task (incoming and outgoing). Link types: spawned, blocked_by, related.",
         inputSchema: {
             type: "object",
             properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                title: { type: "string", description: "Page title" },
-                slug: { type: "string", description: "Page slug (URL-friendly, must be unique in project)" },
-                content: { type: "string", description: "Page content (markdown)" },
-                message: { type: "string", description: "Commit message (default: 'Created via MCP')" },
+                task_id: { type: "string", description: "Task UUID" },
                 ...WORKSPACE_PROP,
             },
-            required: ["project", "title", "slug"],
+            required: ["task_id"],
         },
     },
     {
-        name: "update_doc",
-        description: "Update a documentation page's content. Creates a new version — previous versions are preserved and accessible by version number.",
+        name: "create_task_link",
+        description: "Create a link between two tasks. Types: 'spawned' (this task created the target), 'blocked_by' (this task is blocked by target), 'related' (general relation).",
         inputSchema: {
             type: "object",
             properties: {
-                project: { type: "string", description: "Project slug or UUID" },
-                slug: { type: "string", description: "Page slug" },
-                content: { type: "string", description: "New content (markdown)" },
-                title: { type: "string", description: "New title (optional)" },
-                message: { type: "string", description: "Commit message (default: 'Updated via MCP')" },
+                task_id: { type: "string", description: "Source task UUID" },
+                target_task_id: { type: "string", description: "Target task UUID" },
+                link_type: { type: "string", description: "spawned, blocked_by, or related (default: related)" },
                 ...WORKSPACE_PROP,
             },
-            required: ["project", "slug", "content"],
+            required: ["task_id", "target_task_id"],
         },
     },
     {
-        name: "search_docs",
-        description: "Full-text search across documentation. Searches page titles and content. Optionally scope to a single project.",
+        name: "delete_task_link",
+        description: "Delete a task link by its ID.",
         inputSchema: {
             type: "object",
             properties: {
-                query: { type: "string", description: "Search query (searches titles and content)" },
-                project: { type: "string", description: "Project slug or UUID to scope search (optional)" },
-                limit: { type: "number", description: "Max results (default 10)" },
+                link_id: { type: "string", description: "Link UUID" },
                 ...WORKSPACE_PROP,
             },
-            required: ["query"],
+            required: ["link_id"],
         },
     },
     // ── Auth ──
@@ -846,92 +1110,6 @@ async function handleTool(name, args) {
             const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/subtasks`, undefined, fmt);
             return ok(await callApi("GET", url, ws));
         }
-        // ── Stages & Handoff ──
-        case "list_stages": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/stages`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_stage": {
-            const body = { title: args.title };
-            if (args.description)
-                body.description = args.description;
-            if (args.assignee_user_id)
-                body.assignee_user_id = args.assignee_user_id;
-            if (args.assignee_agent_id)
-                body.assignee_agent_id = args.assignee_agent_id;
-            if (args.agent_instructions)
-                body.agent_instructions = args.agent_instructions;
-            if (args.agent_context)
-                body.agent_context = args.agent_context;
-            if (args.position !== undefined)
-                body.position = args.position;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages`, ws, body));
-        }
-        case "update_stage": {
-            const body = {};
-            if (args.title)
-                body.title = args.title;
-            if (args.description)
-                body.description = args.description;
-            if (args.assignee_user_id)
-                body.assignee_user_id = args.assignee_user_id;
-            if (args.assignee_agent_id)
-                body.assignee_agent_id = args.assignee_agent_id;
-            if (args.agent_instructions)
-                body.agent_instructions = args.agent_instructions;
-            if (args.agent_context)
-                body.agent_context = args.agent_context;
-            if (Object.keys(body).length === 0) {
-                return err("Nothing to update. Provide title, description, assignee_user_id, assignee_agent_id, agent_instructions, or agent_context.");
-            }
-            return ok(await callApi("PATCH", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}`, ws, body));
-        }
-        case "delete_stage": {
-            await callApi("DELETE", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}`, ws);
-            return ok(`Deleted stage ${args.stage_id}`);
-        }
-        case "reorder_stages": {
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages/reorder`, ws, { order: args.order }));
-        }
-        case "submit_handoff": {
-            const body = {
-                what_was_done: args.what_was_done,
-                output: args.output,
-            };
-            if (args.next_owner_context)
-                body.next_owner_context = args.next_owner_context;
-            if (args.resolution)
-                body.resolution = args.resolution;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}/handoff`, ws, body));
-        }
-        case "resolve_task": {
-            const body = {
-                what_was_done: args.what_was_done,
-                output: args.output,
-            };
-            if (args.next_owner_context)
-                body.next_owner_context = args.next_owner_context;
-            if (args.resolution)
-                body.resolution = args.resolution;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/resolve`, ws, body));
-        }
-        // ── Task Links ──
-        case "list_task_links": {
-            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/links`, undefined, fmt);
-            return ok(await callApi("GET", url, ws));
-        }
-        case "create_task_link": {
-            const body = {
-                target_task_id: args.target_task_id,
-            };
-            if (args.link_type)
-                body.link_type = args.link_type;
-            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/links`, ws, body));
-        }
-        case "delete_task_link": {
-            await callApi("DELETE", `/api/v1/board/task-links/${args.link_id}`, ws);
-            return ok(`Deleted task link ${args.link_id}`);
-        }
         // ── Comments ──
         case "add_comment": {
             return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/comments`, ws, { content: args.content }));
@@ -1055,6 +1233,215 @@ async function handleTool(name, args) {
             const url = buildUrl("/api/v1/docs/search", params, fmt);
             return ok(await callApi("GET", url, ws));
         }
+        // ── Docs: Project CRUD ──
+        case "create_project": {
+            const body = { name: args.name };
+            if (args.description)
+                body.description = args.description;
+            if (args.visibility)
+                body.visibility = args.visibility;
+            return ok(await callApi("POST", "/api/v1/docs/projects", ws, body));
+        }
+        case "update_project": {
+            const body = {};
+            if (args.name)
+                body.name = args.name;
+            if (args.description)
+                body.description = args.description;
+            if (args.visibility)
+                body.visibility = args.visibility;
+            if (Object.keys(body).length === 0) {
+                return err("Nothing to update. Provide name, description, or visibility.");
+            }
+            return ok(await callApi("PATCH", `/api/v1/docs/projects/${args.project}`, ws, body));
+        }
+        case "delete_project": {
+            await callApi("DELETE", `/api/v1/docs/projects/${args.project}`, ws);
+            return ok(`Deleted project ${args.project}`);
+        }
+        // ── Docs: Page Operations ──
+        case "list_pages": {
+            const params = {};
+            if (args.view)
+                params.view = String(args.view);
+            if (args.limit)
+                params.limit = String(args.limit);
+            const url = buildUrl(`/api/v1/docs/projects/${args.project}/pages`, params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "move_page": {
+            const body = {};
+            if (args.path)
+                body.path = args.path;
+            if (args.sort_order !== undefined)
+                body.sort_order = args.sort_order;
+            if (Object.keys(body).length === 0) {
+                return err("Provide path or sort_order.");
+            }
+            return ok(await callApi("PATCH", `/api/v1/docs/projects/${args.project}/pages/${args.slug}/move`, ws, body));
+        }
+        case "delete_page": {
+            await callApi("DELETE", `/api/v1/docs/projects/${args.project}/pages/${args.slug}`, ws);
+            return ok(`Deleted page ${args.slug}`);
+        }
+        // ── Docs: Revision History ──
+        case "page_history": {
+            const params = {};
+            if (args.limit)
+                params.limit = String(args.limit);
+            const url = buildUrl(`/api/v1/docs/pages/${args.page_id}/history`, params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "page_diff": {
+            const params = {};
+            if (args.from_rev)
+                params.from = String(args.from_rev);
+            if (args.to_rev)
+                params.to = String(args.to_rev);
+            const url = buildUrl(`/api/v1/docs/pages/${args.page_id}/diff`, params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "page_rollback": {
+            const body = {
+                revision_id: args.revision_id,
+                commit_message: String(args.message || "Rollback via MCP"),
+            };
+            return ok(await callApi("POST", `/api/v1/docs/pages/${args.page_id}/rollback`, ws, body));
+        }
+        // ── Docs: Media ──
+        case "list_media": {
+            const params = {};
+            if (args.limit)
+                params.limit = String(args.limit);
+            const url = buildUrl(`/api/v1/docs/projects/${args.project}/media`, params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        // ── Docs: Bulk ──
+        case "bulk_create_pages": {
+            const body = { pages: args.pages };
+            if (args.branch)
+                body.branch = args.branch;
+            return ok(await callApi("POST", `/api/v1/docs/projects/${args.project}/pages/bulk`, ws, body));
+        }
+        // ── Agent Optimization ──
+        case "agent_my_tasks": {
+            const params = {};
+            if (args.board_id)
+                params.board_id = String(args.board_id);
+            if (args.status)
+                params.status = String(args.status);
+            if (args.limit)
+                params.limit = String(args.limit);
+            const url = buildUrl("/api/v1/board/agent-api/my-tasks", params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "agent_my_delegations": {
+            const params = {};
+            if (args.status)
+                params.status = String(args.status);
+            if (args.limit)
+                params.limit = String(args.limit);
+            const url = buildUrl("/api/v1/board/agent-api/my-delegations", params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "agent_batch_create_tasks": {
+            return ok(await callApi("POST", "/api/v1/board/agent-api/tasks/batch", ws, { tasks: args.tasks }));
+        }
+        case "agent_report_progress": {
+            const body = { percent: args.percent };
+            if (args.message)
+                body.message = args.message;
+            if (args.current_operation)
+                body.current_operation = args.current_operation;
+            return ok(await callApi("POST", `/api/v1/board/agent-api/tasks/${args.task_id}/progress`, ws, body));
+        }
+        case "agent_complete_task": {
+            const body = {};
+            if (args.status)
+                body.status = args.status;
+            if (args.summary)
+                body.summary = args.summary;
+            if (args.result_data)
+                body.result_data = args.result_data;
+            return ok(await callApi("POST", `/api/v1/board/agent-api/tasks/${args.task_id}/complete`, ws, body));
+        }
+        case "agent_delegate_task": {
+            const body = { agent_slug: args.agent_slug };
+            if (args.instructions)
+                body.instructions = args.instructions;
+            return ok(await callApi("POST", `/api/v1/board/agent-api/tasks/${args.task_id}/delegate`, ws, body));
+        }
+        case "search_tasks": {
+            const params = { q: String(args.query) };
+            if (args.board_id)
+                params.board_id = String(args.board_id);
+            if (args.limit)
+                params.limit = String(args.limit);
+            const url = buildUrl("/api/v1/board/cards/search", params, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "batch_get_tasks": {
+            const ids = args.ids.join(",");
+            const url = buildUrl("/api/v1/board/tasks/batch", { ids }, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        // ── Stages ──
+        case "list_stages": {
+            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/stages`, undefined, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "create_stage": {
+            const body = { title: args.title };
+            if (args.description)
+                body.description = args.description;
+            if (args.assignee_agent_id)
+                body.assignee_agent_id = args.assignee_agent_id;
+            if (args.agent_instructions)
+                body.agent_instructions = args.agent_instructions;
+            if (args.position !== undefined)
+                body.position = args.position;
+            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages`, ws, body));
+        }
+        case "update_stage": {
+            const body = {};
+            if (args.title)
+                body.title = args.title;
+            if (args.description)
+                body.description = args.description;
+            if (args.assignee_agent_id)
+                body.assignee_agent_id = args.assignee_agent_id;
+            if (args.agent_instructions)
+                body.agent_instructions = args.agent_instructions;
+            if (Object.keys(body).length === 0) {
+                return err("Nothing to update. Provide title, description, assignee_agent_id, or agent_instructions.");
+            }
+            return ok(await callApi("PATCH", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}`, ws, body));
+        }
+        case "complete_stage": {
+            const body = {};
+            if (args.comment)
+                body.comment = args.comment;
+            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages/${args.stage_id}/handoff`, ws, body));
+        }
+        case "reorder_stages": {
+            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/stages/reorder`, ws, { order: args.order }));
+        }
+        // ── Task Links ──
+        case "list_task_links": {
+            const url = buildUrl(`/api/v1/board/tasks/${args.task_id}/links`, undefined, fmt);
+            return ok(await callApi("GET", url, ws));
+        }
+        case "create_task_link": {
+            const body = {
+                target_task_id: args.target_task_id,
+                link_type: args.link_type || "related",
+            };
+            return ok(await callApi("POST", `/api/v1/board/tasks/${args.task_id}/links`, ws, body));
+        }
+        case "delete_task_link": {
+            await callApi("DELETE", `/api/v1/board/task-links/${args.link_id}`, ws);
+            return ok(`Deleted link ${args.link_id}`);
+        }
         // ── Auth ──
         case "request_access": {
             const baseUrl = args.api_url || DEFAULT_WORKSPACE.api_url;
@@ -1134,13 +1521,20 @@ async function handleTool(name, args) {
     }
 }
 // ── Server Setup ─────────────────────────────────────────────────
-const server = new Server({ name: "opvs", version: "0.5.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "opvs", version: "0.5.2" }, { capabilities: { tools: {} } });
+// ── opvsHUB Generated Tools ──────────────────────────────────────
+import { GENERATED_TOOLS, handleGeneratedTool } from "./generated-tools.js";
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: TOOLS,
+    tools: [...TOOLS, ...GENERATED_TOOLS],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
+        // Try generated tools first (opvsHUB skills)
+        const generatedResult = await handleGeneratedTool(name, (args ?? {}), callApi, buildUrl, ok);
+        if (generatedResult !== null)
+            return generatedResult;
+        // Fall back to hand-written tools
         return await handleTool(name, (args ?? {}));
     }
     catch (e) {