codebase_index 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a55ea6a46950c68c6cc1b39f9008bbff466dea9e20d8b646564d4cc489060552
-  data.tar.gz: ca3f117e515fb14f2ec6069c4e6ef541b661e90f0e3d33daa9f9fab43afb746a
+  metadata.gz: eddea71f3c17946eac1fffac433f0b7802087020aa237be722e1c8ab9e29dfa5
+  data.tar.gz: '07316803c47bbc1823d8b25c22c16371a14c5b0c03669b805421a593f68b2845'
 SHA512:
-  metadata.gz: e9ff9f423902e1651540b9f933e9a1afab31b3b4ebb0347a368769a83aaf8c1a493e7a33ac68d14a7733753da085dc830e9509911d0bc49205b21e2e07d82de3
-  data.tar.gz: ab8630e12cd123cfeeeee6796d0529cdbaa0f8e6e8c0fb9d7d95dadf753b8a8fbb0d5e2136ff2353cc3aac8b0acb5f525f75f903bc777e86326468c6a759ae8a
+  metadata.gz: 674c4526b467daf98309ee5afcc4f89a080b40420f2532adcb923f87fa7c0969fde9e1373b72301326f0f25b81c49f0965460ff03fc17e8e3ae4cdb74b1100c2
+  data.tar.gz: f4417425c8964e176c9b804332f2fb6e31f53827c51cffdea4d0f8b084cbe5c953083496e6403059c6bea2dc2b2c1d87129ecf7d5231fad7b4c5a9d4b51b8339

data/lib/codebase_index.rb

@@ -1,246 +1,6 @@
 # frozen_string_literal: true
 
-# CodebaseIndex - Rails Codebase Indexing and Retrieval
-#
-# A system for extracting, indexing, and retrieving context from Rails codebases
-# to enable AI-assisted development, debugging, and analytics.
-#
-# ## Quick Start
-#
-#   # Extract codebase
-#   CodebaseIndex.extract!
-#
-#   # Or via rake
-#   bundle exec rake codebase_index:extract
-#
-# ## Configuration
-#
-#   CodebaseIndex.configure do |config|
-#     config.output_dir = Rails.root.join("tmp/codebase_index")
-#     config.max_context_tokens = 8000
-#     config.include_framework_sources = true
-#   end
-#
-require_relative 'codebase_index/version'
+warn '[DEPRECATION] The "codebase_index" gem has been renamed to "woods". ' \
+     'Please update your Gemfile: gem "woods"'
 
