reviewflow 3.12.0 → 3.13.0

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

@@ -0,0 +1,15 @@
+import type { ClaudeSessionGateway } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.gateway.js';
+import type { SessionId } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+export interface CleanupClaudeSessionInput {
+    sessionId: SessionId;
+}
+export interface CleanupClaudeSessionDependencies {
+    sessionGateway: ClaudeSessionGateway;
+}
+export interface CleanupClaudeSessionResult {
+    stopped: boolean;
+    removed: boolean;
+    warnings: string[];
+}
+export declare function cleanupClaudeSession(input: CleanupClaudeSessionInput, deps: CleanupClaudeSessionDependencies): Promise<CleanupClaudeSessionResult>;
+//# sourceMappingURL=cleanupClaudeSession.usecase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupClaudeSession.usecase.d.ts","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6EAA6E,CAAC;AACxH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4EAA4E,CAAC;AAE5G,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,gCAAgC;IAC/C,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,EAChC,IAAI,EAAE,gCAAgC,GACrC,OAAO,CAAC,0BAA0B,CAAC,CA0BrC"}

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

@@ -0,0 +1,25 @@
+export async function cleanupClaudeSession(input, deps) {
+    const warnings = [];
+    const stopResult = await deps.sessionGateway.stop(input.sessionId).catch(error => {
+        const message = error instanceof Error ? error.message : String(error);
+        warnings.push(`stop failed: ${message}`);
+        return { success: false, warning: message };
+    });
+    if (!stopResult.success && stopResult.warning) {
+        warnings.push(`stop: ${stopResult.warning}`);
+    }
+    const removeResult = await deps.sessionGateway.remove(input.sessionId).catch(error => {
+        const message = error instanceof Error ? error.message : String(error);
+        warnings.push(`remove failed: ${message}`);
+        return { success: false, warning: message };
+    });
+    if (!removeResult.success && removeResult.warning) {
+        warnings.push(`remove: ${removeResult.warning}`);
+    }
+    return {
+        stopped: stopResult.success,
+        removed: removeResult.success,
+        warnings,
+    };
+}
+//# sourceMappingURL=cleanupClaudeSession.usecase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupClaudeSession.usecase.js","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/cleanupClaudeSession.usecase.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC,EAChC,IAAsC;IAEtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAC/E,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACnF,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,WAAW,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,QAAQ;KACT,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { BillingStateGateway } from '../../../modules/claude-invocation/entities/billingState/billingState.gateway.js';
+import type { EnvironmentGateway } from '../../../modules/claude-invocation/entities/billingState/environment.gateway.js';
+import type { ClaudeDispatchFlags, ClaudeSessionGateway } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.gateway.js';
+import type { ClaudeSession, ClaudeSessionJobType } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+export interface DispatchClaudeSessionInput {
+    jobId: string;
+    jobType: ClaudeSessionJobType;
+    prompt: string;
+    flags: ClaudeDispatchFlags;
+    localPath: string;
+    mergeRequestId: string;
+}
+export interface DispatchClaudeSessionDependencies {
+    sessionGateway: ClaudeSessionGateway;
+    environment: EnvironmentGateway;
+    billingState: BillingStateGateway;
+    now: () => Date;
+}
+export type DispatchClaudeSessionResult = {
+    status: 'dispatched';
+    session: ClaudeSession;
+} | {
+    status: 'rate-limited';
+    rawStderr: string;
+} | {
+    status: 'billing-regression-prevented';
+} | {
+    status: 'paused';
+} | {
+    status: 'failed';
+    rawStderr: string;
+};
+export declare function dispatchClaudeSession(input: DispatchClaudeSessionInput, deps: DispatchClaudeSessionDependencies): Promise<DispatchClaudeSessionResult>;
+//# sourceMappingURL=dispatchClaudeSession.usecase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchClaudeSession.usecase.d.ts","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2EAA2E,CAAC;AACrH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0EAA0E,CAAC;AACnH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,6EAA6E,CAAC;AAIrF,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,4EAA4E,CAAC;AAEpF,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,cAAc,EAAE,oBAAoB,CAAC;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;IAClC,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,8BAA8B,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,EACjC,IAAI,EAAE,iCAAiC,GACtC,OAAO,CAAC,2BAA2B,CAAC,CAmCtC"}

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

