opencode-acp 1.14.23 → 1.14.24

package/README.md

@@ -282,8 +282,11 @@ Each level overrides the previous, so project settings take priority over global
     // 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

@@ -236,8 +236,11 @@ ACP 使用自己的配置文件，按以下顺序搜索：
     // 自动更新 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,
@@ -7757,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 {
@@ -7766,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);
@@ -9074,15 +9110,36 @@ 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.23" : "dev";
+var LOG_VERSION = true ? "1.14.24" : "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) {
+    const resolved = level !== void 0 && LEVEL_RANK[level] !== void 0 ? level : void 0;
+    this.level = resolved ?? (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 });
@@ -9129,7 +9186,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();
@@ -9146,12 +9203,12 @@ var Logger = class {
     }
   }
   info(message, data) {
-    if (!this.enabled) return;
+    if (!this.shouldWrite("info")) return;
     const component = this.getCallerFile(2);
     return this.write("INFO", component, message, data);
   }
   debug(message, data) {
-    if (!this.enabled) return;
+    if (!this.shouldWrite("debug")) return;
     const component = this.getCallerFile(2);
     return this.write("DEBUG", component, message, data);
   }
@@ -9249,7 +9306,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)) {
@@ -11010,6 +11067,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;
@@ -11029,6 +11087,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);
@@ -11090,6 +11156,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);
     }
@@ -11267,12 +11344,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: {
@@ -11286,17 +11382,37 @@ 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 };
+  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) return { updated: false };
+  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) return { updated: false };
+  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 || !isVersionNewer(latest, pkg.version)) return { updated: false };
+  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(target.removeDir, { recursive: true, force: true });
   } catch {
@@ -11429,7 +11545,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.24" : "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 = {
@@ -11459,7 +11583,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,