How zeta92/atrezzo works
atrezzo turns a declared scenario into deterministic application state, serves contract-based API projections, and checks whether a flow renders the expected screen. Its CLI also supports importing API specs, harvesting observed app behavior, runtime generation, and diagnosing unresolved route gaps. The graph follows documented workflow and sampled dependency references; unsampled subsystems are represented only where the README or source index supports them.
Main entry points: cli.mjs CLI · serve.mjs Mock server · scenario.mjs Scenario model · world.mjs Seeded world
Components 21
Scenario authoring
- Scenario model
scripts/lib/scenario.mjs - YAML parser
scripts/lib/yaml.mjs - OpenAPI import
scripts/lib/openapi.mjs - App harvest
scripts/lib/harvest.mjs - Project config
scripts/lib/project.mjs
State and projection
- Seeded world
scripts/lib/world.mjs - Seeded random
scripts/lib/prng.mjs - Projection engine
scripts/lib/contract.mjs
Mock runtimes
- Runtime codegen
scripts/lib/codegen.mjs - Runtime registry
scripts/lib/runtimes/index.mjs - Runtime adapters
scripts/lib/runtimes - Mock server
scripts/lib/serve.mjs - Passthrough fixtures
scripts/lib/passthrough.mjs
Screen verification
- Verification flow
scripts/lib/flows.mjs - Screen verifier
scripts/lib/verify.mjs
Project operations
- Route gaps
scripts/lib/misses.mjs - Project doctor
scripts/lib/doctor.mjs - Request recording
scripts/lib/record.mjs
Other components
- Developer
- CLI
scripts/cli.mjs - Application screen
Connections 30
- Developer → CLI: runs commands
README.md - CLI → Scenario model: loads scenarios
scripts/cli.mjs - CLI → Seeded world: generates state
scripts/cli.mjs - CLI → Mock server: starts mock
scripts/cli.mjs - CLI → Screen verifier: runs checks
scripts/cli.mjs - CLI → OpenAPI import: imports specs
scripts/cli.mjs - CLI → App harvest: harvests app
scripts/cli.mjs - CLI → Runtime registry: selects runtimes
scripts/cli.mjs - CLI → Project config: reads config
scripts/cli.mjs - CLI → Project doctor: checks project
scripts/cli.mjs - CLI → Route gaps: lists gaps
scripts/cli.mjs - CLI → Request recording: records traffic
scripts/cli.mjs - Scenario model → YAML parser: parses input
scripts/lib/scenario.mjs - Scenario model → Seeded world: uses templates
scripts/lib/scenario.mjs - Scenario model → Passthrough fixtures: resolves fixtures
scripts/lib/scenario.mjs - Seeded world → Seeded random: seeds generation
scripts/lib/world.mjs - App harvest → Scenario model: normalizes scenario
scripts/lib/harvest.mjs - App harvest → Seeded world: generates sample state
scripts/lib/harvest.mjs - Mock server → Scenario model: loads scenario
scripts/lib/serve.mjs - Mock server → Seeded world: builds dataset
scripts/lib/serve.mjs - Mock server → Projection engine: handles requests
scripts/lib/serve.mjs - Mock server → Route gaps: records gaps
scripts/lib/serve.mjs - Runtime registry → Runtime adapters: dispatches adapters
scripts/lib/runtimes/index.mjs - Runtime adapters → Runtime codegen: generates handlers
scripts/lib/runtimes/msw.mjs - Screen verifier → Seeded world: resets expected state
scripts/lib/verify.mjs - Screen verifier → Application screen: checks rendered DOM
README.md - Application screen → Mock server: requests mock API
README.md - Screen verifier → Mock server: resets mock
scripts/lib/verify.mjs - Project doctor → Scenario model: checks scenario
scripts/lib/doctor.mjs - Project doctor → Seeded world: checks generated state
scripts/lib/doctor.mjs