QueryWise 0.2.0

data/config/locales/en.yml

@@ -0,0 +1,31 @@
+# Files in the config/locales directory are used for internationalization and
+# are automatically loaded by Rails. If you want to use locales other than
+# English, add the necessary files in this directory.
+#
+# To use the locales, use `I18n.t`:
+#
+#     I18n.t "hello"
+#
+# In views, this is aliased to just `t`:
+#
+#     <%= t("hello") %>
+#
+# To use a different locale, set it with `I18n.locale`:
+#
+#     I18n.locale = :es
+#
+# This would use the information in config/locales/es.yml.
+#
+# To learn more about the API, please read the Rails Internationalization guide
+# at https://guides.rubyonrails.org/i18n.html.
+#
+# Be aware that YAML interprets the following case-insensitive strings as
+# booleans: `true`, `false`, `on`, `off`, `yes`, `no`. Therefore, these strings
+# must be quoted to be interpreted as strings. For example:
+#
+#     en:
+#       "yes": yup
+#       enabled: "ON"
+
+en:
+  hello: "Hello world"

data/config/master.key

@@ -0,0 +1 @@
+739479735365bc824bffe836402b665a

data/config/puma.rb

@@ -0,0 +1,41 @@
+# This configuration file will be evaluated by Puma. The top-level methods that
+# are invoked here are part of Puma's configuration DSL. For more information
+# about methods provided by the DSL, see https://puma.io/puma/Puma/DSL.html.
+#
+# Puma starts a configurable number of processes (workers) and each process
+# serves each request in a thread from an internal thread pool.
+#
+# You can control the number of workers using ENV["WEB_CONCURRENCY"]. You
+# should only set this value when you want to run 2 or more workers. The
+# default is already 1.
+#
+# The ideal number of threads per worker depends both on how much time the
+# application spends waiting for IO operations and on how much you wish to
+# prioritize throughput over latency.
+#
+# As a rule of thumb, increasing the number of threads will increase how much
+# traffic a given process can handle (throughput), but due to CRuby's
+# Global VM Lock (GVL) it has diminishing returns and will degrade the
+# response time (latency) of the application.
+#
+# The default is set to 3 threads as it's deemed a decent compromise between
+# throughput and latency for the average Rails application.
+#
+# Any libraries that use a connection pool or another resource pool should
+# be configured to provide at least as many connections as the number of
+# threads. This includes Active Record's `pool` parameter in `database.yml`.
+threads_count = ENV.fetch("RAILS_MAX_THREADS", 3)
+threads threads_count, threads_count
+
+# Specifies the `port` that Puma will listen on to receive requests; default is 3000.
+port ENV.fetch("PORT", 3000)
+
+# Allow puma to be restarted by `bin/rails restart` command.
+plugin :tmp_restart
+
+# Run the Solid Queue supervisor inside of Puma for single-server deployments
+plugin :solid_queue if ENV["SOLID_QUEUE_IN_PUMA"]
+
+# Specify the PID file. Defaults to tmp/pids/server.pid in development.
+# In other environments, only set the PID file if requested.
+pidfile ENV["PIDFILE"] if ENV["PIDFILE"]

data/config/puma_cloudrun.rb

@@ -0,0 +1,48 @@
+# Puma configuration optimized for Google Cloud Run
+
+# The environment Puma will run in
+environment ENV.fetch("RAILS_ENV") { "production" }
+
+# Port to listen on
+port ENV.fetch("PORT") { 8080 }
+
+# Number of worker processes
+# Cloud Run containers have limited CPU, so we use threads instead of workers
+workers 0
+
+# Number of threads per worker
+# Cloud Run containers typically have 1-2 vCPUs, so 5 threads is optimal
+threads_count = ENV.fetch("RAILS_MAX_THREADS") { 5 }
+threads threads_count, threads_count
+
+# Preload the application for better memory usage
+preload_app!
+
+# Allow puma to be restarted by `rails restart` command
+plugin :tmp_restart
+
+# Bind to all interfaces for Cloud Run
+bind "tcp://0.0.0.0:#{ENV.fetch('PORT') { 8080 }}"
+
+# Logging
+stdout_redirect '/dev/stdout', '/dev/stderr', true
+
+# Graceful shutdown for Cloud Run
+on_worker_boot do
+  ActiveRecord::Base.establish_connection if defined?(ActiveRecord)
+end
+
+# Optimize for Cloud Run's request handling
+before_fork do
+  ActiveRecord::Base.connection_pool.disconnect! if defined?(ActiveRecord)
+end
+
+# Cloud Run timeout handling
+worker_timeout 30
+worker_shutdown_timeout 8
+
+# Memory and performance optimizations for Cloud Run
+nakayoshi_fork if respond_to?(:nakayoshi_fork)
+
+# Healthcheck endpoint
+activate_control_app 'tcp://0.0.0.0:9293', { auth_token: 'health_check_token' }

