rspec-signal 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 865646144fc7ea9cdb902ea7256972fd93b0e5282726195b1bfa60d333de0ac6
+  data.tar.gz: d9a8a241a52e38b52d3b5b3f3f0d999323277a12f5b186bab8b04fdc41e36dee
+SHA512:
+  metadata.gz: 96e69e65c7994aa49d186d3211b1d38783c65a261ef0ce065dc9fd2507b08be5fad1fa167faf413537d151cc48a07dddcae729a721961ea5ca297890e5af75e3
+  data.tar.gz: 4f27334a9cf98604a33229f8c86253c855c92a91ad8f509fab93665a36a9c200340919d8c55337d10e861789e70026bfea094d88b76c26472c0281b789f56c38

data/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-08-26
+
+Initial release.
+
+### Added
+
+- `rspec-signal-parallel`, a quiet `parallel_tests` wrapper that isolates worker
+  JSON by run and test-process number, then globally merges failures into the
+  normal top-level artifacts without changing the parallel test exit status.
+- Opt-in quiet agent mode through `--format RSpec::Signal::Formatter`, preserving
+  RSpec exit status while suppressing verbose failure rendering.
+- `signal.md` as the primary and sole Markdown artifact, with `full.txt` opt-in.
+- Generic `expected`/`got` HTTP status mismatch recognition when the failing
+  expression explicitly reads `response.status`.
+
+- **Related failure clustering.** A second, looser grouping layer beside the exact
+  signatures. Failures are clustered on one shared diagnostic symptom — the HTTP
+  status that actually came back, a missing Capybara selector, a route that does
+  not exist, an ActiveRecord model or schema shape, an undefined method and its
+  receiver, an uninitialized constant, or a namespaced exception class with nothing
+  finer to go on. Reported as a short `## Related failures` section, in `signal.json`
+  as `related`, and counted on the terminal summary. Exact signatures remain the
+  authoritative grouping; a cluster only ever claims a likely common cause.
+- A cluster is only reported when it spans more than one exact signature, so the
+  layer never restates what the signature section already said.
+- **HTML response reduction.** When a failure's actual value is a large HTML
+  document — most often a Rails exception page — the markup is replaced by its
+  size, `<title>`, headings and leading visible text. The expected value is left
+  untouched, and the original is still written verbatim to `full.txt`.
+- `config.relate_failures`, `config.max_clusters`, `config.max_cluster_specs`,
+  `config.reduce_html` and `config.max_html_chars`.
+
+- `RSpec::Signal::Formatter`, installed automatically by `require "rspec/signal"`,
+  which writes a compact failure report without displacing RSpec's default
+  terminal formatter.
+- Three-way backtrace classification (project / library / framework) with
+  first-party detection that covers Bundler `path:` gems and local Rails engines.
+- Backtrace reduction that keeps every first-party frame plus the library frames
+  adjacent to them, and never produces an empty trace.
+- Deterministic failure fingerprinting and grouping on exception class,
+  normalized message, culprit frame and application context.
+- Artifacts in `tmp/rspec-signal/`: `signal.md`, `signal.json`, `full.txt`, and a
+  `.gitignore`. Artifacts are removed when a run has no failures.
+- Exception `cause` chains folded into the failure message, including the
+  first-party frame each cause came from.
+- Recovery of message and backtrace for `:aggregate_failures`, which RSpec exposes
+  only through formatter-only callbacks.
+- Capybara and Rails system-test diagnostics: URL, path, page title, status code,
+  browser console output, and the screenshot path Rails writes.
+- Credential scrubbing for auth headers, credential-shaped assignments, URL
+  userinfo, and well-known token formats, with hooks for project-specific patterns.
+
+### Changed
+
+- Diff hunk headers and HTML summary sizes are normalized out of the fingerprint,
+  so a page one line longer is no longer a different failure.
+
+[Unreleased]: https://github.com/SilenceDogood1984/rspec-signal/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/SilenceDogood1984/rspec-signal/releases/tag/v0.1.0

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chad Snow
+
+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.