nx_folkgame_lib.nx

nx_folkgame_lib.nx -- THE LUDEME SUBSTRATE: one shared board-game core that reads a game as DATA and plays it, so a new folk game is a SPEC and never a new organ. Named for the ludeme -- Browne's unit of game rule -- because the deliverable is the VOCABULARY, not the game list: the 117 rows of knowledge/compare/folkgames.registry exist to prove the vocabulary spans real human game design well enough that novel games can later be SEARCHED out of it (the Ludi/Yavalath result). A game that needs a new organ is a hole in the vocabulary and must be reported as one. NO CAPS, BY CONSTRUCTION. Every array here is sized from the spec itself in a MEASURE pass and filled in a SECOND pass, so there is no FG_MAX_CELLS to guess and none to raise later. This is the estate law that a ceiling which has to be guessed is a defect generator in both directions: too small truncates in silence, too large wastes memory, and raising it only moves the guess. THE SPEC (rows, pipe-delimited, '#' comments). Every key is OPTIONAL except cells and linelen; an unknown key is REFUSED BY NAME rather than ignored, because a silently-dropped rule is a game that plays wrongly while looking parsed. name|<slug>|<Title> family|align cells|<n> board size. REQUIRED. linelen|<n> how many in a row makes a line. REQUIRED. hand|<n> pieces each side places before movement. ABSENT = place until full. win|line forming a line wins outright (Tic-Tac-Toe, Gomoku) win|reduce|<n> reducing the opponent below <n> pieces wins (the Morris family) capture|onmill completing a line removes one enemy piece move|adj after hands are empty, step to an ADJACENT empty cell fly|<n> at or below <n> pieces a side may move to ANY empty cell lines|grid|<w>|<h>|<len> GENERATE every line on a w x h grid -- the generator, not 572 rows line|a,b,c[,...] one explicit line (the Morris boards, which are not grids) adj|grid|<w>|<h>|<mode> GENERATE grid adjacency. mode 0 orthogonal, 1 diagonal, 2 both adj|<cell>|<n1,n2,...> one explicit adjacency row xy|<cell>|<x>|<y> explicit draw position for a non-grid board license_tier: ORIGINAL No hw writes (Rule 26). Sovereign syscalls only, integer only, no float.