@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.1400

package/dist/commands/update.js

@@ -5,12 +5,13 @@
  * Thin client: validation lives in Convex (BR-104).
  */
 import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall, mcpCallWithSession } from '../lib/client.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 `=`.
@@ -20,12 +21,20 @@ function parseFields(fields) {
     for (const f of fields) {
         const eqIndex = f.indexOf('=');
         if (eqIndex === -1) {
-            throw new Error(`Invalid --field format: "${f}". Expected key=value.`);
+            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 Error(`Invalid --field format: "${f}". Key cannot be empty.`);
+            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;
     }
@@ -39,24 +48,34 @@ export async function runUpdate(options) {
     // Require active session (DEC-9, BR-8)
     const session = readSession();
     if (!session) {
-        process.stderr.write('No active session. Run `pb session start` first.\n');
-        process.stderr.write('Write access requires a tracked session (DEC-9).\n');
-        process.exit(1);
+        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) {
-        process.stderr.write('Entry ID is required. Usage: pb update <entry-id> [options]\n');
-        process.exit(1);
+        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);
     }
@@ -64,15 +83,18 @@ export async function runUpdate(options) {
         args.changeNote = options.note;
     }
     // Must have at least one thing to update
-    if (!options.name && !options.status && (!options.field || options.field.length === 0)) {
-        process.stderr.write('Nothing to update. Provide at least one of: --field, --name, --status\n');
-        process.exit(1);
+    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 mcpCallWithSession('chain.updateEntry', args);
+        result = await kernelCallWithSession('chain.updateEntry', args);
     }
     catch (err) {
         // McpError carries code + details from the server. Check by name to avoid
@@ -82,22 +104,22 @@ export async function runUpdate(options) {
             // 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 && !json) {
-                    process.stderr.write(`Error: validation failed\n`);
-                    for (const d of selectErrors) {
+                if (selectErrors.length > 0) {
+                    const fieldMessages = selectErrors.map((d) => {
                         const got = typeof d.invalidValue === 'string' ? d.invalidValue : JSON.stringify(d.invalidValue);
-                        process.stderr.write(`  Field '${d.fieldLabel}' must be one of: ${d.validOptions.join(', ')}. Got: '${got}'\n`);
-                    }
-                    process.exit(1);
-                }
-                if (json) {
-                    process.stderr.write(JSON.stringify({ error: mcpErr.message, code: mcpErr.code, details: mcpErr.details }) + '\n');
-                    process.exit(1);
+                        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 error message
-            process.stderr.write(`Error: ${mcpErr.message}\n`);
-            process.exit(1);
+            // Fallback: plain MCP error
+            throw new CLIError(mcpErr.message, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+            });
         }
         throw err;
     }
@@ -105,11 +127,18 @@ export async function runUpdate(options) {
     // Graceful degradation: if the get fails, still show the update receipt.
     let refreshedEntry = null;
     try {
-        refreshedEntry = await mcpCall('chain.getEntry', { entryId });
+        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.
@@ -117,6 +146,9 @@ export async function runUpdate(options) {
         if (refreshedEntry) {
             output.entry = stripConvexInternals(refreshedEntry);
         }
+        if (hasRejected) {
+            output.fieldsRejected = true;
+        }
         process.stdout.write(JSON.stringify(output) + '\n');
     }
     else {
@@ -135,5 +167,13 @@ export async function runUpdate(options) {
             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

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