agentweaver 0.1.17 → 0.1.18

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, writeSync } from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
@@ -32,12 +32,14 @@ import { clearReadyToMergeFile } from "./runtime/ready-to-merge.js";
 import { describeExecutionRouting, executorsForRoutingGroups, resolveExecutionRouting, } from "./runtime/execution-routing.js";
 import { requestInteractiveExecutionRouting } from "./runtime/interactive-execution-routing.js";
 import { createInteractiveSession } from "./interactive/create-interactive-session.js";
+import { createWebInteractiveSession } from "./interactive/web/index.js";
 import { bye, printError, printInfo, printPanel, printSummary, setFlowExecutionState, stripAnsi, } from "./tui.js";
 import { requestUserInputInTerminal } from "./user-input.js";
 import { runDoctorCommand } from "./doctor/index.js";
-import { detectGitBranchName, requestJiraContext, resolveProjectScope, } from "./scope.js";
+import { requestJiraContext, resolveProjectScope, } from "./scope.js";
 const COMMANDS = [
     "auto-golang",
+    "auto-common-guided",
     "auto-common",
     "auto-simple",
     "auto-status",
@@ -53,7 +55,9 @@ const COMMANDS = [
     "mr-description",
     "plan",
     "plan-revise",
+    "playbook-init",
     "task-describe",
+    "web",
     "implement",
     "review",
     "review-fix",
@@ -61,8 +65,17 @@ const COMMANDS = [
     "run-go-tests-loop",
     "run-go-linter-loop",
 ];
+const INTERACTIVE_SCOPE_WATCH_INTERVAL_MS = 1500;
+const WEB_AUTH_USERNAME_ENV = "AGENTWEAVER_WEB_USERNAME";
+const WEB_AUTH_PASSWORD_ENV = "AGENTWEAVER_WEB_PASSWORD";
 const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = path.resolve(MODULE_DIR, "..");
+function writeStdoutSync(text) {
+    writeSync(process.stdout.fd, text);
+}
+function writeStderrSync(text) {
+    writeSync(process.stderr.fd, text);
+}
 function createRuntimeServices(signal) {
     return {
         resolveCmd,
@@ -71,6 +84,37 @@ function createRuntimeServices(signal) {
     };
 }
 const runtimeServices = createRuntimeServices();
+function isExternalWebHost(host) {
+    const normalized = (host?.trim() || "127.0.0.1").toLowerCase();
+    if (normalized === "127.0.0.1" || normalized === "::1" || normalized === "localhost") {
+        return false;
+    }
+    const unbracketed = normalized.startsWith("[") && normalized.endsWith("]") ? normalized.slice(1, -1) : normalized;
+    if (unbracketed === "::1") {
+        return false;
+    }
+    return true;
+}
+function resolveWebAuthConfig() {
+    const username = process.env[WEB_AUTH_USERNAME_ENV]?.trim() ?? "";
+    const password = process.env[WEB_AUTH_PASSWORD_ENV] ?? "";
+    const hasUsername = username.length > 0;
+    const hasPassword = password.length > 0;
+    if (hasUsername !== hasPassword) {
+        throw new TaskRunnerError(`Web UI auth requires both ${WEB_AUTH_USERNAME_ENV} and ${WEB_AUTH_PASSWORD_ENV}.`);
+    }
+    if (!hasUsername || !hasPassword) {
+        return undefined;
+    }
+    return { username, password };
+}
+function requireWebAuthForHost(host, auth) {
+    if (!isExternalWebHost(host) || auth) {
+        return;
+    }
+    throw new TaskRunnerError(`External Web UI binding requires ${WEB_AUTH_USERNAME_ENV} and ${WEB_AUTH_PASSWORD_ENV}. ` +
+        "Use localhost for no-auth local access, or configure credentials before using --listen-all or --host with an external interface.");
+}
 function buildFailureOutputPreview(output) {
     const normalized = stripAnsi(output).replace(/\r\n/g, "\n").trim();
     if (!normalized) {
@@ -110,6 +154,7 @@ function usage() {
   agentweaver
   agentweaver <jira-browse-url|jira-issue-key>
   agentweaver --force <jira-browse-url|jira-issue-key>
+  agentweaver web [--no-open] [--host <host>|--listen-all] [<jira-browse-url|jira-issue-key>]
   agentweaver git-commit [--dry] [--verbose] [--prompt <text>] [--scope <name>] [<jira-browse-url|jira-issue-key>]
   agentweaver gitlab-diff-review [--dry] [--verbose] [--prompt <text>] [--scope <name>]
   agentweaver gitlab-review [--dry] [--verbose] [--prompt <text>] [--scope <name>]
@@ -121,6 +166,7 @@ function usage() {
   agentweaver mr-description [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
   agentweaver plan [--dry] [--verbose] [--prompt <text>] [--md-lang <en|ru>] [<jira-browse-url|jira-issue-key>]
   agentweaver plan-revise [--dry] [--verbose] [--prompt <text>] <jira-browse-url|jira-issue-key>
+  agentweaver playbook-init [--dry] [--verbose] [--prompt <text>] [--accept-playbook-draft] [--scope <name>]
   agentweaver task-describe [--dry] [--verbose] [--prompt <text>] [<jira-browse-url|jira-issue-key>]
   agentweaver implement [--dry] [--verbose] [--prompt <text>] [--scope <name>] [<jira-browse-url|jira-issue-key>]
   agentweaver review [--dry] [--verbose] [--prompt <text>] [--scope <name>] [--blocking-severities <list>] [<jira-browse-url|jira-issue-key>]
@@ -131,6 +177,7 @@ function usage() {
   agentweaver auto-golang [--dry] [--verbose] [--prompt <text>] [<jira-browse-url|jira-issue-key>]
   agentweaver auto-golang [--dry] [--verbose] [--prompt <text>] --from <phase> [<jira-browse-url|jira-issue-key>]
   agentweaver auto-golang --help-phases
+  agentweaver auto-common-guided [--dry] [--verbose] [--prompt <text>] [--md-lang <en|ru>] [--accept-playbook-draft] <jira-browse-url|jira-issue-key>
   agentweaver auto-common [--dry] [--verbose] [--prompt <text>] [--md-lang <en|ru>] <jira-browse-url|jira-issue-key>
   agentweaver auto-common --help-phases
   agentweaver auto-simple [--dry] [--verbose] [--prompt <text>] [--md-lang <en|ru>] <jira-browse-url|jira-issue-key>
@@ -146,6 +193,9 @@ Interactive Mode:
 Flags:
   --version       Show package version
   --force         In interactive mode, regenerate task summary in Jira-backed flows
+  --no-open       Web command only: print the Web UI URL without opening a browser
+  --host          Web command only: bind Web UI to this host (default: 127.0.0.1)
+  --listen-all    Web command only: bind Web UI to 0.0.0.0
   --dry           Fetch Jira task, but print codex/opencode commands instead of executing them
   --verbose       Show live stdout/stderr of launched commands
   --scope         Explicit workflow scope name for non-Jira runs except instant-task
@@ -154,7 +204,8 @@ Flags:
   --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)
+  --md-lang       Language for workflow markdown artifacts only: en (English) or ru (Russian, default)
+  --accept-playbook-draft  Non-interactively accept generated playbook content for playbook-init or auto-common-guided missing-manifest runs
 
 Required environment variables:
   JIRA_API_KEY    Jira API token used for Jira-backed flows (Bearer by default, or Basic with Jira Cloud)
@@ -170,9 +221,15 @@ Optional environment variables:
   CODEX_MODEL
   OPENCODE_BIN
   OPENCODE_MODEL
+  AGENTWEAVER_WEB_NO_OPEN  Set to 1 to disable browser auto-open for agentweaver web
+  ${WEB_AUTH_USERNAME_ENV}  Web UI Basic auth username; required for external Web UI binding
+  ${WEB_AUTH_PASSWORD_ENV}  Web UI Basic auth password; required for external Web UI binding
 
 Notes:
   - Jira-backed task flows will ask for Jira task via user-input when it is not passed as an argument. task-describe can also work from a manual task description without Jira.
+  - agentweaver web binds to 127.0.0.1 by default on an operating-system-assigned port and does not require auth unless Web UI credentials are configured.
+  - External Web UI binding through --listen-all, --host 0.0.0.0, --host ::, non-loopback IPs, or hostnames other than localhost requires ${WEB_AUTH_USERNAME_ENV} and ${WEB_AUTH_PASSWORD_ENV}.
+  - Web UI Basic auth over plain HTTP is suitable only on trusted networks; use TLS termination or a reverse proxy on untrusted networks.
   - instant-task always uses the current branch-derived project scope and rejects explicit scope overrides or Jira arguments.
   - All flow state and artifacts are stored in the current project scope by default.
   - gitlab-review and gitlab-diff-review ask for GitLab merge request URL via user-input.
@@ -393,13 +450,13 @@ async function printAutoPhasesHelp() {
     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");
 }
-async function autoCommonPhaseIds() {
-    return (await loadDeclarativeFlow({ source: "built-in", fileName: "auto-common.json" })).phases.map((phase) => phase.id);
+async function autoCommonPhaseIds(fileName = "auto-common.json") {
+    return (await loadDeclarativeFlow({ source: "built-in", fileName })).phases.map((phase) => phase.id);
 }
-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");
+async function printAutoCommonPhasesHelp(command = "auto-common", fileName = "auto-common.json") {
+    const phaseLines = [`Available ${command} phases:`, "", ...(await autoCommonPhaseIds(fileName))];
+    phaseLines.push("", `You can run ${command} with:`, `agentweaver ${command} <jira>`);
+    printPanel(command === "auto-common-guided" ? "Auto-Common Guided Phases" : "Auto-Common Phases", phaseLines.join("\n"), "magenta");
 }
 async function autoSimplePhaseIds() {
     return (await loadDeclarativeFlow({ source: "built-in", fileName: "auto-simple.json" })).phases.map((phase) => phase.id);
@@ -428,6 +485,7 @@ function buildBaseConfig(command, options = {}) {
         dryRun: options.dryRun ?? false,
         verbose: options.verbose ?? false,
         ...(options.doctorArgs !== undefined ? { doctorArgs: options.doctorArgs } : {}),
+        ...(options.acceptPlaybookDraft !== undefined ? { acceptPlaybookDraft: options.acceptPlaybookDraft } : {}),
     };
 }
 function commandRequiresTask(command) {
@@ -437,6 +495,7 @@ function commandRequiresTask(command) {
         command === "design-review" ||
         command === "mr-description" ||
         command === "auto-golang" ||
+        command === "auto-common-guided" ||
         command === "auto-common" ||
         command === "auto-simple" ||
         command === "auto-status" ||
@@ -448,6 +507,7 @@ function commandSupportsProjectScope(command) {
         command === "gitlab-diff-review" ||
         command === "gitlab-review" ||
         command === "instant-task" ||
+        command === "playbook-init" ||
         command === "task-describe" ||
         command === "implement" ||
         command === "review" ||
@@ -572,6 +632,8 @@ function autoFlowParams(config, forceRefreshSummary = false) {
         reviewBlockingSeverities: config.reviewBlockingSeverities,
         forceRefresh: forceRefreshSummary,
         mdLang: config.mdLang,
+        acceptPlaybookDraft: config.command === "auto-common-guided" ? config.acceptPlaybookDraft === true : false,
+        launchMode: config.command === "auto-common-guided" ? config.autoFromPhase ?? "restart" : undefined,
         runGoTestsScript: path.join(agentweaverHome(PACKAGE_ROOT), "run_go_tests.py"),
         runGoLinterScript: path.join(agentweaverHome(PACKAGE_ROOT), "run_go_linter.py"),
         runGoTestsIteration: nextArtifactIteration(config.taskKey, "run-go-tests-result", "json"),
@@ -849,6 +911,10 @@ function defaultDeclarativeFlowParams(config, forceRefreshSummary = false, overr
         mdLang: config.mdLang,
         llmExecutor: launchProfile.executor,
         llmModel: launchProfile.model,
+        projectGuidanceFile: "not provided",
+        projectGuidanceJsonFile: "not provided",
+        repairProjectGuidanceFile: "not provided",
+        repairProjectGuidanceJsonFile: "not provided",
         launchProfile,
         executionRouting,
         iteration,
@@ -1028,13 +1094,13 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
                 : {}, requestUserInput, setSummary, effectiveLaunchMode, runtime);
         return false;
     }
-    if (config.command === "auto-common") {
+    if (config.command === "auto-common" || config.command === "auto-common-guided") {
         requireJiraConfig(config);
         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;
-        await runDeclarativeFlowBySpecFile("auto-common.json", config, autoFlowParams(config, forceRefreshSummary), flowOverrides, requestUserInput, setSummary, launchMode, runtime);
+        await runDeclarativeFlowBySpecFile(config.command === "auto-common-guided" ? "auto-common-guided.json" : "auto-common.json", config, autoFlowParams(config, forceRefreshSummary), flowOverrides, requestUserInput, setSummary, launchMode, runtime);
         return false;
     }
     if (config.command === "auto-simple") {
@@ -1135,6 +1201,14 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
         }, flowOverrides, requestUserInput, setSummary, launchMode, runtime);
         return false;
     }
+    if (config.command === "playbook-init") {
+        await runDeclarativeFlowBySpecFile("playbook-init.json", config, {
+            taskKey: config.taskKey,
+            extraPrompt: config.extraPrompt,
+            acceptPlaybookDraft: config.acceptPlaybookDraft === true,
+        }, flowOverrides, requestUserInput, setSummary, launchMode, runtime);
+        return false;
+    }
     if (config.command === "bug-analyze") {
         requireJiraConfig(config);
         if (config.verbose) {
@@ -1396,20 +1470,20 @@ async function executeCommand(baseConfig, runFollowupVerify = true, requestUserI
 }
 async function parseCliArgs(argv) {
     if (argv.includes("--version") || argv.includes("-v")) {
-        process.stdout.write(`${packageVersion()}\n`);
+        writeStdoutSync(`${packageVersion()}\n`);
         process.exit(0);
     }
     if (argv.includes("--help") || argv.includes("-h")) {
-        process.stdout.write(`${usage()}\n`);
+        writeStdoutSync(`${usage()}\n`);
         process.exit(0);
     }
     if (argv.length === 0) {
-        process.stderr.write(`${usage()}\n`);
+        writeStderrSync(`${usage()}\n`);
         process.exit(1);
     }
     const command = argv[0];
     if (!COMMANDS.includes(command)) {
-        process.stderr.write(`${usage()}\n`);
+        writeStderrSync(`${usage()}\n`);
         process.exit(1);
     }
     let dry = false;
@@ -1422,6 +1496,9 @@ async function parseCliArgs(argv) {
     let jiraRef;
     let mdLang;
     let launchMode;
+    let acceptPlaybookDraft = false;
+    let webNoOpen = process.env.AGENTWEAVER_WEB_NO_OPEN === "1";
+    let webHost;
     const doctorArgs = [];
     for (let index = 1; index < argv.length; index += 1) {
         const token = argv[index] ?? "";
@@ -1437,9 +1514,56 @@ async function parseCliArgs(argv) {
             helpPhases = true;
             continue;
         }
+        if (token === "--accept-playbook-draft") {
+            acceptPlaybookDraft = true;
+            continue;
+        }
+        if (token === "--no-open") {
+            if (command !== "web") {
+                writeStderrSync("Error: --no-open is only supported after the web command.\n");
+                process.exit(1);
+            }
+            webNoOpen = true;
+            continue;
+        }
+        if (token === "--listen-all") {
+            if (command !== "web") {
+                writeStderrSync("Error: --listen-all is only supported after the web command.\n");
+                process.exit(1);
+            }
+            webHost = "0.0.0.0";
+            continue;
+        }
+        if (token === "--host") {
+            if (command !== "web") {
+                writeStderrSync("Error: --host is only supported after the web command.\n");
+                process.exit(1);
+            }
+            const hostValue = argv[index + 1]?.trim();
+            if (!hostValue || hostValue.startsWith("-")) {
+                writeStderrSync("Error: --host requires a host value.\n");
+                process.exit(1);
+            }
+            webHost = hostValue;
+            index += 1;
+            continue;
+        }
+        if (token.startsWith("--host=")) {
+            if (command !== "web") {
+                writeStderrSync("Error: --host is only supported after the web command.\n");
+                process.exit(1);
+            }
+            const hostValue = token.slice("--host=".length).trim();
+            if (!hostValue) {
+                writeStderrSync("Error: --host requires a host value.\n");
+                process.exit(1);
+            }
+            webHost = hostValue;
+            continue;
+        }
         if (token === "--resume" || token === "--continue" || token === "--restart") {
             if (launchMode) {
-                process.stderr.write("Error: --resume, --continue, and --restart are mutually exclusive.\n");
+                writeStderrSync("Error: --resume, --continue, and --restart are mutually exclusive.\n");
                 process.exit(1);
             }
             launchMode = token.slice(2);
@@ -1475,7 +1599,7 @@ async function parseCliArgs(argv) {
                 mdLang = langValue;
             }
             else {
-                process.stderr.write("Error: --md-lang accepts only 'en' or 'ru' as values.\n");
+                writeStderrSync("Error: --md-lang accepts only 'en' or 'ru' as values.\n");
                 process.exit(1);
             }
             index += 1;
@@ -1487,7 +1611,7 @@ async function parseCliArgs(argv) {
                 mdLang = langValue;
             }
             else {
-                process.stderr.write("Error: --md-lang accepts only 'en' or 'ru' as values.\n");
+                writeStderrSync("Error: --md-lang accepts only 'en' or 'ru' as values.\n");
                 process.exit(1);
             }
             continue;
@@ -1503,8 +1627,8 @@ async function parseCliArgs(argv) {
         await printAutoPhasesHelp();
         process.exit(0);
     }
-    if (command === "auto-common" && helpPhases) {
-        await printAutoCommonPhasesHelp();
+    if ((command === "auto-common" || command === "auto-common-guided") && helpPhases) {
+        await printAutoCommonPhasesHelp(command, command === "auto-common-guided" ? "auto-common-guided.json" : "auto-common.json");
         process.exit(0);
     }
     if (command === "auto-simple" && helpPhases) {
@@ -1524,6 +1648,9 @@ async function parseCliArgs(argv) {
         ...(mdLang !== undefined ? { mdLang } : {}),
         ...(doctorArgs.length > 0 ? { doctorArgs } : {}),
         ...(launchMode !== undefined ? { launchMode } : {}),
+        ...(acceptPlaybookDraft ? { acceptPlaybookDraft } : {}),
+        ...(command === "web" ? { webNoOpen } : {}),
+        ...(command === "web" && webHost !== undefined ? { webHost } : {}),
     };
 }
 function buildConfigFromArgs(args) {
@@ -1537,24 +1664,66 @@ function buildConfigFromArgs(args) {
         dryRun: args.dry,
         verbose: args.verbose,
         ...(args.doctorArgs !== undefined ? { doctorArgs: args.doctorArgs } : {}),
+        ...(args.acceptPlaybookDraft !== undefined ? { acceptPlaybookDraft: args.acceptPlaybookDraft } : {}),
     });
 }
-async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
+async function runInteractiveWithSessionFactory(createSession, jiraRef, forceRefresh = false, scopeName, installSignalCleanup = false) {
     let currentScope = resolveProjectScope(scopeName, jiraRef);
-    const gitBranchName = detectGitBranchName();
     const flowCatalog = await loadInteractiveFlowCatalog(process.cwd());
     let activeAbortController = null;
     let activeFlowId = null;
+    let pendingScopeSwitch = null;
+    const autoScopeSwitchEnabled = !scopeName?.trim() && !jiraRef?.trim();
+    let lastObservedGitScope = currentScope;
+    let ui;
     let exiting = false;
-    const ui = createInteractiveSession({
+    const applyScopeSwitch = (nextScope, reason) => {
+        const previousScope = currentScope;
+        currentScope = nextScope;
+        ui.setScope(currentScope.scopeKey, currentScope.jiraIssueKey ?? null, currentScope.gitBranchName);
+        syncInteractiveTaskSummary(ui, currentScope, forceRefresh);
+        ui.appendLog(`[scope] ${reason}: ${previousScope.scopeKey} -> ${currentScope.scopeKey}`);
+    };
+    const handleObservedScope = (observedScope, reason) => {
+        if (observedScope.scopeKey === currentScope.scopeKey
+            && observedScope.gitBranchName === currentScope.gitBranchName) {
+            pendingScopeSwitch = null;
+            return;
+        }
+        if (activeAbortController) {
+            if (!pendingScopeSwitch
+                || pendingScopeSwitch.scopeKey !== observedScope.scopeKey
+                || pendingScopeSwitch.gitBranchName !== observedScope.gitBranchName) {
+                pendingScopeSwitch = observedScope;
+                ui.appendLog(`[scope] ${reason}: switch to ${observedScope.scopeKey} pending until current flow finishes`);
+            }
+            return;
+        }
+        pendingScopeSwitch = null;
+        applyScopeSwitch(observedScope, reason);
+    };
+    const refreshScopeFromGit = (reason) => {
+        if (!autoScopeSwitchEnabled) {
+            return;
+        }
+        const observedScope = resolveProjectScope(null, null);
+        if (observedScope.scopeKey === lastObservedGitScope.scopeKey
+            && observedScope.gitBranchName === lastObservedGitScope.gitBranchName) {
+            return;
+        }
+        lastObservedGitScope = observedScope;
+        handleObservedScope(observedScope, reason);
+    };
+    ui = createSession({
         scopeKey: currentScope.scopeKey,
         jiraIssueKey: currentScope.jiraIssueKey ?? null,
         summaryText: "",
         cwd: process.cwd(),
-        gitBranchName,
+        gitBranchName: currentScope.gitBranchName,
         version: packageVersion(),
         flows: interactiveFlowDefinitions(flowCatalog),
         getRunConfirmation: async (flowId) => {
+            refreshScopeFromGit("git scope refresh before launch confirmation");
             const flowEntry = findCatalogEntry(flowId, flowCatalog);
             if (!flowEntry) {
                 throw new TaskRunnerError(`Unknown flow: ${flowId}`);
@@ -1563,6 +1732,7 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
             return resumeLookup;
         },
         onRun: async (flowId, launchMode) => {
+            refreshScopeFromGit("git scope refresh before flow launch");
             const abortController = new AbortController();
             activeAbortController = abortController;
             activeFlowId = flowId;
@@ -1598,7 +1768,7 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
                     const jiraContext = await requestJiraContext((form) => ui.requestUserInput(form));
                     currentScope = resolveProjectScope(null, jiraContext.jiraRef);
                 }
-                ui.setScope(currentScope.scopeKey, currentScope.jiraIssueKey ?? null);
+                ui.setScope(currentScope.scopeKey, currentScope.jiraIssueKey ?? null, currentScope.gitBranchName);
                 if (previousScopeKey !== currentScope.scopeKey || currentScope.jiraIssueKey) {
                     syncInteractiveTaskSummary(ui, currentScope, forceRefresh);
                 }
@@ -1640,6 +1810,11 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
                 if (activeAbortController === abortController) {
                     activeAbortController = null;
                     activeFlowId = null;
+                    if (pendingScopeSwitch && !exiting) {
+                        const nextScope = pendingScopeSwitch;
+                        pendingScopeSwitch = null;
+                        applyScopeSwitch(nextScope, "git scope refresh after flow completion");
+                    }
                 }
             }
         },
@@ -1651,6 +1826,10 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
             activeAbortController.abort();
         },
         onExit: () => {
+            if (activeAbortController) {
+                ui.interruptActiveForm();
+                activeAbortController.abort();
+            }
             exiting = true;
         },
     });
@@ -1661,13 +1840,45 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
         ui.appendLog("[scope] project scope active; task summary will appear after a Jira-backed flow runs");
     }
     syncInteractiveTaskSummary(ui, currentScope, forceRefresh);
+    const scopeWatchInterval = autoScopeSwitchEnabled
+        ? setInterval(() => {
+            if (!exiting) {
+                refreshScopeFromGit("git branch changed");
+            }
+        }, INTERACTIVE_SCOPE_WATCH_INTERVAL_MS)
+        : null;
     return await new Promise((resolve, reject) => {
+        let cleanupStarted = false;
+        const requestExit = () => {
+            if (activeAbortController) {
+                ui.interruptActiveForm();
+                activeAbortController.abort();
+            }
+            exiting = true;
+        };
+        const onSigint = () => requestExit();
+        const onSigterm = () => requestExit();
+        if (installSignalCleanup) {
+            process.once("SIGINT", onSigint);
+            process.once("SIGTERM", onSigterm);
+        }
         const interval = setInterval(() => {
             if (!exiting) {
                 return;
             }
             clearInterval(interval);
             try {
+                if (cleanupStarted) {
+                    return;
+                }
+                cleanupStarted = true;
+                if (scopeWatchInterval) {
+                    clearInterval(scopeWatchInterval);
+                }
+                if (installSignalCleanup) {
+                    process.off("SIGINT", onSigint);
+                    process.off("SIGTERM", onSigterm);
+                }
                 ui.destroy();
                 bye();
                 resolve(0);
@@ -1678,6 +1889,12 @@ async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
         }, 100);
     });
 }
+async function runInteractive(jiraRef, forceRefresh = false, scopeName) {
+    return await runInteractiveWithSessionFactory(createInteractiveSession, jiraRef, forceRefresh, scopeName);
+}
+async function runWebInteractive(jiraRef, forceRefresh = false, noOpen = false, host, auth) {
+    return await runInteractiveWithSessionFactory((options) => createWebInteractiveSession(options, { noOpen, ...(host ? { host } : {}), ...(auth ? { auth } : {}), printInfo }), jiraRef, forceRefresh, null, true);
+}
 export async function main(argv = process.argv.slice(2)) {
     loadTieredEnv(process.cwd());
     let forceRefresh = false;
@@ -1687,6 +1904,9 @@ export async function main(argv = process.argv.slice(2)) {
         args.shift();
     }
     try {
+        if (args[0] === "--no-open") {
+            throw new TaskRunnerError("--no-open is only supported after the web command.");
+        }
         if (args.length === 0) {
             return await runInteractive(undefined, forceRefresh);
         }
@@ -1694,6 +1914,11 @@ export async function main(argv = process.argv.slice(2)) {
             return await runInteractive(args[0] ?? "", forceRefresh);
         }
         const parsedArgs = await parseCliArgs(args);
+        if (parsedArgs.command === "web") {
+            const webAuth = resolveWebAuthConfig();
+            requireWebAuthForHost(parsedArgs.webHost, webAuth);
+            return await runWebInteractive(parsedArgs.jiraRef, forceRefresh, parsedArgs.webNoOpen === true, parsedArgs.webHost, webAuth);
+        }
         const commandCompleted = await executeCommand(buildConfigFromArgs(parsedArgs), true, requestUserInputInTerminal, undefined, undefined, false, parsedArgs.launchMode);
         if (parsedArgs.command === "doctor") {
             return commandCompleted ? 0 : 1;
@@ -1702,12 +1927,12 @@ export async function main(argv = process.argv.slice(2)) {
     }
     catch (error) {
         if (error instanceof TaskRunnerError) {
-            printError(error.message);
+            writeStderrSync(`Error: ${error.message}\n`);
             return 1;
         }
         const returnCode = Number(error.returnCode);
         if (!Number.isNaN(returnCode)) {
-            printError(formatProcessFailure(error));
+            writeStderrSync(`Error: ${formatProcessFailure(error)}\n`);
             return returnCode || 1;
         }
         throw error;