@productbrain/cli 0.1.0-beta.29 → 0.1.0-beta.32

package/dist/__tests__/login.test.js

@@ -0,0 +1,168 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// ---------------------------------------------------------------------------
+// Mocks
+// ---------------------------------------------------------------------------
+const validateKeyMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    validateKey: (...args) => validateKeyMock(...args),
+}));
+vi.mock('../lib/config.js', () => ({
+    HOME_CONFIG_DIR: '/tmp/test-pb-config',
+    HOME_ENV_PATH: '/tmp/test-pb-config/.env',
+}));
+const mkdirSyncMock = vi.fn();
+const writeFileSyncMock = vi.fn();
+vi.mock('fs', () => ({
+    mkdirSync: (...args) => mkdirSyncMock(...args),
+    writeFileSync: (...args) => writeFileSyncMock(...args),
+    existsSync: vi.fn(() => false),
+    readFileSync: vi.fn(() => ''),
+}));
+// Mock readline — simulate user pasting a key
+let readlineAnswer = '';
+vi.mock('readline', () => ({
+    createInterface: () => ({
+        question: (_prompt, cb) => cb(readlineAnswer),
+        close: vi.fn(),
+    }),
+}));
+// Capture console/process output
+const consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+const consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+const stdoutWriteSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+// Track process.exit calls without throwing (so try/catch in login.ts doesn't catch it)
+let exitCode;
+vi.spyOn(process, 'exit').mockImplementation((code) => {
+    exitCode = code;
+    // Return undefined as never — the function won't actually continue
+    // but the test can check exitCode after the call
+    return undefined;
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('pb login — key validation', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        readlineAnswer = '';
+        exitCode = undefined;
+        delete process.env.CONVEX_SITE_URL;
+    });
+    it('saves key on successful validation', async () => {
+        readlineAnswer = 'pb_sk_valid_key_123';
+        validateKeyMock.mockResolvedValue({ valid: true, workspaceId: 'ws-123' });
+        const { runLogin } = await import('../commands/login.js');
+        await runLogin();
+        expect(validateKeyMock).toHaveBeenCalledWith('pb_sk_valid_key_123', 'https://gateway.productbrain.io');
+        expect(writeFileSyncMock).toHaveBeenCalledTimes(1);
+        expect(writeFileSyncMock.mock.calls[0][1]).toContain('PRODUCTBRAIN_API_KEY=pb_sk_valid_key_123');
+        expect(stdoutWriteSpy).toHaveBeenCalledWith(' connected.\n\n');
+        expect(exitCode).toBeUndefined();
+    });
+    it('rejects invalid key (401) without saving', async () => {
+        readlineAnswer = 'pb_sk_bad_key';
+        validateKeyMock.mockResolvedValue({ valid: false, error: 'Invalid API key.' });
+        const { runLogin } = await import('../commands/login.js');
+        await runLogin();
+        expect(writeFileSyncMock).not.toHaveBeenCalled();
+        expect(exitCode).toBe(1);
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('Invalid key'));
+        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('work.productbrain.io'));
+    });
+    it('saves key on network timeout with warning', async () => {
+        readlineAnswer = 'pb_sk_offline_key';
+        validateKeyMock.mockRejectedValue(new Error('fetch failed'));
+        const { runLogin } = await import('../commands/login.js');
+        await runLogin();
+        expect(writeFileSyncMock).toHaveBeenCalledTimes(1);
+        expect(writeFileSyncMock.mock.calls[0][1]).toContain('PRODUCTBRAIN_API_KEY=pb_sk_offline_key');
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining('Could not reach server'));
+        expect(exitCode).toBeUndefined();
+    });
+    it('exits on empty key', async () => {
+        readlineAnswer = '';
+        const { runLogin } = await import('../commands/login.js');
+        await runLogin();
+        expect(exitCode).toBe(1);
+        expect(validateKeyMock).not.toHaveBeenCalled();
+        expect(writeFileSyncMock).not.toHaveBeenCalled();
+    });
+    it('exits on key without pb_sk_ prefix', async () => {
+        readlineAnswer = 'sk_not_a_pb_key';
+        const { runLogin } = await import('../commands/login.js');
+        await runLogin();
+        expect(exitCode).toBe(1);
+        expect(validateKeyMock).not.toHaveBeenCalled();
+        expect(writeFileSyncMock).not.toHaveBeenCalled();
+    });
+    it('shows signup URL in error message', async () => {
+        readlineAnswer = 'pb_sk_bad';
+        validateKeyMock.mockResolvedValue({ valid: false, error: 'Invalid API key.' });
+        const { runLogin } = await import('../commands/login.js');
+        await runLogin();
+        // Signup URL should appear in the error output
+        const allErrorCalls = consoleErrorSpy.mock.calls.flat().join(' ');
+        expect(allErrorCalls).toContain('work.productbrain.io');
+    });
+});
+describe('validateKey()', () => {
+    const originalFetch = globalThis.fetch;
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it('returns valid on 200 with workspace data', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: () => Promise.resolve({ data: { _id: 'ws-abc' } }),
+        });
+        const mod = await vi.importActual('../lib/client.js');
+        const result = await mod.validateKey('pb_sk_test', 'https://test.convex.site');
+        expect(result).toEqual({ valid: true, workspaceId: 'ws-abc' });
+    });
+    it('returns invalid on 401', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: () => Promise.resolve({ error: 'Unauthorized' }),
+        });
+        const mod = await vi.importActual('../lib/client.js');
+        const result = await mod.validateKey('pb_sk_bad', 'https://test.convex.site');
+        expect(result).toEqual({ valid: false, error: 'Invalid API key.' });
+    });
+    it('returns invalid on 403', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 403,
+            json: () => Promise.resolve({ error: 'Forbidden' }),
+        });
+        const mod = await vi.importActual('../lib/client.js');
+        const result = await mod.validateKey('pb_sk_bad', 'https://test.convex.site');
+        expect(result).toEqual({ valid: false, error: 'Invalid API key.' });
+    });
+    it('returns invalid on server error with message', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 500,
+            json: () => Promise.resolve({ error: 'Internal server error' }),
+        });
+        const mod = await vi.importActual('../lib/client.js');
+        const result = await mod.validateKey('pb_sk_test', 'https://test.convex.site');
+        expect(result).toEqual({ valid: false, error: 'Internal server error' });
+    });
+    it('throws on network error (fetch failed)', async () => {
+        globalThis.fetch = vi.fn().mockRejectedValue(new Error('fetch failed'));
+        const mod = await vi.importActual('../lib/client.js');
+        await expect(mod.validateKey('pb_sk_test', 'https://test.convex.site')).rejects.toThrow('fetch failed');
+    });
+    it('throws on timeout (abort)', async () => {
+        globalThis.fetch = vi.fn().mockImplementation(() => new Promise((_, reject) => setTimeout(() => reject(new Error('AbortError')), 100)));
+        const mod = await vi.importActual('../lib/client.js');
+        await expect(mod.validateKey('pb_sk_test', 'https://test.convex.site', 50)).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=login.test.js.map

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

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

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

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

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

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

package/dist/__tests__/profiles.test.js

@@ -0,0 +1,168 @@
+/**
+ * Profile system tests — WP-302 Slice 2.
+ * Tests: CRUD round-trip, auto-migration, resolution order,
+ * cannot-delete-active, session close on switch.
+ */
+import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { resolve } from 'path';
+// vi.hoisted runs before mock hoisting — safe to compute test paths here
+const { TEST_HOME, TEST_CONFIG_DIR, TEST_PROFILES_DIR, TEST_ACTIVE_PATH, TEST_LEGACY_PATH } = vi.hoisted(() => {
+    const os = require('os');
+    const path = require('path');
+    const home = path.resolve(os.tmpdir(), `pb-test-profiles-${process.pid}`);
+    return {
+        TEST_HOME: home,
+        TEST_CONFIG_DIR: path.resolve(home, '.config', 'productbrain'),
+        TEST_PROFILES_DIR: path.resolve(home, '.config', 'productbrain', 'profiles'),
+        TEST_ACTIVE_PATH: path.resolve(home, '.config', 'productbrain', 'active-profile'),
+        TEST_LEGACY_PATH: path.resolve(home, '.config', 'productbrain', '.env'),
+    };
+});
+vi.mock('os', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, homedir: () => TEST_HOME };
+});
+// Mock session to track close-on-switch
+const mockClearSession = vi.fn();
+let mockSessionState = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSessionState,
+    writeSession: vi.fn(),
+    clearSession: mockClearSession,
+    addCapturedEntry: vi.fn(),
+}));
+// Import after mocks
+import { listProfiles, getActiveProfile, createProfile, useProfile, deleteProfile, resolveProfileConfig, } from '../lib/profiles.js';
+describe('profiles', () => {
+    beforeEach(() => {
+        // Clean slate
+        if (existsSync(TEST_CONFIG_DIR)) {
+            rmSync(TEST_CONFIG_DIR, { recursive: true, force: true });
+        }
+        mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+        delete process.env.PB_PROFILE;
+        mockSessionState = null;
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        if (existsSync(TEST_HOME)) {
+            rmSync(TEST_HOME, { recursive: true, force: true });
+        }
+    });
+    describe('CRUD round-trip', () => {
+        it('creates, lists, and deletes a profile', () => {
+            createProfile('staging', 'pb_sk_test_staging');
+            const profiles = listProfiles();
+            expect(profiles).toContain('staging');
+            // First profile becomes active
+            expect(getActiveProfile()).toBe('staging');
+            // Create a second profile so we can delete the first
+            createProfile('dev', 'pb_sk_test_dev');
+            useProfile('dev');
+            deleteProfile('staging');
+            expect(listProfiles()).not.toContain('staging');
+        });
+        it('rejects duplicate profile names', () => {
+            createProfile('myprofile', 'pb_sk_test');
+            expect(() => createProfile('myprofile', 'pb_sk_test2')).toThrow(/already exists/);
+        });
+        it('rejects invalid profile names', () => {
+            expect(() => createProfile('My Profile!', 'pb_sk_test')).toThrow(/Invalid profile name/);
+            expect(() => createProfile('', 'pb_sk_test')).toThrow(/Invalid profile name/);
+            expect(() => createProfile('-bad', 'pb_sk_test')).toThrow(/Invalid profile name/);
+        });
+    });
+    describe('auto-migration from legacy .env', () => {
+        it('migrates legacy .env to default profile on first resolveProfileConfig()', () => {
+            // Set up legacy .env (no profiles dir yet)
+            writeFileSync(TEST_LEGACY_PATH, 'PRODUCTBRAIN_API_KEY=pb_sk_legacy_key\nCONVEX_SITE_URL=https://test.convex.site\n');
+            const config = resolveProfileConfig();
+            expect(config).not.toBeNull();
+            expect(config.apiKey).toBe('pb_sk_legacy_key');
+            // Should have created the default profile
+            expect(existsSync(resolve(TEST_PROFILES_DIR, 'default.env'))).toBe(true);
+            expect(readFileSync(TEST_ACTIVE_PATH, 'utf8').trim()).toBe('default');
+        });
+        it('does not re-migrate if profiles dir already exists', () => {
+            mkdirSync(TEST_PROFILES_DIR, { recursive: true });
+            writeFileSync(TEST_LEGACY_PATH, 'PRODUCTBRAIN_API_KEY=pb_sk_legacy_key\n');
+            // Profiles dir exists, so no migration
+            const config = resolveProfileConfig();
+            // Falls through to legacy .env directly
+            expect(config).not.toBeNull();
+            expect(config.apiKey).toBe('pb_sk_legacy_key');
+            // Should NOT have created a default profile
+            expect(existsSync(resolve(TEST_PROFILES_DIR, 'default.env'))).toBe(false);
+        });
+    });
+    describe('resolution order', () => {
+        it('PB_PROFILE env var wins over active-profile file', () => {
+            createProfile('prod', 'pb_sk_prod_key');
+            createProfile('staging', 'pb_sk_staging_key');
+            useProfile('prod');
+            process.env.PB_PROFILE = 'staging';
+            const config = resolveProfileConfig();
+            expect(config.apiKey).toBe('pb_sk_staging_key');
+        });
+        it('active-profile file wins over default', () => {
+            createProfile('default', 'pb_sk_default_key');
+            createProfile('custom', 'pb_sk_custom_key');
+            useProfile('custom');
+            const config = resolveProfileConfig();
+            expect(config.apiKey).toBe('pb_sk_custom_key');
+        });
+        it('falls back to default profile when no active-profile file', () => {
+            mkdirSync(TEST_PROFILES_DIR, { recursive: true });
+            writeFileSync(resolve(TEST_PROFILES_DIR, 'default.env'), 'PRODUCTBRAIN_API_KEY=pb_sk_fallback\n', { mode: 0o600 });
+            const config = resolveProfileConfig();
+            expect(config.apiKey).toBe('pb_sk_fallback');
+        });
+    });
+    describe('cannot delete active profile', () => {
+        it('throws PROFILE_IS_ACTIVE error', () => {
+            createProfile('active-one', 'pb_sk_test');
+            createProfile('other', 'pb_sk_test2');
+            useProfile('active-one');
+            expect(() => deleteProfile('active-one')).toThrow(/Cannot delete the active profile/);
+        });
+    });
+    describe('cannot delete last profile', () => {
+        it('throws PROFILE_IS_LAST error', () => {
+            createProfile('only-one', 'pb_sk_test');
+            createProfile('other', 'pb_sk_test2');
+            useProfile('other');
+            deleteProfile('only-one');
+            // Now 'other' is the last profile — PROFILE_IS_LAST fires before PROFILE_IS_ACTIVE
+            expect(() => deleteProfile('other')).toThrow(/Cannot delete the last profile/);
+        });
+    });
+    describe('profile use', () => {
+        it('switches active profile', () => {
+            createProfile('first', 'pb_sk_first');
+            createProfile('second', 'pb_sk_second');
+            useProfile('second');
+            expect(getActiveProfile()).toBe('second');
+            useProfile('first');
+            expect(getActiveProfile()).toBe('first');
+        });
+        it('errors on non-existent profile', () => {
+            expect(() => useProfile('nonexistent')).toThrow(/does not exist/);
+        });
+    });
+    describe('profile file format', () => {
+        it('stores apiKey and optional siteUrl', () => {
+            createProfile('with-url', 'pb_sk_test', 'https://custom.convex.site');
+            const content = readFileSync(resolve(TEST_PROFILES_DIR, 'with-url.env'), 'utf8');
+            expect(content).toContain('PRODUCTBRAIN_API_KEY=pb_sk_test');
+            expect(content).toContain('CONVEX_SITE_URL=https://custom.convex.site');
+        });
+        it('omits siteUrl when not provided', () => {
+            createProfile('no-url', 'pb_sk_test');
+            const content = readFileSync(resolve(TEST_PROFILES_DIR, 'no-url.env'), 'utf8');
+            expect(content).toContain('PRODUCTBRAIN_API_KEY=pb_sk_test');
+            expect(content).not.toContain('CONVEX_SITE_URL');
+        });
+    });
+});
+//# sourceMappingURL=profiles.test.js.map

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

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

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,170 @@
+/**
+ * pb setup — guided onboarding tests.
+ * WP-301 Slice 3. Verifies:
+ *   - setup with valid existing config skips login
+ *   - setup tracks telemetry events in order
+ *   - setup with no config triggers login prompt
+ *   - first capture flow starts session and creates entry
+ */
+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);
+    },
+}));
+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 readline — supply answers in sequence
+let readlineAnswers = [];
+let answerIndex = 0;
+vi.mock('readline', () => ({
+    createInterface: () => ({
+        question: (_prompt, cb) => {
+            const answer = readlineAnswers[answerIndex] ?? '';
+            answerIndex++;
+            cb(answer);
+        },
+        close: vi.fn(),
+    }),
+}));
+import { runSetup } from '../commands/setup.js';
+describe('runSetup', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        telemetryEvents.length = 0;
+        readlineAnswers = [];
+        answerIndex = 0;
+        mockConfig = { apiKey: 'pb_sk_test_key_1234', siteUrl: 'https://test.convex.site' };
+        mockSession = null;
+    });
+    it('skips login when valid config exists and user declines capture', async () => {
+        // User answers: "n" to "Skip to first capture?"
+        readlineAnswers = ['n'];
+        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'));
+        logSpy.mockRestore();
+    });
+    it('tracks telemetry events in correct order when user completes full flow with existing config', async () => {
+        // User answers: "y" to skip to capture, "y" to capture, then capture text
+        readlineAnswers = ['y', 'y', 'My first insight'];
+        mcpCallMock
+            .mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }) // resolveWorkspace (step 1)
+            .mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }) // resolveWorkspace (capture)
+            .mockResolvedValueOnce({ sessionId: 'sess-1', workspaceName: 'Test Workspace', initiatedBy: 'cli', toolsScope: 'readwrite' }); // startSession
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ docId: 'doc-1', entryId: 'INS-1' }); // createEntry
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        expect(telemetryEvents).toEqual([
+            'setup_started',
+            'workspace_bound',
+            'first_capture_prompted',
+            'setup_completed',
+        ]);
+        logSpy.mockRestore();
+    });
+    it('triggers login prompt when no valid config exists', async () => {
+        mockConfig = null;
+        // User answers: "n" to "Do you have an account?"
+        readlineAnswers = ['n'];
+        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: "y" to "have account?", then login runs,
+        // then "n" to capture prompt (via post-login rl)
+        readlineAnswers = ['y', 'n'];
+        // 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('setup_started');
+        expect(telemetryEvents).toContain('key_validated');
+        logSpy.mockRestore();
+    });
+    it('handles first capture with session creation', async () => {
+        // Already configured, user wants to capture
+        readlineAnswers = ['y', 'y', 'DEC: Use trunk-based dev'];
+        mcpCallMock
+            .mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }) // resolveWorkspace (verify)
+            .mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }) // resolveWorkspace (capture)
+            .mockResolvedValueOnce({ sessionId: 'sess-setup', workspaceName: 'Test Workspace', initiatedBy: 'cli', toolsScope: 'readwrite' }); // startSession
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ docId: 'doc-1', entryId: 'DEC-100' }); // createEntry
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should have called createEntry with the capture text
+        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.createEntry', expect.objectContaining({
+            name: 'DEC: Use trunk-based dev',
+            collectionSlug: 'insights',
+        }));
+        // Should show the entry ID
+        expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('DEC-100'));
+        logSpy.mockRestore();
+    });
+    it('skips capture gracefully when user enters empty text', async () => {
+        readlineAnswers = ['y', 'y', ''];
+        mcpCallMock
+            .mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }) // resolveWorkspace (verify)
+            .mockResolvedValueOnce({ _id: 'ws-1', keyId: 'key-1', name: 'Test Workspace' }) // resolveWorkspace (capture)
+            .mockResolvedValueOnce({ sessionId: 'sess-setup', workspaceName: 'Test Workspace', initiatedBy: 'cli', toolsScope: 'readwrite' }); // startSession
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runSetup();
+        // Should NOT call createEntry
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        // Should still complete setup
+        expect(telemetryEvents).toContain('setup_completed');
+        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/commands/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgDH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA4ED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmIvE"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkDH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA4ED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqJvE"}

