rails-ai-context 0.8.3 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 850a9ebc40beb305b127b34872a6b7d9e82f67279629b43ba639ed434ae1f62f
-  data.tar.gz: 517f855b24c3d2b1c581e2b7c7f7d2597c360d7ce7ec749a7fe57301c39db1e8
+  metadata.gz: '08211bf465556a4185faaebc25d66fffcf4bd2e54ba335708b82c5e8d81f11f2'
+  data.tar.gz: 2ab947951eb10d48acc6d674c31cea3b2ab9104a6ca9a9f6e9c409ffa1f96a7a
 SHA512:
-  metadata.gz: 75446004fe5acc29bfd5ecfa6c3ef603ca00e698a9a59f81f3bf17a67f8ae94bfecbfc03fe5c1e34c5a2f1f931dd9ea6ff3e46bef501994a5935c4641f86b56a
-  data.tar.gz: 73fce749f524c13a913dbe928fe47f6b9ee66071ddc8a6218f5c52baad360a135100b52d4deed80c453bff9613f538761565760cbd9e9e81e6f8c4399a894c29
+  metadata.gz: 4757bd5de1b215938543d138b4c4a077ff7d1cda9dc25164e03251acd81afe26cd65cae9855cf879950b7a77e1f8aa78fb86e9a02d2e640e10569a9a5fc2bb45
+  data.tar.gz: b2ebb6584d2886ae60c587954fdd54687c9a23a74422c395ee3d1cec063d9c499c4094ea611f1b053100b27cdaa4a47c85da006d99354437e52b6459575aab7c

data/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.4] - 2026-03-19
+
+### Added
+
+- **`structure.sql` support** — the schema introspector now parses `db/structure.sql` when no `db/schema.rb` exists and no database connection is available. Extracts tables, columns (with SQL type normalization), indexes, and foreign keys from PostgreSQL dump format. Prefers `schema.rb` when both exist.
+- **Fingerprinter watches `db/structure.sql`** — file changes to `structure.sql` now trigger cache invalidation and live reload.
+
 ## [0.8.3] - 2026-03-19
 
 ### Changed

data/CLAUDE.md

@@ -39,7 +39,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (385 examples)
+bundle exec rspec           # Run specs (392 examples)
 bundle exec rubocop         # Lint
 ```
 

data/README.md

@@ -353,7 +353,7 @@ The gem parses `db/schema.rb` as text when no database is connected. Works in CI
 ```bash
 git clone https://github.com/crisnahine/rails-ai-context.git
 cd rails-ai-context && bundle install
