You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 511abc5
Browse filesBrowse the repository at this point in the historyBrowse files
actors, timestamps and steps. Attempt-specific metadata supplies attribution;
1959
+
complete job pagination and counts are required for each inventory.
1960
+
New IDs and a current API attempt number do not establish fresh execution.
1961
+
Identical non-null timestamps and steps under a unique name may produce an
1962
+
explicit derived carried association, without inventing a physical attempt.
1963
+
Missing, unreadable or gapped history refuses and stays marked incomplete.
1964
+
There is no deterministic-failure retry waiver.
1965
+
1966
+
Each attempt's metadata and paginated jobs, and the latest proving inventory,
1967
+
retain SHA256 identities of the original binary `gh api --include` stdout.
1968
+
The whole-response digest includes all emitted headers, bodies and separators;
1969
+
ordered page digests cover each HTTP header through the byte before the next
1970
+
header (the first includes any prefix, the last includes trailing bytes).
1971
+
These are CLI response bytes, not wire HTTP bytes or re-encoded JSON. Hashes
1972
+
are computed before decoding, stripping or parsing; raw headers and bodies
1973
+
are excluded from the receipt. Unframed injected fixtures are one response.
1974
+
Each entry names its run, requested attempt, endpoint and purpose; `complete`
1975
+
means the response parsed with complete pagination, not policy success.
1976
+
Admission and refusal bind the ordered `response_inventory` with a separate
1977
+
`canonical-response-inventory/v1` SHA256 over its UTF-8 JSON (`sort_keys=True`,
1978
+
`separators=(",", ":")`, `ensure_ascii=True`); this is a manifest digest.
1979
+
1980
+
Before collecting a run's jobs, the gate reads its current metadata and
1981
+
requires it to match the selected inventory row. Immediately before admission,
1982
+
it reads each relied-on run once more through the underlying transport,
1983
+
bypassing the collection cache, with the selected proof last. This covers docs,
1984
+
passed-over proof candidates and App-push evidence, deduplicated by repository
1985
+
and run id. A changed attempt, unreadable response or mismatched run identity,
1986
+
actors, status or conclusion refuses with nonzero exit and empty success stdout.
1987
+
The receipt keeps initial/final attempts, response digests and incomplete
1988
+
validation on refusal. Collection completeness remains relative to the initial
1989
+
attempt. This bounded second metadata read is validation, not a retry; all
1990
+
other endpoint reads remain one-pass, without retries or sleeps.
1991
+
1992
+
Docs-only releases use `ci_docs_only.is_documentation`, the shared merge
1993
+
classifier, to walk back to the first non-doc commit's actual full CI proof.
1994
+
Each intervening docs SHA still needs its own latest successful ci-post run;
1995
+
a red or missing docs run cannot be rescued by an ancestor. Empty changes stop
1996
+
the walk; unreadable paths/parents and more than 20 docs commits refuse. The requested
1997
+
release SHA/tree, built proof SHA/tree and classified docs chain remain
1998
+
distinct in the receipt. A VERSION bump is non-doc and needs its own full run.
1999
+
The packaged-input control derives source headers, generated version/config/
2000
+
targets, libraries and copied roots from CMake install rules, `release.yml`
2001
+
and the x86 staging helper; unsupported rules refuse.
2002
+
2003
+
The gate optionally writes `--receipt FILE` from the same collected evidence
2004
+
on admission or refusal. Refusal stays nonzero; a receipt write failure also
2005
+
fails admission. The workflow always uploads exactly
2006
+
`${{ runner.temp }}/release-gate-receipt.json` as
2007
+
`release-gate-<phase>-<run_id>-<run_attempt>` for seven days, including dry runs.
2008
+
The allowlisted JSON records identities, authenticated parity, actual advisory
2009
+
verify, App provenance, proving jobs, complete attempt history and limits.
2010
+
Safe refusal reasons name the failed checkpoint and error class; exception
2011
+
representations, credentials, private source and authorization headers are excluded.
2012
+
Limits are ten candidate proof runs, 100 attempts per run, 10,000 jobs per
2013
+
inventory and refusal at the filtered API's 1000-run boundary.
1933
2014
1934
2015
The gate needs `bypass_actors` visible on every branch ruleset in the inventory.
1935
2016
If the release App token cannot see them, the bump is refused.
@@ -1977,8 +2058,10 @@ receipt reader, the cut-over is the watcher's **first recorded main sha**,
1977
2058
fixed in that constant by a reviewed PR. The release job cannot configure it
1978
2059
through an environment variable or workflow input. At that sha and every
1979
2060
descendant, the guard requires a main-proof receipt for the **exact main
1980
-
sha** with both full contexts green and does not consult PR heads. Missing,
1981
-
unreadable or non-green receipts refuse, with no PR or release-bump fallback.
2061
+
sha** with parity green and does not consult PR-head statuses. Missing,
2062
+
unreadable or red parity receipts refuse, with no PR or release-bump fallback.
2063
+
Advisory verify is retained from that exact context map, including missing or red.
2064
+
Phase `bump` still requires an associated merged PR and refuses a re-bump.
1982
2065
Commits preceding the cut-over retain phase 1; unknown ancestry refuses.
1983
2066
The reader seam defines normalized context states, not a receipt storage format.
1984
2067
@@ -1988,7 +2071,7 @@ sleeping or retrying; empty or unparseable evidence also refuses. An empty JSON
1988
2071
array is a valid list response; each caller refuses if its required PR or
1989
2072
context evidence is absent. An empty single-object payload still refuses.
1990
2073
1991
-
Prebuilt jobs build the sha emitted after the release job's atomic push and assert that the release tag still resolves to it before building.
2074
+
Prebuilt jobs build the SHA emitted by phase `tag` and assert that the release tag still resolves to it before building.
1992
2075
A missing/malformed sha or changed tag fails. Dry runs build `github.sha` and skip the tag assertion because no tag exists.
1993
2076
A separate tag ruleset forbids updates and deletion of `v*` tags; see "Release tag immutability and recovery" below.
1994
2077
After packing, x86_64 checks the emitted tarball's SHA-256 sidecar and unpacks those exact bytes in the pinned Bookworm environment before upload.
@@ -2006,7 +2089,7 @@ refused for every workflow, script and token.
2006
2089
Any recovery that requires deleting or moving a `v*` tag now requires a
2007
2090
human administrator to explicitly edit ruleset `25591564`; nothing in this
2008
2091
repository may assume it can re-tag. The workflow's
2009
-
["Refuse if tag already exists" step in `release.yml`](../.github/workflows/release.yml#L140)
2092
+
["Refuse if tag already exists" step in `release.yml`](../.github/workflows/release.yml#L183)
2010
2093
also refuses an existing tag before creating one.
2011
2094
2012
2095
#### Allowed status creators
@@ -2056,7 +2139,7 @@ The scanner runs actionlint before its structural text rules.
2056
2139
The main branch rule table and parser grammar judge the fetched head workflows.
2057
2140
A workflow change that needs a loosened rule must therefore use two changes.
2058
2141
2059
-
Rule and table changes land first while existing workflows pass; workflow changes follow, so one PR cannot change both sides of admission.
2142
+
Rule and table changes land first while existing workflows pass; workflow changes follow, so one PR cannot change both sides of admission; STEP1 is the rules half for the complete current split and planned split+phase contracts, with workflow activation subject to the later composed main change.
2060
2143
`gke-pr.yml` admits two independent variants, each with OLD and NEW shapes.
2061
2144
For arm, OLD omits `build-arm`, so earlier workflow files still pass; defining that job selects all arm NEW checks together.
2062
2145
Arm NEW requires the exact arm classifier output, fixed Debug job on `ubuntu-24.04-arm`, arm-aware `legs` needs/check and independent `result` check.
0 commit comments