@@ -0,0 +1,32 @@
+import { createClaudeSession, } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.js';
+export async function dispatchClaudeSession(input, deps) {
+    if (deps.environment.hasAnthropicApiKey()) {
+        return { status: 'billing-regression-prevented' };
+    }
+    if (deps.billingState.read().dispatchPaused) {
+        return { status: 'paused' };
+    }
+    const result = await deps.sessionGateway.dispatch({
+        prompt: input.prompt,
+        flags: input.flags,
+        localPath: input.localPath,
+        jobId: input.jobId,
+        jobType: input.jobType,
+    });
+    if (result.status === 'rate-limited') {
+        return { status: 'rate-limited', rawStderr: result.rawStderr };
+    }
+    if (result.status === 'failed') {
+        return { status: 'failed', rawStderr: result.rawStderr };
+    }
+    const session = createClaudeSession({
+        sessionId: result.sessionId,
+        jobId: input.jobId,
+        jobType: input.jobType,
+        localPath: input.localPath,
+        mergeRequestId: input.mergeRequestId,
+        dispatchedAt: deps.now(),
+    });
+    return { status: 'dispatched', session };
+}
+//# sourceMappingURL=dispatchClaudeSession.usecase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatchClaudeSession.usecase.js","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/dispatchClaudeSession.usecase.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,mBAAmB,GACpB,MAAM,qEAAqE,CAAC;AA6B7E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiC,EACjC,IAAuC;IAEvC,IAAI,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1C,OAAO,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;QAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;QAChD,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IACjE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;KACzB,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { ClaudeSession } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+import type { ReviewReportGateway } from '../../../modules/claude-invocation/entities/sessionCompletion/reviewReport.gateway.js';
+export interface RetrieveReviewReportInput {
+    session: ClaudeSession;
+    today: Date;
+    mergeRequestNumber: number;
+}
+export interface RetrieveReviewReportDependencies {
+    reportGateway: ReviewReportGateway;
+}
+export type RetrieveReviewReportResult = {
+    status: 'found';
+    content: string;
+    path: string;
+} | {
+    status: 'missing';
+    expectedPath: string;
+};
+export declare function retrieveReviewReport(input: RetrieveReviewReportInput, deps: RetrieveReviewReportDependencies): RetrieveReviewReportResult;
+//# sourceMappingURL=retrieveReviewReport.usecase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveReviewReport.usecase.d.ts","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/retrieveReviewReport.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4EAA4E,CAAC;AAChH,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,gFAAgF,CAAC;AAExF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,IAAI,CAAC;IACZ,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAMhD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,EAChC,IAAI,EAAE,gCAAgC,GACrC,0BAA0B,CAa5B"}

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

