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

package/dist/commands/ingest.d.ts

@@ -1,8 +1,14 @@
 /**
  * pb ingest — bulk document ingestion to Chain as drafts.
  * BET-81 Slice 1: CLI-first ingestion with clientKind attribution (DEC-184).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * BET-221 S7 (FEAT-697): --dry-run, --resume, --concurrency flags.
  */
-export declare function runIngest(options: {
+export interface IngestOptions {
     pattern: string;
-}): Promise<void>;
+    dryRun?: boolean;
+    resume?: boolean;
+    concurrency?: number;
+}
+export declare function runIngest(options: IngestOptions): Promise<void>;
 //# sourceMappingURL=ingest.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD3E"}
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqCD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwJrE"}

package/dist/commands/ingest.js

@@ -1,6 +1,8 @@
 /**
  * pb ingest — bulk document ingestion to Chain as drafts.
  * BET-81 Slice 1: CLI-first ingestion with clientKind attribution (DEC-184).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * BET-221 S7 (FEAT-697): --dry-run, --resume, --concurrency flags.
  */
 import { readFile } from 'fs/promises';
 import { homedir } from 'os';
@@ -8,7 +10,12 @@ import { resolve } from 'path';
 import { globSync } from 'glob';
 import { randomUUID } from 'crypto';
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { convexCall } from '../lib/client.js';
+import { isJsonMode } from '../lib/runner.js';
+import { stripConvexInternals } from '../lib/strip.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+/** Max concurrency limit to prevent overwhelming the backend. */
+const MAX_CONCURRENCY = 5;
 function expandGlob(pattern) {
     const cwd = process.cwd();
     const expanded = pattern.startsWith('~') ? pattern.replace('~', homedir()) : pattern;
@@ -16,51 +23,167 @@ function expandGlob(pattern) {
     const resolved = expanded.startsWith('/') ? expanded : resolve(cwd, normalized);
     return globSync(resolved, { nodir: true, absolute: true });
 }
+/**
+ * Process files with bounded concurrency using a simple pool.
+ * Executes up to `concurrency` tasks simultaneously, returning results in input order.
+ */
+async function processWithConcurrency(items, concurrency, fn) {
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < items.length) {
+            const i = nextIndex++;
+            results[i] = await fn(items[i], i);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
 export async function runIngest(options) {
     const config = await getConfigOrGuide(() => runIngest(options));
     if (!config)
         return;
-    const files = expandGlob(options.pattern);
+    const json = isJsonMode();
+    const dryRun = options.dryRun ?? false;
+    const resume = options.resume ?? false;
+    const concurrency = Math.max(1, Math.min(options.concurrency ?? 1, MAX_CONCURRENCY));
+    let files = expandGlob(options.pattern);
     if (files.length === 0) {
-        console.error(`No files matched: ${options.pattern}`);
-        process.exit(1);
+        throw new CLIError(`No files matched: ${options.pattern}`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Check the glob pattern. Example: pb ingest "docs/**/*.md"',
+        });
     }
     const ingestionRunId = randomUUID();
     // Resolve workspace + keyId — startSession requires apiKeyId (MCP server passes it; CLI gets from resolveWorkspace)
-    const workspace = await mcpCall('resolveWorkspace', {});
+    const workspace = await convexCall('resolveWorkspace', {});
     if (!workspace?.keyId) {
-        throw new Error('API key has no keyId. Use a readwrite key from Settings → API Keys.');
+        throw new CLIError('API key has no keyId.', {
+            code: ErrorCode.AUTH_INVALID,
+            category: 'auth',
+            guidance: 'Use a readwrite key from Settings → API Keys.',
+        });
     }
-    const startRes = await mcpCall('agent.startSession', {
+    // --resume: filter out files whose sourceRef is already committed in staging
+    let resumeSkipped = 0;
+    if (resume) {
+        const committedRefs = await convexCall('staging.getCommittedSourceRefs', {});
+        const committedSet = new Set(committedRefs ?? []);
+        const originalCount = files.length;
+        files = files.filter((f) => !committedSet.has(f));
+        resumeSkipped = originalCount - files.length;
+        if (!json && resumeSkipped > 0) {
+            process.stdout.write(`Resume: skipping ${resumeSkipped} already-committed file(s).\n`);
+        }
+        if (files.length === 0) {
+            if (json) {
+                process.stdout.write(JSON.stringify({ totalCreated: 0, resumeSkipped, files: [], ingestionRunId }) + '\n');
+            }
+            else {
+                process.stdout.write('All files already committed. Nothing to do.\n');
+            }
+            return;
+        }
+    }
+    const startRes = await convexCall('agent.startSession', {
         workspaceId: workspace._id,
         apiKeyId: workspace.keyId,
         clientKind: 'cli',
     });
     const sessionId = startRes.sessionId;
     let totalCreated = 0;
+    let totalSkipped = 0;
+    let totalRejected = 0;
     const total = files.length;
-    for (let i = 0; i < files.length; i++) {
-        const filePath = files[i];
-        const content = await readFile(filePath, 'utf8');
-        const sourceRef = filePath;
-        const result = await mcpCall('chain.ingestDocument', {
-            content,
-            sourceRef,
+    const allResults = [];
+    const processFile = async (filePath, i) => {
+        try {
+            const content = await readFile(filePath, 'utf8');
+            const sourceRef = filePath;
+            const result = await convexCall('chain.ingestDocument', {
+                content,
+                sourceRef,
+                ingestionRunId,
+                sessionId,
+                ...(dryRun && { dryRun: true }),
+            });
+            const created = result?.entriesCreated?.length ?? 0;
+            const skipped = result?.skipped ?? 0;
+            const rejected = result?.rejected?.length ?? 0;
+            return { filePath, created, skipped, rejected, index: i };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!json) {
+                process.stderr.write(`Error processing ${filePath.split('/').pop()}: ${msg}\n`);
+            }
+            return { filePath, created: 0, skipped: 0, rejected: 1, index: i };
+        }
+    };
+    try {
+        if (concurrency === 1) {
+            // Sequential: original behavior with progress output
+            for (let i = 0; i < files.length; i++) {
+                const { filePath, created, skipped, rejected } = await processFile(files[i], i);
+                totalCreated += created;
+                totalSkipped += skipped;
+                totalRejected += rejected;
+                allResults.push({ file: filePath.split('/').pop() ?? filePath, created, skipped, rejected });
+                if (!json) {
+                    const parts = [`${created} created`];
+                    if (skipped > 0)
+                        parts.push(`${skipped} skipped`);
+                    if (rejected > 0)
+                        parts.push(`${rejected} rejected`);
+                    process.stdout.write(`Ingesting [${i + 1}/${total}]: ${filePath.split('/').pop()} — ${parts.join(', ')}\n`);
+                }
+            }
+        }
+        else {
+            // Concurrent: process with pool, then output aggregated results
+            if (!json) {
+                process.stdout.write(`Processing ${total} file(s) with concurrency ${concurrency}...\n`);
+            }
+            const results = await processWithConcurrency(files, concurrency, processFile);
+            for (const { filePath, created, skipped, rejected } of results) {
+                totalCreated += created;
+                totalSkipped += skipped;
+                totalRejected += rejected;
+                allResults.push({ file: filePath.split('/').pop() ?? filePath, created, skipped, rejected });
+            }
+            if (!json) {
+                for (let i = 0; i < allResults.length; i++) {
+                    const r = allResults[i];
+                    const parts = [`${r.created} created`];
+                    if (r.skipped > 0)
+                        parts.push(`${r.skipped} skipped`);
+                    if (r.rejected > 0)
+                        parts.push(`${r.rejected} rejected`);
+                    process.stdout.write(`  [${i + 1}/${total}]: ${r.file} — ${parts.join(', ')}\n`);
+                }
+            }
+        }
+    }
+    finally {
+        await convexCall('agent.closeSession', { sessionId, status: 'closed' });
+    }
+    if (json) {
+        process.stdout.write(JSON.stringify(stripConvexInternals({
+            totalCreated,
+            totalSkipped,
+            totalRejected,
+            ...(resume && { resumeSkipped }),
+            dryRun,
+            files: allResults,
             ingestionRunId,
-            sessionId,
-        });
-        const created = result?.entriesCreated?.length ?? 0;
-        const skipped = result?.skipped ?? 0;
-        const rejected = result?.rejected?.length ?? 0;
-        totalCreated += created;
-        const parts = [`${created} created`];
-        if (skipped > 0)
-            parts.push(`${skipped} skipped`);
-        if (rejected > 0)
-            parts.push(`${rejected} rejected`);
-        console.log(`Ingesting [${i + 1}/${total}]: ${filePath.split('/').pop()} — ${parts.join(', ')}`);
+        })) + '\n');
+    }
+    else {
+        const dryRunSuffix = dryRun ? ' (dry run — staged only, not committed)' : '';
+        const resumeSuffix = resumeSkipped > 0 ? ` ${resumeSkipped} file(s) skipped by --resume.` : '';
+        process.stdout.write(`\nDone. ${totalCreated} entries created as drafts.${dryRunSuffix}${resumeSuffix} Open Cortex to review.\n`);
     }
-    await mcpCall('agent.closeSession', { sessionId, status: 'closed' });
-    console.log(`\nDone. ${totalCreated} entries created as drafts. Open Cortex to review.`);
 }
 //# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,14 @@
+/**
+ * pb init — intelligent entry point that detects setup state and guides the user.
+ *
+ * WP-303 Slice 4 (Keystone): 4-state machine (fresh → has-key → has-workspace → ready).
+ * Uses getConfig() for key check, convexCall for workspace validation.
+ */
+export type InitState = 'fresh' | 'has-key' | 'ready';
+/**
+ * Detect the current setup state without throwing.
+ * Sync check only — does not hit the network.
+ */
+export declare function detectState(): InitState;
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAevC;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA6F7C"}

package/dist/commands/init.js

@@ -0,0 +1,117 @@
+/**
+ * pb init — intelligent entry point that detects setup state and guides the user.
+ *
+ * WP-303 Slice 4 (Keystone): 4-state machine (fresh → has-key → has-workspace → ready).
+ * Uses getConfig() for key check, convexCall for workspace validation.
+ */
+import { getConfig } from '../lib/config.js';
+import { readSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+import { hint, heading, bold, dim, green, icons } from '../lib/style.js';
+import { formatElapsed } from '../lib/format.js';
+import { probeWorkspace } from '../lib/workspace-probe.js';
+import { runOnboardingConversation } from '../lib/onboarding.js';
+/**
+ * Detect the current setup state without throwing.
+ * Sync check only — does not hit the network.
+ */
+export function detectState() {
+    try {
+        getConfig(); // throws CLIError if no valid key
+    }
+    catch {
+        return 'fresh';
+    }
+    // Key is valid. Check if we have a local session (proxy for workspace connectivity).
+    const session = readSession();
+    if (session?.workspaceId) {
+        return 'ready';
+    }
+    // Has key but no session — network probe needed to determine workspace connectivity.
+    return 'has-key';
+}
+export async function runInit() {
+    const json = isJsonMode();
+    const localState = detectState();
+    if (json) {
+        // For JSON mode, try to enrich with network probe if we have a key
+        if (localState === 'fresh') {
+            process.stdout.write(JSON.stringify({
+                state: 'fresh',
+                configured: false,
+                next: 'pb login',
+            }) + '\n');
+            return;
+        }
+        const workspace = await probeWorkspace();
+        const session = readSession();
+        const state = workspace ? 'ready' : 'has-key';
+        process.stdout.write(JSON.stringify({
+            state,
+            configured: true,
+            workspace: workspace?.name ?? null,
+            session: session ? { id: session.sessionId, startedAt: session.startedAt } : null,
+            entryCount: workspace?.entryCount ?? null,
+            next: state === 'ready' ? 'pb orient -b' : 'pb setup',
+        }) + '\n');
+        return;
+    }
+    // Human mode
+    if (localState === 'fresh') {
+        process.stdout.write('\n');
+        process.stdout.write(`${bold('Welcome to Product Brain!')}\n\n`);
+        process.stdout.write(`  Let's get you connected.\n\n`);
+        process.stdout.write(`${heading('Next steps')}\n\n`);
+        hint('1. pb login       Save your API key');
+        hint('2. pb setup       Connect a workspace');
+        hint('3. pb orient -b   See what\'s happening');
+        process.stdout.write('\n');
+        hint(`Get a key: Product Brain app ${dim(icons.arrow)} Settings ${dim(icons.arrow)} API Keys`);
+        process.stdout.write('\n');
+        return;
+    }
+    // Has key — probe workspace
+    process.stdout.write('\n');
+    process.stdout.write(`${bold('Product Brain')} — checking workspace...\n\n`);
+    const workspace = await probeWorkspace();
+    const session = readSession();
+    if (!workspace) {
+        // has-key state — key works but can't reach workspace
+        process.stdout.write(`  ${green(icons.pass)} API key configured\n`);
+        process.stdout.write(`  ${dim('Could not reach workspace — check your connection.')}\n\n`);
+        process.stdout.write(`${heading('Next steps')}\n\n`);
+        hint('pb setup     Connect a workspace');
+        hint('pb doctor    Diagnose connection issues');
+        process.stdout.write('\n');
+        return;
+    }
+    // ready state
+    process.stdout.write(`  ${green(icons.pass)} Connected to ${bold(workspace.name)}\n`);
+    if (session) {
+        const elapsed = formatElapsed(session.startedAt);
+        process.stdout.write(`  ${green(icons.pass)} Session active (started ${elapsed})\n`);
+    }
+    else {
+        process.stdout.write(`  ${dim(icons.dot)} No active session\n`);
+    }
+    // WP-304: Blank workspace → LLM onboarding conversation
+    const isBlank = !workspace.entryCount || workspace.entryCount < 3;
+    if (isBlank) {
+        process.stdout.write('\n');
+        await runOnboardingConversation(workspace.name);
+        return;
+    }
+    if ((workspace.entryCount ?? 0) > 0) {
+        process.stdout.write(`  ${dim(icons.dot)} ${workspace.entryCount} entries on the Chain\n`);
+    }
+    process.stdout.write('\n');
+    process.stdout.write(`${heading('You\'re all set!')}\n\n`);
+    if (!session) {
+        hint('pb session start  Start a write session');
+    }
+    hint('pb orient -b      Workspace overview');
+    hint('pb search <q>     Search the Chain');
+    hint('pb capture <text> Capture knowledge');
+    process.stdout.write('\n');
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.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;AAuDH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAiE9C"}

package/dist/commands/login.js

@@ -1,53 +1,116 @@
 /**
  * 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';
-function question(rl, prompt) {
-    return new Promise((resolve) => {
-        rl.question(prompt, (answer) => resolve((answer ?? '').trim()));
-    });
+import { resolve } from 'path';
+import { HOME_CONFIG_DIR, HOME_ENV_PATH } from '../lib/config.js';
+import { DEFAULT_SITE_URL, resolveAppUrl } from '../lib/constants.js';
+import { API_KEY_PREFIX } from '../lib/tokenConstants.js';
+import { validateKey } from '../lib/client.js';
+import { password as promptPassword } from '../lib/prompts.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { getActiveProfile, PROFILES_DIR } from '../lib/profiles.js';
+const SIGNUP_URL = resolveAppUrl();
+function saveKey(apiKey, siteUrl) {
+    // If a named profile is active, write to that profile's file instead of the
+    // legacy HOME_ENV_PATH. This ensures `pb profile use <name> && pb login`
+    // writes to the correct location and `pb doctor` finds the key immediately.
+    const activeProfile = getActiveProfile();
+    let savePath;
+    if (activeProfile) {
+        savePath = resolve(PROFILES_DIR, `${activeProfile}.env`);
+        const profileContent = [
+            `# Product Brain CLI profile: ${activeProfile}`,
+            `# Saved by "pb login"`,
+            ``,
+            `PRODUCTBRAIN_API_KEY=${apiKey}`,
+            `CONVEX_SITE_URL=${siteUrl}`,
+            ``,
+        ].join('\n');
+        mkdirSync(PROFILES_DIR, { recursive: true });
+        writeFileSync(savePath, profileContent, { mode: 0o600 });
+    }
+    else {
+        savePath = HOME_ENV_PATH;
+        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=${siteUrl}`,
+            ``,
+        ].join('\n');
+        mkdirSync(HOME_CONFIG_DIR, { recursive: true });
+        writeFileSync(savePath, content, { mode: 0o600 });
+    }
+    process.env.PRODUCTBRAIN_API_KEY = apiKey;
+    process.env.CONVEX_SITE_URL = siteUrl;
+    return savePath;
 }
 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_...): ');
+    console.log(`  Get a key: ${SIGNUP_URL} → Settings → API Keys\n`);
+    const apiKey = await promptPassword({
+        message: `Paste your API key (${API_KEY_PREFIX}...)`,
+        validate: (v) => {
+            if (!v)
+                return 'No key entered.';
+            if (!v.startsWith(API_KEY_PREFIX))
+                return `Key must start with ${API_KEY_PREFIX}. Get one from ${SIGNUP_URL} → Settings → API Keys.`;
+            return undefined;
+        },
+    });
+    // Defensive guard — also catches non-interactive / mocked scenarios
     if (!apiKey) {
-        console.error('No key entered. Exiting.');
-        rl.close();
-        process.exit(1);
+        throw new CLIError('No key entered.', {
+            code: ErrorCode.AUTH_MISSING,
+            category: 'auth',
+            guidance: `Get a key from ${SIGNUP_URL} → Settings → API Keys, then run \`pb login\`.`,
+        });
     }
-    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);
+    if (!apiKey.startsWith(API_KEY_PREFIX)) {
+        throw new CLIError(`Key must start with ${API_KEY_PREFIX}.`, {
+            code: ErrorCode.AUTH_INVALID,
+            category: 'auth',
+            guidance: `Get a valid key from ${SIGNUP_URL} → Settings → API Keys.`,
+        });
     }
-    const siteUrl = await question(rl, `API base URL (Enter for default): `);
-    rl.close();
-    const url = siteUrl || DEFAULT_SITE_URL;
-    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(/\/$/, '')}`,
-        ``,
-    ].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');
+    // 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');
+            const savedPath = saveKey(apiKey, siteUrl);
+            console.log(`Saved to ${savedPath}`);
+            console.log('You can run pb from any directory now. Try: pb orient -b\n');
+        }
+        else {
+            process.stdout.write(' failed.\n\n');
+            throw new CLIError(`Invalid key: ${result.error}`, {
+                code: ErrorCode.AUTH_INVALID,
+                category: 'auth',
+                guidance: `Get a valid key: ${SIGNUP_URL} → Settings → API Keys.`,
+            });
+        }
     }
-    catch {
-        // Should not happen after we set env above
+    catch (err) {
+        // Re-throw CLIErrors (validation failures) — don't treat them as network errors
+        if (err instanceof CLIError)
+            throw err;
+        // 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');
+        const savedPath = saveKey(apiKey, siteUrl);
+        console.log(`Saved to ${savedPath}`);
+        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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"}