ilo 0.12.0

#!/usr/bin/env python3
"""
Enforce the modular-skill token budget (Phase 1, PR #395).

Each `skills/ilo/ilo-*.md` module must encode to <= 1,000 tokens under
`cl100k_base`. The aggregate across all six must be <= 5,000.

The budget exists because the whole point of splitting the monolithic
~16,000-token compact spec into modules was to let agents load only the
slices their current task needs (typical: 1-2 modules ~ 2,000 tokens). If
a module drifts past 1,000 tokens, the per-task economics regress, so the
guard is a CI gate, not advisory.

Run locally with: `python3 scripts/check-skill-tokens.py`
"""

from __future__ import annotations

import sys
from pathlib import Path

import tiktoken

SKILL_NAMES = [
    "ilo-language",
    "ilo-builtins",
    "ilo-errors",
    "ilo-tools",
    "ilo-engines",
    "ilo-agent",
    "ilo-examples",
    "ilo-edit-loop",
]

PER_MODULE_LIMIT = 1000
TOTAL_LIMIT = 5000


def main() -> int:
    enc = tiktoken.get_encoding("cl100k_base")
    skills_dir = Path(__file__).resolve().parent.parent / "skills" / "ilo"

    total = 0
    failed = False
    for name in SKILL_NAMES:
        path = skills_dir / f"{name}.md"
        if not path.exists():
            print(f"ERROR: missing skill file: {path}", file=sys.stderr)
            failed = True
            continue
        tokens = len(enc.encode(path.read_text()))
        total += tokens
        flag = "  OVER" if tokens > PER_MODULE_LIMIT else ""
        print(f"  {name:<14} {tokens:5d} tokens{flag}")
        if tokens > PER_MODULE_LIMIT:
            failed = True

    print(f"  {'TOTAL':<14} {total:5d} tokens")
    if total > TOTAL_LIMIT:
        print(
            f"ERROR: total {total} exceeds aggregate budget {TOTAL_LIMIT}",
            file=sys.stderr,
        )
        failed = True
    return 1 if failed else 0


if __name__ == "__main__":
    sys.exit(main())