package/dist/commands/capture.js

@@ -11,6 +11,8 @@ import { mcpCallWithSession } from '../lib/client.js';
 import { readSession, addCapturedEntry } from '../lib/session.js';
 import { isJsonMode } from '../lib/runner.js';
 import { formatCaptureReceipt } from '../formatters/capture.js';
+import { checkActivation } from '../lib/activation.js';
+import { progress } from '../lib/style.js';
 /**
  * Infer an ISO date (YYYY-MM-DD) from free-text values.
  *
@@ -113,7 +115,7 @@ export async function runCapture(options) {
     }
     else {
         if (!json)
-            process.stdout.write('Classifying...\n');
+            progress('Classifying...');
         classification = await mcpCallWithSession('chain.resolveCollection', {
             entryName,
             entryDescription,
@@ -126,7 +128,7 @@ export async function runCapture(options) {
     }
     // Phase 2: Create entry as draft
     if (!json)
-        process.stdout.write(`Capturing to ${collectionSlug}...\n`);
+        progress(`Capturing to ${collectionSlug}...`);
     const data = { description: entryDescription };
     // Only set date when we can infer a source date from the capture itself.
     const datedCollections = ['tensions', 'decisions', 'insights', 'standards', 'business-rules'];
@@ -147,6 +149,25 @@ export async function runCapture(options) {
     });
     // Track in session state
     addCapturedEntry(result.entryId);
+    // WP-301 S4: Activation ceremony — show contextual retrieval after first capture
+    if (!json) {
+        try {
+            const activation = await checkActivation(result.entryId);
+            if (activation?.isFirst && activation.relatedEntries.length > 0) {
+                process.stdout.write('\n  Your first capture is on the Chain. Here\'s how it connects:\n');
+                for (const rel of activation.relatedEntries.slice(0, 3)) {
+                    process.stdout.write(`    \u2192 ${rel.entryId}: ${rel.name} (${rel.relation})\n`);
+                }
+                process.stdout.write('\n');
+            }
+            else if (activation?.isFirst) {
+                process.stdout.write('\n  Your first capture is on the Chain! Run `pb orient -b` to see your workspace.\n\n');
+            }
+        }
+        catch {
+            // Activation is additive — never blocks capture
+        }
+    }
     // BET-272 S3: Advisory quality hints — from createEntryWithClassification result (BR-144)
     const qualityHints = result.qualityHints ?? [];
     // Phase 3: Link to existing entry if --link provided (TEN-705)