# probablyapigeon/sybiosisxp architecture

> Architecture diagram of the GitHub repository probablyapigeon/sybiosisxp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/probablyapigeon/sybiosisxp
- Repository: https://github.com/probablyapigeon/sybiosisxp

## Overview

This repository is a bounded, deterministic agreement-following experiment—not the production XEMBRA engine. Its workflow is to load fixed cases, run each handcrafted policy through the shared parser and agent state transitions, compare traces with expected outcomes, check explanation claims, and write JSON and Markdown results. The README documents protocol constraints and interpretation; their runtime wiring is not established by the sampled source.

Main entry points: [`experiment.py`](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py) (CLI runner), [`cases.json`](https://github.com/probablyapigeon/sybiosisxp/blob/main/cases.json) (Case fixture), [`results/report.json`](https://github.com/probablyapigeon/sybiosisxp/blob/main/results/report.json) (JSON report), [`results/RESULTS.md`](https://github.com/probablyapigeon/sybiosisxp/blob/main/results/RESULTS.md) (Results summary)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation"]
  node_cases["Case fixture<br/>[cases.json]"]
  node_parser["Request parser<br/>[experiment.py]"]
  node_agent["Agreement agent<br/>[experiment.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_evaluator["Case evaluator<br/>[experiment.py]"]
  node_checker["Explanation checker<br/>[experiment.py]"]
end

subgraph group_reporting["Reporting"]
  node_runner["CLI runner<br/>[experiment.py]"]
  node_formatter["Markdown formatter<br/>[experiment.py]"]
  node_json_report["JSON report<br/>[report.json]"]
  node_markdown_report["Results summary<br/>[RESULTS.md]"]
end

node_operator(("Experiment operator"))

node_operator -->|"runs"| node_runner
node_runner -->|"calls"| node_evaluator
node_evaluator -->|"reads"| node_cases
node_evaluator -->|"steps policies"| node_agent
node_agent -->|"parses requests"| node_parser
node_evaluator -->|"checks claims"| node_checker
node_runner -->|"formats report"| node_formatter
node_runner -->|"writes"| node_json_report
node_runner -->|"writes"| node_markdown_report

click node_runner "https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py"
click node_cases "https://github.com/probablyapigeon/sybiosisxp/blob/main/cases.json"
click node_parser "https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py"
click node_agent "https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py"
click node_evaluator "https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py"
click node_checker "https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py"
click node_formatter "https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py"
click node_json_report "https://github.com/probablyapigeon/sybiosisxp/blob/main/results/report.json"
click node_markdown_report "https://github.com/probablyapigeon/sybiosisxp/blob/main/results/RESULTS.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cases,node_parser,node_agent toneBlue
class node_evaluator,node_checker toneAmber
class node_runner,node_formatter,node_json_report,node_markdown_report toneMint
class node_operator toneIndigo
```

## Components

### Simulation

- [Case fixture](https://github.com/probablyapigeon/sybiosisxp/blob/main/cases.json): `cases.json`
- [Request parser](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py): `experiment.py`
- [Agreement agent](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py): `experiment.py`

### Evaluation

- [Case evaluator](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py): `experiment.py`
- [Explanation checker](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py): `experiment.py`

### Reporting

- [CLI runner](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py): `experiment.py`
- [Markdown formatter](https://github.com/probablyapigeon/sybiosisxp/blob/main/experiment.py): `experiment.py`
- [JSON report](https://github.com/probablyapigeon/sybiosisxp/blob/main/results/report.json): `results/report.json`
- [Results summary](https://github.com/probablyapigeon/sybiosisxp/blob/main/results/RESULTS.md): `results/RESULTS.md`

### Other components

- **Experiment operator**

## Connections

- Experiment operator → CLI runner: runs
- CLI runner → Case evaluator: calls
- Case evaluator → Case fixture: reads
- Case evaluator → Agreement agent: steps policies
- Agreement agent → Request parser: parses requests
- Case evaluator → Explanation checker: checks claims
- CLI runner → Markdown formatter: formats report
- CLI runner → JSON report: writes
- CLI runner → Results summary: writes