# Changelog

> **This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.**

## Score

- CAI 62 → 61 (-0.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

## Lenses

- Code Health 69 → 68 (-0.4)
- Architecture 76 → 76 (+0.5)
- Maturity 63 → 65 (+1.9)
- Readiness 72 → 71 (-0.8)
- Security 55 → 55 (+0.0)
- Domain Modelling 100 → 100 (+0.0)
- Accessibility 67 → 61 (-5.5)
- Performance 100 → 100 (+0.0)

## Resolved (32)

- Change coupling clique: embedding.rb, image.rb, transcription.rb (lib/ruby_llm/embedding.rb)
- Change coupling: chat_methods.rb ↔ message_methods.rb (lib/ruby_llm/active_record/chat_methods.rb)
- Duplicated block (13 lines × 2) (lib/ruby_llm/ocr.rb)
- Duplicated block (13–14 lines × 2) (lib/ruby_llm/image.rb)
- Duplicated block (24 lines × 2) (lib/ruby_llm/providers/hetzner/chat.rb)
- Duplicated block (5 lines × 2) (lib/ruby_llm/prompt.rb)
- Duplicated block (5 lines × 2) (lib/ruby_llm/protocols/cohere/tools.rb)
- Duplicated block (6 lines × 2) (lib/ruby_llm/protocols/anthropic/chat.rb)
- Duplicated block (6 lines × 2) (lib/ruby_llm/protocols/chat_completions/chat.rb)
- Duplicated block (8 lines × 2) (lib/ruby_llm/embedding.rb)
- Duplicated block (9 lines × 2) (lib/ruby_llm/protocols/anthropic/files.rb)
- Duplicated block (9 lines × 2) (lib/ruby_llm/protocols/invoke_model/nova_embeddings.rb)
- Duplicated block (9 lines × 3) (lib/ruby_llm/file_store/tools/search.rb)
- Flaky test: RubyLLM::Chat provider mapping lets provider options override the mapped value
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 12 more

## New (90)

- Change coupling: chat_tool_call_state.rb ↔ run_claims.rb (lib/ruby_llm/active_record/chat_tool_call_state.rb)
- Change coupling: embedding.rb ↔ image.rb (lib/ruby_llm/embedding.rb)
- Change coupling: embedding.rb ↔ transcription.rb (lib/ruby_llm/embedding.rb)
- Change coupling: image.rb ↔ transcription.rb (lib/ruby_llm/image.rb)
- Change coupling: run_claims.rb ↔ tool_call_state.rb (lib/ruby_llm/active_record/run_claims.rb)
- Change coupling: transcription.rb ↔ provider.rb (lib/ruby_llm/protocols/chat_completions/transcription.rb)
- Change-coupling hub: speech.rb → embedding.rb, image.rb, provider.rb, transcription.rb (lib/ruby_llm/speech.rb)
- Duplicated block (6 lines × 2) (lib/ruby_llm/file_store/tools/edit.rb)
- Duplicated block (6 lines × 2) (lib/ruby_llm/protocols/chat_completions/chat.rb)
- Duplicated block (8 lines × 2) (lib/ruby_llm/protocols/invoke_model/titan_multimodal_embeddings.rb)
- Duplicated block (9 lines × 2) (lib/ruby_llm/file_store/tools/write.rb)
- Edited copies of one member (3 members, 11+ corresponding lines) (lib/ruby_llm/protocols/anthropic/tools.rb)
- Edited copies of one member (3 members, 12+ corresponding lines) (lib/ruby_llm/file_store/tools/edit.rb)
- Edited copies of one member (3 members, 2+ corresponding lines) (lib/ruby_llm/protocols/anthropic/request_shapes.rb)
- Edited copies of one member (3 members, 3+ corresponding lines) (lib/ruby_llm/protocols/chat_completions/request_shapes.rb)
- Edited copies of one member (3 members, 9+ corresponding lines) (lib/ruby_llm/protocols/invoke_model/nova_embeddings.rb)
- Edited copies of one member (5 members, 10+ corresponding lines) (lib/ruby_llm/protocols/anthropic/files.rb)
- Edited copies of one member (5 members, 12+ corresponding lines) (lib/ruby_llm/providers/azure/media.rb)
- Edited copies of one member (7 members, 4+ corresponding lines) (lib/ruby_llm/protocols/bedrock/async_videos.rb)
- Edited copy of a member (11 corresponding lines) (lib/ruby_llm/protocols/chat_completions/models.rb)
- …and 70 more

## Changes since last survey

- 300 commits — 295 feature/other, 5 fixes

## By area

- lib/ruby_llm — 137 commits
- spec/ruby_llm — 40 commits
- docs/_advanced — 20 commits
- spec/fixtures — 20 commits
- lib/generators — 18 commits
- docs/_data — 11 commits
- docs/_core_features — 10 commits
- docs/_reference — 9 commits
- (root) — 7 commits
- .github/workflows — 5 commits
- docs/_compare — 4 commits
- docs/assets — 3 commits
- docs/_getting_started — 2 commits
- docs/_includes — 2 commits
- skills/rubyllm — 2 commits
- app/assets — 1 commit
- benchmarks/streaming.rb — 1 commit
- conformance/opentelemetry — 1 commit
- docs/Gemfile — 1 commit
- docs/_config.yml — 1 commit

## Notable commits

- fix: Fix Gemini and Interactions attachment and usage gaps (#1373)
- fix: Fix Hetzner, Azure and xAI requests that cannot work (#1604)
- fix: Fix agent rescue_from, chunk types and VideoJob.find (#1361)
- fix: Fix review follow-ups in tool calls, thinking and docs (#1386)
- fix: Fix streamed transcripts and Cohere thinking parity (#1375)
- change: Accept ignored seam keywords through ** (#1393)
- change: Add Agent callback macros and subagents (#1453)
- change: Add Attachment#partial? and Message#spilled_path (#1550)
- change: Add Azure AI Speech fast transcription (#1523)
- change: Add Azure judgments through the Decisions API (#1437)
- change: Add Bedrock Nova code interpreter alias (#1624)
- change: Add DeepSeek web search alias and usage counts (#1623)
- change: Add Deepgram chat on its Think endpoint (#1631)
- change: Add Kimi files, documents, OCR, token counts, web search (#1613)
- change: Add Message#web_sources for hosted web searches (#1478)
- change: Add Meta transcription and Files support (#1607)
- change: Add MiniMax images, video, speech, transcription and files (#1608)
- change: Add Mistral OCR on Vertex AI (#1632)
- change: Add Mistral document OCR on Azure (#1635)
- change: Add Moonshot chat batches (#1636)
- …and 280 more

## Architecture

- Unchanged — 0 containers · 1 contexts · 0 edges
