サイドバーを
日本語化する

Claude Desktop の Recents サイドバーに表示されるセッションタイトルを、自動で日本語化するセットアップをして欲しいです。

## 環境前提
- macOS であること
- jq コマンドが入ってること (なければ案内してください)
- Claude Code がインストール済みであること

## やってほしいこと

### 1. 前提確認
- macOS か確認 (`uname` で Darwin)
- `jq` `python3` `claude` の存在確認
- 不足してたら `brew install jq` 等の案内をして停止

### 2. ファイル `~/.claude/hooks/rename-session-title.sh` を以下の内容で作成
（ディレクトリも無ければ `mkdir -p ~/.claude/hooks` で作成）

```bash
#!/usr/bin/env bash
set -uo pipefail
LOG="$HOME/.claude/hooks/rename-session-title.log"
mkdir -p "$(dirname "$LOG")"
log() { printf '[%s] %s\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$*" >> "$LOG"; }
if [ "${CLAUDE_RENAME_HOOK_ACTIVE:-}" = "1" ]; then exit 0; fi
export CLAUDE_RENAME_HOOK_ACTIVE=1
log "=== hook fired (pid=$$) ==="
if [ "$(uname)" != "Darwin" ]; then
  log "ERROR this script supports macOS only (got: $(uname))"
  exit 0
fi
MISSING=()
for cmd in jq python3 claude; do
  command -v "$cmd" >/dev/null 2>&1 || MISSING+=("$cmd")
done
if [ ${#MISSING[@]} -gt 0 ]; then
  log "ERROR missing required commands: ${MISSING[*]}"
  log "  Install hint:"
  log "    - jq:      brew install jq"
  log "    - python3: brew install python3  (or use system python)"
  log "    - claude:  visit https://claude.com/claude-code"
  log "  Ensure they are in PATH (e.g. /opt/homebrew/bin or /usr/local/bin)"
  exit 0
fi
CLAUDE_BIN=$(command -v claude)
INPUT=$(cat 2>/dev/null || true)
SID=$(printf '%s' "$INPUT" | jq -r '.session_id // empty' 2>/dev/null || echo "")
EVENT=$(printf '%s' "$INPUT" | jq -r '.hook_event_name // empty' 2>/dev/null || echo "")
log "event=$EVENT session_id=$SID"
SESSIONS_DIR="$HOME/Library/Application Support/Claude/claude-code-sessions"
[ -d "$SESSIONS_DIR" ] || { log "no sessions dir"; exit 0; }
LOCKDIR="$HOME/.claude/hooks/.rename.lock.d"
PID_FILE="$LOCKDIR/pid"
acquire_lock() {
  local retries=3
  while [ $retries -gt 0 ]; do
    if mkdir "$LOCKDIR" 2>/dev/null; then echo "$$" > "$PID_FILE"; return 0; fi
    local old_pid=""
    [ -f "$PID_FILE" ] && old_pid=$(cat "$PID_FILE" 2>/dev/null)
    if [ -n "$old_pid" ] && kill -0 "$old_pid" 2>/dev/null; then
      log "lock held by alive pid=$old_pid, skipping"; return 1
    fi
    log "stale lock (pid=${old_pid:-none} not alive), taking over"
    rm -rf "$LOCKDIR"; retries=$((retries - 1))
  done
  log "could not acquire lock after retries, skipping"
  return 1
}
if [ -d "$LOCKDIR" ]; then
  if [ -n "$(find "$LOCKDIR" -maxdepth 0 -mmin +10 2>/dev/null)" ]; then
    rm -rf "$LOCKDIR"; log "removed stale lock by age (fallback)"
  fi
fi
if ! acquire_lock; then exit 0; fi
trap 'rm -rf "$LOCKDIR"' EXIT
is_non_ascii() {
  printf '%s' "$1" | python3 -c 'import sys; sys.exit(0 if any(b>=0x80 for b in sys.stdin.buffer.read()) else 1)'
}
COUNT=0; SCANNED=0
while IFS= read -r -d '' f; do
  SCANNED=$((SCANNED+1))
  TITLE=$(jq -r '.title // empty' "$f" 2>/dev/null)
  [ -n "$TITLE" ] || continue
  if is_non_ascii "$TITLE"; then continue; fi
  log "translating: $TITLE  ($f)"
  PROMPT="次の英語のセッションタイトルを、自然で簡潔な日本語に翻訳してください。
ルール:
- タイトルだけを1行で返す
- 引用符・前置き・補足説明は不要
- 20文字以内を目安に
- 固有名詞・コマンド名・ファイル名は原文のまま残す

タイトル: $TITLE"
  JP_TITLE=$("$CLAUDE_BIN" -p --model haiku "$PROMPT" </dev/null 2>>"$LOG" \
    | head -1 | sed -E 's/^[[:space:]"'''「『]+//; s/[[:space:]"'''」』]+$//')
  [ -n "$JP_TITLE" ] || { log "  empty result, skip"; continue; }
  [ ${#JP_TITLE} -le 200 ] || { log "  too long, skip"; continue; }
  if ! is_non_ascii "$JP_TITLE"; then log "  ascii result, skip: $JP_TITLE"; continue; fi
  TMP="${f}.tmp.$$"
  if jq --arg t "$JP_TITLE" '.title = $t | .titleSource = "user"' "$f" > "$TMP" 2>>"$LOG"; then
    if jq -e '.sessionId and .cliSessionId and (.title != null)' "$TMP" >/dev/null 2>&1; then
      BACKUP_DIR="$HOME/.claude/hooks/backup/$(date '+%Y-%m-%d')"
      if ! mkdir -p "$BACKUP_DIR" 2>>"$LOG"; then
        rm -f "$TMP"; log "  backup dir creation failed, aborting"; continue
      fi
      BACKUP_FILE="$BACKUP_DIR/$(basename "$f")"
      if [ ! -f "$BACKUP_FILE" ]; then
        if ! cp "$f" "$BACKUP_FILE" 2>>"$LOG"; then
          rm -f "$TMP"; log "  backup failed, aborting"; continue
        fi
      fi
      if mv "$TMP" "$f" 2>>"$LOG"; then
        log "  -> $JP_TITLE  file=$f  backup=$BACKUP_FILE"
        COUNT=$((COUNT+1))
      else
        rm -f "$TMP"; log "  mv failed, original not overwritten"
      fi
    else
      rm -f "$TMP"; log "  health check failed, skipping"
    fi
  else
    rm -f "$TMP"; log "  jq failed"
  fi
done < <(find "$SESSIONS_DIR" -name "local_*.json" -print0 2>/dev/null)
log "done. scanned=$SCANNED translated=$COUNT"
exit 0
```

