@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.50

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

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

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

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

package/dist/__tests__/constants.test.js

@@ -0,0 +1,141 @@
+/**
+ * constants — unit tests.
+ * WP-301 Slice 0: Verify DEFAULT_SITE_URL, resolveSiteUrl(), resolveAppUrl(), isDevMode().
+ */
+import { describe, expect, it, beforeEach, afterEach } from 'vitest';
+import { DEFAULT_SITE_URL, resolveSiteUrl, resolveAppUrl, isDevMode, resolveConnectRedeemUrl, } from '../lib/constants.js';
+describe('DEFAULT_SITE_URL', () => {
+    it('is the production Convex site URL', () => {
+        expect(DEFAULT_SITE_URL).toBe('https://gateway.productbrain.io');
+    });
+});
+describe('resolveSiteUrl', () => {
+    let originalPbEnv;
+    beforeEach(() => {
+        originalPbEnv = process.env.PB_ENV;
+    });
+    afterEach(() => {
+        if (originalPbEnv === undefined) {
+            delete process.env.PB_ENV;
+        }
+        else {
+            process.env.PB_ENV = originalPbEnv;
+        }
+    });
+    it('returns localhost URL when PB_ENV=dev', () => {
+        process.env.PB_ENV = 'dev';
+        expect(resolveSiteUrl()).toBe('http://localhost:5176');
+    });
+    it('returns production URL when PB_ENV=production', () => {
+        process.env.PB_ENV = 'production';
+        expect(resolveSiteUrl()).toBe(DEFAULT_SITE_URL);
+    });
+    it('returns production URL when PB_ENV is unset', () => {
+        delete process.env.PB_ENV;
+        expect(resolveSiteUrl()).toBe(DEFAULT_SITE_URL);
+    });
+    it('is case-insensitive for dev', () => {
+        process.env.PB_ENV = 'DEV';
+        expect(resolveSiteUrl()).toBe('http://localhost:5176');
+    });
+});
+describe('resolveAppUrl', () => {
+    let originalPbEnv;
+    beforeEach(() => {
+        originalPbEnv = process.env.PB_ENV;
+    });
+    afterEach(() => {
+        if (originalPbEnv === undefined) {
+            delete process.env.PB_ENV;
+        }
+        else {
+            process.env.PB_ENV = originalPbEnv;
+        }
+    });
+    it('returns localhost URL when PB_ENV=dev', () => {
+        process.env.PB_ENV = 'dev';
+        expect(resolveAppUrl()).toBe('http://localhost:5173');
+    });
+    it('returns production URL when PB_ENV=production', () => {
+        process.env.PB_ENV = 'production';
+        expect(resolveAppUrl()).toBe('https://work.productbrain.io');
+    });
+    it('returns production URL when PB_ENV is unset', () => {
+        delete process.env.PB_ENV;
+        expect(resolveAppUrl()).toBe('https://work.productbrain.io');
+    });
+});
+describe('resolveConnectRedeemUrl', () => {
+    let originalGateway;
+    let originalConvex;
+    beforeEach(() => {
+        originalGateway = process.env.PB_CONNECT_GATEWAY_URL;
+        originalConvex = process.env.CONVEX_SITE_URL;
+        delete process.env.PB_CONNECT_GATEWAY_URL;
+        delete process.env.CONVEX_SITE_URL;
+    });
+    afterEach(() => {
+        if (originalGateway === undefined)
+            delete process.env.PB_CONNECT_GATEWAY_URL;
+        else
+            process.env.PB_CONNECT_GATEWAY_URL = originalGateway;
+        if (originalConvex === undefined)
+            delete process.env.CONVEX_SITE_URL;
+        else
+            process.env.CONVEX_SITE_URL = originalConvex;
+    });
+    it('returns production URL when no env vars are set', () => {
+        expect(resolveConnectRedeemUrl()).toBe(DEFAULT_SITE_URL);
+    });
+    it('uses CONVEX_SITE_URL when set (dev deployment)', () => {
+        process.env.CONVEX_SITE_URL = 'https://my-dev-deploy.convex.site';
+        expect(resolveConnectRedeemUrl()).toBe('https://my-dev-deploy.convex.site');
+    });
+    it('PB_CONNECT_GATEWAY_URL wins over CONVEX_SITE_URL', () => {
+        process.env.CONVEX_SITE_URL = 'https://my-dev-deploy.convex.site';
+        process.env.PB_CONNECT_GATEWAY_URL = 'https://custom-gateway.example.com/';
+        expect(resolveConnectRedeemUrl()).toBe('https://custom-gateway.example.com');
+    });
+    it('CLI gateway overrides all env vars', () => {
+        process.env.PB_CONNECT_GATEWAY_URL = 'https://env-gateway.example.com';
+        process.env.CONVEX_SITE_URL = 'https://my-dev-deploy.convex.site';
+        expect(resolveConnectRedeemUrl('https://cli-gateway.example.com')).toBe('https://cli-gateway.example.com');
+    });
+    it('trims trailing slash from all sources', () => {
+        expect(resolveConnectRedeemUrl('https://example.com/foo/')).toBe('https://example.com/foo');
+        process.env.CONVEX_SITE_URL = 'https://deploy.convex.site/';
+        expect(resolveConnectRedeemUrl()).toBe('https://deploy.convex.site');
+    });
+    it('ignores PB_ENV — Convex HTTP Actions are always cloud-hosted', () => {
+        process.env.PB_ENV = 'dev';
+        expect(resolveConnectRedeemUrl()).toBe(DEFAULT_SITE_URL);
+        delete process.env.PB_ENV;
+    });
+});
+describe('isDevMode', () => {
+    let originalPbEnv;
+    beforeEach(() => {
+        originalPbEnv = process.env.PB_ENV;
+    });
+    afterEach(() => {
+        if (originalPbEnv === undefined) {
+            delete process.env.PB_ENV;
+        }
+        else {
+            process.env.PB_ENV = originalPbEnv;
+        }
+    });
+    it('returns true when PB_ENV=dev', () => {
+        process.env.PB_ENV = 'dev';
+        expect(isDevMode()).toBe(true);
+    });
+    it('returns false when PB_ENV=production', () => {
+        process.env.PB_ENV = 'production';
+        expect(isDevMode()).toBe(false);
+    });
+    it('returns false when PB_ENV is unset', () => {
+        delete process.env.PB_ENV;
+        expect(isDevMode()).toBe(false);
+    });
+});
+//# sourceMappingURL=constants.test.js.map

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

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

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

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

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

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

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 mcpCall 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 mcpCallMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCall: (...args) => mcpCallMock(...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 () => {
+        mcpCallMock.mockResolvedValue(CONSTELLATION_FIXTURE);
+        await runConstellation({ entryId: 'BET-181' });
+        expect(mcpCallMock).toHaveBeenCalledWith('chain.getConstellation', { entryId: 'BET-181' });
+    }));
+    it('outputs entry and grouped relations as JSON in non-TTY mode', withTty(false, async () => {
+        mcpCallMock.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 },
+        };
+        mcpCallMock.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 () => {
+        mcpCallMock.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 () => {
+        mcpCallMock.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 () => {
+        mcpCallMock.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: [],
+            },
+        };
+        mcpCallMock.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: [],
+            },
+        };
+        mcpCallMock.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'],
+            },
+        };
+        mcpCallMock.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 () => {
+        mcpCallMock.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 mcpCallMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCall: (...args) => mcpCallMock(...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;
+    });
+    mcpCallMock.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 () => {
+        mcpCallMock.mockResolvedValue(GATHER_FIXTURE);
+        await runContext({ entryId: 'BET-205' });
+        expect(mcpCallMock).toHaveBeenCalledWith('chain.gatherContext', {
+            entryId: 'BET-205',
+            maxHops: 2,
+        });
+    });
+    it('does not pass strategy to chain.gatherContext', async () => {
+        mcpCallMock.mockResolvedValue(GATHER_FIXTURE);
+        await runContext({ entryId: 'BET-205' });
+        const callArgs = mcpCallMock.mock.calls[0][1];
+        expect(callArgs).not.toHaveProperty('strategy');
+    });
+    it('renders context output correctly', async () => {
+        mcpCallMock.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__/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