Sonarqube Analyzer

# SonarQube Analyzer Skill

Analisa projetos no SonarQube self-hosted, obtém issues e sugere soluções automatizadas.

## Ferramentas Registradas

### `sonar_get_issues`
Obtém lista de issues de um projeto/PR no SonarQube.

**Parâmetros:**
- `projectKey` (string, obrigatório): Chave do projeto
- `pullRequest` (string, opcional): Número da PR para análise específica
- `severities` (string[], opcional): Severidades a filtrar (BLOCKER, CRITICAL, MAJOR, MINOR, INFO)
- `status` (string, opcional): Status das issues (OPEN, CONFIRMED, FALSE_POSITIVE, etc.)
- `limit` (number, opcional): Limite de issues (padrão: 100)

**Exemplo:**
```json
{
  "projectKey": "openclaw-panel",
  "pullRequest": "5",
  "severities": ["CRITICAL", "MAJOR"],
  "limit": 50
}
```

### `sonar_analyze_and_suggest`
Analisa issues e sugere soluções com base nas regras do SonarQube.

**Parâmetros:**
- `projectKey` (string, obrigatório): Chave do projeto
- `pullRequest` (string, opcional): Número da PR
- `autoFix` (boolean, opcional): Tentar aplicar correções automáticas (padrão: false)

**Exemplo:**
```json
{
  "projectKey": "openclaw-panel",
  "pullRequest": "5",
  "autoFix": false
}
```

### `sonar_quality_gate`
Verifica o status do Quality Gate de um projeto.

**Parâmetros:**
- `projectKey` (string, obrigatório): Chave do projeto
- `pullRequest` (string, opcional): Número da PR

**Exemplo:**
```json
{
  "projectKey": "openclaw-panel",
  "pullRequest": "5"
}
```

## Configuração

O skill usa as seguintes configurações do ambiente:

```bash
SONAR_HOST_URL=http://127.0.0.1:9000  # URL do SonarQube
SONAR_TOKEN=admin                      # Token de autenticação
```

## Uso

### Analisar uma PR específica:
```bash
node scripts/analyze.js --project=my-project --pr=5
```

### Gerar relatório de issues:
```bash
node scripts/report.js --project=my-project --format=markdown
```

### Verificar Quality Gate:
```bash
node scripts/quality-gate.js --project=my-project --pr=5
```

## Estrutura de Resposta

### sonar_get...

# OpenClaw SonarQube Analyzer

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
[![OpenClaw Plugin](https://img.shields.io/badge/OpenClaw-Plugin-blue)](https://docs.openclaw.ai)

An **OpenClaw Plugin + CLI Skill** for automated SonarQube code quality analysis with intelligent issue detection and suggested solutions.

## 🎯 Dual Mode

This package works in **two modes**:

| Mode | Use Case | Installation |
|------|----------|--------------|
| **OpenClaw Plugin** | AI agents, automation, cron jobs | Add to `openclaw.json` |
| **CLI Tool** | Manual analysis, CI/CD scripts | `npm install -g` or `npx` |

## 🎯 Overview

This skill integrates with SonarQube self-hosted instances to:
- Fetch and analyze code quality issues
- Provide intelligent solutions based on SonarQube rules
- Generate actionable reports in JSON or Markdown
- Check Quality Gate status
- Distinguish between auto-fixable and manual-fix issues

## 🚀 Quick Start

### Mode 1: OpenClaw Plugin (Recommended for AI Agents)

Install as an OpenClaw plugin to use native tools (`sonar_get_issues`, `sonar_analyze_and_suggest`, `sonar_quality_gate`):

```bash
# Clone to your OpenClaw workspace
git clone https://github.com/FelipeOFF/sonarqube-analyzer.git \
  ~/.openclaw/workspace/skills/sonarqube-analyzer

# Install dependencies
cd ~/.openclaw/workspace/skills/sonarqube-analyzer
npm install
```

Add to your `~/.openclaw/openclaw.json`:

```json
{
  "plugins": {
    "load": {
      "paths": [
        "/home/YOUR_USER/.openclaw/workspace/skills/sonarqube-analyzer"
      ]
    },
    "entries": {
      "sonarqube-analyzer": {
        "enabled": true,
        "config": {
          "sonarHostUrl": "http://127.0.0.1:9000",
          "sonarToken": "your-token-here",
          "defaultProject": "my-project"
        }
      }
    }
  }
}
```

Then reload OpenClaw:
``...