activerabbit-cli 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3a37cdfbd12a95561bee8ddd354ef1f2df2c1c913c90a6cc6a9735cb2917c021
+  data.tar.gz: 48b2e505b9ef3b2c60444104f8afaf20bfccec8e94414f3f4d4442b32550a11b
+SHA512:
+  metadata.gz: 0d278067e8c0ae78af59133ba4d2e633f8eef8e2d3e985be1775fc4f74b70020a3725a9ecd921bf54bb63e7e1d58dee30b837e41b39cb7fe2f2958daf2fc02b2
+  data.tar.gz: 7b307c5640e79b88f1c20f46b2bf4dd3c5796d9712a7b872fefe90ae8f02aeba20a3382924899533ccd8ca4fa61e0c107d9f46d33ba7f23d8cc11abf68b651a6

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to activerabbit-cli will be documented in this file.
+
+## [1.0.0] - 2025-02-25
+
+### Added
+- Initial release
+- `activerabbit login` — authenticate with API key
+- `activerabbit apps` — list available apps
+- `activerabbit use-app <slug>` — set default app
+- `activerabbit status` — app health snapshot
+- `activerabbit incidents` — list incidents with colorized severity and relative time
+- `activerabbit show <id>` — incident details with stack trace
+- `activerabbit explain <id>` — AI-powered root cause analysis
+- `activerabbit trace <endpoint>` — trace analysis with visual span bars
+- `activerabbit deploy-check` — pre-deploy safety check
+- `activerabbit doctor` — verify config and connectivity
+- Multi-app support with interactive selection
+- Output formats: human (default), `--json`, `--md`
+- Config file at `~/.config/activerabbit/config.yml`
+- Environment variable support: `ACTIVERABBIT_API_KEY`, `ACTIVERABBIT_APP`, `ACTIVERABBIT_BASE_URL`

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 ActiveRabbit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,170 @@
+# activerabbit-cli
+
+Production CLI for [ActiveRabbit.ai](https://activerabbit.ai): Rails/JS monitoring and AI-powered issue analysis.
+
+Optimized for:
+- **Developers** — fast terminal output with colors, relative times, visual bars
+- **AI agents** — deterministic `--json` output for scripts and automation
+- **CI/CD** — `--md` output for Slack/GitHub comments
+
+## Installation
+
+```bash
+gem install activerabbit-cli
+```
+
+This installs the `activerabbit` command.
+
+### From source
+
+```bash
+git clone https://github.com/activerabbit/activerabbit-cli.git
+cd activerabbit-cli
+gem build activerabbit-cli.gemspec
+gem install activerabbit-cli-1.0.0.gem
+```
+
+## Quick start
+
+```bash
+# 1. Login with your API key (from app.activerabbit.ai → Settings → API)
+activerabbit login --api-key YOUR_API_KEY
+
+# 2. List your apps
+activerabbit apps
+
+# 3. Select default app
+activerabbit use-app jobsgpt-prod
+
+# 4. Check status
+activerabbit status
+```
+
+Or use environment variables:
+
+```bash
+export ACTIVERABBIT_API_KEY=your_token
+export ACTIVERABBIT_APP=your-app-slug
+activerabbit incidents
+```
+
+## Commands
+
+| Command | Description |
+|--------|-------------|
+| `activerabbit login` | Authenticate with API key |
+| `activerabbit apps` | List available apps |
+| `activerabbit use-app <slug>` | Set default app |
+| `activerabbit status` | App health: errors (24h), p95 latency, deploy status, top issue |
+| `activerabbit incidents [--limit N]` | List incidents with severity, endpoint, count, relative time |
+| `activerabbit show <id>` | Incident details: stack trace, affected users, recent events |
+| `activerabbit explain <id>` | AI analysis: root cause, suggested fix, regression risk, tests |
+| `activerabbit trace <endpoint\|id>` | Trace analysis with visual span bars and bottlenecks |
+| `activerabbit deploy-check` | Pre-deploy safety check |
+| `activerabbit doctor` | Verify config and API connectivity |
+
+## Output formats
+
+Every command supports three output modes:
+
+| Flag | Use case |
+|------|----------|
+| *(default)* | Human-readable with colors, relative times, visual bars |
+| `--json` | Deterministic JSON for scripts, CI, AI agents |
+| `--md` | Markdown for Slack, GitHub comments, reports |
+
+**Note:** Global options must come **before** the command:
+
+```bash
+# Correct
+activerabbit --json incidents
+
+# Also works (command-specific flags after)
+activerabbit --json incidents --limit 5
+```
+
+## JSON shape
+
+All commands return an envelope like:
+
+```json
+{
+  "project": "project_id",
+  "generated_at": "2025-01-15T12:00:00Z",
+  "command": "explain",
+  "data": { ... }
+}
+```
+
+Example for `explain`:
+
+```json
+{
+  "project": "42",
+  "generated_at": "2025-01-15T12:00:00Z",
+  "command": "explain",
+  "data": {
+    "incident_id": "inc_123",
+    "severity": "high",
+    "title": "NoMethodError in JobsController#show",
+    "root_cause": "...",
+    "confidence_score": 0.87,
+    "affected_endpoints": ["/jobs", "/jobs/:id"],
+    "suggested_fix": "...",
+    "regression_risk": "medium",
+    "tests_to_run": ["spec/requests/jobs_spec.rb"],
+    "estimated_impact": "..."
+  }
+}
+```
+
+## CI / script example
+
+```bash
+# Fail deploy if project not healthy
+activerabbit status --json | jq -e '.data.health == "ok"' || exit 1
+
+# Post incident summary to Slack (e.g. from GitHub Actions)
+activerabbit explain "$INCIDENT_ID" --md > summary.md
+# Then upload summary.md to Slack
+```
+
+## Configuration
+
+Config priority (highest to lowest):
+
+1. CLI flags (`--app`, `--base-url`)
+2. Environment variables
+3. Config file (`~/.config/activerabbit/config.yml`)
+
+| Env var | Description |
+|---------|-------------|
+| `ACTIVERABBIT_API_KEY` | API token (required) |
+| `ACTIVERABBIT_APP` | Default app slug |
+| `ACTIVERABBIT_BASE_URL` | API URL (default: https://app.activerabbit.ai) |
+
+## CI/CD example
+
+```bash
+#!/bin/bash
+# Deploy gate: fail if app has critical errors
+
+status=$(activerabbit --json status)
+health=$(echo "$status" | jq -r '.data.health')
+
+if [ "$health" != "ok" ]; then
+  echo "Deploy blocked: app health is $health"
+  activerabbit incidents --limit 3
+  exit 1
+fi
+
+echo "App healthy, proceeding with deploy"
+```
+
+## Roadmap (v2)
+
+- GitHub PR integration — auto-comment with explain/deploy-check
+- Deploy diff — compare errors before/after deploy
+- MCP server — expose CLI to AI agents via Model Context Protocol
+- `activerabbit watch` — stream incidents in real-time
+- Webhook triggers — run CLI commands on new incidents

data/exe/activerabbit

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "activerabbit"
+
+ActiveRabbit::CLI.new(ARGV).run

data/lib/activerabbit/api_client.rb

@@ -0,0 +1,306 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+require "time"
+
+module ActiveRabbit
+  # HTTP client for ActiveRabbit API. Uses X-Project-Token (project API key).
+  # Designed so backend can add real endpoints (status, incidents, explain, traces) later;
+  # until then, uses mock responses when server returns 404 or endpoint is missing.
+  class ApiClient
+    DEFAULT_BASE_URL = "https://app.activerabbit.ai"
+    OPEN_TIMEOUT = 10
+    READ_TIMEOUT = 30
+
+    class Error < StandardError; end
+    class Unauthorized < Error; end
+    class NotFound < Error; end
+    class RateLimited < Error; end
+    class NetworkError < Error; end
+
+    def initialize(config)
+      @config = config
+      @base_url = (config.base_url.to_s.strip != "" ? config.base_url : DEFAULT_BASE_URL).to_s
+    end
+
+    def get(path, query = {})
+      uri = build_uri(path, query)
+      req = Net::HTTP::Get.new(uri)
+      request(uri, req)
+    end
+
+    def post(path, body = {})
+      uri = build_uri(path)
+      req = Net::HTTP::Post.new(uri)
+      req["Content-Type"] = "application/json"
+      req.body = body.is_a?(String) ? body : body.to_json
+      request(uri, req)
+    end
+
+    # --- API methods (return hashes; mock when backend not ready) ---
+
+    def list_apps
+      get("/api/v1/cli/apps")
+    end
+
+    def project_status(app = nil)
+      id = app || @config.effective_app
+      get("/api/v1/cli/apps/#{id}/status")
+    end
+
+    def incidents(app = nil, limit: 10)
+      id = app || @config.effective_app
+      get("/api/v1/cli/apps/#{id}/incidents", "limit" => limit)
+    end
+
+    def incident_detail(incident_id, app = nil)
+      id = app || @config.effective_app
+      get("/api/v1/cli/apps/#{id}/incidents/#{incident_id}")
+    end
+
+    def explain_incident(incident_id, app = nil)
+      id = app || @config.effective_app
+      get("/api/v1/cli/apps/#{id}/incidents/#{incident_id}/explain")
+    end
+
+    def trace(endpoint_or_trace_id, app = nil)
+      id = app || @config.effective_app
+      if endpoint_or_trace_id.include?("/") && !endpoint_or_trace_id.start_with?("tr_")
+        get("/api/v1/cli/apps/#{id}/traces", "endpoint" => endpoint_or_trace_id)
+      else
+        get("/api/v1/cli/apps/#{id}/traces/#{endpoint_or_trace_id}")
+      end
+    end
+
+    def deploy_check(app = nil)
+      id = app || @config.effective_app
+      get("/api/v1/cli/apps/#{id}/deploy_check")
+    end
+
+    private
+
+    def build_uri(path, query = {})
+      full = path.start_with?("http") ? path : "#{@base_url}#{path}"
+      uri = URI(full)
+      uri.query = URI.encode_www_form(query) if query.any?
+      uri
+    end
+
+    def request(uri, req)
+      req["X-Project-Token"] = @config.api_key
+      req["Accept"] = "application/json"
+      req["User-Agent"] = "activerabbit-cli/#{ActiveRabbit::VERSION}"
+
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https", open_timeout: OPEN_TIMEOUT, read_timeout: READ_TIMEOUT) do |http|
+        http.request(req)
+      end
+
+      handle_response(uri, res)
+    rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, SocketError, Net::OpenTimeout, Net::ReadTimeout => e
+      raise NetworkError, "Network error: #{e.message}"
+    end
+
+    def handle_response(uri, res)
+      body = res.body.to_s.strip
+      parsed = (body.empty? ? {} : JSON.parse(body)) rescue {}
+
+      case res.code.to_i
+      when 200, 201
+        parsed.is_a?(Hash) ? parsed : { "data" => parsed }
+      when 401
+        raise Unauthorized, parsed["message"] || "Invalid or missing API key"
+      when 404
+        # Return mock so CLI works before backend has CLI endpoints
+        mock_for(uri, res: res, parsed: parsed)
+      when 429
+        raise RateLimited, parsed["message"] || "Too many requests"
+      when 500..599
+        raise Error, parsed["message"] || "Server error (#{res.code})"
+      else
+        raise Error, parsed["message"] || "Request failed (#{res.code})"
+      end
+    end
+
+    def mock_for(uri, res:, parsed:)
+      path = uri.path
+      query = URI.decode_www_form(uri.query || "").to_h
+      if path =~ %r{/cli/apps$}
+        mock_apps
+      elsif path.include?("/status")
+        mock_status
+      elsif path.include?("/incidents") && !path.include?("/explain")
+        if path =~ %r{/incidents/([^/]+)$}
+          mock_incident_detail($1)
+        else
+          mock_incidents
+        end
+      elsif path.include?("/explain")
+        mock_explain(path)
+      elsif path.include?("/traces")
+        mock_trace(path, query)
+      elsif path.include?("/deploy_check")
+        mock_deploy_check
+      else
+        raise NotFound, parsed["message"] || "Not found"
+      end
+    end
+
+    def mock_apps
+      {
+        "generated_at" => Time.now.utc.iso8601,
+        "command" => "apps",
+        "data" => {
+          "apps" => [
+            { "slug" => "jobsgpt-prod", "name" => "JobsGPT Production", "environment" => "production", "error_count_24h" => 12 },
+            { "slug" => "activerabbit-marketing", "name" => "ActiveRabbit Marketing", "environment" => "production", "error_count_24h" => 0 },
+            { "slug" => "client-storefront", "name" => "Client Storefront", "environment" => "staging", "error_count_24h" => 3 }
+          ]
+        }
+      }
+    end
+
+    def mock_status
+      app = @config.effective_app || "default"
+      {
+        "project" => app,
+        "generated_at" => Time.now.utc.iso8601,
+        "command" => "status",
+        "data" => {
+          "app" => app,
+          "name" => "JobsGPT Production",
+          "health" => "ok",
+          "error_count_24h" => 12,
+          "p95_latency_ms" => 245,
+          "deploy_status" => "stable",
+          "last_deploy_at" => (Time.now - 3600).utc.iso8601,
+          "top_issue" => {
+            "id" => "inc_abc123",
+            "title" => "NoMethodError in JobsController#show",
+            "count" => 8,
+            "severity" => "high"
+          }
+        }
+      }
+    end
+
+    def mock_incidents
+      app = @config.effective_app || "default"
+      now = Time.now
+      {
+        "project" => app,
+        "generated_at" => now.utc.iso8601,
+        "command" => "incidents",
+        "data" => {
+          "incidents" => [
+            { "id" => "inc_abc123", "severity" => "high", "title" => "NoMethodError in JobsController#show", "endpoint" => "GET /jobs/:id", "count" => 127, "last_seen_at" => now.utc.iso8601, "first_seen_at" => (now - 86400).utc.iso8601, "status" => "open" },
+            { "id" => "inc_def456", "severity" => "medium", "title" => "ActiveRecord::RecordNotFound in UsersController#show", "endpoint" => "GET /users/:id", "count" => 42, "last_seen_at" => (now - 1800).utc.iso8601, "first_seen_at" => (now - 172800).utc.iso8601, "status" => "open" },
+            { "id" => "inc_ghi789", "severity" => "low", "title" => "Timeout::Error in ReportsController#export", "endpoint" => "POST /reports/export", "count" => 8, "last_seen_at" => (now - 7200).utc.iso8601, "first_seen_at" => (now - 259200).utc.iso8601, "status" => "wip" },
+            { "id" => "inc_jkl012", "severity" => "critical", "title" => "PG::ConnectionBad in ApplicationController", "endpoint" => "GET /dashboard", "count" => 3, "last_seen_at" => (now - 300).utc.iso8601, "first_seen_at" => (now - 600).utc.iso8601, "status" => "open" }
+          ]
+        }
+      }
+    end
+
+    def mock_incident_detail(incident_id)
+      app = @config.effective_app || "default"
+      now = Time.now
+      {
+        "project" => app,
+        "generated_at" => now.utc.iso8601,
+        "command" => "incident_detail",
+        "data" => {
+          "id" => incident_id,
+          "severity" => "high",
+          "status" => "open",
+          "title" => "NoMethodError in JobsController#show",
+          "exception_class" => "NoMethodError",
+          "message" => "undefined method `status' for nil:NilClass",
+          "endpoint" => "GET /jobs/:id",
+          "count" => 127,
+          "affected_users" => 45,
+          "first_seen_at" => (now - 86400).utc.iso8601,
+          "last_seen_at" => now.utc.iso8601,
+          "top_frame" => "app/controllers/jobs_controller.rb:42:in `show'",
+          "backtrace" => [
+            "app/controllers/jobs_controller.rb:42:in `show'",
+            "app/controllers/application_controller.rb:15:in `wrap_request'",
+            "config/initializers/activerabbit.rb:8:in `block in <main>'"
+          ],
+          "recent_events" => [
+            { "at" => now.utc.iso8601, "user_id" => "user_123", "request_id" => "req_abc" },
+            { "at" => (now - 60).utc.iso8601, "user_id" => "user_456", "request_id" => "req_def" },
+            { "at" => (now - 180).utc.iso8601, "user_id" => "user_789", "request_id" => "req_ghi" }
+          ],
+          "tags" => { "controller" => "JobsController", "action" => "show", "environment" => "production" }
+        }
+      }
+    end
+
+    def mock_explain(path)
+      parts = path.split("/")
+      idx = parts.index("incidents")
+      incident_id = idx ? parts[idx + 1] : "inc_unknown"
+      {
+        "project" => @config.project_id || "default",
+        "generated_at" => Time.now.utc.iso8601,
+        "command" => "explain",
+        "data" => {
+          "incident_id" => incident_id,
+          "severity" => "high",
+          "title" => "NoMethodError in JobsController#show",
+          "root_cause" => "Call to #status on nil when job was deleted or ID invalid.",
+          "confidence_score" => 0.87,
+          "affected_endpoints" => ["/jobs", "/jobs/:id"],
+          "suggested_fix" => "Add a guard: return head :not_found unless @job",
+          "regression_risk" => "medium",
+          "tests_to_run" => ["spec/requests/jobs_spec.rb", "spec/controllers/jobs_controller_spec.rb"],
+          "estimated_impact" => "Low; fix is localized to one action."
+        }
+      }
+    end
+
+    def mock_trace(path, query = {})
+      path_id = path.split("/").last
+      endpoint = query["endpoint"]
+      if endpoint.to_s.strip != ""
+        trace_id = "tr_mock"
+      else
+        trace_id = path_id
+        endpoint = path_id.start_with?("tr_") ? "/jobs" : path_id
+      end
+      endpoint = "/jobs" if endpoint.to_s.strip == ""
+      {
+        "project" => @config.project_id || "default",
+        "generated_at" => Time.now.utc.iso8601,
+        "command" => "trace",
+        "data" => {
+          "trace_id" => trace_id,
+          "endpoint" => endpoint,
+          "duration_ms" => 1250,
+          "spans" => [
+            { "name" => "JobsController#index", "duration_ms" => 1200, "percent" => 96 },
+            { "name" => "Job.load_all", "duration_ms" => 980, "percent" => 78 },
+            { "name" => "N+1 detected (job.user)", "duration_ms" => 450, "percent" => 36 }
+          ],
+          "bottlenecks" => ["N+1 on job.user", "Heavy serialization in index.json.jbuilder"]
+        }
+      }
+    end
+
+    def mock_deploy_check
+      {
+        "project" => @config.project_id || "default",
+        "generated_at" => Time.now.utc.iso8601,
+        "command" => "deploy_check",
+        "data" => {
+          "ready" => true,
+          "last_deploy_at" => (Time.now - 3600).utc.iso8601,
+          "new_errors_since_deploy" => 0,
+          "warnings" => []
+        }
+      }
+    end
+  end
+end