Skip to content

Latest commit

 

History

History
34 lines (30 loc) · 2.58 KB

ARCHITECTURE.md

File metadata and controls

34 lines (30 loc) · 2.58 KB

Architecture

The native executable owns rules, legal moves, search, notation and neural inference. Python handles original selfplay orchestration, training, matches and independent artifact verification. TypeScript owns the loopback analysis service and browser board. The native core runs without Python, network access, tablebases or another engine.

Boundary Source Contract
Geometry src/attacks.cpp a1=0 bitboards, generated rays, nearest blockers
Position src/position.cpp, src/movegen.cpp owned state, rook-origin rights, exact undo
Rules src/rules.cpp mate precedence, claims distinct from automatic termination
Notation src/notation.cpp bounded SAN/PGN, explicit variation parentage
Evaluation src/evaluation.cpp, src/network.cpp side-to-move cp, mate range reserved
Search src/search.cpp, src/table.cpp worker-local heuristics, locked table, shared root alpha
Protocol src/uci.cpp one search owner, bounded input, joined teardown
Learning training/ original labels, lineage splits, transactional checkpoints
Strength arena/ paired colors, all failures retained, opening-cluster uncertainty
Verification verification/ trusted source, independent inference/replay/statistics
Analysis analysis-service/, web/ request generations, budgets, cancellation and backpressure

Editable diagrams and rendered SVGs: