jsharness 1.0.0

package/.harness/gate/index.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+
+/**
+ * Harness Gate Scripts — 主入口
+ * 
+ * 统一验证入口，整合所有检查模块，输出标准化报告。
+ * 
+ * 使用方式：
+ *   node .harness/gate/index.js                     # 完整检查
+ *   node .harness/gate/index.js --save-baseline      # 保存基线
+ *   node .harness/gate/index.js --baseline            # 对比基线
+ *   node .harness/gate/index.js --check A             # 只运行 A 类检查
+ *   node .harness/gate/index.js --report json         # JSON 格式输出
+ *   node .harness/gate/index.js --output report.md    # 输出到文件
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ============================================================
+// 配置与常量
+// ============================================================
+
+const GATE_ROOT = path.resolve(__dirname);
+const CHECKS_DIR = path.join(GATE_ROOT, 'checks');
+const BASELINE_FILE = path.join(process.cwd(), '.gate-baseline.json');
+const REPORT_FILE = path.join(process.cwd(), '.gate-report.json');
+
+// 检查类别定义（按执行顺序）
+const CHECK_CATEGORIES = [
+  { id: 'A', name: '静态规范', module: 'static-compliance', weight: 20, failBlocks: true },
+  { id: 'B', name: '构建门槛', module: 'build-gates', weight: 25, failBlocks: true },
+  { id: 'C', name: '测试合规', module: 'test-compliance', weight: 25, failBlocks: true },
+  { id: 'D', name: '安全质量', module: 'security-quality', weight: 15, failBlocks: true }, // 安全红线
+  { id: 'E', name: '工程一致性', module: 'engineering-consistency', weight: 15, failBlocks: false }
+];
+
+// ============================================================
+// CLI 参数解析
+// ============================================================
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    saveBaseline: args.includes('--save-baseline'),
+    useBaseline: args.includes('--baseline'),
+    checkOnly: null,
+    outputFormat: 'text',
+    outputFile: null,
+    verbose: args.includes('-v') || args.includes('--verbose')
+  };
+  
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--check' && args[i + 1]) {
+      options.checkOnly = args[i + 1].toUpperCase();
+    }
+    if (args[i] === '--report' && args[i + 1]) {
+      options.outputFormat = args[i + 1].toLowerCase();
+    }
+    if (args[i] === '--output' && args[i + 1]) {
+      options.outputFile = args[i + 1];
+    }
+  }
+  
+  return options;
+}
+
+// ============================================================
+// 报告生成器
+// ============================================================
+
+class GateReport {
+  constructor() {
+    this.timestamp = new Date().toISOString();
+    this.tool = 'harness-gate v1.0.0';
+    this.options = parseArgs();
+    this.results = [];
+    this.overallStatus = 'pass';
+    this.duration = { start: Date.now(), end: null };
+    
+    // 基线数据
+    this.baselineData = null;
+    this.baselineComparison = null;
+  }
+
+  /**
+   * 添加一个类别的结果
+   */
+  addCategoryResult(categoryId, result) {
+    this.results.push({ category: categoryId, ...result });
+  }
+
+  /**
+   * 计算总体状态
+   */
+  calculateOverall() {
+    this.duration.end = Date.now();
+    
+    let hasFail = false;
+    let hasWarning = false;
+    
+    for (const result of this.results) {
+      if (result.status === 'fail') hasFail = true;
+      else if (result.status === 'warning') hasWarning = true;
+      
+      // D 类（安全）和 A/B/C 类 FAIL 直接导致门禁失败
+      const catConfig = CHECK_CATEGORIES.find(c => c.id === result.category);
+      if (catConfig?.failBlocks && result.status === 'fail') {
+        hasFail = true;
+      }
+    }
+    
+    if (hasFail) this.overallStatus = 'fail';
+    else if (hasWarning) this.overallStatus = 'warning';
+    else this.overallStatus = 'pass';
+  }
+
+  /**
+   * 生成文本报告
+   */
+  toText() {
+    const lines = [];
+    lines.push('╔════════════════════════════════════════════╗');
+    lines.push('║       HARNESS ENGINEERING GATE REPORT        ║');
+    lines.push('╠════════════════════════════════════════════╣');
+    lines.push(`║ 时间: ${this.timestamp.padEnd(34)}║`);
+    lines.push(`║ 状态: ${this._statusBadge(this.overallStatus).padEnd(33)}║`);
+    lines.push(`║ 耗时: ${((this.duration.end - this.duration.start) / 1000).toFixed(1)}s`.padEnd(40) + '║');
+    lines.push('╠════════════════════════════════════════════╣');
+    
+    for (const result of this.results) {
+      const catName = `[${result.category}] ${CHECK_CATEGORIES.find(c => c.id === result.category)?.name || 'Unknown'}`;
+      lines.push(`║ ${catName.padEnd(38)}║`);
+      lines.push(`║   状态: ${this._statusBadge(result.status).padEnd(33)}║`);
+      if (result.score !== undefined) {
+        lines.push(`║   得分: ${String(result.score).padEnd(36)}║`);
+      }
+      if (result.issues && result.issues.length > 0) {
+        for (const issue of result.issues.slice(0, 10)) {
+          const line = `  ! ${issue.message || issue}`.substring(0, 38);
+          lines.push(`║${line.padEnd(39)}║`);
+        }
+        if (result.issues.length > 10) {
+          lines.push(`║  ... 还有 ${result.issues.length - 10} 个问题`.padEnd(40) + '║');
+        }
+      }
+      lines.push('╟──────────────────────────────────────────────╢');
+    }
+    
+    if (this.baselineComparison) {
+      lines.push('║ 📊 基线对比                                  ║');
+      const bc = this.baselineComparison;
+      lines.push(`║   回归: ${bc.regression ? '⚠️ YES' : '✅ NO'}`);
+      if (bc.details) {
+        for (const d of bc.details) {
+          lines.push(`║   ${d}`.padEnd(39) + '║');
+        }
+      }
+      lines.push('╟──────────────────────────────────────────────╢');
+    }
+    
+    lines.push(`║ 结论: ${this._conclusionText().padEnd(35)}║`);
+    lines.push('╚════════════════════════════════════════════╝');
+    
+    return lines.join('\n');
+  }
+
+  /**
+   * 生成 JSON 报告
+   */
+  toJSON() {
+    return {
+      timestamp: this.timestamp,
+      tool: this.tool,
+      overall_status: this.overallStatus,
+      duration_ms: this.duration.end - this.duration.start,
+      categories: this.results.map(r => ({
+        category_id: r.category,
+        status: r.status,
+        score: r.score,
+        issues_count: r.issues?.length || 0,
+        issues: r.issues || []
+      })),
+      baseline_comparison: this.baselineComparison
+    };
+  }
+
+  _statusBadge(status) {
+    switch (status) {
+      case 'pass': return '✅ PASS';
+      case 'warning': return '⚠️  WARNING';
+      case 'fail': return '❌ FAIL';
+      default: return `❓ ${status}`;
+    }
+  }
+
+  _conclusionText() {
+    switch (this.overallStatus) {
+      case 'pass': return '所有检查通过 ✅ 可以进入下一阶段';
+      case 'warning': return '存在警告 ⚠️  建议修复后继续';
+      case 'fail': return '检查未通过 ❌ 必须修复后重新提交';
+      default: return '状态未知';
+    }
+  }
+}
+
+// ============================================================
+// 主流程
+// ============================================================
+
+async function main() {
+  const options = parseArgs();
+  const report = new GateReport();
+  
+  console.log('\n🚀 Harness Gate Scripts 启动...\n');
+  
+  // 加载基线数据
+  if (options.useBaseline && fs.existsSync(BASELINE_FILE)) {
+    try {
+      report.baselineData = JSON.parse(fs.readFileSync(BASELINE_FILE, 'utf-8'));
+      console.log(`📊 已加载基线文件: ${BASELINE_FILE}\n`);
+    } catch (e) {
+      console.warn(`⚠️ 基线文件解析失败: ${e.message}`);
+    }
+  }
+  
+  // 执行各检查模块
+  const checksToRun = options.checkOnly
+    ? CHECK_CATEGORIES.filter(c => c.id === options.checkOnly)
+    : CHECK_CATEGORIES;
+  
+  if (checksToRun.length === 0) {
+    console.error(`❌ 未知的检查类别: ${options.checkOnly}。可用选项: ${CHECK_CATEGORIES.map(c => c.id).join(', ')}`);
+    process.exit(2);
+  }
+  
+  for (const cat of checksToRun) {
+    console.log(`\n🔍 [${cat.id}] 运行 ${cat.name} 检查...`);
+    
+    try {
+      const checkModulePath = path.join(CHECKS_DIR, `${cat.module}.js`);
+      
+      if (!fs.existsSync(checkModulePath)) {
+        // 模块不存在时返回占位结果
+        report.addCategoryResult(cat.id, {
+          status: 'warning',
+          score: 'N/A',
+          issues: [`检查模块 ${cat.module}.js 尚未实现`]
+        });
+        console.log(`  ⚠️  模块未实现，跳过`);
+        continue;
+      }
+      
+      // 动态加载并执行检查模块
+      const checkFn = require(checkModulePath);
+      const result = await typeof checkFn === 'function' 
+        ? checkFn(options) 
+        : (checkFn.run ? checkFn.run(options) : checkFn);
+      
+      report.addCategoryResult(cat.id, result);
+      console.log(`  结果: ${report._statusBadge(result.status)}${result.score !== undefined ? ` | 得分: ${result.score}` : ''}${result.issues?.length ? ` | 问题数: ${result.issues.length}` : ''}`);
+      
+    } catch (error) {
+      report.addCategoryResult(cat.id, {
+        status: 'error',
+        issues: [{ message: `检查执行异常: ${error.message}`, error }]
+      });
+      console.error(`  ❌ 执行错误: ${error.message}`);
+    }
+  }
+  
+  // 基线对比
+  if (report.baselineData && options.useBaseline) {
+    try {
+      const baselineModule = require(path.join(GATE_ROOT, 'baseline'));
+      report.baselineComparison = baselineModule.compare(report.toJSON(), report.baselineData);
+    } catch (e) {
+      // 基线对比可选，失败不阻塞
+    }
+  }
+  
+  // 计算最终结果
+  report.calculateOverall();
+  
+  // 输出报告
+  if (options.outputFormat === 'json') {
+    console.log(JSON.stringify(report.toJSON(), null, 2));
+  } else {
+    console.log('\n' + report.toText());
+  }
+  
+  // 保存报告文件
+  const outputFile = options.outputFile || REPORT_FILE;
+  fs.writeFileSync(outputFile, JSON.stringify(report.toJSON(), null, 2));
+  console.log(`\n📄 报告已保存到: ${outputFile}`);
+  
+  // 保存基线
+  if (options.saveBaseline) {
+    fs.writeFileSync(BASELINE_FILE, JSON.stringify(report.toJSON(), null, 2));
+    console.log(`💾 基线已保存到: ${BASELINE_FILE}`);
+  }
+  
+  // 返回退出码
+  const shouldFail = report.overallStatus === 'fail';
+  console.log(`\n${shouldFail ? '❌ 门禁未通过' : '✅ 门禁通过'}`);
+  process.exit(shouldFail ? 1 : 0);
+}
+
+// 执行入口
+main().catch(err => {
+  console.error('❌ Gate 脚本致命错误:', err);
+  process.exit(3);
+});
+
+module.exports = { GateReport, CHECK_CATEGORIES, parseArgs };