Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 11 additions & 4 deletions .github/workflows/dogfood-gate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -625,14 +625,21 @@ jobs:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
repository: hyperpolymath/hypatia
ref: be98f74ce93df200752f3798efa1305bfa3e0e10
# Pinned to a Hypatia commit that contains hypatia#1062 (the PinSites miscompile
# fix, merged as 37b8d01). The earlier pin be98f74 lacks it.
ref: 6693f9aed8e4383f78a3d01b600b32663bf7a45c
path: _hypatia
persist-credentials: false
- name: Setup Elixir 1.19.4 / OTP 28.3 for Hypatia oracle
# OTP 28.x (28.1 to 28.5.0.8) crashes this step with SIGSEGV in
# sweep_off_heap, called from the JIT's bs_init_bits, on trees whose
# workflow content trips it (rsr-template-repo#333). OTP 27.3 scored all
# of them cleanly. Do not move to 28.x until a pinned 28.x build scores
# the #333 trees (af8665c, a55669e, 6ad5378) with no crash.
- name: Setup Elixir 1.19.4 / OTP 27.3.4.19 for Hypatia oracle
uses: erlef/setup-beam@54075bcc5e249e4758d363f27d099f55d843f124 # v1.24.1
with:
elixir-version: '1.19.4'
otp-version: '28.3'
otp-version: '27.3.4.19'
- name: Cache Hypatia Mix deps and build
uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
with:
Expand All @@ -641,7 +648,7 @@ jobs:
_hypatia/_build
~/.hex
~/.mix
key: hypatia-oracle-${{ runner.os }}-otp28-elx1194-be98f74ce93df200752f3798efa1305bfa3e0e10
key: hypatia-oracle-${{ runner.os }}-otp27.3.4.19-elx1194-6693f9aed8e4383f78a3d01b600b32663bf7a45c
- name: Compile the oracle
working-directory: _hypatia
run: mix local.hex --force && mix local.rebar --force && mix deps.get && mix compile
Expand Down
4 changes: 4 additions & 0 deletions .github/workflows/estate-rules.yml
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,10 @@ jobs:
https://raw.githubusercontent.com/metadatastician/standards/e064539116c2dcfdf282a4749dbd58c69961c7e6/scripts/kyaml-format.sh \
--output "$RUNNER_TEMP/kyaml-format.sh"
echo "5fddd58fc8cbd2b68766ef5b4b5ba39f299da3f27252ae6cdcff0a641bbaef18 $RUNNER_TEMP/kyaml-format.sh" | sha256sum --check --strict
- name: Rhodibot guide formats and missing or duplicate controls
run: bash tests/workflows/rhodibot_canary_test.sh
- name: Scorecard calling-job permission contract controls
run: bash tests/workflows/scorecard_permissions_test.sh
- name: Non-interactive mint resolves every prompt from the environment
run: bash tests/workflows/non_interactive_mint_test.sh
# repo-init recorded the CHILD's own HEAD as the template commit whenever
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/fork-governance.yml
Original file line number Diff line number Diff line change
Expand Up @@ -438,7 +438,7 @@ jobs:
--hypatia "$ev/hypatia-scan-findings/hypatia-findings.relativized.json"
--panic "$ev/static-analysis-findings/panic-attack-findings.json"
--pons "$ev/static-analysis-findings/pons-findings.json"
--hypatia-ref be98f74ce93df200752f3798efa1305bfa3e0e10
--hypatia-ref 6693f9aed8e4383f78a3d01b600b32663bf7a45c
--panic-ref b5530834a839734d1d181bfe6edb0d43d4233cf4
--pons-ref 51b8920f541782ceb9465ea3f0d33c96104fc1fb
)
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/hypatia-scan.yml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ jobs:
security-events: write
vulnerability-alerts: read # Dependabot alerts, for Hypatia's DA rules
env:
HYPATIA_SHA: 'be98f74ce93df200752f3798efa1305bfa3e0e10'
HYPATIA_SHA: '6693f9aed8e4383f78a3d01b600b32663bf7a45c'
steps:
- name: Checkout repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
Expand Down
13 changes: 11 additions & 2 deletions .github/workflows/rsr-compliance-canary.yml
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,12 @@ jobs:
a2ml_left=$(find . -path ./.git -prune -o -type f -name '*.a2ml' -print | head -5)
[ -z "$a2ml_left" ] || warn "retired .a2ml files present (move their facts into the repo deed): $(echo $a2ml_left)"
# would-DELETE: duplicate community files
[ -f "CONTRIBUTING.md" ] && [ -f "CONTRIBUTING.adoc" ] && warn "duplicate CONTRIBUTING.md + CONTRIBUTING.adoc (one would be removed)"
contributing_guides=()
for guide in CONTRIBUTING.md CONTRIBUTING.adoc .github/CONTRIBUTING.md .github/CONTRIBUTING.adoc; do
[ ! -f "$guide" ] || contributing_guides+=("$guide")
done
[ "${#contributing_guides[@]}" -le 1 ] \
|| warn "duplicate CONTRIBUTING guides: ${contributing_guides[*]} (keep exactly one)"
if [ -f "README.md" ] && [ -f "README.adoc" ] && [ "$(wc -l < README.md)" -lt 5 ]; then
warn "stub README.md alongside README.adoc (would be removed)"
fi
Expand All @@ -70,7 +75,11 @@ jobs:
done
# would-CREATE: missing required files
[ -f "SECURITY.md" ] || [ -f ".github/SECURITY.md" ] || warn "no SECURITY.md (would be created)"
[ -f "CONTRIBUTING.md" ] || [ -f ".github/CONTRIBUTING.md" ] || warn "no CONTRIBUTING.md (would be created)"
# The estate writes its prose in AsciiDoc: CONTRIBUTING.adoc is the guide,
# not a gap (the .md was dropped in 1486d06 and the canary tripped on
# a rule that had diverged from the norm). Either form, root or .github/.
[ "${#contributing_guides[@]}" -gt 0 ] \
|| warn "no CONTRIBUTING.adoc or CONTRIBUTING.md (would be created)"

