Files
threshing-atlas/core
ekcSchianoandClaude Opus 5.5 46c1f00150
CI / test (pull_request) Successful in 41s
Impossible runs: one definition, left out of the route model and the site statistics (#21, #22)
- core/spec/form.yaml impossible_flags: the flags that mean a run cannot have happened as recorded (a dragon an
  encounter does not have, a Green or the Black in the valley, two bonds, two burns, a cadet path that does not
  follow, an early death that still reached the hour...). atlas.runs.impossible() reads it.
- The route model and the site statistics (and the riders' paths) leave those runs out, from every source; every
  other run is used, however partial. The runs stay in runs_clean.csv, flagged. 80 runs: 75 form, 5 Reddit.
  Route-model odds move by at most 0.2 points.
- collection/etl/runs.py: the community form gets the same game-rule checks as "Report a run" and the Reddit
  comments (10 form rows newly flagged); new rule: the Black in the valley.
- The first-sighting pool stays a flag only: it is what riders have seen, not a rule.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UCzTd31GphpMXDhQqWrCMQ
2026-11-19 16:03:45 +00:00
..

core

The shared model. Every other part uses it, so run npm test after any change.

The rules and the game are declarative files in spec/; the Python package atlas/ reads them. JavaScript is used only where it has to run in a browser or in Ken's bot.

File What it does
spec/form.yaml Every question of the community form (how to find it in an export) and every answer (what it is coded as), the answers that count as missing, email redaction, when "left your squadmates" was first asked.
spec/game.yaml The game: every decision and its options in order, every roll and what its odds may depend on, every bonding encounter, the flow of a run from the entrance to the dragons, how form answers map onto it, and the text the bot sees for each option.
atlas/coding.py Codes every form row into a run (python -m atlas.coding). Rule tests: tests/core/test_coding.py.
atlas/model.py, atlas/solver.py The route model: what each coded run reveals about each step, the count tables and shrinkage, the posterior draws, and one interpreter of game.yaml used to solve, evaluate and export the best routes (planner/build_policy.py). Tests: tests/core/test_solver.py, test_game.py.
solver.js JavaScript, for the site and the bot. The route advisor: reads the game and the count tables from data/policy.json and re-solves from any point in a run. tests/core/advisor.test.js checks it gives exactly the Python model's values and choices.
graph.js JavaScript, for the bot. Turns the bot's on-screen choices into form answers, and builds the route graph (analysis/network/build-graph.js). Moves to Python with the collection review.

The site and Ken's bot load the published copies (https://ekcschiano.github.io/threshing-atlas/solver.js, graph.js, data/policy.json), so those names on the site must not change.

To support a new form answer, add it to spec/form.yaml. To change a rule, edit atlas/coding.py and add a test case. To add a choice to the game, add it to spec/game.yaml (and, if the form records it, to atlas/model.py).