From 97a3466953769f64d9d6b03406494a1ebf293e70 Mon Sep 17 00:00:00 2001 From: idy Date: Thu, 30 Jul 2026 10:39:29 +0800 Subject: [PATCH 1/2] repo: document OpenAI review validation matrix Maintainers need an observable default-branch test contract for the new stage-specific review checks and evidence cache. - Map PR, Issue, push, and unchanged rerun triggers to expected stage modes - Clarify that every run republishes all three fixed Checks on the exact head - Record safe invalidation behavior for workflow and policy changes Generated with [Codex](https://github.com/openai) --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index dfe8c0d..2f6c281 100644 --- a/README.md +++ b/README.md @@ -161,6 +161,25 @@ second workflow. ## Rollout +### Live validation matrix + +Use this matrix after the caller is present on the repository's default branch. +Every run recreates the three fixed Checks on the exact current PR head; the +stage modes below describe model work and evidence reuse inside that run. + +| Trigger | PR evidence | Issue evidence | Code evidence | Expected Check publication | +| --- | --- | --- | --- | --- | +| Open a ready PR | `full` | `full` for every linked Issue | `full` complete diff | All three fixed Checks | +| Edit only the PR body | `incremental` field diff | `reused` | `reused` | All three, with only PR metadata re-reviewed | +| Edit one linked Issue | `reused` | `incremental` for that Issue; others `reused` | `incremental` plan-conformance aggregation with no repeated complete code diff | All three, with Issue and Code verdicts revalidated | +| Push a descendant commit | `reused` | `reused` | `incremental` from the last completed head | All three on the new head | +| Rerun an unchanged head | deterministic checks plus `reused` | `reused` | `reused` | All three with zero model tokens | + +An Issue edit revalidates plan conformance without resending an unchanged +complete code diff. A workflow-source, runtime, model, or trusted-policy change +intentionally invalidates incompatible session evidence and safely starts the +affected review stages again. + 1. Copy `openai-pr-review-dispatch.yml` into the caller repository's default branch. 2. Replace local reusable-workflow paths with a protected `v1` reference or an From 20ae0d95aca085372d2971df6718bc539d78f8db Mon Sep 17 00:00:00 2001 From: idy Date: Thu, 30 Jul 2026 11:00:17 +0800 Subject: [PATCH 2/2] repo: clarify review evidence invalidation Document that PR metadata edits must preserve the native closing-Issue relationship. Removing that relationship changes the plan-conformance identity and invalidates affected Code evidence. This follow-up also provides a descendant documentation commit for the live incremental-review validation in Issue #12. Generated with [Codex](https://github.com/openai) --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 2f6c281..342c089 100644 --- a/README.md +++ b/README.md @@ -180,6 +180,10 @@ complete code diff. A workflow-source, runtime, model, or trusted-policy change intentionally invalidates incompatible session evidence and safely starts the affected review stages again. +When editing PR metadata, preserve the native closing-Issue relationship. +Removing or changing that relationship changes the plan-conformance identity +and intentionally invalidates the affected Code evidence. + 1. Copy `openai-pr-review-dispatch.yml` into the caller repository's default branch. 2. Replace local reusable-workflow paths with a protected `v1` reference or an