Resource Display Overhaul — 4-Phase Plan

[OAGr]

Problem

Resource tables across the site (legislation press tabs, org coverage, etc.) are underutilizing data we already have. Key issues:

• Garbled titles — many are URL slugs, not real page titles
• No publication/publisher — Publication column is all dashes
• No dates — Published column is all dashes
• No authors linked to person entities
• "web" type tells nothing — no domain name shown
• No summary/excerpt — impossible to evaluate without clicking
• No stance/sentiment for legislation coverage
• No grouping (official docs vs analysis vs press)

Example: https://www.longtermwiki.com/legislation/california-sb1047?tab=press

Plan: 4 Phases, 13 PRs

Phase 1: Quick Wins (show data we already have)

PR	Size	What
1A	M	Unify OrgResourceRow / ResourceRow into shared ResourceDisplayRow type
1B	S	Pass fetchStatus, archiveUrl, authorEntityIds through build pipeline into database.json
1C	M	Show domain name (from URL), summary subtitle, dead-link/paywall indicators, archive fallback

Phase 2: Data Enrichment

PR	Size	What
2A	M	Link authors to person entities via authorEntityIds (data exists in PG, just not exposed)
2B	M	Auto-map unmapped domains to publications using publications.yaml domain lists
2C	L	Batch-refresh garbled titles via source-fetcher (CLI command)
2D	S	Use extractDateFromUrl() on legislation press tab (already works on org pages)

Phase 3: Legislation-Specific

PR	Size	What
3A	M	Split resources into Official Documents / Analysis / Press Coverage sections
3B	L	Add stance field (support/oppose/neutral) with LLM classification pipeline
3C	L	Timeline view overlaying resources on legislative events

Phase 4: Card Redesign

PR	Size	What
4A	L	New ResourceCard + ResourceList components replacing inline tables
4B	M	Hover preview showing summary/key_points/abstract
4C	M	Better type taxonomy (news_article, legal_analysis, etc. replacing "web")

Dependency Graph

Phase 1A (shared types) ──> Phase 1B (build pipeline) ──> Phase 1C (display)
                       \                                       |
                        \──> Phase 2D (date extraction)       |
                                                               v
Phase 2B (domain mapping) ─────────────────────────> Phase 3A (legislation categories)
Phase 2A (author entity linking)
Phase 2C (title refresh) ──────────────────────────> Phase 4A (card redesign)
Phase 3B (stance field)                                Phase 4B (hover preview)
Phase 3C (timeline)                                    Phase 4C (type taxonomy)

Key Data Gaps

Data	In PG?	In database.json?	Displayed?
authorEntityIds	✓	✗	✗
fetchStatus	✓	✗	✗
archiveUrl	✓	✗	✗
summary/abstract	✓	✓	Only on detail page
Domain name	Derivable from URL	N/A	✗
Publication (via domain)	79 publications with domain maps	Partially linked	Sparse

[OAGr]

Status (April 2026): Partially done.

Done:

• PG resources table has title, authors, authorEntityIds, publishedDate, abstract, keyPoints, summary columns
• Resource enrichment pipeline exists (crux/resource-enrichment/)
• ResourceCard and ResourceList components exist
• CrossRef integration for academic metadata

Not done:

• Resource tables on entity pages still show limited metadata (many dashes for dates/authors)
• No bulk enrichment sweep has been run recently (metadata coverage was 9% as of discussion creation)
• Display doesn't surface all enriched fields (abstract, keyPoints)
• No stance/sentiment display on legislation pages

[OAGr]

Remaining work decomposed into issues

Reviewed the current codebase against the 4-phase plan. Most of the infrastructure and display work (Phases 1, 3A, 4A-C) is already done. The main gap is data coverage — the enrichment pipeline works but hasn't been run at scale.

Completed phases

• Phase 1 (A/B/C): Shared OrgResourceRow type, build pipeline passes fetchStatus/archiveUrl/authorEntityIds, display shows domain/summary/dead-link/archive indicators
• Phase 2A: Author entity linking via resolveResourceAuthors()
• Phase 2D: extractDateFromUrl() used on legislation pages
• Phase 3A: Legislation resources categorized into Official Documents / Analysis / Press Coverage
• Phase 4A: ResourceCard + ResourceList components with card/table view toggle
• Phase 4B: ResourcePreview hover tooltip (summary only)
• Phase 4C: Extended type taxonomy in resource-constants.ts

New issues for remaining work

Issue	Phase	Description
#3666	2B/2C	Run bulk resource enrichment sweep — academic enrichment (CrossRef), LLM deep enrichment (Batch API), title refresh, fetch status. Coverage target: >50% authors/dates, >70% summaries.
#3670	4B	Surface abstract and key points in cards/previews — ResourcePreview and ResourceCard only show summary; abstract, key_points, and review fields exist but aren't surfaced in list views.
#3672	2B	Auto-map unmapped domains to publications — getPublicationByDomain() works at display time but publication_id isn't set on most resources; create CLI command to batch-map and identify missing publication entries.

Related existing issues

• Publication dates missing across all major venues #3369: Publication dates missing across all major venues (would be fixed by Run bulk resource enrichment sweep to fill metadata gaps #3666)
• P2: Publications missing authors, legislation missing provisions/stakeholders #3494: Publications missing authors (would be fixed by Run bulk resource enrichment sweep to fill metadata gaps #3666)
• Resource pipeline dashboard: fetch outcomes, cache fill rate, stuck resources #3537: Resource pipeline dashboard (monitoring for enrichment runs)

[OAGr]

Branch: claude/skill-fixes-discussion-cleanup

Status check (2026-04-08): Frontmatter still reads phases_done: 3, phases_total: 4, last_agent_session 2026-04-03. Phase 4 is the Card Redesign (ResourceCard/ResourceList components, hover preview, refined type taxonomy). However, the 2026-04-03 comment above notes that Phases 4A-C display work is "already done" — so it's unclear whether Phase 4 is genuinely outstanding or just needs a frontmatter bump to 4/4. Decision needed by 2026-04-22: (a) reconcile frontmatter to 4/4 and close as complete, (b) pick up any truly remaining Phase 4 scraps and ship, or (c) close with "Phases 1-3 are sufficient, Phase 4 dropped." Otherwise this becomes ambient noise. — Discussion review 2026-04-08.