2 Commits

Include renames

Author	SHA1	Message	Date
vh	bf351a26d1	feat(u7): filename groups — the last v1 unit, and a table that did not reproduce ... Completes U7 with its fourth component: a jump-to-group rail derived from filename prefixes, replacing the subfolder sections ROADMAP named. The scope departure was ratified by the operator 2026-09-22; this commit deletes test_no_group_rail_is_shipped_yet, the guard that held it back, in the same change that builds what it guarded against. All seven v1 capabilities are now landed. The 1.0 cut is a decision, not a dependency, and it is the operator's — no version bump here, because a commit is not a release. THE RULE CHANGED AT IMPLEMENTATION, ON MEASURED GROUNDS. The contract specified `strip ONE trailing run of digits`; run against the live set that yields 24 groups for sindra-bakeoff's 40 images and 27 for sindra's 30 — a rail with a row per tile — because it keys on the END of the stem, where the instance number lives. The contract's own table claimed 5 and 1 for those two booths and neither reproduces; the numbers are reachable only by two OTHER heuristics, so the table that justified the design was assembled from more than one rule. Its own worked example contradicts it in plain sight. The shipped rule keys on the first separator-delimited segment, where the family lives, destemming only when the stem has no separator at all — so `ac01` -> `ac` while `v30-seed8302` and `v35-seed8302` stay apart. Re-measured across all 17 live booths; the table is in the contract. INV-3 GAINED ITS SECOND DEGENERACY. The contract guarded one group for everything (sc-iso-spread: DSC0001-DSC0006). The live set's actual failure is the opposite — pewpew-ui-brief yields 23 groups for 34 items, dfa-concepts 13 for 20 — and the contract as written would have shipped a rail that is a second copy of the grid. The rail now renders only when grouping is informative: two or more groups, and the middle group holding more than one item. That predicate gets all 17 booths right. Grouping is a VIEW. The grid stays sorted(rel) and the zoom ring stays that order filtered to images; the group fixture interleaves across subdirectories precisely so a (group, rel) re-sort goes red. Groups are derived from the RENDERED list, not the full gallery, so no anchor points at a filtered-out tile. booth/items.py _group_of + Item.group, derived in the resolver (INV-1) booth/app.py _groups() builds the rail rows; build_gallery carries it booth/templates/ the rail-groups nav and its CSS tests/ +16 tests; 639 green Every new falsifier was proved by running its defeating change (12/12). Three were vacuous first time out: one fixture's positional order happened to be alphabetical, one assertion miscounted elements, and the harness itself certified a broken test twice — no green baseline, and byte-identical mutations silently defeated by the pyc cache's one-second mtime granularity.	2026-09-22 21:33:54 -07:00
vh	ce598b3cf6	feat(items): one item record, so an annotation survives the zoom ... The operator reported that zoomed-in images lose their annotations. That was never a rendering bug. Three functions independently walked a booth and derived overlapping subsets of the same facts -- build_gallery (kind, caption, blur, doc), booth_view_file (kind, doc, image ring) and list_booths (kind counts, cover) -- and the zoom route's subset was the smallest. Caption resolution lived inside build_gallery's loop and nowhere else, so there was no code path by which a caption could reach the zoom template. It was never sent. booth/items.py is now the one truth: booth_items() returns the full record -- rel, kind, section, caption, blur, doc kind, size -- and the gallery, the zoom view, the doc view and the index all read it. Patching view.html would have fixed the symptom for images and left the next surface starting from the same missing truth. Two things fall out of the consolidation: - the index and the booth page now agree on what an item IS. list_booths counted every non-dot file, so an A/B pair with two caption sidecars read as 4 items on the index and showed 2 tiles when you opened it. - "section" (the item's subfolder) is computed and carried but nothing renders it yet. That is deliberate: it is U7's whole input, and shipping the field now makes U7 a template change rather than a resolver change. Doc bodies are NOT rendered by the resolver -- the index touches every booth on every page load, and rendering every markdown file in every booth would be the price of that convenience. render_doc_body is a separate step for the one surface that inlines them; an invariant test monkeypatches it to raise and loads the index. Verified beyond the suite, because this repo has shipped two dead controls that every test passed: the caption was measured in a real browser at 1280x41 px, visible, with elementFromPoint at its centre returning the caption itself. layout-probe reports all controls hittable across index, gallery, zoom and doc. 192 tests pass (173 before, 19 new). Contract: docs/contracts/u1_item_record.contract.md	2026-09-21 22:04:07 -07:00