FLITFLOW CORE SPECIFICATION
FlitFlow is a language-independent specification for executing AST-defined workflows safely. Undefined function calls and invalid access never crash the runtime — they're logged and execution continues. Today, it's implemented by the official Python runtime.
Step Execution Pipeline — SPEC 1.2.3
SPEC × RUNTIME
FlitFlow is defined as a common specification, independent of any single language. The Python runtime is one official implementation that conforms to it. The same AST script produces the same result on any implementation that follows the spec.
CORE GUARANTEES
Every conforming implementation is required to hold these.
Undefined function calls and invalid type operations never crash the runtime. Abnormal conditions are logged and execution continues safely.
args are pre-evaluated, params are passed through as deferred blocks,
and results are automatically bound to target_variable.
RETURN, BREAK, and CONTINUE are structured signals, not
exceptions — consumed at well-defined boundaries.
Out-of-bounds access and unresolved branches resolve exactly as the spec defines — to
NULL or a warning log, with no guesswork.
QUICK LOOK
Full usage is covered in the documentation. This is just the shape of it.
# 1. Define a workflow as an AST ast = { "main": [ { "function": "set_variables", "args": { "message": "Hello, FlitFlow!" } } ] } # 2. Validate against the spec, then run it engine = RuntimeEngine(ast) register_builtin_functions(engine) state = {} result = engine.run(state) print(state["message"]) # Hello, FlitFlow! print(result.status) # Status.SUCCESS
SPEC COMPLIANCE
FlitFlow treats compatibility as something to prove, not promise.
USE CASES
Approval chains, batch jobs, and business logic you'd rather declare as an AST than hand-code.
Flows assembled visually in a builder, run by an engine that won't crash on a bad configuration.
Wrap API calls or database access as custom functions and wire them safely into a flow.
Any runtime that conforms to the same spec produces the same behavior, now or after a migration.
ROADMAP
Always Safe execution, the unified pipeline, and the core control signals were defined.
Boolean normalization in switch, shallow-copied nested state, and out-of-loop signal
handling were made explicit.
A built-in for updating root-level state across nested scopes. Supported by the current Python runtime.
Because the spec is language-independent, conforming implementations in TypeScript, Go, or elsewhere are open for anyone to build.
SPEC.md and core_schema.json in FlitFlow-Core-Spec are the source of truth for every behavior described here.