devassist-agent 1.0.0

package/src/cli/commands/report.js

@@ -0,0 +1,310 @@
+/**
+ * devassist report - Generate HTML check report
+ *
+ * Runs full check and generates a styled HTML report with:
+ *   - Summary statistics
+ *   - Findings grouped by severity
+ *   - File distribution
+ *   - Rule trigger statistics
+ *   - Fix suggestions
+ *
+ * Usage:
+ *   devassist report              # Generate report
+ *   devassist report --ai         # Include AI analysis
+ *   devassist report --open       # Open in browser after generating
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Core
+const { engine } = require('../../core/rule-engine');
+
+// 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');
+
+// Shared utilities
+const { collectFileContents } = require('../shared/file-collector');
+const { loadConfig, applyConfigToFindings } = require('../shared/config-loader');
+const { filterIgnored } = require('../shared/inline-ignore');
+
+module.exports = async function report(projectRoot, args, ui) {
+  const { printHeader, c } = ui;
+  const useAI = args.includes('--ai');
+  const openBrowser = args.includes('--open');
+
+  printHeader('生成报告');
+
+  // Collect files using shared utility
+  const fileContents = collectFileContents(projectRoot);
+  if (fileContents.length === 0) {
+    console.log(`  ${c.yellow('未找到源文件。')}\n`);
+    return;
+  }
+
+  const config = loadConfig(projectRoot);
+  const ctx = {
+    files: fileContents,
+    projectRoot,
+    config,
+  };
+
+  // Run all checks
+  console.log(`  ${c.gray('正在执行检查...')}`);
+  engine.registerBatch(codeQualityRules);
+
+  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;
+    }
+  });
+
+  const { findings: ruleFindings } = engine.run(ctx);
+
+  // Arch assessment
+  const archAssessor = new ArchRiskAssessor(projectRoot);
+  const archFindings = [];
+  for (const file of fileContents) {
+    const findings = archAssessor.analyzeFile(file.path, file.content);
+    archFindings.push(...findings);
+  }
+
+  // Tech debt scan
+  const debtTracker = new TechDebtTracker(projectRoot);
+  const debtBoard = debtTracker.scan();
+
+  let allFindings = [...ruleFindings, ...archFindings];
+
+  // Apply config-based rule overrides and inline ignores
+  allFindings = applyConfigToFindings(config, allFindings);
+  allFindings = filterIgnored(allFindings, fileContents);
+
+  // Generate HTML report
+  const html = generateHTML({
+    projectRoot: path.basename(projectRoot),
+    timestamp: new Date().toISOString(),
+    findings: allFindings,
+    debtBoard,
+    totalLines: fileContents.reduce((sum, f) => sum + f.content.split('\n').length, 0),
+    fileCount: fileContents.length,
+  });
+
+  // Save report
+  const reportDir = path.join(projectRoot, '.devassist', 'reports');
+  if (!fs.existsSync(reportDir)) fs.mkdirSync(reportDir, { recursive: true });
+  const now = new Date();
+  const dateStr = `${now.getFullYear()}-${String(now.getMonth()+1).padStart(2,'0')}-${String(now.getDate()).padStart(2,'0')}-${String(now.getHours()).padStart(2,'0')}${String(now.getMinutes()).padStart(2,'0')}`;
+  const reportPath = path.join(reportDir, `report-${dateStr}.html`);
+  fs.writeFileSync(reportPath, html, 'utf-8');
+
+  // Also save as latest.html for easy access
+  fs.writeFileSync(path.join(reportDir, 'latest.html'), html, 'utf-8');
+
+  console.log(`\n  ${c.green('报告已生成：')} ${path.relative(projectRoot, reportPath)}`);
+  console.log(`  ${c.gray('同时保存为：')} .devassist/reports/latest.html\n`);
+
+  // Print summary
+  const blocks = allFindings.filter(f => f.severity === 'block').length;
+  const warns = allFindings.filter(f => f.severity === 'warn').length;
+  const infos = allFindings.filter(f => f.severity === 'info').length;
+  console.log(`  ${c.bold('汇总：')}`);
+  console.log(`    扫描文件数：${fileContents.length}`);
+  console.log(`    总行数：${fileContents.reduce((sum, f) => sum + f.content.split('\n').length, 0)}`);
+  console.log(`    ${c.red(`阻断：${blocks}`)}  ${c.yellow(`警告：${warns}`)}  ${c.gray(`提示：${infos}`)}`);
+  if (debtBoard.items && debtBoard.items.length > 0) {
+    console.log(`    技术债务项：${debtBoard.items.length}`);
+  }
+  console.log('');
+
+  // Open in browser if requested
+  if (openBrowser) {
+    try {
+      const { exec } = require('child_process');
+      if (process.platform === 'win32') {
+        exec(`start "" "${reportPath}"`);
+      } else if (process.platform === 'darwin') {
+        exec(`open "${reportPath}"`);
+      } else {
+        exec(`xdg-open "${reportPath}"`);
+      }
+      console.log(`  ${c.gray('正在浏览器中打开...')}`);
+    } catch (_) {}
+  }
+};
+
+function generateHTML(data) {
+  const { projectRoot, timestamp, findings, debtBoard, fileCount, totalLines } = data;
+  const blocks = findings.filter(f => f.severity === 'block');
+  const warns = findings.filter(f => f.severity === 'warn');
+  const infos = findings.filter(f => f.severity === 'info');
+
+  // Group by file
+  const byFile = {};
+  for (const f of findings) {
+    const file = f.file || '(unknown)';
+    if (!byFile[file]) byFile[file] = [];
+    byFile[file].push(f);
+  }
+
+  // Group by rule
+  const byRule = {};
+  for (const f of findings) {
+    const rule = f.ruleId || f.category || 'other';
+    if (!byRule[rule]) byRule[rule] = [];
+    byRule[rule].push(f);
+  }
+
+  const severityColor = { block: '#e24b4a', warn: '#ef9f27', info: '#888780' };
+  const severityBg = { block: '#fcebeb', warn: '#faeeda', info: '#f1efe8' };
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>DevAssist 检查报告 — ${projectRoot}</title>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #f5f5f3; color: #2c2c2a; line-height: 1.6; }
+  .container { max-width: 960px; margin: 0 auto; padding: 40px 24px; }
+  h1 { font-size: 24px; font-weight: 600; margin-bottom: 8px; }
+  h2 { font-size: 18px; font-weight: 500; margin: 32px 0 16px; padding-bottom: 8px; border-bottom: 1px solid #e0ddd5; }
+  .meta { color: #888780; font-size: 13px; margin-bottom: 24px; }
+  .stats { display: flex; gap: 16px; margin-bottom: 24px; }
+  .stat-card { flex: 1; padding: 20px; border-radius: 12px; text-align: center; }
+  .stat-card .num { font-size: 32px; font-weight: 600; }
+  .stat-card .label { font-size: 12px; color: #888780; margin-top: 4px; }
+  .stat-block { background: #fcebeb; }
+  .stat-block .num { color: #e24b4a; }
+  .stat-warn { background: #faeeda; }
+  .stat-warn .num { color: #ef9f27; }
+  .stat-info { background: #f1efe8; }
+  .stat-info .num { color: #888780; }
+  .stat-files { background: #e6f1fb; }
+  .stat-files .num { color: #185fa5; }
+  .finding { padding: 12px 16px; margin-bottom: 8px; border-radius: 8px; border-left: 3px solid; }
+  .finding-block { background: #fcebeb; border-color: #e24b4a; }
+  .finding-warn { background: #faeeda; border-color: #ef9f27; }
+  .finding-info { background: #f1efe8; border-color: #888780; }
+  .finding .title { font-weight: 500; font-size: 13px; }
+  .finding .location { color: #888780; font-size: 12px; margin-top: 2px; }
+  .finding .suggestion { color: #5f5e5a; font-size: 12px; margin-top: 4px; }
+  .file-group { margin-bottom: 16px; }
+  .file-name { font-weight: 500; font-size: 13px; color: #534ab7; margin-bottom: 8px; }
+  .debt-table { width: 100%; border-collapse: collapse; font-size: 13px; }
+  .debt-table th { text-align: left; padding: 8px 12px; background: #f1efe8; font-weight: 500; }
+  .debt-table td { padding: 8px 12px; border-bottom: 1px solid #e0ddd5; }
+  .debt-table .priority { font-weight: 600; }
+  .debt-table .high { color: #e24b4a; }
+  .debt-table .medium { color: #ef9f27; }
+  .debt-table .low { color: #888780; }
+  .empty { color: #888780; text-align: center; padding: 32px; font-size: 14px; }
+  .rule-bar { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; font-size: 12px; }
+  .rule-bar .bar { height: 6px; border-radius: 3px; background: #534ab7; min-width: 2px; }
+  .rule-bar .count { color: #888780; min-width: 30px; }
+</style>
+</head>
+<body>
+<div class="container">
+  <h1>DevAssist 代码检查报告</h1>
+  <div class="meta">项目：${projectRoot} | 生成时间：${new Date(timestamp).toLocaleString('zh-CN')} | ${fileCount} 个文件，${totalLines} 行</div>
+
+  <div class="stats">
+    <div class="stat-card stat-block"><div class="num">${blocks.length}</div><div class="label">阻断</div></div>
+    <div class="stat-card stat-warn"><div class="num">${warns.length}</div><div class="label">警告</div></div>
+    <div class="stat-card stat-info"><div class="num">${infos.length}</div><div class="label">提示</div></div>
+    <div class="stat-card stat-files"><div class="num">${fileCount}</div><div class="label">文件</div></div>
+  </div>
+
+  ${blocks.length > 0 ? `
+  <h2>阻断（${blocks.length}）</h2>
+  ${blocks.map(f => findingHTML(f)).join('')}
+  ` : ''}
+
+  ${warns.length > 0 ? `
+  <h2>警告（${warns.length}）</h2>
+  ${warns.map(f => findingHTML(f)).join('')}
+  ` : ''}
+
+  ${infos.length > 0 ? `
+  <h2>提示（${infos.length}）</h2>
+  ${infos.slice(0, 20).map(f => findingHTML(f)).join('')}
+  ${infos.length > 20 ? `<div class="empty">...还有 ${infos.length - 20} 条</div>` : ''}
+  ` : ''}
+
+  ${Object.keys(byFile).length > 0 ? `
+  <h2>按文件分组</h2>
+  ${Object.entries(byFile).sort((a, b) => b[1].length - a[1].length).map(([file, fileFindings]) => `
+  <div class="file-group">
+    <div class="file-name">${file} (${fileFindings.length})</div>
+    ${fileFindings.map(f => findingHTML(f)).join('')}
+  </div>
+  `).join('')}
+  ` : ''}
+
+  ${Object.keys(byRule).length > 0 ? `
+  <h2>规则触发统计</h2>
+  ${Object.entries(byRule).sort((a, b) => b[1].length - a[1].length).map(([rule, ruleFindings]) => {
+    const maxCount = Math.max(...Object.values(byRule).map(r => r.length));
+    const width = (ruleFindings.length / maxCount) * 200;
+    return `<div class="rule-bar"><span style="min-width:200px">${rule}</span><div class="bar" style="width:${width}px"></div><span class="count">${ruleFindings.length}</span></div>`;
+  }).join('')}
+  ` : ''}
+
+  ${debtBoard.items && debtBoard.items.length > 0 ? `
+  <h2>技术债务（${debtBoard.items.length}）</h2>
+  <table class="debt-table">
+    <thead><tr><th>文件</th><th>问题描述</th><th>严重度</th><th>修复工时</th><th>优先级</th></tr></thead>
+    <tbody>
+    ${debtBoard.items.slice(0, 15).map(item => {
+      const sevLabel = { high: '高', medium: '中', low: '低' }[item.severity] || '低';
+      return `
+      <tr>
+        <td>${item.file || '-'}</td>
+        <td>${item.description || item.type || '-'}</td>
+        <td class="priority ${item.severity || 'low'}">${sevLabel}</td>
+        <td>${item.effort || '-'}</td>
+        <td class="priority ${item.priority > 0.5 ? 'high' : item.priority > 0.2 ? 'medium' : 'low'}">${(item.priority || 0).toFixed(2)}</td>
+      </tr>
+    `;}).join('')}
+    </tbody>
+  </table>
+  ${debtBoard.items.length > 15 ? `<div class="empty">...还有 ${debtBoard.items.length - 15} 条</div>` : ''}
+  ` : ''}
+
+  ${findings.length === 0 ? `<div class="empty">全部检查通过，未发现问题。</div>` : ''}
+
+  <div style="margin-top:48px;padding-top:16px;border-top:1px solid #e0ddd5;color:#888780;font-size:12px">
+    由 DevAssist Agent v0.1.0 生成 | 共 ${findings.length} 项发现，涉及 ${Object.keys(byFile).length} 个文件
+  </div>
+</div>
+</body>
+</html>`;
+}
+
+function findingHTML(f) {
+  const sev = f.severity || 'info';
+  return `<div class="finding finding-${sev}">
+    <div class="title">${escapeHTML(f.message || '未知问题')}</div>
+    ${f.file ? `<div class="location">${escapeHTML(f.file)}${f.line ? `:${f.line}` : ''}</div>` : ''}
+    ${f.suggestion ? `<div class="suggestion">${escapeHTML(f.suggestion)}</div>` : ''}
+  </div>`;
+}
+
+function escapeHTML(str) {
+  return String(str).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}

package/src/cli/commands/restore.js

@@ -0,0 +1,78 @@
+/**
+ * devassist restore - Restore from backup (non-destructive)
+ *
+ * Key safety feature: shows a pre-restore report first.
+ * Does NOT delete files that exist now but weren't in the backup.
+ */
+
+const { VersionManager } = require('../../modules/dev-time/version-manager');
+
+module.exports = function restore(projectRoot, args, ui) {
+  const { printHeader, printFinding, c } = ui;
+  printHeader('从备份恢复');
+
+  const vm = new VersionManager(projectRoot);
+  const versions = vm.listVersions();
+
+  if (versions.length === 0) {
+    console.log(`  ${c.yellow('没有可用备份。')} 请先执行 ${c.bold('devassist backup')}。\n`);
+    return;
+  }
+
+  const versionId = args.find(a => !a.startsWith('--'));
+
+  if (!versionId) {
+    console.log(`  ${c.gray('可用备份：')}\n`);
+    for (const v of versions) {
+      console.log(`    ${c.blue(v.versionId)} ${c.gray(v.label)} ${c.gray('(' + v.stats.total + ' 个文件, ' + v.stats.changed + ' 变更)')}`);
+    }
+    console.log(`\n  用法：devassist restore ${c.gray('<版本号>')}\n`);
+    return;
+  }
+
+  // Prepare restore (non-destructive report)
+  const report = vm.prepareRestore(versionId);
+
+  console.log(`  ${c.bold('备份：')} ${versionId}\n`);
+
+  if (report.willOverwrite.length > 0) {
+    console.log(`  ${c.yellow('将被覆盖的文件：')}`);
+    for (const f of report.willOverwrite.slice(0, 10)) {
+      console.log(`    ${c.gray(f)}`);
+    }
+    if (report.willOverwrite.length > 10) {
+      console.log(`    ${c.gray('...还有 ' + (report.willOverwrite.length - 10) + ' 个')}`);
+    }
+    console.log();
+  }
+
+  if (report.willRestore.length > 0) {
+    console.log(`  ${c.green('将恢复的文件（当前缺失）：')}`);
+    for (const f of report.willRestore.slice(0, 10)) {
+      console.log(`    ${c.gray(f)}`);
+    }
+    console.log();
+  }
+
+  if (report.newFilesNotInBackup.length > 0) {
+    console.log(`  ${c.red(c.bold('警告：' + report.newFilesNotInBackup.length + ' 个文件当前存在但不在该备份中！'))}`);
+    console.log(`  ${c.gray('这些文件将被保留（非破坏性恢复）。')}`);
+    console.log(`  ${c.gray('对应故障 #12：备份恢复删除了新文件。')}\n`);
+    for (const f of report.newFilesNotInBackup.slice(0, 10)) {
+      console.log(`    ${c.gray(f)}`);
+    }
+    if (report.newFilesNotInBackup.length > 10) {
+      console.log(`    ${c.gray('...还有 ' + (report.newFilesNotInBackup.length - 10) + ' 个')}`);
+    }
+    console.log();
+  }
+
+  // Check for --yes flag to skip confirmation
+  if (!args.includes('--yes')) {
+    console.log(`  ${c.gray('添加 ' + c.bold('--yes') + ' 确认执行恢复。')}\n`);
+    return;
+  }
+
+  const result = vm.doRestore(versionId);
+  console.log(`  ${c.green('恢复完成！')} 恢复了 ${result.restored} 个文件，保留了 ${result.newFilesPreserved} 个新文件。\n`);
+};

