hachiwari 0.4.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cad620e5b99a9b8a69ba25260c70b6a30f7ca3a48a2ef60b7af0b866091564e
-  data.tar.gz: e479948cad8adbcae3f3e438216b70571feb344af0ac6250424d4931f170c6fa
+  metadata.gz: 6b64e8e052849e8217860d6d7f244c85f80af59abf5d924cffb3090e119bbdab
+  data.tar.gz: 91aa8f06a84c9bedf01a367e3a415b101b5c617ae61070d18b75c7eb3d66bead
 SHA512:
-  metadata.gz: 6b57e7666b95e8c532434206265a97567e0640500b75730827a8028ebd8b58d5fd4374c20d5ff0f17555730bff5a46b8613d7634b89c35e7422a2b0f8c2bf91e
-  data.tar.gz: 5fba6c44630ee9da377cbca9151e8929567209878c43124863118e5467dbc791441e7dea762c26c67267919aa88915508feea183739b26f814b64d3dc7fee4bc
+  metadata.gz: 6a63f4f880bc8a3e22291812800aadb27326a724a539bb5de369874b27cb430a7dd3a078c32561104844ac1edc5d0a0cf1a8e54077b5f54c9cb0c6cdfd0c8ce6
+  data.tar.gz: 6079b2b61b32a1e8225aad7f50ed7659f5abb0b16fd85757b3c69326d96be0f24ffcdcee8bae7afbe4d0cc0b42d08dd528b878747c1582d6d687d3cbec0fd343

data/.rubocop.yml

@@ -1,13 +1,48 @@
+# RuboCop 全体設定
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 3.3
+  # Ruby 3.3 以降向けの新しい Cop も自動的に有効化
+  NewCops: enable
+  # 実行ファイルはコマンドライン用途でスタイルが特殊なため除外
+  Exclude:
+    - "bin/**/*"
 
+# 文字列リテラルはダブルクォートで統一
 Style/StringLiterals:
   Enabled: true
   EnforcedStyle: double_quotes
 
+# 補間文字列もダブルクォートを強制
 Style/StringLiteralsInInterpolation:
   Enabled: true
   EnforcedStyle: double_quotes
 
+# 行の長さ上限を 120 文字に設定
 Layout/LineLength:
   Max: 120
+
+# ドキュメントコメントを必須にしない
+Style/Documentation:
+  Enabled: false
+
+# CLI やストレージ周りの複雑さ、およびテストコードの冗長さを許容
+Metrics/ClassLength:
+  Max: 220
+
+# CLI やストレージなどで必要な手続き型処理を許容するため閾値を緩和
+Metrics/MethodLength:
+  Max: 20
+  Exclude:
+    - "test/**/*"
+
+# バリデーションやフォーマット処理の複雑さを吸収
+Metrics/AbcSize:
+  Max: 25
+
+# CLI 分岐やレガシー移行ロジック向けに複雑度の上限を調整
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+# 全体的な認知的複雑度もやや緩和
+Metrics/PerceivedComplexity:
+  Max: 10

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 ## [Unreleased]
 
