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

package/dist/lib/style.test.js

@@ -0,0 +1,263 @@
+/**
+ * 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.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock runner.js for quiet mode control
+vi.mock('./runner.js', () => ({
+    isQuietMode: vi.fn(() => false),
+    isJsonMode: vi.fn(() => false),
+}));
+import { green, red, yellow, dim, bold, supportsColor, icons, copy, banner, hint, progress, formatCheck, adminBanner, confirmProdAction, } from './style.js';
+import { isQuietMode } from './runner.js';
+const mockIsQuietMode = vi.mocked(isQuietMode);
+const mockQuiet = (val) => mockIsQuietMode.mockReturnValue(val);
+describe('color helpers', () => {
+    const originalEnv = process.env.NO_COLOR;
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.NO_COLOR;
+        }
+        else {
+            process.env.NO_COLOR = originalEnv;
+        }
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+    });
+    it('returns ANSI-wrapped string when color is supported', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        delete process.env.NO_COLOR;
+        expect(green('ok')).toContain('\x1b[32m');
+        expect(green('ok')).toContain('ok');
+        expect(red('err')).toContain('\x1b[31m');
+        expect(yellow('warn')).toContain('\x1b[33m');
+        expect(dim('faint')).toContain('\x1b[2m');
+        expect(bold('strong')).toContain('\x1b[1m');
+    });
+    it('returns plain string when NO_COLOR is set', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        process.env.NO_COLOR = '1';
+        expect(green('ok')).toBe('ok');
+        expect(red('err')).toBe('err');
+        expect(yellow('warn')).toBe('warn');
+        expect(dim('faint')).toBe('faint');
+        expect(bold('strong')).toBe('strong');
+    });
+    it('returns plain string when not a TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        delete process.env.NO_COLOR;
+        expect(green('ok')).toBe('ok');
+        expect(red('err')).toBe('err');
+    });
+});
+describe('supportsColor', () => {
+    const originalEnv = process.env.NO_COLOR;
+    const originalIsTTY = process.stdout.isTTY;
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.NO_COLOR;
+        }
+        else {
+            process.env.NO_COLOR = originalEnv;
+        }
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+    });
+    it('returns true for TTY without NO_COLOR', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        delete process.env.NO_COLOR;
+        expect(supportsColor()).toBe(true);
+    });
+    it('returns false when NO_COLOR is set', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        process.env.NO_COLOR = '1';
+        expect(supportsColor()).toBe(false);
+    });
+    it('returns false when not a TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        delete process.env.NO_COLOR;
+        expect(supportsColor()).toBe(false);
+    });
+});
+describe('icons', () => {
+    it('has all expected icon keys', () => {
+        expect(icons.pass).toBeTruthy();
+        expect(icons.fail).toBeTruthy();
+        expect(icons.warn).toBeTruthy();
+        expect(icons.arrow).toBeTruthy();
+        expect(icons.dot).toBeTruthy();
+    });
+});
+describe('copy constants', () => {
+    it('all string constants are non-empty', () => {
+        expect(copy.captured.length).toBeGreaterThan(0);
+        expect(copy.promoted.length).toBeGreaterThan(0);
+        expect(copy.linked.length).toBeGreaterThan(0);
+        expect(copy.updated.length).toBeGreaterThan(0);
+        expect(copy.noSession.length).toBeGreaterThan(0);
+        expect(copy.sessionRequired.length).toBeGreaterThan(0);
+        expect(copy.notFound.length).toBeGreaterThan(0);
+        expect(copy.authFailed.length).toBeGreaterThan(0);
+        expect(copy.nextOrient.length).toBeGreaterThan(0);
+        expect(copy.nextCapture.length).toBeGreaterThan(0);
+        expect(copy.sessionStarted.length).toBeGreaterThan(0);
+        expect(copy.sessionClosed.length).toBeGreaterThan(0);
+    });
+    it('function constants return non-empty strings', () => {
+        expect(copy.nextGet('BET-42').length).toBeGreaterThan(0);
+        expect(copy.nextGet('BET-42')).toContain('BET-42');
+        expect(copy.nextFields('tensions').length).toBeGreaterThan(0);
+        expect(copy.nextFields('tensions')).toContain('tensions');
+    });
+});
+describe('banner', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('writes title to stdout in normal mode', () => {
+        banner('Doctor');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => c[0]).join('');
+        expect(output).toContain('Doctor');
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        banner('Doctor');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('hint', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('writes hint text in normal mode', () => {
+        hint('Run `pb orient -b` to see your workspace.');
+        expect(writeSpy).toHaveBeenCalled();
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        hint('Run `pb orient -b`');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('progress', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('writes progress text in normal mode', () => {
+        progress('Classifying...');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => c[0]).join('');
+        expect(output).toContain('Classifying...');
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        progress('Classifying...');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('formatCheck', () => {
+    it('formats pass result with label and detail', () => {
+        const result = formatCheck('pass', 'Config file', '/path/to/.env');
+        expect(result).toContain('Config file');
+        expect(result).toContain('/path/to/.env');
+    });
+    it('formats fail result', () => {
+        const result = formatCheck('fail', 'API key', 'Not set');
+        expect(result).toContain('API key');
+        expect(result).toContain('Not set');
+    });
+    it('formats warn result', () => {
+        const result = formatCheck('warn', 'CLI', 'Unable to read');
+        expect(result).toContain('CLI');
+        expect(result).toContain('Unable to read');
+    });
+    it('pads label to 16 chars', () => {
+        const result = formatCheck('pass', 'Node', 'v22.0.0');
+        // "Node" (4 chars) padded to 16
+        expect(result).toContain('Node            v22.0.0');
+    });
+});
+describe('adminBanner', () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mockIsQuietMode.mockReturnValue(false);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it('identifies localhost as dev', () => {
+        adminBanner('http://localhost:3000');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV]');
+    });
+    it('identifies 127.0.0.1 as dev', () => {
+        adminBanner('http://127.0.0.1:3000');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV]');
+    });
+    it('identifies ::1 as dev', () => {
+        adminBanner('http://[::1]:3000');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV]');
+    });
+    it('identifies known production hosts as PROD', () => {
+        adminBanner('https://api.productbrain.io');
+        expect(writeSpy).toHaveBeenCalled();
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[PROD]');
+    });
+    it('identifies Convex dev-cloud deployment as DEV·CLOUD', () => {
+        adminBanner('https://trustworthy-kangaroo-277.convex.site');
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[DEV·CLOUD]');
+    });
+    it('identifies unknown remote as CLOUD not PROD', () => {
+        adminBanner('https://other-team-abc.convex.site');
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(output).toContain('[CLOUD]');
+        expect(output).not.toContain('[PROD]');
+    });
+    it('suppresses output in quiet mode', () => {
+        mockIsQuietMode.mockReturnValue(true);
+        adminBanner('https://api.productbrain.io');
+        expect(writeSpy).not.toHaveBeenCalled();
+    });
+});
+describe('confirmProdAction', () => {
+    it('returns true immediately for dev environment', async () => {
+        const result = await confirmProdAction({ confirm: false, message: 'Are you sure?', isProduction: false });
+        expect(result).toBe(true);
+    });
+    it('returns true immediately when --confirm is passed', async () => {
+        const result = await confirmProdAction({ confirm: true, message: 'Are you sure?', isProduction: true });
+        expect(result).toBe(true);
+    });
+    it('returns false in non-TTY prod environment without --confirm', async () => {
+        const origIsTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: false, configurable: true });
+        const result = await confirmProdAction({ confirm: false, message: 'Seed all?', isProduction: true });
+        expect(result).toBe(false);
+        Object.defineProperty(process.stdin, 'isTTY', { value: origIsTTY, configurable: true });
+    });
+});
+//# sourceMappingURL=style.test.js.map

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

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

package/dist/lib/telemetry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Telemetry — fire-and-forget event tracking for CLI.
+ * Uses PostHog capture API directly via fetch. Zero dependencies.
+ * Contract: trackEvent(event, props?) → void. Never blocks, errors silently swallowed.
+ *
+ * Event names follow STD-155: setup_started, key_validated, workspace_bound,
+ * first_capture_prompted, setup_completed.
+ */
+/** Call once after workspace is known. Sets distinct_id and workspace group. */
+export declare function initTelemetry(workspaceId: string): void;
+/**
+ * Fire-and-forget telemetry event. Never throws, never blocks.
+ */
+export declare function trackEvent(event: string, properties?: Record<string, unknown>): void;
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGvD;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAuBpF"}

