55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
# メモリ機構: extract / consolidation 監査ログ
|
|
|
|
## 背景
|
|
|
|
Memory extract と consolidation は、session log / staging / memory / knowledge をまたいで自律的に記録を作成・更新する。動作結果は最終的には `memory/*` / `knowledge/*` と git diff で確認できるが、実行中に何が起きているか、人間が `tail -f` 相当で追える観測面がない。
|
|
|
|
特に consolidation は rewrite / merge / trim / drop を許可するため、あとから最終 diff だけを見るよりも、run lifecycle と memory tool 操作の監査ログがある方が挙動を理解しやすい。
|
|
|
|
## 方針
|
|
|
|
workspace の `.insomnia/memory/_logs/` に append-only な JSONL ログを出す。拡張子は `.log` とし、1 行 1 event で `tail -f` できる形式にする。
|
|
|
|
ログは source of truth ではなく監査・観測用である。正本は従来通り session log、staging、`memory/*`、`knowledge/*`、git diff とする。consolidation の入力や memory 採択判断がこのログに依存する設計にはしない。
|
|
|
|
## 要件
|
|
|
|
- `.insomnia/memory/_logs/` 配下に JSONL `.log` を append する仕組みを追加する。
|
|
- 具体的なローテーション単位は実装で決めてよいが、`tail -f` しやすい最新ログ導線を用意する。
|
|
- 例: 日次 `memory-YYYY-MM-DD.log`、または run 単位 log + `current.log`。
|
|
- extract の lifecycle event を記録する。
|
|
- started / completed / failed
|
|
- run id
|
|
- session id と処理対象 range
|
|
- staging に書いた件数・path / id の概要
|
|
- 取得できる場合は model / usage
|
|
- consolidation の lifecycle event を記録する。
|
|
- started / completed / failed
|
|
- run id
|
|
- consumed staging id list または count
|
|
- 書き込み概要
|
|
- 取得できる場合は model / usage
|
|
- memory / knowledge 専用 write/edit/delete tool の操作を audit event として記録する。
|
|
- `kind`, `slug`, `path`, `op`, `status`
|
|
- 可能なら before / after hash
|
|
- Linter failure も失敗 event として残す
|
|
- ログは通常の LLM context に暗黙注入しない。
|
|
- 人間が `tail -f` するための観測面とする。
|
|
- LLM が読む必要がある場合は通常の tool read 経由にし、history に残る経路を使う。
|
|
- `_staging` とは分離し、consolidation の処理対象にしない。
|
|
|
|
## 完了条件
|
|
|
|
- extract run の開始・終了・失敗が `.insomnia/memory/_logs/*.log` に JSONL で追記される。
|
|
- consolidation run の開始・終了・失敗が同ログに JSONL で追記される。
|
|
- memory / knowledge 専用 tool による write/edit/delete と Linter failure が同ログに JSONL で追記される。
|
|
- 最新ログを `tail -f` する運用手順がドキュメントまたはコメントから分かる。
|
|
- ログが memory / knowledge の正本や consolidation 入力として扱われない。
|
|
|
|
## 範囲外
|
|
|
|
- ログ viewer UI。
|
|
- ログを使った自動 rollback。
|
|
- ログを使った Knowledge 採択 / 整理判定。
|
|
- session-store の正本イベント形式の変更。
|