nurse_andrea 0.2.1 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43221daa0087ee909cc91fd846732ac477aeb2675d56ba02ecd7e3b301e808d7
-  data.tar.gz: 519daf63d6c80e238fe943d4a08f2bfba4ba365f9d5fa7492512e1df099a29f7
+  metadata.gz: 7af261428fe8313fb24aa0c2a90ba94a14791040d1c83cd3bb52ee743f6a3e58
+  data.tar.gz: 0ef0cb18d33855bf8c510cc7da7ced9e0bfc7d67603add9bc739e1cb7b3809a0
 SHA512:
-  metadata.gz: cd67cf5a3418cc74ec896ba1df43f62b3add0a2e266ae65aad02c2bb4f85d03c3cad4477352569fdaa568e5cae902829efe2e117fb7389cec3428a9054d429d1
-  data.tar.gz: 91dc589d97a93d19814cd0ad5b0eb27e9d3c097ef8bc7ecbd130187ea96f9d973577e7009abe2ff9295027fd57aae1bd2102e1422a7941295a50c628bd310d9e
+  metadata.gz: 4e7b22b9c82fb8f952148d7b5c30ba0cee5714f2b596631f5f89ef6618887a6cd86f4556ec456811b68eae92be802a32eb9cc86f360d93c5f9bba68dfe3e5385
+  data.tar.gz: 5c28c6a373e0c22582006ddfe5a237a5b99e57efc2f37bb786985db5a724d07894443891846043f5e29b41debde88cf969372e477fc4f80575d1cd81b02a6025

data/lib/nurse_andrea/configuration.rb

@@ -6,7 +6,8 @@ module NurseAndrea
                   :sdk_version, :sdk_language,
                   :hooks_enabled, :hooks_database, :hooks_cache,
                   :hooks_jobs, :hooks_mailer, :hook_interval_ms,
-                  :platform_detection, :service_discovery, :auto_connect
+                  :platform_detection, :service_discovery, :auto_connect,
+                  :disable_continuous_scan, :continuous_scan_interval
 
     LOG_LEVELS   = { debug: 0, info: 1, warn: 2, error: 3, fatal: 4 }.freeze
     DEFAULT_HOST = "https://nurseandrea.io"
@@ -33,6 +34,8 @@ module NurseAndrea
       @platform_detection = true
       @service_discovery  = true
       @auto_connect       = false
+      @disable_continuous_scan  = false
+      @continuous_scan_interval = 5 * 60  # seconds
     end
 
     alias_method :token,  :api_key
@@ -43,6 +46,7 @@ module NurseAndrea
     def metrics_url   = "#{normalised_host}/api/v1/metrics"
     def traces_url    = "#{normalised_host}/api/v1/traces"
     def handshake_url = "#{normalised_host}/api/v1/handshake"
+    def deploy_url    = "#{normalised_host}/api/v1/deploy"
 
     def enabled?
       @enabled

data/lib/nurse_andrea/continuous_scanner.rb

