@towles/tool 0.0.127 → 0.0.129

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) {