aidemd-mcp/server

Инструмент для обращения к брейн-системе по требованию. Вызывай, когда нужно получить доступ к брейн-системе в середине задачи — НЕ вызывай его при каждом запуске /aide. Состояние брейн-системы при загрузке уже сообщается через aide_info.brain.status; вызов aide_brain при загрузке дублирует эту работу без необходимости. Необязательный параметр `kind` — замкнутый словарь из двух значений: "orientation" (по умолчанию) или "config". - "orientation" — возвращает раздел ориентации: краткую сводку времени выполнения, когда агент обращается к брейн-системе в середине задачи. Если не указать kind, это равносильно передаче "orientation". - "config" — возвращает схему интеграции, используемую /aide:brain config для прохождения настройки брейн-системы. Разделы, установленные при инициализации (playbookIndex, studyPlaybook, updatePlaybook, researchIndex), НЕ возвращаются через этот инструмент — агенты получают к ним доступ через инструмент чтения брейн-системы к файлам на диске. Форма ответа: `{ status, instructions }` — ровно два поля. Никаких `backend`, `connector`, `name`, `kind`. status — отражает размеченное объединение BrainState из buildBrainState. Словарь из четырёх состояний: ok, no-brain-aide, no-mcp-entry, mcp-drift. Принимай решение только по status — других дискриминантов нет. instructions — всегда непустое значение для любой ветки. Используй это поле напрямую: - Для ok: точные байты выбранного раздела из файла .aide/config/brain.aide на хосте, побайтово идентичные тому, что пользователь написал между маркерами этого раздела. Без обрезки, без нормализации, без подстановки ${...}. Выбранный раздел вступает в силу — инструмент больше не играет роли. - Для no-brain-aide: фиксированный текст с инструкцией пользователю выполнить npx @aidemd-mcp/server@latest init. Не продолжай так, будто брейн-система доступна. - Для no-mcp-entry: фиксированный текст с инструкцией пользователю выполнить npx @aidemd-mcp/server@latest sync и перезапустить Claude Code. Не продолжай так, будто брейн-система доступна. - Для mcp-drift: фиксированный текст с инструкцией пользователю выполнить…

Сканирует файлы спецификаций .aide в этом проекте. Возвращает древовидную карту расположения спецификаций, следуя принципу прогрессивного раскрытия. Без пути: возвращает облегчённую карту всего проекта — только местоположения и типы файлов, без содержимого. Используйте её один раз, чтобы понять архитектуру спецификаций проекта. С путём: ответ начинается с цепочки предков — каскадной линии намерений от корня проекта до целевой директории, где каждый предок показывает своё описание и статус согласованности (aligned/misaligned, если задано). Цепочка предков даёт полный унаследованный контекст до чтения тела спецификации. После цепочки предков следует детализированное поддерево целевой директории — выдержки из содержимого файлов и предупреждения об аномалиях. Используйте это, чтобы погрузиться в интересующую вас область. Файлы .aide — это спецификации с прогрессивным раскрытием, которые находятся рядом с кодом оркестратора. Они содержат намерение (стратегия, контракты реализации, антипаттерны), исследования (источники, данные, паттерны) или контрольные списки QA (todo). Читайте файлы .aide ДО чтения кода — они являются слоем контекста между структурой папок и деталями реализации. Типы файлов (.aide, intent.aide, research.aide, plan.aide, todo.aide): - .aide — Спецификация намерения (по умолчанию). Стратегия, контракты, антипаттерны. - intent.aide — То же, что и .aide, используется только если в той же папке есть research.aide. - research.aide — Сырое исследование. Источники, точки данных, синтез паттернов. - plan.aide — План реализации архитектора. Пункты с флажками для исполнителя. - todo.aide — Документ повторной синхронизации QA. Фиксирует, где реализация отошла от намерения. Никогда не размещайте одновременно .aide и intent.aide в одной папке.

