heapscope 0.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f1ac0f631627ce36c708e8a675265170999f9692b5a3d1c883941c01338a814c
+  data.tar.gz: ccf46c30e092d097872925d3a5cfcf124f2a8dd4d252beaf7f5666f9d48d38d1
+SHA512:
+  metadata.gz: 22906c262dd5681cde4b144388818220aa991084679fd709186720e7c50cb4455bb0f7a51a51044b37cc4cb91392364bf55dd9857ad613fe3c96e2f482e9bcc8
+  data.tar.gz: 246a6b67bb0d24839ac72320e458e2955a01d5452da4aca8b1a0f41aa43d7592d2082cd0546f38e371af5b63ec4204efd6f9ae50d4f9e3f277792483fd1ce63d

data/.rubocop.yml

@@ -0,0 +1,119 @@
+AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "vendor/**/*"
+    - "examples/**/*"
+    - "benchmark/**/*"
+    - "*.gemspec"
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Style/MutableConstant:
+  Enabled: false
+
+Naming/MethodParameterName:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 100
+  Exclude:
+    - "lib/heapscope/report/html.rb"
+    - "lib/heapscope/report/text.rb"
+
+Metrics/ClassLength:
+  Max: 400
+
+Metrics/ModuleLength:
+  Max: 400
+
+Metrics/AbcSize:
+  Max: 250
+  Exclude:
+    - "lib/heapscope/report/text.rb"
+
+Metrics/CyclomaticComplexity:
+  Max: 45
+  Exclude:
+    - "lib/heapscope/report/text.rb"
+
+Metrics/PerceivedComplexity:
+  Max: 45
+  Exclude:
+    - "lib/heapscope/report/text.rb"
+
+Metrics/ParameterLists:
+  Max: 15
+
+Metrics/BlockLength:
+  Max: 40
+  Exclude:
+    - "heapscope.gemspec"
+    - "test/**/*"
+    - "Rakefile"
+
+Metrics/BlockNesting:
+  Max: 4
+
+Layout/LineLength:
+  Max: 180
+
+Style/StringLiteralsInInterpolation:
+  Enabled: false
+
+Style/EmptyStringInsideInterpolation:
+  Enabled: false
+
+Lint/ShadowedException:
+  Enabled: false
+
+Lint/NoReturnInBeginEndBlocks:
+  Enabled: false
+
+Layout/EmptyLinesAfterModuleInclusion:
+  Enabled: false
+
+Lint/AmbiguousBlockAssociation:
+  Enabled: false
+
+Lint/DuplicateBranch:
+  Enabled: false
+
+Lint/UselessConstantScoping:
+  Enabled: false
+
+Style/NumericPredicate:
+  Enabled: false
+
+Style/BlockDelimiters:
+  Enabled: false
+
+Style/MultipleComparison:
+  Enabled: false
+
+Style/FormatStringToken:
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/SafeNavigationChainLength:
+  Enabled: false
+
+Naming/PredicateMethod:
+  Enabled: false
+
+Lint/AmbiguousOperatorPrecedence:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  AllowUnusedKeywordArguments: true
+  IgnoreEmptyMethods: true
+
+Style/OptionalBooleanParameter:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+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).
+
+Detailed release write-ups live in [`docs/changelogs/`](docs/changelogs/).
+
+## [Unreleased]
+
+## [0.6.0] — 2026-08-13
+
+### Added
+
+- Budget presets: `rails_request`, `sidekiq_job`, `ci_strict` (`Budget.preset` / `HeapScope.budget_preset`)
+- Finding priority ranking + dedupe (`Findings.rank_and_dedupe`, `Finding#priority`)
+- Next-steps recommendations (`Suggest.next_steps`, `HeapScope.next_steps`, report sections)
+- `heapscope watch` — monitor with anomaly alerts (RSS / live-slot spikes)
+- Monitor `--alert` / `--rss-alert-bytes` / `--live-alert-slots`
+- Slim snapshot JSON (`Snapshot#save(..., slim: true)`, `heapscope snapshot --slim`)
+- `heapscope doctor --fix` + `--config-out` — write starter `heapscope.yml`
+- `HeapScope.write_config!` / `ConfigLoader.write_starter!`
+- Branding asset path helpers (`LOGO_SVG`, `WORDMARK_SVG`, `logo_svg_inline`)
+- Examples package README with logo/wordmark
+- Rake `docs:codes` task for diagnostic catalog generation
+
+### Changed
+
+- Version **0.6.0** — cohesive professional product release
+- `Probe` / `Scorecard` extracted from `session.rb` into `scorecard.rb`
+- `ConfigLoader` moved from `noise.rb` into `config.rb`
+- Framework ignore hints owned by `Noise::FRAMEWORK_HINTS` (Suggest reuses them)
+- Analyzer / retention reports apply ranked, deduped findings
+- CLI `suggest` prints next steps + ignore patterns; `--ignores-only` / JSON payload expanded
+- HTML reports prefer packaged logo SVG when available; include Next steps
+- README / docs / roadmap present a single current-product story (not stacked milestones)
+- Supported versions table updated for 0.6.x
+
+## [0.5.0] — 2026-08-13
+
+### Added
+
+- `.github/FUNDING.yml` with GitHub Sponsors (`theworker02`) and thanks.dev (`u/gh/theworker02`)
+- GitHub Pages site under `site/` + `pages.yml` deploy workflow
+- `HeapScope::Branding` — banner, funding URLs, report footers, `HeapScope.about` / `.branding`
+- `HeapScope::Suggest` + `heapscope suggest` — recommended ignore patterns (never auto-applied)
+- `HeapScope::Pack` + `heapscope pack` — local JSON+HTML+Markdown report bundles
+- CLI `about` command; doctor/help/report footers include funding + docs links
+- Gem metadata `funding_uri` / Pages `documentation_uri`
+- Expansive CLI UX: global `--verbose` / `--quiet` / `--config` / `--json` / `--color` / `--no-color`
+- Per-command help; modular CLI under `lib/heapscope/cli/`
+- CLI commands: `probe`, `measure`, `retention`, `findings`, `scorecard`, `table`, `explain`,
+  `open`/`html`, `self-test`, `env`, `completion`, `man`; aliases `export`, `ignore-suggest`
+- `Catalog.explain` / `Catalog.lookup` for diagnostic encyclopedia entries
+
+### Changed
+
+- Version **0.5.0**
+- Homepage / source URIs → `https://github.com/theworker02/heapscope`
+- `Catalog` extracted from `session.rb` into `catalog.rb`
+- Suggest reuses `Noise` defaults instead of duplicating framework regexes
+
+## [0.4.0] — 2026-08-13
+
+Sessions, scorecards, schema validation, diagnostic catalog, GitHub templates.
+
+## [0.3.0] — 2026-08-12
+
+Aging, globals, closures, fibers, dominators, trends, doctor.
+
+## [0.2.0] — 2026-08-12
+
+Branding, detectors, richer HTML, eval harness, security/CoC.
+
+## [0.1.0] — 2026-08-12
+
+Initial retention toolkit.
+
+[Unreleased]: https://github.com/theworker02/heapscope/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/theworker02/heapscope/releases/tag/v0.6.0
+[0.5.0]: https://github.com/theworker02/heapscope/releases/tag/v0.5.0
+[0.4.0]: https://github.com/theworker02/heapscope/releases/tag/v0.4.0
+[0.3.0]: https://github.com/theworker02/heapscope/releases/tag/v0.3.0
+[0.2.0]: https://github.com/theworker02/heapscope/releases/tag/v0.2.0
+[0.1.0]: https://github.com/theworker02/heapscope/releases/tag/v0.1.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,38 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in the
+HeapScope community a harassment-free experience for everyone, regardless of age,
+body size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual identity
+and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness
+- Being respectful of differing opinions
+- Giving and accepting constructive feedback
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others’ private information without permission
+- Other conduct inappropriate in a professional setting
+
+## Enforcement
+
+Project maintainers are responsible for clarifying and enforcing standards.
+Instances of abusive behavior may be reported to the maintainers via GitHub.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1.
+
+[homepage]: https://www.contributor-covenant.org

