How OTCS works

flowchart TD
    A["People and projects"] --> B["Project registry<br/>otcs.yaml manifest"]
    B --> C["Coordinate map<br/>actor · authority · action · environment<br/>function · time · maturity"]
    C --> D["Evidence ledger<br/>claim-by-claim states, maturity profile"]
    D --> E["Relationship graph<br/>typed edges, each with assertion status"]
    E --> F["Coordination<br/>offers · needs · interfaces"]
    F --> G["Composition in the world<br/>signals → decisions → enforcement → receipts → repair"]
    G -. "field evidence returns" .-> D

flowchart TD
    START(["A project exists"]) --> WHO{"Who is writing<br/>the record?"}

    WHO -- "the project itself" --> PR["Pull request adding<br/>registry/projects/&lt;id&gt;/otcs.yaml"]
    WHO -- "an OTCS maintainer,<br/>from public evidence" --> OBS["record_state: observed<br/>not project-controlled<br/>never shown as participation"]
    WHO -- "nobody — project declines" --> DECL["DECLINE honored<br/>no page is created"]

    PR --> VAL{"npm run validate"}
    VAL -- "schema error,<br/>semantic error,<br/>dangling edge" --> FIX["Fix and resubmit"]
    FIX --> VAL
    VAL -- "passes" --> MERGE["Maintainer merges"]
    MERGE --> EV["Ledger event:<br/>PROJECT_REGISTERED"]
    EV --> REG["record_state: registered<br/>maintainer-verified"]

    OBS --> EV
    REG --> LIVE(["Live record — a public,<br/>attributable claim about itself,<br/>and nothing more"])
    OBS --> LIVE

stateDiagram-v2
    [*] --> SELF_ASSERTED: project states it
    SELF_ASSERTED --> DOCUMENTED: a public artifact shows it
    DOCUMENTED --> REPRODUCIBLE: an outsider can re-derive it
    REPRODUCIBLE --> INDEPENDENTLY_TESTED: independence test passes
    INDEPENDENTLY_TESTED --> FIELD_OBSERVED: repeated real-world evidence

    REPRODUCIBLE --> DOCUMENTED: independence test FAILS
    SELF_ASSERTED --> DISPUTED: dispute record opened
    DOCUMENTED --> DISPUTED: dispute record opened
    REPRODUCIBLE --> DISPUTED: dispute record opened
    INDEPENDENTLY_TESTED --> DISPUTED: dispute record opened
    DISPUTED --> DOCUMENTED: resolved
    SELF_ASSERTED --> RETRACTED: withdrawn by claimant
    DOCUMENTED --> RETRACTED: withdrawn by claimant
    RETRACTED --> [*]

flowchart TD
    SEED["SEED — anyone, no standing required"] --> DISC["DISCOVERY — prior art, affected projects, risks"]
    DISC --> DRAFT["DRAFT — concrete change published<br/>⏱ clock starts here"]
    DRAFT --> DELIB["DELIBERATION — objections raised and answered"]
    DELIB --> TRIAL["TRIAL — implementation or simulation<br/>interfaces target two independent ones"]
    TRIAL --> CLOCK{"Has the class minimum<br/>elapsed?"}
    CLOCK -- "no" --> WAIT["Wait. The clock binds the founder<br/>or it binds nobody."]
    WAIT --> CLOCK
    CLOCK -- "yes" --> BALLOTS

    subgraph BALLOTS ["RATIFICATION — three ballots, not one"]
        BA["A · Readiness<br/>is it specified and evidenced enough to decide?"]
        BB["B · Ratification<br/>should this exact version pass?"]
        BC["C · Implementation<br/>will your project actually implement it?"]
    end

    BALLOTS --> GATE{"Process validity<br/>A_g ≤ E_g"}
    GATE -- "environment supports it" --> ALLOW["ALLOW — ratify"]
    GATE -- "scope or evidence too broad" --> SHAPE["SHAPE — revise"]
    GATE -- "deliberation bypassed or overwhelmed" --> DEAUT["DEAUTOMATE — back to human deliberation"]
    GATE -- "cannot be legitimately supported" --> VETO["VETO — reject"]

    SHAPE --> DELIB
    DEAUT --> DELIB
    ALLOW --> OP["OPERATION — change is active,<br/>ledger event recorded"]
    OP --> REV["REVIEW — every decision carries<br/>a review, expiry, or reaffirmation date"]
    REV --> RENEW["RENEWED"]
    REV --> DEP["DEPRECATED"]

flowchart LR
    subgraph DECLARED ["Declared — authoritative, human-written, PR-reviewed"]
        M["manifests"]
        R["relationships"]
        C["claims"]
        B["ballots and receipts"]
    end

    subgraph GEN ["Generators — deterministic"]
        G1["relationship graph"]
        G2["capability matrix"]
        G3["overlap O · complementarity Γ"]
    end

    subgraph COMPUTED ["computed/ — interpretation, never attribute"]
        S["every artifact stamped:<br/>algorithm version · input hashes<br/>weights · timestamp"]
    end

    DECLARED --> GEN --> COMPUTED
    COMPUTED --> SITE["Site pages, labeled<br/>'computed interpretation, not fact'"]
    DECLARED --> SITE

    LEDGER[/"governance ledger<br/>append-only, hash-chained"/]
    DECLARED -. "every change emits an event" .-> LEDGER