API Reference definitively v#0.5.0

FSM-based CLI/LLM workflow definitively.

Builds subprocess argv from an agent profile, node, and prompt.

Load YAML agent profiles from .definitively/agents/.

Parses LLM subprocess stdout using agent profile output config.

OTP application for the definitively supervision tree.

Command-line interface for workflow runs and program visualization.

Parses CLI flags for declared program inputs.

YAML agent profile for LLM node subprocess invocation.

Pure gh argv builders and result parsers for GitHub CLI nodes.

Pure git argv builders and result parsers for git nodes.

Pure maestro argv builders and result parsers for maestro nodes.

Reusable node 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.

Declarative CLI input for a workflow program.

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.

Structured logging for the definitively.

MCP-style tool surface over Definitively.Run.Coordinator and Definitively.Visualize.

Boots the Hermes MCP stdio transport for IDE hosts (Cursor, Claude Desktop, etc.).

MCP stdio server exposing definitively workflow tools to Cursor and other hosts.

Read/write maestro run context under .definitively/state/.

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

Shared subprocess runner for structured git/gh node executors.

Behaviour for running a workflow node and returning a RawResult.

Selects the executor module for a node definition.

Runs GitHub CLI nodes with structured actions and parsed outcomes.

Runs git nodes with structured actions and parsed outcomes.

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

Runs Maestro harness CLI nodes with structured actions and parsed outcomes.

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.

Schema validation for loaded agent profiles.

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 task that delegates to Definitively.CLI.