polyrun 2.2.1 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf97ce76499f3784cf3a11d8e1ebf640631dc8247785ff74a518b70fb3218459
-  data.tar.gz: c4cc16110c1eb5696b1fab2fa771780a4102856909b8ecb620f2f2da3540b758
+  metadata.gz: 65f2008623ad5bcf9289da8ffb3db95cf07d8261d349978b96ca463b0ff37ea3
+  data.tar.gz: a1fabab4fe6cc0f571b09d8f8a73559866730d6a76a0bc09b48f4a0e0631a724
 SHA512:
-  metadata.gz: 4d24dd153dcb88eb2e1bd7092fd47d72268ca6848061af4b64616fc6ea1307594086cfaa84e6ea06908a82b037b6404684315e66ed3cd7e923fbbaa50409e2f0
-  data.tar.gz: 9569227c3d67cc36eb4e79df95b36c9357aed6c79e853a428546d2c270ccd6accd900a6a8869b250cab3c2bbcf91021d29a4d9a9d5b53292355a6981229e4b64
+  metadata.gz: eb24b21418a3804b868f62f72f1d8462b15f4b7ab0a9901e82789fdb0c7eb04a73ece7bd437ae10acc8c4edbffd53e64ae9e648e09376e6d9d7df2789b42be78
+  data.tar.gz: f0dd0a2b341c81ce8ea3f10358e06f205a0f7329d5695eb82e49a97e067133fe5b665b444c1b57236740a0e354b9945658f2e1351e54730a358583cc411641fb

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 2.2.3 (2026-08-16)
+
+- Fix `merge-failures` `Encoding::CompatibilityError` when JSONL or RSpec JSON contains UTF-8 and the process locale is US-ASCII; read fragments as UTF-8
+- Join worker output forwarders before closing pipe ends so shard logs keep the last bytes after a worker exits
+
+## 2.2.2 (2026-07-25)
+
+- BREAKING: Require Ruby 3.4 or newer
+- Fix `Process.spawn` for string worker commands so the command is one argv element instead of character-splatted
+- Drain remaining worker pipe output when the forwarder hits `IOError` or `Errno::EPIPE`
+
 ## 2.2.1 (2026-07-13)
 
 - Fix per-example timeout leaving ActiveRecord connection pools in a bad state after `Timeout` interrupts database I/O; disconnect all pools on timeout (adapter-agnostic).

data/CODE_OF_CONDUCT.md

@@ -1,25 +1,25 @@
 # Code of Conduct
 
-## Our pledge
+## Our Pledge
 
-We pledge to make participation in the Polyrun community a harassment-free experience for everyone. We operate on principles of mutual respect, privacy, and authentic engagement. We value substantive contributions and clarity on intentions.
+We pledge to make participation in our community a harassment-free experience for everyone. We operate on principles of mutual respect, privacy, and authentic engagement. We value substantive contributions and clarity on intentions.
 
-## Our standards
+## Our Standards
 
 Examples of behavior that contributes to a positive environment include:
 
-- Authenticity: engaging with genuine curiosity and admitting uncertainty rather than feigning knowledge.
-- Responsible innovation: taking full responsibility for any content or code contributed, whether manually written or generated by automation tools.
-- Gentle correction: responding politely to errors. We view mistakes as opportunities for learning, provided they are addressed with humility.
-- Inclusive language: using language that welcomes diverse perspectives and respects the privacy and identity of all participants.
+- Authenticity: Engaging with genuine curiosity and admitting uncertainty rather than feigning knowledge.
+- Responsible Innovation: Taking full responsibility for any content or code contributed, whether manually written or generated by automation tools.
+- Gentle Correction: Responding politely to errors. We view mistakes as opportunities for learning, provided they are addressed with humility.
+- Inclusive Language: Using language that welcomes diverse perspectives and respects the privacy and identity of all participants.
 
 Examples of unacceptable behavior include:
 
