git-pkgs 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ab0df1352b215987b6611a997fc62aa1e2a3ea05abe597c134812f9ec17d9d7
-  data.tar.gz: 5e929d2ebe9f2538d8d6b29ffc6ac89c7164f2d82afc898954159ae1a4a09ca9
+  metadata.gz: 7ff2285e54475944f6c8a9cb98ae9f5efcb78ee0aa74dbea6d46553bbf71caa2
+  data.tar.gz: 81aee90f3e0b9f573e1f9e442dc4c487f07957c320d70ca24a809929248279a3
 SHA512:
-  metadata.gz: 8e8eb54a1557bd2fa965fae8dfc2d2cceca578bec650a95821abef16f19ba2d6d6ab7c88a092cddca87de0b111fa9dd526a76439555144a8638f8507201b552e
-  data.tar.gz: 288792ce23dc723dcf61d37606cbe26cd89f33052687156d5ae032885c8e963647d972c7b772d4712da03aab024be61eb313992a213bff88d7c02c826937c5a9
+  metadata.gz: ffdcb5fe7cc217b105f10018ba24101131120fdfcc8305f3142fcc11f29e7f77114e95c0a2abbe661fcac3a74e4ea0662031dc6a997020225bdabcc9b6ab754b
+  data.tar.gz: 204dc587c61ccb128957910784ccab0cb84c667627dff1fb81d18a6b6779abc34cfff3a838f06146c954d1a50b9ac095a036a67c898d12699c530476b9b3d31c

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-01-02
+
+- `git pkgs show` command to display dependency changes in a single commit
+- `git pkgs history` now supports `--author`, `--since`, and `--until` filters
+- `git pkgs stats --by-author` shows who added the most dependencies
+- `git pkgs stats --ecosystem=X` filters statistics by ecosystem
+
 ## [0.1.1] - 2026-01-01
 
 - `git pkgs history` now works without a package argument to show all dependency changes

data/README.md

@@ -4,11 +4,9 @@ A git subcommand for tracking package dependencies across git history. Analyzes
 
 ## Why this exists
 
-Your lockfile shows what dependencies you have. It doesn't show how you got here. `git log Gemfile.lock` is useless noise.
+Your lockfile shows what dependencies you have, but it doesn't show how you got here, and `git log Gemfile.lock` is useless noise. git-pkgs indexes your dependency history into a queryable database so you can ask questions like: when did we add this? who added it? what changed between these two releases? has anyone touched this in the last year?
 
-git-pkgs indexes your dependency history into a queryable database. You can ask: when did we add this? who added it? what changed between these two releases? has anyone touched this in the last year?
-
-It works across ecosystems. Gemfile, package.json, Dockerfile, GitHub Actions workflows - one unified history instead of separate tools per ecosystem.
+It works across many ecosystems (Gemfile, package.json, Dockerfile, GitHub Actions workflows) giving you one unified history instead of separate tools per ecosystem. Everything runs locally and offline with no external services or network calls, and the database lives in your `.git` directory where you can use it in CI to catch dependency changes in pull requests.
 
 ## Installation
 
@@ -113,8 +111,11 @@ Gemfile (rubygems):
 ### View dependency history
 
 ```bash
-git pkgs history          # all dependency changes
-git pkgs history rails    # changes for a specific package
+git pkgs history                       # all dependency changes
+git pkgs history rails                 # changes for a specific package
+git pkgs history --author=alice        # filter by author
+git pkgs history --since=2024-01-01    # changes after date
+git pkgs history --ecosystem=rubygems  # filter by ecosystem
 ```
 
 Shows when packages were added, updated, or removed:
@@ -166,6 +167,8 @@ Gemfile (rubygems):
 
 ```bash
 git pkgs stats
+git pkgs stats --by-author       # who added the most dependencies
+git pkgs stats --ecosystem=npm   # filter by ecosystem
 ```
 
 Example output:
@@ -211,7 +214,7 @@ Manifest Files
 git pkgs why rails
 ```
 
-Shows the commit that added the dependency with author and message.
+This shows the commit that added the dependency along with the author and message.
 
 ### Dependency tree
 
@@ -220,7 +223,7 @@ git pkgs tree
 git pkgs tree --ecosystem=rubygems
 ```
 
-Shows dependencies grouped by type (runtime, development, etc).
+This shows dependencies grouped by type (runtime, development, etc).
 
 ### Diff between commits
 
@@ -229,20 +232,57 @@ git pkgs diff --from=abc123 --to=def456
 git pkgs diff --from=HEAD~10
 ```
 
-Shows added, removed, and modified packages with version info.
+This shows added, removed, and modified packages with version info.
+
+### Show changes in a commit
+
+```bash
+git pkgs show              # show dependency changes in HEAD
+git pkgs show abc123       # specific commit
+git pkgs show HEAD~5       # relative ref
+```
+
+Like `git show` but for dependencies. Shows what was added, modified, or removed in a single commit.
 
 ### Keep database updated
 
+After the initial analysis, you can incrementally update the database with new commits:
+
 ```bash
 git pkgs update
 ```
 
-Or install git hooks to update automatically after commits and merges:
+You can also install git hooks to update automatically after commits and merges:
 
 ```bash
 git pkgs hooks --install
 ```
 
+### CI usage
+
+You can run git-pkgs in CI to show dependency changes in pull requests:
+
+```yaml
+# .github/workflows/deps.yml
+name: Dependencies
+
+on: pull_request
+
+jobs:
+  diff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+      - run: gem install git-pkgs
+      - run: git pkgs init
+      - run: git pkgs diff --from=origin/${{ github.base_ref }} --to=HEAD
+```
+
 ## Performance
 
 Benchmarked on a MacBook Pro analyzing [octobox](https://github.com/octobox/octobox) (5191 commits, 8 years of history): init takes about 18 seconds at roughly 300 commits/sec, producing an 8.3 MB database. About half the commits (2531) had dependency changes.
@@ -271,6 +311,21 @@ The database schema stores:
 
 See [docs/schema.md](docs/schema.md) for full schema documentation.
 
+Since the database is just SQLite, you can query it directly for ad-hoc analysis:
+
+```bash
+sqlite3 .git/pkgs.sqlite3 "
+  -- who added the most dependencies?
+  SELECT c.author_name, COUNT(*) as deps_added
+  FROM dependency_changes dc
+  JOIN commits c ON dc.commit_id = c.id
+  WHERE dc.change_type = 'added'
+  GROUP BY c.author_name
+  ORDER BY deps_added DESC
+  LIMIT 10;
+"
+```
+
 ## Development
 
 ```bash

data/lib/git/pkgs/cli.rb

@@ -5,7 +5,7 @@ require "optparse"
 module Git
   module Pkgs
     class CLI
-      COMMANDS = %w[init update hooks info list tree history search why blame outdated stats diff branch].freeze
+      COMMANDS = %w[init update hooks info list tree history search why blame outdated stats diff branch show].freeze
 
       def self.run(args)
         new(args).run
@@ -60,6 +60,7 @@ module Git
             outdated  Show dependencies that haven't been updated
             stats     Show dependency statistics
             diff      Show dependency changes between commits
+            show      Show dependency changes in a commit
 
           Options:
             -h, --help     Show this help message

data/lib/git/pkgs/commands/history.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "time"
+
 module Git
   module Pkgs
     module Commands
@@ -31,6 +33,24 @@ module Git
             changes = changes.for_platform(@options[:ecosystem])
           end
 
+          if @options[:author]
+            author = @options[:author]
+            changes = changes.joins(:commit).where(
+              "commits.author_name LIKE ? OR commits.author_email LIKE ?",
+              "%#{author}%", "%#{author}%"
+            )
+          end
+
+          if @options[:since]
+            since_time = parse_time(@options[:since])
+            changes = changes.joins(:commit).where("commits.committed_at >= ?", since_time)
+          end
+
+          if @options[:until]
+            until_time = parse_time(@options[:until])
+            changes = changes.joins(:commit).where("commits.committed_at <= ?", until_time)
+          end
+
           if changes.empty?
             if package_name
               puts "No history found for '#{package_name}'"
@@ -118,6 +138,18 @@ module Git
               options[:format] = v
             end
 
+            opts.on("--author=NAME", "Filter by author name or email") do |v|
+              options[:author] = v
+            end
+
+            opts.on("--since=DATE", "Show changes after date (YYYY-MM-DD)") do |v|
+              options[:since] = v
+            end
+
+            opts.on("--until=DATE", "Show changes before date (YYYY-MM-DD)") do |v|
+              options[:until] = v
+            end
+
             opts.on("-h", "--help", "Show this help") do
               puts opts
               exit
@@ -127,6 +159,13 @@ module Git
           parser.parse!(@args)
           options
         end
+
+        def parse_time(str)
+          Time.parse(str)
+        rescue ArgumentError
+          $stderr.puts "Invalid date format: #{str}"
+          exit 1
+        end
       end
     end
   end

