brushline.tactical.validation
The synthetic tactical/operational case, named checks, result, writer, and loader.
Synthetic tactical/operational validation.
- class brushline.tactical.validation.SyntheticCase(*, program: TacticalProgram, access: AccessPlan, resources: ResourcePlan, operations: OperationsPlan, fhops: FhopsResult, timeline: OperationsTimeline, validation: TacticalValidationResult)[source]
Bases:
BaseModelA complete synthetic tactical/operational case.
- Parameters:
program (TacticalProgram) – Tactical program.
access (AccessPlan) – Access plan.
resources (ResourcePlan) – Resource plan.
operations (OperationsPlan) – Operations plan.
fhops (FhopsResult) – Dry-run FHOPS result.
timeline (OperationsTimeline) – Timeline.
validation (TacticalValidationResult) – Validation result.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.tactical.validation.TacticalValidationResult(*, schema_version: Literal['brushline.tactical-validation.v1'] = 'brushline.tactical-validation.v1', instance_id: str, program_id: str, operations_id: str, timeline_id: str, checks: Annotated[list[ValidationCheck], MinLen(min_length=1)], passed: bool, created_utc: datetime)[source]
Bases:
BaseModelTactical/operational validation result.
- Parameters:
schema_version ({"brushline.tactical-validation.v1"}) – Schema version.
instance_id (str) – Instance id.
program_id (str) – Program id.
operations_id (str) – Operations plan id.
timeline_id (str) – Timeline id.
checks (list of ValidationCheck) – Checks.
passed (bool) – All checks pass.
created_utc (datetime) – Timezone-aware time.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.tactical.validation.ValidationCheck(*, code: Annotated[str, MinLen(min_length=1)], passed: bool, detail: str = '')[source]
Bases:
BaseModelOne named validation check.
- Parameters:
code (str) – Code.
passed (bool) – Result.
detail (str) – Explanation.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- brushline.tactical.validation.build_synthetic_case(created_utc: datetime | None = None) SyntheticCase[source]
Build and validate a deterministic synthetic tactical/operational case.
- Parameters:
created_utc (datetime, optional) – Creation time.
- Returns:
SyntheticCase – Program, access, resources, operations, dry-run, timeline, and validation.
- brushline.tactical.validation.load_validation(path: str | Path) TacticalValidationResult[source]
Load a validation result.
- Parameters:
path (str or Path) – Source.
- Returns:
TacticalValidationResult – Result.
- brushline.tactical.validation.write_validation(result: TacticalValidationResult, path: str | Path) Path[source]
Write a validation result.
- Parameters:
result (TacticalValidationResult) – Result.
path (str or Path) – Destination.
- Returns:
Path – Written path.