@@ -0,0 +1,92 @@
+# PRIVACY: Same guarantees as ManagedServiceScanner — only derived
+# metadata is transmitted, never raw env values. See
+# DATA_PRIVACY_POLICY.rb for the full policy.
+#
+# Periodically re-runs the env-based discovery scan so dependencies
+# added after boot (new env vars, services attached to running
+# instances, configuration reloads) eventually surface as
+# discoveries on the workspace dashboard.
+#
+# Properties guaranteed by the contract below:
+#   * Non-blocking — runs on a dedicated background thread, never on
+#     the request path.
+#   * Bounded — only one thread; calling start! twice is a no-op.
+#   * Fail-safe — any error inside the scan is swallowed; the host
+#     application never crashes from a discovery error.
+#   * Self-aware — short-circuits when SelfFilter.platform_self?
+#     because every URL would be NurseAndrea's own infra.
+#   * Stoppable — explicit stop! signals the thread to exit at the
+#     next sleep boundary; configuration.disable_continuous_scan
+#     prevents start! from creating the thread at all.
+#
+# Fork-safety note: the thread does NOT survive Process._fork (Puma
+# clustered mode, Sidekiq workers). If the host forks after boot, the
+# parent's scanner thread is gone and a new one is not auto-started.
+# Address in a follow-up if it shows up in practice — for one-off
+# webservers and single-process deployments the current design is
+# sufficient.
+
+module NurseAndrea
+  class ContinuousScanner
+    @thread = nil
+    @stop   = false
+    @mutex  = Mutex.new
+
+    class << self
+      attr_reader :thread
+
+      def start!
+        @mutex.synchronize do
+          return if @thread&.alive?
+          return if NurseAndrea.config.disable_continuous_scan
+
+          @stop   = false
+          @thread = Thread.new { run_loop }
+          @thread.name = "nurse_andrea_continuous_scanner"
+        end
+      end
+
+      def stop!
+        @mutex.synchronize do
+          @stop = true
+        end
+        @thread&.wakeup rescue nil
+        @thread&.join(2)
+        @thread = nil
+      end
+
+      def running?
+        @thread&.alive? == true
+      end
+
+      # Public so specs can call it without spinning the loop.
+      def rescan_safely
+        return if NurseAndrea::SelfFilter.platform_self?
+
+        discoveries = NurseAndrea::ManagedServiceScanner.scan
+        return if discoveries.empty?
+
+        # Only push new items — ManagedServiceScanner already dedups
+        # by (type, tech, provider) within a single call, so we just
+        # need to avoid resubmitting items already queued for the
+        # current flush.
+        existing_keys = NurseAndrea.component_discoveries.map { |d| [ d[:type], d[:tech], d[:provider] ] }
+        discoveries.reject! { |d| existing_keys.include?([ d[:type], d[:tech], d[:provider] ]) }
+        NurseAndrea.component_discoveries.concat(discoveries) if discoveries.any?
+      rescue => e
+        NurseAndrea.debug("[ContinuousScanner] error: #{e.class}: #{e.message}")
+      end
+
+      private
+
+      def run_loop
+        interval = NurseAndrea.config.continuous_scan_interval
+        until @stop
+          sleep interval
+          break if @stop
+          rescan_safely
+        end
+      end
+    end
+  end
+end

data/lib/nurse_andrea/deploy.rb

@@ -0,0 +1,35 @@
+module NurseAndrea
+  # Public: ship a deploy event to the NurseAndrea backend so the
+  # dashboard can render it as a vertical marker on time-series charts
+  # and as a chip in the recent-deploys strip.
+  #
+  # Fire-and-forget: any failure (no token, network error, non-2xx) is
+  # logged in debug mode and swallowed so the host application never
+  # crashes from a deploy notification.
+  module Deploy
+    DESCRIPTION_LIMIT = 500
+
+    def self.call(version:, deployer: nil, environment: "production", description: nil)
+      return false unless NurseAndrea.config.valid?
+      return false if version.to_s.strip.empty?
+
+      payload = {
+        version:     version.to_s,
+        deployer:    deployer,
+        environment: environment,
+        description: description.is_a?(String) ? description[0, DESCRIPTION_LIMIT] : description,
+        deployed_at: Time.now.utc.iso8601
+      }.compact
+
+      HttpClient.new.post(NurseAndrea.config.deploy_url, payload)
+    rescue => e
+      NurseAndrea.debug("[NurseAndrea] deploy() error: #{e.class}: #{e.message}")
+      false
+    end
+  end
+
+  # Convenience top-level: NurseAndrea.deploy(version: "1.4.2")
+  def self.deploy(**kwargs)
+    Deploy.call(**kwargs)
+  end
+end

data/lib/nurse_andrea/instrumentation_subscriber.rb

@@ -14,7 +14,7 @@ module NurseAndrea
       "cache_delete.active_support" => :on_cache_delete,
       "perform.active_job"          => :on_job_perform,
       "enqueue.active_job"          => :on_job_enqueue,
-      "deliver.action_mailer"       => :on_mailer,
+      "deliver.action_mailer"       => :on_mailer
     }.freeze
 
     attr_reader :telemetry, :discovered_components
