@productbrain/cli 0.1.0-beta.30 → 0.1.0-beta.3012

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"}

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

@@ -0,0 +1,219 @@
+/**
+ * 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.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock modules BEFORE imports
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+const mockCreateProfile = vi.fn();
+const mockListProfiles = vi.fn(() => []);
+vi.mock('fs', () => ({
+    mkdirSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    existsSync: vi.fn(() => false),
+    readFileSync: vi.fn(() => {
+        throw new Error('ENOENT');
+    }),
+}));
+vi.mock('../lib/constants.js', () => ({
+    resolveAppUrl: () => 'https://test.convex.site',
+    resolveSiteUrl: () => 'https://gateway.productbrain.io',
+    DEFAULT_SITE_URL: 'https://gateway.productbrain.io',
+    resolveConnectRedeemUrl: (cli) => {
+        if (cli?.trim())
+            return cli.trim().replace(/\/$/, '');
+        const fromEnv = process.env.PB_CONNECT_GATEWAY_URL?.trim();
+        if (fromEnv)
+            return fromEnv.replace(/\/$/, '');
+        const fromConvex = process.env.CONVEX_SITE_URL?.trim();
+        if (fromConvex)
+            return fromConvex.replace(/\/$/, '');
+        return 'https://gateway.productbrain.io';
+    },
+}));
+vi.mock('../lib/spinner.js', () => ({
+    withSpinner: async (_msg, fn) => fn(),
+}));
+vi.mock('@clack/prompts', () => ({
+    // Post-S4: no clack.select remains in the handoff path; earlier Ink screens handle prior steps.
+    select: vi.fn(async () => 'start'),
+    isCancel: vi.fn(() => false),
+    text: vi.fn(async () => ''),
+}));
+// WP-2 confirm-first gate: default interactive + confirmed so the E2E flow proceeds.
+vi.mock('../lib/prompts.js', () => ({
+    confirm: vi.fn(async () => true),
+    isInteractive: vi.fn(() => true),
+}));
+vi.mock('../lib/profiles.js', () => ({
+    createProfile: (...args) => mockCreateProfile(...args),
+    listProfiles: () => mockListProfiles(),
+}));
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(async () => { }),
+}));
+// Mock connect-screens (Ink TUI — cannot render in Vitest environment)
+const mockRunConnectScreens = vi.fn(async (_name, _profile) => { });
+const mockRunConnectHeadless = vi.fn(async (_name, _profile) => { });
+vi.mock('./connect-screens.js', () => ({
+    runConnectScreens: (name, profile) => mockRunConnectScreens(name, profile),
+    runConnectHeadless: (name, profile) => mockRunConnectHeadless(name, profile),
+}));
+// Import function under test and mocked modules
+import { runConnect } from './connect.js';
+import { writeFileSync } from 'fs';
+import { CLIError } from '../lib/errors.js';
+import * as clack from '@clack/prompts';
+// Suppress console output
+const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+const stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+const originalEnv = { ...process.env };
+const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+describe('pb connect — integration', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        consoleSpy.mockClear();
+        stdoutSpy.mockClear();
+        stderrSpy.mockClear();
+        process.env.CONVEX_SITE_URL = 'https://test.convex.site';
+        delete process.env.PB_ENV;
+        delete process.env.PB_CONNECT_GATEWAY_URL;
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    it('happy path: full connect flow', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_test123',
+                workspaceId: 'ws1',
+                workspaceName: 'Test WS',
+            }),
+        });
+        await runConnect(token);
+        // fetch called with CONVEX_SITE_URL + /auth/redeem-connect-token
+        expect(mockFetch).toHaveBeenCalledWith('https://test.convex.site/auth/redeem-connect-token', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ token }),
+        }));
+        // Profile created with slugified workspace name
+        expect(mockCreateProfile).toHaveBeenCalledWith('test-ws', 'pb_sk_test123', expect.any(String));
+        // useProfile NOT called — connect doesn't hijack global profile
+        // Project config written
+        expect(writeFileSync).toHaveBeenCalled();
+        // Ink wizard was called with workspace name and profile name
+        expect(mockRunConnectScreens).toHaveBeenCalledWith('Test WS', 'test-ws');
+        // FEAT-1291: post-connect handoff no longer uses clack.select (TEN-1992 fix)
+        expect(clack.select).not.toHaveBeenCalled();
+        // FEAT-1291: printHandoff writes the tailored handoff message to process.stdout.
+        // existsSync is mocked to always-false → bare-repo path fires.
+        expect(stdoutSpy).toHaveBeenCalledWith(expect.stringContaining('No AI tool detected in this project'));
+    });
+    it('token rejection stops flow — wizard and handshake not called', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: false,
+            status: 400,
+            json: async () => ({
+                error: {
+                    code: 'invalid_token',
+                    message: 'Token expired',
+                },
+            }),
+        });
+        await expect(runConnect(token)).rejects.toThrow(CLIError);
+        // Ink wizard and prompts should NOT have been called
+        expect(mockRunConnectScreens).not.toHaveBeenCalled();
+        expect(clack.select).not.toHaveBeenCalled();
+    });
+    it('invalid token format never hits server', async () => {
+        await expect(runConnect('bad_token')).rejects.toThrow(CLIError);
+        // fetch should NOT have been called
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+    it('handshake failure is non-fatal (handled inside runConnectScreens)', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_test456',
+                workspaceId: 'ws2',
+                workspaceName: 'WS Two',
+            }),
+        });
+        // runConnect should NOT throw — runConnectScreens handles handshake internally
+        await expect(runConnect(token)).resolves.toBeUndefined();
+        // runConnectScreens was called with workspace and profile name
+        expect(mockRunConnectScreens).toHaveBeenCalledWith('WS Two', 'ws-two');
+    });
+    it('FEAT-1291: post-connect flow completes without clack.select (no exit-on-cancel path)', async () => {
+        // TEN-1992 fix: the old clack.select "What's next?" menu exited on cancel.
+        // Now runConnect always succeeds after the screens — no cancel path possible.
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_nocancel',
+                workspaceId: 'ws3',
+                workspaceName: 'No Cancel WS',
+            }),
+        });
+        await expect(runConnect(token)).resolves.toBeUndefined();
+        expect(clack.select).not.toHaveBeenCalled();
+    });
+    it('includes deployment hint in error when token is invalid', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: false,
+            status: 400,
+            json: async () => ({
+                error: { code: 'invalid_token', message: 'Token expired' },
+            }),
+        });
+        let caught;
+        try {
+            await runConnect(token);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(CLIError);
+        expect(caught.guidance).toContain('Tried gateway:');
+        expect(caught.guidance).toContain('CONVEX_SITE_URL');
+        expect(caught.guidance).toContain('--gateway');
+    });
+    it('uses CONVEX_SITE_URL for redeem when set', async () => {
+        process.env.CONVEX_SITE_URL = 'https://my-dev.convex.site';
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_convex',
+                workspaceId: 'ws-convex',
+                workspaceName: 'Convex WS',
+            }),
+        });
+        await runConnect(token);
+        expect(mockFetch).toHaveBeenCalledWith('https://my-dev.convex.site/auth/redeem-connect-token', expect.objectContaining({ method: 'POST' }));
+    });
+    it('passes --name to redeem body in non-interactive flow', async () => {
+        const token = 'pb_ct_' + 'a'.repeat(40);
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                apiKey: 'pb_sk_ci',
+                workspaceId: 'ws-ci',
+                workspaceName: 'CI WS',
+            }),
+        });
+        await runConnect(token, { name: 'GitHub Actions' });
+        expect(mockFetch).toHaveBeenCalledWith('https://test.convex.site/auth/redeem-connect-token', expect.objectContaining({
+            body: JSON.stringify({ token, name: 'GitHub Actions' }),
+        }));
+    });
+});
+//# sourceMappingURL=connect-integration.test.js.map

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

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