@hiteshganjoo/rails-mcp-indexer/CHANGELOG.md

Rails MCP server with database schema awareness - parses both Ruby AST and db/schema.rb for complete Rails intelligence

# Changelog

All notable changes to Rails MCP Indexer will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.3.1] - 2025-09-01

### Fixed
- Improved connection reliability when path argument is not provided
- Better error messages when Rails project path is invalid
- Default to current working directory if no path specified
- Added Rails project validation (checks for Gemfile or app/ directory)

## [2.3.0] - 2025-09-01

### Added
- **Knowledge Graph**: Complete graph-based code navigation system
  - SQLite-backed graph store with nodes and edges tables
  - Automatic graph population from AST and database schema
  - Support for code relationships: inheritance, module inclusion, method definitions
  - Database relationships: tables, columns, foreign keys, indexes
  - Rails-specific edges: belongs_to, has_many, has_one, backs (model↔table)
- **New Graph Navigation Tools**:
  - `graph_find_nodes` - Search nodes by kind, key, or label
  - `graph_neighbors` - Traverse connected nodes with edge filtering
  - `graph_explain` - Get detailed node information and suggested actions
  - `get_definition` - Retrieve code snippets with context
  - `list_rails` - List Rails associations, validations, and callbacks
- **Graph Builder**: Intelligent graph construction from multiple sources
  - Extracts relationships from Ruby AST
  - Maps database schema to graph nodes
  - Infers model-to-table mappings using Rails conventions
  - Creates bidirectional relationship edges

### Enhanced
- Indexer now populates knowledge graph during AST parsing
- Database schema parsing feeds into graph structure
- Improved relationship tracking between code and database

## [2.2.0] - 2025-08-31

### Added
- **Database Schema Awareness**: Parses `db/schema.rb` to understand database structure
- **New MCP Tools**:
  - `db_tables` - List all database tables
  - `db_table` - Get detailed table information (columns, indexes, constraints)
  - `db_table_relations` - Find foreign key relationships
  - `db_suggest_associations` - Generate Rails associations from foreign keys
- **Rails Association Mapping**: Automatically suggests `belongs_to`, `has_many`, and `has_one` based on foreign keys
- **Validation Generation**: Suggests Rails validations based on database constraints
- **Schema Parser**: Extracts tables, columns, indexes, and foreign keys from schema.rb
- **SQLite Schema Storage**: Stores schema metadata for fast queries

### Changed
- Reindex now automatically parses schema.rb if present
- Enhanced database with schema-specific tables

## [1.0.6] - 2025-08-26

### Fixed
- **Critical**: Fixed MCP server connection issues by aligning with official MCP server pattern
  - Removed `main` field from package.json (official servers use `main: null`)
  - Renamed server.ts to index.ts following official convention
  - Updated all references from server.js to index.js
  - Server now properly responds to MCP protocol initialization messages

## [1.0.5] - 2025-08-25

### Fixed
- Updated bin executable name to mcp-server-rails-indexer

## [1.0.4] - 2025-08-25

### Fixed
- Fixed bin configuration in package.json

## [1.0.3] - 2025-08-25

### Fixed
- Removed stderr logging that could interfere with MCP communication

## [1.0.2] - 2025-08-25

### Fixed
- Fixed ES module compatibility issues

## [1.0.1] - 2025-08-25

### Changed
- Documentation improvements

## [1.0.0] - 2024-01-26

### Added
- Initial release of Rails MCP Indexer
- AST-based Ruby code parsing using Prism (Ruby 3.3+) or parser gem
- Full-text search with SQLite FTS5
- Rails-aware file type detection (models, controllers, services, etc.)
- MCP tools for code analysis:
  - `search_symbols` - Search for classes, methods, modules
  - `get_snippet` - Extract AST-aware code blocks
  - `call_graph` - Analyze method dependencies
  - `find_similar` - Find similar code patterns
  - `find_tests` - Locate test files for implementations
  - `reindex` - Update code index incrementally
- Incremental indexing for performance
- Comprehensive documentation and examples
- Setup script for easy installation
- PyPI package configuration

### Features
- Support for Ruby 2.7+ (optimized for Ruby 3.3+)
- Automatic exclusion of vendor/, node_modules/, tmp/, log/, .git/
- Rails pattern recognition (associations, validations, callbacks)
- Performance: ~100-150 files/second indexing speed
- Database size: ~10MB per 1000 files

### Credits
- Developed for the Ruby on Rails community