rake-osc7501 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b3793bd5bf5af2934712bc5962ccbeb80cef8048675482a133d9283bad5401fb
+  data.tar.gz: 7226e2c5cef989c4f1d8ec0939680fb509b2f8f2c9d20e84fbf7bcfd353725e7
+SHA512:
+  metadata.gz: 9772443fdd8848641e903512d6486c96340003ef53ab65d9e44d3b8d737c35fa2fd574287e97716b3e0bf96c8295949f20c8e044e93c729e0c70fdba43f93f7c
+  data.tar.gz: 5d7a32e74808f681733f5a1ae28062836b8220567599cbff40ea47941c1ae57b4d8dbe9c13e73543857efb312bbd5614dd5911756641e4830fa9df345fbcd289

data/ACCESSIBILITY.md

@@ -0,0 +1,35 @@
+# Accessibility
+
+Read command output without relying on terminal status indicators. Rake keeps
+ordinary task output and errors available as text.
+
+## Plain text output
+
+Disable automatic status reporting for a Rake invocation:
+
+```sh
+RAKE_OSC7501=off RSPEC_OSC7501=off bundle exec rake
+```
+
+`RAKE_OSC7501=off` disables parent status and automatic RSpec activation.
+`RSPEC_OSC7501=off` also disables explicitly selected child status formatters.
+Task-specific tools control their own text colors and output formats.
+
+By default, Rake sends no status records to pipes, files, or terminals with
+`TERM=dumb`. `RAKE_OSC7501=force` overrides those defaults.
+
+## Environments and limits
+
+The gem requires MRI Ruby 2.1 or newer and Rake 12.3.3 or newer.
+Terminal status requires an OSC 7501-capable terminal. The gem checks for a TTY
+and honors `TERM=dumb` but does not detect OSC support.
+
+Your terminal controls display and announcements. I have not tested the status
+display with screen readers. Your screen reader may need additional settings.
+
+## Report a barrier
+
+Open an [issue](https://github.com/cosgroveb/rake-osc7501/issues) describing what
+you tried, what prevented you from using it, and what would help. Include your
+terminal, operating system, and assistive technology versions when relevant.
+You do not need to disclose a disability or other medical information.

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0 - 2026-11-11
+
+- Report Rake tasks and managed RSpec progress ([0245b76](https://github.com/cosgroveb/rake-osc7501/commit/0245b76c4f88f18b416e20fccc62f84cfa8b3239))
+- Match the RSpec repository setup ([66bf8e2](https://github.com/cosgroveb/rake-osc7501/commit/66bf8e2962137a025d9f36709d55a10cea52305d))

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,68 @@
+# Code of conduct
+
+Everyone who participates in good faith is welcome in rake-osc7501. Treat
+people with respect, regardless of race, ethnicity, caste, color, age, physical
+characteristics, neurodiversity, disability, sex, gender identity or expression,
+sexual orientation, language, philosophy, religion, national or social origin,
+income, education, or other status.
+
+## Working together
+
+Respect the project's purpose and other people's time. Discuss ideas without
+attacking people. Make room for different viewpoints and experiences. Give and
+accept constructive feedback. Account for differences in language, culture,
+and communication when interpreting what someone says.
+
+Take responsibility for what you submit, including code, reports, and comments
+produced with AI assistance. Review it before sharing, make sure you understand
+it, and respond to questions and corrections. Respect the time others spend
+reviewing your work. Take responsibility for repairing harm you cause.
+
+Do not:
+
+- Harass people, ignore a request to stop, or violate stated boundaries.
+- Make personal attacks, discriminate, or stereotype people by identity.
+- Make unwanted sexual comments or advances.
+- Share or use someone's private information without permission.
+- Threaten, encourage, or cause violence or other harm.
+- Impersonate someone or evade moderation with another identity.
+- Contribute someone else's work without credit.
+- Post unrelated advertising or present harmful content without appropriate
+  context and care.
+
+Threatening or encouraging these behaviors also violates this policy. Other
+behavior that threatens the community's well-being may warrant moderation.
+Disagreement alone is not a conduct violation.
+
+## Reporting and enforcement
+
+Report concerns privately to Brian Cosgrove at
+[cosgroveb@gmail.com](mailto:cosgroveb@gmail.com). Include what happened and any
+relevant links or messages. Do not post private reports in public issues.
+
+I review and investigate reports, hear from the people involved as needed, and
+prioritize safety and confidentiality. I share report details only as needed
+to investigate and respond. I handle enforcement privately and discuss any
+public resolution with the people involved. I respond as availability permits,
+without a guaranteed deadline.
+
+Depending on severity and repetition, I may issue a warning, remove content,
+restrict participation, or impose a temporary or permanent ban. Serious
+violations may lead to an immediate ban. Where continued participation is
+appropriate, I explain what needs to change and any conditions for returning.
+These rules apply to maintainers as well as other participants.
+
+## Scope
+
+This policy covers project spaces and anyone officially representing the
+project elsewhere, including through project accounts or at events.
+
+## Attribution
+
+Adapted from [Contributor Covenant 3.0](https://www.contributor-covenant.org/version/3/0/code_of_conduct/),
+stewarded by the Organization for Ethical Source. This adaptation shortens the
+wording and uses a maintainer-led reporting and enforcement process.
+
+This document is licensed under
+[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
+The software remains licensed under [Apache License 2.0](LICENSE).

data/CONTRIBUTING.md

@@ -0,0 +1,122 @@
+# Contributing
+
+Follow the [code of conduct](CODE_OF_CONDUCT.md). Report vulnerabilities through
+the private channel in [SECURITY.md](SECURITY.md).
+
+AI-assisted contributions are welcome. Before requesting review, understand
+the changes, run relevant checks, and verify claims in code, documentation,
+and reports. State what you tested and what remains uncertain. Be prepared to
+explain your choices and address feedback. When using an agent to help answer
+a reviewer, check the answer and send only what is relevant.
+
+Use MRI Ruby 3.4 or newer for development tooling. Install actionlint 1.7.12 on your PATH, then run all checks:
+
+```sh
+bundle install
+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`,
+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.
+
+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
+defined order because their interrupt and fail-fast cases depend on sequence.
+
+Keep runtime dependencies limited to `rake`. Cover task lifecycle behavior with real Rake subprocesses. Check paired RSpec
+reporting with `Gemfile.integration` and `RSPEC_OSC7501_PATH` pointing to a
+checkout that includes `rspec/osc7501/managed.rb`.
+
+Build the gem and documentation:
+
+```sh
+bundle exec rake package
+bundle exec rake smoke
+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.
+The smoke task builds and installs the gem in a temporary directory, then checks
+passing and failing tasks without loading the checkout's library.
+
+## Runtime compatibility
+
+The gem requires MRI Ruby 2.1 or newer and Rake 12.3.3 or newer.
+Use `Gemfile.compat` to test the runtime without modern lint, release or RDoc
+dependencies. On Ruby 2.1, install Bundler 1.17.3 first. Set the RSpec version
+before resolving dependencies:
+
+```sh
+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 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.
+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
+automation, lint and documentation.
+CI also checks RSpec 4.0.0.beta1 on Ruby 4.0.
+
+Compatibility checks use available patch releases within each Ruby series.
+Supporting an older runtime does not extend its upstream security maintenance.
+Unset `BUNDLE_GEMFILE`, `RSPEC_MINOR`, `RSPEC_CORE_VERSION` and `RSPEC_VERSION`
+before returning to the modern development bundle.
+
+Update usage or behavior documentation for user-visible changes. Write commit
+subjects that describe the change, because release notes use those subjects.
+Do not maintain `Unreleased` entries by hand. Preserve the Apache-2.0 license text.
+
+## Release
+
+Release the reviewed commits on remote `main`. Replace `NEW_VERSION` with a
+stable version greater than the current release (use `0.1.0` for the first release):
+
+```sh
+gh workflow run release.yml --ref main -f version=NEW_VERSION
+```
+
+The workflow captures `main`, updates `VERSION`, and generates CHANGELOG bullets
+from non-merge commit subjects since the previous release tag. It preserves
+older changelog sections and uses the same notes for the GitHub Release.
+Versions must use `major.minor.patch` without a `v` prefix or prerelease suffix.
+After the first release, a new version must exceed the current version and
+include new commits. The first release accepts the source version and derives
+notes from initial history when no release tags or dated changelog exist.
+
+The full CI matrix tests the prepared release commit before the workflow pushes
+it and its tag together. If `main` advances during testing, the workflow stops.
+After the push, it publishes to RubyGems, then creates the GitHub Release. No
+intermediate approval is required.
+
+If a release fails, inspect its logs and rerun the same version. If its tag
+already exists, the workflow tests and resumes that tagged release instead of
+releasing newer commits on `main`.
+
+### One-time publishing setup
+
+Before the first publication, configure a RubyGems pending Trusted Publisher with owner `cosgroveb`,
+repository `rake-osc7501`, and workflow `release.yml`. Leave the environment
+blank. The workflow uses short-lived OIDC credentials, with no RubyGems token
+stored in GitHub secrets. Repository Actions permissions must permit the
+workflow's `contents: write` and `id-token: write` requests.
+
+Store a dedicated write-enabled repository deploy key as the Actions secret
+`RELEASE_DEPLOY_KEY`. Only the publish job uses it to push the tested commit
+and tag. Require PRs and CI checks in a separate ruleset with deploy-key bypass,
+and keep deletion and force-push protection in a ruleset without bypasses.
+GitHub applies this bypass to all repository deploy keys, so additional write
+deploy keys would receive the same access. GitHub API calls still use the
+workflow token, and RubyGems still uses OIDC.

data/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,120 @@
+# rake-osc7501
+
+Add OSC 7501 terminal status to ordinary Rake tasks.
+
+```ruby
+# Gemfile
+gem 'rake-osc7501'
+```
+
+```ruby
+# Rakefile
+require 'rake/osc7501'
+
+task(:example) { sleep 5 }
+task default: :example
+```
+
+Run `bundle exec rake`. A supporting terminal receives one named Rake record
+with task activity and the command's outcome. Ordinary command output continues.
+Rake-only projects need no RSpec dependencies.
+
+## RSpec tasks
+
+RubyGems release `rspec-osc7501` 0.1.3 does not include the managed entrypoint.
+Until a gem release includes it, pin the reviewed companion commit in your Gemfile:
+
+```ruby
+gem 'rspec-osc7501', git: 'https://github.com/cosgroveb/rspec-osc7501.git',
+                     ref: '098bb55433dd05265910995b2c349e4db99869bb'
+```
+
+Run `bundle install`, then load the standard RSpec task class before this integration:
+
+```ruby
+require 'rspec/core/rake_task'
+require 'rake/osc7501'
+
+RSpec::Core::RakeTask.new(:spec)
+task(:example) { sleep 5 }
+task default: [:example, :spec]
+```
+
+Existing and later-created standard tasks receive a unique child record for each
+invocation. Automatic selection preserves RSpec's default progress formatter and
+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
+formatter selection.
+
+The adapter passes child context through the spawn environment. It preserves
+parent environment variables and task options. RSpec's clean-environment option,
+where available, receives only the child ID and explicit `RSPEC_OSC7501`,
+`RSPEC_OSC7501_TITLE`, and `TERM` controls.
+
+## Output controls
+
+| Setting | Behavior |
+| --- | --- |
+| `RAKE_OSC7501=auto` | Default. Report to stdout only when it is a TTY and `TERM` is not `dumb`. |
+| `RAKE_OSC7501=force` | Report to stdout even when redirected. |
+| `RAKE_OSC7501=off` | Disable Rake reporting and automatic RSpec activation. |
+
+Other values raise `ArgumentError`. Explicit RSpec selections retain their own
+`RSPEC_OSC7501` controls. Automatic child activation does not depend on the
+parent's TTY because each child honors its RSpec-selected stream.
+
+## Outcomes and limits
+
+Rake reports active task actions without a percentage. Overlapping actions show
+an active count. Skipped file tasks, deduplicated invocations, task listings and
+dry runs do not report executed work.
+
+Normal completion reports `done`. Exceptions and nonzero `SystemExit` report
+`error`. `Interrupt` and successful early `SystemExit` report `idle`. Reporting
+preserves Rake's scheduling, exceptions and exit behavior.
+
+Child results remain after the child and parent finish. A passing suite followed
+by a failing Rake task retains the passing child and failed parent. With
+`fail_on_error = false`, a failed child can accompany a successful parent.
+No completion clears records.
+
+Rake covers task execution after activation. Failures before activation or in
+later process-exit handlers fall outside that result. Abrupt child termination
+can leave a working record without a summary. A child summary can precede a
+process failure. Rake reports the process outcome without inventing test results.
+
+Frames stay below 4096 bytes. Messages contain sanitized UTF-8, capped at 2048
+decoded bytes. Stream errors disable reporting without closing caller streams.
+The gems install no process-wide exit or signal hooks and read no terminal input.
+Terminals control display, dismissal and notifications. Live Rex presentation
+has not been verified.
+
+## Compatibility and development
+
+Runtime targets MRI Ruby >= 2.1 and Rake >= 12.3.3. The optional adapter targets
+RSpec >= 3.6. The oldest paired check uses Ruby 2.1.10, Rake 12.3.3 and RSpec 3.6.0.
+Linux checks also cover Ruby 2.7, 3.1, 3.3, 3.4 and 4.0 with compatible RSpec
+versions, including RSpec 4.0.0.beta1 on Ruby 4.0. RSpec 3.6 has no
+clean-environment option. Other Ruby engines and macOS are unverified.
+
+On modern Ruby:
+
+```sh
+bundle install
+bundle exec rake
+RSPEC_OSC7501_PATH=../rspec-osc7501 BUNDLE_GEMFILE=Gemfile.integration bundle install
+BUNDLE_GEMFILE=Gemfile.integration bundle exec rake spec
+bundle exec ruby script/smoke.rb pkg/rake-osc7501-*.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`
+without type tooling. Pass an RSpec gem package as the smoke script's second
+argument to check installed parent/child reporting.

data/SECURITY.md

@@ -0,0 +1,22 @@
+# Security policy
+
+## Supported versions
+
+I provide security fixes for the latest released version of rake-osc7501.
+Upgrade to the latest release before checking whether a problem still occurs.
+Older releases do not receive security backports.
+
+## Report a vulnerability
+
+Use [GitHub private vulnerability reporting](https://github.com/cosgroveb/rake-osc7501/security/advisories/new).
+Do not disclose vulnerabilities in public issues or pull requests.
+
+Include the affected gem, Ruby, Rake, and optional RSpec versions, steps or a small example
+that reproduces the problem, and the impact. Include terminal and tmux versions
+when relevant. Remove credentials and unrelated private data from examples.
+
+I review reports and coordinate a fix and public disclosure with the reporter.
+Please keep details private while we work out disclosure. I cannot guarantee
+response or fix deadlines.
+
+For ordinary bugs, use the [issue tracker](https://github.com/cosgroveb/rake-osc7501/issues).

data/lib/rake/osc7501/hooks.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Rake
+  module OSC7501
+    module ApplicationHook
+      attr_reader :osc7501_run #: Run?
+
+      #: () -> Object
+      def top_level
+        return super if options.show_tasks || options.show_prereqs || options.dryrun
+
+        previous = @osc7501_run
+        begin
+          @osc7501_run = Run.new($stdout, mode: ENV.fetch('RAKE_OSC7501', 'auto'))
+          @osc7501_run.during_run { super }
+        ensure
+          @osc7501_run = previous
+        end
+      end
+    end
+
+    module TaskHook
+      #: (?Object args) ?{ (*Object) -> Object } -> Object
+      def execute(args = nil, &block)
+        run = application.osc7501_run if application.respond_to?(:osc7501_run)
+        return super unless run
+
+        run.during_task(self) { super(args, &block) }
+      end
+    end
+  end
+end

data/lib/rake/osc7501/rspec_task.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require 'shellwords'
+
+module Rake
+  module OSC7501
+    # Wrap only the standard RSpec task's launch; keep its status handling intact.
+    module RSpecTask
+      # @rbs @osc7501_context: [String, String]?
+
+      #: (bool) -> Object
+      def run_task(verbose)
+        previous = @osc7501_context
+        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
+          super
+        ensure
+          @osc7501_context = previous
+        end
+      end
+
+      #: () -> (String | Array[String] | nil)
+      def ruby_opts
+        options = super
+        return options unless @osc7501_context
+
+        [*options, "-r#{Shellwords.escape(@osc7501_context.last)}"]
+      end
+
+      private
+
+      #: () -> String?
+      def managed_path
+        return unless rspec_path == RSpec::Core::RakeTask::DEFAULT_RSPEC_PATH
+
+        specification = Gem.loaded_specs['rspec-osc7501'] || Gem::Specification.find_all_by_name('rspec-osc7501').first
+        return unless specification
+
+        path = File.join(specification.full_gem_path, 'lib/rspec/osc7501/managed.rb')
+        path if File.file?(path)
+      end
+
+      #: (*Object) -> bool?
+      def system(*arguments)
+        return super unless @osc7501_context
+
+        environment = arguments.first.is_a?(Hash) ? arguments.shift.dup : {}
+        environment['RSPEC_OSC7501_ID'] = @osc7501_context.first
+        %w[RSPEC_OSC7501 RSPEC_OSC7501_TITLE TERM].each do |key|
+          environment[key] = ENV[key] if ENV.key?(key) && !environment.key?(key)
+        end
+        super(environment, *arguments)
+      end
+    end
+  end
+end

data/lib/rake/osc7501/run.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require 'securerandom'
+require 'thread'
+
+module Rake
+  module OSC7501
+    # @rbs!
+    #   interface _TaskName
+    #     def name: () -> String
+    #   end
+
+    class Run
+      # @rbs @active: Array[_TaskName]
+      # @rbs @counter: Integer
+      # @rbs @mutex: Mutex
+      # @rbs @id: String
+      # @rbs @writer: Writer
+      # @rbs @mode: String
+      # @rbs @finished: bool
+
+      #: (IO | StringIO output, mode: String) -> void
+      def initialize(output, mode:)
+        @mode = mode
+        @id = "rake-#{Process.pid}-#{SecureRandom.hex(6)}"
+        @writer = Writer.new(output, mode: mode, id: @id)
+        @finished = false
+        @active = []
+        @counter = 0
+        @mutex = Mutex.new
+      end
+
+      #: [T] () { () -> T } -> T
+      def during_run
+        @writer.emit(state: 'working', msg: 'Running tasks')
+        result = yield
+        finish('done', 'Completed')
+        result
+      rescue Exception => e # Preserve Rake's handling of Interrupt and SystemExit.
+        stopped = e.is_a?(Interrupt) || (e.is_a?(SystemExit) && e.success?)
+        finish(stopped ? 'idle' : 'error', stopped ? 'Stopped' : 'Failed')
+        raise
+      end
+
+      #: [T] (_TaskName) { () -> T } -> T
+      def during_task(task)
+        @mutex.synchronize do
+          @active << task
+          report_active
+        end
+        begin
+          yield
+        ensure
+          @mutex.synchronize do
+            @active.delete_at(@active.rindex(task))
+            report_active
+          end
+        end
+      end
+
+      #: () -> String
+      def next_child_id
+        @mutex.synchronize do
+          @counter += 1
+          "#{@id}/rspec-#{@counter}"
+        end
+      end
+
+      #: () -> bool
+      def managed_children?
+        @mode != 'off'
+      end
+
+      private
+
+      #: (String, String) -> void
+      def finish(state, message)
+        @mutex.synchronize do
+          @finished = true
+          @writer.emit(state: state, msg: message)
+        end
+      end
+
+      #: () -> void
+      def report_active
+        return if @finished
+
+        message = if @active.empty?
+                    'Running tasks'
+                  elsif @active.length == 1
+                    @active.first.name
+                  else
+                    "#{@active.length} active tasks"
+                  end
+        @writer.emit(state: 'working', msg: message)
+      end
+    end
+  end
+end

data/lib/rake/osc7501/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Rake
+  module OSC7501
+    VERSION = '0.1.0' #: String
+  end
+end

data/lib/rake/osc7501/writer.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Rake
+  module OSC7501
+    class Writer # :nodoc: all
+      # @rbs @output: IO | StringIO
+      # @rbs @id: String
+      # @rbs @enabled: bool
+      #: (String?) -> bool
+      def self.valid_id?(id)
+        id.is_a?(String) && id.ascii_only? && id.bytesize <= 128 &&
+          !!(id =~ %r{\A[A-Za-z0-9_.+-]{1,32}(?:/[A-Za-z0-9_.+-]{1,32}){0,7}\z})
+      end
+
+      #: (IO | StringIO output, mode: String, id: String) -> void
+      def initialize(output, mode:, id:)
+        raise ArgumentError, 'RAKE_OSC7501 must be auto, off, or force' unless %w[auto off force].include?(mode)
+
+        @output = output
+        @id = id
+        @enabled = self.class.valid_id?(id) &&
+                   (mode == 'force' || (mode == 'auto' && automatic_output?))
+      rescue IOError, SystemCallError
+        @enabled = false
+      end
+
+      #: (state: String, msg: String) -> void
+      def emit(state:, msg:)
+        return unless @enabled
+
+        fields = ['app=rake', 'title=UmFrZQ==', "state=#{state}", "msg=#{encode(msg, 2048)}"]
+        fields << "id=#{@id}" if @id
+        @output.write("\e]7501;#{fields.join(':')}\e\\")
+        @output.flush if @output.respond_to?(:flush)
+      rescue IOError, SystemCallError
+        @enabled = false
+      end
+
+      private
+
+      #: () -> bool
+      def automatic_output?
+        ENV['TERM'] != 'dumb' && @output.respond_to?(:tty?) && @output.tty?
+      end
+
+      #: (String, Integer) -> String
+      def encode(text, byte_limit)
+        input = text.to_s.byteslice(0, sanitization_byte_limit(byte_limit))
+        clean = input.encode('UTF-8', invalid: :replace, undef: :replace).gsub(/[\u0000-\u001F\u007F-\u009F]/, '')
+        bytes = 0
+        bounded = clean.each_char.take_while do |char|
+          bytes += char.bytesize
+          bytes <= byte_limit
+        end.join
+        [bounded].pack('m0')
+      end
+
+      # Bound sanitization work with 50% headroom for stripped controls.
+      #: (Integer) -> Integer
+      def sanitization_byte_limit(output_byte_limit)
+        output_byte_limit + output_byte_limit / 2
+      end
+    end
+  end
+end

data/lib/rake/osc7501.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require 'rake'
+require_relative 'osc7501/version'
+require_relative 'osc7501/writer'
+require_relative 'osc7501/run'
+require_relative 'osc7501/hooks'
+
+module Rake
+  module OSC7501
+    #: (?Object application) -> void
+    def self.install!(application = Rake.application)
+      application.extend(ApplicationHook) unless application.is_a?(ApplicationHook)
+      Rake::Task.prepend(TaskHook) unless Rake::Task.ancestors.include?(TaskHook)
+      return unless defined?(RSpec::Core::RakeTask)
+
+      require_relative 'osc7501/rspec_task'
+      RSpec::Core::RakeTask.prepend(RSpecTask) unless RSpec::Core::RakeTask.ancestors.include?(RSpecTask)
+    end
+  end
+end
+
+Rake::OSC7501.install!

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: rake-osc7501
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Brian Cosgrove
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
+description: Reports Rake task activity and outcomes through OSC 7501.
+email:
+- cosgroveb@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ACCESSIBILITY.md
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- SECURITY.md
+- lib/rake/osc7501.rb
+- lib/rake/osc7501/hooks.rb
+- lib/rake/osc7501/rspec_task.rb
+- lib/rake/osc7501/run.rb
+- lib/rake/osc7501/version.rb
+- lib/rake/osc7501/writer.rb
+homepage: https://github.com/cosgroveb/rake-osc7501
+licenses:
+- Apache-2.0
+metadata:
+  source_code_uri: https://github.com/cosgroveb/rake-osc7501
+  bug_tracker_uri: https://github.com/cosgroveb/rake-osc7501/issues
+  changelog_uri: https://github.com/cosgroveb/rake-osc7501/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Opt-in OSC 7501 terminal status for Rake tasks
+test_files: []