{
  "version": "1.0.0",
  "effectiveAt": "2026-08-12",
  "status": "public-beta",
  "title": "The Evidence Constitution",
  "preamble": [
    "1001 Smart Cities is a map into the public record, not a substitute for it. Its job is to make claims traceable, sources inspectable, gaps visible and changes permanent.",
    "AI may increase the breadth and consistency of the record. It may not manufacture certainty. Where a source, date, locator, conflict or decision cannot be established, the system records the absence instead of filling it with a plausible answer.",
    "Trust is earned through inspectability: a reader must be able to move from a sentence to the claim it contains, from that claim to the sources that carry it, and from the current record to every earlier revision."
  ],
  "articles": [
    {
      "id": "claim-boundaries",
      "title": "Claims have boundaries",
      "rule": "Every material factual statement is represented as an addressable claim with stable identity and a visible boundary in the published text.",
      "tests": [
        "The claim text is preserved verbatim or the transformation is declared.",
        "Compound claims are split when their parts rely on different sources.",
        "A claim cannot disappear from a revision without a recorded change."
      ]
    },
    {
      "id": "source-identity",
      "title": "Sources are records, not links",
      "rule": "Every cited source has a stable identifier and a dossier that records its URL, publisher identity or known absence, type, language, temporal metadata, locator and preservation state.",
      "tests": [
        "Unknown publisher names, dates and languages are stored as explicit nulls.",
        "A bare URL never counts as a complete dossier.",
        "Redirects, dead links and replacements create new events; they do not silently overwrite the old source record."
      ]
    },
    {
      "id": "time",
      "title": "Time is part of the evidence",
      "rule": "The record distinguishes when a source was published, updated, retrieved, checked, archived and added to the atlas.",
      "tests": [
        "Dates are typed by meaning rather than collapsed into one timestamp.",
        "A current-status claim states the date to which it applies.",
        "Missing temporal facts remain visible and lower the completeness of the dossier."
      ]
    },
    {
      "id": "claim-source-mapping",
      "title": "A source must say what it supports",
      "rule": "Every material claim names at least one source and every source states which claims it supports, contradicts or contextualises.",
      "tests": [
        "Project-level bibliographies alone are insufficient.",
        "A source note describes the relevant passage or records that an exact locator is still missing.",
        "Conflicting sources remain linked side by side; the system does not erase the disagreement."
      ]
    },
    {
      "id": "uncertainty",
      "title": "Uncertainty is structured",
      "rule": "Unknown, disputed, estimated, derived and time-sensitive information are distinct states and are never presented as settled facts by omission.",
      "tests": [
        "Caveats sit with the claim they qualify.",
        "Interpolation and causal interpretation are off by default.",
        "Evidence grades describe the strongest source class, not the truth of every sentence."
      ]
    },
    {
      "id": "ai-role",
      "title": "AI compiles; it does not confer authority",
      "rule": "AI may extract, normalise, compare, translate, link and draft from recorded material. It may not invent facts, fill unknown fields, resolve source conflicts, or assign human and expert review states.",
      "tests": [
        "AI-produced text is disclosed as such.",
        "A generated statement must be reproducible from its recorded claims and sources.",
        "Human and expert review require named, dated actions by an authorised operator."
      ]
    },
    {
      "id": "revision-permanence",
      "title": "History is append-only",
      "rule": "Published corrections create a new immutable revision. Earlier revision permalinks remain available and state that they are superseded when applicable.",
      "tests": [
        "Each revision has a stable URL and a content hash.",
        "The changelog states what changed, why and which fields were affected.",
        "Retractions preserve the prior record and explain the withdrawal."
      ]
    },
    {
      "id": "review-separation",
      "title": "Preparation and review are separate acts",
      "rule": "Machine validation, human review and subject-matter review are different states with different scopes. Passing a schema or source-link check never implies that a person endorsed the claim.",
      "tests": [
        "Every review state records scope, actor and date.",
        "Unreviewed is the default for AI-assisted migrations.",
        "A reviewer may accept the mapping while leaving the underlying claim disputed."
      ]
    }
  ],
  "readerRights": [
    {
      "id": "inspect",
      "title": "Right to inspect",
      "statement": "Readers can see the claims, source mappings, caveats, missing fields and review state behind a published view."
    },
    {
      "id": "reproduce",
      "title": "Right to reproduce",
      "statement": "Stable identifiers, machine-readable records and permanent revisions make the evidence path reproducible."
    },
    {
      "id": "contest",
      "title": "Right to contest",
      "statement": "Readers can challenge a claim, source, locator or interpretation without having to reject the entire project record."
    },
    {
      "id": "correct",
      "title": "Right to correct",
      "statement": "Accepted corrections create a new revision and retain the history of the change."
    },
    {
      "id": "know-limits",
      "title": "Right to know the limits",
      "statement": "The interface exposes what is missing, stale, inaccessible, unarchived, unlocated or unreviewed."
    },
    {
      "id": "reuse",
      "title": "Right to reuse",
      "statement": "Public records remain linkable and reusable under the stated licence, with attribution and revision identity."
    }
  ],
  "reviewStates": [
    {
      "id": "unreviewed",
      "meaning": "Prepared or migrated, with no separate human review of this record."
    },
    {
      "id": "machine-validated",
      "meaning": "Structural and referential checks passed; this is not a factual endorsement."
    },
    {
      "id": "human-reviewed",
      "meaning": "A named operator reviewed the declared scope on the recorded date."
    },
    {
      "id": "expert-reviewed",
      "meaning": "A named subject-matter expert reviewed the declared scope on the recorded date."
    }
  ],
  "nonGoals": [
    "The atlas does not claim that source availability makes a claim true.",
    "The atlas does not hide value judgments inside neutral-looking scores.",
    "The atlas does not convert missing evidence into an estimate.",
    "The atlas does not present AI output as a human-authored or expert-reviewed publication."
  ]
}