aidemd-mcp/server

Инструмент точки входа в brain по требованию. Вызывайте этот инструмент, когда нужно добраться до brain в середине задачи - НЕ вызывайте его при каждой загрузке /aide. Состояние предварительных условий brain при загрузке уже сообщается через aide_info.brain.status; вызов aide_brain при загрузке дублирует эту работу без необходимости. С его помощью также настраивают, исправляют или записывают конфигурацию brain для любого бэкенда, по одному решению за раз. Каждый режим только для чтения: ни один вызов не пишет на диск. Необязательный параметр `source` - определяет, какое чтение выполняется. Если опущен, подразумевается "host". - "host" - одна секция файла .aide/config/brain.aide хоста, описана ниже. - "template" - { template, purpose }: одна секция встроенного шаблона (или его лаунчера, с kind: "launcher") в виде дословных байтов, и однострочное назначение этой секции из опубликованного контракта. Ответ одинаков независимо от состояния конфигурации хоста. Используйте его как рабочий пример при написании этой секции для другого бэкенда. - "contract" - { sections }: все секции контракта по порядку, каждая с marker, role (live или seed) и purpose, без текста секций. - "draft" - структурная проверка черновика конфигурации по path, с теми же правилами и словарём ошибок, что и проверка конфигурации хоста, так что черновик, прошедший проверку, готов к замене. Возвращает { outcome, instructions }: valid; invalid с fault (missing-sections и его sections, или malformed и его reason); absent, когда по path нет файла; refused, когда path вне проекта, и ничего не читается. Проверяет структуру, но никогда содержимое. Необязательный параметр `kind` - только для чтения хоста и шаблона: любой маркер секции опубликованного контракта brain (см. перечисление), live или seed; "launcher" только с source: "template". Если опущен, подразумевается "orientation", runtime-брифинг для доступа к brain в середине задачи. "config" - это поток подключения интеграции, который запускает /aide:brain config. Секции seed извлекаются по одной за вызов во время seeding. path требуется с source: "draft" и не принимается больше нигде…

Удаляет временные файлы пайплайна модуля (plan.aide, todo.aide, brief.aide), как только цикл этого модуля закрылся, оставляя код и спецификации intent как долговечную запись. Никогда не удаляет, не перезаписывает и не читает ничего другого: спецификации intent, спецификации research, код и .aide/session.aide вне доступа. Если plan.aide существует, отказывается работать, пока не отмечены все чекбоксы плана и не отмечен полностью любой присутствующий todo.aide; отсутствие todo.aide не блокирует. Если plan.aide нет, удаляет полностью отмеченный todo.aide и отказывается удалять brief.aide (его удаляют только вместе с его планом), todo.aide без чекбоксов или папку, в которой вообще нет временных файлов. При отказе перечисляет каждый неотмеченный пункт с указанием файла и строки, и ничего не удаляется. По умолчанию plan.aide без чекбоксов отклоняется; передача allowEmptyPlan: true пропускает такой план, не переопределяет ничего другого и не даёт эффекта, если plan.aide нет. Вызывайте его напрямую, потому что реальный вызов уже безопасен. dryRun - необязательный предпросмотр только для проверки, и он никогда не обязателен перед реальным вызовом. Это кросс-платформенная замена удалению через shell, поэтому его можно разрешить по имени.

Сканирует файлы спецификаций .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 (старая установка, предшествующая отслеживанию версий) молча сворачивается в []. Устаревание носит информационный характер - оркестратор продолжает, предупредив пользователя. `behind` (`{ installed, latest }` или null) - мягкое уведомление. Не null только когда запись aide проекта запускает глобально установленный сервер, который старше последней опубликованной версии. Предложите npm i -g @aidemd-mcp/server один раз и продолжайте - это никогда не блокирует конвейер. Null, когда сервер запущен локально, актуален, или проверка версии не может выполниться (офлайн-проверки проходят молча). `brainMigration` (`{ staleSections, legacyLauncher }` или null) - мягкое уведомление. Не null, когда конфигурация brain содержит разделы, текст которых совпадает с более ранней версией шаблона, или устаревший лаунчер brain (legacyLauncher перечисляет причины: unpinned, unversioned, older-pin, missing-auto-confirm). Упомяните это один раз и предложите /aide:brain config; это никогда не блокирует конвейер и никогда не меняет brain.status. `brain` (состояние предварительного условия) - жёсткий шлюз. Сообщает, подключена ли и согласована ли запись brain MCP хоста. Форма: { status, name?, fault?, hints } - name отсутствует при no-brain-aide и brain-aide-invalid; fault присутствует только при brain-aide-invalid. Оркестратор должен остановиться и направить пользователя решить проблему, прежде чем продолжить, если status не равен 'ok'. Проверка путей не выполняется - пакет никогда не выполняет stat ни для одного каталога на диске; состояние полностью выводится из сравнения .aide/config/brain.aide с .mcp.json. Пять brain.status…

Разворачивает среду разработки 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: Шаг Brain config (brain.aide) несёт brainSummary при каждом вызове, включая сводку: sections (у каждой секции marker, role, seedPath для сидов и templateBytes), missingSections, staleSections, причины legacyLauncher и templateIntegration. Он никогда не несёт текст секций, назначения, блоки починки или тела до/после. Отсутствующие секции вставляются через aide_upgrade category: "brain", сиды читаются по одному через aide_brain, а миграции просматриваются и применяются по одной через aide_upgrade. Секции, которые пользователь отредактировал, и кастомные лаунчеры никогда не предлагаются. Инструмент создаёт .aide/config/brain.aide, когда его нет, и никогда не перезаписывает существующий. Исключение - шаги IDE VS Code: Шаги IDE, которые…

Возвращает 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, status ("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 сводка сообщает missingSections, устаревший текст разделов как staleSections и устаревший загрузчик brain как legacyLauncher (его причины), каждый назван отдельно. Затем категория brain проходит через три…

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