asgard 0.5.1 → 0.6.0

metadata

@@ -1,213 +1,194 @@
 --- !ruby/object:Gem::Specification
 name: asgard
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
-- Dewayne VanHoozer
+  - Dewayne VanHoozer
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: thor
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: dotenv
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: tty-table
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.12'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.12'
-- !ruby/object:Gem::Dependency
-  name: ractor_queue
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: listen
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.9'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.9'
+  - !ruby/object:Gem::Dependency
+    name: thor
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "1.5"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "1.5"
+  - !ruby/object:Gem::Dependency
+    name: dotenv
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "3.2"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "3.2"
+  - !ruby/object:Gem::Dependency
+    name: tty-table
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "0.12"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "0.12"
+  - !ruby/object:Gem::Dependency
+    name: ractor_queue
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "0.2"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "0.2"
+  - !ruby/object:Gem::Dependency
+    name: listen
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "3.10"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "3.10"
+  - !ruby/object:Gem::Dependency
+    name: tsort
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "0.2"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ~>
+          - !ruby/object:Gem::Version
+            version: "0.2"
 description: |
-  A powerful Ruby-based task runner for any kind of project with task dependency tracking
-  and concurrent execution of designated tasks. Uses Thor for its rich CLI options, var
-  declarations, dotenv, sh/shebang helpers, importable task files, and scheduled
-  execution of tasks via launchd (macOS) or systemd timers (Linux).
+    A powerful Ruby-based task runner for any kind of project with task dependency tracking
+    and concurrent execution of designated tasks. Uses Thor for its rich CLI options, with
+    dotenv, sh/shebang helpers, importable task files, scheduled execution of tasks via
+    launchd (macOS) or systemd timers (Linux), a file watcher and background jobs.
 email:
-- dewayne@vanhoozer.me
+  - dewayne@vanhoozer.me
 executables:
-- asgard
+  - asgard
 extensions: []
 extra_rdoc_files: []
 files:
