mcptask-rails-runner 0.2.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 90fb6326f0a5b5ffde6055867b4709a7574acb7f1e8cc3facc9b00c37d60518e
+  data.tar.gz: 30dd43c20ec169dadcb0729e63e6c074c84180a2649983478bb9c56a57b630fc
+SHA512:
+  metadata.gz: f2b2a21772d92034835ba3c75483f51312bda2ea235cc407fca2de43a44f4e5dca62f72f3cb4da04e6d50f0c22fa8bf258b02b3bfd0268378e9b984f8197c51c
+  data.tar.gz: 901f117d861d84118d85e0a1684573858aa826f10a969df45130656b480452022618297f70fd35103e76d88f880525a4a787b0dabde04e7504ee1b0dd3d0fcd6

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+The version number tracks the `mcptask_runner` binary the gem ships, so the
+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.
+
+## 0.2.4
+
+- First release. Thin Rails wrapper around the `mcptask_runner` Go binary,
+  with the rake surface of the legacy `mcptask_runner` gem kept unchanged so
+  migrating is a one-line Gemfile edit.
+- Platform gems for `arm64-darwin`, `x86_64-darwin`, `arm64-linux`,
+  `x86_64-linux` and `x64-mingw-ucrt`; the `ruby` fallback gem explains how to
+  supply a binary through `MCPTASK_RUNNER_BIN`.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JchSoft s.r.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,109 @@
+# mcptask-rails-runner
+
+Rails distribution of the [mcptask.online](https://mcptask.online) autonomous
+runner. A thin Ruby wrapper around the `mcptask_runner` Go binary: the gem
+ships the platform-specific binary inside itself (`libexec/`) and exposes the
+same rake tasks as the legacy `mcptask_runner` gem, delegating 1:1 to the CLI.
+
+One gem version carries exactly one binary version — `mcptask-rails-runner
+X.Y.Z` contains the binary from the `vX.Y.Z` release of
+[jchsoft/mcptask-releases](https://github.com/jchsoft/mcptask-releases).
+
+## Requirements
+
+- Ruby >= 3.0, Rails >= 6.0
+- [Claude Code](https://claude.com/claude-code) CLI
+- An mcptask.online account
+
+## Installation
+
+```ruby
+# Gemfile
+gem "mcptask-rails-runner"
+```
+
+```bash
+bundle install
+bundle exec rake mcptask_runner:install
+```
+
+## Migrating from the legacy mcptask_runner gem
+
+The rake surface is identical — the migration is one Gemfile line:
+
+```diff
+- gem "mcptask_runner", git: "git@github.com:jchsoft/mcptask_runner.git"
++ gem "mcptask-rails-runner"
+```
+
+Then `bundle install` and carry on; every `rake mcptask_runner:*` invocation,
+LaunchAgent and shell alias keeps working. Your existing
+`config/mcptask_runner.yml`, `.mcp.json` and `.claude/` setup are read by the
+Go binary as-is. The only legacy task without a counterpart is
+`mcptask_runner:prepare:permissions` — permission sync is part of
+`mcptask_runner:install` now.
+
+## Tasks
+
+| Task | Delegates to |
+|---|---|
+| `mcptask_runner:install` | `mcptask_runner init` |
+| `mcptask_runner:update` | `mcptask_runner update` |
+| `mcptask_runner:bug_report` | `mcptask_runner bug-report` |
+| `mcptask_runner:version` | `mcptask_runner version` |
+| `mcptask_runner:manual:once` (`once_dry`, `today`, `daily`, `review`, `reviews`, `workflow`, `queue`) | `mcptask_runner run <mode>` |
+| `mcptask_runner:manual:story[123]` / `manual:task[123]` | `run story_manual --story-id 123` / `run task_manual --task-id 123` |
+| `mcptask_runner:auto:once` | `run once_auto_squash` |
+| `mcptask_runner:auto:squash:today` (`queue`, `story[123]`, `task[123]`) | `run <mode>_auto_squash` |
+
+`verbose=true` and `ignore_quota=true` environment variables are honored by
+the binary itself, exactly as before.
+
+## Supported platforms
+
+Platform gems exist for `arm64-darwin`, `x86_64-darwin`, `arm64-linux`,
+`x86_64-linux` and `x64-mingw-ucrt`. On anything else bundler falls back to
+the binary-less `ruby` platform gem, which fails at run time with
+instructions: install the binary from
+[mcptask-releases](https://github.com/jchsoft/mcptask-releases) (or via
+`install.sh` / npm `@mcptask/cli`) and point `MCPTASK_RUNNER_BIN` at it. The
+same variable also serves offline or air-gapped installs.
+
+The wrapper always executes the binary through an absolute path inside the
+gem, never through PATH — the binary shares its name with the legacy tooling,
+and a PATH lookup could pick up the wrong install.
+
+## Development
+
+```bash
+bundle install
+bundle exec rake test          # unit tests (binary resolution + task mapping)
+bin/fetch-binaries             # stage release binaries into tmp/binaries/
+bundle exec rake package:all   # build all platform gems into pkg/
+```
+
+## Releasing
+
+Releases are cut by tagging: bump `lib/mcptask_rails_runner/version.rb` to
+match an existing `mcptask-releases` tag, push a matching `vX.Y.Z` tag, and
+the Release workflow downloads the binaries (sha256-verified), builds the
+platform gems and publishes them to rubygems.org through OIDC trusted
+publishing. See `.github/workflows/release.yml`.
+
+One-time setup on rubygems.org, before the first tag can publish anything —
+the gem name has to exist as a trusted-publisher entry:
+
+1. Sign in on rubygems.org, open **Profile → Trusted publishers → Create**.
+2. For a gem that has never been pushed, use **Create a pending trusted
+   publisher** with gem name `mcptask-rails-runner`; for an existing gem, add
+   the publisher on the gem's own page.
+3. Repository owner `jchsoft`, repository name `mcptask-rails-runner`,
+   workflow filename `release.yml`, environment empty.
+
+No API key is stored anywhere: `rubygems/configure-rubygems-credentials`
+exchanges the workflow's OIDC token for a short-lived credential at push time.
+The same model as the npm publish in the Go repository.
+
+## License
+
+MIT

data/lib/mcptask/rails/runner.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+# Bundler's default require for a gem named mcptask-rails-runner.
+require "mcptask_rails_runner"

data/lib/mcptask_rails_runner/binary.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module McptaskRailsRunner
+  # Locates and executes the bundled Go binary.
+  module Binary
+    GEM_ROOT = File.expand_path("../..", __dir__)
+
+    SUPPORTED_PLATFORMS = %w[
+      arm64-darwin
+      x86_64-darwin
+      arm64-linux
+      x86_64-linux
+      x64-mingw-ucrt
+    ].freeze
+
+    module_function
+
+    def executable_name
+      Gem.win_platform? ? "mcptask_runner.exe" : "mcptask_runner"
+    end
+
+    # Absolute path to the bundled binary. Never resolved through PATH: the
+    # binary shares the mcptask_runner name with the legacy gem's rake
+    # namespace, and a PATH lookup could pick up a stale or wrong install.
+    def path(gem_root: GEM_ROOT)
+      override = ENV["MCPTASK_RUNNER_BIN"]
+      return override unless override.nil? || override.empty?
+
+      exe = File.join(gem_root, "libexec", executable_name)
+      return exe if File.file?(exe)
+
+      raise Error, <<~MSG
+        mcptask_runner binary not found at #{exe}.
+
+        The platform gem for #{Gem::Platform.local} was probably not installed.
+        Supported platforms: #{SUPPORTED_PLATFORMS.join(', ')}.
+
+        On a supported platform, re-run `bundle install` (and make sure the
+        platform is in Gemfile.lock: `bundle lock --add-platform #{Gem::Platform.local}`).
+        On an unsupported platform, install the binary from
+        https://github.com/jchsoft/mcptask-releases and point the
+        MCPTASK_RUNNER_BIN environment variable at it.
+      MSG
+    end
+
+    # Replaces the current process, so the binary's exit code and signal
+    # handling reach the caller (rake) unchanged.
+    def exec!(*args)
+      Kernel.exec(path, *args)
+    end
+  end
+end

data/lib/mcptask_rails_runner/railtie.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "rails/railtie"
+
+module McptaskRailsRunner
+  class Railtie < ::Rails::Railtie
+    rake_tasks do
+      load File.expand_path("../tasks/mcptask_runner.rake", __dir__)
+    end
+  end
+end

data/lib/mcptask_rails_runner/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module McptaskRailsRunner
+  # The gem version is pinned 1:1 to the mcptask_runner binary release it
+  # carries (tag v#{VERSION} in jchsoft/mcptask-releases). Bump both together.
+  VERSION = "0.2.4"
+end

data/lib/mcptask_rails_runner.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "mcptask_rails_runner/version"
+
+module McptaskRailsRunner
+  class Error < StandardError; end
+
+  # Validates a rake bracket argument such as manual:story[123].
+  def self.piece_id!(value, name, example)
+    id = Integer(value, exception: false)
+    raise ArgumentError, "#{name} is required and must be a positive integer (usage: rake '#{example}')" if id.nil? || id < 1
+
+    id.to_s
+  end
+end
+
+require_relative "mcptask_rails_runner/binary"
+
+# Only inside a booted Rails app — rails/railtie needs active_support loaded,
+# and outside Rails there is nothing to hook the rake tasks into.
+require_relative "mcptask_rails_runner/railtie" if defined?(::Rails::Railtie)

data/lib/tasks/mcptask_runner.rake

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Rake surface kept identical to the legacy mcptask_runner gem, so migrating
+# a customer is only a Gemfile line swap. Every task delegates 1:1 to the
+# bundled Go CLI via Kernel#exec — the binary's exit code and signal handling
+# reach the caller unchanged, and nothing runs after the delegation line.
+
+require "mcptask_rails_runner"
+
+namespace :mcptask_runner do
+  desc "Install skills, permissions, token and scheduled job into this project"
+  task :install do
+    McptaskRailsRunner::Binary.exec!("init")
+  end
+
+  desc "Refresh bundled skills and helpers"
+  task :update do
+    McptaskRailsRunner::Binary.exec!("update")
+  end
+
+  desc "File a bug against the project with the last run log attached"
+  task :bug_report do
+    McptaskRailsRunner::Binary.exec!("bug-report")
+  end
+
+  desc "Print runner version and resolved configuration"
+  task :version do
+    McptaskRailsRunner::Binary.exec!("version")
+  end
+
+  namespace :manual do
+    {
+      once: "once",
+      once_dry: "once_dry",
+      today: "today",
+      daily: "daily",
+      review: "review",
+      reviews: "reviews",
+      workflow: "workflow",
+      queue: "queue_manual"
+    }.each do |task_name, mode|
+      desc "Run the work loop in #{mode} mode"
+      task task_name do
+        McptaskRailsRunner::Binary.exec!("run", mode)
+      end
+    end
+
+    desc "Work a single story in manual mode"
+    task :story, [:story_id] do |_t, args|
+      id = McptaskRailsRunner.piece_id!(args[:story_id], "story_id", "mcptask_runner:manual:story[123]")
+      McptaskRailsRunner::Binary.exec!("run", "story_manual", "--story-id", id)
+    end
+
+    desc "Work a single task in manual mode"
+    task :task, [:task_id] do |_t, args|
+      id = McptaskRailsRunner.piece_id!(args[:task_id], "task_id", "mcptask_runner:manual:task[123]")
+      McptaskRailsRunner::Binary.exec!("run", "task_manual", "--task-id", id)
+    end
+  end
+
+  namespace :auto do
+    desc "Run the work loop in once_auto_squash mode"
+    task :once do
+      McptaskRailsRunner::Binary.exec!("run", "once_auto_squash")
+    end
+
+    namespace :squash do
+      desc "Run the work loop in today_auto_squash mode"
+      task :today do
+        McptaskRailsRunner::Binary.exec!("run", "today_auto_squash")
+      end
+
+      desc "Run the work loop in queue_auto_squash mode"
+      task :queue do
+        McptaskRailsRunner::Binary.exec!("run", "queue_auto_squash")
+      end
+
+      desc "Work a single story in auto-squash mode"
+      task :story, [:story_id] do |_t, args|
+        id = McptaskRailsRunner.piece_id!(args[:story_id], "story_id", "mcptask_runner:auto:squash:story[123]")
+        McptaskRailsRunner::Binary.exec!("run", "story_auto_squash", "--story-id", id)
+      end
+
+      desc "Work a single task in auto-squash mode"
+      task :task, [:task_id] do |_t, args|
+        id = McptaskRailsRunner.piece_id!(args[:task_id], "task_id", "mcptask_runner:auto:squash:task[123]")
+        McptaskRailsRunner::Binary.exec!("run", "task_auto_squash", "--task-id", id)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: mcptask-rails-runner
+version: !ruby/object:Gem::Version
+  version: 0.2.4
+platform: ruby
+authors:
+- Josef Chmel
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: Thin Rails wrapper around the mcptask_runner Go binary. Ships the platform-specific
+  binary inside the gem and exposes the same rake tasks as the legacy mcptask_runner
+  gem, delegating 1:1 to the CLI.
+email:
+- info@jchsoft.cz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/mcptask/rails/runner.rb
+- lib/mcptask_rails_runner.rb
+- lib/mcptask_rails_runner/binary.rb
+- lib/mcptask_rails_runner/railtie.rb
+- lib/mcptask_rails_runner/version.rb
+- lib/tasks/mcptask_runner.rake
+homepage: https://github.com/jchsoft/mcptask-rails-runner
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/jchsoft/mcptask-rails-runner
+  bug_tracker_uri: https://github.com/jchsoft/mcptask-rails-runner/issues
+  changelog_uri: https://github.com/jchsoft/mcptask-rails-runner/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: mcptask.online autonomous runner for Rails apps
+test_files: []