schema_reaper 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c7a7ccaeefa1c6ddc5597a3b54ebb358fdac16ba72e8413b79cc70ecdf9223e
-  data.tar.gz: e6a801a21a746da04c63416669c0cf35e55975b8af85b631502847bdba769189
+  metadata.gz: f26fed85dd152f6d3f64a45e34d2741f9ec065000267b02ff0f1f0dec05de4e0
+  data.tar.gz: 6d11813b5fa9d27468479b60ffd20e86109cfc3d620c9ee0394f96525c2d0e43
 SHA512:
-  metadata.gz: fd33e938eddd3fd6ffb0e50dca359a62ac6974573838605f627a999bed26114d7501f92ae9edb769053ba65b8ee2d5a6f1d5f7b01f84b39f8abb8707ca6113ce
-  data.tar.gz: aceba9a2f2fdcb55d8b780b5d1e85a7431c9a587f3592e019c3434e7e0e7343d60d10ee8f7063f4b888027f4bdf3c59e7caa09f04b82c1803e3d96afcef239a3
+  metadata.gz: 9a743c7b541a5c82a80eef34b623faa83f22636bd5195cb7278921fe6772baefc75c6ce9cb87643f6ac1ebdd47d400706b9c17dd03004be5d5fbd267355170ca
+  data.tar.gz: db87b48312c071ef3013e0a550cabe43196d68536d0dc4249f67cac5455c03360b8609c827a2785efccb55722a7c6912298bc347902e16bd10eda6b3b69107ca

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 3.1
+  TargetRubyVersion: 2.7
   NewCops: enable
   SuggestExtensions: false
 

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [1.0.2] - 2026-09-04
+
+### Changed
+- Lowered `required_ruby_version` to `>= 2.7.0` (was `>= 3.1.0`).
+  - Rewrote all 40 endless method definitions (`def x = ...`, a Ruby 3.0
+    feature) as classic `def ... end`.
+  - Added explicit `require "set"` where `Set` / `to_set` are used (autoloaded
+    only on Ruby 3.2+).
+  - `rubocop` `TargetRubyVersion` set to 2.7; CI matrix now 2.7–3.3.
+  - Every `lib/`, `spec/` and `exe/` file verified to parse under Ruby 2.7.0;
+    dependency-free modules exercised on a real 2.7 runtime. Runtime deps
+    (`prism` >= 2.7, `thor` >= 2.6, `pg`) all support 2.7.
+- No behaviour change; 29 specs unchanged.
+
+## [1.0.1] - 2026-09-04
+
+Superseded by 1.0.2 before release. Lowered the floor to `>= 3.0.0` only.
+
 ## [1.0.0] - 2026-09-04
 
 First stable release.

data/PRO.md

