@straiffi/archon 1.7.7 → 1.7.9

package/dist/server/index.js

@@ -28,8 +28,8 @@ import { emitMobileRealtime, getMobileAccessStatus, regenerateMobilePairingChall
 import { validateDesktopMobileAccessRequest } from './lib/mobileAccessSecurity.js';
 import { refreshChatSessionUsageSnapshot, refreshSpecSessionUsageSnapshot, stopAllBuildAgents, stopAllReviewAgents, stopBuildAgent, stopReviewAgent } from './lib/agent.js';
 import { runLightweightPrompt } from './lib/lightweightPrompt.js';
-import { startBuildChain, stopBuildChain } from './lib/buildChains.js';
-import { activateQueuedBuildSequenceTicket, compensateBuildSequenceAcceptance, enqueueBundledBuild, getDependencyOrderedBundleTicketIds, hasActiveSequenceForBundle, removeTicketFromBuildSequence, stopBuildSequence, } from './lib/buildSequences.js';
+import { advanceBuildChain, startBuildChain, stopBuildChain } from './lib/buildChains.js';
+import { activateQueuedBuildSequenceTicket, compensateBuildSequenceAcceptance, enqueueBundledBuild, getDependencyOrderedBundleTicketIds, getBuildSequenceIdForTicket, hasActiveSequenceForBundle, removeTicketFromBuildSequence, stopBuildSequence, } from './lib/buildSequences.js';
 import { prepareTicketForBuild } from './lib/buildFlow.js';
 import { getBundlePlanMutationBlockerById, shouldBlockPlanForBundleMutationById, } from './lib/bundleActivity.js';
 import { getDiscoveredModels, normalizeModelId, normalizeTicketModelId } from './lib/models.js';
@@ -47,12 +47,14 @@ import { exportProjectMemoryArchive, importProjectMemoryArchive } from './lib/pr
 import { buildReviewFindingsResponse, computeDiffSignature, getLatestReviewRunForContext, listReviewFindings } from './lib/reviewFindings.js';
 import { formatBuildOpenQuestionAnswersPrompt, getLatestBuildOpenQuestionBatchStatus, hasActiveBuildOpenQuestionBatch, listBuildOpenQuestionsForBundle, loadBuildOpenQuestionsByBundleIds, } from './lib/buildOpenQuestions.js';
 import { acceptBuildOpenQuestionResolution } from './lib/buildOpenQuestionOperations.js';
-import { completeAutomationProgression, createAutomationReviewFix, finishAutomationReviewFix, getAutomationProgression, recoverLegacyAutomationProgression, recoverStoppedSideEffectProgression, runAutomationProgression, stopAutomationProgression, waitAutomationProgression } from './lib/automationProgression.js';
+import { completeAutomationProgression, createAutomationReviewFix, ensureAutomationProgression, finishAutomationReviewFix, getAutomationProgression, recoverLegacyAutomationProgression, recoverStoppedSideEffectProgression, runAutomationProgression, stopAutomationProgression, waitAutomationProgression } from './lib/automationProgression.js';
 import { reconcileAutomationStage } from './lib/automationReconciliation.js';
 import { pausedRunBelongsToProgression, resolveAutomationResumeDecision } from './lib/automationResumeDecision.js';
 import { getAutomationStageDetails, } from './lib/automationStageDetails.js';
 import { buildAutomationFixInstruction, clearAutomationPause, countBlockingFindings, depthAtLeast, getBundleAutomationState, isAutomationDepth, recordAutomationPause, resolveAutomationConfig, upsertBundleAutomationState, } from './lib/ticketAutomation.js';
-import { runAutomationCommitChain } from './lib/ticketAutomationCommit.js';
+import { resolveAutomationCheckGateResume, runAutomationCommitChain, runAutomationCommitOperation } from './lib/ticketAutomationCommit.js';
+import { canMutateBuildTicketCommitCheckpoint, resolveBuildTicketCommitCheckpointLineage } from './lib/buildTicketCommit.js';
+import { advanceSuccessfulBuildTicketAfterCheckpoint, compensateBuildSequenceTicketActivation } from './lib/buildCompletionContinuation.js';
 import { getDiscoveredSkills, normalizeSkillNames } from './lib/skills.js';
 import { clearAllPreviewProxies } from './lib/previewProxy.js';
 import { createExecutionRun, addExecutionRunLink, addExecutionRunLinks, getExecutionRun, hasActiveBuildExecutionRunForTicket, getGitHubActionsExecutionDetails, getTestExecutionDetails, GitHubActionsDispatchConflictError, listExecutionRunLinks, listExecutionRuns, listLifecycleEvents, listProjectLifecycleEvents, toCanonicalLifecycleEvent, transitionExecutionRun, withExecutionRunTransaction, } from './lib/executionRuns.js';
@@ -61,7 +63,7 @@ import { listExecutionTimeline } from './lib/executionTimeline.js';
 import { loadExecutionArtifactSummariesForRuns, openExecutionArtifactForRetrieval, } from './lib/executionArtifacts.js';
 import { cleanupAllExecutionEvidence, EXECUTION_EVIDENCE_CLEANUP_INTERVAL_MS, resolveExecutionEvidenceRetentionDays, } from './lib/executionRunRetention.js';
 import { ExecutionArtifactCleanupError, reconcileExecutionArtifactRegistrationIntents, reconcileFinalizedExecutionArtifacts, reconcileProjectExecutionArtifacts, resolveArtifactCleanupIntervalMs, } from './lib/executionArtifactRetention.js';
-import { shutdownRealtimeServer } from './lib/shutdown.js';
+import { closeHttpServer, shutdownRealtimeServer } from './lib/shutdown.js';
 import { resolveClientBuildPaths, shouldServeClientApp, STATIC_CLIENT_DIRECTORY_OPTIONS, STATIC_CLIENT_INDEX_OPTIONS, } from './lib/staticClient.js';
 import { deleteIntegrationConnection, getGitHubConnectionConfig, getJiraConnectionConfig, listIntegrationConnections, upsertIntegrationConnection, } from './lib/integrations/index.js';
 import { createGitHubPullRequest, createOrFindGitHubPullRequest, findOpenGitHubPullRequest, findOpenGitHubPullRequestByHeadBranch, getGitHubPullRequestComments, getGitHubPullRequestReviews, getGitHubPullRequest, GitHubApiError, hasGitHubRemoteBranch, resolveGitHubRepository, validateGitHubConnection, } from './lib/integrations/github.js';
@@ -75,9 +77,14 @@ import { PlanningReferenceError, resolveExternalPlanningDescription } from './li
 import { refreshIfNeeded as refreshAssignedIssues, clearCachedAssignedIssues } from './lib/integrations/assignedIssuesCache.js';
 import { buildCommitMessagePrompt, normalizeGeneratedCommitMessage } from './lib/commitMessage.js';
 import { BUNDLE_PULL_REQUEST_SYNC_TTL_MS, getBundlePullRequestRecord, hasOpenBundlePullRequest, serializeBundlePullRequest, shouldSyncBundlePullRequest, syncTrackedBundlePullRequestIfNeeded, upsertBundlePullRequest, upsertBundlePullRequestFromGitHub, } from './lib/bundlePullRequests.js';
-import { countInboundProjectLinks, getEffectiveProject, getProjectById, getProjectTicketStats, hasProjectRunIde, listInterruptedProjectDeletions, listProjects, releaseInterruptedProjectDeletionClaims, replaceProjectLinks, serializeProject, updateProjectActiveTarget, validateProjectPayload, } from './lib/projects.js';
+import { countInboundProjectLinks, getEffectiveProject, getProjectCheckDefinitions, getProjectById, getProjectTestCommands, getProjectTicketStats, hasProjectRunIde, listInterruptedProjectDeletions, listProjects, releaseInterruptedProjectDeletionClaims, replaceProjectLinks, serializeProject, updateProjectActiveTarget, validateProjectPayload, } from './lib/projects.js';
 import { getActiveRunStatus, getActiveRunStatusForProject, getPreviewStatusForProject, hasRunConfig, isRunning, openIde, openTicketIdeInWorkspace, resolveProjectRunContextKey, runSetupCommandsInWorkspace, runTicketInWorkspace, stopAllTickets, stopTicket } from './lib/run.js';
-import { clearAllTestSessions, createTestSession, deleteTestSession, discoverTestsForSession, doesTestFileExistForSession, findProjectTestCommand, getTestSession, isTestSelectionSupported, startTestSessionRun, stopTestSessionRun } from './lib/testSessions.js';
+import { clearAllTestSessions, createTestSession, deleteTestSession, discoverTestsForSession, doesTestFileExistForSession, getTestSession, isTestSelectionSupported, startTestSessionRun, stopTestSessionRun } from './lib/testSessions.js';
+import { closeCheckRunnerAdmissions, getCheckBatchAttempts, openCheckRunnerAdmissions, rerunCheckBatchAndSchedule, shutdownCheckRunner, startCheckBatch, stopCheckBatch } from './lib/checkRunner.js';
+import { findActiveCheckBatchForTarget, getCheckAttemptDetails, getCheckBatchDetails, hasActiveProjectCheckBatch, isCheckAttemptCurrent, resolveCheckBatchRerunEligibility } from './lib/checkRuns.js';
+import { getCheckDefinitionFingerprint } from './lib/checkDefinitions.js';
+import { getCheckGateEvaluation } from './lib/checkGateEvaluations.js';
+import { captureCheckWorkspaceIdentity } from './lib/checkWorkspaceIdentity.js';
 import { getBundleBuildBlockerResponse, shouldStartBundleBuildNow, transitionTicketState, } from './lib/ticketWorkflowOperations.js';
 import { submitPlanTicketFollowUp, submitTicketFollowUp, } from './lib/ticketFollowUpOperations.js';
 import { closePendingTicketPlanQuestionSet, listPendingTicketPlanQuestionSetMessageIds, resolveTicketPlanQuestionSet, restoreClosedTicketPlanQuestionSets, } from './lib/planQuestionOperations.js';
@@ -292,15 +299,90 @@ const serializeGitHubActionsExecutionDetail = (details) => {
         jobs_count: details.jobs_count,
     };
 };
