agentweaver 0.1.16 → 0.1.17

package/dist/index.js

@@ -3,9 +3,9 @@ import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
-import { bugAnalyzeArtifacts, bugAnalyzeJsonFile, bugFixDesignJsonFile, bugFixPlanJsonFile, designReviewFile, designReviewJsonFile, gitlabDiffFile, gitlabDiffJsonFile, ensureScopeWorkspaceDir, gitlabReviewFile, gitlabReviewJsonFile, instantTaskInputJsonFile, latestArtifactIteration, nextArtifactIteration, readyToMergeFile, requireArtifacts, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixSelectionJsonFile, reviewJsonFile, scopeWorkspaceDir, flowStateFile, taskSummaryFile, } from "./artifacts.js";
+import { archiveActiveAttempt, bugAnalyzeArtifacts, bugAnalyzeJsonFile, bugFixDesignJsonFile, bugFixPlanJsonFile, designReviewFile, designReviewJsonFile, gitlabDiffFile, gitlabDiffJsonFile, ensureScopeWorkspaceDir, gitlabReviewFile, gitlabReviewJsonFile, instantTaskInputJsonFile, latestArtifactIteration, nextArtifactIteration, readyToMergeFile, requireArtifacts, reviewAssessmentFile, reviewAssessmentJsonFile, reviewFile, reviewFixSelectionJsonFile, reviewJsonFile, scopeWorkspaceDir, flowStateFile, taskSummaryFile, } from "./artifacts.js";
 import { FlowInterruptedError, TaskRunnerError } from "./errors.js";
-import { createFlowRunState, hasResumableFlowState, loadFlowRunState, prepareFlowStateForResume, resetFlowRunState, rewindFlowRunStateToPhase, saveFlowRunState, stripExecutionStatePayload, } from "./flow-state.js";
+import { createFlowRunState, classifyFlowLaunchAvailability, loadFlowRunState, prepareFlowStateForContinue, prepareFlowStateForResume, resetFlowRunState, rewindFlowRunStateToPhase, saveFlowRunState, stripExecutionStatePayload, } from "./flow-state.js";
 import { requireJiraTaskFile } from "./jira.js";
 import { validateStructuredArtifacts } from "./structured-artifacts.js";
 import { AGENTWEAVER_REVIEW_BLOCKING_SEVERITIES_ENV, parseReviewSeverityCsv, resolveReviewBlockingSeveritiesFromEnv, } from "./review-severity.js";
@@ -15,6 +15,7 @@ import { createPipelineContext } from "./pipeline/context.js";
 import { collectFlowRoutingGroups, loadDeclarativeFlow } from "./pipeline/declarative-flows.js";
 import { runExpandedPhase } from "./pipeline/declarative-flow-runner.js";
 import { builtInCommandFlowFile, findCatalogEntry, flowRoutingGroups, isBuiltInCommandFlowId, loadInteractiveFlowCatalog, toDeclarativeFlowRef, } from "./pipeline/flow-catalog.js";
+import { createPipelineRegistryContext } from "./pipeline/plugin-loader.js";
 import { DEFAULT_LAUNCH_PROFILE, } from "./pipeline/launch-profile-config.js";
 import { withCanonicalReviewLoopParams } from "./pipeline/review-iteration.js";
 import { evaluateCondition, resolveValue } from "./pipeline/value-resolver.js";
@@ -149,6 +150,9 @@ Flags:
   --verbose       Show live stdout/stderr of launched commands
   --scope         Explicit workflow scope name for non-Jira runs except instant-task
   --prompt        Extra prompt text appended to the base prompt
+  --resume        Resume an interrupted run when valid
+  --continue      Continue a terminated iterative run when valid
+  --restart       Archive the active attempt and start a fresh run
   --blocking-severities  Comma-separated severities that block merge and drive review-fix auto-selection
   --md-lang       Language for markdown output files: en (English) or ru (Russian, default)
 
