opencode-supertask 0.1.38 → 0.1.39

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable user-facing changes are recorded here. This project follows semantic versioning while it is in the `0.x` development series.
 
+## [0.1.39] - 2026-07-18
+
+### Fixed
+
+- `supertask upgrade` now exits without reinstalling or restarting when the CLI, effective plugin configuration, plugin cache, and ready PM2 Gateway already match npm `latest`.
+- Added `supertask upgrade --force` for intentionally reinstalling the current version, refreshing the Gateway environment, and restarting PM2.
+- The OpenCode `supertask_upgrade` tool now reports an up-to-date no-op instead of restarting an already converged Gateway.
+
+[0.1.39]: https://github.com/vbgate/opencode-supertask/compare/v0.1.38...v0.1.39
+
 ## [0.1.38] - 2026-07-18
 
 ### Fixed

package/README.md

@@ -32,11 +32,11 @@ supertask gateway   # foreground mode: no pm2 required
 
 The plugin never installs global dependencies by itself. Without a running Gateway, queue-management tools still work, but scheduled and queued tasks are not executed and the Dashboard is unavailable.
 
-Upgrades do not require uninstalling. Run `supertask upgrade`: it pins the exact latest plugin, replaces the Gateway, detects whether the global `supertask` came from npm or Bun, and synchronizes the CLI to that same version. `supertask doctor` fails if the CLI, plugin, Gateway package, or ready lock disagree. Versions through 0.1.33 cannot retroactively update their own old CLI, so upgrade from those releases by installing the new global CLI once with the original package manager, then run the new `supertask upgrade`.
+Upgrades do not require uninstalling. Run `supertask upgrade`: it pins the exact latest plugin, replaces the Gateway, detects whether the global `supertask` came from npm or Bun, and synchronizes the CLI to that same version. When the CLI, effective plugin, cache, and ready Gateway already match npm `latest`, the command exits without reinstalling or restarting; use `supertask upgrade --force` to intentionally refresh the environment and restart the current version. `supertask doctor` fails if the CLI, plugin, Gateway package, or ready lock disagree. Versions through 0.1.33 cannot retroactively update their own old CLI, so upgrade from those releases by installing the new global CLI once with the original package manager, then run the new `supertask upgrade`.
 
 Gateway task execution currently requires macOS or Linux. Windows is rejected at startup until the Worker can use an OS Job Object to guarantee that detached OpenCode descendants cannot survive cancellation or recovery.
 
-Run `supertask install` and `supertask upgrade` from the same terminal environment in which `opencode run --agent <name>` works. An explicit install or upgrade refreshes the Gateway's OpenCode/XDG/provider execution environment while keeping the proven Bun path, PM2 identity, database/config scope, and rollback runtime pinned. This matters when a custom primary agent selects a provider through environment variables or a non-default OpenCode config directory.
+Run `supertask install` and `supertask upgrade` from the same terminal environment in which `opencode run --agent <name>` works. An install or version-changing upgrade refreshes the Gateway's OpenCode/XDG/provider execution environment while keeping the proven Bun path, PM2 identity, database/config scope, and rollback runtime pinned. Use `supertask upgrade --force` when the version is already current but the saved environment needs refreshing.
 
 ### Uninstall
 
@@ -131,7 +131,7 @@ supertask config                       # show current config
 supertask doctor [--json]              # static end-to-end runtime diagnostics
 supertask doctor --smoke [--smoke-agent build] [--smoke-model provider/model]
                                         # queue one real Gateway/OpenCode verification task
-supertask upgrade                      # pin latest plugin version and replace Gateway
+supertask upgrade [--force]            # update if needed; force refreshes and restarts
 
 # Task management
 supertask add -n "Task" -a "agent" -p "prompt" --importance 5 \
@@ -295,9 +295,9 @@ supertask gateway   # 前台运行：不需要 pm2
 
 插件不会自行安装全局依赖。Gateway 未运行时仍可管理队列，但不会执行排队/定时任务，也不会启动 Web 控制台。
 
