# Issue #30: ログメッセージの日本語統一

## 優先度: 低

## 概要

フレームワーク内のログメッセージが日本語と英語で混在している。初期フェーズは日本語ユーザーをターゲットとするため、**日本語に統一**する。

## 背景

- 初期は日本語ユーザー向けのニッチなパッケージとして展開
- 日本語ユーザーにとって分かりやすいログメッセージを提供
- 将来的に国際化が必要になった場合は別途対応

## 現状の問題

### 混在の例

```python
# 日本語
logger.info("パイプラインを開始します")
logger.error("ノードの実行に失敗しました")

# 英語（混在）
logger.debug("Starting node execution")
logger.warning("Retry attempt 2 of 3")
```

### 影響

- ログの一貫性がない
- 日本語ユーザーにとって英語メッセージは分かりにくい

## 提案されたアプローチ

### 統一方針

1. **ログメッセージ**: 日本語に統一
2. **ドキュメント**: 日本語
3. **エラーメッセージ**: 日本語に統一
4. **コード内コメント**: 日本語可（ただしdocstringは英語も可）

### 変更例

```python
# Before
logger.debug("Starting node execution")
logger.warning("Retry attempt 2 of 3")

# After
logger.debug("ノード実行を開始")
logger.warning("リトライ 2/3 回目")
```

## 実装計画（TDD）

### Phase 1: Red

```python
# tests/unit/core/test_log_messages.py
import re

def test_all_log_messages_are_japanese():
    """全てのログメッセージが日本語である"""
    # railway/ 配下の全ファイルをスキャン
    # logger.xxx("...") のメッセージを抽出
    # 日本語文字が含まれていることを確認
    ...

def test_no_english_only_log_messages():
    """英語のみのログメッセージがない"""
    # ASCII文字のみのログメッセージを検出
    ...
```

### Phase 2: Green

1. 全ソースコードの英語ログメッセージを洗い出し
2. 日本語に翻訳
3. テストの期待値を更新

### Phase 3: Refactor

一貫したログメッセージスタイルの確立

## 対象ファイルの調査

```bash
# 英語のみのログメッセージを検出
grep -r "logger\." railway/ | grep -vE "[ぁ-んァ-ン一-龥]"
```

## ログメッセージスタイルガイド

```python
# 推奨スタイル
logger.info("パイプライン実行を開始")
logger.debug("ノード 'fetch_users' を実行中")
logger.warning("リトライ 2/3 回目: ConnectionError")
logger.error("ノード 'save_data' の実行に失敗: {error}")

# 避けるスタイル
logger.info("Starting pipeline execution")  # 英語NG
logger.info("パイプラインをスタートします")  # 不自然な日本語
```

## 受け入れ条件

- [ ] 全ログメッセージが日本語
- [ ] 一貫したスタイルガイドに準拠
- [ ] テストが通過
- [ ] ドキュメントへの影響なし

## 関連

- 外部監査（2026-01-22）: 優先度 低
- 初期フェーズは日本語ユーザー向け
