From 31a56de5ccd7513793d3b37b44f4e9396f3c7cd5 Mon Sep 17 00:00:00 2001 From: Scott McCarty Date: Thu, 2 Jul 2026 23:39:13 -0400 Subject: [PATCH 1/2] chore: bump review image to 0.3.0 for structured diff view The reusable review workflow now runs the v0.3.0 pipeline, which feeds agents a structured BEFORE/AFTER diff view instead of a raw unified diff (#19, PR #20). Co-Authored-By: Claude Fable 5 --- .github/workflows/review.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/review.yml b/.github/workflows/review.yml index 1bf34de..260f886 100644 --- a/.github/workflows/review.yml +++ b/.github/workflows/review.yml @@ -62,7 +62,7 @@ on: description: "Gatehouse release image tag. Bump per release." type: string required: false - default: "quay.io/crunchtools/gatehouse:0.2.0" + default: "quay.io/crunchtools/gatehouse:0.3.0" secrets: GEMINI_API_KEY: required: true From 0d7ad8658cf5d0e12dd435c125118d97edcaab1a Mon Sep 17 00:00:00 2001 From: Scott McCarty Date: Thu, 2 Jul 2026 23:48:19 -0400 Subject: [PATCH 2/2] docs: document the structured BEFORE/AFTER diff view in README Addresses the review finding on this PR: the README never mentioned that agents receive a structured diff view as of v0.3.0. Co-Authored-By: Claude Fable 5 --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 282cf8a..486f005 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,16 @@ gatehouse --advisory All 8 agents run concurrently. Findings below 80% confidence are filtered out. +## How Agents See Changes + +Since v0.3.0, agents do not receive raw unified diffs. Each hunk is rendered +as a structured view: a BEFORE block (the old code, removed lines marked +`[-]`) and an AFTER block (the new code with real file line numbers, added +lines marked `[+]`), plus instructions to judge the direction of a change. +Protections *added* by a change are treated as fixes, not findings; +protections *removed* by a change are flagged. Diffs that cannot be parsed +fall back to the raw unified format. + ## Exit Codes | Code | Meaning |