Skip to content

catalogs: freeze e-file table metadata per release - #109

Merged
Thiyaghessan merged 2 commits into
mainfrom
feat/efile-frozen-table-meta
Oct 23, 2026
Merged

Thiyaghessan merged 2 commits into
mainfrom
feat/efile-frozen-table-meta

Conversation

@Thiyaghessan

Copy link
Copy Markdown
Collaborator

Catalog pages for the e-file releases read form, part, title, cardinality and sort order from a per-release frozen file (catalogs/efile/TABLE-META-<id>.csv) instead of the concordance990 version installed at render time. Each release's file is generated by catalogs/efile/make-efile-table-meta.R from the concordance990 git ref the release was labelled with, recorded in EFILE_RELEASES$concordance_ref. Archive pages therefore keep their own labels after concordance990 moves on.

Notes for review:

  • The frozen v1 concordance (tag v2.0.0-baseline) has no form, part or table titles. Releases labelled with v1 (v2_2) take table membership, cardinality and order from the baseline and fill titles from concordance990 2.0.0. Without that the v2_2 page lost every part heading.
  • The five pages were re-rendered with quarto 1.9.38; the previous render used 1.10.18, which is not on this machine, so the HTML diff includes quarto boilerplate changes. Table and section counts per page are unchanged (111, 131, 138, 81, 87 listings).
  • efile_release_meta() stops with the missing table names when a count file gains a table that the frozen file lacks; rerun the script for that release.
  • Tests: Rscript catalogs/tests/test-efile-helpers.R, 10 passing.

Part of the efile_v3_1 review (nccs-contracts #108, release note in nccs-contracts). ADR 0022 breadcrumb: catalog surface change, no contract shape change.

🤖 Generated with Claude Code

Catalog pages read form, part, title, cardinality and sort order from
efile/TABLE-META-<id>.csv, frozen from the concordance990 ref each
release was labelled with (EFILE_RELEASES$concordance_ref), instead of
whatever concordance990 is installed at render time. Archive pages keep
their own labels. v1-labelled releases take titles from concordance990
2.0.0, since the frozen v1 concordance has none.

Adds efile/make-efile-table-meta.R, efile_release_meta(), tests, and
re-renders the five pages that used efile_concordance().

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
read.csv turned an entirely blank title column into NA, and the page
then printed a title paragraph reading NA for every table (111 on the
v2_2 page, 81 on pf_v2_3, 80 on pf_v3_1). Read the text columns as
character, blank any NA, add a regression test, re-render the three
pages. Review finding from Codex on PR #109.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@Thiyaghessan
Thiyaghessan merged commit 8e1dadb into main Oct 23, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant