@cortexkit/aft-opencode 0.18.1 → 0.18.2

package/dist/tui.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@cortexkit/aft-opencode",
-  version: "0.18.1",
+  version: "0.18.2",
   type: "module",
   description: "OpenCode plugin for Agent File Tools (AFT) \u2014 tree-sitter and lsp powered code analysis",
   main: "dist/index.js",
@@ -16,6 +16,7 @@ var package_default = {
     "dist",
     "src/tui",
     "src/shared",
+    "src/logger.ts",
     "README.md"
   ],
   scripts: {
@@ -34,11 +35,11 @@ var package_default = {
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.18.1",
-    "@cortexkit/aft-darwin-x64": "0.18.1",
-    "@cortexkit/aft-linux-arm64": "0.18.1",
-    "@cortexkit/aft-linux-x64": "0.18.1",
-    "@cortexkit/aft-win32-x64": "0.18.1"
+    "@cortexkit/aft-darwin-arm64": "0.18.2",
+    "@cortexkit/aft-darwin-x64": "0.18.2",
+    "@cortexkit/aft-linux-arm64": "0.18.2",
+    "@cortexkit/aft-linux-x64": "0.18.2",
+    "@cortexkit/aft-win32-x64": "0.18.2"
   },
   devDependencies: {
     "@types/node": "^22.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -14,6 +14,7 @@
     "dist",
     "src/tui",
     "src/shared",
+    "src/logger.ts",
     "README.md"
   ],
   "scripts": {
@@ -32,11 +33,11 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.18.1",
-    "@cortexkit/aft-darwin-x64": "0.18.1",
-    "@cortexkit/aft-linux-arm64": "0.18.1",
-    "@cortexkit/aft-linux-x64": "0.18.1",
-    "@cortexkit/aft-win32-x64": "0.18.1"
+    "@cortexkit/aft-darwin-arm64": "0.18.2",
+    "@cortexkit/aft-darwin-x64": "0.18.2",
+    "@cortexkit/aft-linux-arm64": "0.18.2",
+    "@cortexkit/aft-linux-x64": "0.18.2",
+    "@cortexkit/aft-win32-x64": "0.18.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/logger.ts

@@ -0,0 +1,99 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+
+const TAG = "[aft-plugin]";
+const logFile = path.join(os.tmpdir(), "aft-plugin.log");
+
+/**
+ * When AFT_LOG_STDERR=1, logs go to stderr (useful for subprocess tests that
+ * capture stderr output). Otherwise logs go to the temp file.
+ */
+const useStderr = process.env.AFT_LOG_STDERR === "1";
+
+let buffer: string[] = [];
+let flushTimer: ReturnType<typeof setTimeout> | null = null;
+const FLUSH_INTERVAL_MS = 500;
+const BUFFER_SIZE_LIMIT = 50;
+
+function flush(): void {
+  if (buffer.length === 0) return;
+  const data = buffer.join("");
+  buffer = [];
+  try {
+    if (useStderr) {
+      process.stderr.write(data);
+    } else {
+      fs.appendFileSync(logFile, data);
+    }
+  } catch {
+    // Intentional: logging must never throw
+  }
+}
+
+function scheduleFlush(): void {
+  if (flushTimer) return;
+  flushTimer = setTimeout(() => {
+    flushTimer = null;
+    flush();
+  }, FLUSH_INTERVAL_MS);
+  // Don't prevent Node from exiting
+  if (flushTimer && typeof flushTimer === "object" && "unref" in flushTimer) {
+    flushTimer.unref();
+  }
+}
+
+function write(level: string, message: string, data?: unknown, sessionId?: string): void {
+  try {
+    const timestamp = new Date().toISOString();
+    const serialized = data === undefined ? "" : ` ${JSON.stringify(data)}`;
+    const sessionPrefix = sessionId ? ` [${sessionId}]` : "";
+    const line = `[${timestamp}] ${level} ${TAG}${sessionPrefix} ${message}${serialized}\n`;
+    if (useStderr) {
+      // Write immediately in stderr mode (subprocess tests need it before exit)
+      process.stderr.write(line);
+      return;
+    }
+    buffer.push(line);
+    if (buffer.length >= BUFFER_SIZE_LIMIT) {
+      flush();
+    } else {
+      scheduleFlush();
+    }
+  } catch {
+    // Intentional: logging must never throw
+  }
+}
+export function log(message: string, data?: unknown): void {
+  write("INFO", message, data);
+}
+
+export function warn(message: string, data?: unknown): void {
+  write("WARN", message, data);
+}
+
+export function error(message: string, data?: unknown): void {
+  write("ERROR", message, data);
+}
+
+/**
+ * Log with a session-id prefix. Use for messages that originate from a
+ * specific OpenCode session (per-request errors, timeouts, crashes during
+ * a session's tool call). Bridge-lifecycle logs (spawn, version, idle) are
+ * project-scoped, not session-scoped — use `log`/`warn`/`error` for those.
+ */
+export function sessionLog(sessionId: string, message: string, data?: unknown): void {
+  write("INFO", message, data, sessionId);
+}
+
+export function sessionWarn(sessionId: string, message: string, data?: unknown): void {
+  write("WARN", message, data, sessionId);
+}
+
+export function sessionError(sessionId: string, message: string, data?: unknown): void {
+  write("ERROR", message, data, sessionId);
+}
+
+export function getLogFilePath(): string {
+  return logFile;
+}