@lazyingart/agintiflow 0.20.129 → 0.20.131

package/README.md

@@ -103,7 +103,7 @@ Provider signup and key pages:
 | Qwen / DashScope | [https://bailian.console.aliyun.com/](https://bailian.console.aliyun.com/) | `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` |
 | GRS AI image tools | [https://grsai.ai/dashboard/api-keys](https://grsai.ai/dashboard/api-keys) | Configure with `/auxiliary grsai` or `aginti login grsai` |
 
-The CLI quietly auto-starts or reuses the local web UI from the same project. It tries `http://127.0.0.1:3210` first, then `3211`, `3212`, and so on if the port is already occupied by another project. The active URL is shown in the CLI launch header. If startup is blocked, stale, or unavailable, the same header row shows the recovery hint; run `/webapp [port]` inside the CLI to retry, or `/webapp restart [port]` to stop and relaunch the local webapp with the current project and canonical `~/.agintiflow` session home. After a successful `aginti update` or accepted startup auto-update, AgInTiFlow also restarts the compatible local webapp so artifact serving uses the updated package.
+The CLI quietly auto-starts or reuses the local web UI from the same project. It tries `http://127.0.0.1:3210` first, then `3211`, `3212`, and so on if the port is already occupied by another project. The active URL is shown in the CLI launch header. If startup is blocked, stale, or unavailable, the same header row shows the recovery hint; run `/webapp [port]` inside the CLI to retry, `/webapp stop [port]` to stop the compatible local webapp, or `/webapp restart [port]` to stop and relaunch the local webapp with the current project and canonical `~/.agintiflow` session home. Use `/webapp disable` or `aginti webapp disable` to persistently disable automatic webapp startup and update-time restarts; use `/webapp enable` or `aginti webapp enable` to restore them. After a successful `aginti update` or accepted startup auto-update, AgInTiFlow restarts the compatible local webapp only when webapp auto-start is enabled.
 
 Package installation also makes a best-effort, non-blocking webapp initialization. Install never fails because the optional local webapp could not start.
 
@@ -111,6 +111,9 @@ Launch the web UI explicitly when you want a foreground web server:
 
 ```bash
 aginti webapp
+aginti webapp disable
+aginti webapp enable
+aginti webapp stop
 aginti webapp restart
 aginti web --port 3210
 # opens http://127.0.0.1:3210, or the next available port
@@ -145,7 +148,7 @@ aginti --language de
 | Goal | Command |
 | --- | --- |
 | Start interactive chat | `aginti` or `aginti chat` |
-| Start local web app | Auto-starts with `aginti`; detached command is `aginti webapp`; restart with `aginti webapp restart`; foreground mode is `aginti web --port 3210` |
+| Start local web app | Auto-starts with `aginti`; detached command is `aginti webapp`; disable/enable auto-start with `aginti webapp disable` / `aginti webapp enable`; stop with `aginti webapp stop`; restart with `aginti webapp restart`; foreground mode is `aginti web --port 3210` |
 | Save provider keys | `aginti auth`, `/auth`, `/login` |
 | Review current repo | `/review [focus]` |
 | Toggle SCS quality gate | `/scs` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyingart/agintiflow",
-  "version": "0.20.129",
+  "version": "0.20.131",
   "type": "module",
   "description": "AgInTiFlow is a project-aware agent workspace for hybrid wet-dry R&D, hardware-aware intelligence, software automation, and industrial workflows.",
   "license": "Apache-2.0",

package/scripts/smoke-webapp-command.js

@@ -14,6 +14,10 @@ function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function occurrenceCount(value, pattern) {
+  return String(value || "").split(pattern).length - 1;
+}
+
 async function waitFor(predicate, child, label, output) {
   const deadline = Date.now() + 12000;
   while (Date.now() < deadline) {
@@ -74,6 +78,26 @@ async function runCase({ port, env = {}, expectHeader, label }) {
     if (path.resolve(health.agintiflowHome) !== path.resolve(path.join(runtimeDir, `.agintiflow-web-home-${label}`))) {
       throw new Error(`webapp command inherited the wrong home for ${label}: ${JSON.stringify(health)}`);
     }
+    child.stdin.write(`/webapp disable\n`);
+    await waitFor(() => output.stdout.includes("webapp auto-start=disabled"), child, `${label} /webapp disable command`, output);
+    const disabledCount = occurrenceCount(output.stdout, "webapp auto-start=disabled");
+    child.stdin.write(`/webapp status\n`);
+    await waitFor(() => occurrenceCount(output.stdout, "webapp auto-start=disabled") > disabledCount, child, `${label} /webapp status disabled command`, output);
+    child.stdin.write(`/webapp enable\n`);
+    await waitFor(() => output.stdout.includes("webapp auto-start=enabled"), child, `${label} /webapp enable command`, output);
+    child.stdin.write(`/webapp stop ${port}\n`);
+    await waitFor(() => output.stdout.includes(`webapp=http://127.0.0.1:${port} stopped`), child, `${label} /webapp stop command`, output);
+    let stopped = false;
+    try {
+      await fetch(`http://127.0.0.1:${port}/health`);
+    } catch {
+      stopped = true;
+    }
+    if (!stopped) {
+      throw new Error(`webapp still responded after /webapp stop for ${label}`);
+    }
+    child.stdin.write(`/webapp ${port}\n`);
+    await waitFor(() => output.stdout.includes(`webapp=http://127.0.0.1:${port} started`), child, `${label} /webapp restart after stop`, output);
   } finally {
     child.kill("SIGTERM");
     await killPort(port);

package/src/cli.js

@@ -37,7 +37,7 @@ import { handleSkillMeshCommand } from "./skillmesh.js";
 import { handleAapsCliCommand } from "./aaps-adapter.js";
 import { formatInstructionTemplateList, normalizeInstructionTemplate } from "./behavior-contract.js";
 import { applyPermissionMode, normalizePermissionMode } from "./permission-modes.js";
-import { ensureAgintiWebApp } from "./web-autostart.js";
+import { ensureAgintiWebApp, readWebAppPreference, stopAgintiWebApp, writeWebAppPreference } from "./web-autostart.js";
 import { dockerHostInstallPlan, formatDockerSetupText, summarizeDockerSetup } from "./docker-setup.js";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -403,9 +403,9 @@ export function parseArgs(argv) {
       parts.push(...argv.slice(i + 1));
       break;
     }
-    if ((arg === "web" || arg === "--web") && String(argv[i + 1] || "").toLowerCase() === "restart") {
+    if ((arg === "web" || arg === "--web") && ["restart", "stop", "enable", "disable", "status"].includes(String(argv[i + 1] || "").toLowerCase())) {
       result.webapp = true;
-      result.webAction = "restart";
+      result.webAction = String(argv[i + 1] || "").toLowerCase();
       i += 1;
       continue;
     }
@@ -902,7 +902,7 @@ async function restartWebAppAfterUpdate({ commandCwd = process.cwd(), language =
     preferredPort: process.env.AGINTI_WEB_PORT || process.env.PORT || 3210,
     language,
     restart: true,
-    respectAutoStartDisable: false,
+    respectAutoStartDisable: true,
   }).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error), url: "" }));
 }
 
