wordle-five: the engine, the reward, the solver and the probe that checks them

The Python is the source of truth; src/demos/wordle/engine.ts will be a port of
it, and CI gates the two against a SHA-256 over all 21.2M (guess, answer)
pattern pairs rather than a hand-picked vector file — a vector file only ever
catches the cases somebody thought of.

The reward is three weighted components, and the third one is the reason this
demo is worth building. `solved` and `economy` pull toward winning. `consistency`
pulls against them, because a player maximising information deliberately guesses
words that cannot win — a word that splits the remaining candidates evenly
teaches more than a word that might happen to be right. That is good play, and
it costs consistency.

The probe ladder proves the tension is real rather than asserted:

  inaction        0.0000   crude       0.0111   plausible  0.1224
  candidate_only  0.8925   exhaustive  0.9031   oracle     0.9458

The two good policies are 0.05 apart and neither dominates — the entropy oracle
takes 1.00 economy and 0.73 consistency, the candidate-only player takes 0.75
and 1.00. Which one wins is a decision about what you want, which is the whole
argument the site exists to make. probe.py fails CI if either starts dominating.

Two traps found by building it. `consistency` is scored over turns SPENT, not
guesses accepted: counting only legal guesses hands a free 1.0 to a policy that
plays one word and then jams the parser five times — one guess, no
contradictions, perfect score. And `economy`'s denominator is the depth the
SHIPPED solver reaches, not a depth-optimal search: entropy-greedy is not
depth-optimal, so grading it against an exact optimum would make the oracle
rung fail its own assertion on some seeds.

The word lists are built from Wordnik (MIT) intersected with SCOWL, never from
the original game's 2,315 answers. 4,603 answers makes this materially harder
than the original, so the published SALET/3.4212 results are cited as belonging
to that list and our own reference player's TARES/3.72 is measured here.

verifiers is an optional extra. The engine, reward, solver and probe all run —
and gate — without an RL stack resolvable.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019mt6sHQHEnEYrJZvoMCJSB

NOTICE

@@ -0,0 +1,55 @@
+PIG-Demo
+Copyright 2026 Karti Tripathi
+
+This product includes software and data developed by third parties, listed
+below with their licences. Full licence texts are linked; where a licence
+requires a copy to be distributed, it is included in this repository.
+
+--------------------------------------------------------------------------------
+shadcn/ui — MIT
+https://github.com/shadcn-ui/ui
+The components under src/components/ui/ are derived from shadcn/ui's registry
+and adapted by hand. navigation-menu.tsx is a substantial rewrite: the upstream
+version targets Tailwind 4 and this project is on Tailwind 3.4.
+
+Radix UI — MIT
+https://github.com/radix-ui/primitives
+The unstyled primitives those components are built on.
+
+--------------------------------------------------------------------------------
+Wordnik word list — MIT
+https://github.com/wordnik/wordlist
+Snapshot wordlist-20210729.txt. Source of envs/wordle_five/words/guesses.json.
+
+SCOWL (Spell Checker Oriented Word Lists) — permissive, attribution required
+http://wordlist.aspell.net/
+Copyright 2000-2020 Kevin Atkinson. The `wamerican` list is used, in
+intersection with the above, to derive envs/wordle_five/words/answers.json.
+See envs/wordle_five/words/PROVENANCE.md for exactly how.
+
+--------------------------------------------------------------------------------
+Manrope — SIL Open Font License 1.1
+https://github.com/sharanda/manrope
+Copyright 2019 The Manrope Project Authors. Licence text: public/fonts/OFL.txt
+"Manrope" is a Reserved Font Name under that licence: a modified version of the
+font may not be distributed under that name.
+
+Lucide — ISC
+https://github.com/lucide-icons/lucide
+Icons, themselves derived from Feather (MIT, copyright 2013-2017 Cole Bemis).
+
+Recharts — MIT
+https://github.com/recharts/recharts
+
+--------------------------------------------------------------------------------
+PIG (Prime Intellect Growth) — Apache-2.0
+https://github.com/karti-ai/PIG-Demo is a sibling of that project. The design
+token layer in src/index.css and the palette in tailwind.config.js are derived
+from it. Same author; the notice is here because this repository is public and
+Apache-2.0 section 4(d) asks for it either way.
+
+--------------------------------------------------------------------------------
+Not affiliated with, endorsed by, or derived from the code or assets of The New
+York Times Company or its games. "wordle-five" is an independent implementation
+of the well-known five-letter word-guessing format, with its own word lists,
+its own palette, and its own reward.