maf 0.2.0 → 0.3.0

data/lib/maf/worker_list.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# worker_list.rb - list the workers that run now: sessions and dispatchers.
+require "json"
+require "time"
+require_relative "workers"
+require_relative "shared/processes"
+
+module Maf
+  # WorkerList shows each running worker process of the project. A worker
+  # can run twice, for example as a session and as a dispatcher.
+  class WorkerList
+    Row = Struct.new(:worker, :role, :harness, :mode, :pid, :started)
+    HEADER = %w[WORKER ROLE HARNESS MODE PID STARTED].freeze
+    LSTART = "%a %b %d %H:%M:%S %Y %z"
+
+    def initialize(root)
+      @root = root
+      @workers = Workers.at(root)
+    end
+
+    def run
+      rows = running
+      puts rows.empty? ? "No worker runs." : table([HEADER] + rows.map { |row| row.to_a.map(&:to_s) }), warnings(rows)
+    end
+
+    private
+
+    def running = (sessions + dispatchers + registered).uniq(&:pid).sort_by { |row| [row.worker, row.mode] }
+
+    def coord_dir = File.join(@root, ".maf", "coordination")
+    def records(dir, pattern) = Dir.glob(File.join(coord_dir, dir, pattern)).map { |path| [path, read(path)] }
+
+    def sessions
+      records("sessions", "*.maf.json").filter_map do |path, record|
+        row(record, "session") if session_live?(record["pid"], File.mtime(path))
+      end
+    end
+
+    def session_live?(pid, registered)
+      started = Shared::Processes.started_at(pid)
+      Shared::Processes.alive?(pid) && !started.empty? && Time.strptime("#{started} +0000", LSTART) <= registered
+    rescue ArgumentError
+      false
+    end
+
+    def dispatchers
+      records("presence", "*.json").filter_map do |_, entry|
+        row(entry, "dispatch") if entry["mode"] == "dispatch" && Shared::Processes.live?(entry)
+      end
+    end
+
+    def registered
+      @workers.all.filter_map do |worker, entry|
+        row(entry.merge("worker" => worker), "dispatch") if @workers.dispatcher?(worker)
+      end
+    end
+
+    def row(data, mode)
+      entry = @workers.find(data["worker"]).to_h
+      Row.new(data["worker"], data["role"] || entry["role"], data["harness"] || entry["harness"], mode,
+              data["pid"].to_i, Shared::Processes.started_at(data["pid"]))
+    end
+
+    def table(lines)
+      widths = lines.transpose.map { |column| column.map(&:size).max }
+      lines.map { |line| line.zip(widths).map { |text, width| text.ljust(width) }.join("  ").rstrip }
+    end
+
+    def warnings(rows)
+      twice = rows.group_by(&:worker).select { |_, list| list.size > 1 }
+      stopped = @workers.all.keys - rows.map(&:worker)
+      twice.map { |worker, list| "warning: #{worker} runs #{list.size} times (pids #{list.map(&:pid).join(", ")})" } +
+        (stopped.empty? ? [] : ["stopped: #{stopped.join(", ")}"])
+    end
+
+    def read(path)
+      JSON.parse(File.read(path))
+    rescue JSON::ParserError, SystemCallError
+      {}
+    end
+  end
+end

data/templates/roles.yml

@@ -4,6 +4,9 @@
 # the model with --model ROLE=MODEL. If the user does not choose a model,
 # claude roles get lib/maf/flow.rb's DEFAULT_MODELS entry (claude-opus-5-5).
 #
+# `effort` is the default effort level. A role gets it when the harness lists
+# the level. --effort ROLE=LEVEL overrides it. A lower level uses fewer tokens.
+#
 # `description` is also the routing line in the architect's "Available roles"
 # list. Keep it short and specific to the role.
 #
@@ -42,6 +45,7 @@ roles:
       - If a message starts with "ESCALATION", a role cannot fix a problem. Tell the user in plain words:
         what failed, which task, and the impact. Give two or three options with a recommended one.
         Wait for the answer. Then send the answer to the role with `coord msg`.
+        If the escalation names a blocked task, run `coord unblock <id>` after you send the answer.
       - If the architect escalates a repeated review failure, forward the
         options to the user. Do not send a new goal until the user decides.
 
