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: BaseModel

A complete synthetic tactical/operational case.

Parameters:
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: BaseModel

Tactical/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: BaseModel

One 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:
Returns:

Path – Written path.