@straiffi/archon 1.8.7 → 1.8.9

package/dist/server/lib/checkAutoFixDetails.js

@@ -0,0 +1,83 @@
+import db from '../db.js';
+const MAX_ATTEMPTS = 3;
+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled', 'interrupted']);
+export const getCheckAutoFixDetails = (projectId, runOrBatchId) => {
+    const tablesAvailable = db.prepare(`
+    SELECT COUNT(*) AS count FROM sqlite_master
+    WHERE type = 'table' AND name IN ('check_auto_fix_loops', 'check_auto_fix_attempts', 'lifecycle_events')
+  `).get();
+    if (tablesAvailable.count !== 3) {
+        return null;
+    }
+    const loop = db.prepare(`
+    SELECT loop.*, run.status AS execution_status FROM check_auto_fix_loops loop
+    JOIN execution_runs run ON run.id = loop.execution_run_id
+    WHERE run.project_id = ? AND (
+      loop.execution_run_id = ? OR loop.originating_batch_run_id = ? OR loop.final_batch_run_id = ?
+      OR EXISTS (
+        SELECT 1 FROM check_auto_fix_attempts attempt
+        WHERE attempt.loop_run_id = loop.execution_run_id
+          AND (attempt.source_batch_run_id = ? OR attempt.rerun_batch_run_id = ?)
+      )
+    )
+    ORDER BY loop.created_at DESC LIMIT 1
+  `).get(projectId, runOrBatchId, runOrBatchId, runOrBatchId, runOrBatchId, runOrBatchId);
+    if (!loop) {
+        return null;
+    }
+    const rows = db.prepare(`
+    SELECT attempt.ordinal, attempt.source_batch_run_id, attempt.child_run_id,
+      attempt.launch_outcome, attempt.rerun_batch_run_id, attempt.terminal_reason,
+      attempt.terminal_message, attempt.created_at, attempt.updated_at,
+      EXISTS (
+        SELECT 1 FROM lifecycle_events event
+        WHERE event.execution_run_id = attempt.loop_run_id
+          AND event.event_type = 'check_auto_fix_fallback'
+          AND json_extract(event.metadata_json, '$.attempt') = attempt.ordinal
+      ) AS fallback_used,
+      child.status AS child_status, rerun.status AS rerun_status
+    FROM check_auto_fix_attempts attempt
+    LEFT JOIN execution_runs child ON child.id = attempt.child_run_id
+    LEFT JOIN execution_runs rerun ON rerun.id = attempt.rerun_batch_run_id
+    WHERE attempt.loop_run_id = ? ORDER BY attempt.ordinal
+  `).all(loop.execution_run_id);
+    const active = rows[rows.length - 1];
+    const phase = loop.terminal_reason
+        ? 'terminal'
+        : loop.cancellation_requested
+            ? 'stopping'
+            : active?.rerun_batch_run_id && active.rerun_status && !TERMINAL_STATUSES.has(active.rerun_status)
+                ? 'rerunning'
+                : active?.child_run_id && active.child_status && !TERMINAL_STATUSES.has(active.child_status)
+                    ? 'repairing'
+                    : 'dispatching';
+    return {
+        execution_run_id: loop.execution_run_id,
+        execution_status: loop.execution_status,
+        phase,
+        originating_batch_run_id: loop.originating_batch_run_id,
+        final_batch_run_id: loop.final_batch_run_id ?? loop.originating_batch_run_id,
+        owner_type: loop.owner_type,
+        owner_id: loop.owner_id,
+        causal_execution_run_id: loop.causal_execution_run_id,
+        causal_agent_run_id: loop.causal_agent_run_id,
+        attempt_count: loop.attempt_count,
+        max_attempts: MAX_ATTEMPTS,
+        cancellation_requested: loop.cancellation_requested === 1,
+        terminal_reason: loop.terminal_reason,
+        terminal_message: loop.terminal_message,
+        attempts: rows.map(row => ({
+            ordinal: row.ordinal,
+            source_batch_run_id: row.source_batch_run_id,
+            child_run_id: row.child_run_id,
+            continuation: row.launch_outcome === 'continued' || row.launch_outcome === 'fresh' ? row.launch_outcome : null,
+            fallback_used: row.fallback_used === 1,
+            rerun_batch_run_id: row.rerun_batch_run_id,
+            terminal_reason: row.terminal_reason,
+            terminal_message: row.terminal_message,
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        })),
+    };
+};
+//# sourceMappingURL=checkAutoFixDetails.js.map

