Diagram Library v1

D1 · Entity Relationship (database schema)

erDiagram
  USERS ||--o{ USER_ROLES : holds
  ROLES ||--o{ USER_ROLES : grants
  USERS ||--o{ CLAIMS : submits
  TOWNS ||--o{ CLAIMS : concerns
  TOWNS ||--o{ CONTESTED_POSITIONS : "displays (C4)"
  CLAIMS ||--o{ CLAIM_VERSIONS : versions
  CLAIMS ||--o{ CLAIM_STATES : "history (C5)"
  CLAIMS ||--o{ EVIDENCE_LINKS : links
  EVIDENCE_ITEMS ||--o{ EVIDENCE_LINKS : linked
  EVIDENCE_ITEMS ||--o{ SOURCE_LINK_CHECKS : monitored
  CHAMBERS ||--o{ CHAMBER_MEMBERS : seats
  USERS ||--o{ CHAMBER_MEMBERS : serves
  CLAIMS ||--o{ ATTESTATIONS : votes
  CHAMBERS ||--o{ ATTESTATIONS : casts
  CLAIMS ||--o{ GRIEVANCES : rereview
  CLAIMS ||--o{ CONSENT_RECORDS : "DSEIL consent"
  ANCHOR_BATCHES ||--o{ ANCHORS : contains
  CLAIM_STATES ||--o| ANCHORS : "digest only (C8)"
  EVIDENCE_ITEMS ||--o| ANCHORS : "digest only (C8)"
  USERS ||--o{ RECOGNITION_EVENTS : earns
  USERS ||--o{ AUDIT_LOG : acts

D2 · System Architecture (L0–L8)

flowchart TB
  C[L0 Constraint Register C1-C10]:::const
  C --> E[L1 Evidence Layer\nFactBank · Road to Repair]
  C --> V[L2 Verification Layer\nProof of Fact · Chambers · Veracity]
  C --> A[L3 Anchoring Layer\nSHA-256 digest-only]
  C --> G[L4 Governance & Consent\nDSEIL · FPIC · Charter]
  E --> V --> A
  G --> V
  V --> APP[L5 Applications\nBrowser · Platform · Atlas · Provenance pages]
  A --> APP
  M[L6 Agent Mesh\npropose-only] -.proposals.-> V
  H[L7 Economic Layer]:::held -.HELD C1/C7.- C
  APP --> N[L8 Network\nBoley pilot → 13-town federation · OZ 2.0]
  classDef const fill:#9e3b2c,color:#ede6d6
  classDef held fill:#2c2720,color:#7c8a6e,stroke:#7c8a6e,stroke-dasharray:4

D3 · Implementation Dependency Graph

flowchart TB
  L0[Constraint Register] --> LEGAL[Legal formation + counsel]
  L0 --> LOOP[Minimal Pilot Loop definition]
  LEGAL --> MOU[Boley MOU + consent instruments]
  LOOP --> BUDGET[Pilot budget] --> FUND[Funder brief / Zacchaeus]
  LOOP --> BUILD[MVP build S1-S6]
  MOU --> PILOT[Boley pilot live]
  BUILD --> PILOT
  FUND --> PILOT
  PILOT --> P1[Phase 1 evidence]
  P1 --> COUNSEL[Securities review of L7]:::held
  P1 --> FED[Towns 2-3 onboard]
  OZ[OZ 2.0 sprint — deadline 2026-09-28]:::hot --> CAP[Capital channel for towns]
  FPIC[FPIC per nation — no clock, their timeline]:::held
  classDef hot fill:#9e3b2c,color:#ede6d6
  classDef held fill:#2c2720,color:#7c8a6e,stroke:#7c8a6e,stroke-dasharray:4

D4 · Claim Lifecycle — Sequence

sequenceDiagram
  actor R as Resident
  participant API as Claims API
  participant CH as Chamber (humans)
  participant AN as Anchor Service
  participant PUB as Provenance Page
  R->>API: POST /claims (proposed)
  R->>API: POST /claims/id/evidence
  API->>CH: queue notification
  CH->>API: POST attestations (votes)
  CH->>API: POST /claims/id/state (attested) — C5 human only
  API->>AN: nightly digest batch
  AN->>AN: Merkle root → on-chain tx (digest only, C8)
  AN->>API: anchor.confirmed
  API->>PUB: full history + proof
  R->>PUB: shares link — anyone verifies

D5 · Claim State Machine (C5)

stateDiagram-v2
  [*] --> proposed
  proposed --> under_review : chamber picks up
  proposed --> withdrawn : submitter (own claim only)
  under_review --> attested : quorum, human decision
  under_review --> contested : quorum, disagreement stands (C4 spirit)
  under_review --> rejected : quorum
  attested --> contested : grievance re-review only
  contested --> attested : grievance re-review only
  attested --> [*]
  contested --> [*]
  rejected --> [*]
  withdrawn --> [*]
  note right of attested : No delete path exists.\nErasure floor.

D6 · Chamber Review — Activity

flowchart TB
  S[Claim enters queue] --> R{Any member\nconflict of interest?}
  R -- yes --> REC[Member recuses — recorded publicly] --> Q
  R -- no --> Q{Quorum of 3 present?}
  Q -- no --> W[Wait / nudge at day 10] --> Q
  Q -- yes --> EV[Review evidence side-by-side]
  EV --> VOTE[Each member votes with note]
  VOTE --> DEC{Positions}
  DEC -- agreement --> RAT[Coordinator writes public rationale]
  DEC -- split stands --> CON[State: contested — disagreement displayed]
  RAT --> SET[Coordinator sets state — two-step confirm]
  CON --> SET
  SET --> PUB[Published + notified + batched for anchor]

D7 · Evidence Admission — Decision Tree

flowchart TB
  A[Evidence submitted] --> B{C3 category?\nharm / descendant data}
  B -- yes --> X[Rejected at intake\nrespectful explanation + human contact]
  B -- no --> C{Living private person named?}
  C -- yes --> D{Consent record exists?}
  D -- no --> HOLD[Held: 428 CONSENT_REQUIRED]
  D -- yes --> E
  C -- no --> E{Source description present?}
  E -- no --> F[Returned: source description required]
  E -- yes --> G[Registered: hashed, versioned, linked]
  G --> H{Claim reaches attested/contested?}
  H -- yes --> I[anchor_eligible = true]
  H -- no --> J[Stored, unanchored]

D8 · Governance Structure (pilot)

flowchart TB
  CONST[Constraint Register C1-C10] --> CHARTER[Community Charter — Boley-ratified]
  CHARTER --> CHAMBER[Chamber of Five\nquorum 3 · recusal rules]
  CHAMBER --> COORD[Coordinator\npublishes rationale, sets states]
  RES[Residents] -- submit claims --> CHAMBER
  RES -- grievance: one guaranteed re-review --> CHAMBER
  MAYOR[Mayor Hicks / Town of Boley] -- MOU + recruitment --> CHAMBER
  AGENTS[Agent Mesh] -. proposals only, labeled .-> CHAMBER
  COUNSEL[Counsel] -- instruments --> CHARTER

D9 · Trust / Verification Graph (Proof Graph shape)

graph LR
  CL1[Claim: bank built 1922] --- EV1[County record]
  CL1 --- EV2[1923 photograph]
  CL1 --- AT1{{Chamber decision: attested 4/5}}
  AT1 --- M1[Member A] & M2[Member B] & M3[Member C] & M4[Member D]
  M5[Member E — recused] -.recorded.- AT1
  AT1 --- ANC[Anchor: batch 214 digest]
  CL2[Claim: founding year] --- CP1[Position: 1903, source X]
  CL2 --- CP2[Position: 1905, source Y]
  CL2 --- ST2{{contested — both displayed, C4}}

D10 · Knowledge Graph (canon top level)

mindmap
  root((Master Canon v1.0.1))
    Constitution
      C1-C10
      Decision register D1-D7
    Verification
      Proof of Fact
      Chambers
      Veracity API
      Proof Graph
    Evidence
      FactBank
      Road to Repair corpus
    Anchoring
      Digest-only ledger
      DSEIL
    Network
      Boley pilot
      13-town federation
      OZ 2.0 · COEDD
    Held
      Economic layer C1/C7
      Dreamland OS name C6
      Cherokee — FPIC gate C2
    Gaps
      Smart Echo System
      Loop Protocol
      Oracle

D11 · OZ 2.0 Sprint — Flow with deadline

flowchart LR
  A[Tract shortlist\nMoreno + Jay] --> B[COEDD activation meeting]
  A --> C[Per-town nomination briefs]
  B --> D[Governor's-office path\nvia Matthews channel]
  C --> D
  D --> E{{Submission before 2026-09-28}}
  E -- made --> F[Designation decision awaited]
  E -- missed --> G[Documented post-mortem\nnext window strategy]

D12 · Pilot Flywheel (H1-H4 loop)

flowchart LR
  A[Resident submits claim] --> B[Chamber verifies with dignity]
  B --> C[Public anchored provenance]
  C --> D[Trust measurably rises]
  D --> E[More residents participate]
  E --> A
  C --> F[Phase 1 evidence accumulates]
  F --> G[Funding + federation + C7 review unlock]