@co0ontty/wand 2.13.0 → 3.0.0

package/dist/server-session-routes.js

@@ -1,4 +1,3 @@
-import express from "express";
 import { SessionInputError } from "./process-manager.js";
 import { getDefaultModelForProvider, normalizeMode } from "./config.js";
 import { blockWindowMessagesForTransport, sliceTurnBlocksForTransport, truncateMessagesForTransport, windowMessagesForTransport } from "./message-truncator.js";
@@ -7,7 +6,6 @@ import { resolveSessionCwd } from "./session-cwd.js";
 import { resolveCommitAiContext } from "./session-ai-context.js";
 import { getGitStatus, QuickCommitError, runQuickCommitWithFallback, runTagHead, runPush, generateCommitMessageOnly, } from "./git-quick-commit.js";
 import { getErrorMessage } from "./error-utils.js";
-export { getErrorMessage };
 export function parseSessionCreationOrigin(body) {
     const rawSource = body?.sessionSource;
     if (rawSource !== undefined && rawSource !== "interactive" && rawSource !== "automation" && rawSource !== "startup") {
@@ -97,10 +95,6 @@ function removeFromHiddenClaudeSessionIds(storage, ids) {
 function getSessionById(processes, structured, id) {
     return structured.get(id) ?? processes.get(id);
 }
-function listAllSessions(processes, structured) {
-    return [...structured.list(), ...processes.list()]
-        .sort((a, b) => b.startedAt.localeCompare(a.startedAt));
-}
 /** Lightweight session list — omits output and messages to reduce payload. */
 function listAllSessionsSlim(processes, structured) {
     return [...structured.listSlim(), ...processes.listSlim()]
@@ -115,7 +109,7 @@ function requireWorktreeSession(snapshot) {
     }
     return snapshot;
 }
-function buildWorktreeMergeInfo(current, status, info) {
+function buildWorktreeMergeInfo(current, info) {
     return {
         ...(current.worktreeMergeInfo ?? null),
         ...(info ?? null),
@@ -124,7 +118,7 @@ function buildWorktreeMergeInfo(current, status, info) {
     };
 }
 function saveWorktreeMergeState(storage, current, status, info) {
-    const mergedInfo = buildWorktreeMergeInfo(current, status, info);
+    const mergedInfo = buildWorktreeMergeInfo(current, info);
     const updated = {
         ...current,
         worktreeMergeStatus: status,
@@ -134,14 +128,7 @@ function saveWorktreeMergeState(storage, current, status, info) {
     return updated;
 }
 function getWorktreeMergeResponseStatus(error) {
-    const code = getWorktreeMergeErrorCode(error);
-    if (!code) {
-        return 400;
-    }
-    if (code === "WORKTREE_MERGE_CONFLICT") {
-        return 409;
-    }
-    return 400;
+    return getWorktreeMergeErrorCode(error) === "WORKTREE_MERGE_CONFLICT" ? 409 : 400;
 }
 function getWorktreeMergePayload(error, fallback) {
     if (error instanceof WorktreeMergeError) {
@@ -244,7 +231,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
         const all = listAllSessionsSlim(processes, structured);
         res.json(all);
     });
-    app.post("/api/structured-sessions", express.json(), async (req, res) => {
+    app.post("/api/structured-sessions", async (req, res) => {
         const body = req.body;
         try {
             if (body.provider && body.provider !== "claude" && body.provider !== "codex" && body.provider !== "opencode") {
@@ -279,7 +266,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: getErrorMessage(error, "无法启动结构化会话。") });
         }
     });
-    app.post("/api/sessions/:id/model", express.json(), (req, res) => {
+    app.post("/api/sessions/:id/model", (req, res) => {
         const body = req.body;
         const rawModel = typeof body?.model === "string" ? body.model.trim() : null;
         const id = req.params.id;
@@ -304,7 +291,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
     });
     // 思考深度切换：与 /model 路由对称。结构化会话立即影响下一条 prompt（CLI/SDK 各自接入
     // --effort / thinking budget），PTY 会话通过 /effort 更新当前 Claude 进程。
-    app.post("/api/sessions/:id/thinking-effort", express.json(), (req, res) => {
+    app.post("/api/sessions/:id/thinking-effort", (req, res) => {
         const body = req.body;
         const raw = typeof body?.thinkingEffort === "string" ? body.thinkingEffort : null;
         const id = req.params.id;
@@ -328,7 +315,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
     // 执行模式切换：与 /model、/thinking-effort 路由对称。结构化会话立即影响下一条
     // prompt（权限策略 / 系统提示 / CLI flag 都按 session.mode 逐轮重新派生）；PTY 会话
     // 仅更新 wand 自身的权限自动放行判定，已启动的 claude 进程命令行 flag 不变。codex 锁 full-access。
-    app.post("/api/sessions/:id/mode", express.json(), (req, res) => {
+    app.post("/api/sessions/:id/mode", (req, res) => {
         const body = req.body;
         const raw = typeof body?.mode === "string" ? body.mode.trim() : "";
         if (!raw) {
@@ -365,7 +352,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
         }
         res.json({ id: snapshot.id, messages: snapshot.messages ?? [] });
     });
-    app.post("/api/structured-sessions/:id/messages", express.json(), async (req, res) => {
+    app.post("/api/structured-sessions/:id/messages", async (req, res) => {
         const input = String(req.body?.input ?? "");
         const interrupt = !!req.body?.interrupt;
         // preserveQueue: 仅在 interrupt 路径有意义。排队条「立即」会带这个 flag，
@@ -388,7 +375,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
     // ── Structured queued-messages management ──
     // 这些端点构成"排队消息条"的后端操作面：reorder、立即发送、单条删除、全部清空。
     // 全部走乐观更新模型，失败时前端会回滚到上一次 WS 推送的 queuedMessages。
-    app.patch("/api/structured-sessions/:id/queued", express.json(), (req, res) => {
+    app.patch("/api/structured-sessions/:id/queued", (req, res) => {
         const rawOrder = req.body?.order;
         if (!Array.isArray(rawOrder)) {
             res.status(400).json({ error: "缺少 order 数组。" });
@@ -416,7 +403,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: getErrorMessage(error, "无法删除排队消息。") });
         }
     });
-    app.post("/api/structured-sessions/:id/queued/:index/promote", express.json(), async (req, res) => {
+    app.post("/api/structured-sessions/:id/queued/:index/promote", async (req, res) => {
         const index = Number(req.params.index);
         if (!Number.isInteger(index)) {
             res.status(400).json({ error: "下标无效。" });
@@ -498,7 +485,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(getWorktreeMergeResponseStatus(error)).json(getWorktreeMergePayload(error, "无法检查 worktree 合并状态。"));
         }
     });
-    app.post("/api/sessions/:id/worktree/merge", express.json(), (req, res) => {
+    app.post("/api/sessions/:id/worktree/merge", (req, res) => {
         try {
             const current = requireWorktreeSession(getLatestSessionSnapshot(processes, structured, storage, req.params.id));
             if (!isMergeActionAllowed(current)) {
@@ -558,7 +545,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.json({ isGit: false, error: getErrorMessage(error, "无法读取 git 状态。") });
         }
     });
-    app.post("/api/sessions/:id/quick-commit", express.json(), async (req, res) => {
+    app.post("/api/sessions/:id/quick-commit", async (req, res) => {
         const snapshot = getLatestSessionSnapshot(processes, structured, storage, req.params.id);
         if (!snapshot) {
             res.status(404).json({ error: "未找到该会话。" });
@@ -593,7 +580,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: getErrorMessage(error, "快捷提交失败。") });
         }
     });
-    app.post("/api/sessions/:id/generate-commit-message", express.json(), async (req, res) => {
+    app.post("/api/sessions/:id/generate-commit-message", async (req, res) => {
         const snapshot = getLatestSessionSnapshot(processes, structured, storage, req.params.id);
         if (!snapshot) {
             res.status(404).json({ error: "未找到该会话。" });
@@ -618,7 +605,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: getErrorMessage(error, "生成 commit message 失败。") });
         }
     });
-    app.post("/api/sessions/:id/git/tag-head", express.json(), async (req, res) => {
+    app.post("/api/sessions/:id/git/tag-head", async (req, res) => {
         const snapshot = getLatestSessionSnapshot(processes, structured, storage, req.params.id);
         if (!snapshot) {
             res.status(404).json({ error: "未找到该会话。" });
@@ -650,7 +637,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(400).json({ error: getErrorMessage(error, "打 tag 失败。") });
         }
     });
-    app.post("/api/sessions/:id/git/push", express.json(), async (req, res) => {
+    app.post("/api/sessions/:id/git/push", async (req, res) => {
         const snapshot = getLatestSessionSnapshot(processes, structured, storage, req.params.id);
         if (!snapshot) {
             res.status(404).json({ error: "未找到该会话。" });
@@ -699,7 +686,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(getWorktreeMergeResponseStatus(error)).json(getWorktreeMergePayload(error, "无法清理 worktree。"));
         }
     });
-    app.post("/api/sessions/batch-delete", express.json(), (req, res) => {
+    app.post("/api/sessions/batch-delete", (req, res) => {
         const sessionIds = Array.isArray(req.body?.sessionIds)
             ? req.body.sessionIds.filter((value) => typeof value === "string" && value.trim().length > 0)
             : [];
@@ -923,7 +910,7 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             res.status(response.statusCode).json(response.payload);
         }
     });
-    app.post("/api/codex-sessions/:threadId/resume", express.json(), async (req, res) => {
+    app.post("/api/codex-sessions/:threadId/resume", async (req, res) => {
         const threadId = String(req.params.threadId || "").trim();
         const body = req.body;
         try {
@@ -1121,7 +1108,7 @@ export function registerClaudeHistoryRoutes(app, processes, storage) {
             res.status(500).json({ error: getErrorMessage(error, "无法删除该目录下的历史会话。") });
         }
     });
-    app.post("/api/claude-history/batch-delete", express.json(), (req, res) => {
+    app.post("/api/claude-history/batch-delete", (req, res) => {
         const claudeSessionIds = Array.isArray(req.body?.claudeSessionIds)
             ? req.body.claudeSessionIds.filter((value) => typeof value === "string" && value.trim().length > 0)
             : [];
@@ -1204,7 +1191,7 @@ export function registerClaudeHistoryRoutes(app, processes, storage) {
         }
         res.json({ ok: true });
     });
-    app.post("/api/codex-history/batch-delete", express.json(), (req, res) => {
+    app.post("/api/codex-history/batch-delete", (req, res) => {
         const threadIds = Array.isArray(req.body?.claudeSessionIds)
             ? req.body.claudeSessionIds.filter((value) => typeof value === "string" && value.trim().length > 0)
             : [];

package/dist/server.js

@@ -20,7 +20,8 @@ import { getCachedModels, refreshModels } from "./models.js";
 import { ProcessManager } from "./process-manager.js";
 import { SessionLogger } from "./session-logger.js";
 import { StructuredSessionManager } from "./structured-session-manager.js";
-import { getErrorMessage, parseSessionCreationOrigin, registerClaudeHistoryRoutes, registerSessionRoutes } from "./server-session-routes.js";
+import { parseSessionCreationOrigin, registerClaudeHistoryRoutes, registerSessionRoutes } from "./server-session-routes.js";
+import { getErrorMessage } from "./error-utils.js";
 import { checkPackageUpdateAsync, installPackageGloballyAsync, normalizeUpdateChannel, resolveGlobalWandCli, } from "./npm-update-utils.js";
 import { repairServiceUnitAfterUpdate } from "./service-self-repair.js";
 import { computeRelaunch } from "./relaunch.js";
@@ -604,22 +605,6 @@ function resolveAppConnectOrigin(origin, config) {
         return origin;
     }
 }
-function decodeConnectCode(code) {
-    try {
-        const decoded = Buffer.from(code, "base64").toString("utf8");
-        const hashIdx = decoded.lastIndexOf("#");
-        if (hashIdx < 1)
-            return null;
-        const url = decoded.substring(0, hashIdx);
-        const token = decoded.substring(hashIdx + 1);
-        if (!url.startsWith("http") || token.length < 16)
-            return null;
-        return { url, token };
-    }
-    catch {
-        return null;
-    }
-}
 /** Match a semver-looking token in a file name (with optional pre-release / build metadata). */
 function resolveAndroidApkDir(configDir, config) {
     const configuredDir = config.android?.apkDir?.trim();
@@ -1121,7 +1106,6 @@ export async function startServer(config, configPath) {
     const useHttps = config.https === true;
     const protocol = useHttps ? "https" : "http";
     const requireAuth = buildRequireAuth(useHttps, storage, config);
-    const nodeModulesDir = path.join(RUNTIME_ROOT_DIR, "node_modules");
     app.use(express.json({ limit: "1mb" }));
     app.use(compression({ threshold: 1024 }));
     app.use((req, res, next) => {
@@ -1827,7 +1811,7 @@ export async function startServer(config, configPath) {
             res.status(500).json({ error: getErrorMessage(error, "检查 CLI 更新失败。") });
         }
     });
-    app.post("/api/provider-cli-updates", express.json(), async (req, res) => {
+    app.post("/api/provider-cli-updates", async (req, res) => {
         if (providerCliUpdateInFlight || updateInFlight) {
             res.status(409).json({ error: "CLI 更新正在进行中，请稍候。" });
             return;
@@ -2616,7 +2600,7 @@ export async function startServer(config, configPath) {
         const cli = storage.getConfigValue("autoUpdateProviderClis") === "true";
         res.json({ web, apk, dmg, cli });
     });
-    app.post("/api/auto-update", express.json(), (req, res) => {
+    app.post("/api/auto-update", (req, res) => {
         const { web, apk, dmg, cli } = req.body;
         if (typeof web === "boolean") {
             storage.setConfigValue("autoUpdateWeb", String(web));
@@ -2649,7 +2633,7 @@ export async function startServer(config, configPath) {
             },
         });
     });
-    app.post("/api/update-channel", express.json(), (req, res) => {
+    app.post("/api/update-channel", (req, res) => {
         const body = (req.body ?? {});
         const channel = body.channel === "beta" ? "beta" : "stable";
         storage.setConfigValue("updateChannel", channel);

package/dist/storage.d.ts

@@ -58,6 +58,5 @@ export declare class WandStorage {
     getLatestSessionByClaudeSessionId(claudeSessionId: string): SessionSnapshot | null;
     loadSessions(): SessionSnapshot[];
     private mapSessionRow;
-    updateSessionWorktreeMergeState(id: string, status: SessionSnapshot["worktreeMergeStatus"], info: SessionSnapshot["worktreeMergeInfo"]): SessionSnapshot | null;
     deleteSession(id: string): void;
 }

package/dist/storage.js

@@ -577,19 +577,6 @@ export class WandStorage {
     mapSessionRow(row) {
         return mapSessionCore(row);
     }
-    updateSessionWorktreeMergeState(id, status, info) {
-        const current = this.getSession(id);
-        if (!current) {
-            return null;
-        }
-        const updated = {
-            ...current,
-            worktreeMergeStatus: status,
-            worktreeMergeInfo: info,
-        };
-        this.saveSessionMetadata(updated);
-        return updated;
-    }
     deleteSession(id) {
         this.db.prepare("DELETE FROM command_sessions WHERE id = ?").run(id);
     }

package/dist/structured-session-manager.d.ts

@@ -4,7 +4,6 @@ import { ContentBlock, ExecutionMode, ProcessEvent, SessionProvider, SessionRunn
 interface CreateStructuredSessionOptions {
     cwd: string;
     mode: ExecutionMode;
-    prompt?: string;
     provider?: SessionProvider;
     runner?: SessionRunner;
     worktreeEnabled?: boolean;

package/dist/structured-session-manager.js

@@ -925,7 +925,6 @@ export class StructuredSessionManager {
     createSession(options) {
         const id = randomUUID();
         const startedAt = new Date().toISOString();
-        const prompt = options.prompt?.trim();
         const provider = options.provider === "codex" || options.provider === "opencode" ? options.provider : "claude";
         const runner = options.runner ?? defaultStructuredRunner(provider);
         const baseCwd = resolveSessionCwd(options.cwd, this.config.defaultCwd);
@@ -3179,7 +3178,6 @@ export class StructuredSessionManager {
             killedForAskUserQuestion,
             sessionId: turnState.sessionId,
         });
-        const interruptedByUser = this.interruptedWith.has(sessionId);
         const msgs = this.buildCompletedAssistantMessages(current, turnState);
         const interruptPrompt = this.interruptedWith.get(sessionId);
         const keepRunning = killedForAskUserQuestion || !!interruptPrompt;

package/dist/update-helper.js

@@ -195,6 +195,7 @@ SERVICE_SCOPE=${shellQuote(serviceScope ?? "")}
 TIMEOUT_MS=${timeoutMs}
 NODE_BIN=${shellQuote(process.execPath)}
 UPDATE_UTILS=${shellQuote(updateUtilsPath)}
+GLOBAL_CLI_PATH_FILE=${shellQuote(`${logPath}.cli-path`)}
 WORKING_DIRECTORY=${shellQuote(opts.cwd)}
 CLI_ARGS=(${shellArray(opts.cliArgs)})
 GLOBAL_CLI=""
@@ -207,6 +208,7 @@ run() {
 
 on_exit() {
   local status="$?"
+  rm -f "$GLOBAL_CLI_PATH_FILE" 2>/dev/null || true
   if [ "$status" -ne 0 ]; then
     if [ "$PARENT_EXITED" = "0" ]; then
       echo "[wand-update] failed with exit code $status; parent service was left running"
@@ -230,22 +232,13 @@ wait_for_parent_exit() {
   done
 }
 
-resolve_global_cli() {
-  local npm_root
-  npm_root="$(npm root -g)"
-  GLOBAL_CLI="$npm_root/@co0ontty/wand/dist/cli.js"
-  if [ ! -f "$GLOBAL_CLI" ]; then
-    echo "[wand-update] global CLI not found after install: $GLOBAL_CLI"
-    return 1
-  fi
-}
-
 main() {
   echo "[wand-update] installing while parent service stays online"
-  if run "$NODE_BIN" ${nodeLoaderCommand}--input-type=module - "$UPDATE_UTILS" "$INSTALL_SPEC" "$TIMEOUT_MS" <<'WAND_INSTALL_NODE'
+  if run "$NODE_BIN" ${nodeLoaderCommand}--input-type=module - "$UPDATE_UTILS" "$INSTALL_SPEC" "$TIMEOUT_MS" "$GLOBAL_CLI_PATH_FILE" <<'WAND_INSTALL_NODE'
+import { realpathSync, statSync, writeFileSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 
-const [modulePath, installSpec, timeoutValue] = process.argv.slice(2);
+const [modulePath, installSpec, timeoutValue, cliPathFile] = process.argv.slice(2);
 const timeoutMs = Number(timeoutValue);
 const updateUtils = await import(pathToFileURL(modulePath).href);
 const installPackageGloballyAsync = updateUtils.installPackageGloballyAsync
@@ -253,19 +246,37 @@ const installPackageGloballyAsync = updateUtils.installPackageGloballyAsync
 if (typeof installPackageGloballyAsync !== "function") {
   throw new Error("installPackageGloballyAsync is unavailable in " + modulePath);
 }
-await installPackageGloballyAsync(installSpec, timeoutMs, (line) => {
+const installedCli = await installPackageGloballyAsync(installSpec, timeoutMs, (line) => {
   process.stdout.write(String(line) + "\\n");
 });
+if (typeof installedCli !== "string" || installedCli.trim().length === 0) {
+  throw new Error("installer did not return the installed Wand CLI path");
+}
+const resolvedCli = realpathSync(installedCli.trim());
+if (!statSync(resolvedCli).isFile()) {
+  throw new Error("installed Wand CLI is not a file: " + resolvedCli);
+}
+writeFileSync(cliPathFile, resolvedCli, { encoding: "utf8", mode: 0o600 });
 WAND_INSTALL_NODE
   then
     echo "[wand-update] install completed"
   else
     local install_status="$?"
-    echo "[wand-update] install failed; keeping parent service online"
+    echo "[wand-update] install or CLI resolution failed; keeping parent service online"
     return "$install_status"
   fi
 
-  resolve_global_cli
+  if [ ! -f "$GLOBAL_CLI_PATH_FILE" ]; then
+    echo "[wand-update] installer did not persist the global CLI path"
+    return 1
+  fi
+  GLOBAL_CLI="$(<"$GLOBAL_CLI_PATH_FILE")"
+  rm -f "$GLOBAL_CLI_PATH_FILE"
+  if [ ! -f "$GLOBAL_CLI" ]; then
+    echo "[wand-update] global CLI not found after install: $GLOBAL_CLI"
+    return 1
+  fi
+  echo "[wand-update] resolved global CLI: $GLOBAL_CLI"
   echo "[wand-update] initializing updated installation"
   run "$NODE_BIN" "$GLOBAL_CLI" init -c "$CONFIG_PATH"
 
@@ -349,8 +360,11 @@ function spawnDetached(scriptPath, _logPath, env, serviceScope) {
         }
     }
     if (process.platform === "darwin") {
-        const nohupPath = existsSync("/usr/bin/nohup") ? "/usr/bin/nohup" : "nohup";
-        const result = trySpawn(nohupPath, [resolveBashPath(), scriptPath], "nohup");
+        // `detached: true` already creates an independent process group. Wrapping the
+        // helper in /usr/bin/nohup breaks when Wand itself is a launchd daemon:
+        // nohup exits immediately because it cannot adopt a Background session, while
+        // spawn() has already returned a PID and the API falsely reports success.
+        const result = trySpawn(resolveBashPath(), [scriptPath], "bash detached");
         if (result)
             return result;
     }

package/dist/upload-routes.js

@@ -1,4 +1,4 @@
-import { mkdirSync, existsSync } from "node:fs";
+import { mkdirSync } from "node:fs";
 import path from "node:path";
 import { randomBytes } from "node:crypto";
 import multer from "multer";
@@ -16,9 +16,7 @@ export function registerUploadRoutes(app, processes) {
                 return;
             }
             const uploadDir = path.join(cwd, ".wand-uploads");
-            if (!existsSync(uploadDir)) {
-                mkdirSync(uploadDir, { recursive: true });
-            }
+            mkdirSync(uploadDir, { recursive: true });
             cb(null, uploadDir);
         },
         filename(_req, file, cb) {

package/dist/version-utils.js

@@ -19,11 +19,9 @@ export function extractSemver(text) {
 export function compareSemver(a, b) {
     const pa = parseSemverLike(a);
     const pb = parseSemverLike(b);
-    for (let i = 0; i < 3; i++) {
-        const diff = (pa.mainParts[i] || 0) - (pb.mainParts[i] || 0);
-        if (diff !== 0)
-            return diff;
-    }
+    const mainOrder = compareMainParts(pa.mainParts, pb.mainParts);
+    if (mainOrder !== 0)
+        return mainOrder;
     // Main version equal — apply semver prerelease rule: no prerelease > with prerelease.
     if (!pa.pre && pb.pre)
         return 1;
@@ -80,17 +78,23 @@ function comparePrereleaseSegments(preA, preB) {
 export function compareApkInstallOrder(a, b) {
     const pa = parseSemverLike(a);
     const pb = parseSemverLike(b);
-    for (let i = 0; i < 3; i++) {
-        const diff = (pa.mainParts[i] || 0) - (pb.mainParts[i] || 0);
-        if (diff !== 0)
-            return diff;
-    }
+    const mainOrder = compareMainParts(pa.mainParts, pb.mainParts);
+    if (mainOrder !== 0)
+        return mainOrder;
     if (pa.isDebug !== pb.isDebug)
         return pa.isDebug ? 1 : -1;
     if (pa.isDebug && pb.isDebug)
         return comparePrereleaseSegments(pa.pre, pb.pre);
     return 0;
 }
+function compareMainParts(a, b) {
+    for (let i = 0; i < 3; i++) {
+        const diff = (a[i] || 0) - (b[i] || 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
 function parseSemverLike(v) {
     const withoutBuild = v.trim().replace(/^v/, "").split("+")[0] ?? "";
     const [main, ...rest] = withoutBuild.split("-");