devassist-agent 1.0.0

package/src/cli/commands/ask.js

@@ -0,0 +1,79 @@
+/**
+ * devassist ask <question> - Ask AI a question about your codebase
+ */
+
+const fs = require('fs');
+const path = require('path');
+const ai = require('../../ai/adapter');
+const qwen = require('../../ai/providers/qwen');
+const openai = require('../../ai/providers/openai');
+const claude = require('../../ai/providers/claude');
+const hunyuan = require('../../ai/providers/hunyuan');
+const { ConventionStore } = require('../../modules/dev-time/convention-store');
+
+ai.registerProvider('qwen', qwen);
+ai.registerProvider('openai', openai);
+ai.registerProvider('claude', claude);
+ai.registerProvider('hunyuan', hunyuan);
+
+module.exports = async function ask(projectRoot, args, ui) {
+  const { printHeader, c } = ui;
+  printHeader('Ask AI');
+
+  const question = args.filter(a => !a.startsWith('--')).join(' ');
+  if (!question) {
+    console.log(`  Usage: devassist ask ${c.gray('<your question>')}\n`);
+    console.log(`  ${c.gray('Example:')} devassist ask "Why is my API returning data.items instead of data.list?"\n`);
+    return;
+  }
+
+  // Load AI config
+  const configPath = path.join(projectRoot, '.devassist', 'ai-config.json');
+  let config = null;
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      // Override with env vars
+      if (!config.apiKey) {
+        const envMap = { qwen: 'DASHSCOPE_API_KEY', openai: 'OPENAI_API_KEY', claude: 'ANTHROPIC_API_KEY', hunyuan: 'HUNYUAN_API_KEY' };
+        const envVar = envMap[config.provider];
+        if (envVar && process.env[envVar]) {
+          config.apiKey = process.env[envVar];
+          config.enabled = true;
+        }
+      }
+    } catch (_) {}
+  }
+
+  if (!config || !config.enabled || !config.provider) {
+    console.log(`  ${c.yellow('AI 尚未配置。')}\n`);
+    console.log(`  ${c.gray('启用步骤：')}`);
+    console.log(`    1. 编辑 .devassist/ai-config.json`);
+    console.log(`    2. 设置 "provider": "qwen"（或 "openai" / "claude" / "hunyuan"）`);
+    console.log(`    3. 设置 "apiKey": "你的API密钥"`);
+    console.log(`    4. 设置 "enabled": true`);
+    console.log(`\n  ${c.gray('或设置环境变量：')}`);
+    console.log(`    ${c.bold('DASHSCOPE_API_KEY')} 通义千问`);
+    console.log(`    ${c.bold('OPENAI_API_KEY')} OpenAI`);
+    console.log(`    ${c.bold('ANTHROPIC_API_KEY')} Claude`);
+    console.log(`    ${c.bold('HUNYUAN_API_KEY')} 腾讯混元\n`);
+    return;
+  }
+
+  // Load conventions as context
+  const conventionStore = new ConventionStore(projectRoot);
+  const conventions = conventionStore.getPromptBlock({});
+
+  console.log(`  ${c.gray('Question:')} ${question}`);
+  console.log(`  ${c.gray('Provider:')} ${config.provider} (${config.model || 'default'})\n`);
+  console.log(`  ${c.gray('Thinking...')}\n`);
+
+  const result = await ai.ask(config, question, { conventions });
+
+  if (result.unavailable || result.error) {
+    console.log(`  ${c.red('AI error:')} ${result.content}\n`);
+  } else {
+    console.log(`  ${result.content}\n`);
+    if (result.model) console.log(`  ${c.gray('(model: ' + result.model + ')')}\n`);
+  }
+};

package/src/cli/commands/backup.js

