@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.100

package/dist/__tests__/constellation.test.js

@@ -0,0 +1,254 @@
+/**
+ * pb constellation — unit tests.
+ * BET-181 Slice 3: compound view (entry + grouped relations).
+ *
+ * Verifies:
+ * 1. Mock kernelCall returns known constellation structure; command outputs entry + grouped relations
+ * 2. Edge: entry with no relations returns entry-only, empty relations object
+ * 3. Relation types in output derive from the server response, not hardcoded
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { runConstellation } from '../commands/constellation.js';
+import { setOutputMode } from '../lib/runner.js';
+const kernelCallMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    kernelCall: (...args) => kernelCallMock(...args),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn((_fn) => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+// A known constellation fixture for BET-181
+const CONSTELLATION_FIXTURE = {
+    entry: {
+        entryId: 'BET-181',
+        name: 'CLI Agent-Native Foundation',
+        collectionSlug: 'work-packages',
+        collectionName: 'Bets',
+        status: 'active',
+    },
+    relations: {
+        part_of: [
+            {
+                entryId: 'FEAT-100',
+                name: 'Product Brain CLI',
+                collectionSlug: 'features',
+                collectionName: 'Features',
+                direction: 'outgoing',
+            },
+        ],
+        informed_by: [
+            {
+                entryId: 'DEC-299',
+                name: 'JSON default for agent-native output',
+                collectionSlug: 'decisions',
+                collectionName: 'Decisions',
+                direction: 'incoming',
+            },
+            {
+                entryId: 'STD-65',
+                name: 'Structured, parseable, minimal',
+                collectionSlug: 'standards',
+                collectionName: 'Standards',
+                direction: 'incoming',
+            },
+        ],
+    },
+    summary: {
+        totalRelations: 3,
+        relationTypes: ['part_of', 'informed_by'],
+    },
+};
+let stdoutOutput;
+let stderrOutput;
+let stdoutWriteSpy;
+let stderrWriteSpy;
+function withTty(isTty, fn) {
+    return async () => {
+        const original = process.stdout.isTTY;
+        Object.defineProperty(process.stdout, 'isTTY', { value: isTty, configurable: true, writable: true });
+        try {
+            await fn();
+        }
+        finally {
+            Object.defineProperty(process.stdout, 'isTTY', { value: original, configurable: true, writable: true });
+        }
+    };
+}
+beforeEach(() => {
+    stdoutOutput = '';
+    stderrOutput = '';
+    stdoutWriteSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+        stdoutOutput += String(chunk);
+        return true;
+    });
+    stderrWriteSpy = vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+        stderrOutput += String(chunk);
+        return true;
+    });
+    setOutputMode('auto');
+    vi.clearAllMocks();
+});
+afterEach(() => {
+    stdoutWriteSpy.mockRestore();
+    stderrWriteSpy.mockRestore();
+    setOutputMode('auto');
+});
+describe('runConstellation — JSON mode (non-TTY)', () => {
+    it('calls chain.getConstellation with the correct entryId', withTty(false, async () => {
+        kernelCallMock.mockResolvedValue(CONSTELLATION_FIXTURE);
+        await runConstellation({ entryId: 'BET-181' });
+        expect(kernelCallMock).toHaveBeenCalledWith('chain.getConstellation', { entryId: 'BET-181' });
+    }));
+    it('outputs entry and grouped relations as JSON in non-TTY mode', withTty(false, async () => {
+        kernelCallMock.mockResolvedValue(CONSTELLATION_FIXTURE);
+        await runConstellation({ entryId: 'BET-181' });
+        const parsed = JSON.parse(stdoutOutput);
+        expect(parsed.entry.entryId).toBe('BET-181');
+        expect(parsed.entry.name).toBe('CLI Agent-Native Foundation');
+        expect(parsed.relations).toHaveProperty('part_of');
+        expect(parsed.relations).toHaveProperty('informed_by');
+        expect(parsed.summary.totalRelations).toBe(3);
+    }));
+    it('strips Convex internals in JSON mode', withTty(false, async () => {
+        const fixtureWithInternals = {
+            ...CONSTELLATION_FIXTURE,
+            entry: { ...CONSTELLATION_FIXTURE.entry, _id: 'sys-id', _creationTime: 999999 },
+        };
+        kernelCallMock.mockResolvedValue(fixtureWithInternals);
+        await runConstellation({ entryId: 'BET-181' });
+        const parsed = JSON.parse(stdoutOutput);
+        expect(parsed.entry).not.toHaveProperty('_id');
+        expect(parsed.entry).not.toHaveProperty('_creationTime');
+    }));
+});
+describe('runConstellation — pretty mode (TTY)', () => {
+    it('outputs human-readable grouped view in TTY mode', withTty(true, async () => {
+        kernelCallMock.mockResolvedValue(CONSTELLATION_FIXTURE);
+        await runConstellation({ entryId: 'BET-181' });
+        expect(stdoutOutput).toContain('BET-181');
+        expect(stdoutOutput).toContain('CLI Agent-Native Foundation');
+    }));
+    it('shows relation types grouped in TTY output', withTty(true, async () => {
+        kernelCallMock.mockResolvedValue(CONSTELLATION_FIXTURE);
+        await runConstellation({ entryId: 'BET-181' });
+        expect(stdoutOutput).toContain('part_of');
+        expect(stdoutOutput).toContain('informed_by');
+        expect(stdoutOutput).toContain('DEC-299');
+        expect(stdoutOutput).toContain('FEAT-100');
+    }));
+    it('shows direction arrows in TTY output', withTty(true, async () => {
+        kernelCallMock.mockResolvedValue(CONSTELLATION_FIXTURE);
+        await runConstellation({ entryId: 'BET-181' });
+        // outgoing → for part_of, incoming ← for informed_by
+        expect(stdoutOutput).toContain('→');
+        expect(stdoutOutput).toContain('←');
+    }));
+});
+describe('runConstellation — edge case: entry with no relations', () => {
+    it('returns entry-only output with empty relations object', withTty(false, async () => {
+        const noRelationsFixture = {
+            entry: {
+                entryId: 'BET-999',
+                name: 'Orphaned Bet',
+                collectionSlug: 'work-packages',
+                collectionName: 'Bets',
+                status: 'draft',
+            },
+            relations: {},
+            summary: {
+                totalRelations: 0,
+                relationTypes: [],
+            },
+        };
+        kernelCallMock.mockResolvedValue(noRelationsFixture);
+        await runConstellation({ entryId: 'BET-999' });
+        const parsed = JSON.parse(stdoutOutput);
+        expect(parsed.entry.entryId).toBe('BET-999');
+        expect(parsed.relations).toEqual({});
+        expect(parsed.summary.totalRelations).toBe(0);
+        expect(parsed.summary.relationTypes).toHaveLength(0);
+    }));
+    it('shows "No relations" in TTY mode for entry with no relations', withTty(true, async () => {
+        const noRelationsFixture = {
+            entry: {
+                entryId: 'BET-999',
+                name: 'Orphaned Bet',
+                collectionSlug: 'work-packages',
+                collectionName: 'Bets',
+                status: 'draft',
+            },
+            relations: {},
+            summary: {
+                totalRelations: 0,
+                relationTypes: [],
+            },
+        };
+        kernelCallMock.mockResolvedValue(noRelationsFixture);
+        await runConstellation({ entryId: 'BET-999' });
+        expect(stdoutOutput).toContain('No relations');
+    }));
+});
+describe('runConstellation — relation types derive from server response', () => {
+    it('renders any relation type returned by the server, not a hardcoded list', withTty(false, async () => {
+        // Use a novel relation type that doesn't match any hardcoded list
+        const customRelationFixture = {
+            entry: {
+                entryId: 'DEC-999',
+                name: 'Custom Decision',
+                collectionSlug: 'decisions',
+                collectionName: 'Decisions',
+                status: 'active',
+            },
+            relations: {
+                related_to: [
+                    {
+                        entryId: 'TEN-42',
+                        name: 'Some Tension',
+                        collectionSlug: 'tensions',
+                        collectionName: 'Tensions',
+                        direction: 'outgoing',
+                    },
+                ],
+                governs: [
+                    {
+                        entryId: 'FEAT-7',
+                        name: 'Some Feature',
+                        collectionSlug: 'features',
+                        collectionName: 'Features',
+                        direction: 'outgoing',
+                    },
+                ],
+                blocks: [
+                    {
+                        entryId: 'BET-55',
+                        name: 'Blocked Bet',
+                        collectionSlug: 'work-packages',
+                        collectionName: 'Bets',
+                        direction: 'outgoing',
+                    },
+                ],
+            },
+            summary: {
+                totalRelations: 3,
+                relationTypes: ['related_to', 'governs', 'blocks'],
+            },
+        };
+        kernelCallMock.mockResolvedValue(customRelationFixture);
+        await runConstellation({ entryId: 'DEC-999' });
+        const parsed = JSON.parse(stdoutOutput);
+        // Verify the CLI passes through whatever the server returns
+        expect(parsed.relations).toHaveProperty('related_to');
+        expect(parsed.relations).toHaveProperty('governs');
+        expect(parsed.relations).toHaveProperty('blocks');
+        expect(parsed.summary.relationTypes).toContain('related_to');
+        expect(parsed.summary.relationTypes).toContain('governs');
+        expect(parsed.summary.relationTypes).toContain('blocks');
+    }));
+});
+describe('runConstellation — error handling', () => {
+    it('throws CLIError when entry is not found', withTty(false, async () => {
+        kernelCallMock.mockRejectedValue(new Error('Entry "NOTEXIST-9999" not found.'));
+        await expect(runConstellation({ entryId: 'NOTEXIST-9999' })).rejects.toThrow('NOTEXIST-9999');
+    }));
+});
+//# sourceMappingURL=constellation.test.js.map

package/dist/__tests__/constellation.test.js.map

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

package/dist/__tests__/context-strategy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-strategy.test.d.ts.map

package/dist/__tests__/context-strategy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-strategy.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context-strategy.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/context-strategy.test.js

@@ -0,0 +1,79 @@
+/**
+ * pb context — BET-205 Slice 2 regression tests.
+ *
+ * Verifies:
+ * 1. CLI `pb context <entry-id>` calls chain.gatherContext with entryId + maxHops only
+ * 2. No strategy parameter leaks into the entry-based gather call
+ *    (strategy is MCP-tool-only — the CLI context command is always entry-based)
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { runContext } from '../commands/context.js';
+import { setOutputMode } from '../lib/runner.js';
+const kernelCallMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    kernelCall: (...args) => kernelCallMock(...args),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+const GATHER_FIXTURE = {
+    root: { entryId: 'BET-205', name: 'Vector Seed Spike' },
+    related: [
+        {
+            entryId: 'DEC-324',
+            name: 'Embeddings via OpenRouter',
+            collectionName: 'Decisions',
+            relationType: 'informed_by',
+            relationDirection: 'incoming',
+            hop: 1,
+        },
+    ],
+    totalRelations: 1,
+    hopsTraversed: 1,
+};
+let stdoutOutput;
+let stderrOutput;
+let stdoutWriteSpy;
+let stderrWriteSpy;
+beforeEach(() => {
+    stdoutOutput = '';
+    stderrOutput = '';
+    stdoutWriteSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+        stdoutOutput += String(chunk);
+        return true;
+    });
+    stderrWriteSpy = vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+        stderrOutput += String(chunk);
+        return true;
+    });
+    kernelCallMock.mockReset();
+    setOutputMode('pretty');
+});
+afterEach(() => {
+    stdoutWriteSpy.mockRestore();
+    stderrWriteSpy.mockRestore();
+    setOutputMode('auto');
+});
+describe('runContext — entry-based gather (BET-205 S2 regression)', () => {
+    it('calls chain.gatherContext with entryId and maxHops only', async () => {
+        kernelCallMock.mockResolvedValue(GATHER_FIXTURE);
+        await runContext({ entryId: 'BET-205' });
+        expect(kernelCallMock).toHaveBeenCalledWith('chain.gatherContext', {
+            entryId: 'BET-205',
+            maxHops: 2,
+        });
+    });
+    it('does not pass strategy to chain.gatherContext', async () => {
+        kernelCallMock.mockResolvedValue(GATHER_FIXTURE);
+        await runContext({ entryId: 'BET-205' });
+        const callArgs = kernelCallMock.mock.calls[0][1];
+        expect(callArgs).not.toHaveProperty('strategy');
+    });
+    it('renders context output correctly', async () => {
+        kernelCallMock.mockResolvedValue(GATHER_FIXTURE);
+        await runContext({ entryId: 'BET-205' });
+        expect(stdoutOutput).toContain('BET-205');
+        expect(stdoutOutput).toContain('Vector Seed Spike');
+    });
+});
+//# sourceMappingURL=context-strategy.test.js.map

package/dist/__tests__/context-strategy.test.js.map

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

package/dist/__tests__/envelope-contract.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cross-surface envelope contract — CLI side (WP-321 E6 S9).
+ *
+ * Mirrors packages/mcp-server/src/__tests__/envelope-contract.test.ts.
+ * Together they prove the same gateway bytes work correctly for both surfaces.
+ *
+ * CLI contract:
+ *   kernelCall / kernelCallWithSession extract envelope.data from HTTP responses.
+ *   ok:false or non-200 → throw McpError.
+ *
+ * Same mock HTTP response is used here as in the MCP envelope-contract test,
+ * proving both surfaces consume the same gateway bytes correctly (WP-321 done-when).
+ */
+export {};
+//# sourceMappingURL=envelope-contract.test.d.ts.map

