@towles/tool 0.0.127 → 0.0.128

package/node_modules/@towles/shared/src/errors.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { AppError } from "./errors";
+
+describe("AppError", () => {
+  it("carries code and message", () => {
+    const err = new AppError("my_code", "boom");
+    expect(err.code).toBe("my_code");
+    expect(err.message).toBe("boom");
+    expect(err).toBeInstanceOf(Error);
+    expect(err).toBeInstanceOf(AppError);
+  });
+
+  it("uses the constructor name as the error name", () => {
+    class ChildError extends AppError {
+      constructor(message: string) {
+        super("child_code", message);
+      }
+    }
+    expect(new AppError("c", "m").name).toBe("AppError");
+    expect(new ChildError("m").name).toBe("ChildError");
+  });
+
+  it("forwards cause to the native Error.cause", () => {
+    const root = new Error("root");
+    const err = new AppError("wrapped", "outer", { cause: root });
+    expect(err.cause).toBe(root);
+  });
+
+  it("leaves cause undefined when not provided", () => {
+    const err = new AppError("nope", "no cause");
+    expect(err.cause).toBeUndefined();
+  });
+});

package/node_modules/@towles/shared/src/errors.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared error base class for towles-tool.
+ *
+ * Uses the native ES2022 `Error.cause` option so stack traces chain properly.
+ */
+export class AppError extends Error {
+  readonly code: string;
+
+  constructor(code: string, message: string, options?: { cause?: unknown }) {
+    super(message, options);
+    this.name = new.target.name;
+    this.code = code;
+  }
+}

package/node_modules/@towles/shared/src/index.ts

@@ -1,3 +1,4 @@
+export { AppError } from "./errors.js";
 export { ensureDir, fileExists, readFile, writeFile } from "./fs.js";
 export { getTerminalColumns, limitText, printWithHexColor } from "./render.js";
 export { formatDate, generateJournalFilename, getMondayOfWeek, getWeekInfo } from "./date-utils.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@towles/tool",
-  "version": "0.0.127",
+  "version": "0.0.128",
   "description": "One off quality of life scripts that I use on a daily basis.",
   "homepage": "https://github.com/ChrisTowles/towles-tool#readme",
   "bugs": {
@@ -50,32 +50,32 @@
     "prepare": "simple-git-hooks"
   },
   "dependencies": {
-    "@anthropic-ai/claude-code": "^2.1.4",
-    "@anthropic-ai/sdk": "^0.56.0",
+    "@anthropic-ai/claude-code": "^2.1.107",
+    "@anthropic-ai/sdk": "^0.88.0",
     "@towles/shared": "workspace:*",
-    "citty": "^0.1.6",
+    "citty": "^0.2.2",
     "consola": "^3.4.2",
     "d3-hierarchy": "^3.1.2",
     "fzf": "^0.5.2",
-    "luxon": "^3.7.1",
+    "luxon": "^3.7.2",
     "neverthrow": "^8.2.0",
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2",
-    "zod": "^4.0.5"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/bun": "latest",
     "@types/d3-hierarchy": "^3.1.7",
-    "@types/luxon": "^3.6.2",
-    "@types/node": "^22.16.3",
+    "@types/luxon": "^3.7.1",
+    "@types/node": "^25.6.0",
     "@types/prompts": "^2.4.9",
-    "@typescript/native-preview": "^7.0.0-dev.20260111.1",
-    "bumpp": "^10.4.0",
-    "oxfmt": "^0.24.0",
-    "oxlint": "^1.7.0",
-    "simple-git-hooks": "^2.13.0",
-    "typescript": "^5.8.3",
-    "vitest": "^4.0.17"
+    "@typescript/native-preview": "^7.0.0-dev.20260414.1",
+    "bumpp": "^11.0.1",
+    "oxfmt": "^0.45.0",
+    "oxlint": "^1.60.0",
+    "simple-git-hooks": "^2.13.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
   },
   "bundledDependencies": [
     "@towles/shared"

package/packages/agentboard/apps/tui/package.json

@@ -12,8 +12,8 @@
   "dependencies": {
     "@babel/core": "^7.28.0",
     "@babel/preset-typescript": "^7.27.1",
-    "@opentui/core": "^0.1.88",
-    "@opentui/solid": "^0.1.88",
+    "@opentui/core": "^0.1.99",
+    "@opentui/solid": "^0.1.99",
     "@tt-agentboard/mux-tmux": "workspace:*",
     "@tt-agentboard/runtime": "workspace:*",
     "babel-plugin-module-resolver": "^5.0.2",

package/packages/agentboard/apps/tui/src/constants.ts

@@ -32,5 +32,7 @@ export function logResizeDebug(message: string, data?: Record<string, unknown>):
   const extra = data ? ` ${JSON.stringify(data)}` : "";
   try {
     appendFileSync(TUI_RESIZE_LOG, `[${ts}] [pid:${process.pid}] ${message}${extra}\n`);
-  } catch {}
+  } catch {
+    // intentionally ignored: debug log file write is best-effort
+  }
 }

package/packages/agentboard/apps/tui/src/index.tsx

@@ -360,7 +360,9 @@ function App() {
         if (startupFocusToPublish) {
           send({ type: "focus-session", name: startupFocusToPublish });
         }
-      } catch {}
+      } catch {
+        // intentionally ignored: socket setup errors are non-fatal at startup
+      }
     };
 
     socket.onclose = () => {

package/packages/agentboard/apps/tui/src/mux-context.ts

@@ -34,7 +34,9 @@ export function refocusMainPane(muxCtx: MuxContext): void {
         const paneId = main.split(" ")[0];
         Bun.spawnSync(["tmux", "select-pane", "-t", paneId], { stdout: "pipe", stderr: "pipe" });
       }
-    } catch {}
+    } catch {
+      // intentionally ignored: pane discovery is best-effort
+    }
   }
 }
 

