Files
Claro/tools/validate_trusted_command_docs.py
T

25 lines
715 B
Python

#!/usr/bin/env python3
"""Ensure the learner-facing RUN COMMAND docs describe its trust boundary."""
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
DOC = ROOT / "docs" / "PRACTICAL_SCRIPTING.md"
def main() -> int:
text = DOC.read_text(encoding="utf-8").lower()
required = (
"trusted code",
"not a sandbox",
"runs commands on the user's computer",
)
missing = [phrase for phrase in required if phrase not in text]
if missing:
raise SystemExit("RUN COMMAND documentation is missing: " + ", ".join(missing))
print("Trusted command documentation validation complete")
return 0
if __name__ == "__main__":
raise SystemExit(main())