| 1 | # Agent Notes MCP — каталог тулов |
| 2 | |
| 3 | <!-- GENERATED:ToolCatalog START --> |
| 4 | |
| 5 | > Автогенерация из `ToolCatalog.Build()` в репозитории. Не править этот блок вручную. |
| 6 | > |
| 7 | > Обновление: из каталога `agent-notes-mcp` выполнить `dotnet run --project tools/ExportMcpManifest -- --write`. |
| 8 | > |
| 9 | > Тексты совпадают с полем `description` у инструментов MCP; полная схема аргументов — в `inputSchema` (например через `list_tools`). |
| 10 | |
| 11 | ### `memory_health` |
| 12 | |
| 13 | Быстрый health-check памяти: размер hot-context, обязательные секции, предупреждения по бюджету и рекомендации по compaction. Резолв scope: active_scope (если передан) → workspace-scope-map-v1 (по workspace_path) → опционально current: в секции active-scope (легаси) → иначе встроенный fallback (door-to-singularity). |
| 14 | |
| 15 | ### `route_context` |
| 16 | |
| 17 | Подобрать релевантные секции из agent-notes.md по запросу и собрать компактный context-пакет (router-first). Не индексирует файлы knowledge/ — длинные playbook/kb подгружать отдельно через read_knowledge_file (напр. playbook-multi-project-context-v1.md, index-knowledge-router-v1.md). Резолв scope: active_scope (если передан) → workspace-scope-map-v1 (по workspace_path) → опционально current: в секции active-scope (легаси) → иначе встроенный fallback (door-to-singularity). |
| 18 | |
| 19 | ### `write_agent_notes` |
| 20 | |
| 21 | Записать заметки агента (полная замена файла). Путь hot-файла: primary knowledge root из --config → {корень}/agent-notes.md; иначе workspace_path/.cascade-ide/agent-notes.md. ВНИМАНИЕ: перезаписывает файл целиком; для добавления блока без риска стереть остальное используйте append_agent_notes. |
| 22 | |
| 23 | ### `append_agent_notes` |
| 24 | |
| 25 | Добавить блок в конец заметок агента без перезаписи файла. Путь hot-файла: primary knowledge root из --config → {корень}/agent-notes.md; иначе workspace_path/.cascade-ide/agent-notes.md. |
| 26 | |
| 27 | ### `read_agent_notes` |
| 28 | |
| 29 | Прочитать заметки агента. Путь hot-файла: primary knowledge root из --config → {корень}/agent-notes.md; иначе workspace_path/.cascade-ide/agent-notes.md. Возвращает содержимое или пустую строку. |
| 30 | |
| 31 | ### `read_hot_context` |
| 32 | |
| 33 | Прочитать только горячий контекст (L0/L1) без загрузки архивного хвоста. Резолв scope: active_scope (если передан) → workspace-scope-map-v1 (по workspace_path) → опционально current: в секции active-scope (легаси) → иначе встроенный fallback (door-to-singularity). |
| 34 | |
| 35 | ### `upsert_agent_notes_section` |
| 36 | |
| 37 | Точечно вставить/обновить секцию заметок по section_id без полной перезаписи файла. Секция оформляется маркерами <!-- section:ID --> ... <!-- /section:ID -->. Путь hot-файла — как у read_agent_notes. |
| 38 | |
| 39 | ### `list_agent_notes_revisions` |
| 40 | |
| 41 | Список ревизий заметок для rollback. Ревизии хранятся рядом с файлом заметок в подпапке .revisions. |
| 42 | |
| 43 | ### `rollback_agent_notes` |
| 44 | |
| 45 | Откатить заметки к выбранной ревизии (или к последней, если revision_file не задан). Текущее содержимое перед откатом тоже сохраняется как ревизия. |
| 46 | |
| 47 | ### `search_agent_notes` |
| 48 | |
| 49 | Поиск по заметкам с возвратом совпавших строк и номеров строк. |
| 50 | |
| 51 | ### `extract_from_archive` |
| 52 | |
| 53 | Точечное извлечение фактов из архивной ревизии без чтения всего файла. |
| 54 | |
| 55 | ### `compact_hot_context` |
| 56 | |
| 57 | Ужать hot-context: удалить дубли секций, нормализовать формат. По умолчанию preview, apply=true для записи. |
| 58 | |
| 59 | ### `write_knowledge_file` |
| 60 | |
| 61 | Записать файл в каталог knowledge/ (полная замена). Перед записью текущая версия сохраняется в knowledge/.revisions/ (если save_revision=true). Запись только в primary; read-only roots (knowledge_root_id=group) отклоняются. |
| 62 | |
| 63 | ### `append_knowledge_file` |
| 64 | |
| 65 | Добавить блок в конец файла в knowledge/ без перезаписи. Перед добавлением текущая версия сохраняется в knowledge/.revisions/ (если save_revision=true). |
| 66 | |
| 67 | ### `upsert_knowledge_section` |
| 68 | |
| 69 | Вставить или обновить секцию в файле knowledge/ по section_id (маркеры <!-- section:ID --> ... <!-- /section:ID -->). Перед изменением текущая версия сохраняется в knowledge/.revisions/ (если save_revision=true). |
| 70 | |
| 71 | ### `delete_knowledge_file` |
| 72 | |
| 73 | Удалить файл из каталога knowledge/. file_path — относительный путь (без '..'). Если файла нет — NO_CHANGES. |
| 74 | |
| 75 | ### `delete_knowledge_section` |
| 76 | |
| 77 | Удалить секцию из файла knowledge/ по section_id (блок между <!-- section:ID --> и <!-- /section:ID -->). Если секции нет — NO_CHANGES. |
| 78 | |
| 79 | ### `read_knowledge_file` |
| 80 | |
| 81 | Прочитать файл из каталога knowledge/. Корень: knowledge_path, knowledge_root_id (group, …) или primary из --config. Возвращает содержимое или пустую строку. Опционально offset (1-based) и limit. Для протоколов: playbook-multi-project-context-v1.md, index-knowledge-router-v1.md (route_context их не подставляет автоматически). |
| 82 | |
| 83 | ### `list_knowledge_files` |
| 84 | |
| 85 | Список файлов в каталоге knowledge/ (без .revisions). Опционально subdir — подкаталог (например work). Возвращает path, size_bytes, modified_utc. |
| 86 | |
| 87 | <!-- GENERATED:ToolCatalog END --> |
| 88 | |
| 89 | |