opencode-acp 1.14.22 → 1.14.23-pr.332.52

package/README.md

@@ -123,8 +123,8 @@ stateDiagram-v2
 - **T1** fires when raw context exceeds the configured limit. The model sees
   compressible ranges and writes a detailed summary preserving file paths,
   signatures, decisions, and rationale.
-- **T2** fires when T1 summary tokens reach `nudgeGrowthTokens` (default 5% of
-  context window). The model distills old T1 blocks — keeping decisions and
+- **T2** fires when T1 summary tokens reach `nudgeGrowthTokens` (fixed default
+  50000). The model distills old T1 blocks — keeping decisions and
   outcomes, dropping verbose process details.
 - **T3** fires when T2 summary tokens reach the same threshold. The model
   condenses to bare facts (shipped releases, key bugs, architecture decisions).
@@ -278,11 +278,15 @@ Each level overrides the previous, so project settings take priority over global
     "$schema": "https://raw.githubusercontent.com/ranxianglei/opencode-acp/master/dcp.schema.json",
     // Enable or disable the plugin
     "enabled": true,
-    // Automatically update npm-installed ACP when a newer npm latest is available.
+    // Automatically update npm-installed ACP when a newer version is available
+    // on the installed dist-tag/spec (@stable follows stable, @latest follows latest).
     // Version-locked plugin specs are not updated.
     "autoUpdate": true,
-    // Enable INFO/DEBUG logging + per-request snapshots to ~/.config/opencode/logs/acp/
-    // (WARN/ERROR are always logged to daily/<date>.log)
+    // File log verbosity: "debug" | "info" | "warn" | "error" | "silent".
+    // Default "info" writes decision-level events (nudges, transforms, updates)
+    // to ~/.config/opencode/logs/acp/daily/<date>.log
+    "logLevel": "info",
+    // Enable full DEBUG logging + per-request snapshots (overrides logLevel)
     "debug": false,
     // Notification display: "off", "minimal", or "detailed"
     "pruneNotification": "off",

package/README.zh-CN.md

@@ -100,7 +100,7 @@ stateDiagram-v2
 **触发机制：**
 
 - **T1** 在原始上下文超过配置限制时触发。模型看到可压缩范围，编写详细摘要，保留文件路径、函数签名、决策和理由。
-- **T2** 在 T1 摘要 token 达到 `nudgeGrowthTokens`（默认上下文窗口的 5%）时触发。模型蒸馏旧的 T1 块 — 保留决策和结果，丢弃冗长的过程细节。
+- **T2** 在 T1 摘要 token 达到 `nudgeGrowthTokens`（固定默认 50000）时触发。模型蒸馏旧的 T1 块 — 保留决策和结果，丢弃冗长的过程细节。
 - **T3** 在 T2 摘要 token 达到同样阈值时触发。模型浓缩为纯事实（已发布的版本、关键 bug、架构决策）。
 
 每层有**独立的节奏计数器** — T2 触发不阻塞 T3。T1 通过 `!shouldInject` 守卫获得优先级：如果 T1 触发了，T2/T3 等到下一轮。这确保原始上下文压缩优先发生（影响最大）。
@@ -233,11 +233,14 @@ ACP 使用自己的配置文件，按以下顺序搜索：
     "$schema": "https://raw.githubusercontent.com/ranxianglei/opencode-acp/master/dcp.schema.json",
     // Enable or disable the plugin
     "enabled": true,
-    // Automatically update npm-installed ACP when a newer npm latest is available.
-    // Version-locked plugin specs are not updated.
+    // 自动更新 npm 安装的 ACP：跟踪安装所用 dist-tag/规范（@stable 跟随 stable，@latest 跟随 latest）。
+    // 版本锁定的规范不会被更新。
     "autoUpdate": true,
