reviewflow 3.10.0 → 3.13.0

package/dist/tests/units/modules/claude-invocation/usecases/awaitSessionCompletion.usecase.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { awaitSessionCompletion } from '../../../../../modules/claude-invocation/usecases/awaitSessionCompletion.usecase.js';
+import { StubMcpCompletionBridge } from '../../../../../tests/stubs/mcpCompletion.stub.js';
+import { StubClaudeSessionGateway } from '../../../../../tests/stubs/claudeSession.stub.js';
+import { ClaudeSessionFactory } from '../../../../../tests/factories/claudeSession.factory.js';
+import { parseSessionId } from '../../../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+describe('awaitSessionCompletion use case', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-05-22T10:00:00Z'));
+    });
+    it('returns the MCP completion when it arrives first', async () => {
+        const session = ClaudeSessionFactory.create({ sessionId: parseSessionId('mcp00001') });
+        const bridge = new StubMcpCompletionBridge();
+        const sessionGateway = new StubClaudeSessionGateway();
+        bridge.scheduleCompletion(session.jobId, {
+            source: 'mcp',
+            outcome: 'completed',
+            reason: null,
+        });
+        const promise = awaitSessionCompletion({ session, timeoutMs: 60_000, pollIntervalMs: 30_000 }, { sessionGateway, completionBridge: bridge, now: () => new Date('2026-05-22T10:00:00Z') });
+        await vi.runAllTimersAsync();
+        const completion = await promise;
+        expect(completion.source).toBe('mcp');
+        expect(completion.outcome).toBe('completed');
+    });
+    it('returns the polling completion when MCP stays silent', async () => {
+        const session = ClaudeSessionFactory.create({ sessionId: parseSessionId('poll0002') });
+        const bridge = new StubMcpCompletionBridge();
+        const sessionGateway = new StubClaudeSessionGateway();
+        sessionGateway.scheduleAgentCompletion('poll0002', 'completed', 1);
+        const promise = awaitSessionCompletion({ session, timeoutMs: 60_000, pollIntervalMs: 30_000 }, { sessionGateway, completionBridge: bridge, now: () => new Date('2026-05-22T10:00:00Z') });
+        await vi.advanceTimersByTimeAsync(30_000);
+        const completion = await promise;
+        expect(completion.source).toBe('polling');
+        expect(completion.outcome).toBe('completed');
+    });
+    it('returns timeout when no signal arrives within the timeout window', async () => {
+        const session = ClaudeSessionFactory.create({ sessionId: parseSessionId('time0002') });
+        const bridge = new StubMcpCompletionBridge();
+        const sessionGateway = new StubClaudeSessionGateway();
+        let nowMs = new Date('2026-05-22T10:00:00Z').getTime();
+        const now = () => new Date(nowMs);
+        const promise = awaitSessionCompletion({ session, timeoutMs: 15 * 60_000, pollIntervalMs: 30_000 }, { sessionGateway, completionBridge: bridge, now });
+        nowMs += 16 * 60_000;
+        await vi.advanceTimersByTimeAsync(16 * 60_000);
+        const completion = await promise;
+        expect(completion.source).toBe('timeout');
+        expect(completion.outcome).toBe('failed');
+        expect(completion.reason).toBe('timeout');
+    });
+});
+//# sourceMappingURL=awaitSessionCompletion.usecase.test.js.map

package/dist/tests/units/modules/claude-invocation/usecases/awaitSessionCompletion.usecase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaitSessionCompletion.usecase.test.js","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/awaitSessionCompletion.usecase.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/units/modules/claude-invocation/usecases/checkSupervisorHealth.usecase.test.d.ts

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