package/packages/agentboard/packages/runtime/src/agents/watchers/amp.ts

@@ -129,13 +129,17 @@ export class AmpAgentWatcher implements AgentWatcher {
     if (this.fsWatcher) {
       try {
         this.fsWatcher.close();
-      } catch {}
+      } catch {
+        // intentionally ignored: watcher may already be closed during shutdown
+      }
       this.fsWatcher = null;
     }
     if (this.sessionWatcher) {
       try {
         this.sessionWatcher.close();
-      } catch {}
+      } catch {
+        // intentionally ignored: watcher may already be closed during shutdown
+      }
       this.sessionWatcher = null;
     }
     if (this.pollTimer) {

package/packages/agentboard/packages/runtime/src/agents/watchers/claude-code.ts

@@ -175,7 +175,9 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
     for (const w of this.fsWatchers) {
       try {
         w.close();
-      } catch {}
+      } catch {
+        // intentionally ignored: watcher may already be closed during shutdown
+      }
     }
     this.fsWatchers = [];
     if (this.pollTimer) {
@@ -211,7 +213,9 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
           try {
             const mtime = (await stat(filePath)).mtimeMs;
             if (Date.now() - mtime > JOURNAL_IDLE_TIMEOUT_MS) becomeIdle = true;
-          } catch {}
+          } catch {
+            // intentionally ignored: stat failure leaves becomeIdle unchanged
+          }
         }
 
         if (becomeIdle) {
@@ -271,7 +275,9 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
         try {
           const mtime = (await stat(filePath)).mtimeMs;
           if (Date.now() - mtime > JOURNAL_IDLE_TIMEOUT_MS) latestStatus = "idle";
-        } catch {}
+        } catch {
+          // intentionally ignored: stat failure leaves status unchanged
+        }
       }
 
       this.sessions.set(threadId, {
@@ -448,7 +454,9 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
       });
       this.fsWatchers.push(w);
       this.watchedDirs.add(dirPath);
-    } catch {}
+    } catch {
+      // intentionally ignored: watching dir is best-effort, will retry on next setup
+    }
   }
 
   private hasRecentFiles(dirPath: string): boolean {
@@ -461,9 +469,13 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
         try {
           const s = fs.statSync(join(dirPath, file));
           if (now - s.mtimeMs < STALE_MS) return true;
-        } catch {}
+        } catch {
+          // intentionally ignored: skip unreadable file
+        }
       }
-    } catch {}
+    } catch {
+      // intentionally ignored: dir unreadable, treat as no recent files
+    }
     return false;
   }
 
@@ -503,6 +515,8 @@ export class ClaudeCodeAgentWatcher implements AgentWatcher {
         this.watchDir(dirPath);
       });
       this.fsWatchers.push(w);
-    } catch {}
+    } catch {
+      // intentionally ignored: top-level watch is best-effort
+    }
   }
 }

package/packages/agentboard/packages/runtime/src/agents/watchers/codex.ts

@@ -212,7 +212,9 @@ export class CodexAgentWatcher implements AgentWatcher {
     if (this.fsWatcher) {
       try {
         this.fsWatcher.close();
-      } catch {}
+      } catch {
+        // intentionally ignored: watcher may already be closed during shutdown
+      }
       this.fsWatcher = null;
     }
     if (this.pollTimer) {
@@ -238,7 +240,9 @@ export class CodexAgentWatcher implements AgentWatcher {
         if (entry.id && entry.thread_name) {
           names.set(entry.id, entry.thread_name);
         }
-      } catch {}
+      } catch {
+        // intentionally ignored: skip malformed JSON line
+      }
     }
 
     this.threadNames = names;
@@ -359,6 +363,8 @@ export class CodexAgentWatcher implements AgentWatcher {
         if (!filename?.endsWith(".jsonl")) return;
         this.processFile(join(this.sessionsDir, filename));
       });
-    } catch {}
+    } catch {
+      // intentionally ignored: sessions dir watch is best-effort
+    }
   }
 }

package/packages/agentboard/packages/runtime/src/agents/watchers/opencode.ts

@@ -86,7 +86,9 @@ export class OpenCodeAgentWatcher implements AgentWatcher {
     }
     try {
       this.db?.close();
-    } catch {}
+    } catch {
+      // intentionally ignored: best-effort sqlite handle cleanup
+    }
     this.db = null;
     this.ctx = null;
   }
@@ -124,7 +126,9 @@ export class OpenCodeAgentWatcher implements AgentWatcher {
       } catch {
         try {
           this.db.close();
-        } catch {}
+        } catch {
+          // intentionally ignored: best-effort sqlite handle cleanup
+        }
         this.db = null;
         return;
       }
@@ -153,7 +157,9 @@ export class OpenCodeAgentWatcher implements AgentWatcher {
               for (const pr of partRows) {
                 try {
                   lastParts.push(JSON.parse(pr.data));
-                } catch {}
+                } catch {
+                  // intentionally ignored: skip malformed part JSON
+                }
               }
             }
           } catch {
@@ -164,7 +170,9 @@ export class OpenCodeAgentWatcher implements AgentWatcher {
           if (lastMsg) {
             try {
               lastMsgData = JSON.parse(lastMsg.data);
-            } catch {}
+            } catch {
+              // intentionally ignored: leave lastMsgData null on parse failure
+            }
           }
 
           const status = determineStatus(lastMsgData, lastParts);
@@ -211,7 +219,9 @@ export class OpenCodeAgentWatcher implements AgentWatcher {
             for (const pr of partRows) {
               try {
                 lastParts.push(JSON.parse(pr.data));
-              } catch {}
+              } catch {
+                // intentionally ignored: skip malformed part JSON
+              }
             }
           }
         } catch {
@@ -222,7 +232,9 @@ export class OpenCodeAgentWatcher implements AgentWatcher {
         if (lastMsg) {
           try {
             lastMsgData = JSON.parse(lastMsg.data);
-          } catch {}
+          } catch {
+            // intentionally ignored: leave lastMsgData null on parse failure
+          }
         }
 
         const status = determineStatus(lastMsgData, lastParts);

package/packages/agentboard/packages/runtime/src/debug.ts

@@ -15,5 +15,7 @@ export function debugLog(category: string, msg: string, data?: Record<string, un
   const line = `[${ts}] [${category}] ${msg}${extra}\n`;
   try {
     appendFileSync(DEBUG_LOG, line);
-  } catch {}
+  } catch {
+    // intentionally ignored: debug log file write is best-effort
+  }
 }