@@ -0,0 +1,30 @@
+/**
+ * devassist backup - Create incremental backup
+ * devassist restore - Restore from backup (non-destructive)
+ */
+
+const { VersionManager } = require('../../modules/dev-time/version-manager');
+
+module.exports = function backup(projectRoot, args, ui) {
+  const { printHeader, c } = ui;
+  printHeader('创建备份');
+
+  const vm = new VersionManager(projectRoot);
+  const label = args.find(a => !a.startsWith('--')) || '手动备份';
+
+  const manifest = vm.backup(label);
+  console.log(`  ${c.green('备份已创建：')} ${manifest.versionId}`);
+  console.log(`  ${c.bold('标签：')} ${manifest.label}`);
+  console.log(`  ${c.bold('文件：')} 共 ${manifest.files.length} 个`);
+  console.log(`           ${manifest.files.filter(f => f.status === 'new').length} 新增`);
+  console.log(`           ${manifest.files.filter(f => f.status === 'changed').length} 变更`);
+  console.log(`           ${manifest.files.filter(f => f.status === 'unchanged').length} 未变\n`);
+
+  // Also list available versions
+  const versions = vm.listVersions();
+  console.log(`  ${c.gray('可用备份：')}`);
+  for (const v of versions.slice(-5)) {
+    console.log(`    ${c.blue(v.versionId)} ${c.gray(v.label)} ${c.gray('(' + v.stats.total + ' 个文件)')}`);
+  }
+  console.log();
+};

package/src/cli/commands/check.js