@@ -0,0 +1,98 @@
+# schema_reaper Pro — open-core plan
+
+The `schema_reaper` gem stays **MIT, free, and complete for its job**: schema
+introspection, the seven analyzers, static + runtime signal, staged migrations,
+`table`/`json`/`markdown`/`sarif` output, the CI baseline gate. Everything a
+solo developer or single app needs.
+
+**Pro** is a separate paid layer for *teams and multi-database estates* — the
+work that only pays off at scale and that individuals rarely need.
+
+---
+
+## Free vs Pro
+
+| Capability | Free (`schema_reaper`) | Pro (`schema_reaper-pro`) |
+|---|---|---|
+| PostgreSQL adapter | ✅ | ✅ |
+| MySQL / MariaDB adapter | — | ✅ |
+| 7 core analyzers | ✅ | ✅ |
+| Orphan-row + schema-drift analyzers | — | ✅ |
+| Runtime attribute tracker | ✅ (file sink) | ✅ + Redis / StatsD / OTLP sinks |
+| Reporters | table / json / markdown / sarif | + HTML, Slack, Jira, PR review comments |
+| Reclaimable estimate | bytes/row × est. rows | real `pg_total_relation_size`, index bloat, $ per cloud plan |
+| History / trend | local JSONL + `trend` | hosted timeline, burndown charts, per-team dashboards |
+| Baseline gate | one file | per-branch baselines, ownership routing (CODEOWNERS) |
+| Multi-database / shards | one DB per run | fan-out across N databases, divergence report |
+| Scheduled scans + alerts | — | ✅ (cron runner, "queue breached", "new dead column in `billing`") |
+| Mountable dashboard engine | — | ✅ `mount SchemaReaper::Pro::Engine` |
+| SSO, audit log, RBAC | — | ✅ (Enterprise) |
+| Support | GitHub issues, best effort | private issues, SLA |
+
+Pro depends on the OSS gem and reuses its analyzer registry — no fork, no
+divergence. New analyzers land in Free first unless they are inherently
+team-scale.
+
+---
+
+## Delivery & licensing
+
+- **Distribution**: private gem on a Gemfury / GitHub Packages source, installed
+  with a license-key-scoped token.
+
+  ```ruby
+  source "https://pro.schema-reaper.dev" do
+    gem "schema_reaper-pro"
+  end
+  ```
+
+- **License check**: offline-friendly signed key (Ed25519), 30-day grace if the
+  license server is unreachable. No phone-home of schema content — ever.
+- **License**: commercial EULA, per-organization. Source-available to
+  subscribers (read + patch), not redistributable.
+- **Trial**: 21-day full-feature key, no card.
+
+---
+
+## Pricing (draft)
+
+| Tier | Who | Price | Limits |
+|---|---|---|---|
+| **Solo Pro** | 1 dev, unlimited personal/side projects | $9 / mo ($90 / yr) | 3 databases |
+| **Team** | up to 10 devs | $49 / mo ($490 / yr) | 15 databases, Slack/Jira, scheduled scans |
+| **Business** | up to 50 devs | $199 / mo | unlimited databases, dashboard engine, priority support |
+| **Enterprise** | 50+ / regulated | custom (from ~$12k / yr) | SSO, audit log, RBAC, on-prem license server, SLA |
+
+Free forever for: OSS projects, students, and any single non-commercial
+database. Charity/edu 50% off.
+
+---
+
+## Hosted option (later — biggest ceiling)
+
+`schema-reaper.dev` SaaS: point it at a read-replica, get weekly reports, trend
+dashboards, PR comments, and alerts with zero gem install. Same tiers, +$X for
+the managed runner. Ship the self-hosted Pro gem first; the SaaS is Pro + a
+scheduler + a web app.
+
+---
+
+## Rollout order
+
+1. **Now**: Sponsor button, `PRO.md`, "Pro" section in README (waitlist link).
+2. **v1.1 (OSS)**: MySQL adapter groundwork, real size math — proves demand,
+   some lands free.
+3. **Pro 0.1**: private gem = MySQL + Slack reporter + scheduled scans + license
+   key. Sell to the first 10 teams at half price for feedback.
+4. **Pro 0.2**: dashboard engine, multi-DB fan-out, per-branch baselines.
+5. **SaaS beta**: once ~25 paying teams self-host.
+
+---
+
+## Principles
+
+- Free tier never gets *worse* to sell Pro. No crippling, no nag screens.
+- Anything a single app genuinely needs stays free.
+- Never transmit schema, data, or query text without explicit opt-in.
+- Pro features are the ones a 2-person team can't be bothered to build and a
+  50-person org will happily expense.

data/README.md

@@ -124,6 +124,21 @@ require:
 - Mountable dashboard engine, trend charts
 - MySQL adapter
 
