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

package/dist/lib/spinner.js

@@ -0,0 +1,76 @@
+/**
+ * Contextual spinner for async operations.
+ * WP-303 Slice 2: Ambient Feedback (Spinners).
+ *
+ * - TTY: shows animated spinner with 200ms delayed start
+ * - Non-TTY / quiet / json: silent (no output)
+ * - On success: replaces spinner with success message
+ * - On failure: replaces spinner with failure message, rethrows
+ *
+ * Uses raw ANSI escape codes to stay consistent with style.ts (no @clack dependency).
+ */
+import { isQuietMode, isJsonMode } from './runner.js';
+import { green, red, icons } from './style.js';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const FRAME_INTERVAL_MS = 80;
+const DELAYED_START_MS = 200;
+/** Returns true if spinner output should be suppressed. */
+function isSilent() {
+    return !process.stdout.isTTY || isQuietMode() || isJsonMode();
+}
+/**
+ * Run an async function with a contextual spinner.
+ *
+ * In interactive TTY mode, a spinner appears after 200ms (avoids flicker for
+ * fast operations). In non-TTY / quiet / JSON mode, the function runs silently.
+ *
+ * @param label - Text shown next to the spinner (e.g. "Loading orient data")
+ * @param fn - The async operation to run
+ * @param options.successMessage - Optional override for the completion message
+ * @returns The result of fn()
+ * @throws Rethrows any error from fn() after displaying failure
+ */
+export async function withSpinner(label, fn, options) {
+    // Non-interactive: just run the function
+    if (isSilent()) {
+        return fn();
+    }
+    let frameIndex = 0;
+    let spinnerInterval;
+    let started = false;
+    const write = (text) => {
+        // Clear line and write
+        process.stderr.write(`\r\x1b[K${text}`);
+    };
+    const startSpinner = () => {
+        started = true;
+        spinnerInterval = setInterval(() => {
+            const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+            write(`${frame} ${label}`);
+            frameIndex++;
+        }, FRAME_INTERVAL_MS);
+    };
+    // Delayed start — avoids spinner flash for fast operations
+    const delayTimer = setTimeout(startSpinner, DELAYED_START_MS);
+    try {
+        const result = await fn();
+        clearTimeout(delayTimer);
+        if (spinnerInterval)
+            clearInterval(spinnerInterval);
+        if (started) {
+            const msg = options?.successMessage || label;
+            write(`${green(icons.pass)} ${msg}\n`);
+        }
+        return result;
+    }
+    catch (err) {
+        clearTimeout(delayTimer);
+        if (spinnerInterval)
+            clearInterval(spinnerInterval);
+        if (started) {
+            write(`${red(icons.fail)} ${label} \u2014 failed\n`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/lib/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1E,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,2DAA2D;AAC3D,SAAS,QAAQ;IACf,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI,UAAU,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,EAAoB,EACpB,OAAqC;IAErC,yCAAyC;IACzC,IAAI,QAAQ,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,eAA2D,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;QAC7B,uBAAuB;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,OAAO,GAAG,IAAI,CAAC;QACf,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACjE,KAAK,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;YAC3B,UAAU,EAAE,CAAC;QACf,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,2DAA2D;IAC3D,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,IAAI,eAAe;YAAE,aAAa,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;YAC7C,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,IAAI,eAAe;YAAE,aAAa,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lib/spinner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spinner.test.d.ts.map

package/dist/lib/spinner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.test.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.test.ts"],"names":[],"mappings":""}

package/dist/lib/spinner.test.js

@@ -0,0 +1,39 @@
+/**
+ * withSpinner — unit tests.
+ * WP-303 Slice 2: Ambient Feedback (Spinners).
+ *
+ * Tests run in a non-TTY environment (vitest), so the spinner is always silent.
+ * This validates the critical contract: withSpinner is transparent in non-TTY mode.
+ */
+import { describe, expect, it } from 'vitest';
+import { withSpinner } from './spinner.js';
+describe('withSpinner', () => {
+    it('returns the function result in non-TTY mode', async () => {
+        const result = await withSpinner('Loading', async () => 42);
+        expect(result).toBe(42);
+    });
+    it('returns complex objects unchanged', async () => {
+        const data = { entries: [{ id: 'BET-1', name: 'Test' }], total: 1 };
+        const result = await withSpinner('Loading', async () => data);
+        expect(result).toEqual(data);
+    });
+    it('rethrows errors from the wrapped function', async () => {
+        const err = new Error('network failure');
+        await expect(withSpinner('Loading', async () => {
+            throw err;
+        })).rejects.toThrow('network failure');
+    });
+    it('passes through the success message option without affecting result', async () => {
+        const result = await withSpinner('Loading', async () => 'done', { successMessage: 'Loaded successfully' });
+        expect(result).toBe('done');
+    });
+    it('completes without hanging on fast operations', async () => {
+        // This validates the 200ms delay timer is properly cleaned up
+        const start = Date.now();
+        await withSpinner('Fast op', async () => 'quick');
+        const elapsed = Date.now() - start;
+        // Should complete well under the 200ms delay threshold
+        expect(elapsed).toBeLessThan(100);
+    });
+});
+//# sourceMappingURL=spinner.test.js.map

package/dist/lib/spinner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.test.js","sourceRoot":"","sources":["../../src/lib/spinner.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,MAAM,CACV,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAChC,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,SAAS,EACT,KAAK,IAAI,EAAE,CAAC,MAAM,EAClB,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAC1C,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,8DAA8D;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,WAAW,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,uDAAuD;QACvD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/strip.d.ts

@@ -0,0 +1,12 @@
+/**
+ * stripConvexInternals — recursively removes Convex system fields from API responses.
+ *
+ * Strips `_id` and `_creationTime` (Convex internal fields, TEN-340).
+ * Preserves `entryId` (human-readable ID) and all other fields.
+ * Handles nested objects and arrays. Returns a new object (does not mutate).
+ *
+ * Chain: DEC-299 (JSON-default output), TEN-340 (Convex internal exposure)
+ */
+export declare function stripControlChars(str: string): string;
+export declare function stripConvexInternals<T>(data: T): T;
+//# sourceMappingURL=strip.d.ts.map

package/dist/lib/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../../src/lib/strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAelD"}

package/dist/lib/strip.js

@@ -0,0 +1,41 @@
+/**
+ * stripConvexInternals — recursively removes Convex system fields from API responses.
+ *
+ * Strips `_id` and `_creationTime` (Convex internal fields, TEN-340).
+ * Preserves `entryId` (human-readable ID) and all other fields.
+ * Handles nested objects and arrays. Returns a new object (does not mutate).
+ *
+ * Chain: DEC-299 (JSON-default output), TEN-340 (Convex internal exposure)
+ */
+const STRIP_KEYS = new Set(['_id', '_creationTime']);
+/**
+ * Strip ANSI escape sequences and control characters from user-controlled strings
+ * before printing to the terminal. Prevents terminal injection attacks where
+ * entry names/descriptions could contain escape sequences that manipulate
+ * terminal state (cursor movement, color overrides, title changes, etc.).
+ *
+ * BET-269: Security baseline — C3 (CLI terminal escaping).
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_AND_CONTROL_RE = /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]|\x1b\[[0-9;]*[A-Za-z]|\x1b\][^\x07]*\x07|\x1b[^[\]0-9;A-Za-z]?/g;
+export function stripControlChars(str) {
+    if (!str)
+        return str;
+    return str.replace(ANSI_AND_CONTROL_RE, '');
+}
+export function stripConvexInternals(data) {
+    if (Array.isArray(data)) {
+        return data.map((item) => stripConvexInternals(item));
+    }
+    if (data !== null && typeof data === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (STRIP_KEYS.has(key))
+                continue;
+            result[key] = stripConvexInternals(value);
+        }
+        return result;
+    }
+    return data;
+}
+//# sourceMappingURL=strip.js.map

package/dist/lib/strip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.js","sourceRoot":"","sources":["../../src/lib/strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;AAErD;;;;;;;GAOG;AACH,4CAA4C;AAC5C,MAAM,mBAAmB,GAAG,kGAAkG,CAAC;AAE/H,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,IAAO;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAiB,CAAC;IACxE,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC3E,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClC,MAAM,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAsB,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/style.d.ts

@@ -0,0 +1,94 @@
+/**
+ * CLI voice and style — centralized output formatting for Product Brain CLI.
+ * WP-302 Slice 1: Brand Voice + --quiet.
+ *
+ * Design: "instrument panel" — clear status, clear next action.
+ * Tone: confident, concise, helpful. Not chatty. Not corporate.
+ *
+ * All color output respects NO_COLOR env (https://no-color.org/) and TTY detection.
+ * Quiet mode suppresses banners, hints, and progress — only essential results show.
+ */
+/** Returns true if the terminal supports color output. */
+export declare function supportsColor(): boolean;
+export declare const green: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare const icons: {
+    readonly pass: "✓";
+    readonly fail: "✗";
+    readonly warn: "⚠";
+    readonly arrow: "→";
+    readonly dot: "·";
+};
+export declare const copy: {
+    readonly captured: "Captured.";
+    readonly promoted: "Promoted.";
+    readonly linked: "Linked.";
+    readonly updated: "Updated.";
+    readonly sessionStarted: "Session started.";
+    readonly sessionClosed: "Session closed.";
+    readonly noSession: "No active session. Run `pb session start` first.";
+    readonly sessionRequired: "Write access requires a tracked session (DEC-9).";
+    readonly notFound: "Not found.";
+    readonly authFailed: "Authentication failed.";
+    readonly nextOrient: "Next: pb orient -b";
+    readonly nextCapture: "Next: pb capture \"...\"";
+    readonly nextGet: (entryId: string) => string;
+    readonly nextFields: (collection: string) => string;
+};
+/**
+ * Print a command banner. Suppressed in quiet mode.
+ * Example: "Product Brain — Doctor"
+ */
+export declare function banner(title: string): void;
+/**
+ * Print an actionable hint line. Suppressed in quiet mode.
+ * Example: "  Hint: Run `pb orient -b` to see your workspace."
+ */
+export declare function hint(text: string): void;
+/**
+ * Print a progress line (e.g. "Classifying..."). Suppressed in quiet mode.
+ */
+export declare function progress(text: string): void;
+/**
+ * Format a section heading — bold cyan text.
+ */
+export declare function heading(text: string): string;
+/**
+ * Format a check result line for doctor-style output.
+ * Uses colored icons for pass/fail/warn.
+ */
+export declare function formatCheck(status: 'pass' | 'fail' | 'warn', label: string, detail: string): string;
+/**
+ * Print an environment-aware admin banner. Suppressed in quiet mode.
+ *
+ * Labels:
+ * - [DEV] — localhost loopback
+ * - [DEV·CLOUD] — known Convex Development (Cloud) deployment
+ * - [PROD] — known production gateway / prod Convex deployment
+ * - [CLOUD] — other remote URL (unknown tier)
+ *
+ * Format: "⚡ pb admin — [ENV] <host>"
+ */
+export declare function adminBanner(siteUrl: string): void;
+/**
+ * Prompt for confirmation before a destructive admin operation (remote deployments).
+ *
+ * Returns true immediately if:
+ * - `isProduction` is false (local loopback or known dev-cloud — no ceremony)
+ * - `options.confirm` is true (--confirm flag passed by caller)
+ *
+ * In interactive TTY: shows a note() scope preview, then clack confirm().
+ * In non-interactive (CI/scripts): writes to stderr and returns false — caller must pass --confirm.
+ */
+export declare function confirmProdAction(options: {
+    confirm: boolean;
+    message: string;
+    isProduction: boolean;
+    /** Title for the note() panel (e.g. ⚠ Production vs ⚠ Remote deployment). */
+    noteTitle?: string;
+}): Promise<boolean>;
+//# sourceMappingURL=style.d.ts.map

package/dist/lib/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/lib/style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAMD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AAC1F,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AACxF,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AAC3F,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAuD,CAAC;AACzF,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAAsD,CAAC;AACvF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAsD,CAAC;AAMxF,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC;AAMX,eAAO,MAAM,IAAI;;;;;;;;;;;;;gCAkBI,MAAM;sCACA,MAAM;CACvB,CAAC;AAMX;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGvC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASnG;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAoBjD;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,OAAO,CAAC,CASnB"}

package/dist/lib/style.js

@@ -0,0 +1,167 @@
+/**
+ * CLI voice and style — centralized output formatting for Product Brain CLI.
+ * WP-302 Slice 1: Brand Voice + --quiet.
+ *
+ * Design: "instrument panel" — clear status, clear next action.
+ * Tone: confident, concise, helpful. Not chatty. Not corporate.
+ *
+ * All color output respects NO_COLOR env (https://no-color.org/) and TTY detection.
+ * Quiet mode suppresses banners, hints, and progress — only essential results show.
+ */
+import { classifyDeployment, parseHostname } from './deployment.js';
+import { confirm as promptConfirm, isInteractive, note as promptNote } from './prompts.js';
+import { isQuietMode } from './runner.js';
+// ---------------------------------------------------------------------------
+// Color support detection
+// ---------------------------------------------------------------------------
+/** Returns true if the terminal supports color output. */
+export function supportsColor() {
+    return Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+}
+// ---------------------------------------------------------------------------
+// Color helpers — degrade gracefully when NO_COLOR is set or not a TTY
+// ---------------------------------------------------------------------------
+export const green = (s) => (supportsColor() ? `\x1b[32m${s}\x1b[0m` : s);
+export const red = (s) => (supportsColor() ? `\x1b[31m${s}\x1b[0m` : s);
+export const yellow = (s) => (supportsColor() ? `\x1b[33m${s}\x1b[0m` : s);
+export const cyan = (s) => (supportsColor() ? `\x1b[36m${s}\x1b[0m` : s);
+export const dim = (s) => (supportsColor() ? `\x1b[2m${s}\x1b[0m` : s);
+export const bold = (s) => (supportsColor() ? `\x1b[1m${s}\x1b[0m` : s);
+// ---------------------------------------------------------------------------
+// Status icons
+// ---------------------------------------------------------------------------
+export const icons = {
+    pass: '\u2713', // checkmark
+    fail: '\u2717', // x
+    warn: '\u26A0', // warning triangle
+    arrow: '\u2192', // right arrow
+    dot: '\u00B7', // middle dot
+};
+// ---------------------------------------------------------------------------
+// Copy constants — instrument panel voice
+// ---------------------------------------------------------------------------
+export const copy = {
+    // Success preambles
+    captured: 'Captured.',
+    promoted: 'Promoted.',
+    linked: 'Linked.',
+    updated: 'Updated.',
+    sessionStarted: 'Session started.',
+    sessionClosed: 'Session closed.',
+    // Error preambles
+    noSession: 'No active session. Run `pb session start` first.',
+    sessionRequired: 'Write access requires a tracked session (DEC-9).',
+    notFound: 'Not found.',
+    authFailed: 'Authentication failed.',
+    // Next-step prompts
+    nextOrient: 'Next: pb orient -b',
+    nextCapture: 'Next: pb capture "..."',
+    nextGet: (entryId) => `View: pb get ${entryId}`,
+    nextFields: (collection) => `Fields: pb fields ${collection}`,
+};
+// ---------------------------------------------------------------------------
+// Structured output helpers
+// ---------------------------------------------------------------------------
+/**
+ * Print a command banner. Suppressed in quiet mode.
+ * Example: "Product Brain — Doctor"
+ */
+export function banner(title) {
+    if (isQuietMode())
+        return;
+    process.stdout.write(`\n${bold(`Product Brain — ${title}`)}\n\n`);
+}
+/**
+ * Print an actionable hint line. Suppressed in quiet mode.
+ * Example: "  Hint: Run `pb orient -b` to see your workspace."
+ */
+export function hint(text) {
+    if (isQuietMode())
+        return;
+    process.stdout.write(`  ${dim(text)}\n`);
+}
+/**
+ * Print a progress line (e.g. "Classifying..."). Suppressed in quiet mode.
+ */
+export function progress(text) {
+    if (isQuietMode())
+        return;
+    process.stdout.write(`${text}\n`);
+}
+/**
+ * Format a section heading — bold cyan text.
+ */
+export function heading(text) {
+    return bold(cyan(text));
+}
+/**
+ * Format a check result line for doctor-style output.
+ * Uses colored icons for pass/fail/warn.
+ */
+export function formatCheck(status, label, detail) {
+    const icon = status === 'pass'
+        ? green(icons.pass)
+        : status === 'fail'
+            ? red(icons.fail)
+            : yellow(icons.warn);
+    const paddedLabel = label.padEnd(16);
+    return `${icon} ${paddedLabel}${detail}`;
+}
+// ---------------------------------------------------------------------------
+// Admin UX framework (WP-312 S2, FEAT-972)
+// ---------------------------------------------------------------------------
+/**
+ * Print an environment-aware admin banner. Suppressed in quiet mode.
+ *
+ * Labels:
+ * - [DEV] — localhost loopback
+ * - [DEV·CLOUD] — known Convex Development (Cloud) deployment
+ * - [PROD] — known production gateway / prod Convex deployment
+ * - [CLOUD] — other remote URL (unknown tier)
+ *
+ * Format: "⚡ pb admin — [ENV] <host>"
+ */
+export function adminBanner(siteUrl) {
+    if (isQuietMode())
+        return;
+    const host = parseHostname(siteUrl);
+    const tier = classifyDeployment(siteUrl);
+    let envTag;
+    switch (tier) {
+        case 'local':
+            envTag = green('[DEV]');
+            break;
+        case 'prod':
+            envTag = red('[PROD]');
+            break;
+        case 'dev-cloud':
+            envTag = cyan('[DEV·CLOUD]');
+            break;
+        default:
+            envTag = yellow('[CLOUD]');
+    }
+    process.stdout.write(`\n${bold(`\u26A1 pb admin`)} ${dim('\u2014')} ${envTag} ${dim(host)}\n\n`);
+}
+/**
+ * Prompt for confirmation before a destructive admin operation (remote deployments).
+ *
+ * Returns true immediately if:
+ * - `isProduction` is false (local loopback or known dev-cloud — no ceremony)
+ * - `options.confirm` is true (--confirm flag passed by caller)
+ *
+ * In interactive TTY: shows a note() scope preview, then clack confirm().
+ * In non-interactive (CI/scripts): writes to stderr and returns false — caller must pass --confirm.
+ */
+export async function confirmProdAction(options) {
+    if (!options.isProduction)
+        return true;
+    if (options.confirm)
+        return true;
+    if (!isInteractive()) {
+        process.stderr.write('This operation requires --confirm flag in non-interactive mode.\n');
+        return false;
+    }
+    promptNote(options.message, options.noteTitle ?? '⚠  Production');
+    return promptConfirm({ message: 'Proceed?', initialValue: false });
+}
+//# sourceMappingURL=style.js.map

package/dist/lib/style.js.map

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

package/dist/lib/style.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for CLI style module — WP-302 Slice 1.
+ * Verifies color helpers respect NO_COLOR, quiet mode suppresses banners,
+ * and copy constants are non-empty strings.
+ */
+export {};
+//# sourceMappingURL=style.test.d.ts.map

package/dist/lib/style.test.d.ts.map

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