evidence-source/workplans/ESRC-WP-0003-metadata-enrichment.md
tegwick df6acad828
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 3s
chore(consistency): write back state-hub workplan/task IDs [auto]
fix-consistency C-06/C-11 registered ESRC-WP-0002..0004 and the
ESRC-WP-0001 tasks; IDs written back into the workplan files.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 20:56:39 +02:00

52 lines
1.4 KiB
Markdown

---
id: ESRC-WP-0003
type: workplan
title: "Document metadata enrichment beyond pass-through options"
domain: infotech
repo: evidence-source
status: proposed
owner: codex
topic_slug: citation_evidence_mvp
created: "2026-07-08"
updated: "2026-07-08"
spec_refs:
- README.md
- src/pdf/ingest.ts
state_hub_workstream_id: "831267a1-fc93-4872-a25b-73793d9c5df4"
---
# ESRC-WP-0003 — Metadata enrichment
Today `ingestPdf` only passes through caller-supplied `title`/`uri`/`metadata`.
This workplan extracts intrinsic document metadata (PDF info dictionary,
embedded XMP, page-derived signals like author/creation date/title) and folds
it into the `Document` record without breaking the pure-over-bytes contract.
## Sketch
```task
id: ESRC-WP-0003-T01
status: todo
priority: low
state_hub_task_id: "45eeef15-41a9-4abd-9436-ed77e2c6b3a4"
```
Enumerate available PDF metadata sources (info dict, XMP) via PDF.js and decide
precedence vs. caller-supplied options (caller wins).
```task
id: ESRC-WP-0003-T02
status: todo
priority: low
state_hub_task_id: "41ca090f-c709-420a-b7c5-8332e4e82bd1"
```
Implement extraction into a normalized metadata shape; keep it optional so
minimal-metadata PDFs still ingest cleanly.
```task
id: ESRC-WP-0003-T03
status: todo
priority: low
state_hub_task_id: "0004881b-6577-4a62-a2ff-cbb5c4706b1b"
```
Contract tests over the fixture corpus asserting extracted vs. overridden
metadata precedence.