@k2works/claude-code-booster 6.2.0 → 6.3.1

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

@@ -1,214 +0,0 @@
----
-type: Article
-title: "第 12 章: エラーハンドリングと型安全性"
-description: "前章までで Stream API とパイプライン処理を学びました。"
-tags: [article, getting-start-tdd, java]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 12 章: エラーハンドリングと型安全性
-
-## 12.1 はじめに
-
-前章までで Stream API とパイプライン処理を学びました。この章では、`Optional` を使った **null 安全** なコードの書き方と、**型安全** なファクトリパターンを学びます。
-
-## 12.2 Optional による null 安全
-
-### null の問題
-
-`null` は「値がない」ことを表現しますが、NullPointerException の原因になります。
-
-```java
-// 危険: null チェック忘れ
-FizzBuzzValue value = map.get(key); // null の可能性
-String result = value.getValue();    // NullPointerException!
-```
-
-### Optional の基本
-
-`Optional` は「値があるかもしれないし、ないかもしれない」を型で表現します。
-
-```java
-// Optional の生成
-Optional<FizzBuzzValue> present = Optional.of(value);      // 値あり
-Optional<FizzBuzzValue> empty = Optional.empty();           // 値なし
-Optional<FizzBuzzValue> nullable = Optional.ofNullable(v);  // null 許容
-```
-
-### Optional の操作
-
-```java
-Optional<FizzBuzzValue> opt = Optional.of(type.generate(15));
-
-// map: 値を変換
-Optional<String> result = opt.map(FizzBuzzValue::getValue);
-
-// filter: 条件に合わなければ empty
-Optional<FizzBuzzValue> fizz = opt
-    .filter(v -> "Fizz".equals(v.getValue()));
-
-// orElse: 値がなければデフォルト値
-String value = opt.map(FizzBuzzValue::getValue)
-    .orElse("unknown");
-
-// orElseThrow: 値がなければ例外
-String value = opt.map(FizzBuzzValue::getValue)
-    .orElseThrow(() ->
-        new IllegalStateException("値が存在しません"));
-```
-
-## 12.3 FizzBuzzType ファクトリの改善
-
-### 現在の実装: 例外スロー
-
-```java
-public static FizzBuzzType create(int type) {
-    switch (type) {
-        case 1: return new FizzBuzzType01();
-        case 2: return new FizzBuzzType02();
-        case 3: return new FizzBuzzType03();
-        default:
-            throw new IllegalArgumentException(
-                "該当するタイプは存在しません");
-    }
-}
-```
-
-### Optional を使った安全なファクトリ
-
-```java
-public static Optional<FizzBuzzType> createOptional(int type) {
-    switch (type) {
-        case 1: return Optional.of(new FizzBuzzType01());
-        case 2: return Optional.of(new FizzBuzzType02());
-        case 3: return Optional.of(new FizzBuzzType03());
-        default: return Optional.empty();
-    }
-}
-```
-
-使用例:
-
-```java
-// パターン 1: デフォルト値を指定
-FizzBuzzType type = FizzBuzzType.createOptional(4)
-    .orElse(FizzBuzzType.create(1));
-
-// パターン 2: Optional のまま操作
-FizzBuzzType.createOptional(1)
-    .map(t -> t.generate(15))
-    .map(FizzBuzzValue::getValue)
-    .ifPresent(System.out::println);
-```
-
-## 12.4 FizzBuzzList の検索機能
-
-### find: 最初の一致を Optional で返す
-
-```java
-// FizzBuzzList にメソッドを追加
-public Optional<FizzBuzzValue> findFirst(
-        Predicate<FizzBuzzValue> predicate) {
-    return values.stream()
-        .filter(predicate)
-        .findFirst();
-}
-```
-
-使用例:
-
-```java
-FizzBuzzList list = listCommand.executeList(100);
-
-// 最初の FizzBuzz を検索
-Optional<FizzBuzzValue> firstFizzBuzz = list.findFirst(
-    v -> "FizzBuzz".equals(v.getValue())
-);
-
-// 値があれば表示、なければ "none"
-String result = firstFizzBuzz
-    .map(FizzBuzzValue::toString)
-    .orElse("none");
-```
-
-## 12.5 型安全な列挙型ファクトリ
-
-### enum を使った型安全なタイプ指定
-
-```java
-public enum FizzBuzzTypeName {
-    STANDARD(1),
-    NUMBER_ONLY(2),
-    FIZZBUZZ_ONLY(3);
-
-    private final int code;
-
-    FizzBuzzTypeName(int code) {
-        this.code = code;
-    }
-
-    public int getCode() {
-        return code;
-    }
-}
-```
-
-ファクトリメソッドを enum で受け取るバージョン:
-
-```java
-public static FizzBuzzType create(FizzBuzzTypeName name) {
-    return create(name.getCode());
-}
-```
-
-使用例:
-
-```java
-// Before: マジックナンバー
-FizzBuzzType type = FizzBuzzType.create(1);
-
-// After: 型安全な列挙型
-FizzBuzzType type = FizzBuzzType.create(FizzBuzzTypeName.STANDARD);
-```
-
-## 12.6 全体の振り返り
-
-### 第 4 部で学んだこと
-
-| 章 | テーマ | 学んだこと |
-|----|--------|-----------|
-| 10 | 高階関数と関数合成 | Lambda 式、メソッド参照、Function、Stream 基本 |
-| 11 | 不変データとパイプライン処理 | 不変設計、IntStream、Collectors、パイプライン |
-| 12 | エラーハンドリングと型安全性 | Optional、型安全なファクトリ、enum |
-
-### 全 12 章の総括
-
-```
-第 1 部（章 1-3）: TDD の基本サイクル
-  → Red-Green-Refactor、テストファースト
-
-第 2 部（章 4-6）: 開発環境と自動化
-  → Git、静的解析、CI/CD
-
-第 3 部（章 7-9）: オブジェクト指向設計
-  → ポリモーフィズム、デザインパターン、SOLID
-
-第 4 部（章 10-12）: 関数型プログラミング
-  → Lambda、Stream、Optional
-```
-
-TDD の規律を守りながら、手続き型 → OOP → FP と段階的にコードを改善しました。これは「動作するきれいなコード」を目指す TDD の本質です。
-
-## 12.7 まとめ
-
-| 概念 | 適用 |
-|------|------|
-| Optional | null 安全な値の表現と操作 |
-| Optional ファクトリ | `createOptional` で例外を回避 |
-| findFirst | Stream + Optional による安全な検索 |
-| enum ファクトリ | マジックナンバーの排除と型安全性 |
-
-> **よいソフトウェアとは、変更を楽に安全にできて役に立つソフトウェアである。**
->
-> TDD の規律と、オブジェクト指向・関数型の設計技法を組み合わせることで、この目標に近づくことができます。

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

@@ -1,61 +0,0 @@
-# テスト駆動開発から始める Java 入門
-
-## 概要
-
-FizzBuzz 問題を題材に、テスト駆動開発（TDD）の基本サイクルから、開発環境の整備、オブジェクト指向設計、関数型プログラミングの活用まで、Java の特徴を活かしながら段階的に学びます。
-
-## 対象読者
-
-- Java の基本文法を理解しているプログラミング学習者
-- TDD を体験してみたい開発者
-- オブジェクト指向設計や関数型プログラミングに興味がある方
-
-## 前提条件
-
-- JDK 11 以降がインストールされていること
-- Gradle が利用可能であること（Nix 環境推奨: `nix develop .#java`）
-
-## 目次
-
-### 第 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-encapsulation-and-polymorphism.md)
-8. [第 8 章: デザインパターンの適用](08-design-patterns.md)
-9. [第 9 章: SOLID 原則とモジュール設計](09-solid-principles-and-module-design.md)
-
-### 第 4 部: 関数型プログラミングへの展開
-
-10. [第 10 章: 高階関数と関数合成](10-higher-order-functions-and-composition.md)
-11. [第 11 章: 不変データとパイプライン処理](11-immutable-data-and-pipeline.md)
-12. [第 12 章: エラーハンドリングと型安全性](12-error-handling-and-type-safety.md)
-
-## 実装コード
-
-本記事のすべてのコード例は `apps/java/` に実装されています。
-
-```bash
-# 開発環境に入る
-nix develop .#java
-
-# テスト実行
-cd apps/java
-./gradlew test
-```
-
-## 参考文献
-
-- Kent Beck 著『テスト駆動開発』
-- Martin Fowler 著『リファクタリング: 既存のコードを安全に改善する』
-- Robert C. Martin 著『Clean Code: アジャイルソフトウェア達人の技』

package/lib/assets/docs/article/getting-start-tdd/node/01-todo-list-and-first-test.md

@@ -1,253 +0,0 @@
----
-type: Article
-title: "第 1 章: TODO リストと最初のテスト"
-description: "プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して TODO リスト を作るところから始めます。"
-tags: [article, getting-start-tdd, node]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-24T05:22:28Z }
----
-
-# 第 1 章: TODO リストと最初のテスト
-
-## 1.1 はじめに
-
-プログラムを作成するにあたって、まず何をすればよいでしょうか？私たちは、仕様を確認して **TODO リスト** を作るところから始めます。
-
-> TODO リスト
->
-> 何をテストすべきだろうか——着手する前に、必要になりそうなテストをリストに書き出しておこう。
->
-> — テスト駆動開発
-
-## 1.2 仕様の確認
-
-今回取り組む FizzBuzz 問題の仕様は以下の通りです。
-
-```
-1 から 100 までの数をプリントするプログラムを書け。
-ただし 3 の倍数のときは数の代わりに「Fizz」と、5 の倍数のときは「Buzz」とプリントし、
-3 と 5 両方の倍数の場合には「FizzBuzz」とプリントすること。
-```
-
-この仕様をそのままプログラムに落とし込むには少しサイズが大きいですね。最初の作業は仕様を **TODO リスト** に分解する作業から着手しましょう。
-
-## 1.3 TODO リストの作成
-
-仕様を分解して TODO リストを作成します。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [ ] 1 を渡したら文字列 "1" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-まず「1 を渡したら文字列 "1" を返す」という、最も小さなタスクから取り掛かります。
-
-## 1.4 テスティングフレームワークの導入
-
-### テストファースト
-
-最初にプログラムする対象を決めたので、早速プロダクトコードを実装……ではなく **テストファースト** で作業を進めましょう。
-
-> テストファースト
->
-> いつテストを書くべきだろうか——それはテスト対象のコードを書く前だ。
->
-> — テスト駆動開発
-
-今回 TypeScript のテスティングフレームワークには [Vitest](https://vitest.dev/) を利用します。Vitest は Vite をベースにした高速なテストフレームワークで、TypeScript を追加設定なしでサポートします。
-
-### 開発環境のセットアップ
-
-npm プロジェクトに Vitest と TypeScript を追加して、テスト環境をセットアップします。
-
-```json
-// package.json
-{
-  "name": "fizzbuzz",
-  "version": "0.1.0",
-  "description": "FizzBuzz TDD project for Node (JS/TS)",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
-  },
-  "devDependencies": {
-    "typescript": "^5.7",
-    "vitest": "^3.2"
-  }
-}
-```
-
-`"type": "module"` を指定することで、ES Modules を使用します。
-
-TypeScript の設定ファイルを作成します。
-
-```json
-// tsconfig.json
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*.ts", "test/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}
-```
-
-依存パッケージをインストールします。
-
-```bash
-$ npm install
-```
-
-### 環境確認テスト
-
-環境が正しく設定されていることを確認するため、簡単なテストを書きます。
-
-```typescript
-// test/hello.test.ts
-import { describe, test, expect } from "vitest";
-
-describe("Hello", () => {
-  test("greeting", () => {
-    const greeting = (): string => "hello world";
-    expect(greeting()).toBe("hello world");
-  });
-});
-```
-
-Vitest では `describe`、`test`、`expect` を `vitest` から明示的にインポートします。
-
-テストを実行します。
-
-```bash
-$ npx vitest run
-```
-
-```
- ✓ test/hello.test.ts (1 test) 1ms
-
- Test Files  1 passed (1)
-      Tests  1 passed (1)
-```
-
-テストが成功すれば、開発環境のセットアップは完了です。
-
-## 1.5 最初のテストを書く
-
-### アサートファースト
-
-TODO リストの最初の項目「1 を渡したら文字列 "1" を返す」に取り掛かります。
-
-> アサートファースト
->
-> いつアサーションを書くべきだろうか——最初に書こう。
->
-> — テスト駆動開発
-
-テストコードを日本語で記述します。Vitest では `test` 関数の第 1 引数にテスト名を自由に書けるため、日本語のテスト名を使うことでドキュメントとしての可読性が上がります。
-
-```typescript
-// test/fizzbuzz.test.ts
-import { describe, test, expect, beforeEach } from "vitest";
-import { FizzBuzz } from "../src/fizzbuzz";
-
-describe("FizzBuzz", () => {
-  let fizzbuzz: FizzBuzz;
-
-  beforeEach(() => {
-    fizzbuzz = new FizzBuzz();
-  });
-
-  test("1を渡したら文字列1を返す", () => {
-    expect(fizzbuzz.generate(1)).toBe("1");
-  });
-});
-```
-
-### Red: テストを実行して失敗させる
-
-テストを実行します。
-
-```bash
-$ npx vitest run
-```
-
-```
- FAIL  test/fizzbuzz.test.ts
-  FizzBuzz
-    ✕ 1を渡したら文字列1を返す
-      Error: Failed to resolve import "../src/fizzbuzz"
-```
-
-`FizzBuzz` クラスが定義されていないというエラーが出ました。まだ作っていないのですから当然です。
-
-### Green: 仮実装でテストを通す
-
-最初のテストを通すために **仮実装** から始めましょう。
-
-> 仮実装を経て本実装へ
->
-> 失敗するテストを書いてから、最初に行う実装はどのようなものだろうか——ベタ書きの値を返そう。
->
-> — テスト駆動開発
-
-`FizzBuzz` クラスを定義して、文字列リテラルを返す `generate` メソッドを作成します。
-
-```typescript
-// src/fizzbuzz.ts
-export class FizzBuzz {
-  generate(number: number): string {
-    return "1";
-  }
-}
-```
-
-テストを実行します。
-
-```bash
-$ npx vitest run
-```
-
-```
- ✓ test/fizzbuzz.test.ts (1 test) 2ms
-
- Test Files  1 passed (1)
-      Tests  1 passed (1)
-```
-
-テストが通りました！「え？こんなベタ書きのプログラムでいいの？」と思われるかもしれませんが、この細かいステップに今しばらくお付き合いください。
-
-**TODO リスト**:
-
-- [ ] 数を文字列にして返す
-  - [x] 1 を渡したら文字列 "1" を返す
-- [ ] 3 の倍数のときは数の代わりに「Fizz」と返す
-- [ ] 5 の倍数のときは「Buzz」と返す
-- [ ] 3 と 5 両方の倍数の場合には「FizzBuzz」と返す
-- [ ] 1 から 100 までの数
-- [ ] プリントする
-
-## 1.6 まとめ
-
-この章では、TDD の最も基本的なステップを体験しました。
-
-1. **TODO リストの作成** — 仕様を小さなタスクに分解する
-2. **テストファースト** — テスト対象のコードを書く前にテストを書く
-3. **アサートファースト** — テストの終わりにパスすべきアサーションを最初に書く
-4. **仮実装** — 失敗するテストを通すために、ベタ書きの値を返す
-
-次の章では、三角測量によってプログラムを一般化していきます。