data/config/queue.yml

@@ -0,0 +1,18 @@
+default: &default
+  dispatchers:
+    - polling_interval: 1
+      batch_size: 500
+  workers:
+    - queues: "*"
+      threads: 3
+      processes: <%= ENV.fetch("JOB_CONCURRENCY", 1) %>
+      polling_interval: 0.1
+
+development:
+  <<: *default
+
+test:
+  <<: *default
+
+production:
+  <<: *default

data/config/recurring.yml

@@ -0,0 +1,15 @@
+# examples:
+#   periodic_cleanup:
+#     class: CleanSoftDeletedRecordsJob
+#     queue: background
+#     args: [ 1000, { batch_size: 500 } ]
+#     schedule: every hour
+#   periodic_cleanup_with_command:
+#     command: "SoftDeletedRecord.due.delete_all"
+#     priority: 2
+#     schedule: at 5am every day
+
+production:
+  clear_solid_queue_finished_jobs:
+    command: "SolidQueue::Job.clear_finished_in_batches(sleep_between_batches: 0.3)"
+    schedule: every hour at minute 12

data/config/routes.rb

@@ -0,0 +1,28 @@
+Rails.application.routes.draw do
+  # Define your application routes per the DSL in https://guides.rubyonrails.org/routing.html
+
+  # Reveal health status on /up that returns 200 if the app boots with no exceptions, otherwise 500.
+  # Can be used by load balancers and uptime monitors to verify that the app is live.
+  get "up" => "rails/health#show", as: :rails_health_check
+
+  # API routes
+  namespace :api do
+    namespace :v1 do
+      # Query analysis endpoints
+      post 'analyze', to: 'analysis#analyze'
+      post 'analyze_ci', to: 'analysis#analyze_ci'
+
+      # API key management endpoints
+      post 'api_keys', to: 'api_keys#create'
+      get 'api_keys/current', to: 'api_keys#show'
+      post 'api_keys/regenerate', to: 'api_keys#regenerate'
+      delete 'api_keys/current', to: 'api_keys#destroy'
+
+      # Health check endpoint
+      get 'health', to: 'health#show'
+    end
+  end
+
+  # Defines the root path route ("/")
+  # root "posts#index"
+end

data/config/storage.yml

@@ -0,0 +1,34 @@
+test:
+  service: Disk
+  root: <%= Rails.root.join("tmp/storage") %>
+
+local:
+  service: Disk
+  root: <%= Rails.root.join("storage") %>
+
+# Use bin/rails credentials:edit to set the AWS secrets (as aws:access_key_id|secret_access_key)
+# amazon:
+#   service: S3
+#   access_key_id: <%= Rails.application.credentials.dig(:aws, :access_key_id) %>
+#   secret_access_key: <%= Rails.application.credentials.dig(:aws, :secret_access_key) %>
+#   region: us-east-1
+#   bucket: your_own_bucket-<%= Rails.env %>
+
+# Remember not to checkin your GCS keyfile to a repository
+# google:
+#   service: GCS
+#   project: your_project
+#   credentials: <%= Rails.root.join("path/to/gcs.keyfile") %>
+#   bucket: your_own_bucket-<%= Rails.env %>
+
+# Use bin/rails credentials:edit to set the Azure Storage secret (as azure_storage:storage_access_key)
+# microsoft:
+#   service: AzureStorage
+#   storage_account_name: your_account_name
+#   storage_access_key: <%= Rails.application.credentials.dig(:azure_storage, :storage_access_key) %>
+#   container: your_container_name-<%= Rails.env %>
+
+# mirror:
+#   service: Mirror
+#   primary: local
+#   mirrors: [ amazon, google, microsoft ]