package/dist/lib/telemetry.js

@@ -0,0 +1,47 @@
+/**
+ * Telemetry — fire-and-forget event tracking for CLI.
+ * Uses PostHog capture API directly via fetch. Zero dependencies.
+ * Contract: trackEvent(event, props?) → void. Never blocks, errors silently swallowed.
+ *
+ * Event names follow STD-155: setup_started, key_validated, workspace_bound,
+ * first_capture_prompted, setup_completed.
+ */
+const POSTHOG_HOST = 'https://eu.i.posthog.com';
+const POSTHOG_KEY = 'phc_T09qliVxaxpdK8jL3HhSBhedzgxw5N4G4yG4x01jrxj';
+let distinctId = 'anonymous';
+let workspaceGroup;
+/** Call once after workspace is known. Sets distinct_id and workspace group. */
+export function initTelemetry(workspaceId) {
+    distinctId = workspaceId;
+    workspaceGroup = workspaceId;
+}
+function isDisabled() {
+    return process.env.PB_TELEMETRY_DISABLED === '1';
+}
+/**
+ * Fire-and-forget telemetry event. Never throws, never blocks.
+ */
+export function trackEvent(event, properties) {
+    if (isDisabled())
+        return;
+    const payload = {
+        api_key: POSTHOG_KEY,
+        event,
+        distinct_id: distinctId,
+        properties: {
+            ...properties,
+            source: 'cli',
+            ...(workspaceGroup ? { $groups: { workspace: workspaceGroup } } : {}),
+        },
+        timestamp: new Date().toISOString(),
+    };
+    // Fire-and-forget — non-awaited, errors swallowed
+    fetch(`${POSTHOG_HOST}/capture/`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+    }).catch(() => {
+        // Telemetry must never break the CLI flow.
+    });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/lib/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAChD,MAAM,WAAW,GAAG,iDAAiD,CAAC;AAEtE,IAAI,UAAU,GAAG,WAAW,CAAC;AAC7B,IAAI,cAAkC,CAAC;AAEvC,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,UAAU,GAAG,WAAW,CAAC;IACzB,cAAc,GAAG,WAAW,CAAC;AAC/B,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAAoC;IAC5E,IAAI,UAAU,EAAE;QAAE,OAAO;IAEzB,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,WAAW;QACpB,KAAK;QACL,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE;YACV,GAAG,UAAU;YACb,MAAM,EAAE,KAAK;YACb,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE;QACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,kDAAkD;IAClD,KAAK,CAAC,GAAG,YAAY,WAAW,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACZ,2CAA2C;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/tokenConstants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Token prefix constants — single source of truth for token format strings.
+ * keep in sync with convex/lib/tokenConstants.ts
+ * (Monorepo boundary: Convex cannot import from packages/cli and vice versa.)
+ *
+ * DEC-549
+ */
+/** Prefix for permanent API keys (bearer tokens). */
+export declare const API_KEY_PREFIX = "pb_sk_";
+/** Prefix for short-lived connect tokens (15-min, single-use). */
+export declare const CONNECT_TOKEN_PREFIX = "pb_ct_";
+/**
+ * Length of the random hex component in generated API keys.
+ * 32 hex chars = 128-bit entropy.
+ */
+export declare const API_KEY_HEX_LENGTH = 32;
+//# sourceMappingURL=tokenConstants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenConstants.d.ts","sourceRoot":"","sources":["../../src/lib/tokenConstants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC"}

