coulomb/evidence-source
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
evidence-source/workplans/ESRC-WP-0002-html-markdown-representations.md
tegwick df6acad828
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 3s
Details
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

1.7 KiB
Raw Blame History

id type title domain repo status owner topic_slug created updated spec_refs state_hub_workstream_id
ESRC-WP-0002 workplan HTML and Markdown source representations infotech evidence-source proposed codex citation_evidence_mvp 2026-07-08 2026-07-08
README.md
docs/ADR-0001-extraction-boundary.md
../citation-engine/src/shared/document.ts
c0d28886-e02f-4df2-abb6-ebe179171c94

ESRC-WP-0002 — HTML and Markdown source representations

The PDF slice (ESRC-WP-0001) established the ingest boundary and contract shape. This workplan extends ingest to HTML and Markdown sources, producing the same { document, representation } pair over engine-owned contracts.

Open questions

  • Which representationType values do HTML/MD map to, and do they need new DocumentRepresentation fields in citation-engine?
  • How is canonical text + offset map derived for reflowable formats that have no fixed pages? (Page map may be empty or synthetic.)

Sketch

id: ESRC-WP-0002-T01
status: todo
priority: medium
state_hub_task_id: "bf1d2a2f-41b4-44b5-b1d1-4f0eec5fbf59"

Define the HTML/MD representation contract with citation-engine; agree representationType and any offset/page semantics for pageless formats.

id: ESRC-WP-0002-T02
status: todo
priority: medium
state_hub_task_id: "66320911-a4b2-404f-b025-8b23dc0c9680"

Implement ingestHtml / ingestMarkdown in src/html/ and src/markdown/, reusing fingerprintBytes and the canonical-text normalizer.

id: ESRC-WP-0002-T03
status: todo
priority: medium
state_hub_task_id: "266d168c-d93e-4387-9527-70aa0d5b2a6b"

Add fixture-driven contract tests mirroring the PDF suite; decide fixture ownership per ADR-0002.