@productbrain/cli 0.1.0-beta.27 → 0.1.0-beta.2721

package/dist/commands/connect-context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * connect-context — non-UI orchestration for the post-connect wizard.
+ *
+ * Extracted from connect-screens.tsx so the seed-readiness poll + context
+ * handshake can be tested without rendering Ink. The screens render purely from
+ * the result of prepareConnectContext().
+ *
+ * Chain: WP-433 (pb connect handoff), WP-439 S4 (strict-by-default handshake),
+ * WP-379 S3b (async seed polling).
+ */
+import { type HealthGap } from './handshake.js';
+export interface ConnectContext {
+    /** True when the context handshake threw (context files may be incomplete). */
+    handshakeFailed: boolean;
+    /** Handshake error message, when handshakeFailed. */
+    handshakeError?: string;
+    /** Non-empty when starter-setup seeds were still pending after the poll. */
+    seedGaps?: ReadonlyArray<HealthGap>;
+    /**
+     * Adapter files PB left untouched because they already existed without its
+     * auto-gen marker (you authored them). The screen relays these so a user with
+     * a pre-existing CLAUDE.md is not falsely told it was synced (TEN-2107).
+     * Undefined = nothing skipped.
+     */
+    skippedFiles?: ReadonlyArray<string>;
+}
+/**
+ * Prepare the workspace context after `pb connect` redeems a token:
+ *
+ * 1. Poll until starter-setup seeds are ready FIRST. The handshake fetches
+ *    seeded setup-asset bodies (skills/rules); on a fresh workspace those seeds
+ *    land asynchronously (WP-379 S3b), so running the handshake before they are
+ *    ready makes its body fetch fail.
+ * 2. Run the handshake LENIENT. This is an automatic onboarding handshake — it
+ *    follows the precedent set for the automatic refresh at session close
+ *    (session.ts, WP-439 S4): automatic runs must not hard-fail on a body-fetch
+ *    error; orphaned assets are surfaced when the user runs `pb handshake`
+ *    directly. Strict-by-default is for that direct command, not for the silent
+ *    post-connect refresh.
+ *
+ * Never throws — failures are captured in the returned object for the screen to
+ * render.
+ */
+export declare function prepareConnectContext(): Promise<ConnectContext>;
+//# sourceMappingURL=connect-context.d.ts.map

package/dist/commands/connect-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context.d.ts","sourceRoot":"","sources":["../../src/commands/connect-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGnF,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,eAAe,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACpC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAgBrE"}

package/dist/commands/connect-context.js