package/dist/tests/units/modules/claude-invocation/usecases/checkSupervisorHealth.usecase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkSupervisorHealth.usecase.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/checkSupervisorHealth.usecase.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/modules/claude-invocation/usecases/checkSupervisorHealth.usecase.test.js

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { checkSupervisorHealth } from '../../../../../modules/claude-invocation/usecases/checkSupervisorHealth.usecase.js';
+import { StubClaudeSessionGateway } from '../../../../../tests/stubs/claudeSession.stub.js';
+import { StubSupervisorHealthGateway } from '../../../../../tests/stubs/supervisorHealth.stub.js';
+describe('checkSupervisorHealth use case', () => {
+    it('records the supervisor as up when daemon is reachable', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        sessionGateway.setDaemonStatus({ reachable: true, reason: null });
+        const supervisorHealthGateway = new StubSupervisorHealthGateway();
+        const result = await checkSupervisorHealth({
+            sessionGateway,
+            supervisorHealthGateway,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('up');
+        expect(supervisorHealthGateway.read().lastCheckAt).toBe('2026-05-22T10:00:00.000Z');
+    });
+    it('records the supervisor as down when daemon is unreachable', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        sessionGateway.setDaemonStatus({ reachable: false, reason: 'connection refused' });
+        const supervisorHealthGateway = new StubSupervisorHealthGateway();
+        const result = await checkSupervisorHealth({
+            sessionGateway,
+            supervisorHealthGateway,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('down');
+        expect(result.lastDownReason).toBe('connection refused');
+    });
+});
+//# sourceMappingURL=checkSupervisorHealth.usecase.test.js.map

package/dist/tests/units/modules/claude-invocation/usecases/checkSupervisorHealth.usecase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkSupervisorHealth.usecase.test.js","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/checkSupervisorHealth.usecase.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uEAAuE,CAAC;AAC9G,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,cAAc,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACtD,cAAc,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,uBAAuB,GAAG,IAAI,2BAA2B,EAAE,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;YACzC,cAAc;YACd,uBAAuB;YACvB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,sBAAsB,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,cAAc,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACtD,cAAc,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACnF,MAAM,uBAAuB,GAAG,IAAI,2BAA2B,EAAE,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;YACzC,cAAc;YACd,uBAAuB;YACvB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,sBAAsB,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/units/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.test.d.ts

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

package/dist/tests/units/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupClaudeSession.usecase.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.test.js

@@ -0,0 +1,17 @@
+import { describe, it, expect } from 'vitest';
+import { cleanupClaudeSession } from '../../../../../modules/claude-invocation/usecases/cleanupClaudeSession.usecase.js';
+import { StubClaudeSessionGateway } from '../../../../../tests/stubs/claudeSession.stub.js';
+import { parseSessionId } from '../../../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+describe('cleanupClaudeSession use case', () => {
+    it('stops and removes the session on the happy path', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        const sessionId = parseSessionId('clean001');
+        const result = await cleanupClaudeSession({ sessionId }, { sessionGateway });
+        expect(result.stopped).toBe(true);
+        expect(result.removed).toBe(true);
+        expect(result.warnings).toEqual([]);
+        expect(sessionGateway.stopCalls).toContain(sessionId);
+        expect(sessionGateway.removeCalls).toContain(sessionId);
+    });
+});
+//# sourceMappingURL=cleanupClaudeSession.usecase.test.js.map

package/dist/tests/units/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupClaudeSession.usecase.test.js","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sEAAsE,CAAC;AAC5G,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AAE5G,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,cAAc,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAE7E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/units/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.test.d.ts

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

