@mcptoolshop/sovereign 1.0.2 → 1.1.0

package/README.pt-BR.md

@@ -15,7 +15,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Landing Page](https://img.shields.io/badge/landing-page-1F2D52?style=flat)](https://mcp-tool-shop-org.github.io/sovereign/)
 
-</div>
+</div
 
 ---
 
@@ -23,9 +23,54 @@
 
 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.
 
-- **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.
-- **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.
-- **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).
+- **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.
+- **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.
+- **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).
+- **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.
+
+---
+
+## O que há de novo na versão 1.1.0
+
+### Fundação do sistema de falha
+
+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.
+
+Para tornar a camada de falha realmente visível durante o jogo, quatro cartas de pressão agora reduzem o Crédito:
+
+| Carta | Efeito |
+|---|---|
+| Corrida aos Bancos | Crédito Público −1, Capacidade Industrial −1 |
+| Febre Especulativa (Crédito ≥ 7) | Crédito Público −1, Resistência +1, leilão de Receitas/Dívida Estadual não possuídas |
+| Febre Especulativa (Crédito ≤ 6) | Crédito Público −2, Resistência +1, leilão de Receitas/Dívida Estadual não possuídas |
+| Panfleto Antifederalista | Crédito Público −1, Resistência +1, 30 TN por propriedade do sistema de Receita |
+
+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.
+
+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`.
+
+### Polimento visual do jogo completo
+
+Cada elemento visual voltado para o jogador foi projetado como um produto coerente do Tesouro Federalista:
+
+- Logotipo superior + tag de modo + uma versão discreta (não é mais um cabeçalho do painel de telemetria)
+- Sobreposição de orientação na primeira execução, apresentando as três trilhas e os três níveis de falha
+- Tiles do tabuleiro com cristas nos cantos, faixas de cores do sistema, tratamentos distintos para instituições, rotas, impostos e espaços de eventos
+- 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)
+- 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
+- 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
+- A janela de lote foi renomeada para "Execução de Evidência de Equilíbrio"
+- Quebra de responsividade ≤ 768 px e uma folha de estilo para impressão
+
+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.
+
+### Mecânicas preservadas
+
+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.
+
+### Observação importante
+
+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.
 
 ---
 
@@ -54,7 +99,7 @@ Abra a página de destino hospedada em **<https://mcp-tool-shop-org.github.io/so
 
 ### Imprimir e jogar
 
-O protótipo do jogo de tabuleiro é um documento HTML autônomo de 34 páginas. Abra `release/board-game/sovereign-board-game.html` do pacote (ou de um download), depois `Cmd/Ctrl-P → Salvar como PDF → US Letter → 100% de escala`. Recorte e jogue.
+O protótipo do jogo de tabuleiro é um documento HTML autônomo de 34 páginas. Abra `release/board-game/sovereign-prototype.html` do pacote (ou de um download), depois `Cmd/Ctrl-P → Salvar como PDF → US Letter → 100% de escala`. Recorte e jogue.
 
 ### Pacote de lançamento offline
 
@@ -155,4 +200,4 @@ MIT © mcp-tool-shop. Consulte o arquivo [`LICENSE`](./LICENSE).
 
 Desenvolvido por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
 
-</div>
+</div

package/README.zh.md

@@ -15,7 +15,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Landing Page](https://img.shields.io/badge/landing-page-1F2D52?style=flat)](https://mcp-tool-shop-org.github.io/sovereign/)
 
-</div>
+</div
 
 ---
 
@@ -23,9 +23,54 @@
 
 Sovereign是一款**基于“汉密尔顿系统”的“大富翁”风格棋盘游戏**，讲述的是美国公共信贷的建立，同时还提供一个**完整的单人/数字版本**，它可以在浏览器中本地运行，与两个具有固定行为的AI对手对战。
 
-- **棋盘游戏** — 包含34页的可打印版本。 棋盘包含40个格子，22个房产 + 4条路线 + 2个机构，8种颜色系统，7个国会法案按照固定的历史顺序排列，4种玩家角色，3条共享进度条（公共信贷、公共抵抗、工业能力），12+12张事件卡。 除了财政部，还有两种可行的经济发展路径：商人路径和制造商路径。
-- **数字模式** — 单个独立的HTML文件。 完整的状态机，使用确定性 mulberry32 随机数生成器，具有脚本化的AI对手（财政部/金融、商人/基础设施、制造商/工业），支持保存/加载，并具有哈希完整性校验，支持回放，包含批处理模拟工具，以及本地平衡数据统计。
-- **平衡基准** — v0.10版本，在经过九个版本的迭代后，基于1000多次确定性模拟游戏进行调整。 财政部占比59%，商人占比25%，制造商占比16%（符合规范，所有三种模式都达到目标范围）。
+- **棋盘游戏** — 可打印的34页版本。 棋盘包含40个格子，22个地产 + 4条路线 + 2个机构，8种颜色系统，7部国会法案按照固定的历史顺序排列，4种玩家角色，3条共享进度条（公共信用、公共抵抗、工业能力），12+12张事件卡。 除了财政部之外，还有两种可行的经济发展路径：商人路径和制造商路径。
+- **数字模式** — 单个独立的HTML文件。 完整的状态机，使用deterministic mulberry32随机数生成器，带有脚本化的AI对手（财政部/金融、商人/基础设施、制造商/工业），支持保存/加载并具有哈希完整性，支持重播，包含批量模拟工具，以及本地平衡数据统计。
+- **平衡基准** — v0.10的核心平衡在v1.1.0版本中得到保留。 财政部：60.0%；商人：23.5%；制造商：16.5%（在v0.18版本中经过完善的基础版本，所有三种模式都达到了目标范围）。
+- **失败系统** — 分为三个等级：**信用危机**（公共信用≤4，警告），**叛乱**（公共抵抗12，灾难），**违约**（公共信用0，灾难）。 新增于v1.1.0版本；灾难性的结束条件与v0.10版本相同。
+
+---
+
+## v1.1.0版本的新功能
+
+### 失败系统基础
+
+v1.1.0版本引入了一个可用的三级失败等级系统。 违约，即公共信用为0，仍然是导致金融崩溃的灾难性条件（每个玩家损失50%的现金 + 1个升级）。 叛乱，即公共抵抗为12，仍然是导致政治崩溃的灾难性条件（收入升级被摧毁）。 在这两者之间，新增了一个轻微的中间事件——**信用危机**。 当公共信用降至4或更低时，会触发该事件，增加公共抵抗1点，并在账本中记录一条“系统”行。 它不会重置信用，不会摧毁资产，也不会结束游戏。
+
+为了使失败层级在游戏中真正可见，现在有四张压力卡会降低信用值：
+
+| 卡牌 | 效果 |
+|---|---|
+| 银行挤兑 | 公共信用 -1，工业能力 -1 |
+| 投机狂热（信用≥7） | 公共信用 -1，抵抗 +1，拍卖未拥有收入/国家债务 |
+| 投机狂热（信用≤6） | 公共信用 -2，抵抗 +1，拍卖未拥有收入/国家债务 |
+| 反联邦党宣言 | 公共信用 -1，抵抗 +1，每个收入系统地产损失30个TN |
+
+在第一回合，资助法案仍然会增加+2个信用值。 违约，即公共信用为0，仍然被保留为一种戏剧性的限制，而不是平衡目标——信用危机会发出警报。
+
+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`。
+
+### 整体视觉美化
+
+所有面向玩家的界面都经过艺术设计，使其成为一个统一的联邦财政产品：
+
+- 顶部栏：包含游戏名称、模式标签以及一个不显眼的版本标识（不再是数据统计仪表盘的标题）
+- 首次加载时，会显示一个引导界面，介绍三个进度条和三个失败等级
+- 棋盘：包含角落的徽章，颜色分区分块，以及对机构、路线、税收和事件区域的独特处理
+- 账本行：`信用危机` / `违约` / `叛乱` 会有不同的严重程度标识（颜色 + 边框 + 标签，考虑可访问性）
+- 进度条面板：标记信用危机的警告区域（1–4）以及违约和叛乱的结束点
+- 游戏结束报告：显示姿态芯片（信用姿态/危机状态/叛乱状态），位于分数列上方，并带有明确提及危机/违约/叛乱结果的说明
+- 批量模式：重命名为“平衡数据运行”
+- 响应式设计，支持≤768像素的屏幕，并包含打印样式表。
+
+设计系统参考文档以及包含十五个画面的视觉状态审核文件位于 `release/design-system/` 目录下，这些文件记录了 v1.1.0 版本的界面外观。
+
+### 机制保持不变
+
+v0.18 版本的推广审核通过了所有 44 项检查，涵盖了来源、实现、回归测试、平衡/失败证据以及文档准备情况。 100 个种子值的标准游戏状态哈希值在 v0.18 版本的 Node 模拟和优化后的 HTML 版本之间完全一致（值为 `3189375454`）。 `SAVE_VERSION` 仍然是 `'v0.18-candidate'`，因为在优化过程中，没有任何机制发生改变。
+
+### 注意事项
+
+v1.1.0 版本的机制已通过模拟验证，验证范围包括标准的 T/M/Mfg 三元组（400 个种子值）以及 MFG-MIRROR 变体（100 个种子值）。 但尚未经过人工游戏测试。
 
 ---
 
