moai-adk 0.8.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-lang-kotlin/SKILL.md

@@ -1,124 +1,145 @@
 ---
-name: moai-lang-kotlin
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: Kotlin 2.1+ best practices with JUnit 5, Gradle, ktlint, coroutines, and extension functions.
-keywords: ['kotlin', 'junit', 'gradle', 'ktlint', 'coroutines']
-allowed-tools:
-  - Read
-  - Bash
+name: "moai-lang-kotlin"
+description: "Kotlin 2.0+ development specialist covering Ktor, coroutines, Compose Multiplatform, and Kotlin-idiomatic patterns. Use when building Kotlin server apps, Android apps, or multiplatform projects."
+version: 1.1.0
+category: "language"
+modularized: false
+user-invocable: false
+tags: ['kotlin', 'ktor', 'coroutines', 'compose', 'android', 'multiplatform']
+context7-libraries: "/ktorio/ktor, /jetbrains/compose-multiplatform, /jetbrains/exposed"
+related-skills: "moai-lang-java, moai-lang-swift"
+updated: 2026-01-11
+status: "active"
 ---
 
-# Lang Kotlin Skill
+## Quick Reference (30 seconds)
 
-## Skill Metadata
+Kotlin 2.0+ Expert - K2 compiler, coroutines, Ktor, Compose Multiplatform with Context7 integration.
 
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-lang-kotlin |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Language |
+Auto-Triggers: Kotlin files (`.kt`, `.kts`), Gradle Kotlin DSL (`build.gradle.kts`, `settings.gradle.kts`)
+
+Core Capabilities:
+
+- Kotlin 2.0: K2 compiler, coroutines, Flow, sealed classes, value classes
+- Ktor 3.0: Async HTTP server/client, WebSocket, JWT authentication
+- Exposed 0.55: Kotlin SQL framework with coroutines support
+- Spring Boot (Kotlin): Kotlin-idiomatic Spring with WebFlux
+- Compose Multiplatform: Desktop, iOS, Web, Android UI
+- Testing: JUnit 5, MockK, Kotest, Turbine for Flow testing
 
 ---
 
-## What It Does
+## Implementation Guide (5 minutes)
 
-Kotlin 2.1+ best practices with JUnit 5, Gradle, ktlint, coroutines, and extension functions.
+### Kotlin 2.0 Features
 
-**Key capabilities**:
-- ✅ Best practices enforcement for language domain
-- ✅ TRUST 5 principles integration
-- ✅ Latest tool versions (2025-10-22)
-- ✅ TDD workflow support
+Coroutines and Flow: Use coroutineScope with async for parallel operations. Create deferred values with async, then call await on each to get results. Combine results into data classes. For reactive streams, create flow blocks with emit calls inside while loops. Use delay for intervals and flowOn to specify dispatcher.
 
----
+Sealed Classes and Value Classes: Define sealed interface with generic type parameter. Create data class implementations for success and data object for stateless cases like Loading. Use @JvmInline annotation with value class wrapping a primitive. Add init blocks with require for validation.
 
-## When to Use
+### Ktor 3.0 Server
 
-**Automatic triggers**:
-- Related code discussions and file patterns
-- SPEC implementation (`/alfred:2-run`)
-- Code review requests
+Application Setup: Call embeddedServer with Netty, port, and host parameters. Inside the lambda, call configuration functions for Koin, security, routing, and content negotiation. Call start with wait equals true.
 
-**Manual invocation**:
-- Review code for TRUST 5 compliance
-- Design new features
-- Troubleshoot issues
+For Koin configuration, install Koin plugin and define modules with single declarations for singletons. For security, install Authentication plugin and configure JWT with realm, verifier, and validate callback. For content negotiation, install ContentNegotiation with json configuration.
 
----
+Routing with Authentication: Define routing function on Application. Inside routing block, use route for path prefixes. Create unauthenticated endpoints with post and call.receive for request body. Use authenticate block with verifier name for protected routes. Inside route blocks, define get endpoints with call.parameters for path/query params. Use call.respond with status code and response body.
+
+### Exposed SQL Framework
+
+Table and Entity: Define object extending LongIdTable with table name. Declare columns with varchar, enumerationByName, and timestamp functions. Use uniqueIndex() and defaultExpression for defaults.
 
-## Tool Version Matrix (2025-10-22)
+Create entity class extending LongEntity with companion object extending LongEntityClass. Declare properties with by syntax using table column references. Create toModel function to map entity to domain model.
 
