runner

sqllocks_spindle.packs.runner

Orchestrate complete scenario pack execution.

Classes

RunResult dataclass

Result of a complete scenario pack execution.

PackRunner

Orchestrate a complete scenario pack execution.

Steps

1. Validate pack against domain schema
2. Generate base data via Spindle engine
3. Run simulation (file_drop / stream / hybrid)
4. Validate outputs against gates
5. Emit run manifest

Methods:

run(pack, domain, scale='small', seed=42, base_path='.')

Execute a scenario pack end-to-end.

Parameters:

Name	Type	Description	Default
pack	ScenarioPack	The ScenarioPack to execute.	required
domain	Any	A Domain instance whose schema drives generation.	required
scale	str	Scale preset (small, medium, large, xlarge).	'small'
seed	int	Random seed for reproducibility.	42
base_path	str	Root directory for output files.	'.'

Returns:

Type	Description
RunResult	RunResult with manifest, files written, and validation outcomes.