fix: re-pin and re-stamp the five drifted wiki/core provenance pages - #14
Merged
Merged
Conversation
The 2026-08-07 release run failed `wiki_currency_check_autogalaxy` on five `content_sha256` mismatches. All five were caused by one commit, b2fc57a ("docs: update HowToGalaxy references for the tutorial restructure"), which deliberately deferred the frontmatter: "The page's pinned_commit frontmatter is left for the ag_update_wiki maintainer flow." That deferral inverts the usual hazard. The prose is correct; the pins are stale. And `--write-provenance` rewrites `content_sha256` only — it never touches `pinned_commit` — so a bare re-stamp would have turned the check green while leaving two pages attesting current prose against old source. Re-pinned, after re-validating the prose against those checkouts: - `external/howtogalaxy.md` — HowToGalaxy b1815e9d -> ee283c9d. This pin had to move: b2fc57a rewrote the page's own `paths:` list to `chapter_3_pixelizations` / `chapter_4_scaling_up_galaxies`, directories that do not exist at b1815e9d. Verified against ee283c9d: 6+10+6+3+1 = 26 tutorials, 6 simulators, 32 .py total, 26+6 = 32 matching notebooks, and all three chapter tables agree with the files on disk. - `external/skill_citation_map.md` — autogalaxy_assistant a083753 -> 239a61c, 4 commits stale on `skills/`. Content was already current: 25 skills on disk, 25 rows, zero drift in either direction, and all 13 HowToGalaxy cells resolve. A pin correction, not a rewrite. Re-stamped only (their pinned projects did not move; each took a one-line HowToGalaxy cross-reference, verified against source): - `concepts/inversions_and_pixelizations.md` — chapter 3 now carries the linear algebra and Bayesian statistics (tutorial_3_inversions, tutorial_5_bayesian_formalism). - `concepts/non_linear_search.md` — chaining is tutorial_9_search_chaining and tutorial_10_prior_passing, at the end of chapter 2. - `external/rtd.md` — PyAutoGalaxy docs/howtogalaxy/ has exactly chapter_1_introduction .. chapter_4_scaling_up_galaxies plus chapter_optional. Also documents two extensionless prose files in HowToGalaxy (`chapter_2_modeling/tutorial_11_summary`, `chapter_3_pixelizations/introduction`). They are chapter narrative, not tutorials — no .py, no notebook, excluded from the counts — but listing the directory makes the first look like an eleventh tutorial, and the page's URL-building rules yield a 404 for it. Verified here: --check-provenance 0 errors (was 5), --check-citations 78 files / 1061 citations / 0 missing, --lint-idioms clean across 122 files. --check-version and --scope all are NOT gradeable in this session: autogalaxy is not installed, and per the recorded baseline-repin-TRAP a local source install would be the wrong ground truth anyway. CI is authoritative for those two legs. This change touches no PyAuto* symbols, only file paths and prose, so neither leg should move. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013rk1Z3322mKgJEVE761h11
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
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.
Clears the five
content_sha256errors that failedwiki_currency_check_autogalaxyduring the 2026-08-07 release run (PyAutoHandsrelease.yml31200419263). That red has been onmainsince 2026-08-06, so every PR to this repo has been failingwiki-currencyregardless of its contents until this lands.Five files under
wiki/core/. No library, workspace, or skill code touched.The prompt's framing was inverted, and it changed the fix
This was filed as a pure
--write-provenancere-stamp, with a warning against blessing stale prose. The reverse held: the prose is correct and twopinned_commits were stale.All five mismatches trace to one commit, b2fc57a ("docs: update HowToGalaxy references for the tutorial restructure", #12), whose own message records the deferral — "The page's pinned_commit frontmatter is left for the ag_update_wiki maintainer flow." Known debt, not an accident.
The load-bearing detail:
--write-provenancerewritescontent_sha256only and never touchespinned_commit(autoassistant/audit_skill_apis.py:1132-1133). A bare re-stamp would have turned this job green while leaving two pages attesting current prose against superseded source.Re-pinned (2), after re-validating the prose against those checkouts
external/howtogalaxy.md— HowToGalaxyb1815e9d→ee283c9d. This pin had to move: b2fc57a rewrote the page's ownpaths:list tochapter_3_pixelizations/chapter_4_scaling_up_galaxies, directories that do not exist atb1815e9d. The checker cannot catch this — it verifies a pin is a real, reachable commit, not that the declared paths resolve there. Verified againstee283c9d: 6+10+6+3+1 = 26 tutorials, 6 simulators, 32.pytotal, 26+6 = 32 matching notebooks, and all three chapter tables agree with the files on disk.external/skill_citation_map.md— autogalaxy_assistanta083753c→239a61c, 4 commits stale onskills/(22 files, including two entirely new skills). Content was already current — 25 skills on disk, 25 rows, zero drift in either direction, all 13 HowToGalaxy cells resolve — so this is a pin correction, not a rewrite.Re-stamped only (3)
Each took a one-line HowToGalaxy cross-reference from b2fc57a, and none of their pinned projects moved. Every claim re-verified against source:
concepts/inversions_and_pixelizations.md— chapter 3 does carry the linear algebra and Bayesian statistics (tutorial_3_inversions,tutorial_5_bayesian_formalism).concepts/non_linear_search.md— chaining istutorial_9_search_chaining+tutorial_10_prior_passing, at the end of chapter 2.external/rtd.md—PyAutoGalaxy:docs/howtogalaxy/has exactlychapter_1_introduction…chapter_4_scaling_up_galaxiespluschapter_optional.Also folded in: two undocumented prose files
HowToGalaxy carries two extensionless prose files —
chapter_2_modeling/tutorial_11_summaryandchapter_3_pixelizations/introduction. They are chapter narrative, not tutorials: no.py, no notebook, correctly excluded from the counts. Undocumented, they are an active trap — listing the directory makes the first look like an eleventh tutorial, and this page's own URL-building rule (scripts/CHAPTER/TUTORIAL.py) yields a 404 for it. Now documented beside the existing chapter-1 caveats, including the contrast with chapter 1'stutorial_5_summary.py, which is a real script and is counted in its 6.Verification
Run locally on this branch:
--check-provenance--check-citations--lint-idiomsA self-check worth reusing: four of the five new hashes landed exactly on the "actual" values the checker reported before any edit — proof that no prose changed in those four. Only
howtogalaxy.mddiffers, and only by the one deliberate addition.--check-versionand--scope allwere not gradeable locally — they grade against an installedautogalaxy, absent from the container this was prepared in, and per thebaseline-repin-TRAPrecorded undermge-sigma-min-workspace-sweepa local source install would be the wrong ground truth anyway.Both have since passed in CI (
wiki-currencyjob 93016921887). Verified rather than assumed from the badge: the job's stdout is empty because each leg writes to$GITHUB_STEP_SUMMARY, so the workflow was read directly —run()captures each leg'srcand setsfail=1on any non-zero, all five legs run unconditionally, andexit "$fail"is the aggregate (.github/workflows/wiki-currency.yml:129-157). A green conclusion therefore means all five legs exited 0, with nothing skipped or masked.--check-versionpassing also confirms the baseline still matches releasedautogalaxy 2026.8.7.1.The 101 provenance warnings are all
no git checkout resolvable — commit checks skipped (packaged install?), expected on a runner where the libraries are pip-installed. Not actionable, and deliberately not "fixed".Related, not folded in
The sibling
wiki_currency_checkfailure for autolens in the same release run was a PyPI index-propagation race, already resolved and graded clean on all five legs on 2026-08-07. No autolens counterpart exists or is needed.