rails-informant 0.5.3 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87e632d9075cba7b12f2a9d4f37654dbf5c38503d4d037916f70956db5831da6
-  data.tar.gz: a004d0304531b5f591b1c7cf55cf57c188edb1fa0969ab3c1b86dd340f9a1c69
+  metadata.gz: 905f71f9e86e6c982710d2c1dbd8471218798e1cfa80b8baca78124180a1fef3
+  data.tar.gz: 9cc699035012351e2bfe4b0423c2b7fe0bffd7880f05250d2d54f758bf2d50ea
 SHA512:
-  metadata.gz: 938408a0098cc497a2498bd6ac34ff70b1b69740d81647f5a32b997c227d5e2bee260d6f7d7737d26ae92dff5aeb17ba70c78fc530d4b146732b3f0bd251c137
-  data.tar.gz: 2e8a5894b1c1c9f3e4129c813c3717d78c2ecf0c31a338bbf15843044684123d614f465ebf1fe389bf0d433b6ae453d83c4fb1927e8a46f594c790f1270c035b
+  metadata.gz: b103c2f10d32404883a51e7d9ef82daf0dda368bd7ec50165d32f88b9b9d53924aeb6264af9c4e7f10468d6abe891228a62e7e09c2584a74a0d469a619cf9dd5
+  data.tar.gz: fad95e73c07500480d703c2018e5eeeef77656f0cd16aced9b8e778d90c700a450b1f2963c54f093b76fc2b501a013148b2afb18bef81b8eeed399db1bd5d96c

data/README.md

@@ -63,6 +63,8 @@ Install Claude Code integration:
 bin/rails generate rails_informant:skill
 ```
 
+With [Rails Hyperdrive](https://github.com/rails-hyperdrive/rails-hyperdrive), the `/informant` skill arrives through `bin/rails hyperdrive:sync` instead, and the generator installs the rest (see [With Rails Hyperdrive](#with-rails-hyperdrive)).
+
 Errors are captured automatically. To capture manually:
 
 ```ruby
@@ -222,6 +224,19 @@ bin/rails informant:doctor   # reports current / stale / not installed; exits no
 
 Apps that use the gem only for error capture (no Claude Code integration) are never affected.
 
+#### With Rails Hyperdrive
+
+rails-informant is a Hyperdrive companion gem. Once an app has `.hyperdrive/config.yml`, Hyperdrive owns the skill (`.claude/skills/informant/SKILL.md`) and updates it on `bin/rails hyperdrive:sync`, keeping your local edits safe. The generator still owns the hook script, its `.claude/settings.json` entry and `.mcp.json`, and no longer writes the skill. The drift checks ignore the skill in these apps.
+
+If the generator installed the skill before Hyperdrive arrived, hand it over once:
+
+```sh
+rm -f .claude/skills/informant/SKILL.md .claude/skills/informant/SKILL.md.new
+bin/rails hyperdrive:sync
+```
+
+Hyperdrive treats a file it did not install as a local edit and never overwrites it, so the old copy has to go first. Avoid `hyperdrive:sync --overwrite` for this: it rewrites every locally edited Hyperdrive file, from every companion gem. `bin/rails informant:doctor` prints these steps while the handover is pending.
+
 ### Tools
 
 | Tool | Description |

data/Rakefile

@@ -1,5 +1,6 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
+require "hyperdrive/skill_tasks"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"

data/lib/generators/rails_informant/skill_generator.rb

@@ -9,7 +9,9 @@ module RailsInformant
     source_root File.expand_path("skill/templates", __dir__)
 
     def copy_skill_file
-      copy_file "SKILL.md", ".claude/skills/informant/SKILL.md"
+      return if hyperdrive_managed?
+
+      create_file Content::SKILL_PATH, Content.skill_markdown
     end
 
     def copy_hook_script
@@ -63,7 +65,11 @@ module RailsInformant
       say "Claude Code integration installed!", :green
       say ""
       say "  Created .mcp.json"
