impact_score 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f51a2a44a58f5e947305b65a5a894f999086f42110493498fbc60faa35abe3b6
+  data.tar.gz: f3493e5b71269d76b1c0f8f8627bebfebfe6558fca7a144b2047b5beb822855a
+SHA512:
+  metadata.gz: 871dfb27c6d8f32e326a7f276a5c5b2ea2874bf47f0e4dd8be979b72efdefbee7cf0a9c43271201f64eb6d6b79f5995d6d25a7650057c3336e8086d8dd6a6c38
+  data.tar.gz: 1c71cdf5e8e811bf40265a245ae11c173fa3f2877a1fbf0d650b97f1e71d56263bb35c3e7ff717a604af0d055974d255c6e53cd78fa8a0e986c5cd6587a8018d

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Emma Hyde
+
+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,49 @@
+# impact-score-cli
+
+Compute engineering impact scores from a CSV and compare users, with tunable weights.
+
+- Default weights (multiples of 5): PRs 75%, Quality Reviews 5%, Cycle Time 15%, Reviews 5%
+- Commands: `calc` (single user) and `compare` (two users)
+
+## Install
+
+RubyGems (once published):
+
+```bash
+gem install impact_score
+```
+
+Homebrew (HEAD for latest):
+
+```bash
+brew tap emmahyde/tap
+brew install --HEAD emmahyde/tap/impact-score
+```
+
+## Usage
+
+Compare two users:
+
+```bash
+impact-score compare dx_report.csv user_one user_two
+```
+
+Single user:
+
+```bash
+impact-score calc dx_report.csv user_one
+```
+
+Custom weights:
+
+```bash
+impact-score compare dx_report.csv user_one user_two --weights 50,40,5,5
+```
+
+CSV must include columns: `github_username`, `prs_per_week`, `avg_cycle_time_days`, `quality_reviews_per_week`, `reviews_per_week`.
+
+## Releasing
+
+- Set repo secret `RUBYGEMS_API_KEY`
+- Tag a release: `git tag v0.1.0 && git push --tags`
+- GitHub Actions will build and push to RubyGems

data/bin/impact-score

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "impact_score/cli"
+ImpactScore::CLI.start

data/impact_score.gemspec

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name          = "impact_score"
+  spec.version       = File.read(File.join(__dir__, "lib", "impact_score", "version.rb")).match(/VERSION\s*=\s*"([^"]+)"/)[1]
+  spec.summary       = "Compute engineering impact scores from CSV with tunable weights"
+  spec.description   = "CLI and library for computing engineering impact scores and comparisons from CSV exports."
+  spec.homepage      = "https://github.com/emmahyde/impact-score-cli"
+  spec.license       = "MIT"
+
+  spec.author        = "Emma Hyde"
+  spec.email         = "emmajhyde@gmail.com"
+
+  spec.files         = Dir["lib/**/*", "bin/*", "README.md", "LICENSE", "impact_score.gemspec"]
+  spec.bindir        = "bin"
+  spec.executables   = ["impact-score"]
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 3.0"
+
+  spec.add_development_dependency "rake"
+end

data/lib/impact_score/calculator.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "csv"
+
+module ImpactScore
+  Weights = Struct.new(:prs, :quality, :cycle, :reviews)
+
+  class Calculator
+    DEFAULT_WEIGHTS = Weights.new(0.75, 0.05, 0.15, 0.05)
+
+    def initialize(csv_path, weights: DEFAULT_WEIGHTS)
+      @data = CSV.read(csv_path, headers: true)
+      @weights = weights
+      compute_medians!
+    end
+
+    def compare(user1, user2)
+      u1 = find_user(user1)
+      u2 = find_user(user2)
+      raise "User not found: #{user1}" unless u1
+      raise "User not found: #{user2}" unless u2
+
+      c1 = contributions(u1)
+      c2 = contributions(u2)
+      [c1.merge(total: sum(c1)), c2.merge(total: sum(c2))]
+    end
+
+    def calc(user)
+      u = find_user(user)
+      raise "User not found: #{user}" unless u
+      c = contributions(u)
+      c.merge(total: sum(c))
+    end
+
+    private
+
+    def find_user(username)
+      @data.find { |r| r["github_username"] == username }
+    end
+
+    def compute_medians!
+      active = @data.select { |r| r["prs_per_week"].to_f > 0 }
+      prs_values = active.map { |r| r["prs_per_week"].to_f }.sort
+      cycle_values = active.map { |r| r["avg_cycle_time_days"].to_f }.sort
+      @median_prs = median(prs_values)
+      @median_cycle = median(cycle_values)
+    end
+
+    def median(values)
+      return 0.0 if values.empty?
+      mid = values.length / 2
+      values.length.odd? ? values[mid].to_f : (values[mid - 1].to_f + values[mid].to_f) / 2.0
+    end
+
+    def contributions(row)
+      prs = row["prs_per_week"].to_f
+      qrv = row["quality_reviews_per_week"].to_f
+      cyc = row["avg_cycle_time_days"].to_f
+      rvw = row["reviews_per_week"].to_f
+
+      prs_pts = (prs - @median_prs) * @weights.prs
+      qual_pts = qrv * @weights.quality
+      cycle_pts = (@median_cycle - cyc) * @weights.cycle
+      reviews_pts = rvw * @weights.reviews
+
+      {
+        prs: round2(prs_pts),
+        quality: round2(qual_pts),
+        cycle: round2(cycle_pts),
+        reviews: round2(reviews_pts)
+      }
+    end
+
+    def sum(h)
+      round2(h[:prs] + h[:quality] + h[:cycle] + h[:reviews])
+    end
+
+    def round2(x) = (x.to_f * 100).round / 100.0
+  end
+end

