From 052120e949866f46650a01b5e742f2739e0164aa Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 12:45:43 +0000 Subject: [PATCH 1/6] fix(coherence): README status references, and the checker and scan pins the stack shares The README cited a root STATUS.adoc three times. haec has no such file; it has compiler/STATUS.adoc and lsp/STATUS.adoc, which the README now names. The trope-check workflow pins trope-checker at 0dceab6, with hermeneia and vocarium. Between the previous pin (4ecba4f) and 0dceab6, trope-checker's src/, schemas/, spec/ and conformance fixtures do not differ; the one Idris2 file that differs (Trope/Order.idr) differs in comments only. The Hypatia scan pin moves to standards 58362c2, which installs OTP 27.3.4.19. Earlier revisions install OTP 28.x, which faults in the VM's garbage collector on some trees (hypatia#1061). Not changed: design/elaboration.adoc still states an O2 obligation in terms of the v0.1 ordering. That is deferred to the owner. tests/check-examples.sh passes locally against the Rust core built from trope-checker sources identical to main. Found by the stack coherence gate (workbench#83). Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01J4QvDim4mMEfCer9SiAV4H --- .github/workflows/hypatia-scan.yml | 2 +- .github/workflows/trope-check.yml | 2 +- CHANGELOG.adoc | 13 +++++++++++++ README.adoc | 6 +++--- 4 files changed, 18 insertions(+), 5 deletions(-) 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/CHANGELOG.adoc b/CHANGELOG.adoc index 6604f66..653ce6c 100644 --- a/CHANGELOG.adoc +++ b/CHANGELOG.adoc @@ -10,6 +10,19 @@ https://semver.org/spec/v2.0.0.html[Semantic Versioning]. ==== Fixed +* *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 From 4ad8ba0ac2bc89c7b817f7e2e95058fcbf5078c1 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 16:32:33 +0000 Subject: [PATCH 2/6] ci(lint): read the SPDX header block, not line 1 The lint tested line 1 of each workflow for the SPDX identifier. gh actions-lock inserts its banner at line 1 whenever it refreshes the lockfile, so the test failed on nearly every workflow, here and on main. It now reads the leading comment block, the test standards governance-reusable.yml uses. A workflow with no identifier in that block still fails (checked with two planted files). Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01J4QvDim4mMEfCer9SiAV4H --- .github/workflows/workflow-linter.yml | 13 ++++++++++--- CHANGELOG.adoc | 7 +++++++ 2 files changed, 17 insertions(+), 3 deletions(-) diff --git a/.github/workflows/workflow-linter.yml b/.github/workflows/workflow-linter.yml index d1b7dce..fc84429 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" diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc index 653ce6c..699f286 100644 --- a/CHANGELOG.adoc +++ b/CHANGELOG.adoc @@ -10,6 +10,13 @@ https://semver.org/spec/v2.0.0.html[Semantic Versioning]. ==== Fixed +* *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 From d2ae72c7b71ba3b41978aad2e109829761ec2a37 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 16:40:27 +0000 Subject: [PATCH 3/6] ci(lint): judge the ref of a reusable workflow call, not the line The check for reusable workflow calls looked for 40 hex characters anywhere on the line and only matched an unquoted value. A branch ref with a commit named in a trailing comment passed, and so did any quoted ref. The value of each uses: is now read with its comment and quotes removed, and the text after the @ must be exactly 40 lowercase hex characters. Four planted references (comment, double quote, single quote, 41 characters) pass the previous check and fail this one; a plain commit, a quoted commit and an ordinary action on a tag are unaffected. Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01J4QvDim4mMEfCer9SiAV4H --- .github/workflows/workflow-linter.yml | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/.github/workflows/workflow-linter.yml b/.github/workflows/workflow-linter.yml index fc84429..7269500 100644 --- a/.github/workflows/workflow-linter.yml +++ b/.github/workflows/workflow-linter.yml @@ -89,8 +89,22 @@ 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) + # The value of each `uses:` is read as YAML would read it: a + # trailing comment is dropped and surrounding quotes are removed. + # The ref after the @ must then be exactly 40 lowercase hex + # characters; a commit named in a comment, or a quoted branch + # name, does not pass. + unpinned=$(awk ' + /^[[:space:]]*(-[[:space:]]+)?uses:/ { + v = $0 + sub(/^[[:space:]]*(-[[:space:]]+)?uses:[[:space:]]*/, "", v) + sub(/[[:space:]]+#.*$/, "", v) + sub(/[[:space:]]+$/, "", v) + gsub(/^["\047]|["\047]$/, "", v) + if (v !~ /^[^\/]+\/[^\/]+\/\.github\/workflows\/[^@]+@/) next + ref = v; sub(/^[^@]*@/, "", ref) + if (ref !~ /^[0-9a-f]+$/ || length(ref) != 40) print FILENAME ":" FNR ": " $0 + }' .github/workflows/*.yml .github/workflows/*.yaml 2>/dev/null || true) if [ -n "$unpinned" ]; then echo "ERROR: Found reusable workflow calls not pinned to a SHA:" echo "$unpinned" From 9216b737f9f374449a3f5725371f203878519ddb Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 16:44:45 +0000 Subject: [PATCH 4/6] ci(lint): judge reusable workflow refs after YAML decoding The previous version read the raw text of each uses: line, so an escape inside a quoted value (for example \x77orkflows) kept a branch ref out of the check. With yq on the runner each workflow is now parsed and the decoded job-level uses: values are judged: a call that is not local must end in @ and exactly 40 lowercase hex characters, and a workflow that does not parse fails. Without yq the raw-text check remains, with a warning. Run against the real step: an escaped path, a flow-style mapping and a comment carrying a commit are each rejected; a quoted commit, a local call and an ordinary tagged action pass. Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01J4QvDim4mMEfCer9SiAV4H --- .github/workflows/workflow-linter.yml | 54 +++++++++++++++++++-------- 1 file changed, 38 insertions(+), 16 deletions(-) diff --git a/.github/workflows/workflow-linter.yml b/.github/workflows/workflow-linter.yml index 7269500..c2b67fb 100644 --- a/.github/workflows/workflow-linter.yml +++ b/.github/workflows/workflow-linter.yml @@ -89,22 +89,44 @@ jobs: # Reusable workflow calls are outside lockfile scope and must # remain SHA-pinned inline. - # The value of each `uses:` is read as YAML would read it: a - # trailing comment is dropped and surrounding quotes are removed. - # The ref after the @ must then be exactly 40 lowercase hex - # characters; a commit named in a comment, or a quoted branch - # name, does not pass. - unpinned=$(awk ' - /^[[:space:]]*(-[[:space:]]+)?uses:/ { - v = $0 - sub(/^[[:space:]]*(-[[:space:]]+)?uses:[[:space:]]*/, "", v) - sub(/[[:space:]]+#.*$/, "", v) - sub(/[[:space:]]+$/, "", v) - gsub(/^["\047]|["\047]$/, "", v) - if (v !~ /^[^\/]+\/[^\/]+\/\.github\/workflows\/[^@]+@/) next - ref = v; sub(/^[^@]*@/, "", ref) - if (ref !~ /^[0-9a-f]+$/ || length(ref) != 40) print FILENAME ":" FNR ": " $0 - }' .github/workflows/*.yml .github/workflows/*.yaml 2>/dev/null || 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. + unpinned="" + if command -v yq >/dev/null 2>&1; then + 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 + else + # No yq on this runner: the raw text is read instead, with the + # comment and quotes removed. Escapes inside a quoted value are + # not decoded on this path. + echo "::warning::yq not on this runner -- reusable workflow refs read from raw text" + unpinned=$(awk ' + /^[[:space:]]*(-[[:space:]]+)?uses:/ { + v = $0 + sub(/^[[:space:]]*(-[[:space:]]+)?uses:[[:space:]]*/, "", v) + sub(/[[:space:]]+#.*$/, "", v) + sub(/[[:space:]]+$/, "", v) + gsub(/^["\047]|["\047]$/, "", v) + if (v !~ /^[^\/]+\/[^\/]+\/\.github\/workflows\/[^@]+@/) next + ref = v; sub(/^[^@]*@/, "", ref) + if (ref !~ /^[0-9a-f]+$/ || length(ref) != 40) print FILENAME ":" FNR ": " $0 + }' .github/workflows/*.yml .github/workflows/*.yaml 2>/dev/null || true) + fi if [ -n "$unpinned" ]; then echo "ERROR: Found reusable workflow calls not pinned to a SHA:" echo "$unpinned" From 19e66c8a3d8ba0321a7afcf985ff7adb70e09a6f Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 16:46:55 +0000 Subject: [PATCH 5/6] ci(lint): no YAML parser, no verdict on reusable workflow refs The raw-text fallback for runners without yq could not see a flow-style mapping or an escaped path, so on that path a branch ref still passed. The fallback is removed: when yq is missing the step fails and says why. Run against the real step: a flow-style branch ref and an escaped path are rejected, a quoted commit and a local call pass, both repositories pass, and with yq taken off PATH the step exits 1. Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01J4QvDim4mMEfCer9SiAV4H --- .github/workflows/workflow-linter.yml | 51 +++++++++++---------------- 1 file changed, 20 insertions(+), 31 deletions(-) diff --git a/.github/workflows/workflow-linter.yml b/.github/workflows/workflow-linter.yml index c2b67fb..80081d5 100644 --- a/.github/workflows/workflow-linter.yml +++ b/.github/workflows/workflow-linter.yml @@ -94,39 +94,28 @@ jobs: # 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="" - if command -v yq >/dev/null 2>&1; then - 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 + 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 - 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 - else - # No yq on this runner: the raw text is read instead, with the - # comment and quotes removed. Escapes inside a quoted value are - # not decoded on this path. - echo "::warning::yq not on this runner -- reusable workflow refs read from raw text" - unpinned=$(awk ' - /^[[:space:]]*(-[[:space:]]+)?uses:/ { - v = $0 - sub(/^[[:space:]]*(-[[:space:]]+)?uses:[[:space:]]*/, "", v) - sub(/[[:space:]]+#.*$/, "", v) - sub(/[[:space:]]+$/, "", v) - gsub(/^["\047]|["\047]$/, "", v) - if (v !~ /^[^\/]+\/[^\/]+\/\.github\/workflows\/[^@]+@/) next - ref = v; sub(/^[^@]*@/, "", ref) - if (ref !~ /^[0-9a-f]+$/ || length(ref) != 40) print FILENAME ":" FNR ": " $0 - }' .github/workflows/*.yml .github/workflows/*.yaml 2>/dev/null || true) - fi + done < <(printf '%s\n' "$calls") + done if [ -n "$unpinned" ]; then echo "ERROR: Found reusable workflow calls not pinned to a SHA:" echo "$unpinned" From 6df6232a33e7b94b987ec79e62d8841fd25829c2 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 17:11:55 +0000 Subject: [PATCH 6/6] chore(root-shape): allow the five AsciiDoc root documents The allowlist carried the template's .md names (CHANGELOG.md, CONTRIBUTING.md, SECURITY.md), while this repository's root files are AsciiDoc. The root-shape check therefore rejected CHANGELOG.adoc, CONTRIBUTING.adoc, SECURITY.adoc, FUNDING and PROOF-PROGRESS.adoc, which failed CI / required and estate-rules here and on main. The five are added with a line each; the .md entries are left in place. Edit authorised by the owner for this file and these five entries. Before: check-root-shape.sh exits 1 naming the five. After: PASS, 47 entries, 52 permitted. Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01J4QvDim4mMEfCer9SiAV4H --- .machine_readable/root-allow.txt | 9 +++++++++ CHANGELOG.adoc | 7 +++++++ 2 files changed, 16 insertions(+) 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 699f286..93a01c6 100644 --- a/CHANGELOG.adoc +++ b/CHANGELOG.adoc @@ -10,6 +10,13 @@ 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