Skip to content

Four-State Per-Country Curation Lifecycle

Questions or comments?

Post them as a comment on the tracking issue -- requires a GitHub account with access to this repo.

Scope

The maturity model for tracking every country Codex might ever support: State A — no source list configured. State B — sources configured, not yet crawled. State C — crawled, review pending (documents exist but haven't cleared SME review). State D — crawled and validated (fully live in Codex). Per ../schema-changes.md, no field currently records this state explicitly anywhere in the pipeline — this Feature is what introduces it, likely as a computed/aggregated status derived from existing CountryConfig (has sources?), SyncManifest (has crawled parts?), and the new document-review record this Feature Set proposes (has cleared review?).

Value

Turns "are we covered for country X?" into something visible at a glance — the backbone of the ops dashboard's per-country breakdown, and the concrete mechanism by which Curator and Advisor stay aligned on what "coverage" means for a given country at a given moment.

Acceptance criteria

  • Every country Codex could ever support has a computable curation state (A, B, C, or D) at any point in time — not just the countries currently in progress.
  • A country transitions states automatically as pipeline events happen (a source list is added → B; a crawl runs → C; the last pending document in that country clears SME review → D) — states are not manually set by a human unless the underlying trigger genuinely can't be observed automatically.
  • State C explicitly means "review pending," not "fully live" — i.e. a country with crawled-but-unreviewed documents must not appear as State D or be treated as Tier 1 grounded (see ../three-tier-grounding-model).
  • The ops dashboard's per-country grid (see ../curator-ops-dashboard/spec.md) colors each country by this state.