@productbrain/cli 0.1.0-beta.28 → 0.1.0-beta.30

package/dist/commands/doctor.d.ts

@@ -0,0 +1,11 @@
+/**
+ * pb doctor — health check for CLI configuration and connectivity.
+ *
+ * Runs a series of diagnostic checks (config file, API key, environment,
+ * server reachability, Node version, CLI version) and prints a summary.
+ * Does NOT require an active session — this is a diagnostic tool.
+ *
+ * WP-301 Slice 2.
+ */
+export declare function runDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgHH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B/C"}

package/dist/commands/doctor.js

@@ -0,0 +1,124 @@
+/**
+ * pb doctor — health check for CLI configuration and connectivity.
+ *
+ * Runs a series of diagnostic checks (config file, API key, environment,
+ * server reachability, Node version, CLI version) and prints a summary.
+ * Does NOT require an active session — this is a diagnostic tool.
+ *
+ * WP-301 Slice 2.
+ */
+import { existsSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { HOME_ENV_PATH } from '../lib/config.js';
+import { DEFAULT_SITE_URL } from '../lib/constants.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ANSI color helpers — degrade gracefully when NO_COLOR is set or not a TTY.
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const green = (s) => (useColor ? `\x1b[32m${s}\x1b[0m` : s);
+const red = (s) => (useColor ? `\x1b[31m${s}\x1b[0m` : s);
+const yellow = (s) => (useColor ? `\x1b[33m${s}\x1b[0m` : s);
+function formatCheck(result) {
+    const icon = result.status === 'pass'
+        ? green('\u2713')
+        : result.status === 'fail'
+            ? red('\u2717')
+            : yellow('\u26A0');
+    const paddedLabel = result.label.padEnd(16);
+    return `${icon} ${paddedLabel}${result.detail}`;
+}
+/** Check 1: Config file existence */
+function checkConfigFile() {
+    const exists = existsSync(HOME_ENV_PATH);
+    return {
+        status: exists ? 'pass' : 'fail',
+        label: 'Config file',
+        detail: exists ? HOME_ENV_PATH : `Not found: ${HOME_ENV_PATH}`,
+    };
+}
+/** Check 2: API key presence and format */
+function checkApiKey() {
+    const apiKey = process.env.PRODUCTBRAIN_API_KEY ?? '';
+    if (!apiKey) {
+        return { status: 'fail', label: 'API key', detail: 'Not set. Run: pb login' };
+    }
+    if (!apiKey.startsWith('pb_sk_')) {
+        return {
+            status: 'fail',
+            label: 'API key',
+            detail: `Invalid format (expected pb_sk_...). Run: pb login`,
+        };
+    }
+    const masked = apiKey.slice(0, 8) + '****';
+    return { status: 'pass', label: 'API key', detail: masked };
+}
+/** Check 3: Environment and resolved URLs */
+function checkEnvironment() {
+    const env = process.env.PB_ENV || 'production (default)';
+    const siteUrl = (process.env.CONVEX_SITE_URL ?? DEFAULT_SITE_URL).replace(/\/$/, '');
+    return {
+        status: 'pass',
+        label: 'Environment',
+        detail: `${env} \u2192 ${siteUrl}`,
+    };
+}
+/** Check 4: Server reachability via mcpCall */
+async function checkReachability() {
+    try {
+        // Dynamic import to avoid module-load side effects when testing
+        const { mcpCall } = await import('../lib/client.js');
+        const start = Date.now();
+        await mcpCall('chain.getOrientView', {});
+        const elapsed = Date.now() - start;
+        return {
+            status: 'pass',
+            label: 'Reachability',
+            detail: `OK (${elapsed}ms)`,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // Truncate long error messages for readability
+        const short = msg.length > 80 ? msg.slice(0, 77) + '...' : msg;
+        return { status: 'fail', label: 'Reachability', detail: short };
+    }
+}
+/** Check 5: Node.js version */
+function checkNodeVersion() {
+    return { status: 'pass', label: 'Node', detail: process.version };
+}
+/** Check 6: CLI version from package.json */
+function checkCliVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf8'));
+        return { status: 'pass', label: 'CLI', detail: pkg.version };
+    }
+    catch {
+        return { status: 'warn', label: 'CLI', detail: 'Unable to read package.json' };
+    }
+}
+export async function runDoctor() {
+    const results = [];
+    // Synchronous checks
+    results.push(checkConfigFile());
+    results.push(checkApiKey());
+    results.push(checkEnvironment());
+    // Async check — server reachability
+    results.push(await checkReachability());
+    // More synchronous checks
+    results.push(checkNodeVersion());
+    results.push(checkCliVersion());
+    // Print results
+    console.log('');
+    for (const r of results) {
+        console.log(formatCheck(r));
+    }
+    console.log('');
+    // Exit with non-zero if any check failed
+    const hasFail = results.some((r) => r.status === 'fail');
+    if (hasFail) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/doctor.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tests for pb doctor — health check command.
+ * WP-301 Slice 2.
+ */
+export {};
+//# sourceMappingURL=doctor.test.d.ts.map

package/dist/commands/doctor.test.d.ts.map

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

package/dist/commands/doctor.test.js

@@ -0,0 +1,102 @@
+/**
+ * Tests for pb doctor — health check command.
+ * WP-301 Slice 2.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// We test runDoctor by capturing its console output and process.exit calls.
+// Mock dependencies before importing the module under test.
+// Mock config — controls HOME_ENV_PATH export and env state
+const mockHomeEnvPath = '/mock/.config/productbrain/.env';
+vi.mock('../lib/config.js', () => ({
+    HOME_ENV_PATH: mockHomeEnvPath,
+}));
+// Mock client — controls reachability
+const mockMcpCall = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCall: (...args) => mockMcpCall(...args),
+}));
+// Mock existsSync for config file check
+vi.mock('node:fs', async () => {
+    const actual = await vi.importActual('node:fs');
+    return {
+        ...actual,
+        existsSync: vi.fn((path) => {
+            if (path === mockHomeEnvPath)
+                return mockConfigFileExists;
+            return actual.existsSync(path);
+        }),
+    };
+});
+let mockConfigFileExists = true;
+describe('runDoctor', () => {
+    let consoleLogSpy;
+    let processExitSpy;
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        consoleLogSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        processExitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        mockConfigFileExists = true;
+        // Set valid env defaults
+        process.env.PRODUCTBRAIN_API_KEY = 'pb_sk_test1234abcd';
+        process.env.CONVEX_SITE_URL = 'https://trustworthy-kangaroo-277.convex.site';
+        delete process.env.PB_ENV;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        // Restore original env
+        process.env = { ...originalEnv };
+    });
+    it('all checks pass with valid config and reachable server', async () => {
+        mockMcpCall.mockResolvedValueOnce({ ok: true });
+        const { runDoctor } = await import('./doctor.js');
+        await runDoctor();
+        const output = consoleLogSpy.mock.calls.map((c) => c[0]).join('\n');
+        // All six checks should show pass symbol
+        expect(output).toContain('Config file');
+        expect(output).toContain(mockHomeEnvPath);
+        expect(output).toContain('API key');
+        expect(output).toContain('pb_sk_te****');
+        expect(output).toContain('Environment');
+        expect(output).toContain('production (default)');
+        expect(output).toContain('Reachability');
+        expect(output).toContain('OK (');
+        expect(output).toContain('Node');
+        expect(output).toContain(process.version);
+        expect(output).toContain('CLI');
+        // Should NOT exit with failure
+        expect(processExitSpy).not.toHaveBeenCalled();
+    });
+    it('reports missing API key', async () => {
+        delete process.env.PRODUCTBRAIN_API_KEY;
+        mockMcpCall.mockRejectedValueOnce(new Error('No API key'));
+        const { runDoctor } = await import('./doctor.js');
+        await runDoctor();
+        const output = consoleLogSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(output).toContain('Not set');
+        expect(output).toContain('pb login');
+        // Should exit 1 because API key check failed
+        expect(processExitSpy).toHaveBeenCalledWith(1);
+    });
+    it('reports unreachable server', async () => {
+        mockMcpCall.mockRejectedValueOnce(new Error('fetch failed'));
+        const { runDoctor } = await import('./doctor.js');
+        await runDoctor();
+        const output = consoleLogSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(output).toContain('Reachability');
+        expect(output).toContain('fetch failed');
+        // Should exit 1 because reachability failed
+        expect(processExitSpy).toHaveBeenCalledWith(1);
+    });
+    it('reports missing config file', async () => {
+        mockConfigFileExists = false;
+        mockMcpCall.mockResolvedValueOnce({ ok: true });
+        const { runDoctor } = await import('./doctor.js');
+        await runDoctor();
+        const output = consoleLogSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(output).toContain('Not found');
+        expect(output).toContain(mockHomeEnvPath);
+        // Should exit 1 because config file check failed
+        expect(processExitSpy).toHaveBeenCalledWith(1);
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

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

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

package/dist/commands/login.d.ts

@@ -1,5 +1,9 @@
 /**
  * pb login — save API key to ~/.config/productbrain/.env so pb works from any directory.
+ *
+ * Validates the key against the server before saving. On auth failure, shows
+ * error + signup URL and does NOT save. On network/timeout, warns but saves
+ * (don't block offline users).
  */
 export declare function runLogin(): Promise<void>;
 //# sourceMappingURL=login.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAuD9C"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAyD9C"}

package/dist/commands/login.js

@@ -1,53 +1,79 @@
 /**
  * pb login — save API key to ~/.config/productbrain/.env so pb works from any directory.
+ *
+ * Validates the key against the server before saving. On auth failure, shows
+ * error + signup URL and does NOT save. On network/timeout, warns but saves
+ * (don't block offline users).
  */
 import { createInterface } from 'readline';
 import { mkdirSync, writeFileSync } from 'fs';
-import { HOME_CONFIG_DIR, HOME_ENV_PATH, getConfig } from '../lib/config.js';
-const DEFAULT_SITE_URL = 'https://trustworthy-kangaroo-277.convex.site';
+import { HOME_CONFIG_DIR, HOME_ENV_PATH } from '../lib/config.js';
+import { DEFAULT_SITE_URL, resolveAppUrl } from '../lib/constants.js';
+import { validateKey } from '../lib/client.js';
+const SIGNUP_URL = resolveAppUrl();
 function question(rl, prompt) {
     return new Promise((resolve) => {
         rl.question(prompt, (answer) => resolve((answer ?? '').trim()));
     });
 }
-export async function runLogin() {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    console.log('Product Brain — sign in with your API key');
-    console.log('  Get a key: Product Brain app → Settings → API Keys\n');
-    let apiKey = await question(rl, 'Paste your API key (pb_sk_...): ');
-    if (!apiKey) {
-        console.error('No key entered. Exiting.');
-        rl.close();
-        process.exit(1);
-    }
-    if (!apiKey.startsWith('pb_sk_')) {
-        console.error('Key must start with pb_sk_. Get one from Product Brain → Settings → API Keys.');
-        rl.close();
-        process.exit(1);
-    }
-    const siteUrl = await question(rl, `API base URL (Enter for default): `);
-    rl.close();
-    const url = siteUrl || DEFAULT_SITE_URL;
+function saveKey(apiKey, siteUrl) {
     const content = [
         `# Product Brain CLI — saved by "pb login"`,
         `# Edit or delete this file to change or remove your key.`,
         ``,
         `PRODUCTBRAIN_API_KEY=${apiKey}`,
-        `CONVEX_SITE_URL=${url.replace(/\/$/, '')}`,
+        `CONVEX_SITE_URL=${siteUrl}`,
         ``,
     ].join('\n');
     mkdirSync(HOME_CONFIG_DIR, { recursive: true });
     writeFileSync(HOME_ENV_PATH, content, { mode: 0o600 });
     process.env.PRODUCTBRAIN_API_KEY = apiKey;
-    process.env.CONVEX_SITE_URL = url.replace(/\/$/, '');
-    console.log(`\nSaved to ${HOME_ENV_PATH}`);
-    console.log('You can run pb from any directory now. Try: pb orient -b\n');
+    process.env.CONVEX_SITE_URL = siteUrl;
+}
+export async function runLogin() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log('Product Brain — sign in with your API key');
+    console.log(`  Get a key: ${SIGNUP_URL} → Settings → API Keys\n`);
+    const apiKey = await question(rl, 'Paste your API key (pb_sk_...): ');
+    rl.close();
+    if (!apiKey) {
+        console.error('No key entered. Exiting.');
+        process.exit(1);
+        return;
+    }
+    if (!apiKey.startsWith('pb_sk_')) {
+        console.error(`Key must start with pb_sk_. Get one from ${SIGNUP_URL} → Settings → API Keys.`);
+        process.exit(1);
+        return;
+    }
+    // Use CONVEX_SITE_URL env var if set (advanced users), otherwise default
+    const siteUrl = (process.env.CONVEX_SITE_URL || DEFAULT_SITE_URL).replace(/\/$/, '');
+    // Validate key against the server before saving
+    process.stdout.write('Validating key...');
     try {
-        getConfig();
-        console.log('Config looks good.');
+        const result = await validateKey(apiKey, siteUrl);
+        if (result.valid) {
+            process.stdout.write(' connected.\n\n');
+            saveKey(apiKey, siteUrl);
+            console.log(`Saved to ${HOME_ENV_PATH}`);
+            console.log('You can run pb from any directory now. Try: pb orient -b\n');
+        }
+        else {
+            process.stdout.write(' failed.\n\n');
+            console.error(`Invalid key: ${result.error}`);
+            console.error(`Get a valid key: ${SIGNUP_URL} → Settings → API Keys.`);
+            process.exit(1);
+            return;
+        }
     }
     catch {
-        // Should not happen after we set env above
+        // Network error or timeout — save anyway, don't block offline users
+        process.stdout.write(' could not reach server.\n\n');
+        console.warn('Could not reach server — key saved but not verified.\n' +
+            'Run `pb doctor` to check connectivity later.\n');
+        saveKey(apiKey, siteUrl);
+        console.log(`Saved to ${HOME_ENV_PATH}`);
+        console.log('You can run pb from any directory now. Try: pb orient -b\n');
     }
 }
 //# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,gBAAgB,GAAG,8CAA8C,CAAC;AAExE,SAAS,QAAQ,CAAC,EAAsC,EAAE,MAAc;IACtE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7E,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IAEtE,IAAI,MAAM,GAAG,MAAM,QAAQ,CACzB,EAAE,EACF,kCAAkC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1C,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;QAC/F,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAC5B,EAAE,EACF,oCAAoC,CACrC,CAAC;IAEF,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,GAAG,GAAG,OAAO,IAAI,gBAAgB,CAAC;IACxC,MAAM,OAAO,GAAG;QACd,2CAA2C;QAC3C,0DAA0D;QAC1D,EAAE;QACF,wBAAwB,MAAM,EAAE;QAChC,mBAAmB,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;QAC3C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,MAAM,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAErD,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * pb setup — guided first-time onboarding: npm install → first capture.
+ * WP-301 Slice 3. Each step emits telemetry (STD-155 event names).
+ *
+ * Flow:
+ *   0. Check existing config → offer health check or continue to login
+ *   1. Account check → signup URL or login inline
+ *   2. Workspace binding confirmation
+ *   3. Guided first capture (starts a session, captures via MCP)
+ *   4. Summary with next-step hint
+ *
+ * Uses readline for interactive prompts (same pattern as login.ts).
+ * No new npm dependencies.
+ */
+export declare function runSetup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyCH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ9C"}

package/dist/commands/setup.js

@@ -0,0 +1,213 @@
+/**
+ * pb setup — guided first-time onboarding: npm install → first capture.
+ * WP-301 Slice 3. Each step emits telemetry (STD-155 event names).
+ *
+ * Flow:
+ *   0. Check existing config → offer health check or continue to login
+ *   1. Account check → signup URL or login inline
+ *   2. Workspace binding confirmation
+ *   3. Guided first capture (starts a session, captures via MCP)
+ *   4. Summary with next-step hint
+ *
+ * Uses readline for interactive prompts (same pattern as login.ts).
+ * No new npm dependencies.
+ */
+import { createInterface } from 'readline';
+import { getConfig } from '../lib/config.js';
+import { mcpCall, mcpCallWithSession } from '../lib/client.js';
+import { readSession, writeSession } from '../lib/session.js';
+import { trackEvent } from '../lib/telemetry.js';
+import { runLogin } from './login.js';
+/** Prompt helper — same pattern as login.ts. */
+function question(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => resolve((answer ?? '').trim()));
+    });
+}
+/** Mask an API key for display: show prefix + last 4 chars. */
+function maskKey(key) {
+    if (key.length <= 10)
+        return key.slice(0, 6) + '****';
+    return key.slice(0, 6) + '...' + key.slice(-4);
+}
+export async function runSetup() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        await runSetupFlow(rl);
+    }
+    finally {
+        rl.close();
+    }
+}
+async function runSetupFlow(rl) {
+    trackEvent('setup_started');
+    console.log('');
+    console.log('Product Brain — Setup');
+    console.log('=====================');
+    console.log('');
+    // Step 1: Check existing config
+    let hasValidConfig = false;
+    try {
+        const config = getConfig();
+        hasValidConfig = true;
+        console.log(`Already configured: ${maskKey(config.apiKey)}`);
+        console.log(`API endpoint: ${config.siteUrl}`);
+        console.log('');
+        // Verify workspace connectivity
+        try {
+            const workspace = await mcpCall('resolveWorkspace', {});
+            if (workspace?.name) {
+                console.log(`Connected to workspace: ${workspace.name}`);
+            }
+            else {
+                console.log('Workspace connection verified.');
+            }
+            trackEvent('workspace_bound');
+        }
+        catch {
+            console.log('Warning: Could not verify workspace connection. Your key may be invalid.');
+            console.log('Run `pb login` to re-enter your API key.');
+        }
+        console.log('');
+        const runCheck = await question(rl, 'Skip to first capture? (y/n): ');
+        if (runCheck.toLowerCase() !== 'y' && runCheck.toLowerCase() !== 'yes') {
+            console.log('');
+            console.log('Setup complete. Try: pb orient -b');
+            trackEvent('setup_completed');
+            return;
+        }
+    }
+    catch {
+        // No valid config — continue to login
+    }
+    // Step 2: Account check + login (only if no valid config)
+    if (!hasValidConfig) {
+        console.log('To get started, you need a Product Brain account and API key.');
+        console.log('');
+        const hasAccount = await question(rl, 'Do you have a Product Brain account? (y/n): ');
+        if (hasAccount.toLowerCase() !== 'y' && hasAccount.toLowerCase() !== 'yes') {
+            console.log('');
+            console.log('Create an account at: https://productbrain.io');
+            console.log('Then come back and run: pb setup');
+            console.log('');
+            return;
+        }
+        // Run login flow — this handles key prompt, validation, and saving
+        console.log('');
+        rl.close(); // Close our rl so login.ts can create its own
+        await runLogin();
+        trackEvent('key_validated');
+        // Re-open rl for remaining prompts
+        const newRl = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            await runSetupPostLogin(newRl);
+        }
+        finally {
+            newRl.close();
+        }
+        return;
+    }
+    // If we already had config, go straight to first capture
+    await runFirstCapture(rl);
+}
+async function runSetupPostLogin(rl) {
+    // Step 3: Workspace binding — the API key already binds to a workspace
+    console.log('');
+    try {
+        const workspace = await mcpCall('resolveWorkspace', {});
+        if (workspace?.name) {
+            console.log(`Connected to workspace: ${workspace.name}`);
+        }
+        else {
+            console.log('Workspace connection verified.');
+        }
+        trackEvent('workspace_bound');
+    }
+    catch (err) {
+        console.log(`Warning: Could not verify workspace: ${err instanceof Error ? err.message : String(err)}`);
+        console.log('You can still try commands. Run `pb orient -b` to test.');
+    }
+    // Step 4: First capture
+    await runFirstCapture(rl);
+}
+async function runFirstCapture(rl) {
+    console.log('');
+    const wantCapture = await question(rl, 'Ready to capture your first piece of knowledge? (y/n): ');
+    trackEvent('first_capture_prompted');
+    if (wantCapture.toLowerCase() !== 'y' && wantCapture.toLowerCase() !== 'yes') {
+        console.log('');
+        console.log('Setup complete! Try: pb orient -b');
+        trackEvent('setup_completed');
+        return;
+    }
+    // Start a session if none exists
+    let session = readSession();
+    if (!session) {
+        try {
+            const workspace = await mcpCall('resolveWorkspace', {});
+            if (!workspace?.keyId) {
+                console.log('Your API key is read-only. You need a readwrite key for captures.');
+                console.log('Generate one: Product Brain app > Settings > API Keys.');
+                trackEvent('setup_completed');
+                return;
+            }
+            const result = await mcpCall('agent.startSession', {
+                workspaceId: workspace._id,
+                apiKeyId: workspace.keyId,
+                clientKind: 'cli',
+            });
+            session = {
+                sessionId: result.sessionId,
+                workspaceId: workspace._id,
+                workspaceName: result.workspaceName,
+                startedAt: new Date().toISOString(),
+                entriesCaptured: [],
+            };
+            writeSession(session);
+        }
+        catch (err) {
+            console.log(`Could not start session: ${err instanceof Error ? err.message : String(err)}`);
+            console.log('You can start a session manually: pb session start');
+            trackEvent('setup_completed');
+            return;
+        }
+    }
+    // Prompt for capture text
+    console.log('');
+    console.log('Type a short insight, decision, or tension:');
+    const captureText = await question(rl, '> ');
+    if (!captureText) {
+        console.log('No text entered. You can capture later: pb capture "your insight here"');
+        console.log('');
+        console.log('Setup complete! Try: pb orient -b');
+        trackEvent('setup_completed');
+        return;
+    }
+    // Capture via MCP — use mcpCallWithSession which reads the session file
+    try {
+        const result = await mcpCallWithSession('chain.createEntry', {
+            collectionSlug: 'insights',
+            name: captureText,
+            status: 'draft',
+            data: { description: captureText },
+            sessionId: session.sessionId,
+            createdBy: `agent:${session.sessionId}`,
+        });
+        console.log('');
+        console.log(`Captured: ${result.entryId} (draft)`);
+        console.log('Your knowledge is on the Chain. Review it in Product Brain.');
+    }
+    catch (err) {
+        console.log(`Capture failed: ${err instanceof Error ? err.message : String(err)}`);
+        console.log('You can try again: pb capture "your insight here"');
+    }
+    // Step 5: Summary
+    console.log('');
+    console.log('Setup complete! Next steps:');
+    console.log('  pb orient -b       See your workspace at a glance');
+    console.log('  pb capture "..."   Capture more knowledge');
+    console.log('  pb session close   End your session when done');
+    console.log('');
+    trackEvent('setup_completed');
+}
+//# sourceMappingURL=setup.js.map