rails-hyperdrive 0.4.0 → 0.6.0

data/lib/rails/hyperdrive/install_pipeline.rb

@@ -26,7 +26,7 @@ module Rails
       Result = Struct.new(:installed, :updated, :unchanged, :skipped, :orphaned, :removed, :merged, :sidecars,
         keyword_init: true)
 
-      def initialize(root:, shell:, artifacts:, mode: :preserve, warnings: [])
+      def initialize(root:, shell:, artifacts:, mode: :preserve, warnings: [], notices: [])
         raise ArgumentError, "unknown mode #{mode.inspect}" unless MODES.include?(mode)
 
         @root = File.expand_path(root.to_s)
@@ -34,6 +34,7 @@ module Rails
         @artifacts = artifacts
         @mode = mode
         @warnings = warnings
+        @notices = notices
         @result = Result.new(
           installed: [], updated: [], unchanged: [], skipped: [], orphaned: [], removed: [], merged: [], sidecars: []
         )
@@ -54,6 +55,7 @@ module Rails
         write_claude_md(guidelines)
         write_lock
         print_warnings
+        print_notices
         print_footprint(guidelines: eager_guidelines)
         warn_if_destinations_gitignored
         @result
@@ -115,6 +117,7 @@ module Rails
       def install_skills
         @plan.select { |e| e.type == :skill }.each do |entry|
           skill_relpath = source_relpath_for(entry.artifact)
+          support_base = support_relpath_base(entry.artifact, skill_relpath)
           install_file(entry: entry, type: :skill, install_ready_body: entry.install_ready_body,
             source_relpath: skill_relpath, final_name: entry.final_name)
           entry.support_files.each do |file|
@@ -125,7 +128,7 @@ module Rails
               source_gem: entry.source_gem,
               version: entry.version,
               artifact_kind: "skill_support",
-              source_relpath: skill_relpath && File.join(File.dirname(skill_relpath), file[:path])
+              source_relpath: support_base && File.join(support_base, file[:path])
             )
           end
         end
@@ -155,6 +158,22 @@ module Rails
         rel.end_with?(".md.erb") ? rel.delete_suffix(".erb") : rel
       end
 
+      # Supporting files live under the artifact's support root, which for a
+      # template-paired skill is not the definition file's directory.
+      def support_relpath_base(artifact, skill_relpath)
+        support_root = artifact.support_root
+        return skill_relpath && File.dirname(skill_relpath) if support_root.nil? || support_root.to_s.empty?
+
+        root = artifact.source_root
+        return nil if root.nil? || root.to_s.empty?
+
+        prefix = "#{File.expand_path(root.to_s)}/"
+        expanded = File.expand_path(support_root.to_s)
+        return nil unless expanded.start_with?(prefix)
+
+        expanded.delete_prefix(prefix)
+      end
+
       def install_file(dest: nil, type:, install_ready_body:, entry: nil, source_gem: nil, version: nil,
                        artifact_kind: nil, source_relpath: nil, final_name: nil)
         write = {
@@ -524,6 +543,12 @@ module Rails
         @warnings.each { |w| @shell.say "    - #{w}" }
       end
 
+      def print_notices
+        return if additive? || Array(@notices).empty?
+        @shell.say ""
+        @notices.each { |n| @shell.say_status :info, n, :blue }
+      end
+
       def print_footprint(guidelines:)
         return if additive?
 

data/lib/rails/hyperdrive/lock_file.rb

@@ -33,6 +33,7 @@ module Rails
         @files = {}            # path(String) => Entry
         @document = {}         # raw parsed YAML, kept so unknown keys survive
         @disabled = empty_disabled
+        @enabled = []
       end
 
       def read
@@ -45,6 +46,7 @@ module Rails
         claude_md = data["claude_md"]
         @claude_md_state = claude_md["state"] if claude_md.is_a?(Hash)
         @disabled = parse_disabled(data["disabled"])
+        @enabled = parse_enabled(data["enabled"])
         Array(data["files"]).each do |raw|
           next unless raw.is_a?(Hash)
           entry = build_entry(raw)
@@ -71,11 +73,17 @@ module Rails
         Array(@disabled[type.to_sym]).include?(name.to_s)
       end
 
+      # Hand-editable list of gems the app opts into as companions.
+      def enabled_gems
+        @enabled
+      end
+
       # Adopt the state that is not derived from installed content, so
       # rewriting the file preserves it.
       def carry_settings(other)
         @document = other.document.dup
         @disabled = other.disabled_lists.dup
+        @enabled = other.enabled_gems.dup
         self
       end
 
@@ -103,6 +111,7 @@ module Rails
           "version"   => SCHEMA_VERSION,
           "claude_md" => carried.merge("state" => @claude_md_state),
           "disabled"  => DISABLED_KEYS.each_with_object({}) { |(type, key), h| h[key] = @disabled[type] },
+          "enabled"   => @enabled,
           "files"     => @files.values.sort_by(&:path).map { |e| serialize_entry(e) }
         )
         # A nil state means no import line is being managed. Recording one anyway
