activerabbit-cli 1.0.0

data/lib/activerabbit/cli.rb

@@ -0,0 +1,323 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module ActiveRabbit
+  # Main CLI entry: parses global options (--json, --md, --app, etc.) and dispatches to commands.
+  class CLI
+    def initialize(argv = ARGV)
+      @argv = argv.dup
+      @format = "human"
+      @app = nil
+      @base_url = nil
+      parse_global_options!
+    end
+
+    def run
+      cmd = @argv.shift
+      case cmd
+      when "login" then run_login
+      when "apps" then run_apps
+      when "use-app", "use" then run_use_app
+      when "status" then run_status
+      when "incidents", "errors" then run_incidents
+      when "show" then run_show_incident
+      when "explain" then run_explain
+      when "trace" then run_trace
+      when "deploy-check" then run_deploy_check
+      when "doctor" then run_doctor
+      when "version", "-v", "--version" then run_version
+      when "help", "-h", "--help", nil then run_help
+      else
+        $stderr.puts "activerabbit: unknown command '#{cmd}'"
+        $stderr.puts "Run 'activerabbit help' for usage."
+        exit 1
+      end
+    end
+
+    private
+
+    def parse_global_options!
+      parser = OptionParser.new do |opts|
+        opts.on("--json", "Machine-readable JSON output") { @format = "json" }
+        opts.on("--md", "Markdown output (Slack/GitHub)") { @format = "md" }
+        opts.on("--app=NAME", "App slug (overrides config)") { |v| @app = v }
+        opts.on("--project-id=ID", "Project ID (legacy, same as --app)") { |v| @app = v }
+        opts.on("--base-url=URL", "API base URL") { |v| @base_url = v }
+      end
+      parser.order!(@argv)
+    end
+
+    def config
+      @config ||= Config.new(default_app: @app, base_url: @base_url)
+    end
+
+    def client
+      @client ||= ApiClient.new(config)
+    end
+
+    def output(payload)
+      puts Formatters.format(payload, @format)
+    end
+
+    # --- Login ---
+
+    def run_login
+      opts = {}
+      parser = OptionParser.new do |o|
+        o.on("--api-key=KEY", "API key (project token)") { |v| opts[:api_key] = v }
+        o.on("--base-url=URL") { |v| opts[:base_url] = v }
+        o.on("--app=NAME") { |v| opts[:default_app] = v }
+        o.on("--project-id=ID") { |v| opts[:default_app] = v }
+      end
+      parser.parse!(@argv)
+
+      api_key = opts[:api_key] || ENV["ACTIVERABBIT_API_KEY"]
+      if api_key.to_s.strip == ""
+        $stderr.print "API key (X-Project-Token): "
+        api_key = $stdin.gets&.to_s&.strip
+      end
+      if api_key.to_s.strip == ""
+        $stderr.puts "Login aborted (no API key)."
+        exit 1
+      end
+
+      config.save!(api_key: api_key, base_url: opts[:base_url], default_app: opts[:default_app])
+
+      puts UI.c("Logged in.", :green)
+      puts "Config saved to #{config.config_path}"
+      puts "Default app: #{config.default_app || "(not set)"}"
+    end
+
+    # --- Apps ---
+
+    def run_apps
+      require_auth!
+      payload = client.list_apps
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    def run_use_app
+      app_name = @argv.shift
+      if app_name.to_s.strip == ""
+        $stderr.puts "Usage: activerabbit use-app <app-slug>"
+        $stderr.puts "Run 'activerabbit apps' to see available apps."
+        exit 1
+      end
+
+      config.save!(default_app: app_name)
+      puts UI.c("Default app set to #{app_name}", :green)
+    end
+
+    # --- Status ---
+
+    def run_status
+      ensure_app_selected!
+      payload = client.project_status
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    # --- Incidents ---
+
+    def run_incidents
+      ensure_app_selected!
+      limit = 10
+      OptionParser.new do |o|
+        o.on("--limit=N", Integer) { |n| limit = n }
+      end.parse!(@argv)
+      payload = client.incidents(limit: limit)
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    def run_show_incident
+      ensure_app_selected!
+      incident_id = @argv.shift
+      if incident_id.to_s.strip == ""
+        $stderr.puts "Usage: activerabbit show <incident-id>"
+        $stderr.puts "Example: activerabbit show inc_abc123"
+        exit 1
+      end
+      payload = client.incident_detail(incident_id)
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    # --- Explain ---
+
+    def run_explain
+      ensure_app_selected!
+      incident_id = @argv.shift
+      if incident_id.to_s.strip == ""
+        $stderr.puts "Usage: activerabbit explain <incident-id>"
+        $stderr.puts "Example: activerabbit explain inc_abc123"
+        exit 1
+      end
+      payload = client.explain_incident(incident_id)
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    # --- Trace ---
+
+    def run_trace
+      ensure_app_selected!
+      endpoint_or_id = @argv.shift
+      if endpoint_or_id.to_s.strip == ""
+        $stderr.puts "Usage: activerabbit trace <endpoint-or-trace-id>"
+        $stderr.puts "Example: activerabbit trace /jobs"
+        $stderr.puts "Example: activerabbit trace tr_xyz789"
+        exit 1
+      end
+      payload = client.trace(endpoint_or_id)
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    # --- Deploy check ---
+
+    def run_deploy_check
+      ensure_app_selected!
+      payload = client.deploy_check
+      output(payload)
+    rescue ApiClient::Unauthorized, ApiClient::NotFound, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    # --- Doctor ---
+
+    def run_doctor
+      payload = Commands::Doctor.run(config, client)
+      output(payload)
+    rescue ApiClient::NetworkError => e
+      payload = {
+        "project" => config.effective_app,
+        "generated_at" => Time.now.utc.iso8601,
+        "command" => "doctor",
+        "data" => {
+          "config_ok" => config.configured?,
+          "api_ok" => false,
+          "app_ok" => config.app_configured?,
+          "message" => e.message
+        }
+      }
+      output(payload)
+    end
+
+    # --- Version / Help ---
+
+    def run_version
+      puts "activerabbit #{ActiveRabbit::VERSION}"
+    end
+
+    def run_help
+      puts <<~HELP
+        #{UI.c("activerabbit", :bold)} — CLI for ActiveRabbit.ai
+
+        #{UI.c("Commands:", :bold)}
+          login              Save API key (interactive or --api-key)
+          apps               List available apps
+          use-app <slug>     Set default app
+          status             App health snapshot (errors, p95, deploy, top issue)
+          incidents [--limit N]  List incidents (alias: errors)
+          show <id>          Show incident details
+          explain <id>       AI summary and suggested fix for an incident
+          trace <endpoint|trace-id>  Trace analysis
+          deploy-check       Check if safe to deploy
+          doctor             Verify config and API connectivity
+          version            Show version
+          help               This message
+
+        #{UI.c("Global options (before command):", :bold)}
+          --json             Machine-readable JSON (for scripts/agents)
+          --md               Markdown (Slack, GitHub comments)
+          --app=NAME         Override default app
+          --base-url=URL     Override API base URL
+
+        #{UI.c("Environment:", :bold)}
+          ACTIVERABBIT_API_KEY    API token
+          ACTIVERABBIT_BASE_URL   API base URL (default: https://app.activerabbit.ai)
+          ACTIVERABBIT_APP        Default app slug
+
+        #{UI.c("Examples:", :bold)}
+          activerabbit login --api-key YOUR_TOKEN
+          activerabbit apps
+          activerabbit use-app jobsgpt-prod
+          activerabbit status
+          activerabbit incidents --limit 5
+          activerabbit show inc_abc123
+          activerabbit --json explain inc_abc123
+          activerabbit trace /jobs
+      HELP
+    end
+
+    # --- Helpers ---
+
+    def require_auth!
+      return if config.configured?
+
+      $stderr.puts "Not logged in. Run 'activerabbit login' or set ACTIVERABBIT_API_KEY."
+      exit 1
+    end
+
+    def ensure_app_selected!
+      require_auth!
+      return if config.app_configured?
+
+      prompt_app_selection
+    end
+
+    def prompt_app_selection
+      payload = client.list_apps
+      apps = payload.dig("data", "apps") || []
+      if apps.empty?
+        $stderr.puts "No apps found. Create one at https://app.activerabbit.ai"
+        exit 1
+      end
+
+      if apps.size == 1
+        app = apps.first
+        config.save!(default_app: app["slug"])
+        $stderr.puts UI.c("Using app: #{app["name"]} (#{app["slug"]})", :cyan)
+        return
+      end
+
+      $stderr.puts ""
+      $stderr.puts UI.c("Multiple apps found. Select one:", :bold)
+      apps.each_with_index do |app, idx|
+        env_badge = app["environment"] == "production" ? UI.c("prod", :green) : UI.c(app["environment"], :gray)
+        errors = app["error_count_24h"].to_i > 0 ? UI.c("#{app["error_count_24h"]} errors", :red) : UI.c("0 errors", :gray)
+        $stderr.puts "  #{UI.c("#{idx + 1})", :cyan)} #{app["name"]} #{env_badge} — #{errors}"
+      end
+      $stderr.puts ""
+      $stderr.print UI.c("Choice [1-#{apps.size}]: ", :bold)
+
+      input = $stdin.gets&.to_s&.strip
+      idx = input.to_i - 1
+      if idx < 0 || idx >= apps.size
+        $stderr.puts "Invalid choice."
+        exit 1
+      end
+
+      selected = apps[idx]
+      config.save!(default_app: selected["slug"])
+      $stderr.puts UI.c("Default app set to #{selected["slug"]}", :green)
+      $stderr.puts ""
+    rescue ApiClient::Unauthorized, ApiClient::NetworkError => e
+      error_exit(e.message)
+    end
+
+    def error_exit(message)
+      $stderr.puts "activerabbit: #{message}"
+      exit 1
+    end
+  end
+end

data/lib/activerabbit/commands.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "time"
+
+module ActiveRabbit
+  module Commands
+    # doctor: verify config, API connectivity, and app access.
+    module Doctor
+      def self.run(config, client)
+        config_ok = config.configured?
+        app_ok = config.app_configured?
+        api_ok = false
+        message = ""
+
+        if !config_ok
+          message = "Run 'activerabbit login' or set ACTIVERABBIT_API_KEY."
+        else
+          begin
+            client.list_apps
+            api_ok = true
+            if app_ok
+              message = "All checks passed."
+            else
+              message = "API connected. Run 'activerabbit apps' to select an app."
+            end
+          rescue ApiClient::Unauthorized
+            message = "API key invalid or revoked. Check token in settings."
+          rescue ApiClient::NotFound
+            api_ok = true
+            message = "API key valid. CLI endpoints may not be deployed yet (mock data used)."
+          rescue ApiClient::NetworkError => e
+            message = "Network error: #{e.message}"
+          end
+        end
+
+        {
+          "project" => config.effective_app,
+          "generated_at" => Time.now.utc.iso8601,
+          "command" => "doctor",
+          "data" => {
+            "config_ok" => config_ok,
+            "api_ok" => api_ok,
+            "app_ok" => app_ok,
+            "message" => message
+          }
+        }
+      end
+    end
+  end
+end

data/lib/activerabbit/config.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "fileutils"
+
+module ActiveRabbit
+  # Config resolution: CLI flags > env vars > config file.
+  # Config file: ~/.config/activerabbit/config.yml
+  # Stores: api_key, base_url, default_app (slug), project_id (legacy/override)
+  class Config
+    CONFIG_DIR = ENV.fetch("ACTIVERABBIT_CONFIG_DIR", nil) || File.join(Dir.home, ".config", "activerabbit")
+    CONFIG_FILE = File.join(CONFIG_DIR, "config.yml")
+
+    attr_accessor :api_key, :base_url, :project_id, :default_app
+
+    def initialize(api_key: nil, base_url: nil, project_id: nil, default_app: nil)
+      @api_key     = api_key || ENV["ACTIVERABBIT_API_KEY"]
+      @base_url    = base_url || ENV["ACTIVERABBIT_BASE_URL"]
+      @project_id  = project_id || ENV["ACTIVERABBIT_PROJECT_ID"]
+      @default_app = default_app || ENV["ACTIVERABBIT_APP"]
+      load_file!
+      @base_url = normalize_base_url(@base_url) if @base_url
+    end
+
+    def load_file!
+      return unless File.file?(CONFIG_FILE)
+
+      data = YAML.safe_load_file(CONFIG_FILE)
+      return unless data.is_a?(Hash)
+
+      @api_key     ||= data["api_key"]
+      @base_url    ||= data["base_url"]
+      @project_id  ||= data["project_id"]
+      @default_app ||= data["default_app"]
+      @base_url = normalize_base_url(@base_url) if @base_url
+    end
+
+    def save!(api_key: nil, base_url: nil, project_id: nil, default_app: nil)
+      @api_key     = api_key if api_key
+      @base_url    = base_url if base_url
+      @project_id  = project_id if project_id
+      @default_app = default_app if default_app
+      @base_url = normalize_base_url(@base_url) if @base_url
+
+      FileUtils.mkdir_p(File.dirname(CONFIG_FILE))
+      File.write(CONFIG_FILE, to_yaml, perm: 0o600)
+    end
+
+    def to_yaml
+      {
+        "api_key" => @api_key,
+        "base_url" => @base_url,
+        "project_id" => @project_id,
+        "default_app" => @default_app
+      }.compact.to_yaml
+    end
+
+    def configured?
+      api_key.to_s.strip != ""
+    end
+
+    def app_configured?
+      configured? && (default_app.to_s.strip != "" || project_id.to_s.strip != "")
+    end
+
+    # For backward compat: project_configured? = app_configured?
+    alias project_configured? app_configured?
+
+    def effective_app
+      default_app.to_s.strip != "" ? default_app : project_id
+    end
+
+    def config_path
+      CONFIG_FILE
+    end
+
+    private
+
+    def normalize_base_url(url)
+      return nil if url.nil? || url.to_s.strip == ""
+
+      u = url.to_s.strip
+      u = "https://#{u}" unless u.start_with?("http://", "https://")
+      u.chomp("/")
+    end
+  end
+end