@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/__tests__/session-hook-conversation.test.js

@@ -0,0 +1,87 @@
+/**
+ * TASK-562 (Codex P1 on #1937): a Codex or Cursor hook names its conversation only in the JSON on
+ * stdin. With `--hook` the resolver reads it, so two concurrent conversations get two markers and
+ * the SessionEnd of one leaves the other's session active. Runs the real marker files.
+ */
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const { root } = vi.hoisted(() => ({ root: { dir: '' } }));
+vi.mock('../lib/config.js', () => ({ findProjectRoot: () => root.dir }));
+import { readHookConversationId, readStdinFully, resolveConversationId, normalizeConversationId } from '../lib/conversation.js';
+import { clearSession, readSession, writeSession } from '../lib/session.js';
+const ENV = ['PB_CONVERSATION_ID', 'CLAUDE_CODE_SESSION_ID', 'CURSOR_CONVERSATION_ID', 'CODEX_TUI_SESSION_LOG_PATH'];
+const notTty = () => false;
+const hook = (input) => readHookConversationId(() => JSON.stringify(input), notTty);
+const state = (sessionId) => ({ sessionId, workspaceId: 'w1', workspaceName: 'WS', startedAt: new Date().toISOString(), entriesCaptured: [] });
+describe('hook input names the conversation (TASK-562)', () => {
+    const saved = { ...process.env };
+    beforeEach(() => {
+        root.dir = mkdtempSync(join(tmpdir(), 'pb-hook-conv-'));
+        for (const k of ENV)
+            delete process.env[k];
+    });
+    afterEach(() => {
+        rmSync(root.dir, { recursive: true, force: true });
+        process.env = { ...saved };
+        readHookConversationId(() => '', notTty);
+    });
+    it('never touches process.stdin: its getter makes fd 0 non-blocking, so input arriving late would read EAGAIN (Reviewer F2)', () => {
+        const desc = Object.getOwnPropertyDescriptor(process, 'stdin');
+        let touched = 0;
+        Object.defineProperty(process, 'stdin', { configurable: true, get() { touched += 1; return desc.get ? desc.get.call(process) : desc.value; } });
+        try {
+            expect(readHookConversationId(() => '{"session_id":"late"}', notTty)).toBe('late');
+            expect(touched).toBe(0);
+        }
+        finally {
+            Object.defineProperty(process, 'stdin', desc);
+        }
+    });
+    it('input that arrives late on a non-blocking stdin is still read whole: EAGAIN waits, EOF ends (Reviewer F2)', () => {
+        const steps = ['EAGAIN', 'EAGAIN', '{"session_', 'EAGAIN', 'id":"rev-late"}', ''];
+        const readSync = (_fd, buf) => {
+            const step = steps.shift();
+            if (step === 'EAGAIN')
+                throw Object.assign(new Error('EAGAIN: resource temporarily unavailable, read'), { code: 'EAGAIN' });
+            return buf.write(step ?? '');
+        };
+        expect(readStdinFully(readSync, 1_000)).toBe('{"session_id":"rev-late"}');
+        expect(steps).toEqual([]);
+    });
+    it('gives up after the deadline when no input ever arrives, so a hook never hangs', () => {
+        const always = () => { throw Object.assign(new Error('EAGAIN'), { code: 'EAGAIN' }); };
+        const started = Date.now();
+        expect(readStdinFully(always, 60)).toBe('');
+        expect(Date.now() - started).toBeLessThan(1_000);
+    });
+    it('reads nothing when fd 0 is a terminal', () => {
+        expect(readHookConversationId(() => '{"session_id":"x"}', () => true)).toBeNull();
+    });
+    it('two hook inputs open two sessions, and closing one leaves the other active', () => {
+        hook({ session_id: 'codex-a', hook_event_name: 'SessionStart' });
+        writeSession(state('session-a'));
+        hook({ session_id: 'codex-b', hook_event_name: 'SessionStart' });
+        writeSession(state('session-b'));
+        hook({ session_id: 'codex-a', hook_event_name: 'SessionEnd' });
+        clearSession();
+        expect(readSession()).toBeNull();
+        hook({ session_id: 'codex-b', hook_event_name: 'SessionStart' });
+        expect(readSession()?.sessionId).toBe('session-b');
+    });
+    it('reads Cursor conversation_id too, keeps the normalization, and PB_CONVERSATION_ID still wins', () => {
+        hook({ conversation_id: 'cursor/conv 1' });
+        expect(resolveConversationId()).toBe(normalizeConversationId('cursor/conv 1'));
+        process.env.PB_CONVERSATION_ID = 'explicit';
+        expect(resolveConversationId()).toBe('explicit');
+    });
+    it('ranks ahead of the env fallbacks, and with no JSON on stdin the env channels decide', () => {
+        process.env.CODEX_TUI_SESSION_LOG_PATH = '/tmp/superset-log.jsonl';
+        hook({ session_id: 'codex-a' });
+        expect(resolveConversationId()).toBe('codex-a');
+        readHookConversationId(() => 'not json', notTty);
+        expect(resolveConversationId()).toBe(normalizeConversationId('/tmp/superset-log.jsonl'));
+    });
+});
+//# sourceMappingURL=session-hook-conversation.test.js.map

