ask-slack 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8328e80c2b6386b33282dd95c8af3eceab18182e53547d5fe6b849a9bcbe874d
-  data.tar.gz: c73406fd2a39f3d8dca19f856226373cc30c090023a2f73d2f1b342081a2c3bd
+  metadata.gz: fa494a5831a8a5e57491f43b8c7d6677db0e8acfc4c47b9fe208ab36a2f8183e
+  data.tar.gz: 5bff6d53dfd1efed345fc260162d0ca1f93ace445a090a058e8271b8434ecc09
 SHA512:
-  metadata.gz: b46af6dc89a858df607c4e0b57a32873463ab80883757e0bcbba57e1297882a23e2d23fbe916d9e7fa31912caace997be3166b170537af293bff1ae07fb48452
-  data.tar.gz: 32d1694ed20b65b4595a7b24a70aad1f255745d33208b6844b73ce7099154bcea8761f0520826a72f260eb448f067a7d5ed7635980c4a2bcd7aa46e8b769e35e
+  metadata.gz: 219ed3857e6e18d585cceccda1a7511a5fa0d49c16f9ebcd3af3058679f562c41f02987111c8b8074c7d2e1acf9550419ca5a144f75393d0aa9715b99a6b53ec
+  data.tar.gz: 73897b358c923fa37d892104196fe00d37297073507be9f13afe67b445b4e613a8e22d02d57a7fc0cf77aae2f13bfa79adcaff28f24d71a05435de288eded5b2

data/CHANGELOG.md

@@ -0,0 +1,16 @@
+## [0.1.3] - 2026-06-25
+
+### Changed
+- Gemspec validation test. Infrastructure: rubocop, overcommit, bin/setup, CI matrix. VCR rake tasks.
+# Changelog
+
+## [0.1.2] - 2026-06-21
+
+### Added
+
+- Initial release of `ask-slack` — Slack service context for the ask-rb ecosystem.
+- **context.rb** — Metadata constants for AI system prompts: `DESCRIPTION`, `DOCS_URL`, `OPENAPI_URL`, `AUTH_NAME`, `AUTH_HOW`, `GEM_NAME`, `GEM_VERSION`, `GEM_DOCS`, `QUICK_START`
+- **client.rb** — `Ask::Slack.client` returns an authenticated `Slack::Web::Client` via `Ask::Auth.resolve(:slack_token)`. Wraps client in `ClientProxy` to convert `NotAuthed`, `InvalidAuth`, `AccountInactive`, `TokenRevoked`, and `TokenExpired` errors to `Ask::Auth::InvalidCredential`.
+- **error_guide.rb** — `Ask::Slack::Errors` with rate limit info, HTTP status code descriptions, Slack API error string guidance map, exception class mappings, and pagination info for agents.
+- **Dependencies:** `ask-auth ~> 0.1`, `slack-ruby-client ~> 3.1`
+- **Testing:** 29 tests, 81 assertions covering context constants, client auth flow, and error guide lookups.

data/README.md

@@ -1,11 +1,11 @@
 # ask-slack
 
-Slack service context for the ask-rb ecosystem.
+[![Gem Version](https://badge.fury.io/rb/ask-slack.svg)](https://badge.fury.io/rb/ask-slack)
 
-Provides:
-- `Ask::Slack.client` — authenticated Slack Web API client
-- `Ask::Slack::DESCRIPTION` — context metadata for the system prompt
-- `Ask::Slack::Errors` — structured error knowledge for agents
+Slack service context for AI agents in the ask-rb ecosystem. It provides an
+authenticated Slack Web API client built on slack-ruby-client, metadata
+constants for system prompts, and a structured error guide for common Slack
+API issues.
 
 ## Installation
 
@@ -13,7 +13,7 @@ Provides:
 gem "ask-slack"
 ```
 
-## Usage
+## Quick Start
 
 ```ruby
 require "ask-slack"
@@ -26,7 +26,8 @@ client.users_list
 
 ## Authentication
 
-Set your Slack Bot User OAuth Token:
+`Ask::Slack.client` resolves a token via `Ask::Auth.resolve(:slack_token)`.
+Set your Slack Bot User OAuth Token in the environment:
 
 ```bash
 export SLACK_TOKEN=xoxb-your-bot-token-here
@@ -38,9 +39,34 @@ Or add it to `~/.ask/credentials.yml`:
 slack_token: xoxb-your-bot-token-here
 ```
 
+Credentials can also come from Rails credentials, a database, or an OAuth
+provider, depending on your `ask-auth` configuration. Create a Slack app at
+[api.slack.com/apps](https://api.slack.com/apps) to get a bot token.
+
+## Key entry points
+
+- `Ask::Slack.client` - an authenticated `Slack::Web::Client`. It is wrapped
+  in a proxy that converts auth errors (`NotAuthed`, `InvalidAuth`, and
+  related) into `Ask::Auth::InvalidCredential` and retries transient network
+  failures with exponential backoff.
+- `Ask::Slack::Errors` - structured error knowledge for agents: guidance by
+  error string, HTTP status code descriptions, and exception class mapping.
+- `Ask::Slack::DESCRIPTION`, `DOCS_URL`, `AUTH_NAME`, `GEM_NAME`,
+  `GEM_VERSION`, and `QUICK_START` - metadata constants for system prompts.
+
+Use `conversations_list`, not `channels_list`. `channels_list` was removed in
+modern versions of slack-ruby-client.
+
+## Full documentation
+
+The full ask-rb documentation lives at https://ask-rb.github.io/ask-docs.
+[Services: Slack](https://ask-rb.github.io/ask-docs/services/slack) covers
+ask-slack 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/slack/context.rb

@@ -8,8 +8,9 @@ module Ask
     # Base URL for Slack Web API methods.
     DOCS_URL = "https://api.slack.com/methods"
 
-    # URL for the Slack OpenAPI specification.
-    OPENAPI_URL = "https://api.slack.com/specs/openapi"
+    # Slack no longer serves an OpenAPI spec at a stable URL.
+    # The API methods reference is at DOCS_URL instead.
+    # OPENAPI_URL was removed because the spec redirects to a 404 page.
 
     # Credential name used with Ask::Auth.resolve.
     AUTH_NAME = :slack_token

data/lib/ask/slack/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Slack
-    VERSION = '0.1.2'
+    VERSION = '0.1.4'
   end
 end

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-slack
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Kaka Ruto
@@ -13,16 +13,16 @@ dependencies:
   name: ask-auth
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.3.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.3.2
 - !ruby/object:Gem::Dependency
   name: slack-ruby-client
   requirement: !ruby/object:Gem::Requirement
@@ -143,6 +143,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/ask-slack.rb
@@ -151,10 +152,14 @@ files:
 - lib/ask/slack/context.rb
 - lib/ask/slack/error_guide.rb
 - lib/ask/slack/version.rb
+- lib/tasks/vcr.rake
 homepage: https://github.com/ask-rb/ask-slack
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-slack
+  source_code_uri: https://github.com/ask-rb/ask-slack
+  changelog_uri: https://github.com/ask-rb/ask-slack/blob/master/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -169,7 +174,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: Slack service context for the ask-rb ecosystem
 test_files: []