cc-hub-cli 1.1.5 → 1.1.6

package/README.md

@@ -159,6 +159,44 @@ Invoke-Expression (& cc-hub completion powershell | Out-String)
 
 Completes subcommands, profile names, and event types.
 
+## Logging
+
+cc-hub writes structured logs to `~/.claude/cc-hub/logs/cc-hub-YYYY-MM-DD.log`.
+
+### Log levels
+
+Levels are ordered from most to least verbose:
+
+| Level | Description |
+|---|---|
+| `DEBUG` | All service calls, file reads/writes, path encode/decode, proxy requests |
+| `INFO`  | Command executions, profile launches, proxy start/stop |
+| `WARN`  | JSON auto-fix events, backup restores |
+| `ERROR` | Thrown exceptions, upstream errors, uncaught exceptions/rejections |
+
+The default level is `INFO`. To change it, add `_cc_hub_logLevel` to `~/.claude/settings.json`:
+
+```json
+{
+  "_cc_hub_logLevel": "DEBUG"
+}
+```
+
+Valid values: `DEBUG`, `INFO`, `WARN`, `ERROR`.
+
+### Viewing logs
+
+```bash
+# Tail today's log
+tail -f ~/.claude/cc-hub/logs/cc-hub-$(date +%Y-%m-%d).log
+
+# View all logs
+ls -lt ~/.claude/cc-hub/logs/
+
+# Search for errors
+grep ERROR ~/.claude/cc-hub/logs/*.log
+```
+
 ## Configuration
 
 cc-hub reads from these paths (overridable via environment variables):

package/dist/index.js

