rspec-tracer 1.2.3 → 2.0.0.pre.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c0ed3fbdb4a082d56a4d83a528dff26bd174abeb28cf1669dc5dd79de521cee
-  data.tar.gz: ebc2fbdfde4c6ac82072b5464f5dc0441d73efd24b4410ed96d3892ea765f1a9
+  metadata.gz: 552b92475298cfa692f8748b7b7097b12a82a2e8b1003848d1194fe560c0b385
+  data.tar.gz: 34a9d94756083aaf46220460c4d10002d30992703c1aad0e417640ad5b2d79ae
 SHA512:
-  metadata.gz: 1c28a6a997cf74dbb8d910972d9dd8e0b6e9f36aaacc9670e8a50a6bf7c0d4100f6cf421befcba8349750c3ba179a05b86d2a0cbdf740280d490d4bd42c37512
-  data.tar.gz: ce834032d235ea1e2775fb127ac040d6f12f560e7cf9babe5fd208a68cb5dd7260a2ac1f2af78b2a782a622902d9b8291adb2ca339837de70b9f12259e05a456
+  metadata.gz: 57b510bf3f8da2071a72ee222d598e9ce8042b5745cec84e053ea7b7db87e203e73829f890f105d934901835813cee66290ff0b24a07f278b1821c3b75febdb7
+  data.tar.gz: 57adb9424e1bdc3775294de9573726f3b80bea35615d6a41410985724d930faa00c984bf3c9b637297565fa11bf72c938bb92ce8464b7968c9be9fa5b476b2f2

data/CHANGELOG.md

