Skip to main content
Kodelyth ECC
Command

/kotlin-build

Fix Kotlin/Gradle build errors, compiler warnings, and dependency issues incrementally. Invokes the kotlin-build-resolver agent for minimal, surgical fixes.

Run:/kotlin-build

Kotlin Build and Fix

This command invokes the kotlin-build-resolver agent to incrementally fix Kotlin build errors with minimal changes.

What This Command Does

  • Run Diagnostics: Execute ./gradlew build, detekt, ktlintCheck
  • Parse Errors: Group by file and sort by severity
  • Fix Incrementally: One error at a time
  • Verify Each Fix: Re-run build after each change
  • Report Summary: Show what was fixed and what remains

When to Use

Use /kotlin-build when:

  • ./gradlew build fails with errors
  • Kotlin compiler reports errors
  • ./gradlew detekt reports violations
  • Gradle dependency resolution fails
  • After pulling changes that break the build

Diagnostic Commands Run

# Primary build check
./gradlew build 2>&1
Static analysis

./gradlew detekt 2>&1 || echo "detekt not configured"
./gradlew ktlintCheck 2>&1 || echo "ktlint not configured"
Dependency issues

./gradlew dependencies --configuration runtimeClasspath 2>&1 | head -100
Optional deep refresh when caches or dependency metadata are suspect

./gradlew build --refresh-dependencies

Example Session

User: /kotlin-build
Agent:

Kotlin Build Resolution
Initial Diagnostics
bash $ ./gradlew build e: src/main/kotlin/com/example/service/UserService.kt:25:15 Unresolved reference: UserRepository e: src/main/kotlin/com/example/routes/UserRoutes.kt:42:9 Type mismatch: inferred type is String but Int was expected e: src/main/kotlin/com/example/routes/UserRoutes.kt:58:5 'when' expression must be exhaustive 

Errors found: 3
Fix 1: Unresolved Reference
File: src/main/kotlin/com/example/service/UserService.kt:25
Error: Unresolved reference: UserRepository
Cause: Missing import
kotlin // Added import import com.example.repository.UserRepository
bash $ ./gradlew build

2 errors remaining



Fix 2: Type Mismatch
File: src/main/kotlin/com/example/routes/UserRoutes.kt:42
Error: Type mismatch: inferred type is String but Int was expected
kotlin // Changed val count = call.parameters["count"] // To val count = call.parameters["count"]?.toIntOrNull() ?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid count")
bash $ ./gradlew build

1 error remaining



Fix 3: Non-Exhaustive When
File: src/main/kotlin/com/example/routes/UserRoutes.kt:58
Error: 'when' expression must be exhaustive
kotlin // Added missing branch when (user.role) { Role.ADMIN -> handleAdmin(user) Role.USER -> handleUser(user) Role.MODERATOR -> handleModerator(user) // Added }
bash $ ./gradlew build

Build successful!



Final Verification
bash $ ./gradlew detekt

No issues

$ ./gradlew test

All tests passed



Summary
| Metric | Count |
|--------|-------|
| Build errors fixed | 3 |
| Detekt issues fixed | 0 |
| Files modified | 2 |
| Remaining issues | 0 |
Build Status: PASS: SUCCESS

Common Errors Fixed

| Error | Typical Fix | |-------|-------------| | Unresolved reference: X | Add import or dependency | | Type mismatch | Fix type conversion or assignment | | 'when' must be exhaustive | Add missing sealed class branches | | Suspend function can only be called from coroutine | Add suspend modifier | | Smart cast impossible | Use local val or let | | None of the following candidates is applicable | Fix argument types | | Could not resolve dependency | Fix version or add repository |

Fix Strategy

  • Build errors first - Code must compile
  • Detekt violations second - Fix code quality issues
  • ktlint warnings third - Fix formatting
  • One fix at a time - Verify each change
  • Minimal changes - Don't refactor, just fix

Stop Conditions

The agent will stop and report if:

  • Same error persists after 3 attempts
  • Fix introduces more errors
  • Requires architectural changes
  • Missing external dependencies

Related Commands

  • /kotlin-test - Run tests after build succeeds
  • /kotlin-review - Review code quality
  • /verify - Full verification loop

Related

  • Agent: agents/kotlin-build-resolver.md
  • Skill: skills/kotlin-patterns/

Agents this command fires

kotlin-build-resolver

Related skills

kotlin-patterns
← All commands