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

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

1. Run Diagnostics: Execute ./gradlew build, detekt, ktlintCheck
2. Parse Errors: Group by file and sort by severity
3. Fix Incrementally: One error at a time
4. Verify Each Fix: Re-run build after each change
5. 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

$ ./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

// Added import

import com.example.repository.UserRepository

$ ./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

// Changed

val count = call.parameters["count"]

// To

val count = call.parameters["count"]?.toIntOrNull()

?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid count")

$ ./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

// Added missing branch

when (user.role) {

Role.ADMIN -> handleAdmin(user)

Role.USER -> handleUser(user)

Role.MODERATOR -> handleModerator(user) // Added

}

$ ./gradlew build

Build successful!

## Final Verification

$ ./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

Fix Strategy

1. Build errors first - Code must compile
2. Detekt violations second - Fix code quality issues
3. ktlint warnings third - Fix formatting
4. One fix at a time - Verify each change
5. 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
• verification-loop skill - Full verification loop

Related

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