woods 1.6.1 → 2.0.0.beta2

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: woods
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 2.0.0.beta2
 platform: ruby
 authors:
 - Leah Armstrong
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-22 00:00:00.000000000 Z
+date: 2026-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mcp
@@ -16,34 +16,60 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: '1.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: '1.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.19.9
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.19.9
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: msgpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: 1.8.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: 1.8.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: prism
   requirement: !ruby/object:Gem::Requirement
@@ -65,6 +91,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -72,6 +101,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 description: |
   Woods extracts structured data from Rails applications for use in
   AI-assisted development tooling. It provides version-specific context by
@@ -94,6 +126,36 @@ files:
 - CONTRIBUTING.md
 - LICENSE.txt
 - README.md
+- SECURITY.md
+- assets/woods-wordmark-white-with-bg.png
+- docs/AGENT_GUIDE.md
+- docs/AGENT_SETUP.md
+- docs/BACKEND_MATRIX.md
+- docs/CONFIGURATION_REFERENCE.md
+- docs/CONSOLE_MCP_SETUP.md
+- docs/DOCKER_SETUP.md
+- docs/EMBEDDING_MODELS.md
+- docs/EVALUATION.md
+- docs/EXTRACTOR_REFERENCE.md
+- docs/FAQ.md
+- docs/GETTING_STARTED.md
+- docs/INCREMENTAL_EXTRACTION.md
+- docs/INTERNALS.md
+- docs/MCP_HTTP_TRANSPORT.md
+- docs/MCP_SERVERS.md
+- docs/MCP_TOOL_COOKBOOK.md
+- docs/MCP_WORKTREE_SETUP.md
+- docs/NOTION_INTEGRATION.md
+- docs/OBSIDIAN_INTEGRATION.md
+- docs/PUBLISHED_INDEX.md
+- docs/README.md
+- docs/RETRIEVAL_GUIDE.md
+- docs/TOKEN_BENCHMARK.md
+- docs/TROUBLESHOOTING.md
+- docs/UNBLOCKED_INTEGRATION.md
+- docs/UPGRADING_TO_2.md
+- docs/WATCH_DAEMON.md
+- docs/WHY_WOODS.md
 - exe/woods-console
 - exe/woods-console-mcp
 - exe/woods-mcp
@@ -105,6 +167,7 @@ files:
 - lib/generators/woods/templates/create_woods_tables.rb.erb
 - lib/generators/woods/templates/woods.rb.tt
 - lib/tasks/woods.rake
+- lib/tasks/woods_checks.rake
 - lib/tasks/woods_evaluation.rake
 - lib/woods.rb
 - lib/woods/ast.rb
@@ -118,15 +181,12 @@ files:
 - lib/woods/cache/cache_store.rb
 - lib/woods/cache/redis_cache_store.rb
 - lib/woods/cache/solid_cache_store.rb
+- lib/woods/change_set.rb
+- lib/woods/checks/generation_resolution.rb
+- lib/woods/checks/moved_messages.rb
 - lib/woods/chunking/chunk.rb
 - lib/woods/chunking/semantic_chunker.rb
-- lib/woods/console/adapters/cache_adapter.rb
-- lib/woods/console/adapters/good_job_adapter.rb
-- lib/woods/console/adapters/job_adapter.rb
-- lib/woods/console/adapters/sidekiq_adapter.rb
-- lib/woods/console/adapters/solid_queue_adapter.rb
 - lib/woods/console/audit_logger.rb
-- lib/woods/console/bridge.rb
 - lib/woods/console/bridge_protocol.rb
 - lib/woods/console/confirmation.rb
 - lib/woods/console/connection_manager.rb
@@ -136,6 +196,7 @@ files:
 - lib/woods/console/dispatch_pipeline.rb
 - lib/woods/console/embedded_executor.rb
 - lib/woods/console/eval_guard.rb
+- lib/woods/console/input_contract.rb
 - lib/woods/console/model_validator.rb
 - lib/woods/console/rack_middleware.rb
 - lib/woods/console/redactor.rb
@@ -152,6 +213,7 @@ files:
 - lib/woods/console/tools/tier2.rb
 - lib/woods/console/tools/tier3.rb
 - lib/woods/console/tools/tier4.rb
