@mcptoolshop/sovereign 1.0.0

package/README.it.md

@@ -0,0 +1,158 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.md">English</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<div align="center">
+
+<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" />
+
+**Il gioco da tavolo Hamilton System · versione per giocatore singolo / adattamento digitale**
+
+*Finanziamento iniziale · Gestisci il debito. Costruisci la banca. Industrializza la repubblica.*
+
+[![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)
+[![npm version](https://img.shields.io/npm/v/@mcptoolshop/sovereign.svg)](https://www.npmjs.com/package/@mcptoolshop/sovereign)
+[![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>
+
+---
+
+## Cos'è
+
+Sovereign è un **gioco da tavolo "Hamilton System" ispirato a Monopoly**, incentrato sulla nascita del credito pubblico statunitense, e include un **adattamento completo per giocatore singolo / digitale** che esegue le stesse regole localmente in un browser, contro due avversari simulati e deterministici.
+
+- **Gioco da tavolo** — prototipo stampabile in 34 pagine. Tabellone con 40 caselle, 22 proprietà + 4 tratte + 2 istituzioni, 8 sistemi di colori, 7 atti del Congresso in ordine storico fisso, 4 ruoli per giocatore, 3 percorsi condivisi (Credito Pubblico · Resistenza Pubblica · Capacità Industriale), 12+12 carte evento. Due percorsi economici validi oltre al Tesoro: Mercante e Produttore.
+- **Modalità digitale** — un singolo file HTML autonomo. Macchina a stati completa, generatore di numeri casuali deterministico mulberry32, avversari AI simulati (Tesoro / Finanza, Mercante / Infrastrutture, Produttore / Industria), salvataggio / caricamento con controllo dell'integrità tramite hash, strumento di riproduzione, strumento di simulazione batch, telemetria locale sull'equilibrio.
+- **Equilibrio di base** — v0.10, bloccato dopo un ciclo di nove versioni guidato da oltre 1000 simulazioni deterministiche. Tesoro 59% · Mercante 25% · Produttore 16% (CANONICAL × 100, intervallo target raggiunto per tutti e tre i profili).
+
+---
+
+## Come iniziare
+
+### Gioca nel tuo browser (nessuna installazione richiesta)
+
+```bash
+npx @mcptoolshop/sovereign
+```
+
+L'interfaccia a riga di comando (CLI) apre il gioco nel tuo browser predefinito. Nessun installatore, nessun server, nessuna connessione internet richiesta.
+
+Altre modalità:
+
+```bash
+npx @mcptoolshop/sovereign --print    # Open the printable 34-sheet board game
+npx @mcptoolshop/sovereign --start    # Open the audience-routed landing page
+npx @mcptoolshop/sovereign --path     # Print the playable HTML file path
+npx @mcptoolshop/sovereign --help     # All flags
+```
+
+### Gioca online
+
+Apri la pagina di destinazione ospitata all'indirizzo **<https://mcp-tool-shop-org.github.io/sovereign/>** e avvia il gioco digitale.
+
+### Stampa e gioca
+
+Il prototipo del gioco da tavolo è un documento HTML autonomo in 34 pagine. Apri `release/board-game/sovereign-prototype.html` dal pacchetto (o da un download), quindi `Cmd/Ctrl-P → Salva come PDF → Formato US Letter → 100% di scala`. Ritaglia e gioca.
+
+### Pacchetto di rilascio offline
+
+Ogni rilascio con tag include un pacchetto `sovereign-vX.Y.Z-release.zip` nella sua pagina di rilascio di GitHub. Scaricalo, decomprimilo e apri `00-START-HERE.html` per il punto di accesso specifico per l'utente. Tutto funziona offline.
+
+---
+
+## Perché esiste
+
+La tesi di Sovereign è che **il credito pubblico + la finanza federale** erano la leva economica dominante di Alexander Hamilton, ma un gioco "Hamilton System" deve consentire anche al **commercio** e all'**industria** di essere percorsi validi per la vittoria. Il ciclo di bilanciamento (v0.2 → v0.10) è stata una serie di nove versioni, guidata da dati, per mantenere il Tesoro come il profilo più forte (in linea con la storia) senza far collassare il design in un gioco con una sola strategia.
+
+Consulta [`CHANGELOG.md`](./CHANGELOG.md) per l'evoluzione completa versione per versione.
+
+---
+
+## Determinismo
+
+Lo stesso seme + le stesse decisioni umane = registro identico a livello di byte tra le esecuzioni, i browser e i sistemi operativi.
+
+- Singolo generatore di numeri casuali: `mulberry32(state.rngSeed)`.
+- Decisioni dell'avversario: funzioni pure dello stato visibile, con ogni decisione registrata nel registro insieme alla regola che l'ha attivata.
+- Il salvataggio / caricamento preserva un hash dello stato.
+- La riproduzione ricostruisce dallo `initialState(seed) + decisionLog`.
+- Verificato su oltre 1000 giochi deterministici durante il ciclo di bilanciamento da v0.2 a v0.10.
+
+---
+
+## Modello di minaccia e gestione dei dati
+
+Sovereign è un gioco da tavolo basato su browser, completamente autonomo. L'interfaccia a riga di comando (CLI) apre un file HTML locale nel browser predefinito. Non c'è alcun server, nessuna chiamata di rete, nessun account, nessuna sincronizzazione con il cloud.
+
+- **Dati accessibili:** i file HTML inclusi nella directory `release/` (solo lettura) e lo `localStorage` con la chiave `sovereign.autosave` (solo per salvare lo stato del gioco).
+- **Dati NON accessibili:** nessun accesso al file system al di fuori della directory del pacchetto, nessuna richiesta di rete di alcun tipo, nessuna telemetria, nessuna analisi, nessuna credenziale.
+- **Permessi richiesti:** capacità di avviare il browser predefinito del sistema operativo, capacità di leggere i file del pacchetto stesso, `localStorage` del browser (opzionale).
+- **Nessuna telemetria, mai.** La funzione di "telemetria" del simulatore si riferisce a report di analisi del gioco generati localmente a partire dal registro interno; questi non lasciano mai la tua macchina.
+
+Consultare il file [`SECURITY.md`](./SECURITY.md) per la segnalazione di vulnerabilità e la politica di sicurezza completa.
+
+---
+
+## Funzionalità
+
+- **Gioco in singolo di 7 turni** contro due avversari controllati da script (Treasury / Finance e Merchant / Infrastructure per impostazione predefinita; Manufacturer / Industry disponibile per il gioco in batch).
+- **Intelligenza artificiale deterministica** — ogni decisione dell'avversario è una funzione pura dello stato visibile, con una motivazione registrata. Nessun modello linguistico avanzato (LLM), nessuna logica opaca.
+- **8 superfici di gioco** — Tabellone, Pannello del Tesoro, Ispettore degli Asset, Casella degli Eventi, Atti del Congresso, Tracce Condivise, Registro dei Turni, Report Finale.
+- **Aste** — gli asset rifiutati vengono messi all'asta in un'asta multiplayer con offerte programmate in base al profilo.
+- **Salvataggio / caricamento** — autosalvataggio in `localStorage` ad ogni turno, esportazione / importazione manuale in formato JSON, controllo dell'integrità tramite hash al caricamento, versione specifica.
+- **Riproduzione** — riproduzione completa di qualsiasi partita completata. Solo lettura. Ricostruisce a partire dal seme e dal registro delle decisioni, con un'indicazione di integrità.
+- **Simulazione in batch** — esecuzione di 10 / 50 / 100 partite deterministiche contro qualsiasi combinazione di profili, esportazione di report in formato JSON e HTML per l'analisi dell'equilibrio.
+- **Narrazione storica** — libreria di 25 voci derivate dal registro (descrizioni predefinite di 40-60 parole, espansioni di 150-200 parole, riassunto finale della repubblica di circa 300-500 parole). Non modifica mai lo stato.
+- **Accessibilità** — navigazione completa tramite tastiera, indicatori di focus, etichette significative per i lettori di schermo, valori delle tracce leggibili come testo e non solo come indicatori, dimensione minima del corpo in 14px, rispetto delle impostazioni di riduzione del movimento.
+
+---
+
+## Configurazione dei profili (v0.10)
+
+| Profilo | Priorità degli asset | Punti di forza | Punti deboli |
+|--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
+| **Treasury / Finance**         | NF > Debito statale > Debito delle entrate > Banca > Zecca | Aumento del credito pubblico | Nessun reddito dalle infrastrutture |
+| **Merchant / Infrastructure**  | Rotte (tutte e 4) > Commercio > Miglioramenti > Entrate | Scala delle rotte | Nessun punteggio della capacità industriale |
+| **Manufacturer / Industry**    | Produzione > Industria strategica > Miglioramenti > Banca | Moltiplicatori di capacità | Inizio lento; ottiene una Carta iniziale |
+
+Il quarto profilo concettuale (Opportunista / Cash) è stato posticipato. Il set competitivo bloccato della v0.10 è composto da tre profili.
+
+---
+
+## Avvertenze note
+
+- **Le soglie di capacità rimangono rare nel gioco canonico.** La capacità finale media è 3,49; ≥ 6 viene raggiunto solo in 4 / 100 partite. Il punteggio industriale finale esiste come limite massimo, non come percorso regolare.
+- **Il profilo Treasury / Finance rimane intenzionalmente il più forte**, all'interno della fascia target. Questo corrisponde alla tesi storica: il credito pubblico + la finanza federale erano la leva economica dominante di Hamilton.
+- **Gli eventi di fallimento si sono verificati 0 / 400 volte** nella versione di test della v0.10. Le minacce predefinite / ribellione / bancarotta sono attualmente decorative; una versione futura potrebbe rivedere la pressione sullo stato di fallimento.
+- **Testato solo tramite simulazione.** L'equilibrio è validato rispetto a oltre 1.000 partite deterministiche nell'arco dalla v0.3 alla v0.10. Non è ancora stato testato con giocatori umani; la deviazione strategica potrebbe modificare questi valori.
+
+---
+
+## Costruzione e contributo
+
+```bash
+git clone https://github.com/mcp-tool-shop-org/sovereign
+cd sovereign
+npm install
+npm test           # smoke tests
+npm run verify     # full verify (smoke + pack-dry-run + CLI flag check)
+npm run play       # open the game locally
+```
+
+Le versioni vengono pubblicate su npm tramite GitHub Actions (`release.yml`) quando viene eseguito un push con il tag `v*`, e sono accompagnate da una attestazione di provenienza Sigstore. La fonte ufficiale è il ramo `main`.
+
+---
+
+## Licenza
+
+MIT © mcp-tool-shop. Consultare il file [`LICENSE`](./LICENSE).
+
+---
+
+<div align="center">
+
+Creato da <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
+
+</div>

package/README.ja.md

@@ -0,0 +1,158 @@
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<div align="center">
+
+<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" />
+
+**ハミルトン・システム・ボードゲーム · ソロ/デジタル版**
+
+*建国の礎 · 負債を返済する。銀行を設立する。産業を興す。共和国を築く。*
+
+[![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)
+[![npm version](https://img.shields.io/npm/v/@mcptoolshop/sovereign.svg)](https://www.npmjs.com/package/@mcptoolshop/sovereign)
+[![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>
+
+---
+
+## 概要
+
+Sovereignは、**アメリカの公的信用に関するハミルトン・システムを基にしたボードゲーム**であり、さらに、**完全なソロ/デジタル版**も付属しています。このデジタル版は、同じルールに基づいて、ブラウザ上で2つの決定的なAI対戦相手とローカルで動作します。
+
+- **ボードゲーム**：印刷可能な34ページのプロトタイプ。40マス、22の物件地 + 4つのルート + 2つの機関、8つのカラーシステム、7つの議会法（固定された歴史的順序）、4つのプレイヤー役割、3つの共通トラック（公的信用、公的抵抗、産業能力）、12+12枚のイベントカード。財務省以外にも、商人道と製造業者道という2つの経済的戦略が存在します。
+- **デジタルモード**：単一の自己完結型のHTMLファイル。完全なステートマシン、決定的な mulberry32 ランダムナンバージェネレーター、スクリプト化されたAI対戦相手（財務省/金融、商人/インフラ、製造業者/産業）、ハッシュ整合性によるセーブ/ロード機能、リプレイ機能、バッチシミュレーションツール、ローカルのバランスに関するテレメトリー。
+- **バランスの基準**：v0.10。9つのバージョンにわたるシミュレーションゲーム1,000回以上に基づいて調整されました。財務省：59%、商人：25%、製造業者：16%（正攻法 × 100、すべてのプロファイルで目標範囲を達成）。
+
+---
+
+## 始め方
+
+### ブラウザでプレイ (インストール不要)
+
+```bash
+npx @mcptoolshop/sovereign
+```
+
+CLI（コマンドラインインターフェース）を使用すると、ゲームがデフォルトのブラウザで開きます。インストーラー、サーバー、インターネット接続は不要です。
+
+その他のモード：
+
+```bash
+npx @mcptoolshop/sovereign --print    # Open the printable 34-sheet board game
+npx @mcptoolshop/sovereign --start    # Open the audience-routed landing page
+npx @mcptoolshop/sovereign --path     # Print the playable HTML file path
+npx @mcptoolshop/sovereign --help     # All flags
+```
+
+### オンラインでプレイ
+
+**<https://mcp-tool-shop-org.github.io/sovereign/>** にあるランディングページを開き、デジタルゲームをクリックします。
+
+### 印刷してプレイ
+
+ボードゲームのプロトタイプは、自己完結型の34ページのHTMLドキュメントです。パッケージ内の `release/board-game/sovereign-prototype.html` を開くか、ダウンロードしたファイルを開き、`Cmd/Ctrl-P → PDFとして保存 → US Letter → 100%スケール` で保存します。カットしてプレイしてください。
+
+### オフラインリリースバンドル
+
+各リリースには、GitHubのリリースページに `sovereign-vX.Y.Z-release.zip` というバンドルが添付されています。ダウンロードして解凍し、`00-START-HERE.html` を開いてください。すべてオフラインで動作します。
+
+---
+
+## このゲームが存在する理由
+
+Sovereignのテーマは、**公的信用と連邦金融**がアレクサンダー・ハミルトンの経済政策における主要な要素であったというものです。しかし、ハミルトン・システム・ゲームでは、**商業**と**産業**も勝利への有効な道であるべきです。v0.2からv0.10までのバージョンアップは、財務省を最も強力な戦略として維持しつつ（歴史的な事実に基づき）、ゲームが単一の戦略に偏らないようにするための、9つのバージョンにわたる、証拠に基づいた調整でした。
+
+詳細なバージョンごとの変更履歴は、[`CHANGELOG.md`](./CHANGELOG.md) を参照してください。
+
+---
+
+## 決定性
+
+同じシード値と、同じプレイヤーの行動 = 実行ごとに、ブラウザやオペレーティングシステムに関わらず、完全に同一の記録。
+
+- 単一の乱数生成器：`mulberry32(state.rngSeed)`。
+- 相手の行動：可視状態のみに基づいて決定される純粋な関数。すべての行動は、トリガーとなるルールとともに記録に記録されます。
+- セーブ/ロード：状態のハッシュ値を保持します。
+- リプレイ：`initialState(seed) + decisionLog` から再構築されます。
+- v0.2からv0.10までのバランス調整における1,000回以上の決定的なゲームで検証されています。
+
+---
+
+## 脅威モデルとデータ取り扱い
+
+Sovereignは、スタンドアロンで動作するブラウザベースのボードゲームです。CLI（コマンドラインインターフェース）は、デフォルトのブラウザでローカルのHTMLファイルを起動します。サーバー、ネットワーク接続、アカウント、クラウド同期は一切ありません。
+
+- **アクセスされるデータ:** `release/`ディレクトリに含まれるHTMLファイル（読み取り専用）、および`sovereign.autosave`キーの下にある`localStorage`（ゲームのセーブデータのみ）。
+- **アクセスされないデータ:** パッケージディレクトリ外のファイルシステムへのアクセス、あらゆる種類のネットワークリクエスト、テレメトリー、分析、認証情報。
+- **必要な権限:** OSのデフォルトブラウザを起動する能力、パッケージ自身のファイルを読み取る能力、ブラウザの`localStorage`（オプション）。
+- **テレメトリーは一切行いません。** シミュレーターの「テレメトリー」機能は、ブラウザ内の台帳から派生したローカルのゲーム分析レポートを指します。これらはあなたのマシンから一切外部に出ません。
+
+脆弱性報告およびセキュリティポリシーの詳細については、[`SECURITY.md`](./SECURITY.md) を参照してください。
+
+---
+
+## 機能
+
+- **ソロモード：7ラウンドのゲーム**。2つのスクリプト化された対戦相手（デフォルトでは、財務省/金融と、インフラ/商業。製造業/産業はバッチプレイ用）。
+- **決定論的なAI:** 対戦相手のすべての意思決定は、可視状態と台帳に記録された理由に基づいています。LLM（大規模言語モデル）や不透明な仕組みは一切使用していません。
+- **8種類のゲーム画面:** ボード、財務パネル、資産インスペクター、イベント表示、議会法案、共有トラック、ターンログ/台帳、ゲーム終了レポート。
+- **オークション:** 落札されなかった資産は、プロファイルに基づいたスクリプトによる入札が行われるマルチプレイヤーオークションにかけられます。
+- **セーブ/ロード:** 各ターンで`localStorage`に自動保存。手動でJSON形式でエクスポート/インポート可能。ロード時にハッシュ整合性チェックを実施。バージョンによって機能が制限される場合があります。
+- **リプレイ:** 完了したゲーム全体を再生可能。読み取り専用。シードデータと意思決定ログから再構築し、整合性を示すインジケーターを表示します。
+- **バッチシミュレーション:** 任意のプロファイルセットに対して、10/50/100回の決定論的なゲームを実行し、JSON形式とHTML形式のレポートをエクスポートしてバランス分析を行います。
+- **歴史的ナレーション:** 台帳から派生した25件の記述（デフォルトでは40～60語、拡張版では150～200語、ゲーム終了時の要約では約300～500語）。状態を一切変更しません。
+- **アクセシビリティ:** フルキーボード操作、フォーカスインジケーター、スクリーンリーダーに対応したラベル、テキストとして読み取れるトラック値（マーカーとしてだけでなく）、最小フォントサイズ14px、モーション効果の抑制。
+
+---
+
+## プロファイル一覧（v0.10）
+
+| プロファイル | 資産優先順位 | 強み | 弱み |
+|--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
+| **Treasury / Finance**         | NF（国家負債）> 州債 > 歳入債 > 銀行 > 造幣局 | 公的信用の上昇 | インフラ収入なし |
+| **Merchant / Infrastructure**  | ルート（すべて4つ）> 商業 > 改善 > 歳入 | ルートの階層 | 工業生産能力のスコアリングなし |
+| **Manufacturer / Industry**    | 製造業 > 戦略的産業 > 改善 > 銀行 | 生産能力の倍率 | 開始が遅い。開始時にチャーターを獲得する。 |
+
+4つ目のコンセプトドキュメントのプロファイル（Opportunist / Cash）は保留中です。ロックされたv0.10の競争セットは3つです。
+
+---
+
+## 既知の制限事項
+
+- **生産能力の閾値は、通常のプレイでは稀です。** 最終的な平均生産能力は3.49。100回のゲームのうちわずか4回で6以上を達成します。ゲーム終了時の工業生産能力は、上限として存在しますが、一般的な進行ルートではありません。
+- **財務省/金融は、意図的に最も強力なプロファイルです。** これは、目標範囲内にあります。これは、歴史的な視点と一致しています。公的信用と連邦金融は、ハミルトンの主要な経済的手段でした。
+- **失敗イベントは、v0.10の検証テストで0/400回しか発生しませんでした。** デフォルト/反乱/破産のリスクは、現在では装飾的なものです。将来のバージョンで、ゲームオーバーにつながる可能性のあるリスクを再検討するかもしれません。
+- **シミュレーションでのみテスト済み。** バランスは、v0.3からv0.10までの1,000以上の決定論的なゲームで検証されています。まだ人間によるプレイテストは行われていません。戦略的な変更により、これらの数値が変動する可能性があります。
+
+---
+
+## ビルドと貢献
+
+```bash
+git clone https://github.com/mcp-tool-shop-org/sovereign
+cd sovereign
+npm install
+npm test           # smoke tests
+npm run verify     # full verify (smoke + pack-dry-run + CLI flag check)
+npm run play       # open the game locally
+```
+
+リリースは、GitHub Actions (`release.yml`) を使用して、`v*` タグがプッシュされた際に npm に公開されます。Sigstoreによる信頼性の証明も付与されています。真実の源となるのは `main` ブランチです。
+
+---
+
+## ライセンス
+
+MIT © mcp-tool-shop。[`LICENSE`](./LICENSE) を参照してください。
+
+---
+
+<div align="center">
+
+構築者: <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
+
+</div>

package/README.md

@@ -0,0 +1,158 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<div align="center">
+
+<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" />
+
+**The Hamilton System Board Game · solo / digital adaptation**
+
+*Founding Credit · Fund the debt. Build the bank. Industrialize the republic.*
+
+[![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)
+[![npm version](https://img.shields.io/npm/v/@mcptoolshop/sovereign.svg)](https://www.npmjs.com/package/@mcptoolshop/sovereign)
+[![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>
+
+---
+
+## What it is
+
+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.
+
+- **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.
+- **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.
+- **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).
+
+---
+
+## Quick start
+
+### Play in your browser (zero install)
+
+```bash
+npx @mcptoolshop/sovereign
+```
+
+The CLI opens the game in your default browser. No installer, no server, no internet required.
+
+Other modes:
+
+```bash
+npx @mcptoolshop/sovereign --print    # Open the printable 34-sheet board game
+npx @mcptoolshop/sovereign --start    # Open the audience-routed landing page
+npx @mcptoolshop/sovereign --path     # Print the playable HTML file path
+npx @mcptoolshop/sovereign --help     # All flags
+```
+
+### Play online
+
+Open the hosted landing page at **<https://mcp-tool-shop-org.github.io/sovereign/>** and click into the digital game.
+
+### Print and play
+
+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.
+
+### Offline release bundle
+
+Each tagged release attaches a `sovereign-vX.Y.Z-release.zip` bundle to its GitHub Release page. Download it, unzip, and open `00-START-HERE.html` for the audience-routed entry point. Everything runs offline.
+
+---
+
+## Why it exists
+
+The thesis of Sovereign is that **public credit + federal finance** were Alexander Hamilton's dominant economic lever — but a Hamilton-system game must let **commerce** and **industry** also be viable paths to victory. The balance arc (v0.2 → v0.10) was a nine-version, evidence-driven push to keep Treasury as the strongest profile (in line with history) without collapsing the design into a single-strategy game.
+
+See [`CHANGELOG.md`](./CHANGELOG.md) for the full version-by-version evolution.
+
+---
+
+## Determinism
+
+Same seed + same human decisions = byte-identical ledger across runs, browsers, and operating systems.
+
+- Single RNG: `mulberry32(state.rngSeed)`.
+- Opponent decisions: pure functions of visible state, with every decision logged to the ledger with its triggering rule.
+- Save / load roundtrip preserves a state hash.
+- Replay reconstructs from `initialState(seed) + decisionLog`.
+- Verified across 1,000+ deterministic games during the v0.2 → v0.10 balance arc.
+
+---
+
+## Threat model & data handling
+
+Sovereign is a self-contained browser-based board game. The CLI opens a local HTML file in your default browser. There is no server, no network call, no account, no cloud sync.
+
+- **Data touched:** the included HTML files in `release/` (read-only) and `localStorage` under the `sovereign.autosave` key (game save state only).
+- **Data NOT touched:** no filesystem access outside the package directory, no network requests of any kind, no telemetry, no analytics, no credentials.
+- **Permissions required:** ability to spawn the OS default browser, ability to read the package's own files, browser `localStorage` (optional).
+- **No telemetry, ever.** The simulator's "telemetry" feature refers to local game-analysis reports derived from the in-browser ledger; these never leave your machine.
+
+See [`SECURITY.md`](./SECURITY.md) for vulnerability reporting and the full security policy.
+
+---
+
+## Features
+
+- **Solo 7-lap game** vs. two scripted opponents (Treasury / Finance and Merchant / Infrastructure by default; Manufacturer / Industry available for batch play).
+- **Deterministic AI** — every opponent decision is a pure function of visible state with a ledgered reason. No LLM, no opaque magic.
+- **8 game surfaces** — Board, Treasury Panel, Asset Inspector, Event Drawer, Acts of Congress, Shared Tracks, Turn Log / Ledger, Endgame Report.
+- **Auctions** — declined assets go to multi-player auction with profile-driven scripted bidding.
+- **Save / load** — autosave to `localStorage` on every turn, manual JSON export / import, hash integrity check on load, version-gated.
+- **Replay** — full scrubber over any completed game. Read-only. Reconstructs from seed + decisionLog with a green integrity pill.
+- **Batch simulation** — run 10 / 50 / 100 deterministic games against any profile triplet, export JSON + HTML reports for balance analysis.
+- **Historical narration** — 25-entry library derived from the ledger (40–60 word defaults, 150–200 word expansions, ~300–500 word endgame republic summary). Never mutates state.
+- **Accessibility floor** — full keyboard navigation, focus indicators, screen-reader-meaningful labels, track values readable as text not only as markers, 14px minimum body, reduce-motion respect.
+
+---
+
+## Profile lineup (v0.10)
+
+| Profile                        | Asset priority                                                | Strength             | Weakness                            |
+|--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
+| **Treasury / Finance**         | NF > State Debt > Rev Debt > Bank > Mint                      | Public Credit ramp   | No Infrastructure income            |
+| **Merchant / Infrastructure**  | Routes (all 4) > Commerce > Improvements > Revenue            | Route ladder         | No industrial Capacity scoring      |
+| **Manufacturer / Industry**    | Mfg > Strategic Industry > Improvements > Bank                | Capacity multipliers | Slow start; gets a starting Charter |
+
+The fourth concept-doc profile (Opportunist / Cash) is deferred. The locked v0.10 competitive set is three.
+
+---
+
+## Known caveats
+
+- **Capacity thresholds remain rare in canonical play.** Avg final Capacity is 3.49; ≥ 6 reached in only 4 / 100 games. The endgame industrial scoring exists as a ceiling, not a regular path.
+- **Treasury / Finance remains intentionally strongest**, within the target band. This matches the historical thesis: public credit + federal finance were Hamilton's dominant economic lever.
+- **Failure events fired 0 / 400 times** in the v0.10 evidence pass. Default / Rebellion / Bankruptcy threats are currently decorative; a future version may revisit fail-state pressure.
+- **Simulation-tested only.** Balance is validated against 1,000+ deterministic games across the v0.3 → v0.10 arc. Not yet human-playtested; strategic deviation may shift these rates.
+
+---
+
+## Building and contributing
+
+```bash
+git clone https://github.com/mcp-tool-shop-org/sovereign
+cd sovereign
+npm install
+npm test           # smoke tests
+npm run verify     # full verify (smoke + pack-dry-run + CLI flag check)
+npm run play       # open the game locally
+```
+
+Releases are published to npm via GitHub Actions (`release.yml`) on `v*` tag push, with Sigstore provenance attestation. Source-of-truth is the `main` branch.
+
+---
+
+## License
+
+MIT © mcp-tool-shop. See [`LICENSE`](./LICENSE).
+
+---
+
+<div align="center">
+
+Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
+
+</div>

package/README.pt-BR.md

@@ -0,0 +1,158 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.md">English</a>
+</p>
+
+<div align="center">
+
+<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" />
+
+**O Jogo de Tabuleiro Hamilton · Adaptação solo / digital**
+
+*Fundamento do Crédito Público · Financiamento da dívida. Construção do banco. Industrialização da república.*
+
+[![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)
+[![npm version](https://img.shields.io/npm/v/@mcptoolshop/sovereign.svg)](https://www.npmjs.com/package/@mcptoolshop/sovereign)
+[![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>
+
+---
+
+## O que é
+
+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).
+
+---
+
+## Como começar
+
+### Jogue no seu navegador (sem instalação)
+
+```bash
+npx @mcptoolshop/sovereign
+```
+
+O CLI abre o jogo no seu navegador padrão. Não requer instalador, servidor ou internet.
+
+Outros modos:
+
+```bash
+npx @mcptoolshop/sovereign --print    # Open the printable 34-sheet board game
+npx @mcptoolshop/sovereign --start    # Open the audience-routed landing page
+npx @mcptoolshop/sovereign --path     # Print the playable HTML file path
+npx @mcptoolshop/sovereign --help     # All flags
+```
+
+### Jogar online
+
+Abra a página de destino hospedada em **<https://mcp-tool-shop-org.github.io/sovereign/>** e clique no jogo digital.
+
+### Imprimir e jogar
+
+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
+
+Cada lançamento marcado anexa um pacote `sovereign-vX.Y.Z-release.zip` à sua página de lançamento do GitHub. Baixe-o, descompacte e abra `00-START-HERE.html` para o ponto de entrada direcionado ao público. Tudo funciona offline.
+
+---
+
+## Por que ele existe
+
+A tese de Sovereign é que o **crédito público + finanças federais** foram a principal alavancagem econômica de Alexander Hamilton — mas um jogo do sistema Hamilton deve permitir que o **comércio** e a **indústria** também sejam caminhos viáveis para a vitória. O arco de equilíbrio (v0.2 → v0.10) foi um esforço de nove versões, baseado em evidências, para manter o Tesouro como o perfil mais forte (de acordo com a história) sem transformar o design em um jogo de uma única estratégia.
+
+Veja [`CHANGELOG.md`](./CHANGELOG.md) para a evolução completa, versão por versão.
+
+---
+
+## Determinismo
+
+A mesma semente + as mesmas decisões humanas = registro idêntico em bytes em várias execuções, navegadores e sistemas operacionais.
+
+- RNG único: `mulberry32(state.rngSeed)`.
+- Decisões do oponente: funções puras do estado visível, com cada decisão registrada no registro junto com sua regra de disparo.
+- Salvar / carregar preserva um hash de estado.
+- A reprodução reconstrói a partir de `initialState(seed) + decisionLog`.
+- Verificado em mais de 1.000 jogos determinísticos durante o arco de equilíbrio v0.2 → v0.10.
+
+---
+
+## Modelo de ameaças e tratamento de dados
+
+Sovereign é um jogo de tabuleiro baseado em navegador, autônomo. A interface de linha de comando (CLI) abre um arquivo HTML local no seu navegador padrão. Não há servidor, nenhuma chamada de rede, nenhuma conta, nenhuma sincronização na nuvem.
+
+- **Dados acessados:** os arquivos HTML incluídos no diretório `release/` (somente leitura) e o armazenamento local (`localStorage`) sob a chave `sovereign.autosave` (apenas para salvar o estado do jogo).
+- **Dados NÃO acessados:** nenhum acesso ao sistema de arquivos fora do diretório do pacote, nenhuma solicitação de rede de qualquer tipo, nenhuma telemetria, nenhuma análise, nenhuma credencial.
+- **Permissões necessárias:** capacidade de abrir o navegador padrão do sistema operacional, capacidade de ler os arquivos do próprio pacote, armazenamento local (`localStorage`) do navegador (opcional).
+- **Nenhuma telemetria, nunca.** O recurso de "telemetria" do simulador se refere a relatórios de análise do jogo gerados localmente a partir do livro-razão (ledger) exibido no navegador; esses relatórios nunca saem do seu computador.
+
+Consulte o arquivo [`SECURITY.md`](./SECURITY.md) para relatar vulnerabilidades e consultar a política de segurança completa.
+
+---
+
+## Recursos
+
+- **Jogo solo de 7 voltas** contra dois oponentes programados (Treasury / Finance e Merchant / Infrastructure por padrão; Manufacturer / Industry disponível para jogos em lote).
+- **Inteligência artificial determinística** — cada decisão do oponente é uma função pura do estado visível, com uma justificativa registrada no livro-razão. Sem LLM (Large Language Model), sem "magia" obscura.
+- **8 superfícies de jogo** — Quadro, Painel do Tesouro, Inspetor de Ativos, Painel de Eventos, Atos do Congresso, Trilhas Compartilhadas, Registro de Turnos / Livro-Razão, Relatório de Fim de Jogo.
+- **Leilões** — ativos rejeitados vão para leilão multiplayer com lances programados baseados no perfil.
+- **Salvar / carregar** — salvamento automático no `localStorage` a cada turno, exportação/importação manual em formato JSON, verificação de integridade por hash ao carregar, versão controlada.
+- **Revisão** — reprodução completa de qualquer jogo concluído. Somente leitura. Reconstroi a partir da semente (seed) + registro de decisões, com uma verificação de integridade.
+- **Simulação em lote** — execute 10/50/100 jogos determinísticos contra qualquer combinação de perfis, exporte relatórios em formato JSON + HTML para análise de equilíbrio.
+- **Narração histórica** — biblioteca de 25 entradas derivada do livro-razão (descrições padrão de 40 a 60 palavras, expansões de 150 a 200 palavras, resumo da república no final do jogo com aproximadamente 300 a 500 palavras). Nunca altera o estado do jogo.
+- **Acessibilidade** — navegação completa por teclado, indicadores de foco, rótulos significativos para leitores de tela, valores das trilhas legíveis como texto e não apenas como marcadores, tamanho mínimo de fonte de 14px, respeito às configurações de redução de animações.
+
+---
+
+## Conjunto de perfis (v0.10)
+
+| Perfil | Prioridade de ativos | Força | Fraqueza |
+|--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
+| **Treasury / Finance**         | NF > Dívida Estatal > Dívida Revolutiva > Banco > Moeda | Aumento do crédito público | Sem renda de infraestrutura |
+| **Merchant / Infrastructure**  | Rotas (todas as 4) > Comércio > Melhorias > Receita | Escada de rotas | Sem pontuação de capacidade industrial |
+| **Manufacturer / Industry**    | Manufatura > Indústria Estratégica > Melhorias > Banco | Multiplicadores de capacidade | Começo lento; recebe uma Carta inicial |
+
+O quarto perfil conceitual (Oportunista / Caixa) está adiado. O conjunto competitivo bloqueado na v0.10 é de três.
+
+---
+
+## Observações
+
+- **Os limites de capacidade permanecem raros no jogo padrão.** A capacidade final média é de 3,49; ≥ 6 é alcançada em apenas 4/100 jogos. A pontuação industrial no final do jogo existe como um limite máximo, não como um caminho comum.
+- **O perfil Treasury / Finance permanece intencionalmente o mais forte**, dentro da faixa alvo. Isso corresponde à tese histórica: o crédito público + as finanças federais eram o principal instrumento econômico de Hamilton.
+- **Eventos de falha ocorreram 0 / 400 vezes** na versão de teste da v0.10. As ameaças de falha (default, rebelião, falência) são atualmente decorativas; uma versão futura pode reavaliar a pressão para atingir um estado de falha.
+- **Testado apenas em simulação.** O equilíbrio é validado contra mais de 1.000 jogos determinísticos no intervalo v0.3 → v0.10. Ainda não foi testado com jogadores humanos; desvios estratégicos podem alterar essas taxas.
+
+---
+
+## Construção e contribuição
+
+```bash
+git clone https://github.com/mcp-tool-shop-org/sovereign
+cd sovereign
+npm install
+npm test           # smoke tests
+npm run verify     # full verify (smoke + pack-dry-run + CLI flag check)
+npm run play       # open the game locally
+```
+
+As versões são publicadas no npm através do GitHub Actions (`release.yml`) sempre que há um envio (push) na tag `v*`, com a garantia de autenticidade do Sigstore. A fonte de verdade é o ramo `main`.
+
+---
+
+## Licença
+
+MIT © mcp-tool-shop. Consulte o arquivo [`LICENSE`](./LICENSE).
+
+---
+
+<div align="center">
+
+Desenvolvido por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
+
+</div>