evidence-source/workplans/ESRC-WP-0003-metadata-enrichment.md
tegwick 97437dfa18
Some checks failed
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Failing after 15m18s
Implement ESRC-WP-0002/0003/0004: HTML/MD ingest, metadata, recovery
Add ingestHtml and ingestMarkdown with ADR-0003 pageless offset semantics,
PDF intrinsic metadata extraction with caller-wins merge (WP-0003), and
citation recovery primitives including re-ingest reconcile, local quote
search, and pluggable discovery hooks (ADR-0004). Mark all three workplans
finished with contract tests (80 passing).
2026-07-09 01:48:28 +02:00

1.4 KiB

id type title domain repo status owner topic_slug created updated spec_refs state_hub_workstream_id
ESRC-WP-0003 workplan Document metadata enrichment beyond pass-through options infotech evidence-source finished codex citation_evidence_mvp 2026-07-08 2026-07-09
README.md
src/pdf/ingest.ts
src/pdf/metadata.ts
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

id: ESRC-WP-0003-T01
status: done
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).

id: ESRC-WP-0003-T02
status: done
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.

id: ESRC-WP-0003-T03
status: done
priority: low
state_hub_task_id: "0004881b-6577-4a62-a2ff-cbb5c4706b1b"

Contract tests over the fixture corpus asserting extracted vs. overridden metadata precedence.