Trim CLAUDE.md back under the 150k limit (#319)

* Trim CLAUDE.md back under the 150k limit

Claude Code was refusing to load the whole file: 179,094 chars against a
150,000 limit. It is 131,561 now, a 27% cut, with ~18k of headroom.

Nothing was dropped. The two longest sections were snapshotted verbatim into
docs/ and rewritten in place as live rules plus a pointer:

- docs/rust-wasm-port-history.md - the Rust/WASM port's measurement record.
  That section was 77,578 chars, 43% of the file on its own, and most of its
  length was the story of how a count moved rather than a rule anyone needs at
  the keyboard: the superseded before-and-after tables from #269/#290/#293, the
  twelve rejected sweep candidates from #273, and the per-phase landing lists.
- docs/ci-sharding-measurements.md - every CI timing behind the four-shard
  layout: the N=3 through N=6 comparison, the per-run tables from #202, #203,
  #207 and #208, and the three reasons splitting a heavy spec file was rejected.

Every trap stays in CLAUDE.md: the capture-grid snap, the poison-hook doctrine,
the three engine.wasm diff fingerprints, aux.rs on Windows, f64::max against
Math.max, the exchange-format drift, pnpm's minimumReleaseAge reasoning, and the
ruleset hazard around the verify job's name.

Three things were corrected while rewriting rather than carried over:

- The Rust heading said "phases 1-4 landed, phase 5 in progress". Phase 5 is
  complete and phase 6 is half done.
- The CI job table costed `rust` at 19s. It has been 1m45s-2m50s since #225's
  cliff half landed, and it is a range because a single run measures the runner.
- The `maxUnknown: 0` note had drifted into the Rust section. It is fixture
  provenance, so it moved to that section.

Flesch-Kincaid on the rewritten prose is 8.3, down from 9.0. `pnpm vp check`
passes on 436 files.

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

* Point the oracle sections at the oracle repo instead of restating it

The two factorio-oracle sections were 13,061 chars and most of that restated
things ~/GitHub/factorio-oracle now documents itself: every `refs` subcommand
(its README), the `oracle-dump.json` name contract and `error("DUMPED-OK")`
exiting non-zero as success (docs/gotchas.md), the binary shipping unstripped
(docs/order-of-attack.md), and how to write a probe (README again).

They are 6,893 chars now and name those four documents with full
`~/GitHub/factorio-oracle/` paths, so a bare `docs/gotchas.md` cannot be
mistaken for a file in this repo. docs/factorio-reference-and-oracle.md carries
the verbatim long form, including the full WSL capture recipe.

What stayed is what the oracle repo does not know about this one:

- Which API-docs entry points this app's codec depends on, and that the JSON
  dumps are NOT a superset of the HTML - `control:temperature:frequency` is in
  noise-expressions.html and nowhere in runtime-api.json.
- The map-gen Lua files the preview ports, the `name = "<expression>"` grep, and
  the starting_patches 2.0.77 -> 2.1.9 skew that produces a port which passes
  its own tests and disagrees with the game.
- `pnpm refs:sync` pinning nothing, and why it is not in `verify`.
- The "new probes only" rule for test/oracle/, and the two worked probes in
  scripts/probes/.
- That the installed binary is the authority on which version is meant, and
  Steam moves it.

CLAUDE.md is 126,713 chars now, down from 179,094 - a 29% cut with 23k of
headroom under the 150k limit. Flesch-Kincaid on the rewritten prose is 8.2.
`pnpm vp check` passes on 436 files.

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

* Ask the binary for CLI options, not the wiki

`factorio --help` prints every option and ships with the game, so it describes
the version you actually have. It is also ahead of the wiki: it documents
`--map-preview-planet`, `--map-gen-seed-max` and `--exchange-string`, and it
states outright that `--map-gen-seed` "will override seed specified in map gen
settings" - the trap #232 hit, answered by the tool itself.

The wiki page stays named as a fallback for prose the help text does not carry.
The docs snapshot is verbatim, so it keeps the old wording and its header now
flags that one line as superseded.

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

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: wormeyman