How it works
The review-first lifecycle every contribution follows, from proposal to a versioned graph update.
Core principle. No contribution changes the knowledge graph directly. Every contribution is a proposal that is validated and reviewed before any versioned update. Contributions are proposals, not truth.
- 1Proposal
A contributor drafts a structured proposal attached to real graph objects.
- 2Validation
Automated checks confirm targets resolve, sources are present, and domains are separated.
- 3Editorial review
An editor checks scope, clarity, and policy, then routes the proposal.
- 4Scientific review
Where a factual claim is made, a domain expert verifies accuracy and evidence.
- 5Decision
Accepted, rejected, or returned for sources/changes — always with a recorded reason.
- 6Versioned update
Only an accepted proposal may become a versioned graph update. The graph stays the source of truth.
Review states
Every proposal moves through valid states only. Invalid transitions are rejected; no history is fabricated.
| State | Meaning | Can move to |
|---|---|---|
| Draft | Being prepared by the contributor; not yet submitted for review. | submitted, archived |
| Submitted | Submitted for review and waiting to be triaged. | triaged, rejected, archived |
| Triaged | Validated and routed to the appropriate review track. | needs_sources, needs_changes, under_editorial_review, rejected, archived |
| Needs sources | Returned to the contributor to add or strengthen sources. | submitted, under_editorial_review, rejected, archived |
| Needs changes | Returned to the contributor with requested changes. | submitted, under_editorial_review, rejected, archived |
| Under editorial review | An editor is checking scope, clarity, and policy compliance. | under_scientific_review, needs_sources, needs_changes, accepted, rejected, archived |
| Under scientific review | A scientific reviewer is checking accuracy and evidence. | accepted, needs_sources, needs_changes, rejected, archived |
| Accepted | Approved. Eligible for a versioned graph update. | superseded, deprecated, archived |
| Rejected | Declined, with a recorded reason. | archived |
| Archived | Closed and retained for the record. | — |
| Superseded | Replaced by a newer accepted contribution. | archived |
| Deprecated | An accepted change later withdrawn or invalidated. | archived |