asgard 0.5.1 → 0.6.0

data/docs/api.md

@@ -1,368 +0,0 @@
-# API Reference
-
-This page documents the public Ruby API for the Asgard gem. Most users interact with Asgard through the CLI and the task DSL — this page is primarily useful when integrating Asgard into tooling or extending it programmatically.
-
----
-
-## `Asgard` Module Methods
-
-These class methods are defined on the `Asgard` module itself.
-
-| Method | Signature | Description |
-|---|---|---|
-| `run!` | `Asgard.run!(argv)` | Main entry point. Finds `.loki`, loads all task files, validates the dependency graph, and dispatches via Thor. Handles its own errors: missing `.loki` and circular dependencies both produce a clean one-line message and `exit 1`. |
-| `find_task_file` | `Asgard.find_task_file → Pathname, nil` | Searches `Dir.pwd` and each ancestor directory for a `.loki` file. Returns a `Pathname` of the first match, or `nil` if none is found. |
-
-### `run!` Details
-
-```ruby
-Asgard.run!(ARGV)
-```
-
-`run!` guards against direct invocation of `_`-prefixed commands before any files are loaded:
-
-```ruby
-abort "asgard: unknown command '#{argv.first}'" if argv.first&.start_with?("_")
-```
-
-After loading task files, it calls `Tasks.validate_deps!` (circular dependency check) and `Tasks._reset_ran!` (clears per-invocation deduplication state) before starting Thor.
-
-If the dispatched task returns exactly `:fail`, `run!` exits with status 1 (the quality-gate convention). Any other return value, including `:warn` and `:skip`, exits 0.
-
----
-
-## Kernel Methods
-
-These methods are defined as `module_function` on `Kernel` and are therefore available everywhere in Ruby — at the top level of `.loki` files, inside class bodies, and inside task method bodies. No `require` or `include` is needed; they are loaded when `asgard` starts.
-
-| Method | Signature | Returns | Description |
-|---|---|---|---|
-| `loki_up` | `loki_up(name = ".loki") → Pathname, nil` | `Pathname` or `nil` | Searches `Dir.pwd` and each ancestor directory for a file named `name`. Returns a `Pathname` for the first match, or `nil` if not found. Exact filenames only — does not expand globs. |
-| `import` | `import(path) → true, false` | `true` if any file newly loaded | Loads one `.loki` file or a glob of `.loki` files. Relative paths resolve relative to the caller's file (like `require_relative`). Idempotent via `$LOADED_FEATURES`. Raises `ArgumentError` if `path` does not end with `.loki`. Raises `LoadError` if a non-glob path does not exist. |
-| `import_up` | `import_up(name = ".loki") → true, false` | `true` if any file newly loaded | Combines `loki_up` and `import`. Walks ancestors to find the file or glob match, then loads it. Returns `false` if nothing is found. |
-| `changes` | `changes → Asgard::Changes` | `Asgard::Changes` | The files the watcher saw change when it triggered this task: `modified`, `added`, `removed`, `all`, `empty?`. Read once per process from `ASGARD_MODIFIED`, `ASGARD_ADDED` and `ASGARD_REMOVED`; every list is empty when the task is run by hand. See [`Asgard::Watch`](#asgardwatch). |
-| `debug?` | `debug? → true, false` | `$DEBUG` | Returns the current value of `$DEBUG`. Set to `true` by `--debug` on the CLI or directly via `$DEBUG = true`. |
-| `verbose?` | `verbose? → true, false` | `$VERBOSE` | Returns the current value of `$VERBOSE`. Set to `true` by `--verbose` on the CLI or directly via `$VERBOSE = true`. |
-| `env` | `env(name, default = nil) → String, nil` | `ENV` value or default | Fetches an environment variable by symbol or string name. The name is upcased automatically. Raises `KeyError` when the variable is missing and no default is given. |
-
-### `loki_up` Details
-
-Despite the name, `loki_up` is not limited to `.loki` files — it locates any file by walking up the directory tree:
-
-```ruby
-loki_up                       # find .loki (the project root marker)
-loki_up("gem_tasks.loki")     # find gem_tasks.loki in CWD or any ancestor
-loki_up(".env")               # find the nearest .env file up the tree
-loki_up("VERSION")            # find a VERSION file in CWD or any ancestor
-```
-
-Returns a `Pathname` or `nil`. Does not load the file. `Pathname` is accepted by `import`, `dotenv`, `load`, and standard Ruby file methods — no `.to_s` conversion needed in common usage.
-
-```ruby
-if (path = loki_up("gem_tasks.loki"))
-  import path          # Pathname accepted directly
-end
-
-# Pass the located .env to dotenv — works from any subdirectory
-dotenv loki_up(".env") || ".env"
-```
-
-### `import` Details
-
-```ruby
-import "build.loki"                  # relative — resolved from the calling file's directory
-import "/home/shared/gem_tasks.loki" # absolute
-import "*.loki"                      # all *.loki in the same directory as the caller
-import "../shared/*.loki"            # all *.loki one level up
-import "**/*.loki"                   # all *.loki recursively
-import Pathname.new("tasks.loki")    # Pathname accepted
-```
-
-**Extension requirement:** the path (or glob pattern) must end with `.loki`. Passing any other extension raises `ArgumentError`.
-
-**Glob behaviour:** `Dir.glob` is used for pattern expansion. `*.loki` does not match `.loki` (the dotfile) — Ruby's glob excludes dotfiles from `*` by default. Files are loaded in the order `Dir.glob` returns them (sorted on Ruby ≥ 2.7).
-
-**Idempotency:** each resolved absolute path is checked against `$LOADED_FEATURES` before loading. A file already in `$LOADED_FEATURES` is silently skipped and contributes `false` to the return value.
-
-**Return value:** `true` if at least one file was newly loaded; `false` if all matched files were already loaded or no glob pattern produced any matches.
-
-**Verbose/debug output** (to stderr):
-- `verbose?` true — prints each file path as it is loaded
-- `debug?` true — also prints a skip message for each already-loaded file
-
-### `import_up` Details
-
-```ruby
-import_up                          # find and load .loki
-import_up "gem_tasks.loki"         # find and load gem_tasks.loki up the tree
-import_up "*.loki"                 # find the nearest ancestor with *.loki files and load them all
-```
-
-**Exact name:** delegates to `loki_up` to find the file, then calls `import` with the absolute path. Returns `false` without raising if the file is not found.
-
-**Glob name:** walks ancestor directories manually using `Dir.glob`. Stops at the **first** ancestor that has any matches and loads all of them — it does not continue walking after finding a match. Returns `false` if no ancestor contains matching files.
-
-**Verbose/debug output** (to stderr):
-- `verbose?` true — prints `name → /full/path` when a file or directory is found
-- `debug?` true — also prints `name not found` when the search comes up empty
-
----
-
-## `Asgard::Base` DSL Class Methods
-
-`Asgard::Base` is a `Thor` subclass that provides the task DSL. It is the superclass of `Tasks`. All DSL methods are class methods (called in the class body).
-
-| Method | Signature | Description |
-|---|---|---|
-| `depends_on` | `depends_on(*tasks, &block)` | Declare prerequisites for the next `def`. Bare symbols run sequentially; arrays within the splat run as a parallel group. A sole `Proc`/lambda, or a block in place of the splat args, defers resolution to `validate_deps!` (after every `.loki` file has loaded) instead of resolving immediately — see [Dynamic Dependencies](dependencies.md#dynamic-dependencies-proc-block-form). Passing both task arguments and a block raises `Asgard::Error`. |
-| `dotenv` | `dotenv(path = ".env")` | Load the specified `.env` file into `ENV` using the dotenv gem. Silently skipped if the file does not exist. Called at class-load time. |
-| `header` | `header(text)` | Append a line of text shown above the commands list in `asgard help`. Each call adds another line. No-op for per-command help. |
-| `footer` | `footer(text)` | Prepend a line of text shown below the options block in `asgard help`. Each call inserts above the previous lines. No-op for per-command help. |
-| `no_negate` | `no_negate(*names)` | Suppress `[--no-name]` / `[--skip-name]` help entries for one or more boolean class options. Call after the `class_option` declaration. |
-| `sh` | `sh(script, silent: false, exec: false)` | Instance method. Run a shell command or multiline heredoc. Single-line → `system(script)`; multiline → `system("bash", "-c", script)`. Exits with the command's status on failure. With `exec: true`, replaces the asgard process via `Kernel.exec` instead of forking — see [Shell Helpers](shell.md#handing-off-with-exec). |
-| `shebang` | `shebang(interpreter, script, silent: false)` | Instance method. Write `script` to a tempfile and execute it with `interpreter`. See the [Shell Helpers](shell.md) page for the full interpreter table. |
-| `validate_deps!` | `Tasks.validate_deps!` | Build and topologically sort the full dependency graph using stdlib `TSort`. Raises `Asgard::CircularDependencyError` on cycles. Called by `run!` at startup. |
-| `_reset_ran!` | `Tasks._reset_ran!` | Clear the per-invocation task deduplication set. Called by `run!` before dispatching. Thread-safe via Mutex. |
-
-### `header` and `footer` Accumulation
-
-Both `header` and `footer` accumulate across multiple calls and across multiple imported `.loki` files, but they accumulate in opposite directions by design.
-
-**`header` appends** — each call adds to the bottom of the header block:
-
-```ruby
-# .loki
-import "quality.loki"
-import "gem_tasks.loki"
-
-class Tasks
-  header "Project: myapp"       # line 1
-  header "Root: #{loki_up.parent}"  # line 2
-end
-```
-
-Result in `asgard help`:
-```
-Project: myapp
-Root: /home/user/myapp
-```
-
-**`footer` prepends** — each call inserts at the top of the footer block:
-
-```ruby
-class Tasks
-  footer "Github: https://github.com/org/myapp"  # ends up second
-  footer "Docs: https://myapp.example.com"        # ends up first
-end
-```
-
-Result in `asgard help`:
-```
-Docs: https://myapp.example.com
-Github: https://github.com/org/myapp
-```
-
-**Why the asymmetry?** When task files are split across multiple `.loki` files, the base `.loki` is loaded first and any imported files are loaded after. With `header`, earlier-loaded content appears first (the project banner stays at the top). With `footer`, later-loaded content appears first — this allows an imported file to inject a note that appears above the base footer rather than after it.
-
-In practice: if only one file calls `header` and one file calls `footer`, the direction doesn't matter. The difference is visible only when multiple `.loki` files both call `header` or both call `footer`.
-
-Neither `header` nor `footer` appears when running per-command help (`asgard help <task>`).
-
----
-
-### `depends_on` Argument Shapes
-
-```ruby
-depends_on :build                          # single sequential dep
-depends_on :clean, :build                  # two sequential deps
-depends_on [:lint, :typecheck]             # lint and typecheck run in parallel
-depends_on :setup, [:lint, :build], :test  # setup, then lint+build concurrently, then test
-
-# A sole Proc/lambda (or, equivalently, a block) defers resolution to
-# validate_deps!, after every .loki file has loaded — must return the same
-# shape the splat form above would; the shape is validated when it resolves.
-depends_on -> { [all_commands.keys.grep(/_check\z/).map(&:to_sym)] }
-depends_on { [all_commands.keys.grep(/_check\z/).map(&:to_sym)] }
-```
-
-See [Dynamic Dependencies](dependencies.md#dynamic-dependencies-proc-block-form) for the full explanation of the Proc/block form — why it exists, when it runs, and how errors are reported.
-
----
-
-## `Tasks` Built-ins
-
-`Tasks` is pre-defined by the gem as `class Tasks < Asgard::Base`. It adds the following:
-
-| Item | Type | Description |
-|---|---|---|
-| `class_option :debug` | class option | `--debug` flag. Sets `$DEBUG = true` before any task runs. Boolean, default `false`. |
-| `class_option :verbose` | class option | `--verbose` flag. Sets `$VERBOSE = true` before any task runs. Boolean, default `false`. |
-| `class_option :version` | class option | `--version` flag. Handled by `Asgard.run!` before the `.loki` file is loaded — prints `Asgard::VERSION` and exits. `no_negate :version` suppresses the `[--no-version]` / `[--skip-version]` help entries. |
-| `class_option :doctor` | class option | `--doctor` flag. Handled by `Asgard.run!` before the `.loki` file is loaded — runs `Asgard::Doctor.new.run` and exits. `no_negate :doctor` suppresses the `[--no-doctor]` / `[--skip-doctor]` help entries. |
-| `debug?` | Kernel module function | Returns `$DEBUG`. Available everywhere via `Kernel`. |
-| `verbose?` | Kernel module function | Returns `$VERBOSE`. Available everywhere via `Kernel`. |
-| `schedule` | class method (DSL) | `schedule :task, at:/every:, ...` — declares a scheduled entry. Extended from `Asgard::Schedule::DSL`; see [`Asgard::Schedule`](#asgardschedule). |
-| `_schedule` | subcommand | `asgard schedule SUBCOMMAND`, backed by `Asgard::Schedule::Commands`. `map "schedule" => :_schedule` keeps the typed name `schedule`, and a user task named `schedule` cannot shadow it. |
-| `watch` | class method (DSL) | `watch :task, paths: ...` — declares a watched entry. Extended from `Asgard::Watch::DSL`; see [`Asgard::Watch`](#asgardwatch). |
-| `_watcher` | subcommand | `asgard watcher SUBCOMMAND`, backed by `Asgard::Watch::Commands`. `map "watcher" => :_watcher` keeps the typed name `watcher`. |
-
----
-
-## `Asgard::Doctor`
-
-`asgard --doctor` diagnoses `.loki` resolution, import chains, and task definitions for the current directory. It deliberately bypasses the normal `Tasks` boot sequence used by `run!`, so it can still report findings in situations that would otherwise abort the whole process — a broken `.loki` file, a circular or undefined dependency, or a task silently redefined by a later `def`.
-
-| Method | Signature | Description |
-|---|---|---|
-| `new` | `Asgard::Doctor.new(dir = Dir.pwd)` | Builds a doctor scoped to `dir`. |
-| `run` | `doctor.run` | Runs the full diagnostic pass and prints a report to stdout. Does not raise or exit — callers (like `Asgard.run!`) decide what to do afterward. |
-| `ancestor_markers` | `Asgard::Doctor.ancestor_markers(dir) → Array<String>` | Every `.loki` marker from `dir` up to the filesystem root, nearest first. Unlike `loki_up`, it collects every match instead of stopping at the first, so shadowed ancestor markers can be reported. |
-| `duplicate_methods` | `Asgard::Doctor.duplicate_methods(method_log) → Hash` | Given an `Asgard::Base` subclass's `_method_log`, returns the subset of entries defined at more than one location — same file or different — which is exactly what a silent `def` override looks like. |
-
-Findings fall into three levels: `:info` (what was found — the marker used, each import's result), `:warn` (shadowed markers that are never reached), and `:error` (load failures, redefined methods, dependency graph problems).
-
-After the findings, the report prints a **Tasks by file** section: every Thor command, grouped by the `.loki` file it's defined in, as `relative/path:line` — a format an editor can jump straight to. A task name defined at more than one location gets every definition annotated inline: the earlier one(s) are marked `OVERRIDDEN by <file>:<line> — never callable`, and the winning (last) definition is marked `active — redefines <file>:<line>`. This is the exact class of bug the flag was built to catch — a later `def` silently replacing an earlier one, with no error anywhere else in the toolchain. The report ends with a one-line summary and a count of problems/warnings, where each overridden task counts as one problem.
-
-```bash
-asgard --doctor
-```
-
-The asgard repo ships its own live example of this: `xyzzy.loki` defines a `xyzzy` task, and the top-level `.loki` (which imports it) reopens `Tasks` and defines `xyzzy` again — so the one from `xyzzy.loki` is silently dead. Clone the repo and run `asgard --doctor` from its root to see this for yourself:
-
-```
-asgard doctor -- /path/to/asgard
-============================================================
-  [INFO] using .loki marker: /path/to/asgard/.loki
-  [INFO] import "quality.loki" -> /path/to/asgard/quality.loki
-  [INFO] import "gem_tasks.loki" -> /path/to/asgard/gem_tasks.loki
-  [INFO] import "git.loki" -> /path/to/asgard/git.loki
-  [INFO] import "xyzzy.loki" -> /path/to/asgard/xyzzy.loki
-
-Tasks by file:
-
-  .loki
-    xyzzy  .loki:15   active — redefines xyzzy.loki:6
-
-  quality.loki
-    test          quality.loki:6
-    test_verbose  quality.loki:15
-    quality       quality.loki:21
-    rubocop       quality.loki:34
-    rubocop_fix   quality.loki:43
-    flog_check    quality.loki:48
-    flay_check    quality.loki:82
-    reek          quality.loki:104
-
-  gem_tasks.loki
-    console  gem_tasks.loki:6
-    build    gem_tasks.loki:16
-    install  gem_tasks.loki:24
-    release  gem_tasks.loki:31
-
-  git.loki
-    push   git.loki:6
-    pull   git.loki:9
-    fetch  git.loki:12
-
-  xyzzy.loki
-    xyzzy  xyzzy.loki:6   OVERRIDDEN by .loki:15 — never callable
-============================================================
-1 problem(s), 1 warning(s).
-```
-
-The warning is a shadowed ancestor `.loki` marker one directory further up the tree — unrelated to the override, and something you may or may not see depending on what's above the repo on your own machine.
-
----
-
-## `Asgard::Schedule`
-
-Scheduled tasks. The user-facing guide is [Scheduled Tasks](schedule.md); this section covers the Ruby API.
-
-| Method | Signature | Description |
-|---|---|---|
-| `declare` | `Asgard::Schedule.declare(task, **settings) → Hash` | What `Tasks.schedule` calls. Validates via `normalize` and records the entry. Redeclaring an identical entry is a no-op; a different entry under the same name raises `ArgumentError`. |
-| `declarations` | `Asgard::Schedule.declarations → Hash` | Declared entries for this run, keyed by entry name. |
-| `normalize` | `Asgard::Schedule.normalize(task, options: nil, at: nil, on: :daily, every: nil, env: {}, as: nil) → Hash` | Validates one declaration and returns `{ name:, task:, args:, at:, on:, every:, env: }`. Pure. |
-| `backend_class` | `Asgard::Schedule.backend_class(platform = RUBY_PLATFORM)` | `Launchd` on darwin, `Systemd` on linux; raises `Asgard::Schedule::Error` elsewhere. |
-| `runner` / `runner=` | `Asgard::Schedule.runner → #call` | The command runner new backends use: `argv` in, `[output, success?]` out. Defaults to `RUNNER` (`Open3.capture2e`); tests assign a recording runner, and `nil` restores the default. |
-
-Both backends, `Asgard::Schedule::Launchd` and `Asgard::Schedule::Systemd`, implement the same instance API: `files`, `install`, `uninstall`, `start`, `stop`, `trigger`, `installed_names`, `status`, `log_path`, `notes`. Each class also exposes the pure helpers that build its job files (`Launchd.plist`, `Systemd.service_unit`, `Systemd.timer_unit`, ...), so they can be tested without a scheduler.
-
----
-
-## `Asgard::Watch`
-
-Watched files. The user-facing guide is [Watched Files](watch.md); this section covers the Ruby API.
-
-| Method | Signature | Description |
-|---|---|---|
-| `declare` | `Asgard::Watch.declare(task, **settings) → Hash` | What `Tasks.watch` calls. Validates via `normalize` and records the entry. Redeclaring an identical entry is a no-op; a different entry under the same name raises `ArgumentError`. |
-| `declarations` | `Asgard::Watch.declarations → Hash` | Declared entries for this run, keyed by entry name. |
-| `normalize` | `Asgard::Watch.normalize(task, paths:, only: nil, ignore: nil, events: :all, debounce: 0.5, env: {}, as: nil) → Hash` | Validates one declaration and returns `{ name:, task:, paths:, dirs:, only:, ignore:, events:, debounce:, env: }`: the directories listen watches and one `only:` Regexp (or nil) built from the globs and the declared filter. Pure, as are its helpers `split_glob`, `glob_regexp`, `combine_only` and `normalize_events`. |
-| `filter_events` | `Asgard::Watch.filter_events(batch, events) → Asgard::Changes, nil` | A listener batch narrowed to the entry's `events:`; `nil` when nothing is left. |
-
-`Asgard::Changes` is a `Data` class with `modified`, `added` and `removed` path lists, `all`, `empty?`, `to_env` (the three trigger variables) and `Changes.from_env(env = ENV)`. `Changes.current` is the per-process memo behind the `changes` Kernel method; `Changes.forget` clears it.
-
-The daemon is assembled from small classes, each testable alone: `Spawn` builds the frozen, Ractor-shareable description of one run (argv, whitelisted environment, root, log, changes); `Worker` runs one task's triggers serially in its own Ractor and reports every spawn and exit; `Dispatcher` routes listener batches to the worker queues; `Reporter` is the single writer of the log and the per-entry records and tracks in-flight pids; `State` owns the pidfile, log, recorded declarations and entry records under the XDG state directory; `Daemon` wires them to listen and handles signals and reloads.
-
----
-
-## `Asgard::Base` Internal Class Methods
-
-These are implementation details exposed for extensibility. Prefer the DSL methods above in normal use.
-
-| Method | Description |
-|---|---|
-| `_deps` | Hash mapping task name symbols to their stage arrays. Set by `depends_on` + `method_added`. |
-| `_done` | `Set` of task name symbols that have completed in the current invocation. |
-| `_running` | `Set` of task name symbols currently executing (started but not yet finished). |
-| `_cond` | Hash of `ConditionVariable` objects keyed by task name; threads wait here when a dep is in-flight. |
-| `_ran_mutex` | `Mutex` protecting `_done`, `_running`, and `_cond` for thread-safe access. |
-
----
-
-## `invoke_command` Hook
-
-`Asgard::Base` overrides Thor's `invoke_command` to implement dependency resolution and deduplication:
-
-1. Sets `$DEBUG` / `$VERBOSE` from `options` if the corresponding flags are present.
-2. Tries to acquire a run token (`acquire_run_token`): if the task is already in `_done`, returns immediately (skip); if it is in `_running`, waits on the `_cond` ConditionVariable until it finishes, then returns (skip); otherwise adds the task to `_running` and continues.
-3. Resolves dependency stages from `_deps` — already the parallel-group execution plan `depends_on` built — and executes each group in order (parallel groups in threads, sequential groups one at a time).
-4. Calls `command.run(self, *args)` to execute the task itself.
-5. In an `ensure` block, adds the task to `_done` and broadcasts on its `_cond` to wake any waiting threads.
-
----
-
-## Error Classes
-
-| Class | Superclass | Description |
-|---|---|---|
-| `Asgard::Error` | `StandardError` | Base error class for all Asgard errors. |
-| `Asgard::Schedule::Error` | `Asgard::Error` | Raised when a `launchctl`/`systemctl` command fails, or on an unsupported platform. `run!` reports it as `asgard: <message>`. |
-| `Asgard::Watch::Error` | `Asgard::Error` | Raised when the watcher cannot run: a `watch` names a task the project does not define. `run!` reports it as `asgard: <message>`. |
-| `Asgard::CircularDependencyError` | `Asgard::Error` | Raised by `validate_deps!` when a cycle is detected in the dependency graph. `run!` catches this and calls `abort` with a clean message. |
-
-```ruby
-begin
-  Asgard.run!(ARGV)
-rescue Asgard::CircularDependencyError => e
-  # This is already handled inside run! — you only need this
-  # if you call validate_deps! directly in your own tooling.
-  abort "circular dependency: #{e.message}"
-end
-```
-
----
-
-## Dependencies
-
-| Gem | Version | Purpose |
-|---|---|---|
-| [thor](https://github.com/rails/thor) | `~> 1.0` | CLI framework; provides the full task DSL |
-| [dotenv](https://github.com/bkeepers/dotenv) | `~> 3.0` | `.env` file loading |
-
----
-
-## Ruby Version Requirement
-
-Asgard requires **Ruby >= 3.2.0**.

data/docs/assets/css/custom.css

@@ -1,93 +0,0 @@
-/* ==========================================================================
-   Asgard documentation — custom styles
-   Material theme handles the heavy lifting; this file adds targeted polish.
-   ========================================================================== */
-
-/* --------------------------------------------------------------------------
-   .loki filename display
-   Used whenever the filename ".loki" or "*.loki" appears inline or in code.
-   -------------------------------------------------------------------------- */
-
-/* Give inline code that looks like a .loki filename a subtle Norse-gold tint */
-code:is([class*="language-"]) .token.string:has-text(".loki"),
-.md-typeset code.loki-file {
-  color: var(--md-accent-fg-color);
-  font-weight: 600;
-}
-
-/* Highlight .loki filenames in directory tree code blocks */
-.md-typeset .highlight .filename {
-  background-color: color-mix(in srgb, var(--md-primary-fg-color) 12%, transparent);
-  border-bottom: 2px solid var(--md-accent-fg-color);
-  border-radius: 4px 4px 0 0;
-  color: var(--md-default-fg-color);
-  font-size: 0.75rem;
-  font-weight: 600;
-  letter-spacing: 0.04em;
-  padding: 0.3rem 0.8rem;
-}
-
-/* --------------------------------------------------------------------------
-   Admonition tweaks — slightly warmer warning border for the "argument"
-   class-level scope warning that appears on the tasks page.
-   -------------------------------------------------------------------------- */
-
-.md-typeset .admonition.warning,
-.md-typeset details.warning {
-  border-left-color: #e6a817;
-}
-
-.md-typeset .admonition.warning > .admonition-title,
-.md-typeset details.warning > summary {
-  background-color: rgba(230, 168, 23, 0.12);
-}
-
-/* --------------------------------------------------------------------------
-   Table of Contents — emphasise the current section a touch more
-   -------------------------------------------------------------------------- */
-
-.md-nav__link--active {
-  font-weight: 600;
-}
-
-/* --------------------------------------------------------------------------
-   Home page feature table (HTML table in index.md)
-   -------------------------------------------------------------------------- */
-
-.md-typeset table:not([class]) td {
-  vertical-align: top;
-}
-
-/* --------------------------------------------------------------------------
-   Execution diagram in dependencies.md — keep it tight and readable
-   -------------------------------------------------------------------------- */
-
-.md-typeset pre code {
-  font-size: 0.85em;
-  line-height: 1.5;
-}
-
-/* --------------------------------------------------------------------------
-   Subtle Norse-shield watermark on the hero block (index page only).
-   Relies on the Material "primary: indigo" palette.
-   -------------------------------------------------------------------------- */
-
-.md-header {
-  box-shadow: 0 2px 8px rgba(63, 81, 181, 0.25);
-}
-
-/* --------------------------------------------------------------------------
-   Code annotations — keep them readable across both light and dark palettes
-   -------------------------------------------------------------------------- */
-
-.md-typeset .md-annotation__index > * {
-  font-size: 0.7rem;
-}
-
-/* --------------------------------------------------------------------------
-   Task-runner specific: distinguish shell prompt lines from output lines
-   in bash code blocks by dimming lines that don't start with '#' or 'asgard'
-   -------------------------------------------------------------------------- */
-
-/* (Future: add targeted styles once MkDocs Material supports per-line
-   highlighting via config; for now this is intentionally minimal.) */

data/docs/changelog.md

@@ -1 +0,0 @@
---8<-- "CHANGELOG.md"