package/dist/tests/units/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchClaudeSession.usecase.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect } from 'vitest';
+import { dispatchClaudeSession } from '../../../../../modules/claude-invocation/usecases/dispatchClaudeSession.usecase.js';
+import { StubClaudeSessionGateway } from '../../../../../tests/stubs/claudeSession.stub.js';
+import { StubEnvironmentGateway } from '../../../../../tests/stubs/environment.stub.js';
+import { StubBillingStateGateway } from '../../../../../tests/stubs/billingState.stub.js';
+const baseInput = {
+    jobId: 'gitlab:owner/repo:42',
+    jobType: 'review',
+    prompt: '/review-front 42',
+    flags: {
+        model: 'claude-opus-4-7',
+        mcpConfigJson: '{}',
+        systemPrompt: 'system',
+        allowedTools: 'Read,Bash',
+        disallowedTools: 'EnterPlanMode',
+        permissionMode: 'bypassPermissions',
+    },
+    localPath: '/tmp/project',
+    mergeRequestId: 'gitlab-owner/repo-42',
+};
+describe('dispatchClaudeSession use case', () => {
+    it('returns "dispatched" with a session id on the happy path', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        const environment = new StubEnvironmentGateway();
+        const billingState = new StubBillingStateGateway();
+        const result = await dispatchClaudeSession(baseInput, {
+            sessionGateway,
+            environment,
+            billingState,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('dispatched');
+        if (result.status === 'dispatched') {
+            expect(result.session.sessionId).toBe('stub-session');
+            expect(result.session.status).toBe('dispatched');
+        }
+        expect(sessionGateway.dispatchCalls).toHaveLength(1);
+    });
+    it('aborts with "billing-regression-prevented" when ANTHROPIC_API_KEY is present', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        const environment = new StubEnvironmentGateway();
+        environment.setHasAnthropicApiKey(true);
+        const billingState = new StubBillingStateGateway();
+        const result = await dispatchClaudeSession(baseInput, {
+            sessionGateway,
+            environment,
+            billingState,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('billing-regression-prevented');
+        expect(sessionGateway.dispatchCalls).toHaveLength(0);
+    });
+    it('returns "paused" when the billing state is paused', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        const environment = new StubEnvironmentGateway();
+        const billingState = new StubBillingStateGateway();
+        billingState.pause('regression');
+        const result = await dispatchClaudeSession(baseInput, {
+            sessionGateway,
+            environment,
+            billingState,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('paused');
+        expect(sessionGateway.dispatchCalls).toHaveLength(0);
+    });
+    it('returns "rate-limited" when the gateway reports a rate limit', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        sessionGateway.setDispatchResult({ status: 'rate-limited', rawStderr: '429 Too Many Requests' });
+        const environment = new StubEnvironmentGateway();
+        const billingState = new StubBillingStateGateway();
+        const result = await dispatchClaudeSession(baseInput, {
+            sessionGateway,
+            environment,
+            billingState,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('rate-limited');
+    });
+    it('returns "failed" with raw stderr when dispatch fails', async () => {
+        const sessionGateway = new StubClaudeSessionGateway();
+        sessionGateway.setDispatchResult({ status: 'failed', rawStderr: 'boom' });
+        const environment = new StubEnvironmentGateway();
+        const billingState = new StubBillingStateGateway();
+        const result = await dispatchClaudeSession(baseInput, {
+            sessionGateway,
+            environment,
+            billingState,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+        });
+        expect(result.status).toBe('failed');
+        if (result.status === 'failed') {
+            expect(result.rawStderr).toBe('boom');
+        }
+    });
+});
+//# sourceMappingURL=dispatchClaudeSession.usecase.test.js.map

package/dist/tests/units/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchClaudeSession.usecase.test.js","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/units/modules/claude-invocation/usecases/retrieveReviewReport.usecase.test.d.ts

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

package/dist/tests/units/modules/claude-invocation/usecases/retrieveReviewReport.usecase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveReviewReport.usecase.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/retrieveReviewReport.usecase.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/modules/claude-invocation/usecases/retrieveReviewReport.usecase.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from 'vitest';
+import { retrieveReviewReport } from '../../../../../modules/claude-invocation/usecases/retrieveReviewReport.usecase.js';
+import { StubReviewReportGateway } from '../../../../../tests/stubs/reviewReport.stub.js';
+import { ClaudeSessionFactory } from '../../../../../tests/factories/claudeSession.factory.js';
+describe('retrieveReviewReport use case', () => {
+    it('returns the report content when the file exists', () => {
+        const reportGateway = new StubReviewReportGateway();
+        reportGateway.setReport({
+            content: '# Review',
+            path: '/tmp/project/.claude/reviews/2026-05-22-MR-42-review.md',
+        });
+        const result = retrieveReviewReport({
+            session: ClaudeSessionFactory.create(),
+            today: new Date('2026-05-22T10:00:00Z'),
+            mergeRequestNumber: 42,
+        }, { reportGateway });
+        expect(result.status).toBe('found');
+        if (result.status === 'found') {
+            expect(result.content).toBe('# Review');
+        }
+    });
+    it('returns "missing" with the expected path when the file is absent', () => {
+        const reportGateway = new StubReviewReportGateway();
+        reportGateway.setReport(null);
+        const result = retrieveReviewReport({
+            session: ClaudeSessionFactory.create(),
+            today: new Date('2026-05-22T10:00:00Z'),
+            mergeRequestNumber: 42,
+        }, { reportGateway });
+        expect(result.status).toBe('missing');
+        if (result.status === 'missing') {
+            expect(result.expectedPath).toContain('2026-05-22-MR-42-review.md');
+        }
+    });
+    it('uses the followup suffix for followup job type', () => {
+        const reportGateway = new StubReviewReportGateway();
+        reportGateway.setReport(null);
+        const result = retrieveReviewReport({
+            session: ClaudeSessionFactory.create({ jobType: 'followup' }),
+            today: new Date('2026-05-22T10:00:00Z'),
+            mergeRequestNumber: 42,
+        }, { reportGateway });
+        expect(result.status).toBe('missing');
+        if (result.status === 'missing') {
+            expect(result.expectedPath).toContain('followup');
+        }
+    });
+});
+//# sourceMappingURL=retrieveReviewReport.usecase.test.js.map

package/dist/tests/units/modules/claude-invocation/usecases/retrieveReviewReport.usecase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveReviewReport.usecase.test.js","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/retrieveReviewReport.usecase.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sEAAsE,CAAC;AAC5G,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,aAAa,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACpD,aAAa,CAAC,SAAS,CAAC;YACtB,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,yDAAyD;SAChE,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,oBAAoB,CACjC;YACE,OAAO,EAAE,oBAAoB,CAAC,MAAM,EAAE;YACtC,KAAK,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC;YACvC,kBAAkB,EAAE,EAAE;SACvB,EACD,EAAE,aAAa,EAAE,CAClB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,aAAa,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACpD,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,oBAAoB,CACjC;YACE,OAAO,EAAE,oBAAoB,CAAC,MAAM,EAAE;YACtC,KAAK,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC;YACvC,kBAAkB,EAAE,EAAE;SACvB,EACD,EAAE,aAAa,EAAE,CAClB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,aAAa,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACpD,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,oBAAoB,CACjC;YACE,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YAC7D,KAAK,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC;YACvC,kBAAkB,EAAE,EAAE;SACvB,EACD,EAAE,aAAa,EAAE,CAClB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/units/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.test.d.ts

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

package/dist/tests/units/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runClaudeReviewJob.usecase.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.test.js

@@ -0,0 +1,171 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { runClaudeReviewJob } from '../../../../../modules/claude-invocation/usecases/runClaudeReviewJob.usecase.js';
+import { StubClaudeSessionGateway } from '../../../../../tests/stubs/claudeSession.stub.js';
+import { StubMcpCompletionBridge } from '../../../../../tests/stubs/mcpCompletion.stub.js';
+import { StubReviewReportGateway } from '../../../../../tests/stubs/reviewReport.stub.js';
+import { StubBillingStateGateway } from '../../../../../tests/stubs/billingState.stub.js';
+import { StubEnvironmentGateway } from '../../../../../tests/stubs/environment.stub.js';
+import { parseSessionId } from '../../../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+function buildInput(overrides = {}) {
+    return {
+        jobId: 'gitlab:owner/repo:42',
+        jobType: 'review',
+        prompt: '/review-front 42',
+        flags: {
+            model: 'claude-opus-4-7',
+            mcpConfigJson: '{}',
+            systemPrompt: 'system',
+            allowedTools: 'Read,Bash',
+            disallowedTools: 'EnterPlanMode',
+            permissionMode: 'bypassPermissions',
+        },
+        localPath: '/tmp/project',
+        mergeRequestId: 'gitlab-owner/repo-42',
+        mergeRequestNumber: 42,
+        attempt: 0,
+        ...overrides,
+    };
+}
+function buildDeps() {
+    const sessionGateway = new StubClaudeSessionGateway();
+    const completionBridge = new StubMcpCompletionBridge();
+    const reportGateway = new StubReviewReportGateway();
+    const billingState = new StubBillingStateGateway();
+    const environment = new StubEnvironmentGateway();
+    return {
+        sessionGateway,
+        completionBridge,
+        reportGateway,
+        billingState,
+        environment,
+        deps: {
+            sessionGateway,
+            completionBridge,
+            reportGateway,
+            billingState,
+            environment,
+            now: () => new Date('2026-05-22T10:00:00Z'),
+            timeoutMs: 15 * 60_000,
+            pollIntervalMs: 30_000,
+        },
+    };
+}
+describe('runClaudeReviewJob orchestrator', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-05-22T10:00:00Z'));
+    });
+    it('completes the happy path via MCP signal', async () => {
+        const ctx = buildDeps();
+        ctx.sessionGateway.setDispatchResult({
+            status: 'dispatched',
+            sessionId: parseSessionId('happy001'),
+        });
+        ctx.completionBridge.scheduleCompletion('gitlab:owner/repo:42', {
+            source: 'mcp',
+            outcome: 'completed',
+            reason: null,
+        });
+        const runPromise = runClaudeReviewJob(buildInput(), ctx.deps);
+        await vi.runAllTimersAsync();
+        const result = await runPromise;
+        expect(result.status).toBe('completed');
+        expect(ctx.sessionGateway.stopCalls).toContain(parseSessionId('happy001'));
+        expect(ctx.sessionGateway.removeCalls).toContain(parseSessionId('happy001'));
+    });
+    it('returns "failed" with reason "report-missing" when the report file is absent', async () => {
+        const ctx = buildDeps();
+        ctx.sessionGateway.setDispatchResult({
+            status: 'dispatched',
+            sessionId: parseSessionId('miss0001'),
+        });
+        ctx.completionBridge.scheduleCompletion('gitlab:owner/repo:42', {
+            source: 'mcp',
+            outcome: 'completed',
+            reason: null,
+        });
+        ctx.reportGateway.setReport(null);
+        const runPromise = runClaudeReviewJob(buildInput(), ctx.deps);
+        await vi.runAllTimersAsync();
+        const result = await runPromise;
+        expect(result.status).toBe('failed');
+        if (result.status === 'failed') {
+            expect(result.reason).toBe('report-missing');
+        }
+        expect(ctx.sessionGateway.stopCalls).toContain(parseSessionId('miss0001'));
+    });
+    it('returns "retry" with backoff when the gateway reports a rate limit', async () => {
+        const ctx = buildDeps();
+        ctx.sessionGateway.setDispatchResult({
+            status: 'rate-limited',
+            rawStderr: 'rate-limit hit',
+        });
+        const result = await runClaudeReviewJob(buildInput(), ctx.deps);
+        expect(result.status).toBe('retry');
+        if (result.status === 'retry') {
+            expect(result.delayMs).toBe(60_000);
+            expect(result.attempt).toBe(1);
+        }
+    });
+    it('returns "failed" with reason "billing-regression-prevented" when API key is set', async () => {
+        const ctx = buildDeps();
+        ctx.environment.setHasAnthropicApiKey(true);
+        const result = await runClaudeReviewJob(buildInput(), ctx.deps);
+        expect(result.status).toBe('failed');
+        if (result.status === 'failed') {
+            expect(result.reason).toBe('billing-regression-prevented');
+        }
+        expect(ctx.sessionGateway.dispatchCalls).toHaveLength(0);
+    });
+    it('cancels a running session when the AbortSignal fires', async () => {
+        const ctx = buildDeps();
+        ctx.sessionGateway.setDispatchResult({
+            status: 'dispatched',
+            sessionId: parseSessionId('abort001'),
+        });
+        const controller = new AbortController();
+        const runPromise = runClaudeReviewJob(buildInput({ signal: controller.signal }), ctx.deps);
+        await vi.advanceTimersByTimeAsync(10);
+        controller.abort();
+        await vi.runAllTimersAsync();
+        const result = await runPromise;
+        expect(ctx.sessionGateway.stopCalls).toContain(parseSessionId('abort001'));
+        expect(result.status).toBe('failed');
+        if (result.status === 'failed') {
+            expect(result.reason).toContain('stopped');
+        }
+    });
+    it('skips dispatch entirely when the AbortSignal is already aborted', async () => {
+        const ctx = buildDeps();
+        const controller = new AbortController();
+        controller.abort();
+        const result = await runClaudeReviewJob(buildInput({ signal: controller.signal }), ctx.deps);
+        expect(ctx.sessionGateway.dispatchCalls).toHaveLength(0);
+        expect(result.status).toBe('failed');
+        if (result.status === 'failed') {
+            expect(result.reason).toContain('cancelled');
+        }
+    });
+    it('returns "failed" with reason "timeout" when no signal arrives in time', async () => {
+        const ctx = buildDeps();
+        ctx.sessionGateway.setDispatchResult({
+            status: 'dispatched',
+            sessionId: parseSessionId('time0003'),
+        });
+        let nowMs = new Date('2026-05-22T10:00:00Z').getTime();
+        const deps = { ...ctx.deps, now: () => new Date(nowMs) };
+        const runPromise = runClaudeReviewJob(buildInput(), deps);
+        await Promise.resolve();
+        await Promise.resolve();
+        await Promise.resolve();
+        nowMs += 16 * 60_000;
+        await vi.advanceTimersByTimeAsync(16 * 60_000);
+        const result = await runPromise;
+        expect(result.status).toBe('failed');
+        if (result.status === 'failed') {
+            expect(result.reason).toBe('timeout');
+        }
+        expect(ctx.sessionGateway.stopCalls).toContain(parseSessionId('time0003'));
+    });
+});
+//# sourceMappingURL=runClaudeReviewJob.usecase.test.js.map

