ask-rails 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a8258ca96d9513529bc1c0c9c54bd8e2492a110e48d90c9af3f53ca3aa24d9f
-  data.tar.gz: 4a776f46230d7a87719d5a6e12154e90987f71f60af63707da686ba2cce20377
+  metadata.gz: 87296c9e940bcd34d48e640c3a13c3e3d634b57abf253c434d0919b1dc3388bc
+  data.tar.gz: b8edd3def1dfa96b41d6af0dd842bebb724ac9909c8728d5c8a193a3956e83be
 SHA512:
-  metadata.gz: 894f5146923889fd014f1ac770c52eba2cfdc6d84fd546062c05ac85473f6e716e70a298761f25a19ea1b00ba60461aae3ab38889c05a95698d891320879cc86
-  data.tar.gz: d58b94569c064b58493bd0a929cfb1dde3310a43c110c92474947c57e711f5a4e6d57ca596c389e73fcb4ee6bddeff7e8797bc5915ca8e4cbf94eadaf5f2353d
+  metadata.gz: 4533e9675014317d48c973bcfa23dd30a996d24f9f5e734060c37250735cdf0569df6b38ed2bb60c3a6c6d0dfdb8cf814869d5b628a9f0e37a8f5f91616f8347
+  data.tar.gz: 13fc4f80420ad209ab5e531d254883858acb6e8ac28d7806bac514afcc58c278df79a3c7026dfa69a49f20fbd70fa7ef0ac5ecada3255afedb3d23c338dcff2d

data/CHANGELOG.md

@@ -1,3 +1,41 @@
+## [0.6.0] — 2026-07-29
+
+### Added
+
+- **`ask_state` migration in install generator** — `rails generate ask:install` now creates `db/migrate/create_ask_state.rb` with a shared key-value table for agent sessions and graph checkpoints.
+
+- **Standard Rails generator path** — Generator moved to `lib/generators/ask/install_generator.rb` for automatic Rails discovery. Run `rails generate ask:install` with no additional configuration.
+
+### Changed
+
+- Generator creates two migrations with unique timestamps: `ask_state` first, then `ask_audit_logs`.
+
+### Tested
+
+- `rails generate ask:install` tested in production Rails app (kawibot) — creates initializer and both migrations.
+- Migrations run successfully against PostgreSQL.
+
+## [0.5.0] — 2026-07-26
+
+### Added
+
+- **Audit log migration in install generator** — `rails generate ask_rails:install` now creates `db/migrate/create_ask_audit_logs.rb` with `if_not_exists: true`.
+  Table schema: `session_id`, `event_type`, `jsonb data`, `timestamp`, `created_at`, `updated_at`. Indexed on `[session_id, event_type]` and `timestamp`.
+
+### Changed
+
+- Install generator now includes `::Rails::Generators::Migration` for `migration_template` support.
+
+## [0.4.0] — 2026-07-26
+
+### Added
+
+- **ask-rails-harness** — new `Ask::Rails::Harness` module for configuring the Rails-facing agent harness. Separates ask-rb ecosystem configuration from Rails-specific agent harness settings.
+
+### Changed
+
+- `config/initializers/ask_rails.rb` now configures `Ask::Rails::Harness` instead of `Ask::Rails`.
+
 ## [0.1.0] — 2026-07-26
 
 ### Added

data/lib/ask/rails/generators/install/install_generator.rb

@@ -1,14 +1,17 @@
 # frozen_string_literal: true
 
 require "rails/generators"
+require "rails/generators/active_record"
 
 module Ask
   module Rails
     module Generators
       class InstallGenerator < ::Rails::Generators::Base
+        include ::Rails::Generators::Migration
+
         source_root File.expand_path("templates", __dir__)
 
-        desc "Sets up ask-rb for Rails — creates initializer and app/agents/ directory"
+        desc "Sets up ask-rb for Rails — creates initializer, agents directory, state and audit log migrations"
 
         def create_initializer
           template "initializer.rb", "config/initializers/ask.rb"
@@ -22,6 +25,20 @@ module Ask
           empty_directory "app/agents"
           create_file "app/agents/.keep", "" unless options[:skip_keep]
         end
+
+        def create_state_migration
+          migration_template "state_migration.rb", "db/migrate/create_ask_state.rb"
+        end
+
+        def create_audit_log_migration
+          migration_template "audit_log_migration.rb", "db/migrate/create_ask_audit_logs.rb"
+        end
+
+        private
+
+        def migration_version
+          "[#{ActiveRecord::Migration.current_version}]"
+        end
       end
     end
   end

data/lib/ask/rails/generators/install/templates/audit_log_migration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Migration for ask-agent's audit log table.
+# This table records session events (tool calls, errors, token usage, etc.)
+# from every agent that has audit_log configured.
+class CreateAskAuditLogs < ActiveRecord::Migration[<%= migration_version %>]
+  def change
+    create_table :ask_audit_logs, if_not_exists: true do |t|
+      t.string :session_id, null: false
+      t.string :event_type, null: false
+      t.jsonb :data, default: {}
+      t.datetime :timestamp, null: false
+      t.timestamps
+
+      t.index [:session_id, :event_type]
+      t.index :timestamp
+    end
+  end
+end

