feat(linter): add AI-powered linting and detectors #453

Introduce AI-based linting with new detectors and exports. Update related core logic and documentation to support enhanced linting capabilities.

Author: phodal

mpp-core/docs/linter.md

@@ -5,16 +5,16 @@
 | Azure DevOps Pipelines      | Pipeline Remediation                        | CI/CD Failure Remediation                           |
 | CircleCI                    | CircleCI, Pipeline Remediation              | Configuration Validation, CI/CD Failure Remediation |
 | CloudFormation              | Checkov                                     | Code Security                                       |
-| Cppcheck                    | Cppcheck                                    | Code Quality                                        |
+| Cppcheck                    | Cppcheck                       ``           | Code Quality                                        |
 | CSS                         | Biome                                       | Code Quality                                        |
 | Docker                      | Hadolint, Checkov                           | Code Quality, Code Security                         |
 | Environment Files (.env)    | Dotenv Linter                               | Code Quality                                        |
 | GitHub Actions              | actionlint, Pipeline Remediation            | Code Quality, CI/CD Failure Remediation             |
 | GitLab Pipelines            | Pipeline Remediation                        | CI/CD Failure Remediation                           |
-| Go                          | golangci-lint         ``                      | Code Quality                                        |
+| Go                          | golangci-lint         ``                    | Code Quality                                        |
 | Helm                        | Checkov                                     | Code Security                                       |
 | HTML                        | HTMLHint                                    | Code Quality                                        |
-| Javascript                  | Biome, oxlint                               | Code Quality                                        |
+| Javascript                  | Biome, lint                                 | Code Quality                                        |
 | JSON, JSONC                 | Biome                                       | Code Quality                                        |
 | JSX                         | Biome, oxlint                               | Code Quality                                        |
 | Kotlin                      | detekt                                      | Code Quality                                        |
@@ -41,4 +41,4 @@
 | Typescript                  | Biome, oxlint                               | Code Quality                                        |
 | YAML                        | YAMLlint                                    | Code Quality                                        |
 | Prisma                      | Prisma Lint                                 | Code Quality                                        |
-``
+``

mpp-core/src/commonMain/kotlin/cc/unitmesh/agent/CodeReviewAgent.kt

@@ -158,12 +158,26 @@ class CodeReviewAgent(
     }
 
     private suspend fun buildContext(task: ReviewTask): CodeReviewContext {
+        // Get linter summary for the files
+        val linterSummary = if (task.filePaths.isNotEmpty()) {
+            try {
+                val linterRegistry = cc.unitmesh.agent.linter.LinterRegistry.getInstance()
+                linterRegistry.getLinterSummaryForFiles(task.filePaths)
+            } catch (e: Exception) {
+                logger.warn { "Failed to get linter summary: ${e.message}" }
+                null
+            }
+        } else {
+            null
+        }
+
         return CodeReviewContext(
             projectPath = task.projectPath,
             filePaths = task.filePaths,
             reviewType = task.reviewType,
             additionalContext = task.additionalContext,
-            toolList = formatToolList()
+            toolList = formatToolList(),
+            linterSummary = linterSummary
         )
     }
 
@@ -222,7 +236,8 @@ data class CodeReviewContext(
     val filePaths: List<String>,
     val reviewType: ReviewType,
     val additionalContext: String,
-    val toolList: String
+    val toolList: String,
+    val linterSummary: cc.unitmesh.agent.linter.LinterSummary? = null
 )
 
 /**

mpp-core/src/commonMain/kotlin/cc/unitmesh/agent/CodeReviewAgentPromptRenderer.kt

@@ -15,16 +15,59 @@ class CodeReviewAgentPromptRenderer {
             else -> CodeReviewAgentTemplate.EN
         }
 
+        val linterInfo = formatLinterInfo(context.linterSummary)
+
         val prompt = template
             .replace("{{projectPath}}", context.projectPath)
             .replace("{{reviewType}}", context.reviewType.name)
             .replace("{{filePaths}}", context.filePaths.joinToString(", "))
             .replace("{{toolList}}", context.toolList)
             .replace("{{additionalContext}}", context.additionalContext)
+            .replace("{{linterInfo}}", linterInfo)
 
         logger.debug { "Generated code review prompt (${prompt.length} chars)" }
         return prompt
     }
+
+    private fun formatLinterInfo(summary: cc.unitmesh.agent.linter.LinterSummary?): String {
+        if (summary == null) {
+            return "No linter information available."
+        }
+
+        return buildString {
+            appendLine("### Available Linters")
+            appendLine()
+
+            if (summary.availableLinters.isNotEmpty()) {
+                appendLine("**Installed and Ready (${summary.availableLinters.size}):**")
+                summary.availableLinters.forEach { linter ->
+                    appendLine("- **${linter.name}** ${linter.version?.let { "($it)" } ?: ""}")
+                    if (linter.supportedFiles.isNotEmpty()) {
+                        appendLine("  - Files: ${linter.supportedFiles.joinToString(", ")}")
+                    }
+                }
+                appendLine()
+            }
+
+            if (summary.unavailableLinters.isNotEmpty()) {
+                appendLine("**Not Installed (${summary.unavailableLinters.size}):**")
+                summary.unavailableLinters.forEach { linter ->
+                    appendLine("- **${linter.name}**")
+                    linter.installationInstructions?.let {
+                        appendLine("  - Install: $it")
+                    }
+                }
+                appendLine()
+            }
+
+            if (summary.fileMapping.isNotEmpty()) {
+                appendLine("### File-Linter Mapping")
+                summary.fileMapping.forEach { (file, linters) ->
+                    appendLine("- `$file` → ${linters.joinToString(", ")}")
+                }
+            }
+        }
+    }
 }
 
 /**
@@ -60,6 +103,10 @@ Analyze code thoroughly and provide constructive, actionable feedback. Focus on:
 - **Files to Review**: {{filePaths}}
 - **Additional Context**: {{additionalContext}}
 
+## Linter Information
+
+{{linterInfo}}
+
 ## Available Tools
 
 {{toolList}}
@@ -159,6 +206,10 @@ Be constructive, specific, and actionable in your feedback.
 - **待审查文件**: {{filePaths}}
 - **额外上下文**: {{additionalContext}}
 
+## Linter 信息
+
+{{linterInfo}}
+
 ## 可用工具
 
 {{toolList}}