agentilda 1.0.3 → 2.0.0

data/lib/agentilda/unblocker.rb

@@ -147,9 +147,18 @@ module Agentilda
       return [] if subjects.empty?
 
       before = subjects.map { |subject| [subject.feature.ordinal.to_s, self.class.questions(subject)] }.to_h
-      results = UI.concurrently(subjects, headline(subjects), jobs: 1, label: method(:label),
-        fields: method(:log_fields)) do |subject, progress|
-        invoke(subject, &progress)
+      results = UI.concurrently(subjects,
+        headline(subjects),
+        jobs:   1,
+        label:  method(:label),
+        fields: method(:log_fields),
+        file:   ->(_) { "blocked.md" },
+        root:) do |subject, progress|
+        # After ctrl-c the plans not yet started stay as they are, blocked.md
+        # untouched, so the next run picks them up from the beginning.
+        next [false, "not started: interrupted by ctrl-c"] if Control.interrupted?
+
+        invoke(subject, progress)
       end
 
       settle
@@ -159,11 +168,13 @@ module Agentilda
     private
 
     # @param subject [Agentilda::Subject]
-    # @yieldparam phrase [String] what the agent is doing, as it changes
+    # @param progress [Agentilda::UI::Line] a dashboard row carries the
+    #   executor handle its kill and extend keys act on; a plain line does not
     # @return [Array(Boolean, String)]
-    def invoke(subject, &on_activity)
-      @executor.call(agent, subject, root:, &on_activity)
-    rescue => e
+    def invoke(subject, progress)
+      handle = progress.handle if progress.is_a?(Dashboard::Tracker)
+      @executor.call(agent, subject, root:, handle:, &progress)
+    rescue StandardError => e
       [false, "#{e.class}: #{e.message.lines.first.to_s.strip}"]
     end
 
@@ -185,15 +196,18 @@ module Agentilda
       ok, note = result.is_a?(Exception) ? [false, result.message.lines.first.to_s.strip] : result
       current = tree.find(subject.feature.ordinal) || subject
 
-      Outcome.new(subject: current, ok: !!ok, note: note.to_s,
-        before: before.fetch(subject.feature.ordinal.to_s, []), after: self.class.questions(current))
+      Outcome.new(subject: current,
+        ok: !!ok,
+        note: note.to_s,
+        before: before.fetch(subject.feature.ordinal.to_s, []),
+        after: self.class.questions(current))
     end
 
     # @param subjects [Array<Agentilda::Subject>]
     # @return [String]
     def headline(subjects)
       "#{commit? ? "handing" : "would hand"} #{subjects.size} plan#{"s" unless subjects.size == 1} " \
-      "to #{agent.name} in #{root}"
+        "to #{agent.name} in #{root}"
     end
 
     # @param subject [Agentilda::Subject]
@@ -202,6 +216,6 @@ module Agentilda
 
     # @param subject [Agentilda::Subject]
     # @return [Hash] the columns this plan's log lines carry
-    def log_fields(subject) = {plan: subject.feature.ordinal.to_s, status: subject.status.to_s, agent: agent.name}
+    def log_fields(subject) = { plan: subject.feature.ordinal.to_s, status: subject.status.to_s, agent: agent.name }
   end
 end

data/lib/agentilda/version.rb

@@ -6,5 +6,5 @@
 #
 # © 2026 Konstantin Gredeskoul
 module Agentilda
-  VERSION = "1.0.3"
+  VERSION = "2.0.0"
 end

data/lib/agentilda/worktree.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require "fileutils"
+require "shellwords"
+
 module Agentilda
   # A git worktree per plan, so agents working on different plans cannot
   # collide at all.
@@ -103,36 +106,29 @@ module Agentilda
     # and friends, and credential keys.
     #
     # Never fatal. A repository with no ignored files is perfectly normal, and
-    # a plan is not worth abandoning over a seeding step, so this reports and
-    # carries on. It runs `--quiet`, which prints nothing on success and leaves
-    # a real failure on STDERR where the loop's other progress goes.
+    # a plan is not worth abandoning over a seeding step, so this notes it and
+    # carries on.
+    #
+    # The note goes to the progress log, never the terminal: this runs while
+    # the ratatui dashboard owns the screen, and a line written to STDERR
+    # lands on top of an agent's row. The seeder's own output is silenced for
+    # the same reason. A suite that later dies on a missing key is explained
+    # by the log line.
     #
     # @param path [String] the worktree to seed
     # @return [Boolean] whether the seeder ran and succeeded