-      say "  Created .claude/skills/informant/SKILL.md"
+      if hyperdrive_managed?
+        say "  Skipped #{Content::SKILL_PATH} (Rails Hyperdrive installs it: bin/rails hyperdrive:sync)"
+      else
+        say "  Created #{Content::SKILL_PATH}"
+      end
       say "  Created .claude/hooks/informant-alerts.sh"
       say "  Created .claude/settings.json (UserPromptSubmit hook)"
       say ""
@@ -81,6 +87,8 @@ module RailsInformant
 
     private
 
+    def hyperdrive_managed? = Content.hyperdrive_managed?(destination_root)
+
     # Remove every prior informant registration (matched by script path) from all
     # event keys and drop keys left empty, so a re-run migrates a stale
     # registration (e.g. a leftover SessionStart from an earlier gem version)

data/lib/rails_informant/claude_integration_content.rb

@@ -14,6 +14,13 @@ module RailsInformant
     SETTINGS_PATH = ".claude/settings.json"
     MCP_PATH = ".mcp.json"
 
+    # `hyperdrive:init` writes this before the first sync, so the skill is left
+    # to Hyperdrive from the start. Keying on the lock instead would let the
+    # generator write the skill in that window, and Hyperdrive treats an
+    # unlocked file as a local edit it never overwrites.
+    HYPERDRIVE_CONFIG_PATH = ".hyperdrive/config.yml"
+    HYPERDRIVE_LOCK_PATH = ".hyperdrive/lock.yml"
+
     # The command string a settings.json hook entry uses to invoke the script.
     # Absolute via Claude Code's $CLAUDE_PROJECT_DIR because the hook's cwd is
     # not guaranteed to be the app root: a bare relative path fails on every
@@ -48,9 +55,11 @@ module RailsInformant
     end
 
     def skill_markdown
-      File.read File.join(templates_dir, "SKILL.md")
+      File.read File.join(gem_dir, "skills", "informant", "SKILL.md")
     end
 
+    def hyperdrive_managed?(app_root) = File.exist?(File.join(app_root, HYPERDRIVE_CONFIG_PATH))
+
     # The informant server entry inside .mcp.json's "mcpServers".
     def mcp_entry
       { "command" => "informant-mcp" }

data/lib/rails_informant/doctor.rb

@@ -6,6 +6,13 @@ module RailsInformant
   # or error) so it doubles as a CI signal. A thin wrapper over Integration that
   # never raises out — a diagnostic must not crash the run it reports on.
   class Doctor
+    HYPERDRIVE_ADOPTION = <<~REPORT.chomp
+      [Informant] Rails Hyperdrive manages the informant skill, but #{ClaudeIntegrationContent::SKILL_PATH} is not a Hyperdrive install.
+      Hand it over (not --overwrite, which rewrites every edited Hyperdrive file):
+        rm -f #{ClaudeIntegrationContent::SKILL_PATH} #{ClaudeIntegrationContent::SKILL_PATH}.new
+        bin/rails hyperdrive:sync
+    REPORT
+
     def initialize(integration: Integration.new, io: $stdout)
       @integration = integration
       @io = io
@@ -15,6 +22,7 @@ module RailsInformant
       status = @integration.status
       @integration.write_drift_flag stale: status == :stale
       @io.puts report_for(status)
+      @io.puts HYPERDRIVE_ADOPTION if @integration.skill_awaiting_hyperdrive?
       exit_code_for status
     rescue StandardError => e
       # An unexpected failure must exit nonzero, not 0 — a doctor wired into CI

data/lib/rails_informant/integration.rb

@@ -2,6 +2,7 @@ require "digest"
 require "fileutils"
 require "json"
 require "pathname"
+require "yaml"
 require "rails_informant/claude_integration_content"
 
 module RailsInformant
@@ -24,6 +25,7 @@ module RailsInformant
 
     def initialize(app_root: Rails.root)
       @app_root = Pathname(app_root)
+      @hyperdrive_managed = Content.hyperdrive_managed?(@app_root)
     end
 
     # :not_installed | :current | :stale | :error
@@ -47,6 +49,17 @@ module RailsInformant
       status == :stale
     end
 