data/lib/ask/rails/generators/install/templates/initializer.rb

@@ -10,6 +10,18 @@
 #
 # See https://github.com/ask-rb/ask-auth for details.
 
+# Shared key-value state store for agent sessions and graph checkpoints.
+# Uses the ask_state table created by the migration.
+ASK_STATE = Ask::State::PostgreSQL.new(
+  table_name: :ask_state
+)
+
 Ask::Agent.configure do |config|
+  # State persistence for agent sessions
+  config.state = ASK_STATE
+
+  # Audit log for session events
+  config.audit_log = { adapter: :active_record }
+
   # config.default_model = "gpt-4o"
 end

data/lib/ask/rails/generators/install/templates/state_migration.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Migration for ask-rb's shared key-value state table.
+# Used by ask-agent (session persistence) and ask-graph (workflow checkpoints).
+# This single table serves both components — keys are namespaced by convention.
+class CreateAskState < ActiveRecord::Migration[<%= migration_version %>]
+  def change
+    create_table :ask_state do |t|
+      t.string :key, null: false
+      t.jsonb :value, null: false, default: {}
+      t.datetime :expires_at
+      t.timestamps
+
+      t.index :key, unique: true
+      t.index :expires_at
+    end
+  end
+end

data/lib/ask/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Rails
-    VERSION = "0.4.0"
+    VERSION = "0.6.0"
   end
 end

data/lib/generators/ask/install/templates/audit_log_migration.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreateAskAuditLogs < ActiveRecord::Migration[8.1]
+  def change
+    create_table :ask_audit_logs, if_not_exists: true do |t|
+      t.string :session_id, null: false
+      t.string :event_type, null: false
+      t.jsonb :data, default: {}
+      t.datetime :timestamp, null: false
+      t.timestamps
+
+      t.index [:session_id, :event_type]
+      t.index :timestamp
+    end
+  end
+end

data/lib/generators/ask/install/templates/initializer.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Ask Agent Configuration
+# ========================
+#
+# API keys are resolved automatically by Ask::Auth:
+#   - Environment variables: OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.
+#   - Rails credentials: rails credentials:edit → ask.openai, ask.anthropic
+#   - ~/.ask/credentials.yml
+#
+# See https://github.com/ask-rb/ask-auth for details.
+
+Ask::Agent.configure do |config|
+  # Enable audit logging to the ask_audit_logs table
+  # config.audit_log = { adapter: :active_record }
+
+  # Optional: set a default model
+  # config.default_model = "gpt-4o"
+end

data/lib/generators/ask/install/templates/state_migration.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateAskState < ActiveRecord::Migration[8.1]
+  def change
+    create_table :ask_state do |t|
+      t.string :key, null: false
+      t.jsonb :value, null: false, default: {}
+      t.datetime :expires_at
+      t.timestamps
+
+      t.index :key, unique: true
+      t.index :expires_at
+    end
+  end
+end

data/lib/generators/ask/install_generator.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module Ask
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      include ::Rails::Generators::Migration
+
+      source_root File.expand_path("install/templates", __dir__)
+
+      desc "Sets up ask-rb for Rails — creates initializer, state and audit log migrations"
+
+      def create_initializer
+        template "initializer.rb", "config/initializers/ask.rb"
+      end
+
+      def create_state_migration
+        template "state_migration.rb", "db/migrate/#{next_migration_number}_create_ask_state.rb"
+      end
+
+      def create_audit_log_migration
+        template "audit_log_migration.rb", "db/migrate/#{next_migration_number}_create_ask_audit_logs.rb"
+      end
+
+      private
+
+      def next_migration_number
+        # Rails requires exactly YYYYMMDDHHMMSS format
+        @migration_suffix ||= 0
+        now = Time.now.utc.strftime("%Y%m%d%H%M")
+        "#{now}#{format('%02d', @migration_suffix)}"
+      ensure
+        @migration_suffix = (@migration_suffix || 0) + 1
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-rails
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -94,9 +94,15 @@ files:
 - lib/ask/rails.rb
 - lib/ask/rails/generators/install/install_generator.rb
 - lib/ask/rails/generators/install/templates/application_agent.rb
+- lib/ask/rails/generators/install/templates/audit_log_migration.rb
 - lib/ask/rails/generators/install/templates/initializer.rb
+- lib/ask/rails/generators/install/templates/state_migration.rb
 - lib/ask/rails/railtie.rb
 - lib/ask/rails/version.rb
+- lib/generators/ask/install/templates/audit_log_migration.rb
+- lib/generators/ask/install/templates/initializer.rb
+- lib/generators/ask/install/templates/state_migration.rb
+- lib/generators/ask/install_generator.rb
 homepage: https://github.com/ask-rb/ask-rails
 licenses:
 - MIT