Skip to content

issue.md

Latest commit

 

History

History
71 lines (48 loc) · 2.2 KB

issue.md

File metadata and controls

71 lines (48 loc) · 2.2 KB

issue Command Spec

Status: ✅ Done (2026-02-23); ignore/unignore added 2026-03-02

Purpose

Show full details of a single quality issue, including file context, pattern description, and suggested fix.

Usage

codacy issue <provider> <organization> <repository> <issueId>
codacy iss gh my-org my-repo 12345
codacy iss gh my-org my-repo 12345 --output json
codacy iss gh my-org my-repo 12345 --ignore
codacy iss gh my-org my-repo 12345 --ignore --ignore-reason FalsePositive --ignore-comment "Not applicable here"
codacy iss gh my-org my-repo 12345 --unignore

The issueId is the resultDataId shown at the bottom of each issue card in issues and pull-request.

Options

Option Short Description
--ignore -I Ignore this issue
--ignore-reason <reason> -R Reason: AcceptedUse (default) | FalsePositive | NotExploitable | TestCode | ExternalCode
--ignore-comment <comment> -m Optional comment
--unignore -U Unignore this issue

API Endpoints

  1. getIssue — AnalysisService.getIssue(provider, org, repo, resultDataId)
  2. Then in parallel:
    • getPattern — ToolsService.getPattern(toolUuid, patternId)
    • getFileContent — FileService.getFileContent(provider, org, repo, encodedPath, startLine, endLine)
  3. For ignore/unignore: updateIssueState — uses issue.issueId (UUID string), not resultDataId

File context: ±5 lines around the issue's line number.

Output Format

Rendered via shared printIssueDetail from utils/formatting.ts:

{Severity colored} | {Category} {SubCategory?}
{Issue message}

{FilePath}:{LineNumber}
{Extended line content (±5 lines)}
{Optional: suggestion line in green+bold}

{Optional: Potential false positive warning}

{Pattern description}

Why is this a problem?
{Pattern rationale}

How to fix it?
{Pattern solution}

Tags: {pattern tags}

Detected by: {tool name}
{pattern title} ({pattern id})

Tests

File: src/commands/issue.test.ts — 8 tests.