shipper_get_review_round

shipper_get_review_round

Read the complete locally retained content of one review round by its stable identity, including current verification observations and pending versus delivered answers. Supports active, completed, and not-planned issues and never calls GitHub. Optional repository_path selects an existing local git checkout for this call only; omit repository_path to use the active repository. Target preparation uses that checkout’s local identity and settings without changing active server state, and successful result payloads are unchanged.

When to use

Omit repository_path to use the active repository, or supply a local checkout path in repository_path to select that repository for this call only. Explicit targets remain usable when active startup is degraded, do not count as active-repository work, and never change ambient server state. The successful response shape is identical for active and targeted calls. New automatic check stops apply only to independently acquired hosted checks. Hosted-check external obstruction and unchanged-revision stalled remediation enter Failed over Rework while retaining useful fixes, package/branch/PR identity, answers, evidence and delivery debt. Obstruction requires concrete evidence, cause, external remedy and final-HEAD applicability after same-pass fixes; red status, main-branch match or missing tools alone are insufficient. The mechanical backstop requires a completed current V4 check-only review with retained answers and identical fresh failures on unchanged HEAD after refresh/rerun/flake opportunities. Nits are neutral; changed/passed/new/material/pending/unavailable evidence and request-changes bodies veto it. Sandbox limitations remain ordinary investigation. A skipped review consumes no allowance and each stop counts once toward terminal safety. No report, answer, resolution or retry waives required checks or permits red ship/merge. Remedy/restart alone stays Failed. Preserving shipper reset S#123 --to rework and eligible shipper recover S#123 renew allowance on unchanged HEAD, preserve unpublished work and history, and require fresh normal verification. Existing eligibility, locks, closure holds and confirmation rules apply. Missing/divergent retained refs refuse retry. Read current or historical diagnosis, local procedures and pending delivery with issue view/get-issue, including roundless failures. Local verification uses existing prose summaries and relevant comments, without a structured local evidence report. Every attempted non-permission local failure, including apparently unrelated or pre-existing failures, requires an anchored 🔴 must-fix: comment on the most relevant changed line and REQUEST_CHANGES, then ordinary Rework fixes or prose replies. Permission-denied and unattempted checks are limitations, never passes or waivers; all previously required checks stay required. Local-only workflows have no local-evidence automatic stop; the ordinary review-round cap still applies. Historical local observations and failure records remain readable without migration. Outstanding historical local findings receive ordinary prose replies and never authorize a new automatic stop. Upgrade alone does not clear findings, renew allowance, or recover Failed. Publication and hook diagnostics and required hook execution remain unchanged. Use this after the compact Reviews from shipper_get_issue to read one locally retained review round in full by its exact stable round identity. The response includes complete overall feedback, disposition, reviewed revision, every stable finding identity and diff location/range, complete finding comments and implementation replies, optional handled/resolved and addressed/superseded enrichment, an optional pull request reference, and explicit empty or complete partial coverage. It is local-only, read-only, idempotent, unbounded, and supports active, completed, and not-planned issues. GitHub-sourced inline PR review threads are not shown here; locally retained Shipper review rounds are shown under Reviews.

Behavior hints

• readOnlyHint: true — The tool reads the retained review record and optional handling state without changing either.
• idempotentHint: true — Repeated calls return the same retained review content until another workflow operation records handling state.
• openWorldHint: false — The tool reads only local Shipper issue and review state.

Input schema

Name	Type	Required	Default	Description
issue	integer | string	yes	-	Shipper issue reference. S# (GitHub #) accepts ordinary surrounding whitespace and requires the current mirror. Bare numbers are Shipper local IDs first; S# is accepted; gh: and # explicitly target a mapped GitHub issue; GitHub issue URLs are accepted. Responses return S# first with GitHub # second when mapped.
round_id	string	yes	-	Required non-blank stable review round identity from shipper_get_issue.
repository_path	string	no	-	Optional repository path to an existing local git checkout to select for this read only. Omit it to read the active repository.

Example call

{
  "issue": "S#42",
  "round_id": "round-1",
  "repository_path": "/absolute/path/to/selected/checkout"
}

Example result

Resolved issue: S#42 (GitHub #123): Generate MCP tool reference pages
<review-round number="1" round-id="round-1" reviewed-revision="abc123" disposition="REQUEST_CHANGES" finding-count="1" addressed="true" superseded="false">
<feedback>One correctness issue remains.</feedback>
<findings>
<finding finding-id="finding-1" path="src/tool.ts" line="14" side="RIGHT" start-line="10" start-side="RIGHT" handled="true" resolved="true">
<comment>Preserve the stable identity.</comment>
<replies><reply>Updated without rewriting the retained review.</reply></replies>
</finding>
</findings>
<partial-coverage empty="true"/>
</review-round>

Error modes

• Local issue-state replica not initialized: Local issue-state replica is not initialized for owner/repo. Run shipper issue reconcile --repair to import/reconcile it.
• Local issue-state replica present but not fully reconciled: Local issue-state replica is present but not fully reconciled for owner/repo. Run shipper issue reconcile --repair to import/reconcile it.
• Local issue-state replica schema unsupported: Local issue-state replica has an unsupported schema for owner/repo. Locally reconstructable older replicas migrate automatically on first issue-state access. Run shipper issue reconcile --repair for supported local-ID V3 blocker imports requiring GitHub data or ordinary current-store repair. Numeric snapshots in issues/<GitHub-number>.json or _pending-blocker-imports/legacy/<GitHub-number>.json refuse the entire store, listing all affected records and leaving existing local issue state unchanged. This Shipper version no longer migrates GitHub-number issue snapshots. Use a Shipper release from before this change to migrate the store before retrying this version. Fresh or recreated stores retain initial blocked-state imports and interrupted-import retries after metadata becomes reconciled; local-ID V3 stored blocker lists can complete locally in store-only mode.
• Local issue-state replica malformed: Local issue-state replica is malformed for owner/repo. Run shipper issue reconcile --repair to import/reconcile it.
• Running issue-state reader stale: The running Shipper issue-state reader is stale for owner/repo: observed store schema v10 is newer than supported schema v9. Restart or reconnect the MCP client and server. If a freshly launched server remains incompatible, update the installed Shipper release or rebuild the source checkout before reconnecting. Preserve the issue-state store unchanged.
• Review round not found: Review round was not found for S#.
• Review record unavailable: Review record could not be read:
• Invalid or unready repository target: Repository identity could not be established for . The repository has no commits. Create an initial commit. Correct this condition and retry the repository read with repository_path.

Related tools

• shipper_get_issue
• shipper_get_issue_runtime