data/lib/git/pkgs/commands/show.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+module Git
+  module Pkgs
+    module Commands
+      class Show
+        def initialize(args)
+          @args = args
+          @options = parse_options
+        end
+
+        def run
+          ref = @args.shift || "HEAD"
+
+          repo = Repository.new
+
+          unless Database.exists?(repo.git_dir)
+            $stderr.puts "Database not initialized. Run 'git pkgs init' first."
+            exit 1
+          end
+
+          Database.connect(repo.git_dir)
+
+          sha = repo.rev_parse(ref)
+
+          unless sha
+            $stderr.puts "Could not resolve '#{ref}'"
+            exit 1
+          end
+
+          commit = find_or_create_commit(repo, sha)
+
+          unless commit
+            $stderr.puts "Commit '#{sha[0..7]}' not found"
+            exit 1
+          end
+
+          changes = Models::DependencyChange
+            .includes(:commit, :manifest)
+            .where(commit_id: commit.id)
+
+          if @options[:ecosystem]
+            changes = changes.where(ecosystem: @options[:ecosystem])
+          end
+
+          if changes.empty?
+            puts "No dependency changes in #{commit.short_sha}"
+            return
+          end
+
+          if @options[:format] == "json"
+            output_json(commit, changes)
+          else
+            output_text(commit, changes)
+          end
+        end
+
+        def output_text(commit, changes)
+          puts "Commit: #{commit.short_sha} #{commit.message&.lines&.first&.strip}"
+          puts "Author: #{commit.author_name} <#{commit.author_email}>"
+          puts "Date:   #{commit.committed_at.strftime("%Y-%m-%d")}"
+          puts
+
+          added = changes.select { |c| c.change_type == "added" }
+          modified = changes.select { |c| c.change_type == "modified" }
+          removed = changes.select { |c| c.change_type == "removed" }
+
+          if added.any?
+            puts "Added:"
+            added.each do |change|
+              puts "  #{change.name} #{change.requirement} (#{change.ecosystem}, #{change.manifest.path})"
+            end
+            puts
+          end
+
+          if modified.any?
+            puts "Modified:"
+            modified.each do |change|
+              puts "  #{change.name} #{change.previous_requirement} -> #{change.requirement} (#{change.ecosystem}, #{change.manifest.path})"
+            end
+            puts
+          end
+
+          if removed.any?
+            puts "Removed:"
+            removed.each do |change|
+              puts "  #{change.name} #{change.requirement} (#{change.ecosystem}, #{change.manifest.path})"
+            end
+            puts
+          end
+        end
+
+        def output_json(commit, changes)
+          require "json"
+
+          data = {
+            commit: {
+              sha: commit.sha,
+              short_sha: commit.short_sha,
+              message: commit.message&.lines&.first&.strip,
+              author_name: commit.author_name,
+              author_email: commit.author_email,
+              date: commit.committed_at.iso8601
+            },
+            changes: changes.map do |change|
+              {
+                name: change.name,
+                change_type: change.change_type,
+                requirement: change.requirement,
+                previous_requirement: change.previous_requirement,
+                ecosystem: change.ecosystem,
+                manifest: change.manifest.path
+              }
+            end
+          }
+
+          puts JSON.pretty_generate(data)
+        end
+
+        def find_or_create_commit(repo, sha)
+          commit = Models::Commit.find_by(sha: sha) ||
+                   Models::Commit.where("sha LIKE ?", "#{sha}%").first
+          return commit if commit
+
+          rugged_commit = repo.lookup(sha)
+          return nil unless rugged_commit
+
+          Models::Commit.create!(
+            sha: rugged_commit.oid,
+            message: rugged_commit.message,
+            author_name: rugged_commit.author[:name],
+            author_email: rugged_commit.author[:email],
+            committed_at: rugged_commit.time,
+            has_dependency_changes: false
+          )
+        rescue Rugged::OdbError
+          nil
+        end
+
+        def parse_options
+          options = {}
+
+          parser = OptionParser.new do |opts|
+            opts.banner = "Usage: git pkgs show [commit] [options]"
+
+            opts.on("-e", "--ecosystem=NAME", "Filter by ecosystem") do |v|
+              options[:ecosystem] = v
+            end
+
+            opts.on("-f", "--format=FORMAT", "Output format (text, json)") do |v|
+              options[:format] = v
+            end
+
+            opts.on("-h", "--help", "Show this help") do
+              puts opts
+              exit
+            end
+          end
+
+          parser.parse!(@args)
+          options
+        end
+      end
+    end
+  end
+end

data/lib/git/pkgs/commands/stats.rb

@@ -22,19 +22,26 @@ module Git
           branch_name = @options[:branch] || repo.default_branch
           branch = Models::Branch.find_by(name: branch_name)
 
-          data = collect_stats(branch, branch_name)
-
-          if @options[:format] == "json"
-            require "json"
-            puts JSON.pretty_generate(data)
+          if @options[:by_author]
+            output_by_author
           else
-            output_text(data)
+            data = collect_stats(branch, branch_name)
+
+            if @options[:format] == "json"
+              require "json"
+              puts JSON.pretty_generate(data)
+            else
+              output_text(data)
+            end
           end
         end
 
         def collect_stats(branch, branch_name)
