hachiwari 0.4.0 → 1.0.0

data/README.md

@@ -1,120 +1,108 @@
 # 八割 Hachiwari
 
-Hachiwari は、八割に由来します。
-ご自身の目指す勝率（＝既定値八割）を達成するために必要な勝ち数を表示する gem です。
+Hachiwari は、「目指す勝率 80%（＝八割）」という合言葉から生まれた勝率サポートツールです。
+日々の対局成績を入力するだけで、目標勝率に届くまでにあと何勝必要なのかをすぐに教えてくれます。
 
-Hachiwari is derived from the word "80%".
-It is a gem that shows you the number of wins you need to achieve your target win rate (i.e. the default of 80%).
+For translations, see [README.en.md](README.en.md) / [README.es.md](README.es.md) / [README.fr.md](README.fr.md) / [README.de.md](README.de.md).
 
-## インストール方法 Installation
+## インストール方法
 
 以下のコマンドを実行して、インストールしてください。
-Install it yourself as:
 
 ```
 % gem install hachiwari
 ```
 
-## 使い方 Usage
+## 使い方
 
-## 目標勝率を達成するために必要な勝ち数を表示する (自動保存機能付)
+## 目標勝率を達成するために必要な勝ち数・敗数を表示する (自動保存機能付)
 
-``` zsh
-% hachiwari status [wins] [losses] [target] [language]
+```zsh
+% hachiwari [status] [wins] [losses] [target] [language]
 ```
 
-(``` status ``` コマンドの別名として、 ``` s ``` コマンドを用いることが出来ます。)
+`status` は省略可能で、引数のみを渡しても同じ結果が得られます。
+(``` s ``` コマンドは廃止予定です。利用すると警告が表示され、内部で `status` が実行されます。)
 
 四つの引数、勝ち数、負け数、目標勝率、表示言語があります。すべての引数は省略可能です。
 
 * 引数がないとき、既定値もしくは保存されたデータを元に、現在の対局成績を表示します。
   既定値は、勝ち数：０、負け数：０、勝率：八割、表示言語：日本語です。
+  目標勝率を既に上回っている場合は、勝率が閾値を下回るまでに許容される敗北数も表示されます。
 * 一つ目の引数として勝ち数が与えられると、それに基づく必要勝ち数を表示します。
   残りの引数は、既定値もしくは保存されたデータを用います。
-  与えられた勝ち数のデータは、ホームディレクトリの直下のファイル「.hachiwari」に自動的に保存・更新されます。
 * 負け数を与えたい場合・更新したい場合には、二番目の引数として、status コマンドを実行してください。
-* 目標勝率を変更したい場合には、三番目の引数として下さい。九割の勝率を目指す場合には、90 と指定します。
-* 表示言語を変更したい場合には、四番目の引数として与えてください。既定値は日本語 ja です。英語に変更したい場合には、en を指定してください。
+* 表示言語を変更したい場合には、四番目の引数として与えてください。既定値は日本語 `ja` です。英語への切り替えは `en`、スペイン語は `es`、フランス語は `fr`、ドイツ語は `de` を指定してください。
 * 与えられた引数は、自動で保存される為、勝ち数のみが増えた場合、残りの引数の入力は不要です。
 
-## 目標勝率を達成するために必要な勝ち数を表示する (情報表示のみ)
-
-``` zsh
-% hachiwari info [wins] [losses] [target] [language]
-```
-
-(``` info ``` コマンドの別名として、 ``` i ``` コマンドを用いることが出来ます。)
-
-使い方は、``` status / s ``` コマンドと同じです。
-自動保存を行わず、情報表示のみである点が異なります。
-例えばこの場合はどうなるのだろうかと、試算する用途などに便利です。
-
 ## Hachiwari のバージョンを表示する
 
-``` zsh
+```zsh
 % hachiwari version
 ```
 
 Hachiwari のバージョンを表示します。
 
-## Display the number of wins needed to achieve the target win rate. (with automatic saving)
+## 保存済みの対局成績を削除する
 