-- ".envrc"
-- ".github/workflows/deploy-github-pages.yml"
-- ".loki"
-- ".reek.yml"
-- ".rubocop.yml"
-- Archspec.rb
-- CHANGELOG.md
-- CLAUDE.md
-- COMMITS.md
-- LICENSE.txt
-- README.md
-- bin/asgard
-- bin/console
-- bin/setup
-- doc_tasks.loki
-- docs/api.md
-- docs/assets/css/custom.css
-- docs/assets/images/asgard.jpg
-- docs/changelog.md
-- docs/dependencies.md
-- docs/environment.md
-- docs/examples.md
-- docs/getting-started.md
-- docs/helpers.md
-- docs/index.md
-- docs/options.md
-- docs/schedule.md
-- docs/shell.md
-- docs/subcommands.md
-- docs/task-files.md
-- docs/tasks.md
-- docs/variables.md
-- docs/watch.md
-- examples/.env
-- examples/.envrc
-- examples/.loki
-- examples/bad.loki
-- examples/concurrent.loki
-- examples/confirm.loki
-- examples/db_subcommands.loki
-- examples/depends_on_block/bad/.loki
-- examples/depends_on_block/good/.loki
-- examples/do.loki
-- examples/env_usage.loki
-- examples/kitchen_sink.loki
-- examples/server_subcommands.loki
-- examples/subdir/.loki
-- examples/subdir/import_demo.loki
-- examples/subdir/import_up_demo.loki
-- examples/watcher_examples/.envrc
-- examples/watcher_examples/.loki
-- examples/watcher_examples/README.md
-- examples/watcher_examples/bin/hello
-- examples/watcher_examples/data/records.json
-- examples/watcher_examples/docs/drafts/ideas.md
-- examples/watcher_examples/docs/index.md
-- examples/watcher_examples/lib/greeter.rb
-- gem_tasks.loki
-- git.loki
-- lib/asgard.rb
-- lib/asgard/base.rb
-- lib/asgard/base/dependency_graph.rb
-- lib/asgard/base/dispatch.rb
-- lib/asgard/base/registry.rb
-- lib/asgard/base/task_dsl.rb
-- lib/asgard/doctor.rb
-- lib/asgard/doctor/report.rb
-- lib/asgard/doctor/task_sections.rb
-- lib/asgard/errors.rb
-- lib/asgard/kernel_methods.rb
-- lib/asgard/schedule.rb
-- lib/asgard/schedule/commands.rb
-- lib/asgard/schedule/declaration.rb
-- lib/asgard/schedule/launchd.rb
-- lib/asgard/schedule/systemd.rb
-- lib/asgard/schedule/table.rb
-- lib/asgard/shell.rb
-- lib/asgard/tasks.rb
-- lib/asgard/version.rb
-- lib/asgard/watch.rb
-- lib/asgard/watch/changes.rb
-- lib/asgard/watch/commands.rb
-- lib/asgard/watch/daemon.rb
-- lib/asgard/watch/declaration.rb
-- lib/asgard/watch/dispatcher.rb
-- lib/asgard/watch/reporter.rb
-- lib/asgard/watch/spawn.rb
-- lib/asgard/watch/state.rb
-- lib/asgard/watch/worker.rb
-- mkdocs.yml
-- quality.loki
-- quality_rails.loki
-- sig/asgard.rbs
-- xyzzy.loki
-homepage: https://github.com/madbomber/asgard
+  - CHANGELOG.md
+  - LICENSE.txt
+  - README.md
+  - bin/asgard
+  - lib/asgard.rb
+  - lib/asgard/base.rb
+  - lib/asgard/base/dependency_graph.rb
+  - lib/asgard/base/dispatch.rb
+  - lib/asgard/base/registry.rb
+  - lib/asgard/base/task_dsl.rb
+  - lib/asgard/declarations.rb
+  - lib/asgard/doctor.rb
+  - lib/asgard/doctor/report.rb
+  - lib/asgard/doctor/task_sections.rb
+  - lib/asgard/errors.rb
+  - lib/asgard/jobs.rb
+  - lib/asgard/jobs/commands.rb
+  - lib/asgard/jobs/declaration.rb
+  - lib/asgard/jobs/launcher.rb
+  - lib/asgard/jobs/state.rb
+  - lib/asgard/jobs/stopper.rb
+  - lib/asgard/kernel_methods.rb
+  - lib/asgard/leading_flag.rb
+  - lib/asgard/pid.rb
+  - lib/asgard/schedule.rb
+  - lib/asgard/schedule/commands.rb
+  - lib/asgard/schedule/declaration.rb
+  - lib/asgard/schedule/job_files.rb
+  - lib/asgard/schedule/launchd.rb
+  - lib/asgard/schedule/systemd.rb
+  - lib/asgard/schedule/table.rb
+  - lib/asgard/shell.rb
+  - lib/asgard/state_dir.rb
+  - lib/asgard/tasks.rb
+  - lib/asgard/version.rb
+  - lib/asgard/watch.rb
+  - lib/asgard/watch/changes.rb
+  - lib/asgard/watch/commands.rb
+  - lib/asgard/watch/daemon.rb
+  - lib/asgard/watch/declaration.rb
+  - lib/asgard/watch/dispatcher.rb
+  - lib/asgard/watch/mailbox.rb
+  - lib/asgard/watch/reporter.rb
+  - lib/asgard/watch/spawn.rb
+  - lib/asgard/watch/state.rb
+  - lib/asgard/watch/worker.rb
+  - sig/asgard.rbs
+homepage: "https://github.com/madbomber/asgard"
 licenses:
-- MIT
+  - MIT
 metadata:
-  homepage_uri: https://github.com/madbomber/asgard
-  source_code_uri: https://github.com/madbomber/asgard
-  changelog_uri: https://github.com/madbomber/asgard/blob/master/CHANGELOG.md
-  rubygems_mfa_required: 'true'
+  homepage_uri: "https://github.com/madbomber/asgard"
+  source_code_uri: "https://github.com/madbomber/asgard"
+  changelog_uri: "https://github.com/madbomber/asgard/blob/main/CHANGELOG.md"
+  rubygems_mfa_required: "true"
 rdoc_options: []
 require_paths:
