@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.70

package/dist/__tests__/session.test.js

@@ -0,0 +1,46 @@
+/**
+ * pb session id — verify local session read behavior.
+ * TEN-341 test contract: has session → prints ID, no session → exits 1.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runSessionId } from '../commands/session.js';
+vi.mock('../lib/client.js', () => ({
+    mcpCall: vi.fn(),
+    mcpCallWithSession: vi.fn(),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(),
+}));
+describe('runSessionId', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('prints session ID bare to stdout when session exists', () => {
+        mockSession = {
+            sessionId: 'rd79ppnrs9k8d4vtak39pzfmex8378f3',
+            workspaceId: 'ws-1',
+            workspaceName: 'Product Brain',
+            startedAt: '2026-03-19T12:00:00Z',
+            entriesCaptured: [],
+        };
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        runSessionId();
+        expect(writeSpy).toHaveBeenCalledWith('rd79ppnrs9k8d4vtak39pzfmex8378f3\n');
+        writeSpy.mockRestore();
+    });
+    it('throws CLIError when no session', () => {
+        mockSession = null;
+        expect(() => runSessionId()).toThrow('No active session');
+    });
+});
+//# sourceMappingURL=session.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../src/__tests__/session.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;IAChB,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC5B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAC3B,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAC/E;CACF,CAAC,CAAC,CAAC;AAEJ,IAAI,WAAW,GAA2H,IAAI,CAAC;AAC/I,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW;IAC9B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC1B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;CACtB,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,WAAW,GAAG;YACZ,SAAS,EAAE,kCAAkC;YAC7C,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,eAAe;YAC9B,SAAS,EAAE,sBAAsB;YACjC,eAAe,EAAE,EAAE;SACpB,CAAC;QACF,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAElF,YAAY,EAAE,CAAC;QAEf,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,oCAAoC,CAAC,CAAC;QAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/setup.test.js

@@ -0,0 +1,141 @@
+/**
+ * pb setup — guided onboarding tests.
+ * WP-301 Slice 3, WP-304 (LLM onboarding). Verifies:
+ *   - setup with valid existing config goes to onboarding conversation
+ *   - setup with no config triggers login prompt
+ *   - setup tracks telemetry events
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// Track telemetry calls in order
+const telemetryEvents = [];
+vi.mock('../lib/telemetry.js', () => ({
+    trackEvent: (event) => {
+        telemetryEvents.push(event);
+    },
+    initTelemetry: vi.fn(),
+}));
+const mcpCallMock = vi.fn();
+const mcpCallWithSessionMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCall: (...args) => mcpCallMock(...args),
+    mcpCallWithSession: (...args) => mcpCallWithSessionMock(...args),
+}));
+let mockConfig = {
+    apiKey: 'pb_sk_test_key_1234',
+    siteUrl: 'https://test.convex.site',
+};
+vi.mock('../lib/config.js', () => ({
+    getConfig: () => {
+        if (!mockConfig)
+            throw new Error('No API key.');
+        return mockConfig;
+    },
+    getConfigOrGuide: vi.fn(() => mockConfig
+        ? Promise.resolve(mockConfig)
+        : Promise.reject(new Error('No API key.'))),
+    HOME_CONFIG_DIR: '/tmp/test-config',
+    HOME_ENV_PATH: '/tmp/test-config/.env',
+}));
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+const runLoginMock = vi.fn();
+vi.mock('../commands/login.js', () => ({
+    runLogin: () => runLoginMock(),
+}));
+// Mock both onboarding paths — they have their own test files
+const runOnboardingMock = vi.fn();
+vi.mock('../lib/onboarding.js', () => ({
+    runOnboardingConversation: (...args) => runOnboardingMock(...args),
+}));
+const runOnboardingPathBMock = vi.fn();
+vi.mock('../lib/onboarding-path-b.js', () => ({
+    runOnboardingPathB: (...args) => runOnboardingPathBMock(...args),
+}));
+vi.mock('../lib/experiment.js', () => ({
+    isExperimentActive: () => false,
+    assignOnboardingPath: () => 'B',
+}));
+let confirmAnswers = [];
+let confirmIndex = 0;
+vi.mock('../lib/prompts.js', () => ({
+    confirm: () => {
+        const answer = confirmAnswers[confirmIndex] ?? false;
+        confirmIndex++;
+        return Promise.resolve(answer);
+    },
+    ask: () => Promise.resolve(''),
+    password: () => Promise.resolve(''),
+    select: () => Promise.resolve(''),
+    isInteractive: () => true,
+}));
+import { runSetup } from '../commands/setup.js';
+describe('runSetup', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        runOnboardingPathBMock.mockReset();
+        telemetryEvents.length = 0;
+        confirmAnswers = [];
+        confirmIndex = 0;
+        mockConfig = { apiKey: 'pb_sk_test_key_1234', siteUrl: 'https://test.convex.site' };
+        mockSession = null;
+    });
+    it('skips login when valid config exists and runs onboarding', async () => {
+        mcpCallMock.mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }); // resolveWorkspace
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should NOT call runLogin
+        expect(runLoginMock).not.toHaveBeenCalled();
+        // Should show masked key
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('pb_sk_'));
+        // Should show workspace name
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Test Workspace'));
+        // Should call onboarding path B (default path)
+        expect(runOnboardingPathBMock).toHaveBeenCalledWith('Test Workspace');
+        logSpy.mockRestore();
+    });
+    it('triggers login prompt when no valid config exists', async () => {
+        mockConfig = null;
+        // User answers: false to "Do you have an account?"
+        confirmAnswers = [false];
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should show signup guidance
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('productbrain.io'));
+        // Should NOT call runLogin since user said no account
+        expect(runLoginMock).not.toHaveBeenCalled();
+        logSpy.mockRestore();
+    });
+    it('calls runLogin when user has account but no config', async () => {
+        mockConfig = null;
+        // User answers: true to "have account?"
+        confirmAnswers = [true];
+        // After login, config becomes valid
+        runLoginMock.mockImplementation(() => {
+            mockConfig = { apiKey: 'pb_sk_new_key', siteUrl: 'https://test.convex.site' };
+        });
+        mcpCallMock.mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }); // resolveWorkspace
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        expect(runLoginMock).toHaveBeenCalledOnce();
+        expect(telemetryEvents).toContain('key_validated');
+        // Should call onboarding path B after login (default path)
+        expect(runOnboardingPathBMock).toHaveBeenCalledWith('Test Workspace');
+        logSpy.mockRestore();
+    });
+    it('handles workspace verification failure gracefully', async () => {
+        mcpCallMock.mockRejectedValueOnce(new Error('Network error')); // resolveWorkspace fails
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should warn about connection
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Could not verify'));
+        // Should NOT call onboarding
+        expect(runOnboardingMock).not.toHaveBeenCalled();
+        logSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=setup.test.js.map

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

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

package/dist/__tests__/spinner-labels.test.d.ts

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

package/dist/__tests__/spinner-labels.test.d.ts.map

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

package/dist/__tests__/spinner-labels.test.js

@@ -0,0 +1,23 @@
+/**
+ * spinnerLabel — unit tests.
+ * WP-303 Slice 2: Ambient Feedback (Spinners).
+ *
+ * Verifies the MCP function name -> friendly label mapping.
+ */
+import { describe, expect, it } from 'vitest';
+import { spinnerLabel } from '../lib/client.js';
+describe('spinnerLabel', () => {
+    it('maps known MCP functions to friendly labels', () => {
+        expect(spinnerLabel('orient')).toBe('Loading workspace overview');
+        expect(spinnerLabel('entries.get')).toBe('Loading entry');
+        expect(spinnerLabel('capture-quick')).toBe('Capturing to Chain');
+        expect(spinnerLabel('agent.startSession')).toBe('Starting session');
+    });
+    it('generates a fallback label for unknown functions', () => {
+        expect(spinnerLabel('some.unknown.tool')).toBe('Loading some unknown tool');
+    });
+    it('handles simple function names in fallback', () => {
+        expect(spinnerLabel('foobar')).toBe('Loading foobar');
+    });
+});
+//# sourceMappingURL=spinner-labels.test.js.map

package/dist/__tests__/spinner-labels.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-labels.test.js","sourceRoot":"","sources":["../../src/__tests__/spinner-labels.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAClE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/strip.test.js

@@ -0,0 +1,136 @@
+/**
+ * stripConvexInternals — unit tests.
+ * BET-181 Slice 0: TEN-340 (Convex internal exposure), DEC-299 (JSON-default output).
+ *
+ * Verifies: removes _id and _creationTime, preserves entryId and all other fields,
+ * handles nested objects and arrays, does not mutate input.
+ */
+import { describe, expect, it } from 'vitest';
+import { stripConvexInternals } from '../lib/strip.js';
+describe('stripConvexInternals', () => {
+    it('removes _id from a flat object', () => {
+        const input = { _id: 'j57abc', entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        expect(result).toHaveProperty('name', 'Test');
+    });
+    it('removes _creationTime from a flat object', () => {
+        const input = { _creationTime: 1700000000000, entryId: 'BET-181', name: 'Test' };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toHaveProperty('entryId', 'BET-181');
+    });
+    it('removes both _id and _creationTime simultaneously', () => {
+        const input = {
+            _id: 'j57abc',
+            _creationTime: 1700000000000,
+            entryId: 'BET-181',
+            name: 'Test',
+            status: 'active',
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        expect(result).not.toHaveProperty('_creationTime');
+        expect(result).toEqual({ entryId: 'BET-181', name: 'Test', status: 'active' });
+    });
+    it('preserves entryId (human-readable) unconditionally', () => {
+        const input = { _id: 'sys1', _creationTime: 123, entryId: 'DEC-299' };
+        const result = stripConvexInternals(input);
+        expect(result).toHaveProperty('entryId', 'DEC-299');
+    });
+    it('preserves all other fields untouched', () => {
+        const input = {
+            _id: 'sys1',
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'work-packages',
+            data: { description: 'hello' },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).toEqual({
+            name: 'My entry',
+            status: 'draft',
+            collectionSlug: 'work-packages',
+            data: { description: 'hello' },
+        });
+    });
+    it('recursively strips _id and _creationTime from nested objects', () => {
+        const input = {
+            entryId: 'BET-181',
+            relations: [
+                { _id: 'rel1', _creationTime: 111, type: 'part_of', otherEntryId: 'INI-1' },
+            ],
+            data: {
+                _id: 'should-be-removed',
+                description: 'keep this',
+            },
+        };
+        const result = stripConvexInternals(input);
+        // Top level
+        expect(result).toHaveProperty('entryId', 'BET-181');
+        // Nested in array
+        const rel = result.relations[0];
+        expect(rel).not.toHaveProperty('_id');
+        expect(rel).not.toHaveProperty('_creationTime');
+        expect(rel).toHaveProperty('type', 'part_of');
+        expect(rel).toHaveProperty('otherEntryId', 'INI-1');
+        // Nested in object
+        const data = result.data;
+        expect(data).not.toHaveProperty('_id');
+        expect(data).toHaveProperty('description', 'keep this');
+    });
+    it('handles arrays of objects', () => {
+        const input = [
+            { _id: 'a', entryId: 'BET-1', name: 'Bet 1' },
+            { _id: 'b', _creationTime: 999, entryId: 'TEN-1', name: 'Tension 1' },
+        ];
+        const result = stripConvexInternals(input);
+        expect(result).toHaveLength(2);
+        expect(result[0]).not.toHaveProperty('_id');
+        expect(result[0]).toHaveProperty('entryId', 'BET-1');
+        expect(result[1]).not.toHaveProperty('_id');
+        expect(result[1]).not.toHaveProperty('_creationTime');
+        expect(result[1]).toHaveProperty('entryId', 'TEN-1');
+    });
+    it('handles null values without error', () => {
+        const result = stripConvexInternals(null);
+        expect(result).toBeNull();
+    });
+    it('handles primitive values (string, number, boolean) as pass-through', () => {
+        expect(stripConvexInternals('hello')).toBe('hello');
+        expect(stripConvexInternals(42)).toBe(42);
+        expect(stripConvexInternals(true)).toBe(true);
+    });
+    it('does not mutate the input object', () => {
+        const input = { _id: 'sys1', entryId: 'BET-1', name: 'Test' };
+        const inputCopy = { ...input };
+        stripConvexInternals(input);
+        expect(input).toEqual(inputCopy);
+    });
+    it('handles empty objects and arrays', () => {
+        expect(stripConvexInternals({})).toEqual({});
+        expect(stripConvexInternals([])).toEqual([]);
+    });
+    it('handles deeply nested structures', () => {
+        const input = {
+            _id: 'top',
+            level1: {
+                _id: 'l1',
+                level2: {
+                    _id: 'l2',
+                    _creationTime: 123,
+                    value: 'deep',
+                },
+            },
+        };
+        const result = stripConvexInternals(input);
+        expect(result).not.toHaveProperty('_id');
+        const r = result;
+        expect(r.level1).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_id');
+        expect(r.level1.level2).not.toHaveProperty('_creationTime');
+        expect(r.level1.level2['value']).toBe('deep');
+    });
+});
+//# sourceMappingURL=strip.test.js.map

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

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

package/dist/__tests__/surface-profiles.test.d.ts

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

package/dist/__tests__/surface-profiles.test.d.ts.map

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

package/dist/__tests__/surface-profiles.test.js

@@ -0,0 +1,233 @@
+/**
+ * surface-profiles — unit tests.
+ * BET-270 Slice 0: type system + registry.
+ * BET-270 Slice 4: pluggable surface registration + fallback.
+ */
+import { describe, expect, it, beforeEach } from 'vitest';
+import { SURFACE_PROFILES, resolveSurfaceProfile, validateSurfaceProfile, registerSurface, getRegisteredSurfaces, _resetRuntimeRegistryForTesting, } from '../generators/surface-profiles.js';
+// ── Helper ─────────────────────────────────────────────────────────────
+function isValidProfile(profile) {
+    if (!profile || typeof profile !== 'object')
+        return false;
+    const p = profile;
+    return (['batch', 'interactive', 'passive'].includes(p.executionModel) &&
+        ['multi-file', 'single-file'].includes(p.format) &&
+        ['stateless', 'conversational', 'autonomous'].includes(p.sessionModel) &&
+        typeof p.tokenBudget === 'number' &&
+        p.tokenBudget > 0 &&
+        ['orchestrated', 'direct', 'guided'].includes(p.workflowStyle));
+}
+const VALID_CUSTOM_PROFILE = {
+    executionModel: 'batch',
+    format: 'single-file',
+    sessionModel: 'autonomous',
+    tokenBudget: 20000,
+    workflowStyle: 'direct',
+};
+// ── Registry ───────────────────────────────────────────────────────────
+describe('SURFACE_PROFILES registry', () => {
+    it('defines all 4 known targets', () => {
+        expect(Object.keys(SURFACE_PROFILES).sort()).toEqual(['claude', 'codex', 'copilot', 'cursor']);
+    });
+    it.each(['claude', 'cursor', 'codex', 'copilot'])('%s profile has all required fields with correct types', (target) => {
+        expect(isValidProfile(SURFACE_PROFILES[target])).toBe(true);
+    });
+    it('claude profile has correct values', () => {
+        const p = SURFACE_PROFILES.claude;
+        expect(p.executionModel).toBe('interactive');
+        expect(p.format).toBe('multi-file');
+        expect(p.sessionModel).toBe('conversational');
+        expect(p.tokenBudget).toBe(50000);
+        expect(p.workflowStyle).toBe('orchestrated');
+    });
+    it('cursor profile has correct values', () => {
+        const p = SURFACE_PROFILES.cursor;
+        expect(p.executionModel).toBe('interactive');
+        expect(p.format).toBe('multi-file');
+        expect(p.sessionModel).toBe('conversational');
+        expect(p.tokenBudget).toBe(50000);
+        expect(p.workflowStyle).toBe('orchestrated');
+    });
+    it('codex profile has correct values', () => {
+        const p = SURFACE_PROFILES.codex;
+        expect(p.executionModel).toBe('batch');
+        expect(p.format).toBe('multi-file');
+        expect(p.sessionModel).toBe('autonomous');
+        expect(p.tokenBudget).toBe(100000);
+        expect(p.workflowStyle).toBe('direct');
+    });
+    it('copilot profile has correct values', () => {
+        const p = SURFACE_PROFILES.copilot;
+        expect(p.executionModel).toBe('passive');
+        expect(p.format).toBe('single-file');
+        expect(p.sessionModel).toBe('stateless');
+        expect(p.tokenBudget).toBe(30000);
+        expect(p.workflowStyle).toBe('guided');
+    });
+});
+// ── Resolver ──────────────────────────────────────────────────────────
+describe('resolveSurfaceProfile', () => {
+    it.each(['claude', 'cursor', 'codex', 'copilot'])('resolves known target "%s" to a valid profile', (target) => {
+        const profile = resolveSurfaceProfile(target);
+        expect(isValidProfile(profile)).toBe(true);
+    });
+    it('resolves "claude" to the claude profile', () => {
+        expect(resolveSurfaceProfile('claude')).toBe(SURFACE_PROFILES.claude);
+    });
+    it('resolves "cursor" to the cursor profile', () => {
+        expect(resolveSurfaceProfile('cursor')).toBe(SURFACE_PROFILES.cursor);
+    });
+    it('resolves "codex" to the codex profile', () => {
+        expect(resolveSurfaceProfile('codex')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('resolves "copilot" to the copilot profile', () => {
+        expect(resolveSurfaceProfile('copilot')).toBe(SURFACE_PROFILES.copilot);
+    });
+    it('returns codex profile as fallback for unknown targets', () => {
+        expect(resolveSurfaceProfile('unknown-tool')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('returns codex profile for empty string', () => {
+        expect(resolveSurfaceProfile('')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('fallback profile is a valid profile', () => {
+        const fallback = resolveSurfaceProfile('completely-unknown-surface');
+        expect(isValidProfile(fallback)).toBe(true);
+    });
+});
+// ── validateSurfaceProfile ────────────────────────────────────────────
+describe('validateSurfaceProfile', () => {
+    it('accepts a valid profile', () => {
+        expect(validateSurfaceProfile(VALID_CUSTOM_PROFILE)).toBe(true);
+    });
+    it('accepts each built-in profile', () => {
+        for (const target of ['claude', 'cursor', 'codex', 'copilot']) {
+            expect(validateSurfaceProfile(SURFACE_PROFILES[target])).toBe(true);
+        }
+    });
+    it('rejects null', () => {
+        expect(validateSurfaceProfile(null)).toBe(false);
+    });
+    it('rejects a non-object', () => {
+        expect(validateSurfaceProfile('string')).toBe(false);
+        expect(validateSurfaceProfile(42)).toBe(false);
+    });
+    it('rejects a profile missing executionModel', () => {
+        const { executionModel: _, ...rest } = VALID_CUSTOM_PROFILE;
+        expect(validateSurfaceProfile(rest)).toBe(false);
+    });
+    it('rejects a profile missing format', () => {
+        const { format: _, ...rest } = VALID_CUSTOM_PROFILE;
+        expect(validateSurfaceProfile(rest)).toBe(false);
+    });
+    it('rejects a profile missing sessionModel', () => {
+        const { sessionModel: _, ...rest } = VALID_CUSTOM_PROFILE;
+        expect(validateSurfaceProfile(rest)).toBe(false);
+    });
+    it('rejects a profile missing tokenBudget', () => {
+        const { tokenBudget: _, ...rest } = VALID_CUSTOM_PROFILE;
+        expect(validateSurfaceProfile(rest)).toBe(false);
+    });
+    it('rejects a profile missing workflowStyle', () => {
+        const { workflowStyle: _, ...rest } = VALID_CUSTOM_PROFILE;
+        expect(validateSurfaceProfile(rest)).toBe(false);
+    });
+    it('rejects wrong type for executionModel', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, executionModel: 'serverless' })).toBe(false);
+    });
+    it('rejects wrong type for format', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, format: 'multi-page' })).toBe(false);
+    });
+    it('rejects wrong type for sessionModel', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, sessionModel: 'ephemeral' })).toBe(false);
+    });
+    it('rejects tokenBudget of zero', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, tokenBudget: 0 })).toBe(false);
+    });
+    it('rejects negative tokenBudget', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, tokenBudget: -1 })).toBe(false);
+    });
+    it('rejects non-numeric tokenBudget', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, tokenBudget: '50000' })).toBe(false);
+    });
+    it('rejects wrong type for workflowStyle', () => {
+        expect(validateSurfaceProfile({ ...VALID_CUSTOM_PROFILE, workflowStyle: 'manual' })).toBe(false);
+    });
+});
+// ── registerSurface + getRegisteredSurfaces ───────────────────────────
+describe('registerSurface', () => {
+    beforeEach(() => {
+        _resetRuntimeRegistryForTesting();
+    });
+    it('adds a new surface that resolveSurfaceProfile can find', () => {
+        registerSurface('my-tool', VALID_CUSTOM_PROFILE);
+        expect(resolveSurfaceProfile('my-tool')).toBe(VALID_CUSTOM_PROFILE);
+    });
+    it('registered surface profile is not the codex fallback', () => {
+        registerSurface('my-tool', VALID_CUSTOM_PROFILE);
+        const resolved = resolveSurfaceProfile('my-tool');
+        expect(resolved).not.toBe(SURFACE_PROFILES.codex);
+        expect(resolved).toBe(VALID_CUSTOM_PROFILE);
+    });
+    it('throws on invalid profile (missing field)', () => {
+        const { executionModel: _, ...bad } = VALID_CUSTOM_PROFILE;
+        expect(() => registerSurface('bad-tool', bad)).toThrow();
+    });
+    it('throws on invalid profile (wrong type)', () => {
+        expect(() => registerSurface('bad-tool', { ...VALID_CUSTOM_PROFILE, tokenBudget: 0 })).toThrow();
+    });
+    it('throws when attempting to overwrite a built-in surface', () => {
+        expect(() => registerSurface('claude', VALID_CUSTOM_PROFILE)).toThrow();
+        expect(() => registerSurface('cursor', VALID_CUSTOM_PROFILE)).toThrow();
+        expect(() => registerSurface('codex', VALID_CUSTOM_PROFILE)).toThrow();
+        expect(() => registerSurface('copilot', VALID_CUSTOM_PROFILE)).toThrow();
+    });
+    it('does not mutate built-in SURFACE_PROFILES after attempted overwrite', () => {
+        const original = { ...SURFACE_PROFILES.claude };
+        try {
+            registerSurface('claude', VALID_CUSTOM_PROFILE);
+        }
+        catch {
+            // expected
+        }
+        expect(SURFACE_PROFILES.claude).toEqual(original);
+    });
+});
+describe('getRegisteredSurfaces', () => {
+    beforeEach(() => {
+        _resetRuntimeRegistryForTesting();
+    });
+    it('returns all 4 built-in surfaces with no registrations', () => {
+        expect(getRegisteredSurfaces().sort()).toEqual(['claude', 'codex', 'copilot', 'cursor']);
+    });
+    it('includes runtime-registered surfaces', () => {
+        registerSurface('my-tool', VALID_CUSTOM_PROFILE);
+        expect(getRegisteredSurfaces()).toContain('my-tool');
+    });
+    it('returns built-ins + registered in combined list', () => {
+        registerSurface('tool-a', VALID_CUSTOM_PROFILE);
+        registerSurface('tool-b', { ...VALID_CUSTOM_PROFILE, tokenBudget: 5000 });
+        const surfaces = getRegisteredSurfaces();
+        expect(surfaces).toContain('claude');
+        expect(surfaces).toContain('tool-a');
+        expect(surfaces).toContain('tool-b');
+        expect(surfaces).toHaveLength(6);
+    });
+});
+describe('resolveSurfaceProfile (runtime registration)', () => {
+    beforeEach(() => {
+        _resetRuntimeRegistryForTesting();
+    });
+    it('returns registered profile (not codex fallback) for a registered surface', () => {
+        registerSurface('windsurf', VALID_CUSTOM_PROFILE);
+        expect(resolveSurfaceProfile('windsurf')).toBe(VALID_CUSTOM_PROFILE);
+    });
+    it('still returns codex fallback for unregistered unknown surfaces', () => {
+        expect(resolveSurfaceProfile('not-registered')).toBe(SURFACE_PROFILES.codex);
+    });
+    it('built-in surfaces are unaffected by runtime registrations', () => {
+        registerSurface('my-tool', VALID_CUSTOM_PROFILE);
+        expect(resolveSurfaceProfile('claude')).toBe(SURFACE_PROFILES.claude);
+        expect(resolveSurfaceProfile('codex')).toBe(SURFACE_PROFILES.codex);
+    });
+});
+//# sourceMappingURL=surface-profiles.test.js.map