feat(hpi): 端末のコマンド履歴 (atuin) を取り込む

[gapul]

「ターミナルでやってたことも記録できるか」という話ですが、既に記録されていました。 atuin が入っていて、ローカルの SQLite に 3,915 コマンド（2026-06-18 以降）溜まっています。

atuin は既定で同期オフ・ローカル書き込みのみなので、記録そのものは最初から自前です。足りていなかったのは HPI から引く口だけでした。#397 の activitywatch.py と同じく上流にモジュールが無いので自作します。

なお ~/.zsh_history は存在しませんでした。atuin が唯一の履歴です。

何が取れるか

timestamp / duration / exit / command / cwd / session / hostname。作業ディレクトリと終了コードまで入っているのが効きます。

$ hpi doctor my.atuin
✅ OK  : my.atuin
   commands: 3915  (2026-06-18 → 2026-08-21)
   failed:   1126

よく打っているもの: claude 1012 / yazi 467 / brew 393 / cd 279 / ssh 206 / ls 149。

ActivityWatch との補完関係

両者は見ている層が違います。ActivityWatch は「Ghostty が前面にあった」までしか分からず、atuin は端末の中しか見ません。両方あって初めて時刻から作業が復元できます。

横断が実際に動くことを確認しました。

最後のコマンド: 2026-08-21T01:24:31 | ssh seebeck@raspberrypi.local
  その前後3分に前面だったアプリ: [('Ghostty', 80), ('System Settings', 2)]

これが HPI を入れた本来の目的です。ソースごとにバラバラだったものが1つの Python の面から引ける。

実装メモ

exit が -1 の行は「打った時点で行ができて、終わりを見ていない」ものです。実データで 3,915 中 1,313 と3分の1を占めていて、多くは claude や ssh のような長い対話セッションを閉じたケースでした。finished プロパティで判別し、failed() からは除いています。単純に exit != 0 で数えると1300件が偽の失敗になります。

hostname は MacBook-Mini:gapul の形で user がくっついているので分割しました。

稼働中の WAL を取りこぼさないよう sqlite_copy_and_open を使うのは activitywatch.py と同じです。

記録の層について

参考までに、この環境の記録は今こうなっています。

層	道具	HPI から
打鍵そのもの	keystats	まだ
端末のコマンド	atuin	この PR
前面のアプリ・ウィンドウ	ActivityWatch	#397
ブラウザのタブ	ActivityWatch	#397
位置	Dawarich	まだ
音楽	ListenBrainz	まだ

端末の出力まで残したいなら asciinema のような別の道具になりますが、それは記録というより録画なので、必要になってからでいいと思います。