vivlio-starter-pdf 1.1.1 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f467238756b956810a17babdb5808c1d1ee08596fb4cf5a2d4437ee19ac1bdd9
-  data.tar.gz: cc1b31492ec07fdb0aa2fce8bdfe5d84c9e9ffe89584c3c54c39c437233e1d5b
+  metadata.gz: 0335b9ec25ee9a373f9d4c261c1a4a610e87fb2ac538b2207b3dd8f741bc82c1
+  data.tar.gz: 9645fdbcb4575cae982bf48ef0c60f061b6f26afbbe101bd4530f95262c6da32
 SHA512:
-  metadata.gz: 8593d07317b5ec3eefd0b002441e77884eca92ef38271ea91f2ad19b5f33404f7fd750c60641112a274b35a2eb2bd6d183a10cac97e6630afa8bce38d81b7e68
-  data.tar.gz: 9cd7704acb4d156e639d68989b5229aa8ef497f89a3fc1ea28e04b4ce3a9a1ca7580cd0e0d263c7658b656da4e0a1eb08537534c9e3ec1b294fff9bd9dd29236
+  metadata.gz: 01f2c370439f11cf3012f32b092415a8aeebab059386f09462292952e7026b8b616db82e00aae11489465d562c0f90f89ea548f6df98d89523e05c7b0f1e8a00
+  data.tar.gz: 215ff34974f8bc3f2fd81f929bd39413ff79ad454db5993ee36c350dd48af12b091372b9b1ca42c6b048e29d5633e88b29bfb5dca3aebcaa8726d4d594773f4e

data/.ruby-version

@@ -0,0 +1 @@
+4.0.6

data/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+### Planned
+- パフォーマンス最適化（大規模 PDF 対応）
+- 追加 OCR エンジン対応
+- クラウド OCR サービス連携
+- PDF 暗号化対応
+
+## [1.1.2] - 2026-08-07
+
+### Changed
+- **必要な Ruby を 4.0 以上から 3.4 以上へ緩めた** (`vivlio-starter-pdf.gemspec`): Ruby 4.0 固有の機能は使っていない。Prism のバージョン指定パースで全 13 ファイルを解析したところ 4.0.0 / 3.4.0 / 3.3.0 いずれも構文エラー 0 件で、実際の下限を決めていたのは `it`（暗黙ブロック引数・38 箇所）**単独**だった。`it` は 3.3 でも構文エラーにならず実行時 `NameError` になる——静的解析では見つからないので、Ruby 3.4.10 で実走して全テスト通過を確認している。コード変更はゼロ（gemspec 1 行のみ）。本体 `vivlio-starter` の緩和に合わせたもので、本体だけ緩めてもプラグインが `>= 4.0` のままでは 3.4 環境に入らない。
+
+### Fixed
+- **壊れたアウトライン項目 1 件が、しおりを全滅させていたのを直した** (`outline_writer.rb`): 見出しのタイトルに不正な UTF-8 バイトが混ざると `String#strip` が `Encoding::CompatibilityError` を投げ、`add_outline!` の rescue まで飛んで **PDF からしおりが丸ごと消えていた**。範囲外ページ・空タイトル・深すぎる階層はいずれも `on_skip` で 1 件ずつ飛ばす設計なのに、ここだけ全体を巻き添えにしていた。
+  - `add_outline!` は `false` を返すだけで PDF 自体は出来上がるため、**成果物を開くまで誰も気付けない**種類の失敗だった。
+  - 該当項目だけを飛ばし、理由（`title is not valid UTF-8, skipping outline entry: …`）を `on_skip` で報告する。原稿のどの見出しを直せばよいか分かる形にした。
+  - `EncodingError` と `ArgumentError` の両方を捕まえる。壊れたバイト列に Ruby がどちらを投げるかはメソッド次第で（`strip` は `Encoding::CompatibilityError`、`match?` は `ArgumentError`）、その差でしおりの有無が決まってはならない。
+- **アウトライン項目に `nil` 以外の想定外の型が混ざると全体が止まっていたのを直した** (`outline_writer.rb`): `fetch` が `respond_to?(:[])` だけで添字アクセスしていたため、配列に `String` や `Integer` が紛れると `TypeError: no implicit conversion of Symbol into Integer`（`Integer#[]` はビット参照）で落ちていた。Hash 風オブジェクトは従来どおり受けつつ、添字アクセスの失敗は既定値へ倒す。
+
+### Added
+- **堅牢性テストを整備した** (`test/robustness/`): 本体 `vivlio-starter` の `test/vivlio_starter/robustness/` と同じ位置づけで 14 件を追加。守る約束は 2 つ——**公開 API は例外を外へ出さない**（ビルドパイプラインの途中から呼ばれるため、失敗は戻り値で伝える）、**失敗しても入力を壊さない**（読み込んだのと同じパスへ書き戻すため、途中失敗で元 PDF が切り詰められると最も気付きにくい事故になる）。上記 2 件の修正はこのテストを書く過程で見つかったもの。
+  - `broken_pdf_test.rb` — PDF でないファイル・0 バイト・存在しないパス・暗号化 PDF・書き込み不可ファイル。戻り値と、**入力のバイト列が不変であること**を固定
+  - `outline_entry_test.rb` — 壊れた項目を 1 件ずつ飛ばして残りを書くこと、飛ばした理由を報告すること、全滅時に空のしおりツリーを残さないこと
+
 ## [1.1.1] - 2026-06-23
 
 ### Fixed