+_No changes yet._
+
+## [1.0.0] - 2025-09-27
+
+### Added
+- `hachiwari clear` コマンドを追加し、保存済みの対局成績を削除できるようにしました。
+- `hachiwari status --trial` オプションを追加し、保存せずに試算できるようにしました。
+- `hachiwari` 実行時にコマンド名を省略しても `status` として扱われるようにしました。
+- 目標勝率を既に上回っている場合に、勝率を下回るまでに許容される敗北数を案内する機能を追加しました。
+- CLI のヘルプ・コマンド説明をロケールごとの YAML (`config/locales/*.yml`) から読み込むようにし、日本語 (`ja`)／英語 (`en`) に加えてスペイン語 (`es`)・フランス語 (`fr`)・ドイツ語 (`de`) への自動切り替えに対応しました。
+
+### Changed
+- Ruby の対応バージョンを `>= 3.3.0` へ引き上げ、最新環境での動作を保証しました。
+- `bundle update` を実施し、開発用依存関係を最新化しました。
+- CLI 実装を `StatusRunner` / `StatusCalculator` / `StatusPresenter` / `Storage` へ分割し、責務を明確化しました。
+- 実行ファイルの配置を `bin/` に統一し、余分なスクリプト (`bin/setup` / `bin/console`) を削除しました。
+- `info` / `i` / `calculate` コマンドを非推奨化し、実行時は `status --trial` と同等の挙動になるよう警告を表示します。
+- `s` エイリアスを非推奨化し、利用時は警告表示後に `status` として処理します。一般ヘルプからも非表示にしました。
+
+### Fixed
+- gem アンインストール時に自動で保存ファイルを削除するフックを追加し、不要なデータが残らないようにしました。
+
+### Documentation
+- 日本語 README (`README.md`) を整備し、英語版 `README.en.md` を新規追加しました。
+- `LICENSE` に参考用の日本語訳を追記しました。
+- `test/hachiwari_test.rb` に日本語コメントを追加し、テストの意図を明確化しました。
+- 勝率・敗北案内に関するテストケースを追加し、境界条件での挙動を検証できるようにしました。
+- `lib/` 配下の主要コンポーネントに説明コメントを追加し、アーキテクチャをドキュメント化しました。
+
+## [0.4.0] - 2022-04-27
+
+### Added
+- `info` コマンドを追加し、状態を保存せずに勝率を試算できるようにしました。
+
+## [0.3.1] - 2021-12-06
+
+### Changed
+- 軽微な修正を行い、安定性を向上しました。
+
 ## [0.1.0] - 2021-11-08
 
 - Initial release

data/Gemfile

@@ -8,5 +8,6 @@ gemspec
 gem "rake", "~> 13.0"
 
 gem "minitest", "~> 5.0"
+gem "minitest-reporters", "~> 1.6", require: false
 
 gem "rubocop", "~> 1.21"

data/Gemfile.lock

@@ -1,44 +1,65 @@
 PATH
   remote: .
   specs:
