@vikrant82/opencode-cache-keepalive 0.1.0 → 0.1.1

package/lib/logger.ts

@@ -1,21 +1,47 @@
+import { appendFileSync, mkdirSync } from "node:fs"
+import { dirname } from "node:path"
+
 const PREFIX = "[cache-keepalive]"
 
 export class Logger {
-    constructor(private readonly debug: boolean) {}
+    private readonly logPath: string
+    private readonly debug: boolean
+    private initialized = false
+
+    constructor(debug: boolean, logPath: string) {
+        this.debug = debug
+        this.logPath = logPath
+    }
 
     info(message: string, data?: unknown) {
-        if (this.debug) console.log(`${PREFIX} ${message}`, data ?? "")
+        this.write("INFO", message, data)
     }
 
     warn(message: string, data?: unknown) {
-        console.warn(`${PREFIX} ${message}`, data ?? "")
+        this.write("WARN", message, data)
     }
 
     error(message: string, data?: unknown) {
-        console.error(`${PREFIX} ${message}`, data ?? "")
+        this.write("ERROR", message, data)
     }
 
     dbg(message: string, data?: unknown) {
-        if (this.debug) console.log(`${PREFIX}:debug ${message}`, data ?? "")
+        if (this.debug) this.write("DEBUG", message, data)
+    }
+
+    private write(level: string, message: string, data?: unknown): void {
+        const ts = new Date().toISOString()
+        const extra =
+            data !== undefined ? ` ${typeof data === "string" ? data : JSON.stringify(data)}` : ""
+        const line = `${ts} ${level} ${PREFIX} ${message}${extra}\n`
+        try {
+            if (!this.initialized) {
+                mkdirSync(dirname(this.logPath), { recursive: true })
+                this.initialized = true
+            }
+            appendFileSync(this.logPath, line, "utf8")
+        } catch {
+            // Best-effort logging — never crash the plugin.
+        }
     }
 }

package/lib/paths.ts

@@ -29,3 +29,8 @@ export function stateDirectoryPath(): string {
 export function controlFilePath(): string {
     return join(stateDirectoryPath(), "control.json")
 }
+
+/** Append-only log file for the server plugin — never stdout, which corrupts the TUI. */
+export function logFilePath(): string {
+    return join(stateDirectoryPath(), "server.log")
+}

package/lib/state.ts

@@ -26,7 +26,7 @@ export type SessionKeepalive = {
     windowEndsAt: number
     /** Epoch ms the next ping is due. */
     nextPingAt: number
-    /** Pings sent during the current idle stretch. */
+    /** Number of scheduled ping requests attempted during this warm window. */
     pingsSent: number
     /** A real turn is currently running. */
     busy: boolean

package/lib/tui/footer.tsx

@@ -38,7 +38,11 @@ export function KeepaliveFooter(props: { theme: Theme; directory: string; sessio
             const match = readdirSync(stateDirectoryPath())
                 .filter((name) => name.startsWith("state-") && name.endsWith(".json"))
                 .map((name) => readState(join(stateDirectoryPath(), name)))
-                .find((snapshot) => snapshot?.sessions?.[sessionID])
+                .filter(
+                    (snapshot): snapshot is PersistedState =>
+                        snapshot?.sessions?.[sessionID] !== undefined,
+                )
+                .sort((a, b) => b.updatedAt - a.updatedAt)[0]
             setState(match)
         } catch {
             setState(undefined)
@@ -63,8 +67,11 @@ export function KeepaliveFooter(props: { theme: Theme; directory: string; sessio
 
         const interval = session.intervalMs || snapshot.intervalMs || 270_000
         const idleMs = Math.max(0, now() - (session.lastResponseAt || now()))
+        // `nextPingAt` is the scheduler's source of truth and includes the
+        // per-ping jitter. Counting from it keeps the two counters in step.
+        const nextPingAt = Math.max(session.nextPingAt || now(), now())
         const left = session.active
-            ? Math.max(0, Math.floor((session.windowEndsAt - now()) / interval))
+            ? Math.max(0, Math.ceil((session.windowEndsAt - nextPingAt) / interval))
             : 0
         const status: Status =
             !snapshot.enabled || !session.eligible

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "@vikrant82/opencode-cache-keepalive",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "type": "module",
     "description": "OpenCode plugin that keeps provider prompt caches warm by sending invisible keepalive pings, with a live TUI readout",
     "main": "./dist/index.js",