Repository navigation
Description
Purpose
#116 finished the plumbing: one Images shelf, four sources, one Artworks shelf with three, one Texts shelf with two, every card credited, every item saying why it is there. This issue is the appearance pass the owner asked for once that was proven — and the one product decision #116 left open (its D2), which the card design depends on. Measured on main @ 79fd344, 2026-09-19, on /define/war, /define/soldier, /define/nepotism and /define/logomachy at 1280 and 375.
Schema impact
0 new tables, 0 changes to existing tables. Every change is in ContentTypes (data), Culture (the reader), the provider that composes a credit line, and the conformance suite where an assertion names a DOM id that moves.
What the page looks like today, measured
- No word is without an Images shelf. Openverse, Unsplash and Pexels decline nothing and Pexels has no empty at all:
nepotismshows 36 stock photographs,logomachy11. Every one is labelled Search result for “…”, ranked by the provider and not matched on an identifier. That is Many sources, one shelf: the Photos shelf (Openverse, Unsplash, Pexels) as the rule for every multi-source content type — memes and quotes follow it; what eventasaurus taught #116's D2 as recorded, and it is a different page from the one Phase 1 ended with. - The credit is the tallest thing on an Openverse card. Its
attributionis the full CC sentence — "war" by zbigphotography (1M+ views) is licensed under CC BY-SA 2.0. To view a copy of this license, visit https://creativecommons.org/licenses/by-sa/2.0/. — and a required credit is unclamped by decision (Phase 3), so it runs seven lines under a 112 px thumbnail. Unsplash and Pexels compose one line; Commons composes one line. - One shelf, four sets of chrome. Each contributing source adds a matches for “war” · About these results disclosure and a Load more control, so the Images shelf carries four of each; at 375 the byline (Wikimedia Commons · depicts: Wikidata · Openverse · search: CC and public domain · Pexels · …) wraps to four lines above the rail.
- Counts drift across sources. Load more is per source: one click on Pexels made it 24 on a rail where the others hold 12, and the About note faithfully lists 24.
- Cards say Year unknown on every Pexels and most Unsplash and Openverse items, because a stock photograph publishes no date; on the
:imagerow that line is noise in the position a year would hold. - The square frame crops the searches' photographs. Phase 2 measured Openverse on soldier: 15 landscape, 5 portrait, 0 square. Phase 3 measured Unsplash and Pexels ladders with landscape, portrait and original rungs. The row stays square because a square crops a portrait less than 4:3 does — that argument still holds, and this issue does not reopen it without a measurement that beats it.
- Two audit residuals that belong to whoever touches these files next:
Artworks.source_tiers/1runs the samesourcesquery twice per page;/define/soldierrenders two elements withid="may-refer-to-Q4991371"(thing.ex:226). - Two facts from Phase 3's own report that have no other home. (a) Every
hrefon a card comes out of a provider response; since0c1027bthe renderer accepts only an absolute http(s) URL, and that rule is not yet indocs/discovery/adding-a-provider.md. (b) A tier change in a provider'ssource_attrs/0does not reach an existing source row —ensure_source/1insertson_conflict: :nothing— so Openverse stayed:middleuntilSources.Catalog.seed!/0was run by hand. There is no deployment issue in this repository; until there is, every PR that changes a source row's attributes says so in its body, and the guide's §6 says to run the seed.
Decisions (defaults; change them here, not in a chat)
- D1 — A search-only shelf is demoted, not hidden. On a page where no identity-bearing or attesting source contributed to a shelf, the shelf still shows (M6's honesty stands: the label is the point) but it renders after every shelf that has identity or attestation on it, and it takes one page in total, not one per source — twelve items across the searches in turn, with Load more to go on. On a page where an identity source did contribute (
war,soldier), nothing changes: identity leads on tier and the searches follow. The alternative — hide the shelf outright — is one clause inCulture.shelves/1and is recorded here as the fallback if the demoted shelf still reads as a results page. - D2 — A credit is one line the provider composes. M4's verbatim stands for the fields; it never meant a paragraph. Every provider on a
:requiredrow writesattributionas at most one sentence naming the creator and the licence, with no URL in the prose — the licence link D3 puts on the licence name is where "view a copy" lives. Openverse composes"{title}" by {creator}, {licence}from its own fields instead of forwarding the CC boilerplate; Commons, Unsplash and Pexels already comply. Conformance asserts the line carries nohttpand is under 160 characters. - D3 — One About and one Load more per shelf. The shelf's About these results is one disclosure listing every contributing source in tier-then-slug order, each with its reason sentences; Load more is one control that advances every contributing state one page, so counts stay even. DOM ids move from
culture-about-<provider>toculture-about-<type>with aculture-about-<type>-<provider>section inside, and from per-state Load more toculture-more-<type>; the conformance suite's assertions change to the new ids with the same meaning, and that change is listed in the PR as the one place an existing assertion is edited. - D4 — The byline is names. Wikimedia Commons · Openverse · Pexels · Unsplash; each provider's
shelf_detail(depicts: Wikidata, search: CC and public domain) moves into its About section. At 375 the byline is one or two lines. - D5 — A card shows a year only when it has one. The
year · badgeline becomesbadgealone whenyearis absent; Year unknown is never printed on a discovery card. The registry's own entity pages are untouched. - D6 — Aspect and column stay (
aspect-square,w-24 sm:w-28) unless a session measures, on the four real sources at 375, that another frame crops less. Anyone changing them puts the measurement in the PR. - D7 — No provider is named in the reader. Every rule above is data on the row or a fact on the state;
Culturekeeps branching on neither.
Phase 1 — the shelf's chrome (one session)
D1, D3, D4, D5, residual 7, and residual 8's two guide sentences. All in Culture, Artworks.source_tiers/1, thing.ex, docs/discovery/adding-a-provider.md, and the conformance assertions D3 moves. No provider file. Exit: /define/war and /define/nepotism at 1280 and 375 with one About and one Load more per shelf, the byline as names, no Year unknown on an image card, the search-only shelf on nepotism rendered last with twelve items; precommit green apart from the environmental manifest test; conformance green with the moved ids; the four counts on war even after one Load more.
Phase 2 — the card (one session)
Carried in from Phase 1's report (2026-09-19), all provider-side or out of Phase 1's file list:
- Openverse's page 1 returns the same ids as its page 0 — now its own issue, Openverse: the second page is the first page #128, with the measurement. Phase 2 opens
openverse.exfor D2 anyway, so the Phase 2 PR fixes Openverse: the second page is the first page #128 in the same file and closes it; if Phase 2 runs before Openverse: the second page is the first page #128 is read, read Openverse: the second page is the first page #128 first. - Two stale comments in
pexels.ex(lines 38 and 330) still say the card prints Year unknown; D5 made that false. Thing.disagreement/1has the same latent duplicate-id shapemay_refer_to/1had; not observed on a page, fix it the same way whilething.exis open, or record that it is left.- No test drives Load more through the LiveView; a provider fixture with two pages and one
discovery_moreassertion closes that. Culturecomputes each entry's reasons twice per shelf (demotion check and About); cheap, noted, fold it only if the shelf map is being touched anyway.
D2 on Openverse (its provider file), the conformance assertion on every :required row, and the credit's typography beneath a 112 px thumbnail: creator and licence linked, nothing else underlined, the line never taller than three rows at 375. D6's measurement if the session wants to argue with it. Exit: the Openverse credit on /define/war is one line; the fold check and the multi-source check still pass; a screenshot of one card from each of the four sources at 375.
Not doing
- No relevance ranking across sources (Discovery relation assessor: lite ML and LLM judging of provider results before persona curation #101), no curation (Exemplars: people, works and media as attributed examples of a meaning — nomination, the why, votes, ranking and the reverse view on a person's page #105), no perceptual dedup.
- No per-provider tabs or grid; no source filter beyond the header credit.
- No new content-type row, no change to any provider but Openverse's credit line.
- No masonry or justified rail: the rail is one row of equal frames until D6 is beaten.
Checklist
- Phase 1 — chrome: D1, D3, D4, D5, residual 7 (PR Phase 1 of #126: one chrome per shelf #127, audited A, merged 2026-09-19)
- Phase 2 — card: D2, credit typography, D6 decided (PR Phase 2 of #126: the card #129, audited A−, merged 2026-09-19)
Activity
holden commentedon Sep 19, 2026
Phase 1 — #127, open, not merged
Branch
codex/issue-126-phase1offmain@79fd344. 19 files. D1, D3, D4, D5, residual 7, residual 8's guide sentences. No provider file; schema impact 0.Conformance, pasted
mix precommit:The one failure is
test/devils_dictionary/sources/manifest_test.exs:26, the environmental one (the untrackeddata/dumps). Baseline onmainin this worktree was 1,380 tests, 1 failure, same test; the 14 new ones are this PR'sculture_chrome_test.exs. Formatting and compile are clean.Browser proof
Server on 4017,
devils_dictionary_v2, nothing else listening andpg_stat_activityshowing no other application on the database before or during.mix compileto completion first. Screenshots over CDP with an emulated layout viewport,document.documentElement.scrollWidth === 375at 375 on all three pages (and=== 1280at 1280).docs/discovery/issue-126-phase1-war-1280-2026-09-19.jpg/-375-/define/war, all four shelves, first visitdocs/discovery/issue-126-phase1-war-images-1280-2026-09-19.jpgdocs/discovery/issue-126-phase1-war-images-375-2026-09-19.jpgdocs/discovery/issue-126-phase1-nepotism-1280-2026-09-19.jpg/-375-docs/discovery/issue-126-phase1-nepotism-images-1280-2026-09-19.jpgdocs/discovery/issue-126-phase1-logomachy-1280-2026-09-19.jpg/-375-Measured in the DOM:
/define/war— shelves in orderartwork,image,text: the Images shelf has Commons's depictions on it, so nothing is demoted and the table's order stands, exactly as D1 says./define/nepotism— shelves in DOM orderfilm,text,imagelast. The Images shelf has nothing but searches on it, so it is demoted and capped:/define/logomachy— shelvesfilm(empty state),text,imagelast, eleven Pexels photographs, one About with one section, one Load more. Summary readsMatches for “logomachy” · About these results./define/soldier— duplicate DOM ids on the page: 0. It rendered twoid="may-refer-to-Q4991371"before.D5
No card on any of the four pages prints Year unknown. A card with a year prints
1966 · Image; a card without printsImage.The one exit criterion I did not meet as written
One click on
#culture-more-imageadvanced all four sources one page each, which is the mechanism D3 asks for, and it is one control where there were four. The counts on the rail afterwards are not level:Two reasons, neither of them the chrome:
discovery_runshas its page 0 (09:03) and page 1 (09:32) forwarfrom a Phase 3 session on 2026-09-19. The per-source Load more this PR removes is what made it uneven; a persisted page cannot be un-loaded, and the brief forbids deleting a run, sowarstarts uneven and stays uneven by exactly that one page.warreturns the same six ids as its page 0. Verified in the database: 6 results on page 0, 6 on page 1,count(distinct external_id)across both = 6. The shelf's read-time dedup folds them, so its count cannot move. That is a provider-pagination fact, and Openverse is a provider file this phase may not touch — worth a look in Phase 2 or its own issue.So what I can report is: one control, four sources advanced, each by one page, in one click — and the counts diverge only by what was in the cache before and by what Openverse returns. On a word with no pre-loaded page, the advance is level;
culture_chrome_test.exsasserts the cap moves from 12 to 24 when every source has loaded a page.Ledger
5 live requests, all from that one Load more.
discovery_request_attempts256 → 261:Opening
war,nepotism,logomachyandsoldierspent 0 — every page was answered from cache. No image bytes; no run deleted.Where the issue was wrong or insufficient
Residual 8(b)'s remedy is wrong, and the guide now says the true one. The issue says a tier change "did not reach an existing source row … so Openverse stayed
:middleuntilSources.Catalog.seed!/0was run by hand".Sources.Catalog.sources/0holds six MVP-0 sources —wordnet,wiktionary,wikidata,wikipedia,bierce,johnson— and no discovery provider, soseed!/0cannot have fixed an Openverse row and will not fix the next one.Discovery.ensure_source/1is the only writer of a provider's row, and it insertson_conflict: :nothing. The row has to be updated (or dropped so the next visit re-inserts it) by hand. The guide's §6 now says that, with thepsqlline to check the row, rather than pointing at a seed that does nothing here. The observation itself is right and still bites; only the fix named was wrong.Phase 1 cannot be done in the files the issue lists. The brief says "All in
Culture,Artworks.source_tiers/1,thing.ex,docs/discovery/adding-a-provider.md, and the conformance assertions D3 moves." D3's single Load more advances several states, and the handler that advances them isWordLive.handle_event("discovery_more", …), which took one provider slug. I changed it to takeprovidersand reduce; nothing else in the module moved. Listed in the PR body as a shared file touched.D3's "every contributing state" would strand a folded source. I read it as every state on the shelf that has another page. A source whose whole page folded into a better-tiered copy contributes nothing to the byline, so under the literal reading it would never advance and would be off the shelf permanently. The superset satisfies the decision's purpose (the counts move together) and costs nothing. Said out loud because it is a reading, not the words.
D4's byline assertions are not id moves, and I moved them rather than dropping them. Five assertions named
#culture-provider-<slug>and its text ("The Met · tags: Wikidata"). D4 takes the detail out of the byline, so each became two assertions — the name in the byline, the name and detail in that source's About section. The PR body lists them; no assertion lost coverage.The issue's per-provider About id is not the whole set. It names
culture-about-<provider>; the catalog is a state too, so#culture-about-catalogmoved to#culture-about-artwork-catalogin three test files the issue does not mention (word_artwork_catalog_test.exs,artwork_live_test.exs,culture_discovery_live_test.exs). Same move, same meaning.The measured state (item 1) no longer matches the database. The issue records
nepotismat 36 andlogomachyat 11 with every image source:middle. Indevils_dictionary_v2today Openverse, Pexels and Unsplash are:plebsand Commons is:middle, which is what makes the byline read Wikimedia Commons first. Nothing to fix — the tier order and the slug order happen to agree — but the issue's "every source is:middle" is stale and the ordering assertions inculture_chrome_test.exsnow cover the case where they disagree.Left out, named as left out
/define/waris still the seven-line CC boilerplate; you can see it inissue-126-phase1-war-images-1280-2026-09-19.jpg, which is what Phase 2 is for.lib/devils_dictionary/discovery/providers/pexels.ex(lines 38 and 330) still say "the card says Year unknown and that is the truth". D5 made that false. It is a provider file, which this phase may not touch, so they are left for Phase 2.Thing.disagreement/1has the same latent duplicate-id shape asmay_refer_to/1— its@conceptsare assertion revisions on several senses and two senses referring to one entity would render twoid="disagreement-<qid>". Not observed on any page I opened, and the brief scopesthing.exto "the duplicate id only", so I left it and am naming it here.discovery_morehad no test at all); the new component test asserts the control's markup and the cap's arithmetic, and the browser proof above is the end-to-end evidence. A LiveView test for it would want a provider fixture with two pages and is worth its own change.Culturecomputes each entry's reasons twice on a shelf — once to decide whether the shelf is demoted, once in the About. Cheap (it is a map read plus a struct build) and not worth threading a cache through the shelf map for; noted so the next session does not think it went unseen.holden commentedon Sep 19, 2026
Addendum — a design pass over the two controls this phase rebuilt
Ran the chrome through the ui.sh design guidelines after the fact. Three findings, all in the controls D3 and D4 redesigned, none in the card:
#culture-more-<type>carriedhover:text-mist-950with no dark counterpart —mist-950isoklch(14.8%)and the dark page background ismist-950, so hovering the shelf's one Load more in dark mode made it disappear. Nowdark:hover:text-white, which is the idiomcredit_parts/2's links two components down already use. The About summary had the same shape (hover:text-mist-700overdark:text-mist-400); nowdark:hover:text-mist-200. Both pre-existed this PR — they were just four small controls before and are one prominent one now.text-smat every width while the summary on the same row istext-base sm:text-sm. Levelled totext-base sm:text-sm.max(100%, 3rem),pointer-fine:hidden— measured 80×48 at 375, invisible to a mouse.Both controls also gained the
focus-visible:outline-2 focus-visible:outline-offset-2every other interactive element inCulturealready had.Verified at 375 with every disclosure forced open: the About sits inside the gutter (x 24 → 351 of 375), no descendant crosses the viewport edge,
scrollWidthstill 375, and all three new utilities are in the built stylesheet. Screenshot:docs/discovery/issue-126-phase1-nepotism-about-open-375-2026-09-19.jpg.mix precommitafter: 1,394 tests, 1 failure (the environmental manifest test). Conformance: 244 tests, 0 failures. Ledger unchanged at 261 — no further live requests. Aspect and column untouched (D6).Pushed to #127 as a second commit (
046a991).holden commentedon Sep 19, 2026
The Openverse pagination finding is now #128, not a Phase 2 item here. It is a provider correctness and ledger bug rather than an appearance one, this issue's Not doing fences provider changes to Openverse's credit line, and it needs its own probe with a ceiling — a different kind of work from D2's typography. Phase 2 opens
openverse.exanyway, so a session may reasonably do both; neither is gated on the other.holden commentedon Sep 19, 2026
Phase 1 audit (2026-09-19) — PR #127 @
046a991, doc fix inbad464e— grade AIndependent re-check on a fresh detached worktree:
mix precommit1,394 tests, 1 failure, the environmental manifest test only, matching the report. The diff read in full; the screenshots read against the DOM measurements in the report. No browser run of my own this time: the owner's dev server is up on port 4007 from the main checkout againstdevils_dictionary_v2, and a second server on that database is the thing the guide forbids, so the report's DOM readings and the fourteen new component tests stand as the proof.What holds
WordLiveis the one shared file outside the list, and it is the minimum: the event takes a list where it took one slug.may-refer-toid is gone by de-duplicating on object id, with the QID-less fallback so two unidentified things cannot collide either.Sources.Catalog.seed!/0seeds the six MVP-0 sources and no provider, so it cannot have moved Openverse's tier. The guide now says the true thing — update the row by hand and say so in the PR — and CodeRabbit's one finding, thepsqlline naming a fixed database while the procedure allowsDD_DATABASE, is fixed inbad464e.The one exit criterion not met, and why that is fine
"The four counts on war even after one Load more" could not be met on that word: Pexels was already a page deep from a Phase 3 session and a persisted page cannot be un-loaded, and Openverse's page 1 returns the same six ids as page 0, so its count cannot move. The first is history; the second is a provider bug and is now the first item of Phase 2. The mechanism the criterion was written to check — one control, every source advanced one page — is asserted in the component test and shown in the ledger (five requests, one per source plus Commons's hydration).
Verdict
Mergeable at
bad464e. Phase 1 of #126 is done as written, with one reading (D3's "every contributing state" as "every state with another page") said out loud and correct. Phase 2 is the card: D2's one-line credit on Openverse, the credit typography, D6 if measured, plus the five residuals carried into its section above.Merge pull request #127 from razrfly/codex/issue-126-phase1
holden commentedon Sep 19, 2026
Phase 2 — #129, open, not merged
Branch
codex/issue-126-phase2offmain@2a760f3. 15 files. D2, the credit's typography, the Openverse pagination bug, and the four other residuals Phase 1 carried in. Schema impact 0; no source row's attributes changed, so §6's by-hand update does not apply to this PR.Conformance, pasted
That is with D2's new assertion running on every
:required-row provider — Commons, Openverse, Pexels, Unsplash, and the two multi-source stubs — plus the Commons–Openverse fold check, whose credit assertions tightened rather than loosened.mix precommit:The one failure is
test/devils_dictionary/sources/manifest_test.exs:26, the environmental one. Baseline was 1,394 / 1, same test; the nine new tests are seven inopenverse_test.exsand two in the newculture_more_live_test.exs.D2, measured
Openverse forwarded its own CC boilerplate — 155 characters, two sentences, an unbreakable URL. Rendered through the card component on
/define/war, that one credit is fourteen rows at 375 and eleven at 1280. The issue recorded seven; the number on the card the issue names is worse than that.It now composes
"{title}" by {creator}, {licence}. Same card:"war" by zbigphotography (1M+ views), CC-BY-SA-2.0, 50 characters, four rows at 375, three at 1280.docs/discovery/issue-126-phase2-four-sources-before-375-2026-09-19.jpgand…-four-sources-375-2026-09-19.jpgare the same four cards before and after, at 375.The credit's typography, and the exit criterion I did not meet
text-sm→text-xs: the card's own scale, putting the obligation below the title, the year and the artist. Measured on the 131 real image credits indevils_dictionary_v2forwarandsoldier:text-smtext-xstext-smtext-xsCreator and licence linked, nothing else underlined — asserted, not eyeballed: exactly two anchors in the credit and exactly two elements carrying an
underlineclass."Every credit at most three rows at 375" is not met, and it is not reachable from the three files this phase may touch. At
text-xsin a 96 px column a credit has to be about 46 characters to fit three rows.{author}, {licence}, via Wikimedia Commonsspends 23 of them on its tail before it names anybody; the longest real Commons credit here is 89 characters and eight rows. Per source at 375: Commons 32/34 over three, Openverse 12/18, Unsplash 10/33, Pexels 5/46.The two ways to reach it are both fenced: clamp a required credit (forbidden — that is what hid the word Unsplash and the link on it), or widen the column (D6). Your call; the numbers are above and in the component's comment.
On the page of twelve
waractually shows, 8 of 12 credits are at most three rows at 375 and 9 of 12 at 1280, against 5 of 12 before.Openverse's second page — found, and it is not the arithmetic
div(offset, limit) + 1is correct and the run really did ask for page 2. The cause isfilter_dead: Openverse validates upstream links against a cached dead-link mask per query and, when that cache is cold, serves the requested page from the start of the ranking.filter_dead=true,page_size=12, page 2cf-cache-status: HIT,age: 7603— the entry written at 12:19, the moment Phase 1 clicked Load morematureomitted)MISS, and still answered from index 0filter_dead=false, pages 1 / 2 / 3MISSes, contiguousfilter_dead=true,page_size6 / 10 / 20Fix: the first page keeps the filter, the pages after it do not. The cost, said out loud: an item on page 2+ has not been link-checked, so its thumbnail may be dead; and the two rankings differ by what the filter removed, so the unfiltered page 2 can repeat one item from the filtered page 1 — exactly one, measured — which
Shelf.dedup/2folds at read time.The fixture now models the API's behaviour, so a provider that asks for the filter on a later page fails the shared pagination suite rather than a bespoke test. Verified by regressing it deliberately:
This is #128. Your 13:29 comment moved it out of Phase 2; my brief asked for it and Phase 2 opens
openverse.exanyway, so it is in this PR. Close #128 against it or keep #128 for the ledger half — nothing here touches the request-accounting side of it.Screenshots
Saved as the guide names them, in
docs/discovery/:issue-126-phase2-four-sources-375-2026-09-19.jpgissue-126-phase2-four-sources-before-375-2026-09-19.jpgmainrenders themissue-126-phase2-war-images-shelf-375-2026-09-19.jpg/-1280-issue-126-phase2-war-images-shelf-wrap-375-2026-09-19.jpg/-1280-overflowoverridden, so every credit is in one frameWhere the issue was wrong or insufficient
"The credit is the tallest thing on an Openverse card … seven lines" understates it. Measured through the component, that credit is fourteen rows at 375 and eleven at 1280. The direction was right; the number was optimistic.
D2's "under 160 characters" is a conformance ceiling, not a design budget. 160 characters is a paragraph in a 96 px column — about ten rows. The assertion is in as written, because it catches the boilerplate class of failure, but Openverse's own envelope is 72, and the number that matters for the card is 46. Worth recording in D2 itself so the next provider does not aim at 160.
"The credit's typography … never taller than three rows at 375" is not achievable as written, for the reason above. It is not a typography problem: no readable size fits a 73-character Commons credit into three rows of 96 px. The decision it actually forces is D6 (column) or an exception to the no-clamp rule, and the issue does not connect those.
"Beneath a 112 px thumbnail" is true at 1280 and not at 375.
columnisw-24 sm:w-28, so the card is 96 px at 375 and 112 px fromsmup. Every 375 measurement above is at 96. The code wins.Residual "Openverse's page 1 returns the same ids … the
pagearithmetic againstfirst, or Openverse's own ranking" — neither. It is a request parameter we control, and the evidence was reachable without touching the pipeline. Also, the 13:29 comment reclassifies it as out of Phase 2 while the Phase 2 list still carries it as its first item; the checklist and the comment disagree.D6 cannot be measured from what this pipeline stores, which the issue's "unless a session measures … that another frame crops less" assumes it can. No intrinsic image dimensions are persisted by any of the four providers, and the stored thumbnails cannot stand in: every Pexels and Unsplash thumbnail loads at exactly 3:2, which is the provider's rung, not the photograph's shape. Whoever takes D6 needs to persist the width and height the APIs already report, or fetch the originals.
Sources.Catalog.seed!/0is still named in the issue body (item 8b) as what fixed Openverse's tier. Phase 1's report and the guide already corrected this; the issue body did not get the edit.Every file touched, and why
lib/devils_dictionary/discovery/providers/openverse.exfilter_deadon the first page only; the two measurements in the moduledoclib/devils_dictionary/discovery/providers/pexels.exlib/devils_dictionary_web/components/culture.extext-sm→text-xs, and the measurement that chose itlib/devils_dictionary_web/components/thing.exdisagreement/1's latent duplicate DOM idtest/support/discovery/conformance.exhttp, under 160, on every:requiredrowtest/support/discovery/conformance/openverse_fixture.exfilter_deadthe way the API doestest/devils_dictionary/discovery/conformance/openverse_commons_fold_test.exstext-xs)test/devils_dictionary/discovery/providers/openverse_test.exsrequest_options/1'sfilter_deadtest/devils_dictionary_web/live/culture_more_live_test.exs#culture-more-textputs the second page on the rail; the control disappears when the source is out of pagesdocs/discovery/*.jpgword_live.exwas not touched — the new LiveView test drives the existing handler as it is.Ledger
25 live requests, every one an Openverse pagination probe, against the session's ceiling of 40:
page_size=12, pages 1–5,filter_dead=truepage_size6 / 10 / 20 walksfilter_dead=false, pages 1–3None went through the pipeline, so
discovery_request_attemptsis unchanged at 261. No image bytes persisted, no run deleted, nothing written todevils_dictionary_v2.Left out, named as left out
devils_dictionary_v2; a second node on that database is the thing the guide forbids, so I did not start one. Everything measured above was rendered throughCulture.section/1— the real component, the built stylesheet, the real Inter — over realpreview_metadataread out ofdevils_dictionary_v2, in headless Chrome with the layout viewport emulated over CDP. What that cannot show is Load more onwarmoving Openverse's count against the live API, which is the one exit criterion of this phase that needs a running page. The LiveView test covers the mechanism and the fixture covers the provider; the live confirmation is still owed, and it is one click once your server is free.mix run --no-startrenderer, a page wrapper, a CDP driver, a measure script). If the row-count measurement is something the project wants to keep honest over time, it wants to be a task or a test rather than a scratchpad, and that is its own change.Culture's double reasons computation. The shelf map was not opened, so it stays as noted.attributionis a live risk D2 does not close. It isextmetadata.Attributionwhen the file has one — arbitrary uploader text, which may be a paragraph and may contain a URL. The fixture's files have none, so conformance is green; a real file that has one would sail past D2's rule at runtime.commons.exwas outside this phase's file list, so it is named here rather than fixed.holden commentedon Sep 19, 2026
Phase 2 audit (2026-09-19) — PR #129 @
5c528b5, fix in5737240— grade A−Independent re-check on a fresh detached worktree:
mix precommit1,403 tests, 1 failure on the PR as pushed and 1,407 / 1 with the fix, the environmental manifest test only. The diff read in full, the four-source screenshots read, and the pagination claim checked against the live API with four requests of my own.Verified
"{title}" by {creator}, {licence}httpand under 160 on every:requiredrowfilter_dead, not the page arithmeticdisagreementidCodeRabbit, applied in
5737240The one finding was a Major and real: dropping the title only when the line exceeded 72 left the creator unbounded and either field free to carry a URL, so D2's contract was asserted on fixtures rather than enforced. Both fields are now stripped of URLs and clamped — title 32, creator 60 — and the clamped creator is written to the
creatorfield as well, so the card's link still finds the printed name. The line is under 120 by construction. One assertion changed on purpose: "the creator is never cut" became "the creator is bounded".Why A− and not A
git checkoutreverted the provider file mid-session. The session said so and the tests confirm the edits are back; it still cost a re-derivation and is the kind of slip a worktree exists to prevent.The decision the report hands back
"Every credit at most three rows at 375" is not reachable: at the card's 96 px width a credit has to be about 46 characters, Commons's tail alone is 23, and its longest real credit is 89. The two levers are both fenced — clamping a required credit, or widening the column (D6) — and D6 cannot be measured from what the pipeline stores, because no provider persists image dimensions. My recommendation: accept that a Commons credit may run four or five rows, record it as the answer to D6 for now, and revisit width only if a design session wants it for the photographs themselves rather than for the credit. Commons's own
attributionfield is the residual risk D2 does not close: an uploader's free text, unbounded, on a provider file this phase could not touch.Verdict
Ready to merge at
5737240. It closes #128 (the pagination fix is in this PR; the ledger half of #128 is a sentence, not a change). After merge, #126's Phase 2 box ticks and the issue closes on the D6 decision above, unless you want the column widened.Merge pull request #129 from razrfly/codex/issue-126-phase2
holden commentedon Sep 19, 2026
Closing (2026-09-19)
Both phases merged: #127 (chrome) and #129 (card);
main@ the #129 merge. Decisions as they ended:Residuals, none owned here: Commons's own
attributionfield is uploader free text and is not bounded (a provider-file change if it ever bites);Culturecomputes reasons twice per shelf; the row-count measurement harness lives in a scratchpad and is not checked in.#128 closed by #129.