@hupan56/wlkj 3.0.0 → 3.1.2

package/templates/qoder/scripts/{common → foundation/identity}/check_publish.py

@@ -1,98 +1,103 @@
-# -*- coding: utf-8 -*-
-# v3.0 路径自举
-import os as _o, sys as _s
-_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
-if _cp not in _s.path: _s.path.insert(0, _cp)
-from bootstrap import setup; setup()
-
-"""
-check_publish.py - 统一发布前置检查 (guard + contract 双门)
-
-把"造了没接"的两个基建真正接入执行链路:
-  - guard.py (角色边界): 当前角色能否产出该契约? 越权 → 软提示
-  - contract.py (契约校验): 产出文件带不带 @contract 头? 带了是否合规?
-
-设计原则 (与 guard/contract 一致):
-  - 降级不阻塞: 越权/无契约头/校验警告 → 打印提示但 exit 0 (让用户决定)
-  - 只有"硬错误"(契约校验 FAIL) → exit 1, 阻止发布
-  - 统一入口: 所有产出型 skill 发布前调这一个脚本, 不用各自接 guard/contract
-
-用法:
-  python .qoder/scripts/common/check_publish.py <契约类型> <产出文件路径>
-  python .qoder/scripts/common/check_publish.py prd workspace/.../REQ-2026-001-xxx.md
-  python .qoder/scripts/common/check_publish.py design-spec workspace/.../xxx-design-spec.json
-  python .qoder/scripts/common/check_publish.py test-cases workspace/.../xxx-cases.json
-
-退出码:
-  0 = 通过 (含软警告, 可发布)
-  1 = 硬失败 (契约校验 FAIL, 建议不发布)
-  2 = 参数错误 / 内部异常
-
-输出: 人类可读的检查报告 (角色 + 契约两段)
-"""
-
-import sys
-
-
-def run(contract_type, artifact_path):
-    """跑 guard + contract 双门检查。返回 exit code。"""
-    # ============ 门 1: 角色边界 (guard) ============
-    # 越权只软提示, 不阻塞 (ensure=False)
-    print('--- 角色边界检查 ---')
-    try:
-        from common.guard import check_produce
-        gr = check_produce(contract_type)
-        if gr.ok and not gr.is_warn:
-            print('✓', gr.msg)
-        else:
-            # 越权 (WARN): 提示但仍可继续
-            print(gr.msg)
-            if gr.hint:
-                print('  →', gr.hint)
-            print('  (软提示, 不阻塞发布。若需切换角色: /wl-init)')
-    except Exception as e:
-        print('⚠️ 角色检查不可用 ({}), 跳过'.format(str(e)[:60]))
-
-    # ============ 门 2: 契约校验 (contract) ============
-    print()
-    print('--- 契约校验 ---')
-    import os
-    if not os.path.isfile(artifact_path):
-        print('⚠️ 产出文件不存在: {}'.format(artifact_path))
-        print('  (跳过契约校验)')
-        return 0
-    try:
-        from common.contract import validate_contract
-        cr = validate_contract(artifact_path)
-        if cr.ok and not cr.is_warn:
-            print('✓', cr.msg)
-            return 0
-        elif cr.is_warn:
-            # 警告 (无契约头/字段警告/无schema): 软门禁, 可继续
-            print(cr.msg)
-            if cr.hint:
-                print('  →', cr.hint)
-            return 0
-        else:
-            # FAIL (硬错误): 缺必填/类型错/枚举越界 → 阻止
-            print('[FAIL]', cr.msg)
-            if cr.hint:
-                print('  →', cr.hint)
-            print('  (硬失败, 建议修正后再发布)')
-            return 1
-    except Exception as e:
-        print('⚠️ 契约校验异常 ({}), 跳过'.format(str(e)[:60]))
-        return 0
-
-
-def main():
-    if len(sys.argv) < 3:
-        print(__doc__)
-        return 2
-    contract_type = sys.argv[1]
-    artifact_path = sys.argv[2]
-    return run(contract_type, artifact_path)
-
-
-if __name__ == '__main__':
-    sys.exit(main())
+# -*- coding: utf-8 -*-
+# v3.0 路径自举
+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()
+
+"""
+check_publish.py - 统一发布前置检查 (guard + contract 双门)
+
+把"造了没接"的两个基建真正接入执行链路:
+  - guard.py (角色边界): 当前角色能否产出该契约? 越权 → 软提示
+  - contract.py (契约校验): 产出文件带不带 @contract 头? 带了是否合规?
+
+设计原则 (与 guard/contract 一致):
+  - 降级不阻塞: 越权/无契约头/校验警告 → 打印提示但 exit 0 (让用户决定)
+  - 只有"硬错误"(契约校验 FAIL) → exit 1, 阻止发布
+  - 统一入口: 所有产出型 skill 发布前调这一个脚本, 不用各自接 guard/contract
+
+用法:
+  python .qoder/scripts/common/check_publish.py <契约类型> <产出文件路径>
+  python .qoder/scripts/common/check_publish.py prd workspace/.../REQ-2026-001-xxx.md
+  python .qoder/scripts/common/check_publish.py design-spec workspace/.../xxx-design-spec.json
+  python .qoder/scripts/common/check_publish.py test-cases workspace/.../xxx-cases.json
+
+退出码:
+  0 = 通过 (含软警告, 可发布)
+  1 = 硬失败 (契约校验 FAIL, 建议不发布)
+  2 = 参数错误 / 内部异常
+
+输出: 人类可读的检查报告 (角色 + 契约两段)
+"""
+
+import sys
+
+
+def run(contract_type, artifact_path):
+    """跑 guard + contract 双门检查。返回 exit code。"""
+    # ============ 门 1: 角色边界 (guard) ============
+    # 越权只软提示, 不阻塞 (ensure=False)
+    print('--- 角色边界检查 ---')
+    try:
+        from foundation.identity.guard import check_produce
+        gr = check_produce(contract_type)
+        if gr.ok and not gr.is_warn:
+            print('✓', gr.msg)
+        else:
+            # 越权 (WARN): 提示但仍可继续
+            print(gr.msg)
+            if gr.hint:
+                print('  →', gr.hint)
+            print('  (软提示, 不阻塞发布。若需切换角色: /wl-init)')
+    except Exception as e:
+        print('⚠️ 角色检查不可用 ({}), 跳过'.format(str(e)[:60]))
+
+    # ============ 门 2: 契约校验 (contract) ============
+    print()
+    print('--- 契约校验 ---')
+    import os
+    if not os.path.isfile(artifact_path):
+        print('⚠️ 产出文件不存在: {}'.format(artifact_path))
+        print('  (跳过契约校验)')
+        return 0
+    try:
+        from foundation.data.contract import validate_contract
+        cr = validate_contract(artifact_path)
+        if cr.ok and not cr.is_warn:
+            print('✓', cr.msg)
+            return 0
+        elif cr.is_warn:
+            # 警告 (无契约头/字段警告/无schema): 软门禁, 可继续
+            print(cr.msg)
+            if cr.hint:
+                print('  →', cr.hint)
+            return 0
+        else:
+            # FAIL (硬错误): 缺必填/类型错/枚举越界 → 阻止
+            print('[FAIL]', cr.msg)
+            if cr.hint:
+                print('  →', cr.hint)
+            print('  (硬失败, 建议修正后再发布)')
+            return 1
+    except Exception as e:
+        print('⚠️ 契约校验异常 ({}), 跳过'.format(str(e)[:60]))
+        return 0
+
+
+def main():
+    if len(sys.argv) < 3:
+        print(__doc__)
+        return 2
+    contract_type = sys.argv[1]
+    artifact_path = sys.argv[2]
+    return run(contract_type, artifact_path)
+
+
+if __name__ == '__main__':
+    sys.exit(main())