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

package/dist/index.js

@@ -7,13 +7,15 @@
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { Command } from 'commander';
+import { Command, CommanderError } from 'commander';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const cliPackageVersion = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
-import { setOutputMode } from './lib/runner.js';
+import { setOutputMode, setQuietMode, isJsonMode } from './lib/runner.js';
+import { CLIError, ErrorCode } from './lib/errors.js';
 import { runContext } from './commands/context.js';
 import { runGet, runGetMany } from './commands/get.js';
 import { runLogin } from './commands/login.js';
+import { runSetup } from './commands/setup.js';
 import { runOrient } from './commands/orient.js';
 import { runSearch } from './commands/search.js';
 import { runHandshake, runHandshakeInit } from './commands/handshake.js';
@@ -37,14 +39,68 @@ import { runBrief, runCompoundBrief, isCompoundType } from './commands/brief.js'
 import { runVerify } from './commands/verify.js';
 import { runCodexPrep } from './commands/codex-prep.js';
 import { runCollectionsList, runCollectionsGet, runCollectionsAudit, runCollectionsExport } from './commands/collections.js';
+import { runDoctor } from './commands/doctor.js';
+import { runProfileList, runProfileCreate, runProfileUse, runProfileDelete } from './commands/profile.js';
+import { GLOSSARY, formatGlossary } from './lib/glossary.js';
+import { hint, heading, bold } from './lib/style.js';
 const program = new Command();
+/**
+ * Global error handler — single exit point for all CLI errors.
+ * CLIError: format with code + category + guidance.
+ * CommanderError: re-throw for --help / --version (exitCode 0), format others.
+ * Regular Error: wrap as INTERNAL.
+ */
+function handleError(err) {
+    // Commander help/version exits with code 0 — let them through
+    if (err instanceof CommanderError && err.exitCode === 0) {
+        process.exit(0);
+    }
+    const json = isJsonMode();
+    if (err instanceof CLIError) {
+        if (json) {
+            process.stderr.write(JSON.stringify(err.toJSON()) + '\n');
+        }
+        else {
+            process.stderr.write(err.message + '\n');
+            if (err.guidance) {
+                process.stderr.write(err.guidance + '\n');
+            }
+        }
+        process.exit(1);
+    }
+    // CommanderError (bad usage, missing args, etc.)
+    if (err instanceof CommanderError) {
+        const cliErr = new CLIError(err.message, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+        });
+        if (json) {
+            process.stderr.write(JSON.stringify(cliErr.toJSON()) + '\n');
+        }
+        else {
+            process.stderr.write(err.message + '\n');
+        }
+        process.exit(err.exitCode);
+    }
+    // Unknown / unstructured errors
+    const message = err instanceof Error ? err.message : String(err);
+    if (json) {
+        process.stderr.write(JSON.stringify({ error: message, code: 'INTERNAL', category: 'internal' }) + '\n');
+    }
+    else {
+        process.stderr.write(message + '\n');
+    }
+    process.exit(1);
+}
 program
     .name('pb')
     .description('Product Brain — Chain knowledge + write-back CLI')
     .version(cliPackageVersion.version)
     // Global output mode flags (DEC-299, BET-181)
     .option('--json', 'Output machine-readable JSON (overrides TTY auto-detection)')
-    .option('--pretty', 'Force human-readable output even when piped');
+    .option('--pretty', 'Force human-readable output even when piped')
+    .option('-q, --quiet', 'Suppress non-essential output (banners, hints, progress)')
+    .exitOverride(); // Throw CommanderError instead of calling process.exit directly
 // Apply global output mode BEFORE subcommand actions run
 program.hook('preAction', (thisCommand) => {
     const globalOpts = program.opts();
@@ -55,8 +111,43 @@ program.hook('preAction', (thisCommand) => {
         setOutputMode('pretty');
     }
     // else: 'auto' (default) — TTY detection handles it
+    if (globalOpts.quiet) {
+        setQuietMode(true);
+    }
     void thisCommand;
 });
+// Default action — contextual guidance when `pb` is invoked with no command.
+// `pb --help` still works because Commander intercepts --help before the action runs.
+program.action(() => {
+    // If in JSON mode, output structured data
+    if (isJsonMode()) {
+        process.stdout.write(JSON.stringify({ hint: 'Run pb --help for available commands.' }) + '\n');
+        return;
+    }
+    const apiKey = process.env.PRODUCTBRAIN_API_KEY ?? '';
+    const hasKey = apiKey.startsWith('pb_sk_');
+    process.stdout.write('\n');
+    process.stdout.write(`${bold('Product Brain')}\n\n`);
+    if (!hasKey) {
+        process.stdout.write(`${heading('Get started')}\n\n`);
+        hint('pb login          Save your API key');
+        hint('pb doctor         Check configuration');
+        hint('pb setup          Guided first-time setup');
+        process.stdout.write('\n');
+        hint('pb --help         Show all commands');
+    }
+    else {
+        process.stdout.write(`${heading('Quick start')}\n\n`);
+        hint('pb orient -b      Workspace overview');
+        hint('pb search <q>     Search the Chain');
+        hint('pb capture <text> Capture knowledge');
+        hint('pb session start  Start a write session');
+        process.stdout.write('\n');
+        hint('pb --help         Show all commands');
+        hint('pb glossary       Key terms');
+    }
+    process.stdout.write('\n');
+});
 program
     .command('get <entry-id>')
     .description('Display full entry by ID (data, relations, last 10 history events)')
@@ -65,25 +156,13 @@ program
         program.commands.find((c) => c.name() === 'get')?.help();
         return;
     }
