Technical Appendix / Review Surface

Diagram Review

Temporary review page for standalone diagram sources in docs-diagrams/.

Each section renders the diagram in a constrained frame and shows the exact Mermaid source used to generate it. The page is tuned for review, not final publication.

CDR Diagrams

Target page: src/content/docs/conceptual-model/cdr.md Status: draft Source: conceptual-model-cdr.mdx
D1

D1. Monolithic Memory Under Mixed Timescales

Rendered Diagram D1 / MERMAID
flowchart TD I[Observed input stream] F[Fast-changing signals] M[Medium-horizon signals] S[Slow-changing signals] X[Single memory region] O1[One update and review cadence] O2[Fast signals may be missed] O3[Slow signals may be rewritten too often] O4[Competing signals can cause thrashing] O5[Recent signals can dominate and cause overfitting] I --> F I --> M I --> S F --> X M --> X S --> X X --> O1 O1 --> O2 O1 --> O3 O1 --> O4 O1 --> O5 
flowchart TD
    I[Observed input stream]
    F[Fast-changing signals]
    M[Medium-horizon signals]
    S[Slow-changing signals]
    X[Single memory region]
    O1[One update and review cadence]
    O2[Fast signals may be missed]
    O3[Slow signals may be rewritten too often]
    O4[Competing signals can cause thrashing]
    O5[Recent signals can dominate and cause overfitting]

    I --> F
    I --> M
    I --> S
    F --> X
    M --> X
    S --> X
    X --> O1
    O1 --> O2
    O1 --> O3
    O1 --> O4
    O1 --> O5
D2

D2. Partitioned Memory By Timescale

Rendered Diagram D2 / MERMAID
flowchart TD I[Observed input stream] F[Fast-changing signals] R1[Fast region<br/>Short review or expiry cycle] M[Medium-horizon signals] R2[Medium region<br/>Intermediate review cycle] S[Slow-changing signals] R3[Slow region<br/>Long review cycle] I --> F I --> M I --> S F --> R1 M --> R2 S --> R3 
flowchart TD
    I[Observed input stream]
    F[Fast-changing signals]
    R1[Fast region<br/>Short review or expiry cycle]
    M[Medium-horizon signals]
    R2[Medium region<br/>Intermediate review cycle]
    S[Slow-changing signals]
    R3[Slow region<br/>Long review cycle]

    I --> F
    I --> M
    I --> S
    F --> R1
    M --> R2
    S --> R3
D3

D3. Finite Useful Lifespan

Rendered Diagram D3 / MERMAID
flowchart TD A[Representation created] --> B[Useful period] B --> C[Drift accumulates] C --> D[Review point tau*] D --> E{Renew or rebuild?} E -->|yes| F[Representation refreshed] E -->|no| G[Degraded representation retained] G --> H[Higher downstream cost] 
flowchart TD
    A[Representation created] --> B[Useful period]
    B --> C[Drift accumulates]
    C --> D[Review point tau*]
    D --> E{Renew or rebuild?}
    E -->|yes| F[Representation refreshed]
    E -->|no| G[Degraded representation retained]
    G --> H[Higher downstream cost]

Homepage Diagrams

Target page: src/content/docs/index.mdx Status: draft Source: index.mdx
D6

D6. Synix Program Structure

Rendered Diagram D6 / MERMAID
flowchart TB A[Synix] A --> B[Build System<br/>Status: Shipped<br/>Declarative memory pipeline] A --> C[Memory Architecture<br/>Status: In design<br/>Continuously maintained memory] A --> D[Synixolis Protocol<br/>Status: Draft<br/>Persistent state and coordination] A --> E[Conceptual Model<br/>Status: Research<br/>Theory and design motivation] 
flowchart TB
    A[Synix]
    A --> B[Build System<br/>Status: Shipped<br/>Declarative memory pipeline]
    A --> C[Memory Architecture<br/>Status: In design<br/>Continuously maintained memory]
    A --> D[Synixolis Protocol<br/>Status: Draft<br/>Persistent state and coordination]
    A --> E[Conceptual Model<br/>Status: Research<br/>Theory and design motivation]

Memory Architecture Diagrams

