Supported system lists documentation mistakes?

[Proletar666]

GitHub front-page mistakenly list Apple II support with the Atari800 core in the list of supported systems:

https://github.com/provenance-emu/provenance

Expected:

Correct description of supported systems

Actual:

Noticed a wrong piece of info, the Atari800 core isn't for Apple II.

Actually, Apple II's support isn't even mentioned on the Wiki at all: https://wiki.provenance-emu.com/platforms-and-performance/supported-systems

Nor is it mentioned on the app's page in Apple's App Store:

https://apps.apple.com/us/app/provenance-app/id1596862805

Another problem is, App Store lists Atari's 8-bit computer as supported when the Wiki and GitHub only list Atari ST (which is a 16-bit system), and I don't see Atari's 8-bit systems like 400, 800, XE or others mentioned there.

Reproduce:

Open links and compare

NOTES

Actually, the experimental cores maybe should be omitted and not mentioned at all on the App Store page (especially considering that the PS2 core literally requires jit, so sideloading is the only option in the 1st place), but the lists must be consistent otherwise to avoid confusion between users.

APP VERSION

Irrelevant, it's about documentation mistakes, not the app itself

APP SOURCE

Irrelevant

INSTALLED BY

Irrelevant

PLATFORM

Irrelevant

iOS/tvOS VERSION

Irrelevant

---

^{🚫 We DO NOT support unofficial builds installed from 3rd-party sites. (Official Install)
❓ Need help or have a suggestion? Join our Official Discord}

[JoeMatt]

Thanks, looks like some of those are auto-generated mistakes, and others just need to clarify that they're completely off on App Store (AppleII), or require "unsupported cores" option.

PS2 is one of those outliers, where technically it's in the app store relesae, but it would only work on jailbroken or older OSes that can JIT app store installs rather than sideloads only.

---

@claude can you take a look at this,

for the wiki and website not sure if @claude has access to all those repos to fix the issues and fix the generation scripts, if not, Cladue please leave instructions for my local agent to correct the publishing of Core info and the automation scripts

[github-actions]

✅ PR Opened — Awaiting AI Review

Completed

• 🚀 Agent started
• 📖 Audited systems.plist / Core.plist / SystemIdentifier.swift against README and the wiki's auto-generated page
• 🔨 Fixed README.md (Apple II core attribution, missing Atari 8-bit row, Sony/Atari counts, PS2 note)
• 🔨 Fixed 9 stale PVSupported=false flags in systems.plist that were feeding wrong data into the wiki's sync script
• 📤 Opened PR #3674, auto-merge (squash) enabled
• 💬 Posted findings + concrete follow-up instructions for the wiki repo (and website repo, unlocated) as a comment on this issue

Not in scope for this agent

• Provenance-Emu/wiki repo — read-only access only, no push. Instructions left for local agent.
• Website repo — could not be located automatically.
• App Store Connect listing copy — manual edit outside any repo.

Completed: 2026-08-22 03:12 UTC

[github-actions]

What I found & fixed

Opened #3674 against develop with the fixes I could make directly in this repo:

• Apple II core was wrong. README credited it to Atari800; it's actually served by MAME (CoresRetro/RetroArch/PVRetroArch/Core.plist, the mame.libretro.framework entry). Fixed, and flagged ⚠️ since PVAppStoreDisabled=true on that system means it's hard-hidden from the App Store build (confirmed in PVLibrary/Sources/PVRealm/RealmPlatform/Entities/PVSystem.swift — the App Store gate never gets overridden by the "Unsupported Cores" setting for App-Store-disabled systems, only for disabled cores).
• Atari 8-bit (400/800/XL/XE) was missing from the README entirely, even though com.provenance.atari8bit ships via the Atari800 core (same Core.plist also lists com.provenance.5200) — this is what the App Store page was showing that GitHub/wiki weren't. Added the row.
• Section header counts were wrong — "Sony — 2 systems" undercounted its own 3-row table (PS1/PS2/PSP); Atari is now 7 after the new row.
• PS2 note expanded per your clarification: ships in the App Store binary, only runs with JIT (jailbroken devices or older OS versions that still allow JIT for App Store installs); sideloaded/AltStore builds get JIT another way.

Root cause of the "auto-generated mistakes"

The Provenance-Emu/wiki repo's scripts/sync-from-source.py regenerates info/system-reference.md (the "System Reference (Auto-Generated)" wiki page) by reading PVSupported and PVAppStoreDisabled out of this repo's systems.plist. PVAppStoreDisabled is legit — the app itself reads it to gate the App Store build. But PVSupported is dead weight in this app — SystemPlistEntry (PVPlists/Sources/PVPlists/Systems_plist/SystemPlistEntry.swift) doesn't even declare a field for it, so nothing in Swift ever reads it. It only affects the wiki generator, which used it to decide whether a system shows in the main table or gets demoted to "Systems in Development / Disabled."

Nine systems had PVSupported=false despite shipping with a working core and being listed as supported in this README: PSP, GameCube, Dreamcast, DS, 3DS, Atari ST, DOS, MSX, MSX2. That's fixed in #3674 too — flipped to true. Zero effect on the app (dead key at runtime), but it'll stop the wiki from misreporting these as "in development" on its next sync.

I deliberately did not touch the remaining PVSupported=false / PVAppStoreDisabled=true entries that aren't corroborated by anything in this README, since I can't verify their real-world status myself: Macintosh, CD-i, PalmOS, Wolfenstein 3D, Quake, Quake II, C64, TIC-80, NAOMI, NAOMI2, Atomiswave. Those need your call, not a guess from me.

For your local agent — wiki repo (Provenance-Emu/wiki)

I don't have push access there (confirmed via the API — public repo, read-only for this token), so I could only read it. Here's exactly what's left:

1. Re-run the sync once [Agent] Fix supported-systems documentation mistakes (Apple II core, Atari 8-bit, stale plist flags) #3674 merges to develop. The wiki's sync-from-source.yml supports manual dispatch:

   gh workflow run sync-from-source.yml --repo Provenance-Emu/wiki -f branch=develop
   

   It opens a PR (not auto-merged) with a review checklist — Apple II should now show up correctly categorized as "App Store disabled," Atari 8-bit will appear, and the nine previously-misflagged systems will move into the main table.

2. info/supported-systems.md (the hand-maintained page, separate from the auto-generated one) is quite stale and is where the reporter noticed Apple II is missing entirely — worth a full pass, not just an Apple II add:

   • Missing rows entirely: Apple II, Atari 8-bit, MSX/MSX2, C64, DOS, CD-i, PalmOS, GameCube/Wii.
   • Outdated core names: Dreamcast still says "Reicast" (it's Flycast now), 3DS still says "Citra" (now emuThreeDS/Azahar per this repo's README).
   • It duplicates what info/system-reference.md now does automatically and correctly — worth considering just redirecting/trimming this page to point at the auto-generated one instead of hand-maintaining two lists that drift apart (this is exactly how the Apple II/Atari-8-bit gap happened).

3. App Store Connect listing copy (Apple's own metadata, not in any repo I could find) — if it still overstates Apple II or omits Atari 8-bit, that's a manual edit in App Store Connect, not something a repo sync can fix.

4. Website repo — I searched for it under a few likely names (website, provenance-emu.com, www) and came up empty; I don't guess repo URLs I'm not given. If provenance-emu.com's system list is sourced from a repo, point your local agent at it directly and it can likely reuse the same systems.plist parsing approach as scripts/sync-from-source.py in the wiki repo.

PR: #3674