## purpose - Li+ の webhook / Notifications 取り込み意味論を独立した要求仕様として定義し、前景セッションの通知処理を安定させる。 - 現状の `--consume` 前提で backlog 全体を排水する挙動から、前景一致通知の選択処理と無害な stale 通知の清掃を分離する。 ## premise - Codex と Claude Code が同一の `liplus-language` webhook state を共有し、同じ repository のイベントを並行に扱う場合がある。 - 理想動作は、前景セッションに関係する通知だけを既読化または消費し、関係のない通知は残すこと。 - ただし前景外でも、Discussion への外部コメントなど重要な通知は例外的に会話へ出してよい。 - さらに、誰も処理する必要がないと判断できる stale な成功通知や重複通知は、前景一致しなくても清掃できるとよい。 - 将来的には受動受信への移行を見込むため、通知意味論は現在の polling 実装に閉じない方がよい。 ## constraints - `inspect` `claim` `ack/read` `consume/done` `mention` `cleanup` を別概念として定義する。 - GitHub Notifications API を理想系として扱いつつ、classic PAT 制約と local webhook fallback の両方を視野に入れる。 - 共有 queue で一方の AI が他方の前景通知を勝手に排水しないことを最優先にする。 - 関連性判断は可能な限り機械的にし、判断不能時の既定は「黙る・残す」に倒す。 - 新レイヤーは `docs/` の numbered requirements spec として正本化し、既存の operations / adapter の通知記述を整理できる形にする。
