Changelog

Unreleased

#255 Added SYNTH_FORCE_TERMINAL environment variable to force Rich terminal formatting on (true) or off (false), overriding auto-detection. See the Environment Variables page.
#255 When no flow is specified, the default flow is selected by precedence: the flow named by settings.default_flow (if explicitly set), then a flow named default (if present), then the first-defined flow. If settings.default_flow is set but names a non-existent flow, synth run and synth diagram exit with an error. synth list marks the default flow with [default].
#253 The synth list subcommand lists the flows defined in the config file. The --details flag additionally shows each flow's nodes with their triggers and commands.
#253 The synth diagram subcommand outputs a Mermaid diagram describing a flow, replacing the --mermaid flag that was previously on synth run. A --format flag controls the output format (currently only mermaid).
#253 Flows now support an optional description field, displayed by synth list.
#253 Added a Using Synthesize with Other Tools documentation page covering integration with CI systems and AI coding agents.

#255 The environment variable for specifying the config file path has been renamed from SYNTHFILE to SYNTH_FILE.
#253 synth is now a multi-command app. Running a flow now requires the explicit synth run [FLOW] form; synth [FLOW] no longer works.
#253 The recommended installation method is now uv add --dev synthesize, adding Synthesize as a development dependency to your project.
#233 Added support for loading .env files via python-dotenv. A new settings.dot_env sub-section controls the behavior: dot_env.load (default true) enables loading, and dot_env.file (default .env) sets the filename, resolved relative to the config file. Both can be overridden at run time with -s dot_env.load=false or -s dot_env.file=.custom-env.
#247 Added a settings section to the configuration file with a timestamps sub-section. timestamps.sub_second_digits (0-6, default 0) controls how many sub-second digits appear in timestamps, and timestamps.include_date (default false) prepends the date to timestamps. Settings can also be overridden on the command line via -s/--setting using dotted paths (e.g. -s timestamps.sub_second_digits=3).

#244 Updated the recommended installation method from pipx to uv tool install, with alternatives for uvx and uv add --dev.
#246 Renamed target/targets to recipe/recipes in the configuration schema, matching the terminology used by just.

#126 If no more work can be done in a flow, synth will exit. If all recipes ran and succeeded, the exit code will be 0. Otherwise, the exit code will be 1.
#126 Added the --once option, which replaces all "repeating" triggers (like watch or restart) with once. This allows an existing flow to be run as a "single shot", and when combined with the exit behavior change described above potentially useful for using Snyth workflows in CI or other automation.

#128 The separator rule is now red when any node has failed, and a status summary is printed when exiting.
#131 Flows can no longer have cycles in them (via the after trigger).

#129 Ensured that the async tasks that trigger restarts don't get garbage-collected.

Released 2025-02-12

#112 Fix a crash that could happen when a process outputs too much data without a newline.

Released 2024-10-24

#79 Fix a crash that could happen when a process exits while we are trying to terminate it.

Released 2024-07-07

#3 Added PyPI classifiers and other metadata.
#33 #40 Allow injecting arguments (via Jinja2 templates) and environment variables into recipe commands. Arguments and environment variables can be specified at either the flow, node, or recipe level, with the most specific taking precedence.
#43 Mermaid diagrams can be generated for a flow using the --mermaid option.

#30 Reorganized configuration to separate recipes, triggers (formerly "lifecycles"), and flows (graphs of recipes and triggers).
#41 Execution duration is printed in the completion message.
#49 Flow nodes can now have multiple triggers.

#45 Restart triggers now allow for the node's children to run again after the node completes.

Released 2023-02-12

#1 Core graph-of-recipes data model and executor, with support for once, restart, and watch lifecycles.
#1 Support for YAML configuration files.