@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.102

package/dist/__tests__/session-state-machine.test.js

@@ -0,0 +1,154 @@
+/**
+ * WP-322 S2 — Session state machine unit tests.
+ *
+ * Tests the dual-purpose session.json contract:
+ *   - Active session: file present, no closedAt
+ *   - Closed marker: file present, closedAt set
+ *   - No file: fresh state
+ *
+ * Done-when criteria tested:
+ *   1. readSession() returns null when closedAt is present (marker state)
+ *   2. readClosedMarker() returns marker when closedAt is present
+ *   3. readClosedMarker() returns null when no closedAt (active session state)
+ *   4. clearSession() on active session writes a closed marker (atomic tmp→rename)
+ *   5. clearSession() on an existing marker deletes the file (no timestamp refresh)
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+// ---------------------------------------------------------------------------
+// Virtual filesystem state — controlled per test
+// ---------------------------------------------------------------------------
+const fsState = { sessionJson: null };
+vi.mock('fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        existsSync: (p) => {
+            if (String(p).endsWith('session.json'))
+                return fsState.sessionJson !== null;
+            if (String(p).endsWith('session.json.tmp'))
+                return false;
+            return actual.existsSync(p);
+        },
+        readFileSync: (p, enc) => {
+            if (String(p).endsWith('session.json') && enc === 'utf8') {
+                if (fsState.sessionJson === null)
+                    throw new Error('ENOENT');
+                return fsState.sessionJson;
+            }
+            return actual.readFileSync(p, enc);
+        },
+        writeFileSync: (p, data, enc) => {
+            if (String(p).endsWith('session.json') || String(p).endsWith('session.json.tmp')) {
+                fsState.sessionJson = String(data);
+                return;
+            }
+            return actual.writeFileSync(p, data, enc);
+        },
+        renameSync: (src, dst) => {
+            // tmp → session.json: already written to fsState.sessionJson in writeFileSync above
+            if (String(src).endsWith('session.json.tmp') && String(dst).endsWith('session.json'))
+                return;
+            return actual.renameSync(src, dst);
+        },
+        unlinkSync: (p) => {
+            if (String(p).endsWith('session.json')) {
+                fsState.sessionJson = null;
+                return;
+            }
+            return actual.unlinkSync(p);
+        },
+        mkdirSync: vi.fn(), // always succeeds
+    };
+});
+import { readSession, clearSession, readClosedMarker, } from '../lib/session.js';
+const ACTIVE_SESSION = {
+    sessionId: 'rd79aaa',
+    workspaceId: 'ws-1',
+    workspaceName: 'Test Workspace',
+    startedAt: '2026-04-16T09:00:00.000Z',
+    entriesCaptured: [],
+};
+const CLOSED_MARKER = {
+    ...ACTIVE_SESSION,
+    closedAt: new Date(Date.now() - 30 * 60 * 1000).toISOString(), // 30 min ago
+};
+beforeEach(() => {
+    fsState.sessionJson = null;
+    vi.clearAllMocks();
+});
+describe('readSession()', () => {
+    it('returns null when no file exists', () => {
+        expect(readSession()).toBeNull();
+    });
+    it('returns session when file has no closedAt (active session)', () => {
+        fsState.sessionJson = JSON.stringify(ACTIVE_SESSION);
+        const result = readSession();
+        expect(result).not.toBeNull();
+        expect(result?.sessionId).toBe('rd79aaa');
+        expect(result?.closedAt).toBeUndefined();
+    });
+    it('returns null when file has closedAt (closed marker state)', () => {
+        fsState.sessionJson = JSON.stringify(CLOSED_MARKER);
+        expect(readSession()).toBeNull();
+    });
+});
+describe('readClosedMarker()', () => {
+    it('returns null when no file exists', () => {
+        expect(readClosedMarker()).toBeNull();
+    });
+    it('returns null when file has no closedAt (active session)', () => {
+        fsState.sessionJson = JSON.stringify(ACTIVE_SESSION);
+        expect(readClosedMarker()).toBeNull();
+    });
+    it('returns marker shape when closedAt is present', () => {
+        fsState.sessionJson = JSON.stringify(CLOSED_MARKER);
+        const marker = readClosedMarker();
+        expect(marker).not.toBeNull();
+        expect(marker?.sessionId).toBe('rd79aaa');
+        expect(marker?.closedAt).toBeDefined();
+        expect(marker?.workspaceId).toBe('ws-1');
+        expect(marker?.workspaceName).toBe('Test Workspace');
+    });
+});
+describe('clearSession()', () => {
+    it('no-ops when no file exists', () => {
+        expect(() => clearSession()).not.toThrow();
+        expect(fsState.sessionJson).toBeNull();
+    });
+    it('writes a closed marker when called on an active session', () => {
+        fsState.sessionJson = JSON.stringify(ACTIVE_SESSION);
+        clearSession();
+        const result = JSON.parse(fsState.sessionJson);
+        expect(result.sessionId).toBe('rd79aaa');
+        expect(result.closedAt).toBeDefined();
+        expect(typeof result.closedAt).toBe('string');
+        // entriesCaptured should be reset
+        expect(result.entriesCaptured).toEqual([]);
+    });
+    it('deletes the file when called on an already-closed marker (no timestamp refresh)', () => {
+        fsState.sessionJson = JSON.stringify(CLOSED_MARKER);
+        clearSession();
+        // File must be gone — clearSession on a marker deletes, does not refresh
+        expect(fsState.sessionJson).toBeNull();
+    });
+});
+describe('2h resume window boundary', () => {
+    it('readClosedMarker returns marker within 2h window', () => {
+        const recentMarker = { ...ACTIVE_SESSION, closedAt: new Date(Date.now() - 30 * 60 * 1000).toISOString() };
+        fsState.sessionJson = JSON.stringify(recentMarker);
+        const marker = readClosedMarker();
+        expect(marker).not.toBeNull();
+        const elapsed = Date.now() - new Date(marker.closedAt).getTime();
+        expect(elapsed).toBeLessThan(2 * 60 * 60 * 1000);
+    });
+    it('readClosedMarker returns marker outside 2h window (caller checks elapsed)', () => {
+        const staleMarker = { ...ACTIVE_SESSION, closedAt: new Date(Date.now() - 3 * 60 * 60 * 1000).toISOString() };
+        fsState.sessionJson = JSON.stringify(staleMarker);
+        const marker = readClosedMarker();
+        // readClosedMarker always returns the data — runSessionStart checks the elapsed time
+        expect(marker).not.toBeNull();
+        const elapsed = Date.now() - new Date(marker.closedAt).getTime();
+        expect(elapsed).toBeGreaterThan(2 * 60 * 60 * 1000);
+    });
+});
+//# sourceMappingURL=session-state-machine.test.js.map

package/dist/__tests__/session-state-machine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state-machine.test.js","sourceRoot":"","sources":["../../src/__tests__/session-state-machine.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9D,8EAA8E;AAC9E,iDAAiD;AACjD,8EAA8E;AAC9E,MAAM,OAAO,GAAmC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAEtE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IACrC,MAAM,MAAM,GAAG,MAAM,cAAc,EAAuB,CAAC;IAC3D,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,CAAC,CAAS,EAAE,EAAE;YACxB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC;YAC5E,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,YAAY,EAAE,CAAC,CAAS,EAAE,GAAa,EAAE,EAAE;YACzC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACzD,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC5D,OAAO,OAAO,CAAC,WAAW,CAAC;YAC7B,CAAC;YACD,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,GAAY,CAAC,CAAC;QAC9C,CAAC;QACD,aAAa,EAAE,CAAC,CAAS,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;YACzD,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACjF,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO;YACT,CAAC;YACD,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,IAAa,EAAE,GAAY,CAAC,CAAC;QAC9D,CAAC;QACD,UAAU,EAAE,CAAC,GAAW,EAAE,GAAW,EAAE,EAAE;YACvC,oFAAoF;YACpF,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO;YAC7F,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,UAAU,EAAE,CAAC,CAAS,EAAE,EAAE;YACxB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC/E,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,kBAAkB;KACvC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EACL,WAAW,EAEX,YAAY,EACZ,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,cAAc,GAAG;IACrB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,gBAAgB;IAC/B,SAAS,EAAE,0BAA0B;IACrC,eAAe,EAAE,EAAE;CACpB,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,GAAG,cAAc;IACjB,QAAQ,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,aAAa;CAC7E,CAAC;AAEF,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3B,EAAE,CAAC,aAAa,EAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACrD,YAAY,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAY,CAA4B,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,kCAAkC;QAClC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACpD,YAAY,EAAE,CAAC;QACf,yEAAyE;QACzE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,YAAY,GAAG,EAAE,GAAG,cAAc,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1G,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAClE,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,WAAW,GAAG,EAAE,GAAG,cAAc,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7G,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,qFAAqF;QACrF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAClE,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/session-touch.test.d.ts

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

package/dist/__tests__/session-touch.test.d.ts.map

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

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

@@ -0,0 +1,134 @@
+/**
+ * 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 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 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.
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+}));
+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 { kernelCallWithSession } 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) => {
+        const body = JSON.parse(String(init?.body ?? '{}'));
+        if (body.fn === 'agent.touchSession') {
+            return {
+                ok: true,
+                json: async () => ({ data: {} }),
+            };
+        }
+        // Default: the write call
+        return {
+            ok: writeOk,
+            statusText: writeOk ? 'OK' : 'Internal Server Error',
+            json: async () => (writeOk ? { data: writeData } : { error: 'Server error' }),
+        };
+    });
+}
+async function flushMicrotasks() {
+    // Two rounds of microtask flushing to allow the fire-and-forget .catch chain to settle.
+    await Promise.resolve();
+    await Promise.resolve();
+}
+describe('kernelCallWithSession — session touch on write', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSession = {
+            sessionId: 'sess-abc123',
+            workspaceId: 'ws-1',
+            workspaceName: 'Product Brain',
+            startedAt: '2026-03-23T12:00:00Z',
+            entriesCaptured: [],
+        };
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('calls agent.touchSession with the current session ID after a successful write', async () => {
+        global.fetch = makeFetch({ writeOk: true, writeData: { entryId: 'BET-181' } });
+        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
+        expect(calls).toHaveLength(2);
+        // First call: the actual write
+        const writeBody = JSON.parse(String(calls[0][1]?.body ?? '{}'));
+        expect(writeBody.fn).toBe('chain.updateEntry');
+        // Second call: the touch
+        const touchBody = JSON.parse(String(calls[1][1]?.body ?? '{}'));
+        expect(touchBody.fn).toBe('agent.touchSession');
+        expect(touchBody.args.sessionId).toBe('sess-abc123');
+    });
+    it('does NOT call agent.touchSession when no session is active', async () => {
+        mockSession = null;
+        global.fetch = makeFetch({ writeOk: true });
+        await kernelCallWithSession('chain.updateEntry', { entryId: 'BET-100' });
+        await flushMicrotasks();
+        const calls = global.fetch.mock.calls;
+        // Only the write call — no touch
+        expect(calls).toHaveLength(1);
+        const body = JSON.parse(String(calls[0][1]?.body ?? '{}'));
+        expect(body.fn).toBe('chain.updateEntry');
+    });
+    it('does NOT call agent.touchSession when the write fails', async () => {
+        global.fetch = makeFetch({ writeOk: false });
+        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
+        expect(calls).toHaveLength(1);
+        const body = JSON.parse(String(calls[0][1]?.body ?? '{}'));
+        expect(body.fn).toBe('chain.updateEntry');
+    });
+    it('touch errors are silently swallowed — write result is returned regardless', async () => {
+        // Touch call throws a network error
+        global.fetch = vi.fn(async (_input, init) => {
+            const body = JSON.parse(String(init?.body ?? '{}'));
+            if (body.fn === 'agent.touchSession') {
+                throw new Error('Network error');
+            }
+            return {
+                ok: true,
+                json: async () => ({ data: { entryId: 'BET-181' } }),
+            };
+        });
+        // Should resolve successfully despite touch throwing
+        const result = await kernelCallWithSession('chain.updateEntry', { entryId: 'BET-181' });
+        await flushMicrotasks();
+        expect(result).toEqual({ entryId: 'BET-181' });
+    });
+    it('touch is non-blocking — write resolves before touch completes', async () => {
+        const order = [];
+        global.fetch = vi.fn(async (_input, init) => {
+            const body = JSON.parse(String(init?.body ?? '{}'));
+            if (body.fn === 'agent.touchSession') {
+                // Simulate a slow touch
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                order.push('touch-complete');
+                return { ok: true, json: async () => ({ data: {} }) };
+            }
+            order.push('write-complete');
+            return { ok: true, json: async () => ({ data: { 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
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        expect(order).toEqual(['write-complete', 'touch-complete']);
+    });
+});
+//# sourceMappingURL=session-touch.test.js.map

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

@@ -0,0 +1 @@
+{"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.d.ts

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

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

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

package/dist/__tests__/session.test.js

@@ -0,0 +1,46 @@
+/**
+ * pb session id — verify local session read behavior.
+ * TEN-341 test contract: has session → prints ID, no session → exits 1.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runSessionId } from '../commands/session.js';
+vi.mock('../lib/client.js', () => ({
+    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' })),
+}));
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('./handshake.js', () => ({
+    runHandshake: vi.fn(),
+}));
+describe('runSessionId', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('prints session ID bare to stdout when session exists', () => {
+        mockSession = {
+            sessionId: 'rd79ppnrs9k8d4vtak39pzfmex8378f3',
+            workspaceId: 'ws-1',
+            workspaceName: 'Product Brain',
+            startedAt: '2026-03-19T12:00:00Z',
+            entriesCaptured: [],
+        };
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        runSessionId();
+        expect(writeSpy).toHaveBeenCalledWith('rd79ppnrs9k8d4vtak39pzfmex8378f3\n');
+        writeSpy.mockRestore();
+    });
+    it('throws CLIError when no session', () => {
+        mockSession = null;
+        expect(() => runSessionId()).toThrow('No active session');
+    });
+});
+//# sourceMappingURL=session.test.js.map

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

@@ -0,0 +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,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__/setup-ingest.test.d.ts

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

package/dist/__tests__/setup-ingest.test.d.ts.map

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

package/dist/__tests__/setup-ingest.test.js

@@ -0,0 +1,55 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const kernelCallMock = vi.fn();
+const trackEventMock = vi.fn();
+const { fileContents } = vi.hoisted(() => ({
+    fileContents: {},
+}));
+vi.mock('node:fs', () => ({
+    existsSync: vi.fn((path) => path in fileContents),
+    readFileSync: vi.fn((path) => fileContents[path]),
+}));
+vi.mock('../lib/client.js', () => ({
+    kernelCall: (...args) => kernelCallMock(...args),
+}));
+vi.mock('../lib/session.js', () => ({
+    readSession: vi.fn(() => ({
+        sessionId: 'sess-1',
+        workspaceId: 'workspace-1',
+        workspaceName: 'Test Workspace',
+        startedAt: new Date(0).toISOString(),
+        entriesCaptured: [],
+    })),
+}));
+vi.mock('../lib/runner.js', () => ({
+    isJsonMode: vi.fn(() => false),
+}));
+vi.mock('../lib/telemetry.js', () => ({
+    trackEvent: (...args) => trackEventMock(...args),
+}));
+import { runSetupIngest } from '../commands/setup-ingest.js';
+describe('runSetupIngest', () => {
+    let cwdSpy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        Object.keys(fileContents).forEach((key) => delete fileContents[key]);
+        cwdSpy = vi.spyOn(process, 'cwd').mockReturnValue('/repo');
+    });
+    afterEach(() => {
+        cwdSpy.mockRestore();
+    });
+    it('rejects bundle assets before calling generic setup ingest even under a skills directory', async () => {
+        fileContents['/repo/skills/bundle.md'] = `---
+name: Demo Bundle
+assetKind: bundle
+---
+# Demo Bundle
+`;
+        await expect(runSetupIngest('skills/bundle.md')).rejects.toThrow('Bundle assets must be committed via the UI');
+        expect(kernelCallMock).not.toHaveBeenCalled();
+        expect(trackEventMock).toHaveBeenCalledWith('setup.bundle.commit.failed', {
+            reason: 'bundle_cli_not_supported',
+            path: '/repo/skills/bundle.md',
+        });
+    });
+});
+//# sourceMappingURL=setup-ingest.test.js.map

package/dist/__tests__/setup-ingest.test.js.map

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

package/dist/__tests__/setup-resolver.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WP-336 E2 — setup-resolver contract tests.
+ *
+ * Three test groups:
+ *   1. getSetupMode() — reads PB_SETUP_MODE env var correctly
+ *   2. local mode     — resolveSetupAssets returns assets from .productbrain/
+ *   3. chain mode     — resolveSetupAssets calls kernelCall with the right args
+ *
+ * Done-when coverage:
+ *   - WP-336 #3: local mode returns same asset names as what's in .productbrain/
+ *   - WP-336 #2: chain mode calls kernelCall('setup.getActiveSurface', {...})
+ */
+export {};
+//# sourceMappingURL=setup-resolver.test.d.ts.map

package/dist/__tests__/setup-resolver.test.d.ts.map

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