-module CodebaseIndex
-  class Error < StandardError; end
-  class ConfigurationError < Error; end
-  class ExtractionError < Error; end
-  class SessionTracerError < Error; end
-
-  CONFIG_MUTEX = Mutex.new
-
-  # ════════════════════════════════════════════════════════════════════════
-  # Configuration
-  # ════════════════════════════════════════════════════════════════════════
-
-  class Configuration
-    attr_accessor :embedding_model, :include_framework_sources, :gem_configs,
-                  :vector_store, :metadata_store, :graph_store, :embedding_provider, :log_level,
-                  :vector_store_options, :metadata_store_options, :embedding_options,
-                  :concurrent_extraction, :precompute_flows, :enable_snapshots,
-                  :session_tracer_enabled, :session_store, :session_id_proc, :session_exclude_paths,
-                  :console_mcp_enabled, :console_mcp_path, :console_redacted_columns,
-                  :notion_api_token, :notion_database_ids,
-                  :cache_store, :cache_options
-    attr_reader :max_context_tokens, :similarity_threshold, :extractors, :pretty_json, :context_format,
-                :cache_enabled
-
-    def initialize # rubocop:disable Metrics/MethodLength
-      @output_dir = nil # Resolved lazily; Rails.root is nil at require time
-      @embedding_model = 'text-embedding-3-small'
-      @max_context_tokens = 8000
-      @similarity_threshold = 0.7
-      @include_framework_sources = true
-      @gem_configs = {}
-      @extractors = %i[models controllers services components view_components jobs mailers graphql serializers
-                       managers policies validators rails_source]
-      @pretty_json = true
-      @concurrent_extraction = false
-      @precompute_flows = false
-      @enable_snapshots = false
-      @context_format = :markdown
-      @session_tracer_enabled = false
-      @session_store = nil
-      @session_id_proc = nil
-      @session_exclude_paths = []
-      @console_mcp_enabled = false
-      @console_mcp_path = '/mcp/console'
-      @console_redacted_columns = []
-      @notion_api_token = nil
-      @notion_database_ids = {}
-      @cache_enabled = false
-      @cache_store = nil      # :redis, :solid_cache, :memory, or a CacheStore instance
-      @cache_options = {}     # { redis: client, cache: store, ttl: { embeddings: 86400, ... } }
-    end
-
-    # @return [Pathname, String] Output directory, defaulting to Rails.root/tmp/codebase_index
-    def output_dir
-      @output_dir ||= defined?(Rails) && Rails.root ? Rails.root.join('tmp/codebase_index') : 'tmp/codebase_index'
-    end
-
-    # @param value [Object] Must respond to #to_s
-    # @raise [ConfigurationError] if value is nil
-    def output_dir=(value)
-      raise ConfigurationError, 'output_dir cannot be nil' if value.nil?
-
-      @output_dir = value
-    end
-
-    # @param value [Integer] Must be a positive Integer
-    # @raise [ConfigurationError] if value is not a positive Integer
-    def max_context_tokens=(value)
-      unless value.is_a?(Integer) && value.positive?
-        raise ConfigurationError, "max_context_tokens must be a positive Integer, got #{value.inspect}"
-      end
-
-      @max_context_tokens = value
-    end
-
-    # @param value [Numeric] Must be between 0.0 and 1.0 inclusive
-    # @raise [ConfigurationError] if value is out of range or not numeric
-    def similarity_threshold=(value)
-      raise ConfigurationError, "similarity_threshold must be Numeric, got #{value.inspect}" unless value.is_a?(Numeric)
-
-      float_val = value.to_f
-      unless float_val.between?(0.0, 1.0)
-        raise ConfigurationError, "similarity_threshold must be between 0.0 and 1.0, got #{value.inspect}"
-      end
-
-      @similarity_threshold = float_val
-    end
-
-    # @param value [Array<Symbol>] List of extractor names
-    # @raise [ConfigurationError] if value is not an Array of Symbols
-    def extractors=(value)
-      unless value.is_a?(Array) && value.all?(Symbol)
-        raise ConfigurationError, "extractors must be an Array of Symbols, got #{value.inspect}"
-      end
-
-      @extractors = value
-    end
-
-    # @param value [Boolean] Must be true or false
-    # @raise [ConfigurationError] if value is not a boolean
-    def pretty_json=(value)
-      validate_boolean!(:pretty_json, value)
-      @pretty_json = value
-    end
-
-    # @param value [Symbol] Must be one of :claude, :markdown, :plain, :json
-    # @raise [ConfigurationError] if value is not a valid format
-    def context_format=(value)
-      valid = %i[claude markdown plain json]
-      unless valid.include?(value)
-        raise ConfigurationError, "context_format must be one of #{valid.inspect}, got #{value.inspect}"
-      end
-
-      @context_format = value
-    end
-
-    # @param value [Boolean] Enable or disable the cache layer
-    # @raise [ConfigurationError] if value is not a boolean
-    def cache_enabled=(value)
-      validate_boolean!(:cache_enabled, value)
-      @cache_enabled = value
-    end
-
-    # Add a gem to be indexed
-    #
-    # @param gem_name [String] Name of the gem
-    # @param paths [Array<String>] Relative paths within the gem to index
-    # @param priority [Symbol] :high, :medium, or :low
-    def add_gem(gem_name, paths:, priority: :medium)
-      @gem_configs[gem_name] = { paths: paths, priority: priority }
-    end
-
-    private
-
-    def validate_boolean!(name, value)
-      return if value.is_a?(TrueClass) || value.is_a?(FalseClass)
-
-      raise ConfigurationError, "#{name} must be true or false, got #{value.inspect}"
-    end
-  end
-
-  # ════════════════════════════════════════════════════════════════════════
-  # Module Interface
-  # ════════════════════════════════════════════════════════════════════════
-
-  class << self
-    attr_accessor :configuration
-
-    def configure
-      CONFIG_MUTEX.synchronize do
-        self.configuration ||= Configuration.new
-        yield(configuration) if block_given?
-        configuration
-      end
-    end
-
-    # Configure the module using a named preset and optional block customization.
-    #
-    # Valid preset names: :local, :postgresql, :production
-    #
-    # @param name [Symbol] Preset name
-    # @yield [config] Optional block for further customization after preset is applied
-    # @yieldparam config [Configuration] The configuration object
-    # @return [Configuration] The applied configuration
-    def configure_with_preset(name)
-      CONFIG_MUTEX.synchronize do
-        self.configuration = Builder.preset_config(name)
-        yield configuration if block_given?
-        configuration
-      end
-    end
-
-    # Build a Retriever wired with adapters from the current configuration.
-    #
-    # @return [Retriever] A fully wired retriever instance
-    def build_retriever
-      Builder.new(configuration).build_retriever
-    end
-
-    # Retrieve context for a natural language query using the current configuration.
-    #
-    # @param query [String] Natural language query
-    # @param opts [Hash] Options passed through to the retriever (e.g., budget:)
-    # @return [Retriever::RetrievalResult] Retrieval result
-    def retrieve(query, **opts)
-      build_retriever.retrieve(query, **opts)
-    end
-
-    # Perform full extraction
-    #
-    # @param output_dir [String] Override output directory
-    # @return [Hash] Extraction results
-    def extract!(output_dir: nil)
-      require_relative 'codebase_index/extractor'
-
-      dir = output_dir || configuration.output_dir
-      extractor = Extractor.new(output_dir: dir)
-      extractor.extract_all
-    end
-
-    # Perform incremental extraction
-    #
-    # @param changed_files [Array<String>] List of changed files
-    # @return [Array<String>] Re-extracted unit identifiers
-    def extract_changed!(changed_files)
-      require_relative 'codebase_index/extractor'
-
-      extractor = Extractor.new(output_dir: configuration.output_dir)
-      extractor.extract_changed(changed_files)
-    end
-  end
-
-  # Initialize with defaults
-  configure
-end
-
-require_relative 'codebase_index/builder'
-require_relative 'codebase_index/cost_model'
-require_relative 'codebase_index/cache/cache_store'
-require_relative 'codebase_index/cache/cache_middleware'
-require_relative 'codebase_index/railtie' if defined?(Rails::Railtie)
+require 'woods'

