@straiffi/archon 1.7.3 → 1.7.5

package/dist/server/lib/executionRetryPredicates.js

@@ -0,0 +1,74 @@
+export const RETRYABLE_AGENT_STATUSES = new Set(['failed', 'interrupted']);
+export const RETRYABLE_TEST_STATUSES = new Set(['failed', 'cancelled', 'interrupted']);
+export const RETRYABLE_EXECUTION_KINDS = new Set([
+    'test',
+    'plan',
+    'build',
+    'review',
+    'build_follow_up',
+    'plan_follow_up',
+    'chat_turn',
+    'spec_turn',
+    'spec_review',
+]);
+export const LATER_RUN_SUPERSEDED_KINDS = new Set([
+    'plan',
+    'build',
+    'review',
+    'build_follow_up',
+    'plan_follow_up',
+    'chat_turn',
+    'spec_turn',
+]);
+export const isLaterRunSupersededKind = (kind) => LATER_RUN_SUPERSEDED_KINDS.has(kind);
+export const isRetryableExecutionStatus = (kind, status) => ((kind === 'test' ? RETRYABLE_TEST_STATUSES : RETRYABLE_AGENT_STATUSES).has(status));
+export const parseExecutionRetryTestSelection = (value) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    const selection = value;
+    if (selection.kind === 'all') {
+        return { kind: 'all' };
+    }
+    if (selection.kind === 'file' && typeof selection.path === 'string') {
+        return { kind: 'file', path: selection.path };
+    }
+    if (selection.kind === 'case' && typeof selection.path === 'string' && typeof selection.name === 'string') {
+        return { kind: 'case', path: selection.path, name: selection.name };
+    }
+    return null;
+};
+export const resolveExecutionRetryRunConfig = (source) => {
+    const tool = source.metadata?.retry_tool;
+    const model = source.metadata?.retry_model;
+    const variant = source.metadata?.retry_variant;
+    const skills = source.metadata?.retry_skills;
+    if ((tool !== 'opencode' && tool !== 'claude')
+        || (model !== null && typeof model !== 'string')
+        || (variant !== null && typeof variant !== 'string')
+        || !Array.isArray(skills)
+        || skills.some(skill => typeof skill !== 'string')) {
+        return null;
+    }
+    return { tool: tool, model, variant, skills: skills };
+};
+export const resolveExecutionRetrySessionMode = (source) => {
+    const mode = source.metadata?.retry_mode;
+    if (source.kind === 'chat_turn') {
+        return mode === 'plan' || mode === 'build' ? mode : null;
+    }
+    if (source.kind === 'spec_turn') {
+        return mode === 'standard' || mode === 'grill' ? mode : null;
+    }
+    return null;
+};
+export const hasExecutionRetryAutomationOwnership = ({ source, parentKind, automationPausedStageRunId, }) => {
+    if (source.initiated_by !== 'user' || source.metadata?.build_open_question_batch_id) {
+        return true;
+    }
+    if (source.parent_run_id && (parentKind === 'automation_progression' || parentKind === 'automation_review_fix')) {
+        return true;
+    }
+    return automationPausedStageRunId === source.id;
+};
+//# sourceMappingURL=executionRetryPredicates.js.map

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

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

package/dist/server/lib/executionRuns.js

@@ -17,6 +17,12 @@ const GENERIC_RETRY_DENIED_KINDS = new Set([
     'automation_push',
     'automation_pull_request',
 ]);
