Changelog¶

All notable changes to Asgard are documented here.

The format follows Keep a Changelog. Asgard adheres to Semantic Versioning.

Unreleased ¶

var DSL method — replaced by native Ruby class variables. Use @@name ||= "value".freeze in the class body. Class variables are visible in all task instance methods and in subcommand subclasses, making them the correct tool for shared configuration in a Thor-based task runner. See Variables.

*.loki files are no longer auto-loaded by default. Pass --auto-load to asgard to load all *.loki files from the project root alphabetically before .loki. This is a breaking change for projects using the multi-file layout.
Added --auto-load as a built-in CLI flag in Tasks, visible in asgard help

--version built-in CLI flag — prints Asgard::VERSION and exits; implemented as a _-prefixed method in Tasks per the gem-owned naming convention
--debug and --verbose built-in class_option declarations on Tasks — set $DEBUG/$VERBOSE before any task runs via the invoke_command hook in Asgard::Base
debug? and verbose? private predicate helpers on Tasks — thin wrappers around $DEBUG and $VERBOSE for use inside task bodies
_ prefix convention for gem-owned methods in Tasks — built-in methods use _ prefix to distinguish them from user-defined tasks
run! guards against direct invocation of _-prefixed commands with a clean error message and exit 1
examples/ directory with working .loki files:
kitchen_sink.loki — demonstrates the full Thor DSL (all option types, long_desc, class_option, default_task, map, depends_on, var, no_commands, private)
server_subcommands.loki — subcommand group for server management
db_subcommands.loki — subcommand group for database management with depends_on chaining
concurrent.loki — demonstrates parallel task execution with interleaved thread output
README sections: Helper methods, Subcommands, Thor wrapper callout

Replaced warn/exit 1 with abort throughout run! — Kernel#warn is silenced when $VERBOSE = nil, which is the default in Ruby 4.0; abort writes to $stderr regardless

--debug and --verbose promoted from mapped tasks to class_option — they now work as modifiers alongside other commands (e.g. asgard build --debug) rather than as standalone commands
Removed all references to just task runner and recipe terminology; Asgard uses "task" throughout
depends_on parameter renamed from *recipes to *tasks for consistency

Parallel dependency execution — wrap deps in an array to run them concurrently: depends_on [:build, :lint] or depends_on :setup, [:build, :lint], :deploy
Asgard.run!(argv) — single entry point encapsulating find, load, validate, and start
Asgard.load_loki(dir) — auto-loads all *.loki files in a directory alphabetically
Tasks class pre-defined by the gem (class Tasks < Asgard::Base) — task files reopen it without restating the superclass
lib/asgard/tasks.rb — ships the pre-defined Tasks class

Replaced SimpleFlow dependency with Dagwood — purpose-built DAG library with no extra dependencies and no Ruby 4 compatibility issues
bin/asgard simplified to two lines: require "asgard" + Asgard.run!(ARGV)
Task file convention: .loki is the project root marker and entry point; *.loki files each reopen class Tasks and are auto-loaded before .loki
Asgard.find_task_files renamed to Asgard.find_task_file (singular — only .loki is the entry point)
depends_on now accepts mixed sequential/parallel stages; bare symbols run sequentially, arrays within the splat run in parallel
run! handles its own errors — missing .loki and circular dependencies produce a clean one-line message and exit 1 rather than a backtrace
Thread-safe dep deduplication via class-level _ran_tasks Set + Mutex replaces Thor's @_invocations
Removed import macro — task files use Ruby class reopening instead of modules

SimpleFlow dependency (replaced by Dagwood)
logger gem workaround (was only needed for SimpleFlow on Ruby 4)
*.loki glob fallback in find_task_file — only .loki is the auto-discovered entry point

Asgard::Base — Thor subclass providing the task DSL
depends_on — declare task dependencies; dependencies run at most once per invocation
var — declare static or lazy-evaluated variables available to all tasks
import — flat-merge a task module into the current class
dotenv — load a .env file into the environment
sh — run a shell command or multiline heredoc script; exits with the command's status on failure
shebang — write a script body to a tempfile and execute it with a given interpreter (:python3, :node, :ruby, :perl, :bash, :sh, or any custom interpreter)
Asgard.find_task_files — search current directory and ancestors for task files
Task file resolution: .loki takes priority; falls back to all *.loki files sorted alphabetically
asgard executable — finds task files, validates dependency graph, dispatches via Thor
Circular dependency detection via SimpleFlow::DependencyGraph at startup
100% test coverage enforced via SimpleCov (95% minimum threshold)
Quality task in .loki runs flog after tests