package/packages/agentboard/packages/runtime/src/server/index.ts

@@ -1,6 +1,9 @@
 import { readFileSync, unlinkSync, writeFileSync, appendFileSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
+
+import consola from "consola";
+
 import type { MuxProvider } from "../contracts/mux";
 import { isFullSidebarCapable, isBatchCapable } from "../contracts/mux";
 import type { AgentEvent } from "../contracts/agent";
@@ -40,7 +43,9 @@ function log(category: string, msg: string, data?: Record<string, unknown>) {
   const line = `[${ts}] [${category}] ${msg}${extra}\n`;
   try {
     appendFileSync(DEBUG_LOG, line);
-  } catch {}
+  } catch {
+    // intentionally ignored: debug log file write is best-effort
+  }
 }
 
 // shell, getGitInfo, invalidateGitCache imported from ./git-info
@@ -67,7 +72,9 @@ export function startServer(
   // Clear previous log on server start
   try {
     writeFileSync(DEBUG_LOG, "");
-  } catch {}
+  } catch {
+    // intentionally ignored: clearing debug log is best-effort
+  }
   log("server", "starting", { providers: allProviders.map((p) => p.name) });
 
   // Load initial theme from config
@@ -840,7 +847,9 @@ export function startServer(
       try {
         const data = JSON.parse(readFileSync(join(sessionsDir, `${agentPid}.json`), "utf-8"));
         if (data.sessionId === threadId) return pane.id;
-      } catch {}
+      } catch {
+        // intentionally ignored: Claude session file missing or malformed — try next pane
+      }
     }
     return undefined;
   }
@@ -870,7 +879,9 @@ export function startServer(
     } finally {
       try {
         db.close();
-      } catch {}
+      } catch {
+        // intentionally ignored: best-effort sqlite handle cleanup
+      }
     }
     return undefined;
   }
@@ -894,7 +905,9 @@ export function startServer(
         const logText = readFileSync(pathMatch[1], "utf-8");
         const match = logText.match(/ses_[A-Za-z0-9]+/);
         if (match?.[0] === threadId) return pane.id;
-      } catch {}
+      } catch {
+        // intentionally ignored: OpenCode log file unreadable — try next pane
+      }
     }
     return undefined;
   }
@@ -1189,7 +1202,9 @@ export function startServer(
           continue;
         }
       }
-    } catch {}
+    } catch {
+      // intentionally ignored: Claude projects dir missing or unreadable
+    }
     return {};
   }
 
@@ -1216,10 +1231,13 @@ export function startServer(
         .get(`pid:${agentPid}:%`);
       if (row?.thread_id) return { threadId: row.thread_id };
     } catch {
+      // intentionally ignored: Codex sqlite query failed — no thread info available
     } finally {
       try {
         db.close();
-      } catch {}
+      } catch {
+        // intentionally ignored: best-effort sqlite handle cleanup
+      }
     }
     return {};
   }
@@ -1498,7 +1516,9 @@ export function startServer(
     if (idleTimer) clearTimeout(idleTimer);
     try {
       unlinkSync(PID_FILE);
-    } catch {}
+    } catch {
+      // intentionally ignored: PID file may already be gone during shutdown
+    }
     for (const p of allProviders) p.cleanupHooks();
   }
 
@@ -1542,7 +1562,9 @@ export function startServer(
             const name = body.trim().replace(/^"+|"+$/g, "");
             if (name) handleFocus(name);
           }
-        } catch {}
+        } catch {
+          // intentionally ignored: malformed focus body is non-fatal, respond ok
+        }
         return new Response("ok", { status: 200 });
       }
 
@@ -1553,7 +1575,9 @@ export function startServer(
           log("http", "POST /toggle", { ctx });
           toggleSidebar(ctx);
           broadcastState();
-        } catch {}
+        } catch {
+          // intentionally ignored: malformed toggle body is non-fatal, respond ok
+        }
         return new Response("ok", { status: 200 });
       }
 
@@ -1573,7 +1597,9 @@ export function startServer(
           const ctx = parseContext(body) ?? undefined;
           log("http", "POST /switch-index", { index, ctx });
           switchToVisibleIndex(index, ctx?.clientTty);
-        } catch {}
+        } catch {
+          // intentionally ignored: malformed switch-index body is non-fatal, respond ok
+        }
         return new Response("ok", { status: 200 });
       }
 
@@ -1585,7 +1611,9 @@ export function startServer(
           // Debounce ensure-sidebar during rapid switching — intermediate sessions
           // don't need full sidebar validation immediately.
           debouncedEnsureSidebar(ctx ?? undefined);
-        } catch {}
+        } catch {
+          // intentionally ignored: malformed ensure-sidebar body is non-fatal, respond ok
+        }
         return new Response("ok", { status: 200 });
       }
 
@@ -1737,7 +1765,9 @@ export function startServer(
           const cmd = JSON.parse(msg as string) as ClientCommand;
           log("ws", "command", { type: cmd.type });
           handleCommand(cmd, ws);
-        } catch {}
+        } catch {
+          // intentionally ignored: malformed websocket command is non-fatal
+        }
       },
     },
   });