Докладчик времени загрузки, вызываемый оркестратором при запуске. Возвращает два независимых поля верхнего уровня, по которым оркестратор должен выполнить ветвление по отдельности: `outdated` (массив устаревших ключей артефактов) - мягкое уведомление. Сравнивает .aide/versions.json хоста с каноническим манифестом, поставляемым с этим npm-пакетом. Каждый элемент называет ключ артефакта, который отстаёт. Пустой массив означает, что всё актуально. Отсутствующий .aide/versions.json (старая установка, предшествующая отслеживанию версий) молча сводится к []. Устаревание носит информационный характер - оркестратор продолжает работу с уведомлением пользователя. `brain` (состояние предусловия) - жёсткий шлюз. Сообщает, подключена ли и согласована ли запись MCP мозга хоста. Формат: { status, name?, hints }. Оркестратор должен остановиться и направить пользователя на устранение проблемы перед продолжением, если status не равен 'ok'. Валидация путей не выполняется - пакет никогда не проверяет ни одну директорию на диске; состояние выводится полностью из сравнения .aide/config/brain.aide с .mcp.json. Четыре значения brain.status: - ok - .aide/config/brain.aide существует, и запись brain в .mcp.json хоста совпадает с разобранным mcpServerConfig. name - объявленная пользователем описательная метка из brain.aide. Конвейер может продолжаться. - no-brain-aide - .aide/config/brain.aide отсутствует или не поддаётся разбору. Поле name отсутствует. Исправление: запустить /aide и пройти интервью по настройке мозга. - no-mcp-entry - brain.aide успешно разобран, но .mcp.json хоста отсутствует, повреждён или не содержит ключа mcpServers.brain. name присутствует. Исправление: запустить npx @aidemd-mcp/server@latest sync. - mcp-drift - brain.aide и .mcp.json существуют, но их записи brain расходятся в command или args. name присутствует. Исправление: запустить npx @aidemd-mcp/server@latest sync. hints всегда присутствует при любом статусе - массив кандидатов корневых путей мозга, которые оркестратор может показывать во время восстановления. Параметры не требуются - использует серверную…

