mcptask-rails-runner 0.3.18-aarch64-linux → 0.3.19-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99987510bd98763ce26293238e43d2758d6ea62595b68bf878b6abf891e074a5
-  data.tar.gz: 5c9bea0cc358abe46eda3013a6c3a4f149cab91c0afa41a00441f8f90cdc0b81
+  metadata.gz: c41fe0c5aa1f09717740d4fa9c16248f40f93589544671a3c7a24983372be936
+  data.tar.gz: 1a1f66c63d8fd588faf4b0dbb4635315fb239580779a068a440025b956a2461b
 SHA512:
-  metadata.gz: 71a39c423229898cdf9c7ae0ffaa7c9cef068609d03c5c8cffae61e6b29cd7899b43fa53704220be9561d53f7be7424dad85ab829e6357f098c402c5fd391bd1
-  data.tar.gz: c5d220c2bb81dbf6a90cb34a785d1cb76e97294fa7ff36a3a1b7f438f4c800d19d4ebad691e5ebbc4f70a16df295948ea5658c98ff07e7ff43f326727339179c
+  metadata.gz: a05eff5b3e5dfc703a7ccfc7b8631f728afa75c8445b6d7a15f52b288a7523c42332aa531f5bad2e5caecdf8e17a87244b36df0534e4d95f615d9a8f64a9cbf1
+  data.tar.gz: a4b40dd33eaba23092c78bfbd705bc9a257ecf17df6c8d652ce68f655ba0f893bfcfbdcaba227b4f31d069aa86b36daf642b763ed5ec36db2e7174dfc5b9cf98

data/CHANGELOG.md

