citation-engine

Core domain model and engine services for the citation-evidence ecosystem.

This package provides the shared vocabulary (Document, Selector, Annotation, EvidenceItem, EvidenceLink, EvidenceSet, state enums, branded IDs, canonical text normalization) together with in-memory repositories, orchestration services, the event bus, and citation card renderers.

Layout

src/
  shared/   # types, enums, pure helpers
  engine/   # services, repositories, rendering, persistence
wiki/
  SharedContracts.md   # conformance reference (enum lists, normalization rules)

Development

pnpm install
pnpm test
pnpm typecheck
pnpm lint

Extraction status

Code was extracted from citation-evidence/src/shared/ and citation-evidence/src/engine/ after the umbrella MVP (CE-WP-0001..0008) stabilized. The umbrella repo still carries a copy during the transition; this repository is the canonical home going forward.

Contract changes belong in citation-evidence/wiki/SharedContracts.md first, then sync to wiki/SharedContracts.md here.

Related repos

• citation-evidence — umbrella reference workspace
• evidence-anchor — selector creation and resolution
• evidence-source — document ingestion
• citation-work — review workspace UX
• evidence-binder — evidence-to-field linking