refactor: 標準ライブラリの uuid パッケージへ移行

[kantacky]

変更点

Note

このPRは #49 (Go 1.27 へのアップデート) にスタックしています。base は claude/go-1-27-upgrade-6geumw です。#49 のマージ後に base が main に切り替わります。

Go 1.27 で標準ライブラリに追加された uuid パッケージ (RFC 9562) を使うようにし、github.com/google/uuid への直接依存を解消しました。

• 全 20 ファイルの import を github.com/google/uuid から標準ライブラリの uuid へ置き換え
• uuid.Nil は標準ライブラリでは変数ではなく関数のため、uuid.Nil() へ変更（8 箇所）
• uuid.New() / uuid.Parse() / uuid.UUID は標準ライブラリでも同じシグネチャのためそのまま
• internal/shared/uuidv5 パッケージを新規追加（下記参照）

internal/shared/uuidv5 を追加した理由

標準ライブラリの uuid は version 4 / version 7 の生成のみを提供し、名前ベース UUID (version 5, SHA-1) の生成関数を持ちません。deterministicNotificationID が uuid.NewSHA1(uuid.NameSpaceURL, ...) で通知の冪等キーを生成しており、ここだけ標準ライブラリで置き換えられませんでした。

生成される値が変わると既存通知の upsert が重複するため、RFC 9562 §5.5 に沿った実装を internal/shared/uuidv5 に用意し、移行前に github.com/google/uuid が生成していた値を期待値としてテストに固定しています。実装は 20 行程度で、namespace と name の SHA-1 に version/variant ビットを立てるだけです。

確認したこと

• go build ./... / go vet ./... / gofmt -l .（差分なし）/ go test ./... すべて成功
• uuidv5.NewSHA1 が移行前の github.com/google/uuid と同一の UUID を生成することを 5 ケースで確認（version / variant ビット、決定論性、namespace 定数も検証）
• 標準ライブラリの uuid.UUID が pgx v5 の pgtype で UUID 型としてバイナリ・テキスト両フォーマットで正しくラウンドトリップすることを検証済み（[16]byte のため github.com/google/uuid と同じ扱いになります）。GORM のモデル定義は変更不要でした

補足

github.com/google/uuid は github.com/oapi-codegen/runtime が依存しているため、go.mod には indirect 依存として残ります（// indirect へ変化）。生成コード gen/ 自体は uuid を参照していないため、このリポジトリのコードからの直接参照はゼロになりました。

---

Generated by Claude Code