+          ecosystem = @options[:ecosystem]
+
           data = {
             branch: branch_name,
+            ecosystem: ecosystem,
             commits_analyzed: branch&.commits&.count || 0,
             commits_with_changes: branch&.commits&.where(has_dependency_changes: true)&.count || 0,
             current_dependencies: {},
@@ -46,6 +53,7 @@ module Git
           if branch&.last_analyzed_sha
             current_commit = Models::Commit.find_by(sha: branch.last_analyzed_sha)
             snapshots = current_commit&.dependency_snapshots || []
+            snapshots = snapshots.where(ecosystem: ecosystem) if ecosystem
 
             data[:current_dependencies] = {
               total: snapshots.count,
@@ -54,22 +62,28 @@ module Git
             }
           end
 
+          changes = Models::DependencyChange.all
+          changes = changes.where(ecosystem: ecosystem) if ecosystem
+
           data[:changes] = {
-            total: Models::DependencyChange.count,
-            by_type: Models::DependencyChange.group(:change_type).count
+            total: changes.count,
+            by_type: changes.group(:change_type).count
           }
 
-          most_changed = Models::DependencyChange
+          most_changed = changes
             .group(:name, :ecosystem)
             .order("count_all DESC")
             .limit(10)
             .count
 
-          data[:most_changed] = most_changed.map do |(name, ecosystem), count|
-            { name: name, ecosystem: ecosystem, changes: count }
+          data[:most_changed] = most_changed.map do |(name, eco), count|
+            { name: name, ecosystem: eco, changes: count }
           end
 
-          data[:manifests] = Models::Manifest.all.map do |manifest|
+          manifests = Models::Manifest.all
+          manifests = manifests.where(ecosystem: ecosystem) if ecosystem
+
+          data[:manifests] = manifests.map do |manifest|
             { path: manifest.path, ecosystem: manifest.ecosystem, changes: manifest.dependency_changes.count }
           end
 
@@ -82,6 +96,7 @@ module Git
           puts
 
           puts "Branch: #{data[:branch]}"
+          puts "Ecosystem: #{data[:ecosystem]}" if data[:ecosystem]
           puts "Commits analyzed: #{data[:commits_analyzed]}"
           puts "Commits with changes: #{data[:commits_with_changes]}"
           puts
@@ -128,6 +143,38 @@ module Git
           end
         end
 
+        def output_by_author
+          changes = Models::DependencyChange
+            .joins(:commit)
+            .where(change_type: "added")
+
+          changes = changes.where(ecosystem: @options[:ecosystem]) if @options[:ecosystem]
+
+          counts = changes
+            .group("commits.author_name")
+            .order("count_all DESC")
+            .limit(@options[:limit] || 20)
+            .count
+
+          if counts.empty?
+            puts "No dependency additions found"
+            return
+          end
+
+          if @options[:format] == "json"
+            require "json"
+            data = counts.map { |name, count| { author: name, added: count } }
+            puts JSON.pretty_generate(data)
+          else
+            puts "Dependencies Added by Author"
+            puts "=" * 40
+            puts
+            counts.each do |name, count|
+              puts "  #{count.to_s.rjust(4)}  #{name}"
+            end
+          end
+        end
+
         def parse_options
           options = {}
 
@@ -138,10 +185,22 @@ module Git
               options[:branch] = v
             end
 
+            opts.on("-e", "--ecosystem=NAME", "Filter by ecosystem") do |v|
+              options[:ecosystem] = v
+            end
+
             opts.on("-f", "--format=FORMAT", "Output format (text, json)") do |v|
               options[:format] = v
             end
 
+            opts.on("--by-author", "Show dependencies added by author") do
+              options[:by_author] = true
+            end
+
+            opts.on("-n", "--limit=N", Integer, "Limit results (default: 20)") do |v|
+              options[:limit] = v
+            end
+
             opts.on("-h", "--help", "Show this help") do
               puts opts
               exit

data/lib/git/pkgs/version.rb

@@ -2,6 +2,6 @@
 
 module Git
   module Pkgs
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

data/lib/git/pkgs.rb

@@ -27,6 +27,7 @@ require_relative "pkgs/commands/diff"
 require_relative "pkgs/commands/tree"
 require_relative "pkgs/commands/branch"
 require_relative "pkgs/commands/search"
+require_relative "pkgs/commands/show"
 
 module Git
   module Pkgs

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-pkgs
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Andrew Nesbitt
@@ -98,6 +98,7 @@ files:
 - lib/git/pkgs/commands/list.rb
 - lib/git/pkgs/commands/outdated.rb
 - lib/git/pkgs/commands/search.rb
+- lib/git/pkgs/commands/show.rb
 - lib/git/pkgs/commands/stats.rb
 - lib/git/pkgs/commands/tree.rb
 - lib/git/pkgs/commands/update.rb