docs(wiki): update project wiki - #1574
Merged
Merged
Conversation
marcusrbrown
approved these changes
Sep 11, 2026
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.
Weekly wiki refresh. The lint pass found no broken wikilinks and no orphan pages; seven of the eight pages were stale against their
sourcesfrontmatter and were updated in place. No unchanged page was regenerated.What changed and why
The last three weeks of work clustered into two stories, and most of this diff is those two stories being written down.
Session persistence stopped reporting a boolean.
saveCachenow returns aCacheSaveResultwith two independent persistence axes plus a named outcome, and theCACHE_SAVEDstate key that crosses into the post-action hook carries a four-value enum instead oftrue/false. [[Session Persistence]] gained a section on what a save actually reports — including the explicit caveat thatcache-rejectedcovers several causes because the@actions/cacheboundary cannot distinguish them, not because one was diagnosed. [[Execution Lifecycle]] gained a section on the cleanup-to-post handoff, covering whyCLEANUP_METADATA_WRITTENhad to exist separately (CACHE_SAVEDis seeded before cleanup runs, sonot-persistedis ambiguous between "cleanup ran and was denied" and "cleanup never ran"). Also documented: save keys are now scoped by run attempt, because re-runs were colliding with the first attempt's immutable cache entry and having their state discarded through the "already exists" success path.Setup grew a real distinction between an install directory and an executable. Four fixes in five days traced back to the same conflation, so [[Setup and Configuration]] now describes it as one story rather than four bullet points — plus the new fail-fast platform gate (which replaced silent fallbacks that mapped an unsupported arch onto the x64 asset and downloaded a binary that could not execute), the corrected plugin-install condition, and the two new diagnostics that accompany a failed plugin install.
Smaller updates
ResponseSurfaceaxis, which was undocumented. Covers whypr-review-permittedexists (a PR mention is legitimately either a review request or a question) and why the policy table is pinned withsatisfies.Verification
Re-ran the lint pass after editing: wikilinks resolve, no orphans, in-page anchors resolve, relative paths exist, every
sourcesentry exists on disk, and every index row matches its page's frontmattertypeandsummary.Scope is
docs/wiki/only — no source files, noAGENTS.md.Run Summary
schedule(threadschedule-d7190410-34062354146)d9a88dee(lastdocs(wiki):commit), 46 commits reviewed