metadata

@@ -1,253 +1,59 @@
 --- !ruby/object:Gem::Specification
 name: codebase_index
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Leah Armstrong
-autorequire:
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2026-03-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: mcp
+  name: woods
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
-- !ruby/object:Gem::Dependency
-  name: railties
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '6.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '6.1'
+        version: '1.0'
 description: |
-  CodebaseIndex extracts structured data from Rails applications for use in
-  AI-assisted development tooling. It provides version-specific context by
-  running inside Rails to leverage runtime introspection, inlining concerns,
-  mapping routes to controllers, and indexing the exact Rails/gem source
-  versions in use.
+  This gem has been renamed to "woods". Install "woods" instead.
+  This shim exists only to notify existing users of the rename.
 email:
 - info@leah.wtf
-executables:
-- codebase-index-mcp
-- codebase-index-mcp-start
-- codebase-console-mcp
-- codebase-console
-- codebase-index-mcp-http
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- LICENSE.txt
-- README.md
-- exe/codebase-console
-- exe/codebase-console-mcp
-- exe/codebase-index-mcp
-- exe/codebase-index-mcp-http
-- exe/codebase-index-mcp-start
 - lib/codebase_index.rb
-- lib/codebase_index/ast.rb
-- lib/codebase_index/ast/call_site_extractor.rb
-- lib/codebase_index/ast/method_extractor.rb
-- lib/codebase_index/ast/node.rb
-- lib/codebase_index/ast/parser.rb
-- lib/codebase_index/builder.rb
-- lib/codebase_index/cache/cache_middleware.rb
-- lib/codebase_index/cache/cache_store.rb
-- lib/codebase_index/cache/redis_cache_store.rb
-- lib/codebase_index/cache/solid_cache_store.rb
-- lib/codebase_index/chunking/chunk.rb
-- lib/codebase_index/chunking/semantic_chunker.rb
-- lib/codebase_index/console/adapters/cache_adapter.rb
-- lib/codebase_index/console/adapters/good_job_adapter.rb
-- lib/codebase_index/console/adapters/job_adapter.rb
-- lib/codebase_index/console/adapters/sidekiq_adapter.rb
-- lib/codebase_index/console/adapters/solid_queue_adapter.rb
-- lib/codebase_index/console/audit_logger.rb
-- lib/codebase_index/console/bridge.rb
-- lib/codebase_index/console/confirmation.rb
-- lib/codebase_index/console/connection_manager.rb
-- lib/codebase_index/console/console_response_renderer.rb
-- lib/codebase_index/console/embedded_executor.rb
-- lib/codebase_index/console/model_validator.rb
-- lib/codebase_index/console/rack_middleware.rb
-- lib/codebase_index/console/safe_context.rb
-- lib/codebase_index/console/server.rb
-- lib/codebase_index/console/sql_validator.rb
-- lib/codebase_index/console/tools/tier1.rb
-- lib/codebase_index/console/tools/tier2.rb
-- lib/codebase_index/console/tools/tier3.rb
-- lib/codebase_index/console/tools/tier4.rb
-- lib/codebase_index/coordination/pipeline_lock.rb
-- lib/codebase_index/cost_model.rb
-- lib/codebase_index/cost_model/embedding_cost.rb
-- lib/codebase_index/cost_model/estimator.rb
-- lib/codebase_index/cost_model/provider_pricing.rb
-- lib/codebase_index/cost_model/storage_cost.rb
-- lib/codebase_index/db/migrations/001_create_units.rb
-- lib/codebase_index/db/migrations/002_create_edges.rb
-- lib/codebase_index/db/migrations/003_create_embeddings.rb
-- lib/codebase_index/db/migrations/004_create_snapshots.rb
-- lib/codebase_index/db/migrations/005_create_snapshot_units.rb
-- lib/codebase_index/db/migrator.rb
-- lib/codebase_index/db/schema_version.rb
-- lib/codebase_index/dependency_graph.rb
-- lib/codebase_index/embedding/indexer.rb
-- lib/codebase_index/embedding/openai.rb
-- lib/codebase_index/embedding/provider.rb
-- lib/codebase_index/embedding/text_preparer.rb
-- lib/codebase_index/evaluation/baseline_runner.rb
-- lib/codebase_index/evaluation/evaluator.rb
-- lib/codebase_index/evaluation/metrics.rb
-- lib/codebase_index/evaluation/query_set.rb
-- lib/codebase_index/evaluation/report_generator.rb
-- lib/codebase_index/extracted_unit.rb
-- lib/codebase_index/extractor.rb
-- lib/codebase_index/extractors/action_cable_extractor.rb
-- lib/codebase_index/extractors/ast_source_extraction.rb
-- lib/codebase_index/extractors/behavioral_profile.rb
-- lib/codebase_index/extractors/caching_extractor.rb
-- lib/codebase_index/extractors/callback_analyzer.rb
-- lib/codebase_index/extractors/concern_extractor.rb
-- lib/codebase_index/extractors/configuration_extractor.rb
-- lib/codebase_index/extractors/controller_extractor.rb
-- lib/codebase_index/extractors/database_view_extractor.rb
-- lib/codebase_index/extractors/decorator_extractor.rb
-- lib/codebase_index/extractors/engine_extractor.rb
-- lib/codebase_index/extractors/event_extractor.rb
-- lib/codebase_index/extractors/factory_extractor.rb
-- lib/codebase_index/extractors/graphql_extractor.rb
-- lib/codebase_index/extractors/i18n_extractor.rb
-- lib/codebase_index/extractors/job_extractor.rb
-- lib/codebase_index/extractors/lib_extractor.rb
-- lib/codebase_index/extractors/mailer_extractor.rb
-- lib/codebase_index/extractors/manager_extractor.rb
-- lib/codebase_index/extractors/middleware_extractor.rb
-- lib/codebase_index/extractors/migration_extractor.rb
-- lib/codebase_index/extractors/model_extractor.rb
-- lib/codebase_index/extractors/phlex_extractor.rb
-- lib/codebase_index/extractors/policy_extractor.rb
-- lib/codebase_index/extractors/poro_extractor.rb
-- lib/codebase_index/extractors/pundit_extractor.rb
-- lib/codebase_index/extractors/rails_source_extractor.rb
-- lib/codebase_index/extractors/rake_task_extractor.rb
-- lib/codebase_index/extractors/route_extractor.rb
-- lib/codebase_index/extractors/scheduled_job_extractor.rb
-- lib/codebase_index/extractors/serializer_extractor.rb
-- lib/codebase_index/extractors/service_extractor.rb
-- lib/codebase_index/extractors/shared_dependency_scanner.rb
-- lib/codebase_index/extractors/shared_utility_methods.rb
-- lib/codebase_index/extractors/state_machine_extractor.rb
-- lib/codebase_index/extractors/test_mapping_extractor.rb
-- lib/codebase_index/extractors/validator_extractor.rb
-- lib/codebase_index/extractors/view_component_extractor.rb
-- lib/codebase_index/extractors/view_template_extractor.rb
-- lib/codebase_index/feedback/gap_detector.rb
-- lib/codebase_index/feedback/store.rb
-- lib/codebase_index/filename_utils.rb
-- lib/codebase_index/flow_analysis/operation_extractor.rb
-- lib/codebase_index/flow_analysis/response_code_mapper.rb
-- lib/codebase_index/flow_assembler.rb
-- lib/codebase_index/flow_document.rb
-- lib/codebase_index/flow_precomputer.rb
-- lib/codebase_index/formatting/base.rb
-- lib/codebase_index/formatting/claude_adapter.rb
-- lib/codebase_index/formatting/generic_adapter.rb
-- lib/codebase_index/formatting/gpt_adapter.rb
-- lib/codebase_index/formatting/human_adapter.rb
-- lib/codebase_index/graph_analyzer.rb
-- lib/codebase_index/mcp/bootstrapper.rb
-- lib/codebase_index/mcp/index_reader.rb
-- lib/codebase_index/mcp/renderers/claude_renderer.rb
-- lib/codebase_index/mcp/renderers/json_renderer.rb
-- lib/codebase_index/mcp/renderers/markdown_renderer.rb
-- lib/codebase_index/mcp/renderers/plain_renderer.rb
-- lib/codebase_index/mcp/server.rb
-- lib/codebase_index/mcp/tool_response_renderer.rb
-- lib/codebase_index/model_name_cache.rb
-- lib/codebase_index/notion/client.rb
-- lib/codebase_index/notion/exporter.rb
-- lib/codebase_index/notion/mapper.rb
-- lib/codebase_index/notion/mappers/column_mapper.rb
-- lib/codebase_index/notion/mappers/migration_mapper.rb
-- lib/codebase_index/notion/mappers/model_mapper.rb
-- lib/codebase_index/notion/mappers/shared.rb
-- lib/codebase_index/notion/rate_limiter.rb
-- lib/codebase_index/observability/health_check.rb
-- lib/codebase_index/observability/instrumentation.rb
-- lib/codebase_index/observability/structured_logger.rb
-- lib/codebase_index/operator/error_escalator.rb
-- lib/codebase_index/operator/pipeline_guard.rb
-- lib/codebase_index/operator/status_reporter.rb
-- lib/codebase_index/railtie.rb
-- lib/codebase_index/resilience/circuit_breaker.rb
-- lib/codebase_index/resilience/index_validator.rb
-- lib/codebase_index/resilience/retryable_provider.rb
-- lib/codebase_index/retrieval/context_assembler.rb
-- lib/codebase_index/retrieval/query_classifier.rb
-- lib/codebase_index/retrieval/ranker.rb
-- lib/codebase_index/retrieval/search_executor.rb
-- lib/codebase_index/retriever.rb
-- lib/codebase_index/ruby_analyzer.rb
-- lib/codebase_index/ruby_analyzer/class_analyzer.rb
-- lib/codebase_index/ruby_analyzer/dataflow_analyzer.rb
-- lib/codebase_index/ruby_analyzer/fqn_builder.rb
-- lib/codebase_index/ruby_analyzer/mermaid_renderer.rb
-- lib/codebase_index/ruby_analyzer/method_analyzer.rb
-- lib/codebase_index/ruby_analyzer/trace_enricher.rb
-- lib/codebase_index/session_tracer/file_store.rb
-- lib/codebase_index/session_tracer/middleware.rb
-- lib/codebase_index/session_tracer/redis_store.rb
-- lib/codebase_index/session_tracer/session_flow_assembler.rb
-- lib/codebase_index/session_tracer/session_flow_document.rb
-- lib/codebase_index/session_tracer/solid_cache_store.rb
-- lib/codebase_index/session_tracer/store.rb
-- lib/codebase_index/storage/graph_store.rb
-- lib/codebase_index/storage/metadata_store.rb
-- lib/codebase_index/storage/pgvector.rb
-- lib/codebase_index/storage/qdrant.rb
-- lib/codebase_index/storage/vector_store.rb
-- lib/codebase_index/temporal/json_snapshot_store.rb
-- lib/codebase_index/temporal/snapshot_store.rb
-- lib/codebase_index/token_utils.rb
-- lib/codebase_index/version.rb
-- lib/generators/codebase_index/install_generator.rb
-- lib/generators/codebase_index/pgvector_generator.rb
-- lib/generators/codebase_index/templates/add_pgvector_to_codebase_index.rb.erb
-- lib/generators/codebase_index/templates/create_codebase_index_tables.rb.erb
-- lib/tasks/codebase_index.rake
-- lib/tasks/codebase_index_evaluation.rake
-homepage: https://github.com/LeahArmstrong/codebase_index
+homepage: https://github.com/lost-in-the/woods
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/LeahArmstrong/codebase_index
-  source_code_uri: https://github.com/LeahArmstrong/codebase_index/tree/main
-  changelog_uri: https://github.com/LeahArmstrong/codebase_index/blob/main/CHANGELOG.md
-  bug_tracker_uri: https://github.com/LeahArmstrong/codebase_index/issues
-  documentation_uri: https://github.com/LeahArmstrong/codebase_index/tree/main/docs
+  homepage_uri: https://github.com/lost-in-the/woods
+  source_code_uri: https://github.com/lost-in-the/woods
+  changelog_uri: https://github.com/lost-in-the/woods/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: |
+  ╔══════════════════════════════════════════════════════════════╗
+  ║  codebase_index has been renamed to "woods"                 ║
+  ║                                                             ║
+  ║  Please update your Gemfile:                                ║
+  ║    gem 'woods'          # was: gem 'codebase_index'         ║
+  ║                                                             ║
+  ║  And update your require:                                   ║
+  ║    require 'woods'      # was: require 'codebase_index'     ║
+  ║                                                             ║
+  ║  This shim will be removed in a future version.             ║
+  ║  https://github.com/lost-in-the/woods                       ║
+  ╚══════════════════════════════════════════════════════════════╝
 rdoc_options: []
 require_paths:
 - lib
