Skip to main content
Glama

review_work

Destructive

Review local changes before pushing or GitLab MRs and GitHub PRs, then draft inline comments or follow-up tasks for human approval before anything posts.

Instructions

step is one of: read, read_file, find, rubric, pipeline, checkout, checks, blast_radius, tests, verify, batch, prepare_comments, prepare_replies, request_approval, approve, revise, view_draft, publish. Review local changes before pushing, or a GitLab MR / GitHub PR. For several at once, step=batch sizes each one and says which model effort it needs. Start with step=read and follow the "next" field of each result; an error lists everything to fix. The assistant examines the code and drafts French/English comments; nothing is posted until the user approves the saved draft. These steps support one review; they are not separate tools.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "review_work"
  }
}

Input Schema

NameRequiredDescriptionDefault
refNoCommit to read at; defaults to the review head
baseNoLocal reviews only: the comparison ref, e.g. origin/develop for mode=branch
modeNoLocal reviews only: which local changes to read
onlyNoRestrict which runners execute; omit to run every one that is available
pageNo
pathNoOne repository-relative path; a near miss (wrong root, alias, case) is resolved for you
stepNoRequired. Each step and its fields (? = optional): read(target?, page?, mode?, base?, since?) · read_file(target, path?, paths?, hunks?, context?, ref?, lines?) · find(target, path?, query?) · rubric(names) · pipeline(target) · checkout(target, packageManager?, install?) · checks(target?, mode?, base?, only?, detail?) · blast_radius(target?, mode?, base?, detail?, symbols?) · tests(target?, mode?, base?) · verify(target, packageManager?, install?, tests?) · batch(targets?) · prepare_comments(target, language, items, coverage, rubricsApplied, rubricsSkipped?, deterministic?, approval?) · prepare_replies(target, language, replies, approval?) · request_approval(draftId, approval?) · approve(draftId, selectedIds, userWords, publish?) · revise(draftId, itemId, text) · view_draft(draftId) · publish(draftId)
textNoThe reworded comment (Markdown) or task description (Azure HTML) the user asked for
hunksNoInstead of a path: hunk ids such as "3.2" or "3.*", to read each hunk with the code around it
itemsNo
linesNoLine range such as "120-220", "120-" or "-80", applied to every requested file; read only what you need. Without it, files longer than 1500 lines are cut with a continuation hint
namesNoRubric or repository skill names from the read result, e.g. ["review-react-ts", "house-style"]
pathsNoSeveral paths in one call, e.g. the callers to read before refuting a finding; one failing path does not fail the others
queryNoExact text to search the repository for, e.g. a function name, to find callers outside the diff
sinceNoRe-review: "last" returns only what changed since the head of your previous draft of this MR/PR (or since a given commit sha), with that draft's comments
testsNoAlso run the unit tests related to the change
detailNosummary keeps results short; full returns every finding or caller
itemIdNo
targetNoThe MR/PR: its URL, its number for the configured project, or { provider: "gitlab"|"github", project?, number }
contextNoLines to show before and after each of hunks
draftIdNodraft.id from prepare_comments, prepare_replies or prepare
installNoInstall dependencies from the lockfile (lifecycle scripts skipped) when node_modules is missing or the lockfile changed
publishNofalse only when the user asked to approve without posting now
repliesNoReplies to existing review threads, e.g. after fixing what a reviewer asked
symbolsNoExpand every caller of these symbols only
targetsNoSeveral MRs/PRs to size for a bulk review, each a URL, a number or an object; omit for the open ones of the configured project
approvalNoWhere the user approves. default = conversation (REVIEW_APPROVAL). conversation: you show the preview and relay the user's reply with step=approve. in-chat: an MCP form. browser: a local page. terminal: co-dev-review approve. auto: form, then browser, then terminal
coverageNoA verdict for every hunk. Hunks you comment on and generated files are covered automatically; the draft is rejected while any other hunk is unaccounted for.
languageNo
userWordsNoThe user's approving reply, quoted verbatim; it is stored with the approval
selectedIdsNoExactly the item ids the user approved in their reply, e.g. ["R1","R3"]
deterministicNoLeave out: the server finds the checks, blast_radius and tests runs recorded for this review head, and tells the approver which were not run. Give { skipped: "<reason>" } for a pass only to explain why it could not run.
packageManagerNoauto links your checkout's node_modules when the change touches no lockfile or package.json, else installs with the lockfile's manager; link, pnpm, npm or yarn force one; none skips dependencies
rubricsAppliedNoThe skills you actually read and applied: copy read.rubrics.requiredSkills, minus anything listed in rubricsSkipped, plus the repoSkills you read, e.g. ["review-react-ts", "house-style"]
rubricsSkippedNoRouted rubrics you deliberately did not apply, each with a reason the approver sees

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed38 schema fields changedv1.5.0
    • changedInput schema / additionalProperties
      Previous value: -falseNew value: +true
    • addedInput schema / properties / approval
      Added value: +{
      +  "description": "Where the user approves. default = conversation (REVIEW_APPROVAL). conversation: you show the preview and relay the user's reply with step=approve. in-chat: an MCP form. browser: a local page. terminal: co-dev-review approve. auto: form, then browser, then terminal",
      +  "enum": [
      +    "default",
      +    "conversation",
      +    "in-chat",
      +    "browser",
      +    "terminal",
      +    "auto"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / base
      Added value: +{
      +  "description": "Local reviews only: the comparison ref, e.g. origin/develop for mode=branch",
      +  "type": "string"
      +}
    • addedInput schema / properties / context
      Added value: +{
      +  "description": "Lines to show before and after each of hunks",
      +  "maximum": 300,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedInput schema / properties / coverage
      Added value: +{
      +  "description": "A verdict for every hunk. Hunks you comment on and generated files are covered automatically; the draft is rejected while any other hunk is unaccounted for.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "hunks": {
      +        "description": "Hunk ids: \"7.2\", a whole file as \"7.*\", a range as \"7.2-7.5\", a comma-separated mix, or \"rest\" for every hunk not named elsewhere",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "note": {
      +        "description": "Required in practice for not-applicable: say why the hunk needs no judgement",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "verdict": {
      +        "enum": [
      +          "finding",
      +          "reviewed-clean",
      +          "not-applicable"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "hunks",
      +      "verdict"
      +    ],
      +    "type": "object"
      +  },
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "summary keeps results short; full returns every finding or caller",
      +  "enum": [
      +    "summary",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / deterministic
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Leave out: the server finds the checks, blast_radius and tests runs recorded for this review head, and tells the approver which were not run. Give { skipped: \"<reason>\" } for a pass only to explain why it could not run.",
      +  "properties": {
      +    "blastRadius": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "runId": {
      +          "description": "runId returned by the step for this same target",
      +          "pattern": "^[0-9a-f-]{8,36}$",
      +          "type": "string"
      +        },
      +        "skipped": {
      +          "description": "Why the pass could not be run; shown to the approver",
      +          "maxLength": 500,
      +          "minLength": 20,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "checks": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "runId": {
      +          "description": "runId returned by the step for this same target",
      +          "pattern": "^[0-9a-f-]{8,36}$",
      +          "type": "string"
      +        },
      +        "skipped": {
      +          "description": "Why the pass could not be run; shown to the approver",
      +          "maxLength": 500,
      +          "minLength": 20,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "tests": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "runId": {
      +          "description": "runId returned by the step for this same target",
      +          "pattern": "^[0-9a-f-]{8,36}$",
      +          "type": "string"
      +        },
      +        "skipped": {
      +          "description": "Why the pass could not be run; shown to the approver",
      +          "maxLength": 500,
      +          "minLength": 20,
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / draftId
      Added value: +{
      +  "description": "draft.id from prepare_comments, prepare_replies or prepare",
      +  "pattern": "^[0-9a-f-]{8,36}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / hunks
      Added value: +{
      +  "description": "Instead of a path: hunk ids such as \"3.2\" or \"3.*\", to read each hunk with the code around it",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / install
      Added value: +{
      +  "description": "Install dependencies from the lockfile (lifecycle scripts skipped) when node_modules is missing or the lockfile changed",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / itemId
      Added value: +{
      +  "pattern": "^[RT]\\d{1,3}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / items
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "body": {
      +        "description": "Exact comment text in the selected language; include impact and actionable evidence",
      +        "maxLength": 30000,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "description": "After trying to refute the finding: confirmed = trigger named and no protection found; likely = plausible, protection not ruled out; question = needs the author's knowledge, written as a question",
      +        "enum": [
      +          "confirmed",
      +          "likely",
      +          "question"
      +        ],
      +        "type": "string"
      +      },
      +      "line": {
      +        "exclusiveMinimum": 0,
      +        "type": "integer"
      +      },
      +      "lineText": {
      +        "description": "Preferred anchor: the exact text of a line shown in the patch, without its +/- prefix. The server finds the line number; do not count lines. line, when also given, only picks between identical lines",
      +        "maxLength": 500,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "path": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "severity": {
      +        "enum": [
      +          "blocker",
      +          "major",
      +          "minor",
      +          "suggestion"
      +        ],
      +        "type": "string"
      +      },
      +      "side": {
      +        "default": "RIGHT",
      +        "enum": [
      +          "LEFT",
      +          "RIGHT"
      +        ],
      +        "type": "string"
      +      },
      +      "suggestion": {
      +        "description": "Replacement for the anchored line, posted as a suggestion block the author applies in one click. Inline comments on the new file only",
      +        "maxLength": 5000,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "body",
      +      "severity",
      +      "confidence"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 100,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / language
      Added value: +{
      +  "enum": [
      +    "fr",
      +    "en"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / lines
      Added value: +{
      +  "description": "Line range such as \"120-220\", \"120-\" or \"-80\", applied to every requested file; read only what you need. Without it, files longer than 1500 lines are cut with a continuation hint",
      +  "pattern": "^\\s*\\d*\\s*-?\\s*\\d*\\s*$",
      +  "type": "string"
      +}
    • addedInput schema / properties / mode
      Added value: +{
      +  "description": "Local reviews only: which local changes to read",
      +  "enum": [
      +    "working",
      +    "staged",
      +    "branch"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / names
      Added value: +{
      +  "description": "Rubric or repository skill names from the read result, e.g. [\"review-react-ts\", \"house-style\"]",
      +  "items": {
      +    "maxLength": 64,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 8,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / only
      Added value: +{
      +  "description": "Restrict which runners execute; omit to run every one that is available",
      +  "items": {
      +    "enum": [
      +      "tsc",
      +      "eslint",
      +      "dotnet"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / packageManager
      Added value: +{
      +  "description": "auto links your checkout's node_modules when the change touches no lockfile or package.json, else installs with the lockfile's manager; link, pnpm, npm or yarn force one; none skips dependencies",
      +  "enum": [
      +    "auto",
      +    "link",
      +    "pnpm",
      +    "npm",
      +    "yarn",
      +    "none"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / page
      Added value: +{
      +  "maximum": 1000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / path
      Added value: +{
      +  "description": "One repository-relative path; a near miss (wrong root, alias, case) is resolved for you",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / paths
      Added value: +{
      +  "description": "Several paths in one call, e.g. the callers to read before refuting a finding; one failing path does not fail the others",
      +  "items": {
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / publish
      Added value: +{
      +  "description": "false only when the user asked to approve without posting now",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / query
      Added value: +{
      +  "description": "Exact text to search the repository for, e.g. a function name, to find callers outside the diff",
      +  "maxLength": 200,
      +  "minLength": 2,
      +  "type": "string"
      +}
    • addedInput schema / properties / ref
      Added value: +{
      +  "description": "Commit to read at; defaults to the review head",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / replies
      Added value: +{
      +  "description": "Replies to existing review threads, e.g. after fixing what a reviewer asked",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "body": {
      +        "description": "The reply, in the selected language",
      +        "maxLength": 30000,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "resolve": {
      +        "description": "Also resolve the thread (GitLab only)",
      +        "type": "boolean"
      +      },
      +      "threadId": {
      +        "description": "id of a discussion returned by step=read",
      +        "maxLength": 64,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "body"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 50,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • removedInput schema / properties / request
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "base": {
      -          "default": "HEAD",
      -          "description": "For local branch review use the intended comparison ref, e.g. origin/develop",
      -          "type": "string"
      -        },
      -        "mode": {
      -          "default": "working",
      -          "enum": [
      -            "working",
      -            "staged",
      -            "branch"
      -          ],
      -          "type": "string"
      -        },
      -        "page": {
      -          "default": 1,
      -          "maximum": 1000,
      -          "minimum": 1,
      -          "type": "integer"
      -        },
      -        "step": {
      -          "const": "read",
      -          "type": "string"
      -        },
      -        "target": {
      -          "additionalProperties": false,
      -          "description": "Remote MR/PR; omit to review the configured local checkout",
      -          "properties": {
      -            "number": {
      -              "exclusiveMinimum": 0,
      -              "type": "integer"
      -            },
      -            "project": {
      -              "description": "GitLab ID/path or GitHub owner/repository; defaults to configured GitLab project",
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "provider": {
      -              "enum": [
      -                "gitlab",
      -                "github"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "provider",
      -            "number"
      -          ],
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "step"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "lines": {
      -          "description": "Line range such as \"120-220\", \"120-\" or \"-80\"; read only what you need. Without it, files longer than 1500 lines are cut with a continuation hint",
      -          "pattern": "^\\s*\\d*\\s*-?\\s*\\d*\\s*$",
      -          "type": "string"
      -        },
      -        "path": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "ref": {
      -          "description": "Head SHA from the reviewed snapshot",
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "step": {
      -          "const": "read_file",
      -          "type": "string"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "target",
      -        "path",
      -        "ref"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "names": {
      -          "description": "Rubric or repository skill names from the read result, e.g. [\"review-react-ts\", \"house-style\"]",
      -          "items": {
      -            "maxLength": 64,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "maxItems": 8,
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "step": {
      -          "const": "rubric",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "names"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "install": {
      -          "default": true,
      -          "description": "Install dependencies from the lockfile (lifecycle scripts skipped) when node_modules is missing or the lockfile changed",
      -          "type": "boolean"
      -        },
      -        "packageManager": {
      -          "default": "auto",
      -          "description": "auto links your checkout's node_modules when the change touches no lockfile or package.json, else installs with the lockfile's manager; link, pnpm, npm or yarn force one; none skips dependencies. Ask the user first",
      -          "enum": [
      -            "auto",
      -            "link",
      -            "pnpm",
      -            "npm",
      -            "yarn",
      -            "none"
      -          ],
      -          "type": "string"
      -        },
      -        "step": {
      -          "const": "checkout",
      -          "type": "string"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "target"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "base": {
      -          "default": "HEAD",
      -          "type": "string"
      -        },
      -        "detail": {
      -          "default": "summary",
      -          "description": "summary keeps results short; full returns every finding or caller",
      -          "enum": [
      -            "summary",
      -            "full"
      -          ],
      -          "type": "string"
      -        },
      -        "mode": {
      -          "default": "working",
      -          "enum": [
      -            "working",
      -            "staged",
      -            "branch"
      -          ],
      -          "type": "string"
      -        },
      -        "only": {
      -          "description": "Restrict which runners execute; omit to run every one that is available",
      -          "items": {
      -            "enum": [
      -              "tsc",
      -              "eslint",
      -              "dotnet"
      -            ],
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "step": {
      -          "const": "checks",
      -          "type": "string"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target",
      -          "description": "Remote MR/PR prepared with step=checkout; runs in its worktree against the review base, ignoring mode and base"
      -        }
      -      },
      -      "required": [
      -        "step"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "base": {
      -          "default": "HEAD",
      -          "type": "string"
      -        },
      -        "detail": {
      -          "default": "summary",
      -          "description": "summary keeps results short; full returns every finding or caller",
      -          "enum": [
      -            "summary",
      -            "full"
      -          ],
      -          "type": "string"
      -        },
      -        "mode": {
      -          "default": "working",
      -          "enum": [
      -            "working",
      -            "staged",
      -            "branch"
      -          ],
      -          "type": "string"
      -        },
      -        "step": {
      -          "const": "blast_radius",
      -          "type": "string"
      -        },
      -        "symbols": {
      -          "description": "Expand every caller of these symbols only",
      -          "items": {
      -            "maxLength": 64,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "maxItems": 10,
      -          "type": "array"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target",
      -          "description": "Remote MR/PR prepared with step=checkout; runs in its worktree against the review base, ignoring mode and base"
      -        }
      -      },
      -      "required": [
      -        "step"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "step": {
      -          "const": "pipeline",
      -          "type": "string"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "target"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "base": {
      -          "default": "HEAD",
      -          "type": "string"
      -        },
      -        "mode": {
      -          "default": "working",
      -          "enum": [
      -            "working",
      -            "staged",
      -            "branch"
      -          ],
      -          "type": "string"
      -        },
      -        "step": {
      -          "const": "tests",
      -          "type": "string"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target",
      -          "description": "Remote MR/PR prepared with step=checkout; runs in its worktree against the review base, ignoring mode and base"
      -        }
      -      },
      -      "required": [
      -        "step"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "approval": {
      -          "default": "default",
      -          "description": "Where the user approves. default = conversation (REVIEW_APPROVAL). conversation: you show the preview and relay the user's reply with step=approve. in-chat: an MCP form. browser: a local page. terminal: co-dev-review approve. auto: form, then browser, then terminal",
      -          "enum": [
      -            "default",
      -            "conversation",
      -            "in-chat",
      -            "browser",
      -            "terminal",
      -            "auto"
      -          ],
      -          "type": "string"
      -        },
      -        "coverage": {
      -          "description": "Every hunk in the diff needs exactly one verdict. The draft is rejected while any hunk is unaccounted for.",
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "hunks": {
      -                "description": "Hunk ids from the read ledger: \"7.2\", a whole file as \"7.*\", a range as \"7.2-7.5\", or a comma-separated mix",
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "note": {
      -                "description": "Required in practice for not-applicable: say why the hunk needs no judgement",
      -                "maxLength": 500,
      -                "type": "string"
      -              },
      -              "verdict": {
      -                "enum": [
      -                  "finding",
      -                  "reviewed-clean",
      -                  "not-applicable"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "hunks",
      -              "verdict"
      -            ],
      -            "type": "object"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "deterministic": {
      -          "additionalProperties": false,
      -          "description": "Proof that step=checks and step=blast_radius ran on this review head against its base, or an explicit reason each was skipped. A run on another commit or base is rejected.",
      -          "properties": {
      -            "blastRadius": {
      -              "$ref": "#/properties/request/anyOf/8/properties/deterministic/properties/checks"
      -            },
      -            "checks": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "runId": {
      -                      "description": "runId returned by the step for this same target",
      -                      "format": "uuid",
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "runId"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "skipped": {
      -                      "description": "Why the pass could not be run; shown to the approver",
      -                      "maxLength": 500,
      -                      "minLength": 20,
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "skipped"
      -                  ],
      -                  "type": "object"
      -                }
      -              ]
      -            },
      -            "tests": {
      -              "$ref": "#/properties/request/anyOf/8/properties/deterministic/properties/checks",
      -              "description": "runId of step=tests on this head, when tests were run"
      -            }
      -          },
      -          "required": [
      -            "checks",
      -            "blastRadius"
      -          ],
      -          "type": "object"
      -        },
      -        "items": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "body": {
      -                "description": "Exact comment text in the selected language; include impact and actionable evidence",
      -                "maxLength": 30000,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "confidence": {
      -                "description": "After trying to refute the finding: confirmed = trigger named and no protection found; likely = plausible, protection not ruled out; question = needs the author's knowledge, written as a question",
      -                "enum": [
      -                  "confirmed",
      -                  "likely",
      -                  "question"
      -                ],
      -                "type": "string"
      -              },
      -              "line": {
      -                "exclusiveMinimum": 0,
      -                "type": "integer"
      -              },
      -              "lineText": {
      -                "description": "Preferred anchor: the exact content of the added (RIGHT) or removed (LEFT) line, without its +/- prefix. The server finds its line number; do not count lines. line, when also given, only picks between identical lines",
      -                "maxLength": 500,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "path": {
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "severity": {
      -                "enum": [
      -                  "blocker",
      -                  "major",
      -                  "minor",
      -                  "suggestion"
      -                ],
      -                "type": "string"
      -              },
      -              "side": {
      -                "default": "RIGHT",
      -                "enum": [
      -                  "LEFT",
      -                  "RIGHT"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "body",
      -              "severity",
      -              "confidence"
      -            ],
      -            "type": "object"
      -          },
      -          "maxItems": 100,
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "language": {
      -          "enum": [
      -            "fr",
      -            "en"
      -          ],
      -          "type": "string"
      -        },
      -        "rubricsApplied": {
      -          "description": "Names of the rubric skills and repository skills you actually read and applied for this review, e.g. [\"review-react-ts\", \"house-style\"]. Every rubric skill routed by read must be here or in rubricsSkipped.",
      -          "items": {
      -            "maxLength": 64,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "maxItems": 20,
      -          "type": "array"
      -        },
      -        "rubricsSkipped": {
      -          "default": [],
      -          "description": "Routed rubrics you deliberately did not apply, each with a reason the approver sees",
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "name": {
      -                "maxLength": 64,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "reason": {
      -                "maxLength": 300,
      -                "minLength": 15,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "reason"
      -            ],
      -            "type": "object"
      -          },
      -          "maxItems": 20,
      -          "type": "array"
      -        },
      -        "step": {
      -          "const": "prepare_comments",
      -          "type": "string"
      -        },
      -        "target": {
      -          "$ref": "#/properties/request/anyOf/0/properties/target"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "target",
      -        "language",
      -        "items",
      -        "coverage",
      -        "rubricsApplied",
      -        "deterministic"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "approval": {
      -          "$ref": "#/properties/request/anyOf/8/properties/approval"
      -        },
      -        "draftId": {
      -          "format": "uuid",
      -          "type": "string"
      -        },
      -        "step": {
      -          "const": "request_approval",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "draftId"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "draftId": {
      -          "$ref": "#/properties/request/anyOf/9/properties/draftId"
      -        },
      -        "publish": {
      -          "default": true,
      -          "description": "false only when the user asked to approve without posting now",
      -          "type": "boolean"
      -        },
      -        "selectedIds": {
      -          "description": "Exactly the item ids the user approved in their reply, e.g. [\"R1\",\"R3\"]",
      -          "items": {
      -            "pattern": "^[RT]\\d{1,3}$",
      -            "type": "string"
      -          },
      -          "maxItems": 100,
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "step": {
      -          "const": "approve",
      -          "type": "string"
      -        },
      -        "userWords": {
      -          "description": "The user's approving reply, quoted verbatim; it is stored with the approval",
      -          "maxLength": 500,
      -          "minLength": 2,
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "draftId",
      -        "selectedIds",
      -        "userWords"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "draftId": {
      -          "$ref": "#/properties/request/anyOf/9/properties/draftId"
      -        },
      -        "itemId": {
      -          "pattern": "^[RT]\\d{1,3}$",
      -          "type": "string"
      -        },
      -        "step": {
      -          "const": "revise",
      -          "type": "string"
      -        },
      -        "text": {
      -          "description": "The reworded comment (Markdown) or task description (Azure HTML) the user asked for",
      -          "maxLength": 30000,
      -          "minLength": 1,
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "draftId",
      -        "itemId",
      -        "text"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "draftId": {
      -          "$ref": "#/properties/request/anyOf/9/properties/draftId"
      -        },
      -        "step": {
      -          "const": "view_draft",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "draftId"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "draftId": {
      -          "$ref": "#/properties/request/anyOf/9/properties/draftId"
      -        },
      -        "step": {
      -          "const": "publish",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "step",
      -        "draftId"
      -      ],
      -      "type": "object"
      -    }
      -  ]
      -}
    • addedInput schema / properties / rubricsApplied
      Added value: +{
      +  "description": "The skills you actually read and applied: copy read.rubrics.requiredSkills, minus anything listed in rubricsSkipped, plus the repoSkills you read, e.g. [\"review-react-ts\", \"house-style\"]",
      +  "items": {
      +    "maxLength": 64,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • addedInput schema / properties / rubricsSkipped
      Added value: +{
      +  "description": "Routed rubrics you deliberately did not apply, each with a reason the approver sees",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "name": {
      +        "maxLength": 64,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "reason": {
      +        "maxLength": 300,
      +        "minLength": 15,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "name",
      +      "reason"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • addedInput schema / properties / selectedIds
      Added value: +{
      +  "description": "Exactly the item ids the user approved in their reply, e.g. [\"R1\",\"R3\"]",
      +  "items": {
      +    "pattern": "^[RT]\\d{1,3}$",
      +    "type": "string"
      +  },
      +  "maxItems": 100,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / since
      Added value: +{
      +  "description": "Re-review: \"last\" returns only what changed since the head of your previous draft of this MR/PR (or since a given commit sha), with that draft's comments",
      +  "pattern": "^(last|[0-9a-f]{7,40})$",
      +  "type": "string"
      +}
    • addedInput schema / properties / step
      Added value: +{
      +  "description": "Required. Each step and its fields (? = optional): read(target?, page?, mode?, base?, since?) · read_file(target, path?, paths?, hunks?, context?, ref?, lines?) · find(target, path?, query?) · rubric(names) · pipeline(target) · checkout(target, packageManager?, install?) · checks(target?, mode?, base?, only?, detail?) · blast_radius(target?, mode?, base?, detail?, symbols?) · tests(target?, mode?, base?) · verify(target, packageManager?, install?, tests?) · batch(targets?) · prepare_comments(target, language, items, coverage, rubricsApplied, rubricsSkipped?, deterministic?, approval?) · prepare_replies(target, language, replies, approval?) · request_approval(draftId, approval?) · approve(draftId, selectedIds, userWords, publish?) · revise(draftId, itemId, text) · view_draft(draftId) · publish(draftId)",
      +  "enum": [
      +    "read",
      +    "read_file",
      +    "find",
      +    "rubric",
      +    "pipeline",
      +    "checkout",
      +    "checks",
      +    "blast_radius",
      +    "tests",
      +    "verify",
      +    "batch",
      +    "prepare_comments",
      +    "prepare_replies",
      +    "request_approval",
      +    "approve",
      +    "revise",
      +    "view_draft",
      +    "publish"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / symbols
      Added value: +{
      +  "description": "Expand every caller of these symbols only",
      +  "items": {
      +    "maxLength": 64,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / target
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The MR/PR: its URL, its number for the configured project, or { provider: \"gitlab\"|\"github\", project?, number }",
      +  "properties": {
      +    "number": {
      +      "exclusiveMinimum": 0,
      +      "type": "integer"
      +    },
      +    "project": {
      +      "description": "GitLab ID/path or GitHub owner/repository; defaults to the configured project",
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "provider": {
      +      "enum": [
      +        "gitlab",
      +        "github"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "provider",
      +    "number"
      +  ],
      +  "type": "object"
      +}
    • addedInput schema / properties / targets
      Added value: +{
      +  "description": "Several MRs/PRs to size for a bulk review, each a URL, a number or an object; omit for the open ones of the configured project",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "The MR/PR: its URL, its number for the configured project, or { provider: \"gitlab\"|\"github\", project?, number }",
      +    "properties": {
      +      "number": {
      +        "exclusiveMinimum": 0,
      +        "type": "integer"
      +      },
      +      "project": {
      +        "description": "GitLab ID/path or GitHub owner/repository; defaults to the configured project",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "provider": {
      +        "enum": [
      +          "gitlab",
      +          "github"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "provider",
      +      "number"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 20,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / tests
      Added value: +{
      +  "description": "Also run the unit tests related to the change",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / text
      Added value: +{
      +  "description": "The reworded comment (Markdown) or task description (Azure HTML) the user asked for",
      +  "maxLength": 30000,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / userWords
      Added value: +{
      +  "description": "The user's approving reply, quoted verbatim; it is stored with the approval",
      +  "maxLength": 500,
      +  "minLength": 2,
      +  "type": "string"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "request"
      -]
  2. Changed1 schema field changedv1.4.0
    • changedInput schema / properties / request / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "default": "HEAD",
      -        "description": "For local branch review use the intended comparison ref, e.g. origin/develop",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "working",
      -        "enum": [
      -          "working",
      -          "staged",
      -          "branch"
      -        ],
      -        "type": "string"
      -      },
      -      "page": {
      -        "default": 1,
      -        "maximum": 1000,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "step": {
      -        "const": "read",
      -        "type": "string"
      -      },
      -      "target": {
      -        "additionalProperties": false,
      -        "description": "Remote MR/PR; omit to review the configured local checkout",
      -        "properties": {
      -          "number": {
      -            "exclusiveMinimum": 0,
      -            "type": "integer"
      -          },
      -          "project": {
      -            "description": "GitLab ID/path or GitHub owner/repository; defaults to configured GitLab project",
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "provider": {
      -            "enum": [
      -              "gitlab",
      -              "github"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "provider",
      -          "number"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "step"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "path": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "ref": {
      -        "description": "Head SHA from the reviewed snapshot",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "step": {
      -        "const": "read_file",
      -        "type": "string"
      -      },
      -      "target": {
      -        "$ref": "#/properties/request/anyOf/0/properties/target"
      -      }
      -    },
      -    "required": [
      -      "step",
      -      "target",
      -      "path",
      -      "ref"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "names": {
      -        "description": "Rubric or repository skill names from the read result, e.g. [\"review-react-ts\", \"house-conventions\"]",
      -        "items": {
      -          "maxLength": 64,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "maxItems": 8,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "step": {
      -        "const": "rubric",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "step",
      -      "names"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "default": "HEAD",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "working",
      -        "enum": [
      -          "working",
      -          "staged",
      -          "branch"
      -        ],
      -        "type": "string"
      -      },
      -      "only": {
      -        "description": "Restrict which runners execute; omit to run every one that is available",
      -        "items": {
      -          "enum": [
      -            "tsc",
      -            "eslint",
      -            "dotnet"
      -          ],
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "step": {
      -        "const": "checks",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "step"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base": {
      -        "default": "HEAD",
      -        "type": "string"
      -      },
      -      "mode": {
      -        "default": "working",
      -        "enum": [
      -          "working",
      -          "staged",
      -          "branch"
      -        ],
      -        "type": "string"
      -      },
      -      "step": {
      -        "const": "blast_radius",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "step"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "description": "Every hunk in the diff needs exactly one verdict. The draft is rejected while any hunk is unaccounted for.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "hunks": {
      -              "description": "Hunk ids from the read ledger: \"7.2\", a whole file as \"7.*\", a range as \"7.2-7.5\", or a comma-separated mix",
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "note": {
      -              "description": "Required in practice for not-applicable: say why the hunk needs no judgement",
      -              "maxLength": 500,
      -              "type": "string"
      -            },
      -            "verdict": {
      -              "enum": [
      -                "finding",
      -                "reviewed-clean",
      -                "not-applicable"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "hunks",
      -            "verdict"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "items": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "body": {
      -              "description": "Exact comment text in the selected language; include impact and actionable evidence",
      -              "maxLength": 30000,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "line": {
      -              "exclusiveMinimum": 0,
      -              "type": "integer"
      -            },
      -            "path": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "severity": {
      -              "enum": [
      -                "blocker",
      -                "major",
      -                "minor",
      -                "suggestion"
      -              ],
      -              "type": "string"
      -            },
      -            "side": {
      -              "default": "RIGHT",
      -              "enum": [
      -                "LEFT",
      -                "RIGHT"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "body",
      -            "severity"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 100,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "language": {
      -        "enum": [
      -          "fr",
      -          "en"
      -        ],
      -        "type": "string"
      -      },
      -      "rubricsApplied": {
      -        "description": "Names of the rubric skills and repository skills you actually read and applied for this review, e.g. [\"review-react-ts\", \"house-conventions\"]. An empty array is accepted and is shown to the approver as such.",
      -        "items": {
      -          "maxLength": 64,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "maxItems": 20,
      -        "type": "array"
      -      },
      -      "step": {
      -        "const": "prepare_comments",
      -        "type": "string"
      -      },
      -      "target": {
      -        "$ref": "#/properties/request/anyOf/0/properties/target"
      -      }
      -    },
      -    "required": [
      -      "step",
      -      "target",
      -      "language",
      -      "items",
      -      "coverage",
      -      "rubricsApplied"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "draftId": {
      -        "format": "uuid",
      -        "type": "string"
      -      },
      -      "step": {
      -        "const": "view_draft",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "step",
      -      "draftId"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "draftId": {
      -        "$ref": "#/properties/request/anyOf/6/properties/draftId"
      -      },
      -      "step": {
      -        "const": "publish",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "step",
      -      "draftId"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "default": "HEAD",
      +        "description": "For local branch review use the intended comparison ref, e.g. origin/develop",
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "working",
      +        "enum": [
      +          "working",
      +          "staged",
      +          "branch"
      +        ],
      +        "type": "string"
      +      },
      +      "page": {
      +        "default": 1,
      +        "maximum": 1000,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "step": {
      +        "const": "read",
      +        "type": "string"
      +      },
      +      "target": {
      +        "additionalProperties": false,
      +        "description": "Remote MR/PR; omit to review the configured local checkout",
      +        "properties": {
      +          "number": {
      +            "exclusiveMinimum": 0,
      +            "type": "integer"
      +          },
      +          "project": {
      +            "description": "GitLab ID/path or GitHub owner/repository; defaults to configured GitLab project",
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "provider": {
      +            "enum": [
      +              "gitlab",
      +              "github"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "provider",
      +          "number"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "step"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "lines": {
      +        "description": "Line range such as \"120-220\", \"120-\" or \"-80\"; read only what you need. Without it, files longer than 1500 lines are cut with a continuation hint",
      +        "pattern": "^\\s*\\d*\\s*-?\\s*\\d*\\s*$",
      +        "type": "string"
      +      },
      +      "path": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "ref": {
      +        "description": "Head SHA from the reviewed snapshot",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "step": {
      +        "const": "read_file",
      +        "type": "string"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "target",
      +      "path",
      +      "ref"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "names": {
      +        "description": "Rubric or repository skill names from the read result, e.g. [\"review-react-ts\", \"house-style\"]",
      +        "items": {
      +          "maxLength": 64,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "maxItems": 8,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "step": {
      +        "const": "rubric",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "names"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "install": {
      +        "default": true,
      +        "description": "Install dependencies from the lockfile (lifecycle scripts skipped) when node_modules is missing or the lockfile changed",
      +        "type": "boolean"
      +      },
      +      "packageManager": {
      +        "default": "auto",
      +        "description": "auto links your checkout's node_modules when the change touches no lockfile or package.json, else installs with the lockfile's manager; link, pnpm, npm or yarn force one; none skips dependencies. Ask the user first",
      +        "enum": [
      +          "auto",
      +          "link",
      +          "pnpm",
      +          "npm",
      +          "yarn",
      +          "none"
      +        ],
      +        "type": "string"
      +      },
      +      "step": {
      +        "const": "checkout",
      +        "type": "string"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "target"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "default": "HEAD",
      +        "type": "string"
      +      },
      +      "detail": {
      +        "default": "summary",
      +        "description": "summary keeps results short; full returns every finding or caller",
      +        "enum": [
      +          "summary",
      +          "full"
      +        ],
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "working",
      +        "enum": [
      +          "working",
      +          "staged",
      +          "branch"
      +        ],
      +        "type": "string"
      +      },
      +      "only": {
      +        "description": "Restrict which runners execute; omit to run every one that is available",
      +        "items": {
      +          "enum": [
      +            "tsc",
      +            "eslint",
      +            "dotnet"
      +          ],
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "step": {
      +        "const": "checks",
      +        "type": "string"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target",
      +        "description": "Remote MR/PR prepared with step=checkout; runs in its worktree against the review base, ignoring mode and base"
      +      }
      +    },
      +    "required": [
      +      "step"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "default": "HEAD",
      +        "type": "string"
      +      },
      +      "detail": {
      +        "default": "summary",
      +        "description": "summary keeps results short; full returns every finding or caller",
      +        "enum": [
      +          "summary",
      +          "full"
      +        ],
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "working",
      +        "enum": [
      +          "working",
      +          "staged",
      +          "branch"
      +        ],
      +        "type": "string"
      +      },
      +      "step": {
      +        "const": "blast_radius",
      +        "type": "string"
      +      },
      +      "symbols": {
      +        "description": "Expand every caller of these symbols only",
      +        "items": {
      +          "maxLength": 64,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "maxItems": 10,
      +        "type": "array"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target",
      +        "description": "Remote MR/PR prepared with step=checkout; runs in its worktree against the review base, ignoring mode and base"
      +      }
      +    },
      +    "required": [
      +      "step"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "step": {
      +        "const": "pipeline",
      +        "type": "string"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "target"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base": {
      +        "default": "HEAD",
      +        "type": "string"
      +      },
      +      "mode": {
      +        "default": "working",
      +        "enum": [
      +          "working",
      +          "staged",
      +          "branch"
      +        ],
      +        "type": "string"
      +      },
      +      "step": {
      +        "const": "tests",
      +        "type": "string"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target",
      +        "description": "Remote MR/PR prepared with step=checkout; runs in its worktree against the review base, ignoring mode and base"
      +      }
      +    },
      +    "required": [
      +      "step"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "approval": {
      +        "default": "default",
      +        "description": "Where the user approves. default = conversation (REVIEW_APPROVAL). conversation: you show the preview and relay the user's reply with step=approve. in-chat: an MCP form. browser: a local page. terminal: co-dev-review approve. auto: form, then browser, then terminal",
      +        "enum": [
      +          "default",
      +          "conversation",
      +          "in-chat",
      +          "browser",
      +          "terminal",
      +          "auto"
      +        ],
      +        "type": "string"
      +      },
      +      "coverage": {
      +        "description": "Every hunk in the diff needs exactly one verdict. The draft is rejected while any hunk is unaccounted for.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "hunks": {
      +              "description": "Hunk ids from the read ledger: \"7.2\", a whole file as \"7.*\", a range as \"7.2-7.5\", or a comma-separated mix",
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "note": {
      +              "description": "Required in practice for not-applicable: say why the hunk needs no judgement",
      +              "maxLength": 500,
      +              "type": "string"
      +            },
      +            "verdict": {
      +              "enum": [
      +                "finding",
      +                "reviewed-clean",
      +                "not-applicable"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "hunks",
      +            "verdict"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "deterministic": {
      +        "additionalProperties": false,
      +        "description": "Proof that step=checks and step=blast_radius ran on this review head against its base, or an explicit reason each was skipped. A run on another commit or base is rejected.",
      +        "properties": {
      +          "blastRadius": {
      +            "$ref": "#/properties/request/anyOf/8/properties/deterministic/properties/checks"
      +          },
      +          "checks": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "runId": {
      +                    "description": "runId returned by the step for this same target",
      +                    "format": "uuid",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "runId"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "skipped": {
      +                    "description": "Why the pass could not be run; shown to the approver",
      +                    "maxLength": 500,
      +                    "minLength": 20,
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "skipped"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "tests": {
      +            "$ref": "#/properties/request/anyOf/8/properties/deterministic/properties/checks",
      +            "description": "runId of step=tests on this head, when tests were run"
      +          }
      +        },
      +        "required": [
      +          "checks",
      +          "blastRadius"
      +        ],
      +        "type": "object"
      +      },
      +      "items": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "body": {
      +              "description": "Exact comment text in the selected language; include impact and actionable evidence",
      +              "maxLength": 30000,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "confidence": {
      +              "description": "After trying to refute the finding: confirmed = trigger named and no protection found; likely = plausible, protection not ruled out; question = needs the author's knowledge, written as a question",
      +              "enum": [
      +                "confirmed",
      +                "likely",
      +                "question"
      +              ],
      +              "type": "string"
      +            },
      +            "line": {
      +              "exclusiveMinimum": 0,
      +              "type": "integer"
      +            },
      +            "lineText": {
      +              "description": "Preferred anchor: the exact content of the added (RIGHT) or removed (LEFT) line, without its +/- prefix. The server finds its line number; do not count lines. line, when also given, only picks between identical lines",
      +              "maxLength": 500,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "path": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "severity": {
      +              "enum": [
      +                "blocker",
      +                "major",
      +                "minor",
      +                "suggestion"
      +              ],
      +              "type": "string"
      +            },
      +            "side": {
      +              "default": "RIGHT",
      +              "enum": [
      +                "LEFT",
      +                "RIGHT"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "body",
      +            "severity",
      +            "confidence"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 100,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "language": {
      +        "enum": [
      +          "fr",
      +          "en"
      +        ],
      +        "type": "string"
      +      },
      +      "rubricsApplied": {
      +        "description": "Names of the rubric skills and repository skills you actually read and applied for this review, e.g. [\"review-react-ts\", \"house-style\"]. Every rubric skill routed by read must be here or in rubricsSkipped.",
      +        "items": {
      +          "maxLength": 64,
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      },
      +      "rubricsSkipped": {
      +        "default": [],
      +        "description": "Routed rubrics you deliberately did not apply, each with a reason the approver sees",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "name": {
      +              "maxLength": 64,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "reason": {
      +              "maxLength": 300,
      +              "minLength": 15,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "reason"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      },
      +      "step": {
      +        "const": "prepare_comments",
      +        "type": "string"
      +      },
      +      "target": {
      +        "$ref": "#/properties/request/anyOf/0/properties/target"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "target",
      +      "language",
      +      "items",
      +      "coverage",
      +      "rubricsApplied",
      +      "deterministic"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "approval": {
      +        "$ref": "#/properties/request/anyOf/8/properties/approval"
      +      },
      +      "draftId": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "step": {
      +        "const": "request_approval",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "draftId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "draftId": {
      +        "$ref": "#/properties/request/anyOf/9/properties/draftId"
      +      },
      +      "publish": {
      +        "default": true,
      +        "description": "false only when the user asked to approve without posting now",
      +        "type": "boolean"
      +      },
      +      "selectedIds": {
      +        "description": "Exactly the item ids the user approved in their reply, e.g. [\"R1\",\"R3\"]",
      +        "items": {
      +          "pattern": "^[RT]\\d{1,3}$",
      +          "type": "string"
      +        },
      +        "maxItems": 100,
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "step": {
      +        "const": "approve",
      +        "type": "string"
      +      },
      +      "userWords": {
      +        "description": "The user's approving reply, quoted verbatim; it is stored with the approval",
      +        "maxLength": 500,
      +        "minLength": 2,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "draftId",
      +      "selectedIds",
      +      "userWords"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "draftId": {
      +        "$ref": "#/properties/request/anyOf/9/properties/draftId"
      +      },
      +      "itemId": {
      +        "pattern": "^[RT]\\d{1,3}$",
      +        "type": "string"
      +      },
      +      "step": {
      +        "const": "revise",
      +        "type": "string"
      +      },
      +      "text": {
      +        "description": "The reworded comment (Markdown) or task description (Azure HTML) the user asked for",
      +        "maxLength": 30000,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "draftId",
      +      "itemId",
      +      "text"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "draftId": {
      +        "$ref": "#/properties/request/anyOf/9/properties/draftId"
      +      },
      +      "step": {
      +        "const": "view_draft",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "draftId"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "draftId": {
      +        "$ref": "#/properties/request/anyOf/9/properties/draftId"
      +      },
      +      "step": {
      +        "const": "publish",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "step",
      +      "draftId"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. First observedv1.1.0

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and openWorldHint=true, but the description adds the crucial gate behind that: 'nothing is posted until the user approves the saved draft,' plus the fact that drafts are language-specific (French/English) and that the assistant drafts rather than posts. It also discloses the chaining protocol via the 'next' field, which no annotation covers.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The lead is a flat 18-item enum list that duplicates the schema enum and is not front-loaded with the purpose, which only arrives in sentence two. The remaining sentences are tight and each earns its place, but the opening wastes the most prominent position.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 35-parameter, nested, destructive multi-step tool with no output schema, the description covers workflow entry point, error handling, bulk mode, the approval gate, and that results carry a 'next' field. It does not describe what a completed review produces or the approval-mode mechanics, but the schema carries most of that.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 89% and the per-step field mapping in the description ('read(target?, page?, mode?, base?, since?) ...') repeats almost verbatim what the `step` schema description already says. The prose adds workflow meaning (start at read, follow next) but no new semantics for the 35 parameters beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The second sentence gives a concrete verb and resource: 'Review local changes before pushing, or a GitLab MR / GitHub PR,' and the closing line 'These steps support one review; they are not separate tools' clarifies the unusual multi-step shape. The purpose is clear, but it is preceded by an 18-value enum dump and never distinguishes itself from siblings like review_sonar.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Strong internal routing guidance: 'Start with step=read and follow the "next" field of each result,' plus 'an error lists everything to fix' and the batch case for several targets. It stops short of saying when to use this tool instead of a sibling such as review_sonar or plan_ticket_tasks, so it is not a full 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools