sumulige-claude 1.0.8 → 1.0.11

package/lib/commands.js

@@ -9,6 +9,7 @@ const path = require('path');
 const { execSync } = require('child_process');
 const { loadConfig, CONFIG_DIR, CONFIG_FILE, SKILLS_DIR, ensureDir, saveConfig } = require('./config');
 const { copyRecursive, toTitleCase } = require('./utils');
+const { runMigrations, TEMPLATE_VERSION } = require('./migrations');
 
 const TEMPLATE_DIR = path.join(__dirname, '../template');
 
@@ -62,6 +63,7 @@ const commands = {
   // -------------------------------------------------------------------------
   sync: () => {
     console.log('🔄 Syncing Sumulige Claude to current project...');
+    console.log('');
 
     const projectDir = process.cwd();
     const projectConfigDir = path.join(projectDir, '.claude');
@@ -71,6 +73,17 @@ const commands = {
 
     // Create .claude directory
     ensureDir(projectConfigDir);
+
+    // Run migrations (version-aware)
+    const result = runMigrations(projectDir);
+    if (result.migrations.length > 0) {
+      console.log(`📦 Migrating project template → v${TEMPLATE_VERSION}`);
+      result.migrations.forEach(m => {
+        console.log(`   ✅ ${m.description}`);
+      });
+      console.log('');
+    }
+
     console.log('✅ Created .claude directory');
 
     // Sync config
@@ -118,6 +131,55 @@ const commands = {
     console.log('✅ Sync complete!');
   },
 
+  // -------------------------------------------------------------------------
+  migrate: () => {
+    console.log('🔧 Migrating project to latest format...');
+    console.log('');
+
+    const projectDir = process.cwd();
+    const settingsFile = path.join(projectDir, '.claude', 'settings.json');
+
+    if (!fs.existsSync(settingsFile)) {
+      console.log('⚠️  No settings.json found in .claude/');
+      console.log('   Run: smc template');
+      return;
+    }
+
+    let settings;
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsFile, 'utf-8'));
+    } catch (e) {
+      console.log('❌ Invalid JSON in settings.json');
+      return;
+    }
+
+    // 检测旧格式
+    const isOldFormat = settings.matcher || (settings.hooks && typeof settings.hooks === 'object');
+
+    if (!isOldFormat) {
+      console.log('✅ Already using latest format');
+      return;
+    }
+
+    // 读取新模板
+    const templateSettings = path.join(TEMPLATE_DIR, '.claude', 'settings.json');
+    if (!fs.existsSync(templateSettings)) {
+      console.log('❌ Template settings.json not found');
+      return;
+    }
+
+    const newSettings = fs.readFileSync(templateSettings, 'utf-8');
+    fs.writeFileSync(settingsFile, newSettings);
+
+    console.log('✅ Migrated settings.json to latest format');
+    console.log('');
+    console.log('Changes:');
+    console.log('  - Old format: {"matcher": "...", "hooks": [...]}');
+    console.log('  - New format: {"UserPromptSubmit": [...], "PostToolUse": [...]}');
+    console.log('');
+    console.log('ℹ️  Hooks will now work correctly!');
+  },
+
   // -------------------------------------------------------------------------
   agent: (task) => {
     if (!task) {
@@ -565,6 +627,11 @@ const commands = {
     fs.writeFileSync(path.join(targetClaudeDir, 'ANCHORS.md'), anchorsContent);
     console.log('   ✅ .claude/ANCHORS.md');
 
+    // Write version file
+    const { setProjectVersion } = require('./migrations');
+    setProjectVersion(targetDir, TEMPLATE_VERSION);
+    console.log(`   ✅ .claude/.version (v${TEMPLATE_VERSION})`);
+
     // Initialize Sumulige Claude if installed
     console.log('');
     console.log('🤖 Initializing Sumulige Claude...');

package/lib/migrations.js

@@ -0,0 +1,154 @@
+/**
+ * Migrations - Version control for project templates
+ *
+ * 每个迁移函数：
+ * - from: 起始版本
+ * - to: 目标版本
+ * - migrate: 实际迁移逻辑
+ *
+ * 迁移链：v1.0.0 → v1.0.2 → v1.0.10 → ...
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 当前模板版本
+const TEMPLATE_VERSION = '1.0.10';
+
+// 版本文件路径
+const getVersionFile = (projectDir) => path.join(projectDir, '.claude', '.version');
+
+// 读取项目版本
+function getProjectVersion(projectDir) {
+  const versionFile = getVersionFile(projectDir);
+  if (!fs.existsSync(versionFile)) {
+    // 没有 version 文件说明是旧版本项目
+    return '1.0.0';
+  }
+  try {
+    return fs.readFileSync(versionFile, 'utf-8').trim();
+  } catch {
+    return '1.0.0';
+  }
+}
+
+// 写入项目版本
+function setProjectVersion(projectDir, version) {
+  const versionFile = getVersionFile(projectDir);
+  fs.writeFileSync(versionFile, version + '\n');
+}
+
+// 版本比较
+function compareVersions(v1, v2) {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    if (parts1[i] < parts2[i]) return -1;
+    if (parts1[i] > parts2[i]) return 1;
+  }
+  return 0;
+}
+
+// 迁移列表
+const migrations = [
+  {
+    from: '1.0.0',
+    to: '1.0.10',
+    description: 'Migrate hooks format from old to new',
+    migrate: (projectDir) => {
+      const settingsFile = path.join(projectDir, '.claude', 'settings.json');
+      if (!fs.existsSync(settingsFile)) return;
+
+      let settings;
+      try {
+        settings = JSON.parse(fs.readFileSync(settingsFile, 'utf-8'));
+      } catch {
+        return; // 无效 JSON，跳过
+      }
+
+      // 检测旧格式
+      const isOldFormat = settings.matcher || (settings.hooks && typeof settings.hooks === 'object');
+      if (!isOldFormat) return;
+
+      // 读取新模板
+      const templateDir = path.join(__dirname, '../template');
+      const templateSettings = path.join(templateDir, '.claude', 'settings.json');
+
+      if (fs.existsSync(templateSettings)) {
+        fs.writeFileSync(settingsFile, fs.readFileSync(templateSettings, 'utf-8'));
+      }
+    }
+  }
+];
+
+/**
+ * 执行迁移
+ * @param {string} projectDir - 项目目录
+ * @param {boolean} silent - 是否静默模式
+ * @returns {object} { success, migrations, currentVersion }
+ */
+function runMigrations(projectDir, silent = false) {
+  const currentVersion = getProjectVersion(projectDir);
+
+  // 已经是最新版本
+  if (compareVersions(currentVersion, TEMPLATE_VERSION) >= 0) {
+    return {
+      success: true,
+      migrations: [],
+      currentVersion,
+      templateVersion: TEMPLATE_VERSION
+    };
+  }
+
+  // 找到需要执行的迁移
+  const pendingMigrations = migrations.filter(m => {
+    const cmp = compareVersions(currentVersion, m.to);
+    return cmp < 0; // 只执行版本高于当前版本的迁移
+  });
+
+  // 按版本顺序执行
+  pendingMigrations.sort((a, b) => compareVersions(a.to, b.to));
+
+  const executed = [];
+
+  for (const migration of pendingMigrations) {
+    try {
+      if (!silent) {
+        console.log(`⬆️  Migrating: ${currentVersion} → ${migration.to}`);
+        console.log(`   ${migration.description}`);
+      }
+      migration.migrate(projectDir);
+      executed.push(migration);
+      setProjectVersion(projectDir, migration.to);
+      if (!silent) {
+        console.log(`   ✅ Done`);
+      }
+    } catch (error) {
+      if (!silent) {
+        console.log(`   ❌ Failed: ${error.message}`);
+      }
+      return {
+        success: false,
+        error: error.message,
+        currentVersion,
+        executed
+      };
+    }
+  }
+
+  return {
+    success: true,
+    migrations: executed,
+    currentVersion: TEMPLATE_VERSION,
+    templateVersion: TEMPLATE_VERSION
+  };
+}
+
+module.exports = {
+  TEMPLATE_VERSION,
+  getProjectVersion,
+  setProjectVersion,
+  compareVersions,
+  runMigrations
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sumulige-claude",
-  "version": "1.0.8",
+  "version": "1.0.11",
   "description": "The Best Agent Harness for Claude Code",
   "main": "cli.js",
   "bin": {
@@ -8,7 +8,9 @@
     "sumulige-claude": "cli.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch",
     "postinstall": "node cli.js init",
     "sync": "node scripts/sync-external.mjs",
     "update-registry": "node scripts/update-registry.mjs",
@@ -35,7 +37,10 @@
     "node": ">=16.0.0"
   },
   "devDependencies": {
+    "jest": "^30.2.0",
+    "mock-fs": "^5.5.0",
     "prettier": "^3.7.4",
+    "sinon": "^21.0.1",
     "yaml": "^2.8.2"
   }
 }

package/scripts/fix-hooks.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * Fix hooks format from old to new
+ * 旧格式：{"matcher": "...", "hooks": [...]}
+ * 新格式：{"UserPromptSubmit": [{"matcher": {}, "hooks": [...]}], ...}
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+const NEW_FORMAT = {
+  "UserPromptSubmit": [
+    {
+      "matcher": {},
+      "hooks": [
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/project-kickoff.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/rag-skill-loader.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs", "timeout": 1000 }
+      ]
+    }
+  ],
+  "PreToolUse": [
+    {
+      "matcher": {},
+      "hooks": [
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs", "timeout": 1000 }
+      ]
+    }
+  ],
+  "PostToolUse": [
+    {
+      "matcher": {},
+      "hooks": [
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/code-formatter.cjs", "timeout": 5000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/verify-work.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs", "timeout": 1000 }
+      ]
+    }
+  ],
+  "AgentStop": [
+    {
+      "matcher": {},
+      "hooks": [
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/verify-work.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/thinking-silent.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/multi-session.cjs", "timeout": 1000 },
+        { "type": "command", "command": "node \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/todo-manager.cjs", "timeout": 1000 }
+      ]
+    }
+  ]
+};
+
+function fixProject(projectPath) {
+  const settingsFile = path.join(projectPath, '.claude', 'settings.json');
+
+  if (!fs.existsSync(settingsFile)) {
+    console.log(`⚠️  ${projectPath} - no settings.json`);
+    return false;
+  }
+
+  let settings;
+  try {
+    settings = JSON.parse(fs.readFileSync(settingsFile, 'utf-8'));
+  } catch (e) {
+    console.log(`❌ ${projectPath} - invalid JSON`);
+    return false;
+  }
+
+  // 检测旧格式
+  const isOldFormat = settings.matcher || (settings.hooks && typeof settings.hooks === 'object');
+
+  if (!isOldFormat) {
+    console.log(`✅ ${projectPath} - already new format`);
+    return false;
+  }
+
+  // 写入新格式
+  fs.writeFileSync(settingsFile, JSON.stringify(NEW_FORMAT, null, 2) + '\n');
+  console.log(`🔧 ${projectPath} - fixed!`);
+  return true;
+}
+
+// CLI
+const args = process.argv.slice(2);
+
+if (args.length === 0) {
+  // 当前目录
+  fixProject(process.cwd());
+} else {
+  args.forEach(fixProject);
+}

package/template/.claude/commands/commit-push-pr.md

@@ -22,7 +22,27 @@ Analyze the changes and:
 2. Identify the main purpose of the changes
 3. Check if there are any sensitive files that shouldn't be committed
 
-## Step 3: Stage and Commit
+## Step 3: Code Simplification (Before Commit)
+
+**IMPORTANT**: Before creating the commit, simplify and refine the code changes:
+
+1. Review the recently modified code sections
+2. Apply code simplification focusing on:
+   - Code clarity and consistency
+   - Reducing unnecessary complexity and nesting
+   - Eliminating redundant code and abstractions
+   - Following project standards (if CLAUDE.md exists)
+   - Preserving exact functionality
+3. Use explicit, readable code over overly compact solutions
+
+**Trigger phrases to apply simplification**:
+- "简化此代码" (Simplify this code)
+- "使这更清晰" (Make this clearer)
+- "优化此实现" (Optimize this implementation)
+
+Ask the user: "是否需要简化代码？(Need code simplification?)" - if yes, apply code-simplifier agent before proceeding.
+
+## Step 4: Stage and Commit
 
 If there are unstaged changes that should be included, ask the user first.
 
@@ -36,7 +56,7 @@ Then create a commit with a clear message following this format:
 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 ```
 
-## Step 4: Push and Create PR
+## Step 5: Push and Create PR
 
 1. Push the changes to remote
 2. Check if there's an open PR for this branch using:
@@ -51,7 +71,7 @@ Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
      - Test plan (checklist)
      - Link to any related issues
 
-## Step 5: Verify
+## Step 6: Verify
 
 After creating the PR, show the PR URL and check CI status using:
 ```bash

package/template/.claude/hooks/conversation-logger.cjs

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+/**
+ * Conversation Logger - 增强版对话记录器
+ *
+ * 自动记录每次对话到 DAILY_CONVERSATION.md
+ * 按日期分组，无需手动触发
+ *
+ * 功能：
+ * - 捕获用户输入和 AI 输出
+ * - 记录工具使用
+ * - 按日期自动分组
+ * - 实时追加到日志
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const CONVERSATION_LOG = path.join(PROJECT_DIR, '.claude', 'DAILY_CONVERSATION.md');
+const THINKING_DIR = path.join(PROJECT_DIR, '.claude', 'thinking-routes');
+const FLOW_FILE = path.join(THINKING_DIR, '.conversation-flow.json');
+
+// 确保目录存在
+try { fs.mkdirSync(THINKING_DIR, { recursive: true }); } catch (e) {}
+
+// 获取当前日期字符串 (YYYY-MM-DD)
+function getDateStr() {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}
+
+// 获取当前时间字符串 (HH:MM)
+function getTimeStr() {
+  const now = new Date();
+  const hours = String(now.getHours()).padStart(2, '0');
+  const minutes = String(now.getMinutes()).padStart(2, '0');
+  return `${hours}:${minutes}`;
+}
+
+// 转义 Markdown 特殊字符
+function escapeMarkdown(text) {
+  if (!text) return '';
+  return text
+    .replace(/\|/g, '\\|')
+    .replace(/\n/g, ' ')
+    .slice(0, 500); // 限制长度
+}
+
+// 初始化日志文件
+function initLogFile() {
+  if (!fs.existsSync(CONVERSATION_LOG)) {
+    const header = `# 每日对话记录
+
+> 此文件由 conversation-logger.cjs 自动生成
+> 记录与 AI 的每次对话
+
+---
+`;
+    fs.writeFileSync(CONVERSATION_LOG, header, 'utf-8');
+  }
+}
+
+// 追加对话到日志
+function appendConversation(role, content, toolInfo = '') {
+  initLogFile();
+
+  const dateStr = getDateStr();
+  const timeStr = getTimeStr();
+  const roleLabel = role === 'user' ? '👤 用户' : role === 'assistant' ? '🤖 AI' : '🔧 工具';
+  const safeContent = escapeMarkdown(content);
+
+  const entry = `### ${timeStr} - ${roleLabel}
+${safeContent}${toolInfo ? `\n> ${toolInfo}` : ''}
+
+`;
+
+  // 读取现有内容
+  let logContent = fs.readFileSync(CONVERSATION_LOG, 'utf-8');
+
+  // 检查今天是否已有日期头
+  const todayHeader = `## ${dateStr}`;
+  const todayIndex = logContent.indexOf(todayHeader);
+
+  if (todayIndex === -1) {
+    // 今天还没有记录，添加新的日期头
+    const todaySection = `
+---
+
+## ${dateStr}
+
+${entry}
+`;
+    logContent += todaySection;
+  } else {
+    // 找到今天的记录位置，在末尾追加
+    // 使用正则确保只匹配 ## 开头的日期行，而不是 ### 开头的条目
+    const afterToday = logContent.slice(todayIndex + todayHeader.length);
+    const dateMatch = afterToday.match(/^## \d{4}-\d{2}-\d{2}/m);
+    const nextDateIndex = dateMatch ? todayIndex + todayHeader.length + dateMatch.index : -1;
+
+    if (nextDateIndex === -1) {
+      // 今天是最后一天，直接追加到文件末尾
+      logContent += entry;
+    } else {
+      // 在下一天之前插入
+      logContent = logContent.slice(0, nextDateIndex) + entry + logContent.slice(nextDateIndex);
+    }
+  }
+
+  // 写回文件
+  fs.writeFileSync(CONVERSATION_LOG, logContent, 'utf-8');
+}
+
+// 从思维轨迹读取并记录完整对话
+function syncFromFlowFile() {
+  if (!fs.existsSync(FLOW_FILE)) {
+    return;
+  }
+
+  try {
+    const flow = JSON.parse(fs.readFileSync(FLOW_FILE, 'utf-8'));
+    const turns = flow.turns || [];
+
+    if (turns.length === 0) return;
+
+    // 读取现有日志，记录已处理的 turn
+    const logContent = fs.existsSync(CONVERSATION_LOG)
+      ? fs.readFileSync(CONVERSATION_LOG, 'utf-8')
+      : '';
+    initLogFile();
+
+    // 简单的追踪：只记录最新的几次交互
+    const recentTurns = turns.slice(-5);
+
+    recentTurns.forEach(turn => {
+      const time = turn.time ? new Date(turn.time).toISOString() : '';
+      const toolName = turn.toolName || '';
+      const type = turn.type || '';
+
+      // 根据 turn 类型记录
+      if (type === 'potential-action' && toolName) {
+        appendConversation('tool', `[${toolName}]`, turn.description || '');
+      }
+    });
+  } catch (e) {
+    // 静默处理错误
+  }
+}
+
+// 主函数
+function main() {
+  try {
+    const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+    const toolName = process.env.CLAUDE_TOOL_NAME || '';
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+    const textOutput = process.env.CLAUDE_TEXT_OUTPUT || '';
+
+    // 根据事件类型记录
+    switch (eventType) {
+      case 'UserPromptSubmit':
+        // 用户提交输入
+        if (toolInput) {
+          appendConversation('user', toolInput);
+        }
+        break;
+
+      case 'TextOutput':
+        // AI 输出文本
+        if (textOutput) {
+          appendConversation('assistant', textOutput);
+        }
+        break;
+
+      case 'PostToolUse':
+        // 工具使用后
+        if (toolName) {
+          appendConversation('tool', toolInput, `使用工具: ${toolName}`);
+        }
+        break;
+
+      case 'AgentStop':
+        // 会话结束，同步思维轨迹
+        syncFromFlowFile();
+        break;
+    }
+
+  } catch (e) {
+    // 静默处理错误，不干扰正常对话
+  }
+
+  process.exit(0);
+}
+
+// 如果直接运行，执行同步
+if (require.main === module) {
+  if (process.argv.includes('--sync')) {
+    syncFromFlowFile();
+    console.log('✅ 已同步对话记录');
+  } else if (process.argv.includes('--view')) {
+    // 查看今日对话
+    if (fs.existsSync(CONVERSATION_LOG)) {
+      const content = fs.readFileSync(CONVERSATION_LOG, 'utf-8');
+      const today = getDateStr();
+      const start = content.indexOf(`## ${today}`);
+      if (start !== -1) {
+        const end = content.indexOf('## ', start + 10);
+        console.log(content.slice(start, end === -1 ? undefined : end));
+      } else {
+        console.log('📭 今天暂无对话记录');
+      }
+    } else {
+      console.log('📭 暂无对话记录');
+    }
+  } else {
+    main();
+  }
+}
+
+module.exports = { main, syncFromFlowFile, appendConversation };