package/dist/lib/tokenConstants.js

@@ -0,0 +1,17 @@
+/**
+ * Token prefix constants — single source of truth for token format strings.
+ * keep in sync with convex/lib/tokenConstants.ts
+ * (Monorepo boundary: Convex cannot import from packages/cli and vice versa.)
+ *
+ * DEC-549
+ */
+/** Prefix for permanent API keys (bearer tokens). */
+export const API_KEY_PREFIX = 'pb_sk_';
+/** Prefix for short-lived connect tokens (15-min, single-use). */
+export const CONNECT_TOKEN_PREFIX = 'pb_ct_';
+/**
+ * Length of the random hex component in generated API keys.
+ * 32 hex chars = 128-bit entropy.
+ */
+export const API_KEY_HEX_LENGTH = 32;
+//# sourceMappingURL=tokenConstants.js.map

package/dist/lib/tokenConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenConstants.js","sourceRoot":"","sources":["../../src/lib/tokenConstants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC"}

package/dist/lib/update-check.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Ambient update notification for the Product Brain CLI (WP-322 S1 / FEAT-1012).
+ *
+ * Checks npm registry for the latest version of @productbrain/cli and prints
+ * a one-line notification when a newer version is available.
+ *
+ * Rules:
+ *   - Non-blocking: check fires async, never delays the command
+ *   - 24h cache at ~/.config/productbrain/update-check.json
+ *   - Silent on any error (network down, registry unreachable, etc.)
+ *   - JSON mode: suppress notification entirely
+ *   - Does NOT use undici/fetch directly; uses Node.js built-in https
+ */
+/**
+ * Prints one line to stderr if a newer version is available.
+ * The check is always non-blocking: it fires async and is not awaited by the caller.
+ *
+ * Call once per human-initiated command, just before the command action runs.
+ */
+export declare function checkForUpdate(currentVersion: string): void;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/lib/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/lib/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsGH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CA0B3D"}