-升级无需卸载，执行 `supertask upgrade`。它会精确安装最新插件、替换 Gateway，并根据全局 `supertask` 的真实路径识别 npm 或 Bun 后同步 CLI；无法安全确认包管理器时会明确失败并给出精确命令。`doctor` 把 CLI、插件、Gateway 任一版本不一致视为异常。由于 0.1.33 及更早版本还不具备 CLI 自动同步能力，从这些版本升级时先用原包管理器安装一次新 CLI，再运行新版 `supertask upgrade`。
+升级无需卸载，执行 `supertask upgrade`。它会精确安装最新插件、替换 Gateway，并根据全局 `supertask` 的真实路径识别 npm 或 Bun 后同步 CLI；当 CLI、有效插件配置、缓存和就绪 Gateway 已全部匹配 npm `latest` 时直接返回，不重新安装或重启。需要在同版本下强制刷新环境时执行 `supertask upgrade --force`。无法安全确认包管理器时会明确失败并给出精确命令。`doctor` 把 CLI、插件、Gateway 任一版本不一致视为异常。由于 0.1.33 及更早版本还不具备 CLI 自动同步能力，从这些版本升级时先用原包管理器安装一次新 CLI，再运行新版 `supertask upgrade`。
 
-请在手动执行 `opencode run --agent <名称>` 能工作的同一个终端环境中运行 `supertask install` 或 `supertask upgrade`。显式安装/升级会刷新 Gateway 使用的 OpenCode、XDG 与模型 Provider 执行环境，同时固定已经验证的 Bun、PM2、数据库/配置作用域，并保留完整旧环境用于失败回滚。这能避免自定义主 Agent 在终端正常、但 Gateway 仍沿用旧 Provider 凭据或旧 OpenCode 配置目录。
+请在手动执行 `opencode run --agent <名称>` 能工作的同一个终端环境中运行 `supertask install` 或 `supertask upgrade`。安装或发生版本变化的升级会刷新 Gateway 使用的 OpenCode、XDG 与模型 Provider 执行环境，同时固定已经验证的 Bun、PM2、数据库/配置作用域，并保留完整旧环境用于失败回滚。同版本下需要刷新旧 Provider 凭据或 OpenCode 配置目录时使用 `supertask upgrade --force`。
 
 ### 快速开始
 

package/dist/cli/index.js

