2026-05-25 00:13:07 +02:00
|
|
|
# citation-engine
|
|
|
|
|
|
2026-06-22 18:02:05 +02:00
|
|
|
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
|