data/lib/impact_score/cli.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require "optparse"
+require "impact_score"
+
+module ImpactScore
+  class CLI
+    def self.start
+      new.start
+    end
+
+    def start
+      if ARGV.empty? || %w[-h --help help].include?(ARGV[0])
+        return puts(help_text)
+      end
+
+      cmd = ARGV.shift
+      case cmd
+      when "compare"
+        csv, user1, user2, opts = parse_args(3)
+        calc = ImpactScore::Calculator.new(csv, weights: opts[:weights])
+        c1, c2 = calc.compare(user1, user2)
+        print_compare(user1, user2, c1, c2, opts[:weights])
+      when "calc"
+        csv, user, opts = parse_args(2)
+        calc = ImpactScore::Calculator.new(csv, weights: opts[:weights])
+        res = calc.calc(user)
+        print_single(user, res, opts[:weights])
+      else
+        abort "Unknown command: #{cmd}\n\n#{help_text}"
+      end
+    end
+
+    private
+
+    def parse_args(min)
+      opts = { weights: ImpactScore::Calculator::DEFAULT_WEIGHTS }
+      parser = OptionParser.new do |o|
+        o.on("--weights A,B,C,D", Array, "Weights as percentages (prs,quality,cycle,reviews)") do |arr|
+          raise "Need 4 weights" unless arr.size == 4
+          vals = arr.map { |x| x.to_f / 100.0 }
+          opts[:weights] = ImpactScore::Weights.new(*vals)
+        end
+      end
+
+      args = []
+      while args.size < min && ARGV.any?
+        args << ARGV.shift
+      end
+      parser.parse!(ARGV)
+      [*args, opts]
+    end
+
+    def print_compare(u1, u2, c1, c2, w)
+      puts "Weights: PRs #{(w.prs*100).to_i}%, Quality #{(w.quality*100).to_i}%, Cycle #{(w.cycle*100).to_i}%, Reviews #{(w.reviews*100).to_i}%"
+      puts "%-25s %15s %15s %12s" % ["Component", u1, u2, "Δ"]
+      puts "-" * 70
+      %i[prs quality cycle reviews total].each do |k|
+        v1 = c1[k]
+        v2 = c2[k]
+        puts "%-25s %15.2f %15.2f %12.2f" % [k.to_s.capitalize, v1, v2, v1 - v2]
+      end
+    end
+
+    def print_single(u, c, w)
+      puts "Weights: PRs #{(w.prs*100).to_i}%, Quality #{(w.quality*100).to_i}%, Cycle #{(w.cycle*100).to_i}%, Reviews #{(w.reviews*100).to_i}%"
+      puts "%-25s %15s" % ["Component", u]
+      puts "-" * 45
+      %i[prs quality cycle reviews total].each do |k|
+        v = c[k]
+        puts "%-25s %15.2f" % [k.to_s.capitalize, v]
+      end
+    end
+
+    def help_text
+      <<~TXT
+      impact-score – compute and compare impact scores from CSV
+
+      Commands:
+        impact-score compare CSV USER1 USER2 [--weights 75,5,15,5]
+        impact-score calc CSV USER [--weights 75,5,15,5]
+
+      CSV must contain columns: github_username, prs_per_week, avg_cycle_time_days, quality_reviews_per_week, reviews_per_week.
+      TXT
+    end
+  end
+end

data/lib/impact_score/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ImpactScore
+  VERSION = "0.1.0"
+end

data/lib/impact_score.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "impact_score/version"
+require "impact_score/calculator"

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: impact_score
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Emma Hyde
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-10-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: CLI and library for computing engineering impact scores and comparisons
+  from CSV exports.
+email: emmajhyde@gmail.com
+executables:
+- impact-score
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/impact-score
+- impact_score.gemspec
+- lib/impact_score.rb
+- lib/impact_score/calculator.rb
+- lib/impact_score/cli.rb
+- lib/impact_score/version.rb
+homepage: https://github.com/emmahyde/impact-score-cli
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Compute engineering impact scores from CSV with tunable weights
+test_files: []