bisync-cli 0.0.3 → 0.0.5

package/dist/bisync.js

@@ -2,19 +2,19 @@
 // @bun
 
 // src/bin.ts
+import { createWriteStream, mkdirSync } from "fs";
 import { readdir, stat } from "fs/promises";
 import { homedir } from "os";
 import { join, resolve } from "path";
 // package.json
-var version = "0.0.3";
+var version = "0.0.4";
 
 // src/bin.ts
 var CONFIG_DIR = join(homedir(), ".agent-bisync");
 var CONFIG_PATH = join(CONFIG_DIR, "config.json");
 var CLAUDE_SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
 var CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
-var DEBUG_DIR = join(homedir(), ".bysync");
-var DEBUG_LOG_PATH = join(DEBUG_DIR, "debug.log");
+var DEBUG_LOG_PATH = join(CONFIG_DIR, "debug.log");
 var CLIENT_ID = "bisync-cli";
 var MAX_LINES_PER_BATCH = 200;
 var sleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
@@ -25,8 +25,36 @@ Commands:
   setup --site-url <url>   Configure hooks and authenticate
   verify                   Check auth and list session ids
   hook <HOOK>              Handle Claude hook input (stdin JSON)
+
+Global options:
+  --verbose                Enable verbose logging
 `);
 };
+var LOG_LEVEL = "info";
+var debugLogStream = null;
+var getDebugLogStream = () => {
+  if (debugLogStream)
+    return debugLogStream;
+  try {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    debugLogStream = createWriteStream(DEBUG_LOG_PATH, { flags: "a" });
+    debugLogStream.on("error", () => {
+      debugLogStream = null;
+    });
+    return debugLogStream;
+  } catch {
+    return null;
+  }
+};
+var log = (level, message) => {
+  const logMessage = `[bisync][${level}] ${message}`;
+  getDebugLogStream()?.write(`[${new Date().toISOString()}] ${logMessage}
+`);
+  if (level < LOG_LEVEL) {
+    return;
+  }
+  console.log(logMessage);
+};
 var readConfig = async () => {
   return await Bun.file(CONFIG_PATH).json();
 };
@@ -40,16 +68,22 @@ var resolveSiteUrl = (args) => {
   const argValue = argIndex >= 0 ? args[argIndex + 1] : undefined;
   const envValue = process.env.BISYNC_SITE_URL;
   if (argValue) {
-    return argValue;
+    return { siteUrl: argValue, source: "arg" };
   }
   if (envValue) {
-    return envValue;
+    return { siteUrl: envValue, source: "env" };
   }
   const viteConvexUrl = process.env.VITE_CONVEX_URL;
   if (viteConvexUrl?.endsWith(".convex.cloud")) {
-    return viteConvexUrl.replace(".convex.cloud", ".convex.site");
+    return {
+      siteUrl: viteConvexUrl.replace(".convex.cloud", ".convex.site"),
+      source: "vite"
+    };
   }
-  return viteConvexUrl ?? null;
+  if (viteConvexUrl) {
+    return { siteUrl: viteConvexUrl, source: "vite" };
+  }
+  return { siteUrl: null, source: "missing" };
 };
 var openBrowser = async (url) => {
   if (process.platform !== "darwin") {
@@ -60,6 +94,7 @@ var openBrowser = async (url) => {
   } catch {}
 };
 var deviceAuthFlow = async (siteUrl) => {
+  log("debug", `device auth start siteUrl=${siteUrl}`);
   const codeResponse = await fetch(`${siteUrl}/api/auth/device/code`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -67,14 +102,17 @@ var deviceAuthFlow = async (siteUrl) => {
   });
   if (!codeResponse.ok) {
     const errorText = await codeResponse.text();
+    log("debug", `device code request failed status=${codeResponse.status}`);
     throw new Error(`Device code request failed: ${codeResponse.status} ${errorText}`);
   }
+  log("debug", `device code request ok status=${codeResponse.status}`);
   const codeData = await codeResponse.json();
   const verificationUrl = codeData.verification_uri_complete ?? codeData.verification_uri;
-  console.log(`Authorize this device: ${verificationUrl}`);
-  console.log(`User code: ${codeData.user_code}`);
+  log("info", `Authorize this device: ${verificationUrl}`);
+  log("info", `User code: ${codeData.user_code}`);
   await openBrowser(verificationUrl);
   const intervalMs = Math.max(1, codeData.interval ?? 5) * 1000;
+  log("debug", `device auth polling intervalMs=${intervalMs}`);
   let pollDelay = intervalMs;
   while (true) {
     await sleep(pollDelay);
@@ -89,6 +127,7 @@ var deviceAuthFlow = async (siteUrl) => {
     });
     const tokenData = await tokenResponse.json();
     if (tokenResponse.ok && tokenData.access_token) {
+      log("debug", `device auth success status=${tokenResponse.status}`);
       return tokenData.access_token;
     }
     if (tokenData.error === "authorization_pending") {
@@ -96,8 +135,10 @@ var deviceAuthFlow = async (siteUrl) => {
     }
     if (tokenData.error === "slow_down") {
       pollDelay += 1000;
+      log("debug", `device auth slow_down nextDelayMs=${pollDelay}`);
       continue;
     }
+    log("debug", `device auth failed status=${tokenResponse.status} error=${tokenData.error ?? "unknown"}`);
     throw new Error(`Device auth failed: ${tokenData.error ?? "unknown"} ${tokenData.error_description ?? ""}`.trim());
   }
 };
@@ -118,7 +159,20 @@ var ensureHookEntry = (entries, next) => {
   return entries;
 };
 var mergeSettings = async () => {
-  const current = await Bun.file(CLAUDE_SETTINGS_PATH).json().catch(() => ({}));
+  log("debug", `mergeSettings path=${CLAUDE_SETTINGS_PATH}`);
+  const settingsFile = Bun.file(CLAUDE_SETTINGS_PATH);
+  const settingsExists = await settingsFile.exists();
+  log("debug", `mergeSettings existing=${settingsExists}`);
+  let current = {};
+  if (settingsExists) {
+    try {
+      current = await settingsFile.json();
+      log("debug", `mergeSettings read ok`);
+    } catch (error) {
+      log("debug", `mergeSettings read failed: ${error instanceof Error ? error.message : String(error)}`);
+      current = {};
+    }
+  }
   const hooks = current.hooks ?? {};
   const definitions = [
     { name: "SessionStart" },
@@ -144,6 +198,13 @@ var mergeSettings = async () => {
   await Bun.write(CLAUDE_SETTINGS_PATH, JSON.stringify(nextConfig, null, 2), {
     createPath: true
   });
+  log("debug", `mergeSettings wrote settings`);
+  try {
+    const info = await stat(CLAUDE_SETTINGS_PATH);
+    log("debug", `mergeSettings file size=${info.size} mtime=${new Date(info.mtimeMs).toISOString()}`);
+  } catch (error) {
+    log("debug", `mergeSettings stat failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
 };
 var findSessionFile = async (sessionId) => {
   let bestPath = null;
@@ -178,7 +239,7 @@ var findSessionFile = async (sessionId) => {
 var appendDebugLog = async (message) => {
   const logFile = Bun.file(DEBUG_LOG_PATH);
   const content = await logFile.text();
-  await logFile.write(content + message);
+  await Bun.write(DEBUG_LOG_PATH, content + message, { createPath: true });
 };
 var buildLogLines = (raw) => {
   const lines = raw.split(`
@@ -221,33 +282,48 @@ var uploadLogs = async (siteUrl, token, sessionId, raw) => {
   }
 };
 var runSetup = async (args) => {
+  log("debug", `runSetup start`);
   const force = args.includes("--force");
+  log("debug", `runSetup force=${force}`);
   const configExists = await Bun.file(CONFIG_PATH).exists();
+  log("debug", `config path=${CONFIG_PATH} exists=${configExists}`);
   let existingConfig = null;
   if (configExists) {
     try {
       existingConfig = await readConfig();
+      log("debug", `config loaded siteUrl=${existingConfig.siteUrl} token=${existingConfig.token ? "present" : "missing"}`);
     } catch {
+      log("debug", `config load failed; continuing without existing config`);
       existingConfig = null;
     }
   }
-  const siteUrl = resolveSiteUrl(args) ?? existingConfig?.siteUrl ?? null;
+  const resolution = resolveSiteUrl(args);
+  log("debug", `siteUrl resolved=${resolution.siteUrl ?? "null"} source=${resolution.source}`);
+  const siteUrl = resolution.siteUrl ?? existingConfig?.siteUrl ?? null;
+  if (!resolution.siteUrl && existingConfig?.siteUrl) {
+    log("debug", `siteUrl fallback to existing config ${existingConfig.siteUrl}`);
+  }
   if (!siteUrl) {
+    log("debug", `runSetup aborted: missing siteUrl`);
     throw new Error("Missing site URL. Provide --site-url or BISYNC_SITE_URL.");
   }
   if (configExists && existingConfig?.token && !force) {
+    log("debug", `using existing token; updating Claude settings only`);
     await mergeSettings();
-    console.log(`Updated Claude settings using existing credentials at ${CONFIG_PATH}`);
+    log("info", `Updated Claude settings using existing credentials at ${CONFIG_PATH}`);
     return;
   }
   const token = await deviceAuthFlow(siteUrl);
   await writeConfig({ siteUrl, token, clientId: CLIENT_ID });
+  log("debug", `config written to ${CONFIG_PATH}`);
   await mergeSettings();
-  console.log(`Configured Claude settings and saved credentials to ${CONFIG_PATH}`);
+  log("info", `Configured Claude settings and saved credentials to ${CONFIG_PATH}`);
 };
 var runVerify = async () => {
+  log("debug", `runVerify start config=${CONFIG_PATH}`);
   const config = await readConfig();
   const siteUrl = process.env.BISYNC_SITE_URL ?? config.siteUrl;
+  log("debug", `runVerify siteUrl=${siteUrl}`);
   const response = await fetch(`${siteUrl}/api/list-sessions`, {
     method: "GET",
     headers: {
@@ -256,18 +332,20 @@ var runVerify = async () => {
   });
   if (!response.ok) {
     const errorText = await response.text();
+    log("debug", `runVerify failed status=${response.status}`);
     throw new Error(`Verify failed: ${response.status} ${errorText}`);
   }
   const data = await response.json();
   if (data.sessions.length === 0) {
-    console.log("No sessions found.");
+    log("info", "No sessions found.");
     return;
   }
   for (const session of data.sessions) {
-    console.log(session.externalId);
+    log("info", session.externalId);
   }
 };
 var runHook = async (hookName) => {
+  log("debug", `runHook start hook=${hookName}`);
   const stdinRaw = await new Promise((resolve2, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
@@ -294,6 +372,7 @@ var runHook = async (hookName) => {
   const config = await readConfig();
   const siteUrl = process.env.BISYNC_SITE_URL ?? config.siteUrl;
   const token = config.token;
+  log("debug", `runHook siteUrl=${siteUrl}`);
   let sessionFile = null;
   if (typeof stdinPayload.transcript_path === "string") {
     const resolvedPath = resolve(stdinPayload.transcript_path);
@@ -305,19 +384,24 @@ var runHook = async (hookName) => {
     sessionFile = await findSessionFile(sessionId);
   }
   if (!sessionFile) {
+    log("debug", `runHook session file missing sessionId=${sessionId}`);
     await appendDebugLog(`[${new Date().toISOString()}] hook=${hookName} error=session-file-not-found session_id=${sessionId}
 `);
     return;
   }
+  log("debug", `runHook sessionFile=${sessionFile}`);
   const raw = await Bun.file(sessionFile).text();
   if (!raw.trim()) {
+    log("debug", `runHook session file empty sessionId=${sessionId}`);
     await appendDebugLog(`[${new Date().toISOString()}] hook=${hookName} error=empty-log session_id=${sessionId}
 `);
     return;
   }
   try {
     await uploadLogs(siteUrl, token, sessionId, raw);
+    log("debug", `runHook upload ok sessionId=${sessionId}`);
   } catch (error) {
+    log("debug", `runHook upload failed sessionId=${sessionId} message=${error instanceof Error ? error.message : String(error)}`);
     await appendDebugLog(`[${new Date().toISOString()}] hook=${hookName} error=upload-failed session_id=${sessionId} message=${error instanceof Error ? error.message : String(error)}
 `);
   }
@@ -327,7 +411,12 @@ var main = async () => {
     console.log(`\u25B6\uFE0E ${version} (Bun ${Bun.version})`);
     process.exit(0);
   }
-  const [command, ...args] = process.argv.slice(2);
+  if (process.argv.includes("--verbose")) {
+    LOG_LEVEL = "debug";
+  }
+  const rawArgs = process.argv.slice(2);
+  const [command, ...args] = rawArgs;
+  log("debug", `argv=${JSON.stringify(rawArgs)}`);
   if (!command) {
     usage();
     process.exit(1);
@@ -348,7 +437,7 @@ var main = async () => {
     usage();
     process.exit(1);
   } catch (error) {
-    console.error(error instanceof Error ? error.message : error);
+    log("error", error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bisync-cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "bin": {
     "bisync": "dist/bisync.js"
   },

package/src/bin.ts

@@ -2,7 +2,9 @@
 /// <reference types="bun" />
 
 import type { Dirent } from "node:fs";
+import type { WriteStream } from "node:fs";
 
+import { createWriteStream, mkdirSync } from "node:fs";
 import { readdir, stat } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
@@ -13,8 +15,7 @@ const CONFIG_DIR = join(homedir(), ".agent-bisync");
 const CONFIG_PATH = join(CONFIG_DIR, "config.json");
 const CLAUDE_SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
 const CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
-const DEBUG_DIR = join(homedir(), ".bysync");
-const DEBUG_LOG_PATH = join(DEBUG_DIR, "debug.log");
+const DEBUG_LOG_PATH = join(CONFIG_DIR, "debug.log");
 const CLIENT_ID = "bisync-cli";
 const MAX_LINES_PER_BATCH = 200;
 
@@ -24,6 +25,11 @@ type Config = {
   clientId: string;
 };
 
+type SiteUrlResolution = {
+  siteUrl: string | null;
+  source: "arg" | "env" | "vite" | "missing";
+};
+
 const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
 
 const usage = () => {
@@ -33,9 +39,39 @@ Commands:
   setup --site-url <url>   Configure hooks and authenticate
   verify                   Check auth and list session ids
   hook <HOOK>              Handle Claude hook input (stdin JSON)
+
+Global options:
+  --verbose                Enable verbose logging
 `);
 };
 
+let LOG_LEVEL = "info";
+let debugLogStream: WriteStream | null = null;
+
+const getDebugLogStream = (): WriteStream | null => {
+  if (debugLogStream) return debugLogStream;
+  try {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    debugLogStream = createWriteStream(DEBUG_LOG_PATH, { flags: "a" });
+    debugLogStream.on("error", () => {
+      // Silently discard write errors to avoid breaking the CLI.
+      debugLogStream = null;
+    });
+    return debugLogStream;
+  } catch {
+    return null;
+  }
+};
+
+const log = (level: "debug" | "info" | "warn" | "error", message: string) => {
+  const logMessage = `[bisync][${level}] ${message}`;
+  getDebugLogStream()?.write(`[${new Date().toISOString()}] ${logMessage}\n`);
+  if (level < LOG_LEVEL) {
+    return;
+  }
+  console.log(logMessage);
+};
+
 const readConfig = async (): Promise<Config> => {
   return await Bun.file(CONFIG_PATH).json();
 };
@@ -46,21 +82,27 @@ const writeConfig = async (config: Config) => {
   });
 };
 
