@productbrain/cli 0.1.0-beta.7 → 0.1.0-beta.70

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

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

package/dist/__tests__/orient.test.js

@@ -0,0 +1,143 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runOrient } from '../commands/orient.js';
+const mcpCallMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCall: (...args) => mcpCallMock(...args),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+vi.mock('../lib/runner.js', () => ({
+    runCliCommand: vi.fn(async ({ fn, formatPretty }) => {
+        const data = await fn();
+        process.stdout.write(formatPretty(data) + '\n');
+    }),
+}));
+const orientView = {
+    stage: 'grounded',
+    strategicContext: {
+        vision: 'Make Chain startup reliable',
+        purpose: 'Surface the right governance at the right time',
+        activeBetCount: 1,
+        currentBet: 'BET-63',
+        activeTensionCount: 1,
+        productAreas: ['Governance'],
+        productAreaCount: 1,
+    },
+    activeBets: [],
+    governance: {
+        principles: [{ entryId: 'PRI-1', name: 'Use live governance', collectionSlug: 'principles', status: 'published', preview: 'Load constraints from the Chain' }],
+        standards: [{ entryId: 'STD-101', name: 'Single source of truth', collectionSlug: 'standards', status: 'published', preview: 'Derive from the live source' }],
+        businessRules: [{ entryId: 'BR-178', name: 'Do not use provider IDs directly', collectionSlug: 'business-rules', status: 'published', preview: 'Permissions must derive from actor context' }],
+    },
+    tensions: [],
+    architectureNotes: [],
+    proposals: [],
+    absenceSignals: [],
+    startup: {
+        groundingStatus: 'grounded',
+        confidence: 'high',
+        totalFound: 2,
+        seeds: [{ entryId: 'STD-101', name: 'Single source of truth', collectionSlug: 'standards' }],
+        bindingGovernance: {
+            principles: [],
+            standards: [{ entryId: 'STD-101', name: 'Single source of truth', collectionSlug: 'standards', preview: 'Derive from the live source' }],
+            businessRules: [{ entryId: 'BR-178', name: 'Do not use provider IDs directly', collectionSlug: 'business-rules', preview: 'Permissions must derive from actor context' }],
+        },
+        steeringContext: [],
+        supportingContext: [{ entryId: 'DEC-12', name: 'Actor boundary', collectionSlug: 'decisions', score: 4, hop: 1 }],
+        taskProfile: {
+            workType: 'implementation',
+            domain: 'auth',
+            keywords: ['harden', 'auth', 'startup', 'flow'],
+        },
+    },
+    plannedWork: {
+        uncommittedDrafts: [],
+        inProgressEntries: [],
+        openTensions: [],
+    },
+    priorSessions: [],
+    recoveryBlock: null,
+    taskContext: {
+        seeds: [{ entryId: 'STD-101', name: 'Single source of truth', collectionSlug: 'standards' }],
+        context: [{ entryId: 'BR-178', name: 'Provider IDs are not authz', collectionSlug: 'business-rules', score: 3, hop: 0 }],
+        totalFound: 2,
+        confidence: 'high',
+    },
+};
+const orientViewWithoutTask = {
+    ...orientView,
+    startup: undefined,
+    taskContext: undefined,
+};
+const orientViewTaskOnly = {
+    ...orientView,
+    startup: {
+        ...orientView.startup,
+        bindingGovernance: {
+            principles: [],
+            standards: [],
+            businessRules: [],
+        },
+    },
+};
+describe('runOrient', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mcpCallMock.mockResolvedValue(orientViewWithoutTask);
+    });
+    it('calls chain.getOrientView without task by default', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runOrient();
+        const output = writeSpy.mock.calls.map((call) => String(call[0])).join('');
+        writeSpy.mockRestore();
+        expect(mcpCallMock).toHaveBeenCalledWith('chain.getOrientView', {});
+        expect(output).toContain('Task grounding required');
+        expect(output).toContain('pb orient --task');
+    });
+    it('passes task through to chain.getOrientView and renders task context', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mcpCallMock.mockResolvedValueOnce(orientView);
+        await runOrient({ task: 'harden auth startup flow' });
+        const output = writeSpy.mock.calls.map((call) => String(call[0])).join('');
+        writeSpy.mockRestore();
+        expect(mcpCallMock).toHaveBeenCalledWith('chain.getOrientView', {
+            task: 'harden auth startup flow',
+        });
+        expect(output).toContain('## Task grounding');
+        expect(output).toContain('Status: grounded');
+        expect(output).toContain('## Binding governance');
+        expect(output).toContain('## Supporting context');
+        expect(output).toContain('STD-101');
+    });
+    it('renders task context even when governance buckets are empty', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mcpCallMock.mockResolvedValueOnce(orientViewTaskOnly);
+        await runOrient({ task: 'trace supporting context only' });
+        const output = writeSpy.mock.calls.map((call) => String(call[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('## Task grounding');
+        expect(output).toContain('2 relevant entries (high confidence)');
+    });
+    it('brief mode shows stage/count line and task grounding required without full headings', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runOrient({ brief: true });
+        const output = writeSpy.mock.calls.map((call) => String(call[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('grounded | 1 bets | 1 tensions');
+        expect(output).toContain('Task grounding required');
+        expect(output).not.toContain('## Active bets');
+    });
+    it('brief mode with task context renders startup grounding line', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        mcpCallMock.mockResolvedValueOnce(orientView);
+        await runOrient({ brief: true, task: 'harden auth startup flow' });
+        const output = writeSpy.mock.calls.map((call) => String(call[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('Task grounding: grounded');
+        expect(output).toContain('2 relevant entries');
+        expect(output).not.toContain('## Active bets');
+    });
+});
+//# sourceMappingURL=orient.test.js.map

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

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

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

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

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

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

package/dist/__tests__/profiles.test.js

@@ -0,0 +1,168 @@
+/**
+ * Profile system tests — WP-302 Slice 2.
+ * Tests: CRUD round-trip, auto-migration, resolution order,
+ * cannot-delete-active, session close on switch.
+ */
+import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { resolve } from 'path';
+// vi.hoisted runs before mock hoisting — safe to compute test paths here
+const { TEST_HOME, TEST_CONFIG_DIR, TEST_PROFILES_DIR, TEST_ACTIVE_PATH, TEST_LEGACY_PATH } = vi.hoisted(() => {
+    const os = require('os');
+    const path = require('path');
+    const home = path.resolve(os.tmpdir(), `pb-test-profiles-${process.pid}`);
+    return {
+        TEST_HOME: home,
+        TEST_CONFIG_DIR: path.resolve(home, '.config', 'productbrain'),
+        TEST_PROFILES_DIR: path.resolve(home, '.config', 'productbrain', 'profiles'),
+        TEST_ACTIVE_PATH: path.resolve(home, '.config', 'productbrain', 'active-profile'),
+        TEST_LEGACY_PATH: path.resolve(home, '.config', 'productbrain', '.env'),
+    };
+});
+vi.mock('os', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, homedir: () => TEST_HOME };
+});
+// Mock session to track close-on-switch
+const mockClearSession = vi.fn();
+let mockSessionState = null;
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSessionState,
+    writeSession: vi.fn(),
+    clearSession: mockClearSession,
+    addCapturedEntry: vi.fn(),
+}));
+// Import after mocks
+import { listProfiles, getActiveProfile, createProfile, useProfile, deleteProfile, resolveProfileConfig, } from '../lib/profiles.js';
+describe('profiles', () => {
+    beforeEach(() => {
+        // Clean slate
+        if (existsSync(TEST_CONFIG_DIR)) {
+            rmSync(TEST_CONFIG_DIR, { recursive: true, force: true });
+        }
+        mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+        delete process.env.PB_PROFILE;
+        mockSessionState = null;
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        if (existsSync(TEST_HOME)) {
+            rmSync(TEST_HOME, { recursive: true, force: true });
+        }
+    });
+    describe('CRUD round-trip', () => {
+        it('creates, lists, and deletes a profile', () => {
+            createProfile('staging', 'pb_sk_test_staging');
+            const profiles = listProfiles();
+            expect(profiles).toContain('staging');
+            // First profile becomes active
+            expect(getActiveProfile()).toBe('staging');
+            // Create a second profile so we can delete the first
+            createProfile('dev', 'pb_sk_test_dev');
+            useProfile('dev');
+            deleteProfile('staging');
+            expect(listProfiles()).not.toContain('staging');
+        });
+        it('rejects duplicate profile names', () => {
+            createProfile('myprofile', 'pb_sk_test');
+            expect(() => createProfile('myprofile', 'pb_sk_test2')).toThrow(/already exists/);
+        });
+        it('rejects invalid profile names', () => {
+            expect(() => createProfile('My Profile!', 'pb_sk_test')).toThrow(/Invalid profile name/);
+            expect(() => createProfile('', 'pb_sk_test')).toThrow(/Invalid profile name/);
+            expect(() => createProfile('-bad', 'pb_sk_test')).toThrow(/Invalid profile name/);
+        });
+    });
+    describe('auto-migration from legacy .env', () => {
+        it('migrates legacy .env to default profile on first resolveProfileConfig()', () => {
+            // Set up legacy .env (no profiles dir yet)
+            writeFileSync(TEST_LEGACY_PATH, 'PRODUCTBRAIN_API_KEY=pb_sk_legacy_key\nCONVEX_SITE_URL=https://test.convex.site\n');
+            const config = resolveProfileConfig();
+            expect(config).not.toBeNull();
+            expect(config.apiKey).toBe('pb_sk_legacy_key');
+            // Should have created the default profile
+            expect(existsSync(resolve(TEST_PROFILES_DIR, 'default.env'))).toBe(true);
+            expect(readFileSync(TEST_ACTIVE_PATH, 'utf8').trim()).toBe('default');
+        });
+        it('removes legacy .env if profiles dir already exists (TEN-1343)', () => {
+            mkdirSync(TEST_PROFILES_DIR, { recursive: true });
+            writeFileSync(TEST_LEGACY_PATH, 'PRODUCTBRAIN_API_KEY=pb_sk_legacy_key\n');
+            // Profiles dir exists — legacy .env gets deleted, not read
+            const config = resolveProfileConfig();
+            expect(config).toBeNull();
+            // Legacy .env must be gone
+            expect(existsSync(TEST_LEGACY_PATH)).toBe(false);
+            // Should NOT have created a default profile
+            expect(existsSync(resolve(TEST_PROFILES_DIR, 'default.env'))).toBe(false);
+        });
+    });
+    describe('resolution order', () => {
+        it('PB_PROFILE env var wins over active-profile file', () => {
+            createProfile('prod', 'pb_sk_prod_key');
+            createProfile('staging', 'pb_sk_staging_key');
+            useProfile('prod');
+            process.env.PB_PROFILE = 'staging';
+            const config = resolveProfileConfig();
+            expect(config.apiKey).toBe('pb_sk_staging_key');
+        });
+        it('active-profile file wins over default', () => {
+            createProfile('default', 'pb_sk_default_key');
+            createProfile('custom', 'pb_sk_custom_key');
+            useProfile('custom');
+            const config = resolveProfileConfig();
+            expect(config.apiKey).toBe('pb_sk_custom_key');
+        });
+        it('falls back to default profile when no active-profile file', () => {
+            mkdirSync(TEST_PROFILES_DIR, { recursive: true });
+            writeFileSync(resolve(TEST_PROFILES_DIR, 'default.env'), 'PRODUCTBRAIN_API_KEY=pb_sk_fallback\n', { mode: 0o600 });
+            const config = resolveProfileConfig();
+            expect(config.apiKey).toBe('pb_sk_fallback');
+        });
+    });
+    describe('cannot delete active profile', () => {
+        it('throws PROFILE_IS_ACTIVE error', () => {
+            createProfile('active-one', 'pb_sk_test');
+            createProfile('other', 'pb_sk_test2');
+            useProfile('active-one');
+            expect(() => deleteProfile('active-one')).toThrow(/Cannot delete the active profile/);
+        });
+    });
+    describe('cannot delete last profile', () => {
+        it('throws PROFILE_IS_LAST error', () => {
+            createProfile('only-one', 'pb_sk_test');
+            createProfile('other', 'pb_sk_test2');
+            useProfile('other');
+            deleteProfile('only-one');
+            // Now 'other' is the last profile — PROFILE_IS_LAST fires before PROFILE_IS_ACTIVE
+            expect(() => deleteProfile('other')).toThrow(/Cannot delete the last profile/);
+        });
+    });
+    describe('profile use', () => {
+        it('switches active profile', () => {
+            createProfile('first', 'pb_sk_first');
+            createProfile('second', 'pb_sk_second');
+            useProfile('second');
+            expect(getActiveProfile()).toBe('second');
+            useProfile('first');
+            expect(getActiveProfile()).toBe('first');
+        });
+        it('errors on non-existent profile', () => {
+            expect(() => useProfile('nonexistent')).toThrow(/does not exist/);
+        });
+    });
+    describe('profile file format', () => {
+        it('stores apiKey and optional siteUrl', () => {
+            createProfile('with-url', 'pb_sk_test', 'https://custom.convex.site');
+            const content = readFileSync(resolve(TEST_PROFILES_DIR, 'with-url.env'), 'utf8');
+            expect(content).toContain('PRODUCTBRAIN_API_KEY=pb_sk_test');
+            expect(content).toContain('CONVEX_SITE_URL=https://custom.convex.site');
+        });
+        it('omits siteUrl when not provided', () => {
+            createProfile('no-url', 'pb_sk_test');
+            const content = readFileSync(resolve(TEST_PROFILES_DIR, 'no-url.env'), 'utf8');
+            expect(content).toContain('PRODUCTBRAIN_API_KEY=pb_sk_test');
+            expect(content).not.toContain('CONVEX_SITE_URL');
+        });
+    });
+});
+//# sourceMappingURL=profiles.test.js.map

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

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

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

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

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

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