+- lib/woods/coordination/lock_heartbeat.rb
 - lib/woods/coordination/pipeline_lock.rb
 - lib/woods/cost_model.rb
 - lib/woods/cost_model/embedding_cost.rb
@@ -164,14 +226,27 @@ files:
 - lib/woods/db/migrations/004_create_snapshots.rb
 - lib/woods/db/migrations/005_create_snapshot_units.rb
 - lib/woods/db/migrations/006_rename_tables.rb
+- lib/woods/db/migrations/007_typed_snapshot_units.rb
 - lib/woods/db/migrator.rb
 - lib/woods/db/schema_version.rb
 - lib/woods/dependency_graph.rb
+- lib/woods/embedding/fake.rb
 - lib/woods/embedding/indexer.rb
 - lib/woods/embedding/openai.rb
 - lib/woods/embedding/provider.rb
 - lib/woods/embedding/text_preparer.rb
 - lib/woods/embedding/token_counter.rb
+- lib/woods/evaluation/ablation_agent_payload.rb
+- lib/woods/evaluation/ablation_executor.rb
+- lib/woods/evaluation/ablation_provenance.rb
+- lib/woods/evaluation/ablation_report_writer.rb
+- lib/woods/evaluation/ablation_runner.rb
+- lib/woods/evaluation/ablation_summary.rb
+- lib/woods/evaluation/ablation_task.rb
+- lib/woods/evaluation/ablation_task_set.rb
+- lib/woods/evaluation/ablation_timed_executor.rb
+- lib/woods/evaluation/ablation_worktree.rb
+- lib/woods/evaluation/baseline.rb
 - lib/woods/evaluation/baseline_runner.rb
 - lib/woods/evaluation/evaluator.rb
 - lib/woods/evaluation/metrics.rb
@@ -185,6 +260,7 @@ files:
 - lib/woods/extractors/behavioral_profile.rb
 - lib/woods/extractors/caching_extractor.rb
 - lib/woods/extractors/callback_analyzer.rb
+- lib/woods/extractors/component_discovery.rb
 - lib/woods/extractors/concern_extractor.rb
 - lib/woods/extractors/configuration_extractor.rb
 - lib/woods/extractors/controller_extractor.rb
@@ -197,17 +273,20 @@ files:
 - lib/woods/extractors/i18n_extractor.rb
 - lib/woods/extractors/job_extractor.rb
 - lib/woods/extractors/lib_extractor.rb
+- lib/woods/extractors/line_neutralizer.rb
 - lib/woods/extractors/mailer_extractor.rb
 - lib/woods/extractors/manager_extractor.rb
 - lib/woods/extractors/middleware_extractor.rb
 - lib/woods/extractors/migration_extractor.rb
 - lib/woods/extractors/model_extractor.rb
+- lib/woods/extractors/package_extractor.rb
 - lib/woods/extractors/phlex_extractor.rb
 - lib/woods/extractors/policy_extractor.rb
 - lib/woods/extractors/poro_extractor.rb
 - lib/woods/extractors/pundit_extractor.rb
 - lib/woods/extractors/rails_source_extractor.rb
 - lib/woods/extractors/rake_task_extractor.rb
+- lib/woods/extractors/reference_patterns.rb
 - lib/woods/extractors/route_extractor.rb
 - lib/woods/extractors/route_helper_resolver.rb
 - lib/woods/extractors/scheduled_job_extractor.rb
@@ -215,6 +294,7 @@ files:
 - lib/woods/extractors/service_extractor.rb
 - lib/woods/extractors/shared_dependency_scanner.rb
 - lib/woods/extractors/shared_utility_methods.rb
+- lib/woods/extractors/source_nesting.rb
 - lib/woods/extractors/state_machine_extractor.rb
 - lib/woods/extractors/test_mapping_extractor.rb
 - lib/woods/extractors/validator_extractor.rb
@@ -231,10 +311,10 @@ files:
 - lib/woods/flow_document.rb
 - lib/woods/flow_precomputer.rb
 - lib/woods/formatting/base.rb
-- lib/woods/formatting/claude_adapter.rb
-- lib/woods/formatting/generic_adapter.rb
-- lib/woods/formatting/gpt_adapter.rb
 - lib/woods/formatting/human_adapter.rb
+- lib/woods/gem_mapper.rb
+- lib/woods/generation.rb
+- lib/woods/git_command.rb
 - lib/woods/git_provenance.rb
 - lib/woods/graph_analyzer.rb
 - lib/woods/index_artifact.rb
@@ -244,26 +324,30 @@ files:
 - lib/woods/mcp/config_resolver.rb
 - lib/woods/mcp/errors.rb
 - lib/woods/mcp/index_reader.rb
+- lib/woods/mcp/index_reader_pinning.rb
 - lib/woods/mcp/origin_guard.rb
+- lib/woods/mcp/protocol_policy.rb
 - lib/woods/mcp/provider_probe.rb
 - lib/woods/mcp/renderers/claude_renderer.rb
 - lib/woods/mcp/renderers/json_renderer.rb
 - lib/woods/mcp/renderers/markdown_renderer.rb
 - lib/woods/mcp/renderers/plain_renderer.rb
 - lib/woods/mcp/server.rb
+- lib/woods/mcp/tasks/extension.rb
+- lib/woods/mcp/tasks/request_capture.rb
+- lib/woods/mcp/tasks/store.rb
+- lib/woods/mcp/tool_contract.rb
 - lib/woods/mcp/tool_response_renderer.rb
 - lib/woods/mcp/version_aware_tool_dispatch.rb
 - lib/woods/model_name_cache.rb
 - lib/woods/notion/client.rb
 - lib/woods/notion/exporter.rb
-- lib/woods/notion/mapper.rb
 - lib/woods/notion/mappers/column_mapper.rb
 - lib/woods/notion/mappers/migration_mapper.rb
 - lib/woods/notion/mappers/model_mapper.rb
 - lib/woods/notion/mappers/shared.rb
 - lib/woods/notion/rate_limiter.rb
-- lib/woods/observability/health_check.rb
-- lib/woods/observability/instrumentation.rb
+- lib/woods/notion/sync_manifest.rb
 - lib/woods/observability/structured_logger.rb
 - lib/woods/obsidian/errors.rb
 - lib/woods/obsidian/name_mapper.rb
@@ -273,7 +357,16 @@ files:
 - lib/woods/operator/error_escalator.rb
 - lib/woods/operator/pipeline_guard.rb
 - lib/woods/operator/status_reporter.rb
+- lib/woods/path_dispatcher.rb
+- lib/woods/payload_store.rb
+- lib/woods/published_index.rb
+- lib/woods/published_index/edge_shaper.rb
+- lib/woods/published_index/generation_catalog.rb
+- lib/woods/published_index/typed_unit_reader.rb
 - lib/woods/railtie.rb
+- lib/woods/railtie_support.rb
+- lib/woods/release.rb
+- lib/woods/reload_policy.rb
 - lib/woods/resilience/circuit_breaker.rb
 - lib/woods/resilience/index_validator.rb
 - lib/woods/resilience/retryable_provider.rb
@@ -296,6 +389,7 @@ files:
 - lib/woods/session_tracer/redis_store.rb
 - lib/woods/session_tracer/session_flow_assembler.rb
 - lib/woods/session_tracer/session_flow_document.rb
+- lib/woods/session_tracer/solid_cache_coordination.rb
 - lib/woods/session_tracer/solid_cache_store.rb
 - lib/woods/session_tracer/store.rb
 - lib/woods/storage/graph_store.rb
@@ -307,6 +401,7 @@ files:
 - lib/woods/storage/snapshotter/metadata.rb
 - lib/woods/storage/snapshotter/vector.rb
 - lib/woods/storage/vector_store.rb
+- lib/woods/storage_identity.rb
 - lib/woods/tasks.rb
 - lib/woods/temporal/json_snapshot_store.rb
 - lib/woods/temporal/snapshot_store.rb
@@ -318,16 +413,32 @@ files:
 - lib/woods/unblocked/sync_manifest.rb
 - lib/woods/update_check.rb
 - lib/woods/util/host_guard.rb
