@straiffi/archon 1.2.4 → 1.2.6

package/dist/server/index.js

@@ -16,6 +16,7 @@ import { createCorsOriginResolver, parseCorsOrigins } from './lib/cors.js';
 import { branchExistsLocally, commitGitChanges, createWorktreeAsync, deleteWorktree, getBundleReviewDiffForCwd, getGitDiffData, getGitDiffFiles, getGitStatus, getGitUnifiedDiff, getProjectBranch, getProjectBranchSuggestions, getSelectedGitUnifiedDiff, listUnpushedCommitsForCwd, pullGitBranch, pushCurrentBranch, resolveExistingWorktreePath, resolveWorktreePath, summarizeTicketDiffFiles, switchProjectBranch, syncWorktreeFilesAsync, undoLatestUnpushedCommitForCwd } from './lib/git.js';
 import config from './lib/config.js';
 import { autoConfigProject, ProjectAutoConfigError } from './lib/projectAutoConfig.js';
+import { analyzeRepoPath, createInitialCommit, ensureInitialCommitForWorktrees, initializeGitRepo, isInitialCommitRequiredError, } from './lib/projectRepos.js';
 import { browseRepoPath } from './lib/directoryPicker.js';
 import { resolveDesktopServerHost } from './lib/desktopServerHost.js';
 import { emitMobileRealtime, getMobileAccessStatus, regenerateMobilePairingChallenge, revokeMobileSession, startMobileAccess, stopMobileAccess, } from './lib/mobileAccess.js';
