Git履歴の書き換えで肝を冷やした話 ── filter-repoとClaudeで760コミットのメッセージを直す

def run(cmd):
    # text=True だとUTF-8として不正なバイト列(バイナリ差分やShift-JISファイル名混入等)で
    # UnicodeDecodeError を起こして落ちるため、bytesで受け取りerrors="replace"で手動デコード
    result = subprocess.run(cmd, capture_output=True)
    stdout = result.stdout.decode("utf-8", errors="replace")
    stderr = result.stderr.decode("utf-8", errors="replace")
    if result.returncode != 0:
        print(f"[ERROR] command failed: {' '.join(cmd)}\n{stderr}", file=sys.stderr)
        sys.exit(1)
    return stdout


def has_parent(commit_hash):
    result = subprocess.run(
        ["git", "rev-parse", "--verify", "-q", f"{commit_hash}~1"],
        capture_output=True, text=True,
    )
    return result.returncode == 0


def get_commit_info(commit_hash, max_diff_chars):
    msg = run(["git", "log", "-1", "--pretty=format:%s%n%b", commit_hash]).strip()
    files = run(["git", "diff-tree", "--no-commit-id", "--name-status", "-r", commit_hash]).strip()
    if has_parent(commit_hash):
        diff = run(["git", "diff", f"{commit_hash}~1", commit_hash])
    else:
        # 根本コミット(親なし): 空ツリーとの差分 = 全ファイルが追加された状態
        diff = run(["git", "diff-tree", "--root", "-p", commit_hash])
    ...

python3 ~/Downloads/1_extract_diffs.py --out diffs.jsonl

SYSTEM_PROMPT = """あなたはgitコミット履歴の整理を行うアシスタントです。
与えられたdiffと変更ファイル一覧から、Conventional Commits形式の
コミットメッセージを1つだけ生成してください。

ルール:
- 形式: <type>(<scope>): <summary>
  - type は feat, fix, docs, style, refactor, test, chore, perf のいずれか
  - scope は変更の主対象(ディレクトリ名やモジュール名など)。不明なら省略可
  - summary は日本語で50文字以内、命令形または体言止め
- 本文(1行空けて詳細)は、diffから読み取れる「何を変更したか」を箇条書き2〜4行で。
  「なぜ」変更したかはdiffから読み取れないため、推測で書かないこと。
- 出力はコミットメッセージ本文のみ。前置き・後書き・Markdown装飾は一切不要。
"""


def build_user_prompt(entry):
    return f"""変更ファイル:
{entry['files_changed']}

diff:
{entry['diff']}
{'(diffは長いため途中で切り詰めています)' if entry.get('diff_truncated') else ''}

元のメッセージ(参考、意味がないものが多い): {entry['old_message']!r}
"""


# 既存のmessages.jsonがあれば読み込み、すでに成功済みのハッシュはスキップする
# (= 前回APIエラーでスキップされたコミットだけが対象になる)
results = {}
if not args.dry_run and not args.fresh and os.path.exists(args.outfile):
    with open(args.outfile, encoding="utf-8") as f:
        results = json.load(f)
    entries = [e for e in entries if e["hash"] not in results]

python3 ~/Downloads/2_generate_messages.py --in diffs.jsonl --out messages.json --dry-run --limit 5

python3 ~/Downloads/2_generate_messages.py --in diffs.jsonl --out messages.json

old_hash = commit.original_id.decode("ascii")

if old_hash in _messages:
    commit.message = _messages[old_hash].encode("utf-8")
# マッピングにない場合は commit.message を変更しない(元のまま)

REWRITE_MESSAGES_JSON="$(pwd)/messages.json" \
git filter-repo --force --commit-callback "$(cat ~/Downloads/3_rewrite_messages.py)"

git diff 5c69b505ba018d85627a28035e77112a4a40ca3c~1 5c69b505ba018d85627a28035e77112a4a40ca3c
# fatal: ambiguous argument '5c69b505ba018d85627a28035e77112a4a40ca3c~1':
# unknown revision or path not in the working tree.