Target page: src/content/docs/memory/overview.md Status: draft Source: memory-overview.mdx
D9

D9. Architecture Layers

Rendered Diagram D9 / MERMAID
flowchart TB A[Data Model<br/>Objects<br/>Event log<br/>Policies and procedures] B[Governance<br/>Evidence-backed writes<br/>Conflict resolution<br/>Convention changes] C[Agents<br/>Ingestion<br/>Synthesis<br/>Decay and archival<br/>Health monitoring] D[Roadmap<br/>Built<br/>Designed<br/>Planned] A --> B --> C --> D 
flowchart TB
    A[Data Model<br/>Objects<br/>Event log<br/>Policies and procedures]
    B[Governance<br/>Evidence-backed writes<br/>Conflict resolution<br/>Convention changes]
    C[Agents<br/>Ingestion<br/>Synthesis<br/>Decay and archival<br/>Health monitoring]
    D[Roadmap<br/>Built<br/>Designed<br/>Planned]

    A --> B --> C --> D

Node Lifecycle Diagrams

Target page: src/content/docs/synixolis/node-lifecycle.md Status: draft Source: synixolis-node-lifecycle.mdx
D13

D13. Node State Machine

Rendered Diagram D13 / MERMAID
flowchart TD S0[INITIALIZING] S1[ACTIVE] S2[DORMANT] S3[FENCED] S4[TERMINATED] S0 --> S1 S1 --> L1[Write and read activity] L1 --> L2[Evaluation traces] L2 --> L3[Review and learning] L3 --> L4[Rule updates or renewals] L4 --> S1 S1 --> S2 S2 --> S1 L3 --> R1[Renewal decision] R1 -->|refresh| S1 R1 -->|replace| S4 S1 --> S3 S3 --> R2[Recovery review] R2 --> S1 R2 --> S4 
flowchart TD
    S0[INITIALIZING]
    S1[ACTIVE]
    S2[DORMANT]
    S3[FENCED]
    S4[TERMINATED]

    S0 --> S1
    S1 --> L1[Write and read activity]
    L1 --> L2[Evaluation traces]
    L2 --> L3[Review and learning]
    L3 --> L4[Rule updates or renewals]
    L4 --> S1

    S1 --> S2
    S2 --> S1

    L3 --> R1[Renewal decision]
    R1 -->|refresh| S1
    R1 -->|replace| S4

    S1 --> S3
    S3 --> R2[Recovery review]
    R2 --> S1
    R2 --> S4

Synixolis Overview Diagrams

Target page: src/content/docs/synixolis/overview.md Status: draft Source: synixolis-overview.mdx
D10

D10. Single-Node Reference Shape

Rendered Diagram D10 / MERMAID
flowchart TB A[Node] A --> B[CLAUDE.md] A --> C[memory/] A --> D[eval/] A --> E[fault-isolation/] A --> F[colony/] A --> G[protocol/] C --> C1[ephemeral] C1 --> C2[operational] C2 --> C3[structural] C3 --> C4[identity] C4 --> C5[glacier] D --> D1[interaction traces] D1 --> D2[query log] D2 --> D3[compiled rules] 
flowchart TB
    A[Node]
    A --> B[CLAUDE.md]
    A --> C[memory/]
    A --> D[eval/]
    A --> E[fault-isolation/]
    A --> F[colony/]
    A --> G[protocol/]

    C --> C1[ephemeral]
    C1 --> C2[operational]
    C2 --> C3[structural]
    C3 --> C4[identity]
    C4 --> C5[glacier]

    D --> D1[interaction traces]
    D1 --> D2[query log]
    D2 --> D3[compiled rules]
D11

D11. Multi-Node Shared State Model

Rendered Diagram D11 / MERMAID
flowchart TB N1[Node A] N2[Node B] N3[Node C] L[Shared append-only log] V1[Local view A] V2[Local view B] V3[Local view C] N1 --> L N2 --> L N3 --> L L --> V1 L --> V2 L --> V3 
flowchart TB
    N1[Node A]
    N2[Node B]
    N3[Node C]
    L[Shared append-only log]
    V1[Local view A]
    V2[Local view B]
    V3[Local view C]

    N1 --> L
    N2 --> L
    N3 --> L
    L --> V1
    L --> V2
    L --> V3