@@ -43,7 +44,7 @@ import { createGitHubPullRequest, findOpenGitHubPullRequest, findOpenGitHubPullR
 import { importJiraIssue, JiraApiError, validateJiraConnection } from './lib/integrations/jira.js';
 import { JiraPlanningReferenceError, resolveJiraPlanningDescription } from './lib/integrations/planning.js';
 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 { countInboundProjectLinks, getEffectiveProject, getProjectById, getProjectTicketStats, hasProjectRunIde, listProjects, 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 { getBundleBuildBlockerResponse, shouldStartBundleBuildNow, transitionTicketState, } from './lib/ticketWorkflowOperations.js';
@@ -122,6 +123,7 @@ const prepareBundleWorkspace = async (bundle, project, options = {}) => {
     const workspacePath = resolveWorktreePath(branch, project);
     let setupCompleted = false;
     try {
+        ensureInitialCommitForWorktrees(project.repo_path);
         await createWorktreeAsync(branch, project, { baseBranch: options.baseBranch ?? null });
         await syncWorktreeFilesAsync(branch, project);
         await runSetupCommandsInWorkspace(project, workspacePath);
@@ -1435,6 +1437,88 @@ const reviewBundleTickets = (projectId, bundleId) => {
         }),
     };
 };
+const buildBundleTickets = (projectId, bundleId, broadcaster) => {
+    const project = getProjectById(projectId);
+    if (!project) {
+        return { ok: false, status: 404, error: 'Project not found' };
+    }
+    const bundle = getBundle(bundleId, project.id);
+    if (!bundle) {
+        return { ok: false, status: 404, error: 'Bundle not found' };
+    }
+    const planTickets = listBundleSliceTickets(project.id, bundle.id, 'plan');
+    if (planTickets.length === 0) {
+        return { ok: false, status: 409, error: 'No plan tickets are available to build in this bundle' };
+    }
+    const bundleTicketIds = listBundleTickets(project.id, bundle.id).map(ticket => ticket.id);
+    const orderedPlanTicketIds = getDependencyOrderedBundleTicketIds(project.id, planTickets.map(ticket => ticket.id));
+    const planTicketById = new Map(planTickets.map(ticket => [ticket.id, ticket]));
+    const orderedPlanTickets = orderedPlanTicketIds
+        .map(ticketId => planTicketById.get(ticketId))
+        .filter((ticket) => ticket !== undefined);
+    const bundleBuildBlocker = orderedPlanTickets.find(ticket => getBundleBuildBlockerResponse(ticket) !== null);
+    if (bundleBuildBlocker) {
+        const blockerResponse = getBundleBuildBlockerResponse(bundleBuildBlocker);
+        if (!blockerResponse) {
+            return { ok: false, status: 409, error: 'Unable to build the bundle right now.' };
+        }
+        return { ok: false, status: 409, error: blockerResponse.error, details: blockerResponse };
+    }
+    for (const planTicket of orderedPlanTickets) {
+        const buildValidation = prepareTicketForBuild(planTicket.id, {
+            ignoredBlockerTicketIds: bundleTicketIds,
+            updateState: false,
+        });
+        if (!buildValidation.ok) {
+            return {
+                ok: false,
+                status: buildValidation.status,
+                error: buildValidation.error,
+                ...(buildValidation.blockers ? { details: { blockers: buildValidation.blockers } } : {}),
+            };
+        }
+    }
+    const movedTickets = [];
+    for (const planTicket of orderedPlanTickets) {
+        const buildTransition = prepareTicketForBuild(planTicket.id, {
+            ignoredBlockerTicketIds: bundleTicketIds,
+        });
+        if (!buildTransition.ok) {
+            return {
+                ok: false,
+                status: buildTransition.status,
+                error: buildTransition.error,
+                ...(buildTransition.blockers ? { details: { blockers: buildTransition.blockers } } : {}),
+            };
+        }
+        movedTickets.push(buildTransition.ticket);
+    }
+    emitUpdatedTickets(movedTickets.map(ticket => ticket.id));
+    const details = serializeBundleDetails(project, bundle, {
+        target_ticket_id: movedTickets[0]?.id ?? null,
+    });
+    return {
+        ok: true,
+        status: 200,
+        value: details,
+        afterResponse: () => {
+            for (const [index, movedTicket] of movedTickets.entries()) {
+                if (!movedTicket.project_id || !movedTicket.worktree_bundle_id) {
+                    continue;
+                }
+                const queuedBuild = enqueueBundledBuild({
+                    ticketId: movedTicket.id,
+                    projectId: movedTicket.project_id,
+                    worktreeBundleId: movedTicket.worktree_bundle_id,
+                    activate: index === 0 && shouldStartBundleBuildNow(movedTicket),
+                });
+                if (queuedBuild.shouldStartNow) {
+                    startBuild(movedTicket, broadcaster);
+                }
+            }
+        },
+    };
+};
 const getCurrentReviewWorkspaceSignature = (ticket) => {
     if (!ticket) {
         return null;
@@ -1951,6 +2035,7 @@ app.post('/mobile-access/enable', async (req, res) => {
         clientBuild: resolveClientBuildPaths(import.meta.url),
         broadcaster: io,
         preferredProjectId,
+        buildBundle: buildBundleTickets,
         reviewBundleTickets,
         getBundleDetails: getProjectBundleDetails,
         submitBundleFollowUp: submitBundleFollowUpResponse,
@@ -2704,7 +2789,7 @@ app.post('/bundles', async (req, res) => {
         }
         catch (error) {
             deleteBundle(bundle.id, result.project.id);
-            return res.status(500).json({
+            return res.status(isInitialCommitRequiredError(error) ? 409 : 500).json({
                 error: `Unable to prepare the bundle worktree for branch "${bundle.branch}": ${getErrorMessage(error)}`,
             });
         }
@@ -2754,67 +2839,15 @@ app.post('/bundles/:id/build', (req, res) => {
     if ('error' in result) {
         return res.status(400).json({ error: result.error });
     }
-    const bundle = getBundle(req.params.id, result.project.id);
-    if (!bundle) {
-        return res.status(404).json({ error: 'Bundle not found' });
-    }
-    const planTickets = listBundleSliceTickets(result.project.id, bundle.id, 'plan');
-    if (planTickets.length === 0) {
-        return res.status(409).json({ error: 'No plan tickets are available to build in this bundle' });
-    }
-    const bundleTicketIds = listBundleTickets(result.project.id, bundle.id).map(ticket => ticket.id);
-    const orderedPlanTicketIds = getDependencyOrderedBundleTicketIds(result.project.id, planTickets.map(ticket => ticket.id));
-    const planTicketById = new Map(planTickets.map(ticket => [ticket.id, ticket]));
-    const orderedPlanTickets = orderedPlanTicketIds
-        .map(ticketId => planTicketById.get(ticketId))
-        .filter((ticket) => ticket !== undefined);
-    const bundleBuildBlocker = orderedPlanTickets.find(ticket => getBundleBuildBlockerResponse(ticket) !== null);
-    if (bundleBuildBlocker) {
-        return res.status(409).json(getBundleBuildBlockerResponse(bundleBuildBlocker));
-    }
-    for (const planTicket of orderedPlanTickets) {
-        const buildValidation = prepareTicketForBuild(planTicket.id, {
-            ignoredBlockerTicketIds: bundleTicketIds,
-            updateState: false,
-        });
-        if (!buildValidation.ok) {
-            return res.status(buildValidation.status).json({
-                error: buildValidation.error,
-                ...(buildValidation.blockers ? { blockers: buildValidation.blockers } : {}),
-            });
-        }
-    }
-    const movedTickets = [];
-    for (const planTicket of orderedPlanTickets) {
-        const buildTransition = prepareTicketForBuild(planTicket.id, {
-            ignoredBlockerTicketIds: bundleTicketIds,
-        });
-        if (!buildTransition.ok) {
-            return res.status(buildTransition.status).json({
-                error: buildTransition.error,
-                ...(buildTransition.blockers ? { blockers: buildTransition.blockers } : {}),
-            });
-        }
-        movedTickets.push(buildTransition.ticket);
-    }
-    emitUpdatedTickets(movedTickets.map(ticket => ticket.id));
-    res.json(serializeBundleDetails(result.project, bundle, {
-        target_ticket_id: movedTickets[0]?.id ?? null,
-    }));
-    for (const [index, movedTicket] of movedTickets.entries()) {
-        if (!movedTicket.project_id || !movedTicket.worktree_bundle_id) {
-            continue;
-        }
-        const queuedBuild = enqueueBundledBuild({
-            ticketId: movedTicket.id,
-            projectId: movedTicket.project_id,
-            worktreeBundleId: movedTicket.worktree_bundle_id,
-            activate: index === 0 && shouldStartBundleBuildNow(movedTicket),
+    const buildResult = buildBundleTickets(result.project.id, req.params.id, io);
+    if (!buildResult.ok) {
+        return res.status(buildResult.status).json({
+            error: buildResult.error,
+            ...('details' in buildResult ? buildResult.details : {}),
         });
-        if (queuedBuild.shouldStartNow) {
-            startBuild(movedTicket, io);
-        }
     }
+    res.status(buildResult.status).json(buildResult.value);
+    buildResult.afterResponse?.();
 });
 app.post('/bundles/:id/review', (req, res) => {
     const result = getRequiredProject(req);
@@ -2959,20 +2992,47 @@ app.post('/projects/validate-repo-path', (req, res) => {
     if (typeof req.body?.repo_path !== 'string' || req.body.repo_path.trim() === '') {
         return res.status(400).json({ error: 'repo_path must be a non-empty string' });
     }
-    const repoResult = validateRepoPath(req.body.repo_path);
-    if ('error' in repoResult) {
+    const repoAnalysis = analyzeRepoPath(req.body.repo_path, { allowInitialization: true });
+    if (repoAnalysis.kind === 'invalid') {
         return res.json({
             valid: false,
             repo_root: null,
-            error: repoResult.error,
+            error: repoAnalysis.error,
+            will_initialize: false,
+            has_initial_commit: null,
+        });
+    }
+    if (repoAnalysis.kind === 'initializable') {
+        return res.json({
+            valid: false,
+            repo_root: null,
+            error: null,
+            will_initialize: true,
+            has_initial_commit: null,
         });
     }
     return res.json({
         valid: true,
-        repo_root: repoResult.value,
+        repo_root: repoAnalysis.repoRoot,
         error: null,
+        will_initialize: false,
+        has_initial_commit: repoAnalysis.hasInitialCommit,
     });
 });
+app.post('/projects/:id/create-initial-commit', (req, res) => {
+    const project = getProjectById(req.params.id);
+    if (!project) {
+        return res.status(404).json({ error: 'Not found' });
+    }
+    try {
+        createInitialCommit(project.repo_path);
+    }
+    catch (error) {
+        return res.status(409).json({ error: getErrorMessage(error) || 'Unable to create the initial commit right now.' });
+    }
+    const updatedProject = getProjectById(project.id);
+    return res.json(serializeProject(updatedProject ?? null));
+});
 app.post('/projects/browse-repo-path', (_req, res) => {
     const browseResult = browseRepoPath();
     if (browseResult.status === 'cancelled') {
@@ -3322,12 +3382,23 @@ app.get('/projects', (_req, res) => {
     res.json(projects.map(serializeProject));
 });
 app.post('/projects', (req, res) => {
-    const validation = validateProjectPayload(asProjectPayload(req.body));
+    const validation = validateProjectPayload(asProjectPayload(req.body), { allowRepoInitialization: true });
     if ('error' in validation) {
         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, worktree_sync, } = validation.values;
+    if (!repo_path) {
+        return res.status(400).json({ error: 'repo_path must be a non-empty string' });
+    }
+    let normalizedRepoPath = repo_path;
+    try {
+        const initializedRepo = initializeGitRepo(repo_path);
+        normalizedRepoPath = initializedRepo.repoRoot;
+    }
+    catch (error) {
+        return res.status(400).json({ error: getErrorMessage(error) || 'Unable to initialize the project repository.' });
+    }
     const id = randomUUID();
     db.prepare(`
     INSERT INTO projects (
@@ -3349,7 +3420,7 @@ app.post('/projects', (req, res) => {
       worktree_sync
     )
     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);
+  `).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, worktree_sync ?? null);
     replaceProjectLinks(id, linked_project_ids ?? []);
     ensureProjectRootBundle(id);
     if (projectCount === 0) {