claude-starter 1.3.3 → 1.3.5

package/README.md

@@ -11,8 +11,8 @@
 <h1 align="center">🚀 Claude Starter</h1>
 
 <p align="center">
-  <strong>Claude Code 的主页。</strong>你的所有会话，一目了然。<br/>
-  <strong>Your homepage for Claude Code.</strong> All your sessions, at a glance.
+  <strong>Your homepage for Claude Code.</strong> All your sessions, at a glance.<br/>
+  <strong>Claude Code 的主页。</strong>你的所有会话，一目了然。
 </p>
 
 <p align="center">
@@ -25,117 +25,7 @@
 
 ---
 
-# 🇨🇳 中文
-
-## 痛点
-
-用过 Claude Code 的 `/resume` 吗？它给你的是这样一坨东西：
-
-```
-? Select a conversation
-  3ee0f33a-b882-424f-9ba4-260342e4dd5b - 4/3/2026, 10:53:41 AM
-  87570bab-ee92-4681-9591-54abf2fcb486 - 4/3/2026, 10:18:55 AM
-  ...200 个 UUID...
-```
-
-一堆 UUID，没有上下文，无法搜索。**想找到上周帮你调过 bug 的那个 session？祝你好运。**
-
-## 解决方案
-
-**Claude Starter** 是一个精美的终端可视化工具，让你能像浏览网页一样浏览所有 Claude 历史会话。它是你的 **Claude 主页** —— 每次打开终端，`claude-starter` 一敲，所有 session 一目了然。
-
-```bash
-claude-starter
-```
-
-精美的分屏 UI，Tokyo Night 配色。左侧列表一目了然，右侧实时预览对话详情。不是 UUID，是你**真正说过的话**。
-
-## 🔍 搜索 — 杀手级功能
-
-按 `/` 开始输入，**就这么简单**。无需按回车。
-
-跨项目名、Git 分支、对话内容**全文实时搜索**。输入即过滤，`↑↓` 直接导航结果。
-
-- `auth` → 所有认证相关的对话
-- `refactor` → 上周的代码重构
-- `web-app fix` → 某个项目的 bug 修复
-
-**不需要管理模式，不需要确认。输入即搜，方向键即走。**
-
-## 核心能力
-
-| | 功能 | 说明 |
-|---|---|---|
-| 🎨 | **精美 TUI** | Tokyo Night 配色，分屏布局，终端里的 App |
-| ✨ | **一键新建** | 列表顶部直接新建对话 |
-| 🔍 | **即时搜索** | `/` 全文搜索，无需回车 |
-| 📂 | **项目过滤** | `p` 按项目筛选 |
-| ⚡ | **秒级恢复** | 选中 → Enter → 回到对话 |
-| 📋 | **对话预览** | 右侧面板展示完整元数据和对话历史 |
-| 🔀 | **多种排序** | 时间 / 大小 / 消息数 / 项目 |
-| 📎 | **复制 ID** | `c` 一键复制到剪贴板 |
-| 🔒 | **权限模式** | `m` 设置权限模式，`d` 一键 danger 模式恢复 |
-| ✏️ | **重命名会话** | `r` 直接重命名，支持中文输入 |
-| 🗑️ | **删除会话** | `x` 删除不需要的会话 |
-| ⌨️ | **Vim 快捷键** | `j`/`k` 上下，`g`/`G` 跳顶/底 |
-| 🧠 | **智能 CLI** | 自动检测 `mai-claude` / `claude` |
-| 🔐 | **完全本地** | 不联网，不上传，不追踪 |
-
-## 安装
-
-```bash
-npm install -g claude-starter
-```
-
-或者从源码安装：
-
-```bash
-git clone https://github.com/Bojun-Vvibe/claude-starter.git
-cd claude-starter
-npm install
-npm link
-```
-
-然后运行 `claude-starter`，就这么简单。
-
-## CLI 参数
-
-```bash
-claude-starter              # 启动交互式 TUI
-claude-starter --list [N]   # 打印最近 N 个会话（默认 30）
-claude-starter --version    # 显示版本号
-claude-starter --update     # 检查并更新到最新版本
-claude-starter --help       # 显示帮助信息
-```
-
-## 快捷键
-
-| 按键 | 功能 |
-|:---:|------|
-| `↑` `↓` / `j` `k` | 上下导航 |
-| `Enter` | 新建 / 恢复对话 |
-| `n` | 直接新建 |
-| `d` | Danger 模式恢复（bypassPermissions） |
-| `m` | 权限模式选择器 |
-| `r` | 重命名会话 |
-| `/` | 搜索 |
-| `Backspace` | 删除搜索字符，删空自动退出 |
-| `Esc` | 清空搜索 |
-| `p` | 按项目过滤 |
-| `s` | 切换排序（时间/大小/消息数/项目） |
-| `c` | 复制 Session ID |
-| `x` / `Delete` | 删除会话 |
-| `g` / `G` | 跳到顶 / 底 |
-| `Ctrl-D` / `Ctrl-U` | 翻页 |
-| `q` / `Ctrl-C` | 退出 |
-
-## 原理
-
-读取 `~/.claude/projects/` 下的 JSONL 会话文件，解析元数据和对话内容。200 个 session 加载耗时 ~10ms。**所有数据留在本地，不联网。**
-
----
-
-# 🇬🇧 English
+# English
 
 ## The Problem
 
