@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.1000

package/dist/commands/update.js

@@ -0,0 +1,179 @@
+/**
+ * pb update <entry-id> — update fields on existing Chain entries.
+ * Resolves TEN-703. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * Thin client: validation lives in Convex (BR-104).
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall, kernelCallWithSession } from '../lib/client.js';
+import { readSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+import { stripConvexInternals } from '../lib/strip.js';
+import { formatUpdateReceipt } from '../formatters/update.js';
+import { formatEntry } from '../formatters/entry.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+/**
+ * Parse --field key=value pairs into a data object.
+ * Splits on first `=` only to handle values containing `=`.
+ */
+function parseFields(fields) {
+    const data = {};
+    for (const f of fields) {
+        const eqIndex = f.indexOf('=');
+        if (eqIndex === -1) {
+            throw new CLIError(`Invalid --field format: "${f}". Expected key=value.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Use --field key=value (split on first "=").',
+            });
+        }
+        const key = f.slice(0, eqIndex).trim();
+        const value = f.slice(eqIndex + 1).trim();
+        if (!key) {
+            throw new CLIError(`Invalid --field format: "${f}". Key cannot be empty.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Provide a non-empty key before the "=" sign.',
+            });
+        }
+        data[key] = value;
+    }
+    return data;
+}
+export async function runUpdate(options) {
+    const config = await getConfigOrGuide(() => runUpdate(options));
+    if (!config)
+        return;
+    const json = isJsonMode();
+    // Require active session (DEC-9, BR-8)
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            // DEC-9
+            guidance: 'Run `pb session start` first. Write access requires a tracked session.',
+        });
+    }
+    // Validate entryId
+    const entryId = options.entryId.trim();
+    if (!entryId) {
+        throw new CLIError('Entry ID is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb update <entry-id> [options]',
+        });
+    }
+    // Build update args
+    const args = { entryId };
+    args.changedBy = `agent:${session.sessionId}`;
+    if (options.name) {
+        args.name = options.name;
+    }
+    if (options.status) {
+        args.status = options.status;
+    }
+    if (options.workflowStatus) {
+        args.workflowStatus = options.workflowStatus;
+    }
+    if (options.field && options.field.length > 0) {
+        args.data = parseFields(options.field);
+    }
+    if (options.note) {
+        args.changeNote = options.note;
+    }
+    // Must have at least one thing to update
+    if (!options.name && !options.status && !options.workflowStatus && (!options.field || options.field.length === 0)) {
+        throw new CLIError('Nothing to update.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Provide at least one of: --field, --name, --status, --workflow-status',
+        });
+    }
+    if (!json)
+        process.stdout.write(`Updating ${entryId}...\n`);
+    let result;
+    try {
+        result = await kernelCallWithSession('chain.updateEntry', args);
+    }
+    catch (err) {
+        // McpError carries code + details from the server. Check by name to avoid
+        // class identity issues across module boundaries.
+        const mcpErr = err;
+        if (err instanceof Error && err.name === 'McpError') {
+            // Render structured validation errors for select/multi-select fields.
+            if (mcpErr.details && mcpErr.details.length > 0) {
+                const selectErrors = mcpErr.details.filter((d) => d.errorType === 'invalid_option' && d.validOptions);
+                if (selectErrors.length > 0) {
+                    const fieldMessages = selectErrors.map((d) => {
+                        const got = typeof d.invalidValue === 'string' ? d.invalidValue : JSON.stringify(d.invalidValue);
+                        return `Field '${d.fieldLabel}' must be one of: ${d.validOptions.join(', ')}. Got: '${got}'`;
+                    });
+                    throw new CLIError(`Validation failed: ${fieldMessages.join('; ')}`, {
+                        code: ErrorCode.VALIDATION_FAILED,
+                        category: 'validation',
+                    });
+                }
+            }
+            // Fallback: plain MCP error
+            throw new CLIError(mcpErr.message, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+            });
+        }
+        throw err;
+    }
+    // Fetch the refreshed entry so the user sees current state, not just a receipt.
+    // Graceful degradation: if the get fails, still show the update receipt.
+    let refreshedEntry = null;
+    try {
+        refreshedEntry = await kernelCall('chain.getEntry', { entryId });
+    }
+    catch {
+        // Non-fatal — display issue, not a write failure
+    }
+    // BET-271 S1: Determine if any fields were rejected by normalization.
+    const rejectedFields = result.normalization?.rejected ?? [];
+    const hasRejected = rejectedFields.length > 0;
+    // Note: EntryFromApi has canonicalKey (e.g. "bet") but pb fields expects
+    // the collection slug (e.g. "bets"). Since the slug isn't available here,
+    // omit the collection hint — the user knows their entry type.
+    const collectionHint = '';
+    if (json) {
+        // Spread existing result fields flat (preserves backward compat with scripts
+        // that read .id / .warnings / etc.) and add `entry` alongside when available.
+        const output = { ...stripConvexInternals(result) };
+        if (refreshedEntry) {
+            output.entry = stripConvexInternals(refreshedEntry);
+        }
+        if (hasRejected) {
+            output.fieldsRejected = true;
+        }
+        process.stdout.write(JSON.stringify(output) + '\n');
+    }
+    else {
+        process.stdout.write('\n');
+        process.stdout.write(formatUpdateReceipt({
+            entryId,
+            changeNote: options.note,
+            fieldsChanged: options.field ?? [],
+            name: options.name,
+            status: options.status,
+            normalizationWarnings: result.normalizationWarnings ?? [],
+            validationWarnings: result.validationWarnings ?? [],
+        }) + '\n');
+        if (refreshedEntry) {
+            process.stdout.write('\n');
+            process.stdout.write(formatEntry(refreshedEntry) + '\n');
+        }
+    }
+    // BET-271 S1: Throw when fields were rejected — signals "not everything you asked for happened."
+    if (hasRejected) {
+        throw new CLIError(`Fields rejected: ${rejectedFields.join(', ')}.`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: `Run \`pb fields${collectionHint}\` to see valid fields.`,
+        });
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,5 @@
+export type RunUpgradeOptions = {
+    currentVersion: string;
+};
+export declare function runUpgrade({ currentVersion }: RunUpgradeOptions): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.tsx"],"names":[],"mappings":"AAQA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AA+FF,wBAAsB,UAAU,CAAC,EAAE,cAAc,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDrF"}