@@ -5,6 +5,90 @@ entries below describe wrapper changes only. Binary changes are listed in the
 [mcptask-releases](https://github.com/jchsoft/mcptask-releases/releases)
 release notes for the same tag.
 
+## Unreleased
+
+## 0.3.19
+
+**Upgrading:** `bundle update mcptask-rails-runner` in each project for the
+wrapper change, and `mcptask_runner update --self` on each host for the binary
+ones — the installed copy is per machine, so the project bump alone does not
+change what the 08:00 job runs. Both binary changes below are prompt text sent
+to the child, so they take effect on the next run the updated binary starts;
+there is nothing to migrate.
+
+- The line `Binary.install!` prints just before it hands over with `exec` is
+  coloured like everything the binary prints after it: green for a first
+  install and for the same version laid down again, yellow for replacing an
+  older copy, for keeping a newer one, and for `MCPTASK_RUNNER_BIN` diverting
+  the install. Until now it was the last grey line on the screen, sitting in
+  front of a coloured wall and looking like the least important thing there
+  while being the only line that reports a binary was replaced.
+
+  The palette is a deliberate copy of the binary's own rather than a second
+  opinion — `MCPTASK_RUNNER_COLOR` first and winning both ways, then
+  `NO_COLOR`, then `TERM=dumb`, then whether the stream is a terminal, and on
+  Windows the terminal has to advertise ANSI. Both halves of
+  `rake mcptask_runner:update` now answer that question the same way, and a
+  redirect or a pipe still gets exactly the bytes it got before.
+
+Binary changes carried by this version:
+
+- Every numbered workflow step that does real work now carries its own "LOG
+  PROGRESS NOW" line, and each one names the `TaskUpdate` that closes the same
+  step's todo item. A run on 2026-08-25 opened its pull request having logged
+  nothing at all, while its plan moved on the dashboard the whole time: three
+  anchors sat on the auto-squash spine, the seven steps between them said
+  nothing about logging, and the three manual workflows had no anchor anywhere
+  — only the block that sits past the last numbered step, which is the
+  arrangement already known not to get read. Hanging the log on the call the
+  child does make reliably is what ties the effort trail to the plan.
+- The child is told to search inside the project directory and never to run
+  `find /` or `find ~`. That walk enters macOS's protected folders, and the
+  permission dialog it raises names mcptask_runner and blocks the call until it
+  times out — at 08:02 there is nobody there to answer it. The instruction
+  names where to look instead: `bundle show` / `gem which` for Ruby, `go env
+  GOMODCACHE` for Go.
+
+## 0.3.18
+
+No wrapper changes. Full notes in
+[mcptask-releases v0.3.18](https://github.com/jchsoft/mcptask-releases/releases/tag/v0.3.18).
+
+**Upgrading:** run `mcptask_runner update --self` on each host. Both changes
+below are binary behaviour, and the first of them is visible in the output of
+the very command that installs it — so the run that replaces the binary is
+still grey, and every run after it is not.
+
+Binary changes carried by this version:
+
+- The install and update output is coloured, so the one row that needs a look
+  no longer reads exactly like the thirty that do not: green for up-to-date
+  and added, yellow for updated and force-updated, red for conflict-skipped,
+  dimmed section tags, and warnings in red on stderr. It is decided per stream
+  and only when the stream is really a terminal, so a pipe, a redirect and a
+  launchd log get the bytes they always got; `MCPTASK_RUNNER_COLOR` and
+  `NO_COLOR` override.
+- A child's process group is remembered when the child starts, so anything it
+  leaves behind is still reachable after it exits. A process group outlives
+  its leader, but the kernel can no longer name that group once the leader has
+  been reaped — and the kill path used to ask at kill time, get nothing, and
+  signal a bare pid that no longer resolved. Anything a child started and then
+  exited on went on running: a dev server, a backgrounded command, a watcher.
+  Nothing raised, so nothing ever reported it. This had shipped in every
+  version of the runner there has ever been.
+
+## 0.3.17
+
+No wrapper changes, and no entry was written here at the time. Full notes in
+[mcptask-releases v0.3.17](https://github.com/jchsoft/mcptask-releases/releases/tag/v0.3.17).
+
+Nothing an operator can observe changed in the binary either. The release
+carried one refactor — the event stream's assignment callback moved to a
+setter so that a caller supplying its own stream gets it too — which leaves
+production behaviour identical and exists so the path cannot break silently
+under test. Everything else in it was the chaos stress harness, which does not
+ship in the binary.
+
 ## 0.3.16
 
 No wrapper changes. Full notes in

data/README.md

@@ -91,6 +91,15 @@ Go binary as-is. The only legacy task without a counterpart is
 `verbose=true` and `ignore_quota=true` environment variables are honored by
 the binary itself, exactly as before.
 
+`install` and `update` print one line before handing the process over, and it
+is coloured the way the binary colours everything after it: green when the
+install left the machine where it already was, yellow when a binary the host
+was running has just been replaced or when the version on disk was kept
+instead. Only at a terminal — a pipe, a redirect and CI get the plain text
+they always got. `NO_COLOR` turns it off, and `MCPTASK_RUNNER_COLOR` (`1` /
+`0`) answers it either way, ahead of `NO_COLOR`. The binary reads the same two
+variables.
+
 ## Supported platforms
 
 Platform gems exist for `arm64-darwin`, `x86_64-darwin`, `aarch64-linux`,

data/lib/mcptask_rails_runner/binary.rb

@@ -86,10 +86,12 @@ module McptaskRailsRunner
     # versions and one installed binary, so a project pinning an older gem must
     # not quietly drag the machine's runner backwards.
     def install!(install_dir: INSTALL_DIR, gem_root: GEM_ROOT, out: $stdout)
+      paint = Palette.for(out)
+
       override = ENV["MCPTASK_RUNNER_BIN"]
       unless override.nil? || override.empty?
-        out.puts "[mcptask_runner] MCPTASK_RUNNER_BIN is set — running #{override} " \
-                 "and leaving #{installed_path(install_dir: install_dir)} alone."
+        out.puts paint.changed("[mcptask_runner] MCPTASK_RUNNER_BIN is set — running #{override} " \
+                               "and leaving #{installed_path(install_dir: install_dir)} alone.")
         return override
       end
 
@@ -98,14 +100,20 @@ module McptaskRailsRunner
 
       existing = installed_version(target)
       if existing && existing > Gem::Version.new(VERSION)
-        out.puts "[mcptask_runner] #{target} already holds #{existing}, which is newer than this " \
-                 "gem's #{VERSION} — keeping it. Delete that file to install this gem's binary instead."
+        out.puts paint.changed("[mcptask_runner] #{target} already holds #{existing}, which is newer than " \
+                               "this gem's #{VERSION} — keeping it. Delete that file to install this " \
+                               "gem's binary instead.")
         return target
       end
 
       copy(source, target)
-      out.puts "[mcptask_runner] installed mcptask_runner #{VERSION} into #{target}" \
-               "#{existing ? " (replacing #{existing})" : ''}."
+      # Green when this leaves the machine where it already was — a first
+      # install, or the same version laid down again. Yellow when a binary the
+      # host was running has just been replaced, which is the one line of this
+      # command worth stopping on.
+      line = "[mcptask_runner] installed mcptask_runner #{VERSION} into #{target}" \
+             "#{existing ? " (replacing #{existing})" : ''}."
+      out.puts(existing && existing < Gem::Version.new(VERSION) ? paint.changed(line) : paint.ok(line))
       target
     end
 

data/lib/mcptask_rails_runner/palette.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module McptaskRailsRunner
+  # Colour for the lines this gem prints before it hands the process over.
+  #
+  # `rake mcptask_runner:update` opens with Binary.install!'s line, and
+  # everything after it comes from the Go binary, which since 0.3.18 colours its
+  # own output by meaning: green when there was nothing to do, yellow when
+  # something moved, red when something is waiting on a decision. A grey first
+  # line in front of that wall reads as the least important thing on the screen,
+  # when it is in fact the only one that replaced a binary.
+  #
+  # The rules here are copied from internal/install/color.go in the Go repo
+  # rather than invented — same colours, same two environment levers, same "a
+  # terminal and nowhere else". Two halves of one command that disagreed about
+  # what NO_COLOR means would be a puzzle, not a feature.
+  class Palette
+    RESET  = "\e[0m"
+    GREEN  = "\e[32m"
+    YELLOW = "\e[33m"
+
+    # Values of MCPTASK_RUNNER_COLOR that settle the question, either way.
+    FORCE_ON  = %w[1 true always force].freeze
+    FORCE_OFF = %w[0 false never].freeze
+
+    # Terminals that turn escape codes on for themselves and say so. A Windows
+    # console renders them only once virtual-terminal processing is switched on
+    # for its handle, and this gem is not going to call into Win32 for a
+    # convenience — so anything not on this list gets plain text, and
+    # MCPTASK_RUNNER_COLOR=1 is the way in for a console the list has not heard
+    # of.
+    WINDOWS_ANSI_HINTS = %w[WT_SESSION ANSICON ConEmuANSI TERM].freeze
+
+    # for decides how one stream should be written to.
+    def self.for(out, env: ENV)
+      new(enabled: enabled?(out, env))
+    end
+
+    # MCPTASK_RUNNER_COLOR is asked first and wins both ways, because it is the
+    # specific answer: whoever set it knows where this output is going. NO_COLOR
+    # is the general convention (no-color.org) — present and non-empty means no
+    # colour, from anything.
+    def self.enabled?(out, env)
+      specific = env["MCPTASK_RUNNER_COLOR"].to_s.downcase
+      return true if FORCE_ON.include?(specific)
+      return false if FORCE_OFF.include?(specific)
+      return false unless env["NO_COLOR"].to_s.empty?
+      return false if env["TERM"] == "dumb"
+      return false unless out.respond_to?(:tty?) && out.tty?
+
+      Gem.win_platform? ? WINDOWS_ANSI_HINTS.any? { |name| !env[name].to_s.empty? } : true
+    end
+
+    def initialize(enabled:)
+      @enabled = enabled
+    end
+
+    def enabled?
+      @enabled
+    end
+
+    # ok — this is the state you wanted; nothing to read closely.
+    def ok(text)
+      wrap(GREEN, text)
+    end
+
+    # changed — something moved, or what you assumed would happen did not.
+    def changed(text)
+      wrap(YELLOW, text)
+    end
+
+    private
+
+    def wrap(code, text)
+      return text unless @enabled && !text.empty?
+
+      "#{code}#{text}#{RESET}"
+    end
+  end
+end

data/lib/mcptask_rails_runner/version.rb

@@ -10,5 +10,5 @@ module McptaskRailsRunner
   # Binary::INSTALL_DIR. So the pin is per project and per foreground rake
   # invocation; the installed copy is per machine, and the newest binary any of
   # those projects offers is the one that stays.
-  VERSION = "0.3.18"
+  VERSION = "0.3.19"
 end

data/lib/mcptask_rails_runner.rb

@@ -14,6 +14,7 @@ module McptaskRailsRunner
   end
 end
 
+require_relative "mcptask_rails_runner/palette"
 require_relative "mcptask_rails_runner/binary"
 
 # Only inside a booted Rails app — rails/railtie needs active_support loaded,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mcptask-rails-runner
 version: !ruby/object:Gem::Version
-  version: 0.3.18
+  version: 0.3.19
 platform: aarch64-linux
 authors:
 - Josef Chmel
@@ -38,6 +38,7 @@ files:
 - lib/mcptask/rails/runner.rb
 - lib/mcptask_rails_runner.rb
 - lib/mcptask_rails_runner/binary.rb
+- lib/mcptask_rails_runner/palette.rb
 - lib/mcptask_rails_runner/railtie.rb
 - lib/mcptask_rails_runner/version.rb
 - lib/tasks/mcptask_runner.rake