<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>CIG2</title><link>https://docs.grylls.uk/</link><description>Recent content on CIG2</description><generator>Hugo</generator><language>en-gb</language><atom:link href="https://docs.grylls.uk/index.xml" rel="self" type="application/rss+xml"/><item><title>Overview</title><link>https://docs.grylls.uk/framework/overview/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/overview/</guid><description>&lt;h1 id="cig2-for-agents-start-here"&gt;CIG2 for agents: start here&lt;a class="anchor" href="#cig2-for-agents-start-here" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;CIG2 is a Go framework for real-time multiplayer card games. You write the rules; the framework owns:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;concurrency&lt;/li&gt;&#10;&lt;li&gt;hidden information&lt;/li&gt;&#10;&lt;li&gt;networking&lt;/li&gt;&#10;&lt;li&gt;persistence&lt;/li&gt;&#10;&lt;li&gt;testing harnesses&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;This guide is version-matched: &lt;code&gt;cig context&lt;/code&gt; prints the guidance of the CIG2 version your game&amp;rsquo;s &lt;code&gt;go.mod&lt;/code&gt; requires. Trust it over anything you remember from another version.&lt;/p&gt;&#10;&lt;h2 id="the-model-in-one-screen"&gt;The model in one screen&lt;a class="anchor" href="#the-model-in-one-screen" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;A game&lt;/strong&gt; implements &lt;code&gt;cig2.Game&lt;/code&gt;: &lt;code&gt;Setup&lt;/code&gt;, &lt;code&gt;HandleAction&lt;/code&gt;, &lt;code&gt;CheckEnd&lt;/code&gt;. It is registered once, &lt;code&gt;cig2.RegisterGame(name, &amp;amp;Game{})&lt;/code&gt; in &lt;code&gt;init()&lt;/code&gt;, and shared by every table. So it holds &lt;strong&gt;no fields&lt;/strong&gt;; all per-table state lives in &lt;code&gt;s.SetState&lt;/code&gt; / &lt;code&gt;s.SetPlayerState&lt;/code&gt;.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;A session&lt;/strong&gt; is one table. Exactly one goroutine (the actor) runs every game callback. Never start goroutines in game code, and never lock: there is nothing to race with.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;The board&lt;/strong&gt; is a tree of zones (&lt;code&gt;s.NewDeck&lt;/code&gt;, &lt;code&gt;NewHand&lt;/code&gt;, &lt;code&gt;NewPile&lt;/code&gt;, &lt;code&gt;NewDisplay&lt;/code&gt;, &lt;code&gt;NewGroup&lt;/code&gt;). Every zone has a visibility mode, which decides what each seat sees. &lt;code&gt;Card.Reveal()&lt;/code&gt; is sticky and one-way. See &lt;code&gt;cig context hidden-info&lt;/code&gt;.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;Every step is atomic.&lt;/strong&gt; Validate everything, then mutate. Return an error only before the first change (strict rejection checking enforces this).&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;Snapshots are full, never diffs.&lt;/strong&gt; After every step each seat gets its whole filtered view.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;strong&gt;Deterministic by construction:&lt;/strong&gt;&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;read time with &lt;code&gt;s.Now()&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;randomness from &lt;code&gt;s.Rand()&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;delay with &lt;code&gt;s.Schedule&lt;/code&gt; / &lt;code&gt;s.Rearm&lt;/code&gt;&lt;/li&gt;&#10;&lt;li&gt;ask a seat with &lt;code&gt;s.Ask&lt;/code&gt;&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;That is what lets tables be journaled, replayed and restored after a restart.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ul&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/getting-started-snap/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/getting-started-snap/</guid><description>&lt;h1 id="getting-started-implementing-snap"&gt;Getting started: implementing Snap&lt;a class="anchor" href="#getting-started-implementing-snap" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;This walks through building &lt;strong&gt;Snap&lt;/strong&gt; as a second CIG2 game, using only the&#10;framework as it exists today (&lt;code&gt;.claude/SPEC.md&lt;/code&gt;, and everything under the&#10;repo root). Nothing here requires touching framework code — that&amp;rsquo;s the&#10;promise &lt;code&gt;games/highcardduel&lt;/code&gt; already proves, and this guide leans on it as&#10;the worked reference throughout.&lt;/p&gt;&#10;&lt;p&gt;Step 0 is a complete, real, tiny example — build and run it before touching&#10;Snap at all. Every step after that describes Snap&amp;rsquo;s own decisions and code&#10;in prose; it does not write Snap&amp;rsquo;s implementation for you.&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/agent-play/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/agent-play/</guid><description>&lt;h1 id="playing-a-cig2-game-from-an-automated-client"&gt;Playing a CIG2 game from an automated client&lt;a class="anchor" href="#playing-a-cig2-game-from-an-automated-client" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;This is a game-agnostic guide for a program, such as an LLM playtest agent, a&#10;bot or a load test, that plays a CIG2 game over the &lt;code&gt;host&lt;/code&gt; HTTP surface. It&#10;does not need to know the game&amp;rsquo;s rules up front. Everything it needs is in the&#10;snapshot it reads.&lt;/p&gt;&#10;&lt;p&gt;Everything here is opt-in on the server. The worked example uses&#10;&lt;code&gt;cmd/cig2-demo&lt;/code&gt;, started in agent mode:&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/api/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/api/</guid><description>&lt;h1 id="the-wire-contract"&gt;The wire contract&lt;a class="anchor" href="#the-wire-contract" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;strong&gt;Where it lives:&lt;/strong&gt;&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;contract/cig2.schema.json&lt;/code&gt; is every type a CIG2 server sends or accepts, as JSON Schema (draft 2020-12).&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;contract/openapi.json&lt;/code&gt; is the HTTP API, as OpenAPI 3.1.&lt;/li&gt;&#10;&lt;li&gt;A running server serves both at &lt;code&gt;GET /schema&lt;/code&gt; and &lt;code&gt;GET /openapi.json&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;cig context schema&lt;/code&gt; prints the schema for the CIG2 version you build against.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;strong&gt;How it is kept honest:&lt;/strong&gt;&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;It is generated from the Go types&lt;/strong&gt; the server actually marshals (&lt;code&gt;go generate ./contract&lt;/code&gt;), so it cannot drift from the code.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;CI fails if it is stale.&lt;/strong&gt;&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;CI fails on a change that breaks existing clients,&lt;/strong&gt; unless the CHANGELOG has a Migrate entry. &amp;ldquo;Breaking&amp;rdquo; means the server widening what it sends, or narrowing what it accepts.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="game-defined-fields"&gt;Game-defined fields&lt;a class="anchor" href="#game-defined-fields" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Properties marked &lt;code&gt;&amp;quot;x-cig2-game-defined&amp;quot;: true&lt;/code&gt; (card &lt;code&gt;payload&lt;/code&gt; and &lt;code&gt;state&lt;/code&gt;, &lt;code&gt;game_state&lt;/code&gt;, action &lt;code&gt;data&lt;/code&gt;, decision &lt;code&gt;prompt&lt;/code&gt;, table &lt;code&gt;config&lt;/code&gt;) are shaped by each game. &lt;code&gt;GET /describe&lt;/code&gt; returns the game&amp;rsquo;s own schemas for them, plus its rules and seat range, when the game implements &lt;code&gt;cig2.GameDescriber&lt;/code&gt;.&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/authoring/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/authoring/</guid><description>&lt;h1 id="authoring-a-game-the-shape-of-the-code"&gt;Authoring a game: the shape of the code&lt;a class="anchor" href="#authoring-a-game-the-shape-of-the-code" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;package&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;mygame&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;import&lt;/span&gt; (&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#e6db74"&gt;&amp;#34;errors&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#e6db74"&gt;&amp;#34;github.com/PipGrylls/CIG2&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;const&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Name&lt;/span&gt; = &lt;span style="color:#e6db74"&gt;&amp;#34;my-game&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;type&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;struct&lt;/span&gt;{} &lt;span style="color:#75715e"&gt;// no fields: shared by every table&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;var&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;_&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt; = (&lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;)(&lt;span style="color:#66d9ef"&gt;nil&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;var&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;_&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;ActionHinter&lt;/span&gt; = (&lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;)(&lt;span style="color:#66d9ef"&gt;nil&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;init&lt;/span&gt;() { &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;RegisterGame&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;Name&lt;/span&gt;, &lt;span style="color:#f92672"&gt;&amp;amp;&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;{}) }&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;type&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;state&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;struct&lt;/span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;Scores&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;map&lt;/span&gt;[&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;]&lt;span style="color:#66d9ef"&gt;int&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; (&lt;span style="color:#a6e22e"&gt;g&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;) &lt;span style="color:#a6e22e"&gt;Setup&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Session&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;players&lt;/span&gt; []&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;config&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;any&lt;/span&gt;) &lt;span style="color:#66d9ef"&gt;error&lt;/span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;deck&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;NewDeck&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;deck&amp;#34;&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Hidden&lt;/span&gt;())&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Root&lt;/span&gt;().&lt;span style="color:#a6e22e"&gt;AddChild&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;deck&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#75715e"&gt;// … add cards with s.NewCard(&amp;amp;Card{…}), deck.Shuffle(s.Rand()) …&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;SetState&lt;/span&gt;(&lt;span style="color:#f92672"&gt;&amp;amp;&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;state&lt;/span&gt;{&lt;span style="color:#a6e22e"&gt;Scores&lt;/span&gt;: &lt;span style="color:#66d9ef"&gt;map&lt;/span&gt;[&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;]&lt;span style="color:#66d9ef"&gt;int&lt;/span&gt;{}})&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;SetTurn&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;NewTurnTracker&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;players&lt;/span&gt;))&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;nil&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; (&lt;span style="color:#a6e22e"&gt;g&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;) &lt;span style="color:#a6e22e"&gt;HandleAction&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Session&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;p&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;a&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Action&lt;/span&gt;) &lt;span style="color:#66d9ef"&gt;error&lt;/span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;st&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;MustStateOf&lt;/span&gt;[&lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;state&lt;/span&gt;](&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;switch&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;a&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Name&lt;/span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;case&lt;/span&gt; &lt;span style="color:#e6db74"&gt;&amp;#34;play&amp;#34;&lt;/span&gt;:&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#75715e"&gt;// 1. Validate everything — return errors here only.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; !&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Turn&lt;/span&gt;().&lt;span style="color:#a6e22e"&gt;IsCurrent&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;p&lt;/span&gt;) {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;errors&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;New&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;not your turn&amp;#34;&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#75715e"&gt;// 2. Then mutate. No error returns after the first change.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#a6e22e"&gt;st&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Scores&lt;/span&gt;[&lt;span style="color:#a6e22e"&gt;p&lt;/span&gt;]&lt;span style="color:#f92672"&gt;++&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Turn&lt;/span&gt;().&lt;span style="color:#a6e22e"&gt;Advance&lt;/span&gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;nil&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;errors&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;New&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;unknown action&amp;#34;&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; (&lt;span style="color:#a6e22e"&gt;g&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;) &lt;span style="color:#a6e22e"&gt;CheckEnd&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Session&lt;/span&gt;) (&lt;span style="color:#66d9ef"&gt;bool&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Result&lt;/span&gt;) {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#75715e"&gt;// Notice every way the game can end.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;false&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Result&lt;/span&gt;{}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; (&lt;span style="color:#a6e22e"&gt;g&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;Game&lt;/span&gt;) &lt;span style="color:#a6e22e"&gt;LegalActions&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;s&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Session&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;viewer&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;) []&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;ActionHint&lt;/span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#75715e"&gt;// The same predicate HandleAction validates with.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;s&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Turn&lt;/span&gt;().&lt;span style="color:#a6e22e"&gt;IsCurrent&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;viewer&lt;/span&gt;) {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; []&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;ActionHint&lt;/span&gt;{{&lt;span style="color:#a6e22e"&gt;Name&lt;/span&gt;: &lt;span style="color:#e6db74"&gt;&amp;#34;play&amp;#34;&lt;/span&gt;}}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; []&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;ActionHint&lt;/span&gt;{}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="tools-you-will-want"&gt;Tools you will want&lt;a class="anchor" href="#tools-you-will-want" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;You need&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Use&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;per-table data&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;s.SetState&lt;/code&gt;, &lt;code&gt;cig2.MustStateOf[*T]&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;per-seat secrets shown only to that seat&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;s.SetPlayerState&lt;/code&gt; + &lt;code&gt;GameState(s, viewer)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;whose turn&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cig2.NewTurnTracker&lt;/code&gt;, &lt;code&gt;s.Turn()&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;phases and rounds&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cig2.NewPhaseMachine&lt;/code&gt;, &lt;code&gt;OnEnter&lt;/code&gt;, &lt;code&gt;NeedsInput&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&amp;ldquo;after any change, check X&amp;rdquo; rules&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;s.SetSettle&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a timeout or a delayed action&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;s.Schedule&lt;/code&gt;, &lt;code&gt;s.Rearm&lt;/code&gt; (timer-only actions check &lt;code&gt;a.FromTimer()&lt;/code&gt;)&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;ask one seat to choose&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;s.Ask(cig2.Question{…})&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;collect one submission per seat&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cig2.Collector&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a zone by ID with its type&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cig2.MustFindZoneAs[*cig2.Hand](s, id)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a card by UUID&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;s.FindCard(uuid)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;config with defaults and validation&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;cig2.DecodeConfig[Config](config)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;static card tables&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;content.MustLoad[T](fsys, path)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a standard 52-card deck&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;deck52&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a server&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;host.Run(ctx, host.Config{…})&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;cig context cheatsheet&lt;/code&gt; has every signature, and &lt;code&gt;cig context patterns&lt;/code&gt; covers what not to write.&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/cheatsheet/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/cheatsheet/</guid><description>&lt;h1 id="cig2-cheatsheet"&gt;CIG2 cheatsheet&lt;a class="anchor" href="#cig2-cheatsheet" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Fast lookup for the API surface, pulled from source as of this writing.&#10;Everything here is either exported from package &lt;code&gt;cig2&lt;/code&gt;&#10;(&lt;code&gt;github.com/PipGrylls/CIG2&lt;/code&gt;) or from &lt;code&gt;github.com/PipGrylls/CIG2/web&lt;/code&gt;. For the&#10;&lt;em&gt;why&lt;/em&gt;, see &lt;code&gt;.claude/SPEC.md&lt;/code&gt;, &lt;code&gt;docs/superpowers/specs/&lt;/code&gt;, and&#10;&lt;code&gt;docs/getting-started-snap.md&lt;/code&gt;. For a worked example of every entry below,&#10;read &lt;code&gt;games/highcardduel&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Building a game? Read &lt;code&gt;docs/cig2-patterns.md&lt;/code&gt; first.&lt;/strong&gt; This page tells you&#10;what exists; that one tells you which tool solves the problem you have, and&#10;which helpers not to write because the framework already ships them.&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/errors/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/errors/</guid><description>&lt;h1 id="error-codes"&gt;Error codes&lt;a class="anchor" href="#error-codes" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Every developer-facing CIG2 error ends in a code like &lt;code&gt;[CIG2-E101]&lt;/code&gt;. Look one up with &lt;code&gt;cig context errors E101&lt;/code&gt;. The code is part of the message, so &lt;code&gt;errors.Is&lt;/code&gt; against the sentinel still works.&lt;/p&gt;&#10;&lt;h2 id="cig2-e101--journal-replay-diverged"&gt;CIG2-E101 — journal replay diverged&lt;a class="anchor" href="#cig2-e101--journal-replay-diverged" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;A replayed journal produced a different state digest from the one it recorded, at the step named in the error.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Cause:&lt;/strong&gt; one of two things.&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;The game&amp;rsquo;s rules or code changed since the journal was recorded. The error names the recorded game version.&lt;/li&gt;&#10;&lt;li&gt;The game is nondeterministic: &lt;code&gt;time.Now&lt;/code&gt;, ranging a map while drawing randomness, or state in package variables.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;strong&gt;Fix:&lt;/strong&gt;&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/hidden-info/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/hidden-info/</guid><description>&lt;h1 id="hidden-information"&gt;Hidden information&lt;a class="anchor" href="#hidden-information" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;What each seat sees is computed by &lt;code&gt;cig2.Filter&lt;/code&gt; from each zone&amp;rsquo;s visibility. The game never filters cards by hand. It can still leak through the data it writes itself, and &lt;code&gt;cig2test.Explore&lt;/code&gt; checks for that (E501, E502).&lt;/p&gt;&#10;&lt;h2 id="modes-per-viewer"&gt;Modes, per viewer&lt;a class="anchor" href="#modes-per-viewer" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Mode&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Owner sees&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Everyone else sees&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Public()&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;full cards&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;full cards&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;OwnerOnly(p)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;full cards&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;one opaque entry per card, &lt;strong&gt;with a stable UUID&lt;/strong&gt;: trackable, not identifiable&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Concealed(p)&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;full cards&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;the count only, no entries, no UUIDs&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;FaceDown()&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;one positional entry per card, no UUID&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;the same&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Hidden()&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;the count only&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;the count only&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;unset or unknown&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;the count only (fails closed)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;the count only&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;Card.Reveal()&lt;/code&gt; outranks every mode, permanently. A revealed card is shown in full everywhere.&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/inspector/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/inspector/</guid><description>&lt;h1 id="the-inspector"&gt;The inspector&lt;a class="anchor" href="#the-inspector" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;strong&gt;A privileged view of live tables:&lt;/strong&gt;&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;the full board with every hidden card&lt;/li&gt;&#10;&lt;li&gt;exactly what each seat is sent&lt;/li&gt;&#10;&lt;li&gt;pending decisions and timers&lt;/li&gt;&#10;&lt;li&gt;the journal timeline, and the board at any step (replayed into a scratch session)&lt;/li&gt;&#10;&lt;li&gt;how a failed table failed, stack and all&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;strong&gt;Running it:&lt;/strong&gt;&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;-inspector-addr 127.0.0.1:8081 -inspector-password-env INSPECTOR_PASSWORD&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;host.Config.Inspector&lt;/code&gt; does the same in Go.&lt;/li&gt;&#10;&lt;li&gt;It needs its own password, never the app password (E402).&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;Identity.InspectorAuthorize&lt;/code&gt; admits admins by identity instead.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;strong&gt;Write actions&lt;/strong&gt; (&lt;code&gt;-inspector-writes&lt;/code&gt;) are journaled with the operator&amp;rsquo;s name:&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/lobby/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/lobby/</guid><description>&lt;h1 id="identity-lobby-and-matchmaking"&gt;Identity, lobby and matchmaking&lt;a class="anchor" href="#identity-lobby-and-matchmaking" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;There are two lobbies. Pick one:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Invite links&lt;/strong&gt; (&lt;code&gt;-invites&lt;/code&gt;, below) suit a game for friends behind the app password. The host signs in and sends one-time seat links.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;The identity lobby&lt;/strong&gt; (&lt;code&gt;-lobby&lt;/code&gt;) suits accounts, matchmaking and bots. People sign in as guests or with keys, then join, ready up and queue.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="invite-links-hostserverinvites--invites"&gt;Invite links (&lt;code&gt;host.Server.Invites&lt;/code&gt;, &lt;code&gt;-invites&lt;/code&gt;)&lt;a class="anchor" href="#invite-links-hostserverinvites--invites" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Host:&lt;/strong&gt; signs in with the app password and goes to &lt;code&gt;/cig2/lobby&lt;/code&gt;; &lt;code&gt;/&lt;/code&gt; redirects there until the game serves a page. There the host starts a game, opens their own seat, and makes a link per other seat (&lt;code&gt;POST [/t/{id}]/invite?player=&lt;/code&gt;). Invite routes are &lt;code&gt;host.HostOnly&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Guest:&lt;/strong&gt; opens &lt;code&gt;…/join?invite=CODE&lt;/code&gt;. This page is public, and opening it spends nothing. &amp;ldquo;Take the seat&amp;rdquo; sends &lt;code&gt;POST …/join/redeem&lt;/code&gt;, which returns a grant cookie, the seat token stored for &lt;code&gt;SSETransport&lt;/code&gt;, and a redirect to &lt;code&gt;/?table=ID&amp;amp;player=SEAT&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Seat reservation:&lt;/strong&gt; a link reserves its seat. A link for a seat that is already taken is a recovery link: it moves the seat to the new browser.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Code:&lt;/strong&gt; &lt;code&gt;Table.Invite/Redeem/RevokeInvite/InviteFor/SeatInfo/ReissueSeat&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Guests are not hosts:&lt;/strong&gt; a grant passes the gate, but &lt;code&gt;host.IsHost(r)&lt;/code&gt; is false. Wrap your own lobby routes in &lt;code&gt;host.HostOnly&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Board page:&lt;/strong&gt; &lt;code&gt;tablePaths()&lt;/code&gt; from &lt;code&gt;/cig2/invite.js&lt;/code&gt; gives the table&amp;rsquo;s endpoints, and &lt;code&gt;&amp;lt;cig2-invite table=…&amp;gt;&lt;/code&gt; is the host&amp;rsquo;s panel.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="identity-hostidentity"&gt;Identity (&lt;code&gt;host.Identity&lt;/code&gt;)&lt;a class="anchor" href="#identity-hostidentity" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Principals are people or agents, with roles player, host and admin. They come from:&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/patterns/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/patterns/</guid><description>&lt;h1 id="cig2-patterns"&gt;CIG2 Patterns&lt;a class="anchor" href="#cig2-patterns" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Recipes for the things games keep needing. Written for an agent or author&#10;building a game on CIG2 who is about to write a helper the framework already&#10;ships.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;The code here is indicative, not runnable.&lt;/strong&gt; Signatures are real; bodies are&#10;often elided. For the exact surface see &lt;code&gt;docs/cig2-cheatsheet.md&lt;/code&gt; or &lt;code&gt;go doc&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;This document exists because reinvention has actually happened, repeatedly, and&#10;was only caught later by a ledger:&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/persistence/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/persistence/</guid><description>&lt;h1 id="persistence-journals-replay-restore"&gt;Persistence: journals, replay, restore&lt;a class="anchor" href="#persistence-journals-replay-restore" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;&lt;strong&gt;CIG2 never saves session state; it journals inputs.&lt;/strong&gt; Every step&amp;rsquo;s input (an action, a decision answer, a timer delivery, a decision expiry, an admin operation) is appended to the session&amp;rsquo;s journal before the step is broadcast. Each record carries the state digest after the step.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Restoring a table replays its journal&lt;/strong&gt; through the real step functions (&lt;code&gt;cig2.WithReplay&lt;/code&gt;). Closures (&lt;code&gt;OnResolve&lt;/code&gt;, phase hooks, settle steps) come back without any game code, and the digest is checked at every step. Timers still pending are re-armed for their remaining time.&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/testing/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/testing/</guid><description>&lt;h1 id="testing-a-game"&gt;Testing a game&lt;a class="anchor" href="#testing-a-game" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Three tests cover almost everything. The template (&lt;code&gt;cig new&lt;/code&gt;) ships all three.&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-go" data-lang="go"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;// 1. Automated play-testing: random legal games, every rule checked.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;TestExplore&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;cig2test&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Explore&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;mygame&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Name&lt;/span&gt;, []&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;{&lt;span style="color:#e6db74"&gt;&amp;#34;p1&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;p2&amp;#34;&lt;/span&gt;})&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;// 2. A scripted game through the real session path.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;func&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;TestAGame&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt; &lt;span style="color:#f92672"&gt;*&lt;/span&gt;&lt;span style="color:#a6e22e"&gt;testing&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;T&lt;/span&gt;) {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;tbl&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;cig2test&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Start&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;mygame&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Name&lt;/span&gt;, []&lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;PlayerID&lt;/span&gt;{&lt;span style="color:#e6db74"&gt;&amp;#34;p1&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;p2&amp;#34;&lt;/span&gt;}, &lt;span style="color:#a6e22e"&gt;cig2&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;WithSeed&lt;/span&gt;(&lt;span style="color:#ae81ff"&gt;1&lt;/span&gt;))&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;st&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;tbl&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Act&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;p1&amp;#34;&lt;/span&gt;, &lt;span style="color:#e6db74"&gt;&amp;#34;play&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;map&lt;/span&gt;[&lt;span style="color:#66d9ef"&gt;string&lt;/span&gt;]&lt;span style="color:#66d9ef"&gt;string&lt;/span&gt;{&lt;span style="color:#e6db74"&gt;&amp;#34;card&amp;#34;&lt;/span&gt;: &lt;span style="color:#a6e22e"&gt;uuid&lt;/span&gt;})&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#66d9ef"&gt;if&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;st&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Err&lt;/span&gt; &lt;span style="color:#f92672"&gt;!=&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;nil&lt;/span&gt; {&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&#9;&lt;span style="color:#a6e22e"&gt;t&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Fatal&lt;/span&gt;(&lt;span style="color:#a6e22e"&gt;st&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Err&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;hand&lt;/span&gt;, &lt;span style="color:#a6e22e"&gt;_&lt;/span&gt; &lt;span style="color:#f92672"&gt;:=&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;st&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;Snapshot&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;p2&amp;#34;&lt;/span&gt;).&lt;span style="color:#a6e22e"&gt;Root&lt;/span&gt;.&lt;span style="color:#a6e22e"&gt;FindZone&lt;/span&gt;(&lt;span style="color:#e6db74"&gt;&amp;#34;hand-p1&amp;#34;&lt;/span&gt;)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#9;&lt;span style="color:#a6e22e"&gt;_&lt;/span&gt; = &lt;span style="color:#a6e22e"&gt;hand&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;// 3. Golden snapshots: exactly what each seat is sent, UUIDs renamed.&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#75715e"&gt;// See cig2test.Golden.&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="what-runs-automatically"&gt;What runs automatically&lt;a class="anchor" href="#what-runs-automatically" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Every &lt;code&gt;cig2test.Start&lt;/code&gt; table:&lt;/strong&gt;&lt;/p&gt;</description></item><item><title/><link>https://docs.grylls.uk/framework/changelog/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.grylls.uk/framework/changelog/</guid><description>&lt;h1 id="changelog"&gt;Changelog&lt;a class="anchor" href="#changelog" aria-label="Link"&gt;&lt;/a&gt;&lt;/h1&gt;&#10;&lt;p&gt;Changes that a game or server built on CIG2 may need to act on. Each entry&#10;says what changed and, under &lt;strong&gt;Migrate&lt;/strong&gt;, what to do about it.&lt;/p&gt;&#10;&lt;h2 id="upgrading-from-v030-to-v031"&gt;Upgrading from v0.3.0 to v0.3.1&lt;a class="anchor" href="#upgrading-from-v030-to-v031" aria-label="Link"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;v0.3.1 closes a gap that rhetoric found on its first day on v0.3.0. Take it&#10;with &lt;code&gt;go get github.com/PipGrylls/CIG2@v0.3.1&lt;/code&gt;; the &lt;code&gt;cig&lt;/code&gt; tool is tagged&#10;&lt;code&gt;tools/v0.3.1&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;Fixed: with invites on, a guest could reset, create or delete tables.&lt;/strong&gt;&#10;v0.3.0 kept the invite routes host only, but host&amp;rsquo;s own &lt;code&gt;POST reset&lt;/code&gt;,&#10;&lt;code&gt;create&lt;/code&gt;, &lt;code&gt;claim&lt;/code&gt; and &lt;code&gt;t/{table}/delete&lt;/code&gt; still let any grant holder through.&#10;A guest could press a board&amp;rsquo;s &amp;ldquo;New deal&amp;rdquo; and wipe the game. With&#10;&lt;code&gt;Server.Invites&lt;/code&gt; on, those routes are now host only too (403 for a guest).&#10;A guest plays the seat they were given and nothing else; seats are handed&#10;out by the host&amp;rsquo;s links, not claimed. Without &lt;code&gt;Invites&lt;/code&gt; nothing changes:&#10;everyone through the gate holds the password.&lt;/p&gt;</description></item></channel></rss>