-const resolveSiteUrl = (args: string[]) => {
+const resolveSiteUrl = (args: string[]): SiteUrlResolution => {
   const argIndex = args.findIndex((value) => value === "--site-url" || value === "--siteUrl");
   const argValue = argIndex >= 0 ? args[argIndex + 1] : undefined;
   const envValue = process.env.BISYNC_SITE_URL;
   if (argValue) {
-    return argValue;
+    return { siteUrl: argValue, source: "arg" };
   }
   if (envValue) {
-    return envValue;
+    return { siteUrl: envValue, source: "env" };
   }
   const viteConvexUrl = process.env.VITE_CONVEX_URL;
   if (viteConvexUrl?.endsWith(".convex.cloud")) {
-    return viteConvexUrl.replace(".convex.cloud", ".convex.site");
+    return {
+      siteUrl: viteConvexUrl.replace(".convex.cloud", ".convex.site"),
+      source: "vite",
+    };
+  }
+  if (viteConvexUrl) {
+    return { siteUrl: viteConvexUrl, source: "vite" };
   }
-  return viteConvexUrl ?? null;
+  return { siteUrl: null, source: "missing" };
 };
 
 const openBrowser = async (url: string) => {
@@ -75,6 +117,7 @@ const openBrowser = async (url: string) => {
 };
 
 const deviceAuthFlow = async (siteUrl: string) => {
+  log("debug", `device auth start siteUrl=${siteUrl}`);
   const codeResponse = await fetch(`${siteUrl}/api/auth/device/code`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -83,9 +126,12 @@ const deviceAuthFlow = async (siteUrl: string) => {
 
   if (!codeResponse.ok) {
     const errorText = await codeResponse.text();
+    log("debug", `device code request failed status=${codeResponse.status}`);
     throw new Error(`Device code request failed: ${codeResponse.status} ${errorText}`);
   }
 
+  log("debug", `device code request ok status=${codeResponse.status}`);
+
   const codeData: {
     device_code: string;
     user_code: string;
@@ -95,11 +141,12 @@ const deviceAuthFlow = async (siteUrl: string) => {
   } = await codeResponse.json();
 
   const verificationUrl = codeData.verification_uri_complete ?? codeData.verification_uri;
-  console.log(`Authorize this device: ${verificationUrl}`);
-  console.log(`User code: ${codeData.user_code}`);
+  log("info", `Authorize this device: ${verificationUrl}`);
+  log("info", `User code: ${codeData.user_code}`);
   await openBrowser(verificationUrl);
 
   const intervalMs = Math.max(1, codeData.interval ?? 5) * 1000;
+  log("debug", `device auth polling intervalMs=${intervalMs}`);
   let pollDelay = intervalMs;
 
   while (true) {
@@ -121,6 +168,7 @@ const deviceAuthFlow = async (siteUrl: string) => {
     } = await tokenResponse.json();
 
     if (tokenResponse.ok && tokenData.access_token) {
+      log("debug", `device auth success status=${tokenResponse.status}`);
       return tokenData.access_token;
     }
 
@@ -129,9 +177,14 @@ const deviceAuthFlow = async (siteUrl: string) => {
     }
     if (tokenData.error === "slow_down") {
       pollDelay += 1000;
+      log("debug", `device auth slow_down nextDelayMs=${pollDelay}`);
       continue;
     }
 
+    log(
+      "debug",
+      `device auth failed status=${tokenResponse.status} error=${tokenData.error ?? "unknown"}`,
+    );
     throw new Error(
       `Device auth failed: ${tokenData.error ?? "unknown"} ${
         tokenData.error_description ?? ""
@@ -172,9 +225,23 @@ const ensureHookEntry = (entries: ClaudeHookEntry[], next: ClaudeHookEntry) => {
 };
 
 const mergeSettings = async () => {
-  const current: ClaudeSettings = await Bun.file(CLAUDE_SETTINGS_PATH)
-    .json()
-    .catch(() => ({}));
+  log("debug", `mergeSettings path=${CLAUDE_SETTINGS_PATH}`);
+  const settingsFile = Bun.file(CLAUDE_SETTINGS_PATH);
+  const settingsExists = await settingsFile.exists();
+  log("debug", `mergeSettings existing=${settingsExists}`);
+  let current: ClaudeSettings = {};
+  if (settingsExists) {
+    try {
+      current = await settingsFile.json();
+      log("debug", `mergeSettings read ok`);
+    } catch (error) {
+      log(
+        "debug",
+        `mergeSettings read failed: ${error instanceof Error ? error.message : String(error)}`,
+      );
+      current = {};
+    }
+  }
 
   const hooks = current.hooks ?? {};
   const definitions: Array<{ name: string; matcher?: string }> = [
@@ -203,6 +270,19 @@ const mergeSettings = async () => {
   await Bun.write(CLAUDE_SETTINGS_PATH, JSON.stringify(nextConfig, null, 2), {
     createPath: true,
   });
+  log("debug", `mergeSettings wrote settings`);
+  try {
+    const info = await stat(CLAUDE_SETTINGS_PATH);
+    log(
+      "debug",
+      `mergeSettings file size=${info.size} mtime=${new Date(info.mtimeMs).toISOString()}`,
+    );
+  } catch (error) {
+    log(
+      "debug",
+      `mergeSettings stat failed: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
 };
 
 const findSessionFile = async (sessionId: string) => {
@@ -242,7 +322,7 @@ const findSessionFile = async (sessionId: string) => {
 const appendDebugLog = async (message: string) => {
   const logFile = Bun.file(DEBUG_LOG_PATH);
   const content = await logFile.text();
-  await logFile.write(content + message);
+  await Bun.write(DEBUG_LOG_PATH, content + message, { createPath: true });
 };
 
 const buildLogLines = (raw: string) => {
@@ -290,37 +370,55 @@ const uploadLogs = async (siteUrl: string, token: string, sessionId: string, raw
 };
 
 const runSetup = async (args: string[]) => {
+  log("debug", `runSetup start`);
   const force = args.includes("--force");
+  log("debug", `runSetup force=${force}`);
   const configExists = await Bun.file(CONFIG_PATH).exists();
+  log("debug", `config path=${CONFIG_PATH} exists=${configExists}`);
   let existingConfig: Config | null = null;
   if (configExists) {
     try {
       existingConfig = await readConfig();
+      log(
+        "debug",
+        `config loaded siteUrl=${existingConfig.siteUrl} token=${existingConfig.token ? "present" : "missing"}`,
+      );
     } catch {
+      log("debug", `config load failed; continuing without existing config`);
       existingConfig = null;
     }
   }
 
-  const siteUrl = resolveSiteUrl(args) ?? existingConfig?.siteUrl ?? null;
+  const resolution = resolveSiteUrl(args);
+  log("debug", `siteUrl resolved=${resolution.siteUrl ?? "null"} source=${resolution.source}`);
+  const siteUrl = resolution.siteUrl ?? existingConfig?.siteUrl ?? null;
+  if (!resolution.siteUrl && existingConfig?.siteUrl) {
+    log("debug", `siteUrl fallback to existing config ${existingConfig.siteUrl}`);
+  }
   if (!siteUrl) {
+    log("debug", `runSetup aborted: missing siteUrl`);
     throw new Error("Missing site URL. Provide --site-url or BISYNC_SITE_URL.");
   }
 
   if (configExists && existingConfig?.token && !force) {
+    log("debug", `using existing token; updating Claude settings only`);
     await mergeSettings();
-    console.log(`Updated Claude settings using existing credentials at ${CONFIG_PATH}`);
+    log("info", `Updated Claude settings using existing credentials at ${CONFIG_PATH}`);
     return;
   }
 
   const token = await deviceAuthFlow(siteUrl);
   await writeConfig({ siteUrl, token, clientId: CLIENT_ID });
+  log("debug", `config written to ${CONFIG_PATH}`);
   await mergeSettings();
-  console.log(`Configured Claude settings and saved credentials to ${CONFIG_PATH}`);
+  log("info", `Configured Claude settings and saved credentials to ${CONFIG_PATH}`);
 };
 
 const runVerify = async () => {
+  log("debug", `runVerify start config=${CONFIG_PATH}`);
   const config = await readConfig();
   const siteUrl = process.env.BISYNC_SITE_URL ?? config.siteUrl;
+  log("debug", `runVerify siteUrl=${siteUrl}`);
   const response = await fetch(`${siteUrl}/api/list-sessions`, {
     method: "GET",
     headers: {
@@ -330,6 +428,7 @@ const runVerify = async () => {
 
   if (!response.ok) {
     const errorText = await response.text();
+    log("debug", `runVerify failed status=${response.status}`);
     throw new Error(`Verify failed: ${response.status} ${errorText}`);
   }
 
@@ -338,16 +437,17 @@ const runVerify = async () => {
   };
 
   if (data.sessions.length === 0) {
-    console.log("No sessions found.");
+    log("info", "No sessions found.");
     return;
   }
 
   for (const session of data.sessions) {
-    console.log(session.externalId);
+    log("info", session.externalId);
   }
 };
 
 const runHook = async (hookName: string) => {
+  log("debug", `runHook start hook=${hookName}`);
   const stdinRaw = await new Promise<string>((resolve, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
@@ -380,6 +480,7 @@ const runHook = async (hookName: string) => {
   const config = await readConfig();
   const siteUrl = process.env.BISYNC_SITE_URL ?? config.siteUrl;
   const token = config.token;
+  log("debug", `runHook siteUrl=${siteUrl}`);
 
   let sessionFile: string | null = null;
   if (typeof stdinPayload.transcript_path === "string") {
@@ -392,14 +493,18 @@ const runHook = async (hookName: string) => {
     sessionFile = await findSessionFile(sessionId);
   }
   if (!sessionFile) {
+    log("debug", `runHook session file missing sessionId=${sessionId}`);
     await appendDebugLog(
       `[${new Date().toISOString()}] hook=${hookName} error=session-file-not-found session_id=${sessionId}\n`,
     );
     return;
   }
 
+  log("debug", `runHook sessionFile=${sessionFile}`);
+
   const raw = await Bun.file(sessionFile).text();
   if (!raw.trim()) {
+    log("debug", `runHook session file empty sessionId=${sessionId}`);
     await appendDebugLog(
       `[${new Date().toISOString()}] hook=${hookName} error=empty-log session_id=${sessionId}\n`,
     );
@@ -408,7 +513,12 @@ const runHook = async (hookName: string) => {
 
   try {
     await uploadLogs(siteUrl, token, sessionId, raw);
+    log("debug", `runHook upload ok sessionId=${sessionId}`);
   } catch (error) {
+    log(
+      "debug",
+      `runHook upload failed sessionId=${sessionId} message=${error instanceof Error ? error.message : String(error)}`,
+    );
     await appendDebugLog(
       `[${new Date().toISOString()}] hook=${hookName} error=upload-failed session_id=${sessionId} message=${error instanceof Error ? error.message : String(error)}\n`,
     );
@@ -421,7 +531,13 @@ const main = async () => {
     process.exit(0);
   }
 
-  const [command, ...args] = process.argv.slice(2);
+  if (process.argv.includes("--verbose")) {
+    LOG_LEVEL = "debug";
+  }
+
+  const rawArgs = process.argv.slice(2);
+  const [command, ...args] = rawArgs;
+  log("debug", `argv=${JSON.stringify(rawArgs)}`);
   if (!command) {
     usage();
     process.exit(1);
@@ -444,7 +560,7 @@ const main = async () => {
     usage();
     process.exit(1);
   } catch (error) {
-    console.error(error instanceof Error ? error.message : error);
+    log("error", error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
 };