@@ -48,13 +48,14 @@ module NurseAndrea
       return if event.payload[:name] == "SCHEMA"
       return if event.payload[:name]&.start_with?("EXPLAIN")
 
-      adapter = event.payload[:connection]&.adapter_name rescue nil
+      conn    = event.payload[:connection]
+      adapter = conn&.adapter_name rescue nil
 
       # Skip platform's own ClickHouse queries — not the customer's infrastructure
       return if adapter&.downcase&.include?("clickhouse")
 
       tech = adapter_to_tech(adapter)
-      register_discovery("database", tech) if tech
+      register_discovery("database", tech, connection: conn) if tech
 
       table = extract_table(event.payload[:sql])
       @telemetry.record_query(duration_ms: event.duration, table: table)
@@ -100,8 +101,9 @@ module NurseAndrea
       register_discovery("external", "email")
     end
 
-    def register_discovery(type, tech)
+    def register_discovery(type, tech, connection: nil)
       return if tech.nil? || tech.empty? || tech == "unknown"
+      return if self_referential?(connection)
 
       key = "#{type}:#{tech}"
       return if @discovered_components.include?(key)
@@ -113,6 +115,20 @@ module NurseAndrea
       )
     end
 
+    # True when the SDK is running inside NurseAndrea itself, OR when
+    # the SQL event's connection points at NurseAndrea's own infra.
+    # Either way the discovery would be a self-reference, not a
+    # customer component. Process-level + connection-level checks are
+    # both consulted; the same module powers the env-scanner filter.
+    def self_referential?(connection)
+      return true if NurseAndrea::SelfFilter.platform_self?
+      return false unless connection
+
+      db_name = connection.current_database.to_s rescue ""
+      host    = connection.pool&.db_config&.host.to_s rescue ""
+      NurseAndrea::SelfFilter.host_matches?(db_name, host)
+    end
+
     def adapter_to_tech(adapter_name)
       case adapter_name&.downcase
       when "postgresql", "postgis" then "postgresql"

data/lib/nurse_andrea/managed_service_scanner.rb

@@ -15,15 +15,21 @@ module NurseAndrea
       "MONGODB_URI"       => "database",
       "MONGO_URL"         => "database",
       "ELASTICSEARCH_URL" => "search",
-      "KAFKA_BROKERS"     => "queue",
+      "KAFKA_BROKERS"     => "queue"
     }.freeze
 
     def self.scan
+      # Skip env-based discovery entirely when the SDK is loaded inside
+      # NurseAndrea itself — every URL we'd find belongs to the platform's
+      # own infrastructure, not a customer component.
+      return [] if NurseAndrea::SelfFilter.platform_self?
+
       discoveries = []
 
       SCAN_MAP.each do |var_name, component_type|
         url = ENV[var_name]
         next if url.nil? || url.strip.empty?
+        next if NurseAndrea::SelfFilter.host_matches?(url)
 
         tech     = Sanitizer.extract_tech(url)
         provider = Sanitizer.extract_provider(url)
@@ -39,7 +45,7 @@ module NurseAndrea
         discoveries << Sanitizer.sanitize_discovery(raw)
       end
 
-      discoveries.uniq { |d| [d[:type], d[:tech], d[:provider]] }
+      discoveries.uniq { |d| [ d[:type], d[:tech], d[:provider] ] }
     end
   end
 end

data/lib/nurse_andrea/platform_detector.rb

@@ -10,7 +10,7 @@ module NurseAndrea
       fly:          -> { ENV.key?("FLY_APP_NAME") },
       heroku:       -> { ENV.key?("DYNO") },
       digitalocean: -> { ENV.key?("DIGITALOCEAN_APP_PLATFORM_COMPONENT_NAME") },
-      vercel:       -> { ENV.key?("VERCEL") },
+      vercel:       -> { ENV.key?("VERCEL") }
     }.freeze
 
     def self.detect

data/lib/nurse_andrea/railtie.rb