@@ -256,6 +146,116 @@ MIT
 
 ---
 
+# 中文
+
+## 痛点
+
+用过 Claude Code 的 `/resume` 吗？它给你的是这样一坨东西：
+
+```
+? Select a conversation
+  3ee0f33a-b882-424f-9ba4-260342e4dd5b - 4/3/2026, 10:53:41 AM
+  87570bab-ee92-4681-9591-54abf2fcb486 - 4/3/2026, 10:18:55 AM
+  ...200 个 UUID...
+```
+
+一堆 UUID，没有上下文，无法搜索。**想找到上周帮你调过 bug 的那个 session？祝你好运。**
+
+## 解决方案
+
+**Claude Starter** 是一个精美的终端可视化工具，让你能像浏览网页一样浏览所有 Claude 历史会话。它是你的 **Claude 主页** —— 每次打开终端，`claude-starter` 一敲，所有 session 一目了然。
+
+```bash
+claude-starter
+```
+
+精美的分屏 UI，Tokyo Night 配色。左侧列表一目了然，右侧实时预览对话详情。不是 UUID，是你**真正说过的话**。
+
+## 🔍 搜索 — 杀手级功能
+
+按 `/` 开始输入，**就这么简单**。无需按回车。
+
+跨项目名、Git 分支、对话内容**全文实时搜索**。输入即过滤，`↑↓` 直接导航结果。
+
+- `auth` → 所有认证相关的对话
+- `refactor` → 上周的代码重构
+- `web-app fix` → 某个项目的 bug 修复
+
+**不需要管理模式，不需要确认。输入即搜，方向键即走。**
+
+## 核心能力
+
+| | 功能 | 说明 |
+|---|---|---|
+| 🎨 | **精美 TUI** | Tokyo Night 配色，分屏布局，终端里的 App |
+| ✨ | **一键新建** | 列表顶部直接新建对话 |
+| 🔍 | **即时搜索** | `/` 全文搜索，无需回车 |
+| 📂 | **项目过滤** | `p` 按项目筛选 |
+| ⚡ | **秒级恢复** | 选中 → Enter → 回到对话 |
+| 📋 | **对话预览** | 右侧面板展示完整元数据和对话历史 |
+| 🔀 | **多种排序** | 时间 / 大小 / 消息数 / 项目 |
+| 📎 | **复制 ID** | `c` 一键复制到剪贴板 |
+| 🔒 | **权限模式** | `m` 设置权限模式，`d` 一键 danger 模式恢复 |
+| ✏️ | **重命名会话** | `r` 直接重命名，支持中文输入 |
+| 🗑️ | **删除会话** | `x` 删除不需要的会话 |
+| ⌨️ | **Vim 快捷键** | `j`/`k` 上下，`g`/`G` 跳顶/底 |
+| 🧠 | **智能 CLI** | 自动检测 `mai-claude` / `claude` |
+| 🔐 | **完全本地** | 不联网，不上传，不追踪 |
+
+## 安装
+
+```bash
+npm install -g claude-starter
+```
+
+或者从源码安装：
+
+```bash
+git clone https://github.com/Bojun-Vvibe/claude-starter.git
+cd claude-starter
+npm install
+npm link
+```
+
+然后运行 `claude-starter`，就这么简单。
+
+## CLI 参数
+
+```bash
+claude-starter              # 启动交互式 TUI
+claude-starter --list [N]   # 打印最近 N 个会话（默认 30）
+claude-starter --version    # 显示版本号
+claude-starter --update     # 检查并更新到最新版本
+claude-starter --help       # 显示帮助信息
+```
+
+## 快捷键
+
+| 按键 | 功能 |
+|:---:|------|
+| `↑` `↓` / `j` `k` | 上下导航 |
+| `Enter` | 新建 / 恢复对话 |
+| `n` | 直接新建 |
+| `d` | Danger 模式恢复（bypassPermissions） |
+| `m` | 权限模式选择器 |
+| `r` | 重命名会话 |
+| `/` | 搜索 |
+| `Backspace` | 删除搜索字符，删空自动退出 |
+| `Esc` | 清空搜索 |
+| `p` | 按项目过滤 |
+| `s` | 切换排序（时间/大小/消息数/项目） |
+| `c` | 复制 Session ID |
+| `x` / `Delete` | 删除会话 |
+| `g` / `G` | 跳到顶 / 底 |
+| `Ctrl-D` / `Ctrl-U` | 翻页 |
+| `q` / `Ctrl-C` | 退出 |
+
+## 原理
+
+读取 `~/.claude/projects/` 下的 JSONL 会话文件，解析元数据和对话内容。200 个 session 加载耗时 ~10ms。**所有数据留在本地，不联网。**
+
+---
+
 <p align="center">
   <sub>Built with 💜 by <a href="https://github.com/Bojun-Vvibe">Bojun</a> — powered by Claude Code itself</sub>
 </p>

package/index.js

@@ -202,17 +202,20 @@ function loadSessionQuick(filePath, projectName) {
   const sessionId = path.basename(filePath, '.jsonl');
   const stat = fs.statSync(filePath);
 
+  // Use 32KB head buffer (up from 8KB) to handle sessions whose first user
+  // message is very large (e.g. pasted code blocks, long queries).
+  const HEAD_SIZE = 32768;
   const fd = fs.openSync(filePath, 'r');
-  const headBuf = Buffer.alloc(Math.min(8192, stat.size));
+  const headBuf = Buffer.alloc(Math.min(HEAD_SIZE, stat.size));
   fs.readSync(fd, headBuf, 0, headBuf.length, 0);
 
   // Read tail with progressive expansion: start at 32KB, grow up to 256KB
   // until we find a JSON line with a top-level timestamp (to get accurate lastTs).
   let tailStr = '';
-  if (stat.size > 8192) {
+  if (stat.size > HEAD_SIZE) {
     const tailSizes = [32768, 65536, 131072, 262144];
     for (const ts of tailSizes) {
-      const tailSize = Math.min(ts, stat.size - 8192);
+      const tailSize = Math.min(ts, stat.size - HEAD_SIZE);
       const tailBuf = Buffer.alloc(tailSize);
       fs.readSync(fd, tailBuf, 0, tailSize, stat.size - tailSize);
       tailStr = tailBuf.toString('utf-8');
@@ -221,7 +224,7 @@ function loadSessionQuick(filePath, projectName) {
         try { return !!JSON.parse(line).timestamp; } catch { return false; }
       });
       if (hasTopLevelTs) break;
-      if (tailSize >= stat.size - 8192) break;  // already read entire file
+      if (tailSize >= stat.size - HEAD_SIZE) break;  // already read entire file
     }
   }
   fs.closeSync(fd);
@@ -250,7 +253,42 @@ function loadSessionQuick(filePath, projectName) {
         userMsgCount++;
         if (!firstUserMsg) firstUserMsg = extractUserText(d);
       }
-    } catch (e) { /* partial line */ }
+    } catch (e) {
+      // The line was truncated by the head buffer. Try to salvage metadata
+      // via regex so we don't lose the session entirely.
+      if (!firstTs) {
+        const tsMatch = line.match(/"timestamp"\s*:\s*"([^"]+)"/);
+        if (tsMatch) firstTs = tsMatch[1];
+      }
+      if (!version) {
+        const vMatch = line.match(/"version"\s*:\s*"([^"]+)"/);
+        if (vMatch) version = vMatch[1];
+      }
+      if (!gitBranch) {
+        const bMatch = line.match(/"gitBranch"\s*:\s*"([^"]+)"/);
+        if (bMatch) gitBranch = bMatch[1];
+      }
+      if (!cwd) {
+        const cwdMatch = line.match(/"cwd"\s*:\s*"([^"]+)"/);
+        if (cwdMatch) cwd = cwdMatch[1];
+      }
+      // Try to extract user message text from the truncated JSON line.
+      // User messages have "type":"user" and text content embedded inside.
+      if (!firstUserMsg && /"type"\s*:\s*"user"/.test(line)) {
+        userMsgCount++;
+        // Match the text field inside message.content (handles both string
+        // content and array-of-objects content structures).
+        const textMatch = line.match(/"text"\s*:\s*"((?:[^"\\]|\\.)*)/) ||
+                          line.match(/"content"\s*:\s*"((?:[^"\\]|\\.)*)/);
+        if (textMatch) {
+          let text = '';
+          try { text = JSON.parse('"' + textMatch[1] + '"'); } catch { text = textMatch[1]; }
+          if (!text.startsWith('<local-command') && !text.startsWith('<command-')) {
+            firstUserMsg = text.substring(0, 200);
+          }
+        }
+      }
+    }
   }
 
   if (tailStr) {
@@ -259,7 +297,12 @@ function loadSessionQuick(filePath, projectName) {
       try {
         const d = JSON.parse(line);
         if (d.timestamp) lastTs = d.timestamp;
-        if (d.type === 'user') userMsgCount++;
+        if (d.type === 'user') {
+          userMsgCount++;
+          // If no real user message was found in the head (all were commands),
+          // try to pick one from the tail as a fallback topic.
+          if (!firstUserMsg) firstUserMsg = extractUserText(d);
+        }
         if (d.type === 'custom-title' && d.customTitle) customTitle = d.customTitle;
       } catch (e) { /* partial line */ }
     }
@@ -1465,58 +1508,99 @@ function createApp() {
   listPanel.focus();
 }
 
-// ─── Entry Point ─────────────────────────────────────────────────────────────
+// ─── Exports for Testing ────────────────────────────────────────────────────
+// When required as a module (e.g. by tests), export helpers without launching
+// the CLI / TUI.  The entry-point logic only runs when executed directly.
+
+if (typeof module !== 'undefined') {
+  module.exports = {
+    // Data helpers
+    getProjectDisplayName,
+    extractUserText,
+    loadSessionQuick,
+    loadSessionDetail,
+    loadAllSessions,
+    // Formatting
+    formatTimestamp,
+    formatFileSize,
+    getProjectColor,
+    esc,
+    // Meta
+    loadMeta,
+    saveMeta,
+    getSessionMeta,
+    getEffectivePermissionMode,
+    setSessionPermissionMode,
+    setGlobalPermissionMode,
+    // Constants
+    PERMISSION_MODES,
+    PROJECT_COLORS,
+    CLAUDE_DIR,
+    PROJECTS_DIR,
+    META_FILE,
+    // CLI
+    detectCLI,
+    // List mode (for integration tests)
+    runListMode,
+    // TUI (for interaction tests)
+    createApp,
+  };
+}
 
-const PKG = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf-8'));
+// ─── Entry Point ─────────────────────────────────────────────────────────────
+// Only run CLI/TUI when executed directly (not when required as a module).
 
-const args = process.argv.slice(2);
+if (require.main === module) {
+  const PKG = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf-8'));
 
-if (args.includes('--version') || args.includes('-v') || args.includes('-V')) {
-  console.log(`claude-starter v${PKG.version}`);
-  process.exit(0);
-}
+  const args = process.argv.slice(2);
 
-if (args.includes('--update') || args.includes('-u')) {
-  const C = {
-    reset: '\x1b[0m', dim: '\x1b[2m', bold: '\x1b[1m',
-    cyan: '\x1b[36m', yellow: '\x1b[33m', green: '\x1b[32m',
-    red: '\x1b[31m',
-  };
-  console.log(`\n${C.cyan}🔄 Checking for updates…${C.reset}\n`);
+  if (args.includes('--version') || args.includes('-v') || args.includes('-V')) {
+    console.log(`claude-starter v${PKG.version}`);
+    process.exit(0);
+  }
 
-  try {
-    const latest = execSync('npm view claude-starter version 2>/dev/null', {
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 10000,
-    }).toString().trim();
+  if (args.includes('--update') || args.includes('-u')) {
+    const C = {
+      reset: '\x1b[0m', dim: '\x1b[2m', bold: '\x1b[1m',
+      cyan: '\x1b[36m', yellow: '\x1b[33m', green: '\x1b[32m',
+      red: '\x1b[31m',
+    };
+    console.log(`\n${C.cyan}🔄 Checking for updates…${C.reset}\n`);
 
-    if (latest === PKG.version) {
-      console.log(`${C.green}✓ Already on the latest version (v${PKG.version})${C.reset}\n`);
-      process.exit(0);
-    }
+    try {
+      const latest = execSync('npm view claude-starter version 2>/dev/null', {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 10000,
+      }).toString().trim();
+
+      if (latest === PKG.version) {
+        console.log(`${C.green}✓ Already on the latest version (v${PKG.version})${C.reset}\n`);
+        process.exit(0);
+      }
 
-    console.log(`${C.yellow}  Current: v${PKG.version}${C.reset}`);
-    console.log(`${C.green}  Latest:  v${latest}${C.reset}\n`);
-    console.log(`${C.cyan}📦 Updating…${C.reset}\n`);
+      console.log(`${C.yellow}  Current: v${PKG.version}${C.reset}`);
+      console.log(`${C.green}  Latest:  v${latest}${C.reset}\n`);
+      console.log(`${C.cyan}📦 Updating…${C.reset}\n`);
 
-    try {
-      execSync('npm install -g claude-starter@latest', { stdio: 'inherit', timeout: 60000 });
-      console.log(`\n${C.green}${C.bold}✓ Updated to v${latest}${C.reset}\n`);
+      try {
+        execSync('npm install -g claude-starter@latest', { stdio: 'inherit', timeout: 60000 });
+        console.log(`\n${C.green}${C.bold}✓ Updated to v${latest}${C.reset}\n`);
+      } catch (e) {
+        console.error(`\n${C.red}✗ Update failed. Try manually:${C.reset}`);
+        console.log(`${C.yellow}  npm install -g claude-starter@latest${C.reset}\n`);
+        process.exit(1);
+      }
     } catch (e) {
-      console.error(`\n${C.red}✗ Update failed. Try manually:${C.reset}`);
-      console.log(`${C.yellow}  npm install -g claude-starter@latest${C.reset}\n`);
+      console.error(`${C.red}✗ Could not check for updates (network error or npm not found)${C.reset}\n`);
       process.exit(1);
     }
-  } catch (e) {
-    console.error(`${C.red}✗ Could not check for updates (network error or npm not found)${C.reset}\n`);
-    process.exit(1);
-  }
 
-  process.exit(0);
-}
+    process.exit(0);
+  }
 
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(`
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(`
 \x1b[36m🚀 Claude Starter\x1b[0m  \x1b[2mv${PKG.version}\x1b[0m
 
 Usage:
@@ -1542,14 +1626,15 @@ TUI Keyboard Shortcuts:
   Esc           Clear filter
   q / Ctrl-C    Quit
 `);
-  process.exit(0);
-}
+    process.exit(0);
+  }
 
-if (args.includes('--list') || args.includes('-l')) {
-  const limitIdx = args.indexOf('--list') !== -1 ? args.indexOf('--list') : args.indexOf('-l');
-  const limit = parseInt(args[limitIdx + 1]) || 30;
-  runListMode(limit);
-  process.exit(0);
-}
+  if (args.includes('--list') || args.includes('-l')) {
+    const limitIdx = args.indexOf('--list') !== -1 ? args.indexOf('--list') : args.indexOf('-l');
+    const limit = parseInt(args[limitIdx + 1]) || 30;
+    runListMode(limit);
+    process.exit(0);
+  }
 
-createApp();
+  createApp();
+}

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "claude-starter",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "A beautiful terminal UI for managing Claude Code sessions — start new or resume past conversations",
   "main": "index.js",
   "bin": {
     "claude-starter": "./index.js"
   },
   "scripts": {
-    "start": "node index.js"
+    "start": "node index.js",
+    "test": "node --test test.js",
+    "test:tui": "node --test --test-force-exit test-tui.js",
+    "test:all": "node --test --test-force-exit test.js test-tui.js",
+    "prepublishOnly": "npm run test:all"
   },
   "keywords": [
     "claude",