Add Akka Insights and Kubernetes Management module support

- Add insightsModules() for Cinnamon/Akka Insights dependencies
  - Uses direct Maven coordinates (no sbt-cinnamon plugin needed)
  - Includes Prometheus and OpenTelemetry support
  - Scala modules use CrossVersion.for3Use2_13
  - Java modules use plain coordinates
- Add managementKubernetesModules() for K8s-specific deps
  - Cluster bootstrap, K8s discovery, K8s lease, rolling updates
- Add javaModule() helper for Java-only dependencies
- Update forRelease() with withInsights and withManagementKubernetes params
- Remove unused sbt-cinnamon plugin reference from plugins.sbt

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: respencer-ncl

NOTEBOOK.md

@@ -2,9 +2,9 @@
 
 ## Current Status
 
-**Version 1.2.0 ready for release.** Significant maintenance work completed Jan 17, 2026
-addressing all 15 UX issues identified in the maintenance analysis.
-All 16 scripted tests passing (100%). Key changes since 1.1.0:
+**Version 1.2.4 in development.** Added Akka Insights (withInsights) and Kubernetes
+management (withManagementKubernetes) support to the Akka helper. All 16 scripted
+tests passing. Key changes since 1.2.3:
 - CrossModule dependencies now opt-in (breaking change)
 - New helpers: `With.Publishing`, `With.ScalaJavaTime()`, `With.ClassPathJar`, `With.UnmanagedJars`, `With.ShellPrompt`
 - Improved error messages when Root() not configured
@@ -15,6 +15,32 @@ All 16 scripted tests passing (100%). Key changes since 1.1.0:
 
 ## Work Completed (Recent)
 
+### Session Jan 24, 2026 - Akka Insights Support
+
+Added `withInsights` and `withManagementKubernetes` parameters to `With.Akka.forRelease()`:
+
+**New Features:**
+- `withInsights` - Adds Cinnamon telemetry modules (actor, HTTP, cluster metrics)
+- `withInsightsPrometheus` - Prometheus metrics export (default: true)
+- `withInsightsOpenTelemetry` - OpenTelemetry tracing (default: true)
+- `withManagementKubernetes` - K8s discovery, lease, rolling updates
+
+**Implementation:**
+- Added `javaModule()` helper for Java-only dependencies (no Scala suffix)
+- Added `insightsModules()` function with all Cinnamon dependencies
+- Added `managementKubernetesModules()` function
+- Uses direct Maven coordinates instead of sbt-cinnamon plugin
+
+**Technical Notes:**
+- Cinnamon Scala modules: cinnamon-akka, cinnamon-akka-typed, cinnamon-akka-stream,
+  cinnamon-akka-cluster, cinnamon-akka-http
+- Cinnamon Java modules: cinnamon-prometheus, cinnamon-prometheus-httpserver,
+  cinnamon-opentelemetry, cinnamon-agent
+- K8s modules: akka-discovery-kubernetes-api, akka-lease-kubernetes,
+  akka-rolling-update-kubernetes
+
+**Release:** Tag as 1.2.4 after testing
+
 ### Session Jan 17, 2026
 - [x] Refactored AutoPluginHelper to extend `(Project => Project)` for better UX
 - [x] Made CrossModule dependencies optional (breaking change)

project/plugins.sbt

@@ -14,8 +14,6 @@
  * limitations under the License.
  */
 
-// resolvers += "Akka library Repository".at("https://repo.akka.io/maven")
-
 // Generic plugins from github.sbt project
 addSbtPlugin("com.github.sbt" % "sbt-dynver" % "5.0.1")
 

src/main/scala/com/ossuminc/sbt/helpers/Akka.scala

