Schema Diagrams

erDiagram
  Entity ||--o{ RelatedEntry : "relatedEntries"
  Entity ||--o{ EntitySource : "sources"
  Entity ||--o{ ContentSection : "content.sections"
  Entity ||--o| EntityContent : "content"
  Entity ||--o| ParameterDistinctions : "parameterDistinctions"
  Entity }o--o{ Resource : "resources (by ID)"
  Entity }o--o| CauseEffectGraph : "embedded graph"

  Expert ||--o{ ExpertPosition : "positions"
  Expert }o--o| Organization : "affiliation"
  Organization ||--o{ Expert : "keyPeople"

  Estimate ||--o{ EstimateSource : "estimates"
  Crux ||--o{ CruxPosition : "positions"

  Graph ||--o{ GraphNode : "nodes"
  Graph ||--o{ GraphEdge : "edges"

  MasterGraph ||--o{ MasterGraphNode : "nodes"
  MasterGraph ||--o{ MasterGraphEdge : "edges"
  MasterGraph ||--o{ SubgraphSpec : "subgraphs"

  CauseEffectGraph ||--o{ CauseEffectNode : "nodes"
  CauseEffectGraph ||--o{ CauseEffectEdge : "edges"

  FactsFile ||--o{ Fact : "facts"

  Entity {
      string id PK
      EntityType type
      string title
      string description
      string status
      string wikiId UK
  }

  RelatedEntry {
      string id FK
      EntityType type
      RelationshipType relationship
      string strength
  }

  Expert {
      string id PK
      string name
      string affiliation FK
      string role
  }

  Organization {
      string id PK
      string name
      OrgType type
      string founded
  }

  Resource {
      string id PK
      string url
      string title
      ResourceType type
      number importance
  }

  Fact {
      string entity FK
      string factId PK
      string value
      number numeric
      string compute
  }

classDiagram
  class Entity {
      +String id
      +EntityType type
      +String title
      String description
      String[] aliases
      EntityContent content
      EntityStatus status
      String lastUpdated
      String[] tags
      Cluster[] clusters
      String severity
      Likelihood likelihood
      Timeframe timeframe
      ResearchMaturity maturity
      String website
      CustomField[] customFields
      String[] relatedTopics
      RelatedEntry[] relatedEntries
      EntitySource[] sources
      String[] resources
      ParameterDistinctions parameterDistinctions
  }

  class EntityContent {
      String intro
      ContentSection[] sections
      String footer
  }

  class ContentSection {
      +String heading
      String body
      String mermaid
      ContentTable table
      String component
      Record componentProps
  }

  class RelatedEntry {
      +String id
      +EntityType type
      RelationshipType relationship
      String strength
  }

  class CustomField {
      +String label
      +String value
  }

  class EntitySource {
      +String title
      String url
      String author
      String date
  }

  Entity *-- EntityContent
  Entity *-- RelatedEntry
  Entity *-- CustomField
  Entity *-- EntitySource
  EntityContent *-- ContentSection

classDiagram
  class Expert {
      +String id
      +String name
      String affiliation
      String role
      String website
      ExpertPosition[] positions
  }

  class ExpertPosition {
      +String topic
      +String view
      String estimate
      Confidence confidence
      String date
  }

  class Organization {
      +String id
      +String name
      +OrgType type
      String founded
      String headquarters
      String[] keyPeople
      String funding
  }

  Expert *-- ExpertPosition
  Expert --> Organization : affiliation
  Organization --> Expert : keyPeople

classDiagram
  class Estimate {
      +String id
      +String variable
      String unit
      String category
      EstimateSource[] estimates
  }

  class EstimateSource {
      +String source
      +String value
      String date
      Confidence confidence
  }

  class Crux {
      +String id
      +String question
      +Importance importance
      String resolvability
      CruxPosition[] positions
      String[] relatedCruxes
  }

  Estimate *-- EstimateSource

classDiagram
  class Resource {
      +String id
      +String url
      +String title
      ResourceType type
      String[] authors
      Number importance
      String summary
      String review
      String publication_id
  }

  class Publication {
      +String id
      +String name
      +PublicationType type
      +Number credibility
      Boolean peer_reviewed
  }

  Resource --> Publication : publication_id

classDiagram
  class CauseEffectGraph {
      String title
      String description
      String primaryNodeId
      CauseEffectNode[] nodes
      CauseEffectEdge[] edges
  }

  class CauseEffectNode {
      +String id
      +String label
      String description
      NodeType type
      Number confidence
      String details
      String entityRef
      NodeScores scores
      String color
  }

  class CauseEffectEdge {
      String id
      +String source
      +String target
      Strength strength
      Confidence confidence
      Effect effect
      String label
  }

  class NodeScores {
      Number novelty
      Number sensitivity
      Number changeability
      Number certainty
  }

  CauseEffectGraph *-- CauseEffectNode
  CauseEffectGraph *-- CauseEffectEdge
  CauseEffectNode *-- NodeScores

  note for CauseEffectNode "type: leaf | cause | intermediate | effect"
  note for CauseEffectEdge "effect: increases | decreases | mixed"

classDiagram
  class Graph {
      +String id
      +String title
      String description
      GraphNode[] nodes
      GraphEdge[] edges
  }

  class GraphNode {
      +String id
      +String label
      +Category category
      String description
      String entityRef
  }

  class GraphEdge {
      +String from
      +String to
      +EdgeType type
      String label
      Importance strength
  }

  Graph *-- GraphNode
  Graph *-- GraphEdge

  note for GraphNode "category: crux | risk | outcome | capability | intervention"
  note for GraphEdge "type: causes | mitigates | requires | enables | blocks"

classDiagram
  class MasterGraph {
      +String id
      +String title
      String version
      MasterGraphNode[] nodes
      MasterGraphEdge[] edges
      SubgraphSpec[] subgraphs
      Group[] groups
  }

  class MasterGraphNode {
      +String id
      +String label
      +NodeType type
      String ownerEntityId
      String entityRef
      String group
      Number confidence
  }

  class SubgraphSpec {
      +String entityId
      +String centerNode
      Number depth
      String[] includeNodes
      String[] excludeNodes
  }

  MasterGraph *-- MasterGraphNode
  MasterGraph *-- SubgraphSpec

flowchart TD
  A[Entity A] -->|"relatedEntries"| B[Entity B]
  B -.->|"backlink<br/>(auto-computed)"| A

  style A fill:#cceeff
  style B fill:#cceeff

flowchart TD
  subgraph Input["Source Files"]
      YAML["YAML data"]
      MDX["MDX pages"]
  end

  subgraph Parse["1. Parse & Merge"]
      P1["Parse YAML"]
      P2["Scan frontmatter"]
      P3["Auto-create entities"]
  end

  subgraph Transform["2. Transform"]
      T1["Assign numeric IDs"]
      T2["Validate with Zod"]
      T3["Compute backlinks"]
  end

  subgraph Enrich["3. Enrich"]
      E1["Resolve facts"]
      E2["Build indices"]
      E3["Generate search"]
  end

  subgraph Output["Output"]
      DB["database.json"]
  end

  Input --> Parse
  Parse --> Transform
  Transform --> Enrich
  Enrich --> Output

  style Input fill:#fff4e1
  style Parse fill:#cceeff
  style Transform fill:#e1f5ff
  style Enrich fill:#cceeff
  style Output fill:#ccffcc

classDiagram
  class FactsFile {
      +String entity
      +Record facts
  }

  class Fact {
      String value
      Number numeric
      String asOf
      String source
      String note
      Boolean noCompute
      String compute
      String format
      Number formatDivisor
  }

  FactsFile *-- Fact

  note for Fact "compute: expression referencing other facts
e.g. {anthropic.valuation} * {rate}
Resolved via topological sort at build time"