package/dist/tests/units/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runClaudeReviewJob.usecase.test.js","sourceRoot":"","sources":["../../../../../../src/tests/units/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/units/modules/token-accounting/entities/budget/budgetConfig.guard.test.d.ts

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

package/dist/tests/units/modules/token-accounting/entities/budget/budgetConfig.guard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetConfig.guard.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/tests/units/modules/token-accounting/entities/budget/budgetConfig.guard.test.ts"],"names":[],"mappings":""}

package/dist/tests/units/modules/token-accounting/entities/budget/budgetConfig.guard.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { budgetConfigGuard } from '../../../../../../modules/token-accounting/entities/budget/budgetConfig.guard.js';
+import { BUDGET_FLOOR_USD, BUDGET_CEILING_USD, BUDGET_DEFAULT_USD, } from '../../../../../../modules/token-accounting/entities/budget/budgetConfig.schema.js';
+describe('budgetConfigGuard', () => {
+    it('accepts a config with limitUsd at the default 200', () => {
+        const result = budgetConfigGuard.safeParse({ limitUsd: BUDGET_DEFAULT_USD });
+        expect(result.success).toBe(true);
+    });
+    it('accepts the floor 0', () => {
+        const result = budgetConfigGuard.safeParse({ limitUsd: BUDGET_FLOOR_USD });
+        expect(result.success).toBe(true);
+    });
+    it('accepts the ceiling 600', () => {
+        const result = budgetConfigGuard.safeParse({ limitUsd: BUDGET_CEILING_USD });
+        expect(result.success).toBe(true);
+    });
+    it('rejects a limit above 600', () => {
+        const result = budgetConfigGuard.safeParse({ limitUsd: 750 });
+        expect(result.success).toBe(false);
+    });
+    it('rejects a negative limit', () => {
+        const result = budgetConfigGuard.safeParse({ limitUsd: -10 });
+        expect(result.success).toBe(false);
+    });
+    it('rejects a missing limitUsd field', () => {
+        const result = budgetConfigGuard.safeParse({});
+        expect(result.success).toBe(false);
+    });
+});
+//# sourceMappingURL=budgetConfig.guard.test.js.map

package/dist/tests/units/modules/token-accounting/entities/budget/budgetConfig.guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgetConfig.guard.test.js","sourceRoot":"","sources":["../../../../../../../src/tests/units/modules/token-accounting/entities/budget/budgetConfig.guard.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AACrG,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mEAAmE,CAAC;AAE3E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/units/modules/token-accounting/interface-adapters/controllers/http/budget.routes.test.d.ts

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

package/dist/tests/units/modules/token-accounting/interface-adapters/controllers/http/budget.routes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.routes.test.d.ts","sourceRoot":"","sources":["../../../../../../../../src/tests/units/modules/token-accounting/interface-adapters/controllers/http/budget.routes.test.ts"],"names":[],"mappings":""}