+    # Never true for a skill Hyperdrive already owns: a lock-SHA mismatch is a
+    # local edit, and a sidecar with a recorded ancestor is Hyperdrive's own
+    # upgrade of that edit (hyperdrive:sync --resolve). The handover would
+    # discard the edit in both cases.
+    def skill_awaiting_hyperdrive?
+      return false unless @hyperdrive_managed && skill_path.exist?
+
+      entry = informant_skill_entry or return true
+      sidecar_path.exist? && entry["ancestor_sha"].nil?
+    end
+
     # Display only — the drift decision uses the digest, not the version. Harmless
     # that local path/git installs report 0.0.0.dev here; only published installs
     # show a real number.
@@ -79,6 +92,8 @@ module RailsInformant
     def skill_path = @app_root.join(Content::SKILL_PATH)
     def settings_path = @app_root.join(Content::SETTINGS_PATH)
     def mcp_path = @app_root.join(Content::MCP_PATH)
+    def sidecar_path = @app_root.join("#{Content::SKILL_PATH}.new")
+    def lock_path = @app_root.join(Content::HYPERDRIVE_LOCK_PATH)
 
     def hook_script_present? = hook_path.exist?
 
@@ -100,7 +115,7 @@ module RailsInformant
     def expected_digest
       digest_of(
         "hook" => normalize_text(Content.hook_script),
-        "skill" => normalize_text(Content.skill_markdown),
+        "skill" => @hyperdrive_managed ? "" : normalize_text(Content.skill_markdown),
         "settings" => canonical_json(Content.expected_registrations),
         "mcp" => canonical_json(Content.mcp_entry)
       )
@@ -109,7 +124,7 @@ module RailsInformant
     def live_digest
       digest_of(
         "hook" => normalize_text(read_or_empty(hook_path)),
-        "skill" => normalize_text(read_or_empty(skill_path)),
+        "skill" => @hyperdrive_managed ? "" : normalize_text(read_or_empty(skill_path)),
         "settings" => canonical_json(live_settings_registrations || {}),
         "mcp" => canonical_json(live_mcp_entry || {})
       )
@@ -143,6 +158,21 @@ module RailsInformant
       mcp.dig "mcpServers", "informant"
     end
 
+    def informant_skill_entry
+      Array(lock_files).find do |entry|
+        entry["artifact"] == "skill" && entry["source"].to_s.start_with?("rails-informant@")
+      end
+    end
+
+    def lock_files
+      return unless lock_path.exist?
+
+      lock = YAML.safe_load(lock_path.read)
+      lock["files"] if lock.is_a?(Hash)
+    rescue Psych::Exception
+      nil
+    end
+
     # --- json / text helpers ------------------------------------------------
 
     # Read and parse each JSON file at most once per instance. Instances are

data/{lib/generators/rails_informant/skill/templates → skills/informant}/SKILL.md

@@ -1,4 +1,6 @@
 ---
+name: informant
+description: Triage and fix production errors captured by Rails Informant, using its MCP tools.
 disable-model-invocation: true
 allowed-tools:
   - mcp__informant__*

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-informant
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.6.0
 platform: ruby
 authors:
 - Daniel López Prat
@@ -127,7 +127,6 @@ files:
 - db/migrate/20260227000000_create_informant_tables.rb
 - exe/informant-mcp
 - lib/generators/rails_informant/install_generator.rb
-- lib/generators/rails_informant/skill/templates/SKILL.md
 - lib/generators/rails_informant/skill/templates/informant-alerts.sh
 - lib/generators/rails_informant/skill_generator.rb
 - lib/generators/rails_informant/templates/create_informant_tables.rb.erb
@@ -176,12 +175,14 @@ files:
 - lib/rails_informant/structured_event_subscriber.rb
 - lib/rails_informant/version.rb
 - lib/tasks/rails_informant.rake
+- skills/informant/SKILL.md
 homepage: https://github.com/6temes/rails-informant
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/6temes/rails-informant/issues
   changelog_uri: https://github.com/6temes/rails-informant/releases
+  hyperdrive_targets: rails-informant
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/6temes/rails-informant
 rdoc_options: []
@@ -198,7 +199,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Self-hosted error monitoring for Rails with MCP server for agentic workflows
 test_files: []