@straiffi/archon 1.0.12 → 1.1.0

package/dist/server/index.js

@@ -40,6 +40,7 @@ import { JiraPlanningReferenceError, resolveJiraPlanningDescription } from './li
 import { getBundlePullRequestRecord, hasOpenBundlePullRequest, serializeBundlePullRequest, shouldSyncBundlePullRequest, upsertBundlePullRequest, } from './lib/bundlePullRequests.js';
 import { countInboundProjectLinks, getEffectiveProject, getProjectById, getProjectTicketStats, hasProjectRunIde, listProjects, replaceProjectLinks, serializeProject, updateProjectActiveTarget, validateProjectPayload, validateRepoPath, } from './lib/projects.js';
 import { getActiveRunStatus, getActiveRunStatusForProject, getPreviewStatusForProject, hasRunConfig, isRunning, openIde, openTicketIdeInWorkspace, resolveProjectRunContextKey, runProject, runSetupCommandsInWorkspace, runTicketInWorkspace, stopAllTickets, stopProjectRun, stopTicket } from './lib/run.js';
+import { clearAllTestSessions, createTestSession, deleteTestSession, discoverTestsForSession, doesTestFileExistForSession, findProjectTestCommand, getTestSession, isTestSelectionSupported, startTestSessionRun, stopTestSessionRun } from './lib/testSessions.js';
 import { getActiveBundleStageChangeHead, undoTicketStage } from './lib/ticketUndo.js';
 import { closeAllTerminalSessions, createProjectTerminalSession, createTerminalSessionForWorkspace, destroyTerminalSessionById, registerTerminalSocketHandlers, } from './lib/terminal.js';
 import { countBundleTickets, createTicketRecord, createBundle, deleteBundle, ensureProjectRootBundle, autoParkTicketIfStale, clearAutoParkDismissalIfNeeded, assignTicketDoneOrder, assignTicketLaneOrder, getBundle, getBundleByName, getBundleByBranch, getBundleRepresentativeTicketContext, isProjectRootBundle, getTicket, isBundledTicket, listTicketsInRunContext, listBundles, listBoardTicketEnrichment, listTickets, resolveTicketBranch, resolveTicketTool, } from './lib/tickets.js';
@@ -697,6 +698,121 @@ const resolveProjectTargetGitWorkspace = (project) => {
         }),
     };
 };