-    # `$stderr` rather than `Kernel#warn`, matching {Agentilda::UI}, which
-    # writes its progress to `$stderr` too. Style/StderrPuts prefers warn so the
-    # output can be silenced, but warn reaches file descriptor 2 through
-    # `Warning.warn` and ignores a reassigned `$stderr` entirely:
-    #
-    #   $stderr = StringIO.new; warn "x"; $stderr.string  # => ""
-    #
-    # So anything capturing this loop's output, the suite included, would never
-    # see a seeding failure. Being silenceable is worth less than being seen.
-    # rubocop: disable Style/StderrPuts
     def seed(path)
       unless File.executable?(SEEDER)
-        $stderr.puts "worktree: #{SEEDER} is missing, so #{path} has no .env or credential keys"
+        UI.log("worktree: #{SEEDER} is missing, so #{path} has no .env or credential keys")
         return false
       end
 
-      return true if system(SEEDER, "--quiet", path, out: File::NULL)
+      return true if system(SEEDER, "--quiet", path, out: File::NULL, err: File::NULL)
 
-      $stderr.puts "worktree: could not seed #{path}; its suite may fail on a missing key"
+      UI.log("worktree: could not seed #{path}; its suite may fail on a missing key")
       false
     end
 
-    # rubocop: enable Style/StderrPuts
-
     # @param feature [Agentilda::Feature]
     # @return [String] e.g. "kig/002.00-tenancy-households"
     def branch_for(feature) = "#{@user}/#{feature.ordinal}-#{feature.slug}"

data/lib/agentilda.rb

@@ -1,25 +1,41 @@
 # frozen_string_literal: true
 
+# Help screens come from dry-cli-help, which prepends itself to Dry::CLI the
+# moment it loads, so it has to load before the registry's `help` block runs.
 require "dry/cli"
-require_relative "dry/cli/banner"
-require "dry/monads"
+require "dry/cli/help"
+
 require "dry/inflector"
-require "pastel"
-require "unicode/display_width"
-require "strings"
-require "tty/box"
-require "tty/command"
-require "tty/screen"
-require "tty/progressbar"
-require "tty/spinner"
-require "concurrent/array"
-require "concurrent/hash"
-require "etc"
 require "fileutils"
-require "tempfile"
-require "tmpdir"
 require "shellwords"
-require "parallel"
+require "zeitwerk"
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect(
+  "api"        => "API",
+  "cli"        => "CLI",
+  "github"     => "GitHub",
+  "issue"      => "Issues",
+  "list_plans" => "ListPlans",
+  "unit"       => "Units",
+  "ui"         => "UI"
+)
+loader.collapse("#{__dir__}/agentilda/cli/create")
+loader.collapse("#{__dir__}/agentilda/cli/docs")
+loader.collapse("#{__dir__}/agentilda/cli/index")
+loader.collapse("#{__dir__}/agentilda/cli/list_plans")
+loader.collapse("#{__dir__}/agentilda/cli/run")
+loader.collapse("#{__dir__}/agentilda/cli/states")
+loader.collapse("#{__dir__}/agentilda/cli/unblock")
+loader.collapse("#{__dir__}/agentilda/cli/version")
+loader.collapse("#{__dir__}/agentilda/cli/worktree")
+loader.collapse("#{__dir__}/agentilda/cli/agents/subcommands")
+loader.collapse("#{__dir__}/agentilda/cli/linear/subcommands")
+loader.collapse("#{__dir__}/agentilda/cli/mail/subcommands")
+loader.collapse("#{__dir__}/agentilda/cli/resync/subcommands")
+loader.ignore("#{__dir__}/agentilda/cli/linear/linear.rb")
+loader.ignore("#{__dir__}/agentilda/cli/mail/mail.rb")
+loader.ignore("#{__dir__}/agentilda/linear/mapping.rb")
+loader.setup
 
 # Spec → Plan → Build.
 #
@@ -34,13 +50,11 @@ require "parallel"
 # vocabulary, the numbering rules and the transition table live here and are
 # emitted by `agentilda docs`. Three hand-maintained copies of that table
 # have already drifted apart, which is why there is now exactly one.
