How callmepeterd/chess-ia works
chess-ia is a chess-playing AI exposed as a polling worker: it fetches a FEN job, parses the position, searches for a legal move, and submits the UCI move and evaluation. The engine also supports a standalone FEN-to-move harness, perft validation, and an optional PolyGlot opening book; the README documents a mock backend for local play. The rules package is represented as one engine subsystem rather than a file-by-file map. Worker-client internals and mock handlers were not excerpted, so their documented relationships are shown with README evidence.
Main entry points: search.go Minimax search · harness/main.go FEN harness · worker/main.go Worker CLI · worker.go Polling client
Components 13
Interfaces
- Worker CLI
cmd/worker/main.go - FEN harness
harness/main.go - Mock server CLI
cmd/mockbackend/main.go
Chess engine
- Rules engine
rules - Position evaluation
eval/eval.go - Minimax search
search/search.go - Transposition table
search/tt.go
Opening book
- PolyGlot book
book
Worker flow
- Polling client
worker/worker.go - Job solver
worker/solver.go
Mock backend
- Mock endpoints
mock/mock.go
Other components
- Operator
- Backend API
Connections 21
- Operator → Worker CLI: starts worker
README.md - Worker CLI → PolyGlot book: loads optional book
cmd/worker/main.go - Worker CLI → Minimax search: sets book
cmd/worker/main.go - Worker CLI → Polling client: starts polling
cmd/worker/main.go - Polling client → Backend API: polls and submits
README.md - Polling client → Job solver: solves jobs
README.md - Job solver → Rules engine: parses FEN
worker/solver.go - Job solver → Minimax search: runs search
worker/solver.go - Minimax search → Rules engine: generates and applies moves
search/search.go - Minimax search → Position evaluation: evaluates positions
search/search.go - Minimax search → Transposition table: probes and stores
search/search.go - Minimax search → PolyGlot book: checks opening book
search/search.go - Operator → FEN harness: runs analysis
README.md - FEN harness → Rules engine: parses FEN and perft
harness/main.go - FEN harness → Position evaluation: evaluates position
harness/main.go - FEN harness → Minimax search: requests move
harness/main.go - FEN harness → PolyGlot book: loads optional book
harness/main.go - Operator → Mock server CLI: starts mock
README.md - Mock server CLI → Mock endpoints: serves endpoints
cmd/mockbackend/main.go - Mock server CLI → Rules engine: builds selfplay positions
cmd/mockbackend/main.go - Mock endpoints → Polling client: simulates backend contract
README.md