@@ -186,12 +190,12 @@ function packageVersion() {
 function normalizeAutoPhaseId(phaseId) {
     return phaseId.trim().toLowerCase().replaceAll("-", "_");
 }
-function autoPhaseIds() {
-    return loadDeclarativeFlow({ source: "built-in", fileName: "auto-golang.json" }).phases.map((phase) => phase.id);
+async function autoPhaseIds() {
+    return (await loadDeclarativeFlow({ source: "built-in", fileName: "auto-golang.json" })).phases.map((phase) => phase.id);
 }
-function validateAutoPhaseId(phaseId) {
+async function validateAutoPhaseId(phaseId) {
     const normalized = normalizeAutoPhaseId(phaseId);
-    if (!autoPhaseIds().includes(normalized)) {
+    if (!(await autoPhaseIds()).includes(normalized)) {
         throw new TaskRunnerError(`Unknown auto-golang phase: ${phaseId}\nUse 'agentweaver auto-golang --help-phases' or '/help auto-golang' to list valid phases.`);
     }
     return normalized;
@@ -215,6 +219,17 @@ function buildFlowResumeDetails(state) {
     }
     return lines.join("\n");
 }
+function buildFlowContinueDetails(state) {
+    const lines = [
+        "Continuable loop boundary found.",
+        `Updated: ${state.updatedAt}`,
+    ];
+    if (state.continuation?.stopPhaseId && state.continuation?.stopStepId) {
+        lines.push(`Stopped at: ${state.continuation.stopPhaseId}:${state.continuation.stopStepId}`);
+    }
+    lines.push("Continue will preserve existing artifacts and start the next iteration from active inputs.");
+    return lines.join("\n");
+}
 function buildResolverContext(pipelineContext, flowParams, flowConstants, repeatVars, executionState) {
     return {
         flowParams,
@@ -288,7 +303,7 @@ function validateDeclarativePhaseResumeState(phase, phaseState, pipelineContext,
         }
     }
 }
-function validateDeclarativeFlowResumeState(flowEntry, config, state, executionRouting, runtime = runtimeServices) {
+async function validateDeclarativeFlowResumeState(flowEntry, config, state, executionRouting, runtime = runtimeServices) {
     if (state.flowId === "auto-common") {
         const persistedPhaseIds = state.executionState.phases.map((p) => p.id);
         const hasLegacyPlanningGatePhases = persistedPhaseIds.some((id) => ["design_review", "verdict", "plan_revision", "design_review_repeat", "verdict_repeat"].includes(id));
@@ -308,7 +323,7 @@ function validateDeclarativeFlowResumeState(flowEntry, config, state, executionR
     if (flowRequiresTaskScope(flowEntry) && !config.jiraRef) {
         throw new TaskRunnerError("Resume is impossible because Jira context is missing for this flow state. Use restart.");
     }
-    const pipelineContext = createPipelineContext({
+    const pipelineContext = await createPipelineContext({
         issueKey: config.taskKey,
         jiraRef: config.jiraRef,
         dryRun: config.dryRun,
@@ -338,51 +353,59 @@ function buildInteractiveBaseConfig(flowId, scope) {
         ...(flowId !== "instant-task" && scope.jiraRef ? { jiraRef: scope.jiraRef } : {}),
     });
 }
-function lookupInteractiveFlowResume(flowEntry, currentScope) {
+async function lookupInteractiveFlowResume(flowEntry, currentScope) {
     const directState = loadFlowRunState(currentScope.scopeKey, flowEntry.id);
-    if (directState && hasResumableFlowState(directState)) {
+    const availability = classifyFlowLaunchAvailability(directState);
+    if (directState && availability.resume.available) {
         try {
             const effectiveScope = scopeWithRestoredJiraContext(currentScope, directState);
             const baseConfig = buildInteractiveBaseConfig(flowEntry.id, effectiveScope);
             const config = buildRuntimeConfig(baseConfig, effectiveScope);
-            validateDeclarativeFlowResumeState(flowEntry, config, directState, directState.executionRouting);
+            await validateDeclarativeFlowResumeState(flowEntry, config, directState, directState.executionRouting);
             return {
-                resumeAvailable: true,
-                hasExistingState: true,
+                ...availability,
                 details: buildFlowResumeDetails(directState),
             };
         }
         catch (error) {
             return {
-                resumeAvailable: false,
-                hasExistingState: true,
+                ...availability,
+                resume: {
+                    available: false,
+                    reason: error.message,
+                },
                 details: `Interrupted run found, but resume is unavailable.\n${error.message}`,
             };
         }
     }
+    if (directState && availability.continue.available) {
+        return {
+            ...availability,
+            details: buildFlowContinueDetails(directState),
+        };
+    }
     return {
-        resumeAvailable: false,
-        hasExistingState: Boolean(directState),
+        ...availability,
     };
 }
-function printAutoPhasesHelp() {
-    const phaseLines = ["Available auto-golang phases:", "", ...autoPhaseIds()];
+async function printAutoPhasesHelp() {
+    const phaseLines = ["Available auto-golang phases:", "", ...(await autoPhaseIds())];
     phaseLines.push("", "You can resume auto-golang from a phase with:", "agentweaver auto-golang --from <phase> <jira>", "or in interactive mode:", "/auto-golang --from <phase>");
     printPanel("Auto-Golang Phases", phaseLines.join("\n"), "magenta");
 }
-function autoCommonPhaseIds() {
-    return loadDeclarativeFlow({ source: "built-in", fileName: "auto-common.json" }).phases.map((phase) => phase.id);
+async function autoCommonPhaseIds() {
+    return (await loadDeclarativeFlow({ source: "built-in", fileName: "auto-common.json" })).phases.map((phase) => phase.id);
 }
-function printAutoCommonPhasesHelp() {
-    const phaseLines = ["Available auto-common phases:", "", ...autoCommonPhaseIds()];
+async function printAutoCommonPhasesHelp() {
+    const phaseLines = ["Available auto-common phases:", "", ...(await autoCommonPhaseIds())];
     phaseLines.push("", "You can run auto-common with:", "agentweaver auto-common <jira>");
     printPanel("Auto-Common Phases", phaseLines.join("\n"), "magenta");
 }
-function autoSimplePhaseIds() {
-    return loadDeclarativeFlow({ source: "built-in", fileName: "auto-simple.json" }).phases.map((phase) => phase.id);
+async function autoSimplePhaseIds() {
+    return (await loadDeclarativeFlow({ source: "built-in", fileName: "auto-simple.json" })).phases.map((phase) => phase.id);
 }
-function printAutoSimplePhasesHelp() {
-    const phaseLines = ["Available auto-simple phases:", "", ...autoSimplePhaseIds()];
+async function printAutoSimplePhasesHelp() {
+    const phaseLines = ["Available auto-simple phases:", "", ...(await autoSimplePhaseIds())];
     phaseLines.push("", "You can run auto-simple with:", "agentweaver auto-simple <jira>");
     printPanel("Auto-Simple Phases", phaseLines.join("\n"), "magenta");
 }
@@ -400,7 +423,7 @@ function buildBaseConfig(command, options = {}) {
         reviewFixPoints: options.reviewFixPoints ?? null,
         reviewBlockingSeverities: options.reviewBlockingSeverities ?? resolveReviewBlockingSeveritiesFromEnv(),
         extraPrompt: options.extraPrompt ?? null,
-        autoFromPhase: options.autoFromPhase ? validateAutoPhaseId(options.autoFromPhase) : null,
+        autoFromPhase: options.autoFromPhase ?? null,
         mdLang: options.mdLang ?? null,
         dryRun: options.dryRun ?? false,
         verbose: options.verbose ?? false,
@@ -498,29 +521,42 @@ function routingForPrerequisites(launchProfile, executionRouting) {
 function flowSpecFileForPrerequisiteChecks(command) {
     return isBuiltInCommandFlowId(command) ? builtInCommandFlowFile(command) : null;
 }
-function commandRoutingGroupsForPrerequisiteChecks(command, cwd) {
+async function commandRoutingGroupsForPrerequisiteChecks(command, cwd) {
     const fileName = flowSpecFileForPrerequisiteChecks(command);
     if (!fileName) {
         return [];
     }
-    return collectFlowRoutingGroups(loadDeclarativeFlow({ source: "built-in", fileName }), cwd);
+    return collectFlowRoutingGroups(await loadDeclarativeFlow({ source: "built-in", fileName }), cwd);
 }
-function resolveExecutorPrerequisite(executor) {
+function resolveExecutorPrerequisite(executor, registryContext) {
     if (executor === "codex") {
         resolveCmd("codex", "CODEX_BIN");
         return;
     }
-    resolveCmd("opencode", "OPENCODE_BIN");
+    if (executor === "opencode") {
+        resolveCmd("opencode", "OPENCODE_BIN");
+        return;
+    }
+    const definition = registryContext.executors.get(executor);
+    const config = definition.defaultConfig;
+    if (config
+        && typeof config === "object"
+        && !Array.isArray(config)
+        && typeof config.defaultCommand === "string"
+        && typeof config.commandEnvVar === "string") {
+        resolveCmd(config.defaultCommand, config.commandEnvVar);
+    }
 }
-function checkPrerequisites(config, launchProfile, executionRouting) {
+async function checkPrerequisites(config, launchProfile, executionRouting) {
+    const registryContext = await createPipelineRegistryContext(process.cwd());
     const routing = routingForPrerequisites(launchProfile, executionRouting);
-    const groups = commandRoutingGroupsForPrerequisiteChecks(config.command, process.cwd());
+    const groups = await commandRoutingGroupsForPrerequisiteChecks(config.command, process.cwd());
     for (const executor of executorsForRoutingGroups(routing, groups)) {
-        resolveExecutorPrerequisite(executor);
+        resolveExecutorPrerequisite(executor, registryContext);
     }
 }
-function checkAutoPrerequisites(config, launchProfile, executionRouting) {
-    checkPrerequisites(config, launchProfile, executionRouting);
+async function checkAutoPrerequisites(config, launchProfile, executionRouting) {
+    await checkPrerequisites(config, launchProfile, executionRouting);
 }
 function autoFlowParams(config, forceRefreshSummary = false) {
     return {
@@ -616,7 +652,7 @@ function interactiveFlowDefinition(entry) {
         description: flow.description ?? "No description available for this flow.",
         source: entry.source,
         treePath: [...entry.treePath],
-        ...(entry.source === "project-local" ? { sourcePath: entry.absolutePath } : {}),
+        ...(entry.source !== "built-in" ? { sourcePath: entry.absolutePath } : {}),
         phases: flow.phases.map((phase) => ({
             id: phase.id,
             repeatVars: Object.fromEntries(Object.entries(phase.repeatVars).map(([key, value]) => [key, value])),
@@ -666,7 +702,7 @@ function findCurrentFlowExecutionStep(state) {
     return null;
 }
 async function runDeclarativeFlowByRef(flowId, flowRef, config, flowParams, overrides = {}, requestUserInput = requestUserInputInTerminal, setSummary, launchMode = "restart", runtime = runtimeServices) {
-    const context = createPipelineContext({
+    const context = await createPipelineContext({
         issueKey: config.taskKey,
         jiraRef: config.jiraRef,
         dryRun: config.dryRun,
@@ -677,7 +713,7 @@ async function runDeclarativeFlowByRef(flowId, flowRef, config, flowParams, over
         requestUserInput,
         ...(overrides.executionRouting ? { executionRouting: overrides.executionRouting } : {}),
     });
-    const flow = loadDeclarativeFlow(flowRef);
+    const flow = await loadDeclarativeFlow(flowRef);
     const initialExecutionState = {
         flowKind: flow.kind,
         flowVersion: flow.version,
@@ -685,9 +721,12 @@ async function runDeclarativeFlowByRef(flowId, flowRef, config, flowParams, over
         terminationOutcome: "success",
         phases: [],
     };
-    let persistedState = launchMode === "resume" ? loadFlowRunState(config.scope.scopeKey, flowId) : null;
+    const existingStateForRestart = launchMode === "restart" ? loadFlowRunState(config.scope.scopeKey, flowId) : null;
+    let persistedState = launchMode === "resume" || launchMode === "continue"
+        ? loadFlowRunState(config.scope.scopeKey, flowId)
+        : null;
     if (persistedState && launchMode === "resume") {
-        validateDeclarativeFlowResumeState({
+        await validateDeclarativeFlowResumeState({
             id: flowId,
             source: flow.source,
             fileName: flow.fileName,
@@ -700,7 +739,13 @@ async function runDeclarativeFlowByRef(flowId, flowRef, config, flowParams, over
             } }) : undefined), runtime);
         persistedState = prepareFlowStateForResume(persistedState);
     }
+    else if (persistedState && launchMode === "continue") {
+        persistedState = prepareFlowStateForContinue(persistedState, flow.phases);
+    }
     else if (launchMode === "restart") {
+        if (existingStateForRestart) {
+            archiveActiveAttempt(config.scope.scopeKey);
+        }
         resetFlowRunState(config.scope.scopeKey, flowId);
     }
     const executionState = persistedState?.executionState ?? initialExecutionState;
@@ -772,7 +817,7 @@ async function runDeclarativeFlowBySpecFile(fileName, config, flowParams, overri
         ...defaultDeclarativeFlowParams(config, false, overrides),
         ...flowParams,
     };
-    await runDeclarativeFlowByRef(config.command, { source: "built-in", fileName }, config, withCanonicalReviewLoopParams(loadDeclarativeFlow({ source: "built-in", fileName }).kind, mergedFlowParams), overrides, requestUserInput, setSummary, launchMode, runtime);
+    await runDeclarativeFlowByRef(config.command, { source: "built-in", fileName }, config, withCanonicalReviewLoopParams((await loadDeclarativeFlow({ source: "built-in", fileName })).kind, mergedFlowParams), overrides, requestUserInput, setSummary, launchMode, runtime);
 }
 function defaultDeclarativeFlowParams(config, forceRefreshSummary = false, overrides = {}) {
     const iteration = nextReviewIterationForTask(config.taskKey);
@@ -808,6 +853,7 @@ function defaultDeclarativeFlowParams(config, forceRefreshSummary = false, overr
         executionRouting,
         iteration,
         baseIteration: iteration,
+        designReviewBaseIteration: nextDesignReviewIterationForTask(config.taskKey),
         latestIteration,
         taskContextIteration: latestTaskContext ?? nextArtifactIteration(config.taskKey, "task-context", "json"),
         taskSummaryIteration: nextArtifactIteration(config.taskKey, "task"),
@@ -818,6 +864,60 @@ function defaultDeclarativeFlowParams(config, forceRefreshSummary = false, overr
         forceRefresh: forceRefreshSummary,
     };
 }
+function countAvailableNonRestartActions(availability) {
+    return Number(availability.resume.available) + Number(availability.continue.available);
+}
+async function chooseLaunchMode(flowId, scopeKey, explicitLaunchMode, requestUserInput) {
+    const state = loadFlowRunState(scopeKey, flowId);
+    const availability = classifyFlowLaunchAvailability(state);
+    if (explicitLaunchMode) {
+        const selectedAvailability = availability[explicitLaunchMode];
+        if (!selectedAvailability.available) {
+            throw new TaskRunnerError(`${explicitLaunchMode.charAt(0).toUpperCase()}${explicitLaunchMode.slice(1)} is not available for '${flowId}'. ${selectedAvailability.reason}`);
+        }
+        return explicitLaunchMode;
+    }
+    if (!availability.hasExistingState) {
+        return "restart";
+    }
+    const availableNonRestart = countAvailableNonRestartActions(availability);
+    if (availableNonRestart === 0) {
+        return "restart";
+    }
+    const interactive = requestUserInput !== requestUserInputInTerminal || (process.stdin.isTTY && process.stdout.isTTY);
+    if (!interactive) {
+        throw new TaskRunnerError(`Multiple actions are valid for '${flowId}'. Re-run with one of: --resume, --continue, --restart.`);
+    }
+    const result = await requestUserInput({
+        formId: `launch-mode-${flowId}`,
+        title: "Launch Action",
+        description: `Select how to start '${flowId}'.`,
+        submitLabel: "Start",
+        fields: [
+            {
+                id: "launchMode",
+                type: "single-select",
+                label: "Action",
+                required: true,
+                default: availability.continue.available ? "continue" : availability.resume.available ? "resume" : "restart",
+                options: [
+                    ...(availability.resume.available
+                        ? [{ value: "resume", label: "Resume", description: availability.resume.reason }]
+                        : []),
+                    ...(availability.continue.available
+                        ? [{ value: "continue", label: "Continue", description: availability.continue.reason }]
+                        : []),
+                    { value: "restart", label: "Restart", description: availability.restart.reason },
+                ],
+            },
+        ],
+    });
+    const selected = result.values.launchMode;
+    if (selected !== "resume" && selected !== "continue" && selected !== "restart") {
+        throw new TaskRunnerError(`Invalid launch action selected for '${flowId}'.`);
+    }
+    return selected;
+}
 const TASK_SCOPE_PARAM_REFS = new Set(["params.jiraApiUrl", "params.jiraBrowseUrl", "params.jiraTaskFile"]);
 function valueReferencesTaskScopeParams(value) {
     if (Array.isArray(value)) {
@@ -840,7 +940,7 @@ function flowRequiresTaskScope(entry) {
     return valueReferencesTaskScopeParams(entry.flow.phases);
 }
 async function summarizeBuildFailure(output) {
-    return summarizeBuildFailureViaPipeline(createPipelineContext({
+    return summarizeBuildFailureViaPipeline(await createPipelineContext({
         issueKey: "build-failure-summary",
         jiraRef: "build-failure-summary",
         dryRun: false,
@@ -855,7 +955,7 @@ function requireJiraConfig(config) {
         throw new TaskRunnerError(`Command '${config.command}' requires Jira context in the current project scope.`);
     }
 }
-async function executeCommand(baseConfig, runFollowupVerify = true, requestUserInput = requestUserInputInTerminal, resolvedScope, setSummary, forceRefreshSummary = false, launchMode = "restart", launchProfile, executionRouting, selectedRoutingPreset, runtime = runtimeServices) {
+async function executeCommand(baseConfig, runFollowupVerify = true, requestUserInput = requestUserInputInTerminal, resolvedScope, setSummary, forceRefreshSummary = false, explicitLaunchMode, launchProfile, executionRouting, selectedRoutingPreset, runtime = runtimeServices) {
     if (baseConfig.command === "doctor") {
         const exitCode = await runDoctorCommand(baseConfig.doctorArgs ?? []);
         return exitCode === 0;
@@ -870,8 +970,11 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
         : launchProfile
             ? { launchProfile }
             : {};
+    const launchMode = config.command === "auto-status" || config.command === "auto-reset"
+        ? "restart"
+        : await chooseLaunchMode(config.command, config.scope.scopeKey, explicitLaunchMode, requestUserInput);
     if (config.command === "instant-task") {
-        checkPrerequisites(config, launchProfile, executionRouting);
+        await checkPrerequisites(config, launchProfile, executionRouting);
         const hasPersistedInstantTaskState = loadFlowRunState(config.scope.scopeKey, "instant-task") !== null;
         const repromptInstantTaskInput = launchMode === "restart"
             && hasPersistedInstantTaskState
@@ -900,7 +1003,8 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
         let effectiveLaunchProfile = launchProfile;
         let effectiveExecutionRouting = executionRouting;
         if (config.autoFromPhase) {
-            const flow = loadDeclarativeFlow({ source: "built-in", fileName: "auto-golang.json" });
+            config.autoFromPhase = await validateAutoPhaseId(config.autoFromPhase);
+            const flow = await loadDeclarativeFlow({ source: "built-in", fileName: "auto-golang.json" });
             const persistedState = loadFlowRunState(config.scope.scopeKey, "auto-golang");
             if (!persistedState) {
                 throw new TaskRunnerError(`Cannot restart auto-golang from phase '${config.autoFromPhase}' because persisted flow state was not found.`);
@@ -912,7 +1016,7 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
             effectiveExecutionRouting ??= persistedState.executionRouting;
             printPanel("Auto-Golang Resume", `Auto-golang pipeline will continue from phase: ${config.autoFromPhase}`, "yellow");
         }
-        checkAutoPrerequisites(config, effectiveLaunchProfile, effectiveExecutionRouting);
+        await checkAutoPrerequisites(config, effectiveLaunchProfile, effectiveExecutionRouting);
         await runDeclarativeFlowBySpecFile("auto-golang.json", config, autoFlowParams(config, forceRefreshSummary), effectiveExecutionRouting
             ? {
                 launchProfile: effectiveExecutionRouting.defaultRoute,
@@ -926,7 +1030,7 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
     }
     if (config.command === "auto-common") {
         requireJiraConfig(config);
-        checkAutoPrerequisites(config, launchProfile, executionRouting);
+        await checkAutoPrerequisites(config, launchProfile, executionRouting);
         process.env.JIRA_BROWSE_URL = config.jiraBrowseUrl;
         process.env.JIRA_API_URL = config.jiraApiUrl;
         process.env.JIRA_TASK_FILE = config.jiraTaskFile;
@@ -935,7 +1039,7 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
     }
     if (config.command === "auto-simple") {
         requireJiraConfig(config);
-        checkAutoPrerequisites(config, launchProfile, executionRouting);
+        await checkAutoPrerequisites(config, launchProfile, executionRouting);
         process.env.JIRA_BROWSE_URL = config.jiraBrowseUrl;
         process.env.JIRA_API_URL = config.jiraApiUrl;
         process.env.JIRA_TASK_FILE = config.jiraTaskFile;
@@ -949,7 +1053,7 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
             return false;
         }
         const currentStep = findCurrentFlowExecutionStep(state) ?? state.currentStep ?? "-";
-        const phaseOrder = loadDeclarativeFlow({ source: "built-in", fileName: "auto-golang.json" }).phases;
+        const phaseOrder = (await loadDeclarativeFlow({ source: "built-in", fileName: "auto-golang.json" })).phases;
         const lines = [
             `Issue: ${config.taskKey}`,
             `Status: ${state.status}`,
@@ -986,7 +1090,7 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
         printPanel("Auto-Golang Reset", removed ? `State file ${flowStateFile(config.scope.scopeKey, "auto-golang")} removed.` : "No flow state file found.", "yellow");
         return false;
     }
-    checkPrerequisites(config, launchProfile, executionRouting);
+    await checkPrerequisites(config, launchProfile, executionRouting);
     if (config.jiraBrowseUrl && config.jiraApiUrl && config.jiraTaskFile) {
         process.env.JIRA_BROWSE_URL = config.jiraBrowseUrl ?? "";
         process.env.JIRA_API_URL = config.jiraApiUrl ?? "";
@@ -1290,7 +1394,7 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
     }
     throw new TaskRunnerError(`Unsupported command: ${config.command}`);
 }
-function parseCliArgs(argv) {
+async function parseCliArgs(argv) {
     if (argv.includes("--version") || argv.includes("-v")) {
         process.stdout.write(`${packageVersion()}\n`);
         process.exit(0);
@@ -1317,6 +1421,7 @@ function parseCliArgs(argv) {
     let helpPhases = false;
     let jiraRef;
     let mdLang;
+    let launchMode;
     const doctorArgs = [];
     for (let index = 1; index < argv.length; index += 1) {
         const token = argv[index] ?? "";
@@ -1332,6 +1437,14 @@ function parseCliArgs(argv) {
             helpPhases = true;
             continue;
         }
+        if (token === "--resume" || token === "--continue" || token === "--restart") {
+            if (launchMode) {
+                process.stderr.write("Error: --resume, --continue, and --restart are mutually exclusive.\n");
+                process.exit(1);
+            }
+            launchMode = token.slice(2);
+            continue;
+        }
         if (token === "--prompt") {
             prompt = argv[index + 1];
             index += 1;
@@ -1387,15 +1500,15 @@ function parseCliArgs(argv) {
         }
     }
     if (command === "auto-golang" && helpPhases) {
-        printAutoPhasesHelp();
+        await printAutoPhasesHelp();
         process.exit(0);
     }
     if (command === "auto-common" && helpPhases) {
-        printAutoCommonPhasesHelp();
+        await printAutoCommonPhasesHelp();
         process.exit(0);
     }
     if (command === "auto-simple" && helpPhases) {
-        printAutoSimplePhasesHelp();
+        await printAutoSimplePhasesHelp();
         process.exit(0);
     }
     return {
@@ -1410,6 +1523,7 @@ function parseCliArgs(argv) {
         ...(autoFromPhase !== undefined ? { autoFromPhase } : {}),
         ...(mdLang !== undefined ? { mdLang } : {}),
         ...(doctorArgs.length > 0 ? { doctorArgs } : {}),
+        ...(launchMode !== undefined ? { launchMode } : {}),
     };
 }
 function buildConfigFromArgs(args) {
@@ -1428,7 +1542,7 @@ function buildConfigFromArgs(args) {
 async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
     let currentScope = resolveProjectScope(scopeName, jiraRef);
     const gitBranchName = detectGitBranchName();
-    const flowCatalog = loadInteractiveFlowCatalog(process.cwd());
+    const flowCatalog = await loadInteractiveFlowCatalog(process.cwd());
     let activeAbortController = null;
     let activeFlowId = null;
     let exiting = false;
@@ -1445,7 +1559,7 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
             if (!flowEntry) {
                 throw new TaskRunnerError(`Unknown flow: ${flowId}`);
             }
-            const resumeLookup = lookupInteractiveFlowResume(flowEntry, currentScope);
+            const resumeLookup = await lookupInteractiveFlowResume(flowEntry, currentScope);
             return resumeLookup;
         },
         onRun: async (flowId, launchMode) => {
@@ -1457,7 +1571,7 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
                 if (!flowEntry) {
                     throw new TaskRunnerError(`Unknown flow: ${flowId}`);
                 }
-                const routingGroups = flowRoutingGroups(flowEntry, process.cwd());
+                const routingGroups = await flowRoutingGroups(flowEntry, process.cwd());
                 const resumeState = launchMode === "resume" ? loadFlowRunState(currentScope.scopeKey, flowId) : null;
                 if (resumeState) {
                     currentScope = scopeWithRestoredJiraContext(currentScope, resumeState);
@@ -1579,8 +1693,8 @@ export async function main(argv = process.argv.slice(2)) {
         if (args.length === 1 && !args[0]?.startsWith("-") && !COMMANDS.includes(args[0])) {
             return await runInteractive(args[0] ?? "", forceRefresh);
         }
-        const parsedArgs = parseCliArgs(args);
-        const commandCompleted = await executeCommand(buildConfigFromArgs(parsedArgs));
+        const parsedArgs = await parseCliArgs(args);
+        const commandCompleted = await executeCommand(buildConfigFromArgs(parsedArgs), true, requestUserInputInTerminal, undefined, undefined, false, parsedArgs.launchMode);
         if (parsedArgs.command === "doctor") {
             return commandCompleted ? 0 : 1;
         }