UI を日本語にしても、コミットログは英語のままでした — 無人エージェントの出力言語が揺れ続けた6週間の記録

## 出力言語
 
- コミットメッセージは日本語で書いてください
- コードコメントは英語で書いてください

## 出力言語の契約（例外なく適用）
 
言語は「そのテキストを誰が読むか」で決まります。UI 設定や会話の言語とは無関係です。
 
### コミットメッセージ
- prefix は英語固定: `Add:` `Fix:` `Update:` `Refactor:` `Remove:` のいずれか
- prefix 以降の本文は日本語
- 1つのメッセージ内で日本語と英語を混ぜない（prefix を除く）
- 例（従う）: `Fix: スケジューラの競合状態を解消`
- 例（従わない）: `Fix: resolve race condition in the scheduler`
- 例（従わない）: `Fix: スケジューラの競合状態を解消 and update tests`
 
### コードコメント
- `src/` `content/` 配下 = 公開されるコード → 英語のみ
- `scripts/` `_ops/` 配下 = 自分専用の運用スクリプト → 日本語のみ
- 迷ったら英語（公開される可能性を優先）
 
### ログ出力の文字列
- `print` `console.log` `logger.*` の第一引数は英語のみ
- 変数展開の中身（ファイル名・記事タイトル等）はこの限りではありません

#!/usr/bin/env python3
"""出力言語契約のゲート。ステージ済み差分とコミットメッセージを検査する。"""
import re
import subprocess
import sys
from pathlib import Path
 
# CJK 統合漢字・ひらがな・カタカナ。半角記号や全角英数は含めない
CJK = re.compile(r"[぀-ゟ゠-ヿ一-鿿]")
COMMIT_PREFIX = re.compile(r"^(Add|Fix|Update|Refactor|Remove|Docs|Test):\s")
 
# 英語コメント中に現れても違反としない固有名詞・技術語
ALLOWLIST = {"Antigravity", "Gemini", "Dolice", "Cloudflare", "Stripe"}
 
# パス → 期待する言語
RULES = [
    (re.compile(r"^(src|content)/"), "en"),
    (re.compile(r"^(scripts|_ops)/"), "ja"),
]
 
COMMENT_PATTERNS = [
    re.compile(r"^\+\s*//\s?(.*)$"),      # ts/js/go
    re.compile(r"^\+\s*#\s?(.*)$"),       # python/bash
    re.compile(r"^\+\s*\*\s?(.*)$"),      # jsdoc 継続行
]
 
 
def has_cjk(text: str) -> bool:
    return bool(CJK.search(text))
 
 
def strip_allowlist(text: str) -> str:
    for word in ALLOWLIST:
        text = text.replace(word, "")
    return text
 
 
def expected_lang(path: str) -> str | None:
    for pattern, lang in RULES:
        if pattern.match(path):
            return lang
    return None
 
 
def check_commit_message(msg: str) -> list[str]:
    """prefix は英語固定、本文は日本語、1行内の混在は不可。"""
    violations = []
    first = msg.strip().splitlines()[0] if msg.strip() else ""
    if not COMMIT_PREFIX.match(first):
        violations.append(f"commit: prefix が契約外です -> {first[:60]!r}")
        return violations
 
    body = COMMIT_PREFIX.sub("", first)
    if not has_cjk(body):
        violations.append(f"commit: 本文が日本語ではありません -> {body[:60]!r}")
    else:
        # 1行内の混在: CJK を含みつつ、3文字以上の英単語が2つ以上並ぶ
        words = re.findall(r"[A-Za-z]{3,}", strip_allowlist(body))
        if len(words) >= 2:
            violations.append(f"commit: 1行内で言語が混在しています -> {body[:60]!r}")
    return violations
 
 
def iter_added_comments(path: str) -> list[str]:
    """そのファイルの差分から、追加されたコメント行の中身だけを取り出す。"""
    diff = subprocess.run(
        ["git", "diff", "--cached", "-U0", "--", path],
        capture_output=True, text=True, check=True,
    ).stdout
    out = []
    in_code_block = False
    for line in diff.splitlines():
        # .md の差分ではコードブロック内を対象外にする
        if path.endswith(".md") and line.lstrip("+-").strip().startswith("```"):
            in_code_block = not in_code_block
            continue
        if in_code_block or not line.startswith("+"):
            continue
        for pattern in COMMENT_PATTERNS:
            m = pattern.match(line)
            if m and m.group(1).strip():
                out.append(m.group(1).strip())
                break
    return out
 
 
def main() -> int:
    violations: list[str] = []
 
    msg_path = Path(sys.argv[1]) if len(sys.argv) > 1 else None
    if msg_path and msg_path.exists():
        violations += check_commit_message(msg_path.read_text(encoding="utf-8"))
 
    staged = subprocess.run(
        ["git", "diff", "--cached", "--name-only", "-z"],
        capture_output=True, text=True, check=True,
    ).stdout
    # -z を付けないと、日本語ファイル名が八進エスケープされて検査対象を取り違えます
    for path in filter(None, staged.split("\0")):
        want = expected_lang(path)
        if want is None:
            continue
        for comment in iter_added_comments(path):
            cjk = has_cjk(strip_allowlist(comment))
            if want == "en" and cjk:
                violations.append(f"{path}: 公開コードのコメントに日本語 -> {comment[:50]!r}")
            elif want == "ja" and not cjk and len(comment) > 12:
                violations.append(f"{path}: 運用スクリプトのコメントに英語 -> {comment[:50]!r}")
 
    if violations:
        print("🛑 出力言語契約の違反:")
        for v in violations:
            print(f"  - {v}")
        return 1
    print("✅ 出力言語契約 OK")
    return 0
 
 
if __name__ == "__main__":
    sys.exit(main())

# .git/hooks/commit-msg （実行権限を付けること: chmod +x）
#!/bin/sh
python3 scripts/lang_gate.py "$1" || exit 1