@@ -69,13 +92,3 @@ vivlio-starter-pdf 1.0.0 としてリリース！HexaPDF を活用した高度
 - 日本語テキストの空白圧縮処理
 - 括弧の正規化と誤読修正
 - 出版向けの文字処理最適化
-
----
-
-## [Unreleased]
-
-### Planned
-- パフォーマンス最適化（大規模 PDF 対応）
-- 追加 OCR エンジン対応
-- クラウド OCR サービス連携
-- PDF 暗号化対応

data/README.md

@@ -1,7 +1,7 @@
 # vivlio-starter-pdf
 
 [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
-[![Ruby](https://img.shields.io/badge/Ruby-%3E%3D%204.0-red.svg)](https://www.ruby-lang.org/)
+[![Ruby](https://img.shields.io/badge/Ruby-%3E%3D%203.4-red.svg)](https://www.ruby-lang.org/)
 
 **vivlio-starter** の AGPL 拡張プラグイン。HexaPDF を活用した高度な PDF 解析・後処理機能を提供します。
 
@@ -46,24 +46,34 @@ brew install tesseract tesseract-lang poppler vips
 vs pdf:read document.pdf
 ```
 
+標準（MIT）実装に戻して動作を比べたいときは、環境変数で無効化できます。
+
+```zsh
+VIVLIO_PDF_PLUGIN=disable vs build
+```
+
 ### Ruby API
 
 ```ruby
-require "vivlio/starter/pdf"
+require "vivlio_starter/pdf"
 
 # PDF → Markdown 変換
-result = Vivlio::Starter::PDF::Reader.new("input.pdf",
+result = VivlioStarter::Pdf::Reader.new("input.pdf",
   ocr: { mode: "auto", languages: ["jpn"], dpi: 300 }
 ).execute
 
 # アウトライン付与
-provider = Vivlio::Starter::Pdf::EnhancedProvider.new
+provider = VivlioStarter::Pdf::EnhancedProvider.new
 provider.add_outline!(pdf_path, items, max_level: 3)
 
 # 隠しノンブル
 provider.stamp_nombre!(pdf_path, bleed_pt: 8.5)
 ```
 
+`stamp_nombre!` / `add_outline!` は成功で `true`、失敗で `false` を返し、`page_count` は失敗で `nil` を返します。**例外は外へ出しません**（本体のビルドパイプラインの途中から呼ばれるため）。失敗しても入力 PDF は書き換えません。
+
+`add_outline!` の `items` は `{ level:, text:, page: }` の配列です。壊れた項目（不正な UTF-8 のタイトル・範囲外ページ・空タイトル）は 1 件ずつ飛ばして残りを書き込み、飛ばした理由をログに出します。
+
 ## 設定
 
 `config/book.yml` の `pdf_read` セクションで挙動を制御できます。

data/RELEASE_NOTE.md

@@ -1,133 +1,55 @@
-# vivlio-starter-pdf 1.0.0 Release Note
+# vivlio-starter-pdf リリースノート
 
-## 🎉 最初のメジャーリリース
+書籍制作ツール **vivlio-starter** の AGPL 拡張プラグインです。HexaPDF を使い、隠しノンブル・PDF アウトライン・PDF → Markdown 変換（OCR 連携）を担当します。使い方は [README](README.md)、網羅的な変更履歴は [CHANGELOG](CHANGELOG.md) をご覧ください。
 
-vivlio-starter-pdf 1.0.0 をリリースできることを大変嬉しく思います。これは **vivlio-starter** の AGPL 拡張プラグインで、HexaPDF を活用した高度な PDF 解析・後処理機能を提供します。
+新しい版から順に並べています。
 
-## 🚀 主要機能
-
-### PDF → Markdown 変換
-- HexaPDF でテキスト・画像を高精度に抽出
-- 精密な座標解析による行・段落の再構成
-- Markdown 形式での構造化出力
-
-### OCR 連携と日本語対応 🆕
-- スキャン PDF を自動検出
-- Tesseract による日本語 OCR 実行
-- OCR テキストの空白圧縮と括弧正規化
-- prh 辞書による誤読修正
-
-### 画像抽出と位置合わせ
-- PDF 内の XObject を解析し、WebP 形式で書き出し
-- テキスト行と画像の精密な座標マッピング
-- イラスト領域の自動検出と除外
-
-### 出版向け機能
-- **隠しノンブル**: 入稿用 PDF の塗り足し領域にページ番号をオーバーレイ
-- **PDF アウトライン**: HTML 見出しを解析し、PDF のブックマークツリーを構築
-
-## 📦 インストール
-
-```ruby
-# Gemfile
-gem 'vivlio-starter-pdf', '~> 1.0.0'
-```
-
-```bash
-bundle install
-```
-
-### 外部ツール（OCR 利用時）
-
-```bash
-brew install tesseract tesseract-lang poppler vips
-```
-
-## 💡 使用例
-
-### vivlio-starter との連携（プラグイン専用）
-
-```bash
-# Enhanced Mode で自動的に HexaPDF/OCR パイプラインを使用
-vs pdf:read document.pdf
-```
-
-### Ruby API
-
-```ruby
-require "vivlio/starter/pdf"
-
-# PDF → Markdown 変換
-result = Vivlio::Starter::PDF::Reader.new("input.pdf",
-  ocr: { mode: "auto", languages: ["jpn"], dpi: 300 }
-).execute
+---
 
-# アウトライン付与
-provider = Vivlio::Starter::Pdf::EnhancedProvider.new
-provider.add_outline!(pdf_path, items, max_level: 3)
+## 1.1.2 — 2026-08-07
 
-# 隠しノンブル
-provider.stamp_nombre!(pdf_path, bleed_pt: 8.5)
-```
+**細かな不具合修正が中心のリリースです。** ただし 1 件は成果物に直接影響するため、しおり付き PDF を作る方は更新をおすすめします。
 
-## 🔧 設定
+- **壊れた見出しが 1 つあると、しおりが丸ごと消えていた問題を直しました。** 見出しに不正な UTF-8 バイトが混ざると例外が最上位まで飛び、**PDF からしおりが全滅**していました。範囲外ページや空タイトルは 1 件ずつ飛ばす設計だったのに、ここだけ全体を巻き添えにしていたことになります。しかも PDF 自体は出来上がるため、**開いてみるまで誰も気付けません**。今は該当項目だけを飛ばし、どの見出しが原因かをログで知らせます
+- **想定外の型が項目に混ざると、アウトライン付与が止まっていた問題を直しました**（`TypeError`）
+- **必要な Ruby を 4.0 以上から 3.4 以上へ緩めました**（コード変更はゼロ、gemspec 1 行のみ）。本体の緩和に合わせたものです。本体だけ緩めても、プラグインが 4.0 以上のままでは 3.4 環境に入りません
 
-`config/book.yml` の `pdf_read` セクションで挙動を制御：
+あわせて、これらを二度と起こさないための**堅牢性テスト 14 件**を `test/robustness/` に追加しました。守る約束は 2 つです。
 
-```yaml
-pdf_read:
-  text_area:
-    top_margin: 18
-    bottom_margin: 20
-    inner_margin: 15
-    outer_margin: 12
-  page_separator: false
-  ocr:
-    mode: auto
-    languages:
-      - japanese
-    dpi: 300
-    psm: 3
-    inline_image_text: include
-```
+1. **公開 API は例外を外へ出さない。** 本体のビルドパイプラインの途中から呼ばれるため、1 つの PDF 操作が例外で飛ぶとビルド全体が落ちます。失敗は戻り値で伝えます
+2. **失敗しても入力を壊さない。** 読み込んだのと同じパスへ書き戻すので、途中で失敗して元 PDF が切り詰められると「ビルドは続いたのに成果物が壊れている」という最も気付きにくい事故になります
 
-## ✅ テスト品質
+上の 2 件は、このテストを書く過程で見つかりました。
 
-- **網羅的なテストスイート**
-- **実環境での動作検証**
-- **外部ツール連携のテスト**
+## 1.1.1 — 2026-06-23
 
-## 🔄 0.1.0 からの変更点
+- **隠しノンブルを埋め込み可能なフォントで描画するようにしました（FT-02）。** HexaPDF 組込の標準 14 フォント `Helvetica` は PDF に埋め込まれず、印刷所入稿で「非埋め込みフォント」の差し戻しになっていました
+- 書籍プロジェクト直下に同梱の `stylesheets/fonts/hackgen35/HackGen35ConsoleNF-Regular.ttf` があれば、数字グリフのみをサブセット埋め込みします（増分は極小）。無ければ従来どおり `Helvetica` にフォールバックしてビルドを続けます
 
-### 新機能
-- 完全な OCR 連携と日本語対応
-- 画像位置合わせの精密化
-- PDF アウトライン生成機能
-- 隠しノンブル機能
+## 1.1.0 — 2026-06-10
 
-### 改善
-- gemspec の RubyGems 公開設定
-- ドキュメントの整備
-- 外部ツールの自動案内
+- **名前空間を `VivlioStarter::Pdf` へ統一し、`lib/vivlio_starter/` 配下へ再編しました。** 1.0.0 以降で**唯一の非互換変更**です
 
-## 🎯 実績
+本体（`vs`）経由で使っている場合、影響はありません。**Ruby API を直接呼んでいる場合のみ**書き換えが必要です。
 
-- **vivlio-starter** Enhanced Mode で実稼働
-- **日本語出版** 向けの最適化完了
-- **HexaPDF** との高度な連携実現
-- **AGPL-3.0** ライセンス準拠
+| | 1.0.x | 1.1.0 以降 |
+|:---|:---|:---|
+| require | `require "vivlio/starter/pdf"` | `require "vivlio_starter/pdf"` |
+| 名前空間 | `Vivlio::Starter::PDF` と `Vivlio::Starter::Pdf` が混在 | `VivlioStarter::Pdf` に統一 |
 
-## 📋 互換性
+1.0.x では `PDF` と `Pdf` の 2 つの綴りが同居しており、どちらを書けばよいか実物を見ないと分からない状態でした。
 
-- **Ruby**: 4.0+
-- **依存**: hexapdf (~> 1.0), ruby-vips (~> 2.2)
-- **外部ツール**: Tesseract, poppler, libvips（OCR 使用時）
-- **セマンティックバージョニング**: 1.x.x 系は後方互換性を保証
+## 1.0.1 — 2026-03-21
 
-## 🙏 感謝
+- **CLI を追加しました**（`vivlio-starter-pdf --version` / `--help`）。インストール直後に動作確認できます
 
-vivlio-starter-pdf の開発にあたり、HexaPDF の強力な PDF 処理能力と、日本語出版の現場でのニーズが大きな助けとなりました。特に OCR 連携と日本語テキスト処理についての知見は、本プラグインをより実用的なものにする上で不可欠でした。
+## 1.0.0 — 2026-03-21
 
----
+最初のメジャーリリースです。
 
-**vivlio-starter-pdf 1.0.0**: 高度な PDF 処理のための強力な拡張プラグイン
+- **隠しノンブル** — 入稿用 PDF の塗り足し領域に、断裁されて消えるページ番号を刷り込みます
+- **PDF アウトライン** — 見出しから PDF のブックマークツリーを構築します
+- **PDF → Markdown 変換** — HexaPDF でテキスト・画像を座標付きで抽出します
+- **OCR 連携** — スキャン PDF を自動検出し、Tesseract で日本語 OCR を実行。空白圧縮・括弧正規化・prh 辞書による誤読修正まで行います
+- **画像抽出** — PDF 内の XObject を解析し、WebP 形式で書き出します
+- プラグイン専用設計。インストールされていれば本体が自動検出し、Standard Mode から Enhanced Mode へ切り替わります

data/Rakefile

@@ -3,12 +3,59 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
 
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+# gemspec が Ruby 3.4 以上を謳う以上、それが本当かは実際に走らせないと分からない。
+# `it`（暗黙ブロック引数）は 3.3 以下でも構文エラーにならず「it というメソッドの
+# 呼び出し」として通り、実行時に NameError になる——静的解析では捕まらない。
+SUPPORTED_RUBY_VERSIONS = %w[3.4.10 4.0.6].freeze
+
+# 別の Ruby を子プロセスで起動する以上、親の bundler 環境は必ず捨てる。
+# `bundle exec rake test` から呼ばれると、親（現在の Ruby）の bundler を
+# 子（別の Ruby）が読みに行き、テストが始まる前に LoadError で落ちる。
+# nil を渡すと、その環境変数は子から取り除かれる。
+UNBUNDLED_ENV = {
+  "RUBYOPT" => nil, "RUBYLIB" => nil, "GEM_HOME" => nil, "GEM_PATH" => nil,
+  "BUNDLE_GEMFILE" => nil, "BUNDLE_BIN_PATH" => nil, "BUNDLER_VERSION" => nil,
+  "BUNDLER_SETUP" => nil
+}.freeze
+
+namespace :test do
+  # テストの実体。現在の Ruby で 1 回だけ走る（test:versions が各版でこれを呼ぶ）
+  Rake::TestTask.new(:current) do |t|
+    t.libs << "test"
+    t.libs << "lib"
+    t.test_files = FileList["test/**/*_test.rb"]
+  end
+
+  desc "対応する全 Ruby 版（#{SUPPORTED_RUBY_VERSIONS.join(' / ')}）でテストする"
+  task :versions do
+    missing = SUPPORTED_RUBY_VERSIONS - `rbenv versions --bare`.split("\n")
+    unless missing.empty?
+      abort <<~MESSAGE
+        次の Ruby が rbenv に入っていません: #{missing.join(', ')}
+          #{missing.map { "rbenv install #{it}" }.join("\n  ")}
+      MESSAGE
+    end
+
+    # 版ごとに bundle が要る。未導入なら黙って入れる（その版の初回だけ時間がかかる）
+    failed = SUPPORTED_RUBY_VERSIONS.reject do |version|
+      puts "\n=== Ruby #{version} ==="
+      env = UNBUNDLED_ENV.merge("RBENV_VERSION" => version)
+
+      unless system(env, "rbenv exec bundle check", out: File::NULL, err: File::NULL)
+        next false unless system(env, "rbenv exec bundle install --quiet")
+      end
+
+      system(env, "rbenv exec bundle exec rake test:current")
+    end
+
+    abort "\n失敗した Ruby: #{failed.join(', ')}" unless failed.empty?
+    puts "\n全 Ruby 版で通過: #{SUPPORTED_RUBY_VERSIONS.join(' / ')}"
+  end
 end
 
+# 手元では常に対応全版を回す（1 版あたり 10 秒弱で終わるため、分けるほどの負担にならない）。
+# CI（GitHub Actions）は版をマトリクスで分担するので、各ジョブは 1 回でよい。
+task test: (ENV["CI"] ? "test:current" : "test:versions")
 task default: :test
 
 # gem のアンインストール → ビルド → インストールを一括実行
@@ -16,7 +63,7 @@ task :reinstall do
   gemspec = Dir['*.gemspec'].first
   raise 'gemspec が見つかりません' unless gemspec
 
-  require_relative 'lib/vivlio_starter/pdf/version'
+  require_relative 'lib/vivlio_starter/cli/pdf/version'
   version = VivlioStarter::Pdf::VERSION
   gem_name = 'vivlio-starter-pdf'
   gem_file = "#{gem_name}-#{version}.gem"

data/lib/vivlio_starter/cli/pdf/outline_writer.rb

@@ -54,7 +54,9 @@ module VivlioStarter
 
       # Normalizes a raw hash into a consistent entry structure.
       def normalize_entry(raw)
-        text = fetch(raw, :text, fetch(raw, :title, nil)).to_s.strip
+        text = entry_title(raw)
+        return nil if text.nil?
+
         warn_skip("missing title for outline entry: #{raw.inspect}") if text.empty?
         return nil if text.empty?
 
@@ -71,13 +73,40 @@ module VivlioStarter
         { text:, page:, level: }
       end
 
+      # Returns the trimmed title, or +nil+ when the entry must be skipped.
+      #
+      # A title carrying invalid UTF-8 bytes makes +String#strip+ raise
+      # +Encoding::CompatibilityError: invalid byte sequence in UTF-8+. Letting that
+      # escape costs the *entire* outline: +add_outline!+ rescues at the top, so one
+      # mojibake heading would leave the book with no bookmarks at all. Every other
+      # kind of bad entry is skipped one by one through +on_skip+ — this one must
+      # behave the same way, and the message has to name the entry so the author can
+      # fix the manuscript heading that produced it.
+      #
+      # Both +EncodingError+ and +ArgumentError+ are caught on purpose: which one
+      # Ruby raises for broken bytes depends on the method (+strip+ raises
+      # +Encoding::CompatibilityError+, +match?+ raises +ArgumentError+), and that
+      # detail must not decide whether the book keeps its bookmarks.
+      def entry_title(raw)
+        fetch(raw, :text, fetch(raw, :title, nil)).to_s.strip
+      rescue EncodingError, ArgumentError
+        # +inspect+ is safe here: it escapes invalid bytes (\xFF) instead of raising.
+        warn_skip("title is not valid UTF-8, skipping outline entry: #{raw.inspect}")
+        nil
+      end
+
       # Fetches a value from the entry by symbol or string key.
+      #
+      # Entries come from the caller, so a stray String or Integer can end up in the
+      # array. Both answer +respond_to?(:[])+ but raise +TypeError+ when indexed with
+      # a Symbol (+Integer#[]+ is bit access), which would abort the whole outline —
+      # exactly what the per-entry skip exists to prevent. Duck typing is kept so a
+      # Hash-like object still works; only the indexing failure falls back.
       def fetch(raw, key, fallback)
-        if raw.respond_to?(:[]) && (raw[key] || raw[key.to_s])
-          raw[key] || raw[key.to_s]
-        else
-          fallback
-        end
+        value = (raw[key] || raw[key.to_s] if raw.respond_to?(:[]))
+        value.nil? ? fallback : value
+      rescue TypeError
+        fallback
       end
 
       # Returns the proper parent node for the requested level.

data/lib/vivlio_starter/cli/pdf/version.rb

@@ -2,6 +2,6 @@
 
 module VivlioStarter
   module Pdf
-    VERSION = "1.1.1"
+    VERSION = "1.1.2"
   end
 end

data/vivlio-starter-pdf.gemspec

@@ -5,18 +5,20 @@ require_relative "lib/vivlio_starter/cli/pdf/version"
 Gem::Specification.new do |spec|
   spec.name = "vivlio-starter-pdf"
   spec.version = VivlioStarter::Pdf::VERSION
-  spec.authors = ["Mirai"]
-  spec.email = ["mirai@example.com"]
+  spec.authors = ["Atelier Mirai"]
+  spec.email = ["contact@atelier-mirai.net"]
 
   spec.summary = "Advanced PDF processor for vivlio-starter using HexaPDF"
   spec.description = "Provides PDF outline extraction, precision page numbering, and OCR via HexaPDF. AGPL-3.0 licensed."
   spec.homepage = "https://github.com/Atelier-Mirai/vivlio-starter-pdf"
   spec.license = "AGPL-3.0-only"
-  spec.required_ruby_version = ">= 4.0.0"
+  spec.required_ruby_version = ">= 3.4.0"
 
+  # homepage_uri は spec.homepage から自動で作られる。metadata にも同じ URL を書くと
+  # rubygems.org はどちらか片方しか表示せず、gem build が警告を出す
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/Atelier-Mirai/vivlio-starter-pdf"
+  spec.metadata["changelog_uri"] = "https://github.com/Atelier-Mirai/vivlio-starter-pdf/blob/master/CHANGELOG.md"
   spec.post_install_message = <<~MESSAGE
     [vivlio-starter-pdf]
     Enhanced Mode の OCR には外部ツール（tesseract / tesseract-lang / poppler / vips）が必要です。

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: vivlio-starter-pdf
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors:
-- Mirai
+- Atelier Mirai
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -82,12 +82,13 @@ dependencies:
 description: Provides PDF outline extraction, precision page numbering, and OCR via
   HexaPDF. AGPL-3.0 licensed.
 email:
-- mirai@example.com
+- contact@atelier-mirai.net
 executables:
 - vivlio-starter-pdf
 extensions: []
 extra_rdoc_files: []
 files:
+- ".ruby-version"
 - CHANGELOG.md
 - LICENSE
 - README.md
@@ -107,8 +108,8 @@ licenses:
 - AGPL-3.0-only
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/Atelier-Mirai/vivlio-starter-pdf
   source_code_uri: https://github.com/Atelier-Mirai/vivlio-starter-pdf
+  changelog_uri: https://github.com/Atelier-Mirai/vivlio-starter-pdf/blob/master/CHANGELOG.md
 post_install_message: |
   [vivlio-starter-pdf]
   Enhanced Mode の OCR には外部ツール（tesseract / tesseract-lang / poppler / vips）が必要です。
@@ -124,14 +125,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 4.0.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.14
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Advanced PDF processor for vivlio-starter using HexaPDF
 test_files: []