+const ARTIFACT_AUDIT_EVENT_TYPES = new Set([
+    'artifact_created',
+    'artifact_availability_changed',
+    'artifact_deletion_failed',
+    'artifact_expired',
+]);
 export class GitHubActionsDispatchConflictError extends Error {
     executionRunId;
     constructor(executionRunId) {
@@ -27,7 +33,7 @@ export class GitHubActionsDispatchConflictError extends Error {
 }
 const getRunStatement = db.prepare('SELECT * FROM execution_runs WHERE id = ? AND project_id = ?');
 const getRunByIdStatement = db.prepare('SELECT * FROM execution_runs WHERE id = ?');
-const projectExistsStatement = db.prepare('SELECT 1 FROM projects WHERE id = ?');
+const projectExistsStatement = db.prepare('SELECT 1 FROM projects WHERE id = ? AND deletion_started_at IS NULL');
 const insertRunStatement = db.prepare(`
   INSERT INTO execution_runs (
     id, project_id, kind, status, domain_status, source_kind, source_id, source_label, source_url,
@@ -62,6 +68,44 @@ const getRunLinkStatement = db.prepare(`
   WHERE execution_run_id = ? AND project_id = ? AND entity_type = ? AND entity_id = ? AND relationship = ?
 `);
 const getDirectRetryChildStatement = db.prepare('SELECT id FROM execution_runs WHERE retry_of_run_id = ? LIMIT 1');
+const hasLaterRunForPrimaryEntityStatement = db.prepare(`
+  SELECT 1
+  FROM execution_runs candidate
+  INNER JOIN execution_run_links candidate_primary
+    ON candidate_primary.execution_run_id = candidate.id
+    AND candidate_primary.project_id = candidate.project_id
+    AND candidate_primary.relationship = 'primary'
+  INNER JOIN execution_runs source ON source.id = ? AND source.project_id = ?
+  WHERE candidate.project_id = ?
+    AND candidate.kind = ?
+    AND candidate_primary.entity_type = ?
+    AND candidate_primary.entity_id = ?
+    AND candidate.rowid > source.rowid
+    AND candidate.retry_of_run_id IS NOT source.id
+  LIMIT 1
+`);
+const hasLaterSpecReviewForSnapshotStatement = db.prepare(`
+  SELECT 1
+  FROM execution_runs candidate
+  INNER JOIN execution_run_links candidate_primary
+    ON candidate_primary.execution_run_id = candidate.id
+    AND candidate_primary.project_id = candidate.project_id
+    AND candidate_primary.relationship = 'primary'
+    AND candidate_primary.entity_type = 'spec_session'
+  INNER JOIN execution_run_links candidate_snapshot
+    ON candidate_snapshot.execution_run_id = candidate.id
+    AND candidate_snapshot.project_id = candidate.project_id
+    AND candidate_snapshot.relationship = 'context'
+    AND candidate_snapshot.entity_type = 'spec_snapshot'
+  INNER JOIN execution_runs source ON source.id = ? AND source.project_id = ?
+  WHERE candidate.project_id = ?
+    AND candidate.kind = 'spec_review'
+    AND candidate_primary.entity_id = ?
+    AND candidate_snapshot.entity_id = ?
+    AND candidate.rowid > source.rowid
+    AND candidate.retry_of_run_id IS NOT source.id
+  LIMIT 1
+`);
 const getEventStatement = db.prepare('SELECT * FROM lifecycle_events WHERE id = ? AND project_id = ?');
 const insertTestDetailsStatement = db.prepare(`
   INSERT INTO test_execution_details (
@@ -183,26 +227,34 @@ const boundTestOutput = (output, alreadyTruncated = false) => {
         outputTruncated: true,
     };
 };
-const isSourceAvailable = (row) => {
-    if (!row.source_kind || !row.source_id) {
-        return false;
-    }
-    if (row.source_kind === 'ticket') {
-        return Boolean(db.prepare('SELECT 1 FROM tickets WHERE id = ? AND project_id = ?').get(row.source_id, row.project_id));
-    }
-    if (row.source_kind === 'project') {
-        return Boolean(projectExistsStatement.get(row.source_id));
-    }
-    if (row.source_kind === 'bundle') {
-        return Boolean(db.prepare('SELECT 1 FROM worktree_bundles WHERE id = ? AND project_id = ?').get(row.source_id, row.project_id));
-    }
-    if (row.source_kind === 'chat_session') {
-        return Boolean(db.prepare('SELECT 1 FROM chat_sessions WHERE id = ? AND project_id = ?').get(row.source_id, row.project_id));
-    }
-    if (row.source_kind === 'spec_session') {
-        return Boolean(db.prepare('SELECT 1 FROM spec_sessions WHERE id = ? AND project_id = ?').get(row.source_id, row.project_id));
+const SOURCE_TABLES = {
+    ticket: 'tickets',
+    project: 'projects',
+    bundle: 'worktree_bundles',
+    chat_session: 'chat_sessions',
+    spec_session: 'spec_sessions',
+};
+const loadSourceAvailability = (rows) => {
+    const availability = new Map();
+    for (const [sourceKind, table] of Object.entries(SOURCE_TABLES)) {
+        const sourceRows = rows.filter(row => row.source_kind === sourceKind && row.source_id);
+        const ids = [...new Set(sourceRows.map(row => row.source_id))];
+        if (ids.length === 0) {
+            continue;
+        }
+        const projectIds = [...new Set(sourceRows.map(row => row.project_id))];
+        const records = db.prepare(`
+      SELECT id, ${sourceKind === 'project' ? 'id' : 'project_id'} AS project_id
+      FROM ${table}
+      WHERE id IN (${ids.map(() => '?').join(', ')})
+        AND ${sourceKind === 'project' ? 'id' : 'project_id'} IN (${projectIds.map(() => '?').join(', ')})
+    `).all(...ids, ...projectIds);
+        const availableKeys = new Set(records.map(record => `${record.project_id}:${sourceKind}:${record.id}`));
+        for (const row of sourceRows) {
+            availability.set(`${row.project_id}:${sourceKind}:${row.source_id}`, availableKeys.has(`${row.project_id}:${sourceKind}:${row.source_id}`));
+        }
     }
-    return Boolean(safeSnapshotUrl(row.source_url));
+    return availability;
 };
 const safeSnapshotUrl = (value) => {
     if (!value) {
@@ -216,7 +268,7 @@ const safeSnapshotUrl = (value) => {
         return null;
     }
 };
-const serializeRun = (row) => ({
+const serializeRun = (row, sourceAvailability) => ({
     id: row.id,
     project_id: row.project_id,
     kind: row.kind,
@@ -227,7 +279,7 @@ const serializeRun = (row) => ({
             kind: row.source_kind,
             id: row.source_id,
             label: row.source_label,
-            available: isSourceAvailable(row),
+            available: sourceAvailability?.get(`${row.project_id}:${row.source_kind}:${row.source_id}`) ?? loadSourceAvailability([row]).get(`${row.project_id}:${row.source_kind}:${row.source_id}`) ?? Boolean(safeSnapshotUrl(row.source_url)),
             url: safeSnapshotUrl(row.source_url),
         }
         : null,
@@ -255,10 +307,12 @@ const serializeEvent = (row) => ({
     metadata: parseStoredObject(row.metadata_json),
 });
 const PUBLIC_EVENT_METADATA_KEYS = new Set([
+    'artifact_id',
     'candidate_run_ids',
     'conclusion',
     'input_names',
     'provider_run_id',
+    'prior_availability',
     'ref',
     'resolution_attempts',
     'trigger',
@@ -266,7 +320,18 @@ const PUBLIC_EVENT_METADATA_KEYS = new Set([
 ]);
 export const toCanonicalLifecycleEvent = (event) => {
     const metadata = event.metadata
-        ? Object.fromEntries(Object.entries(event.metadata).filter(([key]) => PUBLIC_EVENT_METADATA_KEYS.has(key)))
+        ? Object.fromEntries(Object.entries(event.metadata).filter(([key, value]) => {
+            if (!PUBLIC_EVENT_METADATA_KEYS.has(key)) {
+                return false;
+            }
+            if (key === 'artifact_id') {
+                return typeof value === 'string' && value.length > 0 && value.length <= 255;
+            }
+            if (key === 'prior_availability') {
+                return value === 'available' || value === 'missing';
+            }
+            return true;
+        }))
         : null;
     return {
         ...event,
@@ -567,6 +632,12 @@ const assertTestTarget = (projectId, details) => {
     }
 };
 export const hasDirectRetryChild = (runId) => Boolean(getDirectRetryChildStatement.get(runId));
+export const getDirectRetryChild = (projectId, runId) => {
+    const child = getDirectRetryChildStatement.get(runId);
+    return child ? getExecutionRun(projectId, child.id) : null;
+};
+export const hasLaterExecutionRunForPrimaryEntity = ({ projectId, sourceRunId, kind, entityType, entityId, }) => Boolean(hasLaterRunForPrimaryEntityStatement.get(sourceRunId, projectId, projectId, kind, entityType, entityId));
+export const hasLaterSpecReviewForSnapshot = ({ projectId, sourceRunId, sessionId, snapshotId, }) => Boolean(hasLaterSpecReviewForSnapshotStatement.get(sourceRunId, projectId, projectId, sessionId, snapshotId));
 const insertTestDetails = (runId, details) => {
     const boundedOutput = boundTestOutput(details.output ?? '', details.outputTruncated);
     insertTestDetailsStatement.run(runId, details.commandId ?? null, details.commandName ?? null, details.commandRunner ?? null, details.commandSnapshot ?? null, details.activeCommand ?? null, details.targetKind ?? null, details.targetBundleId ?? null, details.targetLabel ?? null, details.ticketId ?? null, serializeBoundedObject(details.selection, 'Test selection'), serializeBoundedObject(details.summary, 'Test summary'), details.exitCode ?? null, details.durationMs ?? null, boundedOutput.output, boundedOutput.outputTruncated ? 1 : 0, Buffer.byteLength(boundedOutput.output, 'utf8'));
@@ -747,7 +818,33 @@ const createExecutionRunInTransaction = (input, allowAutomationSideEffectRetry =
         metadataJson: serializeBoundedObject(input.eventMetadata, 'Lifecycle event metadata'),
         createdAt: now,
     });
-    return { run: serializeRun(getRunRow(input.projectId, id)), event };
+    const retryEvents = retrySource
+        ? [
+            createEvent({
+                projectId: input.projectId,
+                runId: retrySource.id,
+                eventType: 'retry_requested',
+                fromStatus: retrySource.status,
+                toStatus: retrySource.status,
+                domainStatus: retrySource.domain_status,
+                metadataJson: serializeBoundedObject({ replacement_run_id: id }, 'Lifecycle event metadata'),
+                createdAt: now,
+            }),
+            ...(event.event_type === 'retry_started'
+                ? []
+                : [createEvent({
+                        projectId: input.projectId,
+                        runId: id,
+                        eventType: 'retry_started',
+                        fromStatus: 'queued',
+                        toStatus: 'queued',
+                        domainStatus: input.domainStatus ?? null,
+                        metadataJson: serializeBoundedObject({ retry_of_run_id: retrySource.id }, 'Lifecycle event metadata'),
+                        createdAt: now,
+                    })]),
+        ]
+        : [];
+    return { run: serializeRun(getRunRow(input.projectId, id)), event, retryEvents };
 };
 const insertRunLink = (input) => {
     if (input.link.relationship === 'primary') {
@@ -861,11 +958,17 @@ export const withExecutionRunTransaction = (callback, emitter) => {
             createExecutionRun: input => {
                 const result = createExecutionRunInTransaction(input);
                 enqueueRunAndEvent(notifications, result.run, result.event, emitter);
+                for (const retryEvent of result.retryEvents) {
+                    notifications.push({ event: 'lifecycle-event:created', payload: retryEvent, emitter });
+                }
                 return result.run;
             },
             createAutomationRetryExecutionRun: input => {
                 const result = createExecutionRunInTransaction(input, true);
                 enqueueRunAndEvent(notifications, result.run, result.event, emitter);
+                for (const retryEvent of result.retryEvents) {
+                    notifications.push({ event: 'lifecycle-event:created', payload: retryEvent, emitter });
+                }
                 return result.run;
             },
             transitionExecutionRun: input => {
@@ -931,6 +1034,18 @@ export const getExecutionRun = (projectId, runId) => {
     const row = getRunStatement.get(runId, projectId);
     return row ? serializeRun(row) : null;
 };
+export const getExecutionRunsByIds = (projectId, runIds) => {
+    const ids = [...new Set(runIds)];
+    if (ids.length === 0) {
+        return [];
+    }
+    const rows = db.prepare(`
+    SELECT * FROM execution_runs
+    WHERE project_id = ? AND id IN (${ids.map(() => '?').join(', ')})
+  `).all(projectId, ...ids);
+    const sourceAvailability = loadSourceAvailability(rows);
+    return rows.map(row => serializeRun(row, sourceAvailability));
+};
 export const getQueuedSpecReviewExecutionRun = (projectId, snapshotId) => {
     const row = db.prepare(`
     SELECT execution_runs.id
@@ -989,20 +1104,23 @@ export const hasActiveBuildExecutionRunForTicket = (projectId, ticketId) => {
     LIMIT 1
   `).get(projectId, ticketId));
 };
-const purgeTestExecutionRunTransaction = db.transaction((projectId, runId) => {
-    return db.prepare(`
-    DELETE FROM execution_runs
-    WHERE id = ? AND project_id = ? AND kind = 'test'
-  `).run(runId, projectId).changes > 0;
-});
-export const purgeTestExecutionRun = (projectId, runId) => {
-    return purgeTestExecutionRunTransaction(projectId, runId);
-};
 export const listExecutionRunLinks = (projectId, runId) => {
     getRunRow(projectId, runId);
     const links = getRunLinksStatement.all(runId, projectId);
     return links.map(link => ({ ...link, url_snapshot: safeSnapshotUrl(link.url_snapshot) }));
 };
+export const listExecutionRunLinksForRuns = (projectId, runIds) => {
+    const ids = [...new Set(runIds)];
+    if (ids.length === 0) {
+        return [];
+    }
+    const links = db.prepare(`
+    SELECT * FROM execution_run_links
+    WHERE project_id = ? AND execution_run_id IN (${ids.map(() => '?').join(', ')})
+    ORDER BY execution_run_id ASC, created_at ASC, entity_type ASC, entity_id ASC, relationship ASC
+  `).all(projectId, ...ids);
+    return links.map(link => ({ ...link, url_snapshot: safeSnapshotUrl(link.url_snapshot) }));
+};
 const testDetailsSelect = `
   SELECT td.*, er.project_id, er.status AS execution_status
   FROM test_execution_details td
@@ -1175,30 +1293,41 @@ export const listExecutionRuns = (input) => {
     }
     const statuses = [...new Set(input.statuses ?? [])];
     const cursor = input.cursor ? decodeCursor(input.cursor) : null;
-    const clauses = ['project_id = ?'];
+    const clauses = ['er.project_id = ?'];
     const parameters = [input.projectId];
     if (input.kind) {
-        clauses.push('kind = ?');
+        clauses.push('er.kind = ?');
         parameters.push(input.kind);
     }
     if (statuses.length > 0) {
-        clauses.push(`status IN (${statuses.map(() => '?').join(', ')})`);
+        clauses.push(`er.status IN (${statuses.map(() => '?').join(', ')})`);
         parameters.push(...statuses);
     }
     if (cursor) {
-        clauses.push('(created_at < ? OR (created_at = ? AND id < ?))');
+        clauses.push('(er.created_at < ? OR (er.created_at = ? AND er.id < ?))');
         parameters.push(cursor.created_at, cursor.created_at, cursor.id);
     }
+    if (input.scopeEntity) {
+        clauses.push(`EXISTS (
+      SELECT 1 FROM execution_run_links scope_link
+      WHERE scope_link.execution_run_id = er.id
+        AND scope_link.project_id = er.project_id
+        AND scope_link.entity_type = ?
+        AND scope_link.entity_id = ?
+    )`);
+        parameters.push(input.scopeEntity.type, input.scopeEntity.id);
+    }
     const rows = db.prepare(`
-    SELECT * FROM execution_runs
+    SELECT er.* FROM execution_runs er
     WHERE ${clauses.join(' AND ')}
-    ORDER BY created_at DESC, id DESC
+    ORDER BY er.created_at DESC, er.id DESC
     LIMIT ?
   `).all(...parameters, limit + 1);
     const pageRows = rows.slice(0, limit);
+    const sourceAvailability = loadSourceAvailability(pageRows);
     const lastRow = pageRows.at(-1);
     return {
-        runs: pageRows.map(serializeRun),
+        runs: pageRows.map(row => serializeRun(row, sourceAvailability)),
         next_cursor: rows.length > limit && lastRow
             ? encodeCursor({ created_at: lastRow.created_at, id: lastRow.id })
             : null,
@@ -1213,6 +1342,40 @@ export const listLifecycleEvents = (projectId, runId) => {
   `).all(projectId, runId);
     return rows.map(serializeEvent);
 };
+export const listLatestLifecycleEventsForRuns = (projectId, runIds) => {
+    const ids = [...new Set(runIds)];
+    if (ids.length === 0) {
+        return [];
+    }
+    const rows = db.prepare(`
+    SELECT * FROM (
+      SELECT lifecycle_events.*,
+        ROW_NUMBER() OVER (PARTITION BY execution_run_id ORDER BY sequence DESC, id DESC) AS timeline_rank
+      FROM lifecycle_events
+      WHERE project_id = ? AND execution_run_id IN (${ids.map(() => '?').join(', ')})
+    )
+    WHERE timeline_rank = 1
+  `).all(projectId, ...ids);
+    return rows.map(({ timeline_rank: _timelineRank, ...row }) => serializeEvent(row));
+};
+export const listLatestMeaningfulLifecycleEventsForRuns = (projectId, runIds) => {
+    const ids = [...new Set(runIds)];
+    if (ids.length === 0) {
+        return [];
+    }
+    const excludedEventTypes = [...ARTIFACT_AUDIT_EVENT_TYPES];
+    const rows = db.prepare(`
+    SELECT * FROM (
+      SELECT lifecycle_events.*,
+        ROW_NUMBER() OVER (PARTITION BY execution_run_id ORDER BY sequence DESC, id DESC) AS timeline_rank
+      FROM lifecycle_events
+      WHERE project_id = ? AND execution_run_id IN (${ids.map(() => '?').join(', ')})
+        AND event_type NOT IN (${excludedEventTypes.map(() => '?').join(', ')})
+    )
+    WHERE timeline_rank = 1
+  `).all(projectId, ...ids, ...excludedEventTypes);
+    return rows.map(({ timeline_rank: _timelineRank, ...row }) => serializeEvent(row));
+};
 export const listProjectLifecycleEvents = (input) => {
     const limit = input.limit ?? 50;
     if (!Number.isSafeInteger(limit) || limit < 1 || limit > 200) {