package/dist/lib/update-check.js

@@ -0,0 +1,144 @@
+/**
+ * Ambient update notification for the Product Brain CLI (WP-322 S1 / FEAT-1012).
+ *
+ * Checks npm registry for the latest version of @productbrain/cli and prints
+ * a one-line notification when a newer version is available.
+ *
+ * Rules:
+ *   - Non-blocking: check fires async, never delays the command
+ *   - 24h cache at ~/.config/productbrain/update-check.json
+ *   - Silent on any error (network down, registry unreachable, etc.)
+ *   - JSON mode: suppress notification entirely
+ *   - Does NOT use undici/fetch directly; uses Node.js built-in https
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { request } from 'node:https';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { isJsonMode } from './runner.js';
+import { dim, yellow } from './style.js';
+const PKG_NAME = '@productbrain/cli';
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CONFIG_DIR = join(homedir(), '.config', 'productbrain');
+const CACHE_PATH = join(CONFIG_DIR, 'update-check.json');
+/** Read the cached latest version if it is still fresh (< 24h). */
+function readCache() {
+    try {
+        if (!existsSync(CACHE_PATH))
+            return null;
+        const raw = readFileSync(CACHE_PATH, 'utf8');
+        const entry = JSON.parse(raw);
+        if (Date.now() - entry.checkedAt < CACHE_TTL_MS) {
+            return entry.latestVersion;
+        }
+    }
+    catch {
+        // Corrupt or missing cache — treat as cold
+    }
+    return null;
+}
+/** Write a cache entry with the resolved latest version. */
+function writeCache(latestVersion) {
+    try {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+        const entry = { checkedAt: Date.now(), latestVersion };
+        writeFileSync(CACHE_PATH, JSON.stringify(entry), 'utf8');
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+}
+/** Fetch latest version from npm registry. Returns null on any error. */
+function fetchLatestVersion() {
+    return new Promise((resolve) => {
+        const url = `https://registry.npmjs.org/${PKG_NAME}/latest`;
+        const req = request(url, { method: 'GET', headers: { 'Accept': 'application/json' } }, (res) => {
+            let body = '';
+            res.on('data', (chunk) => { body += chunk.toString(); });
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(body);
+                    resolve(parsed.version ?? null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+            res.on('error', () => resolve(null));
+        });
+        req.on('error', () => resolve(null));
+        req.setTimeout(3000, () => {
+            req.destroy();
+            resolve(null);
+        });
+        req.end();
+    });
+}
+/**
+ * Compare two semver strings. Returns true if `b` is strictly newer than `a`.
+ * Handles standard x.y.z and x.y.z-beta.N formats (numeric comparison per part).
+ */
+function isNewer(current, latest) {
+    if (current === latest)
+        return false;
+    const parseVersion = (v) => {
+        // Strip leading 'v'
+        const clean = v.replace(/^v/, '');
+        // Split on '-' to handle pre-release like '0.1.0-beta.70'
+        const [release, pre] = clean.split('-');
+        const parts = (release ?? '').split('.').map((n) => parseInt(n, 10) || 0);
+        // Append pre-release numeric tag as a negative offset so pre < release
+        if (pre !== undefined) {
+            const preNum = parseInt(pre.replace(/\D+/, ''), 10) || 0;
+            parts.push(-1e6 + preNum);
+        }
+        return parts;
+    };
+    const a = parseVersion(current);
+    const b = parseVersion(latest);
+    const len = Math.max(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        const av = a[i] ?? 0;
+        const bv = b[i] ?? 0;
+        if (bv > av)
+            return true;
+        if (bv < av)
+            return false;
+    }
+    return false;
+}
+/**
+ * Prints one line to stderr if a newer version is available.
+ * The check is always non-blocking: it fires async and is not awaited by the caller.
+ *
+ * Call once per human-initiated command, just before the command action runs.
+ */
+export function checkForUpdate(currentVersion) {
+    // Suppress in JSON/agent mode
+    if (isJsonMode())
+        return;
+    // Fire-and-forget: result is printed after command output via process.nextTick trick
+    void (async () => {
+        try {
+            // Try cache first
+            let latest = readCache();
+            if (latest === null) {
+                latest = await fetchLatestVersion();
+                if (latest)
+                    writeCache(latest);
+            }
+            if (!latest)
+                return;
+            if (!isNewer(currentVersion, latest))
+                return;
+            // Print after current command output (nextTick ensures we don't interleave)
+            process.nextTick(() => {
+                process.stderr.write(`\n${yellow('Update available:')} ${dim(currentVersion)} → ${latest}  ${dim('run')} pb upgrade ${dim('to update')}\n`);
+            });
+        }
+        catch {
+            // Never surface update-check errors to the user
+        }
+    })();
+}
+//# sourceMappingURL=update-check.js.map

package/dist/lib/update-check.js.map

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

package/dist/lib/wizard-surfaces.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Surface detection — identify installed AI tools (Cursor, Claude Code, VS Code).
+ * Part of FEAT-958 Path C: Onboarding wizard (S3).
+ * Q1: Which AI tools do you use?
+ */
+export type Surface = 'cursor' | 'claude-code' | 'vscode';
+/**
+ * Detect if Cursor is installed.
+ * Checks: `which cursor` or common macOS/Windows install paths.
+ * Returns: true if found, false otherwise.
+ */
+export declare function detectCursor(): boolean;
+/**
+ * Detect if Claude Code (VS Code extension) is installed.
+ * Checks: ~/.vscode/extensions for `anthropic.claude-*` directory.
+ * Returns: true if found, false otherwise.
+ */
+export declare function detectClaudeCode(): boolean;
+/**
+ * Detect if VS Code is installed.
+ * Checks: `which code` or common install paths.
+ * Returns: true if found, false otherwise.
+ */
+export declare function detectVSCode(): boolean;
+/**
+ * Detect all installed AI tools.
+ * Returns: array of detected surface IDs (empty if none found).
+ */
+export declare function detectSurfaces(): Promise<Surface[]>;
+/**
+ * Prompt user to confirm/modify detected surfaces.
+ * Uses multiselect with auto-detected items pre-checked.
+ * Returns: user-selected surfaces (can be a subset or addition to detected).
+ */
+export declare function confirmSurfaces(detected: Surface[]): Promise<Surface[]>;
+/**
+ * Run the full surface detection + confirmation flow.
+ * Returns: user-confirmed surfaces.
+ */
+export declare function runSurfaceWizard(): Promise<Surface[]>;
+/**
+ * Map wizard-detected surfaces to handshake target names.
+ * Always includes 'codex' (batch/CI tool, not user-detected).
+ * Returns empty array if surfaces is empty (no filtering).
+ */
+export declare function mapSurfacesToTargets(surfaces: Surface[]): string[];
+//# sourceMappingURL=wizard-surfaces.d.ts.map

package/dist/lib/wizard-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-surfaces.d.ts","sourceRoot":"","sources":["../../src/lib/wizard-surfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAC;AA0B1D;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAYtC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAW1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAWtC;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAQzD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA2B7E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAsB3D;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CASlE"}