# 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

```bash
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`](../citation-evidence/) — umbrella reference workspace
- [`evidence-anchor`](../evidence-anchor/) — selector creation and resolution
- [`evidence-source`](../evidence-source/) — document ingestion
- [`citation-work`](../citation-work/) — review workspace UX
- [`evidence-binder`](../evidence-binder/) — evidence-to-field linking