diff --git a/.github/workflows/hypatia-scan.yml b/.github/workflows/hypatia-scan.yml index ba081a6..3dd8e66 100644 --- a/.github/workflows/hypatia-scan.yml +++ b/.github/workflows/hypatia-scan.yml @@ -20,4 +20,4 @@ permissions: jobs: scan: - uses: metadatastician/standards/.github/workflows/hypatia-scan-reusable.yml@857ff096af11451841fb10488fed1438523973a1 + uses: metadatastician/standards/.github/workflows/hypatia-scan-reusable.yml@58362c24cf225694b388fc660b3525d8207b7c61 diff --git a/.github/workflows/trope-check.yml b/.github/workflows/trope-check.yml index cd0cb1f..6139c9c 100644 --- a/.github/workflows/trope-check.yml +++ b/.github/workflows/trope-check.yml @@ -42,7 +42,7 @@ jobs: uses: actions/checkout@v7.0.1 with: repository: hyperpolymath/trope-checker - ref: 4ecba4f1862aec144ec940b1d8a93ddabd1cb591 # main @ 2026-11-02 (after Phase 0 #107 and #109) + ref: 0dceab68459d46b2cda22137c261023223c30e9a # main @ 2026-11-16; src/, schemas/, spec/ and the conformance fixtures are unchanged since 4ecba4f path: trope-checker # The pinned idris2-pack image is minimal and ships no jq, which both the diff --git a/.github/workflows/workflow-linter.yml b/.github/workflows/workflow-linter.yml index d1b7dce..80081d5 100644 --- a/.github/workflows/workflow-linter.yml +++ b/.github/workflows/workflow-linter.yml @@ -36,16 +36,23 @@ jobs: - name: Check SPDX Headers run: | echo "=== Checking SPDX License Headers ===" + # The header comment block is read, not line 1 alone. gh actions-lock + # inserts "# This workflow is managed by gh actions-lock." at line 1 + # whenever it refreshes the lockfile, so a line-1 test fails every + # workflow the tool has touched. The test below is the one in + # standards' governance-reusable.yml: the leading run of comment + # lines must hold the identifier. failed=0 for file in .github/workflows/*.yml .github/workflows/*.yaml; do [ -f "$file" ] || continue - if ! head -1 "$file" | grep -q "^# SPDX-License-Identifier:"; then - echo "ERROR: $file missing SPDX header" + if ! awk '/^---[[:space:]]*$/ { next } /^#/ { print; next } { exit }' "$file" \ + | grep -q "^# SPDX-License-Identifier:"; then + echo "ERROR: $file has no SPDX-License-Identifier in its header comment block" failed=1 fi done if [ $failed -eq 1 ]; then - echo "Add '# SPDX-License-Identifier: MPL-2.0' as first line" + echo "Add '# SPDX-License-Identifier: ' to the header comment block" exit 1 fi echo "All workflows have SPDX headers" @@ -82,8 +89,33 @@ jobs: # Reusable workflow calls are outside lockfile scope and must # remain SHA-pinned inline. - unpinned=$(grep -rnE "^[[:space:]]+uses:[[:space:]]*[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+/\.github/workflows/[^@]+@" .github/workflows/ | \ - grep -v "@[a-f0-9]\{40\}" || true) + # A reusable workflow call is a job-level `uses:`. With yq each + # workflow is parsed and the DECODED value is judged, so quoting, + # escapes, flow style and trailing comments cannot hide a ref: a + # call that is not local (./) must end in @ followed by exactly + # 40 lowercase hex characters. + # No parser, no verdict: reading the raw text instead would let a + # flow-style mapping or an escaped path through, so the step fails + # when yq is missing. + if ! command -v yq >/dev/null 2>&1; then + echo "ERROR: yq is not on this runner; reusable workflow refs cannot be checked" + exit 1 + fi + unpinned="" + for file in .github/workflows/*.yml .github/workflows/*.yaml; do + [ -f "$file" ] || continue + if ! calls="$(yq -r '.jobs[] | select(has("uses")) | .uses' "$file" 2>&1)"; then + echo "ERROR: $file is not parseable as YAML: $calls" + exit 1 + fi + while IFS= read -r call; do + [ -n "$call" ] || continue + case "$call" in ./*) continue ;; esac + if ! printf '%s\n' "$call" | grep -qE '@[0-9a-f]{40}$'; then + unpinned="${unpinned}${file}: ${call}"$'\n' + fi + done < <(printf '%s\n' "$calls") + done if [ -n "$unpinned" ]; then echo "ERROR: Found reusable workflow calls not pinned to a SHA:" echo "$unpinned" diff --git a/.machine_readable/root-allow.txt b/.machine_readable/root-allow.txt index aa75067..3b885b2 100644 --- a/.machine_readable/root-allow.txt +++ b/.machine_readable/root-allow.txt @@ -24,6 +24,15 @@ SECURITY.md # REQUIRED AT ROOT by scorecard-enforcer CI + the sec LICENSE CHANGELOG.md +# ─── Root documents this repository keeps in AsciiDoc (owner-authorised 2026-11-17) ─── +# The three .md entries above are the template's spelling; this repository's +# files are .adoc. The .md entries are left in place. +CHANGELOG.adoc # the changelog this repository maintains +CONTRIBUTING.adoc # contributor guide, AsciiDoc form of CONTRIBUTING.md +SECURITY.adoc # security policy pointer, AsciiDoc form of SECURITY.md +FUNDING # funding statement (AsciiDoc content, no extension) +PROOF-PROGRESS.adoc # proof progress summary, kept beside README for visibility + # ─── Build entry points (must live at root for their tooling) ──────────────── Justfile # delegates phases to build/just/*.just coordination.k9 # repo-local session binding (template-mandated) diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc index 6604f66..93a01c6 100644 --- a/CHANGELOG.adoc +++ b/CHANGELOG.adoc @@ -10,6 +10,33 @@ https://semver.org/spec/v2.0.0.html[Semantic Versioning]. ==== Fixed +* *Root allowlist names the five AsciiDoc root documents (2026-11-17, +owner-authorised).* `+.machine_readable/root-allow.txt+` listed the template's +`+.md+` names, so the root-shape check rejected `+CHANGELOG.adoc+`, +`+CONTRIBUTING.adoc+`, `+SECURITY.adoc+`, `+FUNDING+` and +`+PROOF-PROGRESS.adoc+`, here and on `+main+`. The five are added; the `+.md+` +entries are left as they were. + +* *Workflow lint reads the SPDX header block (2026-11-17).* The lint tested +line 1 of each workflow for the SPDX identifier, but `+gh actions-lock+` puts +its own banner on line 1 whenever it refreshes the lockfile, so the test failed +on 25 of 25 workflows here and on `+main+`. It now reads the leading comment +block, the same test as `+standards+` `+governance-reusable.yml+`. A workflow +with no identifier in that block still fails. + +* *Stack coherence: three README references, the checker pin and the scan pin +(2026-11-17).* The README cited a root `+STATUS.adoc+` that does not exist; the +files are `+compiler/STATUS.adoc+` and `+lsp/STATUS.adoc+`, and it now names +them. The trope-check workflow pins trope-checker at `+0dceab6+`, the commit +hermeneia and vocarium move to in the same sweep; between the previous pin +(`+4ecba4f+`) and that commit, trope-checker's `+src/+`, `+schemas/+`, +`+spec/+` and conformance fixtures are unchanged, and the one Idris2 file that +differs differs in comments only. The Hypatia scan pin moves to the revision +that installs OTP 27.3.4.19 (hypatia#1061). Not changed: the O2 obligation in +`+design/elaboration.adoc+` that still names the v0.1 +`+Predicated+`-incomparable-to-`+Dropped+` claim. Rewording an obligation is +the owner's. + * *`+docs/status/PROOF-STATUS.adoc+` published a percentage, which PROOF-POLICY forbids (2026-11-09).* The summary read `+*Overall*: 0% proven+`. §8.4 rule 7 is explicit — "Never publish 'X% proved', an average grade, or a single confidence diff --git a/README.adoc b/README.adoc index bd818dd..5359694 100644 --- a/README.adoc +++ b/README.adoc @@ -111,7 +111,7 @@ provides. Design. The surface syntax and the elaboration table are the first artefacts; `examples/` pairs small programs with the IR they lower to, and each lowered IR round-trips through the trope-checker (schema-valid, expected verdict). There is no -compiler yet — `compiler/` and `lsp/` are named future work (`STATUS.adoc`). +compiler yet — `compiler/` and `lsp/` are named future work (`compiler/STATUS.adoc`, `lsp/STATUS.adoc`). == Repository map @@ -124,8 +124,8 @@ compiler yet — `compiler/` and `lsp/` are named future work (`STATUS.adoc`). | `design/trope-ir.schema.json` | Vendored copy of the IR contract Haec targets (canonical in trope-checker). | `examples/` | Small programs (`*.haec`) paired with the IR they lower to (`*.ir.json`). | `docs/trope-estate-architecture.svg` | The three-repo dependency picture. -| `compiler/` | (planned) Parser, type-checker, elaborator, codegen — see `STATUS.adoc`. -| `lsp/` | (planned) Editor support — see `STATUS.adoc`. +| `compiler/` | (planned) Parser, type-checker, elaborator, codegen — see `compiler/STATUS.adoc`. +| `lsp/` | (planned) Editor support — see `lsp/STATUS.adoc`. |=== == Run the checks