@@ -57,6 +57,10 @@ object Akka extends AutoPluginHelper {
   private def akkaTestModule(org: String, name: String, version: String): ModuleID =
     (org %% name % version % Test).cross(CrossVersion.for3Use2_13)
 
+  /** Helper to create a Java-only dependency (no Scala suffix) */
+  private def javaModule(org: String, name: String, version: String): ModuleID =
+    org % name % version
+
   sealed trait ReleaseVersions {
     def akka_core: String
     def akka_http: String
@@ -65,6 +69,7 @@ object Akka extends AutoPluginHelper {
     def akka_management: String
     def akka_projections: String
     def akka_kafka: String
+    def akka_insights: String
   }
 
   /** Version numbers for Akka 2024.10 release */
@@ -76,6 +81,7 @@ object Akka extends AutoPluginHelper {
     val akka_management = "1.6.0"
     val akka_projections = "1.6.0"
     val akka_kafka = "7.0.0"
+    val akka_insights = "2.21.0"
   }
 
   /** Version numbers for Akka 25.10 release (latest as of Jan 2026) Version numbers from:
@@ -89,6 +95,7 @@ object Akka extends AutoPluginHelper {
     val akka_management = "1.6.4"
     val akka_projections = "1.6.18"
     val akka_kafka = "8.0.0"
+    val akka_insights = "2.22.0"
   }
 
   /** Core Akka modules (actor, cluster, persistence, stream) - available in all releases */
@@ -150,13 +157,73 @@ object Akka extends AutoPluginHelper {
     akkaModule("com.lightbend.akka", "akka-projection-r2dbc", version)
   )
 
-  /** Akka Management modules */
+  /** Akka Management modules (core) */
   def managementModules(version: String): Seq[ModuleID] = Seq(
     akkaModule("com.lightbend.akka.management", "akka-management", version),
     akkaModule("com.lightbend.akka.management", "akka-management-cluster-http", version),
     akkaModule("com.lightbend.akka.management", "akka-management-cluster-bootstrap", version)
   )
 
+  /** Akka Management Kubernetes-specific modules */
+  def managementKubernetesModules(version: String): Seq[ModuleID] = Seq(
+    akkaModule("com.lightbend.akka.discovery", "akka-discovery-kubernetes-api", version),
+    akkaModule("com.lightbend.akka.management", "akka-lease-kubernetes", version),
+    akkaModule("com.lightbend.akka.management", "akka-rolling-update-kubernetes", version)
+  )
+
+  /** Akka Insights / Cinnamon modules for telemetry and observability.
+    *
+    * Provides:
+    *   - Actor metrics (mailbox size, processing time, failures)
+    *   - HTTP metrics (request latency, status codes)
+    *   - Cluster metrics (phi accrual, member events)
+    *   - Prometheus endpoint for metrics export
+    *   - OpenTelemetry for distributed tracing
+    *
+    * NOTE: For full instrumentation at runtime, you may need to configure the Cinnamon
+    * Java agent. See: https://doc.akka.io/libraries/akka-insights/current/setup/
+    *
+    * @param version
+    *   The Akka Insights version (e.g., "2.22.0" for Akka 25.10)
+    * @param withHTTP
+    *   Include HTTP instrumentation (requires withHTTP in forRelease)
+    * @param withPrometheus
+    *   Include Prometheus metrics export (default: true)
+    * @param withOpenTelemetry
+    *   Include OpenTelemetry tracing (default: true)
+    */
+  def insightsModules(
+    version: String,
+    withHTTP: Boolean = false,
+    withPrometheus: Boolean = true,
+    withOpenTelemetry: Boolean = true
+  ): Seq[ModuleID] = {
+    // Core Cinnamon modules (Scala 2.13 cross-compiled)
+    val base = Seq(
+      akkaModule("com.lightbend.cinnamon", "cinnamon-akka", version),
+      akkaModule("com.lightbend.cinnamon", "cinnamon-akka-typed", version),
+      akkaModule("com.lightbend.cinnamon", "cinnamon-akka-stream", version),
+      akkaModule("com.lightbend.cinnamon", "cinnamon-akka-cluster", version)
+    )
+    val http = if (withHTTP) Seq(
+      akkaModule("com.lightbend.cinnamon", "cinnamon-akka-http", version)
+    ) else Seq.empty
+    // Prometheus modules (Java-only, no Scala suffix)
+    val prometheus = if (withPrometheus) Seq(
+      javaModule("com.lightbend.cinnamon", "cinnamon-prometheus", version),
+      javaModule("com.lightbend.cinnamon", "cinnamon-prometheus-httpserver", version)
+    ) else Seq.empty
+    // OpenTelemetry module
+    val otel = if (withOpenTelemetry) Seq(
+      javaModule("com.lightbend.cinnamon", "cinnamon-opentelemetry", version)
+    ) else Seq.empty
+    // Cinnamon agent (needed for runtime instrumentation)
+    val agent = Seq(
+      javaModule("com.lightbend.cinnamon", "cinnamon-agent", version)
+    )
+    base ++ http ++ prometheus ++ otel ++ agent
+  }
+
   /** Alpakka Kafka (akka-stream-kafka) modules */
   def kafkaModules(version: String): Seq[ModuleID] = Seq(
     akkaModule("com.typesafe.akka", "akka-stream-kafka", version)
@@ -165,15 +232,35 @@ object Akka extends AutoPluginHelper {
   /** Configure Akka dependencies for a specific release.
     *
     * Automatically adds:
-    *   - Akka repository resolvers (Maven and Ivy style) with tokenized URL from AKKA_LICENSE_KEY
+    *   - Akka repository resolvers (Maven and Ivy style) with tokenized URL from AKKA_REPO_TOKEN
     *   - Core Akka modules for the specified release
     *
     * @param release
     *   The Akka release version ("25.10" or "24.10"). Default is latest (25.10).
+    * @param withHTTP
+    *   Include Akka HTTP modules
+    * @param withGrpc
+    *   Include Akka gRPC runtime
+    * @param withPersistence
+    *   Include Akka Persistence R2DBC
+    * @param withProjections
+    *   Include Akka Projections
+    * @param withManagement
+    *   Include Akka Management (core: health checks, cluster HTTP)
+    * @param withManagementKubernetes
+    *   Include Akka Management Kubernetes modules (discovery, lease, rolling updates)
+    * @param withKafka
+    *   Include Alpakka Kafka connector
+    * @param withInsights
+    *   Include Akka Insights (Cinnamon) for telemetry and observability
+    * @param withInsightsPrometheus
+    *   Include Prometheus metrics export with Insights (default: true when withInsights)
+    * @param withInsightsOpenTelemetry
+    *   Include OpenTelemetry tracing with Insights (default: true when withInsights)
     * @param project
     *   The project to configure
     * @return
-    *   The configured project with Akka resolvers and core modules
+    *   The configured project with Akka resolvers and selected modules
     */
   def forRelease(
     release: String = "",
@@ -182,7 +269,11 @@ object Akka extends AutoPluginHelper {
     withPersistence: Boolean = false,
     withProjections: Boolean = false,
     withManagement: Boolean = false,
-    withKafka: Boolean = false
+    withManagementKubernetes: Boolean = false,
+    withKafka: Boolean = false,
+    withInsights: Boolean = false,
+    withInsightsPrometheus: Boolean = true,
+    withInsightsOpenTelemetry: Boolean = true
   )(project: Project): Project = {
     val versions: ReleaseVersions = release match {
       case "2025.10" | "25.10" | "latest" | "" => V_25_10
@@ -211,13 +302,23 @@ object Akka extends AutoPluginHelper {
           else Seq.empty[ModuleID]
         } ++ {
           if (withManagement) managementModules(versions.akka_management) else Seq.empty[ModuleID]
+        } ++ {
+          if (withManagementKubernetes) managementKubernetesModules(versions.akka_management)
+          else Seq.empty[ModuleID]
         } ++ {
           if (withKafka) kafkaModules(versions.akka_kafka) else Seq.empty[ModuleID]
+        } ++ {
+          if (withInsights) insightsModules(
+            versions.akka_insights,
+            withHTTP = withHTTP,
+            withPrometheus = withInsightsPrometheus,
+            withOpenTelemetry = withInsightsOpenTelemetry
+          ) else Seq.empty[ModuleID]
         }
       }
     )
   }
 
   /** Configure Akka with the latest release */
   def apply(project: Project): Project = forRelease("")(project)
-}
+}