# --- unfixable compliance gaps (also drift) ---
ls *_chora.deed >/dev/null 2>&1 || warn "missing repo deed (*_chora.deed at the root)"
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/scorecard.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ jobs:
# without security-events: write here the scorecard SARIF upload fails with
# startup_failure (hypatia WF018). id-token: write enables OIDC publish.
permissions:
actions: read
contents: read
security-events: write
id-token: write
2 changes: 1 addition & 1 deletion .github/workflows/verdict-grid-publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ jobs:
--hypatia "$ev/hypatia-scan-findings/hypatia-findings.relativized.json" \
--panic "$ev/static-analysis-findings/panic-attack-findings.json" \
--pons "$ev/static-analysis-findings/pons-findings.json" \
--hypatia-ref be98f74ce93df200752f3798efa1305bfa3e0e10 \
--hypatia-ref 6693f9aed8e4383f78a3d01b600b32663bf7a45c \
--panic-ref b5530834a839734d1d181bfe6edb0d43d4233cf4 \
--pons-ref 51b8920f541782ceb9465ea3f0d33c96104fc1fb)
[ ! -d "$ev/fleet-report-backs" ] || args+=(--report-backs "$ev/fleet-report-backs")
Expand Down
5 changes: 0 additions & 5 deletions .hypatia-ignore
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,6 @@ research_extensions/RE005:.github/workflows/quality.yml
research_extensions/RE005:.github/workflows/dot-wellknown-enforcement.yml
research_extensions/RE005:.github/workflows/static-analysis-gate.yml

# RE008 assumes the actor-name comparison is used with pull_request_target. The
# Dependabot workflow uses the unprivileged pull_request event and also verifies
# github.event.pull_request.user.login, so that threat model does not apply.
research_extensions/RE008:.github/workflows/dependabot-automerge.yml