+- lib/woods/util/uuid5.rb
 - lib/woods/version.rb
+- lib/woods/watch/daemon.rb
+- lib/woods/watch/listen_watcher.rb
+- lib/woods/watch/polling_watcher.rb
+- lib/woods/watch/status.rb
+- lib/woods/watch/tree_scan.rb
+- lib/woods/watch/watcher.rb
+- plugin/.claude-plugin/plugin.json
+- plugin/hooks/hooks.json
+- plugin/hooks/woods-post-edit.sh
+- plugin/hooks/woods-session-start.sh
+- plugin/skills/woods-agent-enable/SKILL.md
+- plugin/skills/woods-diagnose/SKILL.md
+- plugin/skills/woods-investigate/SKILL.md
+- plugin/skills/woods-mcp-config/SKILL.md
+- plugin/skills/woods-setup/SKILL.md
 homepage: https://github.com/lost-in-the/woods
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/lost-in-the/woods
-  source_code_uri: https://github.com/lost-in-the/woods/tree/main
-  changelog_uri: https://github.com/lost-in-the/woods/blob/main/CHANGELOG.md
+  source_code_uri: https://github.com/lost-in-the/woods/tree/v2.0.0.beta2
+  changelog_uri: https://github.com/lost-in-the/woods/blob/v2.0.0.beta2/CHANGELOG.md
   bug_tracker_uri: https://github.com/lost-in-the/woods/issues
-  documentation_uri: https://github.com/lost-in-the/woods/tree/main/docs
+  documentation_uri: https://github.com/lost-in-the/woods/tree/v2.0.0.beta2/docs
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []

data/lib/woods/console/adapters/cache_adapter.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-module Woods
-  module Console
-    module Adapters
-      # Cache adapter that auto-detects the active cache store.
-      #
-      # Supports Redis, Solid Cache, memory, and file cache stores.
-      # Detection checks Rails.cache class name first, then falls back
-      # to checking for SolidCache constant.
-      #
-      # @example
-      #   CacheAdapter.detect  # => :redis
-      #   CacheAdapter.stats   # => { tool: 'cache_stats', params: {} }
-      #
-      module CacheAdapter
-        STORE_PATTERNS = {
-          'RedisCacheStore' => :redis,
-          'MemoryStore' => :memory,
-          'FileStore' => :file
-        }.freeze
-
-        module_function
-
-        # Detect the active cache store backend.
-        #
-        # @return [Symbol] One of :redis, :solid_cache, :memory, :file, :unknown
-        def detect
-          if defined?(::Rails) && ::Rails.respond_to?(:cache) && ::Rails.cache
-            class_name = ::Rails.cache.class.name.to_s
-            STORE_PATTERNS.each do |pattern, backend|
-              return backend if class_name.include?(pattern)
-            end
-          end
-
-          return :solid_cache if defined?(::SolidCache)
-
-          :unknown
-        end
-
-        # Get cache store statistics.
-        #
-        # @param namespace [String, nil] Cache namespace filter
-        # @return [Hash] Bridge request
-        def stats(namespace: nil)
-          { tool: 'cache_stats', params: { namespace: namespace }.compact }
-        end
-
-        # Get cache store info (backend type, configuration).
-        #
-        # @return [Hash] Bridge request
-        def info
-          { tool: 'cache_info', params: {} }
-        end
-      end
-    end
-  end
-end

data/lib/woods/console/adapters/good_job_adapter.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'job_adapter'
-
-module Woods
-  module Console
-    module Adapters
-      # Job backend adapter for GoodJob.
-      #
-      # Builds bridge requests for GoodJob queue stats, failure listing,
-      # job lookup, scheduled jobs, and retry operations.
-      #
-      # @example
-      #   adapter = GoodJobAdapter.new
-      #   adapter.queue_stats  # => { tool: 'good_job_queue_stats', params: {} }
-      #
-      class GoodJobAdapter < JobAdapter
-        # Check if GoodJob is available in the current environment.
-        #
-        # @return [Boolean]
-        def self.available?
-          !!defined?(::GoodJob)
-        end
-
-        private
-
-        def prefix
-          'good_job'
-        end
-      end
-    end
-  end
-end