-``` zsh
-% hachiwari status [wins] [losses] [target] [language]
+```zsh
+% hachiwari clear
 ```
 
-(The ``` s ``` command can also be used as an alias for ``` status ```).
+保存されている `.hachiwari` ファイルを削除します。データが存在しない場合は警告のみが表示されます。
 
-There are four arguments: number of wins, number of losses, target win percentage, and display language. All arguments are optional.
+## コマンド一覧や詳細を表示する
 
-* If there is no argument, the current game results are displayed based on default values or saved data.
-  The default values are: wins: 0, losses: 0, win percentage: 80%, display language: Japanese.
-* If the number of wins is given as the first argument, the required number of wins based on it will be displayed.
-  The rest of the arguments are default values or saved data.
-  The data of the number of wins given will be automatically saved and updated in the file ".hachiwari" directly under the home directory.
-* If you want to give/update the number of losses, please execute the status command as the second argument.
-* If you want to change the target winning percentage, make it the third argument. If you want to aim for a 90% win rate, specify 90.
-* If you want to change the display language, give it as the fourth argument. The default language is Japanese ``` ja ```. If you want to change it to English, specify ``` en ```.
-* The arguments given are automatically saved, so if only the number of wins is increased, the remaining arguments need not be entered.
 
-## Display the number of wins needed to achieve the target win rate. (information only)
+```zsh
+% hachiwari --help
+% hachiwari status --help
+```
 
-Usage is the same as the ```status / s ``` command.
-The difference is that it does not save automatically, but only displays information.
-It is useful, for example, for estimating what would happen in this case.
+`hachiwari --help` で利用可能なコマンドの一覧、あるいは特定コマンドの詳細ヘルプを表示します。
 
-## Display the version of Hachiwari
+## 非推奨コマンドについて
 
-``` zsh
-% hachiwari version
-```
+以下のコマンド／エイリアスは非推奨です。実行すると警告が表示され、後方互換の動作にフォールバックします。
 
-Displays the version of Hachiwari.
+- `s`
+  - `status` のエイリアスでしたが、非推奨です。
+  - 実行すると警告を表示し、内部的に `status` を実行します（`hachiwari [status] ...` の利用を推奨）。
+- `info` / `i`
+  - 保存せずに試算のみを行うためのコマンドでしたが、非推奨です。
+  - 実行すると警告を表示し、`status --trial` と同等の動作になります。
+- `calculate`
+  - オプション指定で計算のみを行うためのコマンドでしたが、非推奨です。
+  - 実行すると警告を表示し、`status --trial` と同等の動作になります（`--target`/`--language` は引き続き利用可能）。
 
-## 開発 Development
 
-repo をチェックアウトしたら、`bin/setup`を実行して、依存関係をインストールします。その後、`rake test` を実行してテストを実行します。また、`bin/console`を実行すると、インタラクティブなプロンプトが表示され、実験を行うことができます。
+## 開発
 
-このgemをローカルマシンにインストールするには、`bundle exec rake install`を実行します。新しいバージョンをリリースするには、`version.rb` のバージョン番号を更新してから、`bundle exec rake release` を実行すると、そのバージョンの git タグが作成され、git commits と作成されたタグがプッシュされ、`.gem` ファイルが [rubygems.org](https://rubygems.org) にプッシュされます。
+リポジトリをクローンしたら、以下のコマンドで開発環境を整えてください。
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```zsh
+bundle install
+bundle exec rake test
+```
 
-## 貢献 Contributing
+ - **依存関係のインストール**: `bundle install`
+ - **テストの実行**: `bundle exec rake test`
+ - **CLI の手動確認**: `bundle exec ruby -Ilib bin/hachiwari --help`
 
-バグレポートやプルリクエストは、GitHub（https://github.com/Atelier-Mirai/hachiwari）で受け付けています。このプロジェクトは、共同作業のための安全で歓迎される空間であることを意図しており、貢献者は[行動規範](https://github.com/Atelier-Mirai/hachiwari/blob/master/CODE_OF_CONDUCT.md)を遵守することが期待されています。
+この gem をローカルにインストールするには、`bundle exec rake install` を実行します。
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/Atelier-Mirai/hachiwari. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/Atelier-Mirai/hachiwari/blob/master/CODE_OF_CONDUCT.md).
+新しいバージョンをリリースする手順:
 
-## ライセンス License
+1. `lib/hachiwari/version.rb` の `VERSION` を更新する
+2. 変更をコミットしてリモートへプッシュする
+3. `bundle exec rake release` を実行する
 
-このgemは、[MIT License](https://opensource.org/licenses/MIT)の条件でオープンソースとして提供されています。
+`rake release` は、更新したバージョンで git タグを作成し、コミットとタグを push し、生成された `.gem` を [rubygems.org](https://rubygems.org) に公開します（RubyGems への公開には MFA 設定が必要です）。
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+## 貢献
 
-## 行動規範 Code of Conduct
+ バグレポートやプルリクエストは、[GitHub](https://github.com/Atelier-Mirai/hachiwari)で受け付けています。
 
-Hachiwariプロジェクトのコードベース、イシュートラッカー、チャットルーム、メーリングリストで交流するすべての人は、[行動規範](https://github.com/Atelier-Mirai/hachiwari/blob/master/CODE_OF_CONDUCT.md)に従うことが求められます。
+## ライセンス
 
-Everyone interacting in the Hachiwari project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/hachiwari/blob/master/CODE_OF_CONDUCT.md).
+このgemは、[MIT License](https://opensource.org/licenses/MIT)の条件でオープンソースとして提供されています。詳しくは [LICENSE](./LICENSE) を参照してください。

data/RELEASE_NOTES_v1.0.0.md

@@ -0,0 +1,37 @@
+# Release Notes — `hachiwari` 1.0.0 (2025-09-27)
+
+## Highlights
+- `hachiwari clear` コマンドで保存済みの対局成績を手軽に削除できます。
+- `status --trial` によって保存を伴わない試算が簡単に行えます。`info` / `i` / `calculate` / `s` は非推奨となり、内部で `status` 系へ統一されました。
+- ローカライズ可能なヘルプを導入し、日本語・英語に加えてスペイン語・フランス語・ドイツ語へ自動切り替えできます。
+
+## Added
+- `hachiwari clear` コマンドを追加して保存済みデータの削除を自動化。
+- `hachiwari status --trial` オプションで、保存せずに勝率計算を実行。
+- コマンド名を省略した場合でも `status` を自動起動。
+- 目標勝率を下回るまでの許容敗北数を提示し、現在の余裕度を可視化。
+- `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` / `s` コマンドを非推奨化し、利用時に警告を表示して `status` 系処理へ誘導。
+
+## Fixed
+- アンインストールフックを追加し、gem 削除時に保存ファイルを自動クリア。
+
+## Documentation
+- `README.md`（日本語）を更新し、`README.en.md`（英語版）を追加。
+- `LICENSE` に日本語訳を補足。
+- `test/hachiwari_test.rb` にコメントと追加テストを導入し、挙動と境界ケースを文書化。
+- `lib/` 配下の主要クラスへ説明コメントを拡充し、アーキテクチャを明文化。
+
+## Upgrade Notes
+- Ruby 3.3 以降が必須です。環境の Ruby を更新してからアップグレードしてください。
+- 非推奨コマンド (`info`, `i`, `calculate`, `s`) は今後削除予定です。`status` / `status --trial` への移行を推奨します。
+- ヘルプ文言は `config/locales/` 配下の YAML を編集することでカスタマイズ可能です。
+
+## Test Summary
+- `bundle exec rake`（テストスイートと RuboCop を実行）

data/Rakefile

@@ -3,6 +3,7 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
 
+# `bundle exec rake test` でテストスイートを走らせるタスクを定義
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.libs << "lib"
@@ -11,6 +12,8 @@ end
 
 require "rubocop/rake_task"
 
+# `bundle exec rake rubocop` で静的解析を実行できるようにする
 RuboCop::RakeTask.new
 
+# デフォルトタスクでテストと RuboCop をまとめて実行
 task default: %i[test rubocop]

data/bin/hachiwari

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "hachiwari"
+
+Hachiwari::CLI.start

data/config/locales/de.yml

@@ -0,0 +1,70 @@
+de:
+  status:
+    summary: "%<total>d Spiele %<wins>d Siege %<losses>d Niederlagen Siegquote %<percentage>.4f %%"
+    needed: "Noch %<needed>d Siege bis zum Ziel von %<target>d %%"
+    cushion: "Nach %<losses_to_fall>d weiteren Niederlagen fällt die Quote unter %<target>d %%"
+  help:
+    general_intro: "Verfügbare Befehle:"
+    command_heading: "Befehl: %<usage>s"
+    description_heading: "Beschreibung: %<description>s"
+    unknown_command: "Der Befehl \"%<command>s\" ist nicht vorhanden."
+    general_footer:
+      - "Mit `hachiwari <befehl> --help` erhältst du weitere Details."
+    commands:
+      status:
+        usage: "hachiwari [status] [siege] [niederlagen] [ziel] [sprache]"
+        description: "Zeigt die Siegquote und die benötigten Siege zum Erreichen des Ziels an."
+        details:
+          - "'status' kann weggelassen werden; übergib nur die Argumente."
+          - "Option: --trial / -t für eine Simulation ohne zu speichern."
+      s:
+        usage: "hachiwari s   [siege] [niederlagen] [ziel] [sprache]"
+        description: "Veralteter Alias. Wird nach einer Warnung wie 'status' behandelt."
+      version:
+        usage: "hachiwari version"
+        description: "Zeigt die installierte Version von Hachiwari an."
+      clear:
+        usage: "hachiwari clear"
+        description: "Entfernt die gespeicherten Matchdaten."
+      info:
+        usage: "hachiwari info [siege] [niederlagen] [ziel] [sprache]"
+        description: "Veralteter Befehl. Bitte `status --trial` verwenden."
+        details:
+          - "Zeigt eine Warnung und verhält sich wie --trial."
+      i:
+        usage: "hachiwari i   [siege] [niederlagen] [ziel] [sprache]"
+        description: "Veralteter Alias von info."
+      calculate:
+        usage: "hachiwari calculate [siege] [niederlagen] --target=<wert> --language=<ja|en|es|fr|de>"
+        description: "Veralteter Befehl. Bitte `status --trial` verwenden."
+      help:
+        usage: "hachiwari help [befehl]"
+        description: "Zeigt die Liste der Befehle oder Details zu einem Befehl."
+  deprecations:
+    trial: "Dieser Befehl ist veraltet. Verwende `hachiwari status --trial`."
+    alias: "Dieser Alias ist veraltet. Verwende `hachiwari status --trial`."
+  thor:
+    status:
+      short: "Zeigt den aktuellen Stand und benötigte Siege"
+      long: "Zeigt die Siegquote und die Anzahl benötigter Siege, um das Ziel zu erreichen."
+      details:
+        - "'status' kann weggelassen werden; übergib nur die Argumente."
+        - "Option: --trial / -t für eine Simulation ohne Speicherung."
+      option_trial: "Simulation ohne Speicherung der Ergebnisse."
+    info:
+      short: "Veraltet. Verhält sich wie status --trial"
+      long: "Veralteter Befehl. Bitte status --trial verwenden."
+      option_trial: "Verwendet den Simulationsmodus von status."
+    alias_i:
+      short: "Veralteter Alias von info"
+      long: "Veralteter Alias. Bitte status --trial verwenden."
+    calculate:
+      short: "Veraltet. Verhält sich wie status --trial"
+      long: "Veralteter Befehl. Bitte status --trial verwenden."
+      option_trial: "Verwendet den Simulationsmodus von status."
+      option_target: "Ziel-Prozentsatz"
+      option_language: "Ausgabe-Sprache (ja, en, es, fr, de)"
+    version:
+      short: "Zeigt die installierte Version von Hachiwari an."
+    clear:
+      short: "Löscht die gespeicherten Ergebnisse."

data/config/locales/en.yml

@@ -0,0 +1,70 @@
+en:
+  status:
+    summary: "%<total>d games %<wins>d wins %<losses>d losses a winning percentage of %<percentage>.4f %%."
+    needed: "You need %<needed>d more wins to reach %<target>d %%."
+    cushion: "%<losses_to_fall>d more losses would drop you below %<target>d %%"
+  help:
+    general_intro: "Available commands:"
+    command_heading: "Command: %<usage>s"
+    description_heading: "Description: %<description>s"
+    unknown_command: "Command \"%<command>s\" was not found."
+    general_footer:
+      - "Run `hachiwari <command> --help` for more details."
+    commands:
+      status:
+        usage: "hachiwari [status] [wins] [losses] [target] [language]"
+        description: "Displays winning percentage and number of wins to achieve the goal. (use --trial to skip saving)"
+        details:
+          - "You can omit 'status' and just pass the arguments."
+          - "Option: --trial / -t to simulate without saving."
+      s:
+        usage: "hachiwari s   [wins] [losses] [target] [language]"
+        description: "Deprecated alias. You can omit 'status' and pass arguments directly."
+      version:
+        usage: "hachiwari version"
+        description: "Display the installed version of Hachiwari."
+      clear:
+        usage: "hachiwari clear"
+        description: "Remove any saved match results."
+      info:
+        usage: "hachiwari info [wins] [losses] [target] [language]"
+        description: "Deprecated. Please use `status --trial` instead."
+        details:
+          - "Running this command prints a warning and behaves like `status --trial`."
+      i:
+        usage: "hachiwari i   [wins] [losses] [target] [language]"
+        description: "Deprecated alias of info."
+      calculate:
+        usage: "hachiwari calculate [wins] [losses] --target=<value> --language=<ja|en|es|fr|de>"
+        description: "Deprecated. Please use `status --trial` instead."
+      help:
+        usage: "hachiwari help [command]"
+        description: "Show the list of commands or details for one command."
+  deprecations:
+    trial: "This command is deprecated. Use `hachiwari status --trial` instead."
+    alias: "This alias is deprecated. Use `hachiwari status --trial` instead."
+  thor:
+    status:
+      short: "Display current record and wins needed to reach the target"
+      long: "Displays winning percentage and number of wins to achieve the goal."
+      details:
+        - "You can omit 'status' and just pass the arguments."
+        - "Option: --trial / -t to simulate without saving."
+      option_trial: "Run in trial mode without saving results."
+    info:
+      short: "Deprecated. Behaves like status --trial"
+      long: "Deprecated command. Please use status --trial instead."
+      option_trial: "Use trial mode for the status command."
+    alias_i:
+      short: "Deprecated alias of info"
+      long: "Deprecated alias. Please use status --trial instead."
+    calculate:
+      short: "Deprecated. Behaves like status --trial"
+      long: "Deprecated command. Please use status --trial instead."
+      option_trial: "Use trial mode for the status command."
+      option_target: "Target percentage"
+      option_language: "Display language (ja, en, es, fr, de)"
+    version:
+      short: "Display the installed version of Hachiwari."
+    clear:
+      short: "Remove any saved match results."

data/config/locales/es.yml

@@ -0,0 +1,70 @@
+es:
+  status:
+    summary: "%<total>d partidas %<wins>d victorias %<losses>d derrotas porcentaje %<percentage>.4f %%"
+    needed: "Necesitas %<needed>d victorias más para alcanzar el %<target>d %%"
+    cushion: "Conceder %<losses_to_fall>d derrotas más bajará el porcentaje por debajo de %<target>d %%"
+  help:
+    general_intro: "Comandos disponibles:"
+    command_heading: "Comando: %<usage>s"
+    description_heading: "Descripción: %<description>s"
+    unknown_command: "El comando \"%<command>s\" no existe."
+    general_footer:
+      - "Usa `hachiwari <command> --help` para ver detalles de cada comando."
+    commands:
+      status:
+        usage: "hachiwari [status] [victorias] [derrotas] [objetivo] [idioma]"
+        description: "Muestra el porcentaje de victorias y las victorias necesarias para alcanzar la meta."
+        details:
+          - "Puedes omitir 'status' y pasar sólo los argumentos."
+          - "Opción: --trial / -t para simular sin guardar."
+      s:
+        usage: "hachiwari s   [victorias] [derrotas] [objetivo] [idioma]"
+        description: "Alias en desuso. Se procesará como 'status' tras mostrar una advertencia."
+      version:
+        usage: "hachiwari version"
+        description: "Muestra la versión instalada de Hachiwari."
+      clear:
+        usage: "hachiwari clear"
+        description: "Elimina los datos guardados del registro de partidas."
+      info:
+        usage: "hachiwari info [victorias] [derrotas] [objetivo] [idioma]"
+        description: "Comando obsoleto. Usa `status --trial`."
+        details:
+          - "Al ejecutarlo, muestra una advertencia y funciona igual que --trial."
+      i:
+        usage: "hachiwari i   [victorias] [derrotas] [objetivo] [idioma]"
+        description: "Alias obsoleto de info."
+      calculate:
+        usage: "hachiwari calculate [victorias] [derrotas] --target=<valor> --language=<ja|en>"
+        description: "Comando obsoleto. Usa `status --trial`."
+      help:
+        usage: "hachiwari help [comando]"
+        description: "Muestra la lista de comandos o los detalles de uno."
+  deprecations:
+    trial: "Este comando está obsoleto. Usa `hachiwari status --trial`."
+    alias: "Este alias está obsoleto. Usa `hachiwari status --trial`."
+  thor:
+    status:
+      short: "Muestra el resultado actual y las victorias necesarias"
+      long: "Muestra el porcentaje de victorias y cuántas victorias necesitas para alcanzar el objetivo."
+      details:
+        - "Puedes omitir 'status' y pasar sólo los argumentos."
+        - "Opción: --trial / -t para simular sin guardar."
+      option_trial: "Simula sin guardar el resultado."
+    info:
+      short: "Obsoleto. Se comporta como status --trial"
+      long: "Comando obsoleto. Usa status --trial."
+      option_trial: "Usa el modo de simulación de status."
+    alias_i:
+      short: "Alias obsoleto de info"
+      long: "Alias en desuso. Usa status --trial."
+    calculate:
+      short: "Obsoleto. Se comporta como status --trial"
+      long: "Comando obsoleto. Usa status --trial."
+      option_trial: "Usa el modo de simulación de status."
+      option_target: "Porcentaje objetivo"
+      option_language: "Idioma de salida (ja, en, es, fr, de)"
+    version:
+      short: "Muestra la versión instalada de Hachiwari."
+    clear:
+      short: "Elimina los resultados guardados."

data/config/locales/fr.yml

@@ -0,0 +1,70 @@
+fr:
+  status:
+    summary: "%<total>d parties %<wins>d victoires %<losses>d défaites pourcentage %<percentage>.4f %%"
+    needed: "Encore %<needed>d victoires pour atteindre %<target>d %%"
+    cushion: "Après %<losses_to_fall>d défaites supplémentaires, le pourcentage passera sous %<target>d %%"
+  help:
+    general_intro: "Commandes disponibles :"
+    command_heading: "Commande : %<usage>s"
+    description_heading: "Description : %<description>s"
+    unknown_command: "La commande \"%<command>s\" n'existe pas."
+    general_footer:
+      - "Utilisez `hachiwari <commande> --help` pour plus de détails."
+    commands:
+      status:
+        usage: "hachiwari [status] [victoires] [défaites] [objectif] [langue]"
+        description: "Affiche le pourcentage de victoires et le nombre de victoires nécessaires pour atteindre l'objectif."
+        details:
+          - "Vous pouvez omettre 'status' et passer uniquement les arguments."
+          - "Option : --trial / -t pour simuler sans enregistrer."
+      s:
+        usage: "hachiwari s   [victoires] [défaites] [objectif] [langue]"
+        description: "Alias obsolète. Sera traité comme 'status' après un avertissement."
+      version:
+        usage: "hachiwari version"
+        description: "Affiche la version installée de Hachiwari."
+      clear:
+        usage: "hachiwari clear"
+        description: "Supprime les données sauvegardées des matchs."
+      info:
+        usage: "hachiwari info [victoires] [défaites] [objectif] [langue]"
+        description: "Commande obsolète. Utilisez `status --trial`."
+        details:
+          - "Affiche un avertissement et se comporte comme --trial."
+      i:
+        usage: "hachiwari i   [victoires] [défaites] [objectif] [langue]"
+        description: "Alias obsolète de info."
+      calculate:
+        usage: "hachiwari calculate [victoires] [défaites] --target=<valeur> --language=<ja|en|es|fr|de>"
+        description: "Commande obsolète. Utilisez `status --trial`."
+      help:
+        usage: "hachiwari help [commande]"
+        description: "Affiche la liste des commandes ou les détails d'une commande."
+  deprecations:
+    trial: "Cette commande est obsolète. Utilisez `hachiwari status --trial`."
+    alias: "Cet alias est obsolète. Utilisez `hachiwari status --trial`."
+  thor:
+    status:
+      short: "Affiche le résultat actuel et les victoires nécessaires"
+      long: "Affiche le pourcentage de victoires et le nombre de victoires nécessaires pour atteindre l'objectif."
+      details:
+        - "Vous pouvez omettre 'status' et passer uniquement les arguments."
+        - "Option : --trial / -t pour simuler sans enregistrer."
+      option_trial: "Simuler sans enregistrer les résultats."
+    info:
+      short: "Obsolète. Se comporte comme status --trial"
+      long: "Commande obsolète. Utilisez status --trial."
+      option_trial: "Utilise le mode simulation de status."
+    alias_i:
+      short: "Alias obsolète de info"
+      long: "Alias obsolète. Utilisez status --trial."
+    calculate:
+      short: "Obsolète. Se comporte comme status --trial"
+      long: "Commande obsolète. Utilisez status --trial."
+      option_trial: "Utilise le mode simulation de status."
+      option_target: "Pourcentage cible"
+      option_language: "Langue d'affichage (ja, en, es, fr, de)"
+    version:
+      short: "Affiche la version installée de Hachiwari."
+    clear:
+      short: "Supprime les données sauvegardées."

data/config/locales/ja.yml

@@ -0,0 +1,70 @@
+ja:
+  status:
+    summary: "%<total>d 戦 %<wins>d 勝 %<losses>d 敗 勝率 %<percentage>.4f %% です"
+    needed: "あと %<needed>d 勝で 勝率 %<target>d %% です"
+    cushion: "あと %<losses_to_fall>d 敗すると 勝率 %<target>d %% を下回ります"
+  help:
+    general_intro: "利用可能なコマンド:"
+    command_heading: "コマンド: %<usage>s"
+    description_heading: "説明: %<description>s"
+    unknown_command: "コマンド \"%<command>s\" は存在しません。"
+    general_footer:
+      - "各コマンドの詳細は `hachiwari <command> --help` で確認できます。"
+    commands:
+      status:
+        usage: "hachiwari [status] [wins] [losses] [target] [language]"
+        description: "保存済みまたは指定した勝敗から、勝率と必要勝ち数を表示します。"
+        details:
+          - "status は省略可能です。引数のみでも実行できます。"
+          - "オプション: --trial / -t で保存せず試算します。"
+      s:
+        usage: "hachiwari s   [wins] [losses] [target] [language]"
+        description: "廃止予定のエイリアスです。status を省略して引数のみでも実行できます。"
+      version:
+        usage: "hachiwari version"
+        description: "Hachiwari のバージョン番号を表示します。"
+      clear:
+        usage: "hachiwari clear"
+        description: "保存されている対局成績データを削除します。"
+      info:
+        usage: "hachiwari info [wins] [losses] [target] [language]"
+        description: "廃止予定のコマンドです。status --trial を使用してください。"
+        details:
+          - "実行すると警告を表示し、--trial 相当の結果を出力します。"
+      i:
+        usage: "hachiwari i   [wins] [losses] [target] [language]"
+        description: "info コマンドの非推奨エイリアスです。"
+      calculate:
+        usage: "hachiwari calculate [wins] [losses] --target=<value> --language=<ja|en|es|fr|de>"
+        description: "廃止予定のコマンドです。status --trial を使用してください。"
+      help:
+        usage: "hachiwari help [command]"
+        description: "コマンド一覧や詳細を表示します。"
+  deprecations:
+    trial: "このコマンドは廃止されました。代わりに `hachiwari status --trial` を利用してください。"
+    alias: "このエイリアスは廃止予定です。`hachiwari status --trial` を利用してください。"
+  thor:
+    status:
+      short: "対局成績を表示し、必要勝ち数を計算します"
+      long: "保存済みまたは指定した勝敗から、勝率と必要勝ち数を表示します。"
+      details:
+        - "status は省略可能です。引数のみでも実行できます。"
+        - "オプション: --trial / -t で保存せず試算します。"
+      option_trial: "試算モードで保存せずに結果を表示します。"
+    info:
+      short: "廃止予定。status --trial と同等に動作します"
+      long: "廃止予定のコマンドです。status --trial を使用してください。"
+      option_trial: "status の試算モードを利用します。"
+    alias_i:
+      short: "info の非推奨エイリアスです"
+      long: "廃止予定のエイリアスです。status --trial を使用してください。"
+    calculate:
+      short: "廃止予定。status --trial と同等に動作します"
+      long: "廃止予定のコマンドです。status --trial を使用してください。"
+      option_trial: "status の試算モードを利用します。"
+      option_target: "目標勝率"
+      option_language: "表示言語 (ja, en, es, fr, de)"
+    version:
+      short: "Hachiwari のバージョン番号を表示します。"
+    clear:
+      short: "保存されている対局成績データを削除します。"

data/hachiwari.gemspec

@@ -3,39 +3,34 @@
 require_relative "lib/hachiwari/version"
 
 Gem::Specification.new do |spec|
+  # Gem の基本的なメタ情報を定義
   spec.name          = "hachiwari"
   spec.version       = Hachiwari::VERSION
   spec.authors       = ["Atelier-Mirai"]
   spec.email         = ["contact@atelier-mirai.net"]
 
-  spec.summary       = "Winning rate 80%"
-  spec.description   = "Calculate the number of wins needed to achieve an 80% win rate."
+  spec.summary       = "Track progress toward your target win rate"
+  spec.description   = "Enter your record and instantly see how many wins you need to reach 80% or a custom goal."
   spec.homepage      = "https://github.com/Atelier-Mirai/hachiwari"
   spec.license       = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  # spec.metadata["allowed_push_host"] = "https://github.com/Atelier-Mirai/hachiwari"
+  spec.required_ruby_version = ">= 3.3.0"
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/Atelier-Mirai/hachiwari"
   spec.metadata["changelog_uri"] = "https://github.com/Atelier-Mirai/hachiwari/blob/master/CHANGELOG.md"
 
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  # 配布対象ファイルを Git の管理対象から自動検出
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject do |f|
       (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
     end
   end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
-
-  # For more information and examples about making a new gem, checkout our
-  # guide at: https://bundler.io/guides/creating_gem.html
+  # 実行可能ファイルの配置先と読み込み対象ディレクトリを指定
+  spec.bindir = "bin"
+  spec.executables = Dir.children("bin")
+  spec.require_paths = %w[lib]
 
+  # ランタイムで利用する依存関係を宣言
+  spec.add_dependency "pstore"
   spec.add_dependency "thor"
 end