git rev-list --count HEAD
# 758
git rev-list --count backup-before-rewrite
# fatal: ambiguous argument 'backup-before-rewrite': unknown revision or path not in the working tree.

git branch
#   backup-before-rewrit
#   feature/wsl-support
# * main

git branch -D backup-before-rewrit

git remote add origin [email protected]:ac1965/.emacs.d.git
git push -u origin main
# ! [rejected]        main -> main (fetch first)
# error: failed to push some refs to 'github.com:ac1965/.emacs.d.git'

git fetch origin
# From github.com:ac1965/.emacs.d
#  * [new branch]      main -> origin/main

git branch real-original-history origin/main

git log origin/main --oneline | head -20
# 9dacb62 Update
# 6202000 Update
# ...(以下Updateが並ぶ、書き換え前の本物の履歴と確定)

git diff main real-original-history --stat
# (出力なし = 差分ゼロ、ファイル内容は完全一致)

git push --force-with-lease origin main

git log origin/main --oneline | head -20
# 3d69e3c docs(README.org): ブログファイルを直接開く関数の追加
# 923a71e docs(design_spec): personal LayerのWSL対応とリーダーキー切替バグ修正の説明を追記
# ...(書き換え後の意味のあるメッセージに更新されているのを確認)

git branch -D real-original-history

git clone --no-hardlinks /path/to/original-repo repo-backup-$(date +%Y%m%d)

def generate_one(entry, host, model, timeout):
    resp = requests.post(
        f"{host}/api/generate",
        json={
            "model": model,
            "system": SYSTEM_PROMPT,
            "prompt": build_user_prompt(entry),
            "stream": False,
            "options": {
                "temperature": 0.2,  # コミットメッセージ生成なので低めにして安定させる
            },
        },
        timeout=timeout,
    )
    resp.raise_for_status()
    data = resp.json()
    return strip_code_fence(data.get("response", ""))

# クレジット切れまでにClaude APIで処理できた件数を確認
python3 -c "import json; print(len(json.load(open('messages.json'))))"

# 同じmessages.jsonを指定したまま、Ollama版に切り替えて残りを処理
python3 2_generate_messages_ollama.py --in diffs.jsonl --out messages.json --model qwen2.5-coder:14b

#!/usr/bin/env bash
#
# gen-commit-msg.sh
#
# ステージ済みの git diff (git diff --cached) を Ollama に渡し、
# Conventional Commits 形式のコミットメッセージを生成する。
#
# 事前準備:
#   ollama serve                    (別ターミナルで起動しておく)
#   ollama pull qwen2.5-coder:14b   (初回のみ)
#
# 使い方:
#   git add -A
#   ./gen-commit-msg.sh                     # メッセージを表示するだけ
#   ./gen-commit-msg.sh --commit            # 生成したメッセージでそのままコミット
#   ./gen-commit-msg.sh --commit --edit     # 生成後、エディタで確認・編集してからコミット
#   ./gen-commit-msg.sh --model deepseek-coder-v2:16b
#   ./gen-commit-msg.sh --host http://localhost:11434
#
set -euo pipefail

MODEL="qwen2.5-coder:14b"
HOST="http://localhost:11434"
DO_COMMIT=0
DO_EDIT=0

while [[ $# -gt 0 ]]; do
  case "$1" in
    --model)  MODEL="$2"; shift 2 ;;
    --host)   HOST="$2"; shift 2 ;;
    --commit) DO_COMMIT=1; shift ;;
    --edit)   DO_EDIT=1; shift ;;
    -h|--help)
      sed -n '2,20p' "$0"
      exit 0
      ;;
    *)
      echo "[ERROR] unknown option: $1" >&2
      exit 1
      ;;
  esac
done

# --- 前提チェック -----------------------------------------------------

if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  echo "[ERROR] gitリポジトリの中で実行してください" >&2
  exit 1
fi

DIFF="$(git diff --cached)"
if [[ -z "$DIFF" ]]; then
  echo "[ERROR] ステージされた変更がありません。先に 'git add' してください" >&2
  exit 1
fi

