44 lines
3.9 KiB
Markdown
44 lines
3.9 KiB
Markdown
---
|
||
title: Runbooks — каталог сущностей mappa
|
||
summary: Каталог сущностей mappa (тип → тулы → runbook). Единая карта «что существует и как с этим работать» для агента. Обновлять при добавлении новых типов. Источник: brainstorm:173.
|
||
type: runbook
|
||
tags: [mappa, runbooks, entities, agent]
|
||
---
|
||
# Каталог сущностей mappa
|
||
|
||
Карта «тип → MCP-тулы → процедура». Runbook — агентский слой «как сделать X» (по запросу). Справочные описания тулов — в MCP-поверхности/docs; здесь маршрутизация.
|
||
|
||
## Основные (есть runbook)
|
||
| Тип | Что это | Тул-поверхность | Процедура |
|
||
|---|---|---|---|
|
||
| task | таска на доске | task_list/get/create/update/close, comment_* | [[runbooks/tasks]] |
|
||
| wiki | страница вики (project/shared/private) | wiki_get/search/create/update, entity_* | [[runbooks/wiki]] |
|
||
| inbox | почта проекта | inbox_monitor/send/mark_read | [[runbooks/inbox]] |
|
||
| session/handoff | сессии live-ingest, handoff | session_*, handoff_write | [[runbooks/session]] |
|
||
| поиск/граф | найти/связать | search/entity_search/wiki_search, graph_* | [[runbooks/search]] |
|
||
|
||
## Остальные типы (справка: MCP-описания + docs; наполнение runbooks — post-pilot, task:2071)
|
||
| Тип | Тул-поверхность | Цикл |
|
||
|---|---|---|
|
||
| brainstorm | brainstorm_create/update/promote | шторм-буфер → промоут (wiki+archive) |
|
||
| issue | issue_create/get/list/update, mark_duplicate, add_addresses | репорт bug/feature/question/incident |
|
||
| requirements | requirements_create/get/list/update/add_addresses | спека-контракт «что должно быть» (status: draft→approved→implemented→verified) |
|
||
| plan | plan_create/get/list/update/add_addresses | этапы/фазы планирования |
|
||
| comment | comment_create/list | короткий след на таске (Г2: не носитель вердиктов) |
|
||
| tag | tag_create/list/get/apply | метки, scope=project |
|
||
| attachment | attachment_create/get/list/delete | вложения (url/blob) к task/wiki/brainstorm/session |
|
||
| release | release_create/list/get/close | версии + fixed_in-рёбра (деплой-гейт через .admin) |
|
||
| agent/operator | agent_*, operator_* | реестры субъектов |
|
||
| repo/commit | git_index_* | git-индекс (поиск кода через mappa, волна brainstorm:171) |
|
||
| project | projects_list/register/resolve/create_repo/owners | реестр проектов (канон = папка) |
|
||
| skill | skill_list/get/create/update/delete | каталог скилов сервера |
|
||
| entity-слой | entity_get/search/move/versions/diff/restore/transform | общий слой сущностей |
|
||
| sched/telemetry | scheduler_*, telemetry_* | расписания, метрики (зона админа) |
|
||
|
||
## Правила каталога
|
||
- Каталог — единая карта. **При добавлении нового типа сущности** (напр. requirements/plan 2026-08-28) — расширение этого каталога обязательным шагом в постановке серверной таски (конвенция).
|
||
- Slug'и: `runbooks/<тип>` (kebab, латиница).
|
||
- Связь: [[canon/index]] (гейты) · [[canon/gates]] · [[docs/index]] (wiki:3341, ответы человеку) · [[mappa-wiki-topology]] (wiki:3378)
|
||
|
||
## Связано
|
||
[[canon/index]] · [[canon/gates]] · [[runbooks/tasks]] · [[runbooks/wiki]] · [[runbooks/inbox]] · [[runbooks/session]] · [[runbooks/search]] · brainstorm:173 · requirements:23 |