Definitively (Mix app)

Copy Markdown

User documentation: Read the Book — the canonical guide for install, workspace setup, program authoring, and CLI usage.

This file covers Mix-specific contributor commands only.

Module layout

lib/definitively/
  outcome.ex           # NodeResult / status
  workflow/engine.ex     # gen_statem FSM
  nodes/                 # CLI and LLM evaluators
  init.ex                # .definitively/ scaffold
  visualize.ex           # Graphviz graphs
  cli.ex                 # escript + Mix task entry

Mix commands

cd definitively
mix test
mix format
mix docs                  # API docs → doc/index.html
mix definitively run ../.definitively/programs/example.yml
mix escript.build         # local escript

Quality gates

From repo root in devenv:

moon run definitively:lint definitively:doctor definitively:test definitively:docs definitively:build

See Developing definitively in the book.