brushline.integrations.freshforge
The Brushline FreshForge provider: metadata, node validation, command builders, and execution results.
FreshForge provider for the Brushline instance stages.
The provider declares six node types and runs them through the brushline instance CLI. It is
stateless: validation and planning are non-mutating, and execution only happens when FreshForge
calls run_node.
- class brushline.integrations.freshforge.BrushlineFreshForgeProvider(command_runner: Callable[[tuple[str, ...]], CompletedProcess[str]] | None = None)[source]
Bases:
objectFreshForge provider for the Brushline instance stages.
- metadata() ProviderMetadata[source]
Return the provider metadata and six node types.
- Returns:
ProviderMetadata – Provider id, version, and node contracts.
- validate_node(node: WorkflowNode, node_type: NodeTypeMetadata, *, location: str) tuple[Diagnostic, ...][source]
Validate one Brushline node without executing it.
- Parameters:
node (freshforge.records.WorkflowNode) – Workflow node.
node_type (NodeTypeMetadata) – Provider node metadata.
location (str) – Workflow location for diagnostics.
- Returns:
tuple of Diagnostic – Missing input, output, parameter, or artifact findings.
- run_node(node: WorkflowNode, node_type: NodeTypeMetadata, *, context: RunContext) ProviderRunResult[source]
Execute one Brushline node through the Brushline CLI.
- Parameters:
node (freshforge.records.WorkflowNode) – Workflow node.
node_type (NodeTypeMetadata) – Provider node metadata.
context (freshforge.execution.RunContext) – FreshForge run context.
- Returns:
ProviderRunResult – The command result, outputs, artifacts, and diagnostics.
- brushline.integrations.freshforge.provider_factory() BrushlineFreshForgeProvider[source]
Return the Brushline provider for FreshForge entry-point discovery.
- Returns:
BrushlineFreshForgeProvider – A stateless provider instance.