ask-honeybadger 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30842eefeba7cdd4bc71ad4958755872c84f36f935259717824d235f51ccac99
-  data.tar.gz: c177120c6ee8d243ad0559a935ffb66797aaa896f9cbd096725c3f5acd6e6a6a
+  metadata.gz: 18083370cefeff9d036b53bf1a6ac15ad030817b33f82b823a0967eb530bb811
+  data.tar.gz: 3353dc3b808a6263ea64f18f0822b26aea7820f736a471db470388ebc551c288
 SHA512:
-  metadata.gz: be92b43b9113fa04f1b378b53dcb6c39dd4ce4f6a4dd75dfee2567cd39ae79a57558c5b393fe6c2ec6f7913ae47c1ac7831f3680fc6cdb7d1596abc7db5fbadf
-  data.tar.gz: 6625078687f978f71a36bc32788200f4383f815d83d6ae42d0a7dc6586484c07e30585a8529442aa06ca0b4a47c0b375af86f264c13f094b86cda07cc27ed516
+  metadata.gz: ebc3912e26fcd986856a11715436f0528239843310cd37d1ee5849297a4de16d44b4e2d5859dffbc9829bf11279d96f1793f49943f98425f439f81404409592d
+  data.tar.gz: f3f4ee0ff4c3833c452d1d579eec626b64f49d5a56816f047059b1da82859f19db1a17a53f0bbc9e405b003fa1bb3a2fd12f6f875bf48f5e5d5e2e563bbb24e9

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.1.2] - 2026-06-25
+
+### Changed
+- Expanded tests: Client(10t), ErrorGuide(12t), Context(8t). Infrastructure: rubocop, overcommit, bin/setup, CI matrix, gemspec, SimpleCov.
 # Changelog
 
 ## v0.1.0 (2026-06-10)

data/lib/ask/honeybadger/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Honeybadger
-    VERSION = "0.1.0"
+    VERSION = "0.1.2"
   end
 end

data/lib/ask/skills/honeybadger.use_honeybadger/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: honeybadger.use_honeybadger
+description: How to navigate the Honeybadger Data API — fetch faults, projects, and error details
+---
+
+Use this skill when you need to interact with Honeybadger — reviewing error
+faults, checking project health, or debugging production issues.
+
+## Step 1: Get the Client
+
+```ruby
+client = Ask::Honeybadger.client
+```
+
+This returns an authenticated `Faraday::Connection` pointed at
+`https://app.honeybadger.io/v2`. It expects a valid Honeybadger API token
+resolved via `Ask::Auth.resolve(:honeybadger_token)`.
+
+## Step 2: Explore the Context
+
+```ruby
+Ask::Honeybadger::Context::DOCS_URL    # Honeybadger API docs
+Ask::Honeybadger::Context::QUICK_START # Copy-paste examples
+```
+
+The `QUICK_START` has examples for listing projects, faults, and fault details.
+
+## Step 3: Use Convenience Helpers First
+
+The gem ships with helpers for the most common operations:
+
+```ruby
+# List projects
+projects = Ask::Honeybadger.projects
+
+# Recent faults for a project
+faults = Ask::Honeybadger.recent_faults(project_id: "PROJECT_ID", limit: 10)
+
+# Fault summary (counts by environment, status)
+summary = Ask::Honeybadger.fault_summary(project_id: "PROJECT_ID")
+
+# Single fault details
+fault = Ask::Honeybadger.fault(project_id: "PROJECT_ID", fault_id: "FAULT_ID")
+```
+
+The client returns parsed JSON hashes. Use `Code` to inspect the response
+structure.
+
+## Step 4: Raw API Calls for Custom Needs
+
+For endpoints without convenience helpers, use the Faraday client directly:
+
+```ruby
+client = Ask::Honeybadger.client
+
+# GET request
+response = client.get("/v2/projects/PROJECT_ID/faults/FAULT_ID/notices")
+response.body
+
+# With query parameters
+response = client.get("/v2/projects/PROJECT_ID/faults", { q: "search term", order: "count" })
+response.body
+```
+
+The API is REST-based. All responses are automatically JSON-parsed (Faraday
+middleware handles this).
+
+## Step 5: Authentication & Common Errors
+
+```ruby
+Ask::Honeybadger::Errors.status_code_description(401)
+Ask::Honeybadger::Errors.status_code_description(429)
+```
+
+Common scenarios:
+- **401**: Token invalid or revoked → generate new token at Honeybadger settings
+- **404**: Wrong project ID → list projects first to get correct IDs
+- **429**: Rate limited → wait and retry (Faraday auto-retries 3 times)
+- **500/502/503**: Honeybadger server issue → Faraday auto-retries
+
+## Step 6: Fallback Strategy
+
+1. Reference `Ask::Honeybadger::Context::DOCS_URL` for the full API reference
+2. The Honeybadger API is REST + JSON — you can use any standard HTTP method
+3. List projects first to get correct IDs before querying faults

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-honeybadger
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Kaka Ruto
@@ -13,28 +13,28 @@ dependencies:
   name: ask-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
 - !ruby/object:Gem::Dependency
   name: ask-auth
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.1'
 - !ruby/object:Gem::Dependency
@@ -150,6 +150,7 @@ files:
 - lib/ask/honeybadger/context.rb
 - lib/ask/honeybadger/error_guide.rb
 - lib/ask/honeybadger/version.rb
+- lib/ask/skills/honeybadger.use_honeybadger/SKILL.md
 homepage: https://github.com/ask-rb/ask-honeybadger
 licenses:
 - MIT