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

package/dist/__tests__/errors.test.js

@@ -0,0 +1,188 @@
+/**
+ * CLIError + McpError — unit tests.
+ * WP-302 Slice 0: Error Taxonomy + Commander Migration.
+ *
+ * Verifies:
+ * - CLIError serializes correctly with code, category, guidance
+ * - CLIError works with just a message (optional fields default)
+ * - McpError extends CLIError and retains backward compat
+ * - McpError maps server codes to categories
+ */
+import { describe, expect, it } from 'vitest';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { McpError } from '../lib/client.js';
+describe('CLIError', () => {
+    it('serializes all fields to JSON', () => {
+        const err = new CLIError('No API key configured', {
+            code: ErrorCode.AUTH_MISSING,
+            category: 'auth',
+            guidance: 'Run `pb login` to configure your API key.',
+        });
+        expect(err.message).toBe('No API key configured');
+        expect(err.code).toBe('AUTH_MISSING');
+        expect(err.category).toBe('auth');
+        expect(err.guidance).toBe('Run `pb login` to configure your API key.');
+        const json = err.toJSON();
+        expect(json).toEqual({
+            error: 'No API key configured',
+            code: 'AUTH_MISSING',
+            category: 'auth',
+            guidance: 'Run `pb login` to configure your API key.',
+        });
+    });
+    it('defaults to INTERNAL code and internal category when no options given', () => {
+        const err = new CLIError('Something broke');
+        expect(err.code).toBe('INTERNAL');
+        expect(err.category).toBe('internal');
+        expect(err.guidance).toBeUndefined();
+        const json = err.toJSON();
+        expect(json).toEqual({
+            error: 'Something broke',
+            code: 'INTERNAL',
+            category: 'internal',
+        });
+        // guidance should NOT appear in JSON when undefined
+        expect(json).not.toHaveProperty('guidance');
+    });
+    it('is an instance of Error', () => {
+        const err = new CLIError('test');
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.name).toBe('CLIError');
+    });
+    it('supports all defined error codes', () => {
+        // Verify the ErrorCode object has all expected keys
+        expect(ErrorCode.AUTH_MISSING).toBe('AUTH_MISSING');
+        expect(ErrorCode.AUTH_INVALID).toBe('AUTH_INVALID');
+        expect(ErrorCode.AUTH_DENIED).toBe('AUTH_DENIED');
+        expect(ErrorCode.NETWORK_UNREACHABLE).toBe('NETWORK_UNREACHABLE');
+        expect(ErrorCode.NETWORK_TIMEOUT).toBe('NETWORK_TIMEOUT');
+        expect(ErrorCode.CONFIG_MISSING).toBe('CONFIG_MISSING');
+        expect(ErrorCode.CONFIG_INVALID).toBe('CONFIG_INVALID');
+        expect(ErrorCode.SESSION_REQUIRED).toBe('SESSION_REQUIRED');
+        expect(ErrorCode.VALIDATION_FAILED).toBe('VALIDATION_FAILED');
+        expect(ErrorCode.UPGRADE_FAILED).toBe('UPGRADE_FAILED');
+        expect(ErrorCode.INTERNAL).toBe('INTERNAL');
+    });
+});
+describe('McpError', () => {
+    it('extends CLIError', () => {
+        const err = new McpError('Server error');
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err).toBeInstanceOf(McpError);
+        expect(err.name).toBe('McpError');
+    });
+    it('preserves backward-compatible interface (message, code, details)', () => {
+        const details = [
+            {
+                fieldKey: 'status',
+                fieldLabel: 'Status',
+                invalidValue: 'bogus',
+                validOptions: ['draft', 'active'],
+                errorType: 'invalid_option',
+                message: 'Invalid status value',
+            },
+        ];
+        const err = new McpError('Validation failed', 'VALIDATION_FAILED', details);
+        expect(err.message).toBe('Validation failed');
+        expect(err.code).toBe('VALIDATION_FAILED');
+        expect(err.details).toEqual(details);
+        expect(err.category).toBe('validation');
+    });
+    it('maps ARGUMENT_VALIDATION_FAILED to validation category (TEN-2647)', () => {
+        // Convex's own arg-validator rejection is a 400 the caller fixes by correcting
+        // the offending argument — never an internal fault.
+        const err = new McpError('ArgumentValidationError: Object is missing the required field `score`.', 'ARGUMENT_VALIDATION_FAILED');
+        expect(err.code).toBe('ARGUMENT_VALIDATION_FAILED');
+        expect(err.category).toBe('validation');
+    });
+    it('maps AUTH codes to auth category', () => {
+        const err = new McpError('Unauthorized', 'AUTH_DENIED');
+        expect(err.category).toBe('auth');
+    });
+    it('normalizes the server permission code to stable CLI AUTH_DENIED', () => {
+        const err = new McpError('Another team owns this record', 'AUTHZ_PERMISSION_DENIED');
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+    // WP-584 S4 review round 1 (P2-3): BR-227's own code — convex/http.ts's vendor-gate 403 —
+    // must normalize the SAME way, not fall through the `as` cast and publish Convex's raw
+    // internal code as a fake CLI ErrorCodeValue. Mirrors packages/mcp-server/src/errors.ts's
+    // own AUTHZ_* family test.
+    it('normalizes AUTHZ_INSUFFICIENT_ROLE (BR-227: active session, wrong role) to stable CLI AUTH_DENIED', () => {
+        const err = new McpError('Vendor access required.', 'AUTHZ_INSUFFICIENT_ROLE');
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+    it('normalizes any other AUTHZ_* code to stable CLI AUTH_DENIED (family match, not a fixed list)', () => {
+        const err = new McpError('Not a member.', 'AUTHZ_NOT_MEMBER');
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+    });
+    it('maps UNAUTHORIZED to auth category', () => {
+        const err = new McpError('Unauthorized', 'UNAUTHORIZED');
+        expect(err.category).toBe('auth');
+    });
+    it('maps SESSION_REQUIRED to session category', () => {
+        const err = new McpError('No session', 'SESSION_REQUIRED');
+        expect(err.category).toBe('session');
+    });
+    it('defaults to INTERNAL code and internal category when no code given', () => {
+        const err = new McpError('Unknown error');
+        expect(err.code).toBe('INTERNAL');
+        expect(err.category).toBe('internal');
+    });
+    it('serializes via toJSON from CLIError', () => {
+        const err = new McpError('Bad request', 'VALIDATION_FAILED');
+        const json = err.toJSON();
+        expect(json.error).toBe('Bad request');
+        expect(json.code).toBe('VALIDATION_FAILED');
+        expect(json.category).toBe('validation');
+    });
+});
+describe('McpError: an authority refusal in the gateway details (DEC-1851, Codex thread 1)', () => {
+    const routeTarget = { teamEntryId: 'team1', roleEntryId: 'role1', personIds: ['person1'] };
+    const requiredAction = 'This record is decided by Team Lead; ask Ada.';
+    it('turns the requiredAction into guidance and keeps requiredAction + routeTarget in the JSON authority field', () => {
+        const err = new McpError('Refused: you do not hold the role', 'role_not_owner', [{ requiredAction, routeTarget }]);
+        expect(err.guidance).toBe(requiredAction); // no chain id sent: no ask line, never the internal role id
+        expect(err.toJSON()).toMatchObject({ code: 'role_not_owner', guidance: requiredAction, authority: { requiredAction, routeTarget } });
+    });
+    it('ends with the ask line naming the deciding role, from the one constant the MCP prints too', () => {
+        const err = new McpError('Refused: you do not hold the role', 'role_not_owner', [{ requiredAction, routeTarget, decidingRoleRef: 'ROL-7' }]);
+        expect(err.guidance).toBe(`${requiredAction}\nNext: pb question create "<your ask>" --to-role ROL-7`);
+        expect(err.toJSON()).toMatchObject({ authority: { requiredAction, routeTarget, decidingRoleRef: 'ROL-7' } });
+    });
+    it('prints no ask line when the refusal sends no chain id for the role, never the internal id', () => {
+        const err = new McpError('Accept the team first.', 'ownership_inactive', [{ requiredAction: 'Accept the team first.', routeTarget }]);
+        expect(err.guidance).toBe('Accept the team first.');
+        expect(err.guidance).not.toContain('role1');
+    });
+    it('gives no ask line to a caller with another way in (its own seat, a bound key, a seat an agent holds)', () => {
+        const wayIn = { roleRef: 'ROL-7', roleName: 'Team Lead', teamRef: 'TEAM-2', teamName: 'Engineering' };
+        for (const extra of [{ wayIn }, { boundKey: true }, { heldByAgent: true }]) {
+            expect(new McpError('Refused', 'role_not_owner', [{ requiredAction, routeTarget, decidingRoleRef: 'ROL-7', ...extra }]).guidance).toBe(requiredAction);
+        }
+    });
+    it('leaves validation details, rate limits and detail-free errors untouched', () => {
+        const validation = new McpError('bad', 'VALIDATION_FAILED', [{ fieldKey: 'a', fieldLabel: 'A', invalidValue: 1, errorType: 'required', message: 'x' }]);
+        expect(validation.guidance).toBeUndefined();
+        expect(validation.toJSON()).not.toHaveProperty('authority');
+        expect(new McpError('x', 'rate-limited', [{ requiredAction }], 3).guidance).toMatch(/quota/);
+        expect(new McpError('x', 'role_not_owner').toJSON()).not.toHaveProperty('authority');
+    });
+});
+describe('McpError: a capture refused as a question names the question door (Voice-signed lines)', () => {
+    const ask = 'Next: pb question create "<your ask>" --to-role ROL-n';
+    it('a question routed by its prefix or collection: the Team Lead line, then the question door', () => {
+        const err = new McpError('Not captured: a captured question lands with your Team Lead.', 'VALIDATION_FAILED', [{ questionDoor: 'default' }]);
+        expect(err.message).toBe('Not captured: a captured question lands with your Team Lead.');
+        expect(err.guidance).toBe(ask);
+    });
+    it('a classifier pick into questions: the CLI flag that names another collection, then the question door', () => {
+        const err = new McpError('Not captured: this read as a question. Not one? Name its collection.', 'VALIDATION_FAILED', [{ questionDoor: 'classifier' }]);
+        expect(err.message).toBe('Not captured: this read as a question. Not one? Name its collection with --collection <slug>.');
+        expect(err.guidance).toBe(ask);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

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

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

package/dist/__tests__/fields.test.js

@@ -3,16 +3,17 @@
  * BET-181 Slice 2: Verifies field discovery via chain.getCollectionFields.
  *
  * Test contract:
- * 1. Mock mcpCall returns known field array → command outputs all field properties
+ * 1. Mock kernelCall returns known field array → command outputs all field properties
  * 2. Edge: collection with no fields → returns empty array, not error
  * 3. Error: invalid collection slug → actionable error message
  */
 import { beforeEach, afterEach, describe, expect, it, vi } from 'vitest';
 import { runFields } from '../commands/fields.js';
 import { setOutputMode } from '../lib/runner.js';
-const mcpCallMock = vi.fn();
+import { CLIError } from '../lib/errors.js';
+const kernelCallMock = vi.fn();
 vi.mock('../lib/client.js', () => ({
-    mcpCall: (...args) => mcpCallMock(...args),
+    kernelCall: (...args) => kernelCallMock(...args),
 }));
 vi.mock('../lib/config.js', () => ({
     getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
@@ -34,7 +35,7 @@ beforeEach(() => {
         return true;
     });
     exitSpy = vi.spyOn(process, 'exit').mockImplementation(() => { throw new Error('process.exit'); });
-    mcpCallMock.mockReset();
+    kernelCallMock.mockReset();
     // Force TTY mode so we get human-readable output in tests
     setOutputMode('pretty');
 });
@@ -75,7 +76,7 @@ const SAMPLE_FIELDS = [
 ];
 describe('runFields — TTY output with known field array', () => {
     it('outputs collection name and slug header', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -84,7 +85,7 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('Collection: Work Packages (work-packages)');
     });
     it('outputs all field keys', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -95,7 +96,7 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('elements');
     });
     it('outputs field type for each field', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -106,7 +107,7 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('rich-text');
     });
     it('outputs options for select fields', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -114,18 +115,29 @@ describe('runFields — TTY output with known field array', () => {
         await runFields({ collectionSlug: 'work-packages' });
         expect(stdoutOutput).toContain('small, medium, large');
     });
-    it('outputs helpText when present', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+    it('never echoes a field\'s own helpText (TASK-375, WP-770 GS2a: guidance now comes from bodyTemplate only)', async () => {
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
         });
         await runFields({ collectionSlug: 'work-packages' });
-        expect(stdoutOutput).toContain('How much time to invest');
-        expect(stdoutOutput).toContain('What problem are we solving?');
+        expect(stdoutOutput).not.toContain('How much time to invest');
+        expect(stdoutOutput).not.toContain('What problem are we solving?');
+    });
+    it('outputs the collection\'s bodyTemplate guidance when declared (TASK-375, WP-770 GS2a)', async () => {
+        kernelCallMock.mockResolvedValueOnce({
+            slug: 'work-packages',
+            name: 'Work Packages',
+            fields: SAMPLE_FIELDS,
+            bodyTemplate: [{ heading: 'Appetite', guidance: 'How much time to invest.' }],
+        });
+        await runFields({ collectionSlug: 'work-packages' });
+        expect(stdoutOutput).toContain('Body template');
+        expect(stdoutOutput).toContain('How much time to invest.');
     });
     it('outputs displayHint when present', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -134,7 +146,7 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('badge');
     });
     it('outputs zone when present', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -144,7 +156,7 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('body');
     });
     it('outputs semanticRole when present', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -156,7 +168,7 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('role:    elements');
     });
     it('marks required fields', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -166,19 +178,19 @@ describe('runFields — TTY output with known field array', () => {
         expect(stdoutOutput).toContain('appetite *');
     });
     it('calls chain.getCollectionFields with the correct slug', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'decisions',
             name: 'Decisions',
             fields: [],
         });
         await runFields({ collectionSlug: 'decisions' });
-        expect(mcpCallMock).toHaveBeenCalledWith('chain.getCollectionFields', { slug: 'decisions' });
+        expect(kernelCallMock).toHaveBeenCalledWith('chain.getCollectionFields', { slug: 'decisions' });
     });
 });
 describe('runFields — JSON mode', () => {
     it('outputs JSON with full field array when piped', async () => {
         setOutputMode('json');
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'work-packages',
             name: 'Work Packages',
             fields: SAMPLE_FIELDS,
@@ -201,7 +213,7 @@ describe('runFields — JSON mode', () => {
 });
 describe('runFields — edge: empty fields array', () => {
     it('returns "No fields defined" message, does not error', async () => {
-        mcpCallMock.mockResolvedValueOnce({
+        kernelCallMock.mockResolvedValueOnce({
             slug: 'notes',
             name: 'Notes',
             fields: [],
@@ -213,26 +225,25 @@ describe('runFields — edge: empty fields array', () => {
     });
 });
 describe('runFields — error: invalid collection slug', () => {
-    it('outputs actionable error message and exits 1', async () => {
-        mcpCallMock.mockResolvedValueOnce(null);
-        await expect(runFields({ collectionSlug: 'nonexistent-slug' })).rejects.toThrow('process.exit');
-        expect(exitSpy).toHaveBeenCalledWith(1);
-        expect(stderrOutput).toContain("nonexistent-slug");
-        expect(stderrOutput).toContain('not found');
-    });
-    it('includes suggestion to use a valid slug in error message', async () => {
-        mcpCallMock.mockResolvedValueOnce(null);
-        await expect(runFields({ collectionSlug: 'bad-slug' })).rejects.toThrow('process.exit');
-        expect(stderrOutput).toContain('valid collection slug');
-    });
-    it('outputs JSON error in JSON mode for invalid slug', async () => {
+    it('throws CLIError with actionable message for invalid slug', async () => {
+        kernelCallMock.mockResolvedValueOnce(null);
+        const err = await runFields({ collectionSlug: 'nonexistent-slug' }).catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.message).toContain('nonexistent-slug');
+        expect(err.message).toContain('not found');
+    });
+    it('includes suggestion to use a valid slug in guidance', async () => {
+        kernelCallMock.mockResolvedValueOnce(null);
+        const err = await runFields({ collectionSlug: 'bad-slug' }).catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.guidance).toContain('valid collection slug');
+    });
+    it('throws CLIError in JSON mode for invalid slug', async () => {
         setOutputMode('json');
-        mcpCallMock.mockResolvedValueOnce(null);
-        await expect(runFields({ collectionSlug: 'bad-slug' })).rejects.toThrow('process.exit');
-        expect(exitSpy).toHaveBeenCalledWith(1);
-        const errParsed = JSON.parse(stderrOutput);
-        expect(errParsed).toHaveProperty('error');
-        expect(errParsed.error).toContain('bad-slug');
+        kernelCallMock.mockResolvedValueOnce(null);
+        const err = await runFields({ collectionSlug: 'bad-slug' }).catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.message).toContain('bad-slug');
     });
 });
 //# sourceMappingURL=fields.test.js.map

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

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

package/dist/__tests__/gateway-dry-run-timeout.test.d.ts

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

package/dist/__tests__/gateway-dry-run-timeout.test.d.ts.map

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

package/dist/__tests__/gateway-dry-run-timeout.test.js

@@ -0,0 +1,70 @@
+/**
+ * gateway-dry-run-timeout.test.ts — PR #533 review, Codex P2 (WP-575, TEN-2917).
+ *
+ * The CLI half of "a dry run that times out did not write anything"; packages/mcp-server has
+ * the mirror. Both halves exist on purpose rather than one shared test: the failure mode this
+ * work package removed was the two connectors DISAGREEING, so each connector's own suite has
+ * to fail when ITS copy goes stale — and mcp-server cannot import from here anyway (DEC-701).
+ *
+ * `pb capture` never sends `preview: true` today and says so explicitly
+ * (../commands/capture.ts:445-450), so there is no live CLI defect here. That is exactly why
+ * the test exists: the derivation is kept identical on both sides BEFORE a CLI preview flag
+ * lands, rather than after the two connectors have already drifted apart again.
+ */
+import { describe, expect, it } from 'vitest';
+import { gatewayTimeoutError, isDryRunCall, mayHaveLandedOnTimeout, routeMayMutate } from '../lib/gatewayTimeout.js';
+import { ErrorCode } from '../lib/errors.js';
+/** Mirrored VERBATIM from packages/mcp-server/src/__tests__/gateway-dry-run-timeout.test.ts. */
+const DRY_RUN_PARITY_CASES = [
+    ['chain.createEntry', { preview: true }, false],
+    ['chain.createEntry', {}, true],
+    ['chain.commitEntry', { preview: true }, false],
+    ['chain.commitEntry', {}, true],
+    ['chain.searchEntries', {}, false],
+    ['not.a.real.route', { preview: true }, false],
+    ['not.a.real.route', {}, true],
+];
+describe('connector parity table — mirrored verbatim in the mcp-server suite', () => {
+    it.each(DRY_RUN_PARITY_CASES)('%s -> mayHaveLanded=%o', (fn, args, expected) => {
+        expect(mayHaveLandedOnTimeout(fn, args)).toBe(expected);
+    });
+});
+describe('isDryRunCall', () => {
+    it('recognises only an explicit preview:true', () => {
+        expect(isDryRunCall({ preview: true })).toBe(true);
+        expect(isDryRunCall({ preview: false })).toBe(false);
+        expect(isDryRunCall({})).toBe(false);
+        expect(isDryRunCall(undefined)).toBe(false);
+        expect(isDryRunCall(null)).toBe(false);
+    });
+    it('does not treat a truthy non-true preview as a dry run', () => {
+        // The server validator is v.optional(v.boolean()), so anything else is a caller bug — and
+        // guessing "dry run" from it would claim nothing landed when something might have.
+        expect(isDryRunCall({ preview: 'yes' })).toBe(false);
+        expect(isDryRunCall({ preview: 1 })).toBe(false);
+    });
+});
+describe('gatewayTimeoutError guidance', () => {
+    it('tells a dry run nothing was written, without the duplicate-write warning', () => {
+        const err = gatewayTimeoutError('chain.createEntry', 30_000, { preview: true });
+        expect(err.code).toBe(ErrorCode.NETWORK_TIMEOUT);
+        expect(err.guidance).toMatch(/preview/i);
+        expect(err.guidance).toMatch(/safe to retry/i);
+        expect(err.guidance).not.toMatch(/duplicate/i);
+    });
+    it('still warns on a real write — the fail-safe is unchanged', () => {
+        const err = gatewayTimeoutError('chain.createEntry', 30_000, {});
+        expect(err.guidance).toMatch(/may have\s+COMPLETED anyway/i);
+        expect(err.guidance).toMatch(/duplicate the write/i);
+    });
+    it('an unknown route with no args still fails safe to "may have landed"', () => {
+        expect(routeMayMutate('not.a.real.route')).toBe(true);
+        expect(gatewayTimeoutError('not.a.real.route', 30_000).guidance).toMatch(/duplicate the write/i);
+    });
+    it('a read route says nothing was written, and does not claim it was a preview', () => {
+        const err = gatewayTimeoutError('chain.searchEntries', 10_000, {});
+        expect(err.guidance).toMatch(/this is a read/i);
+        expect(err.guidance).not.toMatch(/preview/i);
+    });
+});
+//# sourceMappingURL=gateway-dry-run-timeout.test.js.map

package/dist/__tests__/gateway-dry-run-timeout.test.js.map

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

package/dist/__tests__/gateway-timeout-body-phase.test.d.ts

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

package/dist/__tests__/gateway-timeout-body-phase.test.d.ts.map

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