-const buildExecutionRunDetailResponse = (project, run) => {
-    const retryEligibility = getExecutionRetryEligibility(project.id, run.id);
+const serializeCheckAttemptExecutionDetail = (projectId, runId) => {
+    const attempt = getCheckAttemptDetails(projectId, runId);
+    return {
+        kind: 'check_attempt',
+        available: true,
+        attempt,
+        batch: attempt ? getCheckBatchDetails(projectId, attempt.batch_run_id) : null,
+    };
+};
+const hydrateCheckAttemptCurrency = async (project, batch, attempts) => {
+    const terminalAttempts = attempts.filter(attempt => attempt.outcome !== null);
+    if (terminalAttempts.length === 0) {
+        return attempts.map(attempt => ({ ...attempt, currency: 'pending' }));
+    }
+    const workspace = resolveExplicitProjectTestWorkspace(project, batch.target_kind, batch.target_bundle_id);
+    if ('error' in workspace) {
+        return attempts.map(attempt => ({
+            ...attempt,
+            currency: attempt.outcome === null ? 'pending' : 'unavailable',
+        }));
+    }
+    const currentIdentity = await captureCheckWorkspaceIdentity(workspace.cwd);
+    const currentProject = getProjectById(project.id);
+    const definitionsById = new Map(getProjectCheckDefinitions(currentProject).map(definition => [definition.id, definition]));
+    return attempts.map(attempt => {
+        if (attempt.outcome === null) {
+            return { ...attempt, currency: 'pending' };
+        }
+        const definition = definitionsById.get(attempt.definition_id);
+        if (!definition || getCheckDefinitionFingerprint(definition) !== attempt.definition_fingerprint) {
+            return { ...attempt, currency: 'stale' };
+        }
+        const currency = currentIdentity.state === 'unavailable'
+            ? 'unavailable'
+            : isCheckAttemptCurrent(attempt, currentIdentity) ? 'current' : 'stale';
+        return { ...attempt, currency };
+    });
+};
+const getCheckBatchRerunEligibility = (project, batch, selection) => {
+    const workspace = resolveExplicitProjectTestWorkspace(project, batch.target_kind, batch.target_bundle_id);
+    return resolveCheckBatchRerunEligibility({
+        projectId: project.id,
+        batchRunId: batch.execution_run_id,
+        availableDefinitions: getProjectCheckDefinitions(project),
+        selection,
+        targetAvailable: !('error' in workspace && typeof workspace.error === 'string' && workspace.error.includes('no longer exists')),
+        workspaceAvailable: !('error' in workspace),
+    });
+};
+const buildExecutionRunDetailResponse = async (project, run) => {
+    const checkBatch = run.kind === 'check_batch' ? getCheckBatchDetails(project.id, run.id) : null;
+    const retryEligibility = checkBatch
+        ? getCheckBatchRerunEligibility(project, checkBatch)
+        : getExecutionRetryEligibility(project.id, run.id);
+    const checkBatchAttempts = checkBatch
+        ? await hydrateCheckAttemptCurrency(project, checkBatch, getCheckBatchAttempts(project.id, run.id))
+        : [];
+    const checkAttemptDetail = run.kind === 'check_attempt' ? serializeCheckAttemptExecutionDetail(project.id, run.id) : null;
+    const checkAttempt = checkAttemptDetail?.attempt && checkAttemptDetail.batch
+        ? (await hydrateCheckAttemptCurrency(project, checkAttemptDetail.batch, [checkAttemptDetail.attempt]))[0]
+        : checkAttemptDetail?.attempt ?? null;
     const details = run.kind === 'test'
         ? serializeTestExecutionDetail(getTestExecutionDetails(project.id, run.id), retryEligibility)
-        : run.kind === 'github_actions'
-            ? { ...serializeGitHubActionsExecutionDetail(getGitHubActionsExecutionDetails(project.id, run.id)), retry_eligibility: retryEligibility }
-            : ['automation_commit', 'automation_push', 'automation_pull_request'].includes(run.kind)
-                ? { kind: run.kind, available: true, automation_stage: getAutomationStageDetails(project.id, run.id), retry_eligibility: retryEligibility }
-                : { kind: run.kind, available: true, retry_eligibility: retryEligibility };
+        : run.kind === 'check_batch'
+            ? {
+                kind: 'check_batch',
+                available: true,
+                batch: checkBatch,
+                attempts: checkBatchAttempts,
+                retry_eligibility: retryEligibility,
+                action_kind: retryEligibility.eligible ? 'rerun' : null,
+            }
+            : run.kind === 'check_attempt'
+                ? {
+                    ...checkAttemptDetail,
+                    attempt: checkAttempt,
+                    retry_eligibility: retryEligibility,
+                    action_kind: null,
+                }
+                : run.kind === 'github_actions'
+                    ? { ...serializeGitHubActionsExecutionDetail(getGitHubActionsExecutionDetails(project.id, run.id)), retry_eligibility: retryEligibility }
+                    : ['automation_commit', 'automation_push', 'automation_pull_request'].includes(run.kind)
+                        ? { kind: run.kind, available: true, automation_stage: getAutomationStageDetails(project.id, run.id), retry_eligibility: retryEligibility }
+                        : { kind: run.kind, available: true, retry_eligibility: retryEligibility };
     const artifacts = loadExecutionArtifactSummariesForRuns(project.id, [run.id], MAX_ARTIFACTS_PER_RUN).get(run.id)
         ?? { artifacts: [], artifact_count: 0 };
     return {
@@ -3628,6 +3710,9 @@ app.delete('/bundles/:id', (req, res) => {
     if (result.project.active_target_kind === 'bundle' && result.project.active_target_bundle_id === bundle.id) {
         return res.status(409).json({ error: 'Cannot delete the currently selected target bundle' });
     }
+    if (findActiveCheckBatchForTarget(result.project.id, 'bundle', bundle.id)) {
+        return res.status(409).json({ error: 'Cannot delete a bundle while checks are running' });
+    }
     const affectedChatSessionIds = listChatSessions(result.project.id)
         .filter(chatSession => chatSession.target_bundle_id === bundle.id)
         .map(chatSession => chatSession.id);
@@ -3855,6 +3940,18 @@ app.post('/bundles/:id/build-open-questions/resolve', (req, res) => {
             io.emit('ticket:updated', ticket);
         }
         if (reviewResult && !reviewResult.ok) {
+            if (reviewResult.code === 'bundle_build_incomplete') {
+                completeAutomationProgression({
+                    projectId: result.project.id,
+                    bundleId: bundle.id,
+                    progressionRunId: accepted.progressionRunId,
+                    broadcaster: io,
+                });
+                for (const ticket of listDetailedBundleTickets(result.project.id, bundle.id)) {
+                    io.emit('ticket:updated', ticket);
+                }
+                return res.json(serializeBundleDetails(result.project, bundle));
+            }
             waitAutomationProgression({
                 projectId: result.project.id,
                 bundleId: bundle.id,
@@ -3868,8 +3965,8 @@ app.post('/bundles/:id/build-open-questions/resolve', (req, res) => {
             return res.status(reviewResult.status).json({ error: reviewResult.error });
         }
         return res.json(serializeBundleDetails(result.project, bundle, {
-            review_owner_ticket_id: reviewResult?.value?.id,
-            target_ticket_id: reviewResult?.value?.id,
+            review_owner_ticket_id: reviewResult?.ok ? reviewResult.value?.id : undefined,
+            target_ticket_id: reviewResult?.ok ? reviewResult.value?.id : undefined,
         }));
     }
     for (const ticket of listDetailedBundleTickets(result.project.id, bundle.id)) {
@@ -3976,7 +4073,7 @@ app.post('/bundles/:id/follow-up', (req, res) => {
     return res.status(response.status).json(response.value);
 });
 const AUTOMATION_SIDE_EFFECT_KINDS = new Set(['automation_commit', 'automation_push', 'automation_pull_request']);
-const AUTOMATION_WORKER_PAUSE_KINDS = new Set(['build', 'review', 'build_follow_up', 'automation_review_fix']);
+const AUTOMATION_WORKER_PAUSE_KINDS = new Set(['build', 'review', 'build_follow_up', 'automation_review_fix', 'check_batch']);
 app.post('/bundles/:id/resume-automation', async (req, res) => {
     const result = getRequiredProject(req);
     if ('error' in result) {
@@ -4052,6 +4149,194 @@ app.post('/bundles/:id/resume-automation', async (req, res) => {
     if (!revalidateDecision()) {
         return res.status(409).json({ error: 'Bundle automation state changed before Resume could start' });
     }
+    const checkpointLineage = resolveBuildTicketCommitCheckpointLineage({
+        projectId: result.project.id,
+        bundleId: bundle.id,
+        progressionRunId,
+    });
+    if (checkpointLineage) {
+        const owner = getTicket(decision.owner_ticket_id);
+        if (!owner || owner.id !== checkpointLineage.ticket.id || owner.agent_status !== 'done') {
+            return res.status(409).json({ error: 'Checkpoint progression owner is no longer the active Build ticket' });
+        }
+        let retryOfRunId;
+        let commitAlreadyComplete = false;
+        const stageRunId = bundleState.automation_paused_stage_run_id;
+        if (stageRunId) {
+            const stage = getExecutionRun(result.project.id, stageRunId);
+            if (!stage
+                || !['automation_commit', 'check_batch'].includes(stage.kind)
+                || !pausedRunBelongsToProgression(result.project.id, bundle.id, progressionRunId, stageRunId)) {
+                return res.status(409).json({ error: 'The paused checkpoint stage does not belong to the active progression' });
+            }
+            if (stage.kind === 'automation_commit') {
+                let reconciled;
+                try {
+                    reconciled = await reconcileAutomationStage({
+                        projectId: result.project.id,
+                        bundleId: bundle.id,
+                        progressionRunId,
+                        stageRunId,
+                    });
+                }
+                catch (error) {
+                    return res.status(409).json({ error: error instanceof Error ? error.message : String(error) });
+                }
+                if (reconciled.domainStatus === 'ambiguous') {
+                    return res.status(409).json({ error: 'The paused checkpoint commit is ambiguous and cannot be resumed safely.' });
+                }
+                if (reconciled.status === 'completed' && reconciled.domainStatus === 'reconciled_completed') {
+                    commitAlreadyComplete = true;
+                }
+                else if (reconciled.status === 'interrupted' && reconciled.domainStatus === 'reconciled_absent') {
+                    retryOfRunId = stage.id;
+                }
+                else {
+                    return res.status(409).json({ error: 'The paused checkpoint commit has no safely resumable outcome.' });
+                }
+            }
+        }
+        try {
+            if (!revalidateDecision()) {
+                return res.status(409).json({ error: 'Bundle automation state changed before Resume could start' });
+            }
+            runAutomationProgression({
+                projectId: result.project.id,
+                bundleId: bundle.id,
+                progressionRunId,
+                broadcaster: io,
+            });
+            if (commitAlreadyComplete) {
+                completeAutomationProgression({
+                    projectId: result.project.id,
+                    bundleId: bundle.id,
+                    progressionRunId,
+                    broadcaster: io,
+                });
+            }
+            else {
+                await runAutomationCommitOperation({
+                    ticket: owner,
+                    io,
+                    progressionRunId,
+                    retryOfRunId,
+                    mutationLabel: 'checkpoint commit',
+                    canCommitLive: canMutateBuildTicketCommitCheckpoint,
+                    shouldCompleteProgression: () => true,
+                    failureMode: 'throw',
+                    requiredProgressionPurpose: 'build_ticket_checkpoint',
+                });
+            }
+        }
+        catch (error) {
+            return res.status(409).json({ error: error instanceof Error ? error.message : String(error) });
+        }
+        const workflowContext = validateWorkflowContext(checkpointLineage.progression.metadata);
+        const continuation = advanceSuccessfulBuildTicketAfterCheckpoint({
+            ticket: owner,
+            emitUpdatedTickets,
+        });
+        if (continuation.nextBuild) {
+            const nextBuild = continuation.nextBuild;
+            const nextSequenceId = continuation.nextSequenceId;
+            const scheduling = startBuild(nextBuild, io, {
+                initiation: {
+                    initiator: 'automation',
+                    causalParentRunId: checkpointLineage.parent.id,
+                    workflowContext,
+                },
+                sequenceId: nextSequenceId,
+                accept: () => {
+                    const transition = prepareTicketForBuild(nextBuild.id, {
+                        ignoredBlockerTicketIds: continuation.ignoredBlockerTicketIds,
+                    });
+                    if (!transition.ok) {
+                        throw new Error(transition.error);
+                    }
+                    if (!nextSequenceId) {
+                        throw new Error('Build sequence no longer exists');
+                    }
+                    activateQueuedBuildSequenceTicket(nextSequenceId, transition.ticket.id);
+                    return {
+                        ticket: transition.ticket,
+                        sequenceId: nextSequenceId,
+                        compensate: () => compensateBuildSequenceTicketActivation(nextSequenceId, transition.ticket.id),
+                    };
+                },
+            });
+            if (!scheduling.accepted) {
+                const stoppedSequence = stopBuildSequence(nextBuild.id);
+                emitUpdatedTickets(stoppedSequence.affectedTicketIds);
+            }
+        }
+        else if (!continuation.nextTicketId && owner.project_id && owner.worktree_bundle_id) {
+            const resumedOwnerForReview = getTicket(owner.id) ?? owner;
+            const liveProject = getEffectiveProject(resumedOwnerForReview) ?? result.project;
+            const automationConfig = resolveAutomationConfig(resumedOwnerForReview.bundle ?? null, liveProject);
+            const autoReviewEnabled = depthAtLeast(automationConfig.depth, 'auto_review');
+            const latestBundleState = getBundleAutomationState(owner.project_id, owner.worktree_bundle_id);
+            const openQuestions = listBuildOpenQuestionsForBundle(owner.project_id, owner.worktree_bundle_id);
+            const shouldPauseForOpenQuestions = autoReviewEnabled
+                && automationConfig.pauseOnOpenQuestions
+                && openQuestions.length > 0;
+            if (shouldPauseForOpenQuestions) {
+                const reviewProgression = ensureAutomationProgression({
+                    projectId: owner.project_id,
+                    bundleId: owner.worktree_bundle_id,
+                    ticketId: owner.id,
+                    ticketTitle: owner.title,
+                    parentRunId: checkpointLineage.parent.id,
+                    workflowContext,
+                    broadcaster: io,
+                });
+                waitAutomationProgression({
+                    projectId: owner.project_id,
+                    bundleId: owner.worktree_bundle_id,
+                    progressionRunId: reviewProgression.runId,
+                    pauseCode: 'open_questions',
+                    pauseReason: `${openQuestions.length} unresolved Build open question${openQuestions.length === 1 ? '' : 's'}`,
+                    reasonCode: 'precondition_failed',
+                    pausedStageRunId: checkpointLineage.parent.id,
+                    broadcaster: io,
+                });
+            }
+            else if (autoReviewEnabled && (!latestBundleState?.automation_paused_reason || latestBundleState.automation_paused_code === 'open_questions')) {
+                const reviewProgression = ensureAutomationProgression({
+                    projectId: owner.project_id,
+                    bundleId: owner.worktree_bundle_id,
+                    ticketId: owner.id,
+                    ticketTitle: owner.title,
+                    parentRunId: checkpointLineage.parent.id,
+                    workflowContext,
+                    broadcaster: io,
+                });
+                const reviewResult = transitionBundleToReview(owner.project_id, owner.worktree_bundle_id, io, {
+                    automatic: true,
+                    initiation: {
+                        causalParentRunId: reviewProgression.runId,
+                        workflowContext,
+                    },
+                });
+                if (!reviewResult.ok) {
+                    waitAutomationProgression({
+                        projectId: owner.project_id,
+                        bundleId: owner.worktree_bundle_id,
+                        progressionRunId: reviewProgression.runId,
+                        pauseCode: 'review',
+                        pauseReason: reviewResult.error,
+                        reasonCode: 'stage_failed',
+                        pausedStageRunId: checkpointLineage.parent.id,
+                        broadcaster: io,
+                    });
+                }
+            }
+        }
+        const resumedOwner = getTicket(owner.id);
+        if (resumedOwner) {
+            io.emit('ticket:updated', resumedOwner);
+        }
+        return res.json(serializeBundleDetails(result.project, bundle));
+    }
     let sideEffectResume = null;
     if (bundleState.automation_paused_stage_run_id) {
         const stageRunId = bundleState.automation_paused_stage_run_id;
@@ -4272,7 +4557,7 @@ app.post('/bundles/:id/resume-automation', async (req, res) => {
                 return res.status(followUpResult.status).json({ error: followUpResult.error });
             }
         }
-        else if (decision.outcome === 'continue_commit_chain') {
+        else if (decision.outcome === 'continue_commit_chain' || decision.outcome === 'rerun_required_checks') {
             try {
                 if (!revalidateDecision()) {
                     return res.status(409).json({ error: 'Bundle automation state changed before Resume could start' });
@@ -4283,7 +4568,10 @@ app.post('/bundles/:id/resume-automation', async (req, res) => {
                     progressionRunId,
                     broadcaster: io,
                 });
-                await runAutomationCommitChain(owner, project, owner.bundle ?? null, automationConfig, io, progressionRunId);
+                const checkGateResume = decision.outcome === 'rerun_required_checks'
+                    ? resolveAutomationCheckGateResume(result.project.id, progressionRunId)
+                    : undefined;
+                await runAutomationCommitChain(owner, project, owner.bundle ?? null, automationConfig, io, progressionRunId, checkGateResume);
             }
             catch (error) {
                 return res.status(409).json({ error: error instanceof Error ? error.message : String(error) });
@@ -4376,6 +4664,11 @@ app.post('/bundles/:id/dismiss-automation-pause', async (req, res) => {
     catch (error) {
         return res.status(409).json({ error: error instanceof Error ? error.message : String(error) });
     }
+    const checkpointLineage = resolveBuildTicketCommitCheckpointLineage({
+        projectId: result.project.id,
+        bundleId: bundle.id,
+        progressionRunId,
+    });
     if (bundleState.automation_paused_stage_run_id) {
         const stage = getExecutionRun(result.project.id, bundleState.automation_paused_stage_run_id);
         if (!stage
@@ -4411,6 +4704,10 @@ app.post('/bundles/:id/dismiss-automation-pause', async (req, res) => {
         broadcaster: io,
         stopLocalWorker: worker => (worker.kind === 'review' ? stopReviewAgent(worker.ticket_id) : stopBuildAgent(worker.ticket_id)),
     });
+    if (checkpointLineage) {
+        const stoppedSequence = stopBuildSequence(checkpointLineage.ticket.id);
+        emitUpdatedTickets(stoppedSequence.affectedTicketIds);
+    }
     for (const ticket of listDetailedBundleTickets(result.project.id, bundle.id)) {
         io.emit('ticket:updated', ticket);
     }
@@ -5495,7 +5792,7 @@ app.post('/projects', (req, res) => {
         return res.status(400).json({ error: validation.error });
     }
     const projectCount = Number(db.prepare('SELECT COUNT(*) AS count FROM projects').get()?.count ?? 0);
-    const { name, repo_path, linked_project_ids, run_setup, run_services, test_commands, run_ide, preview_service_name, preview_path, preview_capability_mode, helper_model, helper_variant, commit_message_rules, auto_park_stale_tickets, memory_enabled, scan_include_globs_json, scan_exclude_globs_json, worktree_sync, spec_aware_code_review_enabled, automation_depth, automation_review_fix_enabled, automation_pause_on_open_questions, automation_review_severity, automation_review_max_iterations, } = validation.values;
+    const { name, repo_path, linked_project_ids, run_setup, run_services, check_definitions, required_check_definition_ids, test_commands, run_ide, preview_service_name, preview_path, preview_capability_mode, helper_model, helper_variant, commit_message_rules, commit_after_each_ticket, auto_park_stale_tickets, memory_enabled, scan_include_globs_json, scan_exclude_globs_json, worktree_sync, spec_aware_code_review_enabled, automation_depth, automation_review_fix_enabled, automation_pause_on_open_questions, automation_review_severity, automation_review_max_iterations, } = validation.values;
     if (!repo_path) {
         return res.status(400).json({ error: 'repo_path must be a non-empty string' });
     }
@@ -5515,6 +5812,8 @@ app.post('/projects', (req, res) => {
       repo_path,
       run_setup,
       run_services,
+      check_definitions,
+      required_check_definition_ids,
       test_commands,
       run_ide,
       preview_service_name,
@@ -5523,6 +5822,7 @@ app.post('/projects', (req, res) => {
       helper_model,
       helper_variant,
       commit_message_rules,
+      commit_after_each_ticket,
       auto_park_stale_tickets,
       memory_enabled,
       scan_include_globs_json,
@@ -5535,8 +5835,8 @@ app.post('/projects', (req, res) => {
       automation_review_severity,
       automation_review_max_iterations
     )
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, name, normalizedRepoPath, run_setup, run_services, test_commands, run_ide ?? null, preview_service_name ?? null, preview_path ?? null, preview_capability_mode ?? null, helper_model ?? null, helper_variant ?? null, commit_message_rules ?? null, auto_park_stale_tickets ?? 0, memory_enabled ?? 0, scan_include_globs_json ?? null, scan_exclude_globs_json ?? null, worktree_sync ?? null, spec_aware_code_review_enabled ?? 0, automation_depth ?? 'manual', automation_review_fix_enabled ?? 0, automation_pause_on_open_questions ?? 0, automation_review_severity ?? 'medium', automation_review_max_iterations ?? 3);
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, name, normalizedRepoPath, run_setup, run_services, check_definitions, required_check_definition_ids ?? '[]', test_commands, run_ide ?? null, preview_service_name ?? null, preview_path ?? null, preview_capability_mode ?? null, helper_model ?? null, helper_variant ?? null, commit_message_rules ?? null, commit_after_each_ticket ?? 0, auto_park_stale_tickets ?? 0, memory_enabled ?? 0, scan_include_globs_json ?? null, scan_exclude_globs_json ?? null, worktree_sync ?? null, spec_aware_code_review_enabled ?? 0, automation_depth ?? 'manual', automation_review_fix_enabled ?? 0, automation_pause_on_open_questions ?? 0, automation_review_severity ?? 'medium', automation_review_max_iterations ?? 3);
     replaceProjectLinks(id, linked_project_ids ?? []);
     ensureProjectRootBundle(id);
     if (projectCount === 0) {
@@ -6702,13 +7002,15 @@ app.patch('/projects/:id', (req, res) => {
             });
         }
     }
-    const { name, repo_path, linked_project_ids, run_setup, run_services, test_commands, run_ide, preview_service_name, preview_path, preview_capability_mode, helper_model, helper_variant, commit_message_rules, auto_park_stale_tickets, memory_enabled, scan_include_globs_json, scan_exclude_globs_json, worktree_sync, spec_aware_code_review_enabled, automation_depth, automation_review_fix_enabled, automation_pause_on_open_questions, automation_review_severity, automation_review_max_iterations, } = validation.values;
+    const { name, repo_path, linked_project_ids, run_setup, run_services, check_definitions, required_check_definition_ids, test_commands, run_ide, preview_service_name, preview_path, preview_capability_mode, helper_model, helper_variant, commit_message_rules, commit_after_each_ticket, auto_park_stale_tickets, memory_enabled, scan_include_globs_json, scan_exclude_globs_json, worktree_sync, spec_aware_code_review_enabled, automation_depth, automation_review_fix_enabled, automation_pause_on_open_questions, automation_review_severity, automation_review_max_iterations, } = validation.values;
     db.prepare(`
     UPDATE projects SET
       name = ?,
       repo_path = ?,
       run_setup = ?,
       run_services = ?,
+      check_definitions = ?,
+      required_check_definition_ids = ?,
       test_commands = ?,
       run_ide = ?,
       preview_service_name = ?,
@@ -6717,6 +7019,7 @@ app.patch('/projects/:id', (req, res) => {
       helper_model = ?,
       helper_variant = ?,
       commit_message_rules = ?,
+      commit_after_each_ticket = ?,
       auto_park_stale_tickets = ?,
       memory_enabled = ?,
       scan_include_globs_json = ?,
@@ -6730,7 +7033,7 @@ app.patch('/projects/:id', (req, res) => {
       automation_review_max_iterations = ?,
       updated_at = CURRENT_TIMESTAMP
     WHERE id = ?
-  `).run(name ?? project.name, repo_path ?? project.repo_path, hasOwn(validation.values, 'run_setup') ? run_setup : project.run_setup, hasOwn(validation.values, 'run_services') ? run_services : project.run_services, hasOwn(validation.values, 'test_commands') ? test_commands : project.test_commands, hasOwn(validation.values, 'run_ide') ? run_ide : project.run_ide, hasOwn(validation.values, 'preview_service_name') ? preview_service_name : project.preview_service_name, hasOwn(validation.values, 'preview_path') ? preview_path : project.preview_path, hasOwn(validation.values, 'preview_capability_mode') ? preview_capability_mode : project.preview_capability_mode, hasOwn(validation.values, 'helper_model') ? helper_model : project.helper_model, hasOwn(validation.values, 'helper_variant') ? helper_variant : project.helper_variant, hasOwn(validation.values, 'commit_message_rules') ? commit_message_rules : project.commit_message_rules, hasOwn(validation.values, 'auto_park_stale_tickets') ? auto_park_stale_tickets : project.auto_park_stale_tickets, hasOwn(validation.values, 'memory_enabled') ? memory_enabled : project.memory_enabled, hasOwn(validation.values, 'scan_include_globs_json') ? scan_include_globs_json : project.scan_include_globs_json, hasOwn(validation.values, 'scan_exclude_globs_json') ? scan_exclude_globs_json : project.scan_exclude_globs_json, hasOwn(validation.values, 'worktree_sync') ? worktree_sync : project.worktree_sync, hasOwn(validation.values, 'spec_aware_code_review_enabled') ? spec_aware_code_review_enabled : project.spec_aware_code_review_enabled, hasOwn(validation.values, 'automation_depth') ? automation_depth : project.automation_depth, hasOwn(validation.values, 'automation_review_fix_enabled') ? automation_review_fix_enabled : project.automation_review_fix_enabled, hasOwn(validation.values, 'automation_pause_on_open_questions') ? automation_pause_on_open_questions : project.automation_pause_on_open_questions, hasOwn(validation.values, 'automation_review_severity') ? automation_review_severity : project.automation_review_severity, hasOwn(validation.values, 'automation_review_max_iterations') ? automation_review_max_iterations : project.automation_review_max_iterations, req.params.id);
+  `).run(name ?? project.name, repo_path ?? project.repo_path, hasOwn(validation.values, 'run_setup') ? run_setup : project.run_setup, hasOwn(validation.values, 'run_services') ? run_services : project.run_services, hasOwn(validation.values, 'check_definitions') ? check_definitions : project.check_definitions, hasOwn(validation.values, 'required_check_definition_ids') ? required_check_definition_ids : project.required_check_definition_ids, hasOwn(validation.values, 'test_commands') ? test_commands : project.test_commands, hasOwn(validation.values, 'run_ide') ? run_ide : project.run_ide, hasOwn(validation.values, 'preview_service_name') ? preview_service_name : project.preview_service_name, hasOwn(validation.values, 'preview_path') ? preview_path : project.preview_path, hasOwn(validation.values, 'preview_capability_mode') ? preview_capability_mode : project.preview_capability_mode, hasOwn(validation.values, 'helper_model') ? helper_model : project.helper_model, hasOwn(validation.values, 'helper_variant') ? helper_variant : project.helper_variant, hasOwn(validation.values, 'commit_message_rules') ? commit_message_rules : project.commit_message_rules, hasOwn(validation.values, 'commit_after_each_ticket') ? commit_after_each_ticket : project.commit_after_each_ticket, hasOwn(validation.values, 'auto_park_stale_tickets') ? auto_park_stale_tickets : project.auto_park_stale_tickets, hasOwn(validation.values, 'memory_enabled') ? memory_enabled : project.memory_enabled, hasOwn(validation.values, 'scan_include_globs_json') ? scan_include_globs_json : project.scan_include_globs_json, hasOwn(validation.values, 'scan_exclude_globs_json') ? scan_exclude_globs_json : project.scan_exclude_globs_json, hasOwn(validation.values, 'worktree_sync') ? worktree_sync : project.worktree_sync, hasOwn(validation.values, 'spec_aware_code_review_enabled') ? spec_aware_code_review_enabled : project.spec_aware_code_review_enabled, hasOwn(validation.values, 'automation_depth') ? automation_depth : project.automation_depth, hasOwn(validation.values, 'automation_review_fix_enabled') ? automation_review_fix_enabled : project.automation_review_fix_enabled, hasOwn(validation.values, 'automation_pause_on_open_questions') ? automation_pause_on_open_questions : project.automation_pause_on_open_questions, hasOwn(validation.values, 'automation_review_severity') ? automation_review_severity : project.automation_review_severity, hasOwn(validation.values, 'automation_review_max_iterations') ? automation_review_max_iterations : project.automation_review_max_iterations, req.params.id);
     if (hasOwn(validation.values, 'linked_project_ids')) {
         replaceProjectLinks(project.id, linked_project_ids ?? []);
     }
@@ -6759,6 +7062,9 @@ const assertProjectDeletionEligible = (projectId, claimId) => {
     if (stats.ticketCount > 0 || stats.worktreeCount > 0 || stats.bundleCount > 0) {
         throw new ProjectDeletionError(409, 'Cannot delete a project with existing tickets, bundles, or worktrees');
     }
+    if (hasActiveProjectCheckBatch(projectId)) {
+        throw new ProjectDeletionError(409, 'Cannot delete a project while checks are active');
+    }
 };
 const completeClaimedProjectDeletion = async (projectId, claimId) => {
     await runExclusiveExecutionArtifactMaintenance(() => reconcileProjectExecutionArtifacts(projectId, {
@@ -6785,6 +7091,19 @@ const completeClaimedProjectDeletion = async (projectId, claimId) => {
                 db.prepare("DELETE FROM execution_artifacts WHERE project_id = ? AND availability = 'deleted'").run(projectId);
                 deleteProjectAttachments(projectId);
                 db.prepare(`
+          DELETE FROM check_gate_evaluation_attempts
+          WHERE evaluation_id IN (SELECT id FROM check_gate_evaluations WHERE project_id = ?)
+        `).run(projectId);
+                db.prepare('DELETE FROM check_gate_evaluations WHERE project_id = ?').run(projectId);
+                db.prepare(`
+          DELETE FROM check_attempt_details
+          WHERE execution_run_id IN (SELECT id FROM execution_runs WHERE project_id = ?)
+        `).run(projectId);
+                db.prepare(`
+          DELETE FROM check_batch_details
+          WHERE execution_run_id IN (SELECT id FROM execution_runs WHERE project_id = ?)
+        `).run(projectId);
+                db.prepare(`
           UPDATE execution_runs
           SET parent_run_id = NULL, retry_of_run_id = NULL
           WHERE project_id = ?
@@ -7671,6 +7990,186 @@ app.post('/projects/:id/test-sessions', (req, res) => {
         targetLabel: workspace.target_label,
     }));
 });
+app.post('/projects/:id/check-batches', async (req, res) => {
+    const project = getProjectById(req.params.id);
+    if (!project) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const body = req.body && typeof req.body === 'object' && !Array.isArray(req.body) ? req.body : null;
+    const targetKind = body?.target_kind === 'bundle'
+        ? 'bundle'
+        : body?.target_kind === 'repo_root'
+            ? 'repo_root'
+            : null;
+    if (!targetKind) {
+        return res.status(400).json({ error: 'target_kind must be repo_root or bundle' });
+    }
+    const definitionIds = parseCheckDefinitionIds(body?.definition_ids);
+    if (!definitionIds) {
+        return res.status(400).json({ error: 'definition_ids must contain at least one unique check definition ID' });
+    }
+    const definitions = getProjectCheckDefinitions(project);
+    const definitionsById = new Map(definitions.map(definition => [definition.id, definition]));
+    const selectedDefinitions = definitionIds.map(id => definitionsById.get(id)).filter((definition) => Boolean(definition));
+    if (selectedDefinitions.length !== definitionIds.length) {
+        return res.status(409).json({ error: 'One or more selected check definitions are stale or unavailable' });
+    }
+    const targetBundleId = typeof body?.target_bundle_id === 'string' ? body.target_bundle_id.trim() || null : null;
+    const workspace = resolveExplicitProjectTestWorkspace(project, targetKind, targetBundleId);
+    if ('error' in workspace) {
+        return res.status(Number(workspace.status)).json({ error: workspace.error });
+    }
+    try {
+        const batch = await startCheckBatch({
+            projectId: project.id,
+            cwd: workspace.cwd,
+            targetKind: workspace.target_kind,
+            targetBundleId: workspace.target_bundle_id,
+            targetLabel: workspace.target_label,
+            selectedDefinitions,
+            availableDefinitions: definitions,
+            sourceReference: { kind: 'project', id: project.id },
+        }, io);
+        return res.status(201).json({
+            batch,
+            attempts: getCheckBatchAttempts(project.id, batch.execution_run_id),
+        });
+    }
+    catch (error) {
+        return res.status(409).json({ error: getErrorMessage(error) });
+    }
+});
+const parseCheckDefinitionIds = (value) => {
+    if (!Array.isArray(value) || value.length === 0 || value.some(id => typeof id !== 'string' || id.trim() === '')) {
+        return null;
+    }
+    const ids = value.map(id => id.trim());
+    return ids.length === new Set(ids).size ? ids : null;
+};
+const parseCheckRerunSelection = (body) => {
+    const payload = body && typeof body === 'object' && !Array.isArray(body) ? body : {};
+    if (payload.mode === undefined || payload.mode === 'all') {
+        return { mode: 'all' };
+    }
+    if (payload.mode === 'failed_only') {
+        return { mode: 'failed' };
+    }
+    if (payload.mode !== 'selected') {
+        return { error: 'mode must be all, failed_only, or selected' };
+    }
+    const definitionIds = parseCheckDefinitionIds(payload.definition_ids);
+    if (!definitionIds) {
+        return { error: 'definition_ids must contain at least one unique source definition ID for selected reruns' };
+    }
+    return { mode: 'selected', definitionIds };
+};
+const rerunProjectCheckBatch = async (project, sourceBatchRunId, body) => {
+    const sourceBatch = getCheckBatchDetails(project.id, sourceBatchRunId);
+    if (!sourceBatch) {
+        return { ok: false, status: 404, error: 'Check batch not found', reason: 'status_not_retryable' };
+    }
+    const selection = parseCheckRerunSelection(body);
+    if ('error' in selection) {
+        return { ok: false, status: 400, error: selection.error, reason: 'retry_input_unavailable' };
+    }
+    const eligibility = getCheckBatchRerunEligibility(project, sourceBatch, selection);
+    if (!eligibility.eligible) {
+        return {
+            ok: false,
+            status: 409,
+            error: 'Check batch cannot be rerun with its current target and definitions',
+            reason: eligibility.reason,
+        };
+    }
+    const workspace = resolveExplicitProjectTestWorkspace(project, sourceBatch.target_kind, sourceBatch.target_bundle_id);
+    if ('error' in workspace) {
+        return { ok: false, status: Number(workspace.status), error: workspace.error, reason: 'retry_workspace_unavailable' };
+    }
+    try {
+        const value = await rerunCheckBatchAndSchedule({
+            projectId: project.id,
+            sourceBatchRunId,
+            cwd: workspace.cwd,
+            availableDefinitions: getProjectCheckDefinitions(project),
+            selection,
+        }, io);
+        return { ok: true, value };
+    }
+    catch (error) {
+        return { ok: false, status: 409, error: getErrorMessage(error), reason: 'retry_input_unavailable' };
+    }
+};
+app.get('/projects/:id/check-batches', (req, res) => {
+    const project = getProjectById(req.params.id);
+    if (!project) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const query = parseLifecycleListQuery(req.query);
+    if ('error' in query) {
+        return res.status(400).json({ error: query.error });
+    }
+    try {
+        return res.json(listExecutionTimeline({
+            project,
+            kind: 'check_batch',
+            statuses: query.statuses,
+            cursor: query.cursor,
+            limit: query.limit,
+        }));
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === 'Invalid execution run cursor') {
+            return res.status(400).json({ error: 'cursor must be a valid execution run cursor' });
+        }
+        throw error;
+    }
+});
+app.get('/projects/:id/check-batches/:batchRunId', async (req, res) => {
+    const project = getProjectById(req.params.id);
+    if (!project) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const batch = getCheckBatchDetails(req.params.id, req.params.batchRunId);
+    if (!batch) {
+        return res.status(404).json({ error: 'Check batch not found' });
+    }
+    return res.json({
+        batch,
+        attempts: await hydrateCheckAttemptCurrency(project, batch, getCheckBatchAttempts(req.params.id, req.params.batchRunId)),
+    });
+});
+app.get('/projects/:id/check-gate-evaluations/:evaluationId', (req, res) => {
+    const evaluation = getCheckGateEvaluation(req.params.id, req.params.evaluationId);
+    if (!evaluation) {
+        return res.status(404).json({ error: 'Check gate evaluation not found' });
+    }
+    return res.json(evaluation);
+});
+app.post('/projects/:id/check-batches/:batchRunId/stop', async (req, res) => {
+    if (!getCheckBatchDetails(req.params.id, req.params.batchRunId)) {
+        return res.status(404).json({ error: 'Check batch not found' });
+    }
+    try {
+        const batch = await stopCheckBatch(req.params.id, req.params.batchRunId, io);
+        return res.json({
+            batch,
+            attempts: getCheckBatchAttempts(req.params.id, req.params.batchRunId),
+        });
+    }
+    catch (error) {
+        return res.status(409).json({ error: getErrorMessage(error) });
+    }
+});
+app.post('/projects/:id/check-batches/:batchRunId/rerun', async (req, res) => {
+    const project = getProjectById(req.params.id);
+    if (!project) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const result = await rerunProjectCheckBatch(project, req.params.batchRunId, req.body);
+    return result.ok
+        ? res.status(201).json(result.value)
+        : res.status(result.status).json({ error: result.error });
+});
 app.get('/projects/:id/execution-runs', (req, res) => {
     const project = getProjectById(req.params.id);
     if (!project) {
@@ -7755,7 +8254,7 @@ app.get('/projects/:id/execution-timeline', (req, res) => {
         throw error;
     }
 });
-app.get('/projects/:id/execution-timeline/:runId', (req, res) => {
+app.get('/projects/:id/execution-timeline/:runId', async (req, res) => {
     const project = getProjectById(req.params.id);
     if (!project) {
         return res.status(404).json({ error: 'Not found' });
@@ -7772,9 +8271,9 @@ app.get('/projects/:id/execution-timeline/:runId', (req, res) => {
     if (scope.scopeEntity && !links.some(link => link.entity_type === scope.scopeEntity?.type && link.entity_id === scope.scopeEntity.id)) {
         return res.status(404).json({ error: 'Execution run not found' });
     }
-    return res.json(buildExecutionRunDetailResponse(project, run));
+    return res.json(await buildExecutionRunDetailResponse(project, run));
 });
-app.get('/projects/:id/execution-runs/:runId', (req, res) => {
+app.get('/projects/:id/execution-runs/:runId', async (req, res) => {
     const project = getProjectById(req.params.id);
     if (!project) {
         return res.status(404).json({ error: 'Not found' });
@@ -7783,7 +8282,7 @@ app.get('/projects/:id/execution-runs/:runId', (req, res) => {
     if (!run) {
         return res.status(404).json({ error: 'Execution run not found' });
     }
-    return res.json(buildExecutionRunDetailResponse(project, run));
+    return res.json(await buildExecutionRunDetailResponse(project, run));
 });
 app.get('/projects/:id/execution-runs/:runId/artifacts/:artifactId', async (req, res) => {
     const project = getProjectById(req.params.id);
@@ -7827,6 +8326,13 @@ app.post('/projects/:id/execution-runs/:runId/retry', async (req, res) => {
     if (!project) {
         return res.status(404).json({ error: 'Not found' });
     }
+    const source = getExecutionRun(project.id, req.params.runId);
+    if (source?.kind === 'check_batch') {
+        const result = await rerunProjectCheckBatch(project, source.id, req.body);
+        return result.ok
+            ? res.status(201).json(result.value)
+            : res.status(result.status).json({ error: result.error, reason: result.reason });
+    }
     const resolution = resolveExecutionRetry(project.id, req.params.runId);
     const result = await dispatchExecutionRetry(resolution, io, async (retry) => {
         const session = createTestSession({
@@ -7892,7 +8398,7 @@ app.get('/test-sessions/:id/discovery', (req, res) => {
         if (!project) {
             return res.status(404).json({ error: 'Project not found' });
         }
-        command = findProjectTestCommand(project, commandId);
+        command = getProjectTestCommands(project).find(item => item.id === commandId) ?? null;
         if (!command) {
             return res.status(404).json({ error: 'Test command not found' });
         }
@@ -7928,7 +8434,7 @@ app.post('/test-sessions/:id/run', async (req, res) => {
     if (!selection) {
         return res.status(400).json({ error: 'selection must be all, file, or case' });
     }
-    const command = findProjectTestCommand(project, commandId);
+    const command = getProjectTestCommands(project).find(item => item.id === commandId) ?? null;
     if (!command) {
         return res.status(404).json({ error: 'Test command not found' });
     }
@@ -8305,6 +8811,7 @@ export const startServer = ({ port = DEFAULT_PORT, host } = {}) => {
                 };
                 httpServer.once('error', handleError);
                 const { bindHost } = resolveDesktopServerHost(host);
+                openCheckRunnerAdmissions();
                 httpServer.listen(port, bindHost, handleListening);
             });
         }
@@ -8328,6 +8835,9 @@ export const shutdownServer = async (signal) => {
         return shutdownServerPromise;
     }
     shutdownRequested = true;
+    closeCheckRunnerAdmissions();
+    const httpServerClosePromise = httpServer.listening ? closeHttpServer(httpServer) : null;
+    void httpServerClosePromise?.catch(() => undefined);
     const pendingStartup = startServerPromise;
     shutdownServerPromise = (async () => {
         await Promise.all([
@@ -8344,6 +8854,7 @@ export const shutdownServer = async (signal) => {
         }
         await executionArtifactCleanupPromise;
         await stopMobileAccess();
+        await shutdownCheckRunner();
         await clearAllTestSessions(io);
         await clearAllGitHubActionsSessions();
         await shutdownRealtimeServer({
@@ -8356,6 +8867,7 @@ export const shutdownServer = async (signal) => {
             stopAllReviewAgents,
             stopAllPlanAgents,
             stopAllTickets,
+            httpServerClosePromise,
         });
     })().finally(() => {
         shutdownRequested = false;