@mcptoolshop/sovereign 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,126 @@
+# Sovereign — Changelog
+
+> A Hamilton-system Monopoly-grammar board game and its solo / digital adaptation.
+> Two artifact streams, one design thesis: **debt → credit → bank → industry**.
+
+---
+
+## Board Game
+
+### v0.2 balance candidate — FROZEN 2026-05-18
+
+The printable board-game artifact. 34 US Letter sheets, 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, 5 distinct card backs.
+
+**Balance levers (v0.2 changes from v0.1):**
+
+| Change | Effect |
+|---|---|
+| Route ladder | 25 / 50 / 100 / 200 → **25 / 50 / 100 / 150** (4-route reduced) |
+| Coinage Act | 25 TN per player → **50 TN from each other player + Credit +1 + Capacity +1** |
+| Industrial Capacity thresholds | ≥ 8 and ≥ 10 → **≥ 6 and ≥ 8** (lowered) |
+| Revolutionary Debt bases | Continental 2 / Soldier Pay 4 → **Continental 4 / Soldier Pay 6** |
+
+Supported by:
+- **FC-EM-002 economy audit** — corrected expected-value math after the original audit was rejected for double-counting and total-rent attribution errors.
+- **Print / Digital audit** — usability and accessibility verification for the printable artifact.
+
+---
+
+## Solo / Digital Mode
+
+Layered, fully additive build over the v0.2 balance candidate. Every phase preserves all prior phases byte-identical. Determinism is enforced by `mulberry32(state.rngSeed)` as the sole RNG; opponent decisions are pure functions of visible state.
+
+### Phase 1 — Concept · FROZEN
+Design contract: state model, 8 surfaces, 3 solo modes, 4 opponent profiles spec, acceptance criteria.
+
+### Phase 2 — Static clickable prototype · FROZEN
+8 surfaces rendered with placeholder state, 11-step walkthrough, accessibility floor.
+
+### Phase 3 — Local state machine · FROZEN
+Real reducer / dispatch pattern, seeded determinism, full 7-lap game loop, all 40 spaces, all 24 cards, all 7 Acts, scoring from rules.
+
+### Phase 4 — Scripted opponents · FROZEN
+Migration to `players[]`, two MVP profiles (Treasury / Finance, Merchant / Infrastructure), auction mechanic, multiplayer rent. Plus the Act-vote orchestration maintenance patch.
+
+### Phase 5 — Narration · Replay · Save / Load · FROZEN
+25-entry narration library derived from ledger (does not mutate state). Save / load with hash integrity. Replay scrubber reconstructs from `initialState(seed) + decisionLog`.
+
+### Phase 6 — Local balance telemetry · FROZEN
+Post-game balance report, batch simulation (10 / 50 / 100 games per config), exportable JSON + HTML, Manufacturer / Industry profile (3rd of the 4-profile concept doc roster).
+
+### Phase 6.1 — Telemetry hygiene · FROZEN
+Fixed name-keyed attribution → slot-indexed, split rentNet from netCashFlow, broke out routes / institutions buckets, mirror-batch slot identity preserved.
+
+---
+
+## Balance Evolution (post Phase 6.1)
+
+All driven by deterministic 400-game evidence passes (4 configs × 100 seeds 2026–2125, sometimes also CANONICAL × 400).
+
+### v0.3 — Diagnostic balance attempt
+- NF Credit endgame bonus: `5 IP split among NF owners if Credit ≥ 8` → **`+1 per qualifying NF owner at Credit ≥ 8; +2 at Credit = 12`**.
+- Report on Manufactures: added **`50 TN per Mfg / Strategic owned`** capital event.
+- Capacity ≥ 8 payment boost: +25% → **+50%**.
+
+**Result:** Treasury 76% / Merchant 22% / Manufacturer 2%. Manufacturer cash-starved.
+
+### v0.4 — Industrial scoring layer
+- Industrial Capacity ≥ 10 milestone: **+2 IP per qualifying industrial system, stacking with the ≥ 8 bonus (max +8)**.
+- Industrial set completion bonuses: **full Mfg +3 IP, full Strategic +2 IP**.
+
+**Result:** Treasury 73% / Merchant 21% / Manufacturer 6%. Scoring buffs firing but Capacity track stays cold.
+
+### v0.5 — Capacity dynamics
+- **Industrial Capacity +1** on first acquisition of any Manufactures or Strategic Industry property from unowned state.
+
+**Result:** Treasury 73% / Merchant 21% / Manufacturer 6%. Track moves in MFG-MIRROR but not in CANONICAL.
+
+### v0.6 — Manufacturer policy relax
+- Removed the set-completion gate from Manufacturer / Industry profile decisions. Set completion becomes a tie-break preference, not a buy gate.
+
+**Result:** Treasury 73% / Merchant 22% / Manufacturer 5%. Profile change didn't move the needle.
+
+### v0.7 — Acquisition funnel telemetry (no game change)
+Diagnostic instrumentation: landing opportunities, buy outcomes, cash-at-opportunity, auction access, turn-order geometry, five-hypothesis classifier.
+
+**Finding:** H1 confirmed — slot 2 (where Manufacturer was seated) gets fewer industrial landings (0.45) than slot 0 (0.68) or slot 1 (0.64) due to dice geometry, regardless of profile.
+
+### v0.8 — Manufacturer Industrial Charter
+- At game setup, the first Manufacturer / Industry slot receives **Textile Works** as a starting Industrial Charter (0 TN, Capacity +1). Property counts normally for rent, set completion, Report on Manufactures payouts, and scoring.
+- Diagnostic CANONICAL-SLOT-SWAP control batch (Manufacturer in slot 0, charter disabled) confirms slot and charter effects are approximately interchangeable.
+
+**Result:** Treasury 68% / Merchant 21% / Manufacturer 11%. **Manufacturer enters the 10–25% target band for the first time.**
+
+### v0.9 — Treasury scoring decomposition (no game change)
+Counterfactual analysis per Treasury win: zero out each scoring category, re-rank, count Treasury-still-wins. Thesis-damage ranking selects the cleanest nerf candidate.
+
+**Finding:** `cashIP` is the load-bearing source. Treasury wins drop from 269 / 400 to 71 / 400 when `cashIP` is removed. `cashIP` appears in 93.7% of Treasury wins. NF Credit bonus is decorative; cash hoarding is the load.
+
+### v0.10 — Cash scoring nerf · FROZEN
+- Cash Influence: **1 IP per 200 TN → 1 IP per 400 TN** (floor).
+
+**Result (CANONICAL × 100):** Treasury 59% / Merchant 25% / Manufacturer 16%. **All six balance targets PASS.** CANONICAL × 400 reinforcement: Treasury 61.0%.
+
+---
+
+## Determinism guarantee
+
+Same seed + same human decisions = byte-identical ledger across runs, browsers, and time.
+- Single RNG: `mulberry32(state.rngSeed)`.
+- Opponent decisions: pure functions of visible state.
+- Save / load roundtrip preserves state hash.
+- Replay reconstructs from `initialState(seed) + decisionLog`.
+- Verified across 1,000+ deterministic games during the v0.2 → v0.10 balance arc.
+
+## Operating model
+
+Local-only. No network calls. No accounts. No cloud sync. No LLM opponents.
+The full game, all profiles, all telemetry, and all batch infrastructure live in one self-contained HTML file.
+
+## Known caveats
+
+- Capacity thresholds (≥ 6, ≥ 8, ≥ 10) remain rare in canonical play (≥ 6 reached in only 4 / 100 games). The endgame industrial scoring exists as a ceiling, not a regular path.
+- Treasury remains intentionally the strongest profile, in line with the historical thesis.
+- Failure events (Default / Rebellion / Bankruptcy) fired 0 / 400 times in the v0.10 evidence pass. Their threat is currently decorative.
+- Balance is simulation-tested only. Not yet human-playtested.
+- The Opportunist / Cash profile (4th profile in the concept document) is deferred. The locked v0.10 competitive set is Treasury / Merchant / Manufacturer.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,158 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</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" />
+
+**El juego de mesa "The Hamilton System" · Adaptación para un solo jugador / digital**
+
+*Crédito fundacional · Financia la deuda. Construye el banco. Industrializa la 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>
+
+---
+
+## ¿Qué es?
+
+Sovereign es un **juego de mesa al estilo "Monopoly" basado en el sistema de Hamilton**, que trata sobre la creación del crédito público estadounidense, además de una **adaptación completa para un solo jugador / digital** que ejecuta las mismas reglas localmente en un navegador contra dos oponentes simulados y deterministas.
+
+- **Juego de mesa** — prototipo imprimible de 34 hojas. Tablero de 40 casillas, 22 propiedades + 4 rutas + 2 instituciones, 8 sistemas de colores, 7 leyes del Congreso en orden histórico fijo, 4 roles de jugador, 3 pistas compartidas (Crédito Público · Resistencia Pública · Capacidad Industrial), 12+12 cartas de evento. Dos vías económicas viables además del Tesoro: Comercio y Manufactura.
+- **Modo digital** — un único archivo HTML autocontenido. Máquina de estados completa, generador de números aleatorios determinista mulberry32, oponentes de IA programados (Tesoro / Finanzas, Comercio / Infraestructura, Manufactura / Industria), guardar / cargar con integridad de hash, herramienta de depuración de repeticiones, herramienta de simulación por lotes, telemetría local de equilibrio.
+- **Punto de equilibrio** — v0.10, congelado después de un ciclo de nueve versiones impulsado por más de 1000 simulaciones de juegos deterministas. Tesoro 59% · Comercio 25% · Manufactura 16% (CANÓNICO × 100, el rango objetivo se cumplió para los tres perfiles).
+
+---
+
+## Cómo empezar
+
+### Juega en tu navegador (sin instalación)
+
+```bash
+npx @mcptoolshop/sovereign
+```
+
+La interfaz de línea de comandos (CLI) abre el juego en tu navegador predeterminado. No requiere instalador, servidor ni conexión a Internet.
+
+Otros 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
+```
+
+### Juega en línea
+
+Abre la página de inicio alojada en **<https://mcp-tool-shop-org.github.io/sovereign/>** y haz clic en el juego digital.
+
+### Imprime y juega
+
+El prototipo del juego de mesa es un documento HTML autocontenido de 34 hojas. Abre `release/board-game/sovereign-prototype.html` desde el paquete (o desde una descarga), luego `Cmd/Ctrl-P → Guardar como PDF → Formato US Letter → 100% de escala`. Recorta y juega.
+
+### Paquete de lanzamiento sin conexión
+
+Cada versión etiquetada adjunta un paquete `sovereign-vX.Y.Z-release.zip` a su página de lanzamiento de GitHub. Descárgalo, descomprímelo y abre `00-START-HERE.html` para el punto de entrada específico para el usuario. Todo funciona sin conexión.
+
+---
+
+## ¿Por qué existe?
+
+La tesis de Sovereign es que **el crédito público y las finanzas federales** fueron el principal instrumento económico de Alexander Hamilton, pero un juego basado en el sistema de Hamilton debe permitir que el **comercio** y la **industria** también sean vías viables para la victoria. El ciclo de equilibrio (v0.2 → v0.10) fue un esfuerzo de nueve versiones, basado en evidencia, para mantener al Tesoro como el perfil más fuerte (de acuerdo con la historia) sin convertir el diseño en un juego de una sola estrategia.
+
+Consulta [`CHANGELOG.md`](./CHANGELOG.md) para ver la evolución completa de cada versión.
+
+---
+
+## Determinismo
+
+La misma semilla + las mismas decisiones humanas = un registro idéntico en bytes en cada ejecución, navegador y sistema operativo.
+
+- Único generador de números aleatorios: `mulberry32(state.rngSeed)`.
+- Decisiones del oponente: funciones puras del estado visible, con cada decisión registrada en el registro junto con su regla de activación.
+- Guardar / cargar preserva un hash de estado.
+- La repetición reconstruye a partir de `initialState(seed) + decisionLog`.
+- Verificado en más de 1000 juegos deterministas durante el ciclo de equilibrio de v0.2 a v0.10.
+
+---
+
+## Modelo de amenazas y manejo de datos
+
+Sovereign es un juego de mesa basado en un navegador, que funciona de forma autónoma. La interfaz de línea de comandos (CLI) abre un archivo HTML local en su navegador predeterminado. No hay servidor, ni llamadas de red, ni cuenta, ni sincronización en la nube.
+
+- **Datos accedidos:** los archivos HTML incluidos en el directorio `release/` (solo lectura) y el almacenamiento local (`localStorage`) bajo la clave `sovereign.autosave` (solo para guardar el estado del juego).
+- **Datos NO accedidos:** no hay acceso al sistema de archivos fuera del directorio del paquete, ni solicitudes de red de ningún tipo, ni telemetría, ni análisis, ni credenciales.
+- **Permisos requeridos:** capacidad para abrir el navegador predeterminado del sistema operativo, capacidad para leer los archivos propios del paquete, almacenamiento local (`localStorage`) del navegador (opcional).
+- **No hay telemetría, nunca.** La función de "telemetría" del simulador se refiere a informes de análisis del juego generados localmente a partir del registro interno; estos nunca abandonan su máquina.
+
+Consulte [`SECURITY.md`](./SECURITY.md) para informar de vulnerabilidades y consultar la política de seguridad completa.
+
+---
+
+## Características
+
+- **Juego de 7 rondas** contra dos oponentes controlados por scripts (por defecto, Tesorería/Finanzas y Comerciante/Infraestructura; el Fabricante/Industria está disponible para partidas por lotes).
+- **Inteligencia artificial determinista:** cada decisión del oponente es una función pura del estado visible, con una justificación registrada. No hay modelos de lenguaje grandes (LLM), ni magia opaca.
+- **8 superficies de juego:** Tablero, Panel de Tesorería, Inspector de Activos, Panel de Eventos, Actos del Congreso, Pistas Compartidas, Registro de Turnos/Registro, Informe de Fin de Juego.
+- **Subastas:** los activos rechazados se subastan a varios jugadores con ofertas programadas basadas en el perfil.
+- **Guardar/cargar:** autoguardado en `localStorage` en cada turno, exportación/importación manual de JSON, verificación de la integridad mediante hash al cargar, con control de versiones.
+- **Revisión:** reproducción completa de cualquier juego completado. Solo lectura. Reconstruye a partir de la semilla y el registro de decisiones, con una "píldora" de integridad verde.
+- **Simulación por lotes:** ejecute 10/50/100 juegos deterministas contra cualquier combinación de perfiles, exporte informes de JSON y HTML para el análisis del equilibrio.
+- **Narración histórica:** biblioteca de 25 entradas derivada del registro (descripciones predeterminadas de 40 a 60 palabras, expansiones de 150 a 200 palabras, resumen de la república al final del juego de aproximadamente 300 a 500 palabras). Nunca modifica el estado.
+- **Accesibilidad:** navegación completa con el teclado, indicadores de enfoque, etiquetas significativas para lectores de pantalla, valores de las pistas legibles como texto y no solo como marcadores, tamaño mínimo de fuente de 14px, respeto de la reducción de movimiento.
+
+---
+
+## Conjunto de perfiles (v0.10)
+
+| Perfil | Prioridad de activos | Fortaleza | Debilidad |
+|--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
+| **Treasury / Finance**         | NF > Deuda estatal > Deuda de ingresos > Banco > Casa de la moneda | Aumento del crédito público | Sin ingresos por infraestructura |
+| **Merchant / Infrastructure**  | Rutas (las 4) > Comercio > Mejoras > Ingresos | Escalera de rutas | Sin puntuación de capacidad industrial |
+| **Manufacturer / Industry**    | Fabricación > Industria estratégica > Mejoras > Banco | Multiplicadores de capacidad | Inicio lento; obtiene una Carta inicial |
+
+El cuarto perfil conceptual (Oportunista/Efectivo) se pospone. El conjunto competitivo bloqueado de la versión 0.10 consta de tres.
+
+---
+
+## Limitaciones conocidas
+
+- **Los umbrales de capacidad siguen siendo raros en el juego canónico.** La capacidad final promedio es de 3,49; se alcanza ≥ 6 en solo 4 de cada 100 juegos. La puntuación industrial al final del juego existe como un límite, no como una ruta habitual.
+- **La Tesorería/Finanzas sigue siendo intencionalmente la más fuerte**, dentro del rango objetivo. Esto coincide con la tesis histórica: el crédito público y las finanzas federales fueron el principal instrumento económico de Hamilton.
+- **Los eventos de fallo se activaron 0/400 veces** en la versión de prueba 0.10. Las amenazas predeterminadas de Default/Rebelión/Bancarrota son actualmente decorativas; una versión futura podría revisar la presión de los estados de fallo.
+- **Solo se ha probado en simulación.** El equilibrio se valida contra más de 1000 juegos deterministas en el ciclo de la versión 0.3 a la 0.10. Aún no se ha probado con jugadores humanos; la desviación estratégica puede cambiar estas tasas.
+
+---
+
+## Construcción y contribución
+
+```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
+```
+
+Las versiones se publican en npm a través de GitHub Actions (`release.yml`) al realizar un "push" en la etiqueta `v*`, con la certificación de origen de Sigstore. La fuente de verdad es la rama `main`.
+
+---
+
+## Licencia
+
+MIT © mcp-tool-shop. Consulte el archivo [`LICENSE`](./LICENSE).
+
+---
+
+<div align="center">
+
+Desarrollado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
+
+</div>

package/README.fr.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.md">English</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" />
+
+**Le jeu de société Hamilton · adaptation solo / numérique**
+
+*Crédit fondateur · Financez la dette. Construisez la banque. Industrialisez la république.*
+
+[![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>
+
+---
+
+## Qu'est-ce que c'est ?
+
+Sovereign est un **jeu de société du type Monopoly, basé sur le système Hamilton**, qui traite de la création du crédit public américain, ainsi qu'une **adaptation complète pour un mode solo / numérique** qui exécute les mêmes règles localement dans un navigateur, contre deux adversaires simulés et déterministes.
+
+- **Jeu de société** — prototype imprimable en 34 feuilles. Plateau de 40 cases, 22 propriétés + 4 routes + 2 institutions, 8 systèmes de couleurs, 7 actes du Congrès dans un ordre historique fixe, 4 rôles de joueurs, 3 pistes communes (Crédit public · Résistance publique · Capacité industrielle), 12+12 cartes d'événements. Deux voies économiques viables en dehors du Trésor : le commerce et l'industrie.
+- **Mode numérique** — un seul fichier HTML autonome. Machine d'état complète, générateur de nombres aléatoires déterministe mulberry32, adversaires simulés (Trésor / Finance, Commerce / Infrastructure, Industrie / Production), sauvegarde / chargement avec intégrité de la somme de contrôle, outil de relecture, outil de simulation par lots, télémétrie locale de l'équilibre.
+- **Équilibre de base** — v0.10, figé après une série de neuf versions, basée sur plus de 1000 simulations de jeux déterministes. Trésor : 59 % · Commerce : 25 % · Industrie : 16 % (valeur canonique × 100, la plage cible est atteinte pour les trois profils).
+
+---
+
+## Démarrage rapide
+
+### Jouez dans votre navigateur (sans installation)
+
+```bash
+npx @mcptoolshop/sovereign
+```
+
+L'interface en ligne de commande ouvre le jeu dans votre navigateur par défaut. Pas d'installateur, pas de serveur, pas besoin de connexion Internet.
+
+Autres 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
+```
+
+### Jouer en ligne
+
+Ouvrez la page d'accueil hébergée à l'adresse **<https://mcp-tool-shop-org.github.io/sovereign/>** et cliquez sur le jeu numérique.
+
+### Imprimer et jouer
+
+Le prototype du jeu de société est un document HTML autonome en 34 feuilles. Ouvrez `release/board-game/sovereign-prototype.html` depuis le paquet (ou depuis un téléchargement), puis `Cmd/Ctrl-P → Enregistrer sous PDF → Format US Letter → 100 % de l'échelle`. Découpez et jouez.
+
+### Paquet de publication hors ligne
+
+Chaque publication avec tag attache un paquet `sovereign-vX.Y.Z-release.zip` à sa page de publication GitHub. Téléchargez-le, décompressez-le et ouvrez `00-START-HERE.html` pour le point d'entrée adapté au public. Tout fonctionne hors ligne.
+
+---
+
+## Pourquoi cela existe-t-il ?
+
+La thèse de Sovereign est que **le crédit public et la finance fédérale** étaient les principaux leviers économiques d'Alexander Hamilton, mais un jeu basé sur le système Hamilton doit permettre au **commerce** et à l'**industrie** d'être également des voies viables vers la victoire. La phase d'équilibre (v0.2 → v0.10) a été une série de neuf versions, axée sur des preuves, visant à maintenir le Trésor comme le profil le plus fort (conformément à l'histoire) sans que la conception ne se réduise à un seul type de stratégie.
+
+Consultez [`CHANGELOG.md`](./CHANGELOG.md) pour l'évolution complète de chaque version.
+
+---
+
+## Déterminisme
+
+La même graine + les mêmes décisions humaines = un registre identique au niveau des octets entre les exécutions, les navigateurs et les systèmes d'exploitation.
+
+- Générateur de nombres aléatoires unique : `mulberry32(state.rngSeed)`.
+- Décisions de l'adversaire : fonctions pures de l'état visible, chaque décision étant enregistrée dans le registre avec sa règle de déclenchement.
+- La sauvegarde / le chargement préservent une somme de contrôle de l'état.
+- La relecture reconstruit à partir de `initialState(seed) + decisionLog`.
+- Vérifié lors de plus de 1000 jeux déterministes pendant la phase d'équilibre v0.2 → v0.10.
+
+---
+
+## Modèle de menace et gestion des données
+
+Sovereign est un jeu de société basé sur un navigateur, autonome. L'interface en ligne de commande (CLI) ouvre un fichier HTML local dans votre navigateur par défaut. Il n'y a pas de serveur, d'appel réseau, de compte, de synchronisation cloud.
+
+- **Données concernées :** les fichiers HTML inclus dans le dossier `release/` (lecture seule) et le stockage local (`localStorage`) sous la clé `sovereign.autosave` (uniquement l'état de sauvegarde du jeu).
+- **Données NON concernées :** aucun accès au système de fichiers en dehors du répertoire du paquet, aucune requête réseau de quelque nature que ce soit, aucune télémétrie, aucune analyse, aucun identifiant.
+- **Autorisations requises :** capacité à lancer le navigateur par défaut du système d'exploitation, capacité à lire les fichiers du paquet, stockage local du navigateur (facultatif).
+- **Aucune télémétrie, jamais.** La fonctionnalité de "télémétrie" du simulateur fait référence à des rapports d'analyse du jeu locaux, dérivés du registre intégré ; ces rapports ne quittent jamais votre machine.
+
+Consultez le fichier [`SECURITY.md`](./SECURITY.md) pour signaler les vulnérabilités et consulter la politique de sécurité complète.
+
+---
+
+## Fonctionnalités
+
+- **Jeu solo en 7 tours** contre deux adversaires programmés (Trésorerie / Finance et Commerce / Infrastructure par défaut ; Fabricant / Industrie disponible pour les parties en série).
+- **IA déterministe** : chaque décision de l'adversaire est une fonction pure de l'état visible, avec une justification enregistrée. Pas de LLM, pas de magie opaque.
+- **8 surfaces de jeu** : Tableau, Panneau de la Trésorerie, Inspecteur des Actifs, Boîte à Événements, Actes du Congrès, Pistes Partagées, Journal des Tours / Registre, Rapport de Fin de Partie.
+- **Enchères** : les actifs rejetés sont mis aux enchères auprès de plusieurs joueurs, avec des enchères programmées basées sur le profil.
+- **Sauvegarde / chargement** : sauvegarde automatique dans le stockage local à chaque tour, exportation / importation manuelle au format JSON, vérification de l'intégrité par hachage lors du chargement, version contrôlée.
+- **Relecture** : relecture complète de n'importe quelle partie terminée. Lecture seule. Reconstruit à partir de la graine et du journal des décisions, avec une "pastille" d'intégrité verte.
+- **Simulation en série** : exécutez 10 / 50 / 100 parties déterministes contre n'importe quel triplet de profils, exportez des rapports JSON + HTML pour l'analyse de l'équilibre.
+- **Narration historique** : bibliothèque de 25 entrées dérivée du registre (descriptions par défaut de 40 à 60 mots, extensions de 150 à 200 mots, résumé de la république de fin de partie d'environ 300 à 500 mots). Ne modifie jamais l'état.
+- **Accessibilité** : navigation complète au clavier, indicateurs de focus, étiquettes significatives pour les lecteurs d'écran, valeurs des pistes lisibles sous forme de texte et non uniquement de marqueurs, taille minimale du corps de texte de 14px, respect des paramètres de réduction du mouvement.
+
+---
+
+## Liste des profils (v0.10)
+
+| Profil | Priorité des actifs | Force | Faiblesse |
+|--------------------------------|---------------------------------------------------------------|----------------------|-------------------------------------|
+| **Treasury / Finance**         | NF > Dette de l'État > Dette des impôts > Banque > Monnaie | Augmentation du crédit public | Pas de revenus d'infrastructure |
+| **Merchant / Infrastructure**  | Routes (les 4) > Commerce > Améliorations > Revenus | Échelle des routes | Pas de notation de la capacité industrielle |
+| **Manufacturer / Industry**    | Fabrication > Industrie stratégique > Améliorations > Banque | Multiplicateurs de capacité | Début lent ; reçoit une charte de départ |
+
+Le quatrième profil conceptuel (Opportuniste / Trésorerie) est reporté. L'ensemble compétitif verrouillé de la v0.10 est de trois.
+
+---
+
+## Limitations connues
+
+- **Les seuils de capacité restent rares dans le jeu canonique.** La capacité finale moyenne est de 3,49 ; ≥ 6 est atteint dans seulement 4 / 100 parties. La notation industrielle de fin de partie existe comme un plafond, et non comme un chemin régulier.
+- **La Trésorerie / Finance reste intentionnellement la plus forte**, dans la plage cible. Cela correspond à la thèse historique : le crédit public + la finance fédérale étaient le principal levier économique de Hamilton.
+- **Les événements d'échec se sont déclenchés 0 / 400 fois** lors de la passe de validation de la v0.10. Les menaces par défaut / rébellion / faillite sont actuellement décoratives ; une version future pourrait revoir la pression des états d'échec.
+- **Testé uniquement par simulation.** L'équilibre est validé par rapport à plus de 1 000 parties déterministes sur l'arc v0.3 → v0.10. Pas encore testé par des joueurs humains ; la déviation stratégique peut modifier ces taux.
+
+---
+
+## Construction et contribution
+
+```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
+```
+
+Les versions sont publiées sur npm via GitHub Actions (`release.yml`) lors de chaque modification de la branche étiquetée `v*`, avec une attestation de provenance Sigstore. La source de vérité est la branche `main`.
+
+---
+
+## Licence
+
+MIT © mcp-tool-shop. Voir le fichier [`LICENSE`](./LICENSE).
+
+---
+
+<div align="center">
+
+Créé par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>
+
+</div>

package/README.hi.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.md">English</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>
+
+---
+
+## यह क्या है
+
+"सोवरिन" एक **हैमिल्टन-सिस्टम मोनोपोली-शैली का बोर्ड गेम** है, जो अमेरिकी सार्वजनिक ऋण की स्थापना के बारे में है, साथ ही एक **पूर्ण एकल/डिजिटल संस्करण** भी है जो समान नियमों को ब्राउज़र में दो पूर्वनिर्धारित स्क्रिप्टेड विरोधियों के खिलाफ स्थानीय रूप से चलाता है।
+
+- **बोर्ड गेम** — 34 पृष्ठों का मुद्रण योग्य प्रोटोटाइप। 40 स्थानों वाला बोर्ड, 22 संपत्ति + 4 मार्ग + 2 संस्थान, 8 रंग प्रणाली, 7 कांग्रेस के अधिनियम जो एक निश्चित ऐतिहासिक क्रम में हैं, 4 खिलाड़ी भूमिकाएं, 3 साझा ट्रैक (सार्वजनिक ऋण · सार्वजनिक प्रतिरोध · औद्योगिक क्षमता), 12+12 इवेंट कार्ड। ट्रेजरी के अलावा दो व्यवहार्य आर्थिक रास्ते: व्यापारी और निर्माता।
+- **डिजिटल मोड** — एक एकल, आत्मनिर्भर HTML फ़ाइल। पूर्ण स्टेट मशीन, नियतात्मक mulberry32 RNG, स्क्रिप्टेड AI विरोधी (ट्रेजरी/वित्त, व्यापारी/बुनियादी ढांचा, निर्माता/उद्योग), हैश अखंडता के साथ सहेजें/लोड करें, रीप्ले पुनर्निर्माण, बैच सिमुलेशन टूल, स्थानीय संतुलन टेलीमेट्री।
+- **संतुलन आधार** — v0.10, नौ संस्करणों के चक्र के बाद स्थिर, जिसमें 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 → Save as PDF → US Letter → 100% scale`। काटें और खेलें।
+
+### ऑफ़लाइन रिलीज़ बंडल
+
+प्रत्येक टैग किए गए रिलीज़ में `sovereign-vX.Y.Z-release.zip` बंडल अपने GitHub रिलीज़ पृष्ठ से जुड़ा होता है। इसे डाउनलोड करें, अनज़िप करें और दर्शकों के लिए एंट्री पॉइंट `00-START-HERE.html` खोलें। सब कुछ ऑफ़लाइन चलता है।
+
+---
+
+## यह क्यों मौजूद है
+
+"सोवरिन" का सिद्धांत यह है कि **सार्वजनिक ऋण + संघीय वित्त** अलेक्जेंडर हैमिल्टन के लिए एक प्रमुख आर्थिक साधन थे - लेकिन एक हैमिल्टन-सिस्टम गेम को **व्यापार** और **उद्योग** को भी जीत के व्यवहार्य रास्ते बनाने की अनुमति देनी चाहिए। संतुलन चक्र (v0.2 → v0.10) नौ संस्करणों का, साक्ष्य-आधारित प्रयास था, जिसका उद्देश्य ट्रेजरी को सबसे मजबूत प्रोफाइल के रूप में बनाए रखना था (इतिहास के अनुरूप) बिना डिज़ाइन को एक-रणनीति वाले गेम में बदलने के।
+
+पूर्ण संस्करण-दर-संस्करण विकास के लिए [`CHANGELOG.md`](./CHANGELOG.md) देखें।
+
+---
+
+## नियतात्मकता
+
+समान बीज + समान मानव निर्णय = रन, ब्राउज़र और ऑपरेटिंग सिस्टम में बाइट-समान खाता।
+
+- एकल RNG: `mulberry32(state.rngSeed)`.
+- विरोधी निर्णय: दिखाई देने वाली स्थिति के शुद्ध फ़ंक्शन, प्रत्येक निर्णय को ट्रिगरिंग नियम के साथ खाता में लॉग किया जाता है।
+- सहेजें/लोड राउंडट्रिप एक राज्य हैश को संरक्षित करता है।
+- रीप्ले `initialState(seed) + decisionLog` से पुनर्निर्माण करता है।
+- v0.2 → v0.10 संतुलन चक्र के दौरान 1,000 से अधिक नियतात्मक गेम में सत्यापित।
+
+---
+
+## खतरे का विश्लेषण और डेटा प्रबंधन
+
+"सोवरिन" एक आत्मनिर्भर, ब्राउज़र-आधारित बोर्ड गेम है। कमांड-लाइन इंटरफेस (CLI) आपके डिफ़ॉल्ट ब्राउज़र में एक स्थानीय HTML फ़ाइल खोलता है। इसमें कोई सर्वर नहीं है, कोई नेटवर्क कनेक्शन नहीं है, कोई खाता नहीं है, और कोई क्लाउड सिंक नहीं है।
+
+- **डेटा जो उपयोग में है:** `release/` फ़ोल्डर में शामिल HTML फ़ाइलें (केवल पढ़ने के लिए) और `localStorage` में `sovereign.autosave` कुंजी के तहत (केवल गेम सेव स्टेट)।
+- **डेटा जो उपयोग में नहीं है:** पैकेज निर्देशिका के बाहर किसी भी फ़ाइल सिस्टम तक पहुंच नहीं, किसी भी प्रकार के नेटवर्क अनुरोध नहीं, कोई टेलीमेट्री नहीं, कोई विश्लेषण नहीं, कोई क्रेडेंशियल नहीं।
+- **आवश्यक अनुमतियाँ:** ऑपरेटिंग सिस्टम के डिफ़ॉल्ट ब्राउज़र को चलाने की क्षमता, पैकेज की अपनी फ़ाइलों को पढ़ने की क्षमता, ब्राउज़र `localStorage` (वैकल्पिक)।
+- **कोई टेलीमेट्री नहीं, कभी नहीं।** सिम्युलेटर की "टेलीमेट्री" सुविधा ब्राउज़र में मौजूद लेज़र से प्राप्त स्थानीय गेम विश्लेषण रिपोर्ट को संदर्भित करती है; ये कभी भी आपके डिवाइस से बाहर नहीं जाती हैं।
+
+भेद्यता रिपोर्टिंग और पूर्ण सुरक्षा नीति के लिए [`SECURITY.md`](./SECURITY.md) देखें।
+
+---
+
+## विशेषताएं
+
+- **7 राउंड वाला एकल खिलाड़ी गेम** दो स्क्रिप्टेड विरोधियों के खिलाफ (डिफ़ॉल्ट रूप से ट्रेजरी/वित्त और व्यापारी/बुनियादी ढांचा; बैच प्ले के लिए निर्माता/उद्योग उपलब्ध)।
+- **निर्धारक (डिटरमिनिस्टिक) एआई** — प्रत्येक विरोधी के निर्णय दृश्य स्थिति का एक शुद्ध फ़ंक्शन है, जिसके साथ लेज़र में कारण दर्ज होता है। कोई 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**    | Mfg > रणनीतिक उद्योग > सुधार > बैंक | क्षमता गुणक | धीमी शुरुआत; एक प्रारंभिक चार्टर प्राप्त होता है |
+
+चौथा अवधारणा-दस्तावेज़ प्रोफ़ाइल (अवसरवादी/कैश) स्थगित है। लॉक v0.10 प्रतिस्पर्धी सेट में तीन प्रोफ़ाइल हैं।
+
+---
+
+## ज्ञात सीमाएं
+
+- **क्षमता सीमाएं अभी भी मानक गेमप्ले में दुर्लभ हैं।** औसत अंतिम क्षमता 3.49 है; ≥ 6 केवल 4/100 गेम में प्राप्त होता है। एंडगेम औद्योगिक स्कोरिंग एक सीमा के रूप में मौजूद है, नियमित मार्ग के रूप में नहीं।
+- **ट्रेजरी/वित्त जानबूझकर सबसे मजबूत है**, लक्षित बैंड के भीतर। यह ऐतिहासिक थीसिस से मेल खाता है: सार्वजनिक क्रेडिट + संघीय वित्त हैमिल्टन का प्रमुख आर्थिक लीवर था।
+- **विफलता घटनाएं 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 एक्शन (`release.yml`) के माध्यम से npm पर प्रकाशित की जाती हैं, जब `v*` टैग पुश किया जाता है, और इसमें Sigstore का प्रमाण शामिल होता है। "main" शाखा ही आधिकारिक स्रोत है।
+
+---
+
+## लाइसेंस
+
+MIT © mcp-tool-shop। देखें [`LICENSE`](./LICENSE)।
+
+---
+
+<div align="center">
+
+यह <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> द्वारा बनाया गया है।
+
+</div>