-    // Enable INFO/DEBUG logging + per-request snapshots to ~/.config/opencode/logs/acp/
-    // (WARN/ERROR are always logged to daily/<date>.log)
+    // 文件日志级别: "debug" | "info" | "warn" | "error" | "silent"
+    // 默认 "info"：决策级事件（压缩提示、转换摘要、更新检查）落盘到
+    // ~/.config/opencode/logs/acp/daily/<日期>.log
+    "logLevel": "info",
+    // 启用完整 DEBUG 日志 + 按请求快照（优先于 logLevel）
     "debug": false,
     // Notification display: "off", "minimal", or "detailed"
     "pruneNotification": "detailed",

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA2BjD,QAAA,MAAM,MAAM,EAAE,MA6IK,CAAA;AAEnB,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA2BjD,QAAA,MAAM,MAAM,EAAE,MAqJK,CAAA;AAEnB,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -868,6 +868,7 @@ var VALID_CONFIG_KEYS = /* @__PURE__ */ new Set([
   "enabled",
   "autoUpdate",
   "debug",
+  "logLevel",
   "showUpdateToasts",
   "allowSubAgents",
   "pruneNotification",
@@ -1466,6 +1467,7 @@ var defaultConfig = {
   enabled: true,
   autoUpdate: true,
   debug: false,
+  logLevel: "info",
   allowSubAgents: true,
   pruneNotification: "off",
   // [FIX #20] Default to toast — chat-mode notifications inject an empty
@@ -1727,6 +1729,7 @@ function mergeLayer(config, data) {
     enabled: data.enabled ?? config.enabled,
     autoUpdate: data.autoUpdate ?? config.autoUpdate,
     debug: data.debug ?? config.debug,
+    logLevel: data.logLevel ?? config.logLevel,
     allowSubAgents: data.allowSubAgents ?? data.experimental?.allowSubAgents ?? config.allowSubAgents,
     pruneNotification: data.pruneNotification ?? config.pruneNotification,
     pruneNotificationType: data.pruneNotificationType ?? config.pruneNotificationType,
@@ -6953,13 +6956,7 @@ function computeShouldNudge2(params) {
   }
   return policy.computeShouldNudge(params);
 }
-function resolveAdaptiveNudgeGrowth2(modelContextLimit) {
-  const policy = getDefaultTriggerPolicy();
-  if (!policy) {
-    return 6e3;
-  }
-  return policy.resolveAdaptiveNudgeGrowth(modelContextLimit);
-}
+var DEFAULT_NUDGE_GROWTH_TOKENS = 5e4;
 function addAnchor(anchorMessageIds, anchorMessageId, anchorMessageIndex, messages, interval) {
   if (anchorMessageIndex < 0) {
     return false;
@@ -7192,7 +7189,9 @@ function refNum(ref) {
 function buildCompressibleRanges(messages, state, protectedTools = [], protectedFilePatterns = [], protectedZoneRefs) {
   const msgInfo = [];
   const protectedMsgInfo = [];
-  for (const msg of messages) {
+  const lastUserRefIdx = [];
+  for (let mi = 0; mi < messages.length; mi++) {
+    const msg = messages[mi];
     if (isSyntheticMessage(msg)) continue;
     const ref = state.messageIds.byRawId.get(msg.info.id);
     if (!ref) continue;
@@ -7227,15 +7226,27 @@ function buildCompressibleRanges(messages, state, protectedTools = [], protected
     }
     let tokens = 0;
     let isTool = false;
+    let hasMeaningfulPart = false;
     for (const part of msg.parts || []) {
       if (part.type === "text" && typeof part.text === "string") {
         tokens += Math.round(part.text.length / 4);
+        if (part.text.trim().length > 0) hasMeaningfulPart = true;
       } else if (part.type !== "text" && part.type !== "reasoning") {
         tokens += Math.round(JSON.stringify(part).length / 4);
         isTool = true;
+        hasMeaningfulPart = true;
       }
     }
-    msgInfo.push({ ref, refNum: rn, tokens, isTool, isUser: msg.info.role === "user" });
+    if (msg.info.role === "user" && !isIgnoredUserMessage(msg)) {
+      lastUserRefIdx.length = 0;
+      lastUserRefIdx.push(msgInfo.length);
+    }
+    msgInfo.push({ ref, refNum: rn, tokens, effectiveTokens: 0, meaningful: hasMeaningfulPart, isTool, isUser: msg.info.role === "user" });
+  }
+  const lastUserIdx = lastUserRefIdx.length > 0 ? lastUserRefIdx[0] : -1;
+  for (let i = 0; i < msgInfo.length; i++) {
+    const info = msgInfo[i];
+    info.effectiveTokens = i !== lastUserIdx && info.meaningful ? info.tokens : 0;
   }
   const groups = [];
   let cur = null;
@@ -7261,6 +7272,7 @@ function buildCompressibleRanges(messages, state, protectedTools = [], protected
         endRef: info.ref,
         count: 1,
         tokens: info.tokens,
+        effectiveTokens: info.effectiveTokens,
         toolPct: info.isTool ? 100 : 0,
         textPct: info.isTool ? 0 : 100
       };
@@ -7268,6 +7280,7 @@ function buildCompressibleRanges(messages, state, protectedTools = [], protected
       cur.endRef = info.ref;
       cur.count++;
       cur.tokens += info.tokens;
+      cur.effectiveTokens += info.effectiveTokens;
       if (info.isTool) {
         cur.toolPct = Math.round((cur.toolPct * (cur.count - 1) + 100) / cur.count);
       } else {
@@ -7310,6 +7323,11 @@ function buildCompressibleRanges(messages, state, protectedTools = [], protected
     protected: protectedGroups
   };
 }
+var EFFECTIVE_MIN_COMPRESSIBLE_TOKENS = 1250;
+function resolveEffectiveFloor(config) {
+  const minChars = config.compress?.minCompressRange ?? 5e3;
+  return minChars > 0 ? Math.floor(minChars / 4) : 0;
+}
 function filterRecommendedRanges(compressible, _protectedRanges, options) {
   const { logger } = options;
   const log = logger?.debug.bind(logger);
@@ -7317,12 +7335,22 @@ function filterRecommendedRanges(compressible, _protectedRanges, options) {
     log?.("filterRecommendedRanges: no compressible ranges, returning empty");
     return [];
   }
-  const result = compressible.map(
-    (r, i) => i === compressible.length - 1 ? { ...r, dangerous: true } : r
+  const floor = options.minEffectiveTokens ?? EFFECTIVE_MIN_COMPRESSIBLE_TOKENS;
+  const kept = compressible.filter((r) => {
+    const effective = r.effectiveTokens ?? r.tokens;
+    return effective > 0 && effective >= floor;
+  });
+  const result = kept.map(
+    (r, i) => i === kept.length - 1 ? { ...r, dangerous: true } : r
   );
-  log?.("filterRecommendedRanges: passthrough (last segment marked dangerous)", {
+  log?.("filterRecommendedRanges: effective-token floor applied", {
     inputRanges: compressible.length,
-    outputRanges: result.length
+    outputRanges: result.length,
+    floor,
+    dropped: compressible.filter((r) => {
+      const effective = r.effectiveTokens ?? r.tokens;
+      return effective <= 0 || effective < floor;
+    }).map((r) => `${r.startRef}\u2013${r.endRef} (${r.effectiveTokens ?? r.tokens} eff tokens)`)
   });
   return result;
 }
@@ -7331,8 +7359,10 @@ function formatCompressibleRanges(ranges, protectedRanges) {
   if (!protectedRanges || protectedRanges.length === 0) {
     if (ranges.length === 0) return "";
     const lines2 = ranges.map((r) => {
+      const eff = r.effectiveTokens ?? r.tokens;
+      const size = eff < r.tokens ? `${fmt(eff)} effective of ${fmt(r.tokens)}` : fmt(r.tokens);
       const suffix = r.dangerous ? "  \u26A0\uFE0F NOT recommended unless you are certain. If you MUST compress this, pass `dangerous: true`." : "";
-      return `  ${r.startRef}\u2013${r.endRef}  ${r.count} msgs  ${fmt(r.tokens)} [tool ${r.toolPct}% | text ${r.textPct}%]${suffix}`;
+      return `  ${r.startRef}\u2013${r.endRef}  ${r.count} msgs  ${size} [tool ${r.toolPct}% | text ${r.textPct}%]${suffix}`;
     });
     return `Compressible ranges (oldest first):
 ${lines2.join("\n")}`;
@@ -7348,7 +7378,7 @@ ${lines2.join("\n")}`;
       tokens: r.tokens,
       toolPct: r.toolPct,
       textPct: r.textPct,
-      compressibleTokens: r.tokens,
+      compressibleTokens: r.effectiveTokens ?? r.tokens,
       compressibleCount: r.count,
       protectedTokens: 0,
       protectedCount: 0,
@@ -7588,7 +7618,7 @@ var injectCompressNudges = (state, config, logger, messages, prompts, compressio
     }
   }
   const suffixMessage = createSuffixMessage(messages);
-  const nudgeGrowthTokens = config.compress?.nudgeGrowthTokens ?? resolveAdaptiveNudgeGrowth2(modelContextLimit);
+  const nudgeGrowthTokens = config.compress?.nudgeGrowthTokens ?? DEFAULT_NUDGE_GROWTH_TOKENS;
   const growthFloor = Math.max(
     config.compress?.minNudgeGrowthFloor ?? 5e3,
     (config.compress?.minNudgeGrowthRatio ?? 0.45) * nudgeGrowthTokens
@@ -7637,14 +7667,18 @@ var injectCompressNudges = (state, config, logger, messages, prompts, compressio
   const recommendedRanges = filterRecommendedRanges(
     unprotectedCompressible,
     contextRanges.protected,
-    { logger }
+    { logger, minEffectiveTokens: resolveEffectiveFloor(config) }
   );
   const hasRecommendations = recommendedRanges.length > 0;
   const allProtected = contextRanges.compressible.length === 0 && contextRanges.protected.length > 0;
   const allInProtectedZone = protectedRefs.size > 0 && unprotectedCompressible.length === 0;
-  const nothingToCompress = allProtected || allInProtectedZone;
-  const shouldInjectNudge = nudgeAllowed && (!nothingToCompress || emergencyOverride);
-  let shouldInject = shouldInjectNudge;
+  const allBelowMin = contextRanges.compressible.length > 0 && recommendedRanges.length === 0;
+  const nothingToCompress = allProtected || allInProtectedZone || allBelowMin;
+  const emergencyNoTargets = emergencyOverride && nothingToCompress;
+  const noticeCadenceMet = state.nudges.lastNudgeShownTokens === void 0 || growthSinceBaseline !== void 0 && growthSinceBaseline >= growthFloor;
+  const shouldInjectNudge = nudgeAllowed && !nothingToCompress;
+  const shouldInjectNotice = emergencyNoTargets && noticeCadenceMet;
+  let shouldInject = shouldInjectNudge || shouldInjectNotice;
   if (shouldInjectNudge) {
     applyAnchoredNudges(state, config, messages, prompts, compressionPriorities, currentTokens, modelContextLimit, suffixMessage);
   }
@@ -7726,6 +7760,13 @@ Multiple entries create separate blocks: \`content: [{ startId: "b${firstBlock.b
 ${rules}`;
       appendToLastTextPart(suffixMessage, tierText);
       shouldInject = true;
+      logger.info(`Tier ${tc.triggerTier} trigger nudge injected`, {
+        session: state.sessionId,
+        action,
+        targetTier: tc.targetTier,
+        blocks: candidates.length,
+        candidateTokens
+      });
       if (tc.triggerTier === 2) {
         state.nudges.lastTier2NudgeTokens = currentTokens;
       } else {
@@ -7735,6 +7776,32 @@ ${rules}`;
     }
   }
   state.nudges.shouldInjectThisTurn = shouldInject;
+  const usagePct = currentTokens !== void 0 && modelContextLimit ? `${(currentTokens / modelContextLimit * 100).toFixed(1)}%` : void 0;
+  if (shouldInjectNudge) {
+    logger.info("Compression nudge injected", {
+      session: state.sessionId,
+      trigger: emergencyOverride ? "emergency" : "growth",
+      currentTokens,
+      usagePct,
+      growthSinceBaseline,
+      growthFloor,
+      recommendedRanges: recommendedRanges.length
+    });
+  } else if (shouldInjectNotice) {
+    logger.info("Emergency /compact notice injected (no compressible targets)", {
+      session: state.sessionId,
+      currentTokens,
+      usagePct
+    });
+  } else if (nudgeAllowed && nothingToCompress) {
+    logger.info("Nudge suppressed: nothing to compress", {
+      session: state.sessionId,
+      reason: allProtected ? "all_protected" : allInProtectedZone ? "in_protected_zone" : "below_effective_floor",
+      currentTokens,
+      usagePct,
+      compressibleRanges: contextRanges.compressible.length
+    });
+  }
   if (shouldInject && config.debug && contextRanges.compressible.length > 0) {
     const compressible = contextRanges.compressible;
     const fmt = (n) => n >= 1e3 ? `${(n / 1e3).toFixed(1)}K` : String(n);
@@ -7778,8 +7845,19 @@ ${formatCompressibleRanges(recommendedRanges, contextRanges.protected)}`;
 Use \`acp_status({scope:"uncompressed"})\` to re-fetch compressible ranges after compressing, or \`acp_status\` for compressed block details.`;
       appendToLastTextPart(suffixMessage, breakdown);
     }
-    if (effectiveTipsVariant === "maxLimit") {
+    if (effectiveTipsVariant === "maxLimit" && !emergencyNoTargets) {
       tipsText = "\n\n\u26A0\uFE0F Context limit reached \u2014 compress now. Prioritize consumed tool outputs.\n\n" + HOW_TO_COMPRESS_RULES + '\n\n{ "topic": "...", "content": [{ "startId": "<ID>", "endId": "<ID>", "summary": "..." }] }\n\nOnly use IDs from visible messages above. Compress older work first.';
+    } else if (shouldInjectNotice) {
+      const emergencyPct = currentTokens !== void 0 && modelContextLimit !== void 0 && modelContextLimit > 0 ? Math.round(currentTokens / modelContextLimit * 100) : void 0;
+      tipsText = `
+
+\u{1F6A8} Context is critically full${emergencyPct !== void 0 ? ` (${emergencyPct}% of limit)` : ""} and there is nothing left that can be safely compressed.
+Do NOT retry compress on the same ranges \u2014 they will keep failing.
+You cannot execute user commands yourself. Act now via your reply/message tool:
+- Inform the user that context is full and compression is exhausted
+- Recommend they run /acp export (archives compression summaries to a file), then /compact or start a new session
+- Alternatively, ask them to relax protected-tool / preserve-recent settings so compression becomes possible
+Then stop retrying and await the user's response.`;
     }
     state.nudges.lastNudgeShownTokens = currentTokens;
     {
@@ -9032,15 +9110,35 @@ import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
 import { join as join3 } from "path";
 import { existsSync as existsSync3 } from "fs";
 import { homedir as homedir3 } from "os";
-var LOG_VERSION = true ? "1.14.22" : "dev";
+var LOG_VERSION = true ? "1.14.23-pr.332.52" : "dev";
+var LEVEL_RANK = {
+  debug: 10,
+  info: 20,
+  warn: 30,
+  error: 40,
+  silent: 99
+};
 var Logger = class {
   logDir;
-  enabled;
-  constructor(enabled) {
-    this.enabled = enabled;
+  /** Resolved verbosity; replaces the old boolean `enabled` flag. */
+  level;
+  /**
+   * @param enabled legacy boolean toggle — `true` maps to `debug`,
+   *                `false` maps to `warn` (errors + warnings only).
+   * @param level   explicit verbosity; when given it wins over `enabled`.
+   */
+  constructor(enabled, level) {
+    this.level = level ?? (enabled ? "debug" : "warn");
     const configHome = process.env.XDG_CONFIG_HOME || join3(homedir3(), ".config");
     this.logDir = join3(configHome, "opencode", "logs", "acp");
   }
+  /** Back-compat view of the old flag: true only at full debug verbosity. */
+  get enabled() {
+    return this.level === "debug";
+  }
+  shouldWrite(level) {
+    return LEVEL_RANK[level] >= LEVEL_RANK[this.level];
+  }
   async ensureLogDir() {
     if (!existsSync3(this.logDir)) {
       await mkdir2(this.logDir, { recursive: true });
@@ -9087,7 +9185,7 @@ var Logger = class {
     }
   }
   async write(level, component, message, data) {
-    if (!this.enabled && level !== "ERROR" && level !== "WARN") return;
+    if (!this.shouldWrite(level.toLowerCase())) return;
     try {
       await this.ensureLogDir();
       const timestamp = (/* @__PURE__ */ new Date()).toISOString();
@@ -9104,12 +9202,10 @@ var Logger = class {
     }
   }
   info(message, data) {
-    if (!this.enabled) return;
     const component = this.getCallerFile(2);
     return this.write("INFO", component, message, data);
   }
   debug(message, data) {
-    if (!this.enabled) return;
     const component = this.getCallerFile(2);
     return this.write("DEBUG", component, message, data);
   }
@@ -9207,7 +9303,7 @@ var Logger = class {
     });
   }
   async saveContext(sessionId, messages) {
-    if (!this.enabled) return;
+    if (this.level !== "debug") return;
     try {
       const contextDir = join3(this.logDir, "context", sessionId);
       if (!existsSync3(contextDir)) {
@@ -10968,6 +11064,7 @@ function createChatMessageTransformHandler(client, registry4, logger, config, pr
         requestModel?.providerID,
         requestModel?.modelID
       );
+      const prevModelID = state.modelID;
       if (requestModelLimit !== void 0) {
         state.modelContextLimit = requestModelLimit;
         state.modelProviderID = requestModel?.providerID;
@@ -10987,6 +11084,14 @@ function createChatMessageTransformHandler(client, registry4, logger, config, pr
         state.modelProviderID = requestModel.providerID;
         state.modelID = requestModel.modelID;
       }
+      if (requestModel?.modelID && requestModel.modelID !== prevModelID) {
+        logger.info("Model switched mid-session", {
+          session: state.sessionId,
+          from: prevModelID,
+          to: requestModel.modelID,
+          contextLimit: state.modelContextLimit
+        });
+      }
       await updatePerTurnState(state, logger, messages);
     }
     syncCompressPermissionState(state, config, hostPermissions, output.messages);
@@ -11048,6 +11153,17 @@ ${text}`);
     hideFailedCompressCalls(output.messages);
     stripStaleMetadata(output.messages);
     dropEmptyMessages(output.messages);
+    const postTokens = getCurrentTokenUsage(state, output.messages);
+    logger.info("Chat transform complete", {
+      session: state.sessionId,
+      model: state.modelID,
+      messages: output.messages.length,
+      prePruneTokens,
+      postTokens,
+      contextLimit: state.modelContextLimit,
+      usagePct: postTokens !== void 0 && state.modelContextLimit ? `${(postTokens / state.modelContextLimit * 100).toFixed(1)}%` : void 0,
+      nudged: state.nudges.shouldInjectThisTurn
+    });
     if (state.sessionId) {
       await logger.saveContext(state.sessionId, output.messages);
     }
@@ -11225,12 +11341,31 @@ import { readFile as readFile2, rm } from "fs/promises";
 import { basename, dirname as dirname4, join as join6 } from "path";
 import { fileURLToPath } from "url";
 var PACKAGE_NAME = "opencode-acp";
-function startAutoUpdate(ctx, enabled) {
-  if (!enabled) return;
+function startAutoUpdate(ctx, enabled, logger) {
+  if (!enabled) {
+    logger?.info("Auto-update disabled by config");
+    return;
+  }
+  logger?.info("Auto-update check starting");
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 1e4);
-  void checkAutoUpdate(controller.signal).then((result) => {
-    if (!result.updated) return;
+  void checkAutoUpdate(controller.signal, logger).then((result) => {
+    if (!result.updated) {
+      if ("error" in result) {
+        logger?.warn("Auto-update failed", {
+          error: result.error,
+          name: result.name,
+          current: result.current,
+          latest: result.latest
+        });
+      }
+      return;
+    }
+    logger?.info("Auto-update applied update", {
+      name: result.name,
+      from: result.current,
+      to: result.latest
+    });
     setTimeout(() => {
       ctx.client.tui.showToast({
         body: {
@@ -11244,17 +11379,39 @@ function startAutoUpdate(ctx, enabled) {
   }).catch(() => {
   }).finally(() => clearTimeout(timeout));
 }
-async function checkAutoUpdate(signal) {
+async function checkAutoUpdate(signal, logger) {
   const packageDir = await findPackageDir(PACKAGE_NAME);
-  if (!packageDir) return { updated: false };
+  if (!packageDir) {
+    logger?.info("Auto-update skipped: package dir not found");
+    return { updated: false };
+  }
   const pkg = await readPackageJson(join6(packageDir, "package.json"));
-  if (!pkg?.name || !pkg.version) return { updated: false };
-  const latest = await fetchLatestVersion(pkg.name, signal);
-  if (!latest || !isVersionNewer(latest, pkg.version)) return { updated: false };
-  const removeDir = await updateRemoveDir(packageDir, pkg.name);
-  if (!removeDir) return { updated: false };
+  if (!pkg?.name || !pkg.version) {
+    logger?.info("Auto-update skipped: package.json unreadable", { packageDir });
+    return { updated: false };
+  }
+  const target = await updateTarget(packageDir, pkg.name);
+  if (!target) {
+    logger?.info("Auto-update skipped: no update target", { name: pkg.name, version: pkg.version });
+    return { updated: false };
+  }
+  const tag = specUpdateTag(target.spec);
+  if (!tag) {
+    logger?.info("Auto-update skipped: spec not auto-updatable", { spec: target.spec });
+    return { updated: false };
+  }
+  const latest = await fetchLatestVersion(pkg.name, tag, signal);
+  if (!latest) {
+    logger?.info("Auto-update skipped: no version published for tag", { name: pkg.name, tag });
+    return { updated: false };
+  }
+  if (!isVersionNewer(latest, pkg.version)) {
+    logger?.info("Auto-update: already up to date", { name: pkg.name, tag, current: pkg.version, latest });
+    return { updated: false };
+  }
+  logger?.info("Auto-update: newer version available", { name: pkg.name, tag, current: pkg.version, latest });
   try {
-    await rm(removeDir, { recursive: true, force: true });
+    await rm(target.removeDir, { recursive: true, force: true });
   } catch {
     return {
       updated: false,
@@ -11276,7 +11433,7 @@ async function findPackageDir(name) {
     dir = parent;
   }
 }
-async function updateRemoveDir(packageDir, name) {
+async function updateTarget(packageDir, name) {
   const packageParent = dirname4(packageDir);
   const nodeModulesDir = basename(packageParent).startsWith("@") ? dirname4(packageParent) : packageParent;
   if (basename(nodeModulesDir) !== "node_modules") return void 0;
@@ -11284,7 +11441,7 @@ async function updateRemoveDir(packageDir, name) {
   const wrapperPkg = await readPackageJson(join6(wrapperDir, "package.json"));
   const spec = wrapperSpec(wrapperDir, name) ?? wrapperPkg?.dependencies?.[name];
   if (!spec || !isAutoUpdatableSpec(spec)) return void 0;
-  return wrapperDir;
+  return { removeDir: wrapperDir, spec };
 }
 function wrapperSpec(wrapperDir, name) {
   if (name.startsWith("@")) {
@@ -11305,8 +11462,22 @@ function isAutoUpdatableSpec(spec) {
   if (/^[~^]/.test(value)) return true;
   if (/^(?:>=|>|<=|<)/.test(value)) return true;
   if (/\s+(?:\|\||-|[<>=])\s+/.test(value)) return true;
+  if (isDistTag(value)) return true;
   return false;
 }
+function specUpdateTag(spec) {
+  const value = spec.trim();
+  if (!isAutoUpdatableSpec(value)) return void 0;
+  if (value === "*") return "latest";
+  if (isDistTag(value)) return value;
+  return "latest";
+}
+function isDistTag(value) {
+  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value)) return false;
+  if (parseVersion(value)) return false;
+  if (/\.x(\.|$)/i.test(value)) return false;
+  return true;
+}
 async function readPackageJson(path) {
   try {
     const data = JSON.parse(await readFile2(path, "utf-8"));
@@ -11315,10 +11486,10 @@ async function readPackageJson(path) {
     return void 0;
   }
 }
-async function fetchLatestVersion(name, signal) {
+async function fetchLatestVersion(name, tag, signal) {
   try {
     const response = await fetch(
-      `https://registry.npmjs.org/${encodeURIComponent(name)}/latest`,
+      `https://registry.npmjs.org/${encodeURIComponent(name)}/${encodeURIComponent(tag)}`,
       {
         signal
       }
@@ -11371,7 +11542,15 @@ var server = (async (ctx) => {
   if (!config.enabled) {
     return {};
   }
-  const logger = new Logger(config.debug);
+  const logger = new Logger(config.debug, config.debug ? "debug" : config.logLevel);
+  logger.info("ACP plugin initialized", {
+    version: true ? "1.14.23-pr.332.52" : "dev",
+    workspace: ctx.directory,
+    logLevel: logger.level,
+    debug: config.debug,
+    autoUpdate: config.autoUpdate,
+    secureMode: isSecureMode()
+  });
   const registry4 = new SessionStateRegistry(logger);
   const prompts = new PromptStore(logger, ctx.directory, config.experimental.customPrompts);
   const hostPermissions = {
@@ -11401,7 +11580,7 @@ var server = (async (ctx) => {
     }
   );
   logger.info("DCP initialized");
-  startAutoUpdate(ctx, config.autoUpdate);
+  startAutoUpdate(ctx, config.autoUpdate, logger);
   const compressToolContext = {
     client: ctx.client,
     registry: registry4,