API Reference definitively v#0.2.0

Copy Markdown

Modules

FSM-based CLI/LLM workflow definitively.

OTP application for the definitively supervision tree.

Command-line interface for workflow runs and program visualization.

Reusable node (CLI or LLM) referenced by active states.

Per-node outcome rules from YAML; classifies RawResult into Outcome.

Medium DSL predicate clauses from YAML outcome rules.

Immutable workflow definition loaded from YAML.

Uninterpreted output from a node executor (phase 3+).

One FSM state from a workflow program.

Pure transition lookup built from a program's states.*.on maps.

Scaffolds a .definitively/ workspace by copying packaged templates from priv/.

Structured logging for the definitively.

Runs CLI nodes with live stdout/stderr streaming and captured output.

Behaviour for running a workflow node and returning a RawResult.

Selects the executor module for a node definition.

Runs LLM nodes by invoking a configurable runner and parsing a JSON envelope.

Runs a subprocess with stdout/stderr streamed to the terminal and captured for callers.

Rich outcome for workflow nodes (CLI, LLM, git, …).

Boundary: classify RawResult using a node's outcome rules.

Application facade for starting and controlling ephemeral workflow runs.

Read-only view of a workflow run for CLI/MCP status queries.

Structured error from spec load or validation.

Load YAML workflow programs into Definitively.Domain.Program.

Cross-checks on a loaded Program before execution.

Renders workflow programs as Graphviz graphs via Graphvix.

Data-driven workflow runner as :gen_statem.

Ephemeral context passed to node executors for a single run.

Resolves an absolute program path and workspace root from a workflow YAML file.

Mix Tasks

Mix task that delegates to Definitively.CLI.