@@ -0,0 +1,83 @@
+/**
+ * connect-context — non-UI orchestration for the post-connect wizard.
+ *
+ * Extracted from connect-screens.tsx so the seed-readiness poll + context
+ * handshake can be tested without rendering Ink. The screens render purely from
+ * the result of prepareConnectContext().
+ *
+ * Chain: WP-433 (pb connect handoff), WP-439 S4 (strict-by-default handshake),
+ * WP-379 S3b (async seed polling).
+ */
+import { runHandshake, pollUntilSeedsReady } from './handshake.js';
+import { setSpinnersSilenced, areSpinnersSilenced } from '../lib/runner.js';
+/**
+ * Prepare the workspace context after `pb connect` redeems a token:
+ *
+ * 1. Poll until starter-setup seeds are ready FIRST. The handshake fetches
+ *    seeded setup-asset bodies (skills/rules); on a fresh workspace those seeds
+ *    land asynchronously (WP-379 S3b), so running the handshake before they are
+ *    ready makes its body fetch fail.
+ * 2. Run the handshake LENIENT. This is an automatic onboarding handshake — it
+ *    follows the precedent set for the automatic refresh at session close
+ *    (session.ts, WP-439 S4): automatic runs must not hard-fail on a body-fetch
+ *    error; orphaned assets are surfaced when the user runs `pb handshake`
+ *    directly. Strict-by-default is for that direct command, not for the silent
+ *    post-connect refresh.
+ *
+ * Never throws — failures are captured in the returned object for the screen to
+ * render.
+ */
+export async function prepareConnectContext() {
+    // WP-2 (TEN-2561): silence the per-kernelCall spinners — "Loading chain getVocabulary",
+    // "Loading chain getOrientView", "Loading setup listAssetsForUser" — that withSpinner
+    // renders for every kernelCall the seed-poll + handshake make. Use the spinner-silence
+    // flag, NOT global quiet mode: quiet also gates interactive prompts (prompts.ts), so
+    // flipping it would suppress the handshake's adopt/revert prompts for PB-managed tampered
+    // files — turning an answerable prompt into a silent "context sync skipped". The caller
+    // (runConnectScreens) shows one human progress line instead. Restored in `finally` so the
+    // flip is scoped to this call.
+    const priorSilenced = areSpinnersSilenced();
+    setSpinnersSilenced(true);
+    try {
+        return await prepareConnectContextInner();
+    }
+    finally {
+        setSpinnersSilenced(priorSilenced);
+    }
+}
+async function prepareConnectContextInner() {
+    // 1. Wait for seeds to be ready before the handshake consumes them.
+    // probe-failed (network/auth) is non-blocking — no seeds warning when the
+    // health endpoint is simply unreachable.
+    let seedGaps;
+    try {
+        const seedResult = await pollUntilSeedsReady();
+        if (seedResult.status === 'seeds-pending') {
+            seedGaps = seedResult.gaps;
+        }
+        // seeds-ready and probe-failed both leave seedGaps undefined (no warning).
+    }
+    catch {
+        // Future-proofing: pollUntilSeedsReady does not throw today (its probe
+        // catches everything into 'probe-failed'); this guards that contract drifting.
+    }
+    // 2. Run handshake lenient — capture failure for display rather than aborting.
+    let handshakeFailed = false;
+    let handshakeError;
+    let skippedFiles;
+    try {
+        const report = await runHandshake({ force: false, apply: true, quiet: true, lenient: true });
+        // userOwnedSkipped = adapter files that already existed without PB's auto-gen
+        // marker, so the handshake left them untouched. Relay them so the screen does
+        // not falsely report them as synced (TEN-2107). These are NOT drift (TEN-2150).
+        if (report?.userOwnedSkipped && report.userOwnedSkipped.length > 0) {
+            skippedFiles = report.userOwnedSkipped;
+        }
+    }
+    catch (err) {
+        handshakeFailed = true;
+        handshakeError = err instanceof Error ? err.message : String(err);
+    }
+    return { handshakeFailed, handshakeError, seedGaps, skippedFiles };
+}
+//# sourceMappingURL=connect-context.js.map

package/dist/commands/connect-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context.js","sourceRoot":"","sources":["../../src/commands/connect-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAkB,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAkB5E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,wFAAwF;IACxF,sFAAsF;IACtF,uFAAuF;IACvF,qFAAqF;IACrF,0FAA0F;IAC1F,wFAAwF;IACxF,0FAA0F;IAC1F,+BAA+B;IAC/B,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;IAC5C,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,MAAM,0BAA0B,EAAE,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B;IACvC,oEAAoE;IACpE,0EAA0E;IAC1E,yCAAyC;IACzC,IAAI,QAA8C,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YAC1C,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,2EAA2E;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,+EAA+E;IACjF,CAAC;IAED,+EAA+E;IAC/E,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,cAAkC,CAAC;IACvC,IAAI,YAA+C,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,8EAA8E;QAC9E,8EAA8E;QAC9E,gFAAgF;QAChF,IAAI,MAAM,EAAE,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACzC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAe,GAAG,IAAI,CAAC;QACvB,cAAc,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AACrE,CAAC"}

package/dist/commands/connect-context.test.d.ts

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

package/dist/commands/connect-context.test.d.ts.map

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

package/dist/commands/connect-context.test.js

