rails-informant 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71f2d05d2caf43bbaab7641118f09b86cafb4949d9f4c2be262a4773f6a88eab
-  data.tar.gz: 8f3de02212167bfcbbb412d653af259eeed2a0e5907f75b8e1191d724faf112a
+  metadata.gz: 9190270b29cd61133c36e5083527afb433de74d02bde6a854c07ba0ee525686d
+  data.tar.gz: c9240093202eb13ac1fd85993ead95983abcced394efe40a0f49ad5cbe183f7d
 SHA512:
-  metadata.gz: b7c2c8599fe28a7adef712a0cc4f989cdae99465a18b2120055c049dbf77136e243dee9f382fc8dee0ed6d6c7d2d6173a18b1e42a750d031a31268fd377758ff
-  data.tar.gz: 59729b6bd6f564023810acd041e3d71f7cf930e8bb65dd88833495b6392d3eb979aa920b80650d4ffe6833f91675743b928a1162ecad4bf10c75c894759843ad
+  metadata.gz: 285bebc2912dfda97c99474e5a272a51c0959e7aea2c5739b051ccc3e661da69fca77960472d73e5acfc0d55d3cc5e7c8c56a4b48dd2a032abb0010150b8d2a5
+  data.tar.gz: 7e11cbeeba65c6e6735c28f3c9b2262a71a8c7a6991d6c5cc31679d2a8062fde7c825e79ea2ca07894328eccc78d58f441c57f2f7d1ebb5c447c573010c4b779

data/README.md

@@ -132,16 +132,13 @@ The bundled `informant-mcp` executable connects Claude Code to your error data v
 
 The `rails_informant:skill` generator creates `.mcp.json` automatically. Set `INFORMANT_PRODUCTION_URL` and `INFORMANT_PRODUCTION_TOKEN` as environment variables (e.g., via `.envrc` + direnv). The MCP server inherits env vars from your shell.
 
-For multi-environment setups, create `~/.config/informant-mcp.yml`:
+For multi-environment setups, add env vars for each environment:
 
