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

package/dist/commands/history.test.js

@@ -0,0 +1,106 @@
+/**
+ * `pb history <entry-id>`.
+ *
+ * Reuses the existing `chain.listEntryVersions` gateway route (no new door): these tests assert
+ * the exact route/args crossing the wire, the not-found refusal, and the pretty-print shape —
+ * especially the "Accepted by <person> (<role>)" line and its "role archived or no longer
+ * resolvable" marker (INS-2585's reader contract for a since-archived/unresolvable accepting role).
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { getConfigOrGuide, kernelCall, runCliCommand } = vi.hoisted(() => ({
+    getConfigOrGuide: vi.fn(),
+    kernelCall: vi.fn(),
+    runCliCommand: vi.fn(async ({ fn }) => fn()),
+}));
+vi.mock('../lib/config.js', () => ({ getConfigOrGuide }));
+vi.mock('../lib/client.js', () => ({ kernelCall }));
+vi.mock('../lib/runner.js', () => ({ runCliCommand }));
+import { runHistory, formatHistory } from './history.js';
+describe('pb history', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        getConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://example.test' });
+    });
+    it('calls chain.listEntryVersions with the given entry id, no workspaceId (gateway-injected)', async () => {
+        kernelCall.mockResolvedValue({ acceptedBy: null, acceptedByRole: null, acceptedByRoleArchived: false, truncated: false, versions: [] });
+        await runHistory({ entryId: 'DEC-100' });
+        expect(kernelCall).toHaveBeenCalledWith('chain.listEntryVersions', { entryId: 'DEC-100' });
+    });
+    it('refuses with a clear message when the entry is not found', async () => {
+        kernelCall.mockResolvedValue(null);
+        await expect(runHistory({ entryId: 'DEC-999' })).rejects.toThrow(/not found/i);
+    });
+    it('formats "Accepted by <person> (<role>)" when both are set', () => {
+        const text = formatHistory('DEC-100', {
+            acceptedBy: 'Randy Hereman', acceptedByRole: 'Head of Product', acceptedByRoleArchived: false,
+            truncated: false, versions: [],
+        });
+        expect(text).toContain('Accepted by Randy Hereman (Head of Product)');
+        expect(text).not.toContain('role archived');
+    });
+    it('marks the accepting role archived-or-unresolvable without hiding the person or the frozen role name', () => {
+        const text = formatHistory('DEC-100', {
+            acceptedBy: 'Randy Hereman', acceptedByRole: 'Head of Product', acceptedByRoleArchived: true,
+            truncated: false, versions: [],
+        });
+        expect(text).toContain('Accepted by Randy Hereman (Head of Product, role archived or no longer resolvable)');
+    });
+    it('shows the person alone, no role parens, when acceptedByRole is null (e.g. no organisational authority applied)', () => {
+        const text = formatHistory('DEC-100', {
+            acceptedBy: 'Randy Hereman', acceptedByRole: null, acceptedByRoleArchived: false,
+            truncated: false, versions: [],
+        });
+        const acceptedByLine = text.split('\n').find((line) => line.startsWith('Accepted by'));
+        expect(acceptedByLine).toBe('Accepted by Randy Hereman');
+    });
+    it('omits the Accepted-by line entirely when no accept event has ever been written', () => {
+        const text = formatHistory('DEC-100', { acceptedBy: null, acceptedByRole: null, acceptedByRoleArchived: false, truncated: false, versions: [] });
+        expect(text).not.toContain('Accepted by');
+    });
+    it('renders one line per version with the resolved display name, role, and change note', () => {
+        const text = formatHistory('DEC-100', {
+            acceptedBy: null, acceptedByRole: null, acceptedByRoleArchived: false, truncated: false,
+            versions: [
+                {
+                    version: 2, name: 'DEC-100', changeNote: 'tightened scope',
+                    publishedAt: Date.parse('2026-02-01T00:00:00Z'),
+                    versionStatus: 'published', displayName: 'Randy Hereman', authorRole: 'Head of Product', authorRoleArchived: false,
+                },
+                {
+                    version: 1, name: 'DEC-100', changeNote: null,
+                    publishedAt: Date.parse('2026-01-01T00:00:00Z'),
+                    versionStatus: 'superseded', displayName: 'Randy Hereman', authorRole: null, authorRoleArchived: false,
+                },
+            ],
+        });
+        expect(text).toContain('v2  2026-02-01  Randy Hereman (Head of Product)  [published] — tightened scope');
+        expect(text).toContain('v1  2026-01-01  Randy Hereman  [superseded]');
+    });
+    it('marks a per-version authorRoleArchived the same way as the entry-level marker', () => {
+        const text = formatHistory('DEC-100', {
+            acceptedBy: null, acceptedByRole: null, acceptedByRoleArchived: false, truncated: false,
+            versions: [{
+                    version: 1, name: 'DEC-100', changeNote: null,
+                    publishedAt: Date.parse('2026-01-01T00:00:00Z'),
+                    versionStatus: 'published', displayName: 'Randy Hereman', authorRole: 'Retired Role', authorRoleArchived: true,
+                }],
+        });
+        expect(text).toContain('Randy Hereman (Retired Role, role archived or no longer resolvable)');
+    });
+    it('surfaces truncation when the read was bounded', () => {
+        const text = formatHistory('DEC-100', {
+            acceptedBy: null, acceptedByRole: null, acceptedByRoleArchived: false, truncated: true,
+            versions: [{
+                    version: 1, name: 'DEC-100', changeNote: null,
+                    publishedAt: Date.parse('2026-01-01T00:00:00Z'),
+                    versionStatus: 'published', displayName: 'Randy Hereman', authorRole: null, authorRoleArchived: false,
+                }],
+        });
+        expect(text).toContain('truncated');
+    });
+    it('says so plainly when an entry has no published versions yet', () => {
+        const text = formatHistory('DEC-100', { acceptedBy: null, acceptedByRole: null, acceptedByRoleArchived: false, truncated: false, versions: [] });
+        expect(text).toContain('No published versions yet.');
+    });
+});
+//# sourceMappingURL=history.test.js.map

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

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

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;AAiBH,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,CAiKrE"}

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 { kernelCall } 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,176 @@ 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 kernelCall('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 kernelCall('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;
+        }
+    }
+    // WP-479 review fix (Codex re-review): ingest is a short-lived HELPER session that the `finally`
+    // below closes. It must own a UNIQUE conversation id so it neither reuses the user's active session
+    // (whose marker the finally-close would strand) nor collides with a CONCURRENT `pb ingest` in the
+    // same shell — two ingests sharing an `ingest:<base>` id would reuse one session and one finally
+    // could close it while the other is still calling `chain.ingestDocument`. `ingestionRunId` is a
+    // fresh per-invocation UUID, so each ingest gets its own isolated, quota-enforced helper session.
+    const ingestConversationId = `ingest:${ingestionRunId}`;
+    const startRes = await kernelCall('agent.startSession', {
         workspaceId: workspace._id,
         apiKeyId: workspace.keyId,
         clientKind: 'cli',
+        conversationId: ingestConversationId,
+        label: `ingest: ${options.pattern}`,
     });
     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 kernelCall('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 kernelCall('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 getConfigSafe() for key diagnosis, then probes workspace connectivity.
+ */
+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;AASH,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,CAiG7C"}

