memory-export

name	memory-export
description	ユーザーレベル長期記憶 (ulm) の中身を JSONL 控えとしてエクスポート（バックアップ/別マシンへの移行/git 差分追跡）する。ユーザーが「記憶をバックアップ/エクスポート/控えを取りたい/別の環境へ移したい/同期したい」と言ったとき、または危険な一括操作（大量削除・reindex・スキーマ移行）の前に控えを取りたいときに使う。復元は import。
allowed-tools	Bash(node:*)

memory-export — 長期記憶を JSONL 控えにエクスポート/復元する

ユーザーレベル長期記憶 (ulm) の DB を、安定した順序の JSONL 控えに書き出すスキル。 DB が正本、JSONL は受動的なミラー（差分を git で追える形）。

なぜ必要か

• 本体は ~/.claude/user-memory/memory.db（SQLite）。SessionEnd フックが ulm export --quiet を 自動実行しているので、通常は控えが勝手に更新される。
• だが「今すぐ控えを取りたい」「別マシンへ移したい」「危険な一括操作の前に保全したい」 「記憶の変化を git で差分追跡したい」ときは、明示的に export する。

いつ使うか

• ユーザーが「記憶をバックアップ / エクスポート / 控え / 別環境へ移行 / 同期」と言ったとき
• 大量削除・reindex・スキーマ移行・モデル変更など、戻せない操作をする前
• 別マシン/別アカウントへ記憶を持っていきたいとき（export → 転送 → import）

やり方（エクスポート）

CLI は ${CLAUDE_PLUGIN_ROOT}/bin/ulm.js。

node "${CLAUDE_PLUGIN_ROOT}/bin/ulm.js" export

• 出力先は固定で $ULM_HOME/export/（既定 ~/.claude/user-memory/export/）。出力先指定オプションは無い。
• 書き出されるファイル:
  • observations.jsonl / states.jsonl / candidates.jsonl / refs.jsonl（公開分）
  • observations.secret.jsonl / states.secret.jsonl（機密分・別ファイル）
  • meta.json（スキーマ版・統計・エクスポート時刻）
  • .gitignore（secret ファイルを除外するよう自動生成）
• スクリプトや自動処理では --quiet でファイル一覧を抑制。
• 実行後に ⚠ … 機密の疑い … 警告が出たら、その観測を obs secret <id> で secret 化してから再 export する。

やり方（復元/移行）

別マシンや復旧時は、export ディレクトリを渡して取り込む:

node "${CLAUDE_PLUGIN_ROOT}/bin/ulm.js" import <export-dir>

• 既存 ID は INSERT OR IGNORE でスキップ（重複は安全に無視）。
• 不正 id / 長すぎる本文 / 不正 status / 壊れた JSON 行は可視的にスキップ（件数を表示）するので、出力の スキップ 行を確認する。
• 取り込んだ行は取込時ゲートで機密を再判定し secret 化される。source 表示で出自を区別できる。

セキュリティ（最重要）

• *.secret.jsonl は機密そのもの。自動生成の .gitignore で除外されるが、export ディレクトリを別の場所へコピー/転送/共有するときは secret ファイルを絶対に含めない（git に add しない・クラウドに上げない）。
• 出力先 $ULM_HOME/export/ は既定でリポジトリ外（~/.claude 配下）。ULM_HOME をリポジトリ内に向けている場合は、secret ファイルがコミットされないか必ず確認する。
• 機密の疑い警告は「取りこぼし前提の多層防御」の一環。無視せず対応する。
• 別マシンへ移すときは、転送経路（USB/クラウド/scp 等）でも secret ファイルの扱いに注意する。

実行後

エクスポート先のパスと、警告が出たかどうかを簡潔に伝える。機密分が含まれることと、その取り扱い注意を必ず添える。