@@ -1949,25 +1949,50 @@ export async function main(argv = process.argv.slice(2)) {
 
   if (args.webapp) {
     const action = String(args.webAction || "start").toLowerCase();
-    if (!["start", "restart", "reuse"].includes(action)) {
-      console.error("Usage: aginti webapp [start|restart] [--port 3210] [--host 127.0.0.1]");
+    if (!["start", "stop", "restart", "reuse", "enable", "disable", "status"].includes(action)) {
+      console.error("Usage: aginti webapp [start|stop|restart|reuse|enable|disable|status] [--port 3210] [--host 127.0.0.1]");
       process.exit(1);
     }
-    const result = await ensureAgintiWebApp({
+    const webOptions = {
       packageDir,
       cwd: args.commandCwd || commandCwd,
       home: args.webHome || "",
       host: args.host || process.env.AGINTI_WEB_HOST || "127.0.0.1",
       preferredPort: args.port || process.env.AGINTI_WEB_PORT || 3210,
-      language: args.language ? resolveLanguage(args.language) : "",
-      restart: action === "restart",
-      respectAutoStartDisable: false,
-    }).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error), url: "" }));
+    };
+    if (action === "enable" || action === "disable" || action === "status") {
+      const preference =
+        action === "status"
+          ? await readWebAppPreference({ home: webOptions.home })
+          : await writeWebAppPreference({ home: webOptions.home, autoStart: action === "enable" });
+      console.log(`webapp auto-start: ${preference.autoStart ? "enabled" : "disabled"}`);
+      console.log(`preference: ${preference.path}`);
+      if (!preference.autoStart) console.log("Use `aginti webapp stop` or `/webapp stop` to stop a currently running webapp.");
+      return;
+    }
+    const result = await (action === "stop"
+      ? stopAgintiWebApp(webOptions)
+      : ensureAgintiWebApp({
+          ...webOptions,
+          language: args.language ? resolveLanguage(args.language) : "",
+          restart: action === "restart",
+          respectAutoStartDisable: false,
+        })
+    ).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error), url: "" }));
     if (!result.ok) {
       console.error(`webapp unavailable: ${result.error || "unknown"}`);
       process.exit(1);
     }
