Revision

Текст документа целиком, его папка, version (нужна для edit_document) и связи: links — куда ссылается [[…]], backlinks — кто ссылается сюда.

Здоровье проекта: статус, метрики и сработавшие правила с готовыми формулировками. Пересказывай их, но не придумывай свой статус и числа.

Участники проекта и их роли

Счётчики задач проекта по статусам и число просроченных

Карточка задачи по ключу (REP-42): описание, последние комментарии, решения, коммиты и mentioned_in — документы и решения, которые на неё ссылаются

История изменений задачи: смены статуса, переносы срока, правки полей

Привязать коммиты к задачам — задача покажет, каким кодом её сделали. Задача берётся из строки «Revision: RV-42» в сообщении коммита или из keys. Коммиты возьми сам: git log --format='%H%x1f%an%x1f%aI%x1f%B%x1e'; repository — git remote get-url origin. Вызывай после коммита по задаче; повтор безопасен. С files ответ назовёт решения и заметки, чей код коммит поменял (code_changed).

Все решения проекта списком: id, название, статус, дата — полный, а не выдача поиска. По умолчанию действующие (принятые и предложенные); status — accepted, proposed, revoked (отменены), superseded (заменены), all. contains — слово в названии. Суть и причина — get_decision.

Оглавление документов проекта: названия по папкам. Открыть — get_document по названию. folder — только эта папка. По словам — search_knowledge.

Задачи текущего пользователя по разделу: active, today, upcoming, overdue, high_priority, blocked, waiting, completed

Проекты, к которым есть доступ: id, название, ключ задач и ссылка на проект.

Перевести ссылку [[from]] на [[to]] сразу во всех документах и решениях проекта; to пусто — ссылка станет обычным текстом. Подпись и #раздел сохраняются, код не трогается. Каждый документ получает версию с причиной why. Один вызов на цель — вместо edit_document по каждому документу.

Записать в память проекта то, что стало ясно по ходу работы: принятое решение (kind=decision), найденную причину сбоя (debugging), повторяемый приём (pattern) или наблюдение (observation). Записывается сразу, без подтверждения. Вызывай в момент, когда понял, а не в конце работы. В body ссылайся на связанное: [[Название]] документа или решения, [[KEY-42]] задачи. Заголовок — утверждение, а не тема: «Выкладка через rsync, а не Git», не «Деплой». Если в проекте уже есть папка по теме (list_documents), клади заметку туда через folder. Решение сверяется с принятыми: если сервер вернул similar_decisions, повтори с supersedes (новое заменяет старое) или checked=true (это о другом).

Поиск по знаниям: тексты задач, комментарии, документы и решения проекта. Используй для вопросов «почему», «как решили», «что обсуждали».

Список задач по структурным признакам: статус, ожидание. Используй для вопросов «что в работе», «что заблокировано».

Сменить статус решения без нового решения: revoked — отменили и замены нет («функцию убрали»), proposed — вернуть в обсуждение, accepted — принять. why обязателен, он допишется в решение. Новое решение вместо старого — не здесь, а remember с supersedes.

Предложить изменение задачи: заголовок, описание, приоритет, срок, статус, ответственный, исполнители, наблюдатели, метки, оценка, ожидание. Людей, статусы и метки называй именами — идентификаторы не нужны; присылай только то, что меняешь: пустое значение ничего не стирает, для стирания есть clear. если имя подойдёт нескольким, инструмент вернёт варианты, переспроси. Если задача ждёт чего-то внешнего (доступа, ключа, ответа) — ставь is_waiting и waiting_reason, а НЕ пиши это в описание: у ожидания свой раздел в «Моей работе». Если задачу держит другая задача — используй add_dependency_draft.

Что изменилось в проектах с прошлого визита: новые и принятые решения, созданные, закрытые и сдвинутые задачи, правленые документы, кто пришёл и ушёл из проекта. Вызывай в начале работы, до того как опираться на то, что помнишь. Без since считает от прошлого визита этого подключения. Кратко: до 10 в группе, перенесённое из файлов — числом; kind — вся группа, detail — с причинами.