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

package/dist/__tests__/conversation.test.js

@@ -0,0 +1,113 @@
+/**
+ * WP-479 E2 (client half) — conversation identity resolution + normalization.
+ *
+ * Done-when criteria tested:
+ *   1. Priority order: explicit override > PB_CONVERSATION_ID > CLAUDE_CODE_SESSION_ID >
+ *      CURSOR_CONVERSATION_ID > CODEX_TUI_SESSION_LOG_PATH > null.
+ *   2. Normalization: ids over 128 chars, or containing any char outside [A-Za-z0-9._-], are
+ *      replaced with their sha256 hex digest — never truncated (join-key stability).
+ *   3. CODEX_TUI_SESSION_LOG_PATH (a filesystem path, always containing "/") is always hashed.
+ *   4. No identity signal at all resolves to null (legacy path).
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createHash } from 'crypto';
+import { resolveConversationId, normalizeConversationId } from '../lib/conversation.js';
+const ENV_KEYS = [
+    'PB_CONVERSATION_ID',
+    'CLAUDE_CODE_SESSION_ID',
+    'CURSOR_CONVERSATION_ID',
+    'CODEX_TUI_SESSION_LOG_PATH',
+];
+const savedEnv = {};
+beforeEach(() => {
+    for (const key of ENV_KEYS) {
+        savedEnv[key] = process.env[key];
+        delete process.env[key];
+    }
+});
+afterEach(() => {
+    for (const key of ENV_KEYS) {
+        if (savedEnv[key] === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = savedEnv[key];
+    }
+});
+function sha256(s) {
+    return createHash('sha256').update(s).digest('hex');
+}
+describe('resolveConversationId() — priority order', () => {
+    it('returns null when no signal is present at all (legacy path)', () => {
+        expect(resolveConversationId()).toBeNull();
+    });
+    it('detects PB_CONVERSATION_ID when nothing else is set', () => {
+        process.env.PB_CONVERSATION_ID = 'conv-abc';
+        expect(resolveConversationId()).toBe('conv-abc');
+    });
+    it('detects CLAUDE_CODE_SESSION_ID when PB_CONVERSATION_ID is absent', () => {
+        process.env.CLAUDE_CODE_SESSION_ID = 'claude-sess-1';
+        expect(resolveConversationId()).toBe('claude-sess-1');
+    });
+    it('detects CURSOR_CONVERSATION_ID when the two above are absent', () => {
+        process.env.CURSOR_CONVERSATION_ID = 'cursor-conv-1';
+        expect(resolveConversationId()).toBe('cursor-conv-1');
+    });
+    it('hashes CODEX_TUI_SESSION_LOG_PATH when it is the only signal', () => {
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/codex/session-log-1.jsonl';
+        expect(resolveConversationId()).toBe(sha256('/tmp/codex/session-log-1.jsonl'));
+    });
+    it('PB_CONVERSATION_ID wins over every other env channel', () => {
+        process.env.PB_CONVERSATION_ID = 'winner';
+        process.env.CLAUDE_CODE_SESSION_ID = 'loser-1';
+        process.env.CURSOR_CONVERSATION_ID = 'loser-2';
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/loser-3';
+        expect(resolveConversationId()).toBe('winner');
+    });
+    it('CLAUDE_CODE_SESSION_ID wins over CURSOR_CONVERSATION_ID and CODEX', () => {
+        process.env.CLAUDE_CODE_SESSION_ID = 'winner';
+        process.env.CURSOR_CONVERSATION_ID = 'loser-1';
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/loser-2';
+        expect(resolveConversationId()).toBe('winner');
+    });
+    it('CURSOR_CONVERSATION_ID wins over CODEX', () => {
+        process.env.CURSOR_CONVERSATION_ID = 'winner';
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/loser';
+        expect(resolveConversationId()).toBe('winner');
+    });
+    it('an explicit override wins over every env channel (the --conversation flag seam)', () => {
+        process.env.PB_CONVERSATION_ID = 'env-value';
+        expect(resolveConversationId('flag-value')).toBe('flag-value');
+    });
+    it('an empty-string / whitespace-only explicit override is ignored, falling through to env', () => {
+        process.env.PB_CONVERSATION_ID = 'env-value';
+        expect(resolveConversationId('   ')).toBe('env-value');
+        expect(resolveConversationId('')).toBe('env-value');
+    });
+});
+describe('normalizeConversationId() — join-key safety', () => {
+    it('leaves a short, safe-charset id untouched', () => {
+        expect(normalizeConversationId('abc-123.DEF_456')).toBe('abc-123.DEF_456');
+    });
+    it('hashes an id over 128 chars — never truncates (no slice-collision risk)', () => {
+        const long = 'a'.repeat(129);
+        expect(normalizeConversationId(long)).toBe(sha256(long));
+        // A 128-char id (the boundary) stays untouched.
+        const boundary = 'a'.repeat(128);
+        expect(normalizeConversationId(boundary)).toBe(boundary);
+    });
+    it('hashes an id containing a path separator (path-escape closed, Pass 5)', () => {
+        const traversal = '../../etc/passwd';
+        expect(normalizeConversationId(traversal)).toBe(sha256(traversal));
+    });
+    it('hashes an id containing any other unsafe char (space, colon, slash, etc.)', () => {
+        expect(normalizeConversationId('has space')).toBe(sha256('has space'));
+        expect(normalizeConversationId('has:colon')).toBe(sha256('has:colon'));
+        expect(normalizeConversationId('has/slash')).toBe(sha256('has/slash'));
+    });
+    it('two distinct long ids that would collide under slice() hash to different values', () => {
+        const idA = 'x'.repeat(200) + 'AAA';
+        const idB = 'x'.repeat(200) + 'BBB';
+        expect(normalizeConversationId(idA)).not.toBe(normalizeConversationId(idB));
+    });
+});
+//# sourceMappingURL=conversation.test.js.map

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

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

package/dist/__tests__/entry-formatter.test.d.ts

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

package/dist/__tests__/entry-formatter.test.d.ts.map

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

package/dist/__tests__/entry-formatter.test.js

@@ -0,0 +1,82 @@
+/**
+ * formatEntry — honest attestation qualifier on the `pb get` Verification line (WP-A T8).
+ * Chain: attestation-model spec §5 (connectors never re-derive), §11 (rollout: optional fields).
+ */
+import { describe, it, expect } from 'vitest';
+import { formatEntry } from '../formatters/entry.js';
+function baseEntry(overrides = {}) {
+    return {
+        entryId: 'TEN-1',
+        name: 'Example entry',
+        canonicalKey: 'tension',
+        status: 'active',
+        ...overrides,
+    };
+}
+describe('formatEntry — Verification line', () => {
+    it('shows the honest qualifier when verifiedBy + attestation are present', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'verified',
+            verifiedBy: 'agent for Randy Hereman',
+            attestation: { strength: 'delegated' },
+        }));
+        expect(output).toContain('Verification: verified — by agent for Randy Hereman (delegated)');
+    });
+    it('falls back to the bare form when verifiedBy + attestation are absent (old server, spec §11)', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'verified',
+        }));
+        expect(output).toContain('Verification: verified');
+        expect(output).not.toContain('Verification: verified —');
+    });
+    it('unverified entry is rendered unchanged, with no attestation suffix', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'unverified',
+        }));
+        expect(output).toContain('Verification: unverified');
+        expect(output).not.toContain('Verification: unverified —');
+    });
+    // Final-review Fix 1: the pre-branch legacy corpus (no legs, no marker → basis
+    // 'legacy-unclassified', spec §7.1) must never render "— by <false founder name>
+    // (delegated)" — the server ships the resolved legacy string in verifiedBy.
+    it('renders the honest legacy qualifier when basis is not attested', () => {
+        const output = formatEntry(baseEntry({
+            verificationStatus: 'verified',
+            verifiedBy: 'legacy — unclassified',
+            attestation: { strength: 'delegated', basis: 'legacy-unclassified' },
+        }));
+        expect(output).toContain('Verification: verified (legacy — unclassified)');
+        expect(output).not.toContain('— by legacy — unclassified');
+    });
+});
+// WP-D (attestation spec §7.2): the ledger stays append-only — the false history
+// sentence stays as written; the server-derived qualifier renders BESIDE it.
+describe('formatEntry — History legacy qualifier', () => {
+    it('renders the server-shipped qualifier beside a legacy verified event', () => {
+        const output = formatEntry(baseEntry({
+            history: [
+                {
+                    timestamp: Date.UTC(2026, 2, 1),
+                    event: 'verified',
+                    changedBy: 'Randy Hereman',
+                    note: 'Entry verified by Randy Hereman',
+                    legacyQualifier: 'legacy record — reads as delegated (assumed delegated — never attributed)',
+                },
+            ],
+        }));
+        // The original sentence is preserved…
+        expect(output).toContain('Entry verified by Randy Hereman');
+        // …and the honest qualifier renders beside it.
+        expect(output).toContain('[legacy record — reads as delegated (assumed delegated — never attributed)]');
+    });
+    it('adds no qualifier when the server ships none (genuine attestation / old server)', () => {
+        const output = formatEntry(baseEntry({
+            history: [
+                { timestamp: Date.UTC(2026, 6, 1), event: 'verified', changedBy: 'agent:sess1', note: 'Entry verified by agent for Randy Hereman' },
+            ],
+        }));
+        expect(output).toContain('Entry verified by agent for Randy Hereman');
+        expect(output).not.toContain('[legacy');
+    });
+});
+//# sourceMappingURL=entry-formatter.test.js.map