@@ -262,8 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
-summary: Rails codebase extraction and indexing for AI-assisted development
+summary: '[DEPRECATED] Use the "woods" gem instead'
 test_files: []

data/CHANGELOG.md

@@ -1,89 +0,0 @@
-# Changelog
-
-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.3.1] - 2026-03-04
-
-### Fixed
-
-- **Gemspec version** now reads from `version.rb` instead of being hardcoded — prevents version mismatch during gem builds
-- **Release workflow** replaced `rake release` (fails on tag-triggered detached HEAD) with `gem build` + `gem push`
-
-## [0.3.0] - 2026-03-04
-
-### Added
-
-- **Redis/SolidCache caching layer** for retrieval pipeline with TTL, namespace isolation, and nil-caching
-- **Engine classification** — engines tagged as `:framework` or `:application` based on install path (handles Docker vendor paths)
-- **Graph analysis staleness tracking** — `generated_at` timestamp and `graph_sha` for detecting stale analysis
-- **Docker setup guide** (`docs/DOCKER_SETUP.md`) — split architecture, volume mounts, bridge mode, troubleshooting
-- **Context7 documentation suite** — 10 new user-facing docs optimized for AI retrieval: FAQ, Troubleshooting, Architecture, Extractor Reference, WHY CodebaseIndex, MCP Tool Cookbook, and 3 Context7 skills
-- **`context7.json`** configuration for controlling Context7 indexing scope
-
-### Fixed
-
-- **Vendor path leak** in source file resolution across 9 extractors — framework gems under `vendor/bundle` no longer produce empty source
-- **Prism cross-version compatibility** — handle API differences between Prism versions
-- **`schema_sha`** now supports `db/structure.sql` fallback (not just `db/schema.rb`)
-- **ViewComponent extractor** skips framework-internal components with no resolvable source file
-- **HTTP connection reuse** and retry handling in embedding providers
-- **DependencyGraph `to_h`** returns a dup to prevent cache pollution
-- **MCP tool counts** corrected across all documentation (27 index / 31 console)
-- **TROUBLESHOOTING.md** corrected: `config.extractors` controls retrieval scope, not which extractors run
-
-### Changed
-
-- **README streamlined** from 620 to 325 lines — added Quick Start, Documentation table; removed verbose sections in favor of links to dedicated docs
-- **Internal rake tasks** (`retrieve`, `self_analyze`) hidden from `rails -T`
-- **Estimated tokens memoization** removed to prevent stale values after source changes
-- **Simplification sweep** — dead code removal, shared helper extraction, bug fixes across caching and retrieval layers
-
-### Performance
-
-- Critical hotspots fixed across extraction, storage, and retrieval pipelines
-- `fetch_key` optimization for falsy value handling in cache layer
-
-## [0.2.1] - 2026-02-19
-
-### Changed
-
-- Switch release workflow to RubyGems trusted publishing
-
-## [0.2.0] - 2026-02-19
-
-### Added
-
-- **Embedded console MCP server** for zero-config Rails querying (no bridge process needed)
-- **Console MCP setup guide** (`docs/CONSOLE_MCP_SETUP.md`) — stdio, Docker, HTTP/Rack, SSH bridge options
-- **CODEOWNERS** and issue template configuration
-
-### Fixed
-
-- MCP gem compatibility and symbol key handling in embedded executor
-- Duplicate URI warning in gemspec
-
-## [0.1.0] - 2026-02-18
-
-### Added
-
-- **Extraction layer** with 13 extractors: Model, Controller, Service, Job, Mailer, Phlex, ViewComponent, GraphQL, Serializer, Manager, Policy, Validator, RailsSource
-- **Dependency graph** with PageRank scoring and GraphAnalyzer (orphans, hubs, cycles, bridges)
-- **Storage interfaces** with InMemory, SQLite, Pgvector, and Qdrant adapters
-- **Embedding pipeline** with OpenAI and Ollama providers, TextPreparer, resumable Indexer
-- **Semantic chunking** with type-aware splitting (model sections, controller per-action)
-- **Context formatting** adapters for Claude, GPT, generic LLMs, and humans
-- **Retrieval pipeline** with QueryClassifier, SearchExecutor, RRF Ranker, ContextAssembler
-- **Retriever orchestrator** with degradation tiers and RetrievalTrace
-- **Schema management** with versioned migrations and Rails generators
-- **Observability** with ActiveSupport::Notifications instrumentation, structured logging, health checks
-- **Resilience** with CircuitBreaker, RetryableProvider, IndexValidator
-- **MCP Index Server** (21 tools) for AI agent codebase retrieval
-- **Console MCP Server** (31 tools across 4 tiers) for live Rails data access
-- **AST layer** with Prism adapter for method extraction and call site analysis
-- **RubyAnalyzer** for class, method, and data flow analysis
-- **Flow extraction** with FlowAssembler, OperationExtractor, FlowDocument
-- **Evaluation harness** with Precision@k, Recall, MRR metrics and baseline comparisons
-- **Rake tasks** for extraction, incremental indexing, framework source, validation, stats, evaluation