@@ -155,4 +200,4 @@ MIT © mcp-tool-shop。请参阅 [`LICENSE`](./LICENSE)。
 
 由 <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> 构建。
 
-</div>
+</div

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcptoolshop/sovereign",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Sovereign — a Hamilton-system economic board game and its solo / digital adaptation. Browser-based, deterministic, self-contained.",
   "type": "module",
   "main": "bin/sovereign.js",
@@ -23,7 +23,7 @@
     "play": "node bin/sovereign.js"
   },
   "devDependencies": {
-    "c8": "^10.1.3"
+    "c8": "^11.0.0"
   },
   "keywords": [
     "board-game",

package/release/CHANGELOG.md

@@ -5,6 +5,40 @@
 
 ---
 
+## v1.1.0 — Failure-system foundation + whole-game visual polish — 2026-05-20
+
+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.
+
+**Three-tier failure system (new in v1.1.0):**
+
+| Tier | Trigger | Severity | Effect | Reset |
+|---|---|---|---|---|
+| Credit Crisis | Public Credit ≤ 4 (first time per game) | warning | Resistance +1, System log | none |
+| Rebellion | Public Resistance 12 | catastrophe | Revenue upgrades destroyed; Whiskey owner → Crisis | resistance → 6 |
+| Default | Public Credit 0 | catastrophe | 50% cash + 1 upgrade per player | credit → 3 |
+
+**Failure-pressure arc (v0.11 → v0.18) — what shipped:**
+
+- Bank Run drops Public Credit -1 + Industrial Capacity -1 (v0.11).
+- Speculation Fever drops Public Credit -1 + Resistance +1 + auctions an unowned Rev/State Debt property (v0.13).
+- Anti-Federalist Pamphlet adds Public Credit -1 to its existing Resistance +1 + 30 TN per Revenue-System property hit (v0.16).
+- Speculation Fever fragile-credit escalation: Credit -1 at Credit ≥ 7, Credit -2 at Credit ≤ 6 (v0.17).
+- Credit Crisis intermediate failure event at Credit ≤ 4 (v0.18).
+
+**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.
+
+**Whole-game visual polish (presentation only, mechanics byte-identical):**
+
+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/`.
+
+**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.
+
+**Caveat:** v0.18 mechanics are simulation-verified, not yet human-playtested.
+
+Translation re-run required (README.md changed). Translations run locally via TranslateGemma before tag push.
+
+---
+
 ## v1.0.2 — Branding correction: it's a board game, not a "prototype" — 2026-05-19
 
 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.