@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/grokkingfp/index.md

@@ -0,0 +1,143 @@
+# Grokking Functional Programming
+
+「Grokking Functional Programming」（Michal Plachta 著）の学習用リポジトリです。
+Scala、Java、F#、C#、Haskell、Clojure、Elixir、Rust、Python、TypeScript、Ruby の11言語で関数型プログラミングの実装例と日本語解説を提供します。
+
+## 11言語統合比較
+
+全 11 言語を横断的に比較する統合記事シリーズです。各章ごとに言語間の共通点と相違点を分析しています。
+
+- [統合記事 目次](all/index.md)
+
+| Part | 章 | タイトル | 統合記事 |
+|------|-----|---------|---------|
+| I | 01 | 関数型プログラミング入門 | [11言語比較](all/part-1-ch01-fp-introduction.md) |
+| I | 02 | 純粋関数と副作用 | [11言語比較](all/part-1-ch02-pure-functions.md) |
+| II | 03 | イミュータブルなデータ操作 | [11言語比較](all/part-2-ch03-immutable-data.md) |
+| II | 04 | 高階関数 | [11言語比較](all/part-2-ch04-higher-order-functions.md) |
+| II | 05 | flatMap とモナド的合成 | [11言語比較](all/part-2-ch05-flatmap.md) |
+| III | 06 | Option 型 | [11言語比較](all/part-3-ch06-option.md) |
+| III | 07 | Either 型と ADT | [11言語比較](all/part-3-ch07-either-adt.md) |
+| IV | 08 | IO モナドと副作用の分離 | [11言語比較](all/part-4-ch08-io-monad.md) |
+| IV | 09 | ストリーム処理 | [11言語比較](all/part-4-ch09-streams.md) |
+| V | 10 | 並行・並列処理 | [11言語比較](all/part-5-ch10-concurrency.md) |
+| VI | 11 | 実践アプリケーション | [11言語比較](all/part-6-ch11-application.md) |
+| VI | 12 | テスト戦略 | [11言語比較](all/part-6-ch12-testing.md) |
+
+## 言語別解説
+
+### Scala 版
+
+Scala 3 と cats-effect/fs2 を使った関数型プログラミングの実装例です。
+
+- [Scala 解説](scala/index.md)
+
+### Java 版
+
+Java 21 と Vavr を使った関数型プログラミングの実装例です。
+
+- [Java 解説](java/index.md)
+
+### F# 版
+
+F# 8 と .NET を使った関数型プログラミングの実装例です。
+
+- [F# 解説](fsharp/index.md)
+
+### C# 版
+
+C# 12 と LanguageExt を使った関数型プログラミングの実装例です。
+
+- [C# 解説](csharp/index.md)
+
+### Haskell 版
+
+Haskell（GHC 9.x）を使った純粋関数型プログラミングの実装例です。
+
+- [Haskell 解説](haskell/index.md)
+
+### Clojure 版
+
+Clojure 1.11 と core.async を使った関数型プログラミングの実装例です。
+
+- [Clojure 解説](clojure/index.md)
+
+### Elixir 版
+
+Elixir 1.15 と OTP を使った関数型プログラミングの実装例です。
+
+- [Elixir 解説](elixir/index.md)
+
+### Rust 版
+
+Rust と tokio を使った関数型プログラミングの実装例です。
+
+- [Rust 解説](rust/index.md)
+
+### Python 版
+
+Python 3.11+ と returns ライブラリを使った関数型プログラミングの実装例です。
+
+- [Python 解説](python/index.md)
+
+### TypeScript 版
+
+TypeScript 5.x と fp-ts を使った関数型プログラミングの実装例です。
+
+- [TypeScript 解説](typescript/index.md)
+
+### Ruby 版
+
+Ruby 3.x と dry-rb を使った関数型プログラミングの実装例です。
+
+- [Ruby 解説](ruby/index.md)
+
+## 章構成
+
+| Part | 内容 | Scala | Java | F# | C# | Haskell | Clojure | Elixir | Rust | Python | TypeScript | Ruby |
+|------|------|-------|------|-----|-----|---------|---------|--------|------|--------|------------|------|
+| I | 関数型プログラミングの基礎 | [part-1](scala/part-1.md) | [part-1](java/part-1.md) | [part-1](fsharp/part-1.md) | [part-1](csharp/part-1.md) | [part-1](haskell/part-1.md) | [part-1](clojure/part-1.md) | [part-1](elixir/part-1.md) | [part-1](rust/part-1.md) | [part-1](python/part-1.md) | [part-1](typescript/part-1.md) | [part-1](ruby/part-1.md) |
+| II | 関数型スタイルのプログラミング | [part-2](scala/part-2.md) | [part-2](java/part-2.md) | [part-2](fsharp/part-2.md) | [part-2](csharp/part-2.md) | [part-2](haskell/part-2.md) | [part-2](clojure/part-2.md) | [part-2](elixir/part-2.md) | [part-2](rust/part-2.md) | [part-2](python/part-2.md) | [part-2](typescript/part-2.md) | [part-2](ruby/part-2.md) |
+| III | エラーハンドリング | [part-3](scala/part-3.md) | [part-3](java/part-3.md) | [part-3](fsharp/part-3.md) | [part-3](csharp/part-3.md) | [part-3](haskell/part-3.md) | [part-3](clojure/part-3.md) | [part-3](elixir/part-3.md) | [part-3](rust/part-3.md) | [part-3](python/part-3.md) | [part-3](typescript/part-3.md) | [part-3](ruby/part-3.md) |
+| IV | IO と副作用の管理 | [part-4](scala/part-4.md) | [part-4](java/part-4.md) | [part-4](fsharp/part-4.md) | [part-4](csharp/part-4.md) | [part-4](haskell/part-4.md) | [part-4](clojure/part-4.md) | [part-4](elixir/part-4.md) | [part-4](rust/part-4.md) | [part-4](python/part-4.md) | [part-4](typescript/part-4.md) | [part-4](ruby/part-4.md) |
+| V | 並行処理 | [part-5](scala/part-5.md) | [part-5](java/part-5.md) | [part-5](fsharp/part-5.md) | [part-5](csharp/part-5.md) | [part-5](haskell/part-5.md) | [part-5](clojure/part-5.md) | [part-5](elixir/part-5.md) | [part-5](rust/part-5.md) | [part-5](python/part-5.md) | [part-5](typescript/part-5.md) | [part-5](ruby/part-5.md) |
+| VI | 実践的なアプリケーション | [part-6](scala/part-6.md) | [part-6](java/part-6.md) | [part-6](fsharp/part-6.md) | [part-6](csharp/part-6.md) | [part-6](haskell/part-6.md) | [part-6](clojure/part-6.md) | [part-6](elixir/part-6.md) | [part-6](rust/part-6.md) | [part-6](python/part-6.md) | [part-6](typescript/part-6.md) | [part-6](ruby/part-6.md) |
+
+## 主要トピック
+
+| Part | 主要トピック | Scala | Java | F# | C# | Haskell | Clojure | Elixir | Rust | Python | TypeScript | Ruby |
+|------|-------------|-------|------|-----|-----|---------|---------|--------|------|--------|------------|------|
+| I | 純粋関数、参照透過性 | 関数型基礎 | 関数型インターフェース | let バインディング | 式形式メソッド | 純粋関数、遅延評価 | defn, let | def, fn | fn, 所有権 | def, 型ヒント | pipe, 関数合成 | def, ブロック |
+| II | イミュータブル、高階関数、flatMap | List, Option | Vavr List, Option | List, パイプライン | Seq, LINQ | リスト内包表記, fold | map/filter/reduce | Enum, パイプ | Iterator, クロージャ | map/filter, ジェネレータ | ReadonlyArray, chain | Enumerable, flat_map |
+| III | Option、Either、ADT | sealed trait | sealed interface | 判別共用体 | Option, Either | Maybe, Either, ADT | nil, some->/some->> | {:ok}/{:error} | Option, Result | Maybe, Result (returns) | Option, Either, fold | nil安全, Result型 |
+| IV | IO モナド、Stream | cats-effect, fs2 | 独自 IO, Vavr Stream | Async, Seq | Task, IAsyncEnumerable | IO モナド, conduit | lazy-seq | Agent, Stream | async/await, Stream | IO, ジェネレータ | Task, TaskEither, IO | IO, Enumerator |
+| V | Ref、Fiber、並列処理 | cats-effect Ref/Fiber | 独自 Ref, Virtual Thread | Ref, MailboxProcessor | Ref, Task並列 | STM, TVar, async | atom/ref, core.async | Task, GenServer | Arc, Mutex, tokio | asyncio, FutureResult | sequenceT, traverseArray | Ref, Thread |
+| VI | Resource、テスト | ScalaCheck | JUnit 5 プロパティテスト | use, FsCheck | Resource, Validator | bracket, QuickCheck | with-open, test.check | ExUnit, StreamData | トレイト, proptest | Protocol, Hypothesis | Reader, fast-check | Resource, RSpec |
+
+## 参照
+
+- [Grokking Functional Programming](https://www.manning.com/books/grokking-functional-programming) - 原著
+- [Scala 公式ドキュメント](https://docs.scala-lang.org/)
+- [cats-effect](https://typelevel.org/cats-effect/)
+- [fs2](https://fs2.io/)
+- [Vavr](https://www.vavr.io/)
+- [F# 公式ドキュメント](https://docs.microsoft.com/ja-jp/dotnet/fsharp/)
+- [F# for Fun and Profit](https://fsharpforfunandprofit.com/)
+- [LanguageExt](https://github.com/louthy/language-ext)
+- [Haskell 公式サイト](https://www.haskell.org/)
+- [Learn You a Haskell](http://learnyouahaskell.com/)
+- [Clojure 公式サイト](https://clojure.org/)
+- [ClojureDocs](https://clojuredocs.org/)
+- [Elixir 公式ドキュメント](https://elixir-lang.org/docs.html)
+- [Elixir School](https://elixirschool.com/ja/)
+- [Rust 公式ドキュメント](https://doc.rust-lang.org/book/)
+- [tokio](https://tokio.rs/)
+- [Python 公式ドキュメント](https://docs.python.org/3/)
+- [returns](https://returns.readthedocs.io/)
+- [Hypothesis](https://hypothesis.readthedocs.io/)
+- [TypeScript 公式ドキュメント](https://www.typescriptlang.org/docs/)
+- [fp-ts](https://gcanti.github.io/fp-ts/)
+- [fast-check](https://fast-check.dev/)
+- [Ruby 公式ドキュメント](https://docs.ruby-lang.org/ja/)
+- [dry-rb](https://dry-rb.org/)
+- [RSpec](https://rspec.info/)

package/lib/assets/docs/article/grokkingfp/java/index.md

@@ -0,0 +1,211 @@
+# Grokking Functional Programming Java 版解説
+
+本シリーズは「Grokking Functional Programming」（Michał Płachta 著）の学習コンパニオンとして、関数型プログラミングの概念を **Java + Vavr** で実装しながら日本語で解説します。
+
+---
+
+## 対象読者
+
+- Java の経験があり、関数型プログラミングに興味がある開発者
+- Scala を学ばずに Java で FP を実践したい方
+- Vavr ライブラリを使った実践的な FP の適用方法を知りたいエンジニア
+
+---
+
+## 記事一覧
+
+### [Part I: 関数型プログラミングの基礎](part-1.md)
+
+関数型プログラミングの基本概念を学びます。
+
+| 章 | トピック |
+|----|----------|
+| 第1章 | 命令型 vs 関数型、Java での FP 入門 |
+| 第2章 | 純粋関数、副作用の排除、テストの容易さ |
+
+**キーワード**: 純粋関数、参照透過性、副作用
+
+---
+
+### [Part II: 関数型スタイルのプログラミング](part-2.md)
+
+イミュータブルなデータ操作と高階関数を学びます。
+
+| 章 | トピック |
+|----|----------|
+| 第3章 | イミュータブルデータ、Vavr List 操作 |
+| 第4章 | 高階関数、map/filter/foldLeft |
+| 第5章 | flatMap、For 内包表記（Vavr） |
+
+**キーワード**: イミュータブル、高階関数、flatMap、Vavr コレクション
+
+---
+
+### [Part III: エラーハンドリングと Option/Either](part-3.md)
+
+型安全なエラーハンドリングを学びます。
+
+| 章 | トピック |
+|----|----------|
+| 第6章 | Option 型、Some/None |
+| 第7章 | Either 型、Sealed クラス、パターンマッチング |
+
+**キーワード**: Option、Either、Sealed クラス（Java 17+）
+
+---
+
+### [Part IV: IO と副作用の管理](part-4.md)
+
+IO パターンとストリーム処理を学びます。
+
+| 章 | トピック |
+|----|----------|
+| 第8章 | IO パターン、Lazy 評価 |
+| 第9章 | Stream 処理、無限ストリーム |
+
+**キーワード**: Lazy、Try、Future、ストリーム処理
+
+---
+
+### [Part V: 並行処理](part-5.md)
+
+関数型プログラミングにおける並行処理を学びます。
+
+| 章 | トピック |
+|----|----------|
+| 第10章 | CompletableFuture、並列ストリーム |
+
+**キーワード**: 並行処理、CompletableFuture、Virtual Threads（Java 21+）
+
+---
+
+### [Part VI: 実践的なアプリケーション構築とテスト](part-6.md)
+
+実践的なアプリケーション構築とテスト戦略を学びます。
+
+| 章 | トピック |
+|----|----------|
+| 第11章 | TravelGuide アプリ、リソース管理 |
+| 第12章 | テスト戦略、プロパティベーステスト |
+
+**キーワード**: Try-with-resources、DataAccess 抽象化、jqwik
+
+---
+
+## 学習パス
+
+```plantuml
+@startuml
+!theme plain
+left to right direction
+
+rectangle "学習の流れ" {
+  card "Part I\n基礎" as p1
+  card "Part II\nイミュータブル操作" as p2
+  card "Part III\n型による安全性" as p3
+  card "Part IV\nIO/Stream" as p4
+  card "Part V\n並行処理" as p5
+  card "Part VI\n実践" as p6
+}
+
+p1 --> p2
+p2 --> p3
+p3 --> p4
+p4 --> p5
+p5 --> p6
+
+@enduml
+```
+
+---
+
+## 使用ライブラリ
+
+| ライブラリ | 用途 | 対応章 |
+|------------|------|--------|
+| Java 17+ | 言語 | 全章 |
+| Vavr | 関数型データ構造 | 全章 |
+| jqwik | プロパティベーステスト | Part VI |
+| JUnit 5 | 単体テスト | 全章 |
+
+---
+
+## Vavr とは
+
+[Vavr](https://www.vavr.io/) は Java 向けの関数型プログラミングライブラリです。
+
+### 主な機能
+
+- **イミュータブルコレクション**: `List`, `Set`, `Map`, `Seq`
+- **関数型データ型**: `Option`, `Either`, `Try`, `Lazy`, `Future`
+- **パターンマッチング**: `Match` API
+- **タプル**: `Tuple1` 〜 `Tuple8`
+- **関数型インターフェース**: `Function0` 〜 `Function8`
+
+### Scala との対応
+
+| Scala | Vavr (Java) |
+|-------|-------------|
+| `Option[T]` | `Option<T>` |
+| `Either[L, R]` | `Either<L, R>` |
+| `Try[T]` | `Try<T>` |
+| `List[T]` | `List<T>` |
+| `for` 内包表記 | `For.yield()` |
+| パターンマッチ | `Match(value).of()` |
+
+---
+
+## リポジトリ構成
+
+```
+grokkingfp-examples/
+├── app/java/src/main/java/      # Java + Vavr のサンプルコード
+├── app/java/src/test/java/      # テストコード
+├── app/scala/src/main/scala/    # Scala 版（参考）
+└── docs/article/                # 解説記事
+    ├── scala/                   # Scala 版解説
+    └── java/                    # Java 版解説（本ディレクトリ）
+        ├── index.md             # この記事
+        ├── part-1.md            # Part I
+        ├── part-2.md            # Part II
+        ├── part-3.md            # Part III
+        ├── part-4.md            # Part IV
+        ├── part-5.md            # Part V
+        └── part-6.md            # Part VI
+```
+
+---
+
+## 関数型プログラミングの利点
+
+本シリーズを通じて、以下の利点を実感できます:
+
+1. **予測可能性** - 純粋関数は同じ入力に対して常に同じ出力
+2. **テスト容易性** - 副作用がないためテストが簡単
+3. **合成可能性** - 小さな関数を組み合わせて複雑な処理を構築
+4. **並行安全性** - イミュータブルデータは競合状態を防ぐ
+5. **型安全性** - Option、Either で null や例外を型で表現
+
+---
+
+## Java での FP: Scala との比較
+
+| 特徴 | Scala | Java + Vavr |
+|------|-------|-------------|
+| 構文の簡潔さ | 非常に簡潔 | やや冗長 |
+| 型推論 | 強力 | 限定的 |
+| パターンマッチ | 言語機能 | ライブラリ |
+| イミュータブル | デフォルト | 明示的に選択 |
+| for 内包表記 | 言語機能 | `For.yield()` |
+| 学習コスト | 高い | 低い（Java 経験者） |
+| エコシステム | Scala 専用 | Java 資産活用可能 |
+
+---
+
+## 参考資料
+
+- [Grokking Functional Programming](https://www.manning.com/books/grokking-functional-programming) - 原著
+- [Vavr 公式ドキュメント](https://www.vavr.io/)
+- [Vavr GitHub](https://github.com/vavr-io/vavr)
+- [jqwik ドキュメント](https://jqwik.net/)
+- [Java 公式ドキュメント](https://docs.oracle.com/en/java/)