### 3. 実行権限を付ける
`chmod +x ~/.claude/hooks/rename-session-title.sh`

### 4. `~/.claude/settings.json` を編集 (重要: 重複登録に注意)

以下の要件を必ず満たしてください:

- ファイルが無ければ `{}` で新規作成
- 既存の場合はバックアップ (`cp ~/.claude/settings.json ~/.claude/settings.json.bak.$(date +%s)`)
- `.hooks` / `.hooks.Stop` / `.hooks.SessionStart` キーが存在しなくても壊れないマージ処理
- 同じ command が既に登録されていれば一度削除してから追加 (2 回実行しても重複しない冪等処理)
- `command` には `~` ではなく `$HOME` を展開した絶対パスを使用

参考の jq コマンド (安全版):

```bash
HOOK_CMD="$HOME/.claude/hooks/rename-session-title.sh"

[ -f ~/.claude/settings.json ] && cp ~/.claude/settings.json ~/.claude/settings.json.bak.$(date +%s)
[ -f ~/.claude/settings.json ] || echo '{}' > ~/.claude/settings.json

jq --arg cmd "$HOOK_CMD" '
  .hooks = (.hooks // {}) |
  .hooks.Stop = (
    (.hooks.Stop // [])
    | map(.hooks = ((.hooks // []) | map(select(.command != $cmd))))
    | map(select((.hooks // []) | length > 0))
  ) |
  .hooks.SessionStart = (
    (.hooks.SessionStart // [])
    | map(.hooks = ((.hooks // []) | map(select(.command != $cmd))))
    | map(select((.hooks // []) | length > 0))
  ) |
  .hooks.Stop += [{
    "hooks": [{
      "type": "command",
      "command": $cmd,
      "async": true,
      "timeout": 120
    }]
  }] |
  .hooks.SessionStart += [{
    "hooks": [{
      "type": "command",
      "command": $cmd,
      "async": true,
      "timeout": 120
    }]
  }]
' ~/.claude/settings.json > ~/.claude/settings.json.tmp \
  && mv ~/.claude/settings.json.tmp ~/.claude/settings.json
```

### 5. `~/.claude/CLAUDE.md` の末尾に以下を追記
（ファイルが無ければ新規作成。既に同じセクションがある場合は重複追記しない）

```
## セッションタイトル
新しいセッションのタイトル / 会話のタイトルは必ず日本語で生成してください。
```

### 6. 動作確認
- `~/.claude/hooks/rename-session-title.sh` が +x で存在
- `~/.claude/settings.json` が valid JSON (`jq . ~/.claude/settings.json`)
- 手動 1 回走らせて動作確認:
  `echo '{"session_id":"setup-test","hook_event_name":"Stop"}' | bash ~/.claude/hooks/rename-session-title.sh`
  ログ確認: `tail -20 ~/.claude/hooks/rename-session-title.log`

### 7. 完了報告
完了したら以下をユーザーに伝えてください:
- 「セットアップ完了しました。Cmd+Q で Claude Desktop を完全終了 → 再起動してください。」
- 「再起動後、Recents の英語タイトルが順次日本語化されます (新規セッションも自動で日本語タイトルになるよう設定済み)」
- バックアップ場所: `~/.claude/hooks/backup/<日付>/` に編集前ファイルが残ります

途中で詰まったら、どこで止まったか教えてください。