data/CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing to HeapScope
+
+Thanks for helping build retention-first Ruby diagnostics.
+
+## Principles
+
+1. Prefer **retention evidence** over allocation volume alone.
+2. Separate **facts**, **derived metrics**, **hypotheses**, and **suspected causes**.
+3. Never fabricate reachability roots or confidence percentages.
+4. Keep the core dependency set minimal (stdlib + `fiddle`).
+5. Optional integrations must not become required gems.
+6. Degrade safely when a runtime capability is missing.
+7. Treat privacy as a feature: no telemetry, no value dumps by default.
+
+## Setup
+
+```bash
+bundle install
+bundle exec rake test
+bundle exec rubocop
+bundle exec ruby benchmark/run.rb
+bundle exec ruby benchmark/eval_harness.rb
+```
+
+## Project layout
+
+| Path | Purpose |
+|------|---------|
+| `lib/heapscope/` | Library |
+| `lib/heapscope/cli/` | Modular CLI |
+| `test/` | Minitest suite |
+| `examples/` | Demonstrations (+ README branding) |
+| `docs/` | Guides + diagnostic encyclopedia |
+| `assets/` | Logos / wordmark (canonical) |
+| `site/` | GitHub Pages marketing site |
+| `benchmark/` | Overhead + eval harness |
+
+## Pull requests
+
+- Conventional commits: `feat:`, `fix:`, `docs:`, `test:`, `chore:`, `refactor:`
+- Update `CHANGELOG.md` under `[Unreleased]`
+- Add `docs/changelogs/X.Y.Z.md` when cutting a release
+- Add/adjust diagnostic docs when introducing finding codes
+- Keep PRs focused
+
+## Branding
+
+Logo sources:
+
+- `assets/logo.svg` — app mark
+- `assets/wordmark.svg` — horizontal lockup
+- `assets/heapscope-logo.png` — raster
+
+Please don’t introduce purple-glow AI-slop aesthetics; HeapScope’s look is teal/slate, calm, technical.
+
+## Code of conduct
+
+See [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
+
+## Security
+
+See [`SECURITY.md`](SECURITY.md).
+
+## Release
+
+Semantic versioning. Standard Bundler flow:
+
+```bash
+# bump lib/heapscope/version.rb
+# update CHANGELOG.md + docs/changelogs/
+bundle exec rake release
+```

data/Gemfile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "minitest", "~> 5.20"
+  gem "rake", "~> 13.0"
+  gem "rubocop", "~> 1.60"
+end

data/LICENSE

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

data/README.md

@@ -0,0 +1,342 @@
+<p align="center">
+  <img src="assets/wordmark.svg" alt="HeapScope" width="520"/>
+</p>
+
+<p align="center">
+  <strong>Ruby object retention, heap growth, and memory leak diagnostics</strong><br/>
+  <em>Not just “how much memory” — <strong>why</strong> the process is keeping it.</em>
+</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/heapscope"><img alt="Gem version" src="https://img.shields.io/gem/v/heapscope?color=0f766e&style=for-the-badge"></a>
+  <a href="https://github.com/theworker02/heapscope/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/theworker02/heapscope/ci.yml?branch=main&style=for-the-badge&label=CI"></a>
+  <a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-334155?style=for-the-badge"></a>
+  <a href="#ruby-compatibility"><img alt="Ruby" src="https://img.shields.io/badge/ruby-%3E%3D%203.1-CC342D?style=for-the-badge&logo=ruby&logoColor=white"></a>
+  <a href="#privacy"><img alt="Privacy" src="https://img.shields.io/badge/privacy-local%20only-0f766e&style=for-the-badge"></a>
+  <a href="#no-saas"><img alt="No SaaS" src="https://img.shields.io/badge/SaaS-none-64748b&style=for-the-badge"></a>
+  <a href="https://thanks.dev/u/gh/theworker02"><img alt="thanks.dev" src="https://img.shields.io/badge/thanks.dev-theworker02-0f766e&style=for-the-badge"></a>
+  <a href="https://theworker02.github.io/heapscope/"><img alt="Docs" src="https://img.shields.io/badge/docs-Pages-0f766e?style=for-the-badge"></a>
+  <a href="CHANGELOG.md"><img alt="Changelog" src="https://img.shields.io/badge/changelog-0.6.0-0f766e&style=for-the-badge"></a>
+</p>
+
+<p align="center">
+  <a href="https://theworker02.github.io/heapscope/">Website</a> ·
+  <a href="docs/index.md">Docs hub</a> ·
+  <a href="#quick-start">Quick start</a> ·
+  <a href="docs/cli.md">CLI</a> ·
+  <a href="#privacy">Privacy</a> ·
+  <a href="https://thanks.dev/u/gh/theworker02">Sponsor</a> ·
+  <a href="CHANGELOG.md">Changelog</a>
+</p>
+
+---
+
+## What HeapScope is
+
+**HeapScope** is a local, evidence-driven Ruby gem for diagnosing **object retention**,
+**abnormal heap growth**, **allocation hot spots**, **long-lived objects**, and
+**leak-shaped patterns** in long-running processes.
+
+It is designed for Rails, Puma, Sidekiq, background jobs, CLIs, and CI — distinguishing
+allocation pressure from retention, and intentional caches from suspicious growth.
+
+> **No SaaS.** No uploads. No telemetry. Everything runs in-process on your machine.
+
+Release notes: [`docs/changelogs/0.6.0.md`](docs/changelogs/0.6.0.md)
+
+---
+
+## Why HeapScope
+
+Traditional tools often answer: *“How much memory is the process using?”*
+
+HeapScope answers: *“Why is this Ruby process retaining more memory than expected?”*
+
+Every finding separates **observed facts**, **derived behavior**, **hypothesis**, and
+**suspected cause** — and never claims `"Memory leak confirmed"` without strong evidence.
+
+---
+
+## Installation
+
+```ruby
+# Gemfile
+gem "heapscope", "~> 0.6"
+```
+
+```bash
+bundle add heapscope
+# or
+gem install heapscope
+```
+
+---
+
+## Ruby compatibility
+
+| Engine | Status |
+|--------|--------|
+| **MRI Ruby ≥ 3.1** | Primary target — full ObjectSpace / allocation tracing / memsize |
+| JRuby | Adapter present; capabilities degrade safely |
+| TruffleRuby | Adapter present; capabilities degrade safely |
+
+```ruby
+puts HeapScope.capabilities
+```
+
+---
+
+## Quick start
+
+```ruby
+require "heapscope"
+
+report = HeapScope.measure(force_gc: true) { perform_work }
+puts report
+report.save("report.json")
+report.save_html("report.html")
+
+# Ranked follow-ups
+puts HeapScope.next_steps(report)
+
+# CI gate
+budget = HeapScope.budget_preset(:ci_strict)
+HeapScope.check(budget: budget) { perform_work }
+```
+
+```bash
+heapscope doctor --fix          # write starter heapscope.yml
+heapscope snapshot --slim -o before.json
+heapscope diff before.json after.json --html report.html --fail-on-medium
+heapscope suggest report.json    # next steps + ignore hints
+heapscope watch --duration 120 -o watch.json
+heapscope about
+```
+
+Full CLI: [docs/cli.md](docs/cli.md)
+
+---
+
+## Product surface
+
+| Capability | How |
+|------------|-----|
+| Snapshots (lightweight / standard / deep / slim JSON) | `HeapScope.snapshot` / `heapscope snapshot` |
+| Diff & compare | `HeapScope.compare` / `heapscope diff` |
+| Block measure & multi-cycle retention | `measure` / `retention_test` |
+| Ranked findings + next steps | analyzer + `Suggest` |
+| Budget presets | `Budget.preset(:rails_request\|:sidekiq_job\|:ci_strict)` |
+| Sessions & scorecards | `HeapScope.session` / `probe` |
+| Watch / monitor with alerts | `heapscope watch` / `Monitor` |
+| Report packs | `HeapScope.pack` / `heapscope pack` |
+| Baselines & schema validation | `baseline` / `validate` |
+| Rails / Rack / Sidekiq / RSpec / Minitest | optional require paths |
+
+---
+
+## Concepts
+
+### Ruby heap vs RSS
+
+HeapScope records **both** Ruby heap populations and process RSS.
+**RSS growth ≠ Ruby object leak** — native extensions, allocators, mmap, and CoW matter.
+
+### Allocated vs retained
+
+```text
+100,000 allocated + 99,500 freed  → churn
+100,000 allocated + 20,000 live   → retention
+```
+
+### Forced GC
+
+Opt-in only (`force_gc: true`). Never enabled by surprise; refuse deep walks in `production_safe`.
+
+---
+
+## Budgets & CI
+
+```ruby
+HeapScope::Budget.preset(:rails_request)
+HeapScope::Budget.preset(:sidekiq_job)
+HeapScope::Budget.preset(:ci_strict)
+
+# or hand-tuned
+HeapScope::Budget.new(
+  max_retained_objects: 1_000,
+  max_rss_growth: 30 * 1024 * 1024,
+  severity_threshold: :high
+)
+```
+
+```bash
+heapscope baseline create report.json -o baseline.json
+heapscope compare baseline.json current.json --threshold 0.5
+```
+
+Guide: [docs/guides/ci-budgets.md](docs/guides/ci-budgets.md)
+
+---
+
+## Monitoring
+
+```ruby
+monitor = HeapScope::Monitor.start(interval: 10, mode: :lightweight, alert: true)
+# ...
+report = monitor.stop
+```
+
+```bash
+heapscope watch --interval 10 --duration 600 -o monitor.json
+```
+
+Alerts fire on RSS / live-slot spikes between samples (thresholds configurable).
+
+---
+
+## Diagnostics
+
+| Code | Name |
+|------|------|
+| HS001 | persistent_class_growth |
+| HS002 | high_retention_ratio |
+| HS003 | thread_local_retention |
+| HS004 | unbounded_collection |
+| HS005 | callback_accumulation |
+| HS006 | closure_retention |
+| HS007 | poor_gc_recovery |
+| HS008 | baseline_regression |
+| HS009 | high_allocation_pressure |
+| HS010 | native_memory_mismatch |
+
+```bash
+heapscope codes
+heapscope explain HS001
+```
+
+Encyclopedia: [`docs/diagnostics/`](docs/diagnostics/)
+
+---
+
+## Configuration
+
+```ruby
+HeapScope.configure do |config|
+  config.mode = :standard # lightweight | standard | deep | production_safe | development
+  config.track_allocations = false
+  config.ignore_patterns << /Zeitwerk/
+  config.inspect_values = false # privacy: off by default
+end
+```
+
+```bash
+heapscope doctor --fix --config-out heapscope.yml
+heapscope --config heapscope.yml doctor
+```
+
+Branding / funding URLs live in `HeapScope::Branding` (single source of truth).
+
+---
+
+## Reports
+
+Text, Markdown, versioned JSON, and static HTML — all offline. HTML uses the same brand mark as the site and README. Reports include **NEXT STEPS** when findings warrant follow-up.
+
+```ruby
+HeapScope.pack(report, "./pack")
+```
+
+---
+
+## Integrations
+
+```ruby
+require "heapscope/middleware"       # Rack sample_rate
+require "heapscope/rails"            # request_retention helpers
+require "heapscope/sidekiq_middleware"
+require "heapscope/minitest"
+require "heapscope/rspec"
+```
+
+Core gem requires **stdlib only** (plus `fiddle` when available for Windows RSS).
+
+---
+
+## Privacy
+
+<a id="privacy"></a>
+<a id="no-saas"></a>
+
+By default HeapScope:
+
+- makes **no network calls**
+- sends **no telemetry / analytics**
+- does **not** serialize object values
+- does **not** dump ENV, tokens, cookies, or request bodies
+
+See [`SECURITY.md`](SECURITY.md).
+
+---
+
+## Examples
+
+```bash
+bundle exec ruby examples/healthy_churn.rb
+bundle exec ruby examples/import_leak.rb
+bundle exec ruby examples/showcase.rb
+```
+
+See [`examples/README.md`](examples/README.md).
+
+---
+
+## Architecture
+
+```text
+lib/heapscope.rb                 Public API
+lib/heapscope/runtime/*          Engine adapters + RSS
+lib/heapscope/collector.rb       Snapshot capture
+lib/heapscope/diff.rb            Population diffs
+lib/heapscope/analyzer.rb        Findings & suspects
+lib/heapscope/findings.rb        Codes + ranking/dedupe
+lib/heapscope/suggest.rb         Next steps + ignore hints
+lib/heapscope/budget.rb          CI budgets + presets
+lib/heapscope/scorecard.rb       Probe + executive scorecard
+lib/heapscope/session.rb         Named artifact sessions
+lib/heapscope/report/*           Text / HTML / Markdown
+lib/heapscope/cli/               Modular CLI commands
+```
+
+---
+
+## Roadmap
+
+See [`docs/ROADMAP.md`](docs/ROADMAP.md). Current focus: deeper precision and optional CI marketplace packaging — not parallel product surfaces.
+
+---
+
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) and [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
+
+```bash
+bundle install
+bundle exec rake test
+bundle exec rubocop
+gem build heapscope.gemspec
+```
+
+---
+
+## License
+
+MIT © [@theworker02](https://github.com/theworker02) — see [`LICENSE`](LICENSE).
+
+Sponsor: [GitHub Sponsors](https://github.com/sponsors/theworker02) · [thanks.dev/u/gh/theworker02](https://thanks.dev/u/gh/theworker02)
+
+---
+
+<p align="center">
+  <img src="assets/logo.svg" alt="" width="72"/><br/>
+  <sub>When <code>top</code> says memory is growing but profiling won’t say why — reach for HeapScope.</sub>
+</p>