-```yaml
-environments:
-  production:
-    url: https://myapp.com
-    token: ${INFORMANT_PRODUCTION_TOKEN}
-  staging:
-    url: https://staging.myapp.com
-    token: ${INFORMANT_STAGING_TOKEN}
+```bash
+export INFORMANT_PRODUCTION_URL=https://myapp.com
+export INFORMANT_PRODUCTION_TOKEN=<token>
+export INFORMANT_STAGING_URL=https://staging.myapp.com
+export INFORMANT_STAGING_TOKEN=<token>
 ```
 
 ### Tools

data/lib/generators/rails_informant/skill/templates/informant-alerts.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# Informant: Check for unresolved production errors on Claude Code startup.
+# Requires: curl, jq
+# Env vars: INFORMANT_PRODUCTION_URL, INFORMANT_PRODUCTION_TOKEN
+#           INFORMANT_PRODUCTION_PATH_PREFIX (optional, default: /informant)
+
+set -euo pipefail
+
+# Silent exit if env vars are missing or URL is not HTTPS
+[[ -z "${INFORMANT_PRODUCTION_URL:-}" ]] && exit 0
+[[ -z "${INFORMANT_PRODUCTION_TOKEN:-}" ]] && exit 0
+[[ "$INFORMANT_PRODUCTION_URL" == https://* ]] || exit 0
+
+# Silent exit if jq is not installed
+command -v jq >/dev/null 2>&1 || exit 0
+
+path_prefix="${INFORMANT_PRODUCTION_PATH_PREFIX:-/informant}"
+url="${INFORMANT_PRODUCTION_URL}${path_prefix}/api/v1/status"
+
+# Fetch status (silent on failure)
+response=$(curl -s -f \
+  --connect-timeout 3 \
+  --max-time 5 \
+  -H @- \
+  "$url" <<< "Authorization: Bearer ${INFORMANT_PRODUCTION_TOKEN}" \
+  2>/dev/null) || exit 0
+
+# Parse unresolved count
+unresolved=$(echo "$response" | jq -r '.unresolved_count // 0') || exit 0
+[[ "$unresolved" -eq 0 ]] && exit 0
+
+# Format error summary
+label="error"
+[[ "$unresolved" -gt 1 ]] && label="errors"
+echo "🚨 Informant: ${unresolved} unresolved ${label} in production"
+
+echo "$response" | jq -r '
+  .top_errors[]? |
+  "  - \(.error_class) (\(.total_occurrences) \(if .total_occurrences == 1 then "occurrence" else "occurrences" end))"
+' 2>/dev/null || true

data/lib/generators/rails_informant/skill_generator.rb

@@ -9,6 +9,11 @@ module RailsInformant
       copy_file "SKILL.md", ".claude/skills/informant/SKILL.md"
     end
 
+    def copy_hook_script
+      copy_file "informant-alerts.sh", ".claude/hooks/informant-alerts.sh"
+      chmod ".claude/hooks/informant-alerts.sh", 0o755
+    end
+
     def create_or_update_mcp_json
       mcp_path = File.join(destination_root, ".mcp.json")
       informant_entry = { "command" => "informant-mcp" }
@@ -27,14 +32,43 @@ module RailsInformant
       say "Could not parse existing .mcp.json — skipping merge. Add the informant server manually.", :red
     end
 
+    def create_or_update_settings_json
+      settings_path = File.join(destination_root, ".claude", "settings.json")
+      hook_command = ".claude/hooks/informant-alerts.sh"
+
+      if File.exist?(settings_path)
+        existing = JSON.parse(File.read(settings_path))
+        existing["hooks"] ||= {}
+        existing["hooks"]["SessionStart"] ||= []
+
+        already_registered = existing["hooks"]["SessionStart"].any? do |entry|
+          entry["hooks"]&.any? { it["command"] == hook_command }
+        end
+
+        unless already_registered
+          existing["hooks"]["SessionStart"] << session_start_hook(hook_command)
+        end
+
+        create_file ".claude/settings.json", JSON.pretty_generate(existing) + "\n", force: true
+      else
+        create_file ".claude/settings.json", JSON.pretty_generate(
+          "hooks" => { "SessionStart" => [ session_start_hook(hook_command) ] }
+        ) + "\n"
+      end
+    rescue JSON::ParserError
+      say "Could not parse existing .claude/settings.json — skipping hook setup.", :red
+    end
+
     def print_next_steps
       say ""
       say "Claude Code integration installed!", :green
       say ""
       say "  Created .mcp.json"
       say "  Created .claude/skills/informant/SKILL.md"
+      say "  Created .claude/hooks/informant-alerts.sh"
+      say "  Created .claude/settings.json (SessionStart hook)"
       say ""
-      say "Next step — set env vars so the MCP server can reach your app.", :yellow
+      say "Next step — set env vars so the MCP server and startup alerts can reach your app.", :yellow
       say "Add to your .envrc (or export manually):"
       say ""
       say "  export INFORMANT_PRODUCTION_URL=https://your-app.com"
@@ -43,6 +77,18 @@ module RailsInformant
       say "The token must match rails_informant.api_token in your Rails credentials."
       say "Add .envrc to .gitignore — it contains secrets."
       say ""
+      say "Optional: install jq for startup error alerts (brew install jq)", :cyan
+    end
+
+    private
+
+    def session_start_hook(command)
+      {
+        "matcher" => "startup",
+        "hooks" => [
+          { "type" => "command", "command" => command, "timeout" => 10 }
+        ]
+      }
     end
   end
 end

data/lib/rails_informant/mcp/configuration.rb

@@ -1,16 +1,12 @@
-require "yaml"
-
 module RailsInformant
   module Mcp
     class Configuration
-      CONFIG_PATH = File.expand_path("~/.config/informant-mcp.yml").freeze
-
-      attr_reader :allow_insecure
-
       def initialize(allow_insecure: false)
         @allow_insecure = allow_insecure
-        @environments = load_environments
+        @environments = load_from_env_vars
         @clients = {}
+
+        raise "No environments configured. Set INFORMANT_<ENV>_URL and INFORMANT_<ENV>_TOKEN environment variables." if @environments.empty?
       end
 
       def default_environment
@@ -34,12 +30,6 @@ module RailsInformant
 
       private
 
-      def load_environments
-        envs = load_from_yaml.merge(load_from_env_vars)
-        raise "No environments configured. Set INFORMANT_<ENV>_URL and INFORMANT_<ENV>_TOKEN environment variables, or create ~/.config/informant-mcp.yml" if envs.empty?
-        envs
-      end
-
       def load_from_env_vars
         ENV.each_with_object({}) do |(key, _), envs|
           next unless (match = key.match(/\AINFORMANT_(.+)_URL\z/))
@@ -52,39 +42,6 @@ module RailsInformant
           }
         end
       end
-
-      def load_from_yaml
-        path = CONFIG_PATH
-        return {} unless File.exist?(path)
-
-        reject_insecure_permissions(path)
-
-        yaml = YAML.safe_load_file(path)
-        return {} unless yaml.is_a?(Hash) && yaml["environments"].is_a?(Hash)
-
-        yaml["environments"].each_with_object({}) do |(name, config), envs|
-          next unless config.is_a?(Hash)
-          envs[name] = { path_prefix: config["path_prefix"], token: interpolate(config["token"]), url: config["url"] }
-        end
-      end
-
-      def reject_insecure_permissions(path)
-        mode = File.stat(path).mode
-        return unless mode & 0o077 != 0
-
-        message = "#{path} has insecure permissions (#{format('%04o', mode & 0o7777)}). Run: chmod 600 #{path}"
-
-        if @allow_insecure
-          warn "[RailsInformant] WARNING: #{message}"
-        else
-          raise "[RailsInformant] #{message} (use --allow-insecure to override)"
-        end
-      end
-
-      def interpolate(value)
-        return value unless value.is_a?(String)
-        value.gsub(/\$\{(INFORMANT_\w+)\}/) { ENV[$1] || "" }
-      end
     end
   end
 end

data/lib/rails_informant/middleware/error_capture.rb

@@ -6,9 +6,11 @@ module RailsInformant
       end
 
       def call(env)
-        @app.call(env).tap do
-          if (exception = env["rails_informant.rescued_exception"])
-            record_exception(exception, env: env)
+        @app.call(env).tap do |status, _headers, _body|
+          # Only record rescued exceptions that resulted in a server error.
+          # 4xx responses are expected application errors handled by ShowExceptions.
+          if (exception = env["rails_informant.rescued_exception"]) && status.to_i >= 500
+            record_exception exception, env:
           end
         end
       rescue StandardError => exception

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-informant
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Daniel López Prat
@@ -127,6 +127,7 @@ files:
 - 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
 - lib/generators/rails_informant/templates/initializer.rb.erb