query_lens 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9aaf93d111afdef8297ecd5bbd1272351f54a7539e76dd9c995a474861e07c75
-  data.tar.gz: 3ac00b2450ecd61da67f68995718cdb2f89ba227a4136bdb0d8aac9cae5c66e6
+  metadata.gz: 302bd0c222f001ae9997180641b03390b244395de3f4b5070b21be1812590fd8
+  data.tar.gz: df5c31d6ab1ca79837cb0e433130b0666f45831666b96a704f4ed27ac5b22465
 SHA512:
-  metadata.gz: bd7f9d8da037af3eb24f18806137d9e5abc6a19c445b2242ade57153c2f0d36a2b7387e3a9e320cb322e89ade259d3eaeedabece561cb773db272c01d4e6f762
-  data.tar.gz: 828078b8c9a7a2fb7143e74de58c79f174087c28a8a70b6edfb8e5163891020379384995c4fb7ad81e393963b96d5a3b5f7f63bc517a4dc28ad1942e6ff52c00
+  metadata.gz: c70804e76cbb049fc5733868e6c0c53976a99960425c1894bd544faeff95e82d93fb6827da4ac3a3355694b478d4b92cb2586e4086f394e402087a6470e5afb1
+  data.tar.gz: 60ba99c1ff1753974762f25f2a30def02d1fee229c334d1fcaac773e1dea3978f26a9faf9d0f2d8e2d1e2d4148caa94ae1773eda1f8a34f43b7a7f5b59521f42

data/README.md

@@ -4,9 +4,9 @@ A mountable Rails engine that lets users write natural language questions and ge
 
 Powered by [RubyLLM](https://rubyllm.com), QueryLens works with any major AI provider: OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Mistral, Ollama (local models), and more.
 
-[Watch the demo (90 seconds)](https://www.loom.com/share/595ed0ea3c1f42b28152a345db586c85)
+![QueryLens Screenshot](docs/screenshot.png)
 
-[![QueryLens Demo](https://cdn.loom.com/sessions/thumbnails/595ed0ea3c1f42b28152a345db586c85-with-play.gif)](https://www.loom.com/share/595ed0ea3c1f42b28152a345db586c85)
+[Watch the demo (90 seconds)](https://www.loom.com/share/595ed0ea3c1f42b28152a345db586c85)
 
 **Want to try it without touching your own database?** The [QueryLens Testbed](https://github.com/bryanbeshore/query_lens_testbed) is a ready-to-go Rails app with sample data — clone, run, and start querying in under 2 minutes.
 
@@ -43,8 +43,10 @@ rails db:migrate
 
 This will:
 1. Create `config/initializers/query_lens.rb` with RubyLLM and QueryLens configuration
-2. Add the engine route to your `config/routes.rb`
-3. Create the `query_lens_projects`, `query_lens_saved_queries`, and `query_lens_conversations` tables
+2. Copy the migration to create the `query_lens_projects`, `query_lens_saved_queries`, and `query_lens_conversations` tables
+3. Add the engine route to your `config/routes.rb`
+
+> **Upgrading from a previous version?** If you already ran migrations from an earlier release (before the install generator included them), your tables are already in place. Just run `rails generate query_lens:install` and skip or discard the generated migration file — no need to migrate again.
 
 ## Configuration
 

data/app/services/query_lens/sql_generator.rb

@@ -14,8 +14,9 @@ module QueryLens
       - Always include an ORDER BY clause when it makes sense (e.g., by date descending, by amount descending).
 
       RESPONSE FORMAT:
-      Respond with a brief explanation of what the query does, then the SQL query wrapped in ```sql code fences.
-      Keep explanations concise (1-2 sentences).
+      - When the user asks for data or wants a new/modified query: respond with a brief explanation (1-2 sentences), then the SQL query wrapped in ```sql code fences.
+      - When the user asks about the results, asks what a column means, wants clarification, or is discussing the data: respond conversationally WITHOUT SQL code fences. The existing query and results will remain visible.
+      - Only include ```sql code fences when you are providing a new or modified query.
 
       DATABASE SCHEMA:
       %{schema}

data/app/views/query_lens/queries/show.html.erb

@@ -253,9 +253,9 @@
       }
 
       if (data.explanation) addMessage('ai', data.explanation, genTime);
+      conversation.push({ role: 'assistant', content: data.raw || data.explanation });
       if (data.sql) {
         el.sql.value = data.sql;
-        conversation.push({ role: 'assistant', content: data.raw || data.explanation });
         await runQueryWithTrace(trace);
       } else {
         addTrace(trace);

data/lib/generators/query_lens/install/install_generator.rb

@@ -1,14 +1,21 @@
+require "rails/generators/active_record/migration"
+
 module QueryLens
   module Generators
     class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
       source_root File.expand_path("templates", __dir__)
 
-      desc "Creates a QueryLens initializer and adds the engine route."
+      desc "Creates a QueryLens initializer, copies migrations, and adds the engine route."
 
       def copy_initializer
         template "initializer.rb", "config/initializers/query_lens.rb"
       end
 
+      def copy_migrations
+        migration_template "create_query_lens_tables.rb.tt", "db/migrate/create_query_lens_tables.rb"
+      end
+
       def add_route
         route 'mount QueryLens::Engine => "/query_lens"'
       end

data/{db/migrate/20260207000001_create_query_lens_tables.rb → lib/generators/query_lens/install/templates/create_query_lens_tables.rb.tt}

@@ -1,4 +1,4 @@
-class CreateQueryLensTables < ActiveRecord::Migration[7.1]
+class CreateQueryLensTables < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
   def change
     create_table :query_lens_projects do |t|
       t.string :name, null: false

data/lib/query_lens/engine.rb

@@ -5,13 +5,5 @@ module QueryLens
     initializer "query_lens.assets" do |app|
       app.config.assets.precompile += %w[query_lens/application.js] if app.config.respond_to?(:assets)
     end
-
-    initializer "query_lens.migrations" do |app|
-      unless app.root.to_s == root.to_s
-        config.paths["db/migrate"].expanded.each do |expanded_path|
-          app.config.paths["db/migrate"] << expanded_path
-        end
-      end
-    end
   end
 end

data/lib/query_lens/version.rb

@@ -1,3 +1,3 @@
 module QueryLens
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: query_lens
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Bryan Beshore
@@ -107,8 +107,8 @@ files:
 - app/views/query_lens/layouts/application.html.erb
 - app/views/query_lens/queries/show.html.erb
 - config/routes.rb
-- db/migrate/20260207000001_create_query_lens_tables.rb
 - lib/generators/query_lens/install/install_generator.rb
+- lib/generators/query_lens/install/templates/create_query_lens_tables.rb.tt
 - lib/generators/query_lens/install/templates/initializer.rb
 - lib/query_lens.rb
 - lib/query_lens/configuration.rb