@hunyed15/codecgc 0.1.0

package/scripts/refresh_codecgc_review_policy.py

@@ -0,0 +1,223 @@
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+from codecgc_artifact_roots import execution_root
+from codecgc_artifact_roots import flow_root
+from codecgc_artifact_roots import normalize_artifact_class
+from route_codecgc_workflow import extract_review_metadata
+from write_codecgc_review import load_json
+from write_codecgc_review import resolve_artifact_path
+from write_codecgc_review import write_review
+
+
+WORKSPACE = Path(__file__).resolve().parents[1]
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="为历史 acceptance/fix-note 产物补写缺失的 CodeCGC 审核策略字段。"
+    )
+    parser.add_argument(
+        "--artifact-class",
+        choices=["product", "fixture", "all"],
+        default="all",
+        help="要扫描的产物类别根目录。默认同时处理 product 和 fixture。",
+    )
+    parser.add_argument(
+        "--write",
+        action="store_true",
+        help="将刷新结果真正写回文件。默认仅输出预演摘要。",
+    )
+    parser.add_argument(
+        "--format",
+        choices=["json", "summary"],
+        default="json",
+        help="输出格式。summary 更适合维护与发布检查。",
+    )
+    return parser
+
+
+def read_text(path: Path) -> str:
+    return path.read_text(encoding="utf-8") if path.exists() else ""
+
+
+def has_review_policy_fields(path: Path) -> bool:
+    text = read_text(path)
+    return (
+        ("Review action kind:" in text or "审核动作类型:" in text)
+        and ("Review fallback stage:" in text or "审核回退阶段:" in text)
+        and ("Review policy reason:" in text or "审核策略原因:" in text)
+    )
+
+
+def has_legacy_review_text(path: Path) -> bool:
+    text = read_text(path)
+    legacy_markers = [
+        "## 5. Review Decision",
+        "## 4. Review Decision",
+        "Requested decision:",
+        "Final decision:",
+        "Outcome:",
+        "Evidence source:",
+        "Risk classes:",
+        "Execution mode:",
+        "Execution performed:",
+        "Reviewed task_id:",
+        "Reviewed step_number:",
+        "Review action kind:",
+        "Review fallback stage:",
+        "Review policy reason:",
+        "Next step:",
+        "- accepted",
+        "- changes-requested",
+    ]
+    return any(marker in text for marker in legacy_markers)
+
+
+def find_audit_candidates(artifact_class: str) -> list[Path]:
+    root = execution_root(artifact_class)
+    if not root.exists():
+        return []
+    return sorted(root.glob("*.json"))
+
+
+def should_scan_artifact_class(value: str, artifact_class: str) -> bool:
+    if value == "all":
+        return True
+    return value == artifact_class
+
+
+def collect_refresh_candidates(scan_target: str) -> list[dict[str, Any]]:
+    candidates: list[dict[str, Any]] = []
+    for artifact_class in ("product", "fixture"):
+        if not should_scan_artifact_class(scan_target, artifact_class):
+            continue
+
+        for audit_path in find_audit_candidates(artifact_class):
+            try:
+                audit = load_json(audit_path)
+                artifact_type, artifact_path = resolve_artifact_path(audit)
+            except Exception:
+                continue
+
+            if not artifact_path.exists():
+                continue
+
+            review = extract_review_metadata(artifact_path)
+            decision = str(review.get("decision", "")).strip()
+            if decision not in {"accepted", "changes-requested"}:
+                continue
+            if has_review_policy_fields(artifact_path) and not has_legacy_review_text(artifact_path):
+                continue
+
+            candidates.append(
+                {
+                    "artifact_class": artifact_class,
+                    "artifact_type": artifact_type,
+                    "artifact_path": artifact_path,
+                    "audit_path": audit_path,
+                    "decision": decision,
+                    "review": review,
+                }
+            )
+    return candidates
+
+
+def refresh_candidates(candidates: list[dict[str, Any]], write: bool) -> dict[str, Any]:
+    refreshed: list[dict[str, str]] = []
+    failed: list[dict[str, str]] = []
+
+    for item in candidates:
+        artifact_path = item["artifact_path"]
+        audit_path = item["audit_path"]
+        decision = item["decision"]
+        try:
+            if write:
+                write_review(
+                    audit_path=audit_path,
+                    decision=decision,
+                    risks=[],
+                    next_step="",
+                    force=True,
+                )
+            audit = load_json(audit_path)
+            artifact_type, resolved_artifact_path = resolve_artifact_path(audit)
+            review = extract_review_metadata(artifact_path)
+            refreshed.append(
+                {
+                    "artifact_class": str(item["artifact_class"]),
+                    "artifact_type": artifact_type,
+                    "artifact_path": str(resolved_artifact_path),
+                    "audit_path": str(audit_path),
+                    "decision": decision,
+                    "review_action_kind": str(review.get("action_kind", "")),
+                    "review_fallback_stage": str(review.get("fallback_stage", "")),
+                    "review_policy_reason": str(review.get("policy_reason", "")),
+                    "written": "yes" if write else "no",
+                }
+            )
+        except Exception as error:
+            failed.append(
+                {
+                    "artifact_path": str(artifact_path),
+                    "audit_path": str(audit_path),
+                    "error": str(error),
+                }
+            )
+
+    return {
+        "refreshed": refreshed,
+        "failed": failed,
+    }
+
+
+def main() -> int:
+    parser = build_parser()
+    args = parser.parse_args()
+
+    scan_target = normalize_artifact_class(args.artifact_class) if args.artifact_class != "all" else "all"
+    candidates = collect_refresh_candidates(scan_target)
+    result = refresh_candidates(candidates, write=args.write)
+
+    output = {
+        "success": True,
+        "scan_target": args.artifact_class,
+        "write": bool(args.write),
+        "candidate_count": len(candidates),
+        "refreshed_count": len(result["refreshed"]),
+        "failed_count": len(result["failed"]),
+        "refreshed": result["refreshed"],
+        "failed": result["failed"],
+    }
+    if args.format == "summary":
+        lines = [
+            "CodeCGC Review Policy Refresh Audit",
+            f"- 范围: {args.artifact_class}",
+            f"- 写入模式: {'是' if args.write else '否'}",
+            f"- 候选数: {len(candidates)}",
+            f"- 刷新成功数: {len(result['refreshed'])}",
+            f"- 失败数: {len(result['failed'])}",
+        ]
+        if result["refreshed"]:
+            for item in result["refreshed"]:
+                lines.append(
+                    "- 已识别: "
+                    + f"{item.get('artifact_path', '')} "
+                    + f"[{item.get('decision', '')} / {item.get('review_action_kind', '')} / {item.get('review_fallback_stage', '')}]"
+                )
+        if result["failed"]:
+            for item in result["failed"]:
+                lines.append(
+                    "- 失败: "
+                    + f"{item.get('artifact_path', '')} ({item.get('error', '')})"
+                )
+        print("\n".join(lines))
+    else:
+        print(json.dumps(output, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/scripts/review_codecgc_workflow.py

@@ -0,0 +1,88 @@
+import argparse
+import sys
+from pathlib import Path
+
+from codecgc_console_io import configure_utf8_stdio
+from codecgc_console_io import print_json
+from codecgc_review_control import evaluate_review
+from write_codecgc_review import load_json
+from write_codecgc_review import render_review_decision
+from write_codecgc_review import write_review
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="CodeCGC 的高层审核入口：读取 audit、生成审核结论并回写到工作流产物。"
+    )
+    parser.add_argument("--audit-file", required=True, help="执行审计 JSON 文件路径。")
+    parser.add_argument(
+        "--decision",
+        required=True,
+        choices=["accepted", "changes-requested"],
+        help="请求的审核决策：accepted 表示希望通过，changes-requested 表示要求修改。",
+    )
+    parser.add_argument("--risk", action="append", default=[], help="可选：补充剩余风险说明。")
+    parser.add_argument("--next-step", default="", help="可选：补充建议的下一步说明。")
+    parser.add_argument("--force", action="store_true", help="允许覆盖已有审核内容。")
+    return parser
+
+
+def main() -> int:
+    configure_utf8_stdio()
+    parser = build_parser()
+    args = parser.parse_args()
+
+    try:
+        audit = load_json(Path(args.audit_file))
+        values = evaluate_review(audit, args.decision, args.risk, args.next_step)
+        writeback = write_review(
+            audit_path=Path(args.audit_file),
+            decision=args.decision,
+            risks=args.risk,
+            next_step=args.next_step,
+            force=args.force,
+        )
+        result = {
+            "success": True,
+            "audit_file": args.audit_file,
+            "requested_decision": args.decision,
+            "final_decision": values["final_decision"],
+            "accepted": values["accepted"],
+            "review_state": values["review_state"],
+            "recommended_command": values["recommended_command"],
+            "recommended_action_kind": values.get("recommended_action_kind", ""),
+            "fallback_stage": values.get("fallback_stage", ""),
+            "policy_reason": values.get("policy_reason", ""),
+            "risk_classes": values.get("risk_classes", []),
+            "evidence_confidence": values.get("evidence_confidence", ""),
+            "scope_check": values["scope_check"],
+            "executor_check": values["executor_check"],
+            "verification": values["verification"],
+            "remaining_risk": values["remaining_risk"],
+            "next_step": values["next_step"],
+            "failure_reasons": values["failure_reasons"],
+            "writeback": writeback,
+        }
+        result["summary"] = {
+            "human_summary": (
+                f"本次审核已完成，最终决策为{render_review_decision(str(values['final_decision']))}。"
+                if str(values["final_decision"]).strip()
+                else "本次审核已完成。"
+            ),
+            "recommended_command": values["recommended_command"],
+            "next": values["next_step"],
+            "review_state": values["review_state"],
+            "recommended_action_kind": values.get("recommended_action_kind", ""),
+            "fallback_stage": values.get("fallback_stage", ""),
+            "accepted": values["accepted"],
+        }
+    except Exception as error:
+        print_json({"success": False, "error": str(error)}, file=sys.stderr)
+        return 1
+
+    print_json(result)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())