How antithesishq/bombadil works
Bombadil is a property-based testing system for web and terminal UIs. Its core workflow is to load a user specification, explore generated actions against a UI, evaluate correctness properties, and produce traces for review; failing traces can also be shrunk. The README documents browser and terminal testing and Antithesis execution. The graph preserves those product areas, but many cross-crate calls are not shown in the sampled source, so unverified connections are dashed rather than asserted.
Main entry points: runner.rs Exploration runner · browser.rs Browser control · verifier.rs Property verification · main.rs Command-line interface
Components 29
Specifications and properties
- Specification loading
lib/bombadil/src/specification/bundler/mod.rs - Property verification
lib/bombadil/src/specification/verifier.rs - Temporal property evaluation
lib/bombadil-ltl/src/eval.rs
Exploration runtime
- Command-line interface
lib/bombadil-cli/src/main.rs - Exploration runner
lib/bombadil/src/runner.rs - Action generation
lib/bombadil/src/model.rs - Trace shrinking
lib/bombadil/src/shrink/mod.rs
UI adapters
- Browser control
lib/bombadil-browser/src/browser.rs - Browser actions
lib/bombadil-browser/src/browser/actions.rs - Browser state
lib/bombadil-browser/src/browser/state.rs - Cookie handling
lib/bombadil-browser/src/cookie.rs - JavaScript instrumentation
lib/bombadil-browser/src/instrumentation/js.rs - Instrumentation IDs
lib/bombadil-browser/src/instrumentation/source_id.rs - Terminal driver
lib/bombadil-terminal/src/driver.rs - PTY session
lib/bombadil-terminal/src/pty.rs - Terminal extraction
lib/bombadil-terminal/src/extractors.rs - Chrome DevTools transport
lib/cdp/src/conn.rs
Traces and review
- Trace writing
lib/bombadil-trace/src/writer.rs - Trace reading
lib/bombadil-trace/src/reader.rs - Trace records
lib/bombadil-trace/src/record.rs - Trace envelope
lib/bombadil-trace/src/envelope.rs - Trace inspection UI
lib/bombadil-inspect/src/lib.rs - Trace timeline
lib/bombadil-inspect/src/timeline.rs - Inspector actions
lib/bombadil-inspect/src/actions.rs - Timeline sizing
lib/bombadil-inspect/src/container_size.rs - Timeline scrolling
lib/bombadil-inspect/src/list_autoscroll.rs
Execution integrations
- Antithesis execution
lib/antithesis-fuzzer/src/lib.rs
Other components
- Developer
- Trace API
Connections 27
- Developer → Command-line interface: starts runs
- Command-line interface → Specification loading: loads spec
- Specification loading → Property verification: provides properties
- Property verification → Temporal property evaluation: evaluates formulas
- Exploration runner → Action generation: requests actions
- Exploration runner → Property verification: checks properties
- Exploration runner → Browser control: drives browser
- Exploration runner → Terminal driver: drives terminal
- Browser control → Browser actions: dispatches actions
lib/bombadil-browser/src/browser.rs - Browser control → Browser state: captures state
lib/bombadil-browser/src/browser.rs - Browser control → Cookie handling: configures cookies
lib/bombadil-browser/src/browser.rs - Browser state → JavaScript instrumentation: uses instrumentation
lib/bombadil-browser/src/browser/state.rs - JavaScript instrumentation → Instrumentation IDs: uses source IDs
lib/bombadil-browser/src/instrumentation/js.rs - Browser control → Chrome DevTools transport: sends commands
- Terminal driver → PTY session: uses PTY
lib/bombadil-terminal/src/driver.rs - Terminal driver → Terminal extraction: extracts state
lib/bombadil-terminal/src/driver.rs - Exploration runner → Trace writing: records run
- Trace shrinking → Property verification: tests candidates
- Trace writing → Trace records: writes records
lib/bombadil-trace/src/writer.rs - Trace writing → Trace envelope: writes envelope
lib/bombadil-trace/src/writer.rs - Trace API → Trace inspection UI: serves trace
lib/bombadil-inspect/src/lib.rs - Trace inspection UI → Trace timeline: renders timeline
lib/bombadil-inspect/src/lib.rs - Trace inspection UI → Inspector actions: renders actions
lib/bombadil-inspect/src/lib.rs - Inspector actions → Timeline sizing: uses sizing
lib/bombadil-inspect/src/actions.rs - Inspector actions → Timeline scrolling: uses scrolling
lib/bombadil-inspect/src/actions.rs - Trace reading → Trace records: reads records
- Command-line interface → Antithesis execution: runs under