@gwdn/nexus-mcp 0.7.0

package/dist/tools/skills.js

@@ -0,0 +1,195 @@
+/**
+ * sk_list + sk_get + sk_create + sk_update + sk_activate -- Layer 2 Coordination
+ *
+ * Skill management tools for the Nexus platform.
+ * Skills are tenant-scoped instruction sets for agent sessions.
+ * Delegates to POST /api/mcp/skills.
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+// ---------------------------------------------------------------------------
+// sk_list
+// ---------------------------------------------------------------------------
+export const skListSchema = {
+    status_filter: z
+        .array(z.enum(['draft', 'active', 'archived']))
+        .optional()
+        .describe('Filter by skill status (default: draft, active)'),
+    limit: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Max number of skills to return'),
+};
+export async function skList(args) {
+    const result = await nexusPost('/api/mcp/skills', {
+        action: 'sk_list',
+        status_filter: args.status_filter,
+        limit: args.limit ?? 50,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// sk_get
+// ---------------------------------------------------------------------------
+export const skGetSchema = {
+    skill_id: z
+        .string()
+        .max(200)
+        .describe('Skill identifier (e.g., nx-init-nexus) or UUID'),
+};
+export async function skGet(args) {
+    const result = await nexusPost('/api/mcp/skills', {
+        action: 'sk_get',
+        skill_id: args.skill_id,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// sk_create
+// ---------------------------------------------------------------------------
+export const skCreateSchema = {
+    skill_id: z.string().max(200).describe('Skill identifier (e.g., nx-init-nexus)'),
+    name: z.string().max(500).describe('Human-readable skill name'),
+    description: z.string().max(1000).optional().describe('Short description'),
+    body: z.string().max(100_000).describe('Full markdown instruction content'),
+    auto_generate_command: z
+        .boolean()
+        .default(true)
+        .describe('Auto-generate an OpenCode command (default: true)'),
+};
+export async function skCreate(args) {
+    const result = await nexusPost('/api/mcp/skills', {
+        action: 'sk_create',
+        skill_id: args.skill_id,
+        name: args.name,
+        description: args.description,
+        body: args.body,
+        auto_generate_command: args.auto_generate_command ?? true,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// sk_update
+// ---------------------------------------------------------------------------
+export const skUpdateSchema = {
+    skill_id: z
+        .string()
+        .max(200)
+        .describe('Skill identifier (e.g., nx-init-nexus) or UUID'),
+    name: z.string().max(500).optional().describe('Updated name'),
+    description: z.string().max(1000).optional().describe('Updated description'),
+    body: z.string().max(100_000).optional().describe('Updated markdown content'),
+    auto_generate_command: z
+        .boolean()
+        .optional()
+        .describe('Toggle command auto-generation'),
+};
+export async function skUpdate(args) {
+    const result = await nexusPost('/api/mcp/skills', {
+        action: 'sk_update',
+        skill_id: args.skill_id,
+        name: args.name,
+        description: args.description,
+        body: args.body,
+        auto_generate_command: args.auto_generate_command,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// sk_activate
+// ---------------------------------------------------------------------------
+export const skActivateSchema = {
+    skill_id: z
+        .string()
+        .max(200)
+        .describe('Skill identifier (e.g., nx-init-nexus) or UUID'),
+    status: z
+        .enum(['active', 'archived', 'draft'])
+        .describe('New status for the skill'),
+};
+export async function skActivate(args) {
+    const result = await nexusPost('/api/mcp/skills', {
+        action: 'sk_activate',
+        skill_id: args.skill_id,
+        status: args.status,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/tools/skills.js.map

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

package/dist/tools/update-task-status.d.ts

@@ -0,0 +1,48 @@
+/**
+ * task_update -- Layer 2 Coordination
+ *
+ * Updates the status (and optionally priority/assignee) of an existing task.
+ * Delegates to POST /api/mcp/tasks (action: task_update).
+ */
+import { z } from 'zod';
+export declare const updateTaskStatusSchema: {
+    task_id: z.ZodString;
+    status: z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        done: "done";
+        cancelled: "cancelled";
+    }>;
+    priority: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+        urgent: "urgent";
+        medium: "medium";
+    }>>;
+    assignee: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodString>;
+};
+type UpdateTaskStatusArgs = {
+    task_id: string;
+    status: string;
+    priority?: string;
+    assignee?: string;
+    user_id: string;
+    agent_id?: string;
+};
+export declare function updateTaskStatus(args: UpdateTaskStatusArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=update-task-status.d.ts.map

package/dist/tools/update-task-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-task-status.d.ts","sourceRoot":"","sources":["../../src/tools/update-task-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CAelC,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB;;;;;;;;;;;;GA2BhE"}

package/dist/tools/update-task-status.js

@@ -0,0 +1,51 @@
+/**
+ * task_update -- Layer 2 Coordination
+ *
+ * Updates the status (and optionally priority/assignee) of an existing task.
+ * Delegates to POST /api/mcp/tasks (action: task_update).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const updateTaskStatusSchema = {
+    task_id: z.string().uuid().describe('Task UUID to update'),
+    status: z
+        .enum(['open', 'in_progress', 'blocked', 'done', 'cancelled'])
+        .describe('New task status'),
+    priority: z
+        .enum(['low', 'medium', 'high', 'urgent'])
+        .optional()
+        .describe('Updated priority (optional)'),
+    assignee: z
+        .string()
+        .uuid()
+        .optional()
+        .describe('UUID of the newly assigned user (optional)'),
+    agent_id: z.string().max(200).optional().describe('Agent identifier if applicable'),
+};
+export async function updateTaskStatus(args) {
+    const result = await nexusPost('/api/mcp/tasks', {
+        action: 'task_update',
+        task_id: args.task_id,
+        status: args.status,
+        priority: args.priority,
+        assignee: args.assignee,
+        agent_id: args.agent_id,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=update-task-status.js.map

package/dist/tools/update-task-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-task-status.js","sourceRoot":"","sources":["../../src/tools/update-task-status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC1D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;SAC7D,QAAQ,CAAC,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACzC,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACpF,CAAA;AAWD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA0B;IAC/D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE;QAC/C,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@gwdn/nexus-mcp",
+  "version": "0.7.0",
+  "description": "MCP server for the Nexus platform",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "nexus-mcp": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/server.ts",
+    "start": "node dist/server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.4"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/__tests__/auth.test.ts

@@ -0,0 +1,162 @@
+/**
+ * Tests for src/auth.ts
+ *
+ * Covers:
+ * - initIdentity() with valid/invalid tokens
+ * - getIdentity() before/after init
+ */
+
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+// Mock the nexus-api module before importing auth
+vi.mock('../nexus-api.js', () => ({
+  nexusGet: vi.fn(),
+}))
+
+import { nexusGet } from '../nexus-api.js'
+import { TEST_IDS } from './helpers'
+
+describe('MCP Auth', () => {
+  beforeEach(() => {
+    vi.resetModules()
+    vi.restoreAllMocks()
+    // Suppress console.error
+    vi.spyOn(console, 'error').mockImplementation(() => {})
+  })
+
+  describe('initIdentity', () => {
+    it('should resolve identity from a valid token', async () => {
+      vi.mocked(nexusGet).mockResolvedValue({
+        ok: true,
+        status: 200,
+        data: {
+          userId: TEST_IDS.userId,
+          email: 'test@example.com',
+          displayName: 'Test User',
+          isPlatformAdmin: true,
+          isPlatformOwner: false,
+          tenantId: TEST_IDS.tenantId,
+          memberships: [],
+          agentAssignments: [],
+        },
+        error: null,
+      })
+
+      process.env.NEXUS_PRIVATE_TOKEN =
+        'nxs_pat_valid-test-token-1234567890abcde'
+
+      const { initIdentity } = await import('../auth.js')
+      const identity = await initIdentity()
+
+      expect(identity).toBeDefined()
+      expect(identity.userId).toBe(TEST_IDS.userId)
+      expect(identity.displayName).toBe('Test User')
+      expect(identity.email).toBe('test@example.com')
+      expect(identity.isPlatformAdmin).toBe(true)
+      expect(identity.isPlatformOwner).toBe(false)
+    })
+
+    it('should throw if NEXUS_PRIVATE_TOKEN is not set', async () => {
+      delete process.env.NEXUS_PRIVATE_TOKEN
+
+      const { initIdentity } = await import('../auth.js')
+      await expect(initIdentity()).rejects.toThrow(
+        'NEXUS_PRIVATE_TOKEN is not set',
+      )
+    })
+
+    it('should throw if API returns an error', async () => {
+      vi.mocked(nexusGet).mockResolvedValue({
+        ok: false,
+        status: 401,
+        data: null,
+        error: 'Invalid token',
+      })
+
+      process.env.NEXUS_PRIVATE_TOKEN = 'nxs_pat_invalid-token-123456789012345'
+
+      const { initIdentity } = await import('../auth.js')
+      await expect(initIdentity()).rejects.toThrow(
+        'Identity resolution failed',
+      )
+    })
+
+    it('should throw if API returns null data', async () => {
+      vi.mocked(nexusGet).mockResolvedValue({
+        ok: true,
+        status: 200,
+        data: null,
+        error: null,
+      })
+
+      process.env.NEXUS_PRIVATE_TOKEN = 'nxs_pat_null-data-token-12345678901234'
+
+      const { initIdentity } = await import('../auth.js')
+      await expect(initIdentity()).rejects.toThrow(
+        'Identity resolution failed',
+      )
+    })
+
+    it('should resolve platform_owner identity with both admin and owner flags', async () => {
+      vi.mocked(nexusGet).mockResolvedValue({
+        ok: true,
+        status: 200,
+        data: {
+          userId: TEST_IDS.userId,
+          email: 'owner@example.com',
+          displayName: 'Platform Owner',
+          isPlatformAdmin: true,
+          isPlatformOwner: true,
+          tenantId: TEST_IDS.tenantId,
+          memberships: [],
+          agentAssignments: [],
+        },
+        error: null,
+      })
+
+      process.env.NEXUS_PRIVATE_TOKEN = 'nxs_pat_owner-test-token-12345678901'
+
+      const { initIdentity } = await import('../auth.js')
+      const identity = await initIdentity()
+
+      expect(identity.isPlatformAdmin).toBe(true)
+      expect(identity.isPlatformOwner).toBe(true)
+      expect(identity.displayName).toBe('Platform Owner')
+      expect(identity.email).toBe('owner@example.com')
+    })
+  })
+
+  describe('getIdentity', () => {
+    it('should throw if called before initIdentity', async () => {
+      const { getIdentity } = await import('../auth.js')
+      expect(() => getIdentity()).toThrow('Identity not initialized')
+    })
+
+    it('should return cached identity after init', async () => {
+      vi.mocked(nexusGet).mockResolvedValue({
+        ok: true,
+        status: 200,
+        data: {
+          userId: TEST_IDS.userId,
+          email: 'cached@example.com',
+          displayName: 'Cached User',
+          isPlatformAdmin: false,
+          isPlatformOwner: false,
+          tenantId: TEST_IDS.tenantId,
+          memberships: [],
+          agentAssignments: [],
+        },
+        error: null,
+      })
+
+      process.env.NEXUS_PRIVATE_TOKEN = 'nxs_pat_cached-test-token-1234567890'
+
+      const { initIdentity, getIdentity } = await import('../auth.js')
+      await initIdentity()
+
+      const identity = getIdentity()
+      expect(identity.userId).toBe(TEST_IDS.userId)
+      expect(identity.displayName).toBe('Cached User')
+    })
+  })
+})

package/src/__tests__/decision-comments.test.ts

@@ -0,0 +1,173 @@
+/**
+ * Tests for decision comment tools.
+ * All tools delegate to the Nexus API via nexusPost().
+ */
+
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { mockApiError, mockApiSuccess, parseToolResponse, TEST_IDS } from './helpers'
+
+vi.mock('../nexus-api.js', () => ({
+  nexusPost: vi.fn(),
+}))
+
+import { nexusPost } from '../nexus-api.js'
+
+describe('Decision Comments tools', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  describe('addDecisionComment', () => {
+    it('should add a comment to an existing decision', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(
+        mockApiSuccess({
+          action: 'dc_add',
+          comment_id: 'comment-id-1',
+          decision_id: TEST_IDS.adrId,
+          decision_title: 'Test ADR',
+          project_id: TEST_IDS.projectId,
+        }),
+      )
+
+      const { addDecisionComment } = await import('../tools/decision-comments.js')
+      const result = await addDecisionComment({
+        decision_id: TEST_IDS.adrId,
+        body: 'This is a comment',
+        user_id: TEST_IDS.userId,
+      })
+
+      expect(result.isError).toBeUndefined()
+      const parsed = parseToolResponse(result)
+      expect(parsed.action).toBe('dc_add')
+      expect(parsed.comment_id).toBe('comment-id-1')
+      expect(parsed.decision_id).toBe(TEST_IDS.adrId)
+      expect(parsed.decision_title).toBe('Test ADR')
+    })
+
+    it('should support agent_id in comment', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(
+        mockApiSuccess({
+          action: 'dc_add',
+          comment_id: 'comment-id-2',
+          decision_id: TEST_IDS.adrId,
+          decision_title: 'ADR',
+          project_id: TEST_IDS.projectId,
+        }),
+      )
+
+      const { addDecisionComment } = await import('../tools/decision-comments.js')
+      const result = await addDecisionComment({
+        decision_id: TEST_IDS.adrId,
+        body: 'Agent comment',
+        agent_id: TEST_IDS.agentId,
+        user_id: TEST_IDS.userId,
+      })
+
+      expect(result.isError).toBeUndefined()
+      // Verify agent_id was passed to the API
+      expect(nexusPost).toHaveBeenCalledWith('/api/mcp/governance', {
+        action: 'dc_add',
+        decision_id: TEST_IDS.adrId,
+        body: 'Agent comment',
+        agent_id: TEST_IDS.agentId,
+      })
+    })
+
+    it('should return error if decision not found', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(mockApiError('Decision not found', 404))
+
+      const { addDecisionComment } = await import('../tools/decision-comments.js')
+      const result = await addDecisionComment({
+        decision_id: TEST_IDS.adrId,
+        body: 'Comment',
+        user_id: TEST_IDS.userId,
+      })
+
+      expect(result.isError).toBe(true)
+    })
+
+    it('should return error on API failure', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(mockApiError('Failed to add comment'))
+
+      const { addDecisionComment } = await import('../tools/decision-comments.js')
+      const result = await addDecisionComment({
+        decision_id: TEST_IDS.adrId,
+        body: 'Comment',
+        user_id: TEST_IDS.userId,
+      })
+
+      expect(result.isError).toBe(true)
+    })
+  })
+
+  describe('listDecisionComments', () => {
+    it('should list comments for a decision', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(
+        mockApiSuccess({
+          decision_id: TEST_IDS.adrId,
+          decision_title: 'Test ADR',
+          total: 2,
+          comments: [
+            {
+              id: 'c1',
+              author_id: TEST_IDS.userId,
+              agent_id: null,
+              body: 'First comment',
+              created_at: '2026-01-01T00:00:00Z',
+            },
+            {
+              id: 'c2',
+              author_id: TEST_IDS.userId,
+              agent_id: TEST_IDS.agentId,
+              body: 'Second comment',
+              created_at: '2026-01-01T01:00:00Z',
+            },
+          ],
+        }),
+      )
+
+      const { listDecisionComments } = await import('../tools/decision-comments.js')
+      const result = await listDecisionComments({
+        decision_id: TEST_IDS.adrId,
+      })
+
+      expect(result.isError).toBeUndefined()
+      const parsed = parseToolResponse(result)
+      expect(parsed.decision_title).toBe('Test ADR')
+      expect(parsed.total).toBe(2)
+      expect(parsed.comments).toHaveLength(2)
+      expect(parsed.comments[0].body).toBe('First comment')
+    })
+
+    it('should return empty list for decision with no comments', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(
+        mockApiSuccess({
+          decision_id: TEST_IDS.adrId,
+          decision_title: 'ADR',
+          total: 0,
+          comments: [],
+        }),
+      )
+
+      const { listDecisionComments } = await import('../tools/decision-comments.js')
+      const result = await listDecisionComments({
+        decision_id: TEST_IDS.adrId,
+      })
+
+      const parsed = parseToolResponse(result)
+      expect(parsed.total).toBe(0)
+      expect(parsed.comments).toHaveLength(0)
+    })
+
+    it('should return error if decision not found', async () => {
+      vi.mocked(nexusPost).mockResolvedValue(mockApiError('Decision not found', 404))
+
+      const { listDecisionComments } = await import('../tools/decision-comments.js')
+      const result = await listDecisionComments({
+        decision_id: TEST_IDS.adrId,
+      })
+
+      expect(result.isError).toBe(true)
+    })
+  })
+})