package/dist/__tests__/session-hook-conversation.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * WP-479 E2 — session label auto-population (founder-day fix, Pass 2).
+ * Priority: SUPERSET_WORKSPACE_NAME env → git branch (silent fail) → cwd basename.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const mockExecSync = vi.fn();
+vi.mock('child_process', () => ({
+    execSync: (...args) => mockExecSync(...args),
+}));
+import { resolveSessionLabel } from '../commands/session.js';
+const savedEnv = {};
+beforeEach(() => {
+    savedEnv.SUPERSET_WORKSPACE_NAME = process.env.SUPERSET_WORKSPACE_NAME;
+    delete process.env.SUPERSET_WORKSPACE_NAME;
+    mockExecSync.mockReset();
+});
+afterEach(() => {
+    if (savedEnv.SUPERSET_WORKSPACE_NAME === undefined)
+        delete process.env.SUPERSET_WORKSPACE_NAME;
+    else
+        process.env.SUPERSET_WORKSPACE_NAME = savedEnv.SUPERSET_WORKSPACE_NAME;
+});
+describe('resolveSessionLabel()', () => {
+    it('prefers SUPERSET_WORKSPACE_NAME when set', () => {
+        process.env.SUPERSET_WORKSPACE_NAME = 'session-attribution';
+        expect(resolveSessionLabel()).toBe('session-attribution');
+        expect(mockExecSync).not.toHaveBeenCalled();
+    });
+    it('falls back to git branch when SUPERSET_WORKSPACE_NAME is absent', () => {
+        mockExecSync.mockReturnValue(Buffer.from('my-feature-branch\n'));
+        expect(resolveSessionLabel()).toBe('my-feature-branch');
+    });
+    it('falls back to cwd basename when git branch lookup throws (silent fail)', () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error('not a git repo');
+        });
+        const expected = process.cwd().split('/').pop();
+        expect(resolveSessionLabel()).toBe(expected);
+    });
+    it('falls back to cwd basename when git returns an empty branch name', () => {
+        mockExecSync.mockReturnValue(Buffer.from('\n'));
+        const expected = process.cwd().split('/').pop();
+        expect(resolveSessionLabel()).toBe(expected);
+    });
+});
+//# sourceMappingURL=session-label.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-label.test.js","sourceRoot":"","sources":["../../src/__tests__/session-label.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7B,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACxD,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,QAAQ,GAAuC,EAAE,CAAC;AAExD,UAAU,CAAC,GAAG,EAAE;IACd,QAAQ,CAAC,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACvE,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC3C,YAAY,CAAC,SAAS,EAAE,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,IAAI,QAAQ,CAAC,uBAAuB,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;;QAC1F,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,QAAQ,CAAC,uBAAuB,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,qBAAqB,CAAC;QAC5D,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC1D,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACnC,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAChD,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAChD,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/session-list-show.test.d.ts

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

