Add knit

Author: kpavlov

.github/workflows/build.yml

@@ -43,6 +43,7 @@ jobs:
           ./gradlew --no-daemon \
             --rerun-tasks \
             clean \
+            knit \
             ktlintCheck \
             build \
             -x :conformance-test:test \

build.gradle.kts

@@ -1,5 +1,6 @@
 plugins {
     id("mcp.dokka")
+    id("knit-convention")
     alias(libs.plugins.ktlint)
     alias(libs.plugins.kover)
 }

buildSrc/build.gradle.kts

@@ -13,4 +13,5 @@ dependencies {
     implementation(libs.kotlinx.atomicfu.gradle)
     implementation(libs.dokka.gradle)
     implementation(libs.maven.publish)
+    implementation(libs.kotlinx.knit)
 }

buildSrc/src/main/kotlin/knit-convention.gradle.kts

@@ -0,0 +1,11 @@
+plugins {
+    id("org.jetbrains.kotlinx.knit")
+}
+knit {
+    rootDir = projectDir
+    files = fileTree(projectDir) {
+        include("README.md")
+    }
+    defaultLineSeparator = "\n"
+    siteRoot = "" // Disable site root validation
+}

docs/.gitignore

@@ -0,0 +1,2 @@
+## Knit-generated sources
+src/

docs/build.gradle.kts

@@ -0,0 +1,27 @@
+import org.jetbrains.kotlin.gradle.dsl.ExplicitApiMode
+
+plugins {
+    id("mcp.multiplatform")
+}
+
+kotlin {
+    jvm()
+
+    explicitApi = ExplicitApiMode.Disabled
+
+    sourceSets {
+        jvmMain {
+            dependencies {
+                implementation(project(":kotlin-sdk"))
+                implementation(libs.kotlinx.coroutines.core)
+                implementation(libs.kotlinx.io.core)
+                implementation(libs.ktor.server.core)
+                implementation(libs.ktor.server.sse)
+            }
+        }
+    }
+}
+
+tasks.clean {
+    delete("src")
+}

gradle/libs.versions.toml

@@ -1,13 +1,14 @@
 [versions]
 # plugins version
-kotlin = "2.2.21"
-dokka = "2.1.0"
 atomicfu = "0.29.0"
-ktlint = "14.0.1"
+binaryCompatibilityValidatorPlugin = "0.18.1"
+dokka = "2.1.0"
+knit = "0.5.0"
+kotlin = "2.2.21"
 kover = "0.9.3"
-netty = "4.2.7.Final"
+ktlint = "14.0.1"
 mavenPublish = "0.35.0"
-binaryCompatibilityValidatorPlugin = "0.18.1"
+netty = "4.2.7.Final"
 openapi-generator = "7.17.0"
 
 # libraries version
@@ -30,6 +31,7 @@ dokka-gradle = { module = "org.jetbrains.dokka:dokka-gradle-plugin", version.ref
 kotlin-gradle = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlin" }
 kotlin-serialization = { module = "org.jetbrains.kotlin:kotlin-serialization", version.ref = "kotlin" }
 kotlinx-atomicfu-gradle = { module = "org.jetbrains.kotlinx:atomicfu-gradle-plugin", version.ref = "atomicfu" }
+kotlinx-knit = { module = "org.jetbrains.kotlinx:kotlinx-knit", version.ref = "knit" }
 maven-publish = { module = "com.vanniktech:gradle-maven-publish-plugin", version.ref = "mavenPublish" }
 
 # Kotlinx libraries

knit.properties

@@ -0,0 +1,3 @@
+# Knit configuration
+knit.package = io.modelcontextprotocol.kotlin.sdk.examples
+knit.dir = docs/src/jvmMain/kotlin

settings.gradle.kts

@@ -23,5 +23,6 @@ include(
     ":kotlin-sdk-server",
     ":kotlin-sdk",
     ":kotlin-sdk-test",
+    ":docs",
     ":conformance-test",
 )