@k2works/claude-code-booster 4.7.0 → 4.9.0

package/lib/assets/docs/article/getting-start-tdd/scala/11-collections-and-lazy-evaluation.md

@@ -1,94 +1,94 @@
-# 第 11 章: コレクション処理と遅延評価
-
-## 11.1 はじめに
-
-Scala の強みの 1 つは、表現力の高いコレクションライブラリです。`List` や `Vector` を使った宣言的な処理により、ループ中心の実装より意図を明確に書けます。
-
-ここで重要なのが評価戦略です。
-
-- 正格評価（eager evaluation）: すぐに計算する
-- 遅延評価（lazy evaluation）: 必要になるまで計算しない
-
-## 11.2 イミュータブルコレクション
-
-Scala の標準コレクションは、デフォルトでイミュータブルを前提に設計されています。
-
-- `List`: 連結リスト。先頭追加や再帰的処理と相性がよい
-- `Vector`: ランダムアクセスに強い
-- `Map`: キーと値の対応
-- `Set`: 重複しない集合
-
-イミュータブルな設計により、副作用を抑えやすくなり、テストしやすいコードになります。
-
-## 11.3 コレクション操作の連鎖
-
-`map`、`flatMap`、`filter`、`foldLeft` を連鎖させると、データ変換の流れを自然に表現できます。
-
-```scala
-val numbers = (1 to 20).toList
-val result = numbers
-  .map(FizzBuzz.generate)
-  .filter(_ != "FizzBuzz")
-  .foldLeft(List.empty[String])((acc, v) => acc :+ v)
-```
-
-for 内包表記も同じ考え方で使えます。
-
-```scala
-val result = for
-  n <- 1 to 100
-  value = FizzBuzz.generate(n)
-  if value != n.toString
-yield value
-```
-
-for 内包表記は、`map`、`flatMap`、`filter` の組み合わせを読みやすく書くための構文糖衣です。
-
-## 11.4 LazyList による遅延評価
-
-FizzBuzz では無限シーケンスを `LazyList` で表現できます。
-
-```scala
-def lazyList: LazyList[String] =
-  LazyList.from(1).map(generate)
-```
-
-`LazyList.from(1)` は 1 から始まる無限列です。`map(generate)` を付けても、実際の計算は要素を取り出すまで実行されません。
-
-```scala
-val firstFive = FizzBuzz.lazyList.take(5).toList
-// List("1", "2", "Fizz", "4", "Buzz")
-```
-
-遅延評価の利点は次のとおりです。
-
-- 必要な分だけ計算するため無駄が少ない
-- 無限リストを安全に表現できる
-- `take`、`drop`、`filter` を組み合わせた逐次処理を書きやすい
-
-## 11.5 テスト
-
-`LazyList` は「必要なときだけ評価される」ことを確認するテストが重要です。
-
-```scala
-test("lazyList: 遅延リストから最初の 5 要素を取得する") {
-  val result = FizzBuzz.lazyList.take(5).toList
-  assert(result === List("1", "2", "Fizz", "4", "Buzz"))
-}
-
-test("lazyList: 遅延リストから 15 番目の要素を取得する") {
-  assert(FizzBuzz.lazyList(14) === "FizzBuzz")
-}
-```
-
-先頭数件だけを取り出すテストと、任意の位置の要素を直接参照するテストを組み合わせると、遅延シーケンスの振る舞いを網羅できます。
-
-## 11.6 まとめ
-
-この章では、Scala のコレクション処理と遅延評価を確認しました。
-
-- イミュータブルコレクションを前提に実装する
-- `map`、`flatMap`、`filter`、`foldLeft` を連鎖して処理を記述する
-- `LazyList` で無限シーケンスと必要時評価を実現する
-
-次章では、`Option` や `Either` を使った型安全なエラーハンドリングを扱います。
+# 第 11 章: コレクション処理と遅延評価
+
+## 11.1 はじめに
+
+Scala の強みの 1 つは、表現力の高いコレクションライブラリです。`List` や `Vector` を使った宣言的な処理により、ループ中心の実装より意図を明確に書けます。
+
+ここで重要なのが評価戦略です。
+
+- 正格評価（eager evaluation）: すぐに計算する
+- 遅延評価（lazy evaluation）: 必要になるまで計算しない
+
+## 11.2 イミュータブルコレクション
+
+Scala の標準コレクションは、デフォルトでイミュータブルを前提に設計されています。
+
+- `List`: 連結リスト。先頭追加や再帰的処理と相性がよい
+- `Vector`: ランダムアクセスに強い
+- `Map`: キーと値の対応
+- `Set`: 重複しない集合
+
+イミュータブルな設計により、副作用を抑えやすくなり、テストしやすいコードになります。
+
+## 11.3 コレクション操作の連鎖
+
+`map`、`flatMap`、`filter`、`foldLeft` を連鎖させると、データ変換の流れを自然に表現できます。
+
+```scala
+val numbers = (1 to 20).toList
+val result = numbers
+  .map(FizzBuzz.generate)
+  .filter(_ != "FizzBuzz")
+  .foldLeft(List.empty[String])((acc, v) => acc :+ v)
+```
+
+for 内包表記も同じ考え方で使えます。
+
+```scala
+val result = for
+  n <- 1 to 100
+  value = FizzBuzz.generate(n)
+  if value != n.toString
+yield value
+```
+
+for 内包表記は、`map`、`flatMap`、`filter` の組み合わせを読みやすく書くための構文糖衣です。
+
+## 11.4 LazyList による遅延評価
+
+FizzBuzz では無限シーケンスを `LazyList` で表現できます。
+
+```scala
+def lazyList: LazyList[String] =
+  LazyList.from(1).map(generate)
+```
+
+`LazyList.from(1)` は 1 から始まる無限列です。`map(generate)` を付けても、実際の計算は要素を取り出すまで実行されません。
+
+```scala
+val firstFive = FizzBuzz.lazyList.take(5).toList
+// List("1", "2", "Fizz", "4", "Buzz")
+```
+
+遅延評価の利点は次のとおりです。
+
+- 必要な分だけ計算するため無駄が少ない
+- 無限リストを安全に表現できる
+- `take`、`drop`、`filter` を組み合わせた逐次処理を書きやすい
+
+## 11.5 テスト
+
+`LazyList` は「必要なときだけ評価される」ことを確認するテストが重要です。
+
+```scala
+test("lazyList: 遅延リストから最初の 5 要素を取得する") {
+  val result = FizzBuzz.lazyList.take(5).toList
+  assert(result === List("1", "2", "Fizz", "4", "Buzz"))
+}
+
+test("lazyList: 遅延リストから 15 番目の要素を取得する") {
+  assert(FizzBuzz.lazyList(14) === "FizzBuzz")
+}
+```
+
+先頭数件だけを取り出すテストと、任意の位置の要素を直接参照するテストを組み合わせると、遅延シーケンスの振る舞いを網羅できます。
+
+## 11.6 まとめ
+
+この章では、Scala のコレクション処理と遅延評価を確認しました。
+
+- イミュータブルコレクションを前提に実装する
+- `map`、`flatMap`、`filter`、`foldLeft` を連鎖して処理を記述する
+- `LazyList` で無限シーケンスと必要時評価を実現する
+
+次章では、`Option` や `Either` を使った型安全なエラーハンドリングを扱います。