data/config.ru

@@ -0,0 +1,6 @@
+# This file is used by Rack-based servers to start the application.
+
+require_relative "config/environment"
+
+run Rails.application
+Rails.application.load_server

data/db/cable_schema.rb

@@ -0,0 +1,11 @@
+ActiveRecord::Schema[7.1].define(version: 1) do
+  create_table "solid_cable_messages", force: :cascade do |t|
+    t.binary "channel", limit: 1024, null: false
+    t.binary "payload", limit: 536870912, null: false
+    t.datetime "created_at", null: false
+    t.integer "channel_hash", limit: 8, null: false
+    t.index ["channel"], name: "index_solid_cable_messages_on_channel"
+    t.index ["channel_hash"], name: "index_solid_cable_messages_on_channel_hash"
+    t.index ["created_at"], name: "index_solid_cable_messages_on_created_at"
+  end
+end

data/db/cache_schema.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+ActiveRecord::Schema[7.2].define(version: 1) do
+  create_table "solid_cache_entries", force: :cascade do |t|
+    t.binary "key", limit: 1024, null: false
+    t.binary "value", limit: 536870912, null: false
+    t.datetime "created_at", null: false
+    t.integer "key_hash", limit: 8, null: false
+    t.integer "byte_size", limit: 4, null: false
+    t.index ["byte_size"], name: "index_solid_cache_entries_on_byte_size"
+    t.index ["key_hash", "byte_size"], name: "index_solid_cache_entries_on_key_hash_and_byte_size"
+    t.index ["key_hash"], name: "index_solid_cache_entries_on_key_hash", unique: true
+  end
+end

data/db/migrate/20250818214709_create_app_profiles.rb

@@ -0,0 +1,13 @@
+class CreateAppProfiles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :app_profiles do |t|
+      t.string :name, null: false
+      t.string :api_key_digest, null: false
+
+      t.timestamps
+    end
+
+    add_index :app_profiles, :api_key_digest, unique: true
+    add_index :app_profiles, :name
+  end
+end

data/db/migrate/20250818214731_create_query_analyses.rb

@@ -0,0 +1,22 @@
+class CreateQueryAnalyses < ActiveRecord::Migration[8.0]
+  def change
+    create_table :query_analyses do |t|
+      t.references :app_profile, null: false, foreign_key: true
+      t.text :sql_query, null: false
+      t.integer :duration_ms
+      t.string :table_name
+      t.string :query_type
+      t.datetime :analyzed_at, null: false
+      t.string :query_hash  # For detecting similar queries
+      t.json :parsed_data   # Store parsed query structure
+
+      t.timestamps
+    end
+
+    add_index :query_analyses, :analyzed_at
+    add_index :query_analyses, :table_name
+    add_index :query_analyses, :query_type
+    add_index :query_analyses, :query_hash
+    add_index :query_analyses, :duration_ms
+  end
+end

data/db/migrate/20250818214740_create_query_patterns.rb

@@ -0,0 +1,22 @@
+class CreateQueryPatterns < ActiveRecord::Migration[8.0]
+  def change
+    create_table :query_patterns do |t|
+      t.string :pattern_type, null: false  # 'n_plus_one', 'slow_query', 'missing_index'
+      t.string :table_name, null: false
+      t.string :column_name
+      t.integer :frequency, default: 1
+      t.datetime :first_seen, null: false
+      t.datetime :last_seen, null: false
+      t.string :pattern_signature  # Unique identifier for the pattern
+      t.json :metadata  # Additional pattern-specific data
+
+      t.timestamps
+    end
+
+    add_index :query_patterns, :pattern_type
+    add_index :query_patterns, :table_name
+    add_index :query_patterns, :pattern_signature, unique: true
+    add_index :query_patterns, :frequency
+    add_index :query_patterns, [:pattern_type, :table_name]
+  end
+end

data/db/migrate/20250818214805_create_optimization_suggestions.rb

@@ -0,0 +1,20 @@
+class CreateOptimizationSuggestions < ActiveRecord::Migration[8.0]
+  def change
+    create_table :optimization_suggestions do |t|
+      t.references :query_analysis, null: false, foreign_key: true
+      t.string :suggestion_type, null: false  # 'n_plus_one', 'slow_query', 'missing_index', 'query_optimization'
+      t.string :title, null: false
+      t.text :description, null: false
+      t.text :sql_suggestion
+      t.integer :priority, default: 1  # 1=low, 2=medium, 3=high, 4=critical
+      t.boolean :implemented, default: false
+      t.json :metadata  # Additional suggestion-specific data
+
+      t.timestamps
+    end
+
+    add_index :optimization_suggestions, :suggestion_type
+    add_index :optimization_suggestions, :priority
+    add_index :optimization_suggestions, :implemented
+  end
+end

data/db/queue_schema.rb

@@ -0,0 +1,129 @@
+ActiveRecord::Schema[7.1].define(version: 1) do
+  create_table "solid_queue_blocked_executions", force: :cascade do |t|
+    t.bigint "job_id", null: false
+    t.string "queue_name", null: false
+    t.integer "priority", default: 0, null: false
+    t.string "concurrency_key", null: false
+    t.datetime "expires_at", null: false
+    t.datetime "created_at", null: false
+    t.index [ "concurrency_key", "priority", "job_id" ], name: "index_solid_queue_blocked_executions_for_release"
+    t.index [ "expires_at", "concurrency_key" ], name: "index_solid_queue_blocked_executions_for_maintenance"
+    t.index [ "job_id" ], name: "index_solid_queue_blocked_executions_on_job_id", unique: true
+  end
+
+  create_table "solid_queue_claimed_executions", force: :cascade do |t|
+    t.bigint "job_id", null: false
+    t.bigint "process_id"
+    t.datetime "created_at", null: false
+    t.index [ "job_id" ], name: "index_solid_queue_claimed_executions_on_job_id", unique: true
+    t.index [ "process_id", "job_id" ], name: "index_solid_queue_claimed_executions_on_process_id_and_job_id"
+  end
+
+  create_table "solid_queue_failed_executions", force: :cascade do |t|
+    t.bigint "job_id", null: false
+    t.text "error"
+    t.datetime "created_at", null: false
+    t.index [ "job_id" ], name: "index_solid_queue_failed_executions_on_job_id", unique: true
+  end
+
+  create_table "solid_queue_jobs", force: :cascade do |t|
+    t.string "queue_name", null: false
+    t.string "class_name", null: false
+    t.text "arguments"
+    t.integer "priority", default: 0, null: false
+    t.string "active_job_id"
+    t.datetime "scheduled_at"
+    t.datetime "finished_at"
+    t.string "concurrency_key"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index [ "active_job_id" ], name: "index_solid_queue_jobs_on_active_job_id"
+    t.index [ "class_name" ], name: "index_solid_queue_jobs_on_class_name"
+    t.index [ "finished_at" ], name: "index_solid_queue_jobs_on_finished_at"
+    t.index [ "queue_name", "finished_at" ], name: "index_solid_queue_jobs_for_filtering"
+    t.index [ "scheduled_at", "finished_at" ], name: "index_solid_queue_jobs_for_alerting"
+  end
+
+  create_table "solid_queue_pauses", force: :cascade do |t|
+    t.string "queue_name", null: false
+    t.datetime "created_at", null: false
+    t.index [ "queue_name" ], name: "index_solid_queue_pauses_on_queue_name", unique: true
+  end
+
+  create_table "solid_queue_processes", force: :cascade do |t|
+    t.string "kind", null: false
+    t.datetime "last_heartbeat_at", null: false
+    t.bigint "supervisor_id"
+    t.integer "pid", null: false
+    t.string "hostname"
+    t.text "metadata"
+    t.datetime "created_at", null: false
+    t.string "name", null: false
+    t.index [ "last_heartbeat_at" ], name: "index_solid_queue_processes_on_last_heartbeat_at"
+    t.index [ "name", "supervisor_id" ], name: "index_solid_queue_processes_on_name_and_supervisor_id", unique: true
+    t.index [ "supervisor_id" ], name: "index_solid_queue_processes_on_supervisor_id"
+  end
+
+  create_table "solid_queue_ready_executions", force: :cascade do |t|
+    t.bigint "job_id", null: false
+    t.string "queue_name", null: false
+    t.integer "priority", default: 0, null: false
+    t.datetime "created_at", null: false
+    t.index [ "job_id" ], name: "index_solid_queue_ready_executions_on_job_id", unique: true
+    t.index [ "priority", "job_id" ], name: "index_solid_queue_poll_all"
+    t.index [ "queue_name", "priority", "job_id" ], name: "index_solid_queue_poll_by_queue"
+  end
+
+  create_table "solid_queue_recurring_executions", force: :cascade do |t|
+    t.bigint "job_id", null: false
+    t.string "task_key", null: false
+    t.datetime "run_at", null: false
+    t.datetime "created_at", null: false
+    t.index [ "job_id" ], name: "index_solid_queue_recurring_executions_on_job_id", unique: true
+    t.index [ "task_key", "run_at" ], name: "index_solid_queue_recurring_executions_on_task_key_and_run_at", unique: true
+  end
+
+  create_table "solid_queue_recurring_tasks", force: :cascade do |t|
+    t.string "key", null: false
+    t.string "schedule", null: false
+    t.string "command", limit: 2048
+    t.string "class_name"
+    t.text "arguments"
+    t.string "queue_name"
+    t.integer "priority", default: 0
+    t.boolean "static", default: true, null: false
+    t.text "description"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index [ "key" ], name: "index_solid_queue_recurring_tasks_on_key", unique: true
+    t.index [ "static" ], name: "index_solid_queue_recurring_tasks_on_static"
+  end
+
+  create_table "solid_queue_scheduled_executions", force: :cascade do |t|
+    t.bigint "job_id", null: false
+    t.string "queue_name", null: false
+    t.integer "priority", default: 0, null: false
+    t.datetime "scheduled_at", null: false
+    t.datetime "created_at", null: false
+    t.index [ "job_id" ], name: "index_solid_queue_scheduled_executions_on_job_id", unique: true
+    t.index [ "scheduled_at", "priority", "job_id" ], name: "index_solid_queue_dispatch_all"
+  end
+
+  create_table "solid_queue_semaphores", force: :cascade do |t|
+    t.string "key", null: false
+    t.integer "value", default: 1, null: false
+    t.datetime "expires_at", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index [ "expires_at" ], name: "index_solid_queue_semaphores_on_expires_at"
+    t.index [ "key", "value" ], name: "index_solid_queue_semaphores_on_key_and_value"
+    t.index [ "key" ], name: "index_solid_queue_semaphores_on_key", unique: true
+  end
+
+  add_foreign_key "solid_queue_blocked_executions", "solid_queue_jobs", column: "job_id", on_delete: :cascade
+  add_foreign_key "solid_queue_claimed_executions", "solid_queue_jobs", column: "job_id", on_delete: :cascade
+  add_foreign_key "solid_queue_failed_executions", "solid_queue_jobs", column: "job_id", on_delete: :cascade
+  add_foreign_key "solid_queue_ready_executions", "solid_queue_jobs", column: "job_id", on_delete: :cascade
+  add_foreign_key "solid_queue_recurring_executions", "solid_queue_jobs", column: "job_id", on_delete: :cascade
+  add_foreign_key "solid_queue_scheduled_executions", "solid_queue_jobs", column: "job_id", on_delete: :cascade
+end