@@ -136,6 +145,12 @@ module Rails
         end
       end
 
+      def parse_enabled(raw)
+        return [] unless raw.is_a?(Array)
+
+        raw.map { |name| name.to_s.strip }.reject(&:empty?).uniq
+      end
+
       def build_entry(raw)
         source_gem, source_version = split_source(raw["source"])
         Entry.new(

data/lib/rails/hyperdrive/skill_tasks.rb

@@ -0,0 +1,27 @@
+# Rake tasks for companion gem repos: add `require "rails/hyperdrive/skill_tasks"`
+# to the Rakefile. Both tasks take an optional gemspec-path argument, e.g.
+# rake "hyperdrive:skills:render[path/to/name.gemspec]".
+require "rake"
+require "rails/hyperdrive/canonical_skill_render"
+
+namespace :hyperdrive do
+  namespace :skills do
+    desc "Render each SKILL.md.erb template to its canonical static SKILL.md"
+    task :render, [:gemspec] do |_t, args|
+      written = Rails::Hyperdrive::CanonicalSkillRender.write(gemspec: args[:gemspec])
+      written.each { |r| puts "render #{r.dest}" }
+      puts "no skill templates found" if written.empty?
+    end
+
+    desc "Fail when a canonical SKILL.md is stale relative to its template"
+    task :check, [:gemspec] do |_t, args|
+      stale = Rails::Hyperdrive::CanonicalSkillRender.stale(gemspec: args[:gemspec])
+      if stale.empty?
+        puts "canonical skill files up to date"
+      else
+        stale.each { |r| warn "stale: #{r.dest}" }
+        abort "#{stale.size} canonical skill file(s) stale; run `rake hyperdrive:skills:render`"
+      end
+    end
+  end
+end

data/lib/rails/hyperdrive/skill_template.rb

@@ -31,6 +31,27 @@ module Rails
         end
       end
 
+      # Fail-open binding for the canonical render: every gem reads as present
+      # at any requested version, so the output includes every conditional
+      # branch. There is no bundle to resolve against, so gem_version is nil.
+      class CanonicalContext
+        def gem?(_name, _requirement = nil)
+          true
+        end
+
+        def any_gem?(*)
+          true
+        end
+
+        def gem_version(_name)
+          nil
+        end
+
+        def template_binding
+          binding
+        end
+      end
+
       module_function
 
       # Errors (ERB SyntaxError included) propagate; the caller decides how to
@@ -39,6 +60,10 @@ module Rails
         ERB.new(source, trim_mode: "-").result(Context.new(resolved).template_binding)
       end
 
+      def render_canonical(source)
+        ERB.new(source, trim_mode: "-").result(CanonicalContext.new.template_binding)
+      end
+
       # Gem::Requirement.new does not parse a single comma-separated string, so
       # such strings are split into separate constraints first.
       def version_matches?(requirement_str, version)

data/lib/rails/hyperdrive/stack_profile.rb

@@ -130,7 +130,8 @@ module Rails
       # Bundler is absent or refuses to resolve.
       def gem_skills_info
         require "rails/hyperdrive/bundler_artifact_discovery"
-        ::Rails::Hyperdrive::BundlerArtifactDiscovery.discover.select(&:skill?).map do |skill|
+        discovered = ::Rails::Hyperdrive::BundlerArtifactDiscovery.discover(enabled_gems: enabled_gems)
+        discovered.select(&:skill?).map do |skill|
           {
             name: skill.name,
             gem: skill.target_gem,
@@ -143,6 +144,24 @@ module Rails
       rescue StandardError
         []
       end
+
+      def enabled_gems
+        require "rails/hyperdrive/install_layout"
+        require "rails/hyperdrive/lock_file"
+        root =
+          if @app_root
+            @app_root.to_s
+          elsif defined?(::Rails) && ::Rails.respond_to?(:root) && ::Rails.root
+            ::Rails.root.to_s
+          end
+        return [] unless root
+
+        ::Rails::Hyperdrive::LockFile.load(
+          File.join(root, ::Rails::Hyperdrive::InstallLayout::LOCK_PATH)
+        ).enabled_gems
+      rescue StandardError
+        []
+      end
     end
   end
 end

data/lib/rails/hyperdrive/tools/run_sql.rb

@@ -40,7 +40,7 @@ module Rails
           shown = rows.first(ROW_CAP)
           lines = [result.columns.join("\t")]
           shown.each { |row| lines << row.map { |v| v.to_s }.join("\t") }
-          lines << "(#{rows.length} rows, truncated)" if rows.length > ROW_CAP
+          lines << "(showing first #{ROW_CAP} of #{rows.length} rows)" if rows.length > ROW_CAP
           lines.join("\n")
         end
       end

data/lib/rails/hyperdrive/version.rb

@@ -1,5 +1,5 @@
 module Rails
   module Hyperdrive
-    VERSION = "0.4.0"
+    VERSION = "0.6.0"
   end
 end

data/lib/rails/hyperdrive.rb

@@ -2,16 +2,6 @@ require "rails/hyperdrive/version"
 
 module Rails
   module Hyperdrive
-    class Configuration
-      DEFAULT_MOUNT_AT = "/_hyperdrive".freeze
-
-      attr_accessor :mount_at
-
-      def initialize
-        @mount_at = DEFAULT_MOUNT_AT
-      end
-    end
-
     def self.root
       @root ||= File.expand_path("..", __dir__)
     end
@@ -19,18 +9,6 @@ module Rails
     def self.dev_mode?
       defined?(::Rails) && ::Rails.respond_to?(:env) && ::Rails.env.development?
     end
-
-    def self.configuration
-      @configuration ||= Configuration.new
-    end
-
-    def self.configure
-      yield(configuration)
-    end
-
-    def self.reset_configuration!
-      @configuration = nil
-    end
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-hyperdrive
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Bakaface
@@ -89,7 +89,6 @@ files:
 - lib/generators/hyperdrive/gitignore_support.rb
 - lib/generators/hyperdrive/install/USAGE
 - lib/generators/hyperdrive/install/install_generator.rb
-- lib/generators/hyperdrive/install/templates/initializer.rb.tt
 - lib/generators/hyperdrive/install_summary.rb
 - lib/generators/hyperdrive/sync/USAGE
 - lib/generators/hyperdrive/sync/sync_generator.rb
@@ -100,12 +99,14 @@ files:
 - lib/rails/hyperdrive/artifact_status.rb
 - lib/rails/hyperdrive/auto_install.rb
 - lib/rails/hyperdrive/bundler_artifact_discovery.rb
+- lib/rails/hyperdrive/canonical_skill_render.rb
 - lib/rails/hyperdrive/claude_md_import.rb
 - lib/rails/hyperdrive/companion_discovery.rb
 - lib/rails/hyperdrive/console_executor.rb
 - lib/rails/hyperdrive/drift_verdict.rb
 - lib/rails/hyperdrive/eager_footprint.rb
 - lib/rails/hyperdrive/engine.rb
+- lib/rails/hyperdrive/gem_manifest.rb
 - lib/rails/hyperdrive/index_document.rb
 - lib/rails/hyperdrive/install_layout.rb
 - lib/rails/hyperdrive/install_pipeline.rb
@@ -116,6 +117,7 @@ files:
 - lib/rails/hyperdrive/resources/skill.rb
 - lib/rails/hyperdrive/resources/stack_profile.rb
 - lib/rails/hyperdrive/safety/rack_middleware.rb
+- lib/rails/hyperdrive/skill_tasks.rb
 - lib/rails/hyperdrive/skill_template.rb
 - lib/rails/hyperdrive/sql_safety.rb
 - lib/rails/hyperdrive/stack_profile.rb

data/lib/generators/hyperdrive/install/templates/initializer.rb.tt

@@ -1,3 +0,0 @@
-Rails::Hyperdrive.configure do |c|
-  c.mount_at = "<%= mount_path %>"
-end