package/lib/assets/docs/article/getting-start-tdd/scala/12-error-handling-and-type-safety.md

@@ -1,92 +1,92 @@
-# 第 12 章: エラーハンドリングと型安全性
-
-## 12.1 はじめに
-
-Scala では、例外を多用するよりも型でエラー可能性を表現する設計が推奨されます。コンパイル時に考慮漏れを減らせるためです。
-
-この章では `Option`、`Either`、`Try`、`require` を使い、型安全なエラーハンドリングを整理します。
-
-## 12.2 Option 型
-
-`Option` は「値があるかもしれないし、ないかもしれない」を表現します。
-
-```scala
-def safeGenerate(number: Int): Option[String] =
-  if number > 0 then Some(generate(number))
-  else None
-```
-
-- `Some(value)`: 値あり
-- `None`: 値なし
-
-`Option` は `map`、`flatMap`、`getOrElse` と相性がよく、null チェックを置き換えられます。
-
-```scala
-val message = FizzBuzz.safeGenerate(3)
-  .map(v => s"結果: $v")
-  .getOrElse("入力が不正です")
-```
-
-## 12.3 Either 型
-
-`Either` は成功と失敗のどちらかを保持します。
-
-```scala
-def generateEither(number: Int): Either[String, String] =
-  if number > 0 then Right(generate(number))
-  else Left(s"正の整数が必要です: $number")
-```
-
-- `Right`: 成功値
-- `Left`: エラー情報
-
-`Either` を使うと、エラーを文字列やドメイン型で返せるため、例外より制御しやすくなります。複数処理の連鎖では for 内包表記も利用できます。
-
-```scala
-val result = for
-  a <- FizzBuzz.generateEither(3)
-  b <- FizzBuzz.generateEither(5)
-yield s"$a, $b"
-```
-
-## 12.4 Try 型
-
-`Try` は例外を値として扱う型です。例外が起きうる処理を安全に包めます。
-
-```scala
-import scala.util.Try
-
-val parsed: Try[Int] = Try("42".toInt)
-```
-
-`Try` は `Success` / `Failure` の 2 形です。`map` や `recover` と組み合わせると、例外処理を宣言的に記述できます。
-
-## 12.5 require による事前条件
-
-ドメインモデルの入力検証には `require` が使えます。
-
-```scala
-case class FizzBuzzValue(number: Int, value: String):
-  require(number > 0, s"数値は正の整数でなければなりません: $number")
-```
-
-不正な値でオブジェクトが作られることを防ぎ、ドメイン不変条件をコンストラクタ境界で守れます。
-
-## 12.6 型安全な設計のまとめ
-
-- `Option`: 値の有無を型で表現する
-- `Either`: 成功 / 失敗の分岐を型で表現する
-- `Try`: 例外を値として安全に扱う
-- `require`: 事前条件を明示し、不正状態を早期に排除する
-
-## 12.7 シリーズのまとめ
-
-全 12 章を通して、FizzBuzz を題材に TDD と Scala の設計原則を段階的に学びました。
-
-- TDD の基本サイクル（Red-Green-Refactor）
-- 開発環境の自動化
-- オブジェクト指向設計（ケースクラス、トレイト、パターンマッチ）
-- 関数型プログラミング（高階関数、コレクション、型安全なエラーハンドリング）
-- Scala の OOP と FP の統合
-
-小さな題材でも、設計・テスト・リファクタリングを繰り返すことで、実務で使える設計力を着実に伸ばせます。
+# 第 12 章: エラーハンドリングと型安全性
+
+## 12.1 はじめに
+
+Scala では、例外を多用するよりも型でエラー可能性を表現する設計が推奨されます。コンパイル時に考慮漏れを減らせるためです。
+
+この章では `Option`、`Either`、`Try`、`require` を使い、型安全なエラーハンドリングを整理します。
+
+## 12.2 Option 型
+
+`Option` は「値があるかもしれないし、ないかもしれない」を表現します。
+
+```scala
+def safeGenerate(number: Int): Option[String] =
+  if number > 0 then Some(generate(number))
+  else None
+```
+
+- `Some(value)`: 値あり
+- `None`: 値なし
+
+`Option` は `map`、`flatMap`、`getOrElse` と相性がよく、null チェックを置き換えられます。
+
+```scala
+val message = FizzBuzz.safeGenerate(3)
+  .map(v => s"結果: $v")
+  .getOrElse("入力が不正です")
+```
+
+## 12.3 Either 型
+
+`Either` は成功と失敗のどちらかを保持します。
+
+```scala
+def generateEither(number: Int): Either[String, String] =
+  if number > 0 then Right(generate(number))
+  else Left(s"正の整数が必要です: $number")
+```
+
+- `Right`: 成功値
+- `Left`: エラー情報
+
+`Either` を使うと、エラーを文字列やドメイン型で返せるため、例外より制御しやすくなります。複数処理の連鎖では for 内包表記も利用できます。
+
+```scala
+val result = for
+  a <- FizzBuzz.generateEither(3)
+  b <- FizzBuzz.generateEither(5)
+yield s"$a, $b"
+```
+
+## 12.4 Try 型
+
+`Try` は例外を値として扱う型です。例外が起きうる処理を安全に包めます。
+
+```scala
+import scala.util.Try
+
+val parsed: Try[Int] = Try("42".toInt)
+```
+
+`Try` は `Success` / `Failure` の 2 形です。`map` や `recover` と組み合わせると、例外処理を宣言的に記述できます。
+
+## 12.5 require による事前条件
+
+ドメインモデルの入力検証には `require` が使えます。
+
+```scala
+case class FizzBuzzValue(number: Int, value: String):
+  require(number > 0, s"数値は正の整数でなければなりません: $number")
+```
+
+不正な値でオブジェクトが作られることを防ぎ、ドメイン不変条件をコンストラクタ境界で守れます。
+
+## 12.6 型安全な設計のまとめ
+
+- `Option`: 値の有無を型で表現する
+- `Either`: 成功 / 失敗の分岐を型で表現する
+- `Try`: 例外を値として安全に扱う
+- `require`: 事前条件を明示し、不正状態を早期に排除する
+
+## 12.7 シリーズのまとめ
+
+全 12 章を通して、FizzBuzz を題材に TDD と Scala の設計原則を段階的に学びました。
+
+- TDD の基本サイクル（Red-Green-Refactor）
+- 開発環境の自動化
+- オブジェクト指向設計（ケースクラス、トレイト、パターンマッチ）
+- 関数型プログラミング（高階関数、コレクション、型安全なエラーハンドリング）
+- Scala の OOP と FP の統合
+
+小さな題材でも、設計・テスト・リファクタリングを繰り返すことで、実務で使える設計力を着実に伸ばせます。

