adrianczuczka/mason

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

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

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

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

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

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

Проверяет этот проект сейчас: возвращает находки аудита документации, находки ревью committed-diff, статус решений/карты и playbook быстрого старта. Quickstart работает только на чтение и детерминирован. Явный режим: setup проверяет общую конфигурацию и активирует её локально, не редактируя общие файлы; режим init явно готовит MCP, инструкции и хуки жизненного цикла для ревью и коммита. Ни один из них не запускает аудиты и не готовит исправления; используйте только по запросу. Необязательный host выбирает codex или claude. Необязательный base выбирает базу для сравнения при ревью; evidence импортирует манифесты CI с результатами проверок, свежестью коммитов и ссылками на изменённые файлы и принятые решения. Повторные вызовы обновляют находки даже после setup.

Готовит проверку решения: возвращает полную запись и историю, любую действующую принятую ревизию, происхождение, изменения и предпросмотры для обоих наборов якорей, а также reviewToken. Для проверки принятых указаний используйте inspectionScope operative и при prepare, и при inspect; ожидающие предложения остаются неоценёнными. По умолчанию область all охватывает обе ревизии. После проверки источника запишите inspect с inspector, note и token, чтобы сообщить об отсутствии противоречий без принятия человеком. Для проверки человеком подготовьте с областью all, затем запишите accept, reaffirm или retire с соответствующим token, уполномоченным проверяющим и причиной. Принятие заменяет действующую ревизию; отзыв отзывает всю запись, включая её предложение. Принятие требует owner, source, читаемый Git HEAD и закоммиченные изменения якорей. Изменённые записи или код аннулируют token. Идентификаторы и одобрения - записанные утверждения для обычного PR-ревью, а не аутентифицированное доказательство.

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

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

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

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