@@ -53,6 +57,7 @@ roles:
       - Process detail in reports. The user needs outcomes and decisions.
       - Optimistic status. Report blockers and failed checks as they are.
     model_hint: "Strongest reasoning and long context, conversational. Cloud: Claude Opus 5.5 (default for the claude harness), GPT-5.x."
+    effort: medium
     can_edit: false
 
   architect:
@@ -84,6 +89,8 @@ roles:
         Goal, Inputs, Out of scope, Acceptance, Report format.
         A worker drifts if a field is missing.
       - Write acceptance criteria as exact test files or commands. The worker runs each one before coord done.
+      - A message `BLOCKED task <id> (dependency)` waits for other work. Plan or order that work.
+        When it lands, run `coord unblock <id>`. A blocked task stays out of `coord next` until then.
       - If a review rejects the same kind of problem two times, stop the fix
         loop. Send the project manager two or three options with the cost of
         each option. A third patch of the same kind usually fails too.
@@ -96,6 +103,7 @@ roles:
       - Code in task specs. Describe behavior and constraints instead.
       - Trust in a worker report without a diff check.
     model_hint: "Strongest reasoning and long context. Cloud: Claude Opus 5.5 (default for the claude harness), GPT-5.x, deepseek-v4."
+    effort: high
     can_edit: false
 
   backend-developer:
@@ -123,6 +131,7 @@ roles:
       - Edits to a test that looks wrong. Report the test to the architect.
       - Claims about code that you did not read.
     model_hint: "A strong code model. A local Qwen3.8-27B is enough for well-scoped tasks; use a cloud coder for hard or large changes."
+    effort: medium
     can_edit: true
 
   frontend-developer:
@@ -149,6 +158,7 @@ roles:
       - Values that are hard-coded to make a test pass.
       - Visual changes outside the task scope.
     model_hint: "Same as backend-developer: local coder for scoped work, cloud coder for hard UI work."
+    effort: medium
     can_edit: true
 
   tester:
@@ -174,6 +184,7 @@ roles:
       - Assertions that only repeat the implementation.
       - Deleted or weakened tests. A test removal needs architect approval.
     model_hint: "Mechanical test work usually fits a local coder model; use cloud for subtle failure analysis."
+    effort: low
     can_edit: true
 
   reviewer:
@@ -216,6 +227,7 @@ roles:
       - Style comments that the project's linter already covers.
       - A warning or minor finding labeled critical to force another round.
     model_hint: "Judgment-heavy. Prefer a cloud model with strong review ability."
+    effort: high
     can_edit: false
 
   skeptic:
@@ -252,6 +264,7 @@ roles:
       - A warning or minor finding labeled critical to force another round.
       - Style comments. The reviewer and the linter cover style.
     model_hint: "Judgment-heavy. Use a different model family from reviewer and auditor, for example GPT-5.x if reviewer runs Claude. Different models miss different defects."
+    effort: high
     can_edit: false
 
   auditor:
@@ -286,4 +299,5 @@ roles:
       - A warning or minor finding labeled critical to force another round.
       - Style comments. The reviewer and the linter cover style.
     model_hint: "Judgment-heavy. Use a different model family from reviewer and skeptic, for example Gemini, Grok, or a strong local model. Different models miss different defects."
+    effort: high
     can_edit: false

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: maf
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Dominik Alberski
@@ -83,8 +83,10 @@ files:
 - lib/maf/flow/agent_links.rb
 - lib/maf/flow/bootstrapper.rb
 - lib/maf/flow/codex_hooks.rb
+- lib/maf/flow/effort_report.rb
 - lib/maf/flow/generator.rb
 - lib/maf/flow/harness_linker.rb
+- lib/maf/flow/hermes_env_setup.rb
 - lib/maf/flow/hermes_hook.rb
 - lib/maf/flow/hermes_hook_setup.rb
 - lib/maf/flow/hook_files.rb
@@ -178,6 +180,7 @@ files:
 - lib/maf/vm/template.rb
 - lib/maf/worker_archive.rb
 - lib/maf/worker_control.rb
+- lib/maf/worker_list.rb
 - lib/maf/workers.rb
 - templates/role-stub.yml.erb
 - templates/roles.yml