@productbrain/cli 0.1.0-beta.47 → 0.1.0-beta.4721

package/dist/__tests__/session-close-loop.test.js

@@ -0,0 +1,231 @@
+/**
+ * pb session close — finish-the-loop enforcement (TEN-2370 / ASM-40).
+ *
+ * Close fetches the SERVER wrapup truth (agent.getSessionWrapup) and:
+ *  - reports committed vs still-draft from server state, not the local snapshot;
+ *  - when drafts remain and --force is absent: prints the promote command, throws
+ *    LOOP_UNFINISHED (→ non-zero exit), and DOES NOT close the session;
+ *  - with --force, or with zero drafts: closes normally;
+ *  - if the wrapup read fails: degrades to a normal close (never blocks on infra).
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runSessionClose } from '../commands/session.js';
+import { ErrorCode } from '../lib/errors.js';
+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(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+    readLocalProjectConfig: vi.fn(() => null),
+}));
+const clearSessionMock = vi.fn();
+let mockSession = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+    writeSession: vi.fn(),
+    clearSession: () => clearSessionMock(),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('../commands/handshake.js', () => ({ runHandshake: vi.fn() }));
+vi.mock('../lib/constants.js', () => ({ resolveAppUrl: () => 'https://work.productbrain.io' }));
+function installRoutes(opts) {
+    kernelCallMock.mockImplementation((fn) => {
+        switch (fn) {
+            case 'agent.getSessionWrapup':
+                if (opts.wrapup instanceof Error)
+                    return Promise.reject(opts.wrapup);
+                return Promise.resolve(opts.wrapup ?? { committed: [], drafts: [] });
+            case 'authorityDomains.readiness':
+                return opts.readiness !== undefined
+                    ? Promise.resolve(opts.readiness)
+                    : Promise.reject(new Error('Admin access required.'));
+            case 'agent.recordWrapup':
+                return Promise.resolve({});
+            case 'agent.closeSession':
+                return Promise.resolve({ status: 'closed', workspaceSlug: 'acme' });
+            case 'setup.listFailedAuditReceipts':
+                return Promise.resolve({ total: 0, entries: [] });
+            default:
+                return Promise.resolve({});
+        }
+    });
+}
+function calledWith(fn) {
+    return kernelCallMock.mock.calls.some((c) => c[0] === fn);
+}
+describe('runSessionClose — finish-the-loop enforcement', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Default to the human-terminal (pretty) context so the nudge-text assertions exercise
+        // the TTY path. Under the test runner's non-TTY default ('auto'), isJsonMode() resolves
+        // to JSON and the nudge is intentionally suppressed — the dedicated --json test covers that.
+        setOutputMode('pretty');
+        mockSession = {
+            sessionId: 'sess-test',
+            workspaceId: 'ws-1',
+            workspaceName: 'Product Brain',
+            startedAt: new Date(Date.now() - 5 * 60_000).toISOString(),
+            entriesCaptured: ['DEC-1', 'TEN-2'],
+        };
+    });
+    it('blocks close with a non-zero LOOP_UNFINISHED error when drafts remain and no --force', async () => {
+        installRoutes({
+            wrapup: { committed: [{ entryId: 'DEC-1', name: 'Decided X' }], drafts: [{ entryId: 'TEN-2', name: 'Tension Y' }] },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        let caught;
+        try {
+            await runSessionClose({});
+        }
+        catch (err) {
+            caught = err;
+        }
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(caught).toBeInstanceOf(Error);
+        expect(caught.code).toBe(ErrorCode.LOOP_UNFINISHED);
+        // Prints the exact promote command for the remaining draft.
+        expect(output).toContain('pb entry accept TEN-2');
+        // The session must NOT be torn down — the agent needs it open to promote.
+        expect(calledWith('agent.closeSession')).toBe(false);
+        expect(clearSessionMock).not.toHaveBeenCalled();
+    });
+    it('blocks close on a draft hidden beyond the cap — overflowDrafts is merged into the gate (TEN-2370)', async () => {
+        // The capped window shows only committed entries (drafts: []), but a still-draft entry
+        // exists past WRAPUP_ENTRY_CAP. The gate must NOT falsely certify the loop finished.
+        installRoutes({
+            wrapup: {
+                committed: [{ entryId: 'DEC-1', name: 'Decided X' }],
+                drafts: [],
+                overflowDrafts: [{ entryId: 'INS-16', name: 'Overflow insight' }],
+            },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        let caught;
+        try {
+            await runSessionClose({});
+        }
+        catch (err) {
+            caught = err;
+        }
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(caught.code).toBe(ErrorCode.LOOP_UNFINISHED);
+        // The overflow draft is promotable — its id appears in the promote command.
+        expect(output).toContain('pb entry accept INS-16');
+        // And the session stays open so the agent can promote it.
+        expect(calledWith('agent.closeSession')).toBe(false);
+        expect(clearSessionMock).not.toHaveBeenCalled();
+    });
+    it('fails closed when the draft set is truncated (overflowUnscanned > 0) even with zero visible drafts', async () => {
+        installRoutes({
+            wrapup: { committed: [{ entryId: 'DEC-1', name: 'Decided X' }], drafts: [], overflowUnscanned: 3 },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        let caught;
+        try {
+            await runSessionClose({});
+        }
+        catch (err) {
+            caught = err;
+        }
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        // Cannot certify the loop finished — must NOT close.
+        expect(caught.code).toBe(ErrorCode.LOOP_UNFINISHED);
+        expect(output).toContain('could not be read');
+        expect(calledWith('agent.closeSession')).toBe(false);
+    });
+    it('in --json mode the blocked gate writes no human nudge to stdout (still throws LOOP_UNFINISHED)', async () => {
+        installRoutes({
+            wrapup: { committed: [], drafts: [{ entryId: 'TEN-2', name: 'Tension Y' }] },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        setOutputMode('json');
+        let caught;
+        try {
+            await runSessionClose({});
+        }
+        catch (err) {
+            caught = err;
+        }
+        finally {
+            setOutputMode('auto');
+        }
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(caught.code).toBe(ErrorCode.LOOP_UNFINISHED);
+        // The human nudge must NOT corrupt stdout for JSON callers — only the structured
+        // error (emitted by the global handler on throw) reaches them.
+        expect(output).not.toContain('Finish the loop');
+        expect(output).not.toContain('Session NOT closed');
+    });
+    it('closes anyway when --force is passed even though drafts remain', async () => {
+        installRoutes({
+            wrapup: { committed: [], drafts: [{ entryId: 'TEN-2', name: 'Tension Y' }] },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await expect(runSessionClose({ force: true })).resolves.toBeUndefined();
+        writeSpy.mockRestore();
+        expect(calledWith('agent.closeSession')).toBe(true);
+        expect(clearSessionMock).toHaveBeenCalled();
+    });
+    it('closes normally and reports server truth when every entry was committed', async () => {
+        installRoutes({
+            wrapup: { committed: [{ entryId: 'DEC-1', name: 'Decided X' }], drafts: [] },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runSessionClose({});
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(calledWith('agent.closeSession')).toBe(true);
+        expect(clearSessionMock).toHaveBeenCalled();
+        expect(output).toContain('1 committed, 0 still draft');
+    });
+    it('degrades to a normal close when the wrapup read fails (never blocks on infra)', async () => {
+        installRoutes({ wrapup: new Error('gateway unreachable') });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await expect(runSessionClose({})).resolves.toBeUndefined();
+        writeSpy.mockRestore();
+        // No server truth → no enforcement → close proceeds.
+        expect(calledWith('agent.closeSession')).toBe(true);
+        expect(clearSessionMock).toHaveBeenCalled();
+    });
+    it('names committed entries beyond the cap — overflowCommitted is merged into the committed listing (TEN-2402)', async () => {
+        // The capped window shows one committed entry; a committed entry exists past
+        // WRAPUP_ENTRY_CAP. Both must be NAMED in the close output — not a bare "N more".
+        installRoutes({
+            wrapup: {
+                committed: [{ entryId: 'DEC-1', name: 'Decided X' }],
+                drafts: [],
+                overflowCommitted: [{ entryId: 'DEC-16', name: 'Overflow decision' }],
+            },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runSessionClose({});
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(calledWith('agent.closeSession')).toBe(true);
+        // Both committed entries — capped and overflow — are named.
+        expect(output).toContain('DEC-1');
+        expect(output).toContain('DEC-16');
+        // The loop-status count reflects the full committed set (2), not just the capped 1.
+        expect(output).toContain('2 committed, 0 still draft');
+    });
+    it('surfaces the pending domain-tag proposal count when the readiness read succeeds', async () => {
+        installRoutes({
+            wrapup: { committed: [{ entryId: 'DEC-1', name: 'Decided X' }], drafts: [] },
+            readiness: { proposals: { pendingDomainTagCount: 4 } },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runSessionClose({});
+        const output = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('4 pending domain-tag proposal');
+        expect(output).toContain('pb authority-domains review');
+    });
+});
+//# sourceMappingURL=session-close-loop.test.js.map

package/dist/__tests__/session-close-loop.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-close-loop.test.js","sourceRoot":"","sources":["../../src/__tests__/session-close-loop.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,174 @@
+/**
+ * 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),
+    readProjectConfig: 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),
+    sessionFileExists: vi.fn(() => false),
+    RESUME_WINDOW_MS: 2 * 60 * 60 * 1000,
+}));
+vi.mock('../commands/handshake.js', () => ({ runHandshake: vi.fn(async () => { }) }));
+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-reset.test.d.ts

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

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

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

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

@@ -0,0 +1,138 @@
+/**
+ * pb session reset — TEN-2189 / WP-456 E2.
+ * Hard-resets local SESSION state: discards session.json (no resume marker). Guards an active
+ * session behind confirmation unless --force. The preview *binding* (config.local.json keys +
+ * PREVIEW_MODE marker) is owned by `npm run pb:real`, NOT reset — see the session-only assertions.
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+const mockReadSession = vi.fn();
+const mockDiscardSession = vi.fn();
+const mockDiscardAllSessions = vi.fn();
+const mockSessionFileExists = vi.fn(() => false);
+const mockHasAnyActive = vi.fn(() => false);
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockReadSession(),
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    discardSession: () => mockDiscardSession(),
+    discardAllSessions: () => mockDiscardAllSessions(),
+    // reset now checks ALL markers (Codex re-review) — mirror sessionFileExists in the mock.
+    hasAnySessionMarker: () => mockSessionFileExists(),
+    hasAnyActiveSession: () => mockHasAnyActive(),
+    sessionFileExists: () => mockSessionFileExists(),
+    readClosedMarker: vi.fn(() => null),
+    addCapturedEntry: vi.fn(),
+}));
+const mockConfirm = vi.fn();
+const mockIsInteractive = vi.fn(() => true);
+vi.mock('../lib/prompts.js', () => ({
+    confirm: (...a) => mockConfirm(...a),
+    isInteractive: () => mockIsInteractive(),
+}));
+import { runSessionReset } from '../commands/session.js';
+const ACTIVE = {
+    sessionId: 's1', workspaceId: 'w1', workspaceName: 'WS',
+    startedAt: '2026-01-01T00:00:00Z', entriesCaptured: [],
+};
+describe('runSessionReset', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockReadSession.mockReturnValue(null);
+        mockSessionFileExists.mockReturnValue(false);
+        mockIsInteractive.mockReturnValue(true);
+    });
+    it('reports nothing to reset when no local session state exists', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionReset({});
+            const out = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+            expect(out).toMatch(/Nothing to reset/);
+            expect(mockDiscardAllSessions).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('is session-only — does not act on a preview binding when no session exists', async () => {
+        // reset never inspects or clears the PREVIEW_MODE marker / preview keys: binding is pb:real's
+        // job. With no session.json present, reset has nothing to do regardless of binding state.
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionReset({});
+            const out = writeSpy.mock.calls.map((c) => String(c[0])).join('');
+            expect(out).toMatch(/Nothing to reset/);
+            expect(out).not.toMatch(/PREVIEW_MODE/);
+            expect(mockDiscardAllSessions).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('discards a closed marker (file present, no active session) without a prompt', async () => {
+        mockSessionFileExists.mockReturnValue(true);
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionReset({});
+            expect(mockConfirm).not.toHaveBeenCalled();
+            expect(mockDiscardAllSessions).toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('prompts before discarding an active session, and aborts on decline', async () => {
+        mockReadSession.mockReturnValue(ACTIVE);
+        mockConfirm.mockResolvedValue(false);
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionReset({});
+            expect(mockConfirm).toHaveBeenCalled();
+            expect(mockDiscardAllSessions).not.toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('discards an active session when the prompt is confirmed', async () => {
+        mockReadSession.mockReturnValue(ACTIVE);
+        mockConfirm.mockResolvedValue(true);
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionReset({});
+            expect(mockConfirm).toHaveBeenCalled();
+            expect(mockDiscardAllSessions).toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('--force discards an active session with no prompt', async () => {
+        mockReadSession.mockReturnValue(ACTIVE);
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        try {
+            await runSessionReset({ force: true });
+            expect(mockConfirm).not.toHaveBeenCalled();
+            expect(mockDiscardAllSessions).toHaveBeenCalled();
+        }
+        finally {
+            writeSpy.mockRestore();
+        }
+    });
+    it('refuses to reset an active session non-interactively without --force', async () => {
+        mockReadSession.mockReturnValue(ACTIVE);
+        mockIsInteractive.mockReturnValue(false);
+        await expect(runSessionReset({})).rejects.toThrow(/refusing to reset/);
+        expect(mockDiscardAllSessions).not.toHaveBeenCalled();
+    });
+    it('refuses when only a SIBLING conversation is active (current is null) — Codex re-review', async () => {
+        // Current conversation resolves to no session, but another conversation's marker is active.
+        mockReadSession.mockReturnValue(null);
+        mockSessionFileExists.mockReturnValue(true);
+        mockHasAnyActive.mockReturnValue(true);
+        mockIsInteractive.mockReturnValue(false);
+        // Must NOT silently delete the sibling active marker — requires confirmation/--force.
+        await expect(runSessionReset({})).rejects.toThrow(/refusing to reset/);
+        expect(mockDiscardAllSessions).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=session-reset.test.js.map