@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/commands/connect.test.js

@@ -0,0 +1,521 @@
+/**
+ * Tests for pb connect command (FEAT-958 S2).
+ * Covers token parsing, redemption, error handling, and key saving.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { homedir } from 'os';
+import { runConnect } from './connect.js';
+import { HOME_FOLDER_REFUSAL } from '../lib/projectConfig.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+// Mock withSpinner to bypass spinner logic in tests
+vi.mock('../lib/spinner.js', () => ({ withSpinner: vi.fn(async (_message, fn) => fn()) }));
+// The .gitignore seal runs real git; lib/productbrain-files.test.ts covers it in throwaway repos (TASK-641).
+vi.mock('../lib/productbrain-files.js', () => ({ sealConnectWrites: vi.fn(() => ({ git: false, added: [], stillExposed: [] })) }));
+// Mock fs operations
+vi.mock('fs', () => ({
+    mkdirSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    openSync: vi.fn((path) => path), // the fd stands in for the temp file it names (writePrivateFile)
+    fchmodSync: vi.fn(),
+    realpathSync: vi.fn((path) => path),
+    closeSync: vi.fn(),
+    renameSync: vi.fn(),
+    unlinkSync: vi.fn(),
+    existsSync: vi.fn(() => false),
+    readFileSync: vi.fn(),
+}));
+// Mock @clack/prompts (connect now uses interactive prompts)
+vi.mock('@clack/prompts', () => ({
+    select: vi.fn(async () => 'continue'),
+    isCancel: vi.fn(() => false),
+    text: vi.fn(async () => ''),
+}));
+// Mock the prompt gate (WP-2 confirm-first gate). Default = interactive + confirmed,
+// so existing happy-path tests flow through the gate; per-test overrides exercise
+// decline and non-interactive fail-closed.
+vi.mock('../lib/prompts.js', () => ({
+    confirm: vi.fn(async () => true),
+    isInteractive: vi.fn(() => true),
+}));
+// Mock profiles (connect saves key as named profile). createProfile is stubbed;
+// profileFileExists wraps the REAL implementation (name validation + the mocked fs above, so
+// "no profile on disk" by default) and the naming tests override it per test. This exercises
+// the actual name-validation regex/CLIError shape in the traversal tests, not a double.
+vi.mock('../lib/profiles.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        createProfile: vi.fn(),
+        profileFileExists: vi.fn((name) => actual.profileFileExists(name)),
+    };
+});
+// The folder part of the derived profile name (TASK-638): pinned so tests never depend on the
+// directory the suite runs from.
+vi.mock('../lib/connectProfileName.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, connectFolderName: vi.fn(() => 'my-repo') };
+});
+// readLocalProjectConfig is the REAL implementation by default; the own-pin test overrides it.
+vi.mock('../lib/config.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, readLocalProjectConfig: vi.fn(() => actual.readLocalProjectConfig()) };
+});
+vi.mock('../lib/session.js', () => ({ discardAllSessions: vi.fn() }));
+// Mock connect-screens (Ink TUI — cannot render in Vitest environment)
+vi.mock('./connect-screens.js', () => ({
+    runConnectScreens: vi.fn(async () => { }),
+    runConnectHeadless: vi.fn(async () => { }),
+}));
+// Import mocked modules after mocking
+import * as fs from 'fs';
+// Mock fetch globally
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+describe('pb connect', () => {
+    beforeEach(async () => {
+        mockFetch.mockClear();
+        vi.clearAllMocks();
+        // Restore the interactive + confirmed baseline. Some tests set mockReturnValue(false)
+        // on isInteractive, which clearAllMocks does NOT reset (it clears call history, not
+        // implementations) — so re-assert the default here to keep tests isolated.
+        const { isInteractive, confirm } = await import('../lib/prompts.js');
+        vi.mocked(isInteractive).mockReturnValue(true);
+        vi.mocked(confirm).mockResolvedValue(true);
+        process.env.PRODUCTBRAIN_API_KEY = undefined;
+        process.env.CONVEX_SITE_URL = undefined;
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('token validation', () => {
+        it('rejects token without pb_ct_ prefix', async () => {
+            await expect(runConnect('invalid_token')).rejects.toThrow(CLIError);
+            // Should not make fetch call
+            expect(mockFetch).not.toHaveBeenCalled();
+        });
+        it('rejects token that is too short', async () => {
+            await expect(runConnect('pb_ct_short')).rejects.toThrow(CLIError);
+            expect(mockFetch).not.toHaveBeenCalled();
+        });
+        it('TASK-562: refuses the home folder, naming the project folder, before the token is spent', async () => {
+            const cwd = vi.spyOn(process, 'cwd').mockReturnValue(homedir());
+            try {
+                const err = await runConnect('pb_ct_' + 'a'.repeat(40)).catch((e) => e);
+                expect(err).toBeInstanceOf(CLIError);
+                expect(err.message).toBe(HOME_FOLDER_REFUSAL);
+                expect(HOME_FOLDER_REFUSAL).toBe('Run pb connect in your project folder, not your home folder.');
+                expect(err.guidance).toBe('cd into your project, then run the same command. Your token still works.');
+                expect(mockFetch).not.toHaveBeenCalled();
+                expect(fs.writeFileSync).not.toHaveBeenCalled();
+            }
+            finally {
+                cwd.mockRestore();
+            }
+        });
+        it('accepts valid token format', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    ok: true,
+                    apiKey: 'pb_sk_test',
+                    workspaceId: 'ws123',
+                    workspaceName: 'My Workspace',
+                }),
+            });
+            await runConnect(validToken);
+            expect(mockFetch).toHaveBeenCalledOnce();
+        });
+    });
+    describe('token redemption', () => {
+        it('successfully redeems valid token', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            const mockResponse = {
+                ok: true,
+                apiKey: 'pb_sk_redeemed123',
+                workspaceId: 'ws456',
+                workspaceName: 'Dev Workspace',
+            };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => mockResponse,
+            });
+            await runConnect(validToken);
+            // Verify POST to /auth/redeem-connect-token
+            expect(mockFetch).toHaveBeenCalledWith(expect.stringContaining('/auth/redeem-connect-token'), expect.objectContaining({
+                method: 'POST',
+                headers: expect.objectContaining({ 'Content-Type': 'application/json' }),
+                body: JSON.stringify({ token: validToken }),
+            }));
+            // Verify profile was created and project config was written
+            const { createProfile } = await import('../lib/profiles.js');
+            expect(createProfile).toHaveBeenCalledWith('dev-workspace-my-repo', 'pb_sk_redeemed123', expect.any(String));
+            expect(fs.writeFileSync).toHaveBeenCalled();
+        });
+        it('includes name in redeem body when ConnectOptions.name is set', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    apiKey: 'pb_sk_named',
+                    workspaceId: 'ws456',
+                    workspaceName: 'Dev Workspace',
+                }),
+            });
+            await runConnect(validToken, { name: '  CI runner  ' });
+            expect(mockFetch).toHaveBeenCalledWith(expect.stringContaining('/auth/redeem-connect-token'), expect.objectContaining({
+                body: JSON.stringify({ token: validToken, name: 'CI runner' }),
+            }));
+        });
+        it('handles invalid_token error (400)', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 400,
+                json: async () => ({
+                    ok: false,
+                    error: {
+                        code: 'invalid_token',
+                        message: 'Token is invalid or expired',
+                    },
+                }),
+            });
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.code).toBe(ErrorCode.AUTH_INVALID);
+        });
+        it('handles workspace_not_found error (404)', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 404,
+                json: async () => ({
+                    ok: false,
+                    error: {
+                        code: 'workspace_not_found',
+                        message: 'Workspace does not exist',
+                    },
+                }),
+            });
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        });
+        it('handles network error (fetch failed)', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockRejectedValueOnce(new Error('fetch failed'));
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.code).toBe(ErrorCode.NETWORK_UNREACHABLE);
+        });
+        it('handles timeout', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockImplementationOnce(() => new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('AbortError')), 10);
+            }));
+            await expect(runConnect(validToken)).rejects.toThrow(CLIError);
+        });
+    });
+    describe('key saving', () => {
+        it('saves API key as named profile', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    ok: true,
+                    apiKey: 'pb_sk_final',
+                    workspaceId: 'ws789',
+                    workspaceName: 'Final Workspace',
+                }),
+            });
+            await runConnect(validToken);
+            // Profile created as <workspace>-<folder> (TASK-638) with the API key
+            const { createProfile } = await import('../lib/profiles.js');
+            expect(createProfile).toHaveBeenCalledWith('final-workspace-my-repo', 'pb_sk_final', expect.any(String));
+        });
+        it('declares the project with an empty config.json: no profile, no siteUrl (TASK-638)', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    ok: true,
+                    apiKey: 'pb_sk_redeemed123',
+                    workspaceId: 'ws456',
+                    workspaceName: 'Dev Workspace',
+                }),
+            });
+            await runConnect(validToken);
+            // Find the writeFileSync call for config.json and verify no profile field
+            const { writeFileSync } = await import('fs');
+            const writeCalls = writeFileSync.mock.calls;
+            // Find the config.json write (ends with config.json)
+            const configJsonCall = writeCalls.find(([path]) => typeof path === 'string' && path.endsWith('config.json') && !path.endsWith('config.local.json'));
+            expect(configJsonCall?.[1]).toBe('{}\n');
+        });
+        it('writes profile to config.local.json (machine-local, gitignored)', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    ok: true,
+                    apiKey: 'pb_sk_redeemed123',
+                    workspaceId: 'ws456',
+                    workspaceName: 'Dev Workspace',
+                }),
+            });
+            await runConnect(validToken);
+            const { writeFileSync } = await import('fs');
+            const writeCalls = writeFileSync.mock.calls;
+            // Find the config.local.json write
+            const localConfigCall = writeCalls.find(([path]) => typeof path === 'string' && path.includes('config.local.json'));
+            expect(localConfigCall).toBeTruthy();
+            if (localConfigCall) {
+                const writtenContent = JSON.parse(localConfigCall[1]);
+                expect(writtenContent).toHaveProperty('profile');
+                expect(writtenContent.profile).toBe('dev-workspace-my-repo');
+            }
+        });
+        it('sets process.env for current session', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({
+                    ok: true,
+                    apiKey: 'pb_sk_env_test',
+                    workspaceId: 'ws999',
+                    workspaceName: 'Env Test',
+                }),
+            });
+            await runConnect(validToken);
+            expect(process.env.PRODUCTBRAIN_API_KEY).toBe('pb_sk_env_test');
+            expect(process.env.CONVEX_SITE_URL).toBeTruthy();
+        });
+        describe('PB_PROFILE env var (sweep finding #8)', () => {
+            afterEach(() => {
+                delete process.env.PB_PROFILE;
+            });
+            it('saves under the PB_PROFILE name instead of the auto-derived slug when set', async () => {
+                process.env.PB_PROFILE = 'owner';
+                const validToken = 'pb_ct_' + 'a'.repeat(40);
+                mockFetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => ({
+                        ok: true,
+                        apiKey: 'pb_sk_env_profile',
+                        workspaceId: 'ws-env',
+                        workspaceName: 'Totally Different Workspace',
+                    }),
+                });
+                await runConnect(validToken);
+                const { createProfile } = await import('../lib/profiles.js');
+                expect(createProfile).toHaveBeenCalledWith('owner', 'pb_sk_env_profile', expect.any(String));
+                const { writeFileSync } = await import('fs');
+                const writeCalls = writeFileSync.mock.calls;
+                const localConfigCall = writeCalls.find(([path]) => typeof path === 'string' && path.includes('config.local.json'));
+                expect(localConfigCall).toBeTruthy();
+                if (localConfigCall) {
+                    const writtenContent = JSON.parse(localConfigCall[1]);
+                    expect(writtenContent.profile).toBe('owner');
+                }
+            });
+            it('ignores blank/whitespace-only PB_PROFILE and uses the derived name', async () => {
+                process.env.PB_PROFILE = '   ';
+                const validToken = 'pb_ct_' + 'a'.repeat(40);
+                mockFetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => ({
+                        ok: true,
+                        apiKey: 'pb_sk_blank_env',
+                        workspaceId: 'ws-blank',
+                        workspaceName: 'Blank Env Workspace',
+                    }),
+                });
+                await runConnect(validToken);
+                const { createProfile } = await import('../lib/profiles.js');
+                expect(createProfile).toHaveBeenCalledWith('blank-env-workspace-my-repo', 'pb_sk_blank_env', expect.any(String));
+            });
+        });
+    });
+    describe('naming and clashes (TASK-638, DEC-1961)', () => {
+        const validToken = 'pb_ct_' + 'a'.repeat(40);
+        function mockRedeemOnce(apiKey, workspaceName) {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ ok: true, apiKey, workspaceId: 'ws-naming', workspaceName }),
+            });
+        }
+        afterEach(async () => {
+            delete process.env.PB_PROFILE;
+            const profiles = await import('../lib/profiles.js');
+            const actualProfiles = await vi.importActual('../lib/profiles.js');
+            vi.mocked(profiles.profileFileExists).mockImplementation((n) => actualProfiles.profileFileExists(n));
+            const config = await import('../lib/config.js');
+            const actualConfig = await vi.importActual('../lib/config.js');
+            vi.mocked(config.readLocalProjectConfig).mockImplementation(() => actualConfig.readLocalProjectConfig());
+        });
+        it("another folder's profile holds the name: takes -2, never overwrites, never prompts", async () => {
+            const { profileFileExists, createProfile } = await import('../lib/profiles.js');
+            vi.mocked(profileFileExists).mockImplementation((n) => n === 'product-brain-product-os');
+            const { connectFolderName } = await import('../lib/connectProfileName.js');
+            vi.mocked(connectFolderName).mockReturnValueOnce('Product-OS');
+            const { confirm } = await import('../lib/prompts.js');
+            mockRedeemOnce('pb_sk_second_folder', 'Product Brain');
+            await runConnect(validToken);
+            expect(createProfile).toHaveBeenCalledWith('product-brain-product-os-2', 'pb_sk_second_folder', expect.any(String));
+            expect(confirm).toHaveBeenCalledTimes(1); // the workspace gate only — no overwrite prompt exists
+        });
+        it("this clone's own pin names the profile: the new key replaces it in place", async () => {
+            const { profileFileExists, createProfile } = await import('../lib/profiles.js');
+            vi.mocked(profileFileExists).mockReturnValue(true);
+            const { readLocalProjectConfig } = await import('../lib/config.js');
+            vi.mocked(readLocalProjectConfig).mockReturnValue({ profile: 'rotate-ws-my-repo' });
+            const stderrSpy = vi.spyOn(process.stderr, 'write');
+            mockRedeemOnce('pb_sk_rotated', 'Rotate WS');
+            await runConnect(validToken);
+            expect(createProfile).toHaveBeenCalledWith('rotate-ws-my-repo', 'pb_sk_rotated', expect.any(String), { overwrite: true });
+            const { discardAllSessions } = await import('../lib/session.js');
+            expect(discardAllSessions).toHaveBeenCalledTimes(1);
+            expect(stderrSpy).toHaveBeenCalledWith(expect.stringContaining('now holds a new key for workspace "Rotate WS"'));
+        });
+        it('PB_PROFILE naming an existing profile is refused BEFORE redeem: token unspent, nothing written', async () => {
+            process.env.PB_PROFILE = 'taken-name';
+            const { profileFileExists, createProfile } = await import('../lib/profiles.js');
+            vi.mocked(profileFileExists).mockImplementation((n) => n === 'taken-name');
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.code).toBe(ErrorCode.PROFILE_CREDENTIALS_CONFLICT);
+            expect(err.guidance).toContain('has not been used');
+            expect(mockFetch).not.toHaveBeenCalled();
+            expect(createProfile).not.toHaveBeenCalled();
+            expect(fs.writeFileSync).not.toHaveBeenCalled();
+        });
+        it.each(['../../etc/passwd', '/etc/passwd'])('a traversal-shaped PB_PROFILE (%s) is refused before redeem and before any path is built', async (bad) => {
+            process.env.PB_PROFILE = bad;
+            const { createProfile } = await import('../lib/profiles.js');
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.code).toBe(ErrorCode.PROFILE_NAME_INVALID);
+            expect(fs.existsSync).not.toHaveBeenCalledWith(expect.stringContaining('passwd'));
+            expect(createProfile).not.toHaveBeenCalled();
+            expect(fs.writeFileSync).not.toHaveBeenCalled();
+            expect(mockFetch).not.toHaveBeenCalled();
+        });
+    });
+    describe('confirm-first gate (WP-2)', () => {
+        const validToken = 'pb_ct_' + 'a'.repeat(40);
+        function mockRedeemOnce(workspaceName) {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ ok: true, apiKey: 'pb_sk_gate', workspaceId: 'ws-gate', workspaceName }),
+            });
+        }
+        it('declining writes nothing locally and revokes the redeemed key through the self-revoke door (TASK-641)', async () => {
+            const { confirm } = await import('../lib/prompts.js');
+            vi.mocked(confirm).mockResolvedValueOnce(false);
+            mockRedeemOnce('Decline WS');
+            mockFetch.mockResolvedValueOnce({ ok: true, json: async () => ({ ok: true, data: { revoked: true } }) });
+            await runConnect(validToken);
+            const { createProfile } = await import('../lib/profiles.js');
+            const { runConnectScreens } = await import('./connect-screens.js');
+            expect(createProfile).not.toHaveBeenCalled();
+            expect(fs.writeFileSync).not.toHaveBeenCalled();
+            expect(runConnectScreens).not.toHaveBeenCalled();
+            const [url, init] = mockFetch.mock.calls[1];
+            expect(url).toMatch(/\/api\/aki$/);
+            expect(init.headers.Authorization).toBe('Bearer pb_sk_gate');
+            expect(JSON.parse(String(init.body))).toEqual({ fn: 'apiKeys.revokeCallingKey', args: {} });
+        });
+        it('the gate runs only after redeem — invalid token format never prompts', async () => {
+            const { confirm } = await import('../lib/prompts.js');
+            await expect(runConnect('pb_ct_short')).rejects.toThrow(CLIError);
+            expect(confirm).not.toHaveBeenCalled();
+        });
+        it('non-interactive without --yes fails closed BEFORE redeem (token not burned, writes nothing)', async () => {
+            const { isInteractive } = await import('../lib/prompts.js');
+            vi.mocked(isInteractive).mockReturnValue(false);
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.code).toBe(ErrorCode.NON_INTERACTIVE);
+            // Refused before redeem — the one-time token is never spent, so the same token
+            // still works once the user adds --yes (fix for the token-burn-on-fail path).
+            expect(mockFetch).not.toHaveBeenCalled();
+            const { createProfile } = await import('../lib/profiles.js');
+            expect(createProfile).not.toHaveBeenCalled();
+            expect(fs.writeFileSync).not.toHaveBeenCalled();
+        });
+        it('non-interactive WITH assumeYes proceeds without prompting, via the headless summary', async () => {
+            const { isInteractive, confirm } = await import('../lib/prompts.js');
+            vi.mocked(isInteractive).mockReturnValue(false);
+            mockRedeemOnce('Yes WS');
+            await runConnect(validToken, { assumeYes: true });
+            const { createProfile } = await import('../lib/profiles.js');
+            const { runConnectScreens, runConnectHeadless } = await import('./connect-screens.js');
+            expect(createProfile).toHaveBeenCalledWith('yes-ws-my-repo', 'pb_sk_gate', expect.any(String));
+            expect(confirm).not.toHaveBeenCalled();
+            // Headless: the Ink wizard (raw-mode stdin) is skipped; the plain summary runs instead.
+            expect(runConnectScreens).not.toHaveBeenCalled();
+            expect(runConnectHeadless).toHaveBeenCalledWith('Yes WS', 'yes-ws-my-repo');
+        });
+        it('strips control chars from the server-provided workspace name before the prompt (BET-269 C3)', async () => {
+            const { confirm } = await import('../lib/prompts.js');
+            // Server-controlled name carrying an ANSI escape + a raw control char.
+            mockRedeemOnce('Evil\x1b[31mWS\x07');
+            await runConnect(validToken);
+            const promptMessage = vi.mocked(confirm).mock.calls[0]?.[0]?.message ?? '';
+            // Security property (BET-269 C3): the executable escape (ESC) and control (BEL)
+            // bytes are gone, so the name can't drive terminal state. Visible text survives.
+            expect(promptMessage).not.toContain('\x1b');
+            expect(promptMessage).not.toContain('\x07');
+            expect(promptMessage).toContain('Evil');
+            expect(promptMessage).toContain('WS');
+        });
+    });
+    describe('error messages', () => {
+        it('provides guidance for invalid token format', async () => {
+            try {
+                await runConnect('bad_token');
+                expect.fail('should have thrown');
+            }
+            catch (err) {
+                if (err instanceof CLIError) {
+                    expect(err.guidance).toContain('pb_ct_');
+                }
+            }
+        });
+        it('provides guidance for invalid_token response', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 400,
+                json: async () => ({
+                    ok: false,
+                    error: {
+                        code: 'invalid_token',
+                        message: 'Token is invalid',
+                    },
+                }),
+            });
+            try {
+                await runConnect(validToken);
+                expect.fail('should have thrown');
+            }
+            catch (err) {
+                if (err instanceof CLIError) {
+                    // TASK-562: the lifetime comes from the kernel constant and the next step names the app page.
+                    // Round 2: a 400 is also a typo, so the message does not claim expiry.
+                    expect(err.message).toBe('This connect command did not work. It expired, was used, or has a typo.');
+                    expect(err.guidance).toContain('A connect command lasts 15 minutes and works once. Get your connect command at https://work.productbrain.io/settings/api-keys.');
+                }
+            }
+        });
+        it('provides guidance for network errors', async () => {
+            const validToken = 'pb_ct_' + 'a'.repeat(40);
+            mockFetch.mockRejectedValueOnce(new Error('ECONNREFUSED'));
+            const err = await runConnect(validToken).catch((e) => e);
+            expect(err).toBeInstanceOf(CLIError);
+            expect(err.category).toBe('network');
+            expect(err.guidance).toMatch(/connection|internet/i);
+        });
+    });
+});
+//# sourceMappingURL=connect.test.js.map

package/dist/commands/connect.test.js.map

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

package/dist/commands/constellation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constellation.d.ts","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlF"}
+{"version":3,"file":"constellation.d.ts","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBlF"}

package/dist/commands/constellation.js

@@ -6,20 +6,23 @@
  * ARCH-25 (orient view model pattern), DEC-99 (ALLOWED_RELATION_TYPES as SSOT)
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand } from '../lib/runner.js';
 import { formatConstellation } from '../formatters/constellation.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 export async function runConstellation(options) {
-    const config = await getConfigOrGuide(() => runConstellation(options));
-    if (!config)
-        return;
+    await getConfigOrGuide();
     await runCliCommand({
-        fn: () => mcpCall('chain.getConstellation', {
+        fn: () => kernelCall('chain.getConstellation', {
             entryId: options.entryId,
         }),
         formatPretty: (result) => {
             if (!result?.entry) {
-                throw new Error(`Entry "${options.entryId}" not found.`);
+                throw new CLIError(`Entry "${options.entryId}" not found.`, {
+                    code: ErrorCode.VALIDATION_FAILED,
+                    category: 'validation',
+                    guidance: 'Check the entry ID and try again. Use `pb search` to find entries.',
+                });
             }
             return formatConstellation(result);
         },

package/dist/commands/constellation.js.map

@@ -1 +1 @@
-{"version":3,"file":"constellation.js","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gCAAgC,CAAC;AAE/F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAsB;QACvC,EAAE,EAAE,GAAG,EAAE,CACP,OAAO,CAAsB,wBAAwB,EAAE;YACrD,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;YAC3D,CAAC;YACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"constellation.js","sourceRoot":"","sources":["../../src/commands/constellation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAA4B,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,gBAAgB,EAAE,CAAC;IAEzB,MAAM,aAAa,CAAsB;QACvC,EAAE,EAAE,GAAG,EAAE,CACP,UAAU,CAAqD,wBAAwB,EAAE;YACvF,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,QAAQ,CAAC,UAAU,OAAO,CAAC,OAAO,cAAc,EAAE;oBAC1D,IAAI,EAAE,SAAS,CAAC,iBAAiB;oBACjC,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,oEAAoE;iBAC/E,CAAC,CAAC;YACL,CAAC;YACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5E"}

package/dist/commands/context.js

@@ -4,21 +4,24 @@
  * Previously: pipe-friendly via process.stdout.isTTY — now delegated to runner.
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { kernelCall } from '../lib/client.js';
 import { runCliCommand, isJsonMode } from '../lib/runner.js';
 import { formatContext } from '../formatters/context.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
 export async function runContext(options) {
-    const config = await getConfigOrGuide(() => runContext(options));
-    if (!config)
-        return;
+    await getConfigOrGuide();
     await runCliCommand({
-        fn: () => mcpCall('chain.gatherContext', {
+        fn: () => kernelCall('chain.gatherContext', {
             entryId: options.entryId,
             maxHops: 2,
         }),
         formatPretty: (result) => {
             if (!result?.root) {
-                throw new Error(`Entry "${options.entryId}" not found.`);
+                throw new CLIError(`Entry "${options.entryId}" not found.`, {
+                    code: ErrorCode.VALIDATION_FAILED,
+                    category: 'validation',
+                    guidance: 'Check the entry ID and try again. Use `pb search` to find entries.',
+                });
             }
             // In pretty mode, use tty: true for rich terminal output
             return formatContext(result, { tty: !isJsonMode() });