@productbrain/cli 0.1.0-beta.52 → 0.1.0-beta.5214

package/dist/__tests__/session-switch.test.js

@@ -0,0 +1,267 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+const mockKernelCall = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    kernelCall: (...a) => mockKernelCall(...a),
+    kernelCallWithSession: vi.fn(),
+}));
+const mockGetConfigOrGuide = vi.fn(async () => ({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' }));
+const mockResolveEffectiveProfile = vi.fn(() => ({ profile: 'p', source: 'local' }));
+const mockReadLocalProjectConfig = vi.fn(() => null);
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: (...a) => mockGetConfigOrGuide(...a),
+    resolveEffectiveProfile: () => mockResolveEffectiveProfile(),
+    readLocalProjectConfig: () => mockReadLocalProjectConfig(),
+    readProjectConfig: vi.fn(() => null),
+    refreshPreviewApiKeyFromDisk: vi.fn(() => 'not-bound'),
+}));
+const mockGetActiveProfile = vi.fn(() => 'global-profile');
+vi.mock('../lib/profiles.js', () => ({ getActiveProfile: () => mockGetActiveProfile() }));
+const mockReadSession = vi.fn();
+const mockWriteSession = vi.fn();
+const mockDiscardSession = vi.fn();
+const mockReadClosedMarker = vi.fn(() => null);
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockReadSession(),
+    writeSession: (...a) => mockWriteSession(...a),
+    clearSession: vi.fn(),
+    discardSession: () => mockDiscardSession(),
+    readClosedMarker: () => mockReadClosedMarker(),
+    sessionFileExists: vi.fn(() => false),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('../commands/handshake.js', () => ({ runHandshake: vi.fn(async () => { }) }));
+// session.ts resolves its profile label through the reporting leaf (WP-700). DELEGATE to this
+// file's own resolveEffectiveProfile mock, which each test sets — so every existing case keeps
+// exactly the profile it was written against. sessionBinding.ts (unmocked here) also imports
+// isEnvKeyBinding from this module.
+vi.mock('../lib/reportedProfile.js', () => ({
+    resolveReportedProfile: () => mockResolveEffectiveProfile(),
+    isEnvKeyBinding: () => false,
+}));
+// TEN-3238 leftover: session start now names its target. Mocked so these tests assert WHETHER it
+// fires without pulling the real notice's config cascade through this file's config.js mock.
+const mockEmitWriteTargetNotice = vi.fn(async () => { });
+vi.mock('../lib/workspaceNotice.js', () => ({
+    emitWriteTargetNotice: (...a) => mockEmitWriteTargetNotice(...a),
+}));
+import { runSessionStart, runSessionClose } from '../commands/session.js';
+describe('runSessionStart switch-backstop', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' });
+        mockReadClosedMarker.mockReturnValue(null);
+        mockReadLocalProjectConfig.mockReturnValue(null);
+        delete process.env.PRODUCTBRAIN_API_KEY;
+        delete process.env.CONVEX_SITE_URL;
+    });
+    it('discards a session whose profile differs from the current effective profile, then starts fresh', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's-old', workspaceId: 'w-old', workspaceName: 'Old',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'old',
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'new', source: 'local' });
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-new', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's-new', workspaceName: 'New', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        await runSessionStart({ json: true });
+        expect(mockDiscardSession).toHaveBeenCalled();
+        // WP-479 E2: writeSession's 2nd arg is the (undefined, absent identity) conversationId override.
+        expect(mockWriteSession).toHaveBeenCalledWith(expect.objectContaining({ sessionId: 's-new', profile: 'new' }), undefined);
+    });
+    it('discards a session whose CREDENTIAL was swapped while the profile name held still (TEN-3240)', async () => {
+        // The exact blind spot: a raw exported PRODUCTBRAIN_API_KEY carries no profile name, so
+        // repointing it at another workspace left the name-only backstop reporting alreadyActive.
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'p', source: 'local' });
+        mockReadSession.mockReturnValue({
+            sessionId: 's-old', workspaceId: 'w-old', workspaceName: 'Old',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'p',
+            bindingFingerprint: 'deadbeefdeadbeef',
+        });
+        process.env.PRODUCTBRAIN_API_KEY = 'pb_sk_a_different_workspaces_key';
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-new', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's-new', workspaceName: 'New', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        await runSessionStart({ json: true });
+        expect(mockDiscardSession).toHaveBeenCalled();
+        expect(mockWriteSession).toHaveBeenCalledWith(expect.objectContaining({ sessionId: 's-new', bindingFingerprint: expect.any(String) }), undefined);
+    });
+    it('keeps a session already active when the same credential is still bound', async () => {
+        process.env.PRODUCTBRAIN_API_KEY = 'pb_sk_unchanged_key';
+        process.env.CONVEX_SITE_URL = 'https://test.convex.site';
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'p', source: 'local' });
+        // Start once to learn the fingerprint this binding produces, rather than hardcoding a digest.
+        mockReadSession.mockReturnValue(null);
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w1', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's1', workspaceName: 'WS', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        await runSessionStart({ json: true });
+        const written = mockWriteSession.mock.calls.at(-1)?.[0];
+        expect(written.bindingFingerprint).toEqual(expect.any(String));
+        vi.clearAllMocks();
+        mockReadClosedMarker.mockReturnValue(null);
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'p',
+            bindingFingerprint: written.bindingFingerprint,
+        });
+        await runSessionStart({ json: true });
+        expect(mockDiscardSession).not.toHaveBeenCalled();
+        expect(mockWriteSession).not.toHaveBeenCalled();
+    });
+    it('restarts a pre-fingerprint session ONCE on upgrade (Codex P1 r13, fail-closed)', async () => {
+        // A marker written before `bindingFingerprint` existed cannot be compared on the credential,
+        // and a matching profile name is not proof (`pb connect` can overwrite a profile in place).
+        // So it restarts once, then carries a fingerprint and never trips this again.
+        process.env.PRODUCTBRAIN_API_KEY = 'pb_sk_whatever';
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'p', source: 'local' });
+        mockReadSession.mockReturnValue({
+            sessionId: 's-old', workspaceId: 'w-old', workspaceName: 'Old',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'p',
+            // no bindingFingerprint — written before this field existed
+        });
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-new', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's-new', workspaceName: 'New', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        await runSessionStart({ json: true });
+        expect(mockDiscardSession).toHaveBeenCalled();
+        expect(mockWriteSession).toHaveBeenCalledWith(expect.objectContaining({ bindingFingerprint: expect.any(String) }), undefined);
+    });
+    it('names its target workspace on the fresh start path, but not on the already-active one (WP-696)', async () => {
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'p', source: 'local' });
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'p',
+        });
+        await runSessionStart({ json: true });
+        expect(mockEmitWriteTargetNotice).not.toHaveBeenCalled();
+        vi.clearAllMocks();
+        mockReadClosedMarker.mockReturnValue(null);
+        mockReadSession.mockReturnValue(null);
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w1', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's1', workspaceName: 'WS', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        await runSessionStart({ json: true });
+        expect(mockEmitWriteTargetNotice).toHaveBeenCalled();
+    });
+    it('reports the effective repo profile on the fresh JSON session path', async () => {
+        mockReadSession.mockReturnValue(null);
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'repo-profile', source: 'local' });
+        mockGetActiveProfile.mockReturnValue('global-profile');
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-repo', keyId: 'k1' };
+            if (method === 'agent.startSession') {
+                return { sessionId: 's-new', workspaceName: 'Repo workspace', initiatedBy: 'cli', toolsScope: 'rw' };
+            }
+            return {};
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({ json: true });
+            const output = writeSpy.mock.calls.map((call) => String(call[0])).join('');
+            expect(JSON.parse(output)).toMatchObject({
+                sessionId: 's-new',
+                workspaceName: 'Repo workspace',
+                activeProfile: 'repo-profile',
+            });
+            expect(mockGetActiveProfile).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('discards and starts fresh on a profile switch in pretty (non-json) mode too', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's-old', workspaceId: 'w-old', workspaceName: 'Old',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'old',
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'new', source: 'local' });
+        mockKernelCall.mockImplementation(async (method) => {
+            if (method === 'resolveWorkspace')
+                return { _id: 'w-new', keyId: 'k1' };
+            if (method === 'agent.startSession')
+                return { sessionId: 's-new', workspaceName: 'New', initiatedBy: 'cli', toolsScope: 'rw' };
+            return {};
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({}); // no json → pretty mode
+            expect(mockDiscardSession).toHaveBeenCalled();
+            expect(mockKernelCall).toHaveBeenCalledWith('agent.startSession', expect.anything());
+            // WP-479 E2: writeSession's 2nd arg is the (undefined, absent identity) conversationId override.
+            expect(mockWriteSession).toHaveBeenCalledWith(expect.objectContaining({ sessionId: 's-new', profile: 'new' }), undefined);
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('preserves alreadyActive for a legacy session with no profile field (no discard)', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], // NOTE: no `profile`
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'new', source: 'local' });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({ json: true });
+            const out = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+            expect(out).toMatch(/alreadyActive/);
+            expect(mockDiscardSession).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('keeps alreadyActive when the effective profile is unchanged', async () => {
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], profile: 'same',
+        });
+        mockResolveEffectiveProfile.mockReturnValue({ profile: 'same', source: 'local' });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionStart({ json: true });
+            const out = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+            expect(out).toMatch(/alreadyActive/);
+            expect(mockDiscardSession).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+});
+describe('runSessionClose --force hint', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockGetConfigOrGuide.mockResolvedValue({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' });
+        mockReadSession.mockReturnValue({
+            sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+            startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [],
+        });
+    });
+    it('puts the --force instruction in the error message itself', async () => {
+        mockKernelCall.mockRejectedValue(new Error('Internal server error'));
+        await expect(runSessionClose({})).rejects.toThrow(/pb session close --force/);
+    });
+});
+//# sourceMappingURL=session-switch.test.js.map