package/dist/__tests__/entry-formatter.test.js.map

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

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

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

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

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

package/dist/__tests__/entryArchive.test.js

@@ -0,0 +1,35 @@
+/**
+ * pb entry archive — verify it relays to runUpdate with status:'archived' +
+ * the DEDICATED archivedReason arg (DEC-1572, WP-640 S4) — never via --field
+ * (archivedReason is platform-owned; convex/lib/platformOwnedDataKeys.ts
+ * silently strips it from generic caller data — live-verified). Thin client
+ * (BR-104): the reason enum is validated server-side
+ * (convex/lib/archivedReasonGuard.ts) — this file only checks the relay shape.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { runEntryArchive } from '../commands/entryArchive.js';
+const runUpdateMock = vi.fn((_options) => Promise.resolve());
+vi.mock('../commands/update.js', () => ({
+    runUpdate: (options) => runUpdateMock(options),
+}));
+describe('runEntryArchive', () => {
+    it('relays --reason as the dedicated archivedReason arg with status:archived', async () => {
+        await runEntryArchive({ entryId: 'STD-1', reason: 'superseded' });
+        expect(runUpdateMock).toHaveBeenCalledWith({
+            entryId: 'STD-1',
+            status: 'archived',
+            archivedReason: 'superseded',
+            note: undefined,
+        });
+    });
+    it('threads --note through unchanged', async () => {
+        await runEntryArchive({ entryId: 'STD-1', reason: 'duplicate', note: 'dup of STD-9' });
+        expect(runUpdateMock).toHaveBeenCalledWith({
+            entryId: 'STD-1',
+            status: 'archived',
+            archivedReason: 'duplicate',
+            note: 'dup of STD-9',
+        });
+    });
+});
+//# sourceMappingURL=entryArchive.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entryArchive.test.js","sourceRoot":"","sources":["../../src/__tests__/entryArchive.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,QAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACtE,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,SAAS,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC;CACxD,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC;YACzC,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,YAAY;YAC5B,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC;YACzC,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,WAAW;YAC3B,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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,154 @@
+/**
+ * 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',
+    })),
+}));
+vi.mock('../lib/adminConfig.js', () => ({
+    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()),
+}));
+const recordServerLatestMock = vi.fn();
+vi.mock('../lib/update-check.js', () => ({
+    recordServerLatest: (version) => recordServerLatestMock(version),
+}));
+// ─── Imports (after mocks) ────────────────────────────────────────────────────
+import { kernelCall, kernelCallWithSession, validateKey, McpError } from '../lib/client.js';
+function makeSuccessResponse(body, status = 200, latestVersion = null) {
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        statusText: 'OK',
+        json: async () => body,
+        headers: { get: (name) => name.toLowerCase() === 'pb-latest-cli-version' ? latestVersion : null },
+    };
+}
+function makeErrorResponse(body, status, latestVersion = null) {
+    return {
+        ok: false,
+        status,
+        statusText: 'Error',
+        json: async () => body,
+        headers: { get: (name) => name.toLowerCase() === 'pb-latest-cli-version' ? latestVersion : null },
+    };
+}
+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("records pb-latest-cli-version header before returning data", async () => {
+        installFetch(makeSuccessResponse({
+            ok: true,
+            summary: "Orient complete",
+            data: { entries: [] },
+        }, 200, '0.1.0-beta.109'));
+        await kernelCall("chain.getOrientEntries", {});
+        expect(recordServerLatestMock).toHaveBeenCalledWith('0.1.0-beta.109');
+    });
+    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 — validateKey", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("records server latest header before preserving invalid-key behavior on 401", async () => {
+        installFetch(makeErrorResponse({ error: 'Invalid or expired authorization token' }, 401, '0.1.0-beta.109'));
+        const result = await validateKey('pb_sk_stale', 'https://example.convex.site');
+        expect(result).toEqual({ valid: false, error: 'Invalid API key.' });
+        expect(recordServerLatestMock).toHaveBeenCalledWith('0.1.0-beta.109');
+    });
+});
+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,143 @@
+/**
+ * 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.UPGRADE_FAILED).toBe('UPGRADE_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 ARGUMENT_VALIDATION_FAILED to validation category (TEN-2647)', () => {
+        // Convex's own arg-validator rejection is a 400 the caller fixes by correcting
+        // the offending argument — never an internal fault.
+        const err = new McpError('ArgumentValidationError: Object is missing the required field `score`.', 'ARGUMENT_VALIDATION_FAILED');
+        expect(err.code).toBe('ARGUMENT_VALIDATION_FAILED');
+        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('normalizes the server permission code to stable CLI AUTH_DENIED', () => {
+        const err = new McpError('Another team owns this record', 'AUTHZ_PERMISSION_DENIED');
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+    // WP-584 S4 review round 1 (P2-3): BR-227's own code — convex/http.ts's vendor-gate 403 —
+    // must normalize the SAME way, not fall through the `as` cast and publish Convex's raw
+    // internal code as a fake CLI ErrorCodeValue. Mirrors packages/mcp-server/src/errors.ts's
+    // own AUTHZ_* family test.
+    it('normalizes AUTHZ_INSUFFICIENT_ROLE (BR-227: active session, wrong role) to stable CLI AUTH_DENIED', () => {
+        const err = new McpError('Vendor access required.', 'AUTHZ_INSUFFICIENT_ROLE');
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+    it('normalizes any other AUTHZ_* code to stable CLI AUTH_DENIED (family match, not a fixed list)', () => {
+        const err = new McpError('Not a member.', 'AUTHZ_NOT_MEMBER');
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+    });
+    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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"}

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

@@ -0,0 +1,6 @@
+/**
+ * Tests for experiment assignment (WP-304).
+ * Verifies deterministic, roughly even distribution.
+ */
+export {};
+//# sourceMappingURL=experiment.test.d.ts.map

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

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