tegwick
97437dfa18
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).
53 lines
No EOL
1.4 KiB
Markdown
53 lines
No EOL
1.4 KiB
Markdown
---
|
|
id: ESRC-WP-0003
|
|
type: workplan
|
|
title: "Document metadata enrichment beyond pass-through options"
|
|
domain: infotech
|
|
repo: evidence-source
|
|
status: finished
|
|
owner: codex
|
|
topic_slug: citation_evidence_mvp
|
|
created: "2026-07-08"
|
|
updated: "2026-07-09"
|
|
spec_refs:
|
|
- README.md
|
|
- src/pdf/ingest.ts
|
|
- src/pdf/metadata.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: 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).
|
|
|
|
```task
|
|
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.
|
|
|
|
```task
|
|
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. |