@straiffi/archon 1.7.6 → 1.7.8

package/dist/server/index.js

@@ -8,11 +8,11 @@ import { createHash, randomUUID } from 'crypto';
 import cors from 'cors';
 import { adjectives, animals, uniqueNamesGenerator } from 'unique-names-generator';
 import db from './db.js';
-import { deleteChatSession, getChatSession, listChatSessions, updateChatSessionMode } from './lib/chats.js';
+import { deleteChatSession, getChatSession, listChatSessions } from './lib/chats.js';
 import { deleteSpecSession, getCreatedTicketIdsForSnapshot, getSpecSession, getSpecSnapshot, listSpecSessions } from './lib/specs.js';
 import { createChatAttachment, createSpecAttachment, getAttachmentById, deleteChatAttachment, deleteProjectAttachments, deleteSpecSessionAttachment, getChatAttachmentForSession, getChatAttachmentLinkedMessageId, getSpecAttachmentForSession, getSpecAttachmentLinkedMessageId, MAX_CHAT_ATTACHMENTS_PER_TURN, MAX_CHAT_ATTACHMENT_SIZE_BYTES, MAX_SPEC_ATTACHMENTS_PER_TURN, MAX_SPEC_ATTACHMENT_SIZE_BYTES, readChatAttachmentContent, readSpecAttachmentContent, validateImageAttachment, } from './lib/attachments.js';
-import { createProjectChatSession, resolveChatMode, resolveChatTool, stopProjectChatSessionResponse, submitProjectChatSessionMessage, } from './lib/chatOperations.js';
-import { createProjectSpecSession, deleteProjectSpecSession, stopProjectSpecSessionResponse, submitProjectSpecSessionMessage, updateProjectSpecSessionMode, } from './lib/specOperations.js';
+import { createProjectChatSession, resolveChatTool, resolveProjectChatPlanQuestionSet, stopProjectChatSessionResponse, submitProjectChatSessionMessage, updateProjectChatSessionMode, } from './lib/chatOperations.js';
+import { createProjectSpecSession, deleteProjectSpecSession, resolveProjectSpecPlanQuestionSet, stopProjectSpecSessionResponse, submitProjectSpecSessionMessage, updateProjectSpecSessionMode, } from './lib/specOperations.js';
 import { buildProjectSpecReviewRevisionDraft, getProjectSpecReviewFindings, startProjectSpecReview, stopProjectSpecReview, } from './lib/specReviewOperations.js';
 import { resolveChatSessionTarget } from './lib/chatTargets.js';
 import { createChatMessage, getChatMessage, updateChatMessageContent } from './lib/chatMessages.js';
@@ -52,7 +52,7 @@ 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 } from './lib/ticketAutomationCommit.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 +61,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,11 +75,18 @@ 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';
+import { hasPendingAskQuestionSet } from './lib/planQuestions.js';
 import { canUseBuildControls, formatActiveRunConflict, getTicketRunReadinessError, resumeBuildTicketRun, runProjectTarget, runTicketRun, stopBuildTicketRun, stopReviewTicketRun, stopProjectTargetRun, stopTicketRun, } from './lib/ticketRunOperations.js';
 import { isTicketAgentSettingsPayload, updateTicketAgentSettings, } from './lib/ticketSettingsOperations.js';
 import { rerunTicketReviewOperation, resolveBundleReviewOwner, transitionBundleToReview } from './lib/bundleReviewOperations.js';
@@ -290,15 +297,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 {
@@ -1752,6 +1834,10 @@ const buildBundleTickets = (projectId, bundleId, broadcaster) => {
         }
     }
     const movedTickets = [];
+    const pendingQuestionMessageIds = new Map(orderedPlanTickets.map(ticket => [
+        ticket.id,
+        listPendingTicketPlanQuestionSetMessageIds(ticket.id),
+    ]));
     const ticketSnapshots = orderedPlanTickets.map(ticket => db.prepare(`
     SELECT id, project_id, state, tool, agent_status, agent_log, streaming_response, branch,
       build_completed_at, run_setup_status, auto_park_dismissed_at, planning_context_json, lane_order
@@ -1765,6 +1851,7 @@ const buildBundleTickets = (projectId, bundleId, broadcaster) => {
     const acceptBundleBuild = () => {
         let activeSequenceId = null;
         for (const [index, planTicket] of orderedPlanTickets.entries()) {
+            closePendingTicketPlanQuestionSet(planTicket.id);
             const buildTransition = prepareTicketForBuild(planTicket.id, {
                 ignoredBlockerTicketIds: bundleTicketIds,
             });
@@ -1797,6 +1884,7 @@ const buildBundleTickets = (projectId, bundleId, broadcaster) => {
                     planning_context_json = ?, lane_order = ?, updated_at = CURRENT_TIMESTAMP
                   WHERE id = ? AND project_id = ?
                 `).run(snapshot.state, snapshot.tool, snapshot.agent_status, snapshot.agent_log, snapshot.streaming_response, snapshot.branch, snapshot.build_completed_at, snapshot.run_setup_status, snapshot.auto_park_dismissed_at, snapshot.planning_context_json, snapshot.lane_order, snapshot.id, snapshot.project_id);
+                            restoreClosedTicketPlanQuestionSets(snapshot.id, pendingQuestionMessageIds.get(snapshot.id) ?? []);
                         }
                     },
                 }