-#
-require_relative "agentilda/version"
 
 # © 2026 Konstantin Gredeskoul
 module Agentilda
   # The folder every project keeps its plans in.
-  PLANS_DIR = ".plans"
+  PLANS_DIR = ENV.fetch("PLANS_DIR", ".plans")
 
   # Prefix for a pull request that deliberately implements no plan —
   # dependency bumps, CI work, hotfixes, developer tooling.
@@ -57,8 +71,8 @@ module Agentilda
   # Unlike `dev` this asserts nothing; it marks a question left open.
   NONE_PREFIX = "none"
 
-  # @return [Dry::Inflector] shared inflector
-  def self.inflector = @inflector ||= Dry::Inflector.new
+  # @return [Dry::Inflector] shared Inflector
+  def self.inflector = @inflector ||= ::Dry::Inflector.new
 
   # Move a directory, preferring `git mv` so its history follows it.
   #
@@ -73,10 +87,22 @@ module Agentilda
     return false if File.exist?(target)
 
     parent = File.dirname(source)
-    tracked = system("git", "-C", parent, "ls-files", "--error-unmatch", source,
-      out: File::NULL, err: File::NULL)
-    moved = tracked && system("git", "-C", parent, "mv", source, target,
-      out: File::NULL, err: File::NULL)
+    tracked = system("git",
+      "-C",
+      parent,
+      "ls-files",
+      "--error-unmatch",
+      source,
+      out: File::NULL,
+      err: File::NULL)
+    moved = tracked && system("git",
+      "-C",
+      parent,
+      "mv",
+      source,
+      target,
+      out: File::NULL,
+      err: File::NULL)
     FileUtils.mv(source, target) unless moved
     true
   end
@@ -108,48 +134,9 @@ module Agentilda
   class Error < StandardError; end
 end
 
-# Each component is required only once it exists, so the suite loads — and
-# stays a useful red/green signal — while the rest is being built. Drop the
-# `File.exist?` guard once every file below is in place.
-%w[
-  ui
-  config
-  ordinal
-  status
-  progress_log
-  state_machine
-  dev_work
-  frontmatter
-  markdown
-  pull_request
-  description
-  feature
-  github
-  tree
-  creator
-  brief
-  adoption
-  resolver
-  resync
-  reporter
-  tally
-  index
-  linear
-  agent
-  transcript
-  roster
-  viewer
-  worktree
-  publisher
-  control
-  keyboard
-  executor
-  runner
-  unblocker
-  documentation
-  diagram
-  cli
-].each do |component|
-  path = File.join(__dir__, "agentilda", "#{component}.rb")
-  require path if File.exist?(path)
-end
+# status.rb and feature.rb define methods on Agentilda itself (`status`,
+# `plan_dirname`, `titleize` and friends) beside the class each is named for.
+# Zeitwerk loads a file when its constant is first named, and a caller of
+# `Agentilda.status` names no constant, so without this those methods exist
+# or not depending on what happened to load first.
+%w[status feature].each { |name| loader.load_file("#{__dir__}/agentilda/#{name}.rb") }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agentilda
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 2.0.0
 platform: ruby
 authors:
 - Konstantin Gredeskoul
@@ -55,16 +55,44 @@ dependencies:
   name: dry-cli-autocomplete
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: dry-cli-help
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: dry-cli-ui
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: dry-inflector
   requirement: !ruby/object:Gem::Requirement
@@ -136,7 +164,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: strings
+  name: ratatui_ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -178,7 +206,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tty-progressbar
+  name: tty-cursor
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -206,7 +234,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tty-spinner
+  name: unicode-display_width
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -220,7 +248,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: unicode-display_width
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -246,8 +274,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- Gemfile
-- Gemfile.lock
 - agentilda.gemspec
 - agents/hansolo-reviewer.md
 - agents/lando-broker.md
@@ -256,14 +282,18 @@ files:
 - agents/palpatine-planner.md
 - agents/rey-frontend.md
 - agents/yoda-writer.md
-- bin/create-plan-folder
 - bin/plan-number
+- bin/setup
 - exe/agentilda
 - exe/tilda
+- exe/tilda-rs
 - lib/agentilda.rb
 - lib/agentilda/adoption.rb
 - lib/agentilda/agent.rb
