Files

tegwick 2a7b05c190 Implement CE-WP-0002 T01-T02: engine types + PDF viewer adapter spike

T01: shared engine types (Document, Selector union, Annotation, EvidenceItem,
branded IDs with newId factory) per wiki/SharedContracts.md §1-§3.

T02: react-pdf-highlighter-plus v1.1.4 spike behind the §5
DocumentViewerAdapter contract in src/anchor/. Pure round-trip math
extracted to pdf-selector-math.ts with 11 unit tests proving lossless
capture → selectors → JSON → restored-rects. ADR-0004 accepted; full
user-flow Playwright verification deferred to T09.

Adds Vite app shell (index.html, src/app/SpikeApp.tsx) so the spike is
exercisable via pnpm dev. tsconfig --noEmit prevents tsc -b from
littering src/ with stray .js outputs.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-25 02:21:31 +02:00

CE-WP-0001-foundations.md

Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures

2026-05-25 00:13:03 +02:00

CE-WP-0002-pdf-review-slice.md

Implement CE-WP-0002 T01-T02: engine types + PDF viewer adapter spike

2026-05-25 02:21:31 +02:00

CE-WP-0003-form-binding-visual-guide.md

Wire workplans to state-hub: topic, 4 workstreams, 29 tasks (UUIDs in frontmatter + task blocks)

2026-05-24 17:07:58 +02:00

CE-WP-0004-citation-card-export.md

Wire workplans to state-hub: topic, 4 workstreams, 29 tasks (UUIDs in frontmatter + task blocks)

2026-05-24 17:07:58 +02:00

README.md

Establish shared-contracts home, dependency map, MVP workplans, and umbrella-first strategy

2026-05-24 16:42:25 +02:00

README.md

MVP Workplans

These four workplans implement the first reference scenario from wiki/ProductRequirementsDocument.md §20 — end-to-end PDF evidence capture → form binding → citation card export — entirely inside the citation-evidence repository.

Workplan	Title	Status
`CE-WP-0001`	Foundations — scaffold, folders, lint rules, normalize, fixtures	todo
`CE-WP-0002`	PDF review slice — engine types, anchor, source, viewer, sidebar	todo
`CE-WP-0003`	Form binding + visual guide — EvidenceLink, rect registry, overlay	todo
`CE-WP-0004`	Citation card export — Markdown + HTML renderers, sidebar export	todo

Order

Strictly sequential. CE-WP-0002 depends on the folder/lint scaffolding from CE-WP-0001. CE-WP-0003 and CE-WP-0004 depend on the engine types, viewer adapter, and sidebar from CE-WP-0002.

How to run a workplan

/ralph-workplan workplans/CE-WP-0001-foundations.md

Ralph drives the loop and retires automatically when all tasks in the workplan are marked done. See ~/.claude/plugins/ralph-workplan/ralph-workplan.md.

Acceptance for MVP

The first reference scenario from PRD §20 runs end-to-end:

Create a collection
Upload a PDF
Select a passage, add commentary, create an evidence item
Open a side-by-side form
Link the evidence item to a form field
Focus the field → field, evidence card, and PDF passage all highlighted
SVG guide visible between field → card → highlight
Export evidence as a Markdown citation card