"""docs/ledger/estimates.jsonl의 줄이 docs/ledger/README.md 형식인지 본다. 빈 파일(복사한 프로젝트)도 통과한다. python3 -m unittest discover -s scripts/tests """ from __future__ import annotations import json import unittest from datetime import datetime from pathlib import Path REPO = Path(__file__).resolve().parent.parent.parent LEDGER = REPO / "docs/ledger/estimates.jsonl" KINDS = {"estimate", "actual", "retro"} COMMON = ("schema", "kind", "task", "recorded_at") RANGES = ("minutes", "calls", "output_tokens") def lines() -> list[dict]: if not LEDGER.exists(): return [] return [json.loads(line) for line in LEDGER.read_text(encoding="utf-8").splitlines() if line.strip()] class LedgerTest(unittest.TestCase): def test_lines_merge_by_union(self) -> None: self.assertIn("docs/ledger/estimates.jsonl merge=union", (REPO / ".gitattributes").read_text(encoding="utf-8").splitlines()) def test_every_line_is_json_with_the_common_fields(self) -> None: for number, entry in enumerate(lines(), start=1): self.assertTrue(set(COMMON) <= entry.keys(), f"line {number}: {sorted(set(COMMON) - entry.keys())}") self.assertEqual(entry["schema"], 1, number) self.assertIn(entry["kind"], KINDS, number) datetime.fromisoformat(entry["recorded_at"]) def test_an_estimate_has_ordered_ranges_and_a_basis(self) -> None: for entry in (e for e in lines() if e["kind"] == "estimate"): for field in RANGES: values = entry[field] self.assertLessEqual(values["p30"], values["p50"], (entry["task"], field)) self.assertLessEqual(values["p50"], values["p80"], (entry["task"], field)) self.assertTrue(entry["basis"].strip(), entry["task"]) def test_an_actual_follows_its_estimate_and_names_the_band_it_fell_in(self) -> None: entries = lines() for position, entry in enumerate(entries): if entry["kind"] != "actual": continue estimates = [e for e in entries[:position] if e["kind"] == "estimate" and e["task"] == entry["task"]] self.assertTrue(estimates, f"{entry['task']}: an actual line needs an earlier estimate line") bands = estimates[-1]["minutes"] expected = next((band for band in ("p30", "p50", "p80") if entry["active_minutes"] <= bands[band]), "over") self.assertEqual(entry["within"], expected, entry["task"]) if __name__ == "__main__": unittest.main()