Prepare for release 0.10.0 (#172)

Author: skydoves

CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.0] - 2026-06-11
+
+### Added
+- **Stability Doctor (IDE plugin)** — a ranked, quantified "what to fix first" list that combines the static stability verdict, the downstream cascade blast radius, and measured runtime waste (Reality Check) into prioritized prescriptions. Scores are **ESTIMATED** (static only, works with no device) or **MEASURED** (backed by live heatmap data; measured waste always outranks estimates). Each prescription shows its problem parameters with static reasons, runtime grades, and value provenance, plus one-click fixes: change `var` → `val` (aborts if write usages exist), annotate with `@Immutable`/`@Stable`, add the type to the stability configuration file, and wrap call-site arguments in `remember(keys) { ... }` for silent-waste parameters (guarded by conservative safety rules and a preview dialog). New **Doctor** tool-window tab, **Code → Run Stability Doctor** action, and a settings group.
+- **Trace-All mode (Gradle + compiler + runtime)** — opt-in module-wide auto-instrumentation: every restartable composable is traced as if it carried `@TraceRecomposition`, so the Live Heatmap, Reality Check, and Stability Doctor get module-wide runtime data without manual annotations.
+  ```kotlin
+  composeStabilityAnalyzer {
+    traceAll {
+      enabled.set(true)             // default: false (opt-in)
+      threshold.set(2)              // default: 2 — skips the initial-composition burst
+      variants.set(listOf("debug")) // default: ["debug"]; never applies to tests
+    }
+  }
+  ```
+  Explicit `@TraceRecomposition` annotations keep their own tag/threshold; previews, inline/readonly/non-restartable composables, and property getters are excluded automatically.
+- **Fully qualified names in recomposition logs** — log headers now carry trailing `(fq: com.example.UserProfile)` and `(auto)` tokens (backward compatible with older parsers), so the IDE attributes runtime data precisely even when composables share a simple name across packages. `RecompositionEvent` gains additive `fqName` and `isAutoTraced` fields.
+
+### Fixed
+- **Android Studio freeze when starting the heatmap on large projects** (#168) — the typealias-resolution fallback iterated and parsed every Kotlin file in the project, and the heatmap inlay refresh ran analysis on the EDT. Lookups now use stub indexes, and the refresh computes on a background thread (the EDT only applies inlay mutations).
+- **AGP 9 no longer leaks to consumers** (#165, thanks to @valeriopilo-tomtom) — the Gradle plugin depends on `gradle-api` as `compileOnly` and isolates all AGP types behind an Android-only registrar, so KMP/JVM projects without AGP work and AGP 8.x projects no longer get AGP 9 on their buildscript classpath.
+- **Nullable types now match the stability configuration file** (#166, thanks to @xplayerCZ) — `kotlinx.datetime.LocalTime?` matches a `kotlinx.datetime.LocalTime` config entry.
+
+### Changed
+- **Runtime disabled-path hardening** — with `ComposeStabilityAnalyzer.setEnabled(false)`, trackers allocate nothing (early exits before any event construction); the tracker cache is thread-safe and keyed by fully qualified name to avoid cross-package collisions.
+
 ## [0.9.0] - 2026-06-04
 
 ### Added

README.md

@@ -286,7 +286,7 @@ This is incredibly useful for:
 First, add the plugin to the `[plugins]` section of your `libs.versions.toml` file:
 
 ```toml
-stability-analyzer = { id = "com.github.skydoves.compose.stability.analyzer", version = "0.9.0" }
+stability-analyzer = { id = "com.github.skydoves.compose.stability.analyzer", version = "0.10.0" }
 ```
 
 Then, apply it to your root `build.gradle.kts` with `apply false`:
@@ -308,6 +308,7 @@ It’s **strongly recommended to use the exact same Kotlin version** as this lib
 
 | Stability Analyzer | Kotlin |
 |--------------------|-------------|
+| 0.10.0             | 2.4.0 |
 | 0.9.0              | 2.4.0 |
 | 0.8.0              | 2.3.21 |
 | 0.7.5              | 2.3.21 |

app/build.gradle.kts

@@ -17,7 +17,7 @@ plugins {
   id(libs.plugins.android.application.get().pluginId)
   id(libs.plugins.kotlin.android.get().pluginId)
   id(libs.plugins.compose.compiler.get().pluginId)
-  id(libs.plugins.compose.stability.analyzer.get().pluginId)
+  alias(libs.plugins.compose.stability.analyzer)
 }
 
 android {

build.gradle.kts

@@ -9,7 +9,6 @@ plugins {
   alias(libs.plugins.compose.compiler) apply false
   alias(libs.plugins.kotlin.multiplatform) apply false
   alias(libs.plugins.jetbrains.compose) apply false
-  alias(libs.plugins.compose.stability.analyzer) apply false
   alias(libs.plugins.kotlin.binary.compatibility)
   alias(libs.plugins.nexus.plugin)
   alias(libs.plugins.spotless)

compose-stability-analyzer-idea/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to the IntelliJ IDEA plugin will be documented in this file.
 
+## [0.10.0] - 2026-06-11
+
+### Added
+- **Stability Doctor** — a ranked, quantified fix list combining the static stability verdict, cascade blast radius, and measured runtime waste into prioritized prescriptions with one-click fixes (`var` → `val`, `@Immutable`/`@Stable`, stability-config entry, and guarded `remember(...)` hoisting for silent-waste parameters). Scores are **ESTIMATED** without a device and upgrade to **MEASURED** during a heatmap session. New **Doctor** tool-window tab, **Code → Run Stability Doctor** action, and a **Stability Doctor** settings group.
+- **Precise runtime-data matching** — heatmap/Reality/Doctor data is keyed by fully qualified name when the runtime reports it (`(fq:)` log token, runtime ≥ 0.10.0), so same-named composables across packages no longer share inlays; older runtimes keep working via simple-name fallback.
+
+### Fixed
+- **Android Studio freeze when starting the heatmap on large projects** (#168) — typealias and source-location lookups now use stub indexes instead of iterating/parsing every project file, and the heatmap inlay refresh runs its analysis on a background thread (the EDT only applies inlay mutations). Refresh ticks are skipped while a previous cycle is still running and during indexing.
+
 ## [0.9.0] - 2026-06-04
 
 ### Changed

compose-stability-analyzer-idea/build.gradle.kts

@@ -26,7 +26,7 @@ kotlin {
 }
 
 group = "com.github.skydoves"
-version = "0.9.0"
+version = "0.10.0"
 
 repositories {
   mavenLocal()
@@ -38,7 +38,7 @@ repositories {
 }
 
 dependencies {
-  implementation("com.github.skydoves:compose-stability-runtime-jvm:0.9.0")
+  implementation("com.github.skydoves:compose-stability-runtime-jvm:0.10.0")
 
   intellijPlatform {
     intellijIdeaCommunity("2025.2")
@@ -74,6 +74,12 @@ intellijPlatform {
             </ul>
         """.trimIndent()
     changeNotes = """
+            <b>0.10.0</b>
+            <ul>
+                <li><b>New: Stability Doctor</b> - A ranked, quantified "what to fix first" list combining the static stability verdict, cascade blast radius, and measured runtime waste into prioritized prescriptions with one-click fixes (var &rarr; val, @Immutable/@Stable, stability-config entry, and guarded remember(...) hoisting for silent-waste parameters). Works without a device (ESTIMATED scores) and upgrades to MEASURED during a heatmap session. New Doctor tool-window tab and Code &rarr; Run Stability Doctor action.</li>
+                <li><b>Trace-All support</b> - With the Gradle plugin's new traceAll mode (0.10.0), the Heatmap, Reality Check, and Doctor receive module-wide runtime data without manual @TraceRecomposition annotations; runtime data is matched by fully qualified name, so same-named composables across packages resolve precisely.</li>
+                <li><b>Fixed: Android Studio freeze when starting the heatmap on large projects</b> - lookups now use stub indexes and the inlay refresh runs its analysis on a background thread.</li>
+            </ul>
             <b>0.9.0</b>
             <ul>
                 <li><b>Updated to Kotlin 2.4.0.</b></li>

docs/version-map.md

@@ -6,6 +6,8 @@ It is **strongly recommended to use the exact same Kotlin version** as this libr
 
 | Stability Analyzer | Kotlin |
 |--------------------|--------|
+| 0.10.0             | 2.4.0  |
+| 0.9.0              | 2.4.0  |
 | 0.8.0              | 2.3.21 |
 | 0.7.5              | 2.3.21 |
 | 0.7.4              | 2.3.20 |

gradle.properties

@@ -48,7 +48,7 @@ kotlin.mpp.androidGradlePluginCompatibility.nowarn=true
 
 # Maven publishing
 GROUP=com.github.skydoves
-VERSION_NAME=0.9.0
+VERSION_NAME=0.10.0
 
 POM_URL=https://github.com/skydoves/compose-stability-analyzer/
 POM_SCM_URL=https://github.com/skydoves/compose-stability-analyzer/

gradle/libs.versions.toml

@@ -12,7 +12,7 @@ androidGradlePlugin = "9.1.1"
 androidxActivity = "1.13.0"
 androidxComposeBom = "2026.05.01"
 jetbrains-compose = "1.11.0"
-compose-stability-analyzer = "0.9.0"
+compose-stability-analyzer = "0.10.0"
 runtimeAnnotation = "1.11.2"
 spotless = "7.0.2"
 shadow = "9.0.0-beta12"

stability-gradle/src/main/kotlin/com/skydoves/compose/stability/gradle/StabilityAnalyzerGradlePlugin.kt

@@ -45,7 +45,7 @@ public class StabilityAnalyzerGradlePlugin : KotlinCompilerPluginSupportPlugin {
     // This version should match the version in gradle.properties (VERSION_NAME).
     // Update this when bumping the library version — it pins the compiler/runtime
     // artifacts the Gradle plugin pulls onto the Kotlin compile classpath.
-    internal const val VERSION = "0.9.0"
+    internal const val VERSION = "0.10.0"
 
     // Compiler option keys
     private const val OPTION_ENABLED = "enabled"