ask-sentry 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc6dc184f307c3a0661dbc52d48c8caee86d7a5309ca627993cd37312686509f
-  data.tar.gz: 5e7484e41f6915948497575f26a28d681da5665fee6f796189498458f4bb1d09
+  metadata.gz: c459eb70d05be7c610124e9f19253867d23cb9e729b3bd091d710d95e6483a19
+  data.tar.gz: abcc7d0d55dcdda71dbb36217236e3f9f0055466d57be5d8b35f564db2f22c71
 SHA512:
-  metadata.gz: 4e2f9dce7c5a47978ecd41fe1696111472158c1e8e5c4f62db6b7d926483a91e8188267b8b27254e422d71d4e3a4831920020da7489a005cfdec816219c4a5d6
-  data.tar.gz: 3ef0390e2ffa88cc75fdb6b1df2260c1da15a1e5c05548e5f4547899fd05c761309db5b03408835b2c826d9de0c8db420ce54d4f19f53305ad246012e3b9e228
+  metadata.gz: 9dfde1d5ea4914ac95c0cf839c3a1d97a6be838d9df6977f3c811d12b4a38abb8fff42f7b47af9677afd25f6d6f9725144d066e0f673429c8e607720939e764d
+  data.tar.gz: 54d3a356e91e1f3ffb19fdf05b7d0840edd60ce86007cc5b2036adff7c7cdcd092b1a56e9e2c386d8ec5f5c43e6e54ff542a5087f019d4de11c7df7d77b40357

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.1.2] - 2026-06-25
+
+### Changed
+- Gemspec validation test. Infrastructure: rubocop, overcommit, bin/setup, CI matrix. VCR rake tasks.
 # Changelog
 
 ## 0.1.0 (2026-06-10)

data/lib/ask/sentry/version.rb

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

data/lib/ask/skills/sentry.use_sentry/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: sentry.use_sentry
+description: How to navigate the Sentry API — fetch issues, events, and error details
+---
+
+Use this skill when you need to interact with Sentry — reviewing error issues,
+checking event details, or debugging production errors.
+
+## Step 1: Get the Client
+
+```ruby
+client = Ask::Sentry.client
+```
+
+This returns an authenticated `Faraday::Connection` pointed at
+`https://sentry.io/api/0/`. It expects a valid Sentry auth token resolved
+via `Ask::Auth.resolve(:sentry_token)`.
+
+## Step 2: Explore the Context
+
+```ruby
+Ask::Sentry::Context::DOCS_URL     # Sentry API docs
+Ask::Sentry::Context::QUICK_START  # Copy-paste examples
+```
+
+The `QUICK_START` has examples for listing issues and events.
+
+## Step 3: Use Convenience Helpers First
+
+The gem ships with helpers for the most common operations:
+
+```ruby
+# Recent errors for a project
+issues = Ask::Sentry.recent_errors(organization: "myorg", project: "myapp", limit: 10)
+
+# Events for a specific issue
+events = Ask::Sentry.issue_events(ISSUE_ID, limit: 10)
+```
+
+## Step 4: Raw API Calls
+
+For endpoints without convenience helpers:
+
+```ruby
+client = Ask::Sentry.client
+
+# List projects
+client.get("projects/")
+
+# List issues for a project
+client.get("projects/ORG/PROJECT/issues/", limit: 20, query: "is:unresolved")
+
+# Get event details
+client.get("issues/ISSUE_ID/events/latest/")
+
+# List releases
+client.get("projects/ORG/PROJECT/releases/")
+```
+
+Sentry's API uses path parameters — the base URL already includes `/api/0/`.
+
+## Step 5: Authentication & Common Errors
+
+```ruby
+Ask::Sentry::Errors.status_code_description(401)
+Ask::Sentry::Errors.status_code_description(429)
+```
+
+Common scenarios:
+- **401**: Token invalid or revoked → regenerate at Sentry auth token settings
+- **403**: Token lacks scope → check token permissions
+- **404**: Wrong org/project slug → verify slugs in Sentry dashboard
+- **429**: Rate limited → wait and retry (Faraday auto-retries 3 times)
+
+## Step 6: Fallback Strategy
+
+1. Reference `Ask::Sentry::Context::DOCS_URL` for the full API reference
+2. Sentry's API is REST + JSON — standard GET requests with URL path parameters
+3. Organization and project slugs are required for most endpoints — get them
+   from the Sentry dashboard URL (`/organizations/{ORG}/projects/{PROJECT}/`)

data/lib/tasks/vcr.rake

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+namespace :vcr do
+  desc "Record VCR cassettes for a specific provider"
+  task :record, [:provider] do |_t, args|
+    provider = args[:provider] || "all"
+    cassette_dir = File.expand_path("../../test/cassettes", __dir__)
+
+    if provider == "all"
+      puts "Removing all cassettes..."
+      FileUtils.rm_rf(Dir[File.join(cassette_dir, "*.yml")])
+    else
+      puts "Removing cassettes for #{provider}..."
+      FileUtils.rm_rf(Dir[File.join(cassette_dir, "*#{provider}*.yml")])
+    end
+
+    puts "Running tests to re-record cassettes..."
+    system("bundle exec rake test")
+  end
+
+  desc "Verify cassettes are fresh (less than 30 days old)"
+  task :verify_freshness do
+    cassette_dir = File.expand_path("../../test/cassettes", __dir__)
+    stale = false
+
+    Dir[File.join(cassette_dir, "*.yml")].each do |cassette|
+      age_days = (Time.now - File.mtime(cassette)) / 86400.0
+      if age_days > 30
+        puts "STALE: #{File.basename(cassette)} is #{age_days.round(1)} days old"
+        stale = true
+      end
+    end
+
+    if stale
+      puts "\nSome cassettes are older than 30 days. Re-record them with:"
+      puts "  bundle exec rake vcr:record[all]"
+      exit 1
+    else
+      puts "All cassettes are fresh (less than 30 days old)."
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-sentry
 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,10 +150,13 @@ files:
 - lib/ask/sentry/context.rb
 - lib/ask/sentry/error_guide.rb
 - lib/ask/sentry/version.rb
+- lib/ask/skills/sentry.use_sentry/SKILL.md
+- lib/tasks/vcr.rake
 homepage: https://github.com/ask-rb/ask-sentry
 licenses:
 - MIT
 metadata:
+  homepage_uri: https://github.com/ask-rb/ask-sentry
   source_code_uri: https://github.com/ask-rb/ask-sentry
   changelog_uri: https://github.com/ask-rb/ask-sentry/blob/main/CHANGELOG.md
 rdoc_options: []