Release the roach ecology to PyPI as 0.2.0

[martymcenroe]

Problem

PyPI has silphe 0.1.0, uploaded 2026-06-11. Fifteen commits have landed on main since, and none of it is installable:

• The whole Andvari roach ecology — structured maze (Structured/fractal maze for the Andvari round (corridors, crevices, dead-end hideouts) #43), a brood with target switching (Multiple roaches in the Andvari round (target selection + switching) #44), bait and feeding (Bait/feeding: lure the roach off its evasion pattern #45), tunnels and re-acquisition (Tunneling: roach drops into a tunnel and re-emerges elsewhere (re-acquisition) #46), poison, the cannibalism domino and the gecko (Poison bait + cannibalism sickening (Advion domino), and a gecko predator #47).
• The capture kernel extraction and the frozen recording schema (Extract the capture kernel into an importable, versioned core #48, Freeze and version the recording schema with a compatibility guarantee #49).
• Arcade scoring and a leaderboard, in-game player switching, the difficulty menu and score multiplier, initials entry and personal bests, ska sound, and exe build artifacts.

Anyone who installs silphe today gets a flat random field and a single roach.

Steps, in order

1. Playtest gate — the operator plays it and critiques it, and every comment is addressed and merged before anything below starts.

Nothing has been played. All of the above is verified by tests, which prove the logic holds and say nothing about whether the round is any good. #59 already lists the two things known to need a human at the controls — round length, now roughly 21 landed hits to clear a hard round against 6-8 before, and whether a screen carrying a maze, silver hide-holes, dark tunnel mouths, gold and purple crumbs, corpses and a cyan gecko is readable at a glance. Anything else the playtest turns up gets filed and fixed too. This step is the gate, not a formality.

2. Bump to 0.2.0 in both pyproject.toml and src/silphe/__init__.py — see #60, which adds the guard that makes a half-done bump fail loudly.

3. Write the 0.2.0 entry in CHANGELOG.md, which currently stops at 0.1.0.

4. Build and upload following docs/0004-pypi-publish.md — being brought up to date under #61, because its current upload command would fail on a second release.

5. Verify: pip install silphe==0.2.0 into a throwaway environment, then silphe-play opens onto the maze with a brood in it.

6. Tag v0.2.0 and push it.

Why 0.2.0

New features, all backward compatible — no entry point changed, no public function was removed, and the recording schema stayed at SCHEMA_VERSION = 1 throughout because every field added was additive. Under semver on a 0.x line that is a minor bump. A patch release would misrepresent the size of the change.

Notes

• Tag-push publishing via OIDC is still not available; release.yml is not on origin (Land release.yml (OIDC release workflow) via classic-PAT — normal push blocked by PAT workflow scope #6). This release is a manual twine upload, and switching to the automated path is that issue's job, not this one's.
• PyPI never permits re-uploading a version, so step 2 is mandatory rather than cosmetic.
• The exe on the GitHub Release is a separate distribution channel and is not part of this issue; it is stale too, which is Build the game as a standalone Windows .exe (PyInstaller) #16's territory.