feat(GOV-010): 强制校验开发质量证据

tools/governance/feature-record.mjs

@@ -9,6 +9,7 @@ const REQUIRED_FEATURE_FILES = Object.freeze([
   'design.md',
   'implementation-plan.md',
   'test-plan.md',
+  'development-summary.md',
   'gitnexus/before.md',
   'gitnexus/impact-plan.md',
   'gitnexus/detected-changes.md',
@@ -27,6 +28,28 @@ const REVIEW_FILES = Object.freeze([
   'review/standards-review.md',
 ]);
 
+const REQUIRED_EVIDENCE_SECTIONS = Object.freeze({
+  'development-summary.md': [
+    '原始开发需求',
+    '需求与范围变化',
+    '实际完成需求',
+    '修复缺陷',
+    '未完成与延期项',
+    '关键提交',
+    '验证证据',
+  ],
+  'design.md': ['安全策略与评估', '性能目标与评估'],
+  'test-plan.md': ['安全验证', '性能验证'],
+  'gitnexus/impact-plan.md': ['直接与间接影响', '跨模块同步修改'],
+  'review/code-review.md': ['安全与残余风险', '性能与资源影响', 'GitNexus 与同步修改'],
+  'review/standards-review.md': [
+    '安全、性能与架构检查',
+    'GitNexus 与开发总结检查',
+  ],
+});
+
+const EMPTY_EVIDENCE_PATTERN = /^(?:无|不适用|n\/?a|none)[。.!！]?$/i;
+
 /**
  * 功能编号是需求、设计、代码提交、测试结果和发布记录之间的主关联键。
  * 严格限制格式可以避免路径穿越、临时名称以及后续无法检索的模糊编号。
@@ -58,6 +81,75 @@ export function getRequiredFeatureFiles() {
   return [...REQUIRED_FEATURE_FILES];
 }
 
+/**
+ * 二级标题允许带文档章节序号，但证据名称必须完整匹配，避免靠散文中偶然出现的
+ * “安全”或“性能”字样绕过门禁。正文只剔除空行和 HTML 注释，不推断业务结论真伪。
+ */
+function collectSecondLevelSections(content) {
+  const sections = new Map();
+  let currentSection;
+
+  for (const line of String(content).replace(/\r\n?/g, '\n').split('\n')) {
+    const heading = line.match(/^##\s+(?:(?:\d+(?:\.\d+)*)\.\s+)?(.+?)\s*$/);
+    if (heading) {
+      currentSection = heading[1];
+      if (!sections.has(currentSection)) sections.set(currentSection, []);
+      continue;
+    }
+    if (currentSection) sections.get(currentSection).push(line);
+  }
+
+  return sections;
+}
+
+function hasSubstantiveEvidence(lines) {
+  const content = (lines ?? [])
+    .join('\n')
+    .replace(/<!--[\s\S]*?-->/g, '')
+    .trim();
+  return content.length > 0 && !EMPTY_EVIDENCE_PATTERN.test(content);
+}
+
+/**
+ * 返回全部无效证据而不是遇到首项即停止，使开发者一次即可补齐同一功能档案。
+ * “不适用”必须附带原因和适用边界；有解释的完整句子不会被当作空占位。
+ */
+export function getInvalidFeatureEvidence(featureReports) {
+  const invalidEvidence = [];
+
+  for (const [file, requiredSections] of Object.entries(REQUIRED_EVIDENCE_SECTIONS)) {
+    const sections = collectSecondLevelSections(featureReports.get(file) ?? '');
+    for (const section of requiredSections) {
+      if (!hasSubstantiveEvidence(sections.get(section))) {
+        invalidEvidence.push(`${file}：${section}`);
+      }
+    }
+  }
+
+  return invalidEvidence;
+}
+
+/** 后续功能的影响计划从完整检查维度起步，减少只分析主模块而遗漏消费者。 */
+export function buildImpactPlanTemplate(featureId) {
+  if (!validateFeatureId(featureId)) {
+    throw new Error(`功能编号格式无效：${featureId}`);
+  }
+
+  return `# GitNexus 开发前影响计划
+
+- 功能编号：${featureId}
+- 总体风险：待分析
+
+## 直接与间接影响
+
+请记录 query、context、upstream impact、消费者和执行流。
+
+## 跨模块同步修改
+
+请逐项判断 HTTP/OpenAPI、Web API、消息契约、数据库、Redis、API、Scheduler、Worker、配置部署、测试和文档。
+`;
+}
+
 /**
  * Review 报告不能只靠“文件存在”通过门禁。这里要求报告使用固定的最终结论行，
  * 避免 pending、blocked 或 changes_required 被一段其他说明文字意外判定为通过。