package/dist/__tests__/session-switch.test.js.map

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

package/dist/__tests__/session-touch.test.js

@@ -1,13 +1,13 @@
 /**
- * session-touch — verify mcpCallWithSession auto-renews the session TTL.
+ * session-touch — verify kernelCallWithSession auto-renews the session TTL.
  * BET-181 Slice 1: Session Auto-Renew on Write.
  *
  * Done-when criteria tested:
- * 1. After a successful mcpCallWithSession, agent.touchSession is called with the current session ID
- * 2. Touch happens in exactly ONE place (mcpCallWithSession) — not per-command
+ * 1. After a successful kernelCallWithSession, agent.touchSession is called with the current session ID
+ * 2. Touch happens in exactly ONE place (kernelCallWithSession) — not per-command
  * 3. Touch is fire-and-forget (does not block the write response)
  * 4. When no session is active (session.json absent), no touch is attempted
- * 5. When mcpCallWithSession fails (write error), touch is NOT called
+ * 5. When kernelCallWithSession fails (write error), touch is NOT called
  */
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 // We need to control what readSession() returns per test.
@@ -19,7 +19,7 @@ vi.mock('../lib/config.js', () => ({
     getConfig: vi.fn(() => ({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
 }));
 // Import the module under test AFTER setting up mocks.
-import { mcpCallWithSession } from '../lib/client.js';
+import { kernelCallWithSession, resetTouchThrottle } from '../lib/client.js';
 // Helper: build a fetch mock that returns different responses based on `fn`.
 function makeFetch({ writeOk = true, writeData = { ok: true }, } = {}) {
     return vi.fn(async (_input, init) => {
@@ -43,9 +43,14 @@ async function flushMicrotasks() {
     await Promise.resolve();
     await Promise.resolve();
 }
-describe('mcpCallWithSession — session touch on write', () => {
+describe('kernelCallWithSession — session touch on write', () => {
     beforeEach(() => {
         vi.clearAllMocks();
+        // WP-579: touches are now throttled per-session (matches the server's own no-op
+        // window) — every test here reuses the same sessionId, so the throttle must be
+        // reset between tests or later tests silently see a suppressed (correctly, but
+        // untested-here) touch from an earlier test.
+        resetTouchThrottle();
         mockSession = {
             sessionId: 'sess-abc123',
             workspaceId: 'ws-1',
@@ -59,7 +64,7 @@ describe('mcpCallWithSession — session touch on write', () => {
     });
     it('calls agent.touchSession with the current session ID after a successful write', async () => {
         global.fetch = makeFetch({ writeOk: true, writeData: { entryId: 'BET-181' } });
-        await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-181', name: 'New name' });
+        await kernelCallWithSession('chain.updateEntry', { entryId: 'BET-181', name: 'New name' });
         await flushMicrotasks();
         const calls = global.fetch.mock.calls;
         // Expect exactly 2 fetch calls: the write + the touch
@@ -75,7 +80,7 @@ describe('mcpCallWithSession — session touch on write', () => {
     it('does NOT call agent.touchSession when no session is active', async () => {
         mockSession = null;
         global.fetch = makeFetch({ writeOk: true });
-        await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-100' });
+        await kernelCallWithSession('chain.updateEntry', { entryId: 'BET-100' });
         await flushMicrotasks();
         const calls = global.fetch.mock.calls;
         // Only the write call — no touch
@@ -85,7 +90,7 @@ describe('mcpCallWithSession — session touch on write', () => {
     });
     it('does NOT call agent.touchSession when the write fails', async () => {
         global.fetch = makeFetch({ writeOk: false });
-        await expect(mcpCallWithSession('chain.updateEntry', { entryId: 'BET-100' })).rejects.toThrow('Server error');
+        await expect(kernelCallWithSession('chain.updateEntry', { entryId: 'BET-100' })).rejects.toThrow('Server error');
         await flushMicrotasks();
         const calls = global.fetch.mock.calls;
         // Only the write call — no touch because write threw
@@ -106,7 +111,7 @@ describe('mcpCallWithSession — session touch on write', () => {
             };
         });
         // Should resolve successfully despite touch throwing
-        const result = await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
+        const result = await kernelCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
         await flushMicrotasks();
         expect(result).toEqual({ entryId: 'BET-181' });
     });
@@ -123,7 +128,7 @@ describe('mcpCallWithSession — session touch on write', () => {
             order.push('write-complete');
             return { ok: true, json: async () => ({ data: { entryId: 'BET-181' } }) };
         });
-        await mcpCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
+        await kernelCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
         // Write has resolved — touch has NOT yet completed (it's still pending)
         expect(order).toEqual(['write-complete']);
         // After waiting for the touch to finish

package/dist/__tests__/session-touch.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-touch.test.js","sourceRoot":"","sources":["../../src/__tests__/session-touch.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,0DAA0D;AAC1D,IAAI,WAAW,GAA2H,IAAI,CAAC;AAE/I,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW;CAC/B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;CACxF,CAAC,CAAC,CAAC;AAEJ,uDAAuD;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,6EAA6E;AAC7E,SAAS,SAAS,CAAC,EACjB,OAAO,GAAG,IAAI,EACd,SAAS,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAItB,EAAE;IACJ,OAAO,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAyB,EAAE,IAAkB,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAoB,CAAC;QACvE,IAAI,IAAI,CAAC,EAAE,KAAK,oBAAoB,EAAE,CAAC;YACrC,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;aACrB,CAAC;QAChB,CAAC;QACD,0BAA0B;QAC1B,OAAO;YACL,EAAE,EAAE,OAAO;YACX,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB;YACpD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;SAClE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,wFAAwF;IACxF,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IAC3D,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,WAAW,GAAG;YACZ,SAAS,EAAE,aAAa;YACxB,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,eAAe;YAC9B,SAAS,EAAE,sBAAsB;YACjC,eAAe,EAAE,EAAE;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC7F,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAE/E,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACxF,MAAM,eAAe,EAAE,CAAC;QAExB,MAAM,KAAK,GAAI,MAAM,CAAC,KAAkC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,sDAAsD;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE9B,+BAA+B;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAkC,CAAC;QACjG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAE/C,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAgD,CAAC;QAC/G,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAChD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,MAAM,eAAe,EAAE,CAAC;QAExB,MAAM,KAAK,GAAI,MAAM,CAAC,KAAkC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,iCAAiC;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAmB,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAE7C,MAAM,MAAM,CACV,kBAAkB,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAElC,MAAM,eAAe,EAAE,CAAC;QAExB,MAAM,KAAK,GAAI,MAAM,CAAC,KAAkC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,qDAAqD;QACrD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAmB,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,oCAAoC;QACpC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAyB,EAAE,IAAkB,EAAE,EAAE;YAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAoB,CAAC;YACvE,IAAI,IAAI,CAAC,EAAE,KAAK,oBAAoB,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YACnC,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC;aACzC,CAAC;QAChB,CAAC,CAA4B,CAAC;QAE9B,qDAAqD;QACrD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAsB,mBAAmB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1G,MAAM,eAAe,EAAE,CAAC;QAExB,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAyB,EAAE,IAAkB,EAAE,EAAE;YAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,CAAoB,CAAC;YACvE,IAAI,IAAI,CAAC,EAAE,KAAK,oBAAoB,EAAE,CAAC;gBACrC,wBAAwB;gBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAc,CAAC;YACpE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,EAAc,CAAC;QACxF,CAAC,CAA4B,CAAC;QAE9B,MAAM,kBAAkB,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,wEAAwE;QACxE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAE1C,wCAAwC;QACxC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"session-touch.test.js","sourceRoot":"","sources":["../../src/__tests__/session-touch.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/session.test.js

@@ -5,8 +5,8 @@
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { runSessionId } from '../commands/session.js';
 vi.mock('../lib/client.js', () => ({
-    mcpCall: vi.fn(),
-    mcpCallWithSession: vi.fn(),
+    kernelCall: vi.fn(),
+    kernelCallWithSession: vi.fn(),
 }));
 vi.mock('../lib/config.js', () => ({
     getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),

package/dist/__tests__/session.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../src/__tests__/session.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;IAChB,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC5B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAC3B,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAC/E;CACF,CAAC,CAAC,CAAC;AAEJ,IAAI,WAAW,GAA2H,IAAI,CAAC;AAC/I,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW;IAC9B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC1B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;CACtB,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,WAAW,GAAG;YACZ,SAAS,EAAE,kCAAkC;YAC7C,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,eAAe;YAC9B,SAAS,EAAE,sBAAsB;YACjC,eAAe,EAAE,EAAE;SACpB,CAAC;QACF,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAElF,YAAY,EAAE,CAAC;QAEf,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,oCAAoC,CAAC,CAAC;QAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../src/__tests__/session.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;IACnB,qBAAqB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC/B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAC3B,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAC/E;CACF,CAAC,CAAC,CAAC;AAEJ,IAAI,WAAW,GAA2H,IAAI,CAAC;AAC/I,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW;IAC9B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;IACrB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;CAC1B,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;CACtB,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,WAAW,GAAG;YACZ,SAAS,EAAE,kCAAkC;YAC7C,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,eAAe;YAC9B,SAAS,EAAE,sBAAsB;YACjC,eAAe,EAAE,EAAE;SACpB,CAAC;QACF,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAElF,YAAY,EAAE,CAAC;QAEf,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,oCAAoC,CAAC,CAAC;QAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/sessionBinding.test.d.ts

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

package/dist/__tests__/sessionBinding.test.d.ts.map

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

package/dist/__tests__/sessionBinding.test.js

@@ -0,0 +1,100 @@
+/**
+ * WP-700 — binding identity for the session switch-backstop.
+ *
+ * Deliberately touches NO process.env: vitest shares worker processes across test files, so
+ * mutating the credential env vars here would break whatever unrelated suite runs alongside.
+ * `fingerprintOf` takes the binding as arguments precisely so this file does not have to.
+ */
+import { describe, it, expect } from 'vitest';
+import { fingerprintOf, bindingChanged, assertSessionStillBound } from '../lib/sessionBinding.js';
+import { DEFAULT_SITE_URL } from '../lib/constants.js';
+describe('fingerprintOf', () => {
+    it('treats a trailing-slash gateway as the SAME binding (Codex P2 r2)', () => {
+        // getConfigOrGuide()/loadEnv() normalize both to one endpoint, so hashing them differently
+        // would spuriously discard a perfectly valid session on the next start.
+        expect(fingerprintOf('pb_sk_same', 'https://x.convex.site/'))
+            .toBe(fingerprintOf('pb_sk_same', 'https://x.convex.site'));
+    });
+    it('moves when the key changes, and when the gateway genuinely changes', () => {
+        const base = fingerprintOf('pb_sk_a', 'https://x.convex.site');
+        expect(fingerprintOf('pb_sk_b', 'https://x.convex.site')).not.toBe(base);
+        expect(fingerprintOf('pb_sk_a', 'https://other.convex.site')).not.toBe(base);
+    });
+    it('treats an absent gateway as the DEFAULT one, not as "no gateway" (Codex P2 r3)', () => {
+        // getConfigOrGuide() falls back to DEFAULT_SITE_URL, so explicitly exporting that exact URL
+        // is the same effective endpoint — hashing '' for the absent case discarded a live session.
+        expect(fingerprintOf('pb_sk_a', undefined)).toBe(fingerprintOf('pb_sk_a', DEFAULT_SITE_URL));
+        expect(fingerprintOf('pb_sk_a', undefined)).toBe(fingerprintOf('pb_sk_a', DEFAULT_SITE_URL + '/'));
+    });
+    it('handles an absent gateway without collapsing distinct keys', () => {
+        expect(fingerprintOf('pb_sk_a', undefined)).not.toBe(fingerprintOf('pb_sk_b', undefined));
+    });
+    it('never leaks the raw key, and stays 16 hex chars', () => {
+        const fp = fingerprintOf('pb_sk_supersecret', 'https://x');
+        expect(fp).not.toContain('supersecret');
+        expect(fp).toMatch(/^[0-9a-f]{16}$/);
+    });
+});
+describe('bindingChanged', () => {
+    it('fires on a changed profile name', () => {
+        expect(bindingChanged({ profile: 'a' }, { profile: 'b', fingerprint: undefined })).toBe(true);
+    });
+    it('fires on a changed credential even when the name held still (TEN-3240)', () => {
+        expect(bindingChanged({ profile: 'a', bindingFingerprint: 'ffff' }, { profile: 'a', fingerprint: '0000' })).toBe(true);
+    });
+    it('does not fire when both signals match', () => {
+        expect(bindingChanged({ profile: 'a', bindingFingerprint: 'ffff' }, { profile: 'a', fingerprint: 'ffff' })).toBe(false);
+    });
+    it('fails CLOSED on EVERY legacy marker once a fingerprint exists (Codex P1 r7, r8, r13)', () => {
+        // A pre-upgrade marker cannot be compared on the credential, so there is no evidence its
+        // workspace is unchanged — whatever shape it has.
+        expect(bindingChanged({ profile: 'p' }, { profile: null, fingerprint: 'abcd' })).toBe(true);
+        expect(bindingChanged({}, { profile: null, fingerprint: 'abcd' })).toBe(true);
+        expect(bindingChanged({}, { profile: 'p', fingerprint: 'abcd' })).toBe(true);
+        // A MATCHING NAME is not evidence either (r13): `pb connect` can overwrite a profile's
+        // credentials in place, so one name can point at two workspaces over time.
+        expect(bindingChanged({ profile: 'p' }, { profile: 'p', fingerprint: 'abcd' })).toBe(true);
+    });
+    it('does not fire that fail-closed rule on a marker this version wrote', () => {
+        // Those always carry a fingerprint, so the rule retires itself as old markers roll over.
+        expect(bindingChanged({ profile: 'p', bindingFingerprint: 'abcd' }, { profile: null, fingerprint: 'abcd' })).toBe(false);
+    });
+    it('uses the name check when NOTHING is bound — nothing to fingerprint against', () => {
+        expect(bindingChanged({ profile: 'a' }, { profile: 'a', fingerprint: undefined })).toBe(false);
+        expect(bindingChanged({ profile: 'a' }, { profile: 'z', fingerprint: undefined })).toBe(true);
+    });
+});
+describe('assertSessionStillBound', () => {
+    // Codex P1 r9: `pb session start` is not the only door. An operator can repoint the credential
+    // and run a write DIRECTLY, so the marker names one workspace while the gateway derives another
+    // from the key (BR-18). This is the guard on every session-attributed write.
+    it('refuses a marker with NO fingerprint once a credential is bound (Codex P1 r15)', () => {
+        // It predates the field, so nothing can prove it targets this credential's workspace — and
+        // `pb relate` sends no session id, so nothing downstream would re-check.
+        expect(() => assertSessionStillBound({}, 'aaaa')).toThrow(/credential changed/i);
+    });
+    it('stays quiet when there is no session, or nothing bound to compare against', () => {
+        expect(() => assertSessionStillBound(null, 'aaaa')).not.toThrow();
+        expect(() => assertSessionStillBound({}, undefined)).not.toThrow();
+    });
+    it('refuses when the credential moved since the session opened', () => {
+        expect(() => assertSessionStillBound({ bindingFingerprint: 'aaaa' }, 'bbbb'))
+            .toThrow(/credential changed/i);
+    });
+    it('passes when the credential is unchanged', () => {
+        expect(() => assertSessionStillBound({ bindingFingerprint: 'aaaa' }, 'aaaa')).not.toThrow();
+    });
+    it('stays quiet when nothing is bound — it cannot judge, so it must not block', () => {
+        expect(() => assertSessionStillBound({ bindingFingerprint: 'aaaa' }, undefined)).not.toThrow();
+    });
+    it('names the repair, so an agent hitting it knows what to run', () => {
+        try {
+            assertSessionStillBound({ bindingFingerprint: 'aaaa' }, 'bbbb');
+            throw new Error('expected a refusal');
+        }
+        catch (e) {
+            expect(e.guidance).toContain('pb session start');
+        }
+    });
+});
+//# sourceMappingURL=sessionBinding.test.js.map

package/dist/__tests__/sessionBinding.test.js.map

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

package/dist/__tests__/sessionByIdLookup.test.d.ts

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

package/dist/__tests__/sessionByIdLookup.test.d.ts.map

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

package/dist/__tests__/sessionByIdLookup.test.js

@@ -0,0 +1,63 @@
+/**
+ * WP-703 (TEN-3315) — resolve a session marker by its session id.
+ *
+ * The write-binding guard compares the bound credential against a marker's fingerprint. Without
+ * this lookup it could only ever judge the AMBIENT conversation's marker, so a call that named a
+ * different session explicitly was skipped — blind exactly where the caller was most deliberate.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdirSync, writeFileSync, rmSync } from 'fs';
+import { resolve, join } from 'path';
+import { tmpdir } from 'os';
+import { randomUUID } from 'crypto';
+vi.mock('../lib/conversation.js', () => ({ resolveConversationId: () => null }));
+describe('readSessionBySessionId', () => {
+    let tempDir;
+    const originalCwd = process.cwd;
+    const marker = (id, extra = {}) => JSON.stringify({
+        sessionId: id, workspaceId: 'w1', workspaceName: 'WS',
+        startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [], ...extra,
+    });
+    beforeEach(() => {
+        tempDir = resolve(tmpdir(), `pb-session-byid-${randomUUID()}`);
+        mkdirSync(join(tempDir, '.productbrain', 'sessions'), { recursive: true });
+        writeFileSync(join(tempDir, '.productbrain', 'config.json'), '{}');
+        process.cwd = () => tempDir;
+    });
+    afterEach(() => {
+        process.cwd = originalCwd;
+        try {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    });
+    it('finds a marker in the per-conversation directory', async () => {
+        writeFileSync(join(tempDir, '.productbrain', 'sessions', 'conv-a.json'), marker('s-a', { bindingFingerprint: 'aaaa' }));
+        const { readSessionBySessionId } = await import('../lib/session.js');
+        expect(readSessionBySessionId('s-a')?.bindingFingerprint).toBe('aaaa');
+    });
+    it('finds a marker in the LEGACY session.json too', async () => {
+        // A session id says nothing about which conversation owns it, so both shapes are searched.
+        writeFileSync(join(tempDir, '.productbrain', 'session.json'), marker('s-legacy'));
+        const { readSessionBySessionId } = await import('../lib/session.js');
+        expect(readSessionBySessionId('s-legacy')?.sessionId).toBe('s-legacy');
+    });
+    it('picks the RIGHT marker when several conversations are active', async () => {
+        const dir = join(tempDir, '.productbrain', 'sessions');
+        writeFileSync(join(dir, 'conv-a.json'), marker('s-a', { bindingFingerprint: 'aaaa' }));
+        writeFileSync(join(dir, 'conv-b.json'), marker('s-b', { bindingFingerprint: 'bbbb' }));
+        const { readSessionBySessionId } = await import('../lib/session.js');
+        expect(readSessionBySessionId('s-b')?.bindingFingerprint).toBe('bbbb');
+    });
+    it('ignores a CLOSED marker — that is not an active session', async () => {
+        writeFileSync(join(tempDir, '.productbrain', 'sessions', 'conv-a.json'), marker('s-closed', { closedAt: '2026-01-01T01:00:00Z' }));
+        const { readSessionBySessionId } = await import('../lib/session.js');
+        expect(readSessionBySessionId('s-closed')).toBeNull();
+    });
+    it('returns null for an unknown id, and never throws on a malformed marker', async () => {
+        writeFileSync(join(tempDir, '.productbrain', 'sessions', 'broken.json'), '{ not json');
+        const { readSessionBySessionId } = await import('../lib/session.js');
+        expect(readSessionBySessionId('s-nope')).toBeNull();
+    });
+});
+//# sourceMappingURL=sessionByIdLookup.test.js.map