@raysonmeng/agentbridge 0.1.13 → 0.1.15

package/dist/cli.js

@@ -176,7 +176,7 @@ function parsePositiveIntEnv(name, fallback, log = () => {}, env = process.env)
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@raysonmeng/agentbridge",
-    version: "0.1.13",
+    version: "0.1.15",
     description: "Bridge between Claude Code and Codex \u2014 bidirectional agent communication via MCP Channel + JSON-RPC",
     type: "module",
     packageManager: "bun@1.3.11",
@@ -255,9 +255,13 @@ __export(exports_update_notifier, {
   isUpdateCheckSuppressed: () => isUpdateCheckSuppressed,
   getCurrentVersion: () => getCurrentVersion,
   buildUpdateNotice: () => buildUpdateNotice,
-  PACKAGE_NAME: () => PACKAGE_NAME
+  buildDismissedUpdateNotice: () => buildDismissedUpdateNotice,
+  PACKAGE_NAME: () => PACKAGE_NAME,
+  DEFAULT_UPDATE_PROMPT_TIMEOUT_MS: () => DEFAULT_UPDATE_PROMPT_TIMEOUT_MS
 });
 import { readFileSync } from "fs";
+import { spawnSync } from "child_process";
+import { createInterface } from "readline";
 function getCurrentVersion() {
   try {
     return require_package().version;
@@ -285,7 +289,8 @@ function readCache(stateDir) {
       return null;
     return {
       lastCheckMs: parsed.lastCheckMs,
-      latest: typeof parsed.latest === "string" ? parsed.latest : null
+      latest: typeof parsed.latest === "string" ? parsed.latest : null,
+      dismissedVersion: typeof parsed.dismissedVersion === "string" ? parsed.dismissedVersion : undefined
     };
   } catch {
     return null;
@@ -327,7 +332,11 @@ async function refreshUpdateCache(deps = {}) {
   try {
     const latest = await fetchLatest(fetchImpl);
     const prev = readCache(stateDir);
-    writeCache(stateDir, { lastCheckMs: now(), latest: latest ?? prev?.latest ?? null });
+    writeCache(stateDir, {
+      lastCheckMs: now(),
+      latest: latest ?? prev?.latest ?? null,
+      dismissedVersion: prev?.dismissedVersion
+    });
   } catch {}
 }
 function buildUpdateNotice(current, latest, isTTY) {
@@ -342,30 +351,109 @@ function buildUpdateNotice(current, latest, isTTY) {
   ].join(`
 `);
 }
+function buildDismissedUpdateNotice(current, latest, isTTY) {
+  const yellow = isTTY ? "\x1B[33m" : "";
+  const bold = isTTY ? "\x1B[1m" : "";
+  const reset = isTTY ? "\x1B[0m" : "";
+  return `${yellow}\u26A0 AgentBridge update available: ${bold}${current}${reset}${yellow} \u2192 ${bold}${latest}${reset} (previously dismissed)`;
+}
 function checkIntervalMs(env) {
   return parsePositiveIntEnv(CHECK_INTERVAL_ENV, DEFAULT_CHECK_INTERVAL_MS, undefined, env);
 }
-function maybeNotifyUpdate(deps = {}) {
+function updatePromptDisabled(env) {
+  return env.AGENTBRIDGE_UPDATE_PROMPT === "0";
+}
+function defaultInstallUpdate(cmd, args) {
+  const res = spawnSync(cmd, args, { stdio: "inherit" });
+  if (res.error)
+    return { ok: false, status: res.status, error: res.error };
+  return { ok: res.status === 0, status: res.status };
+}
+function defaultPromptUpdate(opts) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    let settled = false;
+    let timer;
+    const finish = (answer) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timer);
+      rl.close();
+      resolve(answer);
+    };
+    timer = setTimeout(() => {
+      process.stderr.write(`
+`);
+      finish(false);
+    }, opts.timeoutMs);
+    timer.unref?.();
+    rl.question(`Update AgentBridge now? [y/N] `, (answer) => {
+      finish(/^y(?:es)?$/i.test(answer.trim()));
+    });
+  });
+}
+function recordDismissal(stateDir, cache, latest) {
+  writeCache(stateDir, {
+    ...cache,
+    latest,
+    dismissedVersion: latest
+  });
+}
+async function maybeNotifyUpdate(deps = {}) {
   try {
     const env = deps.env ?? process.env;
     const isTTY = deps.isTTY ?? Boolean(process.stderr.isTTY);
     if (isUpdateCheckSuppressed(env, isTTY))
-      return;
+      return "continue";
     const current = deps.current ?? getCurrentVersion();
     const stateDir = deps.stateDir ?? new StateDirResolver;
     const now = deps.now ?? Date.now;
     const print = deps.print ?? ((m) => process.stderr.write(m + `
 `));
+    const inputIsTTY = deps.inputIsTTY ?? Boolean(process.stdin.isTTY);
+    const promptTimeoutMs = deps.promptTimeoutMs ?? DEFAULT_UPDATE_PROMPT_TIMEOUT_MS;
     const cache = readCache(stateDir);
     if (cache?.latest && isStableUpgrade(current, cache.latest)) {
-      print(buildUpdateNotice(current, cache.latest, isTTY));
+      if (cache.dismissedVersion === cache.latest) {
+        print(buildDismissedUpdateNotice(current, cache.latest, isTTY));
+      } else {
+        print(buildUpdateNotice(current, cache.latest, isTTY));
+        if (!updatePromptDisabled(env) && inputIsTTY) {
+          const promptUpdate = deps.promptUpdate ?? defaultPromptUpdate;
+          let accepted = false;
+          try {
+            accepted = await promptUpdate({ current, latest: cache.latest, timeoutMs: promptTimeoutMs });
+          } catch {
+            accepted = false;
+          }
+          if (accepted) {
+            const installUpdate = deps.installUpdate ?? defaultInstallUpdate;
+            const cmd = "npm";
+            const args = ["install", "-g", `${PACKAGE_NAME}@latest`];
+            const result = installUpdate(cmd, args);
+            if (result.ok) {
+              print("AgentBridge CLI updated. \u8BF7\u91CD\u65B0\u8FD0\u884C\u547D\u4EE4\u3002");
+              print("Plugin: in Claude, run `/plugin marketplace update agentbridge` and then `/reload-plugins`.");
+              return "updated";
+            }
+            const detail = result.error?.message ? ` (${result.error.message})` : typeof result.status === "number" ? ` (exit ${result.status})` : "";
+            print(`\u26A0 AgentBridge update failed${detail}; continuing with the current command.`);
+          } else {
+            recordDismissal(stateDir, cache, cache.latest);
+          }
+        }
+      }
     }
     if (deps.refresh && (!cache || now() - cache.lastCheckMs >= checkIntervalMs(env))) {
       refreshUpdateCache({ stateDir, now, fetchImpl: deps.fetchImpl }).catch(() => {});
     }
-  } catch {}
+    return "continue";
+  } catch {
+    return "continue";
+  }
 }