-- lib
+  - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      version: 3.2.0
+    -
+      - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      version: '0'
+    -
+      - ">="
+      - !ruby/object:Gem::Version
+        version: "0"
 requirements: []
-rubygems_version: 4.0.23
+rubygems_version: 4.1.0.beta3
 specification_version: 4
 summary: A powerful Ruby-based task runner
 test_files: []

data/.envrc

@@ -1,6 +0,0 @@
-# asgard/.envrc
-
-source_up
-
-export RR=`pwd`
-PATH_add $RR/bin

data/.github/workflows/deploy-github-pages.yml

@@ -1,52 +0,0 @@
-name: Deploy Documentation to GitHub Pages
-on:
-  push:
-    branches:
-      - main
-      - develop
-    paths:
-      - "docs/**"
-      - "mkdocs.yml"
-      - ".github/workflows/deploy-github-pages.yml"
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  pages: write
-  id-token: write
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: 3.x
-
-      - name: Install dependencies
-        run: |
-          pip install mkdocs
-          pip install mkdocs-material
-          pip install mkdocs-macros-plugin
-          pip install mike
-
-      - name: Configure Git
-        run: |
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
-
-      - name: Build MkDocs site
-        run: mkdocs build
-
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./site
-          keep_files: true

data/.loki

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-# Asgard gem's own task file.
-# Task is pre-defined by the gem — just reopen it to add tasks.
-
-import "quality.loki"
-# asgard runs as a separate process outside the app it's checking, so
-# `defined?(Rails)` never sees the app's Rails constant. RAILS_ROOT — set in
-# a Rails repo's own .envrc (`export RAILS_ROOT=$RR`, after RR is defined)
-# — is the signal instead.
-import "quality_rails.loki" if ENV["RAILS_ROOT"]
-
-import "gem_tasks.loki"
-import "git.loki"
-import "doc_tasks.loki"
-
-import "xyzzy.loki"  # An example for the --doctor flag
-
-class Tasks
-  @@project      ||= "asgard".freeze
-  @@project_desc ||= "CLI-task runner"
-
-  # Dogfood: `asgard watcher start` reruns the tests whenever a Ruby file changes.
-  watch :test_check, paths: %w[lib test], only: /\.rb\z/
-
-  desc "xyzzy"
-  def xyzzy = puts "everything in Ruby metaprogramming is magic"
-
-  helper(:project_version) do
-    @@project_version ||= File.read("lib/#{@@project}/version.rb").match(/VERSION\s*=\s*"([^"]+)"/)[1].freeze
-  end
-
-  default_task :quality
-
-  header <<~HEAD
-    Project:  #{@@project} (v#{project_version}) - #{@@project_desc}
-    Root Dir: #{loki_up.parent}
-    Default task: #{default_task}
-  HEAD
-end

data/.reek.yml