data/lib/woods/console/adapters/job_adapter.rb

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-module Woods
-  module Console
-    module Adapters
-      # Base class for job backend adapters.
-      #
-      # Subclasses implement `self.available?` and a private `prefix` method.
-      # The prefix is used to build bridge tool names (e.g., "sidekiq_queue_stats").
-      #
-      # @example
-      #   class MyAdapter < JobAdapter
-      #     def self.available? = !!defined?(::MyQueue)
-      #     private
-      #     def prefix = 'my_queue'
-      #   end
-      #
-      class JobAdapter
-        # Get queue statistics (sizes, latencies).
-        #
-        # @return [Hash] Bridge request
-        def queue_stats
-          { tool: "#{prefix}_queue_stats", params: {} }
-        end
-
-        # List recent job failures.
-        #
-        # @param limit [Integer] Max failures (default: 10, max: 100)
-        # @return [Hash] Bridge request
-        def recent_failures(limit: 10)
-          limit = [limit, 100].min
-          { tool: "#{prefix}_recent_failures", params: { limit: limit } }
-        end
-
-        # Find a job by its ID.
-        #
-        # A nil id is dropped from the bridge request so downstream tools see
-        # a missing parameter rather than an explicit `nil` — symmetric with
-        # `CacheAdapter.stats(namespace: nil)`.
-        #
-        # @param id [Object, nil] Job ID
-        # @return [Hash] Bridge request
-        def find_job(id:)
-          { tool: "#{prefix}_find_job", params: { id: id }.compact }
-        end
-
-        # List scheduled jobs.
-        #
-        # @param limit [Integer] Max jobs (default: 20, max: 100)
-        # @return [Hash] Bridge request
-        def scheduled_jobs(limit: 20)
-          limit = [limit, 100].min
-          { tool: "#{prefix}_scheduled_jobs", params: { limit: limit } }
-        end
-
-        # Retry a failed job.
-        #
-        # A nil id is dropped from the bridge request — see #find_job.
-        #
-        # @param id [Object, nil] Job ID
-        # @return [Hash] Bridge request
-        def retry_job(id:)
-          { tool: "#{prefix}_retry_job", params: { id: id }.compact }
-        end
-
-        private
-
-        def prefix
-          raise NotImplementedError, "#{self.class}#prefix must be implemented"
-        end
-      end
-    end
-  end
-end

data/lib/woods/console/adapters/sidekiq_adapter.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'job_adapter'
-
-module Woods
-  module Console
-    module Adapters
-      # Job backend adapter for Sidekiq.
-      #
-      # Builds bridge requests for Sidekiq queue stats, failure listing,
-      # job lookup, scheduled jobs, and retry operations.
-      #
-      # @example
-      #   adapter = SidekiqAdapter.new
-      #   adapter.queue_stats  # => { tool: 'sidekiq_queue_stats', params: {} }
-      #
-      class SidekiqAdapter < JobAdapter
-        # Check if Sidekiq is available in the current environment.
-        #
-        # @return [Boolean]
-        def self.available?
-          !!defined?(::Sidekiq)
-        end
-
-        private
-
-        def prefix
-          'sidekiq'
-        end
-      end
-    end
-  end
-end

data/lib/woods/console/adapters/solid_queue_adapter.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'job_adapter'
-
-module Woods
-  module Console
-    module Adapters
-      # Job backend adapter for Solid Queue.
-      #
-      # Builds bridge requests for Solid Queue job stats, failure listing,
-      # job lookup, scheduled jobs, and retry operations.
-      #
-      # @example
-      #   adapter = SolidQueueAdapter.new
-      #   adapter.queue_stats  # => { tool: 'solid_queue_queue_stats', params: {} }
-      #
-      class SolidQueueAdapter < JobAdapter
-        # Check if Solid Queue is available in the current environment.
-        #
-        # @return [Boolean]
-        def self.available?
-          !!defined?(::SolidQueue)
-        end
-
-        private
-
-        def prefix
-          'solid_queue'
-        end
-      end
-    end
-  end
-end