+- lib/agentilda/agents.rb
+- lib/agentilda/board.rb
 - lib/agentilda/brief.rb
+- lib/agentilda/child.rb
 - lib/agentilda/cli.rb
 - lib/agentilda/cli/agents/subcommands/describe.rb
 - lib/agentilda/cli/agents/subcommands/list.rb
@@ -275,17 +305,25 @@ files:
 - lib/agentilda/cli/linear/subcommands/import.rb
 - lib/agentilda/cli/linear/subcommands/projects.rb
 - lib/agentilda/cli/list_plans/list_plans.rb
+- lib/agentilda/cli/mail/mail.rb
+- lib/agentilda/cli/mail/subcommands/read.rb
+- lib/agentilda/cli/mail/subcommands/send.rb
 - lib/agentilda/cli/resync/subcommands/dirs.rb
 - lib/agentilda/cli/resync/subcommands/prs.rb
 - lib/agentilda/cli/run/run.rb
 - lib/agentilda/cli/states/states.rb
 - lib/agentilda/cli/unblock/unblock.rb
 - lib/agentilda/cli/version/version.rb
+- lib/agentilda/cli/worktree/worktree.rb
+- lib/agentilda/clock.rb
 - lib/agentilda/config.rb
+- lib/agentilda/console.rb
 - lib/agentilda/control.rb
 - lib/agentilda/creator.rb
+- lib/agentilda/dashboard.rb
 - lib/agentilda/dev_work.rb
 - lib/agentilda/diagram.rb
+- lib/agentilda/dispatcher.rb
 - lib/agentilda/documentation.rb
 - lib/agentilda/executor.rb
 - lib/agentilda/feature.rb
@@ -293,6 +331,8 @@ files:
 - lib/agentilda/github.rb
 - lib/agentilda/index.rb
 - lib/agentilda/keyboard.rb
+- lib/agentilda/launcher.rb
+- lib/agentilda/ledger.rb
 - lib/agentilda/linear.rb
 - lib/agentilda/linear/api.rb
 - lib/agentilda/linear/attribution.rb
@@ -303,17 +343,24 @@ files:
 - lib/agentilda/linear/push.rb
 - lib/agentilda/linear/survey.rb
 - lib/agentilda/linear/unit.rb
+- lib/agentilda/mailbox.rb
 - lib/agentilda/markdown.rb
 - lib/agentilda/ordinal.rb
 - lib/agentilda/progress_log.rb
 - lib/agentilda/publisher.rb
 - lib/agentilda/pull_request.rb
+- lib/agentilda/pull_requests.rb
 - lib/agentilda/reporter.rb
 - lib/agentilda/resync.rb
 - lib/agentilda/roster.rb
 - lib/agentilda/runner.rb
+- lib/agentilda/screen/ratatui.rb
+- lib/agentilda/screen/ratatui/bar.rb
+- lib/agentilda/screen/ratatui/key_translator.rb
+- lib/agentilda/state_file.rb
 - lib/agentilda/state_machine.rb
 - lib/agentilda/status.rb
+- lib/agentilda/subject.rb
 - lib/agentilda/tally.rb
 - lib/agentilda/transcript.rb
 - lib/agentilda/tree.rb
@@ -322,7 +369,6 @@ files:
 - lib/agentilda/version.rb
 - lib/agentilda/viewer.rb
 - lib/agentilda/worktree.rb
-- lib/dry/cli/banner.rb
 homepage: https://github.com/kigster/agentilda
 licenses: []
 metadata:
@@ -336,14 +382,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '4.0'
+      version: '3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.20
 specification_version: 4
 summary: 'Agentic specification-driven development: spec, plan, build, review'
 test_files: []

data/Gemfile

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# What agentilda needs in order to run is declared in the gemspec beside this
-# file, so there is one list rather than two that drift. What is left here is
-# only what you need in order to work on it.
-gemspec
-
-gem "rake"
-gem "yard"
-
-group :development do
-  gem "colored2"
-  gem "irb"
-  gem "standard"
-end
-
-group :test do
-  gem "coverage-badge"
-  gem "json_schemer" # validates configuration.example.yml against configuration.schema.json
-  gem "rspec"
-  gem "rspec-its"
-  gem "rspec_junit_formatter" # JUnit XML for CircleCI store_test_results
-  gem "simplecov"
-end