package/dist/commands/init.js

@@ -0,0 +1,120 @@
+/**
+ * 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 getConfigSafe() for key diagnosis, then probes workspace connectivity.
+ */
+import { getConfigSafe } 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';
+/**
+ * Detect the current setup state without throwing.
+ * Sync check only — does not hit the network.
+ */
+export function detectState() {
+    return detectStateFromConfig(getConfigSafe());
+}
+function detectStateFromConfig(configResult) {
+    if (!configResult.ok)
+        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 configResult = getConfigSafe();
+    const localState = detectStateFromConfig(configResult);
+    if (json) {
+        // For JSON mode, try to enrich with network probe if we have a key
+        if (localState === 'fresh') {
+            const failure = configResult.ok ? null : configResult;
+            process.stdout.write(JSON.stringify({
+                state: 'fresh',
+                configured: false,
+                ...(failure && failure.kind !== 'missing-key' ? { reason: failure.reason } : {}),
+                next: failure?.nextCommand ?? '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') {
+        if (!configResult.ok && configResult.kind !== 'missing-key') {
+            process.stdout.write('\n');
+            process.stdout.write(`${bold('Product Brain')} — configuration needs attention\n\n`);
+            process.stdout.write(`  ${configResult.reason}\n\n`);
+            process.stdout.write(`${heading('Next step')}\n\n`);
+            hint(configResult.nextCommand);
+            process.stdout.write('\n');
+            return;
+        }
+        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`);
+    }
+    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"}