pantheon-opencode 1.4.3 → 1.5.0-beta.2

package/.pantheon/code-mode/eval-llm-judge.py

@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+# ---
+# description: LLM judge for skill/agent quality — scores 4 dimensions (0-100) via an OpenAI-compatible endpoint
+# timeout: 120
+# ---
+"""LLM judge layer of the plugin-eval certification pipeline.
+
+Scores a skill/agent directory on 4 dimensions (correctness, maintainability,
+security, practicality), each 0-100, via ONE structured prompt to an
+OpenAI-compatible chat endpoint. Emits a single JSON document on stdout:
+
+    {name, dimensions: {correctness, maintainability, security, practicality},
+     overall, notes: {<dimension>: <justification>}}
+
+Without explicit opt-in it emits a structured skipped result; missing credentials
+or failed calls exit 2 with a clear message.
+
+Env vars:
+  OPENAI_API_KEY    required bearer token
+  OPENAI_BASE_URL   optional endpoint base (default https://api.openai.com/v1)
+  EVAL_JUDGE_MODEL  optional model id (default gpt-4o-mini)
+
+Stdlib only (urllib.request) — no third-party dependencies.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import re
+import sys
+import urllib.error
+import urllib.request
+from pathlib import Path
+from typing import Any
+from urllib.parse import urlparse
+
+DEFAULT_MODEL = "gpt-4o-mini"
+DEFAULT_BASE_URL = "https://api.openai.com/v1"
+REQUEST_TIMEOUT = 90.0
+MAX_CONTENT_CHARS = 12_000
+MAX_SUPPORTING_CHARS = 8_000
+MAX_SUPPORTING_FILES = 6
+DIMENSIONS = ("correctness", "maintainability", "security", "practicality")
+
+JUDGE_PROMPT = """You are a rigorous quality auditor for AI agent skills and agent definitions used in an agentic coding framework. You decide whether a skill or agent definition is production-quality or AI slop.
+
+Apply an explicit ANTI-SLOP bias: flag overengineering, unnecessary abstractions, persona proliferation (multiple fake personas/characters), unverifiable claims, hype language, and instructions that sound impressive but are not actionable.
+
+Score the content on 4 dimensions, each 0-100:
+1. correctness — instructions are accurate and internally consistent; no contradictions; no broken references (files, commands, or agents that do not exist or are misnamed).
+2. maintainability — clear structure, single responsibility, no overengineering, YAGNI-respecting, easy to update.
+3. security — no secrets or credentials; no prompt-injection vectors; no dangerous instructions (e.g. rm -rf, curl | bash, disabling safety checks).
+4. practicality — solves a real problem, actionable, not AI slop or hype; a human would actually use it.
+
+Return ONLY a JSON object with this exact shape:
+{"correctness": <int 0-100>, "maintainability": <int 0-100>, "security": <int 0-100>, "practicality": <int 0-100>, "notes": {"correctness": "<1-2 sentences>", "maintainability": "<1-2 sentences>", "security": "<1-2 sentences>", "practicality": "<1-2 sentences>"}}
+
+Content to evaluate:
+--- BEGIN CONTENT ---
+{content}
+--- END CONTENT ---
+"""
+
+_NAME_RE = re.compile(r"^name:\s*[\"']?([^\"'\n]+?)[\"']?\s*$", re.MULTILINE)
+
+
+class JudgeError(Exception):
+    """Expected, user-facing judge failure."""
+
+
+def _frontmatter_name(text: str) -> str | None:
+    """Extract the frontmatter `name` value, or None when absent."""
+    if not text.startswith("---"):
+        return None
+    end = text.find("\n---", 3)
+    if end == -1:
+        return None
+    match = _NAME_RE.search(text[3:end])
+    return match.group(1).strip() if match else None
+
+
+def _discover_doc(path: Path) -> Path:
+    """Return the primary doc (SKILL.md or agent .md) for a path."""
+    if path.is_file():
+        return path
+    skill = path / "SKILL.md"
+    if skill.is_file():
+        return skill
+    candidates = sorted(path.glob("*.md"))
+    for candidate in candidates:
+        try:
+            text = candidate.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        if text.startswith("---") and text.find("\n---", 3) != -1:
+            return candidate
+    if candidates:
+        return candidates[0]
+    raise JudgeError(f"No SKILL.md or .md file found in {path}")
+
+
+def _supporting_files(doc: Path) -> list[Path]:
+    """Script files next to the doc or in its scripts/ subdir (capped)."""
+    roots = [doc.parent]
+    scripts_dir = doc.parent / "scripts"
+    if scripts_dir.is_dir():
+        roots.append(scripts_dir)
+    found: list[Path] = []
+    for root in roots:
+        for pattern in ("*.py", "*.sh", "*.js", "*.ts", "*.mjs"):
+            found.extend(sorted(root.glob(pattern)))
+    return [p for p in found if p.is_file() and p != doc][:MAX_SUPPORTING_FILES]
+
+
+def _load_content(doc: Path) -> tuple[str, str]:
+    """Return (name, content) with the doc plus small supporting files."""
+    try:
+        text = doc.read_text(encoding="utf-8", errors="replace")
+    except OSError as exc:
+        raise JudgeError(f"Cannot read {doc}: {exc}") from exc
+    name = _frontmatter_name(text) or doc.stem
+    parts = [f"# {name}\n", text[:MAX_CONTENT_CHARS]]
+    if len(text) > MAX_CONTENT_CHARS:
+        parts.append(f"\n[... truncated {len(text) - MAX_CONTENT_CHARS} chars ...]")
+    support: list[str] = []
+    total = 0
+    for sibling in _supporting_files(doc):
+        try:
+            data = sibling.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        chunk = f"\n--- supporting file: {sibling.name} ---\n{data[:2000]}"
+        if total + len(chunk) > MAX_SUPPORTING_CHARS:
+            break
+        support.append(chunk)
+        total += len(chunk)
+    if support:
+        parts.append("\n".join(support))
+    return name, "".join(parts)
+
+
+def _call_llm(prompt: str, allow_external_llm: bool = False) -> str:
+    """Send one chat completion request via urllib; return the assistant text."""
+    if not allow_external_llm:
+        raise JudgeError("External LLM calls require --allow-external-llm or PANTHEON_ALLOW_EXTERNAL_LLM=1")
+    key = os.getenv("OPENAI_API_KEY")
+    if not key:
+        raise JudgeError(
+            "No LLM available: set OPENAI_API_KEY "
+            "(optionally OPENAI_BASE_URL and EVAL_JUDGE_MODEL)."
+        )
+    base_url = os.getenv("OPENAI_BASE_URL", DEFAULT_BASE_URL).rstrip("/")
+    parsed_url = urlparse(base_url)
+    if parsed_url.scheme not in {"http", "https"} or not parsed_url.netloc:
+        raise JudgeError("OPENAI_BASE_URL must use an http or https URL")
+    endpoint = base_url + "/chat/completions"
+    model = os.getenv("EVAL_JUDGE_MODEL") or DEFAULT_MODEL
+    body = {
+        "model": model,
+        "messages": [{"role": "user", "content": prompt}],
+        "temperature": 0.2,
+    }
+    request = urllib.request.Request(
+        endpoint,
+        data=json.dumps(body).encode("utf-8"),
+        headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"},
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=REQUEST_TIMEOUT) as response:
+            payload = json.loads(response.read().decode("utf-8"))
+    except urllib.error.HTTPError as exc:
+        detail = exc.read().decode("utf-8", errors="replace")[:200].replace(key, "[redacted]")
+        raise JudgeError(f"LLM endpoint returned HTTP {exc.code}: {detail}") from exc
+    except (urllib.error.URLError, TimeoutError, OSError) as exc:
+        reason = getattr(exc, "reason", exc)
+        raise JudgeError(f"LLM request failed: {reason}") from exc
+    except (json.JSONDecodeError, UnicodeDecodeError) as exc:
+        raise JudgeError(f"LLM returned invalid JSON payload: {exc}") from exc
+    choices = payload.get("choices") if isinstance(payload, dict) else None
+    message = choices[0].get("message") if choices else None
+    text = message.get("content") if isinstance(message, dict) else None
+    if not isinstance(text, str) or not text.strip():
+        raise JudgeError("LLM returned an empty response.")
+    return text.replace(key, "[redacted]")
+
+
+def _parse_json_object(value: str) -> dict[str, Any] | None:
+    """Parse strict JSON and the fenced JSON commonly returned by models."""
+    candidates = [value.strip()]
+    if candidates[0].startswith("```") and candidates[0].endswith("```"):
+        candidates.append(candidates[0].split("\n", 1)[-1][:-3].strip())
+    for candidate in candidates:
+        try:
+            parsed = json.loads(candidate)
+        except json.JSONDecodeError:
+            continue
+        if isinstance(parsed, dict):
+            return parsed
+    return None
+
+
+def _parse_scores(text: str) -> dict[str, Any]:
+    """Validate the LLM JSON into the report's dimensions/overall/notes."""
+    parsed = _parse_json_object(text)
+    if parsed is None:
+        raise JudgeError("LLM did not return valid JSON.")
+    dimensions: dict[str, int] = {}
+    for dim in DIMENSIONS:
+        raw = parsed.get(dim)
+        try:
+            value = int(raw)
+        except (TypeError, ValueError) as exc:
+            raise JudgeError(f"LLM returned non-integer score for {dim}: {raw!r}") from exc
+        if not 0 <= value <= 100:
+            raise JudgeError(f"LLM returned out-of-range score for {dim}: {value}")
+        dimensions[dim] = value
+    raw_notes = parsed.get("notes")
+    notes = (
+        {dim: str(raw_notes.get(dim, "")) for dim in DIMENSIONS}
+        if isinstance(raw_notes, dict)
+        else {dim: "" for dim in DIMENSIONS}
+    )
+    overall = round(sum(dimensions.values()) / len(dimensions), 1)
+    return {"dimensions": dimensions, "overall": overall, "notes": notes}
+
+
+def main(argv: list[str] | None = None) -> int:
+    """CLI entry point: `python eval-llm-judge.py <skill-or-agent-dir>`."""
+    parser = argparse.ArgumentParser(
+        description="LLM judge for skill/agent quality (plugin-eval layer 2)."
+    )
+    parser.add_argument("path", help="Path to a skill/agent directory or doc file")
+    parser.add_argument("--allow-external-llm", action="store_true", help="Permit sending content to the configured LLM endpoint")
+    args = parser.parse_args(argv)
+    allow_external_llm = args.allow_external_llm or os.getenv("PANTHEON_ALLOW_EXTERNAL_LLM") == "1"
+    try:
+        doc = _discover_doc(Path(args.path))
+        name, content = _load_content(doc)
+        if not allow_external_llm:
+            print(json.dumps({"name": name, "skipped": True, "reason": "external LLM calls not opted in"}, ensure_ascii=False, indent=2))
+            return 0
+        raw = _call_llm(JUDGE_PROMPT.replace("{content}", content), allow_external_llm=True)
+        result = _parse_scores(raw)
+    except JudgeError as exc:
+        print(f"eval-llm-judge: {exc}", file=sys.stderr)
+        return 2
+    print(json.dumps({"name": name, **result}, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/.pantheon/code-mode/eval-monte-carlo.py

@@ -0,0 +1,368 @@
+#!/usr/bin/env python3
+# ---
+# description: Monte Carlo reliability scoring for skills/agents — simulates N runs of the core workflow (plugin-eval layer 3)
+# timeout: 120
+# ---
+"""Monte Carlo reliability layer of the plugin-eval certification pipeline (PR 3).
+
+Simulates N runs of a skill/agent's core workflow. Each run re-verifies the
+frontmatter, a seeded random subset of referenced files/commands, and (when
+present) the skill's test/verify command. Reliability = passes / runs * 100.
+
+For agents, additionally verifies that `skills:` and `@agent` references point
+at real skills/agents and that the YAML frontmatter is valid.
+
+Emits a single JSON document on stdout:
+    {runs, passes, reliability (0-100), failures: [{run, reasons}, ...], ...}
+
+Exit codes: 0 = reliability >= 75, 1 = reliability < 75, 2 = usage/IO error.
+The declared test command executes once per invocation and its result is
+reused across runs (it is deterministic; re-running it N times only burns time).
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import random
+import re
+import shlex
+import signal
+import subprocess
+import sys
+from datetime import date
+from pathlib import Path
+from typing import Any
+
+DEFAULT_RUNS = 20
+DEFAULT_SEED = 42
+TEST_TIMEOUT = 15.0
+SAFE_COMMAND_PREFIXES = ("pytest", "python -m pytest", "npm test", "npm run test", "npm run verify", "bash", "python", "python3", "./")
+KNOWN_AGENTS = frozenset(
+    {
+        "athena", "apollo", "hermes", "aphrodite", "demeter", "themis",
+        "prometheus", "hephaestus", "nyx", "gaia", "iris", "mnemosyne",
+        "talos", "zeus",
+    }
+)
+FILE_REF_RE = re.compile(r"`([\w./-]+\.(?:py|sh|js|ts|mjs|md|json|yml|yaml|toml))`")
+COMMAND_STARTS = ("python", "python3", "bash", "npm", "node", "npx", "pytest", "uv", "./")
+SUPPORTED_COMMANDS = frozenset({"python", "python3", "bash", "npm", "node", "npx", "pytest", "uv"})
+SHELL_OPERATORS = (";", "&&", "||", "|", ">", "<", "`", "$(")
+TEST_SECTION_RE = re.compile(r"^##+\s+(?:Verification|Testing|Test)\b.*$", re.MULTILINE)
+
+
+def _coerce(value: str) -> Any:
+    """Coerce a scalar string into bool/int/float when possible."""
+    lowered = value.lower()
+    if lowered in ("true", "false"):
+        return lowered == "true"
+    if lowered in ("null", "none", "~"):
+        return None
+    try:
+        return int(value)
+    except ValueError:
+        pass
+    try:
+        return float(value)
+    except ValueError:
+        pass
+    return value
+
+
+def _minimal_yaml(block: str) -> dict[str, Any]:
+    """Tiny YAML-subset parser for flat frontmatter (key: value, lists)."""
+    data: dict[str, Any] = {}
+    current_key: str | None = None
+    for raw in block.splitlines():
+        line = raw.rstrip()
+        if not line.strip() or line.lstrip().startswith("#"):
+            continue
+        if line.lstrip().startswith("- "):
+            item = line.split("- ", 1)[1].strip().strip('"').strip("'")
+            if current_key is not None:
+                data.setdefault(current_key, []).append(item)
+            continue
+        if ":" not in line:
+            continue
+        key, _, value = line.partition(":")
+        current_key = key.strip()
+        value = value.strip()
+        if not value:
+            data[current_key] = []
+        else:
+            data[current_key] = _coerce(value.strip('"').strip("'"))
+    return data
+
+
+def _parse_frontmatter(text: str) -> dict[str, Any] | None:
+    """Parse a YAML frontmatter block; return None when absent or invalid."""
+    if not text.startswith("---"):
+        return None
+    end = text.find("\n---", 3)
+    if end == -1:
+        return None
+    block = text[3:end]
+    try:
+        import yaml  # local import: optional dependency
+
+        data = yaml.safe_load(block)
+        return data if isinstance(data, dict) else None
+    except ImportError:
+        return _minimal_yaml(block)
+    except Exception:  # noqa: BLE001 - any YAML error means invalid frontmatter
+        return None
+
+
+def _discover_doc(path: Path) -> Path:
+    """Return the primary doc (SKILL.md or agent .md) for a path."""
+    if path.is_file():
+        return path
+    skill = path / "SKILL.md"
+    if skill.is_file():
+        return skill
+    candidates = sorted(path.glob("*.md"))
+    for candidate in candidates:
+        try:
+            text = candidate.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        if _parse_frontmatter(text) is not None:
+            return candidate
+    if candidates:
+        return candidates[0]
+    raise ValueError(f"No SKILL.md or .md file found in {path}")
+
+
+def _as_list(value: Any) -> list[Any]:
+    if isinstance(value, list):
+        return value
+    if isinstance(value, str) and value.strip():
+        return [value]
+    return []
+
+
+def _extract_references(doc: Path, text: str, is_agent: bool) -> dict[str, list[str]]:
+    """Extract file refs, commands, agent mentions, and (agents) skill refs."""
+    refs: dict[str, list[str]] = {"files": [], "commands": [], "agents": [], "skills": []}
+    for match in FILE_REF_RE.finditer(text):
+        ref = match.group(1)
+        if ref not in refs["files"]:
+            refs["files"].append(ref)
+    for line in text.splitlines():
+        stripped = line.strip()
+        if not stripped.startswith(COMMAND_STARTS) or stripped.startswith(("#", "//")):
+            continue
+        cmd = stripped.split("&&")[0].strip()
+        if cmd and cmd not in refs["commands"]:
+            refs["commands"].append(cmd)
+    for mention in re.findall(r"@([a-z][a-z0-9-]*)", text):
+        if mention not in refs["agents"]:
+            refs["agents"].append(mention)
+    if is_agent:
+        frontmatter = _parse_frontmatter(text) or {}
+        refs["skills"] = [str(s) for s in _as_list(frontmatter.get("skills"))]
+    return refs
+
+
+def _find_test_command(doc: Path, text: str) -> str | None:
+    """Return a test/verify command from frontmatter or a Verification section."""
+    frontmatter = _parse_frontmatter(text) or {}
+    for key in ("test", "test_command", "verify_command", "check_command"):
+        value = frontmatter.get(key)
+        if isinstance(value, str) and value.strip():
+            return value.strip()
+    for match in TEST_SECTION_RE.finditer(text):
+        section = text[match.end() :].split("\n##", 1)[0]
+        for line in section.splitlines():
+            stripped = line.strip()
+            if stripped.startswith(SAFE_COMMAND_PREFIXES) and not stripped.startswith(("#", "//")):
+                return stripped.split("&&")[0].strip()
+    return None
+
+
+def _check_frontmatter(doc: Path, is_agent: bool) -> tuple[bool, str]:
+    """Validate the doc's YAML frontmatter and required keys."""
+    try:
+        text = doc.read_text(encoding="utf-8", errors="replace")
+    except OSError as exc:
+        return False, f"cannot read {doc.name}: {exc}"
+    frontmatter = _parse_frontmatter(text)
+    if frontmatter is None:
+        return False, "frontmatter missing or invalid YAML"
+    required = ("name", "description", "mode") if is_agent else ("name", "description")
+    missing = [key for key in required if key not in frontmatter]
+    if missing:
+        return False, f"frontmatter missing keys: {', '.join(missing)}"
+    return True, ""
+
+
+def _resolve_file(ref: str, base: Path, repo_root: Path) -> Path | None:
+    """Resolve a file reference against the doc dir, repo root, or CWD."""
+    candidate = Path(ref)
+    if candidate.is_absolute():
+        return candidate if candidate.exists() else None
+    for root in (base, repo_root, Path.cwd()):
+        resolved = root / ref
+        if resolved.exists():
+            return resolved
+    return None
+
+
+def _check_file(ref: str, base: Path, repo_root: Path) -> tuple[bool, str]:
+    """Verify a referenced file exists (and is executable for shell scripts)."""
+    resolved = _resolve_file(ref, base, repo_root)
+    if resolved is None:
+        return False, f"missing file: {ref}"
+    if resolved.suffix == ".sh" and not os.access(resolved, os.X_OK):
+        return False, f"not executable: {ref}"
+    return True, ""
+
+
+def _check_command(cmd: str, base: Path, repo_root: Path) -> tuple[bool, str]:
+    """Verify a command's file argument exists (module-only commands pass)."""
+    for token in cmd.split()[1:]:
+        if "/" in token or token.endswith((".py", ".sh", ".js", ".mjs")):
+            if _resolve_file(token, base, repo_root) is None:
+                return False, f"command references missing file: {token}"
+            break
+    return True, ""
+
+
+def _run_test_command(cmd: str, base: Path) -> tuple[bool, str]:
+    """Run an allowlisted command without invoking a shell."""
+    if any(operator in cmd for operator in SHELL_OPERATORS):
+        return False, f"unsafe test command skipped: shell operator in {cmd}"
+    try:
+        argv = shlex.split(cmd)
+    except ValueError as exc:
+        return False, f"unsafe test command skipped: invalid command syntax: {exc}"
+    if not argv:
+        return False, "unsafe test command skipped: empty command"
+    executable = Path(argv[0]).name if argv[0].startswith("./") else argv[0]
+    if executable not in SUPPORTED_COMMANDS and not argv[0].startswith("./"):
+        return False, f"unsafe test command skipped: unsupported command: {argv[0]}"
+    try:
+        proc = subprocess.Popen(
+            argv,
+            cwd=base,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+            start_new_session=True,
+        )
+        try:
+            _stdout, _stderr = proc.communicate(timeout=TEST_TIMEOUT)
+        except subprocess.TimeoutExpired:
+            os.killpg(proc.pid, signal.SIGKILL)
+            proc.wait()
+            return False, f"test command timed out: {cmd}"
+    except subprocess.TimeoutExpired:
+        return False, f"test command timed out: {cmd}"
+    except OSError as exc:
+        return False, f"test command failed to start: {exc}"
+    if proc.returncode != 0:
+        return False, f"test command exited {proc.returncode}: {cmd}"
+    return True, ""
+
+
+def _simulate(
+    rng: random.Random,
+    doc: Path,
+    is_agent: bool,
+    refs: dict[str, list[str]],
+    test_cmd: str | None,
+    test_result: tuple[bool, str] | None,
+    repo_root: Path,
+    skills_dirs: list[Path],
+    agents_dir: Path,
+) -> tuple[list[str], tuple[bool, str] | None]:
+    """Run one simulated execution; return (failure reasons, cached test result)."""
+    failures: list[str] = []
+    ok, reason = _check_frontmatter(doc, is_agent)
+    if not ok:
+        failures.append(reason)
+    files = refs["files"]
+    if files:
+        k = rng.randint(max(1, len(files) // 2), len(files))
+        for ref in rng.sample(files, k):
+            ok, reason = _check_file(ref, doc.parent, repo_root)
+            if not ok:
+                failures.append(reason)
+    commands = refs["commands"]
+    if commands:
+        k = rng.randint(max(1, len(commands) // 2), len(commands))
+        for cmd in rng.sample(commands, k):
+            ok, reason = _check_command(cmd, doc.parent, repo_root)
+            if not ok:
+                failures.append(reason)
+    for agent in refs["agents"]:
+        if agent in KNOWN_AGENTS and not (agents_dir / f"{agent}.md").exists():
+            failures.append(f"unknown agent reference: @{agent}")
+    for skill in refs["skills"]:
+        if not any((directory / skill / "SKILL.md").exists() for directory in skills_dirs):
+            failures.append(f"unknown skill reference: {skill}")
+    if test_cmd:
+        if test_result is None:
+            test_result = _run_test_command(test_cmd, doc.parent)
+        if not test_result[0]:
+            failures.append(test_result[1])
+    return failures, test_result
+
+
+def main(argv: list[str] | None = None) -> int:
+    """CLI entry point: `python eval-monte-carlo.py <path> [--runs N]`."""
+    parser = argparse.ArgumentParser(
+        description="Monte Carlo reliability scoring (plugin-eval layer 3)."
+    )
+    parser.add_argument("path", help="Path to a skill/agent directory or doc file")
+    parser.add_argument("--runs", type=int, default=DEFAULT_RUNS, help="Simulated runs (default 20)")
+    parser.add_argument("--seed", type=int, default=DEFAULT_SEED, help="RNG seed (default 42)")
+    args = parser.parse_args(argv)
+    if args.runs < 1:
+        print("eval-monte-carlo: --runs must be >= 1", file=sys.stderr)
+        return 2
+    repo_root = Path(__file__).resolve().parent.parent.parent
+    agents_dir = repo_root / "src" / "agents"
+    skills_dirs = [repo_root / ".opencode" / "skills", Path.home() / ".config" / "opencode" / "skills"]
+    try:
+        doc = _discover_doc(Path(args.path))
+    except ValueError as exc:
+        print(f"eval-monte-carlo: {exc}", file=sys.stderr)
+        return 2
+    text = doc.read_text(encoding="utf-8", errors="replace")
+    frontmatter = _parse_frontmatter(text) or {}
+    is_agent = "mode" in frontmatter
+    refs = _extract_references(doc, text, is_agent)
+    test_cmd = _find_test_command(doc, text)
+    rng = random.Random(args.seed)
+    failures_list: list[dict[str, Any]] = []
+    test_result: tuple[bool, str] | None = None
+    passes = 0
+    for run in range(1, args.runs + 1):
+        failures, test_result = _simulate(
+            rng, doc, is_agent, refs, test_cmd, test_result, repo_root, skills_dirs, agents_dir
+        )
+        if failures:
+            failures_list.append({"run": run, "reasons": failures})
+        else:
+            passes += 1
+    reliability = round(100.0 * passes / args.runs, 1)
+    report = {
+        "name": frontmatter.get("name") or doc.stem,
+        "date": date.today().isoformat(),
+        "runs": args.runs,
+        "passes": passes,
+        "reliability": reliability,
+        "seed": args.seed,
+        "kind": "agent" if is_agent else "skill",
+        "test_command": test_cmd,
+        "failures": failures_list,
+    }
+    print(json.dumps(report, ensure_ascii=False, indent=2))
+    return 0 if reliability >= 75.0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())