-    const state = result.restarted ? "restarted" : result.reused ? "reused" : "started";
+    const state =
+      action === "stop" && result.stopped
+        ? "stopped"
+        : action === "stop" && result.alreadyStopped
+          ? "already stopped"
+          : result.restarted
+            ? "restarted"
+            : result.reused
+              ? "reused"
+              : "started";
     console.log(`webapp: ${result.url} ${state}`);
     console.log(`project: ${result.runtimeDir || path.resolve(args.commandCwd || commandCwd)}`);
     console.log(`home: ${result.agintiflowHome || ""}`);

package/src/i18n.js

@@ -139,7 +139,7 @@ const TRANSLATIONS = {
     helpSkills: "List Markdown skills selected for a topic.",
     helpSkillMesh: "Manage strict reviewed skill sharing.",
     helpProfile: "Set task profile, e.g. code, website, latex, maintenance.",
-    helpWebapp: "Start, reuse, or restart the local webapp and print its URL.",
+    helpWebapp: "Start, reuse, stop, restart, or configure the local webapp.",
     helpWebSearch: "Enable or disable the web_search tool.",
     helpEnableScs: "Toggle Student-Committee-Supervisor gated execution.",
     helpScouts: "Enable parallel DeepSeek scouts and set scout count.",

package/src/interactive-cli.js

@@ -45,7 +45,7 @@ import {
   permissionModeForApprovalCategory,
   permissionModeLabel,
 } from "./permission-modes.js";
-import { ensureAgintiWebApp } from "./web-autostart.js";
+import { ensureAgintiWebApp, readWebAppPreference, stopAgintiWebApp, writeWebAppPreference } from "./web-autostart.js";
 
 const useColor = Boolean(input.isTTY && output.isTTY && process.env.AGINTIFLOW_NO_COLOR !== "1");
 const ansi = {
@@ -881,7 +881,7 @@ function printHelp() {
       `  ${command("/skills [query]", "List Markdown skills selected for a topic.", "helpSkills")}`,
       `  ${command("/skillmesh [status|off|record|share|sync]", "Manage strict reviewed skill sharing.", "helpSkillMesh")}`,
       `  ${command("/profile <name>", "Set task profile, e.g. code, website, latex, maintenance.", "helpProfile")}`,
-      `  ${command("/webapp [port|restart]", "Start, reuse, or restart the local webapp and print its URL.", "helpWebapp")}`,
+      `  ${command("/webapp [port|start|stop|restart|reuse|enable|disable|status]", "Start, reuse, stop, restart, or configure the local webapp.", "helpWebapp")}`,
       `  ${command("/web-search on|off", "Enable or disable the web_search tool.", "helpWebSearch")}`,
       `  ${command("/web-research <query>", "Run a sourced web_research turn with persisted evidence.", "helpWebSearch")}`,
       `  ${command("/image-read <path> [question]", "Run read_image on a workspace screenshot/image.", "helpWebSearch")}`,
@@ -3011,23 +3011,52 @@ async function handleCommand(line, state, packageDir) {
   }
   if (command === "webapp" || command === "web") {
     const words = value.split(/\s+/).filter(Boolean);
+    const action = words.find((word) => ["start", "stop", "restart", "reuse", "enable", "disable", "status"].includes(word.toLowerCase()))?.toLowerCase() || "start";
     const restart = words.some((word) => word.toLowerCase() === "restart");
     const portValue = words.find((word) => /^\d+$/.test(word));
     const port = Number(portValue) || Number(process.env.AGINTI_WEB_PORT || process.env.PORT || 3210);
-    printSystemLine(restart ? "webapp=restarting" : "webapp=starting");
-    const result = await ensureAgintiWebApp({
+    const webOptions = {
       packageDir,
       cwd: state.commandCwd || process.cwd(),
       host: process.env.AGINTI_WEB_HOST || process.env.HOST || "127.0.0.1",
       preferredPort: port,
-      language: state.language,
-      restart,
-      respectAutoStartDisable: false,
-    }).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error), url: "" }));
+    };
+    if (action === "enable" || action === "disable" || action === "status") {
+      const preference =
+        action === "status"
+          ? await readWebAppPreference()
+          : await writeWebAppPreference({ autoStart: action === "enable" });
+      printSystemLine(`webapp auto-start=${preference.autoStart ? "enabled" : "disabled"}`);
+      if (!preference.autoStart) printSystemLine("webapp disabled for future starts; use /webapp stop to stop a running webapp");
+      return true;
+    }
+    printSystemLine(action === "stop" ? "webapp=stopping" : restart ? "webapp=restarting" : "webapp=starting");
+    const result = await (action === "stop"
+      ? stopAgintiWebApp(webOptions)
+      : ensureAgintiWebApp({
+          ...webOptions,
+          language: state.language,
+          restart,
+          respectAutoStartDisable: false,
+        })
+    ).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error), url: "" }));
     if (result.ok) {
-      state.webAppUrl = result.url;
-      state.webAppNotice = "";
-      printSystemLine(`webapp=${result.url} ${result.restarted ? "restarted" : result.reused ? "reused" : "started"}`);
+      const stateLabel = result.stopped
+        ? action === "stop"
+          ? "stopped"
+          : result.restarted
+            ? "restarted"
+            : "started"
+        : action === "stop" && result.alreadyStopped
+          ? "already stopped"
+          : result.restarted
+            ? "restarted"
+            : result.reused
+              ? "reused"
+              : "started";
+      state.webAppUrl = action === "stop" ? "" : result.url;
+      state.webAppNotice = action === "stop" ? "webapp stopped - use /webapp to start it again" : "";
+      printSystemLine(`webapp=${result.url} ${stateLabel}`);
     } else {
       state.webAppUrl = "";
       state.webAppNotice = `webapp unavailable - use /webapp to retry; error: ${compactLine(result.error || "unknown", 72)}`;

package/src/web-autostart.js

@@ -1,4 +1,5 @@
 import { execFile, spawn } from "node:child_process";
+import fs from "node:fs/promises";
 import http from "node:http";
 import net from "node:net";
 import os from "node:os";
@@ -54,6 +55,32 @@ function resolveRuntimeDir(cwd = "") {
   return path.resolve(process.env.AGINTIFLOW_WEB_RUNTIME_DIR || cwd || process.cwd());
 }
 
+function webPreferencePath(home = "") {
+  return path.join(resolveWebHome(home), "webapp.json");
+}
+
+export async function readWebAppPreference({ home = "" } = {}) {
+  const file = webPreferencePath(home);
+  try {
+    const data = JSON.parse(await fs.readFile(file, "utf8"));
+    return { autoStart: data.autoStart !== false, path: file };
+  } catch {
+    return { autoStart: true, path: file };
+  }
+}
+
+export async function writeWebAppPreference({ home = "", autoStart = true } = {}) {
+  const file = webPreferencePath(home);
+  await fs.mkdir(path.dirname(file), { recursive: true });
+  await fs.writeFile(file, `${JSON.stringify({ autoStart: Boolean(autoStart), updatedAt: new Date().toISOString() }, null, 2)}\n`, "utf8");
+  return await readWebAppPreference({ home });
+}
+
+async function webAutoStartDisabled(home = "") {
+  if (process.env.AGINTI_NO_WEB_AUTO_START === "1" || process.env.AGINTIFLOW_NO_WEB_AUTO_START === "1") return true;
+  return (await readWebAppPreference({ home })).autoStart === false;
+}
+
 function fetchHealthDetails(host, port, timeoutMs = 450) {
   return new Promise((resolve) => {
     const req = http.get(`${webUrl(host, port)}/health`, { timeout: timeoutMs }, (res) => {
@@ -169,6 +196,57 @@ async function stopWebAppOnPort({ host, port, health = {} } = {}) {
     : { ok: false, pids: [...pids], error: `AgInTiFlow webapp on ${host}:${port} did not stop.` };
 }
 
+export async function stopAgintiWebApp({
+  packageDir = process.cwd(),
+  cwd = process.cwd(),
+  home = "",
+  host = DEFAULT_HOST,
+  preferredPort = DEFAULT_PORT,
+  force = false,
+} = {}) {
+  const normalizedHost = normalizeHost(host);
+  const port = normalizePort(preferredPort);
+  const url = webUrl(normalizedHost, port);
+  const runtimeDir = resolveRuntimeDir(cwd);
+  const homeDir = resolveWebHome(home);
+  const health = await fetchHealthDetails(normalizedHost, port);
+
+  if (!health.ok) {
+    if (await canListen(normalizedHost, port)) {
+      return { ok: true, stopped: false, alreadyStopped: true, host: normalizedHost, port, url, runtimeDir, agintiflowHome: homeDir };
+    }
+    return { ok: false, stopped: false, host: normalizedHost, port, url, error: `No AgInTiFlow health endpoint responded on ${url}.` };
+  }
+
+  if (!force && !compatibleHealth(health, { cwd: runtimeDir, home: homeDir, packageDir })) {
+    return {
+      ok: false,
+      stopped: false,
+      host: normalizedHost,
+      port,
+      url,
+      runtimeDir,
+      agintiflowHome: homeDir,
+      health,
+      error: `Refusing to stop AgInTiFlow webapp on ${url} because it belongs to a different project or home.`,
+    };
+  }
+
+  const stopped = await stopWebAppOnPort({ host: normalizedHost, port, health });
+  return {
+    ok: Boolean(stopped.ok),
+    stopped: Boolean(stopped.ok),
+    alreadyStopped: false,
+    host: normalizedHost,
+    port,
+    url,
+    runtimeDir,
+    agintiflowHome: homeDir,
+    health,
+    ...stopped,
+  };
+}
+
 export async function findReusableOrFreeWebPort({
   host = DEFAULT_HOST,
   preferredPort = DEFAULT_PORT,
@@ -223,7 +301,7 @@ export async function ensureAgintiWebApp({
   restart = false,
   respectAutoStartDisable = true,
 } = {}) {
-  if (respectAutoStartDisable && (process.env.AGINTI_NO_WEB_AUTO_START === "1" || process.env.AGINTIFLOW_NO_WEB_AUTO_START === "1")) {
+  if (respectAutoStartDisable && (await webAutoStartDisabled(home))) {
     return { ok: false, disabled: true, url: "" };
   }