-- Harassment: public or private harassment, trolling, or insulting comments.
-- Weaponized complexity: using jargon or overwhelming volume (including automated spam) to silence others.
-- Publishing private information: sharing others' data or personal context without explicit permission.
+- Harassment: Public or private harassment, trolling, or insulting comments.
+- Weaponized Complexity: Using jargon or overwhelming volume (including automated spam) to silence others.
+- Publishing Private Information: Sharing others' data or personal context without explicit permission.
 
-## Artificial intelligence and automation
+## Artificial Intelligence and Automation
 
 In accordance with our commitment to collective awareness:
 

data/CONTRIBUTING.md

@@ -1,107 +1,29 @@
-# Contributing to Polyrun
+# Contributing Guidelines
 
-## Development setup
+Thank you for your interest in contributing. We value learning over perfection but require rigor and responsibility.
 
-```bash
-bundle install
-bundle exec appraisal install
-```
+## The Golden Rule of Automation
 
-## Tests
+We welcome the use of AI and automation tools to reduce toil, but you must strictly adhere to the following:
 
-```bash
-bundle exec rspec
-# or
-bundle exec rake spec
-```
+1. You are the Author: You act as the responsible agent for any code you submit. You must review, debug, and understand every line.
+2. Manage Cognitive Load: Do not submit massive, unreviewed automated dumps. Respect the reviewers' time by annotating complex logic.
+3. Security: Never feed project secrets or private context into public AI models.
 
-Coverage merge performance (large synthetic payloads):
+## How to Contribute
 
-Native extension (optional; compiles via `bundle install` or `cd ext/polyrun_coverage_merge && ruby extconf.rb && make`):
+### 1. Reporting Issues
 
-After pulling changes under `ext/**/*.c` or `ext/**/extconf.rb`, rebuild the extension before running specs or benchmarks:
+- Verify Accuracy: Before posting, verify your information. Avoid generalizations.
+- Use Structured Inputs: Use issue templates to provide clear goals, constraints, and reproduction steps. This helps us understand the context immediately.
 
-```bash
-make native-extension
-# or: bundle exec rake native_extension
-```
+### 2. Pull Request Process
 
-If merge specs segfault or native acceleration behaves oddly after a pull, run `make clean` in `ext/polyrun_coverage_merge` and `make native-extension` again (or `bundle install` to trigger a full compile).
+- Scope: Keep PRs focused on a single goal.
+- Context: Explain why the change is necessary. Transparency builds trust.
+- Testing: Run all smoke tests and regression checks locally. We prioritize safety first.
 
-CI compiles the extension on Linux and macOS (`.github/workflows/native-extension.yml`).
+### 3. Review Process
 
