[H1][SONARCLOUD-TOOLS]
Dictum: Zero-arg defaults enable immediate code quality inspection.
Execute SonarCloud queries through unified Python CLI.
[IMPORTANT] Commands default to project=bsamiee_Parametric_Portal, organization=bsamiee. 1Password auto-injects API token. SonarCloud API base: https://sonarcloud.io/api.
[0][SCANNER]
Dictum: Local scanner enables pre-push quality gates.
Run Analysis:
pnpm sonar
Requirements:
SONAR_TOKEN environment variable (1Password injection or export)- Coverage reports at
packages/*/coverage/lcov.info (run nx run-many -t test first)
Configuration: sonar-project.properties at repo root.
[1][COMMANDS]
| [CMD] |
[ARGS] |
[PURPOSE] |
| quality-gate |
[branch] or pr <num> |
Quality gate pass/fail status |
| issues |
[severities] [types] |
Search code issues |
| measures |
[metrics] |
Project metrics |
| analyses |
[page_size] |
Analysis history |
| projects |
[page_size] |
List organization projects |
| hotspots |
[status] |
Security hotspots |
[2][USAGE]
# Zero-arg invocation (most common)
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py measures
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py analyses
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py projects
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py hotspots
# With optional args
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate main
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate pr 42
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues BLOCKER,CRITICAL
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues BLOCKER,CRITICAL BUG,VULNERABILITY
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py measures coverage,bugs
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py analyses 20
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py projects 50
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py hotspots TO_REVIEW
[3][ARGUMENTS]
quality-gate: [branch] or pr <num>
- No args -- current default branch
main -- specific branchpr 42 -- specific pull request
issues: [severities] [types]
severities -- Comma-separated: BLOCKER, CRITICAL, MAJOR, MINOR, INFOtypes -- Comma-separated: BUG, VULNERABILITY, CODE_SMELL
measures: [metrics]
metrics -- Comma-separated (default: all standard metrics)- Standard:
ncloc, coverage, bugs, vulnerabilities, code_smells, duplicated_lines_density, security_hotspots, reliability_rating, security_rating, sqale_rating
analyses: [page_size]
page_size -- Number of results (default: 10, max: 100)
projects: [page_size]
page_size -- Number of results (default: 100, max: 500)
hotspots: [status]
status -- Filter: TO_REVIEW, ACKNOWLEDGED, FIXED, SAFE
[4][OUTPUT]
Commands return: {"status": "success|error", ...}.
| [INDEX] |
[CMD] |
[RESPONSE] |
| [1] |
quality-gate |
{project, gate_status, passed: bool, conditions[]} |
| [2] |
issues |
{project, total, issues[], summary} |
| [3] |
measures |
{project, name, metrics} |
| [4] |
analyses |
{project, total, analyses[]} |
| [5] |
projects |
{organization, total, projects[]} |
| [6] |
hotspots |
{project, total, hotspots[]} |
[5][ENVIRONMENT]
| [VAR] |
[REQUIRED] |
[DESCRIPTION] |
SONAR_TOKEN |
Yes |
SonarCloud API token (1Password) |
[6][ERROR_HANDLING]
- HTTP errors print
[ERROR] <status>: <body> and exit 1
- Missing token:
[ERROR] SONAR_TOKEN environment variable not set
- Project not found:
[ERROR] 404: Component not found
- Invalid metric name: returns empty metric value (not an error)
1---2name: sonarcloud-tools3description: Executes SonarCloud API operations for quality gates, issues, metrics, analysis history, and security hotspots. Use when checking code quality, inspecting bugs/vulnerabilities, retrieving coverage/complexity metrics, or viewing project security status.4---56# [H1][SONARCLOUD-TOOLS]7>**Dictum:** *Zero-arg defaults enable immediate code quality inspection.*89<br>1011Execute SonarCloud queries through unified Python CLI.1213[IMPORTANT] Commands default to `project=bsamiee_Parametric_Portal`, `organization=bsamiee`. 1Password auto-injects API token. SonarCloud API base: `https://sonarcloud.io/api`.1415---16## [0][SCANNER]17>**Dictum:** *Local scanner enables pre-push quality gates.*1819<br>2021**Run Analysis:**22```bash23pnpm sonar24```2526**Requirements:**27- `SONAR_TOKEN` environment variable (1Password injection or export)<br>28- Coverage reports at `packages/*/coverage/lcov.info` (run `nx run-many -t test` first)2930**Configuration:** `sonar-project.properties` at repo root.3132---33## [1][COMMANDS]3435| [CMD] | [ARGS] | [PURPOSE] |36| ------------ | ------------------------ | ----------------------------- |37| quality-gate | `[branch]` or `pr <num>` | Quality gate pass/fail status |38| issues | `[severities] [types]` | Search code issues |39| measures | `[metrics]` | Project metrics |40| analyses | `[page_size]` | Analysis history |41| projects | `[page_size]` | List organization projects |42| hotspots | `[status]` | Security hotspots |4344---45## [2][USAGE]4647```bash48# Zero-arg invocation (most common)49uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate50uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues51uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py measures52uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py analyses53uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py projects54uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py hotspots5556# With optional args57uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate main58uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate pr 4259uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues BLOCKER,CRITICAL60uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues BLOCKER,CRITICAL BUG,VULNERABILITY61uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py measures coverage,bugs62uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py analyses 2063uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py projects 5064uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py hotspots TO_REVIEW65```6667---68## [3][ARGUMENTS]6970**quality-gate**: `[branch]` or `pr <num>`71- No args -- current default branch72- `main` -- specific branch73- `pr 42` -- specific pull request7475**issues**: `[severities] [types]`76- `severities` -- Comma-separated: `BLOCKER`, `CRITICAL`, `MAJOR`, `MINOR`, `INFO`77- `types` -- Comma-separated: `BUG`, `VULNERABILITY`, `CODE_SMELL`7879**measures**: `[metrics]`80- `metrics` -- Comma-separated (default: all standard metrics)81- Standard: `ncloc`, `coverage`, `bugs`, `vulnerabilities`, `code_smells`, `duplicated_lines_density`, `security_hotspots`, `reliability_rating`, `security_rating`, `sqale_rating`8283**analyses**: `[page_size]`84- `page_size` -- Number of results (default: `10`, max: `100`)8586**projects**: `[page_size]`87- `page_size` -- Number of results (default: `100`, max: `500`)8889**hotspots**: `[status]`90- `status` -- Filter: `TO_REVIEW`, `ACKNOWLEDGED`, `FIXED`, `SAFE`9192---93## [4][OUTPUT]9495Commands return: `{"status": "success|error", ...}`.9697| [INDEX] | [CMD] | [RESPONSE] |98| :-----: | -------------- | ---------------------------------------------------- |99| [1] | `quality-gate` | `{project, gate_status, passed: bool, conditions[]}` |100| [2] | `issues` | `{project, total, issues[], summary}` |101| [3] | `measures` | `{project, name, metrics}` |102| [4] | `analyses` | `{project, total, analyses[]}` |103| [5] | `projects` | `{organization, total, projects[]}` |104| [6] | `hotspots` | `{project, total, hotspots[]}` |105106---107## [5][ENVIRONMENT]108109| [VAR] | [REQUIRED] | [DESCRIPTION] |110| ------------- | ---------- | -------------------------------- |111| `SONAR_TOKEN` | Yes | SonarCloud API token (1Password) |112113---114## [6][ERROR_HANDLING]115116- HTTP errors print `[ERROR] <status>: <body>` and exit 1117- Missing token: `[ERROR] SONAR_TOKEN environment variable not set`118- Project not found: `[ERROR] 404: Component not found`119- Invalid metric name: returns empty metric value (not an error)
bsamiee