Skip to content

[Client P1] Cards show raw project codes/filenames instead of a merchandised title + summary #46

Description

@jaysanderson

Feedback (client + a side-by-side review agent - flagged as THE dominant issue)

Cards in the Fly portal show raw project codes/filenames ("Project 2014-001", "2013-052 DLD", "2014-001-DLD.pdf") instead of a human title + a two-sentence summary of what the document says. "To a non-technical FRDC stakeholder, the Bolt site looks like it understood the documents; the Fly site looks like a folder listing." This does more damage than everything else combined, and violates our own merchandising rule (CLAUDE.md: never raw filenames).

Root cause (two contributing factors)

  1. Enrichment not yet run on FRDC. The DA merchandiser (title/summary/key-takeaways) has run on GRDC (all 1,070 resources render real titles) but NOT yet on FRDC - FRDC is mid-load; enrichment is queued to run after the load completes. So current FRDC codes are a sequencing state, not a pure rendering bug. GRDC cards already render correctly.
  2. Possible un-rendered platform summary (INVESTIGATE - potentially a faster fix). The review agent notes the summaries "almost certainly exist in the KB; the portal just isn't rendering them." The platform likely generates its own per-resource summary on ingest (da-pagesummary / metadata.summary) that we do not read back - see docs/BACKLOG.md ARAG-roadmap item 3 (toSummary reads metadata.summary, not da-pagesummary-f-*).

Action

  • Finish FRDC enrichment (tracked in [Client P1] Ingest the complete corpus for FRDC and GRDC (not a subset) #40 / the post-load plan) so cards get our merchandised fields.
  • Add a fallback so a card is NEVER bare: when our enrichment is absent, render the platform's generated summary/title where present, only falling back to the code as a last resort. Cards then look "understood" immediately on ingest, without waiting for the enrichment pass.

Where

packages/retrieval/src/providers/arag (toSummary / resource mapping); card components in apps/web/src.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions