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

package/dist/__tests__/rate-limit-resilience.test.js

@@ -0,0 +1,209 @@
+/**
+ * WP-579 — rate-limit resilience: touch throttle + backoff/retry (TEN-2923, TEN-2924).
+ *
+ * Mirrors the mock/module-mock conventions of envelope-contract.test.ts.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// ─── Module mocks (must precede imports that trigger side effects) ────────────
+vi.mock('../lib/config.js', () => ({
+    getConfig: vi.fn(() => ({
+        apiKey: 'pb_sk_test',
+        siteUrl: 'https://example.convex.site',
+    })),
+}));
+vi.mock('../lib/adminConfig.js', () => ({
+    resolveAdminConfig: vi.fn(),
+}));
+let mockSession = { sessionId: 'session-1' };
+vi.mock('../lib/session.js', () => ({
+    readSession: vi.fn(() => mockSession),
+    writeSession: vi.fn(),
+    clearSession: vi.fn(),
+    addCapturedEntry: vi.fn(),
+}));
+vi.mock('../lib/spinner.js', () => ({
+    withSpinner: vi.fn((_label, fn) => fn()),
+}));
+vi.mock('../lib/update-check.js', () => ({
+    recordServerLatest: vi.fn(),
+}));
+// ─── Imports (after mocks) ────────────────────────────────────────────────────
+import { kernelCall, kernelCallWithSession, resetTouchThrottle } from '../lib/client.js';
+function successResponse(data = {}) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: 'OK',
+        json: async () => ({ ok: true, data }),
+        headers: { get: () => null },
+    };
+}
+function rateLimitedResponse(retryAfterSeconds) {
+    return {
+        ok: false,
+        status: 429,
+        statusText: 'Too Many Requests',
+        json: async () => ({
+            ok: false,
+            code: 'rate-limited',
+            message: `Rate limit exceeded for this API key. Retry after ${retryAfterSeconds}s.`,
+            retryAfterSeconds,
+        }),
+        headers: { get: (name) => (name === 'Retry-After' ? String(retryAfterSeconds) : null) },
+    };
+}
+function validationFailedResponse() {
+    return {
+        ok: false,
+        status: 400,
+        statusText: 'Bad Request',
+        json: async () => ({ ok: false, code: 'VALIDATION_FAILED', message: 'Bad input' }),
+        headers: { get: () => null },
+    };
+}
+// Two describes below switch on fake timers. Restore real ones after every test so timer
+// state can't leak into a later test in this file (the throttle describe runs first today,
+// but that ordering is not a contract).
+afterEach(() => {
+    vi.useRealTimers();
+});
+describe('kernelCallWithSession — touch throttle (TEN-2923)', () => {
+    let fetchCalls = [];
+    beforeEach(() => {
+        vi.clearAllMocks();
+        resetTouchThrottle();
+        mockSession = { sessionId: 'session-1' };
+        fetchCalls = [];
+        global.fetch = vi.fn(async (_url, init) => {
+            const body = JSON.parse(String(init?.body ?? '{}'));
+            fetchCalls.push(body.fn ?? '');
+            if (body.fn === 'agent.touchSession')
+                return successResponse();
+            return successResponse({ ok: true });
+        });
+    });
+    it('does not send a touchSession call within 5s of the previous one for the same session', async () => {
+        await kernelCallWithSession('chain.createEntry', {});
+        await kernelCallWithSession('chain.createEntry', {});
+        const touchCalls = fetchCalls.filter((fn) => fn === 'agent.touchSession');
+        expect(touchCalls).toHaveLength(1);
+    });
+    it('isolates the throttle window per session id', async () => {
+        mockSession = { sessionId: 'session-a' };
+        await kernelCallWithSession('chain.createEntry', {});
+        mockSession = { sessionId: 'session-b' };
+        await kernelCallWithSession('chain.createEntry', {});
+        const touchCalls = fetchCalls.filter((fn) => fn === 'agent.touchSession');
+        expect(touchCalls).toHaveLength(2);
+    });
+});
+describe('kernelCall — bounded retry on 429 rate-limited (TEN-2924)', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers();
+    });
+    it('retries a rate-limited call once the server-given wait elapses, and succeeds', async () => {
+        let callCount = 0;
+        global.fetch = vi.fn(async () => {
+            callCount += 1;
+            return callCount === 1 ? rateLimitedResponse(1) : successResponse({ id: 'ENT-1' });
+        });
+        const resultPromise = kernelCall('chain.getEntry', {});
+        await vi.advanceTimersByTimeAsync(2000);
+        const result = await resultPromise;
+        expect(result).toEqual({ id: 'ENT-1' });
+        expect(callCount).toBe(2);
+    });
+    it('never retries a non-rate-limited failure (e.g. VALIDATION_FAILED)', async () => {
+        let callCount = 0;
+        global.fetch = vi.fn(async () => {
+            callCount += 1;
+            return validationFailedResponse();
+        });
+        await expect(kernelCall('chain.createEntry', {})).rejects.toThrow('Bad input');
+        expect(callCount).toBe(1);
+    });
+    it('gives up after the bounded retry cap and surfaces the rate-limited error', async () => {
+        let callCount = 0;
+        global.fetch = vi.fn(async () => {
+            callCount += 1;
+            return rateLimitedResponse(1);
+        });
+        const resultPromise = kernelCall('chain.getEntry', {}).catch((err) => err);
+        // Advance past every possible retry wait.
+        await vi.advanceTimersByTimeAsync(20_000);
+        const err = await resultPromise;
+        expect(err).toBeInstanceOf(Error);
+        expect(err.message).toContain('Rate limit exceeded');
+        // Bounded: the initial attempt plus at most 3 retries, never unbounded.
+        expect(callCount).toBeLessThanOrEqual(4);
+        expect(callCount).toBeGreaterThan(1);
+    });
+    it('does not sit on a day-window Retry-After — surfaces it instead of sleeping for hours', async () => {
+        let callCount = 0;
+        global.fetch = vi.fn(async () => {
+            callCount += 1;
+            // The server clamps a day-window denial to the full window (86_400s).
+            return rateLimitedResponse(86_400);
+        });
+        const err = await kernelCall('chain.getEntry', {}).catch((e) => e);
+        expect(err).toBeInstanceOf(Error);
+        expect(err.message).toContain('Rate limit exceeded');
+        // Failed fast on the first attempt — no timer was ever armed.
+        expect(callCount).toBe(1);
+        expect(vi.getTimerCount()).toBe(0);
+    });
+});
+describe('kernelCallWithSession — background calls opt out of retry (TEN-2924)', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers();
+        resetTouchThrottle();
+        mockSession = { sessionId: 'session-1' };
+    });
+    it('never arms a retry timer when retryOnRateLimit is false', async () => {
+        let callCount = 0;
+        global.fetch = vi.fn(async () => {
+            callCount += 1;
+            return rateLimitedResponse(1);
+        });
+        const err = await kernelCallWithSession('chain.recordGroundingOutcome', {}, { retryOnRateLimit: false }).catch((e) => e);
+        expect(err).toBeInstanceOf(Error);
+        // One attempt, and crucially no pending timer left holding the event loop open.
+        expect(callCount).toBe(1);
+        expect(vi.getTimerCount()).toBe(0);
+    });
+    // Codex round 2 found capture.ts was not the only detached call site. Sweep of every
+    // kernelCall* whose promise is neither awaited nor returned: capture.ts (grounding),
+    // brief.ts (recordBriefRun), handshake.ts x2 (drift + collision TENs). All four now opt
+    // out. This pins the class rather than the instances — a detached call that keeps the
+    // retry arms timers that outlive the command's foreground work.
+    it('arms no timer for kernelCall either — the detached brief.ts/handshake.ts shape', async () => {
+        let callCount = 0;
+        global.fetch = vi.fn(async () => {
+            callCount += 1;
+            return rateLimitedResponse(1);
+        });
+        const err = await kernelCall('chain.recordBriefRun', {}, { retryOnRateLimit: false }).catch((e) => e);
+        expect(err).toBeInstanceOf(Error);
+        expect(callCount).toBe(1);
+        expect(vi.getTimerCount()).toBe(0);
+    });
+    it('still retries by default when no options are passed', async () => {
+        // Count only the gateway call — kernelCallWithSession also fires an unawaited
+        // agent.touchSession afterwards, which would race a bare counter.
+        let writeCalls = 0;
+        global.fetch = vi.fn(async (_url, init) => {
+            const body = JSON.parse(String(init?.body ?? '{}'));
+            if (body.fn === 'agent.touchSession')
+                return successResponse();
+            writeCalls += 1;
+            return writeCalls === 1 ? rateLimitedResponse(1) : successResponse({ id: 'ENT-2' });
+        });
+        const resultPromise = kernelCallWithSession('chain.createEntry', {});
+        await vi.advanceTimersByTimeAsync(2000);
+        expect(await resultPromise).toEqual({ id: 'ENT-2' });
+        expect(writeCalls).toBe(2);
+    });
+});
+//# sourceMappingURL=rate-limit-resilience.test.js.map

package/dist/__tests__/rate-limit-resilience.test.js.map

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

package/dist/__tests__/relate.test.js

@@ -1,12 +1,12 @@
 /**
- * pb relate / pb unrelate — verify mcpCallWithSession sequence and args.
+ * pb relate / pb unrelate — verify kernelCallWithSession sequence and args.
  * TEN-341 test contract: happy paths, no session.
  */
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { runRelate, runUnrelate } from '../commands/relate.js';
-const mcpCallWithSessionMock = vi.fn();
+const kernelCallWithSessionMock = vi.fn();
 vi.mock('../lib/client.js', () => ({
-    mcpCallWithSession: (...args) => mcpCallWithSessionMock(...args),
+    kernelCallWithSession: (...args) => kernelCallWithSessionMock(...args),
 }));
 vi.mock('../lib/config.js', () => ({
     getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
@@ -19,11 +19,11 @@ describe('runRelate', () => {
     beforeEach(() => {
         vi.clearAllMocks();
         mockSession = { sessionId: 'sess-test' };
-        mcpCallWithSessionMock.mockResolvedValue({});
+        kernelCallWithSessionMock.mockResolvedValue({});
     });
     it('calls chain.createEntryRelation with correct args', async () => {
         await runRelate({ fromId: 'BET-151', type: 'informed_by', toId: 'DEC-264' });
-        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
             fromEntryId: 'BET-151',
             toEntryId: 'DEC-264',
             type: 'informed_by',
@@ -31,7 +31,7 @@ describe('runRelate', () => {
     });
     it('passes ifMissing=true when --if-missing flag is set', async () => {
         await runRelate({ fromId: 'BET-151', type: 'part_of', toId: 'FEAT-77', ifMissing: true });
-        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
             fromEntryId: 'BET-151',
             toEntryId: 'FEAT-77',
             type: 'part_of',
@@ -40,14 +40,14 @@ describe('runRelate', () => {
     });
     it('does not pass ifMissing when flag is not set', async () => {
         await runRelate({ fromId: 'BET-151', type: 'part_of', toId: 'FEAT-77' });
-        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.createEntryRelation', {
             fromEntryId: 'BET-151',
             toEntryId: 'FEAT-77',
             type: 'part_of',
         });
     });
     it('handles alreadyExists=true response gracefully and reflects it in output', async () => {
-        mcpCallWithSessionMock.mockResolvedValue({ alreadyExists: true });
+        kernelCallWithSessionMock.mockResolvedValue({ alreadyExists: true });
         const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
         await runRelate({ fromId: 'BET-151', type: 'part_of', toId: 'FEAT-77', ifMissing: true });
         const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
@@ -56,7 +56,7 @@ describe('runRelate', () => {
         expect(output).toContain('alreadyExists');
     });
     it('surfaces proposal_created when backend returns a proposal instead of a relation', async () => {
-        mcpCallWithSessionMock.mockResolvedValue({
+        kernelCallWithSessionMock.mockResolvedValue({
             status: 'proposal_created',
             proposalId: 'prop-123',
             fromEntryId: 'STD-2',
@@ -73,22 +73,50 @@ describe('runRelate', () => {
     it('throws CLIError with no active session', async () => {
         mockSession = null;
         await expect(runRelate({ fromId: 'A', type: 'x', toId: 'B' })).rejects.toThrow('No active session');
-        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalled();
     });
     it('throws CLIError with empty args', async () => {
         await expect(runRelate({ fromId: '', type: 'x', toId: 'B' })).rejects.toThrow('All arguments required');
-        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalled();
+    });
+    // WP-625 (S3 of WP-618, DEC-1546, TEN-3037): the relate door's advisory legality + altitude
+    // findings must survive the CLI's closed cast + field list + printer — the whole point of
+    // this slice's CLI deliverable.
+    it('surfaces the relate door\'s advisories in the pretty-printed receipt', async () => {
+        kernelCallWithSessionMock.mockResolvedValue({
+            advisories: [{
+                    ruleId: 'REL-LEGAL-1',
+                    ruleText: 'REL-LEGAL-1: relation type "depends_on" is not declared valid for "vision" (declared: informs, governs, belongs_to).',
+                    severity: 'advisory',
+                    stage: 'discovering',
+                }],
+        });
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runRelate({ fromId: 'STR-1', type: 'depends_on', toId: 'STR-2' });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).toContain('REL-LEGAL-1');
+        expect(output).toContain('not declared valid for');
+        expect(output).toContain('vision');
+    });
+    it('omits advisories from the output when the backend returns none', async () => {
+        kernelCallWithSessionMock.mockResolvedValue({});
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        await runRelate({ fromId: 'BET-151', type: 'informed_by', toId: 'DEC-264' });
+        const output = writeSpy.mock.calls.map(c => String(c[0])).join('');
+        writeSpy.mockRestore();
+        expect(output).not.toContain('advisories');
     });
 });
 describe('runUnrelate', () => {
     beforeEach(() => {
         vi.clearAllMocks();
         mockSession = { sessionId: 'sess-test' };
-        mcpCallWithSessionMock.mockResolvedValue({});
+        kernelCallWithSessionMock.mockResolvedValue({});
     });
     it('calls chain.removeEntryRelation with correct args', async () => {
         await runUnrelate({ fromId: 'BET-151', type: 'part_of', toId: 'FEAT-77' });
-        expect(mcpCallWithSessionMock).toHaveBeenCalledWith('chain.removeEntryRelation', {
+        expect(kernelCallWithSessionMock).toHaveBeenCalledWith('chain.removeEntryRelation', {
             fromEntryId: 'BET-151',
             toEntryId: 'FEAT-77',
             type: 'part_of',
@@ -97,7 +125,7 @@ describe('runUnrelate', () => {
     it('throws CLIError with no active session', async () => {
         mockSession = null;
         await expect(runUnrelate({ fromId: 'A', type: 'x', toId: 'B' })).rejects.toThrow('No active session');
-        expect(mcpCallWithSessionMock).not.toHaveBeenCalled();
+        expect(kernelCallWithSessionMock).not.toHaveBeenCalled();
     });
 });
 //# sourceMappingURL=relate.test.js.map

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

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

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

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

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

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

package/dist/__tests__/restore.test.js

@@ -0,0 +1,85 @@
+/**
+ * pb restore — sweep finding #5: gateway AUTH_DENIED errors (e.g. a delegated-credential
+ * deny-by-default) must survive as AUTH_DENIED, not be rewritten to VALIDATION_FAILED.
+ * Mirrors update.test.ts's "preserves a server authority refusal" coverage for runUpdate.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { runRestore } from '../commands/restore.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+const kernelCallWithSessionMock = vi.fn();
+vi.mock('../lib/client.js', () => ({
+    kernelCallWithSession: (...args) => kernelCallWithSessionMock(...args),
+    // McpError exported so restore.ts can import the type (not used at runtime in tests).
+    McpError: class McpError extends Error {
+        code;
+        guidance;
+        constructor(message, code) {
+            super(message);
+            this.name = 'McpError';
+            this.code = code;
+        }
+    },
+}));
+/** The restore command checks `err.name === 'McpError'`, so any Error with that name works. */
+function makeMcpError(message, code, guidance) {
+    const err = new Error(message);
+    err.name = 'McpError';
+    err.code = code;
+    err.guidance = guidance;
+    return err;
+}
+vi.mock('../lib/config.js', () => ({
+    getConfigOrGuide: vi.fn(() => Promise.resolve({ apiKey: 'pb_sk_test', siteUrl: 'https://test.convex.site' })),
+}));
+vi.mock('../lib/runner.js', () => ({
+    isJsonMode: () => false,
+}));
+let mockSession = { sessionId: 'sess-test' };
+vi.mock('../lib/session.js', () => ({
+    readSession: () => mockSession,
+}));
+describe('runRestore', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockSession = { sessionId: 'sess-test' };
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('preserves a gateway AUTHZ_PERMISSION_DENIED error as machine-readable AUTH_DENIED (not VALIDATION_FAILED)', async () => {
+        kernelCallWithSessionMock.mockRejectedValue(makeMcpError('Delegated credentials cannot restore records.', 'AUTHZ_PERMISSION_DENIED', 'Ask an authorized principal to restore this record.'));
+        const err = await runRestore('DEC-1').catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+    it('preserves a gateway AUTH_DENIED error code as machine-readable AUTH_DENIED', async () => {
+        kernelCallWithSessionMock.mockRejectedValue(makeMcpError('Not authorized.', ErrorCode.AUTH_DENIED));
+        const err = await runRestore('DEC-1').catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+    it('falls back to VALIDATION_FAILED for a non-authority gateway error', async () => {
+        kernelCallWithSessionMock.mockRejectedValue(makeMcpError('Entry not found.', 'NOT_FOUND'));
+        const err = await runRestore('DEC-999').catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.code).toBe(ErrorCode.VALIDATION_FAILED);
+        expect(err.category).toBe('validation');
+    });
+    it('preserves a returned (non-throwing) organisational refusal as AUTH_DENIED', async () => {
+        kernelCallWithSessionMock.mockResolvedValue({
+            outcome: 'refused',
+            refusal: {
+                code: 'role_not_owner',
+                reason: 'This person does not hold this record’s exact owning role in its owning team.',
+                requiredAction: 'Route this change to a holder of the record’s exact owning role.',
+            },
+        });
+        const err = await runRestore('DEC-1').catch((e) => e);
+        expect(err).toBeInstanceOf(CLIError);
+        expect(err.code).toBe(ErrorCode.AUTH_DENIED);
+        expect(err.category).toBe('auth');
+    });
+});
+//# sourceMappingURL=restore.test.js.map

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

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

package/dist/__tests__/route-latency-budget.test.d.ts

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

package/dist/__tests__/route-latency-budget.test.d.ts.map

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

package/dist/__tests__/route-latency-budget.test.js

@@ -0,0 +1,103 @@
+/**
+ * route-latency-budget.test.ts — WP-575 (TEN-2917, TEN-1126), commits_to DEC-64.
+ *
+ * WP-575's acceptance: "Unit coverage for budget derivation from route type, asserted for
+ * BOTH connectors so they cannot drift." This is the CLI half; 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 — a single test in one package would let the other
+ * drift with a green suite.
+ *
+ * Drift is checked against the generator's own `resolveGeneratedContent`, imported from the
+ * generator itself so test and codegen can never disagree about what the rule is (INS-2177:
+ * fingerprint the rule, not the instance — and the concrete failure that lesson comes from,
+ * a test that hand-rebuilt the banner and silently stripped it on every run).
+ *
+ * On failure: `npm run route-budget:codegen` from the repo root, commit both regenerated
+ * files.
+ */
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// @ts-expect-error — plain .mjs module without type declarations
+import { resolveGeneratedContent, DESTS } from '../../../../scripts/generate-route-latency-budget.mjs';
+import { ROUTE_LATENCY_BUDGET_MS, ROUTE_LATENCY_BUDGET_OVERRIDE_MS, ROUTE_TYPE_BY_NAME, WIDEST_ROUTE_LATENCY_BUDGET_MS, latencyBudgetMsForRoute, latencyBudgetMsForRouteType, } from '../generated/routeLatencyBudget.generated.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = join(__dirname, '..', '..', '..', '..');
+describe('route latency budget — CLI generated copy (WP-575)', () => {
+    it('matches what the generator would emit right now', () => {
+        const expected = resolveGeneratedContent(REPO_ROOT);
+        const committed = readFileSync(join(REPO_ROOT, 'packages/cli/src/generated/routeLatencyBudget.generated.ts'), 'utf8');
+        expect(committed).toBe(expected);
+    });
+    it('is byte-identical to the mcp-server copy — the two connectors cannot disagree', () => {
+        const contents = DESTS.map((d) => readFileSync(join(REPO_ROOT, d), 'utf8'));
+        expect(contents).toHaveLength(2);
+        expect(contents[0]).toBe(contents[1]);
+    });
+});
+describe('route latency budget — derivation from route type (WP-575)', () => {
+    it('gives action routes DEC-64\'s 30s background anchor', () => {
+        // Actions are the only Convex function kind that can reach an external service, so
+        // they are the only ones that can be waiting on an LLM. That is why DEC-64's
+        // background anchor applies to them and not to the other two.
+        expect(latencyBudgetMsForRouteType('action')).toBe(30_000);
+        expect(ROUTE_LATENCY_BUDGET_MS.action).toBe(30_000);
+    });
+    it('keeps queries and mutations on the tight budget — neither can reach an LLM', () => {
+        expect(latencyBudgetMsForRouteType('query')).toBe(10_000);
+        expect(latencyBudgetMsForRouteType('mutation')).toBe(10_000);
+    });
+    it('gives chain.createEntry the action budget — the route the defect was reported on', () => {
+        // The bug: a blanket 10s abort on a route whose real round-trip is 14-20s, so MCP
+        // reported hard failures on writes that had SUCCEEDED. Its registry type is `action`,
+        // so the derived budget must now exceed that measured round-trip.
+        expect(ROUTE_TYPE_BY_NAME['chain.createEntry']).toBe('action');
+        expect(latencyBudgetMsForRoute('chain.createEntry')).toBe(30_000);
+        expect(latencyBudgetMsForRoute('chain.createEntry')).toBeGreaterThan(20_000);
+    });
+    it('fails SAFE on an unknown route name — widest budget, never the tightest, never a throw', () => {
+        // Guessing low on an unclassifiable route would abort a call still legitimately in
+        // flight and re-create the exact false-failure this work package removed.
+        expect(latencyBudgetMsForRoute('not.a.real.route')).toBe(WIDEST_ROUTE_LATENCY_BUDGET_MS);
+        expect(WIDEST_ROUTE_LATENCY_BUDGET_MS).toBe(Math.max(...Object.values(ROUTE_LATENCY_BUDGET_MS), ...Object.values(ROUTE_LATENCY_BUDGET_OVERRIDE_MS)));
+    });
+    it('resolves inherited Object.prototype names to the fail-safe, not a truthy member', () => {
+        // PR #533 review, Codex P2. A plain-object map returns a FUNCTION for these names, so
+        // the truthiness check took the "known route" branch and produced an undefined budget —
+        // `AbortSignal.timeout(undefined)` THROWS, turning the fail-safe into a hard failure
+        // before the call ever left the process. The SSOT scans an array and never had this
+        // hole, so the copy also DISAGREED with the source it is generated from.
+        for (const name of ['toString', 'constructor', 'valueOf', 'hasOwnProperty', '__proto__']) {
+            expect(latencyBudgetMsForRoute(name)).toBe(WIDEST_ROUTE_LATENCY_BUDGET_MS);
+            // The real consequence, asserted directly: this must not throw.
+            expect(() => AbortSignal.timeout(latencyBudgetMsForRoute(name))).not.toThrow();
+        }
+    });
+    it('gives the two long-deadline actions their declared per-route budgets', () => {
+        // PR #533 review, Codex P1 — the flat action budget was tighter than these routes'
+        // own server-side deadlines, so the connector would abort a call the server was still
+        // legitimately working on. See the SSOT for the citation behind each number.
+        expect(latencyBudgetMsForRoute('onboarding.chat')).toBeGreaterThan(45_000);
+        expect(latencyBudgetMsForRoute('quality.spineCheck')).toBeGreaterThan(5 * 60_000);
+    });
+    it('carries the whole route registry, not a sampled subset', () => {
+        const names = Object.keys(ROUTE_TYPE_BY_NAME);
+        expect(names.length).toBeGreaterThan(200);
+        // Every value must be one of the three real kinds — a partial or malformed map would
+        // silently hand action routes the tight budget.
+        for (const type of Object.values(ROUTE_TYPE_BY_NAME)) {
+            expect(['query', 'mutation', 'action']).toContain(type);
+        }
+        expect(names.some((n) => ROUTE_TYPE_BY_NAME[n] === 'action')).toBe(true);
+        expect(names.some((n) => ROUTE_TYPE_BY_NAME[n] === 'query')).toBe(true);
+        expect(names.some((n) => ROUTE_TYPE_BY_NAME[n] === 'mutation')).toBe(true);
+    });
+    it('every route resolves to a positive budget', () => {
+        for (const name of Object.keys(ROUTE_TYPE_BY_NAME)) {
+            expect(latencyBudgetMsForRoute(name)).toBeGreaterThan(0);
+        }
+    });
+});
+//# sourceMappingURL=route-latency-budget.test.js.map

package/dist/__tests__/route-latency-budget.test.js.map

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

package/dist/__tests__/session-close-loop.test.d.ts

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

package/dist/__tests__/session-close-loop.test.d.ts.map

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