fix(phase-33): the wiki waits for the flip after all — free-plan GitHub offers wikis only on public repos (settings page text recorded); wiki_sync message + checklist item 5 corrected

This commit is contained in:
Drew T
2026-09-07 14:23:14 -06:00
parent c05c6081bd
commit fae69a9175
2 changed files with 10 additions and 7 deletions
+6 -4
View File
@@ -689,8 +689,9 @@ Mid-phase rules check after every 4 completed tasks (P6). Commit banked artifact
`run_masked.py` swaps one class on top; the only copy lives here; no fork, no standalone repo unless asked; the rejected PR's patch
stays as the record), the codegen map, the decomp.me replica, the drafter write-up, the how-to. `docs/outreach/tools-announcement.md`
(the post-flip xsig post, developer's voice) stored; xsig topics/homepage + fork deletion + the post added to the checklist as 5b.
**The wiki can be pushed NOW** (private wiki flips with the repo) — `wiki_sync.sh` comment/message corrected; checklist item 5
reworded. Commit: see below.
~~The wiki can be pushed NOW~~ — **WRONG (R14, corrected minutes later):** GitHub's settings page reads "Upgrade or make this
repository public to enable Wikis"; on the free plan wikis exist only on public repos, so the wiki waits for the flip. `wiki_sync.sh`
message and checklist item 5 corrected back. Commit: see below.
## 🛑 SESSION CHECKPOINT — A1–A5 ✓, B1–B9/C3 ✓, C1–C9 ✓, D1–D5 ✓, F1–F3 ✓, E1–E6 ✓, G1 ✓ (36 of 41); C10 = SUPPORT TICKET #4736982 FILED, PROBE DAILY; NEXT = the probe-gated chain (Drew: flip → E1/E2/D3 outward → wiki push), then C11, G2 (2026-09-07, written by S88, updated by S89 after the ticket + E1; SUPERSEDES the earlier blocks)
@@ -729,8 +730,9 @@ holds the old ones and stays until the probe passes). **Never `git clean -x`** (
4. **D3 outward (progress boards):** decomp.dev → log in with GitHub → `decomp.dev/manage/new` → add `Druthulu/BFM-decomp` (it reads the
`SLUS_007.26_report` artifact `progress.yml` already uploads). frogress: request slug `bfm` + an API key from the maintainers, then
`FROGRESS_API_SECRET=… .venv/bin/python tools/frogress_upload.py --push`.
5. **F3 outward (the wiki) — CAN BE DONE NOW, before the flip** (a private repo's wiki is private and flips with it): Settings → General →
Features → enable Wikis → Wiki tab → "Create the first page" (any content) → `tools/wiki_sync.sh --push` → check the sidebar links render.
5. **F3 outward (the wiki) — AFTER the flip** (free plan: GitHub offers wikis only on public repos — "Upgrade or make this repository
public to enable Wikis", seen 2026-09-07): Settings → General → Features → enable Wikis → Wiki tab → "Create the first page" (any
content) → `tools/wiki_sync.sh --push` → check the sidebar links render.
5b. **xsig discoverability (post-flip):** `gh repo edit Druthulu/xsig --add-topic decompilation --add-topic mips --add-topic playstation
--add-topic psx --add-topic psyq --add-topic dedup --add-topic reverse-engineering -h https://github.com/Druthulu/BFM-decomp`;
delete the fork `Druthulu/decomp-permuter` (`gh repo delete Druthulu/decomp-permuter --yes`; the patch stays tracked in-tree);
+4 -3
View File
@@ -10,8 +10,9 @@
# tools/wiki_sync.sh # dry run: render, refresh the clone if it exists, print `git status --short` of the sync
# tools/wiki_sync.sh --push # Drew: the same, then commit + push to <repo>.wiki.git
#
# The wiki repository (https://github.com/Druthulu/BFM-decomp.wiki.git) exists only after Wikis is ENABLED in the repo settings
# (works while the repo is still private — a private repo's wiki is private and flips with it; S89) AND
# The wiki repository (https://github.com/Druthulu/BFM-decomp.wiki.git) exists only after Wikis is ENABLED in the repo settings —
# on a free plan GitHub offers wikis only on PUBLIC repositories ("Upgrade or make this repository public to enable Wikis",
# measured 2026-09-07), so this waits for the flip (C10) — AND
# after someone creates the first page in the GitHub UI (Wiki → "Create the first page"); until then the clone fails and
# the dry run still renders and lists the pages (exit 0) while --push refuses (exit 2). A page edited on GitHub is
# overwritten by the next sync — edit docs/wiki/ instead.
@@ -33,7 +34,7 @@ n=$(ls "$RENDER"/*.md | wc -l)
if [ -d "$CLONE/.git" ]; then
git -C "$CLONE" pull -q --ff-only || { echo "wiki_sync: the wiki clone at $CLONE did not fast-forward — resolve by hand (or rm -rf it)"; exit 1; }
elif ! git clone -q "$URL" "$CLONE" 2>/dev/null; then
echo "wiki_sync: $URL is not clonable yet — the wiki exists only after Wikis is enabled in Settings (private is fine) AND after the first page is created"
echo "wiki_sync: $URL is not clonable yet — the wiki exists only after the flip (free plan: wikis need a public repo), Wikis enabled in Settings, AND the first page is created"
echo " in the GitHub UI (Wiki → Create the first page). Rendered $n pages into $RENDER:"
ls "$RENDER" | sed 's/^/ /'
[ $PUSH = 1 ] && { echo "wiki_sync: --push refused (no wiki repository)"; exit 2; }