@@ -1775,5 +1805,5 @@ export function startServer(
   });
 
   const names = allProviders.map((p) => p.name).join(", ");
-  console.log(`agentboard server listening on ${SERVER_HOST}:${SERVER_PORT} (mux: ${names})`);
+  consola.info(`agentboard server listening on ${SERVER_HOST}:${SERVER_PORT} (mux: ${names})`);
 }

package/packages/agentboard/packages/runtime/src/server/launcher.ts

@@ -40,7 +40,9 @@ export async function ensureServer(): Promise<void> {
     // Stale PID file — remove before spawning a new server
     try {
       unlinkSync(PID_FILE);
-    } catch {}
+    } catch {
+      // intentionally ignored: PID file may already be gone
+    }
   }
 
   const proc = Bun.spawn(["tt", "agentboard", "server"], {

package/packages/agentboard/packages/runtime/src/server/pane-scanner.ts

@@ -170,7 +170,9 @@ function resolveClaudeCodeJournalInfo(threadId: string): {
         continue;
       }
     }
-  } catch {}
+  } catch {
+    // intentionally ignored: Claude projects dir missing or unreadable
+  }
   return {};
 }
 
@@ -197,10 +199,13 @@ function resolveCodexPaneInfo(
       .get(`pid:${agentPid}:%`);
     if (row?.thread_id) return { threadId: row.thread_id };
   } catch {
+    // intentionally ignored: Codex sqlite query failed — no thread info available
   } finally {
     try {
       db.close();
-    } catch {}
+    } catch {
+      // intentionally ignored: best-effort sqlite handle cleanup
+    }
   }
   return {};
 }

package/packages/shared/src/errors.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { AppError } from "./errors";
+
+describe("AppError", () => {
+  it("carries code and message", () => {
+    const err = new AppError("my_code", "boom");
+    expect(err.code).toBe("my_code");
+    expect(err.message).toBe("boom");
+    expect(err).toBeInstanceOf(Error);
+    expect(err).toBeInstanceOf(AppError);
+  });
+
+  it("uses the constructor name as the error name", () => {
+    class ChildError extends AppError {
+      constructor(message: string) {
+        super("child_code", message);
+      }
+    }
+    expect(new AppError("c", "m").name).toBe("AppError");
+    expect(new ChildError("m").name).toBe("ChildError");
+  });
+
+  it("forwards cause to the native Error.cause", () => {
+    const root = new Error("root");
+    const err = new AppError("wrapped", "outer", { cause: root });
+    expect(err.cause).toBe(root);
+  });
+
+  it("leaves cause undefined when not provided", () => {
+    const err = new AppError("nope", "no cause");
+    expect(err.cause).toBeUndefined();
+  });
+});

package/packages/shared/src/errors.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared error base class for towles-tool.
+ *
+ * Uses the native ES2022 `Error.cause` option so stack traces chain properly.
+ */
+export class AppError extends Error {
+  readonly code: string;
+
+  constructor(code: string, message: string, options?: { cause?: unknown }) {
+    super(message, options);
+    this.name = new.target.name;
+    this.code = code;
+  }
+}

package/packages/shared/src/index.ts

@@ -1,3 +1,4 @@
+export { AppError } from "./errors.js";
 export { ensureDir, fileExists, readFile, writeFile } from "./fs.js";
 export { getTerminalColumns, limitText, printWithHexColor } from "./render.js";
 export { formatDate, generateJournalFilename, getMondayOfWeek, getWeekInfo } from "./date-utils.js";

package/src/commands/agentboard.ts

@@ -199,7 +199,9 @@ function stopServer(): boolean {
   }
   try {
     unlinkSync(PID_FILE);
-  } catch {}
+  } catch {
+    // intentionally ignored: PID file may already be gone
+  }
   return true;
 }
 

package/src/commands/auto-claude/claude-cli.ts

@@ -1,11 +1,11 @@
 import { createInterface } from "node:readline";
 import { join } from "node:path";
 
-import consola from "consola";
 import pc from "picocolors";
 
-import { readFile } from "@towles/shared";
+import { AppError, readFile } from "@towles/shared";
 import { getConfig } from "./config.js";
+import { logger } from "./logger.js";
 import { sleep } from "./shell.js";
 import { spawnClaude as defaultSpawnClaude } from "./spawn-claude.js";
 import type { SpawnClaudeFn } from "./spawn-claude.js";
@@ -28,6 +28,13 @@ export interface ClaudeLogger {
   log: (...args: unknown[]) => void;
 }
 
+/** Raised when the Claude CLI process fails after all retries. */
+export class ClaudeProcessError extends AppError {
+  constructor(message: string, options?: { cause?: unknown }) {
+    super("claude_process_failed", message, options);
+  }
+}
+
 const PROCESS_RETRIES = 3;
 const PROCESS_RETRY_DELAY_MS = 5_000;
 