@@ -0,0 +1,327 @@
+/**
+ * devassist check - Run all dev-time checks
+ *
+ * Executes:
+ *   1. CodeQualityGuard rules (16 rules: null safety, race conditions, duplicates, etc.)
+ *   2. ConventionStore checks (naming, patterns)
+ *   3. ImpactAnalyzer (if git diff available, check change impact)
+ *   4. ArchRiskAssessor (complexity, circular deps, injection)
+ *   5. SchemaRegistry drift detection (data.list vs data.items)
+ *   6. TechDebtTracker scan (file size, coupling, duplication)
+ *
+ * Post-processing:
+ *   - Apply .devassist/config.json rule overrides (enable/disable/severity)
+ *   - Filter out findings covered by inline ignore comments
+ *   - Enrich findings with code context for AI analysis
+ *
+ * If --ai flag is set, sends suspect findings to AI for deep analysis.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Core
+const { engine } = require('../../core/rule-engine');
+
+// Shared utilities
+const { collectFileContents } = require('../shared/file-collector');
+const { loadConfig, applyConfigToFindings } = require('../shared/config-loader');
+const { filterIgnored } = require('../shared/inline-ignore');
+const { enrichWithContext } = require('../shared/code-context');
+
+// Modules
+const { ConventionStore } = require('../../modules/dev-time/convention-store');
+const { codeQualityRules } = require('../../modules/dev-time/code-quality-guard');
+const { ImpactAnalyzer } = require('../../modules/dev-time/impact-analyzer');
+const { ArchRiskAssessor } = require('../../modules/dev-time/arch-risk-assessor');
+const { TechDebtTracker } = require('../../modules/dev-time/tech-debt-tracker');
+const { SchemaRegistry } = require('../../modules/dev-time/schema-registry');
+
+// AI
+const ai = require('../../ai/adapter');
+const qwen = require('../../ai/providers/qwen');
+const openai = require('../../ai/providers/openai');
+const claude = require('../../ai/providers/claude');
+const hunyuan = require('../../ai/providers/hunyuan');
+const { loadAIConfig, PROVIDER_INFO, computeAgreementStats } = require('./ai');
+
+// Register AI providers
+ai.registerProvider('qwen', qwen);
+ai.registerProvider('openai', openai);
+ai.registerProvider('claude', claude);
+ai.registerProvider('hunyuan', hunyuan);
+
+module.exports = async function check(projectRoot, args, ui) {
+  const { printHeader, printFinding, printStats, c } = ui;
+  const isPreCommit = args.includes('--pre-commit');
+  const useAI = args.includes('--ai');
+  const useCompare = args.includes('--compare');
+  const jsonOutput = args.includes('--json');
+
+  printHeader('运行全部检查');
+
+  // Load project config
+  const config = loadConfig(projectRoot);
+
+  // Collect all source files
+  const fileContents = collectFileContents(projectRoot);
+  if (fileContents.length === 0) {
+    console.log(`  ${c.yellow('未找到源文件。')} 请确认项目目录是否正确。\n`);
+    return;
+  }
+
+  const ctx = {
+    files: fileContents,
+    projectRoot,
+    config,
+  };
+
+  // 1. Register and run CodeQualityGuard rules
+  engine.registerBatch(codeQualityRules);
+
+  // 2. Load conventions and add convention rules
+  const conventionStore = new ConventionStore(projectRoot);
+  engine.register({
+    id: 'convention-check',
+    severity: 'warn',
+    category: 'convention',
+    check(ctx) {
+      const allFindings = [];
+      for (const file of ctx.files) {
+        const findings = conventionStore.check(file.path, file.content);
+        allFindings.push(...findings);
+      }
+      return allFindings.length > 0 ? allFindings : null;
+    }
+  });
+
+  // Run rule engine
+  const { findings, stats } = engine.run(ctx);
+
+  // 3. Impact analysis (if git diff available)
+  let impactFindings = [];
+  if (!isPreCommit) {
+    try {
+      const { execSync } = require('child_process');
+      const diff = execSync('git diff --name-only HEAD 2>/dev/null', { cwd: projectRoot, encoding: 'utf-8' }).trim();
+      if (diff) {
+        const impactAnalyzer = new ImpactAnalyzer(projectRoot);
+        impactAnalyzer.buildGraph();
+        const changedFiles = diff.split('\n').filter(f => f);
+        for (const file of changedFiles) {
+          const fullPath = path.join(projectRoot, file);
+          if (fs.existsSync(fullPath)) {
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const result = impactAnalyzer.analyzeChange(fullPath, content);
+            impactFindings.push(...result.findings);
+          }
+        }
+      }
+    } catch (_) {} // Not a git repo or no changes
+  }
+
+  // 4. Architecture risk assessment
+  const archAssessor = new ArchRiskAssessor(projectRoot);
+  const archFindings = [];
+  for (const file of fileContents) {
+    const findings = archAssessor.analyzeFile(file.path, file.content);
+    archFindings.push(...findings);
+  }
+
+  // 5. SchemaRegistry drift detection
+  const schemaRegistry = new SchemaRegistry(projectRoot);
+  const schemaFindings = schemaRegistry.detectDrift ? schemaRegistry.detectDrift(fileContents) : [];
+
+  // 6. TechDebtTracker scan
+  let debtFindings = [];
+  try {
+    const debtTracker = new TechDebtTracker(projectRoot);
+    const debtBoard = debtTracker.scan();
+    if (debtBoard && debtBoard.items) {
+      // Convert high-priority debt items to findings
+      debtFindings = debtBoard.items
+        .filter(item => item.severity === 'high')
+        .slice(0, 10) // limit to top 10
+        .map(item => ({
+          severity: 'warn',
+          message: `技术债务：${item.description || item.type || '未知问题'}`,
+          file: item.file || '(unknown)',
+          line: item.line || 1,
+          suggestion: `优先级 ${item.priority ? item.priority.toFixed(2) : '?'}，预估修复工时 ${item.effort || '?'}。运行 devassist debt --scan 查看详情。`,
+          ruleId: 'debt-tracker',
+          category: 'tech-debt',
+        }));
+    }
+  } catch (_) {}
+
+  // Merge all findings
+  let allFindings = [...findings, ...impactFindings, ...archFindings, ...schemaFindings, ...debtFindings];
+
+  // Post-processing: apply config-based rule overrides
+  allFindings = applyConfigToFindings(config, allFindings);
+
+  // Post-processing: filter inline ignore comments
+  allFindings = filterIgnored(allFindings, fileContents);
+
+  // Enrich with code context for AI analysis
+  allFindings = enrichWithContext(allFindings, fileContents);
+
+  // 7. AI analysis (optional)
+  let finalFindings = allFindings;
+  let aiConfig = null;
+  if (useAI || useCompare || (config.ai && config.ai.autoAnalyze)) {
+    aiConfig = loadAIConfig(projectRoot);
+    if (aiConfig && aiConfig.engines && aiConfig.engines.length > 0) {
+      const readyEngines = aiConfig.engines.filter(e => e.enabled && e.apiKey);
+      if (readyEngines.length > 0) {
+        const aiContext = { conventions: conventionStore.getRelevant({}), projectInfo: { root: projectRoot } };
+
+        if (useCompare && readyEngines.length >= 2) {
+          // Multi-engine comparison mode
+          console.log(`  ${c.cyan(`${readyEngines.length} 引擎对比模式：`)}${readyEngines.map(e => e.provider).join(' + ')}`);
+          console.log(`  ${c.gray('正在并行分析...')}\n`);
+          finalFindings = await ai.multiAnalyze(readyEngines, allFindings, aiContext);
+        } else {
+          // Single engine mode (use primary/first engine)
+          console.log(`  ${c.cyan('AI 分析模式：')}${readyEngines[0].provider}`);
+          finalFindings = await ai.analyze(readyEngines[0], allFindings, aiContext);
+        }
+      } else {
+        console.log(`  ${c.gray('（AI 引擎未就绪。请在 .devassist/ai-config.json 中配置 API Key）')}\n`);
+      }
+    } else {
+      console.log(`  ${c.gray('（AI 分析已禁用。请在 .devassist/ai-config.json 中配置）')}\n`);
+    }
+  }
+
+  // Output
+  if (jsonOutput) {
+    console.log(JSON.stringify({ findings: finalFindings, stats }, null, 2));
+    saveFindings(projectRoot, finalFindings, stats);
+    return;
+  }
+
+  // Save findings for ai --analyze (even in non-json mode)
+  saveFindings(projectRoot, finalFindings, stats);
+
+  // Save check history
+  saveHistory(projectRoot, finalFindings);
+
+  // Generate comparison HTML report if in compare mode
+  if (useCompare && finalFindings.some(f => f.aiAnalyses && f.aiAnalyses.length >= 2)) {
+    saveComparisonReport(projectRoot, finalFindings, aiConfig, c);
+  }
+
+  // Print findings
+  if (finalFindings.length === 0) {
+    console.log(`  ${c.green('全部检查通过！')} 未发现问题。\n`);
+    return;
+  }
+
+  for (const f of finalFindings) {
+    printFinding(f);
+  }
+  printStats({
+    ...stats,
+    blocks: finalFindings.filter(f => f.severity === 'block').length,
+    warnings: finalFindings.filter(f => f.severity === 'warn').length,
+    infos: finalFindings.filter(f => f.severity === 'info').length,
+  });
+
+  // Exit code for pre-commit
+  const hasBlocks = finalFindings.some(f => f.severity === 'block');
+  if (hasBlocks && isPreCommit) {
+    console.log(`  ${c.red('提交已阻断。')} 请修复 BLOCK 级别问题，或使用 ${c.bold('git commit --no-verify')} 跳过检查。\n`);
+    process.exit(1);
+  }
+};
+
+function saveFindings(projectRoot, findings, stats) {
+  const reportDir = path.join(projectRoot, '.devassist', 'reports');
+  if (!fs.existsSync(reportDir)) fs.mkdirSync(reportDir, { recursive: true });
+  const reportPath = path.join(reportDir, 'latest.json');
+  fs.writeFileSync(reportPath, JSON.stringify({
+    generatedAt: new Date().toISOString(),
+    findings,
+    stats,
+  }, null, 2), 'utf-8');
+}
+
+function saveHistory(projectRoot, findings) {
+  const historyDir = path.join(projectRoot, '.devassist', 'history');
+  if (!fs.existsSync(historyDir)) fs.mkdirSync(historyDir, { recursive: true });
+  const now = new Date();
+  const dateStr = `${now.getFullYear()}-${String(now.getMonth()+1).padStart(2,'0')}-${String(now.getDate()).padStart(2,'0')}`;
+  const entry = {
+    date: now.toISOString(),
+    blocks: findings.filter(f => f.severity === 'block').length,
+    warnings: findings.filter(f => f.severity === 'warn').length,
+    infos: findings.filter(f => f.severity === 'info').length,
+    total: findings.length,
+  };
+
+  // Append to daily history file
+  const historyFile = path.join(historyDir, `${dateStr}.json`);
+  let entries = [];
+  if (fs.existsSync(historyFile)) {
+    try { entries = JSON.parse(fs.readFileSync(historyFile, 'utf-8')); } catch (_) {}
+  }
+  entries.push(entry);
+  fs.writeFileSync(historyFile, JSON.stringify(entries, null, 2), 'utf-8');
+
+  // Clean up history older than 90 days
+  try {
+    const files = fs.readdirSync(historyDir);
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - 90);
+    for (const f of files) {
+      if (!f.endsWith('.json')) continue;
+      const fileDate = new Date(f.replace('.json', ''));
+      if (fileDate < cutoff) {
+        fs.unlinkSync(path.join(historyDir, f));
+      }
+    }
+  } catch (_) {}
+}
+
+function saveComparisonReport(projectRoot, findings, aiConfig, c) {
+  const { generateComparisonHTML } = require('./comparison-report');
+  const watchList = require('../shared/watch-list');
+  const readyEngines = aiConfig.engines.filter(e => e.enabled && e.apiKey);
+  const stats = computeAgreementStats(findings, readyEngines.length);
+
+  // Auto-add disagreement findings to watch list
+  const deferredCount = watchList.addDeferredFindings(projectRoot, findings,
+    '待观察：引擎判断不一致，等运行时验证');
+
+  const html = generateComparisonHTML({
+    projectRoot: path.basename(projectRoot),
+    timestamp: new Date().toISOString(),
+    engines: readyEngines.map(e => ({ provider: e.provider, model: e.model, name: e.name })),
+    stats,
+    findings,
+  });
+
+  const reportDir = path.join(projectRoot, '.devassist', 'reports');
+  if (!fs.existsSync(reportDir)) fs.mkdirSync(reportDir, { recursive: true });
+  const htmlPath = path.join(reportDir, 'ai-comparison.html');
+  fs.writeFileSync(htmlPath, html, 'utf-8');
+
+  // Also save JSON
+  const jsonPath = path.join(reportDir, 'ai-comparison.json');
+  fs.writeFileSync(jsonPath, JSON.stringify({
+    analyzedAt: new Date().toISOString(),
+    engines: readyEngines.map(e => ({ provider: e.provider, model: e.model, name: e.name })),
+    stats,
+    findings,
+  }, null, 2), 'utf-8');
+
+  console.log(`  ${c.green('多引擎对比报告已生成：')}`);
+  console.log(`    HTML:  .devassist/reports/ai-comparison.html`);
+  console.log(`    JSON:  .devassist/reports/ai-comparison.json`);
+  if (deferredCount > 0) {
+    console.log(`  ${c.yellow(`⏳ ${deferredCount} 个判断不一致的发现已标记为待观察（.devassist/watch-list.json）`)}`);
+    console.log(`  ${c.gray('暂不修复，等实际运行验证后再处理。')}`);
+  }
+  console.log('');
+}

package/src/cli/commands/clean.js

@@ -0,0 +1,130 @@
+/**
+ * devassist clean - Clean up old reports, backups, and history
+ *
+ * Usage:
+ *   devassist clean              # Clean items older than 30 days
+ *   devassist clean --days 7     # Clean items older than 7 days
+ *   devassist clean --all        # Clean all except latest
+ *   devassist clean --dry-run    # Show what would be cleaned without deleting
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+module.exports = function clean(projectRoot, args, ui) {
+  const { printHeader, c } = ui;
+  printHeader('清理旧文件');
+
+  const dryRun = args.includes('--dry-run');
+  const cleanAll = args.includes('--all');
+  const daysIdx = args.indexOf('--days');
+  const days = daysIdx >= 0 ? parseInt(args[daysIdx + 1]) || 30 : 30;
+
+  const configDir = path.join(projectRoot, '.devassist');
+  if (!fs.existsSync(configDir)) {
+    console.log(`  ${c.yellow('项目未初始化。')} 运行 devassist init 后再使用清理。\n`);
+    return;
+  }
+
+  const cutoff = new Date();
+  cutoff.setDate(cutoff.getDate() - days);
+
+  let totalFiles = 0;
+  let totalSize = 0;
+
+  // 1. Clean reports
+  const reportDir = path.join(configDir, 'reports');
+  if (fs.existsSync(reportDir)) {
+    console.log(`  ${c.bold('报告目录 (.devassist/reports/)')}`);
+    const files = fs.readdirSync(reportDir);
+    for (const file of files) {
+      if (file === 'latest.html' || file === 'latest.json') continue; // always keep latest
+      const filePath = path.join(reportDir, file);
+      const stat = fs.statSync(filePath);
+      const shouldClean = cleanAll || stat.mtime < cutoff;
+      if (shouldClean) {
+        const sizeKB = (stat.size / 1024).toFixed(1);
+        console.log(`    ${c.gray('删除')} ${file} ${c.gray(`(${sizeKB} KB, ${stat.mtime.toISOString().slice(0, 10)})`)}`);
+        totalFiles++;
+        totalSize += stat.size;
+        if (!dryRun) fs.unlinkSync(filePath);
+      }
+    }
+    console.log('');
+  }
+
+  // 2. Clean backups
+  const backupDir = path.join(configDir, 'backups');
+  if (fs.existsSync(backupDir)) {
+    console.log(`  ${c.bold('备份目录 (.devassist/backups/)')}`);
+    const entries = fs.readdirSync(backupDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const dirPath = path.join(backupDir, entry.name);
+        const manifestPath = path.join(dirPath, 'manifest.json');
+        let dirTime = new Date(0);
+        if (fs.existsSync(manifestPath)) {
+          try {
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+            dirTime = new Date(manifest.createdAt || 0);
+          } catch (_) { dirTime = fs.statSync(dirPath).mtime; }
+        } else {
+          dirTime = fs.statSync(dirPath).mtime;
+        }
+        const shouldClean = cleanAll || dirTime < cutoff;
+        if (shouldClean) {
+          // Calculate size
+          let dirSize = 0;
+          const innerFiles = fs.readdirSync(dirPath);
+          for (const f of innerFiles) {
+            dirSize += fs.statSync(path.join(dirPath, f)).size;
+          }
+          const sizeKB = (dirSize / 1024).toFixed(1);
+          console.log(`    ${c.gray('删除')} ${entry.name}/ ${c.gray(`(${sizeKB} KB, ${dirTime.toISOString().slice(0, 10)})`)}`);
+          totalFiles++;
+          totalSize += dirSize;
+          if (!dryRun) {
+            for (const f of innerFiles) fs.unlinkSync(path.join(dirPath, f));
+            fs.rmdirSync(dirPath);
+          }
+        }
+      }
+    }
+    console.log('');
+  }
+
+  // 3. Clean history
+  const historyDir = path.join(configDir, 'history');
+  if (fs.existsSync(historyDir)) {
+    console.log(`  ${c.bold('历史记录目录 (.devassist/history/)')}`);
+    const files = fs.readdirSync(historyDir);
+    for (const file of files) {
+      if (!file.endsWith('.json')) continue;
+      const filePath = path.join(historyDir, file);
+      const stat = fs.statSync(filePath);
+      const fileDate = new Date(file.replace('.json', ''));
+      const shouldClean = cleanAll || fileDate < cutoff;
+      if (shouldClean) {
+        const sizeKB = (stat.size / 1024).toFixed(1);
+        console.log(`    ${c.gray('删除')} ${file} ${c.gray(`(${sizeKB} KB)`)}`);
+        totalFiles++;
+        totalSize += stat.size;
+        if (!dryRun) fs.unlinkSync(filePath);
+      }
+    }
+    console.log('');
+  }
+
+  // Summary
+  const sizeMB = (totalSize / (1024 * 1024)).toFixed(2);
+  if (totalFiles === 0) {
+    console.log(`  ${c.green('无需清理。')} 没有超过 ${days} 天的旧文件。\n`);
+  } else {
+    const action = dryRun ? '将删除' : '已删除';
+    console.log(`  ${c.green(action + ' ' + totalFiles + ' 个文件')}，释放 ${sizeMB} MB 空间。`);
+    if (dryRun) {
+      console.log(`  ${c.gray('（--dry-run 模式，未实际删除。移除 --dry-run 执行清理。）')}`);
+    }
+    console.log('');
+  }
+};