71 lines
2.9 KiB
Markdown
71 lines
2.9 KiB
Markdown
# Notification 用語のリネーム
|
||
|
||
## 背景
|
||
|
||
Pod 周辺に二系統の「notification」があり、用語が衝突して読みづらい:
|
||
|
||
- **outbound** (Pod → Client): `Event::Notification` / `Notifier::notify` — ユーザー向けの運用診断（compaction 失敗、tool 出力 truncated 等）
|
||
- **inbound** (External → Pod): `Method::Notify` / `NotificationBuffer` — 外部から Pod の LLM context に「メモを置く」経路
|
||
|
||
両者とも `Notification` / `Notify` を共有しており、コードを読む側が毎回どちらの経路かを文脈から判別する必要がある。
|
||
|
||
`Method::Notify` の動詞名は「呼び出し側がやる行為」として意味的に正しいので残し、**outbound 側の名詞**を `Alert` に倒して非対称を入れることで区別する。
|
||
|
||
## 要件
|
||
|
||
### outbound (Pod → Client) — `Alert` にリネーム
|
||
|
||
protocol:
|
||
|
||
- `Event::Notification(Notification)` → `Event::Alert(Alert)`
|
||
- `protocol::Notification` 構造体 → `protocol::Alert`
|
||
- `NotificationLevel` → `AlertLevel`
|
||
- `NotificationSource` → `AlertSource`
|
||
|
||
pod:
|
||
|
||
- `crates/pod/src/ipc/notifier.rs` → `alerter.rs`
|
||
- `Notifier` → `Alerter`
|
||
- `Notifier::notify(...)` → `Alerter::alert(...)`
|
||
- `Notifier::subscribe_with_snapshot()` の戻り値 `Vec<Notification>` → `Vec<Alert>`
|
||
|
||
tui:
|
||
|
||
- `Block::Notification` → `Block::Alert`（描画スタイルは変更しない）
|
||
|
||
### inbound (External → Pod) — `Notify` 据置 + 衛生整理
|
||
|
||
- `Method::Notify` 据置（動詞として正しい）
|
||
- `NotificationBuffer` → `NotifyBuffer`（メソッド名と揃える）
|
||
- `PendingNotification` → `PendingNotify`
|
||
- `notify_wrapper` プロンプト名 据置
|
||
- LLM 向け wrapper ラベル `[Notification]` 据置（LLM への見え方は変えない）
|
||
|
||
### protocol wire 互換
|
||
|
||
開発初期段階のため wire 互換は意図的に切る。client / pod を同時更新する前提で、旧名を吸収する `#[serde(rename)]` 等は入れない。
|
||
|
||
## 範囲外
|
||
|
||
- 通知の content / level / source の意味論変更（純粋な rename のみ）
|
||
- `Notifier` / `NotificationBuffer` の buffer 容量や snapshot 挙動の変更
|
||
- TUI 側 `Block::Alert` の描画スタイルの変更
|
||
|
||
## 完了条件
|
||
|
||
- 上記 rename がすべて反映されている
|
||
- ビルドが通り、既存テストが通る
|
||
- grep で旧名（outbound 文脈の `Notification` / `Notifier` / 動詞 `notify`）が消えている
|
||
|
||
## 参照
|
||
|
||
- `crates/protocol/src/lib.rs`（`Event::Notification`, `Notification` struct, `NotificationLevel/Source`）
|
||
- `crates/pod/src/ipc/notifier.rs`（outbound、`Notifier`）
|
||
- `crates/pod/src/ipc/notification_buffer.rs`（inbound、`NotificationBuffer`, `PendingNotification`）
|
||
- `crates/tui/`（`Block::Notification` 描画）
|
||
|
||
## Review
|
||
- 状態: Approve with follow-up
|
||
- レビュー詳細: [./notification-naming-cleanup.review.md](./notification-naming-cleanup.review.md)
|
||
- 日付: 2026-04-26
|