package/dist/__tests__/envelope-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/envelope-contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/__tests__/envelope-contract.test.js

@@ -0,0 +1,126 @@
+/**
+ * Cross-surface envelope contract — CLI side (WP-321 E6 S9).
+ *
+ * Mirrors packages/mcp-server/src/__tests__/envelope-contract.test.ts.
+ * Together they prove the same gateway bytes work correctly for both surfaces.
+ *
+ * CLI contract:
+ *   kernelCall / kernelCallWithSession extract envelope.data from HTTP responses.
+ *   ok:false or non-200 → throw McpError.
+ *
+ * Same mock HTTP response is used here as in the MCP envelope-contract test,
+ * proving both surfaces consume the same gateway bytes correctly (WP-321 done-when).
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// ─── Module mocks (must precede imports that trigger side effects) ────────────
+vi.mock('../lib/config.js', () => ({
+    getConfig: vi.fn(() => ({
+        apiKey: 'pb_sk_test',
+        siteUrl: 'https://example.convex.site',
+    })),
+    resolveAdminConfig: vi.fn(),
+}));
+vi.mock('../lib/session.js', () => ({
+    readSession: vi.fn(() => null),
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('../lib/spinner.js', () => ({
+    withSpinner: vi.fn((_label, fn) => fn()),
+}));
+// ─── Imports (after mocks) ────────────────────────────────────────────────────
+import { kernelCall, kernelCallWithSession, McpError } from '../lib/client.js';
+function makeSuccessResponse(body, status = 200) {
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        statusText: 'OK',
+        json: async () => body,
+    };
+}
+function makeErrorResponse(body, status) {
+    return {
+        ok: false,
+        status,
+        statusText: 'Error',
+        json: async () => body,
+    };
+}
+function installFetch(response) {
+    global.fetch = vi.fn().mockResolvedValue(response);
+}
+// ─── Tests ────────────────────────────────────────────────────────────────────
+describe("CLI envelope contract — kernelCall", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("success: extracts data from ok:true envelope", async () => {
+        // Same gateway bytes as MCP envelope-contract test
+        installFetch(makeSuccessResponse({
+            ok: true,
+            summary: "Orient complete",
+            data: { entries: [] },
+            next: [{ tool: "capture", description: "Capture next", parameters: {} }],
+            _meta: { durationMs: 42 },
+        }));
+        const data = await kernelCall("chain.getOrientEntries", { workspaceId: "ws-1" });
+        // CLI extracts only data — agent summary/next/meta are not passed to CLI callers
+        expect(data).toEqual({ entries: [] });
+    });
+    it("success without next: data field is correctly extracted", async () => {
+        installFetch(makeSuccessResponse({
+            ok: true,
+            summary: "Done",
+            data: { id: "ENT-1" },
+        }));
+        const data = await kernelCall("chain.getEntry", { entryId: "ENT-1" });
+        expect(data).toEqual({ id: "ENT-1" });
+    });
+    it("error: non-200 HTTP throws McpError with kernel message", async () => {
+        installFetch(makeErrorResponse({
+            ok: false,
+            code: "NOT_FOUND",
+            message: "Entry not found",
+        }, 404));
+        await expect(kernelCall("chain.getEntry", { entryId: "ENT-MISSING" })).rejects.toThrow(McpError);
+        await expect(kernelCall("chain.getEntry", { entryId: "ENT-MISSING" })).rejects.toSatisfy((err) => {
+            if (!(err instanceof McpError))
+                return false;
+            return err.message.includes("Entry not found");
+        });
+    });
+    it("error: ok:false at HTTP 200 throws McpError (forward-compat for DEC-571)", async () => {
+        // DEC-571: gateway returns ok:false at HTTP 200 for soft failures
+        installFetch(makeSuccessResponse({
+            ok: false,
+            code: "VALIDATION_FAILED",
+            message: "Required field missing",
+        }, 200));
+        await expect(kernelCall("chain.capture", { name: "" })).rejects.toThrow(McpError);
+    });
+});
+describe("CLI envelope contract — kernelCallWithSession", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("success: extracts data from ok:true envelope (same as kernelCall)", async () => {
+        installFetch(makeSuccessResponse({
+            ok: true,
+            summary: "Entry created",
+            data: { entryId: "BET-99", name: "Test bet" },
+            _meta: { durationMs: 100 },
+        }));
+        const data = await kernelCallWithSession("agentKnowledge.captureEnvelope", { name: "Test bet" });
+        expect(data).toEqual({ entryId: "BET-99", name: "Test bet" });
+    });
+    it("error: ok:false with HTTP 200 throws McpError (same as kernelCall)", async () => {
+        installFetch(makeSuccessResponse({
+            ok: false,
+            code: "COMMIT_BLOCKED",
+            message: "Strategy link missing",
+        }, 200));
+        await expect(kernelCallWithSession("agentKnowledge.captureEnvelope", { name: "" })).rejects.toThrow(McpError);
+    });
+});
+//# sourceMappingURL=envelope-contract.test.js.map

package/dist/__tests__/envelope-contract.test.js.map

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

package/dist/__tests__/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/__tests__/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/errors.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/errors.test.js

@@ -0,0 +1,117 @@
+/**
+ * CLIError + McpError — unit tests.
+ * WP-302 Slice 0: Error Taxonomy + Commander Migration.
+ *
+ * Verifies:
+ * - CLIError serializes correctly with code, category, guidance
+ * - CLIError works with just a message (optional fields default)
+ * - McpError extends CLIError and retains backward compat
+ * - McpError maps server codes to categories
+ */
+import { describe, expect, it } from 'vitest';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { McpError } from '../lib/client.js';
+describe('CLIError', () => {
+    it('serializes all fields to JSON', () => {
+        const err = new CLIError('No API key configured', {
+            code: ErrorCode.AUTH_MISSING,
+            category: 'auth',
+            guidance: 'Run `pb login` to configure your API key.',
+        });
+        expect(err.message).toBe('No API key configured');
+        expect(err.code).toBe('AUTH_MISSING');
+        expect(err.category).toBe('auth');
+        expect(err.guidance).toBe('Run `pb login` to configure your API key.');
+        const json = err.toJSON();
+        expect(json).toEqual({
+            error: 'No API key configured',
+            code: 'AUTH_MISSING',
+            category: 'auth',
+            guidance: 'Run `pb login` to configure your API key.',
+        });
+    });
+    it('defaults to INTERNAL code and internal category when no options given', () => {
+        const err = new CLIError('Something broke');
+        expect(err.code).toBe('INTERNAL');
+        expect(err.category).toBe('internal');
+        expect(err.guidance).toBeUndefined();
+        const json = err.toJSON();
+        expect(json).toEqual({
+            error: 'Something broke',
+            code: 'INTERNAL',
+            category: 'internal',
+        });
+        // guidance should NOT appear in JSON when undefined
+        expect(json).not.toHaveProperty('guidance');
+    });
+    it('is an instance of Error', () => {
+        const err = new CLIError('test');
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.name).toBe('CLIError');
+    });
+    it('supports all defined error codes', () => {
+        // Verify the ErrorCode object has all expected keys
+        expect(ErrorCode.AUTH_MISSING).toBe('AUTH_MISSING');
+        expect(ErrorCode.AUTH_INVALID).toBe('AUTH_INVALID');
+        expect(ErrorCode.AUTH_DENIED).toBe('AUTH_DENIED');
+        expect(ErrorCode.NETWORK_UNREACHABLE).toBe('NETWORK_UNREACHABLE');
+        expect(ErrorCode.NETWORK_TIMEOUT).toBe('NETWORK_TIMEOUT');
+        expect(ErrorCode.CONFIG_MISSING).toBe('CONFIG_MISSING');
+        expect(ErrorCode.CONFIG_INVALID).toBe('CONFIG_INVALID');
+        expect(ErrorCode.SESSION_REQUIRED).toBe('SESSION_REQUIRED');
+        expect(ErrorCode.VALIDATION_FAILED).toBe('VALIDATION_FAILED');
+        expect(ErrorCode.INTERNAL).toBe('INTERNAL');
+    });
+});
+describe('McpError', () => {
+    it('extends CLIError', () => {
+        const err = new McpError('Server error');
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err).toBeInstanceOf(McpError);
+        expect(err.name).toBe('McpError');
+    });
+    it('preserves backward-compatible interface (message, code, details)', () => {
+        const details = [
+            {
+                fieldKey: 'status',
+                fieldLabel: 'Status',
+                invalidValue: 'bogus',
+                validOptions: ['draft', 'active'],
+                errorType: 'invalid_option',
+                message: 'Invalid status value',
+            },
+        ];
+        const err = new McpError('Validation failed', 'VALIDATION_FAILED', details);
+        expect(err.message).toBe('Validation failed');
+        expect(err.code).toBe('VALIDATION_FAILED');
+        expect(err.details).toEqual(details);
+        expect(err.category).toBe('validation');
+    });
+    it('maps AUTH codes to auth category', () => {
+        const err = new McpError('Unauthorized', 'AUTH_DENIED');
+        expect(err.category).toBe('auth');
+    });
+    it('maps UNAUTHORIZED to auth category', () => {
+        const err = new McpError('Unauthorized', 'UNAUTHORIZED');
+        expect(err.category).toBe('auth');
+    });
+    it('maps SESSION_REQUIRED to session category', () => {
+        const err = new McpError('No session', 'SESSION_REQUIRED');
+        expect(err.category).toBe('session');
+    });
+    it('defaults to INTERNAL code and internal category when no code given', () => {
+        const err = new McpError('Unknown error');
+        expect(err.code).toBe('INTERNAL');
+        expect(err.category).toBe('internal');
+    });
+    it('serializes via toJSON from CLIError', () => {
+        const err = new McpError('Bad request', 'VALIDATION_FAILED');
+        const json = err.toJSON();
+        expect(json.error).toBe('Bad request');
+        expect(json.code).toBe('VALIDATION_FAILED');
+        expect(json.category).toBe('validation');
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/__tests__/errors.test.js.map

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