@@ -0,0 +1,17 @@
+function formatIsoDate(today) {
+    return today.toISOString().slice(0, 10);
+}
+export function retrieveReviewReport(input, deps) {
+    const location = {
+        localPath: input.session.localPath,
+        isoDate: formatIsoDate(input.today),
+        mergeRequestNumber: input.mergeRequestNumber,
+        jobType: input.session.jobType,
+    };
+    const found = deps.reportGateway.read(location);
+    if (found) {
+        return { status: 'found', content: found.content, path: found.path };
+    }
+    return { status: 'missing', expectedPath: deps.reportGateway.buildPath(location) };
+}
+//# sourceMappingURL=retrieveReviewReport.usecase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveReviewReport.usecase.js","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/retrieveReviewReport.usecase.ts"],"names":[],"mappings":"AAoBA,SAAS,aAAa,CAAC,KAAW;IAChC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAgC,EAChC,IAAsC;IAEtC,MAAM,QAAQ,GAAyB;QACrC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;QAClC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;QACnC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO;KAC/B,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;AACrF,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { BillingStateGateway } from '../../../modules/claude-invocation/entities/billingState/billingState.gateway.js';
+import type { EnvironmentGateway } from '../../../modules/claude-invocation/entities/billingState/environment.gateway.js';
+import type { ClaudeDispatchFlags, ClaudeSessionGateway } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.gateway.js';
+import type { ClaudeSessionJobType } from '../../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+import type { McpCompletionBridge } from '../../../modules/claude-invocation/entities/sessionCompletion/mcpCompletion.gateway.js';
+import type { ReviewReportGateway } from '../../../modules/claude-invocation/entities/sessionCompletion/reviewReport.gateway.js';
+export interface RunClaudeReviewJobInput {
+    jobId: string;
+    jobType: ClaudeSessionJobType;
+    prompt: string;
+    flags: ClaudeDispatchFlags;
+    localPath: string;
+    mergeRequestId: string;
+    mergeRequestNumber: number;
+    attempt: number;
+    signal?: AbortSignal;
+}
+export interface RunClaudeReviewJobDependencies {
+    sessionGateway: ClaudeSessionGateway;
+    completionBridge: McpCompletionBridge;
+    reportGateway: ReviewReportGateway;
+    billingState: BillingStateGateway;
+    environment: EnvironmentGateway;
+    now: () => Date;
+    timeoutMs: number;
+    pollIntervalMs: number;
+}
+export type RunClaudeReviewJobResult = {
+    status: 'completed';
+    reportPath: string;
+    content: string;
+} | {
+    status: 'failed';
+    reason: string;
+} | {
+    status: 'retry';
+    delayMs: number;
+    attempt: number;
+};
+export declare function runClaudeReviewJob(input: RunClaudeReviewJobInput, deps: RunClaudeReviewJobDependencies): Promise<RunClaudeReviewJobResult>;
+//# sourceMappingURL=runClaudeReviewJob.usecase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runClaudeReviewJob.usecase.d.ts","sourceRoot":"","sources":["../../../../src/modules/claude-invocation/usecases/runClaudeReviewJob.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2EAA2E,CAAC;AACrH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0EAA0E,CAAC;AACnH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,6EAA6E,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4EAA4E,CAAC;AACvH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iFAAiF,CAAC;AAE3H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gFAAgF,CAAC;AAO1H,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,cAAc,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,aAAa,EAAE,mBAAmB,CAAC;IACnC,YAAY,EAAE,mBAAmB,CAAC;IAClC,WAAW,EAAE,kBAAkB,CAAC;IAChC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,EAC9B,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,wBAAwB,CAAC,CA2GnC"}

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