-var PACKAGE_NAME = "@raysonmeng/agentbridge", REGISTRY_URL, ABBREVIATED_ACCEPT = "application/vnd.npm.install-v1+json", DEFAULT_CHECK_INTERVAL_MS, FETCH_TIMEOUT_MS = 2500, CHECK_INTERVAL_ENV = "AGENTBRIDGE_UPDATE_CHECK_INTERVAL_MS";
+var PACKAGE_NAME = "@raysonmeng/agentbridge", REGISTRY_URL, ABBREVIATED_ACCEPT = "application/vnd.npm.install-v1+json", DEFAULT_CHECK_INTERVAL_MS, FETCH_TIMEOUT_MS = 2500, DEFAULT_UPDATE_PROMPT_TIMEOUT_MS = 15000, CHECK_INTERVAL_ENV = "AGENTBRIDGE_UPDATE_CHECK_INTERVAL_MS";
 var init_update_notifier = __esm(() => {
   init_atomic_json();
   init_state_dir();
@@ -438,6 +526,9 @@ function normalizeBoundedInteger(value, fallback, min, max) {
     return fallback;
   return parsed;
 }
+function normalizeStrategy(value, fallback) {
+  return value === "conserve" || value === "maximize" ? value : fallback;
+}
 function normalizeBoolean(value, fallback) {
   if (typeof value === "boolean")
     return value;
@@ -486,9 +577,27 @@ function normalizeBudgetConfig(raw, fallback = DEFAULT_BUDGET_CONFIG) {
       timeWindowSec: normalizeBoundedInteger(parallel.timeWindowSec, fallback.parallel.timeWindowSec, 60, 604800)
     },
     codexTierControl: normalizeBoolean(budget.codexTierControl, fallback.codexTierControl) && codexTiers.full !== null,
-    codexTiers
+    codexTiers,
+    strategy: normalizeStrategy(budget.strategy, fallback.strategy)
   };
 }
+function applyBudgetEnvOverrides(budget, env = process.env) {
+  const overlay = {
+    enabled: env.AGENTBRIDGE_BUDGET_ENABLED ?? budget.enabled,
+    pollSeconds: env.AGENTBRIDGE_BUDGET_POLL_SECONDS ?? budget.pollSeconds,
+    pauseAt: env.AGENTBRIDGE_BUDGET_PAUSE_AT ?? budget.pauseAt,
+    resumeBelow: env.AGENTBRIDGE_BUDGET_RESUME_BELOW ?? budget.resumeBelow,
+    syncDriftPct: env.AGENTBRIDGE_BUDGET_SYNC_DRIFT_PCT ?? budget.syncDriftPct,
+    parallel: {
+      minRemainingPct: env.AGENTBRIDGE_BUDGET_PARALLEL_MIN_REMAINING_PCT ?? budget.parallel.minRemainingPct,
+      timeWindowSec: env.AGENTBRIDGE_BUDGET_PARALLEL_TIME_WINDOW_SEC ?? budget.parallel.timeWindowSec
+    },
+    codexTierControl: env.AGENTBRIDGE_BUDGET_CODEX_TIER_CONTROL ?? budget.codexTierControl,
+    codexTiers: budget.codexTiers,
+    strategy: env.AGENTBRIDGE_BUDGET_STRATEGY ?? budget.strategy
+  };
+  return normalizeBudgetConfig(overlay, budget);
+}
 function normalizeConfig(raw) {
   if (!isRecord(raw))
     return null;
@@ -615,7 +724,8 @@ var init_config_service = __esm(() => {
       full: null,
       balanced: { effort: "medium" },
       eco: { effort: "low" }
-    }
+    },
+    strategy: "conserve"
   };
   DEFAULT_CONFIG = {
     version: "1.0",
@@ -1015,7 +1125,7 @@ var exports_dev = {};
 __export(exports_dev, {
   runDev: () => runDev
 });
-import { execFileSync as execFileSync3, spawnSync } from "child_process";
+import { execFileSync as execFileSync3, spawnSync as spawnSync2 } from "child_process";
 import { resolve as resolve2 } from "path";
 import { existsSync as existsSync5, cpSync, rmSync } from "fs";
 async function runDev(args = []) {
@@ -1041,7 +1151,7 @@ async function runDev(args = []) {
 `);
   } else {
     console.log("Building CLI from source...");
-    const cliBuild = spawnSync("bun", ["run", "build:cli"], {
+    const cliBuild = spawnSync2("bun", ["run", "build:cli"], {
       cwd: projectRoot,
       stdio: "inherit"
     });
@@ -1052,7 +1162,7 @@ async function runDev(args = []) {
     console.log(`  \u2713 CLI built successfully
 `);
     console.log("Building plugin from source...");
-    const buildResult = spawnSync("bun", ["run", "build:plugin"], {
+    const buildResult = spawnSync2("bun", ["run", "build:plugin"], {
       cwd: projectRoot,
       stdio: "inherit"
     });
@@ -1475,11 +1585,11 @@ function formatBuildInfo(build) {
 var CODE_HASH_SENTINEL = "source", BUILD_INFO;
 var init_build_info = __esm(() => {
   BUILD_INFO = Object.freeze({
-    version: defineString("0.1.13", "0.0.0-source"),
-    commit: defineString("7a71869", "source"),
+    version: defineString("0.1.15", "0.0.0-source"),
+    commit: defineString("89d4c9a", "source"),
     bundle: defineBundle("dist"),
     contractVersion: defineNumber(1, CONTRACT_VERSION),
-    codeHash: defineString("e1fd67d07c62", "source")
+    codeHash: defineString("71ce81854ec9", "source")
   });
 });
 
@@ -3660,12 +3770,26 @@ function readUsableCurrentThread(identity, env = process.env) {
   const state = readRawCurrentThread(identity.stateDir);
   if (!state)
     return null;
-  if (state.status !== "current")
-    return null;
   if (state.pairId !== identity.pairId)
     return null;
   if (state.cwd !== identity.cwd)
     return null;
+  if (state.status === "pending") {
+    const rolloutPath2 = findCodexRolloutFile(state.threadId, env);
+    if (!rolloutPath2)
+      return null;
+    const promoted = {
+      ...state,
+      status: "current",
+      rolloutPath: rolloutPath2,
+      rolloutVerifiedAt: nowIso(),
+      updatedAt: nowIso()
+    };
+    try {
+      atomicWriteJson(identity.stateDir.currentThreadFile, promoted);
+    } catch {}
+    return promoted;
+  }
   if (state.rolloutPath && existsSync12(state.rolloutPath))
     return state;
   const rolloutPath = findCodexRolloutFile(state.threadId, env);
@@ -3759,10 +3883,12 @@ function resolveCodexResumeArgs(parsed, pair, env = process.env) {
   const current = readUsableCurrentThread(identity, env);
   if (parsed.resumeCurrent) {
     if (!current) {
+      const raw = readRawCurrentThread(identity.stateDir);
+      const pending = raw && raw.status === "pending" && raw.pairId === identity.pairId && raw.cwd === identity.cwd ? raw : null;
       return {
         rest: parsed.rest,
         mode: "resume-current",
-        error: "No verified current Codex thread for this pair. Start a new one with `abg codex --new`, or resume a specific thread with `abg codex resume <threadId>`."
+        error: pending ? `No verified current Codex thread for this pair. Found a pending (unverified) thread ${pending.threadId} \u2014 its Codex rollout file was not found. Try \`abg codex resume ${pending.threadId}\`, or start fresh with \`abg codex --new\`.` : "No verified current Codex thread for this pair. Start a new one with `abg codex --new`, or resume a specific thread with `abg codex resume <threadId>`."
       };
     }
     return {
@@ -5069,6 +5195,215 @@ var init_pairs = __esm(() => {
   init_thread_state();
   init_kill();
 });
+// src/budget/types.ts
+var STALE_MAX_AGE_SEC = 600;
+
+// src/budget/budget-state.ts
+function isDecisionGrade(usage, now) {
+  if (!usage)
+    return false;
+  const freshWindow = usage.fiveHour !== null && usage.fiveHour.resetEpoch > now || usage.weekly !== null && usage.weekly.resetEpoch > now;
+  if (!freshWindow)
+    return false;
+  if (usage.fetchedAt > 0 && now - usage.fetchedAt > STALE_MAX_AGE_SEC)
+    return false;
+  return true;
+}
+var init_budget_state = () => {};
+
+// src/budget/burn-view.ts
+function agentWeeklyFiveHourWindowsLeft(usage, now) {
+  if (!usage || usage.stale || !usage.ok)
+    return null;
+  if (!isDecisionGrade(usage, now))
+    return null;
+  const weekly = usage.weekly;
+  if (!weekly || weekly.resetEpoch <= now)
+    return null;
+  if (weekly.burnConfident !== true)
+    return null;
+  if (weekly.runwaySeconds === undefined)
+    return null;
+  return weekly.fiveHourWindowsLeft ?? null;
+}
+var init_burn_view = __esm(() => {
+  init_budget_state();
+});
+
+// src/budget/render.ts
+function resolveGuardHardHint(env = process.env) {
+  const raw = env.AGENTBRIDGE_GUARD_HARD_HINT;
+  if (raw === undefined || raw.trim() === "")
+    return DEFAULT_GUARD_HARD_PCT;
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || parsed < 1 || parsed > 100)
+    return DEFAULT_GUARD_HARD_PCT;
+  return parsed;
+}
+function formatEpoch(epochSeconds) {
+  if (!epochSeconds || epochSeconds <= 0)
+    return "\u672A\u77E5";
+  return new Date(epochSeconds * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
+}
+function formatWindow(window, label) {
+  if (!window)
+    return `${label} \u672A\u77E5`;
+  return `${label} ${window.util}%\uFF08\u91CD\u7F6E ${formatEpoch(window.resetEpoch)}\uFF09`;
+}
+function formatAgent(name, usage, snapshotAt) {
+  if (!usage)
+    return `${name}\uFF1A\u672A\u77E5\uFF08\u63A2\u6D4B\u4E0D\u53EF\u7528\uFF09`;
+  const parts = [
+    formatWindow(usage.fiveHour, "5h"),
+    formatWindow(usage.weekly, "\u5468"),
+    `\u95E8\u63A7 ${usage.gateUtil}%`,
+    `\u9884\u8B66 ${usage.warnUtil}%`
+  ];
+  if (usage.rateLimitedUntil > 0) {
+    parts.push(`\u9650\u6D41\u81F3 ${formatEpoch(usage.rateLimitedUntil)}`);
+  }
+  if (usage.parsedVia === "positional") {
+    parts.push("\u26A0\uFE0F \u7A97\u53E3\u8BC6\u522B\u4F7F\u7528\u4F4D\u7F6E\u515C\u5E95");
+  }
+  const ageSec = usage.fetchedAt > 0 ? snapshotAt - usage.fetchedAt : 0;
+  if (ageSec > 300) {
+    parts.push(`\u26A0\uFE0F \u6570\u636E\u91C7\u96C6\u4E8E ${Math.round(ageSec / 60)} \u5206\u949F\u524D`);
+  } else if (usage.stale) {
+    parts.push("\uFF08\u7F13\u5B58\u6570\u636E\uFF09");
+  }
+  return `${name}\uFF1A${parts.join(" \xB7 ")}`;
+}
+function formatDuration(seconds) {
+  const totalMinutes = Math.max(0, Math.round(seconds / 60));
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  if (hours === 0)
+    return `${minutes}\u5206\u949F`;
+  return `${hours}\u5C0F\u65F6${minutes}\u5206\u949F`;
+}
+function formatClockTime(epochSeconds) {
+  const date = new Date(epochSeconds * 1000);
+  const hh = String(date.getHours()).padStart(2, "0");
+  const mm = String(date.getMinutes()).padStart(2, "0");
+  return `${hh}:${mm}`;
+}
+function formatWindowRate(label, rate) {
+  if (!rate)
+    return null;
+  if (!rate.confident)
+    return `${label} \u91C7\u6837\u4E2D`;
+  return `${label} \u2248${rate.pctPerHour.toFixed(2)}%/h`;
+}
+function formatRunwaySegment(runway, basisWindow, snapshotAt) {
+  const truncatedByReset = basisWindow !== null && basisWindow.resetEpoch > 0 && snapshotAt + runway.seconds >= basisWindow.resetEpoch - RESET_TRUNCATION_EPSILON_SEC;
+  const clock = runway.depletedAtEpoch ? formatClockTime(runway.depletedAtEpoch) : null;
+  let clockNote;
+  if (clock) {
+    clockNote = truncatedByReset ? `\u81F3 ${clock} \u7A97\u53E3\u5237\u65B0\u5373\u622A\u65AD\uFF0C` : `\u81F3 ${clock}\uFF0C`;
+  } else {
+    clockNote = truncatedByReset ? "\u7A97\u53E3\u5237\u65B0\u5373\u622A\u65AD\uFF0C" : "";
+  }
+  return `\u7EA6\u53EF\u518D\u5DE5\u4F5C ${formatDuration(runway.seconds)}\uFF08${clockNote}${WINDOW_LABELS[runway.basis]}\u4E3A\u7EA6\u675F\uFF09`;
+}
+function formatBurnRateLine(name, usage, rates, runway, snapshotAt, guardHardPct) {
+  const parts = [
+    formatWindowRate("5h", rates.fiveHour),
+    formatWindowRate("\u5468", rates.weekly)
+  ].filter((part) => part !== null);
+  if (parts.length === 0 && !runway)
+    return null;
+  if (runway) {
+    const basisWindow = usage ? usage[runway.basis] : null;
+    parts.push(formatRunwaySegment(runway, basisWindow, snapshotAt));
+  }
+  if (guardHardPct !== null) {
+    parts.push(`\u5916\u5C42 guard \u786C\u7EBF ${guardHardPct}%\uFF08v3 \u4E0D\u53EF\u8D8A\u8FC7\uFF1Brunway \u4E3A\u4E2D\u6027\u53E3\u5F84\uFF0CClaude \u4F1A\u5148\u5728\u786C\u7EBF\u88AB\u5916\u5C42\u505C\u4F4F\uFF09`);
+  }
+  return `${name} \u71C3\u5C3D\u7387\uFF1A${parts.join(" \xB7 ")}`;
+}
+function formatFiveHourWindowsLeftLine(snapshot) {
+  const values = [];
+  const claude = agentWeeklyFiveHourWindowsLeft(snapshot.claude, snapshot.updatedAt);
+  const codex = agentWeeklyFiveHourWindowsLeft(snapshot.codex, snapshot.updatedAt);
+  if (claude !== null)
+    values.push(["Claude", claude]);
+  if (codex !== null)
+    values.push(["Codex", codex]);
+  if (values.length === 0)
+    return null;
+  const unique = [...new Set(values.map(([, value]) => value.toFixed(1)))];
+  if (unique.length === 1)
+    return `\u6309\u5F53\u524D\u8282\u594F\uFF0C\u5468\u989D\u5EA6\u8FD8\u591F ~${unique[0]} \u4E2A 5h \u7A97\u53E3`;
+  const byAgent = values.map(([name, value]) => `${name} ~${value.toFixed(1)}`).join(" / ");
+  return `\u6309\u5F53\u524D\u8282\u594F\uFF0C\u5468\u989D\u5EA6\u8FD8\u591F ${byAgent} \u4E2A 5h \u7A97\u53E3`;
+}
+function renderBudgetSnapshot(snapshot, options = {}) {
+  const guardHardPct = options.guardHardPct ?? resolveGuardHardHint();
+  const lines = [];
+  lines.push(`\u3010\u9884\u7B97\u5FEB\u7167 \xB7 \u8D26\u53F7\u7EA7\u3011\u9636\u6BB5\uFF1A${PHASE_LABELS[snapshot.phase]} \xB7 \u66F4\u65B0\u4E8E ${formatEpoch(snapshot.updatedAt)}`);
+  lines.push(formatAgent("Claude", snapshot.claude, snapshot.updatedAt));
+  lines.push(formatAgent("Codex", snapshot.codex, snapshot.updatedAt));
+  if (snapshot.burnRate) {
+    const claudeLine = formatBurnRateLine("Claude", snapshot.claude, snapshot.burnRate.claude, snapshot.runway?.claude ?? null, snapshot.updatedAt, guardHardPct);
+    if (claudeLine)
+      lines.push(claudeLine);
+    const codexLine = formatBurnRateLine("Codex", snapshot.codex, snapshot.burnRate.codex, snapshot.runway?.codex ?? null, snapshot.updatedAt, null);
+    if (codexLine)
+      lines.push(codexLine);
+  }
+  const fiveHourWindowsLeftLine = formatFiveHourWindowsLeftLine(snapshot);
+  if (fiveHourWindowsLeftLine)
+    lines.push(fiveHourWindowsLeftLine);
+  if (snapshot.claude && snapshot.codex) {
+    const abs = Math.abs(snapshot.driftPct);
+    if (abs > 0) {
+      const heavier = snapshot.driftPct > 0 ? "Claude" : "Codex";
+      const lighter = snapshot.driftPct > 0 ? "Codex" : "Claude";
+      lines.push(`\u6F02\u79FB\uFF1A${heavier} \u6BD4 ${lighter} \u9AD8 ${abs} \u4E2A\u767E\u5206\u70B9`);
+    } else {
+      lines.push("\u6F02\u79FB\uFF1A\u53CC\u65B9\u6301\u5E73");
+    }
+  }
+  if (snapshot.paused) {
+    const resume = snapshot.resumeAfterEpoch ? `\uFF1B\u9884\u8BA1\u6062\u590D ${formatEpoch(snapshot.resumeAfterEpoch)}\uFF08\u4EE5\u5B9E\u6D4B\u4E3A\u51C6\uFF1B\u63D0\u524D\u5237\u65B0\u4F1A\u66F4\u65E9\u89E3\u9664\uFF09` : "";
+    const reason = snapshot.pauseReason ?? "\u989D\u5EA6\u63A5\u8FD1\u8017\u5C3D";
+    if (snapshot.pauseSide === "claude" && !snapshot.gateClosed) {
+      lines.push(`\u63A5\u529B\u4E2D\uFF1AClaude \u4FA7\u989D\u5EA6\u8017\u5C3D\uFF0C\u5DF2\u4EA4\u63A5 Codex \u7EE7\u7EED\u63A8\u8FDB\uFF08\u95F8\u95E8\u5F00\u653E\uFF09 \u2014 ${reason}${resume}`);
+    } else if (snapshot.pauseSide === "codex") {
+      lines.push(`\u6682\u505C\uFF1ACodex \u4FA7\u989D\u5EA6\u8017\u5C3D\uFF08\u95F8\u95E8\u5173\u95ED\uFF0CClaude \u53EF solo \u63A8\u8FDB\u72EC\u7ACB\u90E8\u5206\uFF09 \u2014 ${reason}${resume}`);
+    } else {
+      lines.push(`\u6682\u505C\uFF1A\u53CC\u4FA7\u8054\u5408\u6682\u505C\uFF08\u95F8\u95E8\u5173\u95ED\uFF09 \u2014 ${reason}${resume}`);
+    }
+  } else {
+    lines.push("\u6682\u505C\uFF1A\u5426");
+  }
+  if (snapshot.parallelRecommended) {
+    lines.push("\u5E76\u884C\u5EFA\u8BAE\uFF1A\u989D\u5EA6\u5BCC\u4F59\u4E14\u4E34\u8FD1\u7ED3\u7B97\uFF0C\u5EFA\u8BAE\u62C6\u5206\u66F4\u591A\u5E76\u884C\u5B50\u4EFB\u52A1");
+  }
+  if (snapshot.codexTier !== "full") {
+    lines.push(`Codex \u6863\u4F4D\uFF1A${snapshot.codexTier}`);
+  }
+  if (snapshot.claudeAdvice) {
+    lines.push(`Claude \u5EFA\u8BAE\uFF1A${snapshot.claudeAdvice}`);
+  }
+  lines.push("\u6CE8\uFF1A\u767E\u5206\u6BD4\u4E3A\u8BA2\u9605\u8D26\u53F7\u7EA7\u7528\u91CF\uFF08\u540C\u673A\u5176\u4ED6\u4F1A\u8BDD\u5171\u4EAB\u540C\u4E00\u989D\u5EA6\u6C60\uFF09\u3002");
+  return lines.join(`
+`);
+}
+var DEFAULT_GUARD_HARD_PCT = 92, WINDOW_LABELS, RESET_TRUNCATION_EPSILON_SEC = 60, PHASE_LABELS, BUDGET_UNAVAILABLE_TEXT = "\u9884\u7B97\u611F\u77E5\u4E0D\u53EF\u7528\uFF1A\u672A\u68C0\u6D4B\u5230 agent-quota-guard \u63A2\u9488\uFF08~/.budget-guard/bin/budget-probe\uFF09\u6216 budget \u529F\u80FD\u5DF2\u7981\u7528\u3002\u534F\u4F5C\u4E0D\u53D7\u5F71\u54CD\u3002";
+var init_render = __esm(() => {
+  init_burn_view();
+  WINDOW_LABELS = {
+    fiveHour: "5h \u7A97\u53E3",
+    weekly: "\u5468\u7A97\u53E3"
+  };
+  PHASE_LABELS = {
+    normal: "normal\uFF08\u6B63\u5E38\uFF09",
+    balance: "balance\uFF08\u9700\u5747\u8861\uFF09",
+    parallel: "parallel\uFF08\u5EFA\u8BAE\u5E76\u884C\u63D0\u901F\uFF09",
+    paused: "paused\uFF08\u9884\u7B97\u5E72\u9884\u4E2D\uFF09"
+  };
+});
 
 // src/daemon-status.ts
 async function fetchDaemonStatus(port, path = "/healthz", timeoutMs = DAEMON_STATUS_FETCH_TIMEOUT_MS) {
@@ -5272,8 +5607,10 @@ var exports_doctor = {};
 __export(exports_doctor, {
   runDoctor: () => runDoctor,
   formatDoctorReport: () => formatDoctorReport,
+  evaluateBudgetStrategyGuard: () => evaluateBudgetStrategyGuard,
   evaluateArtifactAlignment: () => evaluateArtifactAlignment,
-  describeBuildDrift: () => describeBuildDrift
+  describeBuildDrift: () => describeBuildDrift,
+  V3_DEFAULT_TARGET_UTIL: () => V3_DEFAULT_TARGET_UTIL
 });
 import { existsSync as existsSync15, readFileSync as readFileSync13, readdirSync as readdirSync6, realpathSync as realpathSync3, statSync as statSync7 } from "fs";
 import { join as join17 } from "path";
@@ -5381,6 +5718,7 @@ async function buildDoctorReport(pair, registered) {
     hint: env.ok ? undefined : `\u73AF\u5883\u53D8\u91CF\u4E0E\u5F53\u524D\u76EE\u5F55\u4E0D\u5339\u914D\uFF1A\u8BF7\u5728\u6B63\u786E\u7684\u9879\u76EE\u76EE\u5F55\u91CC\u91CD\u65B0\u8FD0\u884C \`${cli} claude\`\uFF0C\u4E0D\u8981\u590D\u7528\u5176\u4ED6\u76EE\u5F55\u7684\u4F1A\u8BDD\u73AF\u5883\u3002`
   });
   checks.push(configParseabilityCheck(cwd, cli));
+  checks.push(budgetStrategyGuardCheck(cwd));
   checks.push({
     name: "daemon health",
     status: health ? "ok" : "warn",
@@ -5580,6 +5918,33 @@ function configParseabilityCheck(cwd, cli) {
     detail: desc.customValues ? `parsed at ${desc.path} \u2014 custom values in effect` : `parsed at ${desc.path} \u2014 all values match defaults`
   };
 }
+function evaluateBudgetStrategyGuard(strategy, guardHardPct, targetUtilPct = V3_DEFAULT_TARGET_UTIL) {
+  if (strategy !== "maximize") {
+    return {
+      name: "budget strategy",
+      status: "ok",
+      detail: "strategy=conserve \u2014 v2-equivalent budget behavior (v3 maximize is opt-in)"
+    };
+  }
+  if (guardHardPct >= targetUtilPct) {
+    return {
+      name: "budget strategy",
+      status: "ok",
+      detail: `strategy=maximize \u2014 outer guard hard line ${guardHardPct}% covers targetUtil ${targetUtilPct}%`
+    };
+  }
+  return {
+    name: "budget strategy",
+    status: "warn",
+    detail: `strategy=maximize but the outer quota-guard hard line (${guardHardPct}%) is below ` + `targetUtil (${targetUtilPct}%) \u2014 the ${guardHardPct}\u2192${targetUtilPct} band is unreachable for Claude`,
+    hint: "v3 \u4E0D\u53EF\u8D8A\u8FC7\u5916\u5C42 quota-guard \u786C\u7EBF\uFF1AClaude \u4FA7\u8FBE\u5230 guard \u786C\u7EBF\u65F6\u8FDB\u7A0B\u4F1A\u88AB\u5916\u5C42\u5F3A\u505C\uFF0C" + `maximize \u7684 ${guardHardPct}%\u2192${targetUtilPct}% \u533A\u95F4\u5B9E\u9645\u70E7\u4E0D\u5230\u3002\u60F3\u771F\u6B63\u7528\u5230 targetUtil\uFF0C` + "\u9700\u81EA\u884C\u8C03\u9AD8 quota-guard \u7684 BUDGET_HARD\uFF08\u672C\u4ED3\u5E93\u4E0D\u4EE3\u6539\u5916\u5C42\u914D\u7F6E\uFF09\uFF1B\u5C55\u793A\u4FA7\u5DF2\u6309 guard \u7EBF\u6536\u53E3\u3002"
+  };
+}
+function budgetStrategyGuardCheck(cwd) {
+  const config = new ConfigService(cwd).loadOrDefault();
+  const budget = applyBudgetEnvOverrides(config.budget);
+  return evaluateBudgetStrategyGuard(budget.strategy, resolveGuardHardHint());
+}
 function logCheck(name, path, cli) {
   if (!existsSync15(path)) {
     return {
@@ -5629,12 +5994,13 @@ function printDoctorReport(report) {
     console.log(line);
   }
 }
-var LARGE_LOG_WARN_BYTES;
+var LARGE_LOG_WARN_BYTES, V3_DEFAULT_TARGET_UTIL = 97;
 var init_doctor = __esm(() => {
   init_plugin_cache();
   init_build_info();
   init_cli_invocation();
   init_config_service();
+  init_render();
   init_env_guard();
   init_pair_resolver();
   init_thread_state();
@@ -5643,91 +6009,6 @@ var init_doctor = __esm(() => {
   LARGE_LOG_WARN_BYTES = 100 * 1024 * 1024;
 });
 
-// src/budget/render.ts
-function formatEpoch(epochSeconds) {
-  if (!epochSeconds || epochSeconds <= 0)
-    return "\u672A\u77E5";
-  return new Date(epochSeconds * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
-}
-function formatWindow(window, label) {
-  if (!window)
-    return `${label} \u672A\u77E5`;
-  return `${label} ${window.util}%\uFF08\u91CD\u7F6E ${formatEpoch(window.resetEpoch)}\uFF09`;
-}
-function formatAgent(name, usage, snapshotAt) {
-  if (!usage)
-    return `${name}\uFF1A\u672A\u77E5\uFF08\u63A2\u6D4B\u4E0D\u53EF\u7528\uFF09`;
-  const parts = [
-    formatWindow(usage.fiveHour, "5h"),
-    formatWindow(usage.weekly, "\u5468"),
-    `\u95E8\u63A7 ${usage.gateUtil}%`,
-    `\u9884\u8B66 ${usage.warnUtil}%`
-  ];
-  if (usage.rateLimitedUntil > 0) {
-    parts.push(`\u9650\u6D41\u81F3 ${formatEpoch(usage.rateLimitedUntil)}`);
-  }
-  if (usage.parsedVia === "positional") {
-    parts.push("\u26A0\uFE0F \u7A97\u53E3\u8BC6\u522B\u4F7F\u7528\u4F4D\u7F6E\u515C\u5E95");
-  }
-  const ageSec = usage.fetchedAt > 0 ? snapshotAt - usage.fetchedAt : 0;
-  if (ageSec > 300) {
-    parts.push(`\u26A0\uFE0F \u6570\u636E\u91C7\u96C6\u4E8E ${Math.round(ageSec / 60)} \u5206\u949F\u524D`);
-  } else if (usage.stale) {
-    parts.push("\uFF08\u7F13\u5B58\u6570\u636E\uFF09");
-  }
-  return `${name}\uFF1A${parts.join(" \xB7 ")}`;
-}
-function renderBudgetSnapshot(snapshot) {
-  const lines = [];
-  lines.push(`\u3010\u9884\u7B97\u5FEB\u7167 \xB7 \u8D26\u53F7\u7EA7\u3011\u9636\u6BB5\uFF1A${PHASE_LABELS[snapshot.phase]} \xB7 \u66F4\u65B0\u4E8E ${formatEpoch(snapshot.updatedAt)}`);
-  lines.push(formatAgent("Claude", snapshot.claude, snapshot.updatedAt));
-  lines.push(formatAgent("Codex", snapshot.codex, snapshot.updatedAt));
-  if (snapshot.claude && snapshot.codex) {
-    const abs = Math.abs(snapshot.driftPct);
-    if (abs > 0) {
-      const heavier = snapshot.driftPct > 0 ? "Claude" : "Codex";
-      const lighter = snapshot.driftPct > 0 ? "Codex" : "Claude";
-      lines.push(`\u6F02\u79FB\uFF1A${heavier} \u6BD4 ${lighter} \u9AD8 ${abs} \u4E2A\u767E\u5206\u70B9`);
-    } else {
-      lines.push("\u6F02\u79FB\uFF1A\u53CC\u65B9\u6301\u5E73");
-    }
-  }
-  if (snapshot.paused) {
-    const resume = snapshot.resumeAfterEpoch ? `\uFF1B\u9884\u8BA1\u6062\u590D ${formatEpoch(snapshot.resumeAfterEpoch)}\uFF08\u4EE5\u5B9E\u6D4B\u4E3A\u51C6\uFF1B\u63D0\u524D\u5237\u65B0\u4F1A\u66F4\u65E9\u89E3\u9664\uFF09` : "";
-    const reason = snapshot.pauseReason ?? "\u989D\u5EA6\u63A5\u8FD1\u8017\u5C3D";
-    if (snapshot.pauseSide === "claude" && !snapshot.gateClosed) {
-      lines.push(`\u63A5\u529B\u4E2D\uFF1AClaude \u4FA7\u989D\u5EA6\u8017\u5C3D\uFF0C\u5DF2\u4EA4\u63A5 Codex \u7EE7\u7EED\u63A8\u8FDB\uFF08\u95F8\u95E8\u5F00\u653E\uFF09 \u2014 ${reason}${resume}`);
-    } else if (snapshot.pauseSide === "codex") {
-      lines.push(`\u6682\u505C\uFF1ACodex \u4FA7\u989D\u5EA6\u8017\u5C3D\uFF08\u95F8\u95E8\u5173\u95ED\uFF0CClaude \u53EF solo \u63A8\u8FDB\u72EC\u7ACB\u90E8\u5206\uFF09 \u2014 ${reason}${resume}`);
-    } else {
-      lines.push(`\u6682\u505C\uFF1A\u53CC\u4FA7\u8054\u5408\u6682\u505C\uFF08\u95F8\u95E8\u5173\u95ED\uFF09 \u2014 ${reason}${resume}`);
-    }
-  } else {
-    lines.push("\u6682\u505C\uFF1A\u5426");
-  }
-  if (snapshot.parallelRecommended) {
-    lines.push("\u5E76\u884C\u5EFA\u8BAE\uFF1A\u989D\u5EA6\u5BCC\u4F59\u4E14\u4E34\u8FD1\u7ED3\u7B97\uFF0C\u5EFA\u8BAE\u62C6\u5206\u66F4\u591A\u5E76\u884C\u5B50\u4EFB\u52A1");
-  }
-  if (snapshot.codexTier !== "full") {
-    lines.push(`Codex \u6863\u4F4D\uFF1A${snapshot.codexTier}`);
-  }
-  if (snapshot.claudeAdvice) {
-    lines.push(`Claude \u5EFA\u8BAE\uFF1A${snapshot.claudeAdvice}`);
-  }
-  lines.push("\u6CE8\uFF1A\u767E\u5206\u6BD4\u4E3A\u8BA2\u9605\u8D26\u53F7\u7EA7\u7528\u91CF\uFF08\u540C\u673A\u5176\u4ED6\u4F1A\u8BDD\u5171\u4EAB\u540C\u4E00\u989D\u5EA6\u6C60\uFF09\u3002");
-  return lines.join(`
-`);
-}
-var PHASE_LABELS, BUDGET_UNAVAILABLE_TEXT = "\u9884\u7B97\u611F\u77E5\u4E0D\u53EF\u7528\uFF1A\u672A\u68C0\u6D4B\u5230 agent-quota-guard \u63A2\u9488\uFF08~/.budget-guard/bin/budget-probe\uFF09\u6216 budget \u529F\u80FD\u5DF2\u7981\u7528\u3002\u534F\u4F5C\u4E0D\u53D7\u5F71\u54CD\u3002";
-var init_render = __esm(() => {
-  PHASE_LABELS = {
-    normal: "normal\uFF08\u6B63\u5E38\uFF09",
-    balance: "balance\uFF08\u9700\u5747\u8861\uFF09",
-    parallel: "parallel\uFF08\u5EFA\u8BAE\u5E76\u884C\u63D0\u901F\uFF09",
-    paused: "paused\uFF08\u9884\u7B97\u5E72\u9884\u4E2D\uFF09"
-  };
-});
-
 // src/cli/budget.ts
 var exports_budget = {};
 __export(exports_budget, {
@@ -5968,7 +6249,9 @@ async function main(command, restArgs) {
   if (command && NOTIFY_COMMANDS.has(command)) {
     try {
       const { maybeNotifyUpdate: maybeNotifyUpdate2 } = await Promise.resolve().then(() => (init_update_notifier(), exports_update_notifier));
-      maybeNotifyUpdate2({ refresh: REFRESH_COMMANDS.has(command) });
+      const decision = await maybeNotifyUpdate2({ refresh: REFRESH_COMMANDS.has(command) });
+      if (decision === "updated")
+        process.exit(0);
     } catch {}
   }
   switch (command) {