Brushline FreshForge provider
The Brushline provider exposes the instance stages to FreshForge. It is optional and stateless:
validation and planning do not mutate the instance, and execution only happens when FreshForge calls
run_node.
Install
python -m pip install -e ".[freshforge]"
The provider is registered under the freshforge.providers entry-point group:
[project.entry-points."freshforge.providers"]
brushline = "brushline.integrations.freshforge:provider_factory"
Provider id: brushline.
Nodes
Node |
Inputs |
Outputs |
Parameters |
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Each node also declares one artifact key matching its output. The provider resolves each artifact path against the FreshForge run context.
Execution
Each node builds a python -m brushline instance ... command:
brushline instance validate-aoi --aoi <path> --out <dir>
brushline instance segment-corridor --corridor <path> --out <dir>
brushline instance compile-dataset --fixture <path> --out <dir> [--force]
brushline instance seed-state --state <path> --out <dir>
brushline instance validate-scenario --scenario <path> --targets <path> --out <dir>
brushline instance build-demo --demo <path> --out <dir>
The stage commands are thin. P2.7 replaces the map-to-instance orchestration, and P3/P5 replace the state seeding and scenario validation with the real models. The provider always calls the CLI; it does not reimplement the stage.
Validation
validate_node reports a named diagnostic for every missing input, output, parameter, or artifact:
brushline.validation.inputs.missingbrushline.validation.outputs.missingbrushline.validation.parameters.missingbrushline.validation.artifacts.missing
Execution failures use:
brushline.execution.parameters.invalidfor a missing parameter,brushline.execution.command.failedfor a non-zero command,brushline.execution.unsupportedfor an unknown node type.
Offline use
The provider accepts a command runner, so tests can exercise the metadata, validation, command building, and result handling without a live FreshForge run:
from brushline.integrations.freshforge import BrushlineFreshForgeProvider
provider = BrushlineFreshForgeProvider(my_runner)
assert provider.metadata().id == "brushline"
The test suite uses this hook for every node and for the success, failure, missing-parameter, and unknown-node paths.