-| Tool | Version | Purpose | Status |
-|------|---------|---------|--------|
-| **Kotlin** | 2.1.0 | Primary | ✅ Current |
-| **JUnit** | 5.11.0 | Primary | ✅ Current |
-| **Gradle** | 8.12.0 | Primary | ✅ Current |
-| **ktlint** | 1.5.0 | Primary | ✅ Current |
+Repository with Coroutines: Create repository implementation taking Database parameter. Implement suspend functions wrapping Exposed operations in dbQuery helper. Use findById for single entity lookup. Use Entity.new for inserts. Define private dbQuery function using newSuspendedTransaction with IO dispatcher.
+
+### Spring Boot with Kotlin
+
+WebFlux Controller: Annotate class with @RestController and @RequestMapping. Create suspend functions for endpoints with @GetMapping and @PostMapping. Return Flow for collections using map to convert entities. Return ResponseEntity with status codes. Use @Valid for request validation.
 
 ---
 
-## Inputs
+## Advanced Patterns
 
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
+### Compose Multiplatform
 
-## Outputs
+Shared UI Component: Create @Composable function taking ViewModel and callback parameters. Collect uiState as state with collectAsState. Use when expression on sealed state to show different composables for Loading, Success, and Error.
 
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
+For list items, create Card composables with Modifier.fillMaxWidth and clickable. Use Row with padding, AsyncImage for avatars with CircleShape clip, and Column for text content with MaterialTheme.typography.
 
-## Failure Modes
+### Testing with MockK
 
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
+Create test class with mockk for dependencies. Initialize service with mock in declaration. Use @Test with runTest for coroutine tests. Use coEvery with coAnswers for async mocking with delay. Use assertThat for assertions. For Flow testing, use toList to collect emissions and assert on size and content.
 
-## Dependencies
+### Gradle Build Configuration
 
-- Access to project files via Read/Bash tools
-- Integration with `moai-foundation-langs` for language detection
-- Integration with `moai-foundation-trust` for quality gates
+Use plugins block with kotlin("jvm") and kotlin("plugin.serialization") with version strings. Add id for ktor.plugin. Configure kotlin block with jvmToolchain. In dependencies block, add ktor server modules, kotlinx coroutines, exposed modules, and postgresql driver. Add test dependencies for mockk, coroutines-test, and turbine.
 
 ---
 
-## References (Latest Documentation)
+## Context7 Integration
+
+Library mappings for latest documentation:
 
-_Documentation links updated 2025-10-22_
+- `/ktorio/ktor` - Ktor 3.0 server/client documentation
+- `/jetbrains/exposed` - Exposed SQL framework
+- `/JetBrains/kotlin` - Kotlin 2.0 language reference
+- `/Kotlin/kotlinx.coroutines` - Coroutines library
+- `/jetbrains/compose-multiplatform` - Compose Multiplatform
+- `/arrow-kt/arrow` - Arrow functional programming
+
+Usage: Call mcp__context7__get_library_docs with context7CompatibleLibraryID, topic string for specific areas, and tokens parameter for response size.
 
 ---
 
-## Changelog
+## When to Use Kotlin
+
+Use Kotlin When:
+
+- Developing Android applications (official language)
+- Building modern server applications with Ktor
+- Preferring concise, expressive syntax
+- Building reactive services with coroutines and Flow
+- Creating multiplatform applications (iOS, Desktop, Web)
+- Full Java interoperability required
 
-- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
-- **v1.0.0** (2025-03-29): Initial Skill release
+Consider Alternatives When:
+
+- Legacy Java codebase requiring minimal changes
+- Big data pipelines (prefer Scala with Spark)
 
 ---
 
 ## Works Well With
 
-- `moai-foundation-trust` (quality gates)
-- `moai-alfred-code-reviewer` (code review)
-- `moai-essentials-debug` (debugging support)
+- `moai-lang-java` - Java interoperability and Spring Boot patterns
+- `moai-domain-backend` - REST API, GraphQL, microservices architecture
+- `moai-domain-database` - JPA, Exposed, R2DBC patterns
+- `moai-quality-testing` - JUnit 5, MockK, TestContainers integration
+- `moai-infra-docker` - JVM container optimization
 
 ---
 
-## Best Practices
+## Troubleshooting
+
+K2 Compiler: Add kotlin.experimental.tryK2=true to gradle.properties. Clear .gradle directory for full rebuild.
+
+Coroutines: Avoid runBlocking in suspend contexts. Use Dispatchers.IO for blocking operations.
 
-✅ **DO**:
-- Follow language best practices
-- Use latest stable tool versions
-- Maintain test coverage ≥85%
-- Document all public APIs
+Ktor: Ensure ContentNegotiation is installed. Check JWT verifier configuration. Verify routing hierarchy.
+
+Exposed: Ensure all DB operations run within transaction context. Be aware of lazy entity loading outside transactions.
+
+---
+
+## Advanced Documentation
+
+For comprehensive reference materials:
+
+- [reference.md](reference.md) - Complete ecosystem, Context7 mappings, testing patterns, performance
+- [examples.md](examples.md) - Production-ready code examples, Ktor, Compose, Android patterns
+
+---
 
-❌ **DON'T**:
-- Skip quality gates
-- Use deprecated tools
-- Ignore security warnings
-- Mix testing frameworks
+Last Updated: 2026-01-11
+Status: Production Ready (v1.1.0)