woods 1.6.4 → 2.0.0.beta1

data/plugin/skills/woods-mcp-config/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: woods-mcp-config
+description: Configure Woods MCP connections with the exact client JSON shapes and token rules — the Index Server over stdio or Docker, and the authorized Console server over stdio or authenticated HTTP. Use when wiring a Woods server into any MCP client configuration (.mcp.json, Claude Code, desktop clients), pointing an agent at a Rails app's index, or enabling live-data Console access.
+---
+
+# Woods MCP configuration
+
+## Preflight
+
+```bash
+bundle info woods
+bin/rails woods:validate
+bin/rails woods:stats
+```
+
+This skill describes the Woods 2.x line; the authoritative minimum version lives in the marketplace entry. Operate only against capabilities the recorded installed version provides. Detect the MCP client, app root, host vs Docker Rails process, the filesystem context that contains the application bundle and index, and whether live-data access is actually required.
+
+Default to Index-only. It reads generated code context and exposes 14 tools. Console MCP boots Rails and reads live data; ask before enabling it.
+
+## Shape 1: Index-only
+
+```json
+{
+  "mcpServers": {
+    "woods": {
+      "command": "bundle",
+      "args": ["exec", "woods-mcp-start", "./tmp/woods"],
+      "cwd": "/absolute/path/to/app"
+    }
+  }
+}
+```
+
+Use this shape for any stdio-capable MCP client, adapted to the client's configuration location. `woods-mcp-start` validates and launches; it does not install or auto-restart.
+
+When Woods is installed only in Docker, prefer running the server through the application container:
+
+```json
+{
+  "mcpServers": {
+    "woods": {
+      "command": "docker",
+      "args": ["compose", "exec", "-T", "app", "bundle", "exec", "woods-mcp", "/app/tmp/woods"],
+      "cwd": "/absolute/host/path/to/app"
+    }
+  }
+}
+```
+
+Use a host-side bundle only after verifying Ruby, the application bundle, and the index are available on the host. Always pass the path visible to the process that runs `woods-mcp`.
+
+A read-only index mount is sufficient for structural tools. The `reload` tool for in-memory semantic retrieval also takes Woods' shared on-disk writer lock, so the MCP process needs write access to the index directory. Without it, reload returns a typed degraded error and keeps serving the previous aligned generation. Either grant that access or restart the MCP process after publishing a new embedded index.
+
+## Shape 2: Index plus authorized Console
+
+After explicit authorization, enable the live-data master switch in the Rails initializer. The process exits while it remains false:
+
+```ruby
+Woods.configure do |config|
+  config.console_mcp_enabled = true
+  config.console_mcp_token = ENV["WOODS_CONSOLE_MCP_TOKEN"]
+end
+```
+
+The token authenticates HTTP requests and is not sent by a stdio client. Production Rails boot still requires `WOODS_CONSOLE_MCP_TOKEN` to contain at least 32 characters whenever Console is enabled, including for a stdio-only setup. Keep it in the application's secret store. Outside production, omitting it warns and leaves the Console HTTP endpoint guarded with 401.
+
+Then add a direct Console process:
+
+```json
+"woods-console": {
+  "command": "bundle",
+  "args": ["exec", "woods-console-mcp"],
+  "cwd": "/absolute/path/to/app"
+}
+```
+
+For Docker/SSH, configure `~/.woods/console.yml` or `WOODS_CONSOLE_CONFIG`; the launcher owns process replacement. Direct Docker stdio uses `docker exec -i`, or `docker compose exec -T` to disable Compose's pseudo-TTY while retaining stdin.
+
+Console registers nine default tools. `config.console_embedded_read_tools = true` explicitly adds `console_sql` and `console_query` for eleven total. Tier 2, Tier 3, and `console_eval` are inventory-only in supported packaged modes.
+
+## Shape 3: Authenticated Console HTTP
+
+Use only after authorization and server-side setup:
+
+```json
+"woods-console": {
+  "type": "streamable-http",
+  "url": "https://app.example.test/mcp/console",
+  "headers": { "Authorization": "Bearer <token>" }
+}
+```
+
+Require `console_mcp_enabled`, a strong token, allowed origins, TLS, and the Console security controls. Never commit the token or expose an unauthenticated listener.
+
+## Verify
+
+Reconnect through the client so it performs its supported MCP negotiation. Clients on current MCP protocol revisions use per-request metadata/discovery; older clients initialize first — the server supports both. Call `woods_status`, `search`, and `lookup`. For Console, inspect the registered list and call `console_status` only in the authorized environment.
+
+Do not use an isolated raw JSON-RPC request as proof of MCP health. Do not claim conditional Index or inventory-only Console schemas are callable.
+
+Canonical guide: [MCP_SERVERS.md](https://github.com/lost-in-the/woods/blob/main/docs/MCP_SERVERS.md).

data/plugin/skills/woods-setup/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: woods-setup
+description: Install, upgrade, and first-run-configure the Woods Rails code-intelligence gem — Gemfile entry, generator, extraction, index verification, MCP registration, and the 1.x-to-2.x upgrade path. Use whenever a user wants Woods added to or upgraded in a Rails app, or asks for a runtime-accurate codebase index for AI tools, even without naming Woods' components.
+---
+
+# Woods setup
+
+Install a structural Index Server first. Embeddings and Console MCP are separate opt-ins.
+
+## Preflight
+
+Read repository instructions and preserve unrelated changes. Record:
+
+```bash
+git status --short --branch
+ruby --version
+bundle exec rails --version
+bundle info woods 2>/dev/null || true
+bundle exec rails runner 'puts Rails.application.class.name'
+```
+
+This skill describes the Woods 2.x line; the authoritative minimum version lives in the marketplace entry. Operate only against capabilities the recorded installed version provides, and for an older gem use the documentation on that version's tag. Determine host vs Docker execution, database adapter, migration policy, existing Woods config/tables, and which filesystem context contains the application bundle and `tmp/woods/`.
+
+## Install and inspect
+
+Add `gem "woods", "~> 2.0"` to the development group, then:
+
+```bash
+bundle install
+bundle exec ruby -rwoods/version -e 'puts Woods::VERSION'
+bin/rails generate woods:install
+git diff -- config/initializers/woods.rb db/migrate
+```
+
+The generator creates an initializer and a legacy application migration for `woods_units`, `woods_edges`, and `woods_embeddings`. Woods 2's shipped structural index and storage backends do not use those application tables. For a new default installation, propose removing the generated migration and obtain approval first. Keep or run it only when repository history proves an older/custom integration uses those tables, after normal migration authorization and conflict checks.
+
+Do not broadly update gems or overwrite existing configuration.
+
+## Upgrading from 1.x
+
+When the preflight records an installed 1.x version, this is an upgrade, not an install. Woods 2.0 changes observable index identifiers, the publication layout, vector-store reconciliation, and the supported MCP surface, so plan a clean re-index and follow the canonical runbook: [UPGRADING_TO_2.md](https://github.com/lost-in-the/woods/blob/main/docs/UPGRADING_TO_2.md).
+
+Before changing the Gemfile: back up any shared or durable index and agree on a rollback window — never upgrade one in place. After `bundle update woods`, run a full `bin/rails woods:extract` (not incremental; the old index is not a valid baseline across the major), then `woods:validate`. With embeddings configured, re-embed from scratch into a store matching the configured model; expect identifier-level churn in anything that consumed 1.x identifiers (exports, saved queries, downstream tooling). Verify MCP clients against the new surface rather than assuming 1.x tool behavior.
+
+## Extract and verify
+
+Structural setup needs no embedding provider:
+
+```bash
+bin/rails woods:extract
+bin/rails woods:validate
+bin/rails woods:stats
+```
+
+If extraction fails, reproduce Rails boot and eager loading first. Do not inspect internal payload files when Woods tasks provide the check.
+
+Configure the Index Server with the application bundle, absolute app `cwd`, and an index path visible to that process. For a host-installed bundle:
+
+```json
+{
+  "mcpServers": {
+    "woods": {
+      "command": "bundle",
+      "args": ["exec", "woods-mcp-start", "./tmp/woods"],
+      "cwd": "/absolute/path/to/app"
+    }
+  }
+}
+```
+
+When Woods is installed only in Docker, launch it through the application service instead:
+
+```json
+{
+  "mcpServers": {
+    "woods": {
+      "command": "docker",
+      "args": ["compose", "exec", "-T", "app", "bundle", "exec", "woods-mcp", "/app/tmp/woods"],
+      "cwd": "/absolute/host/path/to/app"
+    }
+  }
+}
+```
+
+Reconnect and call `woods_status`, then `search`, `lookup`, and `dependents` for a known class. The normal Index Server has 14 tools. `codebase_retrieve` requires configured embeddings.
+
+Offer to add `bundle exec rake woods:watch` to the existing development process manager. When authorized, it catches up missed changes and automatically maintains the structural index; the Index Server refreshes on its next call, so ordinary edits need no manual extraction or MCP restart. State that boot-captured changes require supervisor restart, Docker may need `WOODS_WATCH_POLL=1`, and semantic vectors still need `woods:embed_incremental`.
+
+The plugin also ships two hooks (Woods 2.3 or later), shipped disabled. A `PostToolUse` hook runs `woods:incremental` in the background when an edit touches models, routes, migrations, schema, or a `package.yml`, reading `cwd` from the hook payload so linked worktrees refresh their own index; it batches paths from overlapping edits instead of dropping them under lock contention. A `SessionStart` hook warns when the published generation predates the last commit, a check scoped to commit timestamps, so it does not cover uncommitted edits or an older checkout. Both do nothing until `tmp/woods/generation.json` exists and until the user sets `WOODS_HOOKS_ENABLED=1`; set `WOODS_HOOK_RAKE="docker compose exec -T app bundle exec rake"` when the bundle lives in a container, `WOODS_OUTPUT` when the index directory is non-default, and `WOODS_HOOKS_DISABLED=1` to turn both back off.
+
+## Ask before expanding scope
+
+Require explicit approval before adding Ollama/OpenAI, pgvector/Qdrant, secrets, Console MCP/live-data access, HTTP transport, or purge overrides. The `:local` preset avoids cloud keys but requires the `sqlite3` gem, an installed/running Ollama service, and a pulled model (`ollama pull nomic-embed-text` by default); `:shared_filesystem` avoids sqlite3 but still uses Ollama. Recommend `gem "tokenizers", "~> 0.5"` for exact counting on dense Ruby source, while stating that it is optional.
+
+## Handoff
+
+Report the Woods version, branch, files changed, commands/results, index path, MCP calls verified, semantic retrieval status, Console status, and unresolved risks. Never infer availability from source schemas alone.
+
+Canonical runbook: [AGENT_SETUP.md](https://github.com/lost-in-the/woods/blob/main/docs/AGENT_SETUP.md).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: woods
 version: !ruby/object:Gem::Version
-  version: 1.6.4
+  version: 2.0.0.beta1
 platform: ruby
 authors:
 - Leah Armstrong
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-26 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mcp
@@ -16,20 +16,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.23.0
+        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.23.0
+        version: '1.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -56,7 +56,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: 1.8.2
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -66,7 +66,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: 1.8.2
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -126,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
@@ -137,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
@@ -150,27 +181,22 @@ 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/adapter_family.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
 - lib/woods/console/console_response_renderer.rb
 - lib/woods/console/credential_index.rb
 - lib/woods/console/credential_scanner.rb
-- lib/woods/console/credential_scanner_registry.rb
 - lib/woods/console/dispatch_pipeline.rb
 - lib/woods/console/embedded_executor.rb
-- lib/woods/console/encrypted_credential_snapshot.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
@@ -179,16 +205,15 @@ files:
 - lib/woods/console/scope_predicate_parser.rb
 - lib/woods/console/server.rb
 - lib/woods/console/sql_noise_stripper.rb
-- lib/woods/console/sql_output_policy.rb
 - lib/woods/console/sql_table_scanner.rb
 - lib/woods/console/sql_validator.rb
-- lib/woods/console/sqlite_read_guard.rb
 - lib/woods/console/table_gate.rb
 - lib/woods/console/tool_specs.rb
 - lib/woods/console/tools/tier1.rb
 - 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
@@ -201,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
@@ -222,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
@@ -234,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
@@ -252,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
@@ -268,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
@@ -280,29 +323,31 @@ files:
 - lib/woods/mcp/bootstrapper.rb
 - lib/woods/mcp/config_resolver.rb
 - lib/woods/mcp/errors.rb
-- lib/woods/mcp/http_transport_options.rb
 - lib/woods/mcp/index_reader.rb
+- lib/woods/mcp/index_reader_pinning.rb
 - lib/woods/mcp/origin_guard.rb
-- lib/woods/mcp/origin_policy.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
@@ -312,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
@@ -335,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
@@ -346,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
@@ -357,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/v1.6.4
-  changelog_uri: https://github.com/lost-in-the/woods/blob/v1.6.4/CHANGELOG.md
+  source_code_uri: https://github.com/lost-in-the/woods/tree/v2.0.0.beta1
+  changelog_uri: https://github.com/lost-in-the/woods/blob/v2.0.0.beta1/CHANGELOG.md
   bug_tracker_uri: https://github.com/lost-in-the/woods/issues
-  documentation_uri: https://github.com/lost-in-the/woods/tree/v1.6.4/docs
+  documentation_uri: https://github.com/lost-in-the/woods/tree/v2.0.0.beta1/docs
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []

data/lib/woods/console/adapter_family.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-module Woods
-  module Console
-    # Adapter names differ from the SQL grammar and session settings they use.
-    module AdapterFamily
-      # Classify a live connection by adapter ancestry, database configuration,
-      # then its display name. Unknown families remain nil: SQL callers must
-      # refuse rather than silently omit dialect-specific safeguards.
-      # @param connection [Object] Active Record connection or compatible adapter
-      # @return [Symbol, nil] :postgres, :mysql, :sqlite, or unknown
-      def self.for(connection)
-        ancestry = connection.class.ancestors.filter_map(&:name)
-        return :postgres if ancestry.include?('ActiveRecord::ConnectionAdapters::PostgreSQLAdapter')
-        return :mysql if ancestry.any? { |name| name.match?(/::(?:AbstractMysql|Mysql2|Trilogy)Adapter\z/) }
-        return :sqlite if ancestry.include?('ActiveRecord::ConnectionAdapters::SQLite3Adapter')
-
-        from_name(configured_adapter(connection)) || from_name(connection.adapter_name)
-      end
-
-      def self.configured_adapter(connection)
-        return unless connection.respond_to?(:pool) && connection.pool.respond_to?(:db_config)
-
-        connection.pool.db_config.adapter
-      end
-      private_class_method :configured_adapter
-
-      def self.from_name(value)
-        name = value.to_s.downcase
-        return :mysql if name.include?('mysql') || %w[trilogy mariadb].include?(name)
-        return :postgres if name.include?('postgre') || %w[postgis cockroachdb redshift].include?(name)
-        return :sqlite if name.include?('sqlite')
-
-        nil
-      end
-      private_class_method :from_name
-    end
-  end
-end

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