bundler-skills 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efdb922b385805d47a3b9d255b160810300f0b6e98157213f6a4587d1d2475dc
-  data.tar.gz: da6868ab55f898967fe52c7699512898c4a4df2e5ccb7e278cd5882b6c0219f1
+  metadata.gz: 439aafda99d985a5bd8da3676ad50a82f17d1e8bf01a895d193998ae1faf885d
+  data.tar.gz: 0050bcd8e99963aecc9b847bba9697e2b88b8d55ecee0f3c8d6a7340a6b0ad9c
 SHA512:
-  metadata.gz: f931afeb29f6d9e263b6f9d39ddbbd0ae157fed3bdc9aa45ccacefd6c64d4e0ca3d14732619f91d964dd81c4e5f88c7367bb26a5ebe11da93b82ae91274843d1
-  data.tar.gz: cacd1cf9954366a41d0edfeecb13fee38ba865ad4ac8c7b9ae45eb966e44ca8982f5a8e8e1e443c18395475a44ca06b1c1899466b5e5ee7c5aa0c2ee6fff5262
+  metadata.gz: de83628fb2e88ab3388afd068d0c478eb901fac43df5858ca280af1012dfaa64363599a4e640874d3d8e392b4189dd7f3962420a0e44d458cb5c5893d6880409
+  data.tar.gz: 46029390766998a7ede9dc14546d6fbbff54810973196a8e8626ce653b905cbcd43dec302d63f1b21e88915c74703296d5ac22881dd9b3ac2e6930b14b3b29a0

data/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-06-21
+
+### Changed
+
+- Post-install summary now highlights runs that actually changed something:
+  when skills are created, relinked (after a gem update), or pruned, the summary
+  line is printed in green (`confirm`) instead of plain text, and the count of
+  relinked skills is now shown alongside linked/pruned.
+- A changed run additionally lists each affected skill grouped by kind
+  (created / relinked / pruned), showing the path to its `SKILL.md`, so the
+  third-party skill contents linked into your project are easy to review.
+
+## [0.2.0] - 2026-06-18
+
+### Added
+
+- `bundle skills init` command: creates a `bundler-skills.yml` config file with
+  all keys commented out, so users can enable only the options they need.
+
 ## [0.1.0] - 2026-06-18
 
 ### Added

data/README.md

@@ -56,7 +56,22 @@ bundle install
 That's it. On install you'll see something like:
 
 ```
-[bundler-skills] 3 skill(s) discovered, 3 linked, 0 pruned across 1 dir(s) (agents: claude)
+[bundler-skills] 3 skill(s) discovered, 3 linked, 0 relinked, 0 pruned across 1 dir(s) (agents: claude)
+```
+
+When a run actually changes something (links created, relinked after a gem
+update, or stale links pruned) the summary is printed in green so it stands out;
+a run with nothing to do prints the same line in plain text. A changed run also
+lists each affected skill, grouped by kind, with the path to its `SKILL.md` so
+you can review the (third-party) skill contents now linked into your project:
+
+```
+[bundler-skills] 3 skill(s) discovered, 2 linked, 1 relinked, 0 pruned across 1 dir(s) (agents: claude)
+  created:
+    .claude/skills/gem-rubocop--style  ->  /path/to/gems/rubocop/skills/style
+    .claude/skills/gem-rubocop--lint   ->  /path/to/gems/rubocop/skills/lint
+  relinked:
+    .claude/skills/gem-rspec--matchers  ->  /path/to/gems/rspec/skills/matchers
 ```
 
 > Alternatively, install it globally with `bundle plugin install bundler-skills`.
@@ -72,6 +87,7 @@ Use the command to sync manually, or to inspect/clean:
 bundle skills          # (or: bundle skills sync) re-create symlinks
 bundle skills list     # show discovered skills and target agents (no changes)
 bundle skills clean    # remove all gem-*--* symlinks this plugin created