+## Pro (for teams)
+
+The gem is free and complete for a single app. **schema_reaper Pro** adds the
+team-scale layer: MySQL adapter, multi-database fan-out, orphan-row and
+schema-drift analyzers, Slack/Jira/PR-comment reporters, real
+`pg_total_relation_size` + $ estimates, scheduled scans with alerts, and a
+mountable dashboard engine. See [PRO.md](PRO.md). Waitlist / early access:
+open an issue tagged `pro`.
+
+## Sponsor
+
+`schema_reaper` is MIT and maintained in the open. If it saved you disk, money,
+or a nasty migration, sponsor its development via the **Sponsor** button on the
+repo.
+
 ## Development
 
 ```

data/lib/schema_reaper/analyzers/base.rb

@@ -9,8 +9,13 @@ module SchemaReaper
     #   gem_columns  - Hash{table_name => Set<column_name>} reserved by gems
     #   config       - Config
     Context = Struct.new(:schema, :used_tokens, :runtime, :gem_columns, :config, keyword_init: true) do
-      def runtime = self[:runtime] || Runtime::Report.empty
-      def gem_columns = self[:gem_columns] || {}
+      def runtime
+        self[:runtime] || Runtime::Report.empty
+      end
+
+      def gem_columns
+        self[:gem_columns] || {}
+      end
     end
 
     # Shared plumbing for analyzers: schema access and token lookup helpers.
@@ -24,16 +29,29 @@ module SchemaReaper
       end
 
       # @return [Array<Finding>]
-      def call = raise NotImplementedError
+      def call
+        raise(NotImplementedError)
+      end
 
       private
 
       attr_reader :ctx
 
-      def schema = ctx.schema
-      def config = ctx.config
-      def runtime = ctx.runtime
-      def used?(token) = ctx.used_tokens.include?(token.to_s.downcase)
+      def schema
+        ctx.schema
+      end
+
+      def config
+        ctx.config
+      end
+
+      def runtime
+        ctx.runtime
+      end
+
+      def used?(token)
+        ctx.used_tokens.include?(token.to_s.downcase)
+      end
 
       def gem_reserved?(table, column)
         ctx.gem_columns.fetch(table, []).include?(column)

data/lib/schema_reaper/analyzers/dead_table.rb

@@ -54,7 +54,9 @@ module SchemaReaper
         ev
       end
 
-      def camelize(str) = str.split("_").map(&:capitalize).join
+      def camelize(str)
+        str.split("_").map(&:capitalize).join
+      end
     end
   end
 end

data/lib/schema_reaper/analyzers/registry.rb

@@ -13,7 +13,9 @@ module SchemaReaper
           @classes << klass unless @classes.include?(klass)
         end
 
-        def all = @classes
+        def all
+          @classes
+        end
       end
     end
   end

data/lib/schema_reaper/cli.rb

@@ -6,7 +6,9 @@ require_relative "../schema_reaper"
 module SchemaReaper
   # Command-line entry point. See `exe/schema_reaper`.
   class CLI < Thor
-    def self.exit_on_failure? = true
+    def self.exit_on_failure?
+      true
+    end
 
     class_option :config, type: :string, default: ".schema_reaper.yml",
                           desc: "path to config file"
@@ -48,13 +50,19 @@ module SchemaReaper
     end
 
     desc "version", "Print version"
-    def version = say(SchemaReaper::VERSION)
+    def version
+      say(SchemaReaper::VERSION)
+    end
 
     private
 
-    def config = @config ||= Config.load(options[:config])
+    def config
+      @config ||= Config.load(options[:config])
+    end
 
-    def run = Runner.new(config: config).run
+    def run
+      Runner.new(config: config).run
+    end
 
     def enforce_baseline(findings)
       new_ones = Baseline.new(config.baseline_path).new_among(findings)

data/lib/schema_reaper/config.rb

@@ -44,15 +44,41 @@ module SchemaReaper
       @data["database_url"] || ENV.fetch("DATABASE_URL", nil)
     end
 
-    def scan_paths      = @data["scan_paths"]
-    def view_globs      = @data["view_globs"]
-    def ignore_tables   = @data.dig("ignore", "tables").to_a
-    def min_age_days    = @data["min_age_days"]
-    def baseline_path   = @data["baseline"]
-    def runtime_log     = @data["runtime_log"]
-    def history_log     = @data["history_log"]
-    def gem_awareness?  = @data["gem_awareness"] != false
-    def require_paths   = @data["require"].to_a
+    def scan_paths
+      @data["scan_paths"]
+    end
+
+    def view_globs
+      @data["view_globs"]
+    end
+
+    def ignore_tables
+      @data.dig("ignore", "tables").to_a
+    end
+
+    def min_age_days
+      @data["min_age_days"]
+    end
+
+    def baseline_path
+      @data["baseline"]
+    end
+
+    def runtime_log
+      @data["runtime_log"]
+    end
+
+    def history_log
+      @data["history_log"]
+    end
+
+    def gem_awareness?
+      @data["gem_awareness"] != false
+    end
+
+    def require_paths
+      @data["require"].to_a
+    end
 
     def always_keep_columns
       @data["always_keep_columns"].to_a

data/lib/schema_reaper/finding.rb

@@ -19,7 +19,9 @@ module SchemaReaper
       [type, table, column, index].compact.join("/")
     end
 
-    def reclaimable_bytes = self[:reclaimable_bytes] || 0
+    def reclaimable_bytes
+      self[:reclaimable_bytes] || 0
+    end
 
     def to_h
       super.merge(id: id, reclaimable_bytes: reclaimable_bytes)

data/lib/schema_reaper/gem_awareness.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "set"
+
 module SchemaReaper
   # Columns and tables that popular gems own and reference indirectly (through
   # metaprogramming the static scanner cannot see). Detected gems get their

data/lib/schema_reaper/migration_generator.rb

@@ -61,7 +61,12 @@ module SchemaReaper
       path
     end
 
-    def camel = "#{@table}_#{@column}".split("_").map(&:capitalize).join
-    def model = @table.split("_").map(&:capitalize).join.sub(/s$/, "")
+    def camel
+      "#{@table}_#{@column}".split("_").map(&:capitalize).join
+    end
+
+    def model
+      @table.split("_").map(&:capitalize).join.sub(/s$/, "")
+    end
   end
 end

data/lib/schema_reaper/reporters/markdown.rb

@@ -35,7 +35,9 @@ module SchemaReaper
         end
       end
 
-      def total = @findings.sum(&:reclaimable_bytes)
+      def total
+        @findings.sum(&:reclaimable_bytes)
+      end
     end
   end
 end

data/lib/schema_reaper/reporters/sarif.rb

@@ -61,7 +61,9 @@ module SchemaReaper
         end
       end
 
-      def camelize(str) = str.split("_").map(&:capitalize).join
+      def camelize(str)
+        str.split("_").map(&:capitalize).join
+      end
     end
   end
 end

data/lib/schema_reaper/reporters/table.rb

@@ -39,7 +39,9 @@ module SchemaReaper
         @findings.sort_by { |f| [-f.confidence, SEV_ORDER.fetch(f.severity, 9)] }
       end
 
-      def total_reclaimable = @findings.sum(&:reclaimable_bytes)
+      def total_reclaimable
+        @findings.sum(&:reclaimable_bytes)
+      end
     end
   end
 end

data/lib/schema_reaper/runner.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "set"
+
 module SchemaReaper
   # Ties introspection + scanning + runtime data + analyzers together.
   class Runner

data/lib/schema_reaper/runtime.rb

@@ -11,7 +11,9 @@ module SchemaReaper
   module Runtime
     # Aggregated view of a usage log, consumed by analyzers.
     Report = Struct.new(:accessed, :observed_days, keyword_init: true) do
-      def self.empty = new(accessed: Set.new, observed_days: 0)
+      def self.empty
+        new(accessed: Set.new, observed_days: 0)
+      end
 
       def self.load(path)
         return empty unless path && File.exist?(path)
@@ -36,9 +38,17 @@ module SchemaReaper
         ((Time.parse(last) - Time.parse(first)) / 86_400).ceil
       end
 
-      def empty? = accessed.empty?
-      def present? = !empty?
-      def read?(table, column) = accessed.include?("#{table}.#{column}")
+      def empty?
+        accessed.empty?
+      end
+
+      def present?
+        !empty?
+      end
+
+      def read?(table, column)
+        accessed.include?("#{table}.#{column}")
+      end
     end
 
     # Buffered writer for the usage log. Thread-safe append of JSON lines.

data/lib/schema_reaper/schema.rb

@@ -9,26 +9,42 @@ module SchemaReaper
     keyword_init: true
   ) do
     # true when every row holds NULL (pg_stats null_frac == 1)
-    def always_null? = null_fraction && null_fraction >= 1.0
+    def always_null?
+      null_fraction && null_fraction >= 1.0
+    end
 
     # true when the column holds exactly one distinct non-null value
-    def single_value? = distinct_values == 1
+    def single_value?
+      distinct_values == 1
+    end
   end
 
   Index = Struct.new(:name, :columns, :unique, :primary, :scans, keyword_init: true) do
-    def covers?(other) = columns.first(other.columns.length) == other.columns
+    def covers?(other)
+      columns.first(other.columns.length) == other.columns
+    end
   end
 
   Table = Struct.new(
     :name, :columns, :indexes, :primary_key, :foreign_keys, :row_count,
     keyword_init: true
   ) do
-    def column_names = columns.map(&:name)
-    def column(name) = columns.find { |c| c.name == name }
-    def index_on(cols) = indexes.find { |i| i.columns == Array(cols) }
+    def column_names
+      columns.map(&:name)
+    end
+
+    def column(name)
+      columns.find { |c| c.name == name }
+    end
+
+    def index_on(cols)
+      indexes.find { |i| i.columns == Array(cols) }
+    end
   end
 
   DatabaseSchema = Struct.new(:tables, keyword_init: true) do
-    def table(name) = tables.find { |t| t.name == name }
+    def table(name)
+      tables.find { |t| t.name == name }
+    end
   end
 end

data/lib/schema_reaper/static/scanner.rb

@@ -10,7 +10,7 @@ module SchemaReaper
     # safe, a false "dead" is not.
     class Scanner
       RUBY_GLOB  = "**/*.rb"
-      WORD_RE    = /[a-z_][a-z0-9_]*/i
+      WORD_RE    = /[a-z_][a-z0-9_]*/i.freeze
 
       # Node classes whose #name (or #unescaped) is a bare identifier we treat
       # as a possible column/table reference.

data/lib/schema_reaper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SchemaReaper
-  VERSION = "1.0.0"
+  VERSION = "1.0.2"
 end

data/lib/schema_reaper.rb

@@ -40,5 +40,7 @@ module SchemaReaper
     "sarif" => Reporters::Sarif
   }.freeze
 
-  def self.reporter(name) = REPORTERS.fetch(name, Reporters::Table)
+  def self.reporter(name)
+    REPORTERS.fetch(name, Reporters::Table)
+  end
 end

data/schema_reaper.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
   DESC
   spec.homepage = "https://github.com/aksshatt/schema_reaper"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1.0"
+  spec.required_ruby_version = ">= 2.7.0"
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
   spec.metadata["homepage_uri"] = spec.homepage

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schema_reaper
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - aksshatt
@@ -100,6 +100,7 @@ files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
+- PRO.md
 - README.md
 - Rakefile
 - exe/schema_reaper
@@ -152,7 +153,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="