sumulige-claude 1.0.11 → 1.1.1

package/.claude/commands/todos.md

@@ -14,12 +14,37 @@ cat development/todos/INDEX.md
 
 ## Task Operations
 
+### Task Types (v2.0)
+
+任务管理系统支持 R-D-T 三阶段生命周期：
+
+```
+Research (研究) → Develop (开发) → Test (测试) → Done (完成)
+```
+
+| 类型 | 图标 | 目录 | 说明 |
+|------|------|------|------|
+| Research | 📊 | `active/research/` | 调研/设计/探索 |
+| Develop | 💻 | `active/develop/` | 实现/编码/重构 |
+| Test | 🧪 | `active/test/` | 测试/验证/QA |
+
+### Task Templates
+
+使用 `.claude/templates/tasks/` 中的模板创建任务：
+
+- **研究任务**: `.claude/templates/tasks/research.md`
+- **开发任务**: `.claude/templates/tasks/develop.md`
+- **测试任务**: `.claude/templates/tasks/test.md`
+
 ### Create a New Task
 
 When user asks to create a task:
-1. Create file in `development/todos/active/`
-2. Use kebab-case for filename (e.g., `user-login.md`)
-3. Use the template format:
+1. Determine the task type (research/develop/test)
+2. Create file in `development/todos/active/{type}/`
+3. Use kebab-case for filename (e.g., `user-authentication.md`)
+4. Copy from the corresponding template
+
+#### Task Template (Legacy Format)
 
 ```markdown
 # [Task Name]
@@ -59,9 +84,19 @@ When user asks to create a task:
 ### Update Task Status
 
 To move a task:
-- **Complete**: Move from `active/` to `completed/`
-- **Backlog**: Move from `active/` to `backlog/`
-- **Archive**: Move from `completed/` to `archived/`
+- **Complete**: Move from `active/{type}/` to `completed/{type}/`
+- **Backlog**: Move from `active/{type}/` to `backlog/{type}/`
+- **Archive**: Move from `completed/{type}/` to `archived/{type}/`
+
+Example: Move `active/develop/auth.md` → `completed/develop/auth.md`
+
+### Auto-Transition Suggestions
+
+When a develop task is completed, the todo-manager will suggest creating a corresponding test task. Check with:
+
+```bash
+node .claude/hooks/todo-manager.cjs --suggest
+```
 
 ### Update Task Progress
 

package/.claude/hooks/pre-commit.cjs

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * Pre-commit Quality Gate
+ *
+ * Runs quality checks before committing.
+ * Fails the commit if critical or error issues are found.
+ *
+ * Install: ln -s ../../.claude/hooks/pre-commit.cjs .git/hooks/pre-commit
+ * Or use: smc hooks install
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+async function main() {
+  // Check if quality gate is enabled
+  const configPath = path.join(projectDir, '.claude', 'quality-gate.json');
+  let config = { enabled: true, gates: { preCommit: true } };
+
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    } catch {}
+  }
+
+  if (!config.enabled || !config.gates?.preCommit) {
+    process.exit(0);
+  }
+
+  // Get staged files
+  let stagedFiles = [];
+  try {
+    const output = execSync('git diff --cached --name-only --diff-filter=ACM', {
+      encoding: 'utf-8',
+      stdio: 'pipe'
+    });
+    stagedFiles = output.trim().split('\n').filter(Boolean);
+  } catch {
+    // Not in git repo or no staged files
+    process.exit(0);
+  }
+
+  if (stagedFiles.length === 0) {
+    process.exit(0);
+  }
+
+  // Filter to checkable files
+  const checkable = stagedFiles.filter(f => {
+    const ext = path.extname(f);
+    return ['.js', '.ts', '.jsx', '.tsx', '.cjs', '.mjs', '.json', '.md'].includes(ext);
+  });
+
+  if (checkable.length === 0) {
+    process.exit(0);
+  }
+
+  console.log(`Running pre-commit quality checks on ${checkable.length} file(s)...`);
+
+  // Run quality gate
+  const { QualityGate } = require(path.join(__dirname, '..', '..', 'lib', 'quality-gate.js'));
+  const gate = new QualityGate({
+    projectDir,
+    config
+  });
+
+  const result = await gate.check({
+    files: checkable.map(f => path.join(projectDir, f)),
+    severity: 'error' // Block on errors and critical only
+  });
+
+  if (!result.passed) {
+    console.error('\nPre-commit quality gate failed.');
+    console.error('Fix issues or use --no-verify to bypass (not recommended).\n');
+    process.exit(1);
+  }
+
+  console.log('Pre-commit quality checks passed.\n');
+}
+
+main().catch(err => {
+  console.error('Pre-commit hook error:', err.message);
+  process.exit(1);
+});

package/.claude/hooks/pre-push.cjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * Pre-push Quality Gate
+ *
+ * Runs full quality checks before pushing.
+ * More comprehensive than pre-commit.
+ *
+ * Install: ln -s ../../.claude/hooks/pre-push.cjs .git/hooks/pre-push
+ * Or use: smc hooks install
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+async function main() {
+  // Check if quality gate is enabled
+  const configPath = path.join(projectDir, '.claude', 'quality-gate.json');
+  let config = { enabled: true, gates: { prePush: true } };
+
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    } catch {}
+  }
+
+  if (!config.enabled || !config.gates?.prePush) {
+    process.exit(0);
+  }
+
+  console.log('Running pre-push quality checks...\n');
+
+  // Get all files that will be pushed
+  let filesToCheck = [];
+  try {
+    // Get files changed since last push
+    const upstream = execSync('git rev-parse --abbrev-ref --symbolic-full-name @{u}', {
+      encoding: 'utf-8',
+      stdio: 'pipe'
+    }).trim() || 'origin/main';
+
+    const output = execSync(`git diff --name-only ${upstream}...HEAD`, {
+      encoding: 'utf-8',
+      stdio: 'pipe'
+    });
+    filesToCheck = output.trim().split('\n').filter(Boolean);
+  } catch {
+    // No upstream or other git error - check staged files only
+    try {
+      const output = execSync('git diff --cached --name-only --diff-filter=ACM', {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      filesToCheck = output.trim().split('\n').filter(Boolean);
+    } catch {
+      // Not in git repo
+      process.exit(0);
+    }
+  }
+
+  if (filesToCheck.length === 0) {
+    process.exit(0);
+  }
+
+  // Filter to checkable files
+  const checkable = filesToCheck.filter(f => {
+    const ext = path.extname(f);
+    return ['.js', '.ts', '.jsx', '.tsx', '.cjs', '.mjs', '.json', '.md'].includes(ext);
+  });
+
+  if (checkable.length === 0) {
+    process.exit(0);
+  }
+
+  console.log(`Checking ${checkable.length} changed file(s)...\n`);
+
+  // Run quality gate
+  const { QualityGate } = require(path.join(__dirname, '..', '..', 'lib', 'quality-gate.js'));
+  const gate = new QualityGate({
+    projectDir,
+    config
+  });
+
+  const result = await gate.check({
+    files: checkable.map(f => path.join(projectDir, f)),
+    severity: 'warn' // Block on warnings too for push
+  });
+
+  if (!result.passed) {
+    console.error('\nPush blocked by quality gate.');
+    console.error('Fix issues or use --no-verify to bypass (not recommended).\n');
+    process.exit(1);
+  }
+
+  console.log('All quality checks passed. Proceeding with push.\n');
+}
+
+main().catch(err => {
+  console.error('Pre-push hook error:', err.message);
+  process.exit(1);
+});

package/.claude/hooks/session-restore.cjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * Session Restore Hook - Restore conversation context from file
+ *
+ * Provides context continuity across sessions
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const SESSIONS_DIR = path.join(PROJECT_DIR, '.claude', 'sessions');
+const MEMORY_FILE = path.join(PROJECT_DIR, '.claude', 'MEMORY.md');
+
+/**
+ * Get latest session
+ */
+function getLatestSession() {
+  if (!fs.existsSync(SESSIONS_DIR)) {
+    return null;
+  }
+  
+  const files = fs.readdirSync(SESSIONS_DIR)
+    .filter(f => f.startsWith('session_') && f.endsWith('.md'))
+    .sort()
+    .reverse();
+  
+  if (files.length === 0) {
+    return null;
+  }
+  
+  const latestFile = files[0];
+  const filepath = path.join(SESSIONS_DIR, latestFile);
+  const content = fs.readFileSync(filepath, 'utf-8');
+  
+  return {
+    file: latestFile,
+    path: filepath,
+    content: content
+  };
+}
+
+/**
+ * Get recent memory entries
+ */
+function getRecentMemory(days = 7) {
+  if (!fs.existsSync(MEMORY_FILE)) {
+    return '';
+  }
+  
+  const content = fs.readFileSync(MEMORY_FILE, 'utf-8');
+  const entries = content.split('## ').slice(1, days + 1);
+  
+  return entries.join('## ');
+}
+
+/**
+ * Format context summary for display
+ */
+function formatContextSummary(latestSession, recentMemory) {
+  let summary = '';
+  
+  if (latestSession) {
+    summary += `\n📁 Last Session: ${latestSession.file}\n`;
+    summary += `   Date: ${fs.statSync(latestSession.path).mtime.toLocaleString()}\n`;
+  }
+  
+  const memoryEntries = recentMemory.split('\n').filter(l => l.trim()).length;
+  if (memoryEntries > 0) {
+    summary += `\n💾 Memory Entries: ${memoryEntries}\n`;
+  }
+  
+  return summary;
+}
+
+// Main execution
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  
+  if (args[0] === '--latest') {
+    const session = getLatestSession();
+    if (session) {
+      console.log(session.content);
+    } else {
+      console.log('No sessions found.');
+    }
+  } else if (args[0] === '--memory') {
+    const memory = getRecentMemory(parseInt(args[1]) || 7);
+    console.log('# Recent Memory\n');
+    console.log(memory);
+  } else if (args[0] === '--summary') {
+    const session = getLatestSession();
+    const memory = getRecentMemory();
+    console.log(formatContextSummary(session, memory));
+  } else {
+    console.log('Usage: node session-restore.cjs [--latest|--memory|--summary]');
+  }
+}
+
+exports.getLatestSession = getLatestSession;
+exports.getRecentMemory = getRecentMemory;
+exports.formatContextSummary = formatContextSummary;

package/.claude/hooks/session-save.cjs

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+/**
+ * Session Save Hook - Save conversation context to file
+ *
+ * Triggered after each conversation turn
+ * Saves conversation history, context, and state
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const SESSIONS_DIR = path.join(PROJECT_DIR, '.claude', 'sessions');
+const MEMORY_FILE = path.join(PROJECT_DIR, '.claude', 'MEMORY.md');
+
+// Ensure sessions directory exists
+if (!fs.existsSync(SESSIONS_DIR)) {
+  fs.mkdirSync(SESSIONS_DIR, { recursive: true });
+}
+
+/**
+ * Generate session filename
+ */
+function getSessionFilename() {
+  const now = new Date();
+  const date = now.toISOString().split('T')[0];
+  const time = now.toTimeString().split(' ')[0].replace(/:/g, '-');
+  return `session_${date}_${time}.md`;
+}
+
+/**
+ * Save session context
+ */
+function saveSession(context) {
+  const filename = getSessionFilename();
+  const filepath = path.join(SESSIONS_DIR, filename);
+  
+  const content = `# Session - ${new Date().toISOString()}
+
+> Type: ${context.type || 'chat'}
+> Model: ${context.model || 'unknown'}
+> Duration: ${context.duration || 'unknown'}
+
+---
+
+## Summary
+
+${context.summary || 'No summary provided'}
+
+---
+
+## Context
+
+\`\`\`json
+${JSON.stringify(context.metadata || {}, null, 2)}
+\`\`\`
+
+---
+
+## Key Points
+
+${(context.keyPoints || []).map((p, i) => `${i + 1}. ${p}`).join('\n')}
+
+---
+
+## Artifacts
+
+${(context.artifacts || []).map(a => `- ${a}`).join('\n') || 'None'}
+
+---
+
+## Next Steps
+
+${context.nextSteps || 'None'}
+
+---
+
+*Session saved at: ${new Date().toISOString()}*
+`;
+
+  fs.writeFileSync(filepath, content, 'utf-8');
+  
+  // Update sessions index
+  updateSessionsIndex();
+  
+  return filename;
+}
+
+/**
+ * Update sessions index
+ */
+function updateSessionsIndex() {
+  const files = fs.readdirSync(SESSIONS_DIR)
+    .filter(f => f.endsWith('.md'))
+    .sort()
+    .reverse();
+  
+  const indexPath = path.join(SESSIONS_DIR, 'INDEX.md');
+  
+  let content = `# Sessions Index
+
+> Total sessions: ${files.length}
+> Last updated: ${new Date().toISOString()}
+
+---
+
+## Recent Sessions
+
+${files.slice(0, 20).map(f => {
+  const filepath = path.join(SESSIONS_DIR, f);
+  const stat = fs.statSync(filepath);
+  return `- [${f}](${f}) - ${stat.mtime.toISOString()}`;
+}).join('\n')}
+
+---
+`;
+  
+  fs.writeFileSync(indexPath, content, 'utf-8');
+}
+
+/**
+ * Update MEMORY.md with latest context
+ */
+function updateMemory(context) {
+  const timestamp = new Date().toISOString();
+  
+  let content = '';
+  
+  if (fs.existsSync(MEMORY_FILE)) {
+    content = fs.readFileSync(MEMORY_FILE, 'utf-8');
+  }
+  
+  // Check if we need to add a new entry
+  const newEntry = `\n## ${timestamp.split('T')[0]}\n\n${
+    context.summary || context.keyPoints?.join('\n') || 'No details'
+  }\n`;
+  
+  // Keep only last 7 days
+  const entries = content.split('## ').slice(1, 8);
+  content = '# Memory\n\n<!-- Project memory updated by AI -->\n' + 
+    '## ' + entries.join('## ') + newEntry;
+  
+  fs.writeFileSync(MEMORY_FILE, content, 'utf-8');
+}
+
+// Main execution
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  
+  if (args[0] === '--save' && args[1]) {
+    const contextData = JSON.parse(fs.readFileSync(args[1], 'utf-8'));
+    const filename = saveSession(contextData);
+    console.log(`✅ Session saved: ${filename}`);
+    
+    if (contextData.addToMemory !== false) {
+      updateMemory(contextData);
+      console.log(`✅ Memory updated`);
+    }
+  }
+}
+
+exports.saveSession = saveSession;
+exports.updateMemory = updateMemory;
+exports.updateSessionsIndex = updateSessionsIndex;