package/src/cli/commands/schema.js

@@ -0,0 +1,93 @@
+/**
+ * devassist schema - Manage schema registry
+ *
+ *   devassist schema import <file.sql>    Import DB schema from DDL
+ *   devassist schema list                 List registered schemas
+ *   devassist schema api add <endpoint> --data-key <key>  Register API contract
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { SchemaRegistry } = require('../../modules/dev-time/schema-registry');
+
+module.exports = function schema(projectRoot, args, ui) {
+  const { printHeader, c } = ui;
+  const subcommand = args[0];
+  const registry = new SchemaRegistry(projectRoot);
+
+  switch (subcommand) {
+    case 'import': {
+      printHeader('导入数据库 Schema');
+      const file = args[1];
+      if (!file) {
+        console.log(`  用法：devassist schema import ${c.gray('<文件.sql>')}\n`);
+        return;
+      }
+      const fullPath = path.isAbsolute(file) ? file : path.join(projectRoot, file);
+      if (!fs.existsSync(fullPath)) {
+        console.log(`  ${c.red('文件不存在：')} ${fullPath}\n`);
+        return;
+      }
+      const content = fs.readFileSync(fullPath, 'utf-8');
+      const findings = registry.importFromDDL(content);
+      const stats = registry.getStats();
+      console.log(`  ${c.green('已导入')} ${stats.tables} 张表，${stats.totalColumns} 个字段\n`);
+      if (findings.length > 0) {
+        console.log(`  ${c.yellow('检测到 Schema 变更：')}\n`);
+        for (const f of findings) {
+          console.log(`  ${f.severity === 'block' ? c.red('[阻断]') : c.yellow('[警告] ')} ${f.message}\n`);
+        }
+      }
+      break;
+    }
+    case 'list': {
+      printHeader('Schema 注册中心');
+      const stats = registry.getStats();
+      console.log(`  ${c.bold('数据表：')} ${stats.tables}`);
+      console.log(`  ${c.bold('API 契约：')} ${stats.apiContracts}`);
+      console.log(`  ${c.bold('字段总数：')} ${stats.totalColumns}\n`);
+
+      const snapshot = registry.exportSnapshot();
+      if (Object.keys(snapshot.schemas).length > 0) {
+        console.log(`  ${c.bold('已注册的数据表：')}\n`);
+        for (const [table, schema] of Object.entries(snapshot.schemas)) {
+          console.log(`  ${c.blue(table)} ${c.gray('v' + schema.version + ' (' + schema.columns.length + ' 个字段)')}`);
+        }
+        console.log();
+      }
+      if (Object.keys(snapshot.apiContracts).length > 0) {
+        console.log(`  ${c.bold('API 契约：')}\n`);
+        for (const [endpoint, contract] of Object.entries(snapshot.apiContracts)) {
+          console.log(`  ${c.blue(endpoint)} ${c.gray('data-key: ' + (contract.dataKey || 'data.list') + ' v' + contract.version)}`);
+        }
+        console.log();
+      }
+      break;
+    }
+    case 'api': {
+      const action = args[1];
+      if (action === 'add') {
+        printHeader('注册 API 契约');
+        const endpoint = args[2];
+        const dataKey = getArg(args, '--data-key') || 'data.list';
+        if (!endpoint) {
+          console.log(`  用法：devassist schema api add ${c.gray('<端点> --data-key <键名>')}\n`);
+          return;
+        }
+        registry.registerAPI(endpoint, { dataKey });
+        console.log(`  ${c.green('已注册 API 契约：')} ${endpoint}（dataKey: ${dataKey}）\n`);
+      } else {
+        console.log(`  用法：devassist schema api ${c.gray('add <端点> --data-key <键名>')}\n`);
+      }
+      break;
+    }
+    default:
+      console.log(`  用法：devassist schema ${c.gray('import|list|api')}\n`);
+  }
+};
+
+function getArg(args, flag) {
+  const idx = args.indexOf(flag);
+  if (idx >= 0 && args[idx + 1]) return args[idx + 1];
+  return null;
+}