package/dist/__tests__/session-list-show.test.d.ts.map

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

package/dist/__tests__/session-list-show.test.js

@@ -0,0 +1,171 @@
+/**
+ * pb session list / pb session show — command wiring tests (WP-479 E4).
+ *
+ * Verifies:
+ * - list calls agent.listSessions and renders quota gauge (pretty) / passes data through (json)
+ * - show resolves by BOTH arg kinds: a Convex-id-shaped arg goes out as sessionId (with a
+ *   conversationId retry when the server rejects it); a non-id-shaped arg goes straight out
+ *   as conversationId
+ * - json mode emits the structured payload
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { setOutputMode } from '../lib/runner.js';
+const kernelCallMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    kernelCall: (...args) => kernelCallMock(...args),
+    kernelCallWithSession: vi.fn(),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(async () => ({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+    readLocalProjectConfig: vi.fn(() => null),
+    resolveEffectiveProfile: vi.fn(() => ({ profile: 'p', source: 'local' })),
+    refreshPreviewApiKeyFromDisk: vi.fn(() => 'not-bound'),
+}));
+vi.mock('../lib/profiles.js', () => ({ getActiveProfile: vi.fn(() => 'p') }));
+vi.mock('../lib/session.js', () => ({
+    readSession: vi.fn(() => null),
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    discardSession: vi.fn(),
+    readClosedMarker: vi.fn(() => null),
+    RESUME_WINDOW_MS: 2 * 60 * 60 * 1000,
+}));
+import { runSessionList, runSessionShow } from '../commands/session.js';
+const LIST_FIXTURE = {
+    active: [
+        {
+            sessionId: 'js7abc123def456ghi789jkl012mno',
+            conversationId: 'conv-a',
+            label: 'session-attribution',
+            clientKind: 'cli',
+            initiatedBy: 'Randy',
+            status: 'active',
+            startedAt: Date.now() - 10 * 60_000,
+            lastToolCallAt: Date.now(),
+            entriesCreatedCount: 2,
+            entriesModifiedCount: 1,
+            purpose: null,
+        },
+    ],
+    recent: [],
+    quota: { activeCount: 1, cap: 50 },
+};
+const SHOW_FIXTURE = {
+    conversationId: 'conv-a',
+    sessions: [
+        {
+            sessionId: 'js7abc123def456ghi789jkl012mno',
+            conversationId: 'conv-a',
+            label: 'session-attribution',
+            clientKind: 'cli',
+            initiatedBy: 'Randy',
+            status: 'active',
+            startedAt: Date.now() - 10 * 60_000,
+            lastToolCallAt: Date.now(),
+            entriesCreatedCount: 1,
+            entriesModifiedCount: 0,
+            purpose: null,
+            entriesCreated: ['e1'],
+            entriesModified: [],
+            relationsCreated: 0,
+            gateFailures: 0,
+            contradictionWarnings: 0,
+        },
+    ],
+    serves: [
+        {
+            servedAt: Date.now() - 60_000,
+            entryId: 'STD-12',
+            surface: 'orient',
+            renderMode: 'brief',
+            task: 'a task',
+            sessionId: 'js7abc123def456ghi789jkl012mno',
+        },
+    ],
+};
+let stdoutOutput;
+let stdoutWriteSpy;
+beforeEach(() => {
+    stdoutOutput = '';
+    stdoutWriteSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+        stdoutOutput += String(chunk);
+        return true;
+    });
+    vi.clearAllMocks();
+    setOutputMode('auto');
+});
+afterEach(() => {
+    stdoutWriteSpy.mockRestore();
+    setOutputMode('auto');
+});
+describe('runSessionList', () => {
+    it('calls agent.listSessions and renders the quota gauge + collision-free labels in pretty mode', async () => {
+        setOutputMode('pretty');
+        kernelCallMock.mockResolvedValue(LIST_FIXTURE);
+        await runSessionList();
+        expect(kernelCallMock).toHaveBeenCalledWith('agent.listSessions', {});
+        expect(stdoutOutput).toContain('Quota: 1 of 50 active');
+        expect(stdoutOutput).toContain('session-attribution');
+        expect(stdoutOutput).toContain('js7abc123def456ghi789jkl012mno');
+    });
+    it('passes the structured payload through in json mode (full conversationId, quota object)', async () => {
+        setOutputMode('json');
+        kernelCallMock.mockResolvedValue({
+            ...LIST_FIXTURE,
+            active: [{ ...LIST_FIXTURE.active[0], conversationId: 'x'.repeat(64) }],
+        });
+        await runSessionList();
+        const parsed = JSON.parse(stdoutOutput);
+        expect(parsed.quota).toEqual({ activeCount: 1, cap: 50 });
+        // JSON carries the FULL conversationId — truncation is a pretty-mode concern only.
+        expect(parsed.active[0].conversationId).toBe('x'.repeat(64));
+    });
+});
+describe('runSessionShow', () => {
+    it('a Convex-id-shaped arg is sent as sessionId', async () => {
+        setOutputMode('pretty');
+        kernelCallMock.mockResolvedValue(SHOW_FIXTURE);
+        await runSessionShow('js7abc123def456ghi789jkl012mno');
+        expect(kernelCallMock).toHaveBeenCalledWith('agent.showConversation', {
+            sessionId: 'js7abc123def456ghi789jkl012mno',
+        });
+        expect(stdoutOutput).toContain('Conversation: conv-a');
+        expect(stdoutOutput).toContain('1 session(s) in lineage');
+        expect(stdoutOutput).toContain('STD-12');
+    });
+    it('a non-id-shaped arg (e.g. UUID with dashes) goes straight out as conversationId', async () => {
+        setOutputMode('pretty');
+        kernelCallMock.mockResolvedValue(SHOW_FIXTURE);
+        await runSessionShow('3f9a-uuid-with-dashes');
+        expect(kernelCallMock).toHaveBeenCalledTimes(1);
+        expect(kernelCallMock).toHaveBeenCalledWith('agent.showConversation', {
+            conversationId: '3f9a-uuid-with-dashes',
+        });
+    });
+    it('retries an id-shaped arg as conversationId when the sessionId call is rejected', async () => {
+        setOutputMode('pretty');
+        // A conversationId can coincidentally match the Convex id shape — first attempt 400s,
+        // the retry as conversationId succeeds (list-row copyability contract).
+        kernelCallMock
+            .mockRejectedValueOnce(new Error('ArgumentValidationError: not an Id<agentSessions>'))
+            .mockResolvedValueOnce(SHOW_FIXTURE);
+        const idShaped = 'abcdefghijklmnopqrstuvwxyz012345';
+        await runSessionShow(idShaped);
+        expect(kernelCallMock).toHaveBeenNthCalledWith(1, 'agent.showConversation', { sessionId: idShaped });
+        expect(kernelCallMock).toHaveBeenNthCalledWith(2, 'agent.showConversation', { conversationId: idShaped });
+        expect(stdoutOutput).toContain('Conversation: conv-a');
+    });
+    it('emits structured JSON in json mode', async () => {
+        setOutputMode('json');
+        kernelCallMock.mockResolvedValue(SHOW_FIXTURE);
+        await runSessionShow('conv-a');
+        const parsed = JSON.parse(stdoutOutput);
+        expect(parsed.conversationId).toBe('conv-a');
+        expect(parsed.sessions).toHaveLength(1);
+        expect(parsed.serves[0].entryId).toBe('STD-12');
+    });
+    it('rejects an empty argument with guidance', async () => {
+        await expect(runSessionShow('   ')).rejects.toThrow(/session id or conversation id/i);
+    });
+});
+//# sourceMappingURL=session-list-show.test.js.map

package/dist/__tests__/session-list-show.test.js.map

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

package/dist/__tests__/session-pinned-role.test.d.ts

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

package/dist/__tests__/session-pinned-role.test.d.ts.map

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