meta(tasks): number 19 legacy files to v2 + restore 0 blocks

.tasks/2026-08-10-00942-session-inbox-monitor-pi-extension.md

@@ -0,0 +1,56 @@
+# session-inbox-monitor-pi-extension — working context
+
+**Status:** 🟢 done (shipped 2026-08-10, scoped-fix same day) — pi-native inbox delivery shipped for ALL pi sessions, see STATUS.md block.
+**Owner:** vitya (pi interactive session, .admin)
+**Notify:** OpeItcLoc03/claude-skills
+
+Pi (pi-coding-agent) не покрывался скилом: Monitor tool — CC-only, хуки CC-only.
+Собран pi-native аналог.
+
+## Решения
+
+1. **Session-scoped, только свой инбокс.** Расширение смотрит только
+   `<ctx.cwd>/.claude-inbox/` — инбокс СВОЕГО проекта. Чужие инбоксы НЕ читает
+   (правило vitya: «ты другие инбоксы читать не имеешь права. Только в своей
+   директории»). Установлено глобально (`~/.pi/agent/extensions/`) — каждый pi
+   имеет capability, но каждый трогает только свой. ПЕРВАЯ версия (глобальный
+   скан всех инбоксов + `PI_INBOX_ROOTS`) — отменена в тот же день: противоречит
+   правилу. Переписана на session-scoped, decoy-тест (чужой инбокс не тронут) PASS.
+2. **Два пути доставки** (контракт как у CC-хуков):
+   - PUSH: poll-интервал 15s по своему инбоксу (интерактив только).
+   - PULL: `agent_settled` sweep — pi-эквивалент Stop-хука.
+   - Dedup per-process по filename; move в `.read/` — кросс-процессный
+     guard: кто первый swept — тот и забрал (CC hook или pi), второй пропускает.
+3. **Headless (`pi -p`, `ctx.hasUI === false`) — НИКАКОЙ доставки.** Ни watcher,
+   ни sweep. Сообщения ждут интерактивную сессию. Зеркалит CC-headless (там
+   внешний Notify/ntfy, не инжект в ран) + не угоняет one-shot прогоны и не
+   съедает сообщения без обработки.
+4. **Доставка:** `pi.sendUserMessage(body, { deliverAs: "followUp", triggerTurn:
+   true })` — заголовок `[inbox] <имя-файла>` + тело инлайн, потом move в
+   `.read/`. Пустые файлы (частичная запись) пропускаются и ретраятся.
+5. **Source of truth:** `.common/lib/pi-extensions/inbox-monitor.ts` (Node
+   built-ins only, без npm deps — авто-дискавери без package.json). Деплой:
+   копия в `~/.pi/agent/extensions/inbox-monitor.ts` (global → все pi, все
+   директории). Hot-reload `/reload`. Тест: `inbox-monitor.test.mjs`
+   (`node --experimental-strip-types`, Node ≥22.6).
+
+## Verified
+
+- Функциональный тест 3 блоков (interactive-own-inbox + decoy-чужой-инбокс,
+  headless-no-delivery, no-inbox-silent) — ALL TESTS PASSED.
+- Нет зависания процесса: headless не стартует интервал; интерактив чистит
+  интервал в `session_shutdown` (timeout-прогон EXITED CLEANLY).
+- Деплой: diff source↔`~/.pi/agent/extensions/` = 0 (byte-identical).
+
+## Open questions / failure modes
+
+- **Кросс-харнессный двойной пикап:** CC и pi оба свипят — `.read/` move делает
+  first-wins, не double-processing. Два pi-процесса на одной машине гонятся как
+  две CC-сессии (known limitation, см. SKILL.md).
+- **Межпроектные сообщения:** письмо, брошенное в инбокс проекта X, доставится
+  только pi/CC-сессии проекта X. Если активной сессии X нет — письмо ждёт в
+  инбоксе (это by design, не баг).
+- **Проверка живого pi-лоада** (что авто-дискавери подхватил расширение в
+  реальном TUI) — за `/reload` при следующей интерактивной pi-сессии.
+- **Headless-доставка не реализована** (сознательно): при необходимости —
+  внешний Notify/ntfy, отдельная задача.