+const stripRepeatedSelfSuffix = (label) => {
+    let nextLabel = label.trim();
+    while (nextLabel !== '') {
+        const match = nextLabel.match(/^(.*?) \(([^()]+)\)$/);
+        if (!match) {
+            return nextLabel;
+        }
+        const prefix = match[1]?.trim() ?? '';
+        const suffix = match[2]?.trim() ?? '';
+        const normalizedPrefix = prefix.toLowerCase();
+        const normalizedSuffix = suffix.toLowerCase();
+        if (normalizedPrefix === normalizedSuffix) {
+            nextLabel = prefix;
+            continue;
+        }
+        if (normalizedPrefix.endsWith(` (${normalizedSuffix})`)) {
+            nextLabel = prefix;
+            continue;
+        }
+        return nextLabel;
+    }
+    return label.trim();
+};
+const stripRepeatedBranchSuffix = (label, branch) => {
+    const trimmedLabel = stripRepeatedSelfSuffix(label);
+    const trimmedBranch = branch.trim();
+    if (trimmedLabel === '' || trimmedBranch === '') {
+        return trimmedLabel;
+    }
+    const suffix = ` (${trimmedBranch})`;
+    let nextLabel = trimmedLabel;
+    while (nextLabel.toLowerCase().endsWith(suffix.toLowerCase())) {
+        nextLabel = nextLabel.slice(0, -suffix.length).trimEnd();
+    }
+    return nextLabel || trimmedLabel;
+};
+const getBundleTestTargetLabel = (bundle) => {
+    const displayName = stripRepeatedSelfSuffix(bundle.name || bundle.branch || '');
+    return bundle.branch ? stripRepeatedBranchSuffix(displayName, bundle.branch) : displayName;
+};
+const resolveExplicitProjectTestWorkspace = (project, targetKind, targetBundleId) => {
+    if (targetKind === 'bundle') {
+        if (!targetBundleId) {
+            return { error: 'target_bundle_id is required for bundle test runs', status: 400 };
+        }
+        const bundle = getBundle(targetBundleId, project.id);
+        if (!bundle || isProjectRootBundle(bundle)) {
+            return { error: 'Selected bundle target no longer exists', status: 409 };
+        }
+        const cwd = resolveExistingWorktreePath(bundle.branch, project);
+        if (!cwd) {
+            return { error: 'Selected bundle target does not have a prepared worktree', status: 409 };
+        }
+        return {
+            project,
+            cwd,
+            target_kind: 'bundle',
+            target_bundle_id: bundle.id,
+            target_label: getBundleTestTargetLabel(bundle),
+        };
+    }
+    const workspace = resolveProjectRootGitWorkspace(project);
+    if ('error' in workspace) {
+        return workspace;
+    }
+    return {
+        project,
+        cwd: workspace.cwd,
+        target_kind: 'repo_root',
+        target_bundle_id: null,
+        target_label: `Repo root (${workspace.branch})`,
+    };
+};
+const resolveTicketTestWorkspace = (ticket) => {
+    const workspace = resolveTicketGitWorkspace(ticket);
+    if ('error' in workspace) {
+        return workspace;
+    }
+    const project = workspace.project;
+    if (ticket.worktree_bundle_id) {
+        const bundle = getBundle(ticket.worktree_bundle_id, project.id);
+        if (bundle && !isProjectRootBundle(bundle)) {
+            return {
+                project,
+                cwd: workspace.cwd,
+                target_kind: 'bundle',
+                target_bundle_id: bundle.id,
+                target_label: getBundleTestTargetLabel(bundle),
+            };
+        }
+    }
+    return {
+        project,
+        cwd: workspace.cwd,
+        target_kind: 'repo_root',
+        target_bundle_id: null,
+        target_label: `Repo root (${workspace.branch})`,
+    };
+};
+const parseTestTargetSelection = (value) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value) || !hasOwn(value, 'kind')) {
+        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;
+};
 const resolveProjectFileSuggestionWorkspace = (project, options = {}) => {
     const ticketId = options.ticketId?.trim() || null;
     if (ticketId) {
@@ -878,6 +994,16 @@ const bundlePullRequestDiscoveryErrorTimestamps = new Map();
 const bundlePullRequestSyncInFlight = new Map();
 const bundlePullRequestSyncErrorTimestamps = new Map();
 const getBundlePullRequestDiscoveryKey = (projectId, bundleId) => `${projectId}:${bundleId}`;
+const startPassiveGitHubWork = (label, callback) => {
+    setImmediate(() => {
+        try {
+            callback();
+        }
+        catch (error) {
+            console.warn(`[integrations] github passive work failed ${label}`, error);
+        }
+    });
+};
 const isBundlePullRequestDiscoveryCoolingDown = (timestamps, key, cooldownMs) => {
     const lastAttemptAt = timestamps.get(key);
     if (lastAttemptAt === undefined) {
@@ -2102,15 +2228,23 @@ app.get('/tickets/:id', async (req, res) => {
     if (!matchesTicketProjectContext(ticket, req)) {
         return res.status(404).json({ error: 'Not found' });
     }
+    let passivePullRequestContext = null;
     if (ticket.project_id && ticket.worktree_bundle_id) {
         const project = getProjectById(ticket.project_id);
         const bundle = project ? getBundle(ticket.worktree_bundle_id, project.id) : null;
         if (project && bundle) {
+            passivePullRequestContext = { project, bundle };
+        }
+    }
+    res.json(ticket);
+    if (passivePullRequestContext) {
+        const { project, bundle } = passivePullRequestContext;
+        startPassiveGitHubWork('ticket-open-pr-sync', () => {
             startTrackedBundlePullRequestSyncIfNeeded(project, bundle);
             startBundlePullRequestDiscoveryIfNeeded(project, bundle);
-        }
+        });
     }
-    return res.json(ticket);
+    return;
 });
 app.get('/tickets/:id/review-findings', (req, res) => {
     const ticket = getTicketRouteContext(req.params.id);
@@ -2186,12 +2320,13 @@ app.get('/bundles', async (req, res) => {
     timing.mark('ensure_project_root_bundle');
     const bundles = listBundles(result.project.id);
     timing.mark('list_bundles');
-    startProjectBundlePullRequestSyncIfNeeded(result.project, bundles);
-    timing.mark('start_pr_sync');
     const serializedBundles = bundles.map(bundle => serializeBundleRow(result.project.id, bundle));
     timing.mark('serialize_bundles');
     timing.end({ count: serializedBundles.length });
     res.json(serializedBundles);
+    startPassiveGitHubWork('project-bundle-pr-sync', () => {
+        startProjectBundlePullRequestSyncIfNeeded(result.project, bundles);
+    });
 });
 app.get('/bundles/:id/details', async (req, res) => {
     const result = getRequiredProject(req);
@@ -2215,9 +2350,11 @@ app.get('/bundles/:id/conversation', (req, res) => {
     if (!bundle) {
         return res.status(404).json({ error: 'Bundle not found' });
     }
-    startBundlePullRequestDiscoveryIfNeeded(result.project, bundle);
     const payload = serializeBundleConversationDetails(result.project, bundle);
     res.json(payload);
+    startPassiveGitHubWork('bundle-conversation-pr-discovery', () => {
+        startBundlePullRequestDiscoveryIfNeeded(result.project, bundle);
+    });
 });
 app.get('/bundles/:id/review-findings', (req, res) => {
     const result = getRequiredProject(req);
@@ -3203,7 +3340,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, run_ide, preview_service_name, preview_path, preview_capability_mode, helper_model, helper_variant, commit_message_rules, auto_park_stale_tickets, memory_enabled, worktree_sync, } = validation.values;
+    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, worktree_sync, } = validation.values;
     const id = randomUUID();
     db.prepare(`
     INSERT INTO projects (
@@ -3212,6 +3349,7 @@ app.post('/projects', (req, res) => {
       repo_path,
       run_setup,
       run_services,
+      test_commands,
       run_ide,
       preview_service_name,
       preview_path,
@@ -3223,8 +3361,8 @@ app.post('/projects', (req, res) => {
       memory_enabled,
       worktree_sync
     )
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, name, repo_path, run_setup, run_services, 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, worktree_sync ?? null);
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, name, repo_path, 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, worktree_sync ?? null);
     replaceProjectLinks(id, linked_project_ids ?? []);
     ensureProjectRootBundle(id);
     if (projectCount === 0) {
@@ -4101,13 +4239,14 @@ app.patch('/projects/:id', (req, res) => {
             });
         }
     }
-    const { name, repo_path, linked_project_ids, run_setup, run_services, run_ide, preview_service_name, preview_path, preview_capability_mode, helper_model, helper_variant, commit_message_rules, auto_park_stale_tickets, memory_enabled, worktree_sync, } = validation.values;
+    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, worktree_sync, } = validation.values;
     db.prepare(`
     UPDATE projects SET
       name = ?,
       repo_path = ?,
       run_setup = ?,
       run_services = ?,
+      test_commands = ?,
       run_ide = ?,
       preview_service_name = ?,
       preview_path = ?,
@@ -4120,7 +4259,7 @@ app.patch('/projects/:id', (req, res) => {
       worktree_sync = ?,
       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, '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, 'worktree_sync') ? worktree_sync : project.worktree_sync, 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, '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, 'worktree_sync') ? worktree_sync : project.worktree_sync, req.params.id);
     if (hasOwn(validation.values, 'linked_project_ids')) {
         replaceProjectLinks(project.id, linked_project_ids ?? []);
     }
@@ -4881,6 +5020,141 @@ app.post('/projects/:id/run', (req, res) => {
         targetBundleId: workspace.target_bundle_id,
     });
 });
+app.post('/projects/:id/test-sessions', (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 targetBundleId = typeof body?.target_bundle_id === 'string' ? body.target_bundle_id : null;
+    const workspace = resolveExplicitProjectTestWorkspace(project, targetKind, targetBundleId);
+    if ('error' in workspace) {
+        return res.status(Number(workspace.status)).json({ error: workspace.error });
+    }
+    return res.status(201).json(createTestSession({
+        projectId: project.id,
+        targetKind: workspace.target_kind,
+        targetBundleId: workspace.target_bundle_id,
+        cwd: workspace.cwd,
+        targetLabel: workspace.target_label,
+    }));
+});
+app.post('/tickets/:id/test-sessions', (req, res) => {
+    const ticket = getTicket(req.params.id);
+    if (!ticket) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    if (!matchesTicketProjectContext(ticket, req)) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const workspace = resolveTicketTestWorkspace(ticket);
+    if ('error' in workspace) {
+        return res.status(workspace.status).json({ error: workspace.error });
+    }
+    return res.status(201).json(createTestSession({
+        projectId: workspace.project.id,
+        ticketId: ticket.id,
+        targetKind: workspace.target_kind,
+        targetBundleId: workspace.target_bundle_id,
+        cwd: workspace.cwd,
+        targetLabel: workspace.target_label,
+    }));
+});
+app.get('/test-sessions/:id/discovery', (req, res) => {
+    const session = getTestSession(req.params.id);
+    if (!session) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const commandId = typeof req.query.command_id === 'string' ? req.query.command_id.trim() : '';
+    let command = null;
+    if (commandId !== '') {
+        const project = getProjectById(session.project_id);
+        if (!project) {
+            return res.status(404).json({ error: 'Project not found' });
+        }
+        command = findProjectTestCommand(project, commandId);
+        if (!command) {
+            return res.status(404).json({ error: 'Test command not found' });
+        }
+    }
+    try {
+        const supportsGranularSelection = command
+            ? isTestSelectionSupported(command, { kind: 'file', path: '' }, session.cwd)
+            : false;
+        return res.json({
+            files: discoverTestsForSession(session.id, command),
+            supports_granular_selection: supportsGranularSelection,
+        });
+    }
+    catch (error) {
+        return res.status(500).json({ error: getErrorMessage(error) });
+    }
+});
+app.post('/test-sessions/:id/run', async (req, res) => {
+    const session = getTestSession(req.params.id);
+    if (!session) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    const project = getProjectById(session.project_id);
+    if (!project) {
+        return res.status(404).json({ error: 'Project not found' });
+    }
+    const body = req.body && typeof req.body === 'object' && !Array.isArray(req.body) ? req.body : null;
+    const commandId = typeof body?.command_id === 'string' ? body.command_id.trim() : '';
+    if (commandId === '') {
+        return res.status(400).json({ error: 'command_id is required' });
+    }
+    const selection = parseTestTargetSelection(body?.selection);
+    if (!selection) {
+        return res.status(400).json({ error: 'selection must be all, file, or case' });
+    }
+    const command = findProjectTestCommand(project, commandId);
+    if (!command) {
+        return res.status(404).json({ error: 'Test command not found' });
+    }
+    if (!isTestSelectionSupported(command, selection, session.cwd)) {
+        return res.status(409).json({ error: 'The selected test command only supports running the full suite.' });
+    }
+    if (selection.kind !== 'all' && !doesTestFileExistForSession(session.id, selection.path, command)) {
+        return res.status(404).json({ error: 'Selected test file no longer exists in this target workspace.' });
+    }
+    try {
+        return res.json(await startTestSessionRun(session.id, project, {
+            command,
+            selection,
+        }, io));
+    }
+    catch (error) {
+        return res.status(409).json({ error: getErrorMessage(error) });
+    }
+});
+app.post('/test-sessions/:id/stop', async (req, res) => {
+    const session = getTestSession(req.params.id);
+    if (!session) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    try {
+        return res.json(await stopTestSessionRun(session.id, io));
+    }
+    catch (error) {
+        return res.status(500).json({ error: getErrorMessage(error) });
+    }
+});
+app.delete('/test-sessions/:id', async (req, res) => {
+    const deleted = await deleteTestSession(req.params.id, io);
+    if (!deleted) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    return res.status(204).send();
+});
 app.post('/tickets/:id/terminal', (req, res) => {
     const ticket = getTicket(req.params.id);
     if (!ticket) {
@@ -5198,6 +5472,7 @@ export const startServer = ({ port = DEFAULT_PORT, host } = {}) => {
     });
 };
 export const shutdownServer = async (signal) => {
+    await clearAllTestSessions(io);
     await shutdownRealtimeServer({
         signal,
         io,