rails-ai-bridge 5.4.0 → 5.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.reek.yml +7 -0
- data/AGENTS.md +2 -2
- data/CHANGELOG.md +57 -0
- data/CLAUDE.md +2 -2
- data/README.md +43 -511
- data/docs/COMPARISON.md +8 -8
- data/docs/COVERAGE.md +1 -1
- data/docs/GUIDE.md +219 -9
- data/docs/ROADMAP.md +3 -3
- data/docs/mcp-security.md +2 -1
- data/lib/rails_ai_bridge/configuration.rb +4 -2
- data/lib/rails_ai_bridge/http_transport_app.rb +7 -1
- data/lib/rails_ai_bridge/introspector.rb +3 -2
- data/lib/rails_ai_bridge/introspectors/code_intelligence_introspector.rb +105 -0
- data/lib/rails_ai_bridge/middleware.rb +9 -3
- data/lib/rails_ai_bridge/serializers/formatters/sections/code_intelligence_formatter.rb +69 -0
- data/lib/rails_ai_bridge/serializers/markdown_serializer.rb +1 -0
- data/lib/rails_ai_bridge/tools/explain_symbol/cli_explorer.rb +7 -31
- data/lib/rails_ai_bridge/tools/explain_symbol/cli_runner.rb +45 -0
- data/lib/rails_ai_bridge/tools/explain_symbol/graphify_explorer.rb +44 -0
- data/lib/rails_ai_bridge/tools/explain_symbol.rb +35 -7
- data/lib/rails_ai_bridge/version.rb +1 -1
- data/server.json +1 -1
- metadata +5 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: f7bb48a28251ee8e4bfe0e4c53c997a2761ebbc2ff3514b3932665f3e6f2ab7e
|
|
4
|
+
data.tar.gz: 5efeab1f89784d31f004263056c3d58a93f391baadb301aafdf1be0f084a085f
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5be842f71f3a2f60f5005b825e7f3feffba30bf09fe4c9e25649af9e60daaa7f6007256ccf400037fba47ff2221738d60ab4d02a1e89d8828278c48ed5f1643f
|
|
7
|
+
data.tar.gz: ff93e2abe13b0c2ecbbcacaf8dd4806271796a2ec2ab0e4a3c147151396b5b2b6e65d120bbc102d9074107e2f17904b0d2f84dcd77e9632e48f21b1b35c1d2f2
|
data/.reek.yml
CHANGED
|
@@ -93,6 +93,7 @@ detectors:
|
|
|
93
93
|
ControlParameter:
|
|
94
94
|
exclude:
|
|
95
95
|
- RailsAiBridge::Registry::ContextProviderClient#probe
|
|
96
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#staleness_label
|
|
96
97
|
- RailsAiBridge::ContextProvider#rebuild
|
|
97
98
|
- RailsAiBridge::Doctor::Checkers::RegistryChecker#call
|
|
98
99
|
- RailsAiBridge::Doctor::Checkers::BaseChecker#check
|
|
@@ -470,6 +471,9 @@ detectors:
|
|
|
470
471
|
- RailsAiBridge::Tools::ModelDetails::SingleModelFormatter#format_macro_list
|
|
471
472
|
- RailsAiBridge::Tools::ModelDetails::StandardFormatter#call
|
|
472
473
|
- RailsAiBridge::Tools::Schema::TableFormatter#call
|
|
474
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#codegraph_lines
|
|
475
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#graphify_lines
|
|
476
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#render
|
|
473
477
|
InstanceVariableAssumption:
|
|
474
478
|
exclude:
|
|
475
479
|
- RailsAiBridge::Generators::InstallGenerator
|
|
@@ -1045,6 +1049,8 @@ detectors:
|
|
|
1045
1049
|
- RailsAiBridge::Watcher#handle_change
|
|
1046
1050
|
- RailsAiBridge::Watcher#start
|
|
1047
1051
|
- RailsAiBridge#validate_auto_mount_configuration!
|
|
1052
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#graphify_lines
|
|
1053
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#render
|
|
1048
1054
|
UncommunicativeVariableName:
|
|
1049
1055
|
exclude:
|
|
1050
1056
|
- RailsAiBridge::AssistantFormatsPreference#formats_for_default_bridge_task
|
|
@@ -1323,3 +1329,4 @@ detectors:
|
|
|
1323
1329
|
- RailsAiBridge::Tools::ModelDetails::SingleModelFormatter#macro_present?
|
|
1324
1330
|
- RailsAiBridge::Tools::Schema::StandardFormatter#partition_note
|
|
1325
1331
|
- RailsAiBridge::Tools::SearchCode::Formatter#call
|
|
1332
|
+
- RailsAiBridge::Serializers::Formatters::Sections::CodeIntelligenceFormatter#format_time
|
data/AGENTS.md
CHANGED
|
@@ -8,7 +8,7 @@ committed context files. It does not write to the host database.
|
|
|
8
8
|
- `lib/rails_ai_bridge.rb` — Main entry point, public API (Zeitwerk autoloaded)
|
|
9
9
|
- `lib/rails_ai_bridge/configuration.rb` — User-facing config with presets (:standard, :full)
|
|
10
10
|
- `lib/rails_ai_bridge/introspector.rb` — Orchestrates sub-introspectors
|
|
11
|
-
- `lib/rails_ai_bridge/introspectors/` — Built-in introspector classes; `:standard` preset runs **9**, `:full` runs **
|
|
11
|
+
- `lib/rails_ai_bridge/introspectors/` — Built-in introspector classes; `:standard` preset runs **9**, `:full` runs **28** (see `Configuration::PRESETS`). Registry: `Introspector::BUILTIN_INTROSPECTORS` (`:full` already includes `non_ar_models`; opt-in-only symbols not in any preset: `database_stats`, `semantic`).
|
|
12
12
|
- `lib/rails_ai_bridge/tools/` — 22 built-in MCP tools using the official mcp SDK (hosts can add more via `additional_tools`)
|
|
13
13
|
- `lib/rails_ai_bridge/serializers/` — Output formatters (claude, claude_rules, codex, cursor_rules, devin, devin_rules, copilot, copilot_instructions, gemini, rules, markdown, JSON)
|
|
14
14
|
- `lib/rails_ai_bridge/resources.rb` — MCP resources (static data AI clients read directly)
|
|
@@ -32,7 +32,7 @@ committed context files. It does not write to the host database.
|
|
|
32
32
|
6. **Diff-aware** — context regeneration skips unchanged files
|
|
33
33
|
7. **Per-assistant serializers** — each AI tool gets tailored output format
|
|
34
34
|
8. **Zeitwerk autoloading** — files loaded on-demand, not all upfront
|
|
35
|
-
9. **Introspector presets** — `:standard` (9 core) default, `:full` (
|
|
35
|
+
9. **Introspector presets** — `:standard` (9 core) default, `:full` (28 introspectors, includes `non_ar_models`) with opt-in extras such as `database_stats` and `semantic` for power users
|
|
36
36
|
10. **MCP auto-discovery** — `.mcp.json` generated by install generator
|
|
37
37
|
11. **Outbound context providers (v5)** — `rails_get_provider_context` fetches from declared external MCP services. Disabled by default, exact host allowlist, read-only tool enforcement, `ToolResultCache::NON_CACHEABLE` exclusion. Separate from local `rails_get_context`.
|
|
38
38
|
12. **Compact by default** — context files ≤150 lines, MCP tools use `detail` parameter (summary/standard/full)
|
data/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [5.5.0] - 2026-11-20
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- `rails_explain_symbol` now falls back to a local Graphify index: when
|
|
15
|
+
`.codegraph/` is absent but `graphify-out/graph.json` exists, the tool runs
|
|
16
|
+
`graphify query` against the project's graph. Shared CLI execution moved to
|
|
17
|
+
`ExplainSymbol::CliRunner`; the missing-index message and tool description
|
|
18
|
+
name both index types.
|
|
19
|
+
- `CodeIntelligenceIntrospector` (`:code_intelligence`, included in the
|
|
20
|
+
`:full` preset — 28 introspectors) reports whether local CodeGraph and
|
|
21
|
+
Graphify indexes exist, when they were last generated, and whether the
|
|
22
|
+
Graphify graph is stale relative to `git HEAD`. Rendered as a new
|
|
23
|
+
`## Code Intelligence Indexes` section in markdown output.
|
|
24
|
+
- Dependency refresh: archspec dev-dependency raised to `~> 1.2.0`
|
|
25
|
+
(Dependabot #359).
|
|
26
|
+
|
|
27
|
+
### Changed
|
|
28
|
+
|
|
29
|
+
- README restructured: install-profile detail, per-client setup walkthroughs,
|
|
30
|
+
managed regions, Rubydex, extending the built-ins, and skill packs moved to
|
|
31
|
+
`docs/GUIDE.md`, which becomes the single source for the full configuration
|
|
32
|
+
tables.
|
|
33
|
+
- Refreshed `docs/COMPARISON.md` against live sources (2026-11-20): the
|
|
34
|
+
read-only SQL/data-access row now reflects the shipped `rails_query` and
|
|
35
|
+
`rails_read_logs`, tool and introspector counts updated, download counts
|
|
36
|
+
re-verified.
|
|
37
|
+
|
|
38
|
+
### Fixed
|
|
39
|
+
|
|
40
|
+
- HTTP MCP CORS: when `cors_origins` includes `'*'`, the response now sends
|
|
41
|
+
the literal `Access-Control-Allow-Origin: *` instead of echoing the
|
|
42
|
+
request's arbitrary `Origin` header back.
|
|
43
|
+
- Rack middleware: the HTTP transport app is built inside the same reentrant
|
|
44
|
+
monitor as the transport, so concurrent first requests can no longer build
|
|
45
|
+
two apps (and two rate limiters) with one discarded.
|
|
46
|
+
|
|
47
|
+
### Security
|
|
48
|
+
|
|
49
|
+
- Documented two accepted limits in `docs/mcp-security.md`: `rails_query`
|
|
50
|
+
blocks statement types, not SQL function side effects (e.g. `SELECT
|
|
51
|
+
setval(...)` on PostgreSQL) — use a read-only database role when exposing
|
|
52
|
+
data tools; and CORS `'*'` mode is wildcard-allow — prefer exact origins.
|
|
53
|
+
|
|
54
|
+
### Maintenance
|
|
55
|
+
|
|
56
|
+
- Refresh the mutation and demo-app lockfiles and the local lockfile, including
|
|
57
|
+
MCP 1.11.0, Rubydex 0.4.4, Combustion 1.7.0, Faraday 2.15.1, RuboCop 1.92.3,
|
|
58
|
+
Zeitwerk 2.8.3, WEBrick 1.9.2, and YARD 0.9.45. Skunk remains on 0.5.4 and
|
|
59
|
+
Reek on 6.5.x: RubyCritic pins `reek (~> 6.5.0, < 7.0)` in both 4.12.0 and
|
|
60
|
+
5.0.0, and Skunk requires `rubycritic < 5.0`, so Dependabot PR #358 (reek
|
|
61
|
+
6.6) was rejected.
|
|
62
|
+
- Added focused specs for five previously unspec'd serializer collaborators
|
|
63
|
+
(`RulesArchitectureBuilder`, `RulesStackOverviewBuilder`,
|
|
64
|
+
`RulesKeyConsiderationsBuilder`, `RulesDocumentBuilder`, `LineEnforcer`);
|
|
65
|
+
refreshed `docs/COVERAGE.md` to state the shipped 90/90 coverage floor.
|
|
66
|
+
|
|
10
67
|
## [5.4.0] - 2026-10-23
|
|
11
68
|
|
|
12
69
|
### Added
|
data/CLAUDE.md
CHANGED
|
@@ -9,7 +9,7 @@ committed context files. It does not write to the host database.
|
|
|
9
9
|
- `lib/rails_ai_bridge/configuration.rb` — User-facing config with presets (:standard, :full)
|
|
10
10
|
- `lib/rails_ai_bridge/introspector.rb` — Orchestrates sub-introspectors
|
|
11
11
|
- `lib/rails_ai_bridge/introspectors/` — Built-in introspector classes; `:standard` preset
|
|
12
|
-
runs **9**, `:full` runs **
|
|
12
|
+
runs **9**, `:full` runs **28** (see `Configuration::PRESETS`). Registry:
|
|
13
13
|
`Introspector::BUILTIN_INTROSPECTORS` (`:full` already includes
|
|
14
14
|
`non_ar_models`; opt-in-only symbols not in any preset: `database_stats`,
|
|
15
15
|
`semantic`).
|
|
@@ -39,7 +39,7 @@ committed context files. It does not write to the host database.
|
|
|
39
39
|
6. **Diff-aware** — context regeneration skips unchanged files
|
|
40
40
|
7. **Per-assistant serializers** — each AI tool gets tailored output format
|
|
41
41
|
8. **Zeitwerk autoloading** — files loaded on-demand, not all upfront
|
|
42
|
-
9. **Introspector presets** — `:standard` (9 core) default, `:full` (
|
|
42
|
+
9. **Introspector presets** — `:standard` (9 core) default, `:full` (28 introspectors, includes `non_ar_models`) with opt-in extras such as `database_stats` and `semantic` for power users
|
|
43
43
|
10. **MCP auto-discovery** — `.mcp.json` generated by install generator
|
|
44
44
|
11. **Outbound context providers (v5)** — `rails_get_provider_context` fetches from declared external MCP services. Disabled by default, exact host allowlist, read-only tool enforcement, `ToolResultCache::NON_CACHEABLE` exclusion. Separate from local `rails_get_context`.
|
|
45
45
|
12. **Compact by default** — context files ≤150 lines, MCP tools use `detail` parameter (summary/standard/full)
|