adrianczuczka/mason

Выполняет анализ истории git в кодовой базе. Возвращает паттерны соглашений о коммитах, устаревшие директории и часто изменяемые файлы. Это совокупная статистика по сотням коммитов, которую было бы трудоёмко вычислить вручную.

Синхронизирует концептуальную карту проекта с Confluence в виде вики-страниц, понятных продуктовой команде: индексная страница, по одной странице на каждую функцию (описания на языке PM, без путей к файлам) и страница изменений. Mason заменяет содержимое управляемых страниц; ручные правки этого содержимого перезаписываются. Требует, чтобы сначала был вызван mason_set_confluence.

Выполняет полный анализ проекта за один вызов. Возвращает статистику истории git, структуру проекта с количеством файлов, подобранные образцы кода (примерно по 60 строк каждый) и сопоставление тестовых и исходных файлов. Это рекомендуемая отправная точка — сначала вызывайте этот инструмент, затем читайте конкретные файлы нативно для получения полного содержимого.

Этап Map сборки концепт-карты. Возвращает один пакет исходных файлов (скелеты каждого файла в пакете плюс несколько более глубоко прочитанных тел для привязки), вместе с системным промптом, который инструктирует вас извлекать возможности и потоки ТОЛЬКО для этого пакета. Вызывайте повторно с возвращённым nextOffset, пока он не станет null, вызывая save_partial_snapshot между каждым вызовом. Используйте названия функций, естественные для продукта, чтобы частичные результаты чисто объединялись на этапе Reduce.

Получает превью (первые ~60 строк) репрезентативных файлов исходного кода из кодовой базы. Включает точки входа, конфигурационные файлы, горячие файлы (часто изменяемые), тестовые примеры и по одному файлу из каждой директории для охвата. Читает файлы нативно для полного содержимого.

Собирает контекст задачи: сопоставляет решения с обоснованием, утверждением, владельцем, источниками, последней проверкой и актуальностью, а также связанные тесты, влияние на файлы и любые доступные записи карты. Предложения - рекомендации; устаревшие записи не проверены; принятые решения - ограничения, действительные при условии актуальности. Ни инициализация, ни карта не требуются. Передайте задачу и необязательные файлы. map.status и диагностика сохраняют отсутствующие или недействительные знания. Влияние охватывает до трех уникальных файлов, расширяя якоря каталогов.

Прослеживает исторических партнёров по совместным изменениям, связанные тесты и ссылки с доказательствами: разрешённые импорты, явные пути или неопределённые кандидаты имён. Кандидаты - не доказанные зависимости. Детерминированный и только для чтения; не требует инициализации или карты понятий.

Возвращает опциональную карту архитектуры «фича-файл» с данными о дрейфе и доверии. Если карты нет, возвращает exists:false, а также структуру проекта, Git-сигналы и пары тестов. Decision capture, get_context и get_impact по-прежнему работают. Инициализация не требуется.

Проверяет установленную автоматизацию и наблюдаемые события хоста, или возобновляет/проверяет сохранённые доказательства исправления документации между сеансами. status доступен только для чтения; check сохраняет локальные эталоны и отчёты проверки, не редактируя исходный код и не утверждая рекомендации. Возвращает краткие результаты с полным путём к отчёту. Работает без карты.

Проверяет, насколько карта понятий отошла от HEAD. Детерминированная (git + файловая система, без LLM). Возвращает, какие функции/потоки устарели и какие изменённые файлы за ними стоят, новые исходные файлы, ещё не занесённые на карту, файлы-призраки (занесены, но удалены), переименования и recommendation: up-to-date (ничего не нужно делать), incremental (обновить только устаревшие записи через save_snapshot) или full-rebuild (перезапустить сборку Map-Reduce). Вызывайте этот инструмент перед тем, как довериться карте в длительной сессии, или периодически, чтобы поддерживать карту и любые синхронизированные вики в актуальном состоянии.

Записывает настройку инструкций ассистента локально в игнорируемый .mason/local/project.json, а настройки функций - в общий .mason/config.json. Другие инструменты работают без этого маркера. Повторные вызовы сохраняют исходное время настройки и существующие параметры; передавайте confluenceConfigured только для изменения этого параметра.