@@ -45,6 +45,11 @@ module NurseAndrea
         discoveries = NurseAndrea::ManagedServiceScanner.scan
         NurseAndrea.component_discoveries.concat(discoveries)
         NurseAndrea.debug("[NurseAndrea] Discovered #{discoveries.size} managed services")
+
+        # Periodic rescan — picks up dependencies added after boot
+        # (env reloads, attached services). Respects
+        # disable_continuous_scan and SelfFilter short-circuit.
+        NurseAndrea::ContinuousScanner.start!
       end
 
       # Hook subscriptions (sql.active_record, cache_*, perform.active_job, etc.)
@@ -60,6 +65,7 @@ module NurseAndrea
     end
 
     at_exit do
+      NurseAndrea::ContinuousScanner.stop! rescue nil
       NurseAndrea::MemorySampler.stop rescue nil
       NurseAndrea::LogShipper.instance.flush! rescue nil
       NurseAndrea::MetricsShipper.instance.flush! rescue nil

data/lib/nurse_andrea/self_filter.rb

@@ -0,0 +1,39 @@
+# Suppresses discovery emission when the SDK is loaded inside
+# NurseAndrea itself. Both the InstrumentationSubscriber (hook-based)
+# and the ManagedServiceScanner (env-based) must consult this filter
+# before adding to NurseAndrea.component_discoveries — otherwise the
+# platform's own infrastructure shows up as proposed components on
+# every workspace dashboard.
+
+module NurseAndrea
+  module SelfFilter
+    SELF_INDICATORS = %w[nurseandrea nurse-andrea nurse_andrea].freeze
+
+    class << self
+      def platform_self?
+        return @platform_self if defined?(@platform_self)
+        @platform_self = compute_platform_self
+      end
+
+      def reset!
+        remove_instance_variable(:@platform_self) if defined?(@platform_self)
+      end
+
+      def host_matches?(*candidates)
+        candidates.compact.map(&:to_s).map(&:downcase).any? do |s|
+          SELF_INDICATORS.any? { |i| s.include?(i) }
+        end
+      end
+
+      private
+
+      def compute_platform_self
+        return false unless defined?(Rails) && Rails.application
+        app_name = Rails.application.class.module_parent_name.to_s.downcase
+        SELF_INDICATORS.any? { |i| app_name.include?(i) }
+      rescue
+        false
+      end
+    end
+  end
+end

data/lib/nurse_andrea/version.rb

@@ -1,3 +1,3 @@
 module NurseAndrea
-  VERSION = "0.2.1"
+  VERSION = "0.2.4"
 end

data/lib/nurse_andrea.rb

@@ -15,6 +15,9 @@ require "nurse_andrea/managed_service_scanner"
 require "nurse_andrea/component_telemetry"
 require "nurse_andrea/instrumentation_subscriber"
 require "nurse_andrea/memory_sampler"
+require "nurse_andrea/deploy"
+require "nurse_andrea/self_filter"
+require "nurse_andrea/continuous_scanner"
 
 require "nurse_andrea/railtie" if defined?(Rails::Railtie)
 require "nurse_andrea/engine"  if defined?(Rails::Engine)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nurse_andrea
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.4
 platform: ruby
 authors:
 - Ago AI LLC
@@ -28,6 +28,8 @@ files:
 - lib/nurse_andrea/backfill.rb
 - lib/nurse_andrea/component_telemetry.rb
 - lib/nurse_andrea/configuration.rb
+- lib/nurse_andrea/continuous_scanner.rb
+- lib/nurse_andrea/deploy.rb
 - lib/nurse_andrea/engine.rb
 - lib/nurse_andrea/http_client.rb
 - lib/nurse_andrea/instrumentation_subscriber.rb
@@ -43,6 +45,7 @@ files:
 - lib/nurse_andrea/queue_depth_reporter.rb
 - lib/nurse_andrea/railtie.rb
 - lib/nurse_andrea/sanitizer.rb
+- lib/nurse_andrea/self_filter.rb
 - lib/nurse_andrea/version.rb
 - nurse_andrea.gemspec
 homepage: https://nurseandrea.io