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

package/dist/commands/connect.js

@@ -0,0 +1,279 @@
+/**
+ * pb connect — redeem a short-lived connect token to save an API key locally.
+ *
+ * Part of FEAT-958 Path C: Onboarding flow.
+ * Token is obtained from an onboarding link (e.g., email, QR code).
+ * S1 endpoint: POST /auth/redeem-connect-token
+ * S2 (this): CLI command to parse token, redeem, and save key locally.
+ * S3: Wizard flow (surface detection + trust level).
+ * S4: Final handshake (pb handshake).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { resolveAppUrl, resolveConnectRedeemUrl } from '../lib/constants.js';
+import { CONNECT_TOKEN_PREFIX } from '../lib/tokenConstants.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { createProfile, listProfiles, PROFILES_DIR } from '../lib/profiles.js';
+import { withSpinner } from '../lib/spinner.js';
+import * as clack from '@clack/prompts';
+import { runHandshake } from './handshake.js';
+const APP_URL = resolveAppUrl();
+/**
+ * Validate token format — must start with pb_ct_ and be >20 chars.
+ * @returns error message if invalid, undefined if valid.
+ */
+function validateTokenFormat(token) {
+    if (!token.startsWith(CONNECT_TOKEN_PREFIX)) {
+        return `Invalid token format. Token must start with '${CONNECT_TOKEN_PREFIX}'.`;
+    }
+    if (token.length < 30) {
+        return `Token is too short. Got ${token.length} chars, expected >30.`;
+    }
+    return undefined;
+}
+/**
+ * POST /auth/redeem-connect-token with the token.
+ * Returns the API key + workspace info, or throws CLIError on failure.
+ */
+async function redeemToken(token, siteUrl) {
+    return withSpinner('Redeeming token', async () => {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 5000);
+        try {
+            const res = await fetch(`${siteUrl}/auth/redeem-connect-token`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ token }),
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!res.ok) {
+                let errorCode = 'unknown_error';
+                let errorMessage = `Server returned ${res.status}`;
+                try {
+                    const errorData = (await res.json());
+                    if (errorData.error?.code) {
+                        errorCode = errorData.error.code;
+                        errorMessage = errorData.error.message ?? errorMessage;
+                    }
+                }
+                catch {
+                    // Failed to parse error JSON — use default message
+                }
+                // Map error codes to user-friendly messages
+                if (errorCode === 'invalid_token' || res.status === 400) {
+                    throw new CLIError('Token is invalid, expired, or already used. Get a new token from your onboarding link.', {
+                        code: ErrorCode.AUTH_INVALID,
+                        category: 'auth',
+                        guidance: `Tried gateway: ${siteUrl}\nVisit ${APP_URL} to get a new onboarding link, or contact support.\n\nIf your token came from a different Convex deployment, use:\n  pb connect --gateway <your-deployment>.convex.site <token>\nor set CONVEX_SITE_URL in your environment.`,
+                    });
+                }
+                if (errorCode === 'workspace_not_found' || res.status === 404) {
+                    throw new CLIError('Workspace not found. The token may be from a deleted workspace.', {
+                        code: ErrorCode.AUTH_DENIED,
+                        category: 'auth',
+                        guidance: 'Contact support for help.',
+                    });
+                }
+                throw new CLIError(`Token redemption failed: ${errorMessage}`, {
+                    code: ErrorCode.AUTH_INVALID,
+                    category: 'auth',
+                    guidance: `Visit ${APP_URL} to get a new onboarding link.`,
+                });
+            }
+            const json = (await res.json());
+            // Check for error response (has error field)
+            if ('error' in json && json.error) {
+                const errorCode = json.error.code || 'unknown_error';
+                const errorMessage = json.error.message || 'Token redemption failed';
+                throw new CLIError(errorCode === 'invalid_token' ? 'Token is invalid, expired, or already used.' : errorMessage, {
+                    code: ErrorCode.AUTH_INVALID,
+                    category: 'auth',
+                    guidance: `Visit ${APP_URL} to get a new onboarding link.`,
+                });
+            }
+            return json;
+        }
+        catch (err) {
+            clearTimeout(timer);
+            // Re-throw CLIErrors (validation failures)
+            if (err instanceof CLIError)
+                throw err;
+            // Network/timeout error
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg === 'fetch failed' || msg.includes('ECONNREFUSED') || msg.includes('ENOTFOUND')) {
+                throw new CLIError('Could not reach ProductBrain. Check your internet connection.', {
+                    code: ErrorCode.NETWORK_UNREACHABLE,
+                    category: 'network',
+                    guidance: 'Check your connection, then try again: pb connect <token>',
+                });
+            }
+            // Unknown error
+            throw new CLIError(`Network error: ${msg}`, {
+                code: ErrorCode.NETWORK_UNREACHABLE,
+                category: 'network',
+                guidance: 'Check your internet connection and try again.',
+            });
+        }
+    });
+}
+/**
+ * Slugify workspace name for profile naming.
+ * Lowercase, replace spaces/special chars with hyphens, max 32 chars.
+ */
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 32) || 'default';
+}
+/**
+ * Save API key as a named profile. Creates or updates the profile.
+ * Does NOT activate the profile globally — project config (.productbrain/config.json)
+ * handles per-project resolution. User can switch manually with `pb use <profile>`.
+ * Sets process.env for the current process only (so handshake works).
+ */
+function saveKeyAsProfile(apiKey, siteUrl, profileName) {
+    const existing = listProfiles();
+    if (existing.includes(profileName)) {
+        // Overwrite existing profile with fresh credentials (re-connect scenario)
+        const lines = [
+            `# Product Brain CLI profile: ${profileName}`,
+            `PRODUCTBRAIN_API_KEY=${apiKey}`,
+            ...(siteUrl ? [`CONVEX_SITE_URL=${siteUrl}`] : []),
+            '',
+        ];
+        mkdirSync(PROFILES_DIR, { recursive: true });
+        writeFileSync(resolve(PROFILES_DIR, `${profileName}.env`), lines.join('\n'), { mode: 0o600 });
+    }
+    else {
+        createProfile(profileName, apiKey, siteUrl);
+    }
+    // Don't call useProfile() — that hijacks the global active profile.
+    // Project config pins the workspace per-project instead.
+    process.env.PRODUCTBRAIN_API_KEY = apiKey;
+    process.env.CONVEX_SITE_URL = siteUrl;
+}
+/**
+ * Write .productbrain/config.json to pin this project to the workspace.
+ * Stores profile name + siteUrl. Does NOT include the API key (that stays in profiles, never committed).
+ */
+function saveProjectConfig(siteUrl, profileName) {
+    const configDir = resolve(process.cwd(), '.productbrain');
+    const configPath = resolve(configDir, 'config.json');
+    // Read existing config to preserve other fields
+    let existing = {};
+    if (existsSync(configPath)) {
+        try {
+            existing = JSON.parse(readFileSync(configPath, 'utf8'));
+        }
+        catch { /* ignore parse errors */ }
+    }
+    // Write profile + siteUrl (no API key — that stays in profiles, never committed)
+    const config = { ...existing, siteUrl, profile: profileName };
+    mkdirSync(configDir, { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * Main entrypoint for `pb connect <token>`.
+ * Validates token format, redeems it via /auth/redeem-connect-token,
+ * saves the key, and runs the wizard (S3).
+ */
+export async function runConnect(token, options = {}) {
+    // 1. Validate token format
+    const formatError = validateTokenFormat(token);
+    if (formatError) {
+        throw new CLIError(formatError, {
+            code: ErrorCode.AUTH_INVALID,
+            category: 'auth',
+            guidance: `Usage: pb connect <token>\nToken must start with '${CONNECT_TOKEN_PREFIX}' and be at least 30 characters long.`,
+        });
+    }
+    // 2. Resolve cloud Convex gateway (--gateway → env → CONVEX_SITE_URL → production)
+    const siteUrl = resolveConnectRedeemUrl(options.gateway);
+    const result = await redeemToken(token, siteUrl);
+    // 4. Save API key as named profile + pin project config
+    const profileName = slugify(result.workspaceName);
+    saveKeyAsProfile(result.apiKey, siteUrl, profileName);
+    saveProjectConfig(siteUrl, profileName);
+    // 5. Print success
+    process.stdout.write('\n');
+    console.log(`✓ Connected to "${result.workspaceName}"`);
+    process.stdout.write('\n');
+    // 6. Run handshake — write ALL target files (no filtering)
+    console.log('Setting up your product context...\n');
+    try {
+        await runHandshake({ quiet: true });
+        console.log('✓ Context files synced to your AI tools:\n');
+        console.log('  .cursor/rules/     → Cursor');
+        console.log('  CLAUDE.md           → Claude Code');
+        console.log('  .github/            → GitHub Copilot');
+        console.log('  AGENTS.md           → Codex / CI');
+        console.log('');
+        console.log('  These update when you run `pb session start`.');
+    }
+    catch (err) {
+        // Handshake failure is non-fatal during connect
+        console.log('⚠ Context sync skipped (run `pb handshake` manually later)');
+        if (err instanceof Error)
+            console.log(`  ${err.message}`);
+    }
+    process.stdout.write('\n');
+    // Screen 1 → Continue gate
+    const cont1 = await clack.select({
+        message: '',
+        options: [{ value: 'continue', label: 'Continue →' }],
+    });
+    if (clack.isCancel(cont1))
+        process.exit(130);
+    // 7. Profile & multi-workspace info
+    console.log(`  Your API key is saved as profile "${profileName}".`);
+    console.log('  To connect another workspace, run `pb connect` with that token.');
+    console.log('  Switch between workspaces with `pb use <profile>`.\n');
+    console.log('  Context files were synced to this project.');
+    console.log('  For other repos, run `pb handshake` to set them up too.');
+    process.stdout.write('\n');
+    // Screen 2 → Continue gate
+    const cont2 = await clack.select({
+        message: '',
+        options: [{ value: 'continue', label: 'Continue →' }],
+    });
+    if (clack.isCancel(cont2))
+        process.exit(130);
+    // 8. Interactive "What's next?" menu
+    const next = await clack.select({
+        message: "What's next?",
+        options: [
+            { value: 'start', label: 'Start coding', hint: 'Just one step' },
+            { value: 'connect', label: 'Connect another workspace' },
+            { value: 'docs', label: 'Learn more', hint: 'productbrain.io/docs' },
+            { value: 'community', label: 'Join the community', hint: 'community.productbrain.io' },
+        ],
+    });
+    if (clack.isCancel(next))
+        process.exit(130);
+    process.stdout.write('\n');
+    switch (next) {
+        case 'start':
+            console.log('  Next time you open your AI tool in this project, run:\n');
+            console.log('    pb session start\n');
+            console.log('  That refreshes your product context and starts a tracked session.');
+            console.log('  Then just code normally — your AI already has your context.');
+            break;
+        case 'connect':
+            console.log('  Run `pb connect <token>` with the token from your other workspace.');
+            console.log('  Each workspace gets its own profile. Switch with `pb use <profile>`.');
+            break;
+        case 'docs':
+            console.log('  → https://productbrain.io/docs');
+            break;
+        case 'community':
+            console.log('  → https://community.productbrain.io');
+            break;
+    }
+    process.stdout.write('\n');
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAiBhC;;;GAGG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC5C,OAAO,gDAAgD,oBAAoB,IAAI,CAAC;IAClF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,OAAO,2BAA2B,KAAK,CAAC,MAAM,uBAAuB,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe;IACvD,OAAO,WAAW,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,4BAA4B,EAAE;gBAC9D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;gBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,IAAI,SAAS,GAAG,eAAe,CAAC;gBAChC,IAAI,YAAY,GAAG,mBAAmB,GAAG,CAAC,MAAM,EAAE,CAAC;gBAEnD,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0E,CAAC;oBAC9G,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;wBAC1B,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;wBACjC,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC;oBACzD,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,mDAAmD;gBACrD,CAAC;gBAED,4CAA4C;gBAC5C,IAAI,SAAS,KAAK,eAAe,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACxD,MAAM,IAAI,QAAQ,CAChB,wFAAwF,EACxF;wBACE,IAAI,EAAE,SAAS,CAAC,YAAY;wBAC5B,QAAQ,EAAE,MAAM;wBAChB,QAAQ,EAAE,kBAAkB,OAAO,WAAW,OAAO,8NAA8N;qBACpR,CACF,CAAC;gBACJ,CAAC;gBAED,IAAI,SAAS,KAAK,qBAAqB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC9D,MAAM,IAAI,QAAQ,CAAC,iEAAiE,EAAE;wBACpF,IAAI,EAAE,SAAS,CAAC,WAAW;wBAC3B,QAAQ,EAAE,MAAM;wBAChB,QAAQ,EAAE,2BAA2B;qBACtC,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,IAAI,QAAQ,CAAC,4BAA4B,YAAY,EAAE,EAAE;oBAC7D,IAAI,EAAE,SAAS,CAAC,YAAY;oBAC5B,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,SAAS,OAAO,gCAAgC;iBAC3D,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2F,CAAC;YAE1H,6CAA6C;YAC7C,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,eAAe,CAAC;gBACrD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,yBAAyB,CAAC;gBACrE,MAAM,IAAI,QAAQ,CAChB,SAAS,KAAK,eAAe,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,YAAY,EAC5F;oBACE,IAAI,EAAE,SAAS,CAAC,YAAY;oBAC5B,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,SAAS,OAAO,gCAAgC;iBAC3D,CACF,CAAC;YACJ,CAAC;YAED,OAAO,IAAsB,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,2CAA2C;YAC3C,IAAI,GAAG,YAAY,QAAQ;gBAAE,MAAM,GAAG,CAAC;YAEvC,wBAAwB;YACxB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,GAAG,KAAK,cAAc,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxF,MAAM,IAAI,QAAQ,CAAC,+DAA+D,EAAE;oBAClF,IAAI,EAAE,SAAS,CAAC,mBAAmB;oBACnC,QAAQ,EAAE,SAAS;oBACnB,QAAQ,EAAE,2DAA2D;iBACtE,CAAC,CAAC;YACL,CAAC;YAED,gBAAgB;YAChB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,GAAG,EAAE,EAAE;gBAC1C,IAAI,EAAE,SAAS,CAAC,mBAAmB;gBACnC,QAAQ,EAAE,SAAS;gBACnB,QAAQ,EAAE,+CAA+C;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAe,EAAE,WAAmB;IAC5E,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,0EAA0E;QAC1E,MAAM,KAAK,GAAG;YACZ,gCAAgC,WAAW,EAAE;YAC7C,wBAAwB,MAAM,EAAE;YAChC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,EAAE;SACH,CAAC;QACF,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,WAAW,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,oEAAoE;IACpE,yDAAyD;IACzD,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,MAAM,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,OAAe,EAAE,WAAmB;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAErD,gDAAgD;IAChD,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACvC,CAAC;IAED,iFAAiF;IACjF,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAC9D,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa,EAAE,UAA0B,EAAE;IAC1E,2BAA2B;IAC3B,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,SAAS,CAAC,YAAY;YAC5B,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,qDAAqD,oBAAoB,uCAAuC;SAC3H,CAAC,CAAC;IACL,CAAC;IAED,mFAAmF;IACnF,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEjD,wDAAwD;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACtD,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAExC,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,2DAA2D;IAC3D,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gDAAgD;QAChD,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QAC1E,IAAI,GAAG,YAAY,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,2BAA2B;IAC3B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7C,oCAAoC;IACpC,OAAO,CAAC,GAAG,CAAC,uCAAuC,WAAW,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,2BAA2B;IAC3B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7C,qCAAqC;IACrC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE;YAChE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,2BAA2B,EAAE;YACxD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,sBAAsB,EAAE;YACpE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,2BAA2B,EAAE;SACvF;KACF,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;YACnF,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;YAC7E,MAAM;QACR,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;YACtF,MAAM;QACR,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAChD,MAAM;QACR,KAAK,WAAW;YACd,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACrD,MAAM;IACV,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Tests for pb connect command (FEAT-958 S2).
+ * Covers token parsing, redemption, error handling, and key saving.
+ */
+export {};
+//# sourceMappingURL=connect.test.d.ts.map

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

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

package/dist/commands/connect.test.js

@@ -0,0 +1,230 @@
+/**
+ * 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 { runConnect } from './connect.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) => {
+        // withSpinner just calls the function immediately in tests
+        return fn();
+    }),
+}));
+// Mock fs operations
+vi.mock('fs', () => ({
+    mkdirSync: vi.fn(),
+    writeFileSync: 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),
+}));
+// Mock profiles (connect saves key as named profile)
+vi.mock('../lib/profiles.js', () => ({
+    createProfile: vi.fn(),
+    listProfiles: vi.fn(() => []),
+    PROFILES_DIR: '/tmp/profiles',
+}));
+// Mock handshake (connect runs handshake after token redemption)
+vi.mock('./handshake.js', () => ({
+    runHandshake: 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(() => {
+        mockFetch.mockClear();
+        vi.clearAllMocks();
+        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('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', 'pb_sk_redeemed123', expect.any(String));
+            expect(fs.writeFileSync).toHaveBeenCalled();
+        });
+        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'));
+            await expect(runConnect(validToken)).rejects.toThrow(CLIError);
+            const err = await runConnect(validToken).catch((e) => e);
+            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 with slugified name and API key
+            const { createProfile } = await import('../lib/profiles.js');
+            expect(createProfile).toHaveBeenCalledWith('final-workspace', 'pb_sk_final', expect.any(String));
+        });
+        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('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) {
+                    expect(err.message).toContain('invalid');
+                    expect(err.guidance).toContain('onboarding');
+                }
+            }
+        });
+        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

@@ -0,0 +1,11 @@
+/**
+ * pb constellation <entry-id> — compound view: entry + grouped relations.
+ * BET-181 Slice 3: agents can assess a shaped bet from this single output.
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal),
+ * ARCH-25 (orient view model pattern), DEC-99 (ALLOWED_RELATION_TYPES as SSOT)
+ */
+export declare function runConstellation(options: {
+    entryId: string;
+}): Promise<void>;
+//# sourceMappingURL=constellation.d.ts.map

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

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

package/dist/commands/constellation.js

@@ -0,0 +1,33 @@
+/**
+ * pb constellation <entry-id> — compound view: entry + grouped relations.
+ * BET-181 Slice 3: agents can assess a shaped bet from this single output.
+ *
+ * Chain: DEC-299 (agent-native, JSON-default), STD-65 (structured, parseable, minimal),
+ * ARCH-25 (orient view model pattern), DEC-99 (ALLOWED_RELATION_TYPES as SSOT)
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { convexCall } 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 runCliCommand({
+        fn: () => convexCall('chain.getConstellation', {
+            entryId: options.entryId,
+        }),
+        formatPretty: (result) => {
+            if (!result?.entry) {
+                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);
+        },
+    });
+}
+//# sourceMappingURL=constellation.js.map

package/dist/commands/constellation.js.map

@@ -0,0 +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,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,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,UAAU,CAAsB,wBAAwB,EAAE;YACxD,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

@@ -1,6 +1,7 @@
 /**
  * pb context <entry-id> — gather and display constellation context.
- * Pipe-friendly: when stdout is not a TTY, output clean markdown (no ANSI codes).
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
+ * Previously: pipe-friendly via process.stdout.isTTY — now delegated to runner.
  */
 export declare function runContext(options: {
     entryId: string;

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

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