philihp / kennerspiel / 26010439109

96%

push

github

feat(game): add encode() for ML-friendly state representation (#1704)

* feat(game): add encode() for ML-friendly state representation

Adds a flat Float32Array encoder for GameState intended as input to a
heuristic value/policy network for MCTS guidance. Encodes per-player
tableaus (with perspective rotation so the active player is always
slot 0), a multi-channel H×W landscape grid, frame, rondel deltas, and
shared state. Exposes featureSpec so training code can index into the
vector reliably as new enum members are appended.

https://claude.ai/code/session_012g8vWmxD3NfWGedLs6YqpK

* chore(game): clean up unnecessary type assertions flagged by typescript-eslint 8.59

Drive-by: eslint --fix on the 27 no-unnecessary-type-assertion errors
that landed with the typescript-eslint bump in #1702. No behavior change;
all 1323 tests still pass.

https://claude.ai/code/session_012g8vWmxD3NfWGedLs6YqpK

* test(game): cover settlement-tile and unplaced-laybrother paths in encode

Raises encode.ts statement coverage from 96% to 99% by adding two tests
flagged as uncovered patches by Coveralls.

https://claude.ai/code/session_012g8vWmxD3NfWGedLs6YqpK

* fix(game): anchor encode landscape grid by landscapeOffset

The previous encoding wrote landscape[r] straight into output row r,
but r is a raw array index that shifts as players buy districts/plots
above their starting board. Two semantically identical boards could
land in different rows of the tensor, forcing the model to learn an
unnecessary symmetry.

Now: each cell is written to output row (raw_row - landscapeOffset)
+ gridAnchor, so a player's logical row 0 always sits at the same
output row. H is enlarged to 38 with ANCHOR = 18 to cover up to 9
districts + 9 plots (each 2 rows tall) in either direction. The
landscapeOffset scalar is dropped since the anchored grid encodes
the same information implicitly. featureSpec gains a gridAnchor field
so consumers know where logical 0 lives.

https://claude.ai/code/ses... (continued)

1308 of 1499 branches covered (87.26%)

Branch coverage included in aggregate %.

93 of 94 new or added lines in 2 files covered. (98.94%)

3498 of 3499 relevant lines covered (99.97%)

611.31 hits per line