androjack-mcp 1.3.0

package/build/tools/gradle.js

@@ -0,0 +1,234 @@
+/**
+ * Tool 5 – gradle_dependency_checker
+ *
+ * Looks up the latest stable version of any Android/Kotlin/Jetpack library
+ * from Google Maven and Maven Central.
+ *
+ * Correctness guarantees:
+ *   - BOM-managed libraries (Compose, Firebase) emit platform() wrapper
+ *   - Plugin declarations emit plugins {} block, not implementation()
+ *   - Falls back through: Google Maven → Maven Central → Jetpack releases page
+ *
+ * Source of truth: dl.google.com/dl/android/maven2 + search.maven.org
+ */
+import { secureFetchJson, secureFetch, extractPageText } from "../http.js";
+import { MAVEN_SEARCH_URL, GOOGLE_MAVEN_URL } from "../constants.js";
+const LIBRARY_CATALOGUE = {
+    // ── Compose ────────────────────────────────────────────────────────────────
+    "compose-bom": { groupId: "androidx.compose", artifactId: "compose-bom" },
+    "compose": { groupId: "androidx.compose.ui", artifactId: "ui", bomManaged: true },
+    "compose-ui": { groupId: "androidx.compose.ui", artifactId: "ui", bomManaged: true },
+    "compose-material3": { groupId: "androidx.compose.material3", artifactId: "material3", bomManaged: true },
+    "compose-foundation": { groupId: "androidx.compose.foundation", artifactId: "foundation", bomManaged: true },
+    "compose-runtime": { groupId: "androidx.compose.runtime", artifactId: "runtime", bomManaged: true },
+    "compose-animation": { groupId: "androidx.compose.animation", artifactId: "animation", bomManaged: true },
+    "material3": { groupId: "androidx.compose.material3", artifactId: "material3", bomManaged: true },
+    // ── Architecture ───────────────────────────────────────────────────────────
+    "lifecycle": { groupId: "androidx.lifecycle", artifactId: "lifecycle-runtime-ktx", releasePageSlug: "lifecycle" },
+    "viewmodel": { groupId: "androidx.lifecycle", artifactId: "lifecycle-viewmodel-ktx", releasePageSlug: "lifecycle" },
+    "lifecycle-compose": { groupId: "androidx.lifecycle", artifactId: "lifecycle-runtime-compose", releasePageSlug: "lifecycle" },
+    "navigation": { groupId: "androidx.navigation", artifactId: "navigation-compose", releasePageSlug: "navigation" },
+    "navigation-compose": { groupId: "androidx.navigation", artifactId: "navigation-compose", releasePageSlug: "navigation" },
+    "room": { groupId: "androidx.room", artifactId: "room-runtime", releasePageSlug: "room" },
+    "paging": { groupId: "androidx.paging", artifactId: "paging-runtime", releasePageSlug: "paging" },
+    "paging-compose": { groupId: "androidx.paging", artifactId: "paging-compose", releasePageSlug: "paging" },
+    "datastore": { groupId: "androidx.datastore", artifactId: "datastore-preferences", releasePageSlug: "datastore" },
+    "workmanager": { groupId: "androidx.work", artifactId: "work-runtime-ktx", releasePageSlug: "work" },
+    "hilt": { groupId: "com.google.dagger", artifactId: "hilt-android", releasePageSlug: "hilt" },
+    "hilt-compose": { groupId: "androidx.hilt", artifactId: "hilt-navigation-compose", releasePageSlug: "hilt" },
+    "hilt-navigation-compose": { groupId: "androidx.hilt", artifactId: "hilt-navigation-compose", releasePageSlug: "hilt" },
+    // ── Network ────────────────────────────────────────────────────────────────
+    "retrofit": { groupId: "com.squareup.retrofit2", artifactId: "retrofit" },
+    "retrofit-gson": { groupId: "com.squareup.retrofit2", artifactId: "converter-gson" },
+    "retrofit-moshi": { groupId: "com.squareup.retrofit2", artifactId: "converter-moshi" },
+    "okhttp": { groupId: "com.squareup.okhttp3", artifactId: "okhttp" },
+    "okhttp-logging": { groupId: "com.squareup.okhttp3", artifactId: "logging-interceptor" },
+    // Ktor — KMP HTTP client (replaces Retrofit in KMP projects)
+    // Note: ktor-client-android is the Android engine; use ktor-client-core in commonMain
+    "ktor": { groupId: "io.ktor", artifactId: "ktor-client-core" },
+    "ktor-core": { groupId: "io.ktor", artifactId: "ktor-client-core" },
+    "ktor-android": { groupId: "io.ktor", artifactId: "ktor-client-okhttp" },
+    "ktor-ios": { groupId: "io.ktor", artifactId: "ktor-client-darwin" },
+    "ktor-json": { groupId: "io.ktor", artifactId: "ktor-serialization-kotlinx-json" },
+    "ktor-negotiation": { groupId: "io.ktor", artifactId: "ktor-client-content-negotiation" },
+    // KMP — Kotlin Multiplatform core libraries
+    "kotlinx-serialization": { groupId: "org.jetbrains.kotlinx", artifactId: "kotlinx-serialization-json" },
+    "serialization": { groupId: "org.jetbrains.kotlinx", artifactId: "kotlinx-serialization-json" },
+    "kotlinx-datetime": { groupId: "org.jetbrains.kotlinx", artifactId: "kotlinx-datetime" },
+    "datetime": { groupId: "org.jetbrains.kotlinx", artifactId: "kotlinx-datetime" },
+    // Room KMP (stable since Room 2.7 — different from Android-only Room)
+    "room-kmp": { groupId: "androidx.room", artifactId: "room-runtime" },
+    "sqlite-bundled": { groupId: "androidx.sqlite", artifactId: "sqlite-bundled" },
+    // DataStore KMP (different from Android DataStore)
+    "datastore-kmp": { groupId: "androidx.datastore", artifactId: "datastore-preferences-core" },
+    // Koin — KMP-compatible DI (Hilt is Android-only, cannot be used in commonMain)
+    "koin": { groupId: "io.insert-koin", artifactId: "koin-core" },
+    "koin-android": { groupId: "io.insert-koin", artifactId: "koin-android" },
+    "koin-compose": { groupId: "io.insert-koin", artifactId: "koin-compose" },
+    // ── Image loading ──────────────────────────────────────────────────────────
+    // Coil 3 is the current major (io.coil-kt.coil3 group)
+    "coil": { groupId: "io.coil-kt.coil3", artifactId: "coil-compose" },
+    "coil3": { groupId: "io.coil-kt.coil3", artifactId: "coil-compose" },
+    "glide": { groupId: "com.github.bumptech.glide", artifactId: "glide" },
+    "glide-compose": { groupId: "com.github.bumptech.glide", artifactId: "compose" },
+    // ── Serialization ──────────────────────────────────────────────────────────
+    "gson": { groupId: "com.google.code.gson", artifactId: "gson" },
+    "moshi": { groupId: "com.squareup.moshi", artifactId: "moshi-kotlin" },
+    // Note: kotlinx-serialization is also listed in the KMP section above
+    // ── Kotlin ────────────────────────────────────────────────────────────────
+    "coroutines": { groupId: "org.jetbrains.kotlinx", artifactId: "kotlinx-coroutines-android" },
+    "kotlin-stdlib": { groupId: "org.jetbrains.kotlin", artifactId: "kotlin-stdlib" },
+    // ── Firebase ──────────────────────────────────────────────────────────────
+    "firebase-bom": { groupId: "com.google.firebase", artifactId: "firebase-bom" },
+    "firebase": { groupId: "com.google.firebase", artifactId: "firebase-bom" },
+    "firebase-analytics": { groupId: "com.google.firebase", artifactId: "firebase-analytics-ktx", bomManaged: true },
+    "firebase-auth": { groupId: "com.google.firebase", artifactId: "firebase-auth-ktx", bomManaged: true },
+    "firebase-firestore": { groupId: "com.google.firebase", artifactId: "firebase-firestore-ktx", bomManaged: true },
+    "firebase-crashlytics": { groupId: "com.google.firebase", artifactId: "firebase-crashlytics-ktx", bomManaged: true },
+    "firebase-messaging": { groupId: "com.google.firebase", artifactId: "firebase-messaging-ktx", bomManaged: true },
+    "firebase-storage": { groupId: "com.google.firebase", artifactId: "firebase-storage-ktx", bomManaged: true },
+    // ── Google Play Services ───────────────────────────────────────────────────
+    "play-services-auth": { groupId: "com.google.android.gms", artifactId: "play-services-auth" },
+    "play-services-maps": { groupId: "com.google.android.gms", artifactId: "play-services-maps" },
+    "credentials": { groupId: "androidx.credentials", artifactId: "credentials" },
+    "credentials-play": { groupId: "androidx.credentials", artifactId: "credentials-play-services-auth" },
+    // ── Paging / Data ─────────────────────────────────────────────────────────
+    "profileinstaller": { groupId: "androidx.profileinstaller", artifactId: "profileinstaller" },
+    "startup": { groupId: "androidx.startup", artifactId: "startup-runtime", releasePageSlug: "startup" },
+    "splashscreen": { groupId: "androidx.core", artifactId: "core-splashscreen", releasePageSlug: "core" },
+    "window": { groupId: "androidx.window", artifactId: "window", releasePageSlug: "window" },
+    "adaptive": { groupId: "androidx.compose.material3.adaptive", artifactId: "adaptive", releasePageSlug: "compose-material3-adaptive" },
+    "adaptive-compose": { groupId: "androidx.compose.material3.adaptive", artifactId: "adaptive-navigation" },
+    // ── Testing ───────────────────────────────────────────────────────────────
+    "mockk": { groupId: "io.mockk", artifactId: "mockk" },
+    "turbine": { groupId: "app.cash.turbine", artifactId: "turbine" },
+    "espresso": { groupId: "androidx.test.espresso", artifactId: "espresso-core" },
+    "compose-testing": { groupId: "androidx.compose.ui", artifactId: "ui-test-junit4", bomManaged: true },
+    // ── Plugins ───────────────────────────────────────────────────────────────
+    "agp": { groupId: "com.android.tools.build", artifactId: "gradle", isPlugin: true, pluginId: "com.android.application" },
+    "ksp": { groupId: "com.google.devtools.ksp", artifactId: "com.google.devtools.ksp.gradle.plugin", isPlugin: true, pluginId: "com.google.devtools.ksp" },
+    "kotlin-android": { groupId: "org.jetbrains.kotlin", artifactId: "kotlin-gradle-plugin", isPlugin: true, pluginId: "org.jetbrains.kotlin.android" },
+};
+// ── Maven fetchers ────────────────────────────────────────────────────────────
+async function fromGoogleMaven(groupId, artifactId) {
+    const groupPath = groupId.replace(/\./g, "/");
+    const url = `${GOOGLE_MAVEN_URL}/${groupPath}/${artifactId}/maven-metadata.xml`;
+    try {
+        const xml = await secureFetch(url);
+        const release = xml.match(/<release>([^<]+)<\/release>/)?.[1];
+        const latest = xml.match(/<latest>([^<]+)<\/latest>/)?.[1];
+        return release ?? latest ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function fromMavenCentral(groupId, artifactId) {
+    try {
+        const q = encodeURIComponent(`g:"${groupId}" AND a:"${artifactId}"`);
+        const url = `${MAVEN_SEARCH_URL}?q=${q}&rows=1&wt=json`;
+        const data = await secureFetchJson(url);
+        return data?.response?.docs?.[0]?.latestVersion ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function fromJetpackReleasesPage(slug) {
+    const url = `https://developer.android.com/jetpack/androidx/releases/${slug}`;
+    try {
+        const html = await secureFetch(url);
+        return extractPageText(html, 1800);
+    }
+    catch {
+        return `Could not fetch release page. Check: https://developer.android.com/jetpack/androidx/versions`;
+    }
+}
+// ── Output formatters ─────────────────────────────────────────────────────────
+function formatPlugin(entry, version) {
+    const pluginId = entry.pluginId ?? `${entry.groupId}.${entry.artifactId}`;
+    return (`**Plugin id:** \`${pluginId}\`\n` +
+        `**Latest Stable:** \`${version}\`\n\n` +
+        `\`\`\`kotlin\n// libs.versions.toml\n[plugins]\n${entry.artifactId.split(".")[0]} = { id = "${pluginId}", version = "${version}" }\n\n` +
+        `// build.gradle.kts\nplugins {\n    alias(libs.plugins.${entry.artifactId.split(".")[0]})\n}\n\`\`\``);
+}
+function formatBom(entry, version) {
+    const isFirebase = entry.groupId.startsWith("com.google.firebase");
+    const bomCoords = isFirebase
+        ? `com.google.firebase:firebase-bom:${version}`
+        : `${entry.groupId}:${entry.artifactId}:${version}`;
+    return (`**BOM managed — use \`platform()\` wrapper**\n` +
+        `**BOM version:** \`${version}\`\n\n` +
+        `\`\`\`kotlin\ndependencies {\n    implementation(platform("${bomCoords}"))\n    implementation("${entry.groupId}:${entry.artifactId}")  // no version — BOM pins it\n}\n\`\`\`\n\n` +
+        `> ✅ Import the BOM once; all matching artifacts pick up the pinned version automatically.`);
+}
+function formatLibrary(entry, version) {
+    const coords = `${entry.groupId}:${entry.artifactId}:${version}`;
+    return (`**Latest Stable:** \`${version}\`\n\n` +
+        `\`\`\`kotlin\n// Kotlin DSL\nimplementation("${coords}")\n\`\`\`\n\n` +
+        `\`\`\`groovy\n// Groovy DSL\nimplementation '${coords}'\n\`\`\`\n\n` +
+        `\`\`\`toml\n# libs.versions.toml\n[libraries]\n${entry.artifactId} = { group = "${entry.groupId}", name = "${entry.artifactId}", version = "${version}" }\n\`\`\``);
+}
+// ── Main handler ──────────────────────────────────────────────────────────────
+export async function gradleDependencyChecker(libraryName) {
+    if (!libraryName || libraryName.trim().length < 2) {
+        return "ERROR: Library name must be at least 2 characters.";
+    }
+    const name = libraryName.trim().toLowerCase().replace(/\s+/g, "-").slice(0, 100);
+    const header = `## AndroJack Gradle Dependency Checker\n**Library:** \`${libraryName}\`\n\n`;
+    const entry = LIBRARY_CATALOGUE[name];
+    if (entry) {
+        // Try Google Maven first (authoritative for Jetpack + Firebase)
+        let version = await fromGoogleMaven(entry.groupId, entry.artifactId);
+        // Fallback: Maven Central (for third-party: Retrofit, OkHttp, Coil, etc.)
+        if (!version)
+            version = await fromMavenCentral(entry.groupId, entry.artifactId);
+        if (version) {
+            let body;
+            if (entry.isPlugin) {
+                body = formatPlugin(entry, version);
+            }
+            else if (entry.bomManaged && (name.endsWith("-bom") || name === "firebase" || name === "firebase-bom" || name === "compose-bom")) {
+                body = formatBom(entry, version);
+            }
+            else if (entry.bomManaged) {
+                // Individual BOM-managed artifact — show both BOM and direct approaches
+                body =
+                    formatLibrary(entry, version) +
+                        `\n\n> 💡 Prefer importing the BOM (\`compose-bom\` or \`firebase-bom\`) to keep all artifacts version-aligned.`;
+            }
+            else {
+                body = formatLibrary(entry, version);
+            }
+            const releaseUrl = entry.releasePageSlug
+                ? `https://developer.android.com/jetpack/androidx/releases/${entry.releasePageSlug}`
+                : `https://search.maven.org/artifact/${entry.groupId}/${entry.artifactId}`;
+            return (header + body +
+                `\n\n**Official release notes:** ${releaseUrl}\n\n` +
+                `> ✅ GROUNDING GATE: Use version \`${version}\` as confirmed by authoritative Maven source.`);
+        }
+        // Version not found — serve release page content
+        if (entry.releasePageSlug) {
+            const text = await fromJetpackReleasesPage(entry.releasePageSlug);
+            return (header +
+                `**Version lookup inconclusive via automated search.**\n\n` +
+                `**Jetpack release page:**\n${text}\n\n` +
+                `> Check https://developer.android.com/jetpack/androidx/versions for current stable.`);
+        }
+    }
+    // Unknown library — try Maven Central by name
+    const mcResult = await fromMavenCentral(name, name);
+    if (mcResult) {
+        return (header +
+            `**Not in local catalogue — Maven Central result:**\n` +
+            formatLibrary({ groupId: "?", artifactId: name }, mcResult) +
+            `\n\n> ⚠️ Verify group ID and artifact ID at https://search.maven.org`);
+    }
+    return (header +
+        `**Library \`${libraryName}\` not found in local catalogue or Maven search.**\n\n` +
+        `Try searching manually:\n` +
+        `- https://search.maven.org/search?q=${encodeURIComponent(name)}\n` +
+        `- https://developer.android.com/jetpack/androidx/versions\n` +
+        `- https://firebase.google.com/docs/android/setup#available-libraries\n\n` +
+        `Common patterns: \`compose-bom\`, \`hilt\`, \`room\`, \`firebase-bom\`, \`retrofit\`, \`coil\`, \`credentials\``);
+}

package/build/tools/kmp.js

@@ -0,0 +1,348 @@
+// Tool 16: Kotlin Multiplatform (KMP) Guide
+// 900+ new KMP libraries published in 2025. Room, DataStore, Ktor all have KMP variants.
+// AI tools silently generate Android-only code for KMP projects — iOS build fails.
+export async function androidKmpGuide(topic) {
+    const t = topic.toLowerCase().trim();
+    const overview = `
+# Kotlin Multiplatform (KMP) — Official Reference (2025)
+Source: https://kotlinlang.org/docs/multiplatform.html
+
+## What KMP Is — And Is Not
+
+KMP shares **business logic and data layer** (domain, data, networking, storage) across
+Android and iOS while keeping **native UIs** on each platform. It is NOT Compose Multiplatform
+(CMP) — CMP shares UI as well, using Compose for iOS. They are separate, both valid.
+
+| Approach | What's Shared | UI |
+|----------|--------------|-----|
+| KMP only | Domain + Data layer | Native (SwiftUI on iOS, Compose on Android) |
+| KMP + CMP | Domain + Data + UI | Compose on all platforms |
+
+## Why AI Tools Get KMP Wrong
+
+When you ask "add Room to my KMP project," AI tools generate Android-only Room code.
+It compiles. Android works. iOS build fails. Silent correctness failure.
+Every major Jetpack library now has a KMP variant — always use the KMP artifact in KMP projects.
+
+## Project Structure
+
+\`\`\`
+shared/
+  src/
+    commonMain/kotlin/     ← shared code (use expect/actual for platform differences)
+    androidMain/kotlin/    ← Android-specific implementations
+    iosMain/kotlin/        ← iOS-specific implementations
+androidApp/                ← Android Compose UI
+iosApp/                    ← SwiftUI (Xcode project)
+\`\`\`
+
+## Gradle Setup (Kotlin DSL)
+
+\`\`\`kotlin
+// shared/build.gradle.kts
+plugins {
+  alias(libs.plugins.kotlinMultiplatform)
+  alias(libs.plugins.androidLibrary)
+  alias(libs.plugins.kotlinSerialization)
+  alias(libs.plugins.ksp)  // For Room KMP
+}
+
+kotlin {
+  androidTarget {
+    compilations.all { kotlinOptions { jvmTarget = "11" } }
+  }
+  listOf(iosX64(), iosArm64(), iosSimulatorArm64()).forEach { iosTarget ->
+    iosTarget.binaries.framework {
+      baseName = "Shared"
+      isStatic = true
+    }
+  }
+
+  sourceSets {
+    commonMain.dependencies {
+      implementation(libs.kotlinx.coroutines.core)
+      implementation(libs.kotlinx.serialization.json)
+      implementation(libs.ktor.client.core)           // Networking (NOT Retrofit — not KMP)
+      implementation(libs.ktor.client.content.negotiation)
+      implementation(libs.ktor.serialization.kotlinx.json)
+      implementation(libs.room.runtime)               // Room KMP
+      implementation(libs.sqlite.bundled)
+      implementation(libs.datastore.preferences.core) // DataStore KMP
+    }
+    androidMain.dependencies {
+      implementation(libs.ktor.client.okhttp)         // OkHttp engine on Android
+      implementation(libs.kotlinx.coroutines.android)
+    }
+    iosMain.dependencies {
+      implementation(libs.ktor.client.darwin)         // Darwin engine on iOS
+    }
+  }
+}
+\`\`\`
+
+Source: https://kotlinlang.org/docs/multiplatform-get-started.html
+`;
+    const libraries = `
+# KMP — Library Catalogue (2025)
+Source: https://kotlinlang.org/docs/multiplatform-introduce-frameworks.html
+
+## ⚠️ Android vs KMP Artifact Mapping — Where AI Tools Fail
+
+| Function | Android-Only (❌ use in KMP) | KMP Equivalent (✅ use in KMP) |
+|----------|---------------------------|-------------------------------|
+| Networking | Retrofit + OkHttp | **Ktor** (ktor-client-core) |
+| Database | Room (Android) | **Room KMP** (room-runtime, sqlite-bundled) |
+| Preferences | DataStore (Android) | **DataStore KMP** (datastore-preferences-core) |
+| JSON | Gson / Moshi | **kotlinx-serialization-json** |
+| DI | Hilt (Android only) | **Koin** (koin-core) or manual |
+| Image loading | Coil / Glide | **Coil3** (io.coil-kt.coil3 — KMP-ready) |
+| Date/Time | java.time | **kotlinx-datetime** |
+| Settings | SharedPreferences | DataStore KMP |
+
+## libs.versions.toml — KMP Dependencies
+
+\`\`\`toml
+[versions]
+kotlin = "2.1.0"
+ktor = "3.1.0"
+room = "2.7.0"           # Room KMP stable since 2.7
+kotlinxCoroutines = "1.10.1"
+kotlinxSerialization = "1.8.0"
+kotlinxDatetime = "0.6.2"
+datastore = "1.1.2"
+koin = "4.0.0"
+coil3 = "3.1.0"
+sqlite = "2.5.0"
+
+[libraries]
+# Ktor — Multiplatform HTTP client (replaces Retrofit in KMP)
+ktor-client-core = { group = "io.ktor", name = "ktor-client-core", version.ref = "ktor" }
+ktor-client-okhttp = { group = "io.ktor", name = "ktor-client-okhttp", version.ref = "ktor" }  # Android
+ktor-client-darwin = { group = "io.ktor", name = "ktor-client-darwin", version.ref = "ktor" }  # iOS
+ktor-client-content-negotiation = { group = "io.ktor", name = "ktor-client-content-negotiation", version.ref = "ktor" }
+ktor-serialization-kotlinx-json = { group = "io.ktor", name = "ktor-serialization-kotlinx-json", version.ref = "ktor" }
+
+# Room KMP
+room-runtime = { group = "androidx.room", name = "room-runtime", version.ref = "room" }
+room-compiler = { group = "androidx.room", name = "room-compiler", version.ref = "room" }  # KSP
+sqlite-bundled = { group = "androidx.sqlite", name = "sqlite-bundled", version.ref = "sqlite" }
+
+# DataStore KMP
+datastore-preferences-core = { group = "androidx.datastore", name = "datastore-preferences-core", version.ref = "datastore" }
+
+# kotlinx
+kotlinx-coroutines-core = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-core", version.ref = "kotlinxCoroutines" }
+kotlinx-coroutines-android = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-android", version.ref = "kotlinxCoroutines" }
+kotlinx-serialization-json = { group = "org.jetbrains.kotlinx", name = "kotlinx-serialization-json", version.ref = "kotlinxSerialization" }
+kotlinx-datetime = { group = "org.jetbrains.kotlinx", name = "kotlinx-datetime", version.ref = "kotlinxDatetime" }
+
+# Koin — KMP-compatible DI (Hilt is Android-only)
+koin-core = { group = "io.insert-koin", name = "koin-core", version.ref = "koin" }
+koin-android = { group = "io.insert-koin", name = "koin-android", version.ref = "koin" }
+koin-compose = { group = "io.insert-koin", name = "koin-compose", version.ref = "koin" }
+
+# Coil3 — KMP-ready image loading
+coil3-compose = { group = "io.coil-kt.coil3", name = "coil-compose", version.ref = "coil3" }
+coil3-network-ktor = { group = "io.coil-kt.coil3", name = "coil-network-ktor3", version.ref = "coil3" }
+\`\`\`
+
+Source: https://kotlinlang.org/docs/multiplatform-introduce-frameworks.html
+`;
+    const roomKmp = `
+# KMP — Room KMP Setup (Stable since Room 2.7)
+Source: https://developer.android.com/kotlin/multiplatform/room
+
+## Room KMP Gradle Setup
+
+\`\`\`kotlin
+// shared/build.gradle.kts
+plugins {
+  alias(libs.plugins.ksp)
+}
+
+kotlin {
+  sourceSets {
+    commonMain.dependencies {
+      implementation(libs.room.runtime)
+      implementation(libs.sqlite.bundled)
+    }
+  }
+}
+
+// KSP for Room compiler — apply to each target
+dependencies {
+  add("kspAndroid", libs.room.compiler)
+  add("kspIosX64", libs.room.compiler)
+  add("kspIosArm64", libs.room.compiler)
+  add("kspIosSimulatorArm64", libs.room.compiler)
+}
+\`\`\`
+
+## Room KMP Database — In commonMain
+
+\`\`\`kotlin
+// shared/src/commonMain/kotlin/Database.kt
+@Database(entities = [UserEntity::class], version = 1)
+abstract class AppDatabase : RoomDatabase() {
+  abstract fun userDao(): UserDao
+}
+
+@Dao
+interface UserDao {
+  @Query("SELECT * FROM users") fun getAllUsers(): Flow<List<UserEntity>>
+  @Insert suspend fun insert(user: UserEntity)
+  @Delete suspend fun delete(user: UserEntity)
+}
+
+@Entity(tableName = "users")
+data class UserEntity(
+  @PrimaryKey val id: String,
+  val name: String,
+  val email: String
+)
+\`\`\`
+
+## Platform-Specific Database Builder
+
+\`\`\`kotlin
+// shared/src/androidMain/kotlin/DatabaseBuilder.kt
+fun getDatabaseBuilder(ctx: Context): RoomDatabase.Builder<AppDatabase> {
+  val appContext = ctx.applicationContext
+  val dbFile = appContext.getDatabasePath("app.db")
+  return Room.databaseBuilder<AppDatabase>(appContext, dbFile.absolutePath)
+}
+
+// shared/src/iosMain/kotlin/DatabaseBuilder.kt
+fun getDatabaseBuilder(): RoomDatabase.Builder<AppDatabase> {
+  val dbFilePath = NSHomeDirectory() + "/app.db"
+  return Room.databaseBuilder<AppDatabase>(name = dbFilePath)
+}
+\`\`\`
+
+Source: https://developer.android.com/kotlin/multiplatform/room
+`;
+    const ktor = `
+# KMP — Ktor HTTP Client (Replaces Retrofit in KMP)
+Source: https://ktor.io/docs/client-create-multiplatform-application.html
+
+## Why Retrofit Cannot Be Used in KMP
+Retrofit depends on Java reflection and OkHttp — neither is available in iosMain.
+Ktor is the official KMP HTTP client with platform-specific engines.
+
+## Ktor API Client in commonMain
+
+\`\`\`kotlin
+// shared/src/commonMain/kotlin/ApiClient.kt
+import io.ktor.client.*
+import io.ktor.client.call.*
+import io.ktor.client.plugins.contentnegotiation.*
+import io.ktor.client.request.*
+import io.ktor.serialization.kotlinx.json.*
+import kotlinx.serialization.json.Json
+
+class ApiClient {
+  private val client = HttpClient {
+    install(ContentNegotiation) {
+      json(Json { ignoreUnknownKeys = true; isLenient = true })
+    }
+  }
+
+  suspend fun getUser(userId: String): User =
+    client.get("https://api.example.com/users/$userId").body()
+
+  suspend fun createPost(post: CreatePostRequest): Post =
+    client.post("https://api.example.com/posts") {
+      setBody(post)
+    }.body()
+}
+
+@Serializable
+data class User(val id: String, val name: String, val email: String)
+\`\`\`
+
+## Repository Pattern with Ktor
+
+\`\`\`kotlin
+// commonMain — same pattern as Android MVVM, works on all platforms
+interface UserRepository {
+  suspend fun getUser(id: String): Result<User>
+  fun observeUsers(): Flow<List<User>>
+}
+
+class UserRepositoryImpl(
+  private val apiClient: ApiClient,
+  private val userDao: UserDao
+) : UserRepository {
+  override suspend fun getUser(id: String): Result<User> = runCatching {
+    val entity = userDao.getUser(id) ?: run {
+      val user = apiClient.getUser(id)
+      userDao.insert(user.toEntity())
+      user
+    }
+    entity.toDomain()
+  }
+
+  override fun observeUsers(): Flow<List<User>> =
+    userDao.getAllUsers().map { entities -> entities.map { it.toDomain() } }
+}
+\`\`\`
+
+Source: https://ktor.io/docs/client-create-multiplatform-application.html
+`;
+    const expectActual = `
+# KMP — expect/actual Pattern
+Source: https://kotlinlang.org/docs/multiplatform-expect-actual.html
+
+## When to Use expect/actual
+
+Use expect/actual only for platform-specific capabilities with no KMP equivalent:
+- Platform-specific APIs (GPS, biometrics, camera)
+- Platform SDKs (Firebase iOS SDK vs Firebase Android SDK)
+- Performance-critical native code
+
+Do NOT use expect/actual for things that already have KMP libraries (networking, storage, etc.).
+
+## expect/actual Example — Platform Info
+
+\`\`\`kotlin
+// commonMain
+expect fun getPlatformName(): String
+expect class PlatformContext
+
+// androidMain
+actual fun getPlatformName(): String = "Android \${Build.VERSION.RELEASE}"
+actual typealias PlatformContext = Context
+
+// iosMain
+actual fun getPlatformName(): String = UIDevice.currentDevice.systemName()
+actual class PlatformContext
+\`\`\`
+
+## expect/actual for Coroutines Dispatcher
+
+\`\`\`kotlin
+// commonMain
+expect val backgroundDispatcher: CoroutineDispatcher
+
+// androidMain
+actual val backgroundDispatcher: CoroutineDispatcher = Dispatchers.IO
+
+// iosMain
+actual val backgroundDispatcher: CoroutineDispatcher = Dispatchers.Default
+\`\`\`
+
+Source: https://kotlinlang.org/docs/multiplatform-expect-actual.html
+`;
+    if (t.includes("room") || t.includes("database") || t.includes("db"))
+        return roomKmp;
+    if (t.includes("ktor") || t.includes("network") || t.includes("http") || t.includes("retrofit"))
+        return ktor;
+    if (t.includes("expect") || t.includes("actual") || t.includes("platform"))
+        return expectActual;
+    if (t.includes("librar") || t.includes("depend") || t.includes("gradle") || t.includes("toml"))
+        return libraries;
+    return overview + "\n\n---\n\n" +
+        "**Query topics:** 'libraries' (KMP dependency catalogue), 'room' (Room KMP setup), " +
+        "'ktor' (networking — replaces Retrofit), 'expect actual' (platform-specific code)\n\n" +
+        "Source: https://kotlinlang.org/docs/multiplatform.html";
+}