@mcptoolshop/sovereign 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ja.md CHANGED
@@ -15,7 +15,7 @@
15
15
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
16
16
  [![Landing Page](https://img.shields.io/badge/landing-page-1F2D52?style=flat)](https://mcp-tool-shop-org.github.io/sovereign/)
17
17
 
18
- </div>
18
+ </div
19
19
 
20
20
  ---
21
21
 
@@ -23,9 +23,54 @@
23
23
 
24
24
  Sovereignは、**アメリカの公的信用に関するハミルトン・システムを基にしたボードゲーム**であり、さらに、**完全なソロ/デジタル版**も付属しています。このデジタル版は、同じルールに基づいて、ブラウザ上で2つの決定的なAI対戦相手とローカルで動作します。
25
25
 
26
- - **ボードゲーム**:印刷可能な34ページのプロトタイプ。40マス、22の物件地 + 4つのルート + 2つの機関、8つのカラーシステム、7つの議会法(固定された歴史的順序)、4つのプレイヤー役割、3つの共通トラック(公的信用、公的抵抗、産業能力)、12+12枚のイベントカード。財務省以外にも、商人道と製造業者道という2つの経済的戦略が存在します。
27
- - **デジタルモード**:単一の自己完結型のHTMLファイル。完全なステートマシン、決定的な mulberry32 ランダムナンバージェネレーター、スクリプト化されたAI対戦相手(財務省/金融、商人/インフラ、製造業者/産業)、ハッシュ整合性によるセーブ/ロード機能、リプレイ機能、バッチシミュレーションツール、ローカルのバランスに関するテレメトリー。
28
- - **バランスの基準**:v0.10。9つのバージョンにわたるシミュレーションゲーム1,000回以上に基づいて調整されました。財務省:59%、商人:25%、製造業者:16%(正攻法 × 100、すべてのプロファイルで目標範囲を達成)。
26
+ - **ボードゲーム** — 印刷可能な34ページ版。40マス、22の物件 + 4つのルート + 2つの機関、8つのカラーシステム、7つの議会法(固定された歴史的順序)、4つのプレイヤー役割、3つの共通トラック(公共信用、公共抵抗、工業生産力)、12+12枚のイベントカード。財務省以外にも、商人道と製造業者道という2つの経済的戦略が存在します。
27
+ - **デジタルモード** — 単一の自己完結型のHTMLファイル。完全な状態遷移システム、決定論的な mulberry32 乱数生成器、スクリプトによるAI対戦相手(財務省/金融、商人/インフラ、製造業者/産業)、ハッシュ整合性によるセーブ/ロード機能、リプレイ機能、バッチシミュレーションツール、ローカルバランステレメトリー。
28
+ - **バランス基準** — v0.10のコアバランスがv1.1.0まで維持されています。財務省:60.0%、商人:23.5%、製造業者:16.5%(v0.18の改良版におけるCANONICAL × 400。すべてのプロファイルで目標範囲を達成)。
29
+ - **システム障害** — 3つの段階:**信用危機**(公共信用 ≤ 4、警告)、**反乱**(公共抵抗 12、大惨事)、**デフォルト**(公共信用 0、大惨事)。v1.1.0で新しく追加されました。大惨事の状態はv0.10から変更されていません。
30
+
31
+ ---
32
+
33
+ ## v1.1.0の新機能
34
+
35
+ ### システム障害の基礎
36
+
37
+ v1.1.0では、3段階のシステム障害の階層が実装されました。公共信用が0になった場合のデフォルト状態は、依然として壊滅的な金融崩壊の状態(各プレイヤーにつき50%の現金と1つのアップグレードを失う)です。公共抵抗が12になった場合の反乱状態は、依然として壊滅的な政治崩壊の状態(収入のアップグレードが破壊される)です。その間、新しい段階的なイベントである**信用危機**が発生します。公共信用が4以下になったときに初めて発生し、抵抗力を+1増加させ、システムログに「システム」の行を記録します。信用をリセットしたり、資産を破壊したり、ゲームを終了したりすることはありません。
38
+
39
+ システム障害を実際にゲームプレイで可視化するために、現在、信用を低下させる4つのプレッシャーカードが追加されています。
40
+
41
+ | カード | 効果 |
42
+ |---|---|
43
+ | 銀行の取り付け騒ぎ | 公共信用 -1、工業生産力 -1 |
44
+ | 投機熱(信用 ≥ 7) | 公共信用 -1、抵抗力 +1、未所有の収入/国債のオークション |
45
+ | 投機熱(信用 ≤ 6) | 公共信用 -2、抵抗力 +1、未所有の収入/国債のオークション |
46
+ | 反連邦主義のパンフレット | 公共信用 -1、抵抗力 +1、収入システムを持つ物件ごとに30のTN(税金) |
47
+
48
+ 1周目の資金調達法は、依然として公共信用を+2増加させます。大惨事であるデフォルトの状態は、バランス目標ではなく、劇的な制限として維持されています。信用危機が、実際の状態を示す指標となります。
49
+
50
+ CANONICAL-400の証拠(シード値:2026 – 2425):財務省:60.0%、商人:23.5%、製造業者:16.5%。信用危機が発生する回数:2 / 400。デフォルトが発生する回数:0 / 400。反乱が発生する回数:0 / 400。抵抗力 ≥ 8 の状態が維持される回数:0 / 400。決定論:合格。詳細な証拠は、`experiments/v0.18-failure-pressure-candidate/sovereign-v0.18-evidence-sweep.html`で確認できます。
51
+
52
+ ### ゲーム全体の視覚的な改善
53
+
54
+ プレイヤーが目にするすべての要素は、統一された連邦主義の財務省製品としてデザインされています。
55
+
56
+ - 上部のバーに表示されるロゴ + モード表示 + 控えめなバージョン表示(テレメトリーダッシュボードのヘッダーではなくなりました)
57
+ - 初回起動時に表示されるチュートリアルオーバーレイで、3つのトラックと3つのシステム障害段階を紹介
58
+ - コーナーに装飾のあるタイル、システムカラーバンド、機関、ルート、税金、イベントスペースの区別されたデザイン
59
+ - `CREDIT_CRISIS` / `DEFAULT` / `REBELLION`のログ行には、明瞭さを示す色、ボーダー、ラベルが適用されています(アクセシビリティに配慮)
60
+ - トラックパネルには、信用危機の警告帯(1~4)と、デフォルトおよび反乱の状態を示すマーカーが表示されます
61
+ - ゲーム終了レポートには、スコア列の上部に、信用状態/危機状態/反乱状態を示すチップが表示され、結果について明確に説明するナレーションが追加されます
62
+ - バッチモードは、「バランスの証拠実行」として再構成されました
63
+ - 768px以下の画面に対応するレスポンシブデザインと、印刷用のスタイルシート
64
+
65
+ デザインシステムのリファレンスと、15フレームの視覚的な状態の監査は、`release/design-system/` ディレクトリに格納されています。これらは、v1.1.0 リリースのインターフェースがどのようなものかを示す、信頼できる記録です。
66
+
67
+ ### 動作の維持
68
+
69
+ v0.18のプロモーション監査では、起源、実装、回帰テスト、バランス/失敗の証拠、およびドキュメントの準備に関する44件のチェック項目すべてに合格しました。100個のシードを使用した標準的なゲームの状態のハッシュ値は、v0.18のNodeシミュレーションと、改良されたHTML版(`3189375454`)で完全に一致しています。`SAVE_VERSION`は、改良プロセスにおいて動作に変更がなかったため、`'v0.18-candidate'`のままです。
70
+
71
+ ### 注意点
72
+
73
+ v1.1.0の動作は、標準的なT/M/Mfgのトリプレット(400個のシード)と、MFG-MIRRORのバリアント(100個のシード)を使用してシミュレーションで検証されています。ただし、まだ人間によるプレイテストは実施されていません。
29
74
 
30
75
  ---
31
76
 
@@ -155,4 +200,4 @@ MIT © mcp-tool-shop。[`LICENSE`](./LICENSE) を参照してください。
155
200
 
156
201
  構築者: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
157
202
 
158
- </div>
203
+ </div
package/README.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  **The Hamilton System Board Game · solo / digital adaptation**
10
10
 
11
- *Founding Credit · Fund the debt. Build the bank. Industrialize the republic.*
11
+ *Founding Credit · Fund the debt. Build the bank. Industrialize the Republic.*
12
12
 
13
13
  [![CI](https://github.com/mcp-tool-shop-org/sovereign/actions/workflows/ci.yml/badge.svg)](https://github.com/mcp-tool-shop-org/sovereign/actions/workflows/ci.yml)
14
14
  [![npm version](https://img.shields.io/npm/v/@mcptoolshop/sovereign.svg)](https://www.npmjs.com/package/@mcptoolshop/sovereign)
@@ -23,9 +23,54 @@
23
23
 
24
24
  Sovereign is a **Hamilton-system Monopoly-grammar board game** about the founding of US public credit, plus a **complete solo / digital adaptation** that runs the same rules locally in a browser against two deterministic scripted opponents.
25
25
 
26
- - **Board game** — printable 34-sheet prototype. 40-space board, 22 properties + 4 routes + 2 institutions, 8 color systems, 7 Acts of Congress in fixed historical order, 4 player roles, 3 shared tracks (Public Credit · Public Resistance · Industrial Capacity), 12+12 event cards. Two viable economic paths beyond Treasury: Merchant and Manufacturer.
26
+ - **Board game** — printable 34-sheet edition. 40-space board, 22 properties + 4 routes + 2 institutions, 8 color systems, 7 Acts of Congress in fixed historical order, 4 player roles, 3 shared tracks (Public Credit · Public Resistance · Industrial Capacity), 12+12 event cards. Two viable economic paths beyond Treasury: Merchant and Manufacturer.
27
27
  - **Digital mode** — single self-contained HTML file. Full state machine, deterministic mulberry32 RNG, scripted AI opponents (Treasury / Finance, Merchant / Infrastructure, Manufacturer / Industry), save / load with hash integrity, replay scrubber, batch simulation tool, local balance telemetry.
28
- - **Balance baseline** — v0.10, frozen after a nine-version arc driven by 1,000+ deterministic simulation games. Treasury 59% · Merchant 25% · Manufacturer 16% (CANONICAL × 100, target band met for all three profiles).
28
+ - **Balance baseline** — v0.10 core balance preserved through v1.1.0. Treasury 60.0% · Merchant 23.5% · Manufacturer 16.5% (CANONICAL × 400 at the v0.18 polished foundation; target band met for all three profiles).
29
+ - **Failure system** — three tiers: **Credit Crisis** (Public Credit ≤ 4, warning), **Rebellion** (Public Resistance 12, catastrophe), **Default** (Public Credit 0, catastrophe). New as of v1.1.0; the catastrophic endpoints are unchanged from v0.10.
30
+
31
+ ---
32
+
33
+ ## What's new in v1.1.0
34
+
35
+ ### Failure-system foundation
36
+
37
+ v1.1.0 introduces a working three-tier failure hierarchy. Default at Public Credit 0 stays as the catastrophic financial collapse condition (50% cash + 1 upgrade lost per player). Rebellion at Public Resistance 12 stays as the catastrophic political collapse (Revenue upgrades destroyed). Between them, a new soft intermediate event — **Credit Crisis** — fires the first time Public Credit collapses to 4 or lower, ticks Resistance +1, and logs a System row in the ledger. It does not reset Credit, does not destroy assets, and does not end the game.
38
+
39
+ To make the failure layer actually visible in play, four pressure cards now move Credit downward:
40
+
41
+ | Card | Effect |
42
+ |---|---|
43
+ | Bank Run | Public Credit −1, Industrial Capacity −1 |
44
+ | Speculation Fever (Credit ≥ 7) | Public Credit −1, Resistance +1, auction unowned Rev/State Debt |
45
+ | Speculation Fever (Credit ≤ 6) | Public Credit −2, Resistance +1, auction unowned Rev/State Debt |
46
+ | Anti-Federalist Pamphlet | Public Credit −1, Resistance +1, 30 TN per Revenue-System property |
47
+
48
+ Funding Act at lap 1 still adds +2 Credit. The catastrophic Default endpoint is preserved as a dramatic limit, not a balance target — Credit Crisis carries the live signal.
49
+
50
+ CANONICAL-400 evidence (seeds 2026 – 2425): Treasury 60.0% · Merchant 23.5% · Manufacturer 16.5%. Credit Crisis fires 2 / 400. Default fires 0 / 400. Rebellion fires 0 / 400. Resistance ≥ 8 holds at 0 / 400. Determinism PASS. Full evidence at `experiments/v0.18-failure-pressure-candidate/sovereign-v0.18-evidence-sweep.html`.
51
+
52
+ ### Whole-game visual polish
53
+
54
+ Every player-facing surface art-directed as one coherent Federalist Treasury product:
55
+
56
+ - Topbar wordmark + mode tag + a discreet version pill (no longer a telemetry dashboard header)
57
+ - First-load orientation overlay introducing the three tracks and three failure tiers
58
+ - Board tiles with corner crests, system color bands, distinct treatments for institutions, routes, taxes, and event spaces
59
+ - Ledger rows for `CREDIT_CRISIS` / `DEFAULT` / `REBELLION` get distinct severity treatments (color + border + label — accessibility-aware)
60
+ - Tracks panel marks the Credit Crisis warning band (1–4) and the Default and Rebellion endpoints
61
+ - Endgame report shows posture chips (credit posture / Crisis state / Rebellion state) above the score columns, with narration that explicitly mentions Crisis / Default / Rebellion outcomes
62
+ - Batch modal reframed as "Balance Evidence Run"
63
+ - Responsive ≤ 768 px breakpoint and a print stylesheet
64
+
65
+ The design-system reference and a fifteen-frame visual state audit live under `release/design-system/` — these are the durable record of how the v1.1.0 release surface looks.
66
+
67
+ ### Mechanics preserved
68
+
69
+ The v0.18 promotion audit passed 44 / 44 checks across provenance, implementation, regression, balance/failure evidence, and documentation readiness. The 100-seed canonical game-state hash is byte-identical between the v0.18 Node simulation and the polished HTML (`3189375454`). `SAVE_VERSION` remains `'v0.18-candidate'` because no mechanic changed across the polish pass.
70
+
71
+ ### Caveat
72
+
73
+ v1.1.0 mechanics are simulation-verified across the canonical T/M/Mfg triplet (400 seeds) and the MFG-MIRROR variant (100 seeds). They are not yet human-playtested.
29
74
 
30
75
  ---
31
76
 
@@ -54,7 +99,7 @@ Open the hosted landing page at **<https://mcp-tool-shop-org.github.io/sovereign
54
99
 
55
100
  ### Print and play
56
101
 
57
- The board-game prototype is a self-contained 34-sheet HTML document. Open `release/board-game/sovereign-prototype.html` from the package (or from a download), then `Cmd/Ctrl-P → Save as PDF → US Letter → 100% scale`. Cut and play.
102
+ The printable board game is a self-contained 34-sheet HTML document. Open `release/board-game/sovereign-board-game.html` from the package (or from a download), then `Cmd/Ctrl-P → Save as PDF → US Letter → 100% scale`. Cut and play.
58
103
 
59
104
  ### Offline release bundle
60
105
 
package/README.pt-BR.md CHANGED
@@ -15,7 +15,7 @@
15
15
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
16
16
  [![Landing Page](https://img.shields.io/badge/landing-page-1F2D52?style=flat)](https://mcp-tool-shop-org.github.io/sovereign/)
17
17
 
18
- </div>
18
+ </div
19
19
 
20
20
  ---
21
21
 
@@ -23,9 +23,54 @@
23
23
 
24
24
  Sovereign é um **jogo de tabuleiro do tipo Monopoly, inspirado no sistema Hamilton**, sobre a fundação do crédito público dos EUA, além de uma **adaptação completa para jogar sozinho / digitalmente** que executa as mesmas regras localmente em um navegador contra dois oponentes programados e determinísticos.
25
25
 
26
- - **Jogo de tabuleiro** — protótipo imprimível em 34 páginas. Tabuleiro com 40 espaços, 22 propriedades + 4 rotas + 2 instituições, 8 sistemas de cores, 7 Atos do Congresso em ordem histórica fixa, 4 papéis de jogador, 3 trilhas compartilhadas (Crédito Público · Resistência Pública · Capacidade Industrial), 12+12 cartas de evento. Dois caminhos econômicos viáveis além do Tesouro: Comércio e Indústria.
27
- - **Modo digital** — um único arquivo HTML autônomo. Máquina de estados completa, RNG determinístico mulberry32, oponentes de IA programados (Tesouro / Finanças, Comércio / Infraestrutura, Indústria / Indústria), salvar / carregar com integridade de hash, ferramenta de reprodução, ferramenta de simulação em lote, telemetria local de equilíbrio.
28
- - **Equilíbrio base** — v0.10, congelado após um arco de nove versões impulsionado por mais de 1.000 jogos de simulação determinísticos. Tesouro 59% · Comércio 25% · Indústria 16% (CANÔNICO × 100, a faixa alvo foi atingida para todos os três perfis).
26
+ - **Jogo de tabuleiro** — edição impressa com 34 páginas. Tabuleiro com 40 espaços, 22 propriedades + 4 rotas + 2 instituições, 8 sistemas de cores, 7 Atos do Congresso em ordem histórica fixa, 4 papéis de jogador, 3 trilhas compartilhadas (Crédito Público · Resistência Pública · Capacidade Industrial), 12+12 cartas de evento. Dois caminhos econômicos viáveis além do Tesouro: Comerciante e Fabricante.
27
+ - **Modo digital** — um único arquivo HTML autônomo. Máquina de estados completa, gerador de números aleatórios mulberry32 determinístico, oponentes com IA programada (Tesouro / Finanças, Comerciante / Infraestrutura, Fabricante / Indústria), salvar / carregar com integridade por hash, ferramenta de análise de repetições, ferramenta de simulação em lote, telemetria de equilíbrio local.
28
+ - **Equilíbrio base** — o equilíbrio central da versão 0.10 foi mantido até a versão 1.1.0. Tesouro: 60,0% · Comerciante: 23,5% · Fabricante: 16,5% (valor CANONICAL × 400 na base refinada da versão 0.18; a faixa alvo foi atingida para todos os três perfis).
29
+ - **Sistema de falha** — três níveis: **Crise de Crédito** (Crédito Público ≤ 4, aviso), **Rebelião** (Resistência Pública 12, catástrofe), **Inadimplência** (Crédito Público 0, catástrofe). Novo na versão 1.1.0; os pontos finais catastróficos permanecem inalterados em relação à versão 0.10.
30
+
31
+ ---
32
+
33
+ ## O que há de novo na versão 1.1.0
34
+
35
+ ### Fundação do sistema de falha
36
+
37
+ A versão 1.1.0 introduz uma hierarquia de falha funcional de três níveis. A inadimplência em Crédito Público 0 permanece como a condição de colapso financeiro catastrófico (50% de dinheiro + 1 atualização perdida por jogador). A Rebelião em Resistência Pública 12 permanece como o colapso político catastrófico (atualizações de receita destruídas). Entre eles, um novo evento intermediário — **Crise de Crédito** — ocorre na primeira vez que o Crédito Público cai para 4 ou menos, aumenta a Resistência em +1 e registra uma linha no registro. Não redefine o Crédito, não destrói ativos e não termina o jogo.
38
+
39
+ Para tornar a camada de falha realmente visível durante o jogo, quatro cartas de pressão agora reduzem o Crédito:
40
+
41
+ | Carta | Efeito |
42
+ |---|---|
43
+ | Corrida aos Bancos | Crédito Público −1, Capacidade Industrial −1 |
44
+ | Febre Especulativa (Crédito ≥ 7) | Crédito Público −1, Resistência +1, leilão de Receitas/Dívida Estadual não possuídas |
45
+ | Febre Especulativa (Crédito ≤ 6) | Crédito Público −2, Resistência +1, leilão de Receitas/Dívida Estadual não possuídas |
46
+ | Panfleto Antifederalista | Crédito Público −1, Resistência +1, 30 TN por propriedade do sistema de Receita |
47
+
48
+ A Lei de Financiamento no turno 1 ainda adiciona +2 Crédito. O ponto final catastrófico de Inadimplência é mantido como um limite dramático, não como um alvo de equilíbrio — a Crise de Crédito transmite o sinal ativo.
49
+
50
+ Evidência CANONICAL-400 (sementes 2026 – 2425): Tesouro 60,0% · Comerciante 23,5% · Fabricante 16,5%. A Crise de Crédito ocorre 2 / 400 vezes. A Inadimplência ocorre 0 / 400 vezes. A Rebelião ocorre 0 / 400 vezes. A Resistência ≥ 8 permanece em 0 / 400. Determinismo: APROVADO. Evidência completa em `experiments/v0.18-failure-pressure-candidate/sovereign-v0.18-evidence-sweep.html`.
51
+
52
+ ### Polimento visual do jogo completo
53
+
54
+ Cada elemento visual voltado para o jogador foi projetado como um produto coerente do Tesouro Federalista:
55
+
56
+ - Logotipo superior + tag de modo + uma versão discreta (não é mais um cabeçalho do painel de telemetria)
57
+ - Sobreposição de orientação na primeira execução, apresentando as três trilhas e os três níveis de falha
58
+ - Tiles do tabuleiro com cristas nos cantos, faixas de cores do sistema, tratamentos distintos para instituições, rotas, impostos e espaços de eventos
59
+ - As linhas do registro para `CRISE_DE_CREDITO` / `INADIMPLÊNCIA` / `REBELIÃO` recebem tratamentos de severidade distintos (cor + borda + rótulo — com acessibilidade em mente)
60
+ - O painel de trilhas marca a faixa de aviso da Crise de Crédito (1–4) e os pontos finais de Inadimplência e Rebelião
61
+ - O relatório de fim de jogo mostra os chips de postura (postura do crédito / estado da Crise / estado da Rebelião) acima das colunas de pontuação, com uma narração que menciona explicitamente os resultados de Crise / Inadimplência / Rebelião
62
+ - A janela de lote foi renomeada para "Execução de Evidência de Equilíbrio"
63
+ - Quebra de responsividade ≤ 768 px e uma folha de estilo para impressão
64
+
65
+ A referência do sistema de design e uma auditoria visual de quinze quadros estão localizadas em `release/design-system/` – estes são os registros permanentes de como a interface da versão v1.1.0 se apresenta.
66
+
67
+ ### Mecânicas preservadas
68
+
69
+ A auditoria de promoção da versão v0.18 passou em 44 de 44 verificações, abrangendo a origem, a implementação, a regressão, as evidências de equilíbrio/falha e a prontidão da documentação. O hash do estado do jogo canônico, com 100 "sementes", é byte a byte idêntico entre a simulação Node da versão v0.18 e o HTML finalizado (`3189375454`). A variável `SAVE_VERSION` permanece como `'v0.18-candidate'` porque nenhuma mecânica foi alterada durante o processo de finalização.
70
+
71
+ ### Observação importante
72
+
73
+ As mecânicas da versão v1.1.0 foram verificadas por simulação em todo o conjunto canônico de T/M/Mfg (400 sementes) e na variante MFG-MIRROR (100 sementes). Elas ainda não foram testadas por jogadores humanos.
29
74
 
30
75
  ---
31
76
 
@@ -155,4 +200,4 @@ MIT © mcp-tool-shop. Consulte o arquivo [`LICENSE`](./LICENSE).
155
200
 
156
201
  Desenvolvido por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
157
202
 
158
- </div>
203
+ </div
package/README.zh.md CHANGED
@@ -6,26 +6,71 @@
6
6
 
7
7
  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/sovereign/readme.png" alt="Sovereign — The Hamilton System Board Game" width="400" />
8
8
 
9
- **Hamilton 系统桌游 · 单人/数字版**
9
+ **“汉密尔顿系统”棋盘游戏 · 单人/数字版本**
10
10
 
11
- *奠基信贷 · 偿还债务。 建立银行。 推动工业化,建设共和国。*
11
+ *创始基金 · 偿还债务。 建立银行。 推动工业化,建设共和国。*
12
12
 
13
13
  [![CI](https://github.com/mcp-tool-shop-org/sovereign/actions/workflows/ci.yml/badge.svg)](https://github.com/mcp-tool-shop-org/sovereign/actions/workflows/ci.yml)
14
14
  [![npm version](https://img.shields.io/npm/v/@mcptoolshop/sovereign.svg)](https://www.npmjs.com/package/@mcptoolshop/sovereign)
15
15
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
16
16
  [![Landing Page](https://img.shields.io/badge/landing-page-1F2D52?style=flat)](https://mcp-tool-shop-org.github.io/sovereign/)
17
17
 
18
- </div>
18
+ </div
19
19
 
20
20
  ---
21
21
 
22
22
  ## 简介
23
23
 
24
- Sovereign 是一款 **基于 Hamilton 系统的单多米诺骨牌游戏**,讲述的是美国公共信贷的建立,同时还提供一个 **完整的单人/数字版**,它可以在浏览器中本地运行,与两个预设的、可预测的对手进行游戏。
24
+ Sovereign是一款**基于“汉密尔顿系统”的“大富翁”风格棋盘游戏**,讲述的是美国公共信贷的建立,同时还提供一个**完整的单人/数字版本**,它可以在浏览器中本地运行,与两个具有固定行为的AI对手对战。
25
25
 
26
- - **桌游**包含 34 页的打印原型。 包含 40 个格子,22 处地产 + 4 条路线 + 2 个机构,8 个颜色系统,7 项国会法案按照固定的历史顺序排列,4 个玩家角色,3 条共享进度条(公共信贷 · 公众抵制 · 工业能力),12+12 张事件卡。 除了财政部之外,还有两种可行的经济发展路径:商人路径和制造商路径。
27
- - **数字模式** — 单个独立的 HTML 文件。 完整的状态机,使用可预测的 mulberry32 随机数生成器,预设的 AI 对手(财政部/金融、商人/基础设施、制造商/工业),支持保存/加载,并具有哈希完整性校验,回放功能,批量模拟工具,以及本地平衡性数据统计。
28
- - **平衡性基准** — v0.10 版本,在经过九个版本的迭代后冻结,该迭代基于 1000 多个可预测的模拟游戏。 财政部:59%;商人:25%;制造商:16%(符合规范的 100 倍,所有三种模式都达到了目标范围)。
26
+ - **棋盘游戏**可打印的34页版本。 棋盘包含40个格子,22个地产 + 4条路线 + 2个机构,8种颜色系统,7部国会法案按照固定的历史顺序排列,4种玩家角色,3条共享进度条(公共信用、公共抵抗、工业能力),12+12张事件卡。 除了财政部之外,还有两种可行的经济发展路径:商人路径和制造商路径。
27
+ - **数字模式** — 单个独立的HTML文件。 完整的状态机,使用deterministic mulberry32随机数生成器,带有脚本化的AI对手(财政部/金融、商人/基础设施、制造商/工业),支持保存/加载并具有哈希完整性,支持重播,包含批量模拟工具,以及本地平衡数据统计。
28
+ - **平衡基准** — v0.10的核心平衡在v1.1.0版本中得到保留。 财政部:60.0%;商人:23.5%;制造商:16.5%(在v0.18版本中经过完善的基础版本,所有三种模式都达到了目标范围)。
29
+ - **失败系统** — 分为三个等级:**信用危机**(公共信用≤4,警告),**叛乱**(公共抵抗12,灾难),**违约**(公共信用0,灾难)。 新增于v1.1.0版本;灾难性的结束条件与v0.10版本相同。
30
+
31
+ ---
32
+
33
+ ## v1.1.0版本的新功能
34
+
35
+ ### 失败系统基础
36
+
37
+ v1.1.0版本引入了一个可用的三级失败等级系统。 违约,即公共信用为0,仍然是导致金融崩溃的灾难性条件(每个玩家损失50%的现金 + 1个升级)。 叛乱,即公共抵抗为12,仍然是导致政治崩溃的灾难性条件(收入升级被摧毁)。 在这两者之间,新增了一个轻微的中间事件——**信用危机**。 当公共信用降至4或更低时,会触发该事件,增加公共抵抗1点,并在账本中记录一条“系统”行。 它不会重置信用,不会摧毁资产,也不会结束游戏。
38
+
39
+ 为了使失败层级在游戏中真正可见,现在有四张压力卡会降低信用值:
40
+
41
+ | 卡牌 | 效果 |
42
+ |---|---|
43
+ | 银行挤兑 | 公共信用 -1,工业能力 -1 |
44
+ | 投机狂热(信用≥7) | 公共信用 -1,抵抗 +1,拍卖未拥有收入/国家债务 |
45
+ | 投机狂热(信用≤6) | 公共信用 -2,抵抗 +1,拍卖未拥有收入/国家债务 |
46
+ | 反联邦党宣言 | 公共信用 -1,抵抗 +1,每个收入系统地产损失30个TN |
47
+
48
+ 在第一回合,资助法案仍然会增加+2个信用值。 违约,即公共信用为0,仍然被保留为一种戏剧性的限制,而不是平衡目标——信用危机会发出警报。
49
+
50
+ CANONICAL-400实验数据(种子:2026 – 2425):财政部:60.0%;商人:23.5%;制造商:16.5%。 信用危机触发2次/400次。 违约触发0次/400次。 叛乱触发0次/400次。 公共抵抗≥8的概率为0次/400次。 确定性测试通过。 完整的实验数据请参考:`experiments/v0.18-failure-pressure-candidate/sovereign-v0.18-evidence-sweep.html`。
51
+
52
+ ### 整体视觉美化
53
+
54
+ 所有面向玩家的界面都经过艺术设计,使其成为一个统一的联邦财政产品:
55
+
56
+ - 顶部栏:包含游戏名称、模式标签以及一个不显眼的版本标识(不再是数据统计仪表盘的标题)
57
+ - 首次加载时,会显示一个引导界面,介绍三个进度条和三个失败等级
58
+ - 棋盘:包含角落的徽章,颜色分区分块,以及对机构、路线、税收和事件区域的独特处理
59
+ - 账本行:`信用危机` / `违约` / `叛乱` 会有不同的严重程度标识(颜色 + 边框 + 标签,考虑可访问性)
60
+ - 进度条面板:标记信用危机的警告区域(1–4)以及违约和叛乱的结束点
61
+ - 游戏结束报告:显示姿态芯片(信用姿态/危机状态/叛乱状态),位于分数列上方,并带有明确提及危机/违约/叛乱结果的说明
62
+ - 批量模式:重命名为“平衡数据运行”
63
+ - 响应式设计,支持≤768像素的屏幕,并包含打印样式表。
64
+
65
+ 设计系统参考文档以及包含十五个画面的视觉状态审核文件位于 `release/design-system/` 目录下,这些文件记录了 v1.1.0 版本的界面外观。
66
+
67
+ ### 机制保持不变
68
+
69
+ v0.18 版本的推广审核通过了所有 44 项检查,涵盖了来源、实现、回归测试、平衡/失败证据以及文档准备情况。 100 个种子值的标准游戏状态哈希值在 v0.18 版本的 Node 模拟和优化后的 HTML 版本之间完全一致(值为 `3189375454`)。 `SAVE_VERSION` 仍然是 `'v0.18-candidate'`,因为在优化过程中,没有任何机制发生改变。
70
+
71
+ ### 注意事项
72
+
73
+ v1.1.0 版本的机制已通过模拟验证,验证范围包括标准的 T/M/Mfg 三元组(400 个种子值)以及 MFG-MIRROR 变体(100 个种子值)。 但尚未经过人工游戏测试。
29
74
 
30
75
  ---
31
76
 
@@ -37,7 +82,7 @@ Sovereign 是一款 **基于 Hamilton 系统的单多米诺骨牌游戏**,讲
37
82
  npx @mcptoolshop/sovereign
38
83
  ```
39
84
 
40
- CLI 命令会在您的默认浏览器中打开游戏。 无需安装程序,无需服务器,无需互联网连接。
85
+ CLI命令可以打开游戏,使用您的默认浏览器。 无需安装,无需服务器,无需连接互联网。
41
86
 
42
87
  其他模式:
43
88
 
@@ -48,37 +93,37 @@ npx @mcptoolshop/sovereign --path # Print the playable HTML file path
48
93
  npx @mcptoolshop/sovereign --help # All flags
49
94
  ```
50
95
 
51
- ### 在线玩
96
+ ### 在线游戏
52
97
 
53
- 打开托管的页面 **<https://mcp-tool-shop-org.github.io/sovereign/>**,然后点击进入数字游戏。
98
+ 打开位于 **<https://mcp-tool-shop-org.github.io/sovereign/>** 的主页,然后点击进入数字游戏。
54
99
 
55
100
  ### 打印并玩
56
101
 
57
- 桌游原型是一个独立的 34 HTML 文档。 打开 `release/board-game/sovereign-prototype.html` 文件(或从下载的文件中打开),然后使用 `Cmd/Ctrl-P → 保存为 PDF → US Letter → 100% 比例`。 裁剪并开始游戏。
102
+ 可打印的棋盘游戏是一个独立的34页HTML文档。 打开 `release/board-game/sovereign-board-game.html` 文件(或从下载的文件中),然后使用 `Cmd/Ctrl-P → 保存为PDF → US Letter → 100% 比例`。 剪切并开始游戏。
58
103
 
59
104
  ### 离线发布包
60
105
 
61
- 每个版本都会在 GitHub 发布页面上附加一个 `sovereign-vX.Y.Z-release.zip` 的发布包。 下载它,解压缩,然后打开 `00-START-HERE.html` 文件,该文件会引导您进入游戏。 所有内容都可以在离线状态下运行。
106
+ 每个版本都会在GitHub发布页面上附加一个 `sovereign-vX.Y.Z-release.zip` 的发布包。 下载它,解压缩,然后打开 `00-START-HERE.html` 文件,该文件会引导您进入游戏。 整个游戏可以在离线状态下运行。
62
107
 
63
108
  ---
64
109
 
65
110
  ## 设计理念
66
111
 
67
- Sovereign 的核心思想是,**公共信贷 + 联邦财政** 是亚历山大·汉密尔顿最重要的经济杠杆。 但是,一款基于 Hamilton 系统的游戏必须允许 **商业** 和 **工业** 成为通往胜利的可行途径。 从 v0.2 到 v0.10 的平衡性迭代是一个持续九个版本的、以证据为导向的过程,旨在保持财政部作为最强大的模式(符合历史),同时避免游戏设计陷入单一策略。
112
+ Sovereign 的核心思想是,**公共信贷和联邦财政**是亚历山大·汉密尔顿最重要的经济杠杆——但一款“汉密尔顿系统”游戏必须允许**商业**和**工业**也成为通往胜利的可行途径。 从 v0.2 到 v0.10 的平衡迭代是一个持续九个版本的、以证据为导向的过程,旨在保持财政部作为最强大的模式(符合历史),同时避免游戏设计陷入单一策略。
68
113
 
69
114
  请查看 [`CHANGELOG.md`](./CHANGELOG.md) 文件,了解每个版本的详细变化。
70
115
 
71
116
  ---
72
117
 
73
- ## 可预测性
118
+ ## 确定性
74
119
 
75
- 相同的种子 + 相同的玩家决策 = 跨运行、浏览器和操作系统,完全相同的游戏记录。
120
+ 相同的种子 + 相同的玩家决策 = 跨运行、浏览器和操作系统,账本完全一致。
76
121
 
77
122
  - 单个随机数生成器:`mulberry32(state.rngSeed)`。
78
- - 电脑决策:是基于可见状态的纯函数,并且每个决策都会记录到游戏记录中,并附带触发规则。
79
- - 保存/加载功能会保留状态哈希值。
80
- - 回放功能会从 `initialState(seed) + decisionLog` 重新构建游戏。
81
- - 在 v0.2 到 v0.10 的平衡性迭代过程中,通过 1000 多个可预测的游戏进行了验证。
123
+ - AI 决策:是基于可见状态的纯函数,并且每个决策都会记录到账本中,并附带触发规则。
124
+ - 保存/加载功能会保留状态哈希。
125
+ - 回放功能可以从 `initialState(seed) + decisionLog` 重建游戏。
126
+ - 在 v0.2 到 v0.10 的平衡迭代过程中,经过了 1000 多次确定性游戏的验证。
82
127
 
83
128
  ---
84
129
 
@@ -86,7 +131,7 @@ Sovereign 的核心思想是,**公共信贷 + 联邦财政** 是亚历山大·
86
131
 
87
132
  Sovereign 是一款独立的、基于浏览器的棋盘游戏。命令行界面会在您的默认浏览器中打开一个本地 HTML 文件。它没有服务器,没有网络调用,没有账户,也没有云同步。
88
133
 
89
- - **涉及的数据:** `release/` 目录中的 HTML 文件(只读),以及 `sovereign.autosave` 键下的 `localStorage`(仅用于游戏存档)。
134
+ - **涉及的数据:** `release/` 目录中的 HTML 文件(只读),以及 `sovereign.autosave` 键下的 `localStorage`(仅用于游戏存档状态)。
90
135
  - **未涉及的数据:** 不会访问包目录之外的文件系统,不会进行任何类型的网络请求,不会收集任何遥测数据,不会进行任何分析,不会存储任何凭据。
91
136
  - **所需权限:** 能够启动操作系统默认浏览器,能够读取包自身的配置文件,以及可选的浏览器 `localStorage` 访问权限。
92
137
  - **绝不收集任何遥测数据。** 模拟器的“遥测”功能指的是从浏览器中的账本中提取的本地游戏分析报告,这些报告永远不会离开您的设备。
@@ -97,15 +142,15 @@ Sovereign 是一款独立的、基于浏览器的棋盘游戏。命令行界面
97
142
 
98
143
  ## 功能
99
144
 
100
- - **单人 7 轮游戏:** 对抗两个预设的对手(默认情况下为财政/金融和商人/基础设施;制造商/工业模式可用于批量游戏)。
101
- - **确定性人工智能:** 每一个对手的决策都是基于可见状态的纯函数,并带有账本记录的理由。没有 LLM,没有不透明的魔法。
102
- - **8 个游戏界面:** 棋盘、财政面板、资产检查器、事件面板、国会法案、共享轨道、回合日志/账本、游戏结束报告。
103
- - **拍卖:** 未被选择的资产将进入多玩家拍卖,采用基于配置文件的预设竞标策略。
145
+ - **单人 7 轮游戏:** 对抗两个预设的对手(默认情况下为财政/金融和商人/基础设施;制造商/工业可用于批量游戏)。
146
+ - **确定性人工智能:** 每一个对手的决策都是对可见状态的纯函数运算,并带有账本记录的理由。没有 LLM,没有不透明的魔法。
147
+ - **8 个游戏界面:** 棋盘、财政面板、资产检查器、事件抽屉、国会法案、共享轨道、回合日志/账本、游戏结束报告。
148
+ - **拍卖:** 放弃的资产将进入多玩家拍卖,采用基于配置文件的预设竞标策略。
104
149
  - **保存/加载:** 每回合自动保存到 `localStorage`,支持手动导出/导入 JSON 文件,加载时进行哈希完整性检查,并根据版本进行限制。
105
- - **回放:** 可以对任何已完成的游戏进行完整的回放。只读。通过种子数据和决策日志进行重建,并带有绿色的完整性验证标志。
106
- - **批量模拟:** 运行 10/50/100 轮确定性游戏,针对任何配置组合,并导出 JSON 和 HTML 报告以进行平衡性分析。
107
- - **历史叙述:** 从账本中提取的 25 条条目(默认情况下为 40-60 个单词,扩展版本为 150-200 个单词,游戏结束时为约 300-500 个单词的概要)。不会改变游戏状态。
108
- - **可访问性:** 完整的键盘导航,焦点指示器,屏幕阅读器友好的标签,可以以文本形式读取的数值(而不仅仅是标记),最小字体为 14px,尊重减少动画设置。
150
+ - **回放:** 可以对任何已完成的游戏进行完整的回放。只读。通过种子值和决策日志进行重建,并带有绿色的完整性验证。
151
+ - **批量模拟:** 运行 10/50/100 局确定性游戏,针对任何配置组合,并导出 JSON 和 HTML 报告以进行平衡分析。
152
+ - **历史叙述:** 从账本中提取的 25 条条目(默认情况下为 40-60 个单词,扩展为 150-200 个单词,游戏结束时为约 300-500 个单词的共和国总结)。不会改变游戏状态。
153
+ - **可访问性:** 完整的键盘导航,焦点指示器,屏幕阅读器友好的标签,可以以文本形式读取的数值(而不是仅作为标记),最小字体为 14px,尊重减少动画设置。
109
154
 
110
155
  ---
111
156
 
@@ -113,20 +158,20 @@ Sovereign 是一款独立的、基于浏览器的棋盘游戏。命令行界面
113
158
 
114
159
  | 配置 | 资产优先级 | 优势 | 劣势 |
115
160
  |--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
116
- | **Treasury / Finance** | NF > 州债务 > 营收债务 > 银行 > 铸币厂 | 公共信用增长 | 无基础设施收入 |
117
- | **Merchant / Infrastructure** | 航线 (全部 4 条) > 商业 > 改善 > 收入 | 航线等级 | 无工业产能评分 |
118
- | **Manufacturer / Industry** | 制造业 > 战略工业 > 改善 > 银行 | 产能倍数 | 开局较慢;获得初始特许权 |
161
+ | **Treasury / Finance** | NF > 州债务 > 财政债务 > 银行 > 铸币厂 | 公共信用增长 | 无基础设施收入 |
162
+ | **Merchant / Infrastructure** | 路线 (全部 4 条) > 商业 > 改进 > 收入 | 路线等级 | 无工业产能评分 |
163
+ | **Manufacturer / Industry** | 制造业 > 战略工业 > 改进 > 银行 | 产能倍数 | 开局较慢;获得初始特许权 |
119
164
 
120
- 第四个概念性配置文件(机会主义者/现金)已推迟。当前 v0.10 版本中可用的竞争配置组合为三个。
165
+ 第四个概念文档配置(机会主义者/现金)已推迟。当前 v0.10 版本中可用的竞争配置为三个。
121
166
 
122
167
  ---
123
168
 
124
169
  ## 已知问题
125
170
 
126
- - **产能阈值在标准游戏中仍然很少出现。** 最终平均产能为 3.49;只有在 4/100 游戏中达到 ≥ 6。游戏结束时的工业产能评分是一个上限,而不是常规的路径。
127
- - **财政/金融配置仍然是最强的,** 处于目标范围内。这符合历史论证:公共信用和联邦财政是汉密尔顿的主要经济杠杆。
128
- - **失败事件在 v0.10 版本的测试中从未触发过(0/400 次)。** 默认/叛乱/破产威胁目前只是装饰性的;未来的版本可能会重新考虑失败状态的压力。
129
- - **仅进行模拟测试。** 平衡性是根据 v0.3 → v0.10 版本中的 1000 多个确定性游戏进行验证的。尚未进行人类游戏测试;战略偏差可能会改变这些数值。
171
+ - **产能阈值在标准游戏中仍然很少出现。** 最终平均产能为 3.49;只有在 4/100 局游戏中达到 ≥ 6。游戏结束时的工业评分仅作为上限,而不是常规的路径。
172
+ - **财政/金融配置仍然有意地是最强的,** 处于目标范围内。这符合历史论证:公共信用和联邦财政是汉密尔顿的主要经济杠杆。
173
+ - **在 v0.10 版本的测试中,失败事件触发了 0/400 次。** 默认/叛乱/破产威胁目前仅为装饰;未来的版本可能会重新考虑失败状态的压力。
174
+ - **仅进行模拟测试。** 平衡是通过对 v0.3 → v0.10 版本中的 1000+ 局确定性游戏进行的验证。尚未进行人类游戏测试;战略偏差可能会改变这些数值。
130
175
 
131
176
  ---
132
177
 
@@ -141,13 +186,13 @@ npm run verify # full verify (smoke + pack-dry-run + CLI flag check)
141
186
  npm run play # open the game locally
142
187
  ```
143
188
 
144
- 发布版本会通过 GitHub Actions (`release.yml`) 推送到 npm,并在 `v*` 标签推送时进行 Sigstore 来源证明。 权威版本位于 `main` 分支。
189
+ 通过 GitHub Actions(`release.yml`)在 `v*` 标签推送时,会将版本发布到 npm,并附带 Sigstore 的来源证明。`main` 分支是最终版本来源。
145
190
 
146
191
  ---
147
192
 
148
193
  ## 许可证
149
194
 
150
- MIT © mcp-tool-shop 参见 [`LICENSE`](./LICENSE)。
195
+ MIT © mcp-tool-shop。请参阅 [`LICENSE`](./LICENSE)。
151
196
 
152
197
  ---
153
198
 
@@ -155,4 +200,4 @@ MIT © mcp-tool-shop。 参见 [`LICENSE`](./LICENSE)。
155
200
 
156
201
  由 <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> 构建。
157
202
 
158
- </div>
203
+ </div
package/bin/sovereign.js CHANGED
@@ -7,7 +7,7 @@
7
7
  * release/digital-mode/sovereign-solo.html file.
8
8
  *
9
9
  * Flags:
10
- * --print Open the printable 34-sheet board game prototype instead.
10
+ * --print Open the printable 34-sheet board game instead.
11
11
  * --start Open the START-HERE landing page (audience-routed entry).
12
12
  * --path Print the file path of the playable HTML and exit.
13
13
  * --quiet Silent on success (only errors print).
@@ -32,7 +32,7 @@ const PKG_ROOT = resolve(HERE, '..');
32
32
 
33
33
  const TARGETS = {
34
34
  game: resolve(PKG_ROOT, 'release', 'digital-mode', 'sovereign-solo.html'),
35
- print: resolve(PKG_ROOT, 'release', 'board-game', 'sovereign-prototype.html'),
35
+ print: resolve(PKG_ROOT, 'release', 'board-game', 'sovereign-board-game.html'),
36
36
  start: resolve(PKG_ROOT, 'release', '00-START-HERE.html'),
37
37
  };
38
38
 
@@ -70,7 +70,7 @@ function help() {
70
70
 
71
71
  Usage:
72
72
  sovereign Open the digital board game in your browser.
73
- sovereign --print Open the printable 34-sheet board game prototype.
73
+ sovereign --print Open the printable 34-sheet board game.
74
74
  sovereign --start Open the START-HERE landing page.
75
75
  sovereign --path Print the playable HTML file path and exit.
76
76
  sovereign --quiet Silent on success.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcptoolshop/sovereign",
3
- "version": "1.0.1",
3
+ "version": "1.1.0",
4
4
  "description": "Sovereign — a Hamilton-system economic board game and its solo / digital adaptation. Browser-based, deterministic, self-contained.",
5
5
  "type": "module",
6
6
  "main": "bin/sovereign.js",
@@ -23,7 +23,7 @@
23
23
  "play": "node bin/sovereign.js"
24
24
  },
25
25
  "devDependencies": {
26
- "c8": "^10.1.3"
26
+ "c8": "^11.0.0"
27
27
  },
28
28
  "keywords": [
29
29
  "board-game",
@@ -201,7 +201,7 @@
201
201
  <span class="tag">Designer</span>
202
202
  <div class="name">Read the design</div>
203
203
  <div class="desc">Start with the printable board game, then the solo / digital concept document that defined the digital adaptation before any code was written.</div>
204
- <a href="board-game/sovereign-prototype.html">Board game →</a>
204
+ <a href="board-game/sovereign-board-game.html">Board game →</a>
205
205
  &nbsp; · &nbsp;
206
206
  <a href="design-history/01-phase1-concept.html">Concept →</a>
207
207
  </div>
@@ -275,7 +275,7 @@
275
275
 
276
276
  <h3>Board game</h3>
277
277
  <div class="files">
278
- <a href="board-game/sovereign-prototype.html">sovereign-prototype.html</a><span class="desc">The printable 34-sheet board game. Open in browser, then print to PDF.</span>
278
+ <a href="board-game/sovereign-board-game.html">sovereign-board-game.html</a><span class="desc">The printable 34-sheet board game. Open in browser, then print to PDF.</span>
279
279
  <a href="board-game/sovereign-economy-audit.html">sovereign-economy-audit.html</a><span class="desc">FC-EM-002 corrected expected-value economy audit.</span>
280
280
  <a href="board-game/sovereign-print-audit.html">sovereign-print-audit.html</a><span class="desc">Print / digital usability audit.</span>
281
281
  </div>
@@ -5,9 +5,60 @@
5
5
 
6
6
  ---
7
7
 
8
+ ## v1.1.0 — Failure-system foundation + whole-game visual polish — 2026-05-20
9
+
10
+ Promotes the v0.18 failure-pressure foundation and the whole-game visual polish pass to the canonical Sovereign Solo / Digital Mode release surface. The digital artifact ships at `release/digital-mode/sovereign-solo.html`; the prior v0.10 canonical is archived alongside it as `sovereign-solo-v0.10-baseline.html`. The in-HTML `SAVE_VERSION` remains `'v0.18-candidate'` — no mechanic changed across the polish pass.
11
+
12
+ **Three-tier failure system (new in v1.1.0):**
13
+
14
+ | Tier | Trigger | Severity | Effect | Reset |
15
+ |---|---|---|---|---|
16
+ | Credit Crisis | Public Credit ≤ 4 (first time per game) | warning | Resistance +1, System log | none |
17
+ | Rebellion | Public Resistance 12 | catastrophe | Revenue upgrades destroyed; Whiskey owner → Crisis | resistance → 6 |
18
+ | Default | Public Credit 0 | catastrophe | 50% cash + 1 upgrade per player | credit → 3 |
19
+
20
+ **Failure-pressure arc (v0.11 → v0.18) — what shipped:**
21
+
22
+ - Bank Run drops Public Credit -1 + Industrial Capacity -1 (v0.11).
23
+ - Speculation Fever drops Public Credit -1 + Resistance +1 + auctions an unowned Rev/State Debt property (v0.13).
24
+ - Anti-Federalist Pamphlet adds Public Credit -1 to its existing Resistance +1 + 30 TN per Revenue-System property hit (v0.16).
25
+ - Speculation Fever fragile-credit escalation: Credit -1 at Credit ≥ 7, Credit -2 at Credit ≤ 6 (v0.17).
26
+ - Credit Crisis intermediate failure event at Credit ≤ 4 (v0.18).
27
+
28
+ **Why v0.14 / v0.15 recovery gates were rejected:** mechanically correct but aggregate-inert. The v0.16 → v0.18 chain pivoted to pressure-side changes rather than recovery-side gates.
29
+
30
+ **Whole-game visual polish (presentation only, mechanics byte-identical):**
31
+
32
+ All 16 player-facing surfaces art-directed as one Federalist Treasury system: topbar wordmark; first-load orientation overlay; board tile crests with corner glyphs and system color bands; ledger row severity treatments for `CREDIT_CRISIS` / `DEFAULT` / `REBELLION`; tracks panel warning bands; distinct Market Shock vs Republic Debate card chrome; endgame posture chips + drop-cap narration; "Balance Evidence Run" batch modal; responsive ≤ 768 px breakpoint; print stylesheet. Design-system reference under `release/design-system/`.
33
+
34
+ **Mechanics-preservation evidence:** v0.18 promotion audit 44 / 44 PASS. CANONICAL-400 balance bands held: Treasury 60.0 % / Merchant 23.5 % / Manufacturer 16.5 %. 100-seed canonical state hash 3189375454 byte-identical between Node sim and polished HTML.
35
+
36
+ **Caveat:** v0.18 mechanics are simulation-verified, not yet human-playtested.
37
+
38
+ Translation re-run required (README.md changed). Translations run locally via TranslateGemma before tag push.
39
+
40
+ ---
41
+
42
+ ## v1.0.2 — Branding correction: it's a board game, not a "prototype" — 2026-05-19
43
+
44
+ The product is shipped, signed, versioned, and on npm. "Prototype" language was design-time scaffolding that should have been retired at v1.0.0. This release removes that language across all user-facing surfaces.
45
+
46
+ **Changes:**
47
+
48
+ - Renamed `release/board-game/sovereign-prototype.html` → `release/board-game/sovereign-board-game.html`. Updated `bin/sovereign.js` `--print` resolution and the smoke tests to match.
49
+ - Swept "prototype" out of README.md, CHANGELOG.md, release/README.txt, release/00-START-HERE.html, release/board-game/README.txt, release/board-game/V0.10-RULES-ALIGNMENT.md, site/src/site-config.ts, site/src/content/docs/handbook/getting-started.md, site/src/content/docs/handbook/reference.md, site/src/content/docs/handbook/design-history.md, bin/sovereign.js, and test/smoke.test.mjs.
50
+ - Replacement language: "printable edition" or "printable board game" depending on context. The board game stays at v0.2 balance per the existing freeze; nothing in the rules changes.
51
+ - Historical phase names that contained "prototype" (e.g. "Phase 2 — Static clickable prototype") and audit document titles that contained "Prototype" remain unchanged — those are accurate archival references to the named build phases and the original audit document title. They live in `design-history/` and the print-audit's own title.
52
+
53
+ No game-logic, balance, or behavior changes. CLI flags unchanged. Existing v1.0.0 / v1.0.1 saves still load.
54
+
55
+ Translation re-run required (README.md changed). User runs polyglot locally before tag push.
56
+
57
+ ---
58
+
8
59
  ## v1.0.1 — Printable v0.10 Rules Alignment Delta — 2026-05-19
9
60
 
10
- Adds `release/board-game/V0.10-RULES-ALIGNMENT.md`: a delta sheet that lists the eight rule changes a physical table would apply on top of the v0.2 printable prototype to play at v0.10 balance. The board-game prototype HTML itself remains frozen at v0.2 (no human-table playtest has been run); this delta is opt-in for groups reprinting at v0.10 rules.
61
+ Adds `release/board-game/V0.10-RULES-ALIGNMENT.md`: a delta sheet that lists the eight rule changes a physical table would apply on top of the v0.2 printable edition to play at v0.10 balance. The printable board-game HTML itself remains frozen at v0.2 (no human-table playtest has been run); this delta is opt-in for groups reprinting at v0.10 rules.
11
62
 
12
63
  The eight deltas: Industrial Charter setup grant · Capacity +1 on first industrial purchase · Capacity ≥ 8 payment bonus +25% → +50% · Capacity ≥ 10 industrial milestone (new) · Full Mfg / Strategic set completion bonuses (new) · Cash IP scoring 1 per 200 TN → 1 per 400 TN · NF Credit endgame bonus 5-IP-split → +1/+2 per qualifying owner · Report on Manufactures capital event (now includes 50 TN per Mfg/Strategic owned + Strategic upgrade halving).
13
64
 
@@ -8,7 +8,7 @@ WHAT THIS IS
8
8
 
9
9
  Sovereign is a Hamilton-system board game and its solo / digital adaptation.
10
10
 
11
- The board game is a 40-space Monopoly-grammar prototype about the founding of
11
+ The board game is a 40-space Monopoly-grammar tabletop game about the founding of
12
12
  US public credit. Three Hamiltonian profiles - Treasury / Finance, Merchant /
13
13
  Infrastructure, and Manufacturer / Industry - compete on an Influence scoring
14
14
  track across 7 laps. Acts of Congress pass in their historical order. Public
@@ -28,7 +28,7 @@ WHERE TO START
28
28
  That page hyperlinks every artifact in this release and routes you by audience:
29
29
 
30
30
  - Player : open the digital simulator and play.
31
- - Designer : read the board-game prototype and the concept document.
31
+ - Designer : read the printable board game and the concept document.
32
32
  - Balance : open the v0.10 batch reports and the freeze audit.
33
33
  - Auditor : open the freeze audit and the design-history audits.
34
34
 
@@ -41,7 +41,7 @@ BUNDLE LAYOUT
41
41
  CHANGELOG.md Full v0.2 -> v0.10 evolution.
42
42
 
43
43
  /board-game/
44
- sovereign-prototype.html The printable 34-sheet board game (v0.2).
44
+ sovereign-board-game.html The printable 34-sheet board game (v0.2).
45
45
  sovereign-economy-audit.html FC-EM-002 corrected economy audit.
46
46
  sovereign-print-audit.html Print / digital usability audit.
47
47