package/dist/__tests__/promote.test.js

@@ -0,0 +1,161 @@
+/**
+ * pb promote — verify mcpCallWithSession sequence and args.
+ * Covers: happy path (direct commit), governance proposal, no session, empty entryId.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { runPromote } from '../commands/promote.js';
+const mcpCallWithSessionMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    mcpCallWithSession: (...args) => mcpCallWithSessionMock(...args),
+}));
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+// Force pretty mode for all tests so formatPromoteReceipt output is tested
+vi.mock('../lib/runner.js', () => ({
+    isJsonMode: () => false,
+    runCliCommand: vi.fn(async ({ fn, formatPretty }) => {
+        const data = await fn();
+        process.stdout.write(formatPretty(data) + '\n');
+    }),
+}));
+let mockSession = { sessionId: 'sess-test' };
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+}));
+describe('runPromote', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSession = { sessionId: 'sess-test' };
+    });
+    it('calls chain.commitEntry with correct args (happy path)', async () => {
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ name: 'Test entry', collectionSlug: 'tensions', data: { description: 'Valid description' } })
+            .mockResolvedValueOnce([])
+            .mockResolvedValueOnce({
+            _id: 'j571abc',
+            entryId: 'TEN-951',
+            versionId: 'v123',
+            version: 1,
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runPromote({ entryId: 'TEN-951' });
+        writeSpy.mockRestore();
+        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.commitEntry', {
+            entryId: 'TEN-951',
+            author: 'agent:sess-test',
+            sessionId: 'sess-test',
+        });
+    });
+    it('passes commitMessage when --message is provided', async () => {
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ name: 'Test entry', collectionSlug: 'tensions', data: { description: 'Valid description' } })
+            .mockResolvedValueOnce([])
+            .mockResolvedValueOnce({
+            _id: 'j571abc',
+            entryId: 'TEN-951',
+            versionId: 'v123',
+            version: 1,
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runPromote({ entryId: 'TEN-951', message: 'Validated and ready' });
+        writeSpy.mockRestore();
+        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.commitEntry', {
+            entryId: 'TEN-951',
+            author: 'agent:sess-test',
+            sessionId: 'sess-test',
+            commitMessage: 'Validated and ready',
+        });
+    });
+    it('displays version result for direct commit', async () => {
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ name: 'Wave 2 smoke test', collectionSlug: 'tensions', data: { description: 'Valid description' } })
+            .mockResolvedValueOnce([])
+            .mockResolvedValueOnce({
+            _id: 'j571abc',
+            entryId: 'TEN-951',
+            name: 'Wave 2 smoke test',
+            versionId: 'v123',
+            version: 1,
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runPromote({ entryId: 'TEN-951' });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('Promoted TEN-951');
+        expect(output).toContain('draft');
+        expect(output).toContain('active');
+        expect(output).toContain('v1');
+    });
+    it('displays proposal result for governance mode', async () => {
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ name: 'Some governed decision', collectionSlug: 'decisions', data: { rationale: 'Valid description' } })
+            .mockResolvedValueOnce([])
+            .mockResolvedValueOnce({
+            status: 'proposal_created',
+            proposalId: 'prop-abc',
+            existing: false,
+            entryId: 'DEC-100',
+            name: 'Some governed decision',
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runPromote({ entryId: 'DEC-100' });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('Created proposal');
+        expect(output).toContain('DEC-100');
+        expect(output).toContain('governance mode');
+    });
+    it('displays quality warnings when present', async () => {
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ name: 'Test Bet', collectionSlug: 'bets', data: { description: 'Valid description' } })
+            .mockResolvedValueOnce([])
+            .mockResolvedValueOnce({
+            _id: 'j571abc',
+            entryId: 'BET-151',
+            name: 'Test Bet',
+            versionId: 'v123',
+            version: 1,
+            qualityVerdict: {
+                verdict: 'warn',
+                violations: ['Missing done-when criteria', 'No appetite set'],
+            },
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runPromote({ entryId: 'BET-151' });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('Quality warnings');
+        expect(output).toContain('Missing done-when criteria');
+        expect(output).toContain('No appetite set');
+    });
+    it('throws CLIError with no active session', async () => {
+        mockSession = null;
+        await expect(runPromote({ entryId: 'TEN-951' })).rejects.toThrow('No active session');
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+    });
+    it('throws CLIError with empty entryId', async () => {
+        await expect(runPromote({ entryId: '  ' })).rejects.toThrow('Entry ID is required');
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+    });
+    it('handles server errors thrown during commit', async () => {
+        mcpCallWithSessionMock.mockRejectedValue(new Error('Entry not found.'));
+        await expect(runPromote({ entryId: 'TEN-999' })).rejects.toThrow('Entry not found.');
+    });
+    it('blocks promote when semantic contradiction preflight finds a contradiction', async () => {
+        mcpCallWithSessionMock
+            .mockResolvedValueOnce({ name: 'Conflicting entry', collectionSlug: 'decisions', data: { rationale: 'Valid description' } })
+            .mockResolvedValueOnce([
+            {
+                chainEntryId: 'DEC-42',
+                chainEntryName: 'Existing decision',
+                type: 'contradiction',
+                confidence: 0.9,
+                explanation: 'Directly contradicts the approved baseline.',
+            },
+        ]);
+        await expect(runPromote({ entryId: 'DEC-100' })).rejects.toThrow('Commit blocked by contradiction with DEC-42: Directly contradicts the approved baseline.');
+        expect(mcpCallWithSessionMock).not.toHaveBeenCalledWith('chain.commitEntry', expect.anything());
+    });
+});
+//# sourceMappingURL=promote.test.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Tests for lib/prompts.ts — TTY-aware, cancel-safe prompt gate.
+ * WP-303 review fix: cover interactive guard paths and cancel behavior.
+ */
+export {};
+//# sourceMappingURL=prompts.test.d.ts.map

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

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