D12

D12. Optimization, Promotion, And Demotion Lifecycle

Rendered Diagram D12 / SVG
Optimization, promotion, and demotion lifecycle A vertically stacked lifecycle diagram showing five levels. Each level contains a local three-step cycle. Between adjacent levels, a transfer section contains a promotion mechanism and a decay mechanism. Level 0 Pure inference / Artifact: none Inference Local usage Observed recurrence promotion candidate Transfer between Level 0 and Level 1 Promotion mechanism capture -> validate -> retain Decay mechanism stop retaining -> fall back Level 1 Recognized pattern / Artifact: trace-backed observation Observation Reuse in similar cases Review for persistence Transfer between Level 1 and Level 2 Promotion mechanism compile -> validate -> adopt locally Decay mechanism insufficient recurrence -> observation Level 2 Local compilation / Artifact: explicit local rule Local rule Routine local execution Review for broader value Transfer between Level 2 and Level 3 Promotion mechanism proposal -> validation -> approval Decay mechanism downgrade -> local rule Level 3 Shared convention / Artifact: promoted stable rule Shared rule Shared use across nodes Review for integration Transfer between Level 3 and Level 4 Promotion mechanism stabilize -> implement -> ship Decay mechanism withdraw -> revert to shared rule Level 4 Native integration / Artifact: implementation primitive Implementation primitive Built-in execution path Review for continued fitness 
<svg viewBox="0 0 760 1645" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="d12-title d12-desc">
  <title id="d12-title">Optimization, promotion, and demotion lifecycle</title>
  <desc id="d12-desc">A vertically stacked lifecycle diagram showing five levels. Each level contains a local three-step cycle. Between adjacent levels, a transfer section contains a promotion mechanism and a decay mechanism.</desc>
  <defs>
    <marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto">
      <path d="M 0 0 L 10 5 L 0 10 z" fill="#365d84" />
    </marker>
    <marker id="arrow-soft" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto">
      <path d="M 0 0 L 10 5 L 0 10 z" fill="#8da1b6" />
    </marker>
    <style>
      .frame { fill: #f6f9fc; stroke: #9fb0c2; stroke-width: 1.5; rx: 18; }
      .transfer { fill: #eef3f8; stroke: #9fb0c2; stroke-width: 1.5; rx: 18; }
      .node { fill: #365d84; stroke: #274867; stroke-width: 1.5; rx: 12; }
      .node-soft { fill: #56789b; stroke: #365d84; stroke-width: 1.5; rx: 12; }
      .title { font: 600 20px 'IBM Plex Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif; fill: #18212b; }
      .subtitle { font: 500 13px 'IBM Plex Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif; fill: #536171; }
      .label { font: 600 13px 'IBM Plex Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif; fill: #f8fbff; }
      .small { font: 500 12px 'IBM Plex Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif; fill: #f8fbff; }
      .flow { stroke: #365d84; stroke-width: 2.2; fill: none; marker-end: url(#arrow); }
      .flow-soft { stroke: #8da1b6; stroke-width: 1.9; fill: none; marker-end: url(#arrow-soft); stroke-dasharray: 6 5; }
      .caption { font: 600 12px 'IBM Plex Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif; fill: #536171; letter-spacing: 0.04em; text-transform: uppercase; }
    </style>
  </defs>
  <g transform="translate(14,16) scale(0.78)">
  <rect x="70" y="40" width="780" height="220" class="frame" />
  <text x="100" y="82" class="title">Level 0</text>
  <text x="100" y="106" class="subtitle">Pure inference / Artifact: none</text>
  <rect x="120" y="132" width="180" height="52" class="node" />
  <rect x="370" y="132" width="180" height="52" class="node" />
  <rect x="620" y="132" width="180" height="52" class="node" />
  <text x="210" y="163" text-anchor="middle" class="label">Inference</text>
  <text x="460" y="163" text-anchor="middle" class="label">Local usage</text>
  <text x="710" y="156" text-anchor="middle" class="label">Observed recurrence</text>
  <text x="710" y="172" text-anchor="middle" class="small">promotion candidate</text>
  <path d="M 300 158 H 370" class="flow" />
  <path d="M 550 158 H 620" class="flow" />
  <path d="M 710 184 V 214 H 210 V 184" class="flow-soft" />

  <rect x="140" y="300" width="640" height="150" class="transfer" />
  <text x="170" y="338" class="caption">Transfer between Level 0 and Level 1</text>
  <rect x="190" y="358" width="240" height="56" class="node" />
  <rect x="490" y="358" width="240" height="56" class="node-soft" />
  <text x="310" y="381" text-anchor="middle" class="label">Promotion mechanism</text>
  <text x="310" y="397" text-anchor="middle" class="small">capture -&gt; validate -&gt; retain</text>
  <text x="610" y="381" text-anchor="middle" class="label">Decay mechanism</text>
  <text x="610" y="397" text-anchor="middle" class="small">stop retaining -&gt; fall back</text>
  <path d="M 310 260 V 358" class="flow" />
  <path d="M 310 414 V 490" class="flow" />
  <path d="M 610 490 V 414" class="flow-soft" />
  <path d="M 610 358 V 260" class="flow-soft" />

  <rect x="70" y="490" width="780" height="220" class="frame" />
  <text x="100" y="532" class="title">Level 1</text>
  <text x="100" y="556" class="subtitle">Recognized pattern / Artifact: trace-backed observation</text>
  <rect x="120" y="582" width="180" height="52" class="node" />
  <rect x="370" y="582" width="180" height="52" class="node" />
  <rect x="620" y="582" width="180" height="52" class="node" />
  <text x="210" y="613" text-anchor="middle" class="label">Observation</text>
  <text x="460" y="606" text-anchor="middle" class="label">Reuse in</text>
  <text x="460" y="622" text-anchor="middle" class="label">similar cases</text>
  <text x="710" y="606" text-anchor="middle" class="label">Review for</text>
  <text x="710" y="622" text-anchor="middle" class="label">persistence</text>
  <path d="M 300 608 H 370" class="flow" />
  <path d="M 550 608 H 620" class="flow" />
  <path d="M 710 634 V 664 H 210 V 634" class="flow-soft" />

  <rect x="140" y="750" width="640" height="150" class="transfer" />
  <text x="170" y="788" class="caption">Transfer between Level 1 and Level 2</text>
  <rect x="190" y="808" width="240" height="56" class="node" />
  <rect x="490" y="808" width="240" height="56" class="node-soft" />
  <text x="310" y="831" text-anchor="middle" class="label">Promotion mechanism</text>
  <text x="310" y="847" text-anchor="middle" class="small">compile -&gt; validate -&gt; adopt locally</text>
  <text x="610" y="831" text-anchor="middle" class="label">Decay mechanism</text>
  <text x="610" y="847" text-anchor="middle" class="small">insufficient recurrence -&gt; observation</text>
  <path d="M 310 710 V 808" class="flow" />
  <path d="M 310 864 V 940" class="flow" />
  <path d="M 610 940 V 864" class="flow-soft" />
  <path d="M 610 808 V 710" class="flow-soft" />

  <rect x="70" y="940" width="780" height="220" class="frame" />
  <text x="100" y="982" class="title">Level 2</text>
  <text x="100" y="1006" class="subtitle">Local compilation / Artifact: explicit local rule</text>
  <rect x="120" y="1032" width="180" height="52" class="node" />
  <rect x="370" y="1032" width="180" height="52" class="node" />
  <rect x="620" y="1032" width="180" height="52" class="node" />
  <text x="210" y="1063" text-anchor="middle" class="label">Local rule</text>
  <text x="460" y="1056" text-anchor="middle" class="label">Routine local</text>
  <text x="460" y="1072" text-anchor="middle" class="label">execution</text>
  <text x="710" y="1056" text-anchor="middle" class="label">Review for</text>
  <text x="710" y="1072" text-anchor="middle" class="label">broader value</text>
  <path d="M 300 1058 H 370" class="flow" />
  <path d="M 550 1058 H 620" class="flow" />
  <path d="M 710 1084 V 1114 H 210 V 1084" class="flow-soft" />

  <rect x="140" y="1200" width="640" height="150" class="transfer" />
  <text x="170" y="1238" class="caption">Transfer between Level 2 and Level 3</text>
  <rect x="190" y="1258" width="240" height="56" class="node" />
  <rect x="490" y="1258" width="240" height="56" class="node-soft" />
  <text x="310" y="1281" text-anchor="middle" class="label">Promotion mechanism</text>
  <text x="310" y="1297" text-anchor="middle" class="small">proposal -&gt; validation -&gt; approval</text>
  <text x="610" y="1281" text-anchor="middle" class="label">Decay mechanism</text>
  <text x="610" y="1297" text-anchor="middle" class="small">downgrade -&gt; local rule</text>
  <path d="M 310 1160 V 1258" class="flow" />
  <path d="M 310 1314 V 1390" class="flow" />
  <path d="M 610 1390 V 1314" class="flow-soft" />
  <path d="M 610 1258 V 1160" class="flow-soft" />

  <rect x="70" y="1390" width="780" height="220" class="frame" />
  <text x="100" y="1432" class="title">Level 3</text>
  <text x="100" y="1456" class="subtitle">Shared convention / Artifact: promoted stable rule</text>
  <rect x="120" y="1482" width="180" height="52" class="node" />
  <rect x="370" y="1482" width="180" height="52" class="node" />
  <rect x="620" y="1482" width="180" height="52" class="node" />
  <text x="210" y="1513" text-anchor="middle" class="label">Shared rule</text>
  <text x="460" y="1506" text-anchor="middle" class="label">Shared use</text>
  <text x="460" y="1522" text-anchor="middle" class="label">across nodes</text>
  <text x="710" y="1506" text-anchor="middle" class="label">Review for</text>
  <text x="710" y="1522" text-anchor="middle" class="label">integration</text>
  <path d="M 300 1508 H 370" class="flow" />
  <path d="M 550 1508 H 620" class="flow" />
  <path d="M 710 1534 V 1564 H 210 V 1534" class="flow-soft" />

  <rect x="140" y="1650" width="640" height="150" class="transfer" />
  <text x="170" y="1688" class="caption">Transfer between Level 3 and Level 4</text>
  <rect x="190" y="1708" width="240" height="56" class="node" />
  <rect x="490" y="1708" width="240" height="56" class="node-soft" />
  <text x="310" y="1731" text-anchor="middle" class="label">Promotion mechanism</text>
  <text x="310" y="1747" text-anchor="middle" class="small">stabilize -&gt; implement -&gt; ship</text>
  <text x="610" y="1731" text-anchor="middle" class="label">Decay mechanism</text>
  <text x="610" y="1747" text-anchor="middle" class="small">withdraw -&gt; revert to shared rule</text>
  <path d="M 310 1610 V 1708" class="flow" />
  <path d="M 310 1764 V 1840" class="flow" />
  <path d="M 610 1840 V 1764" class="flow-soft" />
  <path d="M 610 1708 V 1610" class="flow-soft" />

  <rect x="70" y="1840" width="780" height="220" class="frame" />
  <text x="100" y="1882" class="title">Level 4</text>
  <text x="100" y="1906" class="subtitle">Native integration / Artifact: implementation primitive</text>
  <rect x="120" y="1932" width="180" height="52" class="node" />
  <rect x="370" y="1932" width="180" height="52" class="node" />
  <rect x="620" y="1932" width="180" height="52" class="node" />
  <text x="210" y="1956" text-anchor="middle" class="label">Implementation</text>
  <text x="210" y="1972" text-anchor="middle" class="label">primitive</text>
  <text x="460" y="1956" text-anchor="middle" class="label">Built-in</text>
  <text x="460" y="1972" text-anchor="middle" class="label">execution path</text>
  <text x="710" y="1956" text-anchor="middle" class="label">Review for</text>
  <text x="710" y="1972" text-anchor="middle" class="label">continued fitness</text>
  <path d="M 300 1958 H 370" class="flow" />
  <path d="M 550 1958 H 620" class="flow" />
  <path d="M 710 1984 V 2014 H 210 V 1984" class="flow-soft" />
</g>