-    hachiwari (0.4.0)
+    hachiwari (1.0.0)
+      pstore
       thor
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
-    minitest (5.15.0)
-    parallel (1.22.1)
-    parser (3.1.2.0)
+    ansi (1.5.0)
+    ast (2.4.3)
+    builder (3.3.0)
+    json (2.15.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    minitest (5.25.5)
+    minitest-reporters (1.7.1)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    parallel (1.27.0)
+    parser (3.3.9.0)
       ast (~> 2.4.1)
+      racc
+    prism (1.5.1)
+    pstore (0.1.4)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.3.1)
-    rexml (3.2.5)
-    rubocop (1.28.2)
+    rake (13.3.0)
+    regexp_parser (2.11.3)
+    rubocop (1.81.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
-      parser (>= 3.1.0.0)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml
-      rubocop-ast (>= 1.17.0, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.17.0)
-      parser (>= 3.1.1.0)
-    ruby-progressbar (1.11.0)
-    thor (1.2.1)
-    unicode-display_width (2.1.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    thor (1.4.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
 
 PLATFORMS
+  arm64-darwin-24
   x86_64-darwin-21
 
 DEPENDENCIES
   hachiwari!
   minitest (~> 5.0)
+  minitest-reporters (~> 1.6)
   rake (~> 13.0)
   rubocop (~> 1.21)
 
 BUNDLED WITH
-   2.3.11
+   2.7.1

data/LICENSE

@@ -0,0 +1,34 @@
+The MIT License (MIT)
+
+Copyright (c) 2021-2025 Atelier-Mirai
+
+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.
+
+------------------------------------------------------------
+以下は参考用の日本語訳です。法的効力を持つのは上記の英語版ライセンス文です。
+
+MIT ライセンス（参考訳）
+
+Copyright (c) 2021-2025 Atelier-Mirai
+
+本ソフトウェアおよび関連文書ファイル（以下「ソフトウェア」）の複製を入手した者に対し、ソフトウェアを無制限に扱うことを無償で許可します。これには、ソフトウェアの使用、複製、改変、結合、掲載、頒布、再許諾、および/または販売の権利、ならびにソフトウェアを供給された者に同様のことを許可する権利が含まれます。
+
+上記の著作権表示および本許諾表示は、ソフトウェアのすべての複製または重要な部分に記載しなければなりません。
+
+ソフトウェアは「現状のまま」で提供され、明示黙示を問わず、商品性、特定目的への適合性、および権利非侵害についての保証を含め、いかなる種類の保証も行いません。著作者または著作権者は、契約、不法行為、その他いかなる行為によるかを問わず、ソフトウェアに起因または関連して生じる一切の請求、損害、その他の責任について責任を負いません。

data/README.de.md

@@ -0,0 +1,103 @@
+# Hachiwari
+
+Hachiwari leitet sich vom Ziel ab, eine Siegquote von 80 % zu erreichen. Die Ruby-Gem zeigt, wie viele zusätzliche Siege nötig sind, um das gesetzte Ziel zu schaffen (Standardziel: 80 %).
+
+Weitere Sprachen: [README.md](README.md) (Japanisch) / [README.en.md](README.en.md) (Englisch) / [README.es.md](README.es.md) (Spanisch) / [README.fr.md](README.fr.md) (Französisch).
+
+## Installation
+
+Installiere die Gem mit:
+
+```
+% gem install hachiwari
+```
+
+## Verwendung
+
+### Anzahl der benötigten Siege zur Zielquote anzeigen (mit automatischer Speicherung)
+
+```
+% hachiwari [status] [wins] [losses] [target] [language]
+```
+
+- `status` kann weggelassen werden; übergib einfach die Argumente.
+- Der alte Alias `s` ist veraltet. Bei Verwendung erscheint eine Warnung und `status` wird intern ausgeführt.
+- Es gibt vier Argumente: Siege, Niederlagen, Zielquote und Ausgabesprache. Alle sind optional.
+- Ohne Argumente wird der aktuelle Stand anhand der Standardwerte oder gespeicherter Daten gezeigt. Standard: Siege 0, Niederlagen 0, Zielquote 80 %, Sprache Japanisch (`ja`).
+- Gibst du Siege als erstes Argument an, berechnet Hachiwari, wie viele zusätzliche Siege dafür noch fehlen. Die übrigen Argumente greifen auf Standard- oder gespeicherte Werte zurück.
+- Die eingegebenen Siege werden automatisch in `~/.hachiwari` gespeichert.
+- Um Niederlagen zu aktualisieren, übergib sie als zweites Argument.
+- Zum Anpassen der Zielquote nutze das dritte Argument (z. B. `90` für 90 %).
+- Zum Ändern der Sprache verwende das vierte Argument. Unterstützt werden `ja` (Japanisch, Standard), `en` (Englisch), `es` (Spanisch), `fr` (Französisch) und `de` (Deutsch).
+
+Um das Ergebnis ohne Speicherung anzuzeigen, hänge die Option `--trial` (oder kurz `-t`) an:
+
+```
+% hachiwari [status] --trial [wins] [losses] [target] [language]
+```
+
+Die Argumente funktionieren wie beim regulären `status`, aber es wird nichts gespeichert. Die früheren Befehle `info`, `i` und `calculate` sind veraltet; sie zeigen eine Warnung und verhalten sich wie `status --trial`.
+
+### Version von Hachiwari anzeigen
+
+```
+% hachiwari version
+```
+
+Zeigt die installierte Version von Hachiwari an.
+
+### Gespeicherte Daten löschen
+
+```
+% hachiwari clear
+```
+
+Löscht die gespeicherte Datei `.hachiwari`. Existiert sie nicht, erscheint nur eine Warnung.
+
+### Befehlsliste oder Detailhilfe anzeigen
+
+```
+% hachiwari --help
+% hachiwari status --help
+```
+
+`hachiwari --help` listet verfügbare Befehle auf; `hachiwari <befehl> --help` zeigt detaillierte Hilfe.
+
+### Veraltete Befehle
+
+Folgende Befehle/Aliase sind veraltet. Bei Ausführung erscheint eine Warnung, danach erfolgt ein kompatibles Verhalten:
+
+- **s**: Früher ein Alias von `status`. Warnung und anschließende Ausführung von `status`.
+- **info / i**: Dienten früher als Simulation ohne Speicherung. Jetzt Warnung und Verhalten wie `status --trial`.
+- **calculate**: Diente dem reinen Options-basierten Berechnen. Jetzt Warnung und Verhalten wie `status --trial` (Optionen `--target`/`--language` bleiben nutzbar).
+
+## Entwicklung
+
+Klone das Repository und richte die Umgebung mit:
+
+```
+bundle install
+bundle exec rake test
+```
+
+- **Abhängigkeiten installieren**: `bundle install`
+- **Tests ausführen**: `bundle exec rake test`
+- **CLI manuell prüfen**: `bundle exec ruby -Ilib bin/hachiwari --help`
+
+Zum lokalen Installieren der Gem: `bundle exec rake install`.
+
+### Neue Version veröffentlichen
+
+1. `VERSION` in `lib/hachiwari/version.rb` anpassen.
+2. Änderungen committen und pushen.
+3. `bundle exec rake release` ausführen.
+
+Damit werden Tag und Commits erstellt und gepusht, und die Gem wird auf [rubygems.org](https://rubygems.org) veröffentlicht (MFA bei RubyGems erforderlich).
+
+## Mitwirken
+
+Fehlerberichte und Pull Requests sind auf [GitHub](https://github.com/Atelier-Mirai/hachiwari) willkommen.
+
+## Lizenz
+
+Diese Gem steht unter der [MIT-Lizenz](https://opensource.org/licenses/MIT). Details siehe [LICENSE](./LICENSE).

data/README.en.md

@@ -0,0 +1,103 @@
+# Hachiwari
+
+Hachiwari originates from the phrase "80 percent" (hachiwari). It is a Ruby gem that tells you how many additional wins you need to hit your target win rate (80 percent by default).
+
+For other languages, see [README.md](README.md) (Japanese) / [README.es.md](README.es.md) (Spanish) / [README.fr.md](README.fr.md) (French) / [README.de.md](README.de.md) (German).
+
+## Installation
+
+Install it with:
+
+```
+% gem install hachiwari
+```
+
+## Usage
+
+### Display the number of wins required to reach the target win rate (with automatic saving)
+
+```
+% hachiwari [status] [wins] [losses] [target] [language]
+```
+
+- You can omit `status` and pass only the arguments.
+- The legacy alias `s` is deprecated; it prints a warning and internally invokes `status`.
+- There are four arguments: number of wins, number of losses, target win rate, and display language. All of them are optional.
+- With no arguments, the current record is shown based on defaults or previously saved data. Defaults are wins: 0, losses: 0, target: 80 percent, language: Japanese (`ja`).
+- If you pass wins as the first argument, Hachiwari tells you how many more wins are required from that value. Remaining arguments fall back to defaults or saved data.
+- The number of wins you provide is automatically saved to `~/.hachiwari`.
+- To update losses, pass them as the second argument.
+- To change the target win rate, use the third argument (for example, `90` for 90 percent).
+- To change the language, use the fourth argument. Supported values are `ja` (Japanese, default), `en` (English), `es` (Spanish), `fr` (French), and `de` (German).
+
+To preview the result without saving it, append the `--trial` (or `-t`) option:
+
+```
+% hachiwari [status] --trial [wins] [losses] [target] [language]
+```
+
+Arguments behave exactly as in the regular `status` command, but no state is persisted. The legacy `info`, `i`, and `calculate` commands are deprecated; they print a warning and behave like `status --trial`.
+
+### Display the version of Hachiwari
+
+```
+% hachiwari version
+```
+
+Shows the installed version of Hachiwari.
+
+### Delete saved match data
+
+```
+% hachiwari clear
+```
+
+Removes the stored `.hachiwari` file. If no data exists, a warning is shown instead.
+
+### Show command lists or detailed help
+
+```
+% hachiwari --help
+% hachiwari status --help
+```
+
+`hachiwari --help` prints available commands, and `hachiwari <command> --help` prints detailed help for each command.
+
+### Deprecated commands
+
+The following commands/aliases are deprecated. When executed, they print a warning and fall back to compatible behavior:
+
+- **s**: Former alias of `status`. A warning is printed and `status` runs.
+- **info / i**: Formerly provided trial output without saving. They now warn and behave like `status --trial`.
+- **calculate**: Former option-driven calculator command. It now warns and behaves like `status --trial` (the `--target` / `--language` options remain available).
+
+## Development
+
+Clone the repository and set up the development environment with:
+
+```
+bundle install
+bundle exec rake test
+```
+
+- **Install dependencies**: `bundle install`
+- **Run tests**: `bundle exec rake test`
+- **Check the CLI manually**: `bundle exec ruby -Ilib bin/hachiwari --help`
+
+To install the gem locally, run `bundle exec rake install`.
+
+### Releasing a new version
+
+1. Update `VERSION` in `lib/hachiwari/version.rb`.
+2. Commit and push your changes.
+3. Run `bundle exec rake release`.
+
+The release task creates a git tag, pushes commits and the tag, and publishes the gem to [rubygems.org](https://rubygems.org) (you need MFA enabled on RubyGems).
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/Atelier-Mirai/hachiwari).
+
+## License
+
+This gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). See [LICENSE](./LICENSE) for details.

data/README.es.md

@@ -0,0 +1,103 @@
+# Hachiwari
+
+Hachiwari debe su nombre al objetivo de alcanzar un 80 % de victorias. Es una gema de Ruby que te muestra cuántas victorias necesitas para llegar a tu porcentaje objetivo (el objetivo predeterminado es 80 %).
+
+Para documentación en otros idiomas, consulta [README.md](README.md) / [README.en.md](README.en.md) / [README.fr.md](README.fr.md) / [README.de.md](README.de.md).
+
+## Instalación
+
+Instálalo ejecutando:
+
+```
+% gem install hachiwari
+```
+
+## Uso
+
+### Mostrar el número de victorias necesarias para alcanzar la tasa objetivo (con guardado automático)
+
+```
+% hachiwari [status] [wins] [losses] [target] [language]
+```
+
+- Puedes omitir `status` y pasar únicamente los argumentos.
+- El alias heredado `s` está en desuso; al usarlo se mostrará una advertencia y se ejecutará `status` internamente.
+- Hay cuatro argumentos: número de victorias, número de derrotas, porcentaje objetivo y idioma de salida. Todos son opcionales.
+- Si no proporcionas argumentos, se mostrará el registro actual usando los valores predeterminados o los datos guardados previamente. Los valores predeterminados son victorias: 0, derrotas: 0, porcentaje objetivo: 80 %, idioma: japonés (`ja`).
+- Si proporcionas el número de victorias como primer argumento, se mostrará la cantidad de victorias adicionales necesarias a partir de ese valor. El resto de los argumentos usará valores predeterminados o guardados.
+- El número de victorias proporcionado se guarda automáticamente en `~/.hachiwari`.
+- Para actualizar el número de derrotas, pásalo como segundo argumento.
+- Para cambiar el porcentaje objetivo, proporciónalo como tercer argumento (por ejemplo `90` para un objetivo del 90 %).
+- Para cambiar el idioma, usa el cuarto argumento. Especifica `ja` para japonés (predeterminado), `en` para inglés, `es` para español, `fr` para francés o `de` para alemán.
+
+Para obtener el resultado sin guardarlo, agrega la opción `--trial` (o `-t`):
+
+```
+% hachiwari [status] --trial [wins] [losses] [target] [language]
+```
+
+Los argumentos funcionan igual que en el comando `status`, pero el estado no se persiste. Los comandos heredados `info`, `i` y `calculate` están obsoletos; se mostrará una advertencia y se comportarán como `status --trial`.
+
+### Mostrar la versión de Hachiwari
+
+```
+% hachiwari version
+```
+
+Muestra la versión instalada de Hachiwari.
+
+### Borrar los datos guardados
+
+```
+% hachiwari clear
+```
+
+Elimina el archivo `.hachiwari` guardado. Si no existe, solo se mostrará una advertencia.
+
+### Mostrar la lista de comandos o la ayuda detallada
+
+```
+% hachiwari --help
+% hachiwari status --help
+```
+
+`hachiwari --help` muestra la lista de comandos disponibles, y `hachiwari <comando> --help` muestra la ayuda detallada de cada comando.
+
+### Comandos obsoletos
+
+Los siguientes comandos/alias están obsoletos. Al ejecutarlos se mostrará una advertencia y se realizará una acción de compatibilidad:
+
+- **s**: Era un alias de `status`. Se mostrará una advertencia y se ejecutará `status`.
+- **info / i**: Realizaban una simulación sin guardar. Ahora muestran una advertencia y se comportan como `status --trial`.
+- **calculate**: Permitía calcular solo con opciones. Ahora muestra una advertencia y se comporta como `status --trial` (los parámetros `--target`/`--language` siguen disponibles).
+
+## Desarrollo
+
+Clona el repositorio y prepara el entorno con:
+
+```
+bundle install
+bundle exec rake test
+```
+
+- **Instalar dependencias**: `bundle install`
+- **Ejecutar pruebas**: `bundle exec rake test`
+- **Comprobar el CLI manualmente**: `bundle exec ruby -Ilib bin/hachiwari --help`
+
+Para instalar la gema localmente, ejecuta `bundle exec rake install`.
+
+### Publicar una nueva versión
+
+1. Actualiza `VERSION` en `lib/hachiwari/version.rb`.
+2. Haz commit y push de los cambios.
+3. Ejecuta `bundle exec rake release`.
+
+Este comando creará la etiqueta git, la publicará y subirá la gema a [rubygems.org](https://rubygems.org) (necesitas MFA en RubyGems).
+
+## Contribuir
+
+Aceptamos informes de errores y pull requests en [GitHub](https://github.com/Atelier-Mirai/hachiwari).
+
+## Licencia
+
+Este software se distribuye bajo la [Licencia MIT](https://opensource.org/licenses/MIT). Consulta [LICENSE](./LICENSE) para más detalles.

data/README.fr.md

@@ -0,0 +1,103 @@
+# Hachiwari
+
+Hachiwari tire son nom de l'objectif d'atteindre 80 % de victoires. C'est une gem Ruby qui indique le nombre de victoires supplémentaires nécessaires pour atteindre votre pourcentage cible (80 % par défaut).
+
+Pour les autres langues, consultez [README.md](README.md) (japonais) / [README.en.md](README.en.md) (anglais) / [README.es.md](README.es.md) (espagnol) / [README.de.md](README.de.md) (allemand).
+
+## Installation
+
+Installez la gem avec :
+
+```
+% gem install hachiwari
+```
+
+## Utilisation
+
+### Afficher le nombre de victoires nécessaires pour atteindre le taux cible (avec sauvegarde automatique)
+
+```
+% hachiwari [status] [wins] [losses] [target] [language]
+```
+
+- Vous pouvez omettre `status` et ne passer que les arguments.
+- L'alias hérité `s` est obsolète : son utilisation affiche un avertissement puis exécute `status` en interne.
+- Les quatre arguments sont : nombre de victoires, nombre de défaites, pourcentage cible et langue d'affichage. Ils sont tous facultatifs.
+- Sans argument, le score actuel est affiché à partir des valeurs par défaut ou des données enregistrées. Par défaut : victoires : 0, défaites : 0, objectif : 80 %, langue : japonais (`ja`).
+- Si vous fournissez le nombre de victoires en premier argument, Hachiwari indique combien de victoires supplémentaires sont nécessaires à partir de ce total. Les autres arguments reviennent aux valeurs par défaut ou enregistrées.
+- Le nombre de victoires fourni est automatiquement enregistré dans `~/.hachiwari`.
+- Pour mettre à jour le nombre de défaites, passez-le en second argument.
+- Pour modifier le pourcentage cible, utilisez le troisième argument (par exemple `90` pour 90 %).
+- Pour changer la langue, utilisez le quatrième argument. Valeurs prises en charge : `ja` (japonais, par défaut), `en` (anglais), `es` (espagnol), `fr` (français) et `de` (allemand).
+
+Pour obtenir un résultat sans enregistrer, ajoutez l'option `--trial` (ou `-t`) :
+
+```
+% hachiwari [status] --trial [wins] [losses] [target] [language]
+```
+
+Les arguments se comportent comme pour `status`, mais l'état n'est pas sauvegardé. Les anciens commandes `info`, `i` et `calculate` sont obsolètes : elles affichent un avertissement et se comportent comme `status --trial`.
+
+### Afficher la version de Hachiwari
+
+```
+% hachiwari version
+```
+
+Affiche la version installée de Hachiwari.
+
+### Supprimer les données enregistrées
+
+```
+% hachiwari clear
+```
+
+Supprime le fichier `.hachiwari` enregistré. S'il n'existe pas, seul un avertissement est affiché.
+
+### Afficher la liste des commandes ou une aide détaillée
+
+```
+% hachiwari --help
+% hachiwari status --help
+```
+
+`hachiwari --help` affiche la liste des commandes disponibles, et `hachiwari <commande> --help` montre l'aide détaillée de chaque commande.
+
+### Commandes obsolètes
+
+Les commandes/alias suivants sont obsolètes ; ils affichent un avertissement et basculent vers un comportement compatible :
+
+- **s** : ancien alias de `status`. Un avertissement est affiché, puis `status` s'exécute.
+- **info / i** : réalisaient une simulation sans sauvegarde. Elles avertissent désormais et se comportent comme `status --trial`.
+- **calculate** : permettait un calcul basé uniquement sur des options. Elle avertit désormais et se comporte comme `status --trial` (les options `--target`/`--language` restent disponibles).
+
+## Développement
+
+Clonez le dépôt et préparez l'environnement avec :
+
+```
+bundle install
+bundle exec rake test
+```
+
+- **Installer les dépendances** : `bundle install`
+- **Lancer les tests** : `bundle exec rake test`
+- **Vérifier le CLI manuellement** : `bundle exec ruby -Ilib bin/hachiwari --help`
+
+Pour installer la gem localement, exécutez `bundle exec rake install`.
+
+### Publier une nouvelle version
+
+1. Mettez à jour `VERSION` dans `lib/hachiwari/version.rb`.
+2. Commitez et poussez les modifications.
+3. Lancez `bundle exec rake release`.
+
+Cette commande crée un tag git, pousse les commits et le tag, puis publie la gem sur [rubygems.org](https://rubygems.org) (MFA requis sur RubyGems).
+
+## Contribuer
+
+Les rapports de bugs et pull requests sont les bienvenus sur [GitHub](https://github.com/Atelier-Mirai/hachiwari).
+
+## Licence
+
+Cette gem est publiée sous [licence MIT](https://opensource.org/licenses/MIT). Consultez [LICENSE](./LICENSE) pour plus de détails.