{
  "_comment": [
    "THE retention number for published agent artifacts. One file, read by everything that",
    "depends on it, because a check and the policy it enforces must read the same number from the",
    "same place or they drift — and the drift looks like a defect in something else.",
    "",
    "WHAT WENT WRONG WITHOUT IT (2026-08-08/09). The registry stopped serving felhom-agent",
    "0.120.0 and older, while scripts/check-published-versions.py demanded that EVERY git tag",
    "still be downloadable. Both rules are individually sensible; together they are impossible.",
    "CI went red at a commit whose own run had been green the day before, on a true finding that",
    "no one could act on. The red will return at the next publish unless the two read one number.",
    "",
    "HOW THE NUMBER WAS ARRIVED AT. generic_versions_kept is 10 because that is what the registry",
    "keeps: the deleter was ESTABLISHED on 2026-08-10 (R-287) — the newest-10 prune of generic packages",
    "run under R-267 (felhom-agent and felhom-golden generic held exactly 10 afterwards). Until then this",
    "file called the 10 an observed state with no located ruling; that is superseded (corrected",
    "2026-10-05, R-291). Container packages are not pruned by that rule.",
    "",
    "SO THIS FILE IS A FLOOR, NOT A LICENCE. It says: CI may assume nothing older than the newest",
    "N generic versions is still downloadable. It does NOT authorise deleting anything, and the",
    "operator should confirm or replace the number — at which point this file changes and both",
    "readers follow it in the same commit.",
    "",
    "THE DEEPER BOUND, recorded so a future session does not have to re-derive it: the principled",
    "limit is the hub's vouched min_agent floor (0.127.0 on 2026-08-09). Nothing can install an",
    "agent below it — the hub refuses to vouch one and boxes update to the floor — so a released",
    "version below the floor being un-downloadable costs nothing real. Bounding on the floor would",
    "be better than bounding on a count, and it needs the gate to read the hub, which is network",
    "the gate does not have today. Filed as the follow-up in R-287.",
    "",
    "NEVER retire a git TAG to satisfy this. felhom-host-install.sh fetches an agent's config",
    "files from raw/tag/v<version>/configs/, so deleting a tag retires the ability to install that",
    "version at all — a strictly worse act than an un-downloadable binary."
  ],
  "generic_versions_kept": 10,
  "readers": [
    "scripts/check-published-versions.py — bounds its assertion to the newest N versions"
  ],
  "recorded": "2026-08-09",
  "recorded_by": "CC 2026-08-09; the number's source (the R-267 newest-10 prune, established 2026-08-10 by R-287) recorded 2026-10-05 (R-291)"
}