ask-solid_errors 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba92491b11bac63cbf32c9ef78b4245685da5f7250dbe429103d97ea62440dda
-  data.tar.gz: 6799651969f12c163af3220a2dbbf0007a607aed1b9b40b6c68fe3f701c361d5
+  metadata.gz: 97f7f95592c168dbf2e976d888c2b85031b9136c40386da559f8d7abe85abeb3
+  data.tar.gz: 5b3d27d615c77cee20f5b093d3841abde30f83af73d988eb6e06521dd8419e0d
 SHA512:
-  metadata.gz: cb31e50960076744ae4f559587a9f5a59543a16e7cfe7ff025cc1aebf2ddd895448e6b9d9cd58f4f7d52fde330e1c60af1abd5ef40f2bb9ee36bed84959ee8f7
-  data.tar.gz: 4e644898ac61e75b9408d009099259f78afaac05202ac711110033c614a18ef8337402a65184ccca010e64086c23cb2b656c86de8a23aa75653e2caf2c55522b
+  metadata.gz: 19e64ceac2f115da3cd2b850499e4eb382dd7686b1858f473f2db59bb450c0443e98fd6dc5794f7f961b29e9a0011d2cb2623a54241fd638913a4c9359f0200b
+  data.tar.gz: 36e61798a9d9840aaa7573e9ae2e985266e14816833d7abc979e24d7427044a687121af16f57759bd0340d5654eb9150722778d43b706286514511f9b554c580

data/README.md

@@ -1,6 +1,11 @@
 # ask-solid_errors
 
-SolidErrors — error tracking stored in your Rails database
+[![Gem Version](https://badge.fury.io/rb/ask-solid_errors.svg)](https://badge.fury.io/rb/ask-solid_errors)
+
+SolidErrors service context for AI agents in the ask-rb ecosystem. It wraps
+the SolidErrors ActiveRecord models so agents can query the error tracking
+data stored in your Rails database, and provides a structured error guide for
+common SolidErrors situations.
 
 ## Installation
 
@@ -8,24 +13,23 @@ SolidErrors — error tracking stored in your Rails database
 gem "ask-solid_errors"
 ```
 
-## Prerequisites
-
-This gem requires the `solid_errors` gem to be installed and configured in your Rails app:
+This gem has no HTTP client and needs no authentication. It requires the
+`solid_errors` gem and its tables in your Rails app:
 
 ```ruby
 gem "solid_errors"
 ```
 
-Run the SolidErrors migration:
-
 ```bash
 bin/rails solid_errors:install:migrations
 bin/rails db:migrate
 ```
 
-## Usage
+## Quick Start
 
 ```ruby
+require "ask-solid_errors"
+
 # Recent errors
 errors = Ask::SolidErrors.recent(limit: 10)
 errors.map { |e| { id: e.id, class: e.exception_class, message: e.message.truncate(200) } }
@@ -36,29 +40,40 @@ error.backtrace
 error.context
 error.occurrences
 
-# Filter by status
-Ask::SolidErrors.unresolved   # errors needing attention
-Ask::SolidErrors.resolved     # previously resolved errors
-
-# Filter by class or severity
+# Filter by status, class, or severity
+Ask::SolidErrors.unresolved
+Ask::SolidErrors.resolved
 Ask::SolidErrors.by_class("ActiveRecord::RecordNotFound")
 Ask::SolidErrors.by_severity("error")
 
-# Search messages
+# Search messages and count occurrences
 Ask::SolidErrors.search("timeout")
-
-# Occurrence count
 Ask::SolidErrors.occurrence_count(error)
-Ask::SolidErrors.occurrence_count(42)
-
-# Low-level client for custom queries
-client = Ask::SolidErrors.client
-client.where(exception_class: "RuntimeError").order(created_at: :desc)
 ```
 
+## Key entry points
+
+- `Ask::SolidErrors.client` - a proxy wrapping `SolidErrors::Error`. Query
+  methods return `ActiveRecord::Relation` objects that can be chained further.
+- Convenience helpers: `recent(limit: 10)`, `find(id)`, `unresolved`,
+  `resolved`, `by_class(klass)`, `by_severity(severity)`, `search(query)`,
+  and `occurrence_count(error)`.
+- `Ask::SolidErrors::Errors` - structured error knowledge for agents:
+  guidance by exception class and severity level, plus schema reference.
+- `Ask::SolidErrors::DESCRIPTION`, `GEM_NAME`, and `QUICK_START` - metadata
+  constants for system prompts.
+
+## Full documentation
+
+The full ask-rb documentation lives at https://ask-rb.github.io/ask-docs.
+[Services: SolidErrors](https://ask-rb.github.io/ask-docs/services/solid_errors)
+covers ask-solid_errors in depth, including the client, error guide, and
+constants. API reference: https://ask-rb.github.io/ask-docs/reference/api.
+
 ## Development
 
-```bash
+```
+bundle install
 bundle exec rake test
 ```
 

data/lib/ask/solid_errors/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module SolidErrors
-    VERSION = "0.1.2"
+    VERSION = "0.1.3"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-solid_errors
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Kaka Ruto
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.11.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.11.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -102,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.18
 specification_version: 4
 summary: SolidErrors — error tracking stored in your Rails database
 test_files: []