package/dist/server/lib/checkAutoFixDetails.js.map

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

package/dist/server/lib/checkAutoFixPolicy.js

@@ -0,0 +1,59 @@
+import { createHash } from 'crypto';
+import { getCheckDefinitionFingerprint } from './checkDefinitions.js';
+import { parseRequiredCheckDefinitionIds } from './requiredCheckPolicy.js';
+const updateLengthDelimited = (hash, value) => {
+    const buffer = Buffer.from(value, 'utf8');
+    const length = Buffer.alloc(8);
+    length.writeBigUInt64BE(BigInt(buffer.length));
+    hash.update(length).update(buffer);
+};
+const compareDefinitionIds = (left, right) => (Buffer.compare(Buffer.from(left.id, 'utf8'), Buffer.from(right.id, 'utf8')));
+const snapshotDefinition = (definition) => ({
+    id: definition.id,
+    name: definition.name,
+    category: definition.category,
+    command: definition.command,
+    ...(definition.cwd ? { cwd: definition.cwd } : {}),
+    timeout_ms: definition.timeout_ms,
+    ...(definition.category === 'test' ? { runner: definition.runner } : {}),
+});
+export const getCheckAutoFixPolicyFingerprint = (definitions) => {
+    const hash = createHash('sha256');
+    updateLengthDelimited(hash, 'archon-check-auto-fix-policy-v1');
+    for (const definition of [...definitions].sort(compareDefinitionIds)) {
+        updateLengthDelimited(hash, definition.id);
+        updateLengthDelimited(hash, getCheckDefinitionFingerprint(definition));
+    }
+    return hash.digest('hex');
+};
+export const createCheckAutoFixPolicySnapshot = (project, selectedDefinitionSnapshots) => {
+    const membership = parseRequiredCheckDefinitionIds(project.auto_fix_check_definition_ids, 'auto_fix_check_definition_ids');
+    if ('error' in membership) {
+        return { status: 'invalid', error: membership.error };
+    }
+    const membershipSet = new Set(membership.value);
+    const definitions = selectedDefinitionSnapshots
+        .filter(definition => membershipSet.has(definition.id))
+        .map(snapshotDefinition)
+        .sort(compareDefinitionIds);
+    return {
+        status: 'valid',
+        snapshot: {
+            definitionIds: definitions.map(definition => definition.id),
+            definitions,
+            fingerprint: getCheckAutoFixPolicyFingerprint(definitions),
+        },
+    };
+};
+export const doCurrentDefinitionsMatchCheckAutoFixPolicySnapshot = (snapshot, currentDefinitions) => {
+    if (snapshot.fingerprint !== getCheckAutoFixPolicyFingerprint(snapshot.definitions)) {
+        return false;
+    }
+    const currentDefinitionsById = new Map(currentDefinitions.map(definition => [definition.id, definition]));
+    return snapshot.definitions.every(definition => {
+        const currentDefinition = currentDefinitionsById.get(definition.id);
+        return currentDefinition !== undefined
+            && getCheckDefinitionFingerprint(currentDefinition) === getCheckDefinitionFingerprint(definition);
+    });
+};
+//# sourceMappingURL=checkAutoFixPolicy.js.map

package/dist/server/lib/checkAutoFixPolicy.js.map

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

package/dist/server/lib/checkRepair.js

