@khalilgharbaoui/opencode-claude-code-plugin 0.4.12 → 0.4.14

package/README.md

@@ -321,11 +321,28 @@ Set `permissionMode: "plan"` to forward `--permission-mode plan` to Claude. The
 
 ## Debug logging
 
+Two independent knobs:
+
 ```bash
+# Verbose logging to stderr (opencode surfaces stderr as UI warnings):
 DEBUG=opencode-claude-code opencode
+
+# Persistent file log (default: OFF — file is not created at all):
+OPENCODE_CLAUDE_CODE_LOG_FILE=1 opencode
+
+# Both:
+DEBUG=opencode-claude-code OPENCODE_CLAUDE_CODE_LOG_FILE=1 opencode
 ```
 
-Goes to stderr.
+When `OPENCODE_CLAUDE_CODE_LOG_FILE` is set to any truthy value (`1`,
+`true`, `yes`, `on`), the plugin writes NOTICE/WARN/ERROR (plus INFO and
+DEBUG when `DEBUG=opencode-claude-code` is also set) to
+`~/.local/share/opencode-claude-code/plugin.log` with 5MB rotation. Override
+the directory with `OPENCODE_CLAUDE_CODE_LOG_DIR=/custom/path`.
+
+Default is off so the plugin doesn't accrete a log file on every user's
+disk. Opt in when you need to inspect auto-continue decisions, broker
+state, or other plugin internals.
 
 ## Known limitations
 

package/dist/index.js

@@ -9,6 +9,13 @@ var DEBUG = process.env.DEBUG?.includes("opencode-claude-code") ?? false;
 var LOG_DIR = process.env.OPENCODE_CLAUDE_CODE_LOG_DIR ?? join(homedir(), ".local", "share", "opencode-claude-code");
 var LOG_FILE = join(LOG_DIR, "plugin.log");
 var MAX_LOG_BYTES = 5 * 1024 * 1024;
+function isTruthyEnv(v) {
+  if (v == null) return false;
+  const s = v.toLowerCase().trim();
+  if (s === "") return false;
+  return s !== "0" && s !== "false" && s !== "no" && s !== "off";
+}
+var LOG_FILE_ENABLED = isTruthyEnv(process.env.OPENCODE_CLAUDE_CODE_LOG_FILE);
 var fileLoggingDisabled = false;
 function rotateIfNeeded() {
   try {
@@ -20,6 +27,7 @@ function rotateIfNeeded() {
   }
 }
 function writeToFile(line) {
+  if (!LOG_FILE_ENABLED) return;
   if (fileLoggingDisabled) return;
   try {
     mkdirSync(dirname(LOG_FILE), { recursive: true });
@@ -1211,7 +1219,7 @@ async function createProxyMcpServer(tools = DEFAULT_PROXY_TOOLS) {
             timer = setTimeout(() => {
               if (!pending.has(callId)) return;
               pending.delete(callId);
-              log.warn("proxy-mcp tool call timed out", {
+              log.notice("proxy-mcp tool call timed out", {
                 callId,
                 toolName,
                 timeoutMs: PROXY_CALL_TIMEOUT_MS
@@ -1255,8 +1263,11 @@ async function createProxyMcpServer(tools = DEFAULT_PROXY_TOOLS) {
         error: { code: -32601, message: `Unknown method: ${request.method}` }
       });
     } catch (error) {
-      log.warn("proxy-mcp error handling request", {
-        error: error instanceof Error ? error.message : String(error)
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      const isTimeout = errorMessage.includes("timed out after") && errorMessage.includes("waiting for opencode to resolve");
+      const logFn = isTimeout ? log.notice : log.warn;
+      logFn("proxy-mcp error handling request", {
+        error: errorMessage
       });
       try {
         writeJson(res, {
@@ -1428,7 +1439,7 @@ function queuePendingProxyCall(sessionKey2, call) {
         `Proxy tool call '${call.toolName}' timed out after ${PENDING_PROXY_CALL_TIMEOUT_MS}ms waiting for opencode to resolve the call`
       )
     );
-    log.warn("timed out pending proxy call", {
+    log.notice("timed out pending proxy call", {
       sessionKey: current.sessionKey,
       toolCallId: call.id,
       toolName: call.toolName,