@@ -1,166 +0,0 @@
----
-detectors:
-
-  # Disabled: conflicts with project no-comment coding style.
-  IrresponsibleModule:
-    enabled: false
-
-  # Disabled: bang methods without non-bang counterparts are common in internal APIs.
-  MissingSafeMethod:
-    enabled: false
-
-  # Disabled: explicit nil checks are idiomatic Ruby (nil? / unless nil, etc.).
-  NilCheck:
-    enabled: false
-
-  # Disabled: method size/complexity is already covered by Flog (the primary
-  # complexity gate) and RuboCop's Metrics/MethodLength.
-  TooManyStatements:
-    enabled: false
-
-  # Default is 4 — Doctor legitimately tracks several pieces of diagnostic state.
-  TooManyInstanceVariables:
-    max_instance_variables: 6
-    exclude:
-      - Asgard::Watch::Daemon  # wires reporter, dispatcher, listeners, inbox and the stop flag for one run
-
-  # Accept standard Ruby short-name conventions for limited-scope variables.
-  UncommunicativeVariableName:
-    accept:
-      - _    # intentionally ignored
-      - d    # dep / dir / data
-      - e    # rescue => e
-      - f    # file / finding
-      - h    # hash
-      - i    # index
-      - k    # key
-      - p    # path
-      - t    # task / thread
-
-  # Reviewed and accepted as false positives / intentional design, per method
-  # (generated with `reek --todo` and hand-curated — see project review notes).
-  # Unlike a count-based baseline, this is precise: it grandfathers exactly
-  # these smells at exactly these methods, so a genuinely new smell at a new
-  # or existing method still fails the gate even if it doesn't change the
-  # file's total warning count.
-  Attribute:
-    exclude:
-      - Asgard::Doctor::ImportTracer#doctor # needs to stay settable/resettable per doctor run
-      - Asgard::Schedule#runner                     # test seam: tests swap in a recording runner, nil restores RUNNER
-
-  BooleanParameter:
-    exclude:
-      - Asgard::Base#help          # must match Thor's positional super signature exactly
-      - Asgard::Shell#sh           # silent: is the real public API contract
-      - Asgard::Shell#shebang      # same
-
-  ControlParameter:
-    exclude:
-      - Asgard::Shell#sh
-      - Asgard::Shell#shebang
-      - Asgard::Schedule#entry_name                 # as: is the user's explicit override of the derived name
-      - Asgard::Watch#normalize                     # same: as: overrides the task name as the entry name
-
-  DuplicateMethodCall:
-    exclude:
-      - Asgard::Base::Dispatch#acquire_run_token  # done.include?(target): check, then poll-until-true
-      - Asgard::Base::Dispatch#run_dep_group      # errors.size: two branches of one guard
-      - Asgard::Doctor::Report#print_report       # puts divider: intentional top+bottom rule
-      - Asgard::Doctor::Report#summary_line       # errors.zero?: sequential guard clauses
-      - Asgard::Doctor#load_chain                 # Base.subclasses: before/after snapshot diff
-      - Kernel#import_up                          # "not found" warned from two independent branches
-      - Asgard#self.run!                          # Base.subclasses snapshot diff; e.message in separate rescues
-      - Asgard::Base#tree                          # say "\n": intentional blank line before and after the tree
-      - Asgard::Schedule::Launchd#unload             # loaded?(name): check, then poll until bootout finishes
-
-  FeatureEnvy:
-    exclude:
-      - Asgard::Base::Dispatch#acquire_run_token
-      - Asgard::Base::Dispatch#run_dep_group
-      - Asgard::Base::Dispatch#signal_done
-      - Asgard::Base::Registry#inherited            # inherited(subclass) configuring subclass is the whole point
-      - Asgard::Base::DependencyGraph#_normalize_pending_deps # small transform of its own argument
-      - Asgard::Base::DependencyGraph#_call_dep_proc          # rescue => e; e.class/e.message is inherent
-      - Asgard::Base::DependencyGraph#_validate_dep_stage!    # pure shape check of its own argument
-      - Asgard::Base::DependencyGraph#_validate_dep_leaf!     # pure shape check of its own argument
-      - Asgard::Doctor::TaskSections#class_task_file_map
-      - Asgard::Doctor::TaskSections#relative_path
-      - Asgard::Doctor::TaskSections#task_status
-      - Asgard::Shell#shebang                       # Tempfile.create(&block) idiom
-
-  ManualDispatch:
-    exclude:
-      - Asgard::Base::DependencyGraph#_normalize_pending_deps # respond_to?(:call) distinguishes a Proc from an Array/Symbol — no polymorphic alternative over Ruby's own built-in types
-      - Asgard::Base::DependencyGraph#_resolve_lazy_deps!     # same check
-      - Asgard::Schedule#seconds                         # duck-types ActiveSupport::Duration (in_seconds) without depending on it
-
-  InstanceVariableAssumption:
-    exclude:
-      - Asgard::Base    # class-level DSL state built up across method_added/inherited, not object init
-      - Asgard::Doctor  # multi-phase report builder; @ivars set across report_markers/load_chain/etc in `run`
-
-  NestedIterators:
-    exclude:
-      - Asgard::Base::DependencyGraph#_build_dep_graph
-      - Asgard::Base::DependencyGraph#_check_dep_arities!
-      - Asgard::Base::TaskDSL#no_negate               # inner block defines a method, isn't really iteration
-      - Asgard::Doctor::Report#print_task_sections
-      - Asgard::Doctor::TaskSections#class_task_file_map
-      - Asgard::Doctor::TaskSections#override_count
-      - Asgard::Schedule::Commands#preview            # specs x files per spec
-      - Asgard::Schedule::Launchd#self.calendar_intervals # times x weekdays
-
-  UtilityFunction:
-    exclude:
-      - Asgard::Base::DependencyGraph#_build_dep_graph # genuinely pure, but tightly coupled to this graph model
-      - Asgard::Base::Dispatch#dep_results             # thread-local by design, not self — that's the whole point
-      - Asgard::Base::Dispatch#with_dep_results        # same: stashes results on Thread.current, not self
-      - Asgard::Shell#shell_argv                       # extracted pure on purpose so it's testable without invoking system/exec
-      - Asgard::Schedule::DSL#schedule                 # class-level DSL delegating to the Schedule registry
-      - Asgard::Watch::DSL#watch                       # same, for the Watch registry
-      - Asgard::Schedule::Commands#schedules           # Thor no_commands helpers: reads of the registry / CWD shared by the subcommands
-      - Asgard::Schedule::Commands#schedule_root
-      - Asgard::Schedule::Commands#schedule_summary
-      - Asgard::Watch::Commands#watches                # same: the Watch registry read by every subcommand
-
-  # Asgard::Schedule: the backends implement a fixed API (see
-  # lib/asgard/schedule/declaration.rb) plus pure, separately tested helpers,
-  # and the keyword parameters below mirror launchd/systemd job fields and the
-  # `schedule` DSL's own keywords.
-  DataClump:
-    exclude:
-      - Asgard::Schedule                            # at:/on: and task/args are the declaration's vocabulary
-      - Asgard::Watch::Spawn                        # spec + context are the two inputs of every spawn function
-
-  LongParameterList:
-    exclude:
-      - Asgard::Schedule#normalize                  # the `schedule` DSL keywords
-      - Asgard::Watch#normalize                     # the `watch` DSL keywords
-      - Asgard::Schedule#describe
-      - Asgard::Schedule#program_arguments
-      - Asgard::Schedule::Table#self.draw            # rows plus the title, io and headers the caller chooses
-      - Asgard::Schedule::Launchd#self.plist        # one keyword per plist field
-      - Asgard::Schedule::Systemd#self.service_unit # one keyword per unit field
-      - Asgard::Schedule::Systemd#self.timer_unit
-      - Asgard::Schedule::Systemd#initialize        # injectable home/runner/env/user for tests
-      - Asgard::Watch::Dispatcher#initialize        # injectable worker starter and clock for tests
-      - Asgard::Watch::Daemon#initialize            # injectable listen/exec/out for tests
-
-  RepeatedConditional:
-    exclude:
-      - Asgard::Schedule::Launchd                   # loaded?(name) guards distinct launchctl transitions
-
-  TooManyMethods:
-    exclude:
-      - Asgard::Schedule::Commands                  # one method per subcommand plus its helpers
-      - Asgard::Watch::Commands                     # same
-      - Asgard::Schedule::Launchd                   # backend API + pure helpers
-      - Asgard::Schedule::Systemd
-      - Asgard::Watch::State                        # one reader/writer pair per file it keeps
-
-
-exclude_paths:
-  - test
-  - docs
-  - coverage
-  - pkg