[code-simplifier] chore: clarify review fleet JSON format

From 4d5ff2a3de1000f6aff1fc0f0080f5c4bd9caf77 Mon Sep 17 00:00:00 2001
From: Copilot CLI <copilot-cli@users.noreply.github.com>
Date: Wed, 22 Apr 2026 07:56:48 +0000
Subject: [PATCH] chore: clarify review fleet JSON format

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .github/scripts/consolidate_reviews.py       | 9 +++++----
 scripts/codespace-setup/install-build-cli.sh | 3 ++-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/.github/scripts/consolidate_reviews.py b/.github/scripts/consolidate_reviews.py
index 032e9e1..fc3069f 100644
--- a/.github/scripts/consolidate_reviews.py
+++ b/.github/scripts/consolidate_reviews.py
@@ -1,9 +1,10 @@
 #!/usr/bin/env python3
 """Consolidate review fleet findings into a single PR report.
 
-Reads review-*.md files from a directory, extracts findings in the format
-[SEVERITY] file:line — description — fix, de-duplicates by file:line,
-and outputs a consolidated markdown report.
+Reads review-*.json files from a directory and extracts findings from the
+`{"findings": [{"severity", "location", "description", "fix"}]}` structure.
+Findings are de-duplicated by location (file:line) and emitted as a consolidated
+markdown report.
 
 Usage:
     python consolidate_reviews.py <reviews-dir> <run-url> [-o report.md]
@@ -234,7 +235,7 @@ def build_report(findings: list[Finding], run_url: str, pr_number: int | None =
 
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("reviews_dir", type=Path, help="Directory containing review-*.md files")
+    parser.add_argument("reviews_dir", type=Path, help="Directory containing review-*.json files")
     parser.add_argument("run_url", help="URL to the workflow run")
     parser.add_argument("-o", "--output", type=Path, default=Path("report.md"), help="Output file path")
     parser.add_argument("--pr-number", type=int, help="Pull request number for deterministic emoji set select
... (truncated)