-bundle exec rspec       # 385 examples
+bundle exec rspec       # 392 examples
 bundle exec rubocop     # Lint
 ```
 

data/demo_script.sh

@@ -8,7 +8,7 @@ echo 'Fetching gem metadata from https://rubygems.org...'
 sleep 0.3
 echo 'Resolving dependencies...'
 sleep 0.3
-echo 'Installing rails-ai-context 0.8.3'
+echo 'Installing rails-ai-context 0.8.4'
 echo ''
 sleep 1
 

data/lib/rails_ai_context/fingerprinter.rb

@@ -8,6 +8,7 @@ module RailsAiContext
   class Fingerprinter
     WATCHED_FILES = %w[
       db/schema.rb
+      db/structure.sql
       config/routes.rb
       config/database.yml
       Gemfile.lock

data/lib/rails_ai_context/introspectors/schema_introspector.rb

@@ -109,12 +109,24 @@ module RailsAiContext
         File.join(app.root, "db", "schema.rb")
       end
 
-      # Fallback: parse db/schema.rb as text when DB isn't connected
+      def structure_file_path
+        File.join(app.root, "db", "structure.sql")
+      end
+
+      # Fallback: parse schema file as text when DB isn't connected.
+      # Tries db/schema.rb first, then db/structure.sql.
       # This enables introspection in CI, Claude Code, etc.
       def static_schema_parse
-        path = schema_file_path
-        return { error: "No schema.rb found at #{path}" } unless File.exist?(path)
+        if File.exist?(schema_file_path)
+          parse_schema_rb(schema_file_path)
+        elsif File.exist?(structure_file_path)
+          parse_structure_sql(structure_file_path)
+        else
+          { error: "No db/schema.rb or db/structure.sql found" }
+        end
+      end
 
+      def parse_schema_rb(path)
         content = File.read(path)
         tables = {}
         current_table = nil
@@ -138,6 +150,81 @@ module RailsAiContext
           note: "Parsed from db/schema.rb (no DB connection)"
         }
       end
+
+      def parse_structure_sql(path) # rubocop:disable Metrics/MethodLength
+        content = File.read(path)
+        tables = {}
+
+        # Match CREATE TABLE blocks
+        content.scan(/CREATE TABLE (?:public\.)?(\w+)\s*\((.*?)\);/m) do |table_name, body|
+          next if table_name.start_with?("ar_internal_metadata", "schema_migrations")
+
+          columns = parse_sql_columns(body)
+          tables[table_name] = { columns: columns, indexes: [], foreign_keys: [] }
+        end
+
+        # Match CREATE INDEX / CREATE UNIQUE INDEX
+        content.scan(/CREATE (?:UNIQUE )?INDEX (\w+) ON (?:public\.)?(\w+).*?\((.+?)\)/m) do |idx_name, table, cols|
+          col_list = cols.scan(/\w+/).first
+          tables[table]&.dig(:indexes)&.push({ name: idx_name, columns: col_list })
+        end
+
+        # Match ALTER TABLE ... ADD CONSTRAINT ... FOREIGN KEY (handles multi-line)
+        content.scan(/ALTER TABLE\s+(?:ONLY\s+)?(?:public\.)?(\w+)\s+ADD CONSTRAINT.*?FOREIGN KEY\s*\((\w+)\)\s*REFERENCES\s+(?:public\.)?(\w+)\((\w+)\)/m) do |from, col, to, pk|
+          tables[from]&.dig(:foreign_keys)&.push({ from_table: from, to_table: to, column: col, primary_key: pk })
+        end
+
+        {
+          adapter: "static_parse",
+          tables: tables,
+          total_tables: tables.size,
+          note: "Parsed from db/structure.sql (no DB connection)"
+        }
+      end
+
+      # Parse column definitions from a CREATE TABLE body
+      def parse_sql_columns(body)
+        columns = []
+        body.each_line do |line|
+          line = line.strip.chomp(",").strip
+          next if line.empty?
+          next if line.match?(/\A(PRIMARY|CONSTRAINT|CHECK|UNIQUE|EXCLUDE|FOREIGN)\b/i)
+
+          # Match: column_name type_with_params [constraints]
+          if (match = line.match(/\A"?(\w+)"?\s+(.+)/))
+            col_name = match[1]
+            rest = match[2]
+            # Extract type: everything before NOT NULL, NULL, DEFAULT, etc.
+            col_type = rest.split(/\s+(?:NOT\s+NULL|NULL|DEFAULT|PRIMARY|UNIQUE|CONSTRAINT|CHECK)\b/i).first&.strip&.downcase
+            next unless col_type && !col_type.empty?
+            columns << { name: col_name, type: normalize_sql_type(col_type) }
+          end
+        end
+        columns
+      end
+
+      def normalize_sql_type(type)
+        case type
+        when /\Ainteger\z/i, /\Aint\z/i, /\Aint4\z/i then "integer"
+        when /\Abigint\z/i, /\Aint8\z/i then "bigint"
+        when /\Asmallint\z/i, /\Aint2\z/i then "smallint"
+        when /\Acharacter varying\z/i, /\Avarchar\z/i then "string"
+        when /\Atext\z/i then "text"
+        when /\Aboolean\z/i, /\Abool\z/i then "boolean"
+        when /\Atimestamp/i then "datetime"
+        when /\Adate\z/i then "date"
+        when /\Atime\z/i then "time"
+        when /\Anumeric\z/i, /\Adecimal\z/i then "decimal"
+        when /\Afloat/i, /\Adouble/i then "float"
+        when /\Ajsonb?\z/i then "json"
+        when /\Auuid\z/i then "uuid"
+        when /\Ainet\z/i then "inet"
+        when /\Acitext\z/i then "citext"
+        when /\Aarray\z/i then "array"
+        when /\Ahstore\z/i then "hstore"
+        else type
+        end
+      end
     end
   end
 end

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "0.8.3"
+  VERSION = "0.8.4"
 end

data/server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "0.8.3",
+  "version": "0.8.4",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.8.3/rails-ai-context-mcp.mcpb",
+      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.8.4/rails-ai-context-mcp.mcpb",
       "fileSha256": "dd711a0ad6c4de943ae4da94eaf59a6dc9494b9d57f726e24649ed4e2f156990",
       "transport": {
         "type": "stdio"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 0.8.3
+  version: 0.8.4
 platform: ruby
 authors:
 - crisnahine