@@ -558,17 +558,26 @@ function transformAnthropicToOpenAI(body) {
         });
       }
       const contentParts = msg.content.filter(
-        (b) => b.type === "text" && b.text || b.type === "image" && b.source
+        (b) => b.type === "text" && b.text || b.type === "image" && (b.source?.type === "base64" && b.source.media_type && b.source.data || b.source?.type === "url" && b.source.url)
       );
       if (contentParts.length > 0) {
         const converted = contentParts.map((part) => {
           if (part.type === "image") {
-            const url = part.source?.type === "base64" ? `data:${part.source.media_type};base64,${part.source.data}` : part.source?.url ?? "";
-            return { type: "image_url", image_url: { url } };
+            if (part.source?.type === "base64" && part.source.media_type && part.source.data) {
+              const url = `data:${part.source.media_type};base64,${part.source.data}`;
+              debug(`transform: converting base64 image (${part.source.media_type}, ${part.source.data.length} chars)`);
+              return { type: "image_url", image_url: { url } };
+            } else if (part.source?.type === "url" && part.source.url) {
+              debug(`transform: converting image url (${part.source.url.slice(0, 80)}...)`);
+              return { type: "image_url", image_url: { url: part.source.url } };
+            }
+            warn(`transform: skipping invalid image block (missing source fields)`);
+            return null;
           }
           return { type: "text", text: part.text };
-        });
-        if (converted.every((p) => p.type === "text")) {
+        }).filter(Boolean);
+        if (converted.length === 0) {
+        } else if (converted.every((p) => p.type === "text")) {
           messages.push({
             role: "user",
             content: converted.map((p) => p.text).join("")
@@ -1480,7 +1489,7 @@ function encodePath(p) {
   debug(`codec: encode "${p}" -> "${encoded}"`);
   return encoded;
 }
-function decodePath(encoded) {
+function decodePath2(encoded) {
   const decoded = createPathCodec().decode(encoded);
   debug(`codec: decode "${encoded}" -> "${decoded}"`);
   return decoded;
@@ -1596,11 +1605,54 @@ function snippet(text, query, width = 150) {
   const suffix = end < text.length ? "..." : "";
   return prefix + text.slice(start, end) + suffix;
 }
+function findSessionFile(sessionQuery, projectQuery) {
+  debug(`sessions: findSessionFile query="${sessionQuery}" project=${projectQuery || "(any)"}`);
+  let searchDirs = [];
+  if (projectQuery) {
+    const projDir = findProjectDir(projectQuery);
+    if (!projDir) {
+      throw new Error(`No project matched: ${projectQuery}`);
+    }
+    searchDirs.push(path6.join(PROJECTS_DIR, projDir));
+  } else {
+    try {
+      searchDirs = fs6.readdirSync(PROJECTS_DIR).map((d) => path6.join(PROJECTS_DIR, d));
+    } catch {
+      throw new Error(`No projects directory found at ${PROJECTS_DIR}`);
+    }
+  }
+  const matches = [];
+  for (const dir of searchDirs) {
+    let files;
+    try {
+      files = fs6.readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      const sessionId = file.replace(/\.jsonl$/, "");
+      if (sessionId.toLowerCase().includes(sessionQuery.toLowerCase())) {
+        matches.push({ filePath: path6.join(dir, file), project: path6.basename(dir) });
+      }
+    }
+  }
+  if (matches.length === 0) {
+    return null;
+  }
+  if (matches.length > 1) {
+    const lines = matches.map((m) => `  ${path6.basename(m.filePath)} in ${decodePath(m.project)}`).join("\n");
+    throw new Error(`Multiple sessions matched '${sessionQuery}':
+${lines}
+Use --project to disambiguate.`);
+  }
+  return matches[0];
+}
 
 // src/sessions/commands.ts
 import { Command as Command4 } from "commander";
 import fs7 from "fs";
 import path7 from "path";
+import { spawnSync as spawnSync3 } from "child_process";
 function sessionCommand() {
   const session = new Command4("session").description("Manage Claude Code sessions");
   const desktopApp2 = createDesktopApp();
@@ -1630,7 +1682,7 @@ function sessionCommand() {
       } catch {
       }
       const stat = fs7.statSync(fullPath);
-      const decoded = decodePath(projDir);
+      const decoded = decodePath2(projDir);
       if (opts.json) {
         console.log(JSON.stringify({ project: decoded, sessions: nSessions, modified: Math.floor(stat.mtimeMs) }));
       } else if (opts.short) {
@@ -1648,7 +1700,7 @@ function sessionCommand() {
       throw new Error(`No project matched: ${project}`);
     }
     const fullPath = path7.join(PROJECTS_DIR, projDir);
-    console.log(`Project: ${decodePath(projDir)}`);
+    console.log(`Project: ${decodePath2(projDir)}`);
     console.log(`Dir:     ${fullPath}`);
     console.log("");
     const fmt = (sid, name, started, msgs) => `${sid.padEnd(36)}  ${name.padEnd(30)}  ${started.padEnd(17)}  ${msgs}`;
@@ -1742,7 +1794,7 @@ function sessionCommand() {
                   const relPath = path7.relative(baseDir, fullPath);
                   const projEnc = relPath.split(path7.sep)[0];
                   const sessionId = path7.basename(fullPath, ".jsonl");
-                  const projName = label ? projEnc : decodePath(projEnc);
+                  const projName = label ? projEnc : decodePath2(projEnc);
                   console.log(`${label}[${projName}  \u2192  ${sessionId}]`);
                   found = true;
                   count++;
@@ -1928,6 +1980,38 @@ function sessionCommand() {
     const verb = opts.dryRun ? "Would delete" : "Deleted";
     console.log(`${verb} ${deleted} file(s) (~${Math.floor(freed / 1024)}KB freed)`);
   }));
+  session.command("troubleshoot").description("Launch Claude Code to troubleshoot a session file").argument("<session>", "Session ID or partial match").option("-i, --interactive", "Open an interactive Claude Code window instead of a one-shot prompt").action(safeAction((sessionId, opts) => {
+    debug(`session troubleshoot: session=${sessionId} interactive=${!!opts.interactive}`);
+    console.log(`Searching for session '${sessionId}'...`);
+    const match = findSessionFile(sessionId);
+    if (!match) {
+      throw new Error(`Session '${sessionId}' not found.`);
+    }
+    if (!fs7.existsSync(match.filePath)) {
+      throw new Error(`Session file no longer exists: ${match.filePath}`);
+    }
+    console.log(`Found session file: ${match.filePath}`);
+    const nodeBinary = process.argv[0];
+    const scriptPath = process.argv[1];
+    let args;
+    const promptText = `Please analyze this Claude Code session file: ${match.filePath}
+
+The file contains a JSONL conversation history. Review it for any errors, anomalies, or issues (truncated responses, failed tool calls, error messages, corrupted data, etc.). Summarize what happened in the session and identify any problems that need attention. If the file is very large, focus on the most recent turns and any lines containing "error", "exception", "failed", or non-JSON content.`;
+    if (opts.interactive) {
+      console.log("Launching Claude Code (interactive)...");
+      info(`session troubleshoot: launching cc-hub run (interactive) for ${match.filePath}`);
+      args = ["run", promptText];
+    } else {
+      console.log("Launching Claude Code with prompt...");
+      info(`session troubleshoot: launching cc-hub run -p "${promptText}"`);
+      args = ["run", "-p", promptText];
+    }
+    const result = spawnSync3(nodeBinary, [scriptPath, ...args], {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    process.exit(result.status ?? 1);
+  }));
   return session;
 }
 
@@ -1985,6 +2069,7 @@ _cc-hub() {
     'ps:Show active Claude Code processes'
     'stats:Show summary statistics'
     'clean:Delete session JSONL files older than N days'
+    'troubleshoot:Launch Claude Code to troubleshoot a session file'
   )
 
   _cc_hub_profiles() {
@@ -2062,6 +2147,8 @@ _cc-hub() {
         session)
           if (( CURRENT == 2 )); then
             _describe -t session-subcmds 'session subcommand' session_subcmds
+          elif [[ $words[2] == "troubleshoot" ]]; then
+            _arguments -C -S               '(-i --interactive)'{-i,--interactive}'[Open an interactive Claude Code window instead of a one-shot prompt]'
           fi
           ;;
       esac
@@ -2121,7 +2208,7 @@ _cc-hub() {
   local provider_subcmds="list"
   local provider_types="anthropic openai"
   local hooks_subcmds="list add remove enable disable"
-  local session_subcmds="list show search ps stats clean"
+  local session_subcmds="list show search ps stats clean troubleshoot"
 
   # Top-level command
   if [[ \${COMP_CWORD} -eq 1 ]]; then
@@ -2172,6 +2259,13 @@ _cc-hub() {
     session)
       if [[ \${COMP_CWORD} -eq 2 ]]; then
         COMPREPLY=($(compgen -W "$session_subcmds" -- "$cur"))
+      elif [[ "\${COMP_WORDS[2]}" == "troubleshoot" ]]; then
+        if [[ "$prev" == "--interactive" || "$prev" == "-i" ]]; then
+          :
+        else
+          local troubleshoot_opts="--interactive -i"
+          COMPREPLY=($(compgen -W "$troubleshoot_opts" -- "$cur"))
+        fi
       fi
       ;;
   esac
@@ -2199,7 +2293,7 @@ var POWERSHELL_COMPLETION = `Register-ArgumentCompleter -Native -CommandName cc-
 
   $profileSubcmds = @('add', 'update', 'list', 'view', 'remove', 'rename', 'default', 'sync')
   $hookSubcmds = @('list', 'add', 'remove', 'enable', 'disable')
-  $sessionSubcmds = @('list', 'show', 'search', 'ps', 'stats', 'clean')
+  $sessionSubcmds = @('list', 'show', 'search', 'ps', 'stats', 'clean', 'troubleshoot')
   $providerSubcmds = @('list')
 
   $tokens = $commandAst.CommandElements | ForEach-Object { $_.ToString() }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hub-cli",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "Manage Claude CLI profiles, hooks, and sessions",
   "type": "module",
   "bin": {