@@ -2406,20 +2494,10 @@ app.get('/projects/:id/chat-sessions/:sessionId/agent-runs', (req, res) => {
     return res.json({ runs: listAgentRunsForParent('chat', chatSession.id) });
 });
 app.patch('/projects/:id/chat-sessions/:sessionId', (req, res) => {
-    const project = getProjectById(req.params.id);
-    if (!project) {
-        return res.status(404).json({ error: 'Not found' });
-    }
-    const existing = getProjectChatSession(project.id, req.params.sessionId);
-    if (!existing) {
-        return res.status(404).json({ error: 'Not found' });
-    }
-    const updated = updateChatSessionMode(existing.id, resolveChatMode(req.body.mode));
-    if (!updated) {
-        return res.status(404).json({ error: 'Not found' });
-    }
-    io.emit('chat-session:updated', updated);
-    return res.json(updated);
+    const result = updateProjectChatSessionMode({ projectId: req.params.id, chatSessionId: req.params.sessionId, payload: req.body, broadcaster: io });
+    return result.ok
+        ? res.status(result.status).json(result.value)
+        : res.status(result.status).json({ error: result.error, ...(result.value ? { chat_session: result.value } : {}) });
 });
 app.post('/projects/:id/chat-sessions/:sessionId/messages', (req, res) => {
     const result = submitProjectChatSessionMessage({
@@ -2429,10 +2507,22 @@ app.post('/projects/:id/chat-sessions/:sessionId/messages', (req, res) => {
         broadcaster: io,
     });
     if (!result.ok) {
-        return res.status(result.status).json({ error: result.error });
+        return res.status(result.status).json({ error: result.error, ...(result.value ? { chat_session: result.value } : {}) });
     }
     return res.status(result.status).json(result.value);
 });
+app.post('/projects/:id/chat-sessions/:sessionId/plan-questions/:messageId/resolve', (req, res) => {
+    const result = resolveProjectChatPlanQuestionSet({
+        projectId: req.params.id,
+        chatSessionId: req.params.sessionId,
+        messageId: req.params.messageId,
+        payload: req.body,
+        broadcaster: io,
+    });
+    return result.ok
+        ? res.status(result.status).json(result.value)
+        : res.status(result.status).json({ error: result.error, ...(result.value ? { chat_session: result.value } : {}) });
+});
 app.post('/projects/:id/chat-sessions/:sessionId/attachments', (req, res) => {
     const project = getProjectById(req.params.id);
     if (!project) {
@@ -2720,7 +2810,7 @@ app.patch('/projects/:id/spec-sessions/:sessionId', (req, res) => {
         broadcaster: io,
     });
     if (!result.ok) {
-        return res.status(result.status).json({ error: result.error });
+        return res.status(result.status).json({ error: result.error, ...(result.value ? { spec_session: result.value } : {}) });
     }
     return res.status(result.status).json(result.value);
 });
@@ -2732,10 +2822,22 @@ app.post('/projects/:id/spec-sessions/:sessionId/messages', (req, res) => {
         broadcaster: io,
     });
     if (!result.ok) {
-        return res.status(result.status).json({ error: result.error });
+        return res.status(result.status).json({ error: result.error, ...(result.value ? { spec_session: result.value } : {}) });
     }
     return res.status(result.status).json(result.value);
 });
+app.post('/projects/:id/spec-sessions/:sessionId/plan-questions/:messageId/resolve', (req, res) => {
+    const result = resolveProjectSpecPlanQuestionSet({
+        projectId: req.params.id,
+        specSessionId: req.params.sessionId,
+        messageId: req.params.messageId,
+        payload: req.body,
+        broadcaster: io,
+    });
+    return result.ok
+        ? res.status(result.status).json(result.value)
+        : res.status(result.status).json({ error: result.error, ...(result.value ? { spec_session: result.value } : {}) });
+});
 app.post('/projects/:id/spec-sessions/:sessionId/attachments', (req, res) => {
     const project = getProjectById(req.params.id);
     if (!project) {
@@ -3606,6 +3708,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);
@@ -3954,7 +4059,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) {
@@ -4250,7 +4355,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' });
@@ -4261,7 +4366,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) });
@@ -5473,7 +5581,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, 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' });
     }
