rake-osc7501 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 868cd8a5aa617ffa44d3a9da5c6d02ff514d223ff294d3723afa0cc1c139c9f4
-  data.tar.gz: 8bc395f13a34ad648a31a3c364c172242a5624f01880cfd417b4efa82babc800
+  metadata.gz: 9ec4d24e91dfcf5e1fc81da1a23945ea6782ad3ea8de3f042e7e7ba0db5ae61e
+  data.tar.gz: 611c5cd0014c4c19b20b6dea23ece1be35826438ec8846fed4a070341541d801
 SHA512:
-  metadata.gz: 98b140b5886a2a428394477cdd9bb0f2f20ab4d2a7bd5af1bca441ec95ec4234e5f501fd6f7ff8d10abbd3bc7e8e08cd8c8d24ef0257f764e613d4bf5b5d0634
-  data.tar.gz: 796a7c336a8e980cdac4c0b315e6d2fc5d184591162ec8cf97ceda6a839ca1a1b9e9e5644a94e9f83d9104037893f43370b7aa24519bb1a4bf5372e7ff202ae9
+  metadata.gz: 2edae9f21fac815f594a72940145e420a466c691c1a37a8abeeb882c62bcbc6eb83ef439138da26105a05760ea53efe4ac0882d14fcf3ebcb209adc5cf894165
+  data.tar.gz: a3c2a55f578791cbb038d1f6cedf0b57c304cfc363de2a0b2bb0161158318745158a1e0cdc6708eef2b0b2d60d40d4e326f6d16bd17d5ed0a0d0ce7b671fa953

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+## 0.1.2 - 2026-11-13
+
+- Enable OSC reporting for direct RSpec runs ([ac72e7d](https://github.com/cosgroveb/rake-osc7501/commit/ac72e7db42be722561b4673f3de3ecb1ef2f9422))
+- Check Ruby implementations against inline RBS ([4ec47b3](https://github.com/cosgroveb/rake-osc7501/commit/4ec47b379bc1396efaec97a5b824d9b4abb80277))
+- Package generated runtime RBS signatures ([ecfcad0](https://github.com/cosgroveb/rake-osc7501/commit/ecfcad06a510bde0d6fab00580a92f0a6f845701))
+- Build compatibility gems without type tooling ([784efd3](https://github.com/cosgroveb/rake-osc7501/commit/784efd35d2ba7e49bd3f12600196512f95fa0086))
+- Bump actions/download-artifact from 4.3.0 to 8.0.2 ([5b2445b](https://github.com/cosgroveb/rake-osc7501/commit/5b2445be7bcfa8d563efbd42b91e759d3e9eaf8c))
+- Bump actions/upload-artifact from 4.6.2 to 7.0.2 ([f4c30a5](https://github.com/cosgroveb/rake-osc7501/commit/f4c30a59b917398fe54e0d7a251d16081a8365bc))
+- Install RSpec reporting after loading the Rakefile ([c35a24a](https://github.com/cosgroveb/rake-osc7501/commit/c35a24a330fa0ef62d2d1224ca6be9dff6da4c27))
+
 ## 0.1.1 - 2026-11-12
 
 - Preserve release failure diagnostics on retries ([5e89c7b](https://github.com/cosgroveb/rake-osc7501/commit/5e89c7b0f84a9ed45342b4f5e5d8154f309f6b67))

data/CONTRIBUTING.md

@@ -17,12 +17,18 @@ bundle exec rake
 ```
 
 The default task runs RuboCop with rubocop-rspec, bundler-audit, actionlint,
-inline RBS checks, specs, installed-gem smoke tests and RDoc. Run `bundle exec rake lint`, `audit`, `workflows`,
+inline RBS checks, specs, installed-gem smoke tests and RDoc. Run `bundle exec rake lint`, `audit`, `workflows`, `types`,
 or `spec` for individual checks. RuboCop applies default style rules to release tooling and build configuration,
 and correctness cops to existing runtime code, fixtures and smoke tests.
 Scoped exclusions preserve Ruby 2.1 support and exception propagation. Do not add a TODO baseline. Dependency auditing checks the
 lockfile generated by `bundle install`. Keep that lockfile out of commits.
 
+`rake types` uses Steep to check runtime and tooling implementations in `lib/`
+and `script/` against generated inline signatures. Specs and build configuration
+receive annotation and signature validation only. Keep project types inline.
+`sig/dependencies.rbs` fills gaps in dependency signatures, and generated files
+stay in ignored `tmp/`.
+
 Specs run in random order and report their seed. Reproduce an ordering failure
 with `bundle exec rspec --seed <seed>` and narrow it with
 `bundle exec rspec --seed <seed> --bisect`. Generated subprocess fixtures keep a
@@ -42,7 +48,9 @@ bundle exec rake rdoc
 ```
 
 The package is `pkg/rake-osc7501-<version>.gem`. Open `tmp/rdoc/index.html` to check
-rendered documentation. Keep generated files out of commits.
+rendered documentation. `rake package` generates runtime RBS from `lib/` into
+`pkg/rake-osc7501-<version>/sig/` and includes it in the gem for type tools to
+discover by gem name. Keep generated files out of commits.
 The smoke task builds and installs the gem in a temporary directory, then checks
 passing and failing tasks without loading the checkout's library.
 The `pure-rake` CI job runs this check with only Rake and the built gem installed
@@ -60,13 +68,15 @@ export BUNDLE_GEMFILE=Gemfile.compat
 export RSPEC_MINOR=3.6
 export RSPEC_CORE_VERSION=3.6.0
 bundle install
-bundle exec rspec spec/rake
+bundle exec rspec --options '' spec/rake
 bundle exec gem build rake-osc7501.gemspec
 bundle exec ruby script/smoke.rb rake-osc7501-*.gem
 ```
 
 Remove `Gemfile.compat.lock` before changing RSpec versions. Keep it out of commits.
 The compatibility bundle pins diff-lcs 1.3 so test dependencies install on Ruby 2.1.
+These bare `gem build` checks omit generated signatures and need no type tooling.
+Use the modern development bundle and `rake package` for distribution builds.
 CI checks the oldest Ruby against both RSpec endpoints, the oldest RSpec on modern
 Ruby, and the Debian Bullseye and Bookworm version families. These jobs run the
 runtime suite and installed-gem smoke checks. Modern jobs also test release

data/README.md

@@ -48,8 +48,9 @@ configured formatters, including their output files. An explicit OSC formatter
 keeps its destination and receives no duplicate.
 
 Missing or older `rspec-osc7501` installations without `rspec/osc7501/managed.rb`
-leave the original RSpec command intact. Custom runners and reverse require order
-receive generic Rake reporting. Direct `rspec` commands still need explicit OSC
+leave the original RSpec command intact. Either require order works when RSpec's
+Rake tasks are loaded before top-level execution. Custom runners receive generic
+Rake reporting. Direct `rspec` commands still need explicit OSC
 formatter selection.
 
 The adapter passes child context through the spawn environment. It preserves
@@ -118,9 +119,11 @@ Rake and the built gem installed in an isolated gem directory.
 Set `RSPEC_OSC7501_PATH` to test a local companion checkout instead of the released gem.
 
 `rake types` checks method annotation coverage across authored Ruby files,
-generates inline RBS with pinned development tools, and validates signatures.
-Generated signatures stay in ignored `tmp/`. See [CONTRIBUTING.md](CONTRIBUTING.md)
-for lint, dependency audit, workflow checks and release setup. This check validates declarations,
-not implementation type consistency. Compatibility checks use `Gemfile.compat`
+generates inline RBS, and uses Steep to check implementations in `lib/` and
+`script/` against their signatures. Specs and build configuration receive
+annotation and signature validation, not implementation checking.
+Generated project signatures stay in ignored `tmp/`. `sig/dependencies.rbs`
+supplies missing dependency declarations. See [CONTRIBUTING.md](CONTRIBUTING.md)
+for lint, dependency audit, workflow checks and release setup. Compatibility checks use `Gemfile.compat`
 without type tooling. Pass an RSpec gem package as the smoke script's second
 argument to check installed parent/child reporting.

data/lib/rake/osc7501/hooks.rb

@@ -2,7 +2,29 @@
 # rbs_inline: enabled
 
 module Rake
+  # @rbs!
+  #   class Application
+  #     include OSC7501::ApplicationHook
+  #   end
+
   module OSC7501
+    # @rbs!
+    #   interface _Application
+    #     def options: () -> _Options
+    #     def top_level: () -> Object
+    #   end
+    #   interface _Options
+    #     def show_tasks: () -> (:tasks | :describe | :lines)?
+    #     def show_prereqs: () -> bool
+    #     def dryrun: () -> bool
+    #   end
+    #   interface _Task
+    #     def name: () -> String
+    #     def application: () -> ::Rake::Application
+    #     def execute: (?Object) ?{ (*Object) -> Object } -> Object
+    #   end
+
+    # @rbs module-self _Application
     module ApplicationHook
       attr_reader :osc7501_run #: Run?
 
@@ -10,16 +32,19 @@ module Rake
       def top_level
         return super if options.show_tasks || options.show_prereqs || options.dryrun
 
+        OSC7501.install_rspec!
         previous = @osc7501_run
         begin
-          @osc7501_run = Run.new($stdout, mode: ENV.fetch('RAKE_OSC7501', 'auto'))
-          @osc7501_run.during_run { super }
+          run = Run.new($stdout, mode: ENV.fetch('RAKE_OSC7501', 'auto'))
+          @osc7501_run = run
+          run.during_run { super }
         ensure
           @osc7501_run = previous
         end
       end
     end
 
+    # @rbs module-self _Task
     module TaskHook
       #: (?Object args) ?{ (*Object) -> Object } -> Object
       def execute(args = nil, &block)

data/lib/rake/osc7501/rspec_task.rb

@@ -5,7 +5,16 @@ require 'shellwords'
 
 module Rake
   module OSC7501
+    # @rbs!
+    #   interface _RSpecRakeTask
+    #     def run_task: (bool) -> Object
+    #     def ruby_opts: () -> (String | Array[String] | nil)
+    #     def rspec_path: () -> String
+    #     def system: (*String | Hash[String, String?] | Hash[Symbol, bool]) -> bool?
+    #   end
+
     # Wrap only the standard RSpec task's launch; keep its status handling intact.
+    # @rbs module-self _RSpecRakeTask
     module RSpecTask
       # @rbs @osc7501_context: [String, String]?
 
@@ -15,7 +24,7 @@ module Rake
         begin
           run = Rake.application.osc7501_run if Rake.application.respond_to?(:osc7501_run)
           path = managed_path if run && run.managed_children?
-          @osc7501_context = path ? [run.next_child_id, path] : nil
+          @osc7501_context = path && run ? [run.next_child_id, path] : nil
           super
         ensure
           @osc7501_context = previous
@@ -25,9 +34,11 @@ module Rake
       #: () -> (String | Array[String] | nil)
       def ruby_opts
         options = super
-        return options unless @osc7501_context
+        context = @osc7501_context
+        return options unless context
 
-        [*options, "-r#{Shellwords.escape(@osc7501_context.last)}"]
+        options = [options] if options.is_a?(String)
+        (options || []) + ["-r#{Shellwords.escape(context.last)}"]
       end
 
       private
@@ -43,12 +54,20 @@ module Rake
         path if File.file?(path)
       end
 
-      #: (*Object) -> bool?
+      #: (*String | Hash[String, String?] | Hash[Symbol, bool]) -> bool?
       def system(*arguments)
-        return super unless @osc7501_context
+        context = @osc7501_context
+        return super unless context
 
-        environment = arguments.first.is_a?(Hash) ? arguments.shift.dup : {}
-        environment['RSPEC_OSC7501_ID'] = @osc7501_context.first
+        # @type var environment: Hash[String, String?]
+        first = arguments.first
+        if first.is_a?(Hash)
+          arguments.shift
+          environment = first.dup
+        else
+          environment = {}
+        end
+        environment['RSPEC_OSC7501_ID'] = context.first
         %w[RSPEC_OSC7501 RSPEC_OSC7501_TITLE TERM].each do |key|
           environment[key] = ENV[key] if ENV.key?(key) && !environment.key?(key)
         end

data/lib/rake/osc7501/run.rb

@@ -53,7 +53,8 @@ module Rake
           yield
         ensure
           @mutex.synchronize do
-            @active.delete_at(@active.rindex(task))
+            index = @active.rindex(task) #: Integer
+            @active.delete_at(index)
             report_active
           end
         end

data/lib/rake/osc7501/version.rb

@@ -3,6 +3,6 @@
 
 module Rake
   module OSC7501
-    VERSION = '0.1.1' #: String
+    VERSION = '0.1.2' #: String
   end
 end

data/lib/rake/osc7501/writer.rb

@@ -37,7 +37,7 @@ module Rake
 
       #: (String, Integer) -> String
       def encode(text, byte_limit)
-        input = text.to_s.byteslice(0, sanitization_byte_limit(byte_limit))
+        input = text.to_s.byteslice(0, sanitization_byte_limit(byte_limit)) #: String
         clean = input.encode('UTF-8', invalid: :replace, undef: :replace).gsub(/[\u0000-\u001F\u007F-\u009F]/, '')
         bytes = 0
         bounded = clean.each_char.take_while do |char|

data/lib/rake/osc7501.rb

@@ -13,6 +13,11 @@ module Rake
     def self.install!(application = Rake.application)
       application.extend(ApplicationHook) unless application.is_a?(ApplicationHook)
       Rake::Task.prepend(TaskHook) unless Rake::Task.ancestors.include?(TaskHook)
+      install_rspec!
+    end
+
+    #: () -> void
+    def self.install_rspec!
       return unless defined?(RSpec::Core::RakeTask)
 
       require_relative 'osc7501/rspec_task'

data/sig/rake/osc7501/hooks.rbs

@@ -0,0 +1,45 @@
+# Generated from lib/rake/osc7501/hooks.rb with RBS::Inline
+
+module Rake
+  class Application
+    include OSC7501::ApplicationHook
+  end
+
+  module OSC7501
+    interface _Application
+      def options: () -> _Options
+
+      def top_level: () -> Object
+    end
+
+    interface _Options
+      def show_tasks: () -> (:tasks | :describe | :lines)?
+
+      def show_prereqs: () -> bool
+
+      def dryrun: () -> bool
+    end
+
+    interface _Task
+      def name: () -> String
+
+      def application: () -> ::Rake::Application
+
+      def execute: (?Object) ?{ (*Object) -> Object } -> Object
+    end
+
+    # @rbs module-self _Application
+    module ApplicationHook : _Application
+      attr_reader osc7501_run: Run?
+
+      # : () -> Object
+      def top_level: () -> Object
+    end
+
+    # @rbs module-self _Task
+    module TaskHook : _Task
+      # : (?Object args) ?{ (*Object) -> Object } -> Object
+      def execute: (?Object args) ?{ (*Object) -> Object } -> Object
+    end
+  end
+end

data/sig/rake/osc7501/rspec_task.rbs

@@ -0,0 +1,35 @@
+# Generated from lib/rake/osc7501/rspec_task.rb with RBS::Inline
+
+module Rake
+  module OSC7501
+    interface _RSpecRakeTask
+      def run_task: (bool) -> Object
+
+      def ruby_opts: () -> (String | Array[String] | nil)
+
+      def rspec_path: () -> String
+
+      def system: (*String | Hash[String, String?] | Hash[Symbol, bool]) -> bool?
+    end
+
+    # Wrap only the standard RSpec task's launch; keep its status handling intact.
+    # @rbs module-self _RSpecRakeTask
+    module RSpecTask : _RSpecRakeTask
+      @osc7501_context: [ String, String ]?
+
+      # : (bool) -> Object
+      def run_task: (bool) -> Object
+
+      # : () -> (String | Array[String] | nil)
+      def ruby_opts: () -> (String | Array[String] | nil)
+
+      private
+
+      # : () -> String?
+      def managed_path: () -> String?
+
+      # : (*String | Hash[String, String?] | Hash[Symbol, bool]) -> bool?
+      def system: (*String | Hash[String, String?] | Hash[Symbol, bool]) -> bool?
+    end
+  end
+end

data/sig/rake/osc7501/run.rbs

@@ -0,0 +1,48 @@
+# Generated from lib/rake/osc7501/run.rb with RBS::Inline
+
+module Rake
+  module OSC7501
+    interface _TaskName
+      def name: () -> String
+    end
+
+    class Run
+      @active: Array[_TaskName]
+
+      @counter: Integer
+
+      @mutex: Mutex
+
+      @id: String
+
+      @writer: Writer
+
+      @mode: String
+
+      @finished: bool
+
+      # : (IO | StringIO output, mode: String) -> void
+      def initialize: (IO | StringIO output, mode: String) -> void
+
+      # : [T] () { () -> T } -> T
+      def during_run: [T] () { () -> T } -> T
+
+      # : [T] (_TaskName) { () -> T } -> T
+      def during_task: [T] (_TaskName) { () -> T } -> T
+
+      # : () -> String
+      def next_child_id: () -> String
+
+      # : () -> bool
+      def managed_children?: () -> bool
+
+      private
+
+      # : (String, String) -> void
+      def finish: (String, String) -> void
+
+      # : () -> void
+      def report_active: () -> void
+    end
+  end
+end

data/sig/rake/osc7501/version.rbs

@@ -0,0 +1,7 @@
+# Generated from lib/rake/osc7501/version.rb with RBS::Inline
+
+module Rake
+  module OSC7501
+    VERSION: String
+  end
+end

data/sig/rake/osc7501/writer.rbs

@@ -0,0 +1,29 @@
+# Generated from lib/rake/osc7501/writer.rb with RBS::Inline
+
+module Rake
+  module OSC7501
+    class Writer
+      @output: IO | StringIO
+
+      @enabled: bool
+
+      # : (IO | StringIO output, mode: String) -> void
+      def initialize: (IO | StringIO output, mode: String) -> void
+
+      # : (state: String, msg: String) -> void
+      def emit: (state: String, msg: String) -> void
+
+      private
+
+      # : () -> bool
+      def automatic_output?: () -> bool
+
+      # : (String, Integer) -> String
+      def encode: (String, Integer) -> String
+
+      # Bound sanitization work with 50% headroom for stripped controls.
+      # : (Integer) -> Integer
+      def sanitization_byte_limit: (Integer) -> Integer
+    end
+  end
+end

data/sig/rake/osc7501.rbs

@@ -0,0 +1,11 @@
+# Generated from lib/rake/osc7501.rb with RBS::Inline
+
+module Rake
+  module OSC7501
+    # : (?Object application) -> void
+    def self.install!: (?Object application) -> void
+
+    # : () -> void
+    def self.install_rspec!: () -> void
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rake-osc7501
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Brian Cosgrove
@@ -43,6 +43,12 @@ files:
 - lib/rake/osc7501/run.rb
 - lib/rake/osc7501/version.rb
 - lib/rake/osc7501/writer.rb
+- sig/rake/osc7501.rbs
+- sig/rake/osc7501/hooks.rbs
+- sig/rake/osc7501/rspec_task.rbs
+- sig/rake/osc7501/run.rbs
+- sig/rake/osc7501/version.rbs
+- sig/rake/osc7501/writer.rbs
 homepage: https://github.com/cosgroveb/rake-osc7501
 licenses:
 - Apache-2.0