Развёртывает среду разработки AIDE в проекте. Возвращает структурированный JSON для использования агентом — не в виде текстового описания. Инструмент использует схему с двумя вызовами для постепенного раскрытия информации: Первый вызов (без параметра `category`): Возвращает облегчённую сводку — каждый шаг с полями name, status (would-create/would-overwrite/would-skip/exists), category и filePath, но БЕЗ ПОЛЕЙ content. Также возвращает brainHints (кандидаты в корень brain) и обнаруженный framework. Используйте это, чтобы понять, что нужно сделать и для каких категорий требуются запросы к пользователю. Второй вызов (с параметром `category`): Инструмент сам записывает на диск все файлы со статусом would-create И одобренные would-overwrite и возвращает манифест — шаги с filePath, status (created, overwritten или exists) и name, но БЕЗ content. Шаги со статусом would-skip остаются would-skip в манифесте (инструмент для них ничего не записывает). Агент никогда не видит содержимое файлов и не использует инструмент Write для новых файлов. Исключение — шаги MCP: Для шагов MCP манифест содержит данные prescription (имя ключа и объект записи), чтобы агент мог прочитать существующую конфигурацию, объединить и записать. Инструмент никогда не трогает конфигурацию MCP напрямую. Исключение — категория brain: При вызове с category=brain также передайте brainPath с подтверждённым пользователем корневым путём brain. Инструмент сам создаёт каркасные директории корня brain. Исключение — шаги IDE VS Code: Шаги IDE, которым нужно внешнее средство (CLI VS Code), возвращают инструкции для выполнения агентом, поскольку это не простые записи файлов. Логика ветвления агента — silent-on-create, prompt-on-overwrite: После первого вызова пройдите по категориям, используя это правило: - Pure-create category (все шаги — would-create, would-skip или exists): применяйте бесшумно, сразу вызывая с category=X — без AskUserQuestion. Категория, в которой нечего перезаписывать на диске, не даёт пользователю возможности принять решение. - Overwrite-bearing category (любой шаг — …

Возвращает JSDoc, сигнатуру и kind для именованного символа без открытия полного файла: прогрессивное раскрытие кода уровня 2. Когда агенту известно имя функции из списка импортов или файла оркестратора, он вызывает inspect, чтобы узнать, что делает символ, что он принимает и что возвращает, основываясь только на его контракте. Ищет по исходным файлам TypeScript и JavaScript (ts, tsx, js, jsx, mjs, cjs). Использует необязательный параметр file для сужения поиска до одного файла, если местоположение уже известно.

Читает файл спецификации .aide с полным контекстом. Возвращает содержимое файла, его классифицированный тип (intent/research/plan/todo), связанные спецификации в той же директории и ссылки, найденные в содержимом (относительные пути, встроенные ссылки, URL). Используйте этот инструмент после aide_discover для углублённого изучения конкретной спецификации.

Создаёт новые .aide spec-файлы с автоматическим применением правил именования. Правила именования: intent-спеки по умолчанию имеют расширение .aide, но переименовываются в intent.aide при наличии research.aide в той же папке. Создание research.aide автоматически переименовывает любой существующий .aide-файл в intent.aide. Типы: - intent — Стратегия, контракты, анти-паттерны - research — Источники, данные, паттерны (запускает переименование существующих .aide-файлов) - both — Создаёт пару research.aide + intent.aide - todo — Документ QA-перенастройки для агентов контроля качества - plan — План реализации архитектора (не взаимодействует с intent/research по именованию)

Сравнивает артефакты методологии AIDE в этом проекте с каноническими версиями и возвращает структурированные JSON-результаты, сгруппированные по категориям. Используйте этот инструмент, когда пользователь просит обновить AIDE, синхронизировать AIDE, обновить AIDE, проверить обновления AIDE или привести AIDE в актуальное состояние. ЭТО НЕ ДЛЯ редактирования пользовательских .aide-спецификаций — он проверяет только инфраструктуру методологии. Инструмент использует двухшаговый паттерн для постепенного раскрытия информации: Первый вызов (без параметра `category`): Возвращает лёгкую сводку — каждая категория с названиями файлов, статусами и количеством, но БЕЗ содержимого файлов. Используйте это, чтобы понять, что отошло, и показать пользователю сводку. Спросите, какие категории он хочет применить. Второй вызов (с параметром `category`): Инструмент сам записывает все изменённые/отсутствующие файлы напрямую на диск и возвращает манифест — результаты по файлам с filePath, статусом ("updated", "created" или "unchanged") и name, но БЕЗ canonicalContent. Агент никогда не видит содержимого файлов и не использует инструмент Write для файлов методологии. Повторите второй вызов для каждой категории, которую подтвердит пользователь. Как вызывающий агент, вы обязаны: 1. Вызвать сначала без category, чтобы получить сводку. 2. Показать каждую отошедшую категорию (изменённые/отсутствующие) и спросить пользователя, какие применить. 3. Для каждой подтверждённой категории вызвать снова с category=X — инструмент записывает файлы и возвращает манифест. Сообщите пользователю, что было обновлено/создано. 4. Для категории mcp манифест всё ещё содержит данные prescription — сами объедините эту запись с существующей конфигурацией MCP (прочитайте → объедините → запишите). Если malformed — скажите пользователю, не перезаписывайте. 5. Для ide манифест может содержать instructions по установке расширения для VS Code — выполните эту команду за пользователя. Конфигурация для Zed записывается напрямую инструментом. 6. Для brain — category=brain никогда не записывает; запись манифеста содержит поле instructions, которое указывает агенту вызвать /aide:brain config — единственный канонический источник для создания brain.aide. ВАЖНО —…

Проверка состояния файлов .aide spec в проекте. Обнаруживает осиротевшие spec'ы (в папках без оркестратора), отсутствующие spec'ы (оркестраторы с 3+ импортами helper, но без .aide), конфликты имен (.aide + intent.aide в одной папке), битые ссылки, осиротевшие research (research.aide без intent spec) и отсутствующие описания (spec'ы без поля description в frontmatter).