Plain text · sha256 59ea4187fcd5
The description, rendered
This renders the markdown inside the description, so it isn’t quite the description itself.The raw view and the plain text are the bytes as they were sent.
Report code-review findings as a typed list so the host UI can render them. Use this only when the active code-review instructions tell you to report findings with this tool; otherwise follow whatever output format those instructions specify. When reporting a review's results, call it once with the verified findings ranked most-severe first (empty array if nothing survived verification) and do not also print the findings as text. When re-reporting after applying fixes (only if the apply instructions ask for it), set outcome on each finding to what actually happened.
What it accepts
2 parameters The JSON parameter schema sent beside this description, 2,046 characters of it. Name, type, then whether the client marked it required.findings
object[]
required
Verified findings, most-severe first; empty if none survived
level
one of 5
optional
Effort level the review ran at
sha256 12080470ff64 · the schema as the client sent it:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"findings": {
"description": "Verified findings, most-severe first; empty if none survived",
"items": {
"additionalProperties": false,
"properties": {
"category": {
"description": "Short kebab-case slug of the finding type, e.g. \"correctness\", \"simplification\", \"efficiency\", \"test-coverage\"",
"maxLength": 40,
"type": "string"
},
"failure_scenario": {
"description": "Concrete inputs/state \u2192 wrong output/crash",
"type": "string"
},
"file": {
"description": "Repo-relative path of the file the finding is in",
"type": "string"
},
"line": {
"description": "1-indexed line the finding anchors to",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"outcome": {
"description": "Set ONLY when re-reporting after applying fixes: what happened to this finding",
"enum": [
"fixed",
"skipped",
"no_change_needed"
],
"type": "string"
},
"short_summary": {
"description": "Compressed label for compact UI (\u226460 chars): the claim alone, no rationale or consequence clause",
"maxLength": 60,
"type": "string"
},
"summary": {
"description": "One-sentence statement of the defect",
"type": "string"
},
"verdict": {
"description": "Set when a verify pass ran; absent on inline-only reviews",
"enum": [
"CONFIRMED",
"PLAUSIBLE"
],
"type": "string"
}
},
"required": [
"file",
"summary",
"failure_scenario"
],
"type": "object"
},
"maxItems": 32,
"type": "array"
},
"level": {
"description": "Effort level the review ran at",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max"
],
"type": "string"
}
},
"required": [
"findings"
],
"type": "object"
}