@@ -5493,6 +5601,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,
@@ -5513,8 +5623,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, 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) {
@@ -6680,13 +6790,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, 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 = ?,
@@ -6708,7 +6820,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, '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 ?? []);
     }
@@ -6737,6 +6849,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, {
@@ -6763,6 +6878,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 = ?
@@ -7649,6 +7777,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) {
@@ -7733,7 +8041,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' });
@@ -7750,9 +8058,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' });
@@ -7761,7 +8069,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);
@@ -7805,6 +8113,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({
@@ -7870,7 +8185,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' });
         }
@@ -7906,7 +8221,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' });
     }
@@ -8049,7 +8364,7 @@ app.post('/tickets/:id/follow-up', (req, res) => {
         broadcaster: io,
     });
     if (!result.ok) {
-        return res.status(result.status).json({ error: result.error });
+        return res.status(result.status).json({ error: result.error, ...(result.value ? { ticket: result.value } : {}) });
     }
     return res.status(result.status).json(result.value);
 });
@@ -8061,10 +8376,25 @@ app.post('/tickets/:id/plan-follow-up', (req, res) => {
         broadcaster: io,
     });
     if (!result.ok) {
-        return res.status(result.status).json({ error: result.error });
+        return res.status(result.status).json({ error: result.error, ...(result.value ? { ticket: result.value } : {}) });
     }
     return res.status(result.status).json(result.value);
 });
+app.post('/tickets/:id/plan-questions/:messageId/resolve', (req, res) => {
+    const result = resolveTicketPlanQuestionSet({
+        ticketId: req.params.id,
+        requestedProjectId: getRequestedProjectId(req),
+        messageId: req.params.messageId,
+        setId: typeof req.body?.set_id === 'string' ? req.body.set_id : '',
+        rawResolutions: req.body?.resolutions,
+        dismissAll: req.body?.dismiss_all === true,
+        broadcaster: io,
+    });
+    if (!result.ok) {
+        return res.status(result.status).json({ error: result.error, ...(result.value ? { ticket: result.value } : {}) });
+    }
+    return res.status(result.status).json({ ticket: result.value, kind: result.kind, execution_context: result.executionContext });
+});
 app.post('/tickets/:id/plan', (req, res) => {
     const ticket = getTicket(req.params.id);
     if (!ticket) {
@@ -8076,6 +8406,12 @@ app.post('/tickets/:id/plan', (req, res) => {
     if (ticket.state !== 'plan') {
         return res.status(400).json({ error: 'Only plan-state tickets can be planned' });
     }
+    if (hasPendingAskQuestionSet(ticket.messages)) {
+        return res.status(409).json({
+            error: 'Resolve or dismiss the pending question set before continuing.',
+            ticket,
+        });
+    }
     const bundleSelection = resolveRequestedBundleSelection(req.body, ticket.project_id);
     if ('error' in bundleSelection) {
         return res.status(bundleSelection.status).json({ error: bundleSelection.error });
@@ -8262,6 +8598,7 @@ export const startServer = ({ port = DEFAULT_PORT, host } = {}) => {
                 };
                 httpServer.once('error', handleError);
                 const { bindHost } = resolveDesktopServerHost(host);
+                openCheckRunnerAdmissions();
                 httpServer.listen(port, bindHost, handleListening);
             });
         }
@@ -8285,6 +8622,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([
@@ -8301,6 +8641,7 @@ export const shutdownServer = async (signal) => {
         }
         await executionArtifactCleanupPromise;
         await stopMobileAccess();
+        await shutdownCheckRunner();
         await clearAllTestSessions(io);
         await clearAllGitHubActionsSessions();
         await shutdownRealtimeServer({
@@ -8313,6 +8654,7 @@ export const shutdownServer = async (signal) => {
             stopAllReviewAgents,
             stopAllPlanAgents,
             stopAllTickets,
+            httpServerClosePromise,
         });
     })().finally(() => {
         shutdownRequested = false;