# wrong_sha_pin compares 40-hex action pins against Hypatia's static May-2026
# @sha_pins table (e.g. actions/checkout@v4 vs the current actions/checkout@v7.0.1
# and ossf/scorecard-action@v2.5.0). Authoritative pin verification is enforced by
Expand Down
2 changes: 1 addition & 1 deletion .machine_readable/policies/hypatia-rule-order.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"SPDX-License-Identifier":"MPL-2.0","clashes":[{"id":"C1","resolution":"single producer; scripts/check-workflow-edges.sh fails on a dead edge","summary":"one scanner, two workflows"},{"id":"C2","resolution":"one pin per tool per repository; the verdict job names the producer's commit","summary":"one tool, two pins"},{"id":"C3","resolution":"panicbot stays unenrolled; the grid's own row is the authority","summary":"panicbot versus the direct panic-attack row"},{"id":"C4","resolution":"every fragment must end on a path boundary","summary":"substring fragments suppress more than they name"},{"id":"C5","resolution":"subsumed entries are refused","summary":"a broad entry makes narrower ones dead"},{"id":"C6","resolution":"the named path must exist in the tree","summary":"an exemption outlives the file it names"},{"id":"C7","resolution":"stated, not worked around; un-suppression is an upstream change","summary":"a repository cannot narrow a built-in default"},{"id":"C8","resolution":"producers own their gates; a failed fleet is orange rows, not a block","summary":"the reporter must not re-gate"}],"concerns":[{"id":"hypatia-execution","owner":".github/workflows/hypatia-scan.yml","rationale":"Two workflows built and ran the same scanner at the same pin (clash C1)."},{"id":"hypatia-gate","owner":".github/workflows/hypatia-scan.yml","rationale":"The producer owns its gate; the verdict grid is not a gate (clash C8)."},{"id":"panic-attack-gate","owner":".github/workflows/static-analysis-gate.yml","rationale":"Blocks on critical exactly once, in the workflow that runs it."},{"id":"pons-asinorum","owner":".github/workflows/static-analysis-gate.yml","rationale":"Advisory by design: pons classifies evidence, it does not prove."},{"id":"verdict-grid-render","owner":".github/workflows/fork-governance.yml","rationale":"The reporter collects evidence and never scans (clash C8)."},{"id":"verdict-grid-comment","owner":".github/workflows/verdict-grid-publish.yml","rationale":"Only the trusted default-branch workflow_run publisher may write the single bot-owned verdict comment; PR rendering remains read-only."},{"id":"fleet-report-backs","owner":".github/workflows/fork-governance.yml","rationale":"The fleet job is the only producer of .gitbot-fleet evidence."},{"id":"exemption-policy","owner":".hypatia-ignore","rationale":"One file, checked by scripts/check-hypatia-ignore.sh."}],"grid":{"commit":"8e48b1caade08a552646adeab66558ac43b4360d","library":"scripts/lib/verdict-grid.jq","library_sha256":"5681fcefe09480d82b7fa13a6fcb0c389f16467fe7abbace66986cca83114544","renderer":"scripts/verdict-grid.sh","renderer_sha256":"3ee93552920dfc7c472e763a040cbaed8f38ed4b8af151f5d5076d3124211388","repository":"metadatastician/standards","specification":"docs/VERDICT-GRID-SPEC.adoc"},"layer_owners":["hypatia","this-repository","the-gate","the-grid"],"layers":[{"description":"Python, Go, Makefile and Gemfile are refused by a dedicated clause; no exemption reaches it.","id":"rule-total-ban","overrides":"nothing: every other layer is unreachable for this rule","owner":"hypatia","rank":1,"repository_can_change":false,"scope":"cicd_rules/banned_language_file"},{"description":"Applied to every rule before any module-specific table.","id":"universal-excludes","overrides":"every layer below it, for the paths it names","owner":"hypatia","rank":2,"repository_can_change":false,"scope":"vendored and generated paths: .git/, node_modules/, _build/, deps/, target/, dist/, .hypatia-baseline.json"},{"description":"Training corpora and fixtures are provenance, not signal.","id":"builtin-defaults","overrides":"every layer below it; a repository cannot narrow it (clash C7)","owner":"hypatia","rank":3,"repository_can_change":false,"scope":"@training_corpus_paths keyed per module, plus benches/ for code_safety only"},{"description":"Scoped, reasoned exemptions. Fragments are substring matches, so each must end on a path boundary.","id":"repository-ignore","overrides":"nothing above it; it may only widen layer 3","owner":"this-repository","rank":4,"repository_can_change":true,"scope":".hypatia-ignore"},{"description":"Line- or file-scoped. The narrowest layer, and the one to use when only one line is affected.","id":"inline-directive","overrides":"layers 3 and 4, for the line that carries it","owner":"this-repository","rank":5,"repository_can_change":true,"scope":"# hypatia: allow <module>/<type> -- <reason>"},{"description":"Applied at gate time only. The verdict grid ignores it, so standing debt stays visible.","id":"baseline","overrides":"the gate's decision, never a scanner's output","owner":"the-gate","rank":6,"repository_can_change":true,"scope":".hypatia-baseline.json"},{"description":"Presentation and grading. It never suppresses a finding.","id":"grid-normalisation","overrides":"nothing; it may not change what a scanner reported","owner":"the-grid","rank":7,"repository_can_change":false,"scope":"severity words, suppressed:true, the row's colour"}],"observed_modules":[{"layer":4,"module":"research_extensions","rationale":"RE001/RE005/RE008 are advisory recommendations for workflows that deliberately hold a credential or render an annotation non-fatally; each exemption is file-scoped."},{"layer":4,"module":"workflow_audit","rationale":"wrong_sha_pin compares against a static May-2026 table; authoritative pin verification is actions.lock plus check-lock-sync.sh, which runs on every pull request."}],"scanner":{"commit":"be98f74ce93df200752f3798efa1305bfa3e0e10","repository":"hyperpolymath/hypatia","sources":["lib/hypatia/scanner_suppression.ex","lib/rules/"]},"schema":"hypatia-rule-order/1"}
{"SPDX-License-Identifier":"MPL-2.0","clashes":[{"id":"C1","resolution":"single producer; scripts/check-workflow-edges.sh fails on a dead edge","summary":"one scanner, two workflows"},{"id":"C2","resolution":"one pin per tool per repository, including Hypatia checkouts; the verdict job names the producer's commit","summary":"one tool, two pins"},{"id":"C3","resolution":"panicbot stays unenrolled; the grid's own row is the authority","summary":"panicbot versus the direct panic-attack row"},{"id":"C4","resolution":"every fragment must end on a path boundary","summary":"substring fragments suppress more than they name"},{"id":"C5","resolution":"subsumed entries are refused","summary":"a broad entry makes narrower ones dead"},{"id":"C6","resolution":"the named path must exist in the tree","summary":"an exemption outlives the file it names"},{"id":"C7","resolution":"stated, not worked around; un-suppression is an upstream change","summary":"a repository cannot narrow a built-in default"},{"id":"C8","resolution":"producers own their gates; a failed fleet is orange rows, not a block","summary":"the reporter must not re-gate"}],"concerns":[{"id":"hypatia-execution","owner":".github/workflows/hypatia-scan.yml","rationale":"Two workflows built and ran the same scanner at the same pin (clash C1)."},{"id":"hypatia-gate","owner":".github/workflows/hypatia-scan.yml","rationale":"The producer owns its gate; the verdict grid is not a gate (clash C8)."},{"id":"panic-attack-gate","owner":".github/workflows/static-analysis-gate.yml","rationale":"Blocks on critical exactly once, in the workflow that runs it."},{"id":"pons-asinorum","owner":".github/workflows/static-analysis-gate.yml","rationale":"Advisory by design: pons classifies evidence, it does not prove."},{"id":"verdict-grid-render","owner":".github/workflows/fork-governance.yml","rationale":"The reporter collects evidence and never scans (clash C8)."},{"id":"verdict-grid-comment","owner":".github/workflows/verdict-grid-publish.yml","rationale":"Only the trusted default-branch workflow_run publisher may write the single bot-owned verdict comment; PR rendering remains read-only."},{"id":"fleet-report-backs","owner":".github/workflows/fork-governance.yml","rationale":"The fleet job is the only producer of .gitbot-fleet evidence."},{"id":"exemption-policy","owner":".hypatia-ignore","rationale":"One file, checked by scripts/check-hypatia-ignore.sh."}],"grid":{"commit":"8e48b1caade08a552646adeab66558ac43b4360d","library":"scripts/lib/verdict-grid.jq","library_sha256":"5681fcefe09480d82b7fa13a6fcb0c389f16467fe7abbace66986cca83114544","renderer":"scripts/verdict-grid.sh","renderer_sha256":"3ee93552920dfc7c472e763a040cbaed8f38ed4b8af151f5d5076d3124211388","repository":"metadatastician/standards","specification":"docs/VERDICT-GRID-SPEC.adoc"},"layer_owners":["hypatia","this-repository","the-gate","the-grid"],"layers":[{"description":"Python, Go, Makefile and Gemfile are refused by a dedicated clause; no exemption reaches it.","id":"rule-total-ban","overrides":"nothing: every other layer is unreachable for this rule","owner":"hypatia","rank":1,"repository_can_change":false,"scope":"cicd_rules/banned_language_file"},{"description":"Applied to every rule before any module-specific table.","id":"universal-excludes","overrides":"every layer below it, for the paths it names","owner":"hypatia","rank":2,"repository_can_change":false,"scope":"vendored and generated paths: .git/, node_modules/, _build/, deps/, target/, dist/, .hypatia-exemptions.md, .hypatia-baseline.json"},{"description":"Training corpora and fixtures are provenance, not signal.","id":"builtin-defaults","overrides":"every layer below it; a repository cannot narrow it (clash C7)","owner":"hypatia","rank":3,"repository_can_change":false,"scope":"@training_corpus_paths keyed per module (security_errors, code_safety, migration_rules, structural_drift, content_patterns, dogfooding), plus benches/ for code_safety only, and for security_errors also .github/workflows/integration.yml and, for secret_detected only, harvested-registry/"},{"description":"Scoped, reasoned exemptions. Fragments are substring matches, so each must end on a path boundary.","id":"repository-ignore","overrides":"nothing above it; it may only widen layer 3","owner":"this-repository","rank":4,"repository_can_change":true,"scope":".hypatia-ignore"},{"description":"Line- or file-scoped. The narrowest layer, and the one to use when only one line is affected.","id":"inline-directive","overrides":"layers 3 and 4, for the line that carries it","owner":"this-repository","rank":5,"repository_can_change":true,"scope":"# hypatia: allow <module>/<type> -- <reason>"},{"description":"Applied at gate time only. The verdict grid ignores it, so standing debt stays visible.","id":"baseline","overrides":"the gate's decision, never a scanner's output","owner":"the-gate","rank":6,"repository_can_change":true,"scope":".hypatia-baseline.json"},{"description":"Presentation and grading. It never suppresses a finding.","id":"grid-normalisation","overrides":"nothing; it may not change what a scanner reported","owner":"the-grid","rank":7,"repository_can_change":false,"scope":"severity words, suppressed:true, the row's colour"}],"observed_modules":[{"layer":4,"module":"research_extensions","rationale":"RE001 and RE005 exemptions are file-scoped for deliberate credential-bearing or non-fatal reporting workflows. The former RE008 entry is removed: the Dependabot job pins the PR author by login and numeric id and performs no actor comparison."},{"layer":4,"module":"workflow_audit","rationale":"wrong_sha_pin compares against a static May-2026 table; authoritative pin verification is actions.lock plus check-lock-sync.sh, which runs on every pull request."}],"scanner":{"commit":"6693f9aed8e4383f78a3d01b600b32663bf7a45c","repository":"hyperpolymath/hypatia","sources":["lib/hypatia/scanner_suppression.ex","lib/rules/"]},"schema":"hypatia-rule-order/1"}
Loading
Loading