-    try {
-        await runGet({ entryId: entryId.trim() });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runGet({ entryId: entryId.trim() });
 });
 program
     .command('get-many <entry-ids...>')
     .description('Fetch multiple entries in parallel (space-separated IDs)')
     .action(async (entryIds) => {
-    try {
-        await runGetMany({ entryIds: entryIds.map((id) => id.trim()).filter(Boolean) });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runGetMany({ entryIds: entryIds.map((id) => id.trim()).filter(Boolean) });
 });
 program
     .command('context <entry-id>')
@@ -93,26 +172,14 @@ program
         program.commands.find((c) => c.name() === 'context')?.help();
         return;
     }
-    try {
-        await runContext({ entryId: entryId.trim() });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runContext({ entryId: entryId.trim() });
 });
 program
     .command('changes')
     .description('Detect entries modified and relations created since a given time (BET-239)')
     .requiredOption('--since <duration>', 'Time window: 1h, 6h, 1d, 7d, 30d')
     .action(async (opts) => {
-    try {
-        await runChanges({ since: opts.since });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runChanges({ since: opts.since });
 });
 program
     .command('walk <entry-id>')
@@ -121,36 +188,26 @@ program
     .option('--direction <dir>', 'Traversal direction: outgoing or incoming (default outgoing)', 'outgoing')
     .option('-t, --type <relation-type>', 'Filter by relation type (e.g. depends_on, informs, governs)')
     .action(async (entryId, opts) => {
-    try {
-        const depth = parseInt(opts.depth, 10);
-        if (isNaN(depth) || depth < 1 || depth > 4) {
-            console.error('--depth must be between 1 and 4.');
-            process.exit(1);
-        }
-        await runChainWalk({
-            entryId: entryId.trim(),
-            depth,
-            direction: opts.direction,
-            type: opts.type,
+    const depth = parseInt(opts.depth, 10);
+    if (isNaN(depth) || depth < 1 || depth > 4) {
+        throw new CLIError('--depth must be between 1 and 4.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
         });
     }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runChainWalk({
+        entryId: entryId.trim(),
+        depth,
+        direction: opts.direction,
+        type: opts.type,
+    });
 });
 program
     .command('cross-cut')
     .description('Structural aggregation — all relations of a given type grouped by source collection (BET-239)')
     .requiredOption('--type <relation-type>', 'Relation type to scan (e.g. part_of, informs, governs)')
     .action(async (opts) => {
-    try {
-        await runCrossCut({ type: opts.type });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCrossCut({ type: opts.type });
 });
 program
     .command('brief [type]')
@@ -163,27 +220,20 @@ program
     .option('--since-last', 'Compare against last brief run (incremental mode)')
     .option('--since <timestamp>', 'ISO 8601 timestamp for delta type (e.g. 2026-03-24T00:00:00Z)')
     .action(async (type, opts) => {
-    try {
-        // If positional arg is a compound type, route to compound brief
-        if (type && isCompoundType(type)) {
-            await runCompoundBrief({ type, since: opts.since });
-            return;
-        }
-        // Otherwise, require --skill for incremental brief
-        if (!opts.skill) {
-            console.error('Usage:\n' +
-                '  pb brief --skill <name>    Incremental delta\n' +
-                '  pb brief steering          Compound steering brief\n' +
-                '  pb brief confidence        Compound confidence pass\n' +
-                '  pb brief delta             Compound delta sync');
-            process.exit(1);
-        }
-        await runBrief({ skill: opts.skill, sinceLast: opts.sinceLast });
+    // If positional arg is a compound type, route to compound brief
+    if (type && isCompoundType(type)) {
+        await runCompoundBrief({ type, since: opts.since });
+        return;
     }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
+    // Otherwise, require --skill for incremental brief
+    if (!opts.skill) {
+        throw new CLIError('Usage:\n' +
+            '  pb brief --skill <name>    Incremental delta\n' +
+            '  pb brief steering          Compound steering brief\n' +
+            '  pb brief confidence        Compound confidence pass\n' +
+            '  pb brief delta             Compound delta sync', { code: ErrorCode.VALIDATION_FAILED, category: 'validation' });
     }
+    await runBrief({ skill: opts.skill, sinceLast: opts.sinceLast });
 });
 program
     .command('search [query...]')
@@ -194,13 +244,7 @@ program
         program.commands.find((c) => c.name() === 'search')?.help();
         return;
     }
-    try {
-        await runSearch({ query });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runSearch({ query });
 });
 program
     .command('orient')
@@ -210,13 +254,7 @@ program
     // SYNC: domain list must match TaskDomain in convex/mcpKnowledge/startupResolver.ts
     .option('-s, --scope <domain>', 'Domain scope for governance filtering. Valid values: auth, governance, architecture, product, data-foundation, chainwork, capture-pipeline, ingestion, intelligence-and-operations, review-and-learning, general')
     .action(async (opts) => {
-    try {
-        await runOrient({ brief: opts.brief, task: opts.task?.trim() || undefined, scope: opts.scope?.trim() || undefined });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runOrient({ brief: opts.brief, task: opts.task?.trim() || undefined, scope: opts.scope?.trim() || undefined });
 });
 program
     .command('handshake')
@@ -227,17 +265,11 @@ program
     .option('--level <level>', 'With --init: trust level (guide|work|silent|full-trust). Without --init: content tier (beginner|intermediate|expert)')
     .option('--generate', 'Fetch governance entries from the Chain and merge generated rules (BET-286)')
     .action(async (opts) => {
-    try {
-        if (opts.init) {
-            await runHandshakeInit({ level: opts.level, dryRun: opts.dryRun });
-            return;
-        }
-        await runHandshake({ force: opts.force, dryRun: opts.dryRun, level: opts.level, generate: opts.generate });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
+    if (opts.init) {
+        await runHandshakeInit({ level: opts.level, dryRun: opts.dryRun });
+        return;
     }
+    await runHandshake({ force: opts.force, dryRun: opts.dryRun, level: opts.level, generate: opts.generate });
 });
 program
     .command('codex-prep <task...>')
@@ -249,25 +281,27 @@ program
         program.commands.find((c) => c.name() === 'codex-prep')?.help();
         return;
     }
-    try {
-        await runCodexPrep({ task, dryRun: opts.dryRun });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCodexPrep({ task, dryRun: opts.dryRun });
 });
 program
     .command('login')
     .description('Save your API key to ~/.config/productbrain/.env (works from any directory)')
     .action(async () => {
-    try {
-        await runLogin();
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runLogin();
+});
+program
+    .command('doctor')
+    .description('Check CLI configuration and connectivity')
+    .option('--fix', 'Auto-repair common configuration issues')
+    .option('--dry-run', 'Preview what --fix would do without changing anything')
+    .action(async (opts) => {
+    await runDoctor({ fix: opts.fix, dryRun: opts.dryRun });
+});
+program
+    .command('setup')
+    .description('Guided first-time setup: account, login, workspace, first capture')
+    .action(async () => {
+    await runSetup();
 });
 // --- Write commands (require active session) ---
 const sessionCmd = program
@@ -278,38 +312,20 @@ sessionCmd
     .description('Start a tracked write session (opens session, refreshes context)')
     .option('--json', 'Output machine-readable JSON (deprecated: use global --json flag)')
     .action(async (opts) => {
-    try {
-        await runSessionStart({ json: opts.json });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runSessionStart({ json: opts.json });
 });
 sessionCmd
     .command('id')
     .description('Print current session ID to stdout (machine-readable, TEN-707)')
     .action(() => {
-    try {
-        runSessionId();
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    runSessionId();
 });
 sessionCmd
     .command('close')
     .description('Close the active session (wrapup, refresh context)')
     .option('--force', 'Clear local session state even if server close fails')
     .action(async (opts) => {
-    try {
-        await runSessionClose({ force: opts.force });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runSessionClose({ force: opts.force });
 });
 program
     .command('capture [text...]')
@@ -328,23 +344,17 @@ program
         program.commands.find((c) => c.name() === 'capture')?.help();
         return;
     }
-    try {
-        await runCapture({
-            text: text || opts.name || '',
-            name: opts.name,
-            description: opts.description,
-            collection: opts.collection,
-            link: opts.link,
-            type: opts.type,
-            sourceRef: opts.sourceRef,
-            sourceExcerpt: opts.sourceExcerpt,
-            json: opts.json,
-        });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCapture({
+        text: text || opts.name || '',
+        name: opts.name,
+        description: opts.description,
+        collection: opts.collection,
+        link: opts.link,
+        type: opts.type,
+        sourceRef: opts.sourceRef,
+        sourceExcerpt: opts.sourceExcerpt,
+        json: opts.json,
+    });
 });
 // --- Update command (TEN-703) ---
 program
@@ -356,20 +366,14 @@ program
     .option('--workflow-status <status>', 'Set workflow status (server-validated)')
     .option('--note <text>', 'Change note for history')
     .action(async (entryId, opts) => {
-    try {
-        await runUpdate({
-            entryId,
-            field: opts.field,
-            name: opts.name,
-            status: opts.status,
-            workflowStatus: opts.workflowStatus,
-            note: opts.note,
-        });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runUpdate({
+        entryId,
+        field: opts.field,
+        name: opts.name,
+        status: opts.status,
+        workflowStatus: opts.workflowStatus,
+        note: opts.note,
+    });
 });
 // --- Promote command (Wave 2 CLI Polish) ---
 program
@@ -380,26 +384,14 @@ program
         program.commands.find((c) => c.name() === 'verify')?.help();
         return;
     }
-    try {
-        await runVerify({ entryId: entryId.trim() });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runVerify({ entryId: entryId.trim() });
 });
 program
     .command('promote <entry-id>')
     .description('Promote entry from draft to active (commit to SSOT)')
     .option('-m, --message <text>', 'Commit message')
     .action(async (entryId, opts) => {
-    try {
-        await runPromote({ entryId, message: opts.message });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runPromote({ entryId, message: opts.message });
 });
 // --- Relate / Unrelate commands (TEN-704) ---
 program
@@ -407,25 +399,13 @@ program
     .description('Add a typed relation between two entries (requires active session)')
     .option('--if-missing', 'Only create relation if it does not already exist')
     .action(async (fromId, type, toId, opts) => {
-    try {
-        await runRelate({ fromId, type, toId, ifMissing: opts.ifMissing });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runRelate({ fromId, type, toId, ifMissing: opts.ifMissing });
 });
 program
     .command('unrelate <from-id> <type> <to-id>')
     .description('Remove a typed relation between two entries (requires active session)')
     .action(async (fromId, type, toId) => {
-    try {
-        await runUnrelate({ fromId, type, toId });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runUnrelate({ fromId, type, toId });
 });
 // --- Ingest command (BET-81) ---
 program
@@ -435,23 +415,19 @@ program
     .option('--resume', 'Skip files whose sourceRef is already committed in staging.')
     .option('--concurrency <n>', 'Process up to N files in parallel (default 1, max 5).', '1')
     .action(async (pattern, opts) => {
-    try {
-        const concurrency = parseInt(opts.concurrency ?? '1', 10);
-        if (Number.isNaN(concurrency) || concurrency < 1) {
-            console.error('--concurrency must be a positive integer.');
-            process.exit(1);
-        }
-        await runIngest({
-            pattern,
-            dryRun: opts.dryRun,
-            resume: opts.resume,
-            concurrency,
+    const concurrency = parseInt(opts.concurrency ?? '1', 10);
+    if (Number.isNaN(concurrency) || concurrency < 1) {
+        throw new CLIError('--concurrency must be a positive integer.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
         });
     }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runIngest({
+        pattern,
+        dryRun: opts.dryRun,
+        resume: opts.resume,
+        concurrency,
+    });
 });
 // --- Fields command (BET-181 Slice 2) ---
 program
@@ -462,13 +438,7 @@ program
         program.commands.find((c) => c.name() === 'fields')?.help();
         return;
     }
-    try {
-        await runFields({ collectionSlug: collection.trim() });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runFields({ collectionSlug: collection.trim() });
 });
 // --- Constellation command (BET-181 Slice 3) ---
 program
@@ -479,13 +449,7 @@ program
         program.commands.find((c) => c.name() === 'constellation')?.help();
         return;
     }
-    try {
-        await runConstellation({ entryId: entryId.trim() });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runConstellation({ entryId: entryId.trim() });
 });
 // --- Audit command (BET-182 Slice 2) ---
 program
@@ -496,19 +460,13 @@ program
     .option('--fix', 'Auto-execute exact fixes via pb update, rerun once')
     .option('--verbose', 'Show all gates including PASS detail')
     .action(async (entryIds, opts) => {
-    try {
-        await runAudit({
-            entryIds: entryIds.map((id) => id.trim()).filter(Boolean),
-            phase: opts.phase,
-            gate: opts.gate,
-            fix: opts.fix,
-            verbose: opts.verbose,
-        });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runAudit({
+        entryIds: entryIds.map((id) => id.trim()).filter(Boolean),
+        phase: opts.phase,
+        gate: opts.gate,
+        fix: opts.fix,
+        verbose: opts.verbose,
+    });
 });
 program
     .command('brand-pack')
@@ -523,13 +481,7 @@ program
     .command('proposals')
     .description('List open consent proposals with expiry countdown (BET-221)')
     .action(async () => {
-    try {
-        await runProposals();
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runProposals();
 });
 program
     .command('accept [proposal-id]')
@@ -537,29 +489,19 @@ program
     .option('-a, --auto', 'Auto-approve all open proposals (skip contradictions)')
     .action(async (proposalId, opts) => {
     if (!proposalId && !opts.auto) {
-        process.stderr.write('Usage: pb accept <proposal-id> or pb accept --auto\n');
-        process.exit(1);
-    }
-    try {
-        await runAccept({ proposalId, auto: opts.auto });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
+        throw new CLIError('Usage: pb accept <proposal-id> or pb accept --auto', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+        });
     }
+    await runAccept({ proposalId, auto: opts.auto });
 });
 program
     .command('reject <proposal-id>')
     .description('Reject a consent proposal with a required reason (BR-7)')
     .requiredOption('-r, --reason <text>', 'Reason for rejection (required)')
     .action(async (proposalId, opts) => {
-    try {
-        await runReject({ proposalId, reason: opts.reason });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runReject({ proposalId, reason: opts.reason });
 });
 // --- Collections command (BET-280 Slice 1) ---
 const collectionsCmd = program
@@ -569,13 +511,7 @@ collectionsCmd
     .command('list')
     .description('List all collections — slug, name, field count, icon')
     .action(async () => {
-    try {
-        await runCollectionsList();
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCollectionsList();
 });
 collectionsCmd
     .command('get <slug>')
@@ -585,37 +521,68 @@ collectionsCmd
         program.commands.find((c) => c.name() === 'collections')?.help();
         return;
     }
-    try {
-        await runCollectionsGet({ slug: slug.trim() });
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCollectionsGet({ slug: slug.trim() });
 });
 collectionsCmd
     .command('audit')
     .description('Collection health report — classification, icon, displayHint coverage, schema gaps')
     .action(async () => {
-    try {
-        await runCollectionsAudit();
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCollectionsAudit();
 });
 collectionsCmd
     .command('export')
     .description('Export all system_collection_definitions with full classification metadata (admin only)')
     .action(async () => {
-    try {
-        await runCollectionsExport();
-    }
-    catch (err) {
-        console.error(err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    }
+    await runCollectionsExport();
 });
-program.parse();
+// --- Profile commands (WP-302 Slice 2) ---
+const profileCmd = program
+    .command('profile')
+    .description('Manage workspace profiles (WP-302: multi-workspace support)');
+profileCmd
+    .command('list')
+    .description('List all profiles, mark active one')
+    .action(async () => {
+    await runProfileList();
+});
+profileCmd
+    .command('create <name>')
+    .description('Create a new profile with an API key')
+    .requiredOption('--api-key <key>', 'API key (pb_sk_...)')
+    .option('--url <url>', 'Convex site URL (defaults to production)')
+    .action(async (name, opts) => {
+    await runProfileCreate({ name, apiKey: opts.apiKey, url: opts.url });
+});
+profileCmd
+    .command('use <name>')
+    .description('Switch active profile (closes any active session)')
+    .action(async (name) => {
+    await runProfileUse({ name });
+});
+profileCmd
+    .command('delete <name>')
+    .description('Delete a profile (cannot delete active or last profile)')
+    .action(async (name) => {
+    await runProfileDelete({ name });
+});
+// --- Glossary command (WP-302 Slice 4) ---
+program
+    .command('glossary')
+    .description('Show key Product Brain CLI terms and definitions')
+    .action(() => {
+    if (isJsonMode()) {
+        process.stdout.write(JSON.stringify(GLOSSARY) + '\n');
+        return;
+    }
+    const lines = [
+        '',
+        heading('Glossary'),
+        '',
+        formatGlossary(),
+        '',
+    ];
+    process.stdout.write(lines.join('\n') + '\n');
+});
+// Parse with global error handler — all uncaught errors route through handleError
+program.parseAsync().catch(handleError);
 //# sourceMappingURL=index.js.map