How candavere/lattice works
Lattice is a deterministic, partially observable multi-agent research environment; its agents are evaluation subjects, not the product. The main workflow is to run a seeded simulation, record its steps, then verify, render, analyze, or replay that recording. Separate evaluation and benchmarking workflows produce evaluation and throughput artifacts; evaluation can seat an external process through the wire protocol. The README documents these command paths and major capabilities. Sampled source confirms simulation, policy, replay, protocol, and rendering behavior; links for unsampled subsystems rely on the README, so uncertain internal call wiring is omitted.
Main entry points: CliApp.cs Command App · ScenarioRunner.cs Scenario Runner · PairedEvaluation.cs Paired Evaluation · ExternalAgent.cs External Agent
Components 22
Simulation Runtime
- Map Generation
Generator/MapGenerator.cs - Map And Rules
Environment/MapData.cs - Step Simulation
Environment/Simulation.cs
Agents And Evaluation
- Agent Policies
Agents/AgentFactories.cs - Scenario Runner
Agents/ScenarioRunner.cs - Paired Evaluation
Agents/PairedEvaluation.cs - Benchmarking
Analytics/Benchmarking/BenchmarkHarness.cs - External Agent
Agents/External/ExternalAgent.cs - Evaluation Artifact
Cli/JsonArtifact.cs - Throughput Artifact
Analytics/Benchmarking/BenchmarkReport.cs
Trajectory Records
- Trajectory Writer
Trajectories/TrajectoryWriter.cs - JSONL Recording
Trajectories/TrajectoryModel.cs - Trajectory Reader
Trajectories/TrajectoryReader.cs - Replay Verification
Trajectories/TrajectoryReplay.cs
Analysis And Views
- Trajectory Analysis
Analytics/TrajectoryAnalyzer.cs - Analysis Report
Analytics/ReportGenerator.cs - Trajectory Rendering
Visualization/SvgTrajectoryExporter.cs - Browser Viewer
site/app.js
CLI And Protocol
- Command App
Cli/CliApp.cs - Wire Protocol
Protocol/ProtocolParser.cs
Other components
- Researcher
- Agent Process
Connections 27
- Researcher → Command App: runs commands
- Command App → Map Generation: generates maps
- Map Generation → Map And Rules: provides map
- Command App → Scenario Runner: runs simulation
- Scenario Runner → Step Simulation: steps state
- Scenario Runner → Agent Policies: requests actions
- Agent Policies → Step Simulation: returns actions
- Scenario Runner → Trajectory Writer: records run
- Trajectory Writer → JSONL Recording: writes JSONL
- Command App → Trajectory Reader: loads recording
- Trajectory Reader → JSONL Recording: reads JSONL
- Command App → Replay Verification: verifies replay
- Replay Verification → Step Simulation: recomputes steps
- Command App → Trajectory Rendering: renders recording
- Command App → Trajectory Analysis: analyzes recording
- Trajectory Analysis → Analysis Report: feeds report
- Researcher → Browser Viewer: opens viewer
- Browser Viewer → JSONL Recording: reads recording
- Command App → Paired Evaluation: runs evaluation
- Paired Evaluation → Scenario Runner: runs paired scenarios
- Paired Evaluation → Evaluation Artifact: writes result
- Command App → Benchmarking: runs benchmark
- Benchmarking → Throughput Artifact: writes metrics
- Paired Evaluation → External Agent: seats candidate
- External Agent → Wire Protocol: exchanges messages
- External Agent → Agent Process: launches process
- Agent Process → Wire Protocol: speaks protocol