@brxce/mcp-server 1.0.0

package/dist/tools/worknode-subtree-tool.js

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+/**
+ * Transforms a full WorkNode object to a minimal version for token efficiency
+ */
+function toMinimalWorkNode(node) {
+    return {
+        id: node.id,
+        parentNodeId: node.parentNodeId,
+        workspaceId: node.workspaceId,
+        nodeType: node.nodeType,
+        nodeLevel: node.nodeLevel,
+        nodePath: node.nodePath,
+        title: node.title,
+        description: node.description,
+        status: node.status,
+        priority: node.priority,
+        dueDate: node.dueDate,
+        assignee: node.assignee,
+        createdBy: node.createdBy,
+    };
+}
+export function registerWorknodeSubtreeTool(server, apiClient) {
+    server.registerTool('brxce_worknode_subtree', {
+        description: `Get a specific WorkNode and all its descendants (subtree).
+
+⚠️ **CRITICAL: WorkNode Context Verification Required**
+Before calling this tool, you MUST:
+1. Use \`brxce_workspace_overview\` first to find the node ID within a workspace
+2. NEVER use arbitrary or guessed nodeId values
+3. Verify the node exists in the workspace tree before drilling down
+4. If user mentions a node by name, search the workspace tree first
+
+**Example Workflow:**
+\`\`\`
+User: "Show me what's under the MVP Development project"
+LLM:
+  1. Calls brxce_workspace_overview to get workspace tree
+  2. Finds "MVP Development" project with ID 856
+  3. Calls brxce_worknode_subtree with nodeId: 856
+  4. Shows subtree results
+\`\`\`
+
+This tool retrieves a single WorkNode and ALL its child nodes recursively, providing:
+- The target node details
+- Complete list of all descendants (children, grandchildren, etc.)
+- Hierarchical statistics for the subtree
+- Progress and completion tracking for the entire branch
+
+**When to use this tool:**
+- When user asks about a specific goal, project, or task
+- To understand the scope and breakdown of work under a node
+- To analyze completion status of a specific initiative
+- To see all sub-tasks under a particular task
+- When you need detailed context about a node's children
+
+**Use cases:**
+- "What's under project X?" → Use this with project X's ID
+- "Show me all tasks in goal Y" → Use this with goal Y's ID
+- "What are the sub-tasks of task Z?" → Use this with task Z's ID
+- "How is project ABC broken down?" → Use this with project ABC's ID
+
+**Default behavior:**
+- Returns the target node + all active descendants
+- Excludes completed and deleted items by default
+- Use filters to include completed work or limit depth
+
+**Compact Mode (Token Efficiency):**
+- When \`compact=true\`, returns only essential fields: id, title, nodeType, status, priority, parentNodeId, nodeLevel, workspaceId
+- When \`compact=false\` or omitted, returns all fields including: description, assignee, progress, dueDate, completedAt, tags (simplified: name, slug, color), etc.
+- **Achieves ~75% size reduction** (e.g., 25KB → 5.8KB for 26 descendants)
+- Use compact mode when you only need basic hierarchy and don't need detailed metadata
+
+⏰ **TIMEZONE HANDLING:**
+ALL date/time fields in the response are in UTC (ISO 8601 format):
+- completedAt, createdAt, updatedAt, dueDate, startDate
+
+When presenting results to the user, you MUST convert UTC timestamps to the user's local timezone:
+1. Check the current date/time from the <env> tag in the system prompt
+2. Identify the user's timezone (e.g., Asia/Seoul = UTC+9)
+3. Convert ALL displayed timestamps from UTC to local time
+4. Format dates in a user-friendly way (e.g., "오후 5:16" not "08:16 UTC")
+
+Example conversion (Korea Time, UTC+9):
+- API returns: "completedAt": "2025-10-20T08:16:25.556Z" (UTC)
+- Display to user: "완료: 2025-10-20 오후 5:16" (KST)
+
+**Tip:** First use brxce_workspace_overview to find the node ID, then use this tool to drill into that specific node's subtree.`,
+        inputSchema: {
+            nodeId: z.number().describe('The WorkNode ID to fetch subtree for'),
+            includeCompleted: z.boolean().optional().describe('Include completed descendants (default: false)'),
+            includeCancelled: z.boolean().optional().describe('Include cancelled descendants (default: false)'),
+            includeAll: z
+                .boolean()
+                .optional()
+                .describe('Include all statuses including completed and cancelled (overrides other flags)'),
+            includeArchived: z.boolean().optional().describe('Include archived descendants (default: false)'),
+            includeDeleted: z.boolean().optional().describe('Include soft-deleted descendants (default: false)'),
+            maxDepth: z
+                .number()
+                .optional()
+                .describe('Maximum depth to traverse from target node (default: unlimited)'),
+            compact: z.boolean().optional().describe('Return compact format (minimal fields for token efficiency, ~75% size reduction, default: false)'),
+        },
+    }, async (args) => {
+        const { nodeId, ...filters } = args;
+        if (!nodeId || typeof nodeId !== 'number') {
+            throw new Error('nodeId is required and must be a number');
+        }
+        try {
+            // Build query string
+            const queryParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(filters)) {
+                if (value !== undefined && value !== null) {
+                    queryParams.append(key, String(value));
+                }
+            }
+            const queryString = queryParams.toString();
+            const url = `/mcp/worknodes/${nodeId}/subtree${queryString ? `?${queryString}` : ''}`;
+            const response = await apiClient.get(url);
+            if (!response.success) {
+                throw new Error('Failed to fetch worknode subtree');
+            }
+            // Use backend's compact mode if requested, otherwise return full data
+            const isCompact = response.data.compact || false;
+            const nodeData = response.data.node;
+            const childrenData = response.data.children;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            node: nodeData,
+                            children: childrenData,
+                            statistics: response.data.stats,
+                            compact: isCompact,
+                            metadata: response.meta,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Handle 404 specially
+            if (error.response?.status === 404 || error.message?.includes('not found')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'WorkNode not found',
+                                message: `WorkNode with ID ${nodeId} does not exist or you don't have access to it.`,
+                                nodeId,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to fetch worknode subtree',
+                            message: error.message,
+                            nodeId,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=worknode-subtree-tool.js.map

package/dist/tools/worknode-subtree-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worknode-subtree-tool.js","sourceRoot":"","sources":["../../src/tools/worknode-subtree-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/worknode-tag-tool.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ApiClient } from '../services/api-client.js';
+export declare function registerWorknodeTagTools(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=worknode-tag-tool.d.ts.map

package/dist/tools/worknode-tag-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worknode-tag-tool.d.ts","sourceRoot":"","sources":["../../src/tools/worknode-tag-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAmd/E"}

package/dist/tools/worknode-tag-tool.js

@@ -0,0 +1,353 @@
+import { z } from 'zod';
+export function registerWorknodeTagTools(server, apiClient) {
+    /**
+     * Add tags to WorkNode
+     */
+    server.registerTool('brxce_add_tags_to_worknode', {
+        description: `Add one or more tags to a WorkNode.
+
+**When to use:**
+- When user mentions tags for a specific WorkNode
+- To organize and categorize work items
+- After creating a WorkNode, to add relevant tags
+
+**Constraints:**
+- If category doesn't allow multiple tags, can only add one per category
+- If category is required, WorkNode must have at least one tag from that category
+
+**Example scenarios:**
+User: "Tag task #142 with React and TypeScript"
+Assistant: Get tag IDs for React and TypeScript, then call:
+brxce_add_tags_to_worknode(workspaceId: 4, worknodeId: 142, tagIds: [25, 26])
+
+User: "This is a high priority backend task"
+Assistant: Add "high-priority" and "backend" tags
+
+**Returns:**
+- Number of tags added
+- Number skipped (if already tagged)
+- List of all current tags on the WorkNode`,
+        inputSchema: {
+            workspaceId: z.number().describe('The workspace ID'),
+            worknodeId: z.number().describe('WorkNode ID to add tags to'),
+            tagIds: z.array(z.number()).describe('Array of tag IDs to add')
+        }
+    }, async (args) => {
+        try {
+            const { workspaceId, worknodeId, tagIds } = args;
+            const url = `/mcp/workspaces/${workspaceId}/worknodes/${worknodeId}/tags`;
+            const response = await apiClient.post(url, { tagIds });
+            if (!response.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to add tags: ${response.message || 'Unknown error'}`,
+                        },
+                    ],
+                };
+            }
+            const { added, skipped, tags } = response.data;
+            let resultText = `Tags added to WorkNode #${worknodeId}:\\n\\n`;
+            resultText += `Added: ${added} tag(s)\\n`;
+            if (skipped > 0)
+                resultText += `Skipped: ${skipped} (already tagged)\\n`;
+            resultText += `\\n**Current tags:**\\n`;
+            // Group by category
+            const byCategory = tags.reduce((acc, wnt) => {
+                const catName = wnt.tag.category.name;
+                if (!acc[catName])
+                    acc[catName] = [];
+                acc[catName].push(wnt.tag.name);
+                return acc;
+            }, {});
+            Object.entries(byCategory).forEach(([catName, tagNames]) => {
+                resultText += `- ${catName}: ${tagNames.join(', ')}\\n`;
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error adding tags: ${error.message || 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
+    /**
+     * Get WorkNode tags
+     */
+    server.registerTool('brxce_get_worknode_tags', {
+        description: `Get all tags attached to a WorkNode.
+
+**When to use:**
+- To check what tags a WorkNode currently has
+- Before adding more tags (to avoid duplicates)
+- To understand WorkNode's categorization
+
+**Returns:**
+- All tags grouped by category
+- Tag details (name, slug, category)
+- Who added each tag and when
+
+**Example:**
+User: "What tags does task #142 have?"
+Assistant calls: brxce_get_worknode_tags(workspaceId: 4, worknodeId: 142)`,
+        inputSchema: {
+            workspaceId: z.number().describe('The workspace ID'),
+            worknodeId: z.number().describe('WorkNode ID')
+        }
+    }, async (args) => {
+        try {
+            const { workspaceId, worknodeId } = args;
+            const url = `/mcp/workspaces/${workspaceId}/worknodes/${worknodeId}/tags`;
+            const response = await apiClient.get(url);
+            if (!response.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to get tags: ${response.message || 'Unknown error'}`,
+                        },
+                    ],
+                };
+            }
+            const { tags, total } = response.data;
+            let resultText = `## Tags for WorkNode #${worknodeId}\\n\\n`;
+            resultText += `Total tags: ${total}\\n\\n`;
+            if (tags.length === 0) {
+                resultText += `No tags attached.\\n`;
+            }
+            else {
+                // Group by category
+                const byCategory = tags.reduce((acc, wnt) => {
+                    const catName = wnt.tag.category.name;
+                    if (!acc[catName])
+                        acc[catName] = [];
+                    acc[catName].push(wnt);
+                    return acc;
+                }, {});
+                Object.entries(byCategory).forEach(([catName, catTags]) => {
+                    resultText += `### ${catName}\\n`;
+                    catTags.forEach((wnt) => {
+                        resultText += `- **${wnt.tag.name}** (ID: ${wnt.tag.id})\\n`;
+                        if (wnt.tag.description)
+                            resultText += `  ${wnt.tag.description}\\n`;
+                        if (wnt.tag.parentTag)
+                            resultText += `  Parent: ${wnt.tag.parentTag.name}\\n`;
+                        const addedDate = new Date(wnt.addedAt).toISOString().split('T')[0];
+                        resultText += `  Added: ${addedDate}`;
+                        if (wnt.user)
+                            resultText += ` by ${wnt.user.name || wnt.user.email}`;
+                        resultText += `\\n`;
+                    });
+                    resultText += `\\n`;
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting tags: ${error.message || 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
+    /**
+     * Batch assign tags to multiple WorkNodes
+     */
+    server.registerTool('brxce_batch_assign_tags', {
+        description: `Assign one or more tags to multiple WorkNodes in a single operation.
+
+**When to use:**
+- When tagging multiple WorkNodes with the same tag(s)
+- Organizing a group of related work items
+- Applying sprint/release tags to multiple tasks
+
+**Efficiency:**
+- Single API call instead of N × M calls
+- Optimized for large-scale tagging operations
+- Automatic handling of duplicates and constraints
+
+**Example scenarios:**
+
+1. Sprint tagging:
+   User: "Tag all tasks in Sprint-42 with the sprint tag"
+   Assistant: Get task IDs and sprint tag ID, then call:
+   brxce_batch_assign_tags(
+     workspaceId: 4,
+     worknodeIds: [100, 101, 102, 103],
+     tagIds: [42]
+   )
+
+2. Multi-tag assignment:
+   User: "Add Backend and High-Priority tags to these 5 tasks"
+   Assistant:
+   brxce_batch_assign_tags(
+     workspaceId: 4,
+     worknodeIds: [200, 201, 202, 203, 204],
+     tagIds: [10, 20]  // Backend, High-Priority
+   )
+
+3. Technology stack tagging:
+   User: "Tag all React components with React and TypeScript"
+   Assistant: Search for React components, get tag IDs, then batch assign
+
+**Returns:**
+- Total WorkNodes and tags involved
+- Number of assignments added, skipped, and failed
+- Detailed failure reasons (category constraints, etc.)
+
+**Constraints handled:**
+- Category allowMultiple restrictions
+- Duplicate tag prevention (auto-skip)
+- Workspace and WorkNode validation
+
+**Best practices:**
+1. Use this when tagging 2+ WorkNodes
+2. Combine with brxce_search_tags to find tag IDs
+3. Combine with brxce_workspace_tree to find WorkNode IDs
+4. Review failed assignments if category constraints exist`,
+        inputSchema: {
+            workspaceId: z.number().describe('The workspace ID'),
+            worknodeIds: z
+                .array(z.number())
+                .describe('Array of WorkNode IDs to add tags to'),
+            tagIds: z
+                .array(z.number())
+                .describe('Array of tag IDs to add to each WorkNode')
+        }
+    }, async (args) => {
+        try {
+            const { workspaceId, worknodeIds, tagIds } = args;
+            const url = `/mcp/workspaces/${workspaceId}/tags/batch-assign`;
+            const response = await apiClient.post(url, { worknodeIds, tagIds });
+            if (!response.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to batch assign tags: ${response.message || 'Unknown error'}`,
+                        },
+                    ],
+                };
+            }
+            const { totalWorknodes, totalTags, totalAssignments, added, skipped, failed } = response.data;
+            let resultText = `## Batch Tag Assignment Results\\n\\n`;
+            resultText += `**Summary:**\\n`;
+            resultText += `- WorkNodes: ${totalWorknodes}\\n`;
+            resultText += `- Tags: ${totalTags}\\n`;
+            resultText += `- Total assignments attempted: ${totalAssignments}\\n`;
+            resultText += `- ✅ Added: ${added}\\n`;
+            resultText += `- ⏭️ Skipped (duplicates): ${skipped}\\n`;
+            resultText += `- ❌ Failed: ${failed.length}\\n\\n`;
+            if (failed.length > 0) {
+                resultText += `**Failures:**\\n`;
+                failed.forEach((f) => {
+                    resultText += `- WorkNode #${f.worknodeId}, Tag #${f.tagId}: ${f.reason}\\n`;
+                });
+            }
+            if (added > 0) {
+                resultText += `\\n✅ Successfully assigned ${added} tag-worknode relationships!`;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: resultText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error batch assigning tags: ${error.message || 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
+    /**
+     * Remove tag from WorkNode
+     */
+    server.registerTool('brxce_remove_tag_from_worknode', {
+        description: `Remove a tag from a WorkNode.
+
+**When to use:**
+- When a tag is no longer relevant to the WorkNode
+- To correct mis-tagging
+- User explicitly requests tag removal
+
+**Constraints:**
+- Cannot remove if it's the last tag from a required category
+
+**Example:**
+User: "Remove the React tag from task #142"
+Assistant: Get React tag ID, then call:
+brxce_remove_tag_from_worknode(workspaceId: 4, worknodeId: 142, tagId: 25)`,
+        inputSchema: {
+            workspaceId: z.number().describe('The workspace ID'),
+            worknodeId: z.number().describe('WorkNode ID'),
+            tagId: z.number().describe('Tag ID to remove')
+        }
+    }, async (args) => {
+        try {
+            const { workspaceId, worknodeId, tagId } = args;
+            const url = `/mcp/workspaces/${workspaceId}/worknodes/${worknodeId}/tags/${tagId}`;
+            const response = await apiClient.delete(url);
+            if (!response.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to remove tag: ${response.message || 'Unknown error'}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Tag removed from WorkNode #${worknodeId} successfully.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error removing tag: ${error.message || 'Unknown error'}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=worknode-tag-tool.js.map

package/dist/tools/worknode-tag-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worknode-tag-tool.js","sourceRoot":"","sources":["../../src/tools/worknode-tag-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/worknode-update-tool.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ApiClient } from '../services/api-client.js';
+export declare function registerWorknodeUpdateTool(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=worknode-update-tool.d.ts.map

package/dist/tools/worknode-update-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worknode-update-tool.d.ts","sourceRoot":"","sources":["../../src/tools/worknode-update-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA+BtD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QA0bjF"}