@@ -1,81 +1,398 @@
-## [1.2.3] - 2026-05-06
+## [2.0.0.pre.2] - 2026-05-16
+
+Bug-fix + interop release after the field-test pass that followed
+`v2.0.0.pre.1`. 15 issues filed publicly
+([#182](https://github.com/avmnu-sng/rspec-tracer/issues/182)–[#196](https://github.com/avmnu-sng/rspec-tracer/issues/196))
+plus two follow-on findings
+([#210](https://github.com/avmnu-sng/rspec-tracer/issues/210) and
+[#218](https://github.com/avmnu-sng/rspec-tracer/issues/218))
+surfaced during fix-verification; all 17 are closed at tag. No CI
+surface drops, no Ruby / Rails / RSpec floor changes.
+
+The cumulative cache `schema_version` path is `3 → 5` (two bumps
+across [#209](https://github.com/avmnu-sng/rspec-tracer/pull/209)
+and [#211](https://github.com/avmnu-sng/rspec-tracer/pull/211));
+a pre.1 cache cold-loads cleanly on the pre.2 upgrade in one cold
+run, then warm caches resume. See [`UPGRADING.md`](UPGRADING.md).
+
+### Added
+
+- **`coverage_modes` config DSL** for the standalone Coverage
+  path (no SimpleCov). Pass any subset of
+  `[:lines, :branches, :methods, :oneshot_lines, :eval]`; default
+  `[:lines]` keeps byte-compatibility with prior runs. Threaded
+  through both `RSpecTracer.setup_coverage` and
+  `Engine#ensure_coverage_started`; inert when SimpleCov drives
+  Coverage. New COOKBOOK recipe "Coverage modes (rspec-tracer +
+  SimpleCov interop)" under recipe 9 documents the per-mode
+  interop matrix.
+- **`bin/rspec-tracer cache:clear --force` / `-f`** as a synonym
+  for `--yes` / `-y`. Matches the common Unix-CLI convention.
+- **COOKBOOK recipe for the `:msgpack` serializer** documenting
+  the `storage_backend :json, serializer: :msgpack` option for
+  ~3.5× smaller caches than `:json` on dependency-heavy suites.
+  Notes that `.msgpack.gz` payloads are raw `Zlib::Deflate`
+  streams (not gzip format) — the suffix is cosmetic and may
+  change in a future major release.
+
+### Changed
+
+- **Cache `schema_version` bump 3 → 5** (cumulative). The
+  `example_id` digest now drops the load-order-dependent
+  generated-class-name suffix and the line-number fields, and
+  substitutes a positional discriminator for unnamed
+  `it { }` / `specify { }` / `example { }` examples that
+  previously picked up RSpec's `"example at <path>:<line>"`
+  description fallback. First run on pre.2 is cold; subsequent
+  runs return to warm. See [`UPGRADING.md`](UPGRADING.md)
+  "Schema-version cold runs."
+- **Duplicate-example-identity detection now prune-and-continue.**
+  When the runner detects two examples with the same identity,
+  it drops the colliders from the run and lets the rest of the
+  suite proceed, instead of aborting the entire run to zero
+  examples. `fail_on_duplicates` becomes purely an exit-code
+  lever — the non-colliding remainder always runs. The error log
+  names the colliding examples (file:line + description) with a
+  remediation hint. See [`UPGRADING.md`](UPGRADING.md)
+  "Duplicate example identities."
 
 ### Fixed
 
-- **Parallel-tests purge race when a sibling worker is still mid-flush**
-  — the elected worker trusted only `parallel_tests`'s pid-file barrier
-  (`ParallelTests.wait_for_other_processes_to_finish`), which under
-  specific scheduling/I/O timing on GHA Linux x86_64 can return while a
-  sibling's `parallel_tests_N/` dir hasn't fully flushed. The elected
-  then merged + purged, racing the in-progress sibling. Symptoms:
-  intermittent leftover `parallel_tests_N/` dir post-purge AND/OR
-  silently dropped peer caches in the merge.
-
-  Backport of upstream PR
-  [#168](https://github.com/avmnu-sng/rspec-tracer/pull/168). Adds a
-  filesystem barrier layered on top of the pid-file wait. Each worker
-  writes a `.rspec_tracer_boot` marker at `RSpecTracer.start` time and
-  a `.rspec_tracer_done` marker as the first step of its at_exit tasks;
-  the elected worker waits for every booted peer's `.done` to
-  materialize before proceeding to merge + purge. Two independent
-  signals (pid file + filesystem) must agree before the elected worker
-  declares the peer set stable. Bounded at 5 s with a graceful warn for
-  crashed peers — their dirs are purged regardless of completion state,
-  and the merge accepts whatever's on disk.
-
-## [1.2.2] - 2026-05-04
+- **Restored flaky-test detection across runs.** A top-line
+  README feature present in 1.x since v1.0.0; silently dropped
+  in the 2.0 rewrite — the registry `:flaky` status, the
+  `:flaky_example` filter reason, the `flaky_examples` snapshot
+  field, and the HTML reporter's Flaky tab were all retained,
+  but no production code path transitioned an example into
+  `:flaky`. `on_example_passed` now promotes a
+  previously-failed-or-flaky example into `:flaky`;
+  `on_example_failed` keeps a previously-flaky example sticky.
+  Closes [#194](https://github.com/avmnu-sng/rspec-tracer/issues/194).
+- **`run_reason` field in `report.json` (and the terminal
+  `by reason:` line) now persists the correct reason on warm
+  runs for every reason path** — `Failed previously`,
+  `Pending previously`, `Interrupted previously`, `Files changed`,
+  `Environment changed`. Previously displayed as `No cache` on
+  every warm-run case because `Engine#register_example`
+  short-circuited on the entry already seeded from the previous
+  snapshot. Single-character fix closing all five reason paths.
+  Closes [#186](https://github.com/avmnu-sng/rspec-tracer/issues/186).
+- **Parallel-`tests` `cache_hit_reason` counts no longer inflated
+  by worker count.** Each worker independently computed an
+  identical `filtered_examples` hash against the global
+  previous-run snapshot; the pre-fix sum-merge inflated
+  always-re-run buckets N-fold. The merge now keys on
+  `example_id` (first-write-wins), then re-tallies. Closes
+  [#193](https://github.com/avmnu-sng/rspec-tracer/issues/193).
+- **`example_id` stable across runs when multiple files share a
+  `describe` name** (the load-order-dependent
+  `RSpec::ExampleGroups::Name_N` disambiguator suffix is no
+  longer in the digest) **and stable across line-shift edits for
+  unnamed one-liner examples** (`it { is_expected.to eq(7) }`,
+  `specify { ... }`, `example { ... }`). Long-standing bugs since
+  v1.0.0; pervasive in shoulda-matchers model specs which are
+  almost entirely one-liner matcher syntax. Closes
+  [#196](https://github.com/avmnu-sng/rspec-tracer/issues/196)
+  + [#210](https://github.com/avmnu-sng/rspec-tracer/issues/210).
+- **NPE in `RSpec.world.example_count` for suites with
+  intermediate describe groups after rspec-tracer drops a
+  duplicate-identity example.** Companion fix to the
+  duplicate-detection prune-and-continue redesign above — the
+  kept-map needed a default block so descendants of an
+  intermediate describe (a describe containing only nested
+  describes, no direct `it`s) resolve to an empty array on the
+  `filtered_examples` lookup instead of `nil`. Closes
+  [#218](https://github.com/avmnu-sng/rspec-tracer/issues/218).
+- **`storage_backend :json, serializer: :msgpack` no longer
+  crashes on `Time` values** (and `Symbol` values now round-trip
+  losslessly across the cache). Registered
+  `MessagePack::Factory` type extensions for `Time` (12-byte
+  `tv_sec + tv_nsec`, UTC-canonicalized on decode) and `Symbol`
+  (UTF-8 body). Users who followed rspec-tracer's own 50 MiB
+  cache warning's `:msgpack` recommendation no longer brick
+  their cache silently on the first run that writes a `Time`.
+  Closes [#182](https://github.com/avmnu-sng/rspec-tracer/issues/182).
+- **`bin/rspec-tracer cache:info` and `explain` now compose with
+  `storage_backend :sqlite`.** Previously hardcoded the
+  JsonBackend on-disk layout and reported `no last_run.json yet`
+  on every sqlite run, even after a successful rspec. Both CLI
+  sub-commands now dispatch through a shared
+  `Storage::Backend.build` factory; sqlite metadata-table reads
+  surface alongside JSON manifest reads behind the same
+  protocol. Closes
+  [#183](https://github.com/avmnu-sng/rspec-tracer/issues/183).
+- **`bin/rspec-tracer doctor` no longer false-reports `SimpleCov:
+  not loaded` / `Rails: not loaded`** when those gems ARE in the
+  Gemfile (doctor runs in its own process; app code doesn't load
+  there). Three states are now reported: loaded-in-this-process
+  (`OK`), installed-but-not-loaded
+  (`INFO ... installed (<version>; not loaded in doctor's process)`),
+  and not-installed (`INFO ... not installed`). Closes
+  [#184](https://github.com/avmnu-sng/rspec-tracer/issues/184).
+- **`bin/rspec-tracer` invocation guidance flipped to
+  `bundle exec rspec-tracer`** across README, COOKBOOK, and
+  UPGRADING. The bare `bin/rspec-tracer` form required users to
+  run `bundle binstubs rspec-tracer` first; `bundle exec
+  rspec-tracer` works out of the box. Closes
+  [#185](https://github.com/avmnu-sng/rspec-tracer/issues/185).
+- **`reports_s3_path` deprecation warning no longer false-flags
+  on the probe path** — when no `remote_cache_backend` /
+  `remote_cache_uri` is configured AND the user runs
+  `rake rspec_tracer:remote_cache:download` / `:upload` /
+  `:prune_all`. A new non-warning predicate gates the probe; the
+  deprecation now fires only on legitimate use of the legacy
+  DSL. Closes
+  [#187](https://github.com/avmnu-sng/rspec-tracer/issues/187).
+- **`remote_cache` success now emits visible INFO lines** for
+  `download!` (`restored cache from <ref>` — with a
+  `(cross-branch fallback)` qualifier when a PR-tier download
+  falls through to a commit-ancestry ref successfully),
+  `upload!` (`uploaded cache to <ref>`), and `prune_all!`
+  (`prune_all removed N refs`). One fix covers all three
+  backends (s3 / redis / file) + the cron-driven `prune_all`
+  admin task. Closes
+  [#188](https://github.com/avmnu-sng/rspec-tracer/issues/188).
+- **`track_ar_schema_notifications` now installs correctly under
+  the canonical README setup order** (`RSpecTracer.start` BEFORE
+  `require_relative '../config/environment'`). Previously,
+  `defined?(::Rails::VERSION)` was false at engine.setup time
+  and the entire Rails-observer install path short-circuited —
+  the `sql.active_record` subscriber never attached AND the
+  documented `use_transactional_fixtures`-widening warn never
+  fired. Now late-binds via a `before(:suite)` hook that
+  re-checks Rails-loaded state after `rails_helper.rb` has
+  required the environment. Closes
+  [#192](https://github.com/avmnu-sng/rspec-tracer/issues/192).
+- **`RSpecTracer.start` no longer crashes** when the user
+  pre-starts `::Coverage` (e.g. to opt into branch coverage for
+  SimpleCov-free runs). The `setup_coverage` entry point now
+  matches `Engine#ensure_coverage_started`'s `Coverage.running?`
+  guard + `RuntimeError` rescue. Closes
+  [#195](https://github.com/avmnu-sng/rspec-tracer/issues/195).
+- **`InvalidUsageError` raised on conflicting
+  `remote_cache_backend` / `remote_cache_uri` configuration now
+  names both DSLs and explains they are alternatives.** The
+  previous `<dsl> already configured` message was confusing when
+  the user only typed `remote_cache_uri` (which dispatches
+  internally to `remote_cache_backend`).
+- **README per-example-precision section now covers Rails
+  engines.** An engine's own `lib/` is `require`d at gem-load
+  time via the Gemfile.lock cascade and lands in the boot set
+  **regardless of `eager_load`**. COOKBOOK gains a
+  `transitive_load_tracking false` opt-out recipe with the
+  trade-off documented. Closes
+  [#189](https://github.com/avmnu-sng/rspec-tracer/issues/189).
+- **Engine + dummy-app two-rspec-summary explainer** added to
+  COOKBOOK — clarifies which of the two terminal summary totals
+  is authoritative when an engine fixture invokes RSpec against
+  its dummy app. Closes
+  [#190](https://github.com/avmnu-sng/rspec-tracer/issues/190).
+
+## [2.0.0.pre.1] - 2026-05-06
+
+The first pre-release of the 2.0 line. Architecture rewrite around
+the input-taxonomy mental model documented in
+[`ARCHITECTURE.md`](ARCHITECTURE.md): every test is a pure function
+of its inputs; tracking is input identification; cache invalidation
+is input-digest mismatch.
+
+The 1.x cache is not readable by 2.0 — first run on the new version
+is cold, then warm caches resume. Existing CI integration (`rake
+rspec_tracer:remote_cache:download` / `:upload`, the env vars,
+the `rspec_tracer_cache/` / `rspec_tracer_coverage/` /
+`rspec_tracer_report/` directory contracts) is preserved bit-for-bit.
+
+### Added
+
+- **Pluggable storage backends.** `storage_backend :json` (default,
+  preserves 1.x JSON layout) or `storage_backend :sqlite` (single-
+  file SQLite database; MRI only — JRuby falls back to `:json` with
+  a one-time warn). The 10-file per-run JSON layout (`last_run.json`
+  + `<run_id>/{all_examples,duplicate_examples,interrupted_examples,
+  flaky_examples,failed_examples,pending_examples,skipped_examples,
+  all_files,dependency,examples_coverage}.json`) is unchanged.
+- **Pluggable remote-cache backends.** `remote_cache_backend :s3`
+  (preserves the 1.x S3 layout including `awslocal` / LocalStack
+  support), `:local_fs` (filesystem-backed; no S3 needed), or
+  `:redis` (with optional per-key TTL + `<prefix>:pr_branches`
+  sidecar SADD on PR-tier uploads for ops dashboards).
+- **Per-example `tracks:` DSL.** Annotate any describe / context /
+  example with `tracks: { files: 'app/policies/**/*.rb', env:
+  'ROLE_CONFIG' }` to declare extra inputs the tracker can't auto-
+  observe — config files baked at boot, env-var branches, and
+  similar. `:files` accepts a string glob or array; `:env` accepts a
+  literal name, array, or single-wildcard pattern (`'RAILS_*'`,
+  `'*_TOKEN'`, `'*'`). Cascade unions parent + child without
+  clobbering.
+- **`track_env(*names)` config-level DSL** for env vars every test
+  depends on (`AUTH_TOKEN`, `DATABASE_URL`, `RAILS_ENV`). Same
+  wildcard syntax as the per-example `tracks: { env: ... }`.
+  Persists as `env_snapshot.json` (concrete keys only, no pattern
+  leakage).
+- **`track_files(*globs)` config-level DSL** for files every test
+  depends on (`Gemfile.lock`, schema, locale catalogs).
+- **Rails preset** via `track_rails_defaults` — auto-attaches the
+  common Rails-side declared globs (views, locales, fixtures,
+  factories, helpers, config). `track_rails_defaults except:
+  [:views, :schema]` opts specific globs out so framework-event
+  subscribers (`render_template.action_view` for views; the opt-in
+  `sql.active_record` observer enabled by
+  `track_ar_schema_notifications` for `db/schema.rb`) attribute
+  them per-example instead.
+- **Auto-detection of Rails** at start time; the engine attaches
+  `ActionView` template + `ActiveRecord` schema (when opted in)
+  notification observers automatically when `::Rails::VERSION` is
+  defined.
+- **`bin/rspec-tracer` CLI** with five sub-commands:
+  `doctor` (config + environment diagnosis, schema-version + remote-
+  cache reachability + AR-schema-narrow checks), `cache:info`
+  (size, last run, invalidation stats), `cache:clear` (rm cache
+  dirs), `report:open` (open the HTML report in the default
+  browser), `explain <example_id>` (show why a given example is
+  scheduled to run or skip). The CLI is opt-in for local-dev
+  convenience; the `rake rspec_tracer:remote_cache:*` tasks remain
+  first-class for CI integration.
+- **Boot-time warns** for two common user-trust traps:
+  - SimpleCov loaded but not started before `RSpecTracer.start`
+    (load-order is part of the documented contract; the warn
+    surfaces it instead of silently bolting onto a Coverage already
+    in flight).
+  - `track_ar_schema_notifications` enabled with
+    `use_transactional_fixtures` defaulting to true (per-example
+    BEGIN/COMMIT fires `sql.active_record` and attributes
+    `db/schema.rb` to every AR-touching example; the warn points
+    at the README "Narrow AR-schema attribution" guidance).
+- **`.rspec-tracer` DSL typo `did you mean?` suggestions** at config
+  load — typos like `track_filez` raise `InvalidUsageError` with a
+  pointer at `track_files`.
+- **Rails 8.0 CI-gated support** (Ruby 3.2+ required; Rails 8.0
+  dropped Ruby 3.1 support upstream). `jruby-9.4 × Rails 8.0` is
+  unsupported (no `activerecord-jdbcsqlite3-adapter ~> 80.0`
+  upstream).
+- **Schema-version field** in `last_run.json` for explicit
+  cross-version cache validation. Cache-shape changes bump the
+  field; mismatched caches refuse-to-load with an info-level "cold
+  run" log line.
+- **`docs/CI_RECIPES.md`** translating the
+  [`.github/workflows/example-tracer-cache.yml`](.github/workflows/example-tracer-cache.yml)
+  GitHub Actions cache pattern to CircleCI / GitLab CI / Buildkite
+  / Heroku CI. The 4-component cache key (`runner.os` +
+  `.ruby-version` + `lib/rspec_tracer/version.rb` + Gemfile-hash)
+  translates 1:1 across providers; only the YAML envelope is
+  GHA-specific.
+- **Coexistence smokes** for `rspec-retry`, `rspec-rerun`, and
+  `knapsack`. All three compose with rspec-tracer's `Module#prepend`
+  chain on `RSpec::Core::Runner` / `Reporter` without override.
+- **`bin/rspec-tracer doctor` reachability checks** for the
+  configured remote-cache backend (S3 / Local-FS / Redis) — surfaces
+  misconfigured credentials / missing buckets / unreachable Redis
+  hosts at first invocation instead of mid-CI-run.
+- **HTML reporter** (committed build output, no `assets:precompile`
+  step on user installs) and **JSON reporter** (machine-readable,
+  for CI dashboards) alongside the existing terminal output. The
+  terminal line now includes a `by reason:` breakdown
+  (`12 Files changed · 3 Whole-suite invalidator changed · ...`)
+  and a cache size + delta suffix (`14.4 MiB; +6.7 KiB vs prev
+  run`).
+
+### Changed
+
+- **Ruby ≥ 3.1** is the floor (1.x supported Ruby 2.5+). 3.2, 3.3,
+  3.4, 4.0 + JRuby 9.4 are CI-gated. Rails 7.0 / 7.1 / 7.2 / 8.0 +
+  RSpec 3.12 / 3.13 are CI-gated.
+- **SimpleCov branch coverage now works alongside rspec-tracer.**
+  The 1.x caveat ("SimpleCov would not report branch coverage
+  results even when enabled") is **no longer applicable** — the
+  coverage-stack rewrite decoupled rspec-tracer's line-only
+  emission from SimpleCov's branch-tracking. Users who turned
+  `enable_coverage :branch` off when adopting rspec-tracer 1.x can
+  re-enable in 2.0.
+- **Cache schema bump.** First run on 2.0 is cold; subsequent runs
+  return to warm.
+- **Coverage adapter** consolidated: a single
+  `Reporters::CoverageJsonReporter` owns `coverage.json` emission
+  (replacing the 1.x `CoverageReporter` + `CoverageWriter` pair).
+  Output shape preserved.
+- **Parallel-tests reporter behavior:** terminal / JSON / HTML
+  reports now emit ONCE at the merged top-level location after
+  `merge_snapshot!` runs, instead of per-worker (where
+  `purge_worker_dirs!` then removed them and left users with no
+  usable output). Per-worker emission was a pre-2.0 behavior bug.
 
 ### Fixed
 
+- **ERB template tracking via `render_template.action_view`** (closes
+  the issue behind upstream
+  [#66](https://github.com/avmnu-sng/rspec-tracer/issues/66)). The
+  Rails subscriber attributes rendered ERB partials to the example
+  that triggered the render.
+- **Phantom `metadata[:file_path]` graceful skip** (closes the issue
+  behind upstream
+  [#72](https://github.com/avmnu-sng/rspec-tracer/issues/72)). Specs
+  whose `metadata[:file_path]` doesn't resolve to a readable file
+  (gem-generated examples, deleted-between-runs files) now log
+  debug + skip dependency registration instead of raising.
 - **Default filter list now excludes rspec-tracer's own output
-  directories** (`rspec_tracer_cache/`, `rspec_tracer_coverage/`,
-  `rspec_tracer_report/`, and the `rspec_tracer.lock` file). Prior
-  versions did not exclude these paths, so any spec that read a tracer
-  cache file (typical for outer integration specs that assert on cache
-  state after a fixture subprocess run) had those paths attributed as
-  dependencies. The user-visible symptom was reverse-dependency reports
-  showing tracer-self paths as deps of unrelated specs, plus
-  spurious files-changed re-runs whenever the tracer rewrote its own
-  cache. Both `add_filter` and `add_coverage_filter` defaults updated.
-
-- **Carry-forward filter contract** — newly added filters now apply
-  uniformly to both fresh attribution AND prior-snapshot carry-forward.
-  Previously, `Cache#load_all_files_cache` and `load_dependency_cache`
-  read previous-run state without re-applying the current filter list.
-  A user adding a new filter mid-development saw the filter take
-  effect only for fresh attributions on cold runs; previously-cached
-  paths matching the new filter persisted in `all_files` and
-  `dependency` until the next cold run. Filter additions now take
+  directories** — `rspec_tracer_cache/`, `rspec_tracer_coverage/`,
+  `rspec_tracer_report/`, `rspec_tracer.lock`. Previously, tests
+  that read the tracer's own cache files (e.g. integration specs
+  asserting on cache state after a fixture subprocess run) got
+  those paths attributed as deps. The tracer's output is
+  regenerated every run by design and should never invalidate a
+  test. Both `add_filter` (dep graph) and `add_coverage_filter`
+  (coverage report) lists were updated.
+- **`add_filter` / `add_coverage_filter` now apply uniformly to
+  both fresh attributions AND prior-snapshot carry-forward.**
+  Previously, `Engine#seed_all_files_from_previous` and
+  `Engine#seed_graph_from_previous` seeded paths from the previous
+  run's snapshot WITHOUT re-applying the current filter list — so
+  a filter added between runs would NOT exclude already-cached
+  paths until a cold run wiped them. Filter additions now take
   effect on the very next warm run.
 
-## [1.2.1] - 2026-05-01
+### Deprecated
 
-### Fixed
+The 1.x configuration surface keeps working; each deprecated entry
+fires one `logger.warn` at first use pointing at the replacement.
+The deprecated values still resolve semantically. All four are slated
+for removal in 3.0.
+
+- **`reports_s3_path(uri)`** → use **`remote_cache_uri(uri)`**.
+- **`use_local_aws(bool)`** → use **`remote_cache_backend :s3,
+  local: true`**.
+- **`RSPEC_TRACER_REPORTS_S3_PATH`** → use
+  **`RSPEC_TRACER_REMOTE_CACHE_URI`**.
+- **`RSPEC_TRACER_USE_LOCAL_AWS`** → fold into
+  `remote_cache_backend` params.
+
+### Removed
 
-- **Parallel-tests merge silently dropped peer caches and left worker
-  directories behind** when the spawned-worker count exceeded
-  `ENV['PARALLEL_TEST_GROUPS']`. The merge + purge call-sites in
-  `lib/rspec_tracer.rb` (`merge_parallel_tests_reports`,
-  `merge_parallel_tests_coverage_reports`,
-  `purge_parallel_tests_reports`) iterated `1..ENV['PARALLEL_TEST_GROUPS']`
-  to construct per-worker directory names. But parallel_tests sets
-  `PARALLEL_TEST_GROUPS = num_processes.to_s` for each child, where
-  `num_processes` is the user-requested process count
-  (`Parallel.processor_count` by default) — not the actual worker
-  count. When `num_processes < spawned_worker_count` (e.g. when the
-  spec-count partition produces more non-empty groups than
-  `num_processes`, or shared-runner CPU detection drifts mid-run),
-  peer caches with `TEST_ENV_NUMBER` above the env bound were silently
-  dropped from the merge (warm-run skip decisions get made against
-  an under-sampled merged manifest) and left behind by the purge
-  (visible as straggler `parallel_tests_<N>/` directories under
-  `rspec_tracer_cache/`). The same gem behaviour was documented on
-  v1.1.1's `last_process?` fix
-  ([PR #101](https://github.com/avmnu-sng/rspec-tracer/pull/101)) but
-  the iteration call-sites kept the buggy bound. Each method now globs
-  the actual `parallel_tests_*` subdirectories under its base path,
-  making the merge + purge robust to whatever count parallel_tests
-  spawned. No cache format change.
+- **Cucumber feature-file integration suite.** Contributor-facing
+  only; users see no change. Replaced by RSpec subprocess
+  integration specs under `spec/integration/`. The `bundle exec
+  rake` legacy entry point is removed; `task` (Taskfile) is the
+  canonical dev loop.
+- **Ruby ≤ 3.0 and Rails ≤ 6.x support** (already dropped in 1.1.0;
+  re-stated here for clarity at the major boundary).
+- **Windows support** (no CI gate; never actively maintained).
+
+### Deferred to 2.1
+
+- **Per-example dependency attribution under Rails
+  `config.eager_load = true`.** When `eager_load = true` (Rails
+  default for CI tests to mirror prod), all `app/` files load at
+  boot and land in the boot-set; the whole-suite invalidator fires
+  on any `app/` edit, re-running every example. This is SAFE (never
+  misses a dep) but coarser than per-example attribution. The 2.1
+  enhancement will install a class-attribution mechanism (working
+  name: `track_class_attribution`) using `TracePoint(:class)` at
+  boot + `TracePoint(:call)` per example to trim the invalidator
+  scope to only examples that touched the changed file's class /
+  method surface. Opt-in by default; designed from scratch on the
+  user-shape problem (not a resurrection of any 1.x DSL name).
+  Today's escape hatches: set `config.eager_load = false` in test
+  env for full per-example precision, or use `tracks: { files:
+  '...' }` for per-example narrowing on specific groups.
 
 ## [1.2.0] - 2026-04-24