@@ -0,0 +1,88 @@
+import { planRetry } from '../../../modules/claude-invocation/entities/retrySchedule/retrySchedule.valueObject.js';
+import { dispatchClaudeSession } from '../../../modules/claude-invocation/usecases/dispatchClaudeSession.usecase.js';
+import { awaitSessionCompletion } from '../../../modules/claude-invocation/usecases/awaitSessionCompletion.usecase.js';
+import { retrieveReviewReport } from '../../../modules/claude-invocation/usecases/retrieveReviewReport.usecase.js';
+import { cleanupClaudeSession } from '../../../modules/claude-invocation/usecases/cleanupClaudeSession.usecase.js';
+export async function runClaudeReviewJob(input, deps) {
+    if (input.signal?.aborted) {
+        return { status: 'failed', reason: 'cancelled' };
+    }
+    const dispatchResult = await dispatchClaudeSession({
+        jobId: input.jobId,
+        jobType: input.jobType,
+        prompt: input.prompt,
+        flags: input.flags,
+        localPath: input.localPath,
+        mergeRequestId: input.mergeRequestId,
+    }, {
+        sessionGateway: deps.sessionGateway,
+        environment: deps.environment,
+        billingState: deps.billingState,
+        now: deps.now,
+    });
+    if (dispatchResult.status === 'billing-regression-prevented') {
+        return { status: 'failed', reason: 'billing-regression-prevented' };
+    }
+    if (dispatchResult.status === 'paused') {
+        return { status: 'failed', reason: 'dispatch-paused' };
+    }
+    if (dispatchResult.status === 'rate-limited') {
+        const retry = planRetry(input.attempt);
+        if (retry.status === 'give-up') {
+            return { status: 'failed', reason: 'rate-limited-give-up' };
+        }
+        return { status: 'retry', delayMs: retry.delayMs, attempt: retry.nextAttempt };
+    }
+    if (dispatchResult.status === 'failed') {
+        return { status: 'failed', reason: `dispatch-failed: ${dispatchResult.rawStderr}` };
+    }
+    const { session } = dispatchResult;
+    const abortListener = input.signal
+        ? () => {
+            void deps.sessionGateway.stop(session.sessionId);
+            deps.completionBridge.publish(input.jobId, {
+                source: 'mcp',
+                outcome: 'stopped',
+                reason: 'cancelled',
+            });
+        }
+        : null;
+    if (input.signal && abortListener) {
+        input.signal.addEventListener('abort', abortListener);
+    }
+    let completion;
+    try {
+        completion = await awaitSessionCompletion({
+            session,
+            timeoutMs: deps.timeoutMs,
+            pollIntervalMs: deps.pollIntervalMs,
+        }, {
+            sessionGateway: deps.sessionGateway,
+            completionBridge: deps.completionBridge,
+            now: deps.now,
+        });
+    }
+    finally {
+        if (input.signal && abortListener) {
+            input.signal.removeEventListener('abort', abortListener);
+        }
+    }
+    await cleanupClaudeSession({ sessionId: session.sessionId }, { sessionGateway: deps.sessionGateway });
+    if (completion.source === 'timeout') {
+        return { status: 'failed', reason: 'timeout' };
+    }
+    if (completion.outcome !== 'completed') {
+        const reasonSuffix = completion.reason !== null ? `: ${completion.reason}` : '';
+        return { status: 'failed', reason: `outcome-${completion.outcome}${reasonSuffix}` };
+    }
+    const report = retrieveReviewReport({
+        session,
+        today: deps.now(),
+        mergeRequestNumber: input.mergeRequestNumber,
+    }, { reportGateway: deps.reportGateway });
+    if (report.status === 'missing') {
+        return { status: 'failed', reason: 'report-missing' };
+    }
+    return { status: 'completed', reportPath: report.path, content: report.content };
+}
+//# sourceMappingURL=runClaudeReviewJob.usecase.js.map

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

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

package/dist/modules/review-execution/usecases/mcp/setPhase.usecase.d.ts

