entity-registry

1# Entity Registry
2 
3The canonical machine-facing entity authority. It records identity and recognition facts with provenance; it does not own positioning, brand voice, claim approval, or page copy.
4 
5## Quick Start
6 
7```text
8Audit entity recognition for organization acme-analytics.
9Review pending entity proposals and reconcile duplicate IDs.
10Record a verified Wikidata QID and sameAs set for entity-7f42.
11Diagnose why AI systems confuse this entity with another organization.
12```
13 
14## Skill Contract
15 
16**Unit:** one stable, non-PII entity aggregate ID. **Reads:** `memory/events/entities.ndjson`, `memory/projections/entities.json`, the Narrative and claims projections, verified source records, and optional rendered views. **Writes:** authorized entity events through `scripts/registry-events.py`; a Markdown view under `memory/entities/` may then be regenerated from accepted projection state. **Done when:** the six signal categories have Pass/Partial/Fail/Unknown observations with evidence, identity conflicts are resolved or left open, every accepted change has an event ID/offset/revision, and `verify entities` passes.
17…