package/dist/commands/upgrade.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useEffect, useMemo, useState } from 'react';
+import { Box, Text } from 'ink';
+import { isJsonMode } from '../lib/runner.js';
+import { bold, dim } from '../lib/style.js';
+import { UPGRADE_COMMAND } from '../lib/constants.js';
+import { detectInstallChannel, buildUpgradeCommand, spawnUpgrade } from '../lib/upgrade-runner.js';
+import { isNewer, resolveLatestVersion } from '../lib/update-check.js';
+function canUseInteractiveUpgrade() {
+    return Boolean(process.stdout.isTTY &&
+        process.stdin.isTTY &&
+        !isJsonMode() &&
+        process.env.CI !== 'true' &&
+        !process.env.PB_NO_INTERACTIVE);
+}
+function ProgressLines({ lines }) {
+    const visible = lines.slice(-8);
+    return (_jsx(Box, { flexDirection: "column", marginTop: 1, children: visible.length === 0 ? (_jsx(Text, { color: "gray", children: "Waiting for installer output..." })) : visible.map((line, index) => (_jsx(Text, { color: "gray", children: line }, `${index}:${line}`))) }));
+}
+function UpgradeTui({ currentVersion, latestVersion, onDone, onExit, }) {
+    const [lines, setLines] = useState([]);
+    const [status, setStatus] = useState('running');
+    const [message, setMessage] = useState('');
+    const channel = useMemo(() => detectInstallChannel(), []);
+    const command = useMemo(() => buildUpgradeCommand(channel, latestVersion ?? undefined), [channel, latestVersion]);
+    useEffect(() => {
+        let mounted = true;
+        let timer;
+        spawnUpgrade(channel, {
+            version: latestVersion ?? undefined,
+            onOutput: (line) => {
+                if (!mounted)
+                    return;
+                setLines((prev) => [...prev, line]);
+            },
+        }).then((result) => {
+            if (!mounted)
+                return;
+            setStatus('succeeded');
+            setMessage(`Updated with ${result.command}`);
+            onDone();
+            timer = setTimeout(onExit, 700);
+        }).catch((err) => {
+            if (!mounted)
+                return;
+            setStatus('failed');
+            setMessage(err instanceof Error ? err.message : String(err));
+            onDone(err);
+            timer = setTimeout(onExit, 1200);
+        });
+        return () => {
+            mounted = false;
+            if (timer)
+                clearTimeout(timer);
+        };
+    }, [channel, onDone, onExit]);
+    const target = latestVersion ?? 'latest beta';
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, color: "cyan", children: "Upgrade pb CLI" }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { children: currentVersion }), _jsxs(Text, { color: "gray", children: [" ", '->', " "] }), _jsx(Text, { bold: true, children: target })] }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "gray", children: "Channel: " }), _jsx(Text, { children: command.channel }), _jsx(Text, { color: "gray", children: "  Command: " }), _jsx(Text, { children: command.display })] }), _jsx(ProgressLines, { lines: lines }), _jsxs(Box, { marginTop: 1, children: [status === 'running' && _jsx(Text, { color: "yellow", children: "Installing..." }), status === 'succeeded' && _jsx(Text, { color: "green", children: message }), status === 'failed' && _jsx(Text, { color: "red", children: message })] })] }));
+}
+export async function runUpgrade({ currentVersion }) {
+    const latest = await resolveLatestVersion(currentVersion);
+    const hasNewer = latest !== null && isNewer(currentVersion, latest);
+    // Anti-downgrade (DEC-3): only act when we have a STRICTLY NEWER target. A null `latest`
+    // (offline, or the registry's beta tag is <= installed) must NOT fall back to a bare
+    // `@productbrain/cli@beta` install — that can downgrade a newer installed CLI. Treat
+    // "no strictly newer target" as a no-op everywhere, never an auto-install of a bare tag.
+    if (!hasNewer) {
+        if (isJsonMode()) {
+            process.stdout.write(JSON.stringify({ status: 'current', currentVersion, latest: latest ?? null }) + '\n');
+        }
+        else if (latest) {
+            process.stdout.write(`\n${bold('pb is already current')} (${currentVersion}).\n\n`);
+        }
+        else {
+            // Could not resolve a newer version (offline / registry unreachable). Surface the manual
+            // command instead of auto-installing a bare tag that could downgrade.
+            process.stdout.write('\n');
+            process.stdout.write(`${bold('pb upgrade')}  ${dim('—')} could not determine a newer version (offline?).\n`);
+            process.stdout.write(`pb is at ${currentVersion}. To reinstall manually, run:\n\n`);
+            process.stdout.write(`  ${UPGRADE_COMMAND}\n\n`);
+        }
+        return;
+    }
+    // From here `latest` is non-null and strictly newer than the installed version.
+    if (isJsonMode()) {
+        const command = buildUpgradeCommand(detectInstallChannel(), latest).display;
+        process.stdout.write(JSON.stringify({ command, latest, hint: 'Run the command above to upgrade pb CLI.' }) + '\n');
+        return;
+    }
+    if (!canUseInteractiveUpgrade()) {
+        const displayCmd = buildUpgradeCommand(detectInstallChannel(), latest).display;
+        process.stdout.write('\n');
+        process.stdout.write(`${bold('Upgrade pb CLI')}  ${dim('—')} run the command below:\n\n`);
+        process.stdout.write(`  ${displayCmd}\n\n`);
+        process.stdout.write(`${dim(currentVersion)} -> ${latest}\n\n`);
+        return;
+    }
+    const { render } = await import('ink');
+    let upgradeError;
+    const { waitUntilExit, unmount } = render(React.createElement(UpgradeTui, {
+        currentVersion,
+        latestVersion: latest,
+        onDone: (err) => { upgradeError = err; },
+        onExit: () => unmount(),
+    }));
+    await waitUntilExit();
+    if (upgradeError)
+        throw upgradeError;
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/upgrade.js.map

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

package/dist/commands/usage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * pb usage — Ink TUI dashboard for session and activity data (WP-322 S4, E2/FEAT-1011).
+ *
+ * Tabs:
+ *   Overview  — summary stats (total sessions, entries 30d, avg duration, last session)
+ *   Activity  — table: Date | Sessions | Entries | Relations | Gate Failures (30d)
+ *   Spend     — static placeholder (v1)
+ *   Insights  — text-based activity heatmap (30d)
+ *
+ * JSON mode (--json): fetches data and emits structured JSON to stdout, no Ink.
+ * Non-TTY fallback: plain-text summary.
+ *
+ * Keyboard:
+ *   Tab / Shift+Tab  — cycle tabs
+ *   q / Escape       — quit
+ *
+ * Chain: WP-322, DEC-572 (envelope SSOT, supersedes DEC-299), DEC-184 (clientKind)
+ */
+/** Mirrors agent.getActivityByDay response shape (added in S3). */
+export type ActivityDay = {
+    date: string;
+    sessionCount: number;
+    entriesCreated: number;
+    relationsCreated: number;
+    gateFailures: number;
+};
+type UsageData = {
+    activity: ActivityDay[];
+    workspaceId: string;
+};
+export type UsageDashboardProps = {
+    data: UsageData;
+    onExit: () => void;
+};
+export declare function UsageDashboard({ data, onExit }: UsageDashboardProps): import("react/jsx-runtime").JSX.Element;
+export declare function runUsage(options?: {
+    json?: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/commands/usage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA8RF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,mBAAmB,2CAqCnE;AAkDD,wBAAsB,QAAQ,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC9E"}

package/dist/commands/usage.js

@@ -0,0 +1,232 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * pb usage — Ink TUI dashboard for session and activity data (WP-322 S4, E2/FEAT-1011).
+ *
+ * Tabs:
+ *   Overview  — summary stats (total sessions, entries 30d, avg duration, last session)
+ *   Activity  — table: Date | Sessions | Entries | Relations | Gate Failures (30d)
+ *   Spend     — static placeholder (v1)
+ *   Insights  — text-based activity heatmap (30d)
+ *
+ * JSON mode (--json): fetches data and emits structured JSON to stdout, no Ink.
+ * Non-TTY fallback: plain-text summary.
+ *
+ * Keyboard:
+ *   Tab / Shift+Tab  — cycle tabs
+ *   q / Escape       — quit
+ *
+ * Chain: WP-322, DEC-572 (envelope SSOT, supersedes DEC-299), DEC-184 (clientKind)
+ */
+import React, { useState } from 'react';
+import { Box, Text, useInput, useApp } from 'ink';
+import { kernelCall } from '../lib/client.js';
+import { isJsonMode } from '../lib/runner.js';
+const TABS = ['overview', 'activity', 'spend', 'insights'];
+const TAB_LABELS = {
+    overview: 'Overview',
+    activity: 'Activity',
+    spend: 'Spend',
+    insights: 'Insights',
+};
+function nextTab(current) {
+    const idx = TABS.indexOf(current);
+    return TABS[(idx + 1) % TABS.length];
+}
+function prevTab(current) {
+    const idx = TABS.indexOf(current);
+    return TABS[(idx - 1 + TABS.length) % TABS.length];
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function padRight(s, width) {
+    return s.length >= width ? s.slice(0, width - 1) + '…' : s.padEnd(width);
+}
+function padLeft(s, width) {
+    return s.length >= width ? s.slice(0, width) : s.padStart(width);
+}
+/** Format YYYY-MM-DD as MM/DD. */
+function formatDate(iso) {
+    // iso = "YYYY-MM-DD"
+    const parts = iso.split('-');
+    if (parts.length < 3)
+        return iso;
+    return `${parts[1]}/${parts[2]}`;
+}
+/** Intensity block character for heatmap. */
+function intensityChar(n) {
+    if (n === 0)
+        return '.';
+    if (n <= 2)
+        return '░';
+    if (n <= 5)
+        return '▒';
+    return '█';
+}
+// ---------------------------------------------------------------------------
+// Derived stats for Overview tab
+// ---------------------------------------------------------------------------
+function computeOverviewStats(activity) {
+    const totalSessions = activity.reduce((s, d) => s + d.sessionCount, 0);
+    const totalEntries30d = activity.reduce((s, d) => s + d.entriesCreated, 0);
+    // Last day with sessions > 0
+    const lastActiveDay = [...activity].reverse().find((d) => d.sessionCount > 0);
+    // Average session duration: not available from activity data alone — show N/A in v1
+    // (S3 query doesn't return duration; we skip it and note it)
+    return {
+        totalSessions,
+        totalEntries30d,
+        lastActiveDay,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tab components
+// ---------------------------------------------------------------------------
+function TabBar({ activeTab }) {
+    return (_jsxs(Box, { marginBottom: 1, children: [TABS.map((tab) => {
+                const isActive = tab === activeTab;
+                return (_jsx(Box, { marginRight: 2, children: isActive ? (_jsx(Text, { bold: true, color: "cyan", underline: true, children: TAB_LABELS[tab] })) : (_jsx(Text, { color: "gray", children: TAB_LABELS[tab] })) }, tab));
+            }), _jsx(Text, { dimColor: true, color: "gray", children: "  Tab/Shift+Tab to switch \u00B7 q quit" })] }));
+}
+function OverviewTab({ activity }) {
+    const { totalSessions, totalEntries30d, lastActiveDay } = computeOverviewStats(activity);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "white", children: "Session & Activity Summary" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "gray", children: '  Sessions (30d):      ' }), _jsx(Text, { bold: true, color: "cyan", children: String(totalSessions) })] }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: '  Entries created (30d):' }), _jsxs(Text, { bold: true, color: "cyan", children: ['  ', String(totalEntries30d)] })] }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", children: '  Avg duration:        ' }), _jsx(Text, { color: "gray", children: '  n/a (v1)' })] }), lastActiveDay ? (_jsxs(Box, { children: [_jsx(Text, { color: "gray", children: '  Last active:         ' }), _jsxs(Text, { bold: true, color: "cyan", children: ['  ', lastActiveDay.date] }), _jsxs(Text, { color: "gray", children: ['  (', String(lastActiveDay.sessionCount), ' session', lastActiveDay.sessionCount !== 1 ? 's' : '', ', ', String(lastActiveDay.entriesCreated), ' entr', lastActiveDay.entriesCreated !== 1 ? 'ies' : 'y', ')'] })] })) : (_jsxs(Box, { children: [_jsx(Text, { color: "gray", children: '  Last active:         ' }), _jsx(Text, { dimColor: true, color: "gray", children: '  no sessions in last 30 days' })] }))] }), _jsx(Box, { marginTop: 2, children: _jsx(Text, { dimColor: true, color: "gray", children: '  Data covers last 30 days · spend data coming soon' }) })] }));
+}
+const COL_DATE = 8;
+const COL_SESSIONS = 9;
+const COL_ENTRIES = 9;
+const COL_RELATIONS = 11;
+const COL_GATE_FAIL = 14;
+function ActivityTab({ activity }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { children: _jsxs(Text, { color: "gray", bold: true, children: ['  ', padRight('DATE', COL_DATE), ' ', padLeft('SESSIONS', COL_SESSIONS), '  ', padLeft('ENTRIES', COL_ENTRIES), '  ', padLeft('RELATIONS', COL_RELATIONS), '  ', padLeft('GATE FAILS', COL_GATE_FAIL)] }) }), _jsx(Box, { marginBottom: 0, children: _jsx(Text, { color: "gray", children: '  ' + '─'.repeat(COL_DATE + COL_SESSIONS + COL_ENTRIES + COL_RELATIONS + COL_GATE_FAIL + 10) }) }), activity.length === 0 && (_jsx(Box, { paddingY: 1, children: _jsx(Text, { color: "gray", children: "  No activity in the last 30 days." }) })), activity.map((day) => {
+                const hasActivity = day.sessionCount > 0 || day.entriesCreated > 0 || day.relationsCreated > 0 || day.gateFailures > 0;
+                return (_jsx(Box, { children: _jsxs(Text, { color: hasActivity ? 'white' : 'gray', children: ['  ', padRight(formatDate(day.date), COL_DATE), ' ', padLeft(String(day.sessionCount), COL_SESSIONS), '  ', padLeft(String(day.entriesCreated), COL_ENTRIES), '  ', padLeft(String(day.relationsCreated), COL_RELATIONS), '  ', padLeft(String(day.gateFailures), COL_GATE_FAIL)] }) }, day.date));
+            }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: '  ' + '─'.repeat(COL_DATE + COL_SESSIONS + COL_ENTRIES + COL_RELATIONS + COL_GATE_FAIL + 10) }) }), _jsx(Box, { children: _jsxs(Text, { dimColor: true, color: "gray", children: ['  ', activity.length, " days"] }) })] }));
+}
+function SpendTab() {
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, color: "white", children: "Spend" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "  Spend tracking coming soon \u2014 upgrade to a paid plan for LLM usage analytics." }) })] }));
+}
+function InsightsTab({ activity }) {
+    // Build a lookup: date → total activity (sessions + entries)
+    const activityByDate = new Map();
+    for (const d of activity) {
+        activityByDate.set(d.date, d.sessionCount + d.entriesCreated);
+    }
+    // 30 days ending today
+    const today = new Date();
+    const days = [];
+    for (let i = 29; i >= 0; i--) {
+        const d = new Date(today);
+        d.setDate(today.getDate() - i);
+        days.push(d.toISOString().slice(0, 10));
+    }
+    // Group into weeks of 7
+    const weeks = [];
+    for (let i = 0; i < days.length; i += 7) {
+        weeks.push(days.slice(i, i + 7));
+    }
+    // Month label per week (from week-start day)
+    const monthLabels = weeks.map((week) => {
+        const first = week[0];
+        if (!first)
+            return '';
+        return new Date(first + 'T00:00:00Z').toLocaleString('default', { month: 'short' });
+    });
+    const totalActivity = activity.reduce((s, d) => s + d.sessionCount + d.entriesCreated, 0);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { bold: true, children: "Activity Heatmap \u2014 30 days" }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { dimColor: true, children: '     ' }), monthLabels.map((m, wi) => (_jsx(Text, { dimColor: true, children: m.padEnd(8).slice(0, 8) }, wi)))] }), _jsx(Box, { marginTop: 0, flexDirection: "column", children: [0, 1, 2, 3, 4, 5, 6].map((dow) => {
+                    const dayLabel = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'][dow];
+                    return (_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: dayLabel + ' ' }), weeks.map((week, wi) => {
+                                const day = week[dow];
+                                const n = day ? (activityByDate.get(day) ?? 0) : 0;
+                                const ch = day ? intensityChar(n) : ' ';
+                                const color = n === 0 ? 'gray' : n <= 2 ? 'blue' : n <= 5 ? 'cyan' : 'green';
+                                return (_jsxs(Text, { color: n > 0 ? color : undefined, dimColor: n === 0, children: [ch, ' '] }, wi));
+                            })] }, dow));
+                }) }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: [". 0  \u2591 1-2  \u2592 3-5  \u2588 6+   ", days.length, " days, ", totalActivity, " total actions"] }) })] }));
+}
+export function UsageDashboard({ data, onExit }) {
+    const { exit } = useApp();
+    const [activeTab, setActiveTab] = useState('overview');
+    useInput((input, key) => {
+        if (key.tab) {
+            if (key.shift) {
+                setActiveTab((t) => prevTab(t));
+            }
+            else {
+                setActiveTab((t) => nextTab(t));
+            }
+            return;
+        }
+        if (input === 'q' || key.escape) {
+            exit();
+            onExit();
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "pb usage  " }), _jsx(Text, { dimColor: true, color: "gray", children: "session & activity dashboard" })] }), _jsx(TabBar, { activeTab: activeTab }), activeTab === 'overview' && _jsx(OverviewTab, { activity: data.activity }), activeTab === 'activity' && _jsx(ActivityTab, { activity: data.activity }), activeTab === 'spend' && _jsx(SpendTab, {}), activeTab === 'insights' && _jsx(InsightsTab, { activity: data.activity })] }));
+}
+async function fetchUsageData() {
+    const workspace = await kernelCall('resolveWorkspace', {});
+    const workspaceId = workspace._id;
+    let activity = [];
+    try {
+        const raw = await kernelCall('agent.getActivityByDay', {
+            workspaceId,
+            daysBack: 30,
+        });
+        if (raw?.days && Array.isArray(raw.days)) {
+            activity = raw.days;
+        }
+    }
+    catch {
+        // Activity data unavailable — render with empty array
+    }
+    return { activity, workspaceId };
+}
+// ---------------------------------------------------------------------------
+// Plain-text summary (non-TTY fallback)
+// ---------------------------------------------------------------------------
+function renderPlainText(data) {
+    const { totalSessions, totalEntries30d, lastActiveDay } = computeOverviewStats(data.activity);
+    process.stdout.write(`pb usage — session & activity (last 30 days)\n`);
+    process.stdout.write(`  Sessions:        ${totalSessions}\n`);
+    process.stdout.write(`  Entries created: ${totalEntries30d}\n`);
+    if (lastActiveDay) {
+        process.stdout.write(`  Last active:     ${lastActiveDay.date} (${lastActiveDay.sessionCount} sessions, ${lastActiveDay.entriesCreated} entries)\n`);
+    }
+    else {
+        process.stdout.write(`  Last active:     no sessions in the last 30 days\n`);
+    }
+    process.stdout.write(`  Spend:           coming soon\n`);
+    process.stdout.write(`\n  Run in a TTY terminal for the interactive dashboard.\n`);
+}
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+export async function runUsage(options = {}) {
+    const json = isJsonMode() || options.json === true;
+    // Fetch data first (needed for all output modes)
+    const data = await fetchUsageData();
+    // JSON mode: emit structured output and exit
+    if (json) {
+        const { totalSessions, totalEntries30d } = computeOverviewStats(data.activity);
+        process.stdout.write(JSON.stringify({
+            sessions: totalSessions,
+            entries30d: totalEntries30d,
+            activity: data.activity,
+        }) + '\n');
+        return;
+    }
+    // Non-TTY: plain-text summary
+    if (!process.stdout.isTTY) {
+        renderPlainText(data);
+        return;
+    }
+    // TTY: Ink TUI
+    const { render } = await import('ink');
+    const { waitUntilExit, unmount } = render(React.createElement(UsageDashboard, {
+        data,
+        onExit: () => unmount(),
+    }));
+    await waitUntilExit();
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

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

package/dist/commands/verify.d.ts

@@ -0,0 +1,13 @@
+/**
+ * pb verify <entry-id> — mark a chain entry as verified.
+ * Calls chain.verifyEntry. Requires active session (DEC-9).
+ * Thin client: verification logic lives in Convex.
+ *
+ * Chain: BET-240 (Source Fidelity), FEAT-785 (E1: Verification Status Schema)
+ */
+interface VerifyOptions {
+    entryId: string;
+}
+export declare function runVerify(options: VerifyOptions): Promise<void>;
+export {};
+//# sourceMappingURL=verify.d.ts.map