Repository navigation
Commit ff1a077
committed
fix(docs): resolve the dangling references and the code-scanning alert on this PR
Remaining CI failures on this PR, triaged to source rather than to name.
"HYPATIA" IS NOT A WORKFLOW
Triaged first because it looked like one. No workflow or job in this repository
is named `Hypatia`; the check-run comes from the GitHub Advanced Security app,
i.e. it is the code-scanning gate, and it failed because the SARIF upload from
this PR contained **1 new alert in code changed by this pull request**:
.machine_readable/rsr-profile.a2ml
warning: doc references `src/interface/` but no such directory exists in the
tree (likely surviving a directory rename)
A true positive against my own new file, not a false one. The directory really
is absent (0 tracked files under src/interface/ in the canon), and the sentence
was declaring *that absence* — "no C-ABI seam and no formally specified ABI;
src/interface/ absent" — but written so that it read as a live path reference.
Reworded to state the same fact without the bare path token. The alert was not
dismissed and no scanning config was touched: the text is simply unambiguous now
about what it means.
TWO MORE DANGLING REFERENCES, FOUND WHILE LOOKING
Chasing that alert meant checking every path this PR's files point at, and two
pointed at a document that was never committed — `docs/binding/04-EXECUTION-*`
does not exist, and neither does `docs/binding/`:
.machine_readable/rsr-profile.a2ml:37 "see docs/binding/04-EXECUTION-PLAN.md, ruling R-B"
docs/AFFIRMATION.adoc:54 link:../binding/04-EXECUTION-PLAN.md[...]
scripts/check-canon-lockstep.sh:98 "# See docs/binding/04-EXECUTION-PLAN.md."
These were references to a plan that existed only in conversation. A document
that cites a non-existent authority is worse than one that cites none: it reads
as though the argument has been made somewhere. Repointed at what actually
exists and actually says it:
* the dialect note -> docs/AUDIT.adoc finding F3, which records that the law is
authored in a superseded dialect while DEED is itself an unratified DRAFT
* the ordering rule -> canon.lock [canon.lockstep], which is where
"spine-adopts-then-canon-releases" is actually stated
* AFFIRMATION's "We intend" list -> docs/AUDIT.adoc, which enumerates the
release conditions those actions serve
A scan of every cross-reference in every .adoc and .a2ml this PR touches now
resolves; earlier it did not.
NO LOCK BUMP REQUIRED
`.machine_readable/rsr-profile.a2ml` is not named in canon.lock [canon.artifacts]
(criteria, gates, applicability, lifecycle, constitution), so a comment edit in it
is not a canon change and Gate A assertion 2 stays satisfied.
GATES AFTER
Gate A, --canon standards -> passed 8 failed 0 skipped 2 GATE A PASSED
Gate A, --canon . -> passed 8 failed 0 skipped 2 GATE A PASSED
check-rsr-profile.sh . -> OK — scaffold matches declared capabilities
check-standards-map.sh -> GATE D PASSED, entry_count = 120
(cherry picked from commit 236fcb8)1 parent 41a6d7b commit ff1a077
3 files changed
Lines changed: 7 additions & 5 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
34 | 34 | | |
35 | 35 | | |
36 | 36 | | |
37 | | - | |
| 37 | + | |
| 38 | + | |
38 | 39 | | |
39 | 40 | | |
40 | 41 | | |
| |||
93 | 94 | | |
94 | 95 | | |
95 | 96 | | |
96 | | - | |
| 97 | + | |
| 98 | + | |
97 | 99 | | |
98 | 100 | | |
99 | 101 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
50 | 50 | | |
51 | 51 | | |
52 | 52 | | |
53 | | - | |
54 | | - | |
| 53 | + | |
| 54 | + | |
55 | 55 | | |
56 | 56 | | |
57 | 57 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
95 | 95 | | |
96 | 96 | | |
97 | 97 | | |
98 | | - | |
| 98 | + | |
99 | 99 | | |
100 | 100 | | |
101 | 101 | | |
| |||
0 commit comments