Files
yao-meta-skill/scripts/reference_synthesis_markdown.py
YAO 31ce04c655 Split meta skill CLI and review gates
Merge the beta-ready Yao Meta Skill architecture, report, evidence gate, and release-boundary updates.\n\nRelease boundary: beta/public testing is allowed; formal world-class, fully reviewed, or superiority claims remain blocked until the pending evidence gates are accepted.
2026-06-17 18:43:02 +08:00

100 lines
4.0 KiB
Python

from typing import Any
SCRIPT_INTERFACE = "internal-module"
SCRIPT_INTERFACE_REASON = "Imported by render_reference_synthesis.py to keep reference synthesis modeling separate from Markdown rendering."
def render_markdown(summary: dict[str, Any]) -> str:
lines = [
"# Reference Synthesis",
"",
f"Skill: `{summary['skill_name']}`",
f"- Description: {summary['description']}",
f"- Intent confidence: `{summary['intent_confidence']['score']}/100` (`{summary['intent_confidence']['band']}`)",
"",
"## Live GitHub Benchmarks",
"",
]
if summary["github_benchmarks"]:
for repo in summary["github_benchmarks"]:
lines.extend(
[
f"### {repo['name']}",
f"- URL: {repo['url']}",
f"- Stars: `{repo['stars']}`",
]
)
for item in repo.get("borrow", []):
lines.append(f"- Borrow: {item}")
lines.append("")
else:
lines.append("- No live GitHub benchmarks are attached yet.")
lines.append("")
lines.extend(["## Curated World-Class Pattern Tracks", ""])
for track in summary["source_tracks"]:
lines.extend(
[
f"### {track['name']}",
f"- Type: `{track['source_type']}`",
f"- Evidence mode: `{track['evidence_mode']}`",
f"- Why relevant: {track['why_relevant']}",
f"- Borrow: {track['borrow']}",
f"- Avoid: {track['avoid']}",
"",
]
)
lines.extend(["## Borrow Now", ""])
for item in summary["synthesis"]["borrow_now"]:
lines.append(f"- {item}")
lines.extend(["", "## Avoid Now", ""])
for item in summary["synthesis"]["avoid_now"]:
lines.append(f"- {item}")
lines.extend(["", "## Pattern Gate", ""])
pattern_gate = summary["synthesis"]["pattern_gate"]
lines.append(f"- Summary: {pattern_gate['summary']}")
lines.append(f"- Acceptance threshold: `{pattern_gate['threshold']}/4`")
if pattern_gate["accepted"]:
lines.append("- Accepted patterns:")
for item in pattern_gate["accepted"][:5]:
lines.append(
f" - **{item['name']}**: {item['score']}/4 "
f"({', '.join(item['passed'])})"
)
if pattern_gate["deferred"]:
lines.append("- Deferred patterns:")
for item in pattern_gate["deferred"][:5]:
lines.append(
f" - **{item['name']}**: missing {', '.join(item['missing']) or 'none'}"
)
lines.extend(["", "## Default Recommendation", ""])
lines.append(f"- Summary: {summary['synthesis']['recommendation']['summary']}")
lines.append(f"- Why: {summary['synthesis']['recommendation']['why']}")
lines.append(f"- User decision required: `{summary['synthesis']['recommendation']['user_decision_required']}`")
lines.extend(["", "## Visibility Mode", ""])
lines.append(f"- Mode: `{summary['synthesis']['visibility']['mode']}`")
if summary["synthesis"]["visibility"]["reasons"]:
lines.append(f"- Reasons: {', '.join(summary['synthesis']['visibility']['reasons'])}")
lines.append(f"- User note: {summary['synthesis']['visibility']['user_note']}")
lines.append(f"- Reviewer note: {summary['synthesis']['visibility']['reviewer_note']}")
lines.extend(["", "## Conflict Check", ""])
if summary["synthesis"]["conflicts"]:
for conflict in summary["synthesis"]["conflicts"]:
lines.append(f"- **{conflict['key']}**: {conflict['summary']}")
else:
lines.append("- No material design conflict detected. Keep the synthesis silent for the user.")
lines.extend(["", "## Quality Lift Thesis", ""])
for item in summary["synthesis"]["quality_risers"]:
lines.append(f"- {item}")
lines.extend(["", "## Decision Prompt", "", summary["synthesis"]["decision_prompt"], ""])
return "\n".join(lines).strip() + "\n"