Inspect this project now: returns documentation audit findings, committed-diff review findings, decision/map status, and a quickstart playbook. Quickstart and map modes are read-only and deterministic. Explicit mode: setup configures MCP, instructions and lifecycle hooks to use mason on PATH while retaining original audit evidence; use it only when the user requests setup. Optional host selects codex or claude. Optional base selects the review comparison; evidence imports CI manifests with check outcomes, commit freshness, and links to changed files and accepted decisions. mode: map returns the full Map-Reduce build workflow. Repeat calls refresh findings even after setup.

Отслеживает исправления документации относительно исходных аудиторских доказательств. prepare сохраняет локальную базовую линию и возвращает рабочий заказ по области; verify читает эту базовую линию и сообщает об исправленных, неисправленных, требующих проверки, непроверенных и новых замечаниях. Подавленные предупреждения остаются нерешёнными. Не редактирует документацию и не утверждает решения. Карта не требуется.

Настраивает учётные данные Confluence. Двухшаговый процесс: (1) вызов без spaceKey для проверки учётных данных и получения списка доступных пространств — передайте их пользователю. (2) повторный вызов с теми же baseUrl/email/apiToken плюс выбранный spaceKey для сохранения. Учётные данные хранятся в ~/.mason/config.json. Предупредите пользователя, что API-токен будет виден в истории чата, прежде чем он его вставит.

Сокращает шаг построения карты концепций. Возвращает каждый частичный снимок и системный запрос с просьбой объединить их в одну целостную карту всего проекта. Преобразует варианты платформ в единые возможности продукта, дедуплицирует почти дубликаты и гарантирует, что ни один файл не будет пропущен. После создания объединенной карты вызовите save_snapshot, чтобы сохранить её (это также очищает частичные снимки).

Prepare a decision review: returns the full record and history, any operative accepted revision, provenance, changes and previews for both sets of anchors, and a reviewToken. Then record accept, reaffirm, or retire with that token, the authorized reviewer, and a reason. Acceptance replaces the operative revision; retirement withdraws the entire record including its proposal. Acceptance requires owner, source, readable Git HEAD, and committed anchor changes. Changed records or code invalidate the token. Identities and approvals are recorded assertions for normal PR review, not authenticated proof.

Фиксирует или изменяет предложение решения с обоснованием, якорями, необязательным владельцем, источниками и известным участником. Не требуется настройка или карта. Создаёт локальную запись и сохраняет историю содержимого. Изменения создают отложенное предложение, пока последняя принятая редакция остаётся действующей; неизменённое содержимое не перепроверяет и не обновляет его. Используйте review_decision для авторизованного принятия или повторного подтверждения. Предложение не может заменить запись с действующей принятой редакцией; рассмотрите её замену, а оригинал отдельно выведите из обращения.

Сохраните частичную карту понятий, полученную для одного пакета. Вызывайте это один раз на пакет, с batchId из ответа generate_snapshot_batch. Частичные карты накапливаются в .mason/partial-snapshots/ и объединяются на этапе свёртки.

Сохраняет карту соответствия концепций файлам в виде постоянного снимка проекта. Отображает названия функций и потоки данных на файлы, которые их реализуют. Сохраняется между сеансами — будущие сессии могут вызвать get_snapshot, чтобы мгновенно найти нужные файлы. Не требуется API-ключ — вы — LLM, которая генерирует эту карту.

Записывайте вердикты verify_snapshot. Записи, признанные ok, получают отметку verifiedAt; сбои помечаются флагом verificationFailed с вашим примечанием и отображаются в get_context, get_snapshot и mason_check_drift, пока не будут исправлены. Примечания к вердикту обязательны для сбоев.

Выборочно проверяет КОРРЕКТНОСТЬ карты понятий (дрифт проверяет свежесть; эта проверка — что записи были верны изначально). Возвращает выборку записей — всегда сначала непроверенные и проверенные дольше всего — с каркасами их заявленных файлов, чтобы вы могли судить, действительно ли файлы реализуют то, что утверждает запись. Сообщайте результаты обратно через save_verification. Запускайте периодически или после автоматического обновления, записавшего записи, не просмотренные человеком.