From ffcaa12b4b338fb545c3543d3017d4bf9c6a36df Mon Sep 17 00:00:00 2001 From: Matthew Jackson <1085847+MattJackson@users.noreply.github.com> Date: Fri, 14 Aug 2026 11:26:30 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20public-hygiene=20pass=20=E2=80=94=20rem?= =?UTF-8?q?ove=20internal=20process=20references=20from=20shipped=20commen?= =?UTF-8?q?ts?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rewrites the five lines the public-hygiene gate flags on main so they state behaviour instead of process: the guard-number citations in next-version.sh and release-selftest.yml, the mutation-campaign section header in tests.rs (now describes what the tests pin — operator- and boundary-level regressions), and a personal attribution in the e2e prod-ready proof's doc comment. --- .github/scripts/next-version.sh | 2 +- .github/workflows/release-selftest.yml | 2 +- store-sqlite-plugin/tests/e2e.rs | 2 +- store-sqlite/src/tests.rs | 3 ++- 4 files changed, 5 insertions(+), 4 deletions(-) diff --git a/.github/scripts/next-version.sh b/.github/scripts/next-version.sh index 27fce0e..710abf7 100755 --- a/.github/scripts/next-version.sh +++ b/.github/scripts/next-version.sh @@ -2,7 +2,7 @@ # next-version.sh — compute THIS repo's next release tag for release-on-upstream.yml. # # Single source of truth for the version math, exercised in CI by release-selftest.yml so the -# release automation can't silently rot (guard #135.8). Prints "v.." to stdout. +# release automation cannot silently rot. Prints "v.." to stdout. # # Inputs (env, all optional): # INPUT_VERSION explicit version to cut (leading "v" tolerated) -> used verbatim. diff --git a/.github/workflows/release-selftest.yml b/.github/workflows/release-selftest.yml index a6aafb6..9cfa502 100644 --- a/.github/workflows/release-selftest.yml +++ b/.github/workflows/release-selftest.yml @@ -1,4 +1,4 @@ -# CI self-test for the release-on-upstream version-compute logic (guard #135.8). +# CI self-test for the release-on-upstream version-compute logic. # Runs the REAL .github/scripts/next-version.sh against synthetic repos and asserts it produces a # valid next version for BOTH the has-prior-tag and no-prior-tag cases — WITHOUT publishing anything. # This is what keeps the release automation from silently rotting before the fleet fan-out is armed. diff --git a/store-sqlite-plugin/tests/e2e.rs b/store-sqlite-plugin/tests/e2e.rs index f5dff34..e372b89 100644 --- a/store-sqlite-plugin/tests/e2e.rs +++ b/store-sqlite-plugin/tests/e2e.rs @@ -396,7 +396,7 @@ fn wait_for_admin_ready( } } -/// THE REAL "PROD READY" PROOF (Matthew's bar): the sqlite plugin installed the way a real operator +/// THE REAL "PROD READY" PROOF: the sqlite plugin installed the way a real operator /// actually installs it — a `POST /api/v1/admin/plugins` call against a REAL running busbar admin /// listener, never file-drop, never a direct `load_store()`/loader call — then EXERCISED through /// that same live instance's own admin API (mint a virtual key + an attached AWS SigV4 credential diff --git a/store-sqlite/src/tests.rs b/store-sqlite/src/tests.rs index ba0906c..061fdb7 100644 --- a/store-sqlite/src/tests.rs +++ b/store-sqlite/src/tests.rs @@ -751,7 +751,8 @@ fn foreign_keys_cascade_is_real_not_just_the_app_level_delete() { ); } -// ── Mutation-testing regressions (cargo-mutants round 1, store-sqlite/src/lib.rs) ────────────── +// ── Operator- and boundary-level regression guards for store-sqlite/src/lib.rs: each test ──── +// pins a specific comparison, guard or early-return that the broader suite does not distinguish. #[test] fn is_memory_path_rejects_a_plain_file_path() {