@@ -1,6 +1,7 @@
 import db from '../db.js';
 import { stopBuildAgent } from './agent.js';
 import { terminalizeAgentRunsForExecutionRun } from './agentRuns.js';
+import { resolveCausalAgentRun } from './agentRuns.js';
 import { assertNoActiveAutomationChild } from './activeAutomationChild.js';
 import { getBundlePlanMutationBlockerById } from './bundleActivity.js';
 import { runAutomationReviewGateOrPause } from './automationReviewGate.js';
@@ -8,14 +9,17 @@ import { resolveBundleReviewOwner } from './bundleReviewOperations.js';
 import { resolveBuildTicketCommitCheckpointLineage } from './buildTicketCommit.js';
 import { getExecutionRun, withExecutionRunTransaction } from './executionRuns.js';
 import { getCheckDefinitionFingerprint } from './checkDefinitions.js';
-import { findActiveCheckBatchForTarget, getCheckBatchDetails } from './checkRuns.js';
+import { findActiveCheckAutoFixForTarget, findActiveCheckBatchForTarget, getCheckBatchDetails } from './checkRuns.js';
 import { startCheckBatch, stopCheckBatch, waitForCheckBatch } from './checkRunner.js';
 import { finalizeCheckRepair, finalizeCheckRepairInTransaction } from './checkRepairLifecycle.js';
 import { captureCheckWorkspaceIdentity } from './checkWorkspaceIdentity.js';
 import { resolveWorktreePath } from './git.js';
 import { getProjectById, getProjectCheckDefinitions } from './projects.js';
 import { getRequiredCheckPolicyFingerprint } from './requiredCheckPolicy.js';
-import { submitTicketFollowUp } from './ticketFollowUpOperations.js';
+import { dispatchCheckRepair } from './checkRepairDispatch.js';
+import { getChatSession } from './chats.js';
+import { stopChatAgent } from './agent.js';
+import { revokeAgentSpawnPermit } from './agentSpawnPermits.js';
 import { getBundleAutomationState, resolveAutomationConfig } from './ticketAutomation.js';
 import { continueAfterBuildCheckpoint } from './automationBuildContinuation.js';
 import { getAutomationProgression, runAutomationProgression, waitAutomationProgression, waitAutomationProgressionInTransaction, } from './automationProgression.js';
@@ -335,6 +339,70 @@ const resolveOwnerTicket = (projectId, batch, requestedTicketId, progressionRunI
     }
     return eligible[0];
 };