@@ -0,0 +1,158 @@
+/**
+ * Tests for prepareConnectContext — the non-UI orchestration behind the
+ * post-connect wizard (seed-readiness poll + context handshake).
+ *
+ * Root cause (P1): `pb connect`'s automatic handshake ran STRICT and BEFORE the
+ * seed-readiness poll. On a fresh workspace (seeds still landing async) or with
+ * an orphan setup-asset body, the handshake's body fetch failed and — being
+ * strict (WP-439 S4) — threw, surfacing only a dim "⚠ Context sync skipped" and
+ * leaving CLAUDE.md / rules unwritten. WP-439 S4 made the automatic refresh at
+ * session close LENIENT (session.ts) for exactly this reason; connect's automatic
+ * refresh follows that same precedent.
+ *
+ * Fix: poll seeds ready FIRST, then run the handshake LENIENT.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(async () => { }),
+    pollUntilSeedsReady: vi.fn(async () => ({ status: 'seeds-ready' })),
+}));
+import * as handshake from './handshake.js';
+import { prepareConnectContext } from './connect-context.js';
+import { areSpinnersSilenced, setSpinnersSilenced, getQuietMode, setQuietMode } from '../lib/runner.js';
+const runHandshake = vi.mocked(handshake.runHandshake);
+const pollUntilSeedsReady = vi.mocked(handshake.pollUntilSeedsReady);
+const PENDING_GAPS = [
+    { kind: 'starter-setup-missing', severity: 'warn', message: 'Starter setup seeds are still running.' },
+];
+describe('prepareConnectContext', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-ready' });
+        runHandshake.mockResolvedValue(undefined);
+    });
+    it('runs the handshake in lenient mode (matches session.ts automatic-handshake policy)', async () => {
+        await prepareConnectContext();
+        expect(runHandshake).toHaveBeenCalledTimes(1);
+        expect(runHandshake).toHaveBeenCalledWith(expect.objectContaining({ force: false, apply: true, quiet: true, lenient: true }));
+    });
+    it('waits for seeds to be ready BEFORE running the handshake', async () => {
+        const order = [];
+        pollUntilSeedsReady.mockImplementation(async () => {
+            order.push('poll');
+            return { status: 'seeds-ready' };
+        });
+        runHandshake.mockImplementation(async () => {
+            order.push('handshake');
+            return undefined;
+        });
+        await prepareConnectContext();
+        expect(order).toEqual(['poll', 'handshake']);
+    });
+    it('surfaces seed gaps when starter setup is still pending', async () => {
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-pending', gaps: PENDING_GAPS });
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toEqual(PENDING_GAPS);
+        expect(result.handshakeFailed).toBe(false);
+    });
+    it('reports no seed gaps when seeds are ready', async () => {
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-ready' });
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toBeUndefined();
+    });
+    it('reports no seed gaps when the health probe fails (non-blocking)', async () => {
+        pollUntilSeedsReady.mockResolvedValue({ status: 'probe-failed', error: 'network down' });
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toBeUndefined();
+    });
+    it('captures a handshake failure without throwing', async () => {
+        runHandshake.mockRejectedValue(new Error('boom'));
+        const result = await prepareConnectContext();
+        expect(result.handshakeFailed).toBe(true);
+        expect(result.handshakeError).toBe('boom');
+    });
+    it('surfaces seed gaps AND a handshake failure together (fresh-workspace worst case)', async () => {
+        // Seeds time out, then the lenient handshake still throws on a genuinely
+        // orphaned body — both signals must surface independently.
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-pending', gaps: PENDING_GAPS });
+        runHandshake.mockRejectedValue(new Error('orphan body'));
+        const result = await prepareConnectContext();
+        expect(result.seedGaps).toEqual(PENDING_GAPS);
+        expect(result.handshakeFailed).toBe(true);
+        expect(result.handshakeError).toBe('orphan body');
+    });
+    it('reports success when the handshake completes', async () => {
+        const result = await prepareConnectContext();
+        expect(result.handshakeFailed).toBe(false);
+        expect(result.handshakeError).toBeUndefined();
+    });
+    it('surfaces files PB left untouched (user-owned files without the auto-gen marker)', async () => {
+        // TEN-2107: the handshake skips files the user authored (no auto-gen marker)
+        // and reports them as userOwnedSkipped. The connect screen must relay these so
+        // a user with a pre-existing CLAUDE.md is not falsely told "synced". These are
+        // never treated as drift (TEN-2150).
+        runHandshake.mockResolvedValue({
+            filesWritten: ['AGENTS.md'],
+            filesSkipped: [
+                { path: 'CLAUDE.md', reason: 'user-owned — left untouched (pb won\'t overwrite your file)' },
+            ],
+            userOwnedSkipped: ['CLAUDE.md'],
+        });
+        const result = await prepareConnectContext();
+        expect(result.skippedFiles).toEqual(['CLAUDE.md']);
+        expect(result.handshakeFailed).toBe(false);
+    });
+    it('reports no skipped files when PB wrote (or refreshed) everything', async () => {
+        // Default mock resolves an empty/undefined report → nothing left untouched.
+        const result = await prepareConnectContext();
+        expect(result.skippedFiles).toBeUndefined();
+    });
+});
+describe('prepareConnectContext — spinner-silence seam (WP-2 / TEN-2561)', () => {
+    // The seed-poll + handshake make kernelCalls whose spinners render raw internal labels
+    // ("Loading chain getVocabulary", …). The fn must suppress those during its work via the
+    // SPINNER-silence flag — and must NOT touch global quiet mode, which gates interactive
+    // prompts (so the handshake's adopt/revert prompts for tampered files still run). The
+    // flag is restored afterward, even when the (lenient) handshake throws.
+    beforeEach(() => {
+        vi.clearAllMocks();
+        pollUntilSeedsReady.mockResolvedValue({ status: 'seeds-ready' });
+        runHandshake.mockResolvedValue(undefined);
+        setSpinnersSilenced(false);
+        setQuietMode(false);
+    });
+    it('silences spinners during seed-poll + handshake, then restores — WITHOUT touching quiet', async () => {
+        let silencedDuringPoll;
+        let silencedDuringHandshake;
+        let quietDuringHandshake;
+        pollUntilSeedsReady.mockImplementation(async () => {
+            silencedDuringPoll = areSpinnersSilenced();
+            return { status: 'seeds-ready' };
+        });
+        runHandshake.mockImplementation(async () => {
+            silencedDuringHandshake = areSpinnersSilenced();
+            quietDuringHandshake = getQuietMode();
+            return undefined;
+        });
+        expect(areSpinnersSilenced()).toBe(false);
+        await prepareConnectContext();
+        expect(silencedDuringPoll).toBe(true);
+        expect(silencedDuringHandshake).toBe(true);
+        // Quiet (the interactive-prompt gate) must stay off — otherwise the handshake's
+        // adopt/revert tamper prompts would throw NON_INTERACTIVE (TEN-2561 regression).
+        expect(quietDuringHandshake).toBe(false);
+        expect(areSpinnersSilenced()).toBe(false); // restored
+    });
+    it('restores the spinner-silence flag even when the handshake throws (lenient)', async () => {
+        runHandshake.mockRejectedValue(new Error('boom'));
+        const result = await prepareConnectContext();
+        expect(result.handshakeFailed).toBe(true);
+        expect(areSpinnersSilenced()).toBe(false); // restored despite the throw
+    });
+    it('preserves a pre-existing silenced=true (does not force it back off)', async () => {
+        setSpinnersSilenced(true);
+        await prepareConnectContext();
+        expect(areSpinnersSilenced()).toBe(true);
+    });
+});
+//# sourceMappingURL=connect-context.test.js.map

package/dist/commands/connect-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-context.test.js","sourceRoot":"","sources":["../../src/commands/connect-context.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAI9D,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IACnC,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CACpE,CAAC,CAAC,CAAC;AAEJ,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExG,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AACvD,MAAM,mBAAmB,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAErE,MAAM,YAAY,GAA6B;IAC7C,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,wCAAwC,EAAE;CACvG,CAAC;AAEF,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QACjE,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,MAAM,qBAAqB,EAAE,CAAC;QAC9B,MAAM,CAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CACvC,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACnF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE;YAChD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,YAAY,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE;YACzC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,qBAAqB,EAAE,CAAC;QAE9B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAEvF,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAEzF,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,YAAY,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;QAChG,yEAAyE;QACzE,2DAA2D;QAC3D,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACvF,YAAY,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,aAAa,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,6EAA6E;QAC7E,+EAA+E;QAC/E,+EAA+E;QAC/E,qCAAqC;QACrC,YAAY,CAAC,iBAAiB,CAAC;YAC7B,YAAY,EAAE,CAAC,WAAW,CAAC;YAC3B,YAAY,EAAE;gBACZ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,6DAA6D,EAAE;aAC7F;YACD,gBAAgB,EAAE,CAAC,WAAW,CAAC;SACF,CAAC,CAAC;QAEjC,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,4EAA4E;QAC5E,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC9E,uFAAuF;IACvF,yFAAyF;IACzF,uFAAuF;IACvF,sFAAsF;IACtF,wEAAwE;IACxE,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QACjE,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC1C,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;QACtG,IAAI,kBAAuC,CAAC;QAC5C,IAAI,uBAA4C,CAAC;QACjD,IAAI,oBAAyC,CAAC;QAC9C,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE;YAChD,kBAAkB,GAAG,mBAAmB,EAAE,CAAC;YAC3C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,YAAY,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE;YACzC,uBAAuB,GAAG,mBAAmB,EAAE,CAAC;YAChD,oBAAoB,GAAG,YAAY,EAAE,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,qBAAqB,EAAE,CAAC;QAE9B,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,gFAAgF;QAChF,iFAAiF;QACjF,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,YAAY,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,6BAA6B;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,qBAAqB,EAAE,CAAC;QAC9B,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/connect-handoff.d.ts

@@ -0,0 +1,51 @@
+/**
+ * WP-433 S4 — FEAT-1291: pb connect chat handoff + locked agent-detection heuristic.
+ *
+ * Provides pure detection + resolution of the post-connect handoff message.
+ * No I/O side effects except `printHandoff` (which takes a stream).
+ *
+ * Locked detection heuristic (IMP-12 acceptance: ≤200 chars, user in chat ≤5 sec):
+ *   .claude/=Y, .cursor/=Y  → claude-or-cursor
+ *   .claude/=Y, .cursor/=N  → claude
+ *   .claude/=N, .cursor/=Y  → cursor
+ *   .claude/=N, .cursor/=N, AGENTS.md=Y → codex
+ *   .claude/=N, .cursor/=N, AGENTS.md=N → bare-repo (docs link)
+ *
+ */
+export type HandoffMarkers = {
+    hasClaude: boolean;
+    hasCursor: boolean;
+    hasCodexFile: boolean;
+};
+export type HandoffAgent = 'claude' | 'cursor' | 'claude-or-cursor' | 'codex' | 'bare-repo';
+export type HandoffResult = {
+    agent: HandoffAgent;
+    message: string;
+};
+export declare const HANDOFF_MESSAGE_CLAUDE_OR_CURSOR = "Open Claude Code or Cursor in this project and type in chat: Start Product Brain";
+export declare const HANDOFF_MESSAGE_CLAUDE = "Open Claude Code in this project and type in chat: Start Product Brain";
+export declare const HANDOFF_MESSAGE_CURSOR = "Open Cursor in this project and type in chat: Start Product Brain";
+export declare const HANDOFF_MESSAGE_CODEX = "Open Codex CLI in this project and type in chat: Start Product Brain";
+export declare const HANDOFF_MESSAGE_BARE_REPO = "No AI tool detected in this project. Visit productbrain.io/docs to set one up.";
+/**
+ * Resolve the handoff agent + message from the detected markers.
+ * Implements the locked heuristic table verbatim.
+ */
+export declare function resolveHandoff(markers: HandoffMarkers): HandoffResult;
+/**
+ * Detect handoff markers by probing the filesystem at `cwd`.
+ * Thin adapter over the surface adapters' detect predicates — keeps this
+ * module decoupled from detectSurfaces() while staying grounded in the same
+ * filesystem facts.
+ *
+ * `.claude/` → hasClaude
+ * `.cursor/` → hasCursor
+ * `AGENTS.md` or `.codex/` → hasCodexFile (mirrors codexAdapter.detect)
+ */
+export declare function detectHandoffMarkers(cwd: string): HandoffMarkers;
+/**
+ * Write the handoff message to `stdout` followed by a trailing newline.
+ * No extra prose, no boxes, no spinners.
+ */
+export declare function printHandoff(stdout: NodeJS.WritableStream, result: HandoffResult): void;
+//# sourceMappingURL=connect-handoff.d.ts.map

