How simonbouhier/epp_verdict works
EPP combines multi-model deliberation and evidence-backed attestations with a read-only dashboard for historical runs. The principal workflow explores a claim, aggregates extracted triplets into consensus, crystallizes results as attestations, and stores them. Separate branches cover deterministic source anchoring, contract auditing, and governance; blockchain publication is retired, though an on-chain archive and Solana client remain. The excerpts document the ESMM pipeline and some storage and provider behavior; links between unsampled API, audit, and governance modules are therefore kept conservative.
Main entry points: pipeline.py ESMM pipeline · engine.py EPP database · orchestrator.py Run orchestrator · cycle_manager.py Exploration cycles
Components 21
Deliberation
- ESMM pipeline
services/esmm/pipeline.py - Run orchestrator
services/esmm/orchestrator.py - Exploration cycles
services/esmm/cycle_manager.py - Model rotation
services/esmm/model_rotator.py - Model providers
services/providers - Triplet consensus
services/esmm/consensus_engine.py
Evidence and storage
- Attestation pipeline
services/esmm/pipeline.py - Source adapters
services/sources/adapters - EPP database
database/engine.py
Interfaces and archive
- API routes
app/api - Historical dashboard
ui/src/App.tsx - Archive pages
ui/src/routes - Run data loader
ui/src/data/loader.ts
Auditing and integrations
- Contract auditing
services/audit - Governance proposals
services/governance/proposal.py - Solana client
services/solana/client.py
Other components
- Claim submitter
- Model service
- SQLite
- Solana devnet
- Historical run data
Connections 18
- Claim submitter → API routes: submits claims
- API routes → ESMM pipeline: dispatches runs
- ESMM pipeline → Run orchestrator: starts run
- Run orchestrator → Exploration cycles: manages cycles
- Exploration cycles → Model rotation: requests model responses
- Model rotation → Model providers: selects provider
- Model providers → Model service: requests inference
- Run orchestrator → Triplet consensus: aggregates triplets
- ESMM pipeline → Source adapters: fetches source evidence
- ESMM pipeline → Attestation pipeline: crystallizes results
- Attestation pipeline → EPP database: stores attestations
- EPP database → SQLite: reads and writes
- Contract auditing → EPP database: uses stored data
- Governance proposals → EPP database: uses stored data
- Solana client → Solana devnet: submits and queries
- Historical dashboard → Archive pages: routes visitors
- Archive pages → Run data loader: loads archive data
- Run data loader → Historical run data: reads historical runs