@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/scripts/{eval_prd.py → validation/metrics/eval_prd.py}

@@ -1,5 +1,17 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# v3.0 路径自举: 向上搜索 foundation/bootstrap.py (深度无关)
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
+
 """
 QODER EVA - PRD/原型 自动评估 (快且准的"准"侧自动指标)
 
@@ -14,12 +26,12 @@ Usage:
   A3 模板完整 (30分): PRD 包含团队模板必需章节的比例
      -> 保证团队章程的模板结构不丢
 
-结果追加到 .qoder/learning/eval-history.jsonl (本机), 供 /wl-status 趋势展示。
+结果追加到 data/learning/eval-history.jsonl (本机), 供 /wl-status 趋势展示。
 Exit: 0 = 总分>=80, 1 = 不达标 (发布前应修复)
 """
 
 import os
-from common.paths import BUILD_CACHE_DIR
+from foundation.core.paths import BUILD_CACHE_DIR
 import sys
 import json
 import re
@@ -33,10 +45,11 @@ if sys.platform == 'win32':
 
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
-BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+BASE = get_repo_root()
 INDEX_DIR = os.path.join(BASE, 'data', 'index')
 TPL_DIR = os.path.join(BASE, '.qoder', 'templates')
-HISTORY = os.path.join(BASE, '.qoder', 'learning', 'eval-history.jsonl')
+from foundation.core.paths import EVAL_HISTORY_PATH  # 统一真源: 防止写路径再漂移 (历史 bug: 曾写成 .qoder/learning/)
+HISTORY = str(EVAL_HISTORY_PATH)
 
 # 完整模板必需章节 (prd-full-template.md) / Mini 模板必需章节
 FULL_SECTIONS = ['版本信息', '变更日志', '名词解释', '需求背景', '需求来源', '产品现状',
@@ -185,10 +198,17 @@ def score_reality(prd_text):
     if checked == 0:
         return 1.0, '未引用具体字段/API (零星文案类需求正常)', []
     ratio = hits / checked
+    # 图谱覆盖度感知: 防止"认真写 API 引用但图谱没覆盖"比"啥都不写"分还低。
+    kg_api_count = len(api_paths)
+    if kg_api_count < 10 and ratio < 0.5 and hits == 0:
+        ratio = max(ratio, 0.5)
+        note_suffix = '(图谱API稀疏, 已软保底)'
+    else:
+        note_suffix = ''
     db_note = ('，其中 %d 个由数据库层确认' % db_bonus) if db_bonus else ''
     layer_note = ('(双层: 代码+数据库)' if db_cols else '(代码层)')
-    return ratio, '{}/{} 个字段/API 引用可在图谱中找到{}{}'.format(
-        hits, checked, layer_note, db_note), misses[:8]
+    return ratio, '{}/{} 个字段/API 引用可在图谱中找到{}{}{}'.format(
+        hits, checked, layer_note, db_note, note_suffix), misses[:8]
 
 
 # ============================================================
@@ -257,6 +277,13 @@ def score_template(prd_text):
 # ============================================================
 
 def main():
+    """v3.0: 接入 Result + contract 校验 (让设计模式真落地)。
+
+    改动:
+    1. 评估前先 validate_contract (软校验, 无契约头降级不阻塞)
+    2. 用 Result 表达三级结果 (PASS/WARN/FAIL), 替代裸 return 0/1
+    3. graceful_error 装饰器统一输出
+    """
     if len(sys.argv) < 2:
         print(__doc__)
         return 1
@@ -264,11 +291,37 @@ def main():
     html_path = sys.argv[2] if len(sys.argv) > 2 else None
 
     if not os.path.isfile(prd_path):
-        print('PRD 不存在: ' + prd_path)
+        print('[FAIL] PRD 不存在: ' + prd_path)
         return 1
 
+    # v3.0 接入: 角色边界校验 (guard.py, 软提示不阻塞)
+    # eval_prd 是 PRD 发布的必经质量门, 在这里检查"当前角色能否产出 prd"
+    # 越权 → 打印提示但不 return(降级, 让用户自己决定是否继续)
+    try:
+        from foundation.identity.guard import check_produce
+        gr = check_produce('prd')
+        if gr.is_warn:
+            print(gr.msg)
+            if gr.hint:
+                print('  -> ' + gr.hint)
+    except Exception:
+        pass  # guard 不可用不影响评估
+
+    # v3.0 接入: 契约校验 (软, 无@contract头则降级不阻塞)
+    try:
+        from foundation.data.contract import validate_contract
+        cr = validate_contract(prd_path)
+        if cr.is_warn:
+            print(cr.msg)  # WARN: 无契约头或字段警告, 提示但不阻塞
+        elif cr.ok and cr.code not in ('no_contract', 'no_schema', 'ok'):
+            print(cr.msg)
+            if cr.hint:
+                print('  -> ' + cr.hint)
+    except Exception:
+        pass  # 契约校验失败不影响评估
+
     # 用程序化 API 评估 (重构后 main 只是 CLI 包装)
-    from common.eval_api import evaluate, format_report
+    from foundation.utils.eval_api import evaluate, format_report
     try:
         result = evaluate(prd_path, html_path)
     except FileNotFoundError as e:
@@ -278,14 +331,27 @@ def main():
     # 打印人类可读报告
     print(format_report(result))
 
-    # 详细 misses (补充 format_report 之外的细节)
-    if result.get('msg2') and '非真源颜色' in str(result.get('msg2', '')):
-        # msg2 已含信息, 此处可补 unknown 列表 —— 但 evaluate 已合并进 misses
-        pass
+    # v3.0 接入: 用 Result 表达三级 (PASS ≥80 / WARN 60-80 / FAIL <60)
+    # 现状是二值 passed, 这里加 WARN 中间档, 让"差一点的 PRD"能带警告发布
+    from foundation.data.result import Result, CODE
+    pct = result.get('pct', 0)
+    if result['passed']:
+        verdict = Result.success(msg='✓ PASS ({}%)'.format(pct), data=result)
+    elif pct >= 60:
+        verdict = Result.warning(
+            '⚠ WARN ({}%): 低于80但有内容, 可带警告发布'.format(pct),
+            code=CODE.BELOW_THRESH, data=result,
+        )
+    else:
+        verdict = Result.failure(
+            '✗ FAIL ({}%): 低于60, 需修复'.format(pct),
+            code=CODE.BELOW_THRESH,
+            hint='检查字段锚定(A1)和模板完整(A3)',
+        )
 
     # 记录历史 (原子追加, 防并发损坏)
     try:
-        from common.atomicio import atomic_append_jsonl
+        from foundation.io.atomicio import atomic_append_jsonl
         os.makedirs(os.path.dirname(HISTORY), exist_ok=True)
         atomic_append_jsonl(HISTORY, {
             'time': datetime.now().isoformat(),
@@ -295,11 +361,12 @@ def main():
             'a3_template': result['r3'],
             'score_pct': result['pct'],
             'passed': result['passed'],
+            'verdict': verdict.code,  # v3.0: 记录三级判定
         }, timeout=10)
     except Exception:
         pass  # 历史记录失败不影响评估结果
 
-    # 埋点: PRD 评估结果反馈给 learning 引擎 (prd_accepted / prd_rejected)
+    # 埋点: PRD 评估结果反馈给 learning 引擎
     try:
         from learn import record_feedback
         event = 'prd_accepted' if result['passed'] else 'prd_rejected'
@@ -311,7 +378,9 @@ def main():
     except Exception:
         pass  # 埋点失败不影响评估
 
-    return 0 if result['passed'] else 1
+    # exit code: PASS=0, WARN=0(可继续), FAIL=1
+    # (WARN 不阻塞发布, 与方案"eval_prd 三级门禁"一致)
+    return 0 if verdict.ok else 1
 
 
 if __name__ == '__main__':