data/db/schema.rb

@@ -0,0 +1,79 @@
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# This file is the source Rails uses to define your schema when running `bin/rails
+# db:schema:load`. When creating a new database, `bin/rails db:schema:load` tends to
+# be faster and is potentially less error prone than running all of your
+# migrations from scratch. Old migrations may fail to apply correctly if those
+# migrations use external dependencies or application code.
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema[8.0].define(version: 2025_08_18_214805) do
+  create_table "app_profiles", force: :cascade do |t|
+    t.string "name", null: false
+    t.string "api_key_digest", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["api_key_digest"], name: "index_app_profiles_on_api_key_digest", unique: true
+    t.index ["name"], name: "index_app_profiles_on_name"
+  end
+
+  create_table "optimization_suggestions", force: :cascade do |t|
+    t.integer "query_analysis_id", null: false
+    t.string "suggestion_type", null: false
+    t.string "title", null: false
+    t.text "description", null: false
+    t.text "sql_suggestion"
+    t.integer "priority", default: 1
+    t.boolean "implemented", default: false
+    t.json "metadata"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["implemented"], name: "index_optimization_suggestions_on_implemented"
+    t.index ["priority"], name: "index_optimization_suggestions_on_priority"
+    t.index ["query_analysis_id"], name: "index_optimization_suggestions_on_query_analysis_id"
+    t.index ["suggestion_type"], name: "index_optimization_suggestions_on_suggestion_type"
+  end
+
+  create_table "query_analyses", force: :cascade do |t|
+    t.integer "app_profile_id", null: false
+    t.text "sql_query", null: false
+    t.integer "duration_ms"
+    t.string "table_name"
+    t.string "query_type"
+    t.datetime "analyzed_at", null: false
+    t.string "query_hash"
+    t.json "parsed_data"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["analyzed_at"], name: "index_query_analyses_on_analyzed_at"
+    t.index ["app_profile_id"], name: "index_query_analyses_on_app_profile_id"
+    t.index ["duration_ms"], name: "index_query_analyses_on_duration_ms"
+    t.index ["query_hash"], name: "index_query_analyses_on_query_hash"
+    t.index ["query_type"], name: "index_query_analyses_on_query_type"
+    t.index ["table_name"], name: "index_query_analyses_on_table_name"
+  end
+
+  create_table "query_patterns", force: :cascade do |t|
+    t.string "pattern_type", null: false
+    t.string "table_name", null: false
+    t.string "column_name"
+    t.integer "frequency", default: 1
+    t.datetime "first_seen", null: false
+    t.datetime "last_seen", null: false
+    t.string "pattern_signature"
+    t.json "metadata"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["frequency"], name: "index_query_patterns_on_frequency"
+    t.index ["pattern_signature"], name: "index_query_patterns_on_pattern_signature", unique: true
+    t.index ["pattern_type", "table_name"], name: "index_query_patterns_on_pattern_type_and_table_name"
+    t.index ["pattern_type"], name: "index_query_patterns_on_pattern_type"
+    t.index ["table_name"], name: "index_query_patterns_on_table_name"
+  end
+
+  add_foreign_key "optimization_suggestions", "query_analyses"
+  add_foreign_key "query_analyses", "app_profiles"
+end

data/db/seeds.rb

@@ -0,0 +1,9 @@
+# This file should ensure the existence of records required to run the application in every environment (production,
+# development, test). The code here should be idempotent so that it can be executed at any point in every environment.
+# The data can then be loaded with the bin/rails db:seed command (or created alongside the database with db:setup).
+#
+# Example:
+#
+#   ["Action", "Comedy", "Drama", "Horror"].each do |genre_name|
+#     MovieGenre.find_or_create_by!(name: genre_name)
+#   end

data/init.sql

@@ -0,0 +1,9 @@
+-- Initialize PostgreSQL for Query Optimizer API
+-- This script runs when the database container starts for the first time
+
+-- Enable required extensions
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+CREATE EXTENSION IF NOT EXISTS "pg_stat_statements";
+
+-- Create database if it doesn't exist (handled by POSTGRES_DB env var)
+-- This file is mainly for any additional setup needed