package/lib/assets/docs/article/getting-start-tdd/scala/index.md

@@ -1,65 +1,65 @@
-# テスト駆動開発から始める Scala 入門
-
-## 概要
-
-本シリーズでは、テスト駆動開発（TDD）の実践を通じて Scala の特徴を学びます。FizzBuzz 問題を題材に、Red-Green-Refactor サイクルを体験しながら、Scala のオブジェクト指向と関数型プログラミングの両方を段階的に習得します。
-
-## 対象読者
-
-- プログラミングの基礎知識を持つ方
-- TDD に興味がある方
-- Scala や JVM 上の関数型プログラミングに興味がある方
-
-## 前提条件
-
-- Scala 3.x、sbt がインストールされていること
-- テキストエディタまたは IDE が利用可能であること
-- Git の基本操作ができること
-
-## Scala の特徴
-
-| 特徴 | 説明 |
-|------|------|
-| OOP と FP の統合 | オブジェクト指向と関数型プログラミングを自然に組み合わせ可能 |
-| 型推論 | 強力な型推論により型アノテーションを最小限に抑制 |
-| ケースクラス | 不変の値オブジェクトを簡潔に定義 |
-| パターンマッチ | 網羅的で型安全な分岐処理 |
-| トレイト | 柔軟なミックスインによるコード再利用 |
-| コレクションライブラリ | 統一的な API による豊富なコレクション操作 |
-| JVM 互換 | Java エコシステムとの完全な相互運用性 |
-
-## 開発ツール
-
-| ツール | 用途 |
-|--------|------|
-| sbt | ビルドツール・パッケージマネージャ |
-| ScalaTest | テスティングフレームワーク |
-| scalafmt | コードフォーマッタ |
-| WartRemover | 静的解析（コード品質チェック） |
-| Metals | Language Server Protocol 実装 |
-
-## 目次
-
-### 第 1 部: TDD の基本サイクル
-
-1. [第 1 章: TODO リストと最初のテスト](./01-todo-list-and-first-test.md)
-2. [第 2 章: 仮実装と三角測量](./02-fake-it-and-triangulation.md)
-3. [第 3 章: 明白な実装とリファクタリング](./03-obvious-implementation-and-refactoring.md)
-
-### 第 2 部: 開発環境と自動化
-
-4. [第 4 章: バージョン管理と Conventional Commits](./04-version-control-and-conventional-commits.md)
-5. [第 5 章: パッケージ管理と静的解析](./05-package-management-and-static-analysis.md)
-6. [第 6 章: タスクランナーと CI/CD](./06-task-runner-and-ci-cd.md)
-
-### 第 3 部: オブジェクト指向設計
-
-7. [第 7 章: ケースクラスとトレイトによるポリモーフィズム](./07-case-classes-and-traits.md)
-8. [第 8 章: パターンマッチとシールドトレイト](./08-pattern-matching-and-sealed-traits.md)
-9. [第 9 章: パッケージとモジュール設計](./09-packages-and-module-design.md)
-
-### 第 4 部: 関数型プログラミング
-
-10. [第 10 章: 高階関数と関数合成](./10-higher-order-functions-and-composition.md)
-11. [第 11 章: コレクション処理と遅延評価](./11-collections-and-lazy-evaluation.md)
-12. [第 12 章: エラーハンドリングと型安全性](./12-error-handling-and-type-safety.md)
+# テスト駆動開発から始める Scala 入門
+
+## 概要
+
+本シリーズでは、テスト駆動開発（TDD）の実践を通じて Scala の特徴を学びます。FizzBuzz 問題を題材に、Red-Green-Refactor サイクルを体験しながら、Scala のオブジェクト指向と関数型プログラミングの両方を段階的に習得します。
+
+## 対象読者
+
+- プログラミングの基礎知識を持つ方
+- TDD に興味がある方
+- Scala や JVM 上の関数型プログラミングに興味がある方
+
+## 前提条件
+
+- Scala 3.x、sbt がインストールされていること
+- テキストエディタまたは IDE が利用可能であること
+- Git の基本操作ができること
+
+## Scala の特徴
+
+| 特徴 | 説明 |
+|------|------|
+| OOP と FP の統合 | オブジェクト指向と関数型プログラミングを自然に組み合わせ可能 |
+| 型推論 | 強力な型推論により型アノテーションを最小限に抑制 |
+| ケースクラス | 不変の値オブジェクトを簡潔に定義 |
+| パターンマッチ | 網羅的で型安全な分岐処理 |
+| トレイト | 柔軟なミックスインによるコード再利用 |
+| コレクションライブラリ | 統一的な API による豊富なコレクション操作 |
+| JVM 互換 | Java エコシステムとの完全な相互運用性 |
+
+## 開発ツール
+
+| ツール | 用途 |
+|--------|------|
+| sbt | ビルドツール・パッケージマネージャ |
+| ScalaTest | テスティングフレームワーク |
+| scalafmt | コードフォーマッタ |
+| WartRemover | 静的解析（コード品質チェック） |
+| Metals | Language Server Protocol 実装 |
+
+## 目次
+
+### 第 1 部: TDD の基本サイクル
+
+1. [第 1 章: TODO リストと最初のテスト](./01-todo-list-and-first-test.md)
+2. [第 2 章: 仮実装と三角測量](./02-fake-it-and-triangulation.md)
+3. [第 3 章: 明白な実装とリファクタリング](./03-obvious-implementation-and-refactoring.md)
+
+### 第 2 部: 開発環境と自動化
+
+4. [第 4 章: バージョン管理と Conventional Commits](./04-version-control-and-conventional-commits.md)
+5. [第 5 章: パッケージ管理と静的解析](./05-package-management-and-static-analysis.md)
+6. [第 6 章: タスクランナーと CI/CD](./06-task-runner-and-ci-cd.md)
+
+### 第 3 部: オブジェクト指向設計
+
+7. [第 7 章: ケースクラスとトレイトによるポリモーフィズム](./07-case-classes-and-traits.md)
+8. [第 8 章: パターンマッチとシールドトレイト](./08-pattern-matching-and-sealed-traits.md)
+9. [第 9 章: パッケージとモジュール設計](./09-packages-and-module-design.md)
+
+### 第 4 部: 関数型プログラミング
+
+10. [第 10 章: 高階関数と関数合成](./10-higher-order-functions-and-composition.md)
+11. [第 11 章: コレクション処理と遅延評価](./11-collections-and-lazy-evaluation.md)
+12. [第 12 章: エラーハンドリングと型安全性](./12-error-handling-and-type-safety.md)