# romeojulietlove/crsu-x-romeo-juliet-hackathon architecture

> Architecture diagram of the GitHub repository romeojulietlove/crsu-x-romeo-juliet-hackathon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/romeojulietlove/crsu-x-romeo-juliet-hackathon
- Repository: https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon

## Overview

This repository is a synthetic sequential-introduction policy challenge kit, not a live matchmaking service. A policy receives observable simulator state, may ask for missing constraint information, then proposes pairs; the evaluator runs those decisions across scenario variants and scores outcomes. Its core runtime is the simulator and reciprocal eligibility logic, with separate branches for reference policies, public snapshot generation, and organiser assessment. The graph follows shown calls and README-described capabilities; it does not imply that the supplied snapshot files feed evaluation automatically.

Main entry points: [`organise.py`](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/organise.py) (Private grading), [`evaluate.py`](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/evaluate.py) (Episode evaluator), [`build_public_data.py`](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/build_public_data.py) (Snapshot builder), [`policy.py`](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/policy.py) (Reference policy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation"]
  node_world_generator["World generator<br/>[kit.py]"]
  node_eligibility["Reciprocal eligibility<br/>[kit.py]"]
  node_simulator["Episode simulator<br/>[kit.py]"]
end

subgraph group_policy["Policy"]
  node_reference_policy["Reference policy<br/>[policy.py]"]
  node_policy_helpers["Baseline decisions<br/>[kit.py]"]
  node_policy_process["Policy process<br/>[policy.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_evaluator["Episode evaluator<br/>[evaluate.py]"]
  node_scoring["Scenario scoring<br/>[evaluate.py]"]
  node_private_worlds["Private worlds<br/>[organise.py]"]
  node_organiser_grading["Private grading<br/>[organise.py]"]
end

subgraph group_data["Synthetic Data"]
  node_snapshot_builder["Snapshot builder"]
  node_public_snapshots["Public snapshots"]
end

node_participant(("Policy author"))
node_organiser(("Organiser"))

node_participant -->|"edits"| node_reference_policy
node_reference_policy -->|"uses baselines"| node_policy_helpers
node_reference_policy -->|"checks pairs"| node_eligibility
node_evaluator -->|"runs episodes"| node_simulator
node_evaluator -->|"creates worlds"| node_world_generator
node_evaluator -->|"invokes policy"| node_policy_process
node_evaluator -->|"summarises results"| node_scoring
node_simulator -->|"checks assignments"| node_eligibility
node_snapshot_builder -->|"generates pools"| node_world_generator
node_snapshot_builder -->|"runs rollout"| node_simulator
node_snapshot_builder -->|"writes snapshots"| node_public_snapshots
node_organiser -->|"prepares assessment"| node_organiser_grading
node_organiser_grading -->|"creates worlds"| node_private_worlds
node_organiser_grading -->|"generates worlds"| node_world_generator
node_organiser_grading -->|"grades episodes"| node_evaluator
node_organiser_grading -->|"summarises results"| node_scoring

click node_world_generator "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py"
click node_eligibility "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py"
click node_simulator "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py"
click node_reference_policy "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/policy.py"
click node_policy_helpers "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py"
click node_evaluator "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/evaluate.py"
click node_policy_process "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/policy.py"
click node_scoring "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/evaluate.py"
click node_private_worlds "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/organise.py"
click node_organiser_grading "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/organise.py"
click node_snapshot_builder "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/build_public_data.py"
click node_public_snapshots "https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/tree/main/data"

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_world_generator,node_eligibility,node_simulator toneBlue
class node_reference_policy,node_policy_helpers,node_policy_process toneAmber
class node_evaluator,node_scoring,node_private_worlds,node_organiser_grading toneMint
class node_snapshot_builder,node_public_snapshots toneRose
class node_participant,node_organiser toneIndigo
```

## Components

### Simulation

- [World generator](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py): `kit.py`
- [Reciprocal eligibility](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py): `kit.py`
- [Episode simulator](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py): `kit.py`

### Policy

- [Reference policy](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/policy.py): `policy.py`
- [Baseline decisions](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/kit.py): `kit.py`
- [Policy process](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/policy.py): `policy.py`

### Evaluation

- [Episode evaluator](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/evaluate.py): `evaluate.py`
- [Scenario scoring](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/evaluate.py): `evaluate.py`
- [Private worlds](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/organise.py): `organise.py`
- [Private grading](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/organise.py): `organise.py`

### Synthetic Data

- [Snapshot builder](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/blob/main/build_public_data.py): `build_public_data.py`
- [Public snapshots](https://github.com/romeojulietlove/crsu-x-romeo-juliet-hackathon/tree/main/data): `data`

### Other components

- **Policy author**
- **Organiser**

## Connections

- Policy author → Reference policy: edits (evidence: `README.md`)
- Reference policy → Baseline decisions: uses baselines (evidence: `policy.py`)
- Reference policy → Reciprocal eligibility: checks pairs (evidence: `policy.py`)
- Episode evaluator → Episode simulator: runs episodes (evidence: `evaluate.py`)
- Episode evaluator → World generator: creates worlds (evidence: `evaluate.py`)
- Episode evaluator → Policy process: invokes policy (evidence: `evaluate.py`)
- Episode evaluator → Scenario scoring: summarises results (evidence: `evaluate.py`)
- Episode simulator → Reciprocal eligibility: checks assignments (evidence: `kit.py`)
- Snapshot builder → World generator: generates pools (evidence: `build_public_data.py`)
- Snapshot builder → Episode simulator: runs rollout (evidence: `build_public_data.py`)
- Snapshot builder → Public snapshots: writes snapshots (evidence: `build_public_data.py`)
- Organiser → Private grading: prepares assessment (evidence: `organise.py`)
- Private grading → Private worlds: creates worlds (evidence: `organise.py`)
- Private grading → World generator: generates worlds (evidence: `organise.py`)
- Private grading → Episode evaluator: grades episodes (evidence: `organise.py`)
- Private grading → Scenario scoring: summarises results (evidence: `organise.py`)
