#!/usr/bin/env python3 """ enrich_dist_skills.py — Non-mutating enrichment pass over dist/skills. Reads every SKILL.md, derives tags/domain/risk, dedupes tags, fingerprints source family, and writes proposal-only reports. Does NOT modify any skill. Outputs: reports/dist-skills-enriched-inventory.json reports/dist-skills-domain-report.md reports/dist-skills-risk-report.md reports/frontmatter-proposals.json reports/frontmatter-proposals.md reports/quality-gate-flagged.json reports/source-fingerprint.md """ from pathlib import Path from collections import Counter, defaultdict import json import re import yaml from typing import Iterable ROOT = Path("dist/skills") OUT = Path("reports") OUT.mkdir(exist_ok=True) # --------------------------------------------------------------------------- # YAML frontmatter parser (pyyaml-backed) # --------------------------------------------------------------------------- FM_RE = re.compile(r"^---\r?\n(.*?)\r?\n---\r?\n", re.S) def parse_frontmatter(text: str): """Return (frontmatter_dict, body_text) using yaml.safe_load.""" m = FM_RE.match(text) if not m: return {}, text try: fm = yaml.safe_load(m.group(1)) if not isinstance(fm, dict): fm = {} except yaml.YAMLError: fm = {} body = text[m.end():] return fm, body def slug_to_title(value: str) -> str: text = value.replace("_", " ").replace("-", " ").strip() text = re.sub(r"\s+", " ", text) if not text: return value words = [] for word in text.split(): if word.isupper(): words.append(word) elif len(word) <= 3 and word.lower() in {"api", "cli", "sdk", "css", "html", "sql", "aws", "gcp"}: words.append(word.upper()) else: words.append(word.capitalize()) return " ".join(words) def first_heading(body: str) -> str: for line in body.splitlines(): if line.startswith("# "): heading = line[2:].strip() heading = re.sub(r"\s+\([^)]*\)$", "", heading).strip() return heading return "" def first_meaningful_paragraph(body: str) -> str: lines = [] for raw in body.splitlines(): line = raw.strip() if not line: if lines: break continue if line.startswith("#") or line.startswith(">") or line.startswith("```") or line.startswith("