+bundle skills init     # create a bundler-skills.yml config file with defaults
 bundle skills <cmd> --dry-run   # show what would change without writing
 ```
 

data/lib/bundler_skills/command.rb

@@ -9,14 +9,32 @@ module BundlerSkills
   class Command < Bundler::Plugin::API
     command "skills"
 
+    INIT_TEMPLATE = <<~YAML
+      # bundler-skills.yml — all keys are optional
+      #
+      # enabled:                    # nil (auto) | false (off) | [development] (env list)
+      # agents:                     # omit = auto-detect; or list: [claude, cursor]; or "*"
+      #   - claude
+      #   - cursor
+      # gitignore: true             # manage .gitignore (default true)
+      # cleanup: true               # prune stale gem-*--* links when a gem is removed (default true)
+      # recursive: false            # also scan skills/**/SKILL.md (default false)
+      # include:                    # only these gems (empty = all). fnmatch on "gem" or "gem/skill"
+      #   - rubocop
+      #   - "rails-*"
+      # exclude:                    # exclude these (wins over include)
+      #   - some-noisy-gem
+    YAML
+
     def exec(_command_name, args)
-      dry_run = args.delete("--dry-run") ? true : false
+      dry_run = !!args.delete("--dry-run")
       subcommand = args.shift || "sync"
 
       case subcommand
       when "sync" then run_sync(dry_run)
       when "list" then run_list
       when "clean" then run_clean(dry_run)
+      when "init" then run_init
       when "help", "-h", "--help" then print_help
       else
         Bundler.ui.error("[bundler-skills] unknown subcommand: #{subcommand}")
@@ -51,6 +69,17 @@ module BundlerSkills
       end
     end
 
+    def run_init
+      path = Bundler.root / Config::CONFIG_FILENAME
+      if File.exist?(path)
+        Bundler.ui.warn("[bundler-skills] #{Config::CONFIG_FILENAME} already exists")
+        return
+      end
+
+      File.write(path, INIT_TEMPLATE)
+      Bundler.ui.info("[bundler-skills] created #{Config::CONFIG_FILENAME}")
+    end
+
     def run_clean(dry_run)
       removed = synchronizer(dry_run: dry_run).clean
       total = removed.values.sum(&:size)
@@ -68,6 +97,7 @@ module BundlerSkills
           sync   (default) discover skills and (re)create symlinks
           list   show discovered skills and target agents (no changes)
           clean  remove all gem-*--* symlinks this plugin created
+          init   create a bundler-skills.yml config file with defaults
 
         Options:
           --dry-run   show what would change without writing

data/lib/bundler_skills/linker.rb

@@ -22,6 +22,11 @@ module BundlerSkills
         @skipped = []
         @pruned = []
       end
+
+      # Did this run actually mutate the filesystem? kept/skipped are no-ops.
+      def changed?
+        created.any? || relinked.any? || pruned.any?
+      end
     end
 
     def initialize(skills_dir:, config: Config.new(Config::DEFAULTS), logger: nil)

data/lib/bundler_skills/synchronizer.rb

@@ -83,12 +83,42 @@ module BundlerSkills
       end
 
       created = links_by_dir.values.sum { |r| r.created.size }
+      relinked = links_by_dir.values.sum { |r| r.relinked.size }
       pruned = links_by_dir.values.sum { |r| r.pruned.size }
-      @logger.info(
+
+      message =
         "[bundler-skills] #{skills.size} skill(s) discovered, " \
-        "#{created} linked, #{pruned} pruned across #{links_by_dir.size} dir(s) " \
-        "(agents: #{agents.map(&:key).join(', ')})"
-      )
+        "#{created} linked, #{relinked} relinked, #{pruned} pruned " \
+        "across #{links_by_dir.size} dir(s) (agents: #{agents.map(&:key).join(', ')})"
+
+      # Make a run that actually changed something stand out (green) so it is
+      # noticed amid bundle's output; an unchanged run stays plain.
+      if links_by_dir.values.any?(&:changed?)
+        @logger.confirm(message)
+        # List the skills that changed so the user can review the (third-party)
+        # SKILL.md contents now linked into their project. created/relinked are
+        # in the discovery set so we can show their source path; pruned skills
+        # are already gone, so we show the name only.
+        log_changed_skills(skills, links_by_dir)
+      else
+        @logger.info(message)
+      end
+    end
+
+    def log_changed_skills(skills, links_by_dir)
+      source_by_link = skills.to_h { |s| [s.link_name, s.source_path] }
+
+      %i[created relinked pruned].each do |kind|
+        entries = links_by_dir.flat_map do |subdir, result|
+          result.public_send(kind).map { |name| [File.join(subdir, name), source_by_link[name]] }
+        end
+        next if entries.empty?
+
+        @logger.info("  #{kind}:")
+        entries.each do |path, source|
+          @logger.info(source ? "    #{path}  ->  #{source}" : "    #{path}")
+        end
+      end
     end
   end
 end

data/lib/bundler_skills/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bundler-skills
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - aki77