package/dist/commands/connect-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-handoff.d.ts","sourceRoot":"","sources":["../../src/commands/connect-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,kBAAkB,GAClB,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAO,MAAM,gCAAgC,qFACuC,CAAC;AAErF,eAAO,MAAM,sBAAsB,2EACuC,CAAC;AAE3E,eAAO,MAAM,sBAAsB,sEACkC,CAAC;AAEtE,eAAO,MAAM,qBAAqB,yEACsC,CAAC;AAEzE,eAAO,MAAM,yBAAyB,mFAC4C,CAAC;AAInF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAgBrE;AAID;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAMhE;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAEvF"}

package/dist/commands/connect-handoff.js

@@ -0,0 +1,70 @@
+/**
+ * WP-433 S4 — FEAT-1291: pb connect chat handoff + locked agent-detection heuristic.
+ *
+ * Provides pure detection + resolution of the post-connect handoff message.
+ * No I/O side effects except `printHandoff` (which takes a stream).
+ *
+ * Locked detection heuristic (IMP-12 acceptance: ≤200 chars, user in chat ≤5 sec):
+ *   .claude/=Y, .cursor/=Y  → claude-or-cursor
+ *   .claude/=Y, .cursor/=N  → claude
+ *   .claude/=N, .cursor/=Y  → cursor
+ *   .claude/=N, .cursor/=N, AGENTS.md=Y → codex
+ *   .claude/=N, .cursor/=N, AGENTS.md=N → bare-repo (docs link)
+ *
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+// ── Locked message strings (IMP-12: ≤200 chars each) ─────────────────────────
+export const HANDOFF_MESSAGE_CLAUDE_OR_CURSOR = 'Open Claude Code or Cursor in this project and type in chat: Start Product Brain';
+export const HANDOFF_MESSAGE_CLAUDE = 'Open Claude Code in this project and type in chat: Start Product Brain';
+export const HANDOFF_MESSAGE_CURSOR = 'Open Cursor in this project and type in chat: Start Product Brain';
+export const HANDOFF_MESSAGE_CODEX = 'Open Codex CLI in this project and type in chat: Start Product Brain';
+export const HANDOFF_MESSAGE_BARE_REPO = 'No AI tool detected in this project. Visit productbrain.io/docs to set one up.';
+// ── Resolution ───────────────────────────────────────────────────────────────
+/**
+ * Resolve the handoff agent + message from the detected markers.
+ * Implements the locked heuristic table verbatim.
+ */
+export function resolveHandoff(markers) {
+    const { hasClaude, hasCursor, hasCodexFile } = markers;
+    if (hasClaude && hasCursor) {
+        return { agent: 'claude-or-cursor', message: HANDOFF_MESSAGE_CLAUDE_OR_CURSOR };
+    }
+    if (hasClaude) {
+        return { agent: 'claude', message: HANDOFF_MESSAGE_CLAUDE };
+    }
+    if (hasCursor) {
+        return { agent: 'cursor', message: HANDOFF_MESSAGE_CURSOR };
+    }
+    if (hasCodexFile) {
+        return { agent: 'codex', message: HANDOFF_MESSAGE_CODEX };
+    }
+    return { agent: 'bare-repo', message: HANDOFF_MESSAGE_BARE_REPO };
+}
+// ── Detection ────────────────────────────────────────────────────────────────
+/**
+ * Detect handoff markers by probing the filesystem at `cwd`.
+ * Thin adapter over the surface adapters' detect predicates — keeps this
+ * module decoupled from detectSurfaces() while staying grounded in the same
+ * filesystem facts.
+ *
+ * `.claude/` → hasClaude
+ * `.cursor/` → hasCursor
+ * `AGENTS.md` or `.codex/` → hasCodexFile (mirrors codexAdapter.detect)
+ */
+export function detectHandoffMarkers(cwd) {
+    return {
+        hasClaude: existsSync(join(cwd, '.claude')),
+        hasCursor: existsSync(join(cwd, '.cursor')),
+        hasCodexFile: existsSync(join(cwd, 'AGENTS.md')) || existsSync(join(cwd, '.codex')),
+    };
+}
+// ── Output ───────────────────────────────────────────────────────────────────
+/**
+ * Write the handoff message to `stdout` followed by a trailing newline.
+ * No extra prose, no boxes, no spinners.
+ */
+export function printHandoff(stdout, result) {
+    stdout.write(result.message + '\n');
+}
+//# sourceMappingURL=connect-handoff.js.map

package/dist/commands/connect-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-handoff.js","sourceRoot":"","sources":["../../src/commands/connect-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAsB5B,gFAAgF;AAEhF,MAAM,CAAC,MAAM,gCAAgC,GAC3C,kFAAkF,CAAC;AAErF,MAAM,CAAC,MAAM,sBAAsB,GACjC,wEAAwE,CAAC;AAE3E,MAAM,CAAC,MAAM,sBAAsB,GACjC,mEAAmE,CAAC;AAEtE,MAAM,CAAC,MAAM,qBAAqB,GAChC,sEAAsE,CAAC;AAEzE,MAAM,CAAC,MAAM,yBAAyB,GACpC,gFAAgF,CAAC;AAEnF,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEvD,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;IAClF,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;AACpE,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC3C,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC3C,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;KACpF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA6B,EAAE,MAAqB;IAC/E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/commands/connect-integration.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Integration tests for pb connect — full E2E flow (FEAT-958 S5).
+ * Covers: token validation -> redemption -> key save -> wizard -> handshake.
+ * All external deps (fs, fetch, wizard, handshake) are mocked.
+ */
+export {};
+//# sourceMappingURL=connect-integration.test.d.ts.map

package/dist/commands/connect-integration.test.d.ts.map

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