feat: 個人の記録を複数端末で同期できるようにする

[gapul]

「Claude のセッションも複数端末で同期したい。コンフリクト起きるかな？」に対する答えです。

起きるものと起きないものがあって、扱いを分ける必要がありました。

競合の分類

記録の実体は2種類に分かれます。

	例	そのまま同期して
1ファイル1書き手	Claude の projects/<uuid>.jsonl	平気	セッションごとに別ファイル、書くのはそれを走らせた端末だけ、追記のみ
1ファイル複数書き手	Claude の history.jsonl、nvim の keystrokes.jsonl	必ず衝突	どの端末も同じパスに追記する。Syncthing なら sync-conflict-* が生える

後者を素直に同期する方法はありません。追記位置が競合するので、マージも自動ではできません。

なので同期するのは元ファイルではなく写しにします。personal-history/<ホスト名>/ を掘って、各端末は自分の名前のディレクトリしか書かない。こうすると構造として競合が起きません。ActivityWatch の aw-sync が採っているのと同じ考え方です（あちらも「自分が作ったバケットしか書かない」という規約で競合解決を回避しています）。

読む側は personal-history/*/claude/history.jsonl のようにグロブで拾えば、全端末ぶんが1つの列になります。HPI の get_files がグロブを受けるので、config.py の書き換えは1回で済み、端末が増えても触りません。

atuin だけ別扱い

シェル履歴はファイル同期しません。atuin 本体に同期機構があり、レコード単位の追記型で、しかもクライアント側で暗号化してから送ります。SQLite の写しを配るより明確に筋がいいです。

services.atuin を homeserver に立てます（shell.gapul.net、tailnet 内のみ）。

注意点として database.createLocally が既定 true なので、この箱に初めてネイティブの PostgreSQL が1つ生えます（今までの postgres は全部コンテナ側でした）。UNIX ソケット越しなのでポートは開きません。

openRegistration は false のままにしてあります。アカウントを作るときだけ一時的に true にして atuin register し、済んだら戻す運用です。開けっ放しだと tailnet 内の誰でもアカウントを作れます。

副産物: バックアップの穴が埋まる

前に指摘した「Claude の history.jsonl がどこにもバックアップされていない」問題が、これで片付きます。~/Sync/syncthing は restic の対象なので、書き出した時点でバックアップにも乗ります。12,777 件の「自分が何を考えて何を頼んだか」は再現できない記録なので、これは効きます。

検証（実機）

• keystats.db（3.9MB、WAL 3.3MB）と ActivityWatch（250MB）の .backup が一貫した写しを作る。写した側から event 1,152,774 件が読める
• history.jsonl のコピーが 12,777 行取れる
• rsync のフィルタが .jsonl だけを拾う（587ファイル、1.2GB）
• homeConfigurations.gapul に personal-history-snapshot エージェントが入る

サイズについて

Claude のセッション本体が 1.2GB あります。初回の同期はそれなりに重いです。以降は追記のみなので rsync の差分は小さくなります。

iPhone には配っていません。Syncthing のフォルダは母艦とだけ共有しています。

デプロイ後の手作業

1. homeserver を rebuild して、openRegistration を一時的に true にし atuin register、済んだら戻す
2. 各端末で atuin login して atuin sync
3. Syncthing の GUI で personal-history フォルダを母艦側でも受け入れる

やっていないこと

nvim の keystrokes.jsonl は同期対象に入れましたが、時刻が vim.uv.hrtime() の単調時計（起動からの経過ナノ秒）なので、他のソースとの時系列突き合わせには使えません。集めておく価値はありますが、繋ぐには上流に実時刻を足してもらう必要があります。