From cfcac01497e446c4ce7d41490cd3aa46062a79e5 Mon Sep 17 00:00:00 2001 From: Tri Lam Date: Wed, 3 Jun 2026 15:51:19 -0700 Subject: [PATCH] chore(docs): relocate post-wave audit + add GA policy-matrix gate MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move docs/v1-rc1-post-wave-audit.md to docs/audits/wave-2026-06-01.md (the audits dir is the conventional home for point-in-time audit snapshots; the v1-rc1-* prefix at the doc root no longer reflects scope after rc1 stabilization). Update the one self-reference inside the file. Add GA cut criterion 2 to docs/cut-criteria.yaml — engine-specific policy-matrix validation re-enable — pointing at the historical defer commit 33fddc0 so the GA release-prep PR can verify the gate before tag cut. Closes the bureaucracy-vs-tracking concern raised on #502. Signed-off-by: Tri Lam --- .../wave-2026-06-01.md} | 2 +- docs/cut-criteria.yaml | 29 +++++++++++++++++++ docs/v1-ga-cut-criteria.md | 20 +++++++++++++ 3 files changed, 50 insertions(+), 1 deletion(-) rename docs/{v1-rc1-post-wave-audit.md => audits/wave-2026-06-01.md} (99%) diff --git a/docs/v1-rc1-post-wave-audit.md b/docs/audits/wave-2026-06-01.md similarity index 99% rename from docs/v1-rc1-post-wave-audit.md rename to docs/audits/wave-2026-06-01.md index 3702c1e1..955d3c35 100644 --- a/docs/v1-rc1-post-wave-audit.md +++ b/docs/audits/wave-2026-06-01.md @@ -30,7 +30,7 @@ Combined with finding #1 (move projectors into sibling files) and finding #2 (on ## Stop-condition summary -- Audit doc: this file (`docs/v1-rc1-post-wave-audit.md`). +- Audit doc: this file (`docs/audits/wave-2026-06-01.md`). - Follow-up issues filed: **9** (#375–#383), labeled `post-wave-audit`. - Out-of-scope for this audit: actual refactor PRs. diff --git a/docs/cut-criteria.yaml b/docs/cut-criteria.yaml index 92d16fe0..a8f5a8b3 100644 --- a/docs/cut-criteria.yaml +++ b/docs/cut-criteria.yaml @@ -587,3 +587,32 @@ drafting). Rc1-side prerequisite is the audit RFP (rc1 Tier-2 item A); GA flips this to ☑ when the report lands in `docs/audits/`. + +- id: 2 + title: "Engine-specific policy-matrix validation re-enabled" + tier: 1 + milestones: [v1.0-ga] + owner: "O2 (Convenience & Quality)." + rubric: | + The engine-specific policy-matrix workflow deferred at rc1 + (commit + [`33fddc0`](https://github.com/TraceCoreAI/tracecore/commit/33fddc0)) + is re-enabled before GA tag. Either (a) the workflow lives at + `.github/workflows/policy-matrix.yml` and runs green on `main`, + or (b) a successor gate covers the same engine-specific + validation surface and is wired into `verify` per the GA + quality bar. + citation: + - "Commit [`33fddc0`](https://github.com/TraceCoreAI/tracecore/commit/33fddc0) defer note" + - "[`docs/RELEASE-CHECKLIST.md`](RELEASE-CHECKLIST.md) GA gate row" + rubric_check: + artifact_exists: "test -f .github/workflows/policy-matrix.yml" + gate_script: "" + notes: | + Deferred at rc1 because the engine-specific matrix raced the + pattern-library churn and produced false-red signal more often + than it caught real regressions. GA re-enable requires the + pattern roster to stabilize (criterion 1 of rc1 at ☑) and the + matrix to either (a) be re-wired against the stable roster, or + (b) be superseded by a successor gate documented in + `docs/RELEASE-CHECKLIST.md`. diff --git a/docs/v1-ga-cut-criteria.md b/docs/v1-ga-cut-criteria.md index 30fe63e7..6c4aa0cf 100644 --- a/docs/v1-ga-cut-criteria.md +++ b/docs/v1-ga-cut-criteria.md @@ -47,6 +47,26 @@ repo state at render time; never hand-edited in this file. item A); GA flips this to ☑ when the report lands in `docs/audits/`. +### 2. Engine-specific policy-matrix validation re-enabled + +- **Owner objective:** O2 (Convenience & Quality). +- **Falsifiable rubric:** The engine-specific policy-matrix workflow deferred at rc1 + (commit + [`33fddc0`](https://github.com/TraceCoreAI/tracecore/commit/33fddc0)) + is re-enabled before GA tag. Either (a) the workflow lives at + `.github/workflows/policy-matrix.yml` and runs green on `main`, + or (b) a successor gate covers the same engine-specific + validation surface and is wired into `verify` per the GA + quality bar. +- **Citation:** Commit [`33fddc0`](https://github.com/TraceCoreAI/tracecore/commit/33fddc0) defer note and [`docs/RELEASE-CHECKLIST.md`](RELEASE-CHECKLIST.md) GA gate row. +- **Status:** ☐ planned — Deferred at rc1 because the engine-specific matrix raced the + pattern-library churn and produced false-red signal more often + than it caught real regressions. GA re-enable requires the + pattern roster to stabilize (criterion 1 of rc1 at ☑) and the + matrix to either (a) be re-wired against the stable roster, or + (b) be superseded by a successor gate documented in + `docs/RELEASE-CHECKLIST.md`. + --- ## How this doc is kept honest