if ! curl -s -o /dev/null -w '%{http_code}' "$HOST/api/tags" | grep -q '^200$'; then
  echo "[ERROR] $HOST に接続できません。'ollama serve' が起動しているか確認してください" >&2
  exit 1
fi

FILES_CHANGED="$(git diff --cached --name-status)"

# --- プロンプト組み立て ------------------------------------------------

SYSTEM_PROMPT='あなたはgitコミット履歴の整理を行うアシスタントです。
与えられたdiffと変更ファイル一覧から、Conventional Commits形式の
コミットメッセージを1つだけ生成してください。

ルール:
- 形式: <type>(<scope>): <summary>
  - type は feat, fix, docs, style, refactor, test, chore, perf のいずれか
  - scope は変更の主対象(ディレクトリ名やモジュール名など)。不明なら省略可
  - summary は日本語で50文字以内、命令形または体言止め
- 本文(1行空けて詳細)は、diffから読み取れる「何を変更したか」を箇条書き2〜4行で。
  「なぜ」変更したかはdiffから読み取れないため、推測で書かないこと。
- 出力はコミットメッセージ本文のみ。前置き・後書き・Markdown装飾・```などの
  コードフェンスは一切不要。説明や確認の言葉("承知しました"等)も付けないこと。'

# diffが巨大すぎるとコンテキスト長を超えるため、上限を設けて切り詰める
MAX_DIFF_CHARS=8000
if [[ ${#DIFF} -gt $MAX_DIFF_CHARS ]]; then
  DIFF="${DIFF:0:$MAX_DIFF_CHARS}
(diffは長いため途中で切り詰めています)"
fi

USER_PROMPT="変更ファイル:
${FILES_CHANGED}

diff:
${DIFF}"

# --- Ollama呼び出し -----------------------------------------------------
# jqへの依存を避けるため、リクエストJSONの組み立て・レスポンスのパースは python3 で行う

REQUEST_JSON="$(
  MODEL="$MODEL" SYSTEM_PROMPT="$SYSTEM_PROMPT" USER_PROMPT="$USER_PROMPT" python3 -c '
import json, os
print(json.dumps({
    "model": os.environ["MODEL"],
    "system": os.environ["SYSTEM_PROMPT"],
    "prompt": os.environ["USER_PROMPT"],
    "stream": False,
    "options": {"temperature": 0.2},
}))
'
)"

echo "[INFO] model=$MODEL host=$HOST でメッセージを生成中..." >&2

RESPONSE="$(curl -s -X POST "$HOST/api/generate" -d "$REQUEST_JSON")"

COMMIT_MSG="$(
  echo "$RESPONSE" | python3 -c '
import json, sys
data = json.load(sys.stdin)
text = data.get("response", "").strip()
# モデルが ```...``` で囲って返すことがあるため剥がす
if text.startswith("```"):
    lines = text.split("\n")
    if lines[0].startswith("```"):
        lines = lines[1:]
    if lines and lines[-1].strip() == "```":
        lines = lines[:-1]
    text = "\n".join(lines).strip()
print(text)
'
)"

if [[ -z "$COMMIT_MSG" ]]; then
  echo "[ERROR] メッセージの生成に失敗しました。Ollamaの応答:" >&2
  echo "$RESPONSE" >&2
  exit 1
fi

echo "----------------------------------------"
echo "$COMMIT_MSG"
echo "----------------------------------------"

# --- コミット実行(任意) -------------------------------------------------

if [[ $DO_COMMIT -eq 1 ]]; then
  if [[ $DO_EDIT -eq 1 ]]; then
    git commit -e -m "$COMMIT_MSG"
  else
    git commit -m "$COMMIT_MSG"
  fi
else
  echo "[INFO] --commit を付けると、このメッセージでそのままコミットします" >&2
fi

chmod +x gen-commit-msg.sh

git add -A
./gen-commit-msg.sh                    # 生成結果を表示するだけ
./gen-commit-msg.sh --commit           # そのままコミット
./gen-commit-msg.sh --commit --edit    # エディタで確認・編集してからコミット