2.5 KiB
2.5 KiB
title: Runbook — session
summary: Сессии и handoff в mappa: live-ingest (session_upsert/heartbeat), ритуал старта (orient: pull → handoff → inbox → liveness), ритуал финиша (closing: handoff-write). Источник: brainstorm:173.
type: runbook
tags: [mappa, runbook, session, handoff, agent]
Runbook: session / handoff
Ритуал старта сессии (orient)
- Pull before work:
git pull --ff-only(никогда auto-merge/rebase/stash; грязное дерево → скип одной строкой). - Handoff-чтение: последняя handoff-сущность проекта (
entity_search type=handoff) → summary/open_treks/ask_user/guards → «предыдущая сессия предложила X — делаем?» → ждать человека (не авто-исполнять). - Инбокс: inbox_monitor → обработать письма (Г2); письма в начале ближайшего хода.
- Liveness: «alive/dead» одной строкой; deep-диагностика — вне ритуала (человеку/диагностической сессии).
- Welcome-снапшот — по запросу, НЕ авто на первом ходу.
Live-ingest (телесные хуки)
- Сессия = сущность (session:N):
session_upsert(sourceRef, project, runtime, machine, folder)— create/update;session_heartbeat(id, working_on)— пульс; action=finalize → clean-завершение. - Claim-гейт (repo,branch):
session_hold(repo, branch)— свободно → работай; чужой клейм → НИЧЕГО не делать, сообщить человеку «кто держит», ждать (ревок — только оператор). - Stale-active (обрыв) → crash-detect: сказать человеку, предложить (игнор/напоминание письмом/продолжить).
Ритуал финиша (closing)
handoff_write(project, session_id, status, summary, open_treks, ask_user, guards, recent_commits)— по решению человека (не авто-sweep).- PROPOSE wiki-ingest (важное знание → вики) + PROPOSE закрытия тасок. Мутации — после подтверждения.
Связано
runbooks/index · runbooks/inbox · runbooks/tasks · canon/gates · контракт wiki:2660 · concepts/session-live-ingest (wiki:2604) · brainstorm:173