@@ -39,7 +46,7 @@ export async function runClaude(opts: {
 }): Promise<ClaudeResult> {
   const cfg = getConfig();
   const spawnFn = opts.spawnFn ?? defaultSpawnClaude;
-  const log = opts.logger ?? consola;
+  const log = opts.logger ?? logger;
   const args = [
     "-p",
     "--output-format",
@@ -61,7 +68,7 @@ export async function runClaude(opts: {
       `\n${pc.bold(pc.cyan("── System Prompt (CLAUDE.md) ──"))}\n${pc.dim(systemPrompt.trimEnd())}\n`,
     );
   } catch {
-    /* CLAUDE.md not present */
+    // intentionally ignored: CLAUDE.md is optional
   }
 
   try {
@@ -70,7 +77,7 @@ export async function runClaude(opts: {
       `\n${pc.bold(pc.cyan(`── Prompt (${opts.promptFile}) ──`))}\n${pc.dim(promptContent.trimEnd())}\n`,
     );
   } catch {
-    /* prompt file not present */
+    // intentionally ignored: prompt file preview is optional
   }
 
   let lastError: Error | undefined;
@@ -92,7 +99,9 @@ export async function runClaude(opts: {
       }
     }
   }
-  throw lastError ?? new Error("runClaude failed after all retries");
+  throw new ClaudeProcessError(`runClaude failed after ${PROCESS_RETRIES} attempts`, {
+    cause: lastError,
+  });
 }
 
 function logActivityEvent(event: ReturnType<typeof parseStreamLine>, log: ClaudeLogger): void {

package/src/commands/auto-claude/index.ts

@@ -3,7 +3,6 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 
 import { defineCommand } from "citty";
-import consola from "consola";
 
 import { debugArg } from "../shared.js";
 import { printExplain, printStepTemplate } from "./explain.js";
@@ -12,8 +11,9 @@ import { fetchIssue, fetchIssues } from "./steps/fetch-issues.js";
 import { getConfig, initConfig } from "./config.js";
 import { git } from "@towles/shared";
 import { runClaude } from "./claude-cli.js";
+import { logger } from "./logger.js";
 import { sleep } from "./shell.js";
-import { log, logBanner } from "./utils.js";
+import { logBanner } from "./utils.js";
 import type { IssueContext } from "./utils.js";
 import type { StepName } from "./prompt-templates/index.js";
 
@@ -104,7 +104,7 @@ export default defineCommand({
       try {
         printStepTemplate(args["step-template"] as string);
       } catch (e) {
-        consola.error(e instanceof Error ? e.message : String(e));
+        logger.error(e instanceof Error ? e.message : String(e));
         process.exit(1);
       }
       return;
@@ -125,7 +125,7 @@ export default defineCommand({
       });
 
       if (result.is_error) {
-        consola.error("Claude reported an error");
+        logger.error("Claude reported an error");
         process.exit(1);
       }
       return;
@@ -142,9 +142,9 @@ export default defineCommand({
     const resetIssue = args.reset ? Number(args.reset) : undefined;
     if (resetIssue) {
       const issueDir = join(process.cwd(), `.auto-claude/issue-${resetIssue}`);
-      log(`Resetting state for issue-${resetIssue}...`);
+      logger.info(`Resetting state for issue-${resetIssue}...`);
       rmSync(issueDir, { recursive: true, force: true });
-      log(`Cleaned ${issueDir}`);
+      logger.info(`Cleaned ${issueDir}`);
       return;
     }
 
@@ -155,7 +155,7 @@ export default defineCommand({
 
     if (loopMode) {
       registerShutdownHandlers();
-      log(`Loop mode — interval: ${intervalMs / 60_000}min, limit: ${limit}`);
+      logger.info(`Loop mode — interval: ${intervalMs / 60_000}min, limit: ${limit}`);
     }
 
     const issueNumber = args.issue ? Number(args.issue) : undefined;
@@ -172,16 +172,16 @@ export default defineCommand({
       try {
         await syncWithRemote();
       } catch (e) {
-        log(`Sync failed: ${e instanceof Error ? e.message : String(e)}`);
+        logger.warn(`Sync failed: ${e instanceof Error ? e.message : String(e)}`);
         if (loopMode) {
-          log(`Will retry in ${Math.round(intervalMs / 1000)}s...`);
+          logger.info(`Will retry in ${Math.round(intervalMs / 1000)}s...`);
           await sleep(intervalMs);
           continue;
         }
         throw e;
       }
 
-      log("Fetching labeled issues…");
+      logger.info("Fetching labeled issues…");
       let contexts: IssueContext[];
       if (issueNumber) {
         const ctx = await fetchIssue(issueNumber);
@@ -191,19 +191,19 @@ export default defineCommand({
       }
 
       if (contexts.length === 0) {
-        log("No issues to process.");
+        logger.info("No issues to process.");
       } else {
-        log(`Processing ${contexts.length} issue(s)...\n`);
+        logger.info(`Processing ${contexts.length} issue(s)...\n`);
 
         for (const ctx of contexts) {
           const issueStart = Date.now();
           try {
             await runPipeline(ctx, untilStep);
           } catch (e) {
-            consola.error(`Pipeline error for ${ctx.repo}#${ctx.number}:`, e);
+            logger.error(`Pipeline error for ${ctx.repo}#${ctx.number}:`, e);
           } finally {
             const elapsed = ((Date.now() - issueStart) / 1000).toFixed(1);
-            log(`Completed ${ctx.repo}#${ctx.number} in ${elapsed}s`);
+            logger.info(`Completed ${ctx.repo}#${ctx.number} in ${elapsed}s`);
           }
         }
       }
@@ -211,23 +211,23 @@ export default defineCommand({
       if (loopMode) {
         const waitMs = Math.max(0, intervalMs - (Date.now() - iterationStart));
         if (waitMs > 0) {
-          log(`Waiting ${Math.round(waitMs / 1000)}s until next iteration...`);
+          logger.info(`Waiting ${Math.round(waitMs / 1000)}s until next iteration...`);
           await sleep(waitMs);
         }
       }
     } while (loopMode);
 
-    log("Done.");
+    logger.info("Done.");
   },
 });
 
 async function syncWithRemote(): Promise<void> {
   const cfg = getConfig();
-  log("Syncing with remote...");
+  logger.info("Syncing with remote...");
   await git(["fetch", "--all", "--prune"]);
   const branch = await git(["rev-parse", "--abbrev-ref", "HEAD"]);
   if (branch !== cfg.mainBranch) {
-    log(`Warning: on branch "${branch}", switching to ${cfg.mainBranch}...`);
+    logger.warn(`On branch "${branch}", switching to ${cfg.mainBranch}...`);
     await git(["checkout", cfg.mainBranch]).catch(() => {
       // Best-effort checkout — may fail if working tree is dirty
     });
@@ -235,9 +235,9 @@ async function syncWithRemote(): Promise<void> {
   const status = await git(["status", "--porcelain"]);
   if (status.length > 0) {
     const files = status.trim().split("\n");
-    consola.warn(`Working tree has ${files.length} uncommitted change(s):`);
+    logger.warn(`Working tree has ${files.length} uncommitted change(s):`);
     for (const file of files) {
-      consola.warn(`  ${file.trim()}`);
+      logger.warn(`  ${file.trim()}`);
     }
   }
   await git(["pull", cfg.remote, cfg.mainBranch]);
@@ -246,7 +246,7 @@ async function syncWithRemote(): Promise<void> {
 function registerShutdownHandlers(): void {
   for (const signal of ["SIGINT", "SIGTERM"] as const) {
     process.on(signal, () => {
-      log(`Received ${signal}, shutting down...`);
+      logger.info(`Received ${signal}, shutting down...`);
       setTimeout(() => process.exit(1), 5_000).unref();
       git(["checkout", getConfig().mainBranch])
         .catch(() => {

package/src/commands/auto-claude/logger.ts

@@ -0,0 +1,3 @@
+import consola from "consola";
+
+export const logger = consola.withTag("auto-claude");

package/src/commands/auto-claude/pipeline.ts

@@ -9,8 +9,9 @@ import { stepImplement } from "./steps/implement.js";
 import { stepPlan, stepReview, stepSimplify } from "./steps/simple-steps.js";
 import { LABELS, ensureLabelsExist, removeLabel, setLabel } from "./labels.js";
 import type { ExecSafeFn } from "./labels.js";
+import { logger } from "./logger.js";
+
 import { ensureDir, execSafe, fileExists, ghRaw, git, readFile, writeFile } from "@towles/shared";
-import { log } from "./utils.js";
 import type { IssueContext } from "./utils.js";
 import type { SpawnClaudeFn } from "./spawn-claude.js";
 
@@ -29,14 +30,14 @@ export async function runPipeline(
   const cfg = getConfig();
   const exec = deps?.exec;
   const spawnFn = deps?.spawnFn;
-  log(`Pipeline starting for ${ctx.repo}#${ctx.number}: ${ctx.title}`);
+  logger.info(`Pipeline starting for ${ctx.repo}#${ctx.number}: ${ctx.title}`);
 
   ensureDir(ctx.issueDir);
   const ramblingsPath = join(ctx.issueDir, ARTIFACTS.initialRamblings);
   if (!fileExists(ramblingsPath)) {
     const content = `# ${ctx.title}\n\n> ${ctx.repo}#${ctx.number}\n\n${ctx.body ?? ""}`;
     writeFile(ramblingsPath, content);
-    log("Saved initial-ramblings.md");
+    logger.info("Saved initial-ramblings.md");
   }
 
   // Label management
@@ -51,7 +52,7 @@ export async function runPipeline(
       return;
     }
     if (untilStep === "plan") {
-      log(`Pipeline paused after "plan" (--until plan)`);
+      logger.info(`Pipeline paused after "plan" (--until plan)`);
       return;
     }
 
@@ -71,7 +72,7 @@ export async function runPipeline(
         return;
       }
       if (untilStep === "implement") {
-        log(`Pipeline paused after "implement" (--until implement)`);
+        logger.info(`Pipeline paused after "implement" (--until implement)`);
         return;
       }
 
@@ -81,7 +82,7 @@ export async function runPipeline(
         return;
       }
       if (untilStep === "simplify") {
-        log(`Pipeline paused after "simplify" (--until simplify)`);
+        logger.info(`Pipeline paused after "simplify" (--until simplify)`);
         return;
       }
 
@@ -91,7 +92,7 @@ export async function runPipeline(
         return;
       }
       if (untilStep === "review") {
-        log(`Pipeline paused after "review" (--until review)`);
+        logger.info(`Pipeline paused after "review" (--until review)`);
         return;
       }
 
@@ -101,13 +102,13 @@ export async function runPipeline(
         await removeLabel(ctx.repo, ctx.number, LABELS.inProgress, exec);
         await setLabel(ctx.repo, ctx.number, LABELS.success, exec);
         await setLabel(ctx.repo, ctx.number, LABELS.review, exec);
-        log(`Pipeline complete for ${ctx.repo}#${ctx.number} — ${prUrl}`);
+        logger.info(`Pipeline complete for ${ctx.repo}#${ctx.number} — ${prUrl}`);
         return;
       }
 
       // Review failed
       if (attempt < maxRetries) {
-        log(
+        logger.warn(
           `Review did not pass (attempt ${attempt + 1}/${maxRetries + 1}), retrying implement→simplify→review…`,
         );
       }
@@ -151,7 +152,7 @@ async function handleFailure(
       exec,
     );
   }
-  log(`Pipeline stopped at "${stepName}" for ${ctx.repo}#${ctx.number}`);
+  logger.info(`Pipeline stopped at "${stepName}" for ${ctx.repo}#${ctx.number}`);
 }
 
 async function checkoutMain(): Promise<void> {
@@ -165,7 +166,7 @@ async function checkoutMain(): Promise<void> {
     const idx = lines.findIndex((l) => l.includes("auto-claude: before switching to"));
     if (idx >= 0) {
       await execSafe("git", ["stash", "pop", `stash@{${idx}}`]);
-      log("Restored stashed changes");
+      logger.info("Restored stashed changes");
     }
   }
 }

package/src/commands/auto-claude/steps/create-pr.ts

@@ -1,11 +1,9 @@
 import { join } from "node:path";
 
-import consola from "consola";
-
 import { execSafe, fileExists, ghRaw, git, readFile, writeFile } from "@towles/shared";
 import { getConfig } from "../config.js";
+import { logger } from "../logger.js";
 import { ARTIFACTS } from "../prompt-templates/index.js";
-import { log } from "../utils.js";
 import type { IssueContext } from "../utils.js";
 import type { ExecSafeFn } from "../labels.js";
 
@@ -14,7 +12,7 @@ export async function createPr(ctx: IssueContext, exec?: ExecSafeFn): Promise<st
 
   const existingUrl = await getExistingPrUrl(ctx.branch, exec);
   if (existingUrl) {
-    log(`PR already exists: ${existingUrl}`);
+    logger.info(`PR already exists: ${existingUrl}`);
     return existingUrl;
   }
 
@@ -68,12 +66,12 @@ export async function createPr(ctx: IssueContext, exec?: ExecSafeFn): Promise<st
   }
 
   writeFile(join(ctx.issueDir, ARTIFACTS.prUrl), prUrl);
-  log(`PR created: ${prUrl}`);
+  logger.info(`PR created: ${prUrl}`);
 
   try {
     await attachArtifacts(ctx, prUrl, exec);
   } catch (e) {
-    consola.warn(`Artifact upload failed (non-blocking): ${e}`);
+    logger.warn(`Artifact upload failed (non-blocking): ${e}`);
   }
 
   return prUrl;
@@ -84,7 +82,7 @@ async function attachArtifacts(ctx: IssueContext, prUrl: string, exec?: ExecSafe
   const tag = `ac-issue-${ctx.number}`;
   const cfg = getConfig();
 
-  log("Archiving pipeline artifacts…");
+  logger.info("Archiving pipeline artifacts…");
   await execSafe("tar", [
     "czf",
     archivePath,
@@ -95,7 +93,7 @@ async function attachArtifacts(ctx: IssueContext, prUrl: string, exec?: ExecSafe
     ".",
   ]);
 
-  log("Uploading artifacts to GitHub release…");
+  logger.info("Uploading artifacts to GitHub release…");
   await ghRaw(["release", "delete", tag, "--yes", "--repo", cfg.repo], exec);
 
   await ghRaw(
@@ -119,7 +117,7 @@ async function attachArtifacts(ctx: IssueContext, prUrl: string, exec?: ExecSafe
   );
 
   if (!assetUrl) {
-    consola.warn("Could not get artifact download URL — skipping PR comment");
+    logger.warn("Could not get artifact download URL — skipping PR comment");
     return;
   }
 
@@ -154,7 +152,7 @@ async function getExistingPrUrl(branch: string, exec?: ExecSafeFn): Promise<stri
     const prs = JSON.parse(out) as Array<{ url: string }>;
     return prs.length > 0 ? prs[0].url : null;
   } catch {
-    consola.debug(`Failed to parse PR list JSON for branch "${branch}"`);
+    logger.debug(`Failed to parse PR list JSON for branch "${branch}"`);
     return null;
   }
 }

package/src/commands/auto-claude/steps/fetch-issues.ts

@@ -1,7 +1,7 @@
-import consola from "consola";
-import { getConfig } from "../config.js";
 import { gh } from "@towles/shared";
-import { buildIssueContext, log } from "../utils.js";
+import { getConfig } from "../config.js";
+import { logger } from "../logger.js";
+import { buildIssueContext } from "../utils.js";
 import type { IssueContext } from "../utils.js";
 
 interface GhIssue {
@@ -14,7 +14,7 @@ interface GhIssue {
 export async function fetchIssues(limit?: number): Promise<IssueContext[]> {
   const cfg = getConfig();
 
-  log(`Scanning ${cfg.repo} for issues labeled "${cfg.triggerLabel}"...`);
+  logger.info(`Scanning ${cfg.repo} for issues labeled "${cfg.triggerLabel}"...`);
 
   let issues: GhIssue[];
   try {
@@ -31,16 +31,16 @@ export async function fetchIssues(limit?: number): Promise<IssueContext[]> {
       "number,title,body,labels",
     ]);
   } catch (e) {
-    log(`Warning: could not fetch issues from ${cfg.repo}: ${e}`);
+    logger.warn(`Could not fetch issues from ${cfg.repo}: ${e}`);
     return [];
   }
 
   if (issues.length === 0) {
-    log("No issues found.");
+    logger.info("No issues found.");
     return [];
   }
 
-  log(`Found ${issues.length} issue(s).`);
+  logger.info(`Found ${issues.length} issue(s).`);
 
   const selected = limit != null ? issues.slice(0, limit) : issues;
   return selected.map((issue) => buildIssueContext(issue, cfg.repo, cfg.scopePath));
@@ -61,7 +61,7 @@ export async function fetchIssue(issueNumber: number): Promise<IssueContext | un
     ]);
     return buildIssueContext(issue, cfg.repo, cfg.scopePath);
   } catch {
-    consola.debug(`Could not fetch issue #${issueNumber} from ${cfg.repo}`);
+    logger.debug(`Could not fetch issue #${issueNumber} from ${cfg.repo}`);
     return undefined;
   }
 }

package/src/commands/auto-claude/steps/implement.ts

@@ -1,13 +1,12 @@
 import { join } from "node:path";
 
-import consola from "consola";
-
 import { getConfig } from "../config.js";
 import { ARTIFACTS, STEP_LABELS, TEMPLATES } from "../prompt-templates/index.js";
 import { fileExists, git, readFile } from "@towles/shared";
 import { runClaude } from "../claude-cli.js";
+import { logger } from "../logger.js";
 import { resolveTemplate } from "../templates.js";
-import { buildTokens, log, logStep } from "../utils.js";
+import { buildTokens, logStep } from "../utils.js";
 import type { IssueContext } from "../utils.js";
 import type { SpawnClaudeFn } from "../spawn-claude.js";
 
@@ -28,7 +27,7 @@ export async function stepImplement(ctx: IssueContext, spawnFn?: SpawnClaudeFn):
   const reviewFeedback = fileExists(reviewPath) ? readFile(reviewPath) : "";
 
   for (let i = 1; i <= maxIterations; i++) {
-    log(`Implementation iteration ${i}/${maxIterations}`);
+    logger.info(`Implementation iteration ${i}/${maxIterations}`);
 
     const tokens = buildTokens(ctx, { REVIEW_FEEDBACK: reviewFeedback });
     const promptFile = resolveTemplate(TEMPLATES.implement, tokens, ctx.issueDir);
@@ -40,18 +39,18 @@ export async function stepImplement(ctx: IssueContext, spawnFn?: SpawnClaudeFn):
     });
 
     if (result.is_error) {
-      consola.error(`Implement iteration ${i} failed: ${result.result}`);
+      logger.error(`Implement iteration ${i} failed: ${result.result}`);
       return false;
     }
 
     if (fileExists(completedPath)) {
-      log(`Implementation complete after ${i} iteration(s)`);
+      logger.info(`Implementation complete after ${i} iteration(s)`);
       return true;
     }
 
-    log(`Iteration ${i} finished but completed-summary.md not yet created — tasks remain`);
+    logger.warn(`Iteration ${i} finished but completed-summary.md not yet created — tasks remain`);
   }
 
-  consola.error(`Implementation did not complete after ${maxIterations} iterations`);
+  logger.error(`Implementation did not complete after ${maxIterations} iterations`);
   return false;
 }

package/src/commands/auto-claude/utils.ts

@@ -14,6 +14,7 @@ import {
 } from "@towles/shared";
 import { runClaude } from "./claude-cli.js";
 import { getConfig } from "./config.js";
+import { logger } from "./logger.js";
 import { ARTIFACTS } from "./prompt-templates/index.js";
 import { resolveTemplate } from "./templates.js";
 
@@ -100,10 +101,6 @@ function findNthBlankLine(lines: string[], n: number): number {
 
 // ── Logging ──
 
-export function log(msg: string): void {
-  consola.info(`[auto-claude] ${msg}`);
-}
-
 export function logBanner(label: string, width = 60): void {
   const inner = `  ${label}  `;
   const totalDashes = Math.max(0, width - inner.length - 2);
@@ -131,7 +128,7 @@ export async function ensureBranch(branch: string): Promise<void> {
   const hadDirtyTree = status.ok && status.stdout.length > 0;
   if (hadDirtyTree) {
     await git(["stash", "push", "-m", `auto-claude: before switching to ${branch}`]);
-    log("Stashed uncommitted changes");
+    logger.info("Stashed uncommitted changes");
   }
 
   // Check if branch exists locally (rev-parse is reliable, no output parsing)
@@ -147,7 +144,7 @@ export async function ensureBranch(branch: string): Promise<void> {
     await git(["checkout", branch]);
     return;
   } catch {
-    /* doesn't exist remotely */
+    // intentionally ignored: branch doesn't exist remotely, fall through to create it
   }
 
   // Create new branch from main
@@ -195,12 +192,12 @@ export async function runStepWithArtifact(opts: StepRunnerOptions): Promise<bool
   });
 
   if (result.is_error) {
-    consola.error(`${stepName} step failed: ${result.result}`);
+    logger.error(`${stepName} step failed: ${result.result}`);
     return false;
   }
 
   if (!isValid(artifactPath)) {
-    consola.error(`${stepName} step did not produce expected artifact`);
+    logger.error(`${stepName} step did not produce expected artifact`);
     return false;
   }
 

package/src/commands/graph/analyzer.test.ts

@@ -18,7 +18,7 @@ function textBlock(text: string): ContentBlock {
 }
 
 function toolUseBlock(name: string, input: Record<string, unknown>): ContentBlock {
-  return { type: "tool_use" as const, id: "tool-stub", name, input };
+  return { type: "tool_use" as const, id: "tool-stub", name, input, caller: { type: "direct" } };
 }
 
 function makeUsage(overrides: Partial<Usage> = {}): Usage {
@@ -27,6 +27,8 @@ function makeUsage(overrides: Partial<Usage> = {}): Usage {
     output_tokens: 0,
     cache_read_input_tokens: null,
     cache_creation_input_tokens: null,
+    cache_creation: null,
+    inference_geo: null,
     server_tool_use: null,
     service_tier: null,
     ...overrides,

package/src/commands/graph.test.ts

@@ -11,6 +11,8 @@ function makeUsage(overrides: Partial<Usage> = {}): Usage {
     output_tokens: 0,
     cache_read_input_tokens: null,
     cache_creation_input_tokens: null,
+    cache_creation: null,
+    inference_geo: null,
     server_tool_use: null,
     service_tier: null,
     ...overrides,

package/src/commands/journal/list.ts

@@ -33,6 +33,7 @@ export function collectJournalEntries(files: string[], baseDir: string): Journal
     try {
       size = statSync(filePath).size;
     } catch {
+      // intentionally ignored: skip files that can't be stat'd (deleted, permission)
       continue;
     }
     entries.push({
@@ -204,7 +205,7 @@ export default defineCommand({
       }
 
       consola.info(`Showing ${colors.green(String(result.length))} journal entries:\n`);
-      console.log(renderTable(result));
+      consola.log(renderTable(result));
     } catch (error) {
       consola.error("Failed to list journal entries:", error);
       process.exit(1);

package/src/commands/journal/search.ts

@@ -240,12 +240,12 @@ export default defineCommand({
 
       for (const [filePath, fileMatches] of byFile) {
         const relative = path.relative(baseFolder, filePath);
-        console.log(colors.bold(colors.cyan(relative)));
+        consola.log(colors.bold(colors.cyan(relative)));
         for (const m of fileMatches) {
           for (const line of m.context) {
-            console.log(line);
+            consola.log(line);
           }
-          console.log("");
+          consola.log("");
         }
       }
     } catch (error) {