-```bash
-bundle exec rake bench_merge
-# or: ruby benchmark/merge_coverage.rb
-```
-
-RSpec performance benchmarks (coverage merge + spec-quality peek; writes `tmp/benchmarks/profile_<sha>.log`):
-
-```bash
-bundle exec rake bench_performance
-# optional: STACKPROF=1 or BENCHMARK_IPS=1 for spec/performance/profiling_spec.rb
-# optional: BENCH_MEMORY=1 bundle exec rspec spec/performance/benchmark_merge_spec.rb spec/performance/benchmark_spec.rb --tag benchmark
-# optional env: BENCH_LINE_COUNT_REPS, BENCH_MEMORY_REPS
-```
-
-Run the suite under alternate Ruby constraints (see `Appraisals` and `gemfiles/`):
-
-```bash
-bundle exec appraisal ruby32 rspec
-bundle exec appraisal ruby34 rspec
-bundle exec appraisal ruby40 rspec
-```
-
-## Linting
-
-[RuboCop](https://rubocop.org/) with [Standard](https://github.com/standardrb/standard) style, plus `rubocop-rspec` and `rubocop-thread_safety`. Project-specific cop tweaks and metric `Exclude` lists live in `.rubocop.yml`.
-
-```bash
-bundle exec rubocop
-bundle exec rubocop -a   # safe autocorrect
-bundle exec rake rubocop
-```
-
-## RBS
-
-Type signatures live under `sig/` and ship with the gem. Validate them after changes:
-
-```bash
-bundle exec rake rbs
-# equivalent: bundle exec rbs -I sig validate
-```
-
-Keep `require "polyrun"` free of RSpec/Minitest: optional wiring stays in `polyrun/rspec`, `polyrun/minitest`, and `polyrun/reporting/rspec_junit` (see README).
-
-[Trunk](https://trunk.io/) aggregates RuboCop, YAML, Markdown, shellcheck, and more (see `.trunk/trunk.yaml`):
-
-```bash
-trunk check
-trunk fmt
-```
-
-CI runs `rake ci` (RSpec + RuboCop). Optional Trunk workflow: `.github/workflows/trunk.yml`.
-
-## Adopting Polyrun in other repos
-
-- [docs/SETUP_PROFILE.md](docs/SETUP_PROFILE.md) — agent or human checklist (CI model A vs B, database, prepare).
-- `bundle exec polyrun init --list` — lists starter `polyrun.yml` and `POLYRUN.md` templates (see `examples/templates/README.md`).
-
-## Examples
-
-Runnable demos live under `examples/`. After changing the gem, smoke them:
-
-```bash
-cd examples && ./bin/ci_prepare
-cd examples/simple/simple_demo && RAILS_ENV=test bundle exec rspec
-# optional: complex polyrepo demo (multi-DB + three Vite clients + RSpec E2E)
-# cd examples/complex/polyrepo_demo && RAILS_ENV=test bin/rails db:prepare && bundle exec rspec
-```
-
-See `examples/README.md`.
-
-## Pull requests
-
-- One logical change per PR when possible.
-- Add or update specs for behavior changes.
-- Run `bundle exec rake ci` before pushing.
+- We encourage productive friction. Expect questions about your approach.
+- If a reviewer suggests a change, view it as mutual aid, not criticism.

data/README.md

@@ -197,6 +197,19 @@ See [`examples/README.md`](examples/README.md) for Rails apps (Capybara, Playwri
 
 You can replace SimpleCov and simplecov plugins, parallel_tests, and rspec_junit_formatter with Polyrun for those roles. Use `merge-timing`, `report-timing`, and `Data::FactoryCounts` (optionally with `Data::FactoryInstrumentation`) for slow-file and factory metrics. YAML fixture batches and bulk inserts can use `Data::Fixtures` and `ParallelProvisioning` for shard-aware seeding; wire your own `truncate` and `load_seed` in hooks.
 
+## Links
+
+- [GitHub](https://github.com/amkisko/polyrun.rb)
+- [GitLab](https://gitlab.com/amkisko/polyrun.rb)
+- [RubyGems](https://rubygems.org/gems/polyrun)
+- [Versions Atom](https://rubygems.org/gems/polyrun/versions.atom) (feed id `10936755433440`)
+- [libraries.io](https://libraries.io/rubygems/polyrun)
+- [Deps.dev](https://deps.dev/rubygems/polyrun)
+- [SonarCloud](https://sonarcloud.io/project/overview?id=amkisko_polyrun.rb)
+- [Snyk](https://snyk.io/test/github/amkisko/polyrun.rb)
+- [Codecov](https://app.codecov.io/github/amkisko/polyrun.rb)
+- [OpenSSF Scorecard](https://scorecard.dev/viewer/?uri=github.com/amkisko/polyrun.rb)
+
 ## License
 
 Released under the [MIT License](LICENSE). Copyright (c) 2026 Andrei Makarov.

data/SECURITY.md

@@ -2,9 +2,9 @@
 
 ## Reporting a Vulnerability
 
-Do not open a public GitHub issue for security vulnerabilities.
+Do not open a public issue for security vulnerabilities.
 
-Email security details to security@kiskolabs.com.
+Email security details to: security@kiskolabs.com
 
 Include: description, steps to reproduce, potential impact, and suggested fix (if available).
 
@@ -21,7 +21,7 @@ Include: description, steps to reproduce, potential impact, and suggested fix (i
 - We will publish a security advisory after the vulnerability is patched
 - We will coordinate public disclosure with you
 
-## Automation security
+## Automation Security
 
-- Context isolation: do not include production credentials, API keys, or personally identifiable information in prompts sent to third-party LLMs or automation services.
-- Supply chain: verify automated dependencies.
+- Context Isolation: It is strictly forbidden to include production credentials, API keys, or Personally Identifiable Information (PII) in prompts sent to third-party LLMs or automation services.
+- Supply Chain: All automated dependencies must be verified.

data/lib/polyrun/reporting/failure_merge.rb

@@ -101,7 +101,7 @@ module Polyrun
           return rows_from_jsonl_file(path)
         end
 
-        text = File.read(path)
+        text = File.read(path, encoding: Encoding::UTF_8)
         data =
           begin
             JSON.parse(text)
@@ -126,7 +126,7 @@ module Polyrun
 
       def rows_from_jsonl_file(path)
         acc = []
-        File.readlines(path, chomp: true).each_with_index do |line, idx|
+        File.readlines(path, chomp: true, encoding: Encoding::UTF_8).each_with_index do |line, idx|
           line = line.strip
           next if line.empty?
 

data/lib/polyrun/version.rb

@@ -1,3 +1,3 @@
 module Polyrun
-  VERSION = "2.2.1"
+  VERSION = "2.2.3"
 end

data/lib/polyrun/worker_output.rb

@@ -66,7 +66,8 @@ module Polyrun
             err: err_write
           )
         else
-          Process.spawn(child_env, *cmd, *paths, out: out_write, err: err_write)
+          # Array(cmd) so a String command is one argv element (not character-splatted).
+          Process.spawn(child_env, *Array(cmd), *Array(paths), out: out_write, err: err_write)
         end
 
       out_write.close
@@ -137,7 +138,7 @@ module Polyrun
           forwarder.consume(stream, io.readpartial(4096))
         end
       rescue IOError, Errno::EPIPE
-        # worker closed the pipe
+        drain_remaining_output(io, forwarder, stream)
       ensure
         io.close unless io.closed?
       end
@@ -145,13 +146,25 @@ module Polyrun
     end
     private_class_method :forwarder_thread
 
+    # EOFError subclasses IOError; keep drain rescues separate so a closed pipe
+    # during the final read does not escape the forwarder thread.
+    def drain_remaining_output(io, forwarder, stream)
+      remaining = io.read
+      forwarder.consume(stream, remaining) if remaining && !remaining.empty?
+    rescue IOError, Errno::EPIPE
+      nil
+    end
+    private_class_method :drain_remaining_output
+
     def drain_forwarders(entry)
+      # Join first so threads can drain pipe buffers after the child exits.
+      # Closing read ends before join races and can drop the final bytes.
+      entry[:threads].each(&:join)
       entry[:ios].each do |io|
         io.close unless io.closed?
       rescue IOError
         nil
       end
-      entry[:threads].each(&:join)
       entry[:forwarder].close
     end
     private_class_method :drain_forwarders

data/polyrun.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.summary = "Parallel tests, coverage (SimpleCov-compatible) formatters, fixtures/snapshots, assets & DB provisioning—zero runtime deps"
   spec.homepage = "https://github.com/amkisko/polyrun.rb"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1.0"
+  spec.required_ruby_version = ">= 3.4"
 
   spec.files = (
     Dir["lib/**/*", "sig/**/*.rbs", "bin/polyrun", "README.md", "CHANGELOG.md", "docs/SETUP_PROFILE.md", "LICENSE", "CONTRIBUTING.md", "CODE_OF_CONDUCT.md", "SECURITY.md", "polyrun.gemspec"] +

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: polyrun
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.2.3
 platform: ruby
 authors:
 - Andrei Makarov
@@ -393,14 +393,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Parallel tests, coverage (SimpleCov-compatible) formatters, fixtures/snapshots,
   assets & DB provisioning—zero runtime deps