How afnan-0206/isocheck works
IsoCheck checks client-observed transaction histories for isolation anomalies. In the principal workflow, concurrent workload clients generate list-append transactions against PostgreSQL; the runner records invoke/completion events as JSONL, and the CLI parses a history and asks the checker to infer version orders, construct dependency graphs, and report anomaly witnesses. The harness also supports seeded acceptance campaigns and a buggy-database control. Core analysis and harness links are grounded in excerpts or README statements; unsampled campaign internals are not expanded beyond documented links.
Main entry points: checker.cpp Anomaly Checker · runner.py History Runner · main.cpp Checker CLI · run_campaign.py Acceptance Campaign
Components 14
Workload Harness
- Workload Generator
harness/workload.py - History Runner
harness/runner.py - PostgreSQL Harness
harness/postgres.py - Acceptance Campaign
harness/run_campaign.py - Buggy Control Runner
harness/buggy_runner.py
History Analysis
- History Parsing
core/src/history.cpp - Anomaly Checker
core/src/checker.cpp - Version Inference
core/src/version_order.cpp
Dependency Analysis
- Graph Construction
core/src/checker.cpp - Cycle Search
core/src/graph.cpp
Results
- Checker CLI
cli/main.cpp - Verdict Output
cli/main.cpp
Other components
- Operator
- PostgreSQL
Connections 19
- Operator → Acceptance Campaign: starts campaign
README.md - Operator → History Runner: runs workload
README.md - Workload Generator → History Runner: supplies templates
harness/runner.py - History Runner → PostgreSQL Harness: executes transactions
harness/runner.py - PostgreSQL Harness → PostgreSQL: runs SQL
harness/postgres.py - History Runner → Checker CLI: invokes checker
harness/runner.py - Acceptance Campaign → Checker CLI: checks histories
harness/run_campaign.py - Acceptance Campaign → History Runner: runs workload
harness/run_campaign.py - Buggy Control Runner → Checker CLI: runs checker
README.md - Checker CLI → History Parsing: parses history
cli/main.cpp - Checker CLI → Anomaly Checker: checks history
cli/main.cpp - Anomaly Checker → History Parsing: extracts transactions
- Anomaly Checker → Version Inference: infers versions
- Anomaly Checker → Graph Construction: builds graph
core/src/checker.cpp - Anomaly Checker → Cycle Search: finds cycles
- Graph Construction → Version Inference: uses version orders
- Cycle Search → Graph Construction: searches graph
- Anomaly Checker → Verdict Output: returns verdict
- Verdict Output → Operator: shows result
cli/main.cpp