[0.1.5] Release v0.1.5 — Marketplace compatibility, daemon improvements, diagnostics

[unurgunite]

Description

Release v0.1.5 — the first Marketplace-compatible release of DocScribe for RubyMine.

Changes

Platform & Compatibility

• com.intellij.modules.ruby made optional — changed from hard depends to optional="true". Ruby-specific extensions moved to a secondary descriptor (withRubyPlugin.xml). Plugin now installs on IntelliJ IDEA without Ruby plugin (limited functionality), unblocking Marketplace publication.

Daemon & Execution

• Project Ruby SDK used for all bundle exec docscribe commands — SDK bin/ prepended to PATH, BUNDLE_GEMFILE set. Shared buildSdkEnvironment() helper reused across CLI, gem check, and server startup.
• Capability detection — performGemCheck() parses --version output, stores version and server mode support (>= 1.5.1). Server startup skipped for versions < 1.5.1, falling back to CLI.
• Graceful handling when docscribe gem not installed — one-time check on first use, cached for the session. User notification with "Open Gemfile" action.

Performance

• Concurrency guard for rapid annotations — per-file generation counter discards stale results when newer checks start during rapid saves.
• Annotation cache respects settings — configHash derived from DocscribeSettings.hideCommentsByDefault. Settings changes invalidate cache. Max 1000 entries with LRU-like eviction.

Features

• Rakefile support (no extension) — all annotators, actions, and intention actions accept Rakefile without .rb or .rake extension.
• Doctor diagnostics action — DoctorAction collects project root, Gemfile, Ruby SDK, docscribe gem version, daemon state, settings. Editor Popup -> DocScribe -> DocScribe Doctor.
• Update Types from RBS — action to refresh YARD docs from RBS signatures.

Fixes

• Annotation cache now invalidated on settings change — DocscribeSettingsChangeListener clears cache when saved.
• Detekt compliance — refactored DocscribeDaemon.kt complexity violations.

Build & Test

• intellijDependencies() added to build.gradle.kts (required by instrumentTestCode).
• 119 tests — all passing: gem check, capability detection, Rakefile, concurrency, SDK env, Doctor, cache invalidation.

Related PRs

• [0.1.5] Make com.intellij.modules.ruby optional for Marketplace verification #27 — Make com.intellij.modules.ruby optional
• [0.1.5] Graceful handling when docscribe gem not installed #29 — Graceful handling when docscribe gem not installed
• [0.1.5] Fix annotation cache invalidation: compute configHash from settings #30 — Fix annotation cache invalidation
• [0.1.5] Add Rakefile (no extension) support to annotator and actions #31 — Add Rakefile support
• [0.1.5] Use project Ruby SDK for all bundle exec docscribe commands #32 — Use project Ruby SDK
• [0.1.5] Limit concurrency: discard stale annotation results per file; add SDK env tests #33 — Concurrency guard for annotations
• [0.1.5] Add docscribe capability detection: parse version, skip server on < 1.5.1 #34 — Capability detection
• [0.1.5] Add Doctor diagnostics action #35 — Doctor diagnostics action

Checklist

• Tests pass (./gradlew test)
• Formatting clean (./gradlew spotlessCheck)
• Static analysis clean (./gradlew detekt)
• Plugin verified compatible with RubyMine 2026.1
• CHANGELOG updated