images-convert 0.4.1

data/README.md

@@ -0,0 +1,378 @@
+# ImageMagickで簡単画像変換
+
+[![RubyGems Version](https://img.shields.io/gem/v/images-convert.svg)](https://rubygems.org/gems/images-convert)
+[![RubyGems Downloads](https://img.shields.io/gem/dt/images-convert.svg)](https://rubygems.org/gems/images-convert)
+[![CI](https://github.com/Atelier-Mirai/images-convert/actions/workflows/ci.yml/badge.svg)](https://github.com/Atelier-Mirai/images-convert/actions/workflows/ci.yml)
+
+ImageMagickを使った画像形式変換のためのRuby gem。Thorで構築され、単一ファイル変換、ディレクトリ一括変換、設定値の保存機能、waifu2xによる高解像度アップスケールを備えたCLIツールです。HEIC、JPG、PNG、WebPなど様々な画像形式間の変換をサポートします。
+
+## インストール
+
+**インストールは超簡単！ ターミナルから次のコマンドを実行するだけ**
+```bash
+gem install images-convert
+```
+
+**🎉 インストール完了！** すぐに使い始めてみましょう！
+```bash
+# 単一ファイル変換
+# HEIC→JPGへの変換が既定値です。画像幅は1920xにリサイズされます。
+# 例: ~/Downloads/IMG_2000.HEIC を ~/Desktop/IMG_2000.jpg に変換
+images-convert IMG_2000.HEIC ~/Downloads ~/Desktop
+
+# 入力ディレクトリは ~/Downloads、出力ディレクトリは ~/Desktop が既定値です。
+# また、画像ファイル名がIMG_で始まる場合は、以下のように省略できます。
+images-convert 2000
+
+# 短縮コマンド（エイリアス）を用いて、同じ操作を実行できます。
+imgconv 2000
+
+# 「最新N件をまとめて変換」ショートカット
+images-convert -5    # 最新の5件を既定値で変換
+images-convert -0    # すべての対象ファイルを既定値で変換
+images-convert --all # すべての対象ファイルを既定値で変換
+```
+
+## 基本的な使い方
+
+### HEICをJPGに変換する
+入力ディレクトリは `~/Downloads`、出力ディレクトリは `~/Desktop` が既定値です。
+また、画像ファイル名が `IMG_` で始まる場合は、`IMG_2000.HEIC` に代えて、`2000` と省略できます。
+
+```bash
+images-convert 2000
+# または
+imgconv 2000
+```
+
+### 最新N件/全件を変換する
+既定の入出力ディレクトリ、変換形式、リサイズ幅を用いて、最新N件または全件を変換します。
+判定基準の既定値は、`mtime`（ファイル更新日時）です。`exif`（EXIF 撮影日時）を基準に最新N件を選定する場合は、`--latest-exif` オプションを指定します。
+
+```bash
+images-convert -5               # 最新5件を既定値で変換
+images-convert -5 --latest-exif # EXIF 撮影日時で最新5件を変換
+images-convert -0               # すべての対象ファイルを既定値で変換
+images-convert --all            # --all でも同じ
+```
+
+### 最新件数の判定基準を切り替える
+
+`-N` を利用した際の「最新順」の基準は、`mtime`（ファイル更新日時）が既定値ですが、 `exif`（EXIF 撮影日時）を既定値に設定することもできます。
+
+```bash
+images-convert set-latest-mode exif  # 以後は EXIF を基準に最新N件を選定する
+images-convert set-latest-mode mtime # ファイル更新日時を既定値に戻す
+```
+
+### 直接入出力ディレクトリやリサイズ幅を指定する
+以下のように書くことで、任意の入出力ディレクトリや変換形式、リサイズ幅を指定できます。`~/Pictures/flower.jpg` は入力ファイル、`~/Desktop/flower.webp` は出力ファイル、`1024x` はリサイズ幅を表します。
+
+```bash
+images-convert ~/Pictures/flower.jpg ~/Desktop/flower.webp 1024x
+```
+
+ディレクトリ名を省略した場合には、既定値の入出力ディレクトリが用いられます。
+横幅を1024xにリサイズして、flower.jpgをflower.webpに変換します。
+
+```bash
+images-convert flower.jpg flower.webp 1024x
+```
+
+高さをx1024にリサイズして、flower.jpgをflower.webpに変換します。
+
+```bash
+images-convert flower.jpg flower.webp x1024
+```
+
+横幅を50%にリサイズして、flower.jpgをflower.webpに変換します。
+
+```bash
+images-convert flower.jpg flower.webp 50%
+```
+
+### 変換形式やリサイズ幅、入出力ディレクトリを変更する
+
+既定値を、ご自身が良く用いる変換形式やリサイズ幅に変更できます。
+
+```bash
+# 例: JPG→WebP、リサイズ幅1024x
+images-convert set JPG WebP 1024x
+# 例: JPG→WebP、リサイズ幅50% (拡張子は大文字小文字を区別しません。またjpg/jpegを同一視します。)
+images-convert set jpeg webp 50%
+```
+
+以後はファイル名（または番号）だけで変換できます。
+
+```bash
+# 例: ~/Downloads/flower.jpg を ~/Desktop/flower.webp に変換
+images-convert flower
+# 例: ~/Downloads/IMG_2000.jpg を ~/Desktop/IMG_2000.webp に変換
+images-convert 2000
+```
+
+入力/出力ディレクトリを設定することも可能です。
+入力元 `~/Documentsフォルダ`、出力先 `~/Documents/converted`フォルダにする例です。
+
+```bash
+images-convert set-dir ~/Documents ~/Documents/converted
+```
+
+### waifu2x による高解像度化（AI アップスケール）
+
+`--resize` などで指定したサイズが現在の画像より大きくなる場合、自動的に waifu2x (waifu2x-ncnn-vulkan) を利用した高解像度化に切り替わります。waifu2x 実行ファイルやモデルは、必要に応じて自動ダウンロードされます。
+
+```bash
+# 例: 元画像が幅500pxの場合は 4 倍に拡大
+images-convert input.png --resize 2000x --output output.png
+```
+
+出力形式が `png`/`jpg`/`jpeg`/`webp` のいずれかであれば、自動アップスケールが適用されます。それ以外の形式やアップスケール不要な場合は、従来どおり MiniMagick による通常変換が行われます。
+
+> **補足**: たとえば元画像が 300px なら waifu2x が 4 倍、700px なら 2 倍に拡大し、最後は MiniMagick が `--resize` で指定した 2000px へ仕上げます。常に最終出力は `--resize` の指示どおりになります。
+
+#### waifu2x の既定値を設定する
+
+```bash
+# 例: 既定倍率4倍、ノイズ除去レベル3、モデル anime を設定
+images-convert config set-waifu2x --scale 4 --noise 3 --model anime
+
+# 例: A4向け自動スケールを無効化し、出力フォーマットを jpg に固定
+images-convert config set-waifu2x --no-auto-scale-a4 --image_format jpg
+```
+
+利用可能な主なオプション（`config set-waifu2x`）:
+
+- `--scale NUM` … 既定の拡大率 (1〜4, 3は4と同等)
+- `--noise NUM` … ノイズ除去レベル (0〜4)
+- `--model NAME` … モデルエイリアス（例: `anime`, `photo`, `anime_style_art_rgb` など）
+- `--[no-]auto-scale-a4` … A4 用紙に合わせた自動スケール調整を利用するか
+- `--[no-]a4-print` … PDF 生成時に A4 レイアウトを適用するか
+- `--image_format FORMAT` … waifu2x の出力画像フォーマット
+- `--on_error ACTION` … エラー発生時の挙動 (`stop` または `skip`)
+- `--quality NUM` … waifu2x 出力品質 (1〜100, 未指定時は既定値)
+
+設定後は `images-convert config` で現在の waifu2x 既定値を確認できます。
+
+#### PDF を生成する
+
+複数ページの PDF を出力したい場合は、`--output-mode` に `pdf` または `both` を指定します。拡大・縮小のいずれの場合でも利用でき、`both` を指定すると画像出力と PDF を同時に取得できます。
+
+```bash
+# 例: ディレクトリ内の画像を拡大（または縮小）して PDF 化
+images-convert convert /path/to/images --output-mode pdf --waifu2x-model anime --pdf-quality 90 --pdf-density 300
+
+# 例: 拡大（または縮小）した画像と PDF を両方出力
+images-convert convert /path/to/images --output-mode both --waifu2x-image-format webp
+```
+
+PDF 関連オプション:
+
+- `--pdf-compression {jpeg|jpeg2000|zip}` … PDF に埋め込む画像の圧縮方式
+- `--pdf-quality NUM` … 圧縮品質 (0〜100)
+- `--pdf-density NUM` … ページ解像度 (DPI)
+- `--waifu2x-a4-print/--no-waifu2x-a4-print` … A4 レイアウト (余白・中央寄せ) の有無
+
+PDF 出力先は、指定がなければ入力ディレクトリに `ディレクトリ名.pdf` として作成されます。`--output` や `--output-dir` と組み合わせて保存先を調整できます。
+
+### 最新件数の判定基準を切り替える
+
+`--latest` を利用した際の「最新順」の基準を `mtime`（ファイル更新日時）と `exif`（EXIF 撮影日時）から選べます。
+
+```bash
+images-convert set-latest-mode exif  # 以後は EXIF を基準に最新N件を選定
+images-convert set-latest-mode mtime # 既定値（ファイル更新日時）に戻す
+```
+
+### ディレクトリからディレクトリへ一括変換する
+入力ディレクトリ内にある画像ファイルを纏めて、出力ディレクトリに変換することができます。
+
+例: `~/Pictures/HEIC` ディレクトリ内の `HEIC`ファイルを、`~/Desktop/converted` ディレクトリに `JPG(既定値)` + `リサイズ幅1920x(既定値)`で一括変換する
+
+```bash
+images-convert ~/Pictures/HEIC ~/Desktop/converted
+```
+
+事前に出力形式やサイズを変更しておけば、その設定が適用されます
+
+```bash
+images-convert set HEIC WebP 1024x
+# 以降は、HEIC->WebP、1024xで一括変換されます。
+images-convert convert ~/Pictures/HEIC ~/Desktop/converted
+```
+
+### 引数
+
+`images-convert ファイル名または番号`
+または
+`images-convert 入力ディレクトリ 出力ディレクトリ`
+- ファイル名または番号のみ指定すれば、設定された形式・サイズで変換します
+- ディレクトリ指定時は、入力ディレクトリ内の対象拡張子を一括で変換し、出力ディレクトリに保存します
+- 対応形式: HEIC, JPG, PNG, GIF, WebP, TIFF, BMP, ICO, PDFなど、ImageMagickでサポートする形式
+- 形式名は大文字・小文字を区別しません（例: HEIC/heic/JPG/jpg いずれも可）
+- jpeg 指定時は出力拡張子を jpg に統一します（入力は .jpg / .jpeg の両方を自動検出）
+
+入力ディレクトリに変換後のファイルを書き出す場合には、出力ディレクトリの指定を省略できます。
+`images-convert 入力ディレクトリ兼出力ディレクトリ`
+
+### オプション
+- `-h, --help`: ヘルプメッセージを表示
+- `-v, --version`: バージョン情報を表示
+
+- `-d, --delete`: 変換後に元のファイルを削除
+- `-i, --input_dir`: 入力ディレクトリを指定
+- `-o, --output_dir`: 出力ディレクトリを指定
+- `-f, --overwrite`: 既存の出力ファイルがある場合に上書き（デフォルトはスキップ）
+- `-s, --suffix VALUE`: 出力ファイル名にサフィックスを付与（例: `_resized`）
+- `--recursive`: ディレクトリを再帰的に処理
+- `--latest N`: 入力ディレクトリ内（既定は設定の input_dir）から更新日時の新しい順に N 件を変換
+- `-N`: 入力ディレクトリ内（既定は設定の input_dir）から更新日時の新しい順に N 件を変換（ショートカット）
+- `--all` または `-0`: 入力ディレクトリ内の対象ファイルをすべて変換
+- `--quality NUM`: JPEG / WebP などの出力品質 (1〜100)。未指定時は設定ファイルの既定値を使用
+
+ディレクトリ一括変換で `入力ディレクトリ` のみ指定した場合についての補足説明:
+- JPG から WebP への変換など、異なる形式の変換を行う場合は、出力先は入力先と同じディレクトリになります。
+(例: 同じディレクトリに flower.jpg -> flower.webp が生成されます。)
+- JPG から JPG への変換など、同一形式の変換を行う場合（リサイズのみを行う場合）は、出力先は入力先と同じディレクトリですが、安全の為、デフォルトでは上書きしません。`--overwrite` を明示することにより、上書きを許可できます。(flower.jpg -> flower.jpg)。または `--suffix _resized` を使用して、flower.jpg -> flower_resized.jpg のように出力ファイル名を変更できます。
+
+### 既定値（デフォルト設定）
+
+初回実行時に自動作成される設定ファイル（`~/.images-convert/config.yml`）の既定値は以下の通りです。
+
+- 入力形式（from）: HEIC
+- 出力形式（to）: JPG
+- リサイズ（resize）: 1920x
+- 入力ディレクトリ: `~/Downloads`
+- 出力ディレクトリ: `~/Desktop`
+
+### 設定のカスタマイズ
+
+**使いやすいように、自分好みの設定にカスタマイズしましょう！**
+
+```bash
+# 現在の設定を表示（初回実行時は自動で設定ファイルが作成されます）
+images-convert config
+
+# デフォルト値を変更（例: JPG→WebP、サイズ1024x）
+images-convert config set JPG WebP 1024x
+
+# 設定変更後は省略して使用可能
+images-convert 2000  # JPG→WebP、1024xで変換、Documentsフォルダから出力
+
+# 最新N件を指定のディレクトリで
+images-convert -3 --input_dir ~/Pictures --output_dir ~/Desktop
+# または次のように省略できます
+images-convert -3 ~/Pictures ~/Desktop
+
+# コマンドラインオプションで一時的に指定することもできます。
+# 例: 入力ディレクトリを ~/Pictures、出力ディレクトリを ~/Desktop に指定する例
+images-convert flower ~/Pictures ~/Desktop
+images-convert 2000   ~/Pictures ~/Desktop
+```
+
+**設定ファイルは自動で作成されます** `~/.images-convert/config.yml` に保存されます。
+既定値へ戻したい場合は `imgconv config reset` を実行してください（確認を省略する場合は `--force` を付与）。
+
+### アンインストール時のクリーンアップ
+
+gemをアンインストールする際は、設定ファイルも自動で削除されます:
+
+```bash
+images-convert cleanup
+```
+
+これで `~/.images-convert/` ディレクトリ全体が削除されます。
+
+### 設定ファイルの例（既定値）
+
+Gemインストール直後に作成される設定ファイルは次のようになっています。
+
+```yaml
+# ~/.images-convert/config.yml
+defaults:
+  from: HEIC      # 入力形式
+  to: JPG         # 出力形式
+  resize: 1920x   # リサイズ値
+directories:
+  input: ~/Downloads    # 入力ディレクトリ
+  output: ~/Desktop     # 出力ディレクトリ
+selection:
+  latest_mode: mtime    # 最新件数判定基準 (mtime/exif)
+waifu2x:
+  scale: 2              # 拡大率 (1-4)
+  noise: 1              # ノイズ除去レベル (0-4)
+  model: photo          # モデルエイリアス
+  auto_scale_a4: true   # A4基準の自動スケール調整
+  a4_print: true        # A4レイアウトPDF調整（デフォルトで有効）
+  image_format: webp    # waifu2x出力フォーマット
+  on_error: stop        # エラー時の挙動 (stop/skip)
+output:
+  image_quality: 90     # 出力画像品質 (1-100)
+  pdf_quality: 90       # PDF埋め込み画像の品質 (1-100)
+  pdf_compression: jpeg # PDF埋め込み画像の圧縮方式 (jpeg/jpeg2000/zip)
+  pdf_density: 300      # PDF埋め込み画像のDPI
+```
+
+### 対話式セットアップを利用する
+
+`imgconv setup` コマンドを実行すると、既定値を対話形式で更新できるウィザードが起動します。
+
+```bash
+bin/imgconv setup
+```
+
+- **現在値を保持したい場合は Enter** キーを押すだけで OK です。
+- `y`/`n` の質問では、「現在値」と「既定値」が併記されるため、いま有効になっている設定を確認しながら変更できます。
+- 形式名やモデル名など、候補が決まっている項目は、入力ミスがあれば再入力を求めます（例: 最新判定モードは `mtime` または `exif` のみ受け付け）。
+- ウィザード終了時には、変更された項目が `旧値 => 新値` の形式で表示され、新しい値は端末上で緑色でハイライトされます。
+- そのまま `imgconv config` が呼び出され、**最新の設定一式が即座に表示** されます。
+
+### ヘルプを表示する
+
+```bash
+images-convert --help
+# または
+imgconv --help
+```
+
+### バージョン情報を表示する
+
+```bash
+images-convert --version
+# または
+imgconv --version
+```
+
+## 要件
+
+- Ruby 3.3+
+  - `images-convert` は Ruby 製の CLI ツールです。Ruby 3.3 以上がインストールされた環境でご利用ください。
+- ImageMagick（未導入の場合は初回実行時に自動導入を案内します）
+  - 変換処理には ImageMagick を利用します。インストールされていない場合、初回実行時に対話形式で導入を案内します。
+- waifu2x-ncnn-vulkan（AI アップスケール機能を使用する場合）
+  - waifu2x バイナリを環境に用意するか、または `config set-waifu2x` でパス/自動ダウンロードURLを指定してください。
+
+## 開発
+
+貢献するには：
+1. リポジトリを取得し、ローカル環境にクローンします。
+2. プロジェクトディレクトリへ移動し、依存関係をインストールしてください。
+
+```bash
+git clone https://github.com/Atelier-Mirai/images-convert.git
+cd images-convert
+bundle install
+```
+
+## ライセンス
+
+MIT License です。詳しくは [LICENSE](./LICENSE) ファイルをご確認ください。
+
+### テストで使用している画像の出典
+
+- 桜と小鳥、メジロの夫婦: https://www.photo-ac.com/main/detail/28776655
+- 青空とひまわり: https://www.photo-ac.com/main/detail/33232207
+- 秋の満月: https://www.photo-ac.com/main/detail/27810146
+- 雪だるま: https://www.photo-ac.com/main/detail/4880573
+
+これらの写真をご提供くださった photoAC の作者の皆さまに深く感謝いたします。

data/RELEASE_NOTES_v0.2.12.md

@@ -0,0 +1,66 @@
+# images-convert 0.2.12
+
+リリース日: 2025-09-25
+
+## ハイライト
+- EXIF 撮影日時を基準にした「最新 N 件」選定に対応（`--latest-exif`）。
+- 既定の最新選定基準を設定できる `set-latest-mode` コマンドを追加（`mtime`/`exif`）。
+- 設定ファイルに `selection.latest_mode` を追加し、設定の表示/保存/読み込みに対応。
+
+## 変更点詳細
+- 機能追加
+  - `--latest-exif` フラグを追加（`--latest N` と併用）。
+    - EXIF の `DateTimeOriginal` / `CreateDate` / `DateTimeDigitized` / `DateTime` の順で解析し、並び替えに使用。
+    - EXIF が無い、または解析失敗時はファイル更新日時（mtime）へフォールバックし、実行時にその旨を通知。
+  - `images-convert config set-latest-mode MODE` を追加（`MODE`: `mtime` または `exif`）。
+    - 現在設定は `images-convert config` で確認可能。
+- 設定ファイル
+  - `~/.images-convert/config.yml` に `selection.latest_mode` を追加。例:
+    ```yaml
+    selection:
+      latest_mode: mtime
+    ```
+- CLI オプション/ヘルプ
+  - `convert` コマンドに `--latest-exif` を追加。
+  - 最新 N 件/全件の選定メッセージに基準（`mtime`/`exif`）を表示。
+- ドキュメント
+  - `README.md` に `--latest-exif` と `set-latest-mode` の使い方を追記。
+- テスト
+  - `CLILatestSelectionTest`: EXIF 順ソートと mtime フォールバックのテストを追加。
+  - `CLIConfigTest`: `set-latest-mode` の正常系/異常系テストを追加。
+
+## 破壊的変更
+ - 廃止: `--dry-run` オプションを削除しました。テスト用途は MiniMagick スタブにより実変換検証で代替します。
+ - 変更: 短縮コマンド名を `imgcvt` から `imgconv` に統一しました（エイリアス移行）。
+
+## アップグレード手順
+1. gem を更新:
+   ```bash
+   gem install images-convert
+   # もしくは
+   bundle update images-convert
+   ```
+2. 既定の最新判定基準を EXIF にしたい場合:
+   ```bash
+   images-convert config set-latest-mode exif
+   ```
+3. 破壊的変更への対応（必要な場合）:
+   - `--dry-run` を使っていた箇所を削除
+   - `imgcvt` を使用しているスクリプトは `imgconv` に置換
+
+## 利用例
+- EXIF を基準に最新 5 件を変換:
+  ```bash
+  images-convert --latest 5 --latest-exif
+  ```
+- 既定の基準を EXIF に設定（以降は `--latest N` のみで EXIF 基準を使用）:
+  ```bash
+  images-convert config set-latest-mode exif
+  ```
+- 全件変換（従来どおり）:
+  ```bash
+  images-convert --all
+  ```
+
+## 参考
+- 変更の全体像は `CHANGELOG.md` の「未リリース」セクションを参照してください。

data/RELEASE_NOTES_v0.2.3.md

@@ -0,0 +1,19 @@
+# images-convert 0.2.3
+
+以下は CHANGELOG.md の 0.2.3 抜粋です。
+
+## 0.2.3 - 2025-09-23
+- 機能追加: 「最新の画像 N 件」または「全件」を既定値に従って一括変換できるオプションを追加
+  - `-N`（例: `-1`, `-5`）… 最新の N 件を変換（`convert --latest N` のショートカット）
+  - `-0` / `--all` … すべての対象ファイルを変換
+  - サブコマンド省略時でも `images-convert -5` のように実行可能（内部的に `convert` を補完）
+  - 入力/出力ディレクトリや from/to/resize は設定ファイルの既定値（`images-convert config`）を使用
+
+### 使用例
+```bash
+images-convert -1                     # 最新1件
+images-convert -5 --delete            # 最新5件、変換後に元ファイル削除
+images-convert -0 --overwrite         # 全件、上書き許可
+images-convert convert --latest 3     # ロングオプション
+images-convert convert --all
+```

data/RELEASE_NOTES_v0.3.0.md

@@ -0,0 +1,66 @@
+# images-convert 0.3.0
+
+リリース日: 2025-09-25
+
+## ハイライト
+- EXIF 撮影日時を基準にした「最新 N 件」選定に対応（`--latest-exif`）。
+- 既定の最新選定基準を設定できる `set-latest-mode` コマンドを追加（`mtime`/`exif`）。
+- 設定ファイルに `selection.latest_mode` を追加し、設定の表示/保存/読み込みに対応。
+
+## 変更点詳細
+- 機能追加
+  - `--latest-exif` フラグを追加（`--latest N` と併用）。
+    - EXIF の `DateTimeOriginal` / `CreateDate` / `DateTimeDigitized` / `DateTime` の順で解析し、並び替えに使用。
+    - EXIF が無い、または解析失敗時はファイル更新日時（mtime）へフォールバックし、実行時にその旨を通知。
+  - `images-convert config set-latest-mode MODE` を追加（`MODE`: `mtime` または `exif`）。
+    - 現在設定は `images-convert config` で確認可能。
+- 設定ファイル
+  - `~/.images-convert/config.yml` に `selection.latest_mode` を追加。例:
+    ```yaml
+    selection:
+      latest_mode: mtime
+    ```
+- CLI オプション/ヘルプ
+  - `convert` コマンドに `--latest-exif` を追加。
+  - 最新 N 件/全件の選定メッセージに基準（`mtime`/`exif`）を表示。
+- ドキュメント
+  - `README.md` に `--latest-exif` と `set-latest-mode` の使い方を追記。
+- テスト
+  - `CLILatestSelectionTest`: EXIF 順ソートと mtime フォールバックのテストを追加。
+  - `CLIConfigTest`: `set-latest-mode` の正常系/異常系テストを追加。
+
+## 破壊的変更
+- 廃止: `--dry-run` オプションを削除しました。テスト用途は MiniMagick スタブにより実変換検証で代替します。
+- 変更: 短縮コマンド名を `imgcvt` から `imgconv` に統一しました（エイリアス移行）。
+
+## アップグレード手順
+1. gem を更新:
+   ```bash
+   gem install images-convert
+   # もしくは
+   bundle update images-convert
+   ```
+2. 既定の最新判定基準を EXIF にしたい場合:
+   ```bash
+   images-convert config set-latest-mode exif
+   ```
+3. 破壊的変更への対応（必要な場合）:
+   - `--dry-run` を使っていた箇所を削除
+   - `imgcvt` を使用しているスクリプトは `imgconv` に置換
+
+## 利用例
+- EXIF を基準に最新 5 件を変換:
+  ```bash
+  images-convert --latest 5 --latest-exif
+  ```
+- 既定の基準を EXIF に設定（以降は `--latest N` のみで EXIF 基準を使用）:
+  ```bash
+  images-convert config set-latest-mode exif
+  ```
+- 全件変換（従来どおり）:
+  ```bash
+  images-convert --all
+  ```
+
+## 参考
+- 変更の全体像は `CHANGELOG.md` の「0.3.0」セクションを参照してください。

data/RELEASE_NOTES_v0.4.0.md

@@ -0,0 +1,14 @@
+# リリースノート v0.4.0 (2025-09-26)
+
+## ハイライト
+- `imgconv setup` の**対話式セットアップウィザード**を新設しました。質問形式で現在値と既定値を確認しながら設定でき、入力内容を検証して誤りを防ぎます。完了時には変更点を色付きで比較表示し、そのまま `imgconv config` を実行して最新設定を即確認できます。
+- **waifu2x 連携**を追加しました。リサイズ指定が元画像を上回る場合、自動的に waifu2x (waifu2x-ncnn-vulkan) に委譲して高解像度化します。`config set-waifu2x` で倍率・ノイズ除去・モデル・エラー時動作などを細かく調整でき、バイナリ/モデルパスや PDF 出力モードの上書きにも対応します。
+
+## 改善
+- `lib/images_convert/mini_magick_stub.rb` を拡張し、寸法取得や `Image.ping` のスタブを実装しました。ImageMagick が無い環境でもテストを強化できます。
+
+## テストと品質
+- `lib/images_convert/waifu2x_test_stub.rb` と `test/test_waifu2x.rb` を追加し、waifu2x パイプライン全体をテスト可能にしました。本番コードとスタブの両方で安定した動作を担保します。
+
+## アップグレード手順
+- アップグレード後は `bin/imgconv setup` を実行し、ウィザードで既定値を見直してください。終了時に自動で表示される `imgconv config` で設定内容を確認できます。

data/RELEASE_NOTES_v0.4.1.md

@@ -0,0 +1,13 @@
+# リリースノート v0.4.1 (2025-09-26)
+
+## ハイライト
+- `imgconv config reset` サブコマンドを追加しました。確認プロンプト付きで設定を既定値に戻せるようになり、`--force` オプションで確認をスキップできます。
+
+## 変更点
+- CLI `config` コマンドに `reset` サブコマンドを実装し、復元後は `show_all_settings` の結果を即座に表示して現在の構成を把握しやすくしました。
+- `ImagesConvert::Configuration.reset_to_defaults` を新設し、設定ファイルの再生成・キャッシュクリアを一括で行えるようにしました。
+- `README.md` と `CHANGELOG.md` にリセット手順とリリース情報を追記しました。
+- `test/test_config.rb` に `config reset` の回帰テストを追加し、既存の設定関連テスト一式がグリーンになることを確認しました。
+
+## テスト
+- `bundle exec rake test`

data/Rakefile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*.rb'
+  t.verbose = true
+end
+
+# Default task
+task default: :test

data/bin/images-convert

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require_relative '../lib/images_convert'
+
+# 数値短縮フラグ（-1, -5, -0）を正式オプションへ変換し、サブコマンド省略時に convert を補う
+preprocess_argv!(ARGV)
+ImagesConvertCLI.start(ARGV)

data/bin/imgconv

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require_relative '../lib/images_convert'
+
+# 数値短縮フラグ（-1, -5, -0）を正式オプションへ変換し、サブコマンド省略時に convert を補う
+preprocess_argv!(ARGV)
+ImagesConvertCLI.start(ARGV)

data/images-convert.gemspec

@@ -0,0 +1,39 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+# バージョンは単一情報源として lib/images_convert/version.rb から取得
+version_file = File.expand_path('lib/images_convert/version.rb', __dir__)
+version_source = File.read(version_file)
+version = version_source[/VERSION\s*=\s*"([^"]+)"/, 1] || version_source[/VERSION\s*=\s*'([^']+)'/, 1]
+
+Gem::Specification.new do |s|
+  s.name        = "images-convert"
+  s.version     = version
+  s.authors     = ["Atelier Mirai"]
+  s.email       = ["contact@atelier-mirai.net"]
+  s.homepage    = "https://github.com/Atelier-Mirai/images-convert"
+  s.summary     = "A CLI tool for converting image formats using ImageMagick and waifu2x"
+  s.description = "A powerful CLI tool for converting image formats using ImageMagick, with optional waifu2x upscaling when enlarging images. Supports single file conversion, bulk directory conversion, and persistent configuration settings. Convert between various formats (HEIC, JPG, PNG, WebP, etc.)."
+  s.license     = "MIT"
+
+  s.metadata = {
+    "homepage_uri"      => "https://github.com/Atelier-Mirai/images-convert#readme",
+    "source_code_uri"   => "https://github.com/Atelier-Mirai/images-convert",
+    "changelog_uri"     => "https://github.com/Atelier-Mirai/images-convert/blob/master/CHANGELOG.md",
+    "documentation_uri" => "https://github.com/Atelier-Mirai/images-convert#readme"
+  }
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  # 公開する実行ファイルは新名称のみ（後方互換は無し）
+  s.executables   = ['images-convert', 'imgconv']
+  s.require_paths = ["lib"]
+
+  s.add_dependency "thor", "~> 1.0"
+  s.add_dependency "mini_magick", "~> 4.12"
+  s.add_dependency "parallel", "~> 1.22"
+  s.add_dependency "rmagick"
+  s.add_dependency "combine_pdf", "~> 1.0"
+
+  s.required_ruby_version = ">= 3.3.0"
+end

data/lib/images_convert/cleanup.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+
+module ImagesConvert
+  class Cleanup
+    CONFIG_DIR = File.expand_path('~/.images-convert')
+
+    def self.run
+      if Dir.exist?(CONFIG_DIR)
+        puts "設定ファイルとディレクトリを削除しますか？ [Y/n]"
+        print "> "
+        answer = (STDIN.gets || "").strip
+        answer = 'y' if answer.empty?
+
+        if answer.downcase.start_with?('y')
+          begin
+            FileUtils.rm_rf(CONFIG_DIR)
+            puts "設定ファイルとディレクトリを削除しました: #{CONFIG_DIR}"
+          rescue => e
+            puts "削除中にエラーが発生しました: #{e.message}"
+          end
+        else
+          puts "削除をキャンセルしました。設定ファイルは残ります。"
+        end
+      else
+        puts "設定ディレクトリが見つかりません: #{CONFIG_DIR}"
+      end
+    end
+  end
+end