ask-solid_errors 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bc92f1121f81b6a0ed87e8e141a698a13257e12fa6306fbc564032b964c2b2c
-  data.tar.gz: f25b7fe3b53975150dd5880ca08f1c188b5d2f19d957414a87a186c26c521f82
+  metadata.gz: 97f7f95592c168dbf2e976d888c2b85031b9136c40386da559f8d7abe85abeb3
+  data.tar.gz: 5b3d27d615c77cee20f5b093d3841abde30f83af73d988eb6e06521dd8419e0d
 SHA512:
-  metadata.gz: 61aa60d118cd6f17e7604af52673b5f6e56d1606c31f65edce8145fe9d24e32f34c0c186e780aeb85559bc7e9daa3b6588586cf035bef7166a5703637c21da20
-  data.tar.gz: 4e5727509ea785da77c7bf989124cec2b1d6a11551fd2cc9536b80a35fc7be7fbf3d2d3a7f6800e3acd44cc2647442a122e4ffca95ae41510fdd2bfc46600a83
+  metadata.gz: 19e64ceac2f115da3cd2b850499e4eb382dd7686b1858f473f2db59bb450c0443e98fd6dc5794f7f961b29e9a0011d2cb2623a54241fd638913a4c9359f0200b
+  data.tar.gz: 36e61798a9d9840aaa7573e9ae2e985266e14816833d7abc979e24d7427044a687121af16f57759bd0340d5654eb9150722778d43b706286514511f9b554c580

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+## [0.1.2] - 2026-06-25
+
+### Changed
+- Gemspec validation test. Infrastructure: rubocop, overcommit, bin/setup, CI matrix, SimpleCov.
+# Changelog
+
+## 0.1.0 (2026-06-10)
+
+### Added
+
+- `Ask::SolidErrors.context` — DESCRIPTION, GEM_NAME, QUICK_START for system prompts
+- `Ask::SolidErrors.client` — ClientProxy wrapping `SolidErrors::Error` with ActiveRecord delegation
+- `Ask::SolidErrors.recent`, `.find`, `.unresolved`, `.resolved`, `.by_class`, `.by_severity`, `.search`, `.occurrence_count` — module-level convenience helpers
+- `Ask::SolidErrors::Errors` — structured error knowledge (18 common Rails exceptions, 3 severity levels, database schema documentation)
+- No authentication needed — SolidErrors queries the Rails database directly via ActiveRecord
+- Guard clause `ensure_solid_errors_loaded!` with clear error message if gem is missing
+- Full Minitest test suite with in-memory SQLite (41 tests, 76 assertions)

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.1"
+    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.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Kaka Ruto
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: ask-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.11.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.11.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -51,20 +65,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-- !ruby/object:Gem::Dependency
-  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'
 description: Error context for agents via SolidErrors for the ask-rb ecosystem.
 email:
 - kaka@myrrlabs.com
@@ -72,6 +72,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/ask-solid_errors.rb
@@ -83,7 +84,10 @@ files:
 homepage: https://github.com/ask-rb/ask-solid_errors
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-solid_errors
+  source_code_uri: https://github.com/ask-rb/ask-solid_errors
+  changelog_uri: https://github.com/ask-rb/ask-solid_errors/blob/master/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -98,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: []