+const resolveRepairOwner = (projectId, batch, sourceRunId, requestedTicketId, progressionRunId) => {
+    const primary = db.prepare(`
+    SELECT entity_type, entity_id
+    FROM execution_run_links
+    WHERE execution_run_id = ? AND project_id = ? AND relationship = 'primary'
+      AND entity_type IN ('ticket', 'chat_session')
+  `).get(sourceRunId, projectId);
+    if (primary?.entity_type === 'chat_session') {
+        if (requestedTicketId || progressionRunId) {
+            throw new CheckRepairError(409, 'Chat Build repair ownership conflicts with Ticket automation');
+        }
+        const session = getChatSession(primary.entity_id);
+        if (!session
+            || session.project_id !== projectId
+            || session.mode !== 'build'
+            || session.target_kind !== batch.target_kind
+            || session.target_bundle_id !== batch.target_bundle_id) {
+            throw new CheckRepairError(409, 'The causal Chat Build owner is stale or unavailable');
+        }
+        return { ownerType: 'chat_session', ownerId: session.id, ticket: null, description: session.title };
+    }
+    const ticket = resolveOwnerTicket(projectId, batch, requestedTicketId ?? (primary?.entity_type === 'ticket' ? primary.entity_id : null), progressionRunId);
+    if (primary?.entity_type === 'ticket' && primary.entity_id !== ticket.id) {
+        throw new CheckRepairError(409, 'Requested Ticket does not own the causal check batch');
+    }
+    return {
+        ownerType: 'ticket',
+        ownerId: ticket.id,
+        ticket,
+        description: ticket.description || ticket.title,
+    };
+};
+const resolveCausalExecution = (projectId, sourceRunId, ownerType, ownerId) => {
+    const source = getExecutionRun(projectId, sourceRunId);
+    const direct = source?.parent_run_id ? getExecutionRun(projectId, source.parent_run_id) : null;
+    const expectedKinds = ownerType === 'ticket' ? ['build', 'build_follow_up'] : ['chat_turn'];
+    const directOwner = direct ? db.prepare(`
+    SELECT 1 FROM execution_run_links
+    WHERE execution_run_id = ? AND project_id = ? AND relationship = 'primary'
+      AND entity_type = ? AND entity_id = ?
+  `).get(direct.id, projectId, ownerType, ownerId) : null;
+    if (direct && expectedKinds.includes(direct.kind) && directOwner) {
+        return direct;
+    }
+    if (ownerType === 'chat_session') {
+        throw new CheckRepairError(409, 'The causal Chat Build execution is unavailable');
+    }
+    const row = db.prepare(`
+    SELECT run.id
+    FROM execution_runs run
+    JOIN execution_run_links link ON link.execution_run_id = run.id
+      AND link.project_id = run.project_id AND link.relationship = 'primary'
+      AND link.entity_type = 'ticket' AND link.entity_id = ?
+    WHERE run.project_id = ? AND run.kind IN ('build', 'build_follow_up')
+      AND run.status = 'completed'
+      AND EXISTS (SELECT 1 FROM agent_runs agent WHERE agent.execution_run_id = run.id)
+    ORDER BY run.created_at DESC, run.id DESC LIMIT 1
+  `).get(ownerId, projectId);
+    const causal = row ? getExecutionRun(projectId, row.id) : null;
+    if (!causal) {
+        throw new CheckRepairError(409, 'The causal Ticket Build execution is unavailable');
+    }
+    return causal;
+};
 const toRepairDestination = (purpose) => {
     if (purpose === 'automation_review') {
         return 'pre_review';
@@ -350,6 +418,12 @@ const toRepairDestination = (purpose) => {
     }
     return purpose === null ? 'manual' : 'unknown';
 };
+const assertNoActiveCheckAutoFixForTarget = (projectId, targetKind, targetBundleId) => {
+    const active = findActiveCheckAutoFixForTarget(projectId, targetKind, targetBundleId);
+    if (active) {
+        throw new CheckRepairError(409, `Check target is busy with active auto-fix ${active}`);
+    }
+};
 export const getCheckRepairCandidateState = async (projectId, batchRunId) => {
     const project = getProjectById(projectId);
     const batch = project ? getCheckBatchDetails(projectId, batchRunId) : null;
@@ -357,6 +431,7 @@ export const getCheckRepairCandidateState = async (projectId, batchRunId) => {
     const purpose = batch?.automation_boundary_purpose ?? null;
     const base = {
         candidate_tickets: [],
+        candidate_chat_sessions: [],
         accepts_ticket_id: false,
         destination: toRepairDestination(purpose),
         eligible_attempt_run_ids: [],
@@ -431,6 +506,7 @@ export const getCheckRepairCandidateState = async (projectId, batchRunId) => {
         return { ...base, eligibility: { eligible: false, reason: 'workspace_changed' } };
     }
     if (findActiveCheckBatchForTarget(projectId, batch.target_kind, batch.target_bundle_id)
+        || findActiveCheckAutoFixForTarget(projectId, batch.target_kind, batch.target_bundle_id)
         || db.prepare(`
       SELECT 1 FROM execution_runs repair
       JOIN check_repair_details details ON details.execution_run_id = repair.id
@@ -443,6 +519,27 @@ export const getCheckRepairCandidateState = async (projectId, batchRunId) => {
         return { ...base, eligibility: { eligible: false, reason: 'busy' } };
     }
     const progressionRunId = sourceRun.initiated_by === 'automation' ? sourceRun.parent_run_id : null;
+    const primaryOwner = db.prepare(`
+    SELECT entity_type, entity_id FROM execution_run_links
+    WHERE execution_run_id = ? AND project_id = ? AND relationship = 'primary'
+  `).get(batchRunId, projectId);
+    if (primaryOwner?.entity_type === 'chat_session') {
+        const session = getChatSession(primaryOwner.entity_id);
+        if (!session
+            || session.project_id !== projectId
+            || session.mode !== 'build'
+            || session.target_kind !== batch.target_kind
+            || session.target_bundle_id !== batch.target_bundle_id) {
+            return { ...base, eligibility: { eligible: false, reason: 'non_repairable' } };
+        }
+        return {
+            ...base,
+            eligibility: { eligible: true, reason: null },
+            candidate_chat_sessions: [{ id: session.id, title: session.title }],
+            eligible_attempt_run_ids: currentStructuredEvidence.map(row => row.execution_run_id),
+            eligible_raw_output_attempt_run_ids: currentRawOutputEvidence.map(row => row.execution_run_id),
+        };
+    }
     let candidates;
     if (progressionRunId) {
         const ticketIds = db.prepare(`
@@ -464,13 +561,14 @@ export const getCheckRepairCandidateState = async (projectId, batchRunId) => {
     return {
         eligibility: { eligible: true, reason: null },
         candidate_tickets: candidateTickets,
+        candidate_chat_sessions: [],
         accepts_ticket_id: !progressionRunId,
         destination: toRepairDestination(purpose),
         eligible_attempt_run_ids: currentStructuredEvidence.map(row => row.execution_run_id),
         eligible_raw_output_attempt_run_ids: currentRawOutputEvidence.map(row => row.execution_run_id),
     };
 };
-const formatRepairInstruction = (ticket, diagnosticEvidence, rawOutputEvidence) => {
+const formatRepairInstruction = (ownerDescription, diagnosticEvidence, rawOutputEvidence) => {
     const diagnostics = diagnosticEvidence.map(row => {
         const location = row.file_path ? `${row.file_path}${row.start_line ? `:${row.start_line}` : ''}` : 'unknown location';
         return `- [${escapePromptEvidence(row.definition_id)}] ${escapePromptEvidence(location)}: ${escapePromptEvidence(row.message.slice(0, MAX_PROMPT_DIAGNOSTIC_CHARS))}${row.code ? ` (${escapePromptEvidence(row.code)})` : ''}`;
@@ -484,11 +582,11 @@ const formatRepairInstruction = (ticket, diagnosticEvidence, rawOutputEvidence)
         return `<check_output attempt_id="${escapePromptEvidence(row.attempt_run_id)}" evidence="${rawOnly ? 'raw_only' : 'diagnostic'}" truncated="${truncated}">\n${escapePromptEvidence(row.retained_output.slice(-MAX_PROMPT_OUTPUT_CHARS))}\n</check_output>`;
     })
         .join('\n\n');
-    return `You are repairing persisted command failures for an existing ticket in its current worktree.
+    return `You are repairing persisted command failures for an existing Build owner in its resolved workspace.
 
-<ticket>
-${escapePromptEvidence(ticket.description || ticket.title)}
-</ticket>
+<build_owner>
+${escapePromptEvidence(ownerDescription)}
+</build_owner>
 
 <check_diagnostics>
 ${diagnostics}
@@ -618,7 +716,9 @@ const completeRepairFollowUp = async (projectId, repairRunId, io) => {
             targetLabel: sourceBatch.target_label,
             selectedDefinitions: selected,
             availableDefinitions: currentDefinitions,
-            sourceReference: { kind: 'ticket', id: details.ticket_id },
+            sourceReference: details.owner_type === 'ticket'
+                ? { kind: 'ticket', id: details.owner_id }
+                : { kind: 'chat_session', id: details.owner_id },
             rerunOfBatchRunId: sourceBatch.execution_run_id,
             rerunAttemptRunIds,
             automationParentRunId: details.automation_progression_run_id,
@@ -668,7 +768,7 @@ const completeRepairFollowUp = async (projectId, repairRunId, io) => {
             });
             return;
         }
-        const ticket = getTicket(details.ticket_id);
+        const ticket = details.ticket_id ? getTicket(details.ticket_id) : null;
         const bundle = getBundle(progressionBundleId, projectId);
         if (!ticket || !bundle || getAutomationProgression(projectId, bundle.id)?.id !== details.automation_progression_run_id) {
             throw new Error('Automation ownership changed before repaired checks completed');
@@ -773,7 +873,8 @@ const revalidateBeforeAgentStart = async (projectId, repairRunId, childRunId) =>
     if (activeBatch) {
         throw new Error(`Check target became busy before the repair agent could start (${activeBatch})`);
     }
-    if (batch.target_bundle_id && getTargetMutationBlocker(projectId, batch.target_bundle_id, details.ticket_id)) {
+    assertNoActiveCheckAutoFixForTarget(projectId, batch.target_kind, batch.target_bundle_id);
+    if (batch.target_bundle_id && getTargetMutationBlocker(projectId, batch.target_bundle_id, details.ticket_id ?? undefined)) {
         throw new Error('Check target became busy with another worktree-mutating agent');
     }
     if (details.automation_progression_run_id) {
@@ -840,6 +941,7 @@ export const startCheckRepair = async (input) => {
     if (activeBatch) {
         throw new CheckRepairError(409, `Check target is busy with active batch ${activeBatch}`);
     }
+    assertNoActiveCheckAutoFixForTarget(project.id, sourceBatch.target_kind, sourceBatch.target_bundle_id);
     assertNoActiveCheckRepairForTarget(project.id, sourceBatch.target_kind, sourceBatch.target_bundle_id);
     const progressionRunId = sourceRun.initiated_by === 'automation' ? sourceRun.parent_run_id : null;
     const boundaryPurpose = progressionRunId ? sourceBatch.automation_boundary_purpose : null;
@@ -886,16 +988,19 @@ export const startCheckRepair = async (input) => {
             targetBundleId: sourceBatch.target_bundle_id,
         }, boundaryPurpose)
         : null;
-    const ticket = resolveOwnerTicket(project.id, sourceBatch, input.ticketId ?? null, progressionRunId);
-    const mutationBlocker = getTargetMutationBlocker(project.id, targetBundleId, ticket.id);
+    const owner = resolveRepairOwner(project.id, sourceBatch, sourceRun.id, input.ticketId ?? null, progressionRunId);
+    const causalExecution = resolveCausalExecution(project.id, sourceRun.id, owner.ownerType, owner.ownerId);
+    const causalAgentRun = resolveCausalAgentRun(causalExecution.id);
+    const mutationBlocker = getTargetMutationBlocker(project.id, targetBundleId, owner.ticket?.id);
     if (mutationBlocker) {
         throw new CheckRepairError(409, `Check target is busy with mutating ticket ${mutationBlocker}`);
     }
     const definitionIds = [...new Set(validated.evidence.map(row => row.definition_id))];
     let repairContext;
     withExecutionRunTransaction(transaction => {
+        assertNoActiveCheckAutoFixForTarget(project.id, sourceBatch.target_kind, sourceBatch.target_bundle_id);
         assertNoActiveCheckRepairForTarget(project.id, sourceBatch.target_kind, sourceBatch.target_bundle_id);
-        const transactionMutationBlocker = getTargetMutationBlocker(project.id, targetBundleId, ticket.id);
+        const transactionMutationBlocker = getTargetMutationBlocker(project.id, targetBundleId, owner.ticket?.id);
         if (transactionMutationBlocker) {
             throw new CheckRepairError(409, `Check target is busy with mutating ticket ${transactionMutationBlocker}`);
         }
@@ -908,9 +1013,11 @@ export const startCheckRepair = async (input) => {
             initiatedBy: progressionRunId ? 'automation' : 'user',
             parentRunId: progressionRunId,
             retryOfRunId: input.retryOfRepairRunId ?? undefined,
-            sourceReference: { kind: 'ticket', id: ticket.id, label: ticket.title },
-            links: ticket.worktree_bundle_id
-                ? [{ entityType: 'bundle', entityId: ticket.worktree_bundle_id, relationship: 'context' }]
+            sourceReference: owner.ownerType === 'ticket'
+                ? { kind: 'ticket', id: owner.ownerId, label: owner.ticket?.title }
+                : { kind: 'chat_session', id: owner.ownerId, label: owner.description },
+            links: sourceBatch.target_bundle_id
+                ? [{ entityType: 'bundle', entityId: sourceBatch.target_bundle_id, relationship: 'context' }]
                 : [],
             domainStatus: 'running',
             eventType: input.retryOfRepairRunId ? 'check_repair_retry_started' : 'check_repair_created',
@@ -924,12 +1031,13 @@ export const startCheckRepair = async (input) => {
         });
         db.prepare(`
       INSERT INTO check_repair_details (
-        execution_run_id, source_batch_run_id, target_kind, target_bundle_id, ticket_id,
+        execution_run_id, source_batch_run_id, target_kind, target_bundle_id,
+        owner_type, owner_id, ticket_id, causal_execution_run_id, causal_agent_run_id,
         automation_progression_run_id, automation_boundary_purpose, initial_workspace_identity_json,
         configuration_fingerprint, effective_policy_fingerprint, definition_ids_json,
         retry_of_check_repair_run_id
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(repair.id, sourceBatch.execution_run_id, sourceBatch.target_kind, sourceBatch.target_bundle_id, ticket.id, progressionRunId, boundaryPurpose, JSON.stringify(validated.finalIdentity), sourceBatch.configuration_fingerprint, effectivePolicyFingerprint, JSON.stringify(definitionIds), input.retryOfRepairRunId ?? null);
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(repair.id, sourceBatch.execution_run_id, sourceBatch.target_kind, sourceBatch.target_bundle_id, owner.ownerType, owner.ownerId, owner.ticket?.id ?? null, causalExecution.id, causalAgentRun.id, progressionRunId, boundaryPurpose, JSON.stringify(validated.finalIdentity), sourceBatch.configuration_fingerprint, effectivePolicyFingerprint, JSON.stringify(definitionIds), input.retryOfRepairRunId ?? null);
         const insertProvenance = db.prepare(`
       INSERT INTO check_repair_diagnostic_provenance (
         check_repair_run_id, ordinal, diagnostic_id, attempt_run_id, definition_id
@@ -946,39 +1054,19 @@ export const startCheckRepair = async (input) => {
     }, asBroadcaster(input.io));
     const persistedDetails = getCheckRepairDetails(project.id, repairContext.runId);
     const persistedEvidence = assertRepairEvidence(project, persistedDetails.diagnostic_ids, persistedDetails.raw_output_attempt_run_ids);
-    const instruction = formatRepairInstruction(ticket, persistedEvidence.diagnosticEvidence, persistedEvidence.rawOutputEvidence);
-    const scheduling = submitTicketFollowUp({
-        ticketId: ticket.id,
-        requestedProjectId: project.id,
-        payload: undefined,
+    const instruction = formatRepairInstruction(owner.description, persistedEvidence.diagnosticEvidence, persistedEvidence.rawOutputEvidence);
+    const scheduling = dispatchCheckRepair({
+        details: persistedDetails,
+        instruction,
         broadcaster: asBroadcaster(input.io),
-        persistTriggerMessage: false,
-        initiation: {
-            initiator: progressionRunId ? 'automation' : 'user',
-            causalParentRunId: repairContext.runId,
-        },
-        providerContinuation: 'fresh',
-        trustedTrigger: {
-            instruction,
-            onExecutionCreated: context => {
-                const updated = db.prepare(`
-          UPDATE check_repair_details SET follow_up_run_id = ?, updated_at = CURRENT_TIMESTAMP
-          WHERE execution_run_id = ? AND follow_up_run_id IS NULL
-        `).run(context.runId, repairContext.runId);
-                if (updated.changes !== 1) {
-                    throw new Error('Check repair follow-up ownership could not be persisted');
-                }
+        orchestration: {
+            beforeStart: context => revalidateBeforeAgentStart(project.id, repairContext.runId, context.runId),
+            onCompletion: () => completeRepairFollowUp(project.id, repairContext.runId, input.io),
+            onCancellation: () => {
+                failRepair(project.id, repairContext.runId, 'Check repair agent was stopped', 'cancelled', input.io);
             },
-            orchestration: {
-                prompt: instruction,
-                beforeStart: context => revalidateBeforeAgentStart(project.id, repairContext.runId, context.runId),
-                onCompletion: () => completeRepairFollowUp(project.id, repairContext.runId, input.io),
-                onCancellation: () => {
-                    failRepair(project.id, repairContext.runId, 'Check repair follow-up was stopped', 'cancelled', input.io);
-                },
-                onFailure: (_context, message) => {
-                    failRepair(project.id, repairContext.runId, message, 'failed', input.io);
-                },
+            onFailure: (_context, message) => {
+                failRepair(project.id, repairContext.runId, message, 'failed', input.io);
             },
         },
     });
@@ -1000,7 +1088,7 @@ export const retryCheckRepair = async (projectId, repairRunId, io) => {
         projectId,
         diagnosticIds: source.diagnostic_ids,
         rawOutputAttemptRunIds: source.raw_output_attempt_run_ids,
-        ticketId: source.automation_progression_run_id ? null : source.ticket_id,
+        ticketId: source.automation_progression_run_id || source.owner_type === 'chat_session' ? null : source.ticket_id,
         io,
         retryOfRepairRunId: source.execution_run_id,
     });
@@ -1035,11 +1123,12 @@ export const stopCheckRepair = async (projectId, repairRunId, io) => {
                     eventType: 'check_repair_follow_up_cancelled',
                 });
                 terminalizeAgentRunsForExecutionRun(followUp.id, 'stopped', 'Check repair was stopped');
+                const ownerTable = details.owner_type === 'ticket' ? 'tickets' : 'chat_sessions';
                 db.prepare(`
-          UPDATE tickets SET agent_status = 'stopped', agent_log = NULL,
+          UPDATE ${ownerTable} SET agent_status = 'stopped', agent_log = NULL,
             streaming_response = NULL, updated_at = CURRENT_TIMESTAMP
           WHERE id = ? AND project_id = ? AND agent_status = 'running'
-        `).run(details.ticket_id, projectId);
+        `).run(details.owner_id, projectId);
             }
         }
         return true;
@@ -1051,7 +1140,13 @@ export const stopCheckRepair = async (projectId, repairRunId, io) => {
         await stopCheckBatch(projectId, details.rerun_batch_run_id, io ? asBroadcaster(io) : undefined);
     }
     else if (stopFollowUpAgent) {
-        await stopBuildAgent(details.ticket_id);
+        revokeAgentSpawnPermit(details.follow_up_run_id);
+        if (details.owner_type === 'ticket') {
+            await stopBuildAgent(details.owner_id);
+        }
+        else {
+            await stopChatAgent(details.owner_id);
+        }
     }
     return getCheckRepairDetails(projectId, repairRunId);
 };