@@ -22220,9 +22220,11 @@ var init_semver = __esm({
 var update_exports = {};
 __export(update_exports, {
   getGlobalCliDiagnostic: () => getGlobalCliDiagnostic,
+  getLatestVersion: () => getLatestVersion,
   getOpenCodePluginDiagnostic: () => getOpenCodePluginDiagnostic,
   installLatestPlugin: () => installLatestPlugin,
   installPluginVersion: () => installPluginVersion,
+  isVersionConverged: () => isVersionConverged,
   resolveConfiguredPluginSpec: () => resolveConfiguredPluginSpec,
   resolveInstalledPlugin: () => resolveInstalledPlugin,
   resolveInstalledPluginVersion: () => resolveInstalledPluginVersion,
@@ -22242,6 +22244,9 @@ import {
 } from "fs";
 import { homedir as homedir4, tmpdir as tmpdir2 } from "os";
 import { dirname as dirname7, join as join5, resolve as resolve4 } from "path";
+function isVersionConverged(version2, state2) {
+  return state2.packageVersion === version2 && state2.plugin.ok && state2.plugin.version === version2 && state2.plugin.cachedVersion === version2 && (!state2.cli.installed || state2.cli.version === version2) && state2.gateway.pm2Installed && state2.gateway.processFound && state2.gateway.status === "online" && state2.gateway.ready && state2.gateway.runningVersion === version2 && state2.gateway.gatewayPackageVersion === version2 && state2.gateway.scopeMatches;
+}
 function pluginAt(packageDir) {
   const packageJson = join5(packageDir, "package.json");
   const gatewayEntry = join5(packageDir, "dist/gateway/index.js");
@@ -22409,7 +22414,7 @@ function updateGlobalCli(version2) {
   }
   return { ...after, action: "updated" };
 }
-function latestVersion() {
+function getLatestVersion() {
   const result = spawnSync3(npmBin(), [
     "view",
     PACKAGE_NAME,
@@ -22583,7 +22588,7 @@ function installPluginVersion(version2) {
   return resolveInstalledPluginVersion(version2);
 }
 function installLatestPlugin() {
-  return installPluginVersion(latestVersion());
+  return installPluginVersion(getLatestVersion());
 }
 var PACKAGE_NAME;
 var init_update2 = __esm({
@@ -29732,25 +29737,43 @@ program2.command("uninstall").description(t2("\u505C\u6B62\u5E76\u79FB\u9664 PM2
     process.exit(1);
   }
 });
-program2.command("upgrade").description(t2("\u66F4\u65B0 OpenCode \u63D2\u4EF6\u7F13\u5B58\u5E76\u91CD\u542F Gateway", "update the OpenCode plugin cache and restart the Gateway")).action(async () => {
-  console.log(t2("\u6B63\u5728\u66F4\u65B0 opencode-supertask...", "Updating opencode-supertask..."));
+program2.command("upgrade").description(t2("\u66F4\u65B0 OpenCode \u63D2\u4EF6\u3001CLI \u548C Gateway\uFF1B\u5DF2\u662F\u6700\u65B0\u7248\u672C\u65F6\u4E0D\u91CD\u542F", "update the OpenCode plugin, CLI, and Gateway without restarting when already current")).option("--force", t2("\u5373\u4F7F\u5DF2\u662F\u6700\u65B0\u7248\u672C\u4E5F\u91CD\u65B0\u5B89\u88C5\u5E76\u91CD\u542F Gateway", "reinstall and restart the Gateway even when already current")).action(async (options) => {
+  console.log(t2("\u6B63\u5728\u68C0\u67E5 opencode-supertask \u66F4\u65B0...", "Checking for opencode-supertask updates..."));
   let installed;
   let previousVersion;
+  let targetVersion;
+  let updater;
   try {
-    const { resolveInstalledPlugin: resolveInstalledPlugin2 } = await Promise.resolve().then(() => (init_update2(), update_exports));
-    previousVersion = resolveInstalledPlugin2().version;
+    updater = await Promise.resolve().then(() => (init_update2(), update_exports));
+    const { getGatewayDiagnostic: getGatewayDiagnostic2 } = await Promise.resolve().then(() => (init_pm2(), pm2_exports));
+    targetVersion = updater.getLatestVersion();
+    const plugin = updater.getOpenCodePluginDiagnostic();
+    const cli = updater.getGlobalCliDiagnostic();
+    const gateway = getGatewayDiagnostic2();
+    if (!options.force && updater.isVersionConverged(targetVersion, {
+      packageVersion: getPackageVersion(),
+      plugin,
+      cli,
+      gateway
+    })) {
+      console.log(t2(
+        `SuperTask \u5DF2\u662F\u6700\u65B0\u7248\u672C v${targetVersion}\uFF0C\u65E0\u9700\u5347\u7EA7\uFF1BGateway \u672A\u91CD\u542F\u3002`,
+        `SuperTask is already up to date at v${targetVersion}; the Gateway was not restarted.`
+      ));
+      return;
+    }
+    previousVersion = plugin.version ?? updater.resolveInstalledPlugin().version;
   } catch (error) {
-    console.error(t2("\u65E0\u6CD5\u786E\u8BA4\u5F53\u524D OpenCode \u63D2\u4EF6\u7248\u672C\uFF0C\u5DF2\u53D6\u6D88\u5347\u7EA7\uFF1A", "Could not determine the current OpenCode plugin version; upgrade cancelled: ") + (error instanceof Error ? error.message : String(error)));
+    console.error(t2("\u65E0\u6CD5\u68C0\u67E5\u5F53\u524D\u7248\u672C\uFF0C\u5DF2\u53D6\u6D88\u5347\u7EA7\uFF1A", "Could not check the current version; upgrade cancelled: ") + (error instanceof Error ? error.message : String(error)));
     process.exit(1);
   }
+  console.log(t2("\u6B63\u5728\u66F4\u65B0 opencode-supertask...", "Updating opencode-supertask..."));
   try {
-    const { installLatestPlugin: installLatestPlugin2 } = await Promise.resolve().then(() => (init_update2(), update_exports));
-    installed = installLatestPlugin2();
+    installed = updater.installPluginVersion(targetVersion);
   } catch (err) {
     let detail = err instanceof Error ? err.message : String(err);
     try {
-      const { installPluginVersion: installPluginVersion2 } = await Promise.resolve().then(() => (init_update2(), update_exports));
-      installPluginVersion2(previousVersion);
+      updater.installPluginVersion(previousVersion);
     } catch (rollbackError) {
       detail += `; OpenCode \u63D2\u4EF6\u56DE\u6EDA\u5931\u8D25: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`;
     }
@@ -29794,8 +29817,7 @@ SuperTask upgraded: ${result.before ?? "unknown"} \u2192 ${result.after}`
     let detail = err instanceof Error ? err.message : String(err);
     try {
       if (previousVersion !== installed.version) {
-        const { installPluginVersion: installPluginVersion2 } = await Promise.resolve().then(() => (init_update2(), update_exports));
-        installPluginVersion2(previousVersion);
+        updater.installPluginVersion(previousVersion);
       }
     } catch (rollbackError) {
       detail += `; Gateway \u5DF2\u56DE\u6EDA\uFF0C\u4F46 OpenCode \u63D2\u4EF6\u56DE\u6EDA\u5931\u8D25: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`;