@@ -1,3 +1,4 @@
+import type { McpCompletionBridge } from "../../../../modules/claude-invocation/entities/sessionCompletion/mcpCompletion.gateway.js";
 import type { ReviewProgressGateway } from "../../entities/progress/progress.gateway.js";
 import type { ReviewPhase } from "../../entities/progress/progress.type.js";
 export type SetPhaseResult = {
@@ -10,6 +11,7 @@ export type SetPhaseResult = {
 };
 export interface SetPhaseDependencies {
     progressGateway: ReviewProgressGateway;
+    completionBridge?: McpCompletionBridge;
 }
 export declare function setPhase(jobId: string, phase: ReviewPhase, deps: SetPhaseDependencies): SetPhaseResult;
 //# sourceMappingURL=setPhase.usecase.d.ts.map

package/dist/modules/review-execution/usecases/mcp/setPhase.usecase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setPhase.usecase.d.ts","sourceRoot":"","sources":["../../../../../src/modules/review-execution/usecases/mcp/setPhase.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAE5E,MAAM,MAAM,cAAc,GACvB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACpC,eAAe,EAAE,qBAAqB,CAAC;CACvC;AAED,wBAAgB,QAAQ,CACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,oBAAoB,GACxB,cAAc,CAiBhB"}
+{"version":3,"file":"setPhase.usecase.d.ts","sourceRoot":"","sources":["../../../../../src/modules/review-execution/usecases/mcp/setPhase.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iFAAiF,CAAC;AAC3H,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAE5E,MAAM,MAAM,cAAc,GACvB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACpC,eAAe,EAAE,qBAAqB,CAAC;IACvC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,wBAAgB,QAAQ,CACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,oBAAoB,GACxB,cAAc,CAqBhB"}

package/dist/modules/review-execution/usecases/mcp/setPhase.usecase.js

@@ -1,5 +1,5 @@
 export function setPhase(jobId, phase, deps) {
-    const { progressGateway } = deps;
+    const { progressGateway, completionBridge } = deps;
     const progress = progressGateway.setPhase(jobId, phase);
     if (!progress) {
         return {
@@ -7,6 +7,9 @@ export function setPhase(jobId, phase, deps) {
             error: `Job not found: ${jobId}`,
         };
     }
+    if (phase === "completed" && completionBridge) {
+        completionBridge.publish(jobId, { source: "mcp", outcome: "completed", reason: null });
+    }
     return {
         success: true,
         phase: progress.currentPhase,

package/dist/modules/review-execution/usecases/mcp/setPhase.usecase.js.map

@@ -1 +1 @@
-{"version":3,"file":"setPhase.usecase.js","sourceRoot":"","sources":["../../../../../src/modules/review-execution/usecases/mcp/setPhase.usecase.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,QAAQ,CACvB,KAAa,EACb,KAAkB,EAClB,IAA0B;IAE1B,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAEjC,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO;YACN,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,kBAAkB,KAAK,EAAE;SAChC,CAAC;IACH,CAAC;IAED,OAAO;QACN,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,QAAQ,CAAC,YAAY;QAC5B,eAAe,EAAE,QAAQ,CAAC,eAAe;KACzC,CAAC;AACH,CAAC"}
+{"version":3,"file":"setPhase.usecase.js","sourceRoot":"","sources":["../../../../../src/modules/review-execution/usecases/mcp/setPhase.usecase.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,QAAQ,CACvB,KAAa,EACb,KAAkB,EAClB,IAA0B;IAE1B,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAEnD,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO;YACN,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,kBAAkB,KAAK,EAAE;SAChC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,WAAW,IAAI,gBAAgB,EAAE,CAAC;QAC/C,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,OAAO;QACN,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,QAAQ,CAAC,YAAY;QAC5B,eAAe,EAAE,QAAQ,CAAC,eAAe;KACzC,CAAC;AACH,CAAC"}

package/dist/tests/acceptance/169-migrate-claude-invocation-to-bg-mode.acceptance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=169-migrate-claude-invocation-to-bg-mode.acceptance.test.d.ts.map

package/dist/tests/acceptance/169-migrate-claude-invocation-to-bg-mode.acceptance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"169-migrate-claude-invocation-to-bg-mode.acceptance.test.d.ts","sourceRoot":"","sources":["../../../src/tests/acceptance/169-migrate-claude-invocation-to-bg-mode.acceptance.test.ts"],"names":[],"mappings":""}

package/dist/tests/acceptance/169-migrate-claude-invocation-to-bg-mode.acceptance.test.js

@@ -0,0 +1,238 @@
+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 { StubSupervisorHealthGateway } from '../../tests/stubs/supervisorHealth.stub.js';
+import { StubEnvironmentGateway } from '../../tests/stubs/environment.stub.js';
+import { auditBilling } from '../../modules/claude-invocation/usecases/auditBilling.usecase.js';
+import { checkSupervisorHealth } from '../../modules/claude-invocation/usecases/checkSupervisorHealth.usecase.js';
+import { parseSessionId } from '../../modules/claude-invocation/entities/claudeSession/claudeSession.schema.js';
+function createContext() {
+    const sessionGateway = new StubClaudeSessionGateway();
+    const completionBridge = new StubMcpCompletionBridge();
+    const reportGateway = new StubReviewReportGateway();
+    const billingState = new StubBillingStateGateway();
+    const supervisorHealth = new StubSupervisorHealthGateway();
+    const environment = new StubEnvironmentGateway();
+    const deps = {
+        sessionGateway,
+        completionBridge,
+        reportGateway,
+        billingState,
+        environment,
+        now: () => new Date('2026-05-22T10:00:00Z'),
+        timeoutMs: 15 * 60 * 1000,
+        pollIntervalMs: 30_000,
+    };
+    return {
+        sessionGateway,
+        completionBridge,
+        reportGateway,
+        billingState,
+        supervisorHealth,
+        environment,
+        deps,
+    };
+}
+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',
+    mergeRequestNumber: 42,
+    attempt: 0,
+};
+describe('SPEC-169: Migrate Claude invocation to --bg mode (acceptance)', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-05-22T10:00:00Z'));
+    });
+    describe('Scenario 1: Webhook triggers review dispatched via --bg', () => {
+        it('spawns claude --bg with the configured flags and captures the session ID', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'dispatched', sessionId: parseSessionId('7c5dcf5d') });
+            context.completionBridge.scheduleCompletion(baseInput.jobId, {
+                source: 'mcp',
+                outcome: 'completed',
+                reason: null,
+            });
+            context.reportGateway.setReport({
+                content: '# Review report',
+                path: '/tmp/project/.claude/reviews/2026-05-22-MR-42-review.md',
+            });
+            const runPromise = runClaudeReviewJob(baseInput, context.deps);
+            await vi.runAllTimersAsync();
+            const result = await runPromise;
+            expect(result.status).toBe('completed');
+            const calls = context.sessionGateway.dispatchCalls;
+            expect(calls).toHaveLength(1);
+            expect(calls[0]?.flags.permissionMode).toBe('bypassPermissions');
+            expect(JSON.stringify(calls[0])).not.toContain('-p ');
+            expect(JSON.stringify(calls[0])).not.toContain('--print');
+        });
+    });
+    describe('Scenario 2: Completion via MCP primary signal', () => {
+        it('reads the report from the conventional path, then stops and removes the session', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'dispatched', sessionId: parseSessionId('abc12345') });
+            context.completionBridge.scheduleCompletion(baseInput.jobId, {
+                source: 'mcp',
+                outcome: 'completed',
+                reason: null,
+            });
+            context.reportGateway.setReport({
+                content: '# Review content',
+                path: '/tmp/project/.claude/reviews/2026-05-22-MR-42-review.md',
+            });
+            const runPromise = runClaudeReviewJob(baseInput, context.deps);
+            await vi.runAllTimersAsync();
+            const result = await runPromise;
+            expect(result.status).toBe('completed');
+            if (result.status === 'completed') {
+                expect(result.content).toBe('# Review content');
+            }
+            expect(context.sessionGateway.stopCalls).toContain('abc12345');
+            expect(context.sessionGateway.removeCalls).toContain('abc12345');
+        });
+    });
+    describe('Scenario 3: Completion via polling fallback', () => {
+        it('detects completion through claude agents --json when MCP stays silent', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'dispatched', sessionId: parseSessionId('poll0001') });
+            context.sessionGateway.scheduleAgentCompletion('poll0001', 'completed', 1);
+            context.reportGateway.setReport({
+                content: '# Polled report',
+                path: '/tmp/project/.claude/reviews/2026-05-22-MR-42-review.md',
+            });
+            const runPromise = runClaudeReviewJob(baseInput, context.deps);
+            await vi.runAllTimersAsync();
+            const result = await runPromise;
+            expect(result.status).toBe('completed');
+            expect(context.sessionGateway.stopCalls).toContain('poll0001');
+            expect(context.sessionGateway.removeCalls).toContain('poll0001');
+        });
+    });
+    describe('Scenario 4: Hard timeout reached without completion signal', () => {
+        it('marks the job failed with reason "timeout" after 15 minutes', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'dispatched', sessionId: parseSessionId('time0001') });
+            let nowMs = new Date('2026-05-22T10:00:00Z').getTime();
+            const deps = { ...context.deps, now: () => new Date(nowMs) };
+            const runPromise = runClaudeReviewJob(baseInput, deps);
+            await Promise.resolve();
+            await Promise.resolve();
+            await Promise.resolve();
+            nowMs += 16 * 60 * 1000;
+            await vi.advanceTimersByTimeAsync(16 * 60 * 1000);
+            const result = await runPromise;
+            expect(result.status).toBe('failed');
+            if (result.status === 'failed') {
+                expect(result.reason).toBe('timeout');
+            }
+            expect(context.sessionGateway.stopCalls).toContain('time0001');
+            expect(context.sessionGateway.removeCalls).toContain('time0001');
+        });
+    });
+    describe('Scenario 5: Report file missing after completion', () => {
+        it('fails the job with reason "report-missing" and still runs cleanup', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'dispatched', sessionId: parseSessionId('rep00001') });
+            context.completionBridge.scheduleCompletion(baseInput.jobId, {
+                source: 'mcp',
+                outcome: 'completed',
+                reason: null,
+            });
+            context.reportGateway.setReport(null);
+            const runPromise = runClaudeReviewJob(baseInput, context.deps);
+            await vi.runAllTimersAsync();
+            const result = await runPromise;
+            expect(result.status).toBe('failed');
+            if (result.status === 'failed') {
+                expect(result.reason).toBe('report-missing');
+            }
+            expect(context.sessionGateway.stopCalls).toContain('rep00001');
+        });
+    });
+    describe('Scenario 6: Rate limit error on dispatch', () => {
+        it('returns a retry signal with exponential backoff', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'rate-limited', rawStderr: '429 Too Many Requests' });
+            const result = await runClaudeReviewJob(baseInput, context.deps);
+            expect(result.status).toBe('retry');
+            if (result.status === 'retry') {
+                expect(result.delayMs).toBe(60_000);
+                expect(result.attempt).toBe(1);
+            }
+        });
+    });
+    describe('Scenario 7: Supervisor down detection', () => {
+        it('records supervisor down status when daemon is unreachable', async () => {
+            const context = createContext();
+            context.sessionGateway.setDaemonStatus({ reachable: false, reason: 'connection refused' });
+            const health = await checkSupervisorHealth({
+                sessionGateway: context.sessionGateway,
+                supervisorHealthGateway: context.supervisorHealth,
+                now: () => new Date('2026-05-22T10:00:00Z'),
+            });
+            expect(health.status).toBe('down');
+            expect(context.supervisorHealth.read().status).toBe('down');
+        });
+    });
+    describe('Scenario 8: Billing regression detected pre-dispatch', () => {
+        it('aborts dispatch when ANTHROPIC_API_KEY is present in the environment', async () => {
+            const context = createContext();
+            context.environment.setHasAnthropicApiKey(true);
+            const result = await runClaudeReviewJob(baseInput, context.deps);
+            expect(result.status).toBe('failed');
+            if (result.status === 'failed') {
+                expect(result.reason).toBe('billing-regression-prevented');
+            }
+            expect(context.sessionGateway.dispatchCalls).toHaveLength(0);
+        });
+    });
+    describe('Scenario 9: Periodic billing audit detects API consumption', () => {
+        it('pauses the dispatch queue when usage indicates API-pool consumption', async () => {
+            const context = createContext();
+            context.sessionGateway.setUsage({ usesApiPool: true, raw: 'API tokens used: 12345' });
+            const result = await auditBilling({
+                sessionGateway: context.sessionGateway,
+                billingStateGateway: context.billingState,
+                now: () => new Date('2026-05-22T10:00:00Z'),
+            });
+            expect(result.regression).toBe(true);
+            expect(context.billingState.read().dispatchPaused).toBe(true);
+        });
+    });
+    describe('Scenario 10: Followup job uses same --bg dispatch path', () => {
+        it('runs the followup through the same use case with jobType="followup"', async () => {
+            const context = createContext();
+            context.sessionGateway.setDispatchResult({ status: 'dispatched', sessionId: parseSessionId('foll0001') });
+            context.completionBridge.scheduleCompletion(baseInput.jobId, {
+                source: 'mcp',
+                outcome: 'completed',
+                reason: null,
+            });
+            context.reportGateway.setReport({
+                content: '# Followup report',
+                path: '/tmp/project/.claude/reviews/2026-05-22-MR-42-followup.md',
+            });
+            const runPromise = runClaudeReviewJob({ ...baseInput, jobType: 'followup' }, context.deps);
+            await vi.runAllTimersAsync();
+            const result = await runPromise;
+            expect(result.status).toBe('completed');
+            expect(context.reportGateway.lastReadJobType).toBe('followup');
+        });
+    });
+});
+//# sourceMappingURL=169-migrate-claude-invocation-to-bg-mode.acceptance.test.js.map