Repository navigation
refactor: migrate Markdown to AsciiDoc - #102
Merged
Merged
Conversation
hyperpolymath
added a commit
that referenced
this pull request
Oct 2, 2026
…c (P1-0 prep) (#143) First step of ULTRAPLAN **P1-0** (the claims ledger). Before `dashboard-check` takes on claims, it has to be able to fail. ## Two reasons the STATE-vs-dashboard gate could not fail on `main` 1. **The job died before the checker ran.** `dashboard-check.yml` passed `with: toolchain: v1` to `dtolnay/rust-toolchain@v1`, and `v1` is not a toolchain. *STATE vs dashboard reconciliation* is red on `main` b1fc4ed at the toolchain-parse step. Now `toolchain: stable`. `uses:` is unchanged, so `actions.lock` is untouched; `gh actions-lock --no-fix` reports the same on this branch as on main (0 errors). 2. **The checker compared nothing.** It read `TOPOLOGY.md` / `READINESS.md`, which #102 renamed to `.adoc`, and an absent file was skipped. Run locally on `main`, it printed `OK — dashboards agree` without reading either dashboard. ## Change (`crates/dashboard-check`) - An absent dashboard, or a field that cannot be parsed on either side, is now a **failure**, not a skip. That covers completion, grade (TOPOLOGY and READINESS), Last-updated, and the STATE fields. - `OK` lists every value it compared, so a vacuous pass is visible. - Reads `.adoc` with a `.md` fallback, and `descriptiles/STATE.a2ml` with a `6a2/` fallback (AGENTS §2a). The `6a2/` directory is not renamed here. - The TOPOLOGY grade is read from the `OVERALL` line only. Previously the first `Grade ` anywhere in the file counted, and it matched prose by accident. - AsciiDoc shapes (`*Current Grade:* D`, `// Last updated: …`) are parsed. Test fixtures are copied from the real files. ## Real gap surfaced, fixed here #102 dropped TOPOLOGY's `Last updated` line, so staleness was uncheckable. It is restored as an AsciiDoc comment with its **original** date (2026-07-02, from `TOPOLOGY.md` at `3a8a4b3^`), not today's date. ## Evidence ``` $ cargo run -q -p dashboard-check -- --check . # this branch dashboard-check: OK — dashboards agree with ./.machine_readable/6a2/STATE.a2ml: ✓ completion 60% (TOPOLOGY.adoc) ✓ grade D (TOPOLOGY.adoc) ✓ TOPOLOGY.adoc last updated 2026-07-02 >= STATE 2026-06-12 ✓ grade D (READINESS.adoc) ``` Before the date line was restored: `✗ TOPOLOGY.adoc has no 'Last updated: YYYY-MM-DD' line`, rc=1. - Unit tests: **8 → 19**, all pass. clippy `--all-targets -D warnings` is clean, and `cargo fmt --check` is clean (it reformatted lines the old file already had unformatted). - **Ten mutants, all killed.** Each one reintroduces a silent skip (TOPOLOGY absent, Last-updated absent, grade absent), reads the grade from any line, drops the adoc READINESS token, drops `.adoc`, drops the `.md` fallback, or ignores `descriptiles/`. The first run left two survivors: the adoc-token path was masked by the `CRG Grade:` heading, and `read_surface` was untested. Tests were added for both, and they are now killed. ## Scope This is a correctness fix to an existing gate. The claims ledger itself (rows of claim | status | artefact | command, measured test counts, reject-class fixtures) is the next PR, stacked on this one. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01VxcAoyMQe7CjQwCKL18Mm4 Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Automated migration of .md to .adoc per global rules, preserving wikis and critical exceptions.