mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00

Files

catlog22 2f3a14e946 Add unit tests for LspGraphBuilder class

- Implement comprehensive unit tests for the LspGraphBuilder class to validate its functionality in building code association graphs.
- Tests cover various scenarios including single level graph expansion, max nodes and depth boundaries, concurrent expansion limits, document symbol caching, error handling during node expansion, and edge cases such as empty seed lists and self-referencing nodes.
- Utilize pytest and asyncio for asynchronous testing and mocking of LspBridge methods.

2026-01-20 12:49:31 +08:00

4.5 KiB

Raw Blame History

CLI History Store 数据库迁移优化 - 完成报告

📋 任务概况

优化 CLI History Store 的数据库迁移逻辑，解决每次 CLI 执行都输出重复迁移日志的问题。

✅ 实现清单

1. 完善 turns 表结构 - COMPLETED

文件: ccw/src/tools/cli-history-store.ts:149-169

在 initSchema() 的 CREATE TABLE 语句中添加了 5 个缺失的列：

✅ cached INTEGER DEFAULT 0 (行 162)
✅ stdout_full TEXT (行 163)
✅ stderr_full TEXT (行 164)
✅ parsed_output TEXT (行 165)
✅ final_output TEXT (行 166)

验证:

sed -n '162,166p' ccw/src/tools/cli-history-store.ts
# 输出: 所有 5 列定义已确认

2. 重构迁移逻辑 - COMPLETED

文件: ccw/src/tools/cli-history-store.ts:331-361

将逐个迁移（每列一条日志）改为批量迁移（单条汇总日志）：

// 改进前: 5 条独立的 console.log 调用
if (!hasCached) {
  console.log('[CLI History] Migrating database: adding cached column...');
  // ...
}
if (!hasStdoutFull) {
  console.log('[CLI History] Migrating database: adding stdout_full column...');
  // ...
}
// ... 重复 3 次

// 改进后: 1 条汇总日志
const missingTurnsColumns: string[] = [];
for (const [col, def] of Object.entries(turnsColumnDefs)) {
  if (!turnsColumns.has(col)) {
    missingTurnsColumns.push(col);
  }
}
if (missingTurnsColumns.length > 0) {
  console.log(`[CLI History] Migrating turns table: adding ${missingTurnsColumns.length} columns...`);
  // ...
}

关键改进:

使用 Set 高效查询列名
集中定义列配置 (turnsColumnDefs)
条件输出：仅在有迁移时显示一条汇总日志

验证:

sed -n '353,361p' ccw/src/tools/cli-history-store.ts
# 输出: 批量迁移逻辑已确认

3. memory-store.ts 评估 - COMPLETED

文件: ccw/src/core/memory-store.ts

结论: 无需修复 ✅

原因:

表结构完整，所有列在 initDatabase() 中已定义
迁移逻辑清晰，仅处理 2 个后续添加的列
无类似的批量列缺失问题

📊 效果对比

指标	修复前	修复后	改进
新安装日志数	5 条	0 条	-100%
旧库升级日志数	每次 5 条	首次 1 条	-80%
后续启动日志	每次 5 条	静默	-100%
表结构完整性	运行时创建	创建时完整	✓

🧪 测试验证

测试脚本执行

node test-cli-history-migration.js

测试结果

✓ Test 1: New database creation - 所有列已在创建时定义
✓ Test 2: Subsequent initialization - 后续初始化静默
✓ Test 3: Column verification - 所有 16 列已验证

✓ All required columns present: id, conversation_id, turn_number, 
  timestamp, prompt, duration_ms, status, exit_code, stdout, stderr, 
  truncated, cached, stdout_full, stderr_full, parsed_output, final_output

📁 文件变更

修改的文件

ccw/src/tools/cli-history-store.ts
├── 149-169: 添加 5 列到 CREATE TABLE turns
└── 331-361: 重构迁移逻辑为批量处理

无需修改的文件

ccw/src/core/memory-store.ts (表结构完整)

🔍 根本原因分析

原问题根源:

turns 表在 initSchema() 中缺少 5 个列定义
新数据库创建时表结构不完整
每次实例化都执行 migrateSchema() 检查
CLI 每次作为新进程运行，单例缓存失效
逐个迁移导致 5 条重复日志

修复策略:

✅ 在 initSchema() 中添加完整列定义
✅ 实现批量迁移逻辑
✅ 条件输出：仅在必要时显示汇总日志

🎯 后续行动

即时验证

# 1. 编译验证
npm run build

# 2. 集成测试
npm test -- --grep "cli-history"

# 3. 手动测试
rm -rf ~/.ccw/test-project
ccw cli -p "test query" --tool gemini --mode analysis
# 预期: 无迁移日志输出

长期监控

监控 CLI 执行日志输出，确认无重复迁移日志
定期审查新增列的使用情况
保持迁移逻辑与表结构定义同步

📚 相关文档

MIGRATION_FIX_SUMMARY.md - 详细实现总结
ccw/src/tools/cli-history-store.ts - 源代码实现

✨ 总结

✅ 所有计划项目已完成

新数据库创建时表结构完整
旧数据库升级时日志输出优化
批量迁移策略有效降低日志噪声
向后兼容性保持完好
代码质量和可维护性得到提升

预期影响: CLI 执行时将不再输出重复的数据库迁移日志，提升用户体验。

4.5 KiB Raw Blame History