agenticempire/axint

Запустите дымовой тест компилятора без исходников через реальный пайплайн Axint. Используйте сразу после установки или подключения Axint, чтобы текущий агент доказал, что сделал больше, чем просто запустил MCP-сервер. Использование: вызывайте сразу после установки или первого подключения MCP, чтобы агент доказал реальное использование Axint помимо запуска сервера. Эффекты: встроенный дымовой тест компилятора только для чтения; не записывает файлы и не использует сеть.

Спросите у локального мозга проекта Axint, что этому агенту делать дальше. Читает контекст проекта, последнее доказательство выполнения (proof), последний план исправления (repair plan) и активные заявки на файлы (file claims), затем возвращает руководство, специфичное для хоста: для Xcode, редакторов с приоритетом патчей (patch-first editors) или другой линии агента (agent lane). Использование: применяйте, когда локальное доказательство должно выбрать следующий шаг; используйте suggest для идей с чистого листа (greenfield) и repair для известных ошибок. Эффекты: читает локальный контекст Axint/доказательство и может обновить артефакты советов (advice artifacts); без сети.

Забирайте файлы в заявку (claim) перед тем, как агент начнёт их редактировать — чтобы другие агенты не правили одни и те же SwiftUI/App файлы одновременно. Заявки локальны, живут недолго и хранятся в .axint/coordination/claims.json. Применение: используйте перед редактированием общих файлов при параллельной работе агентов; освобождайте заявку, когда закончили. Эффект: записывает локальные координационные заявки в .axint/coordination; без сети.

Установите локальный мозг мультиагентного проекта Axint. Создаёт файлы .axint/agent.json, .axint/context/latest.* и .axint/coordination, чтобы AI-агенты, Xcode и люди координировались через один и тот же локальный слой истины. Использование: используйте один раз на проект для создания локальной мультиагентной координации; не нужно для разовой компиляции. Результат: записывает файлы .axint/agent, context и coordination; без сети.

Освобождает активные локальные заявки на файлы Axint для этого агента после завершения или отказа от задачи. Это предотвращает блокировку друг друга параллельными агентами и Xcode из-за устаревших заявок. Использование: используйте после завершения или отказа от заявленных файлов; используйте agent.claim перед правками и agent.advice для следующих шагов. Результат: обновляет локальные заявки координации в .axint/coordination; без сети.

Запустите вызываемую агентом проверку Cloud Check для исходного кода на Swift или Axint TypeScript. Принимает исходный код в строковом виде или путь к файлу (sourcePath), затем возвращает вердикт в стиле Cloud, выводы, специфичные для Apple, следующие шаги, подсказку для исправления AI и сигнал обратной связи от компилятора с удалением конфиденциальных данных, если проверка обнаруживает ошибку. Это устраняет ограничение, связанное с тем, что проверка доступна только в браузере, для агентов Xcode и MCP: они могут запускать проверку программно в цикле сборки. Применение: используйте для проверки исходного кода с учётом Apple и подсказок по исправлению; предоставьте доказательства для утверждений о UI/рантайме. Эффекты: ответ только для чтения на основе предоставленного исходного кода или пути; может использовать настроенную конечную точку Cloud Check; исходный код не отправляется, если он не предоставлен.

Компилирует TypeScript-исходник (вызов defineIntent()) в нативный Swift-код App Intent. Возвращает { swift, infoPlist?, entitlements? } в виде строки, без записи файлов и сетевых запросов. При ошибке валидации возвращает диагностику (severity, AX error code, position, fix suggestion) вместо Swift. Использование: когда TypeScript DSL нужно преобразовать в Swift; используйте validate только для более дешёвой предварительной проверки. Эффекты: только чтение сгенерированного Swift/диагностики, не записывает файлы и не использует сеть.

Возвращает локальный для проекта контекст документации Axint, который агенты должны перезагружать после новых чатов или уплотнения контекста. Это долговременная память документации, которая не дает агенту забыть рабочий процесс и продолжать использовать Axint. Использование: применяйте после уплотнения, когда агенту нужна документация по рабочему процессу без повторного чтения всего сайта. Эффекты: контекст документации только для чтения; не записывает файлы и не использует сеть.

Возвращает компактную оперативную память Axint, которую агенты должны перезагружать при новом запуске чата, после сжатия контекста или после длительного дрейфа кода. Используйте это, чтобы держать Axint в фокусе, не перечитывая полную документацию. Применение: используйте после сжатия или перезапуска сессии для компактных рабочих правил; используйте context.docs для более длинных рабочих документов. Эффекты: контекст только для чтения, не записывает файлы и не использует сеть.

Проведи аудит текущего окружения Axint и связей проекта: запущенная версия MCP, ожидаемая версия, пути Node/npm/npx, файл .mcp.json проекта, AGENTS.md, CLAUDE.md, .axint/project.json и регистрация Xcode Claude Agent. Используйте это, когда агент может быть подключен к устаревшему процессу Axint или когда новому проекту нужно подтверждение первой настройки MCP. Используйте: вызывайте, когда разводка MCP, пути пакетов, настройка Xcode или память проекта могут быть устаревшими. Эффекты: инспекция только для чтения; не записывает файлы; не требует аутентификации или сети.

Генерирует структурированный пакет нативных функций Apple на основе описания. Возвращает несколько файлов: Swift-исходники с поддержкой компиляции, сопутствующий виджет/вью, фрагменты Info.plist, entitlements и XCTest-заготовки — всё разбито по файлам, так что Xcode-агент может записать каждый файл прямо в проект. Рассчитан на совместную работу с инструментами Xcode MCP: вызови axint.feature, чтобы сгенерировать пакет, а затем используй XcodeWrite, чтобы разместить каждый файл. Используй: для создания новых нативных поверхностей Apple; не подходит для исправления существующих багов в приложении. Эффекты: только чтение сгенерированного вывода; не записывает файлы и не использует сеть.

Создать или прочитать конфиденциальный учебный пакет для системы диагностики Axint. Пакеты включают структуру проекта, диагностические коды, класс проблемы, отредактированные доказательства и вероятного владельца продукта, но никогда не включают исходный код. Пользователи могут проверить JSON перед отправкой в Axint Cloud. Использование: используйте, когда результат работы Axint был неудовлетворительным и вам нужен конфиденциальный пакет проблемы; не для отправки исходного кода. Результат: записывает или читает отредактированные пакеты .axint/feedback; по умолчанию никогда не включает исходный код.

Читает последний Fix Packet, который Axint выпустил локально после компиляции или запуска watch. Возвращает точный артефакт исправления, который должны использовать AI tools или Xcode helpers далее: вердикт, основные находки, полную диагностику, следующие шаги и готовый для AI промпт для исправления. Используйте это после axint compile или axint watch, когда нужен последний пакет без копирования-вставки или дополнительного прохода компиляции. Использование: после локального compile/watch/check, когда выпущен пакет; это не новый проход анализа. Эффекты: только чтение локального артефакта; не записывает файлы и не использует сеть.

Сканирует локальный Apple-проект и создаёт компактный пакет .axint/context, чтобы Axint мог анализировать изменённые файлы, соседние SwiftUI-поверхности и файлы с риском взаимодействия, а не только один исходный файл за раз. Используй: перед проектно-осознанным ремонтом, работой с несколькими SwiftUI-файлами или анализом рисков взаимодействия. Эффект: записывает .axint/context, если dryRun=true не задан; читает только локальные файлы проекта.

.mcp.json ```json { "mcpServers": { "axint": { "command": "axint", "args": ["mcp"], "env": {}, "disabled": false, "autoApprove": [] } }, "tools": { "axint.status": { "description": "Check current Axint state and workflow readiness.", "inputSchema": {} }, "axint.activate": { "description": "Activate the Axint workflow for the current project.", "inputSchema": { "type": "object", "properties": { "gate": { "type": "string", "description": "Workflow gate to run (default: all)." } } } }, "axint.validate.swift": { "description": "Validate Swift files against project standards and compile checks.", "inputSchema": { "type": "object", "properties": { "path": { "type": "string", "description": "Path to Swift file or directory to validate." } } } }, "axint.cloudcheck": { "description": "Run Cloud Check with evidence. Provides test results, logs, or screenshots as proof.", "inputSchema": { "type": "object", "properties": { "evidence": { "type": "array", "items": { "type": "string" }, "description": "List of evidence paths or URLs." } } } } } } ``` AGENTS.md ```markdown # Agents This project uses the following agents: - **Axint Core** — Manages project lifecycle and workflow gates. - **Swift Linter** — Validates Swift code style and compilation. - **Cloud Checker** — Runs integration tests against staging/production environments and collects evidence. All agents must be invoked via the MCP tools defined in `.mcp.json`. Do not make static-only claims about bugs — always back findings with evidence from `axint.cloudcheck` or `axint.validate.swift`. ``` CLAUDE.md ```markdown # Claude Instructions for Axint Project You are working in a new Apple app project bootstrapped with Axint. ## Workflow 1. **Read docs** — Start by reading `.axint/README.md` and any project documentation. 2. **Call `axint.status`** — Check the current project state. 3. **Call `axint.activate`** — Activate the first-try workflow. This will run all gates. 4. **Run workflow gates** — The activation will automatically validate Swift and run Cloud Check. 5. **Validate Swift** — Use `axint.validate.swift` if you need manual validation. 6. **Run Cloud Check with evidence** — Use `axint.cloudcheck` and always include evidence (logs, screenshots, test results). Do NOT claim bugs based on static analysis alone. ## Rules - Never assert a bug without providing evidence from Cloud Check. - Prefer dynamic verification (runtime logs, test output) over static guesses. - If you cannot run a tool, ask the user to set up the environment. ``` .axint/AXINT_MEMORY.md ```markdown # Axint Memory ## Project ID `com.example.mynewapp` ## State - Initialised: yes - Last activation: never - Workflow gates: pending - Swift validation: pending - Cloud Check: pending ## Notes First-time project. Use `axint.activate` to run through gates. Document all evidence when running Cloud Check. ``` .axint/project.json ```json { "projectName": "MyNewApp", "bundleIdentifier": "com.example.mynewapp", "platform": "iOS", "swiftVersion": "5.9", "xcodeVersion": "15.0", "deploymentTarget": "17.0", "workflowGates": [ "readDocs", "statusCheck", "activation", "swiftValidation", "cloudCheck" ] } ``` .axint/README.md ```markdown # Axint Project Start Pack This pack bootstraps a new Apple app with the Axint first-try workflow. ## Files - `.mcp.json` — MCP server configuration for Axint tools. - `AGENTS.md` — Agent roles and rules. - `CLAUDE.md` — Instructions for Claude AI. - `.axint/AXINT_MEMORY.md` — Persistent project memory. - `.axint/project.json` — Project metadata and workflow gates. - `.axint/README.md` — This file. ## Workflow 1. Read docs (this file and `CLAUDE.md`). 2. Call `axint.status` to verify environment. 3. Call `axint.activate` to start the first-try gates. 4. After activation, validate Swift code with `axint.validate.swift`. 5. Run `axint.cloudcheck` with evidence (test logs, screenshots) to confirm behavior. 6. Avoid static-only bug claims — always provide evidence. ## Notes - No files are written by this pack; it is read-only. - Requires Axint CLI installed and MCP-capable host (Xcode extension or AI agent). ```

Обновить подсказки версий project-pack, принадлежащие Axint, после обновления. Используйте это после axint.upgrade или обновлений npm/pip, чтобы .axint/project.json, AGENTS.md, CLAUDE.md и документация по реидратации Axint перестали указывать агентам на устаревшую версию пакета. Использование: применяйте после обновлений пакетов, чтобы локальные подсказки project-pack перестали ссылаться на старые версии Axint. Эффект: обновляет файлы инструкций проекта, принадлежащие Axint, если только dryRun не равно true; сеть не используется.

Ищет в реестре Axint уже опубликованные пакеты, соответствующие запросу на естественном языке. Используйте этот инструмент ДО вызова axint.feature или axint.compile, чтобы агент мог установить существующий пакет вместо повторной генерации Swift, который сообщество уже опубликовало. Возвращает ранжированные результаты с именем, версией, описанием, областями применения и командой установки. Применение: используйте перед генерацией кода, чтобы найти переиспользуемые пакеты; не для проверки локального Swift. Эффекты: поиск в локальном реестре только для чтения, использует AXINT_REGISTRY_PATH или соседнюю копию репозитория; по умолчанию без сети.

Планирует ремонт существующих приложений Apple с учётом проекта. Индексирует локальный проект, классифицирует свидетельства сборки/UI/рантайма, запускает Cloud Check, если предоставлен исходный код, ранжирует вероятные файлы SwiftUI/App, возвращает план исправления/доказательства с учётом хоста и записывает .axint/repair вместе с privacy-safe пакетом .axint/feedback. Использование: используйте для существующих багов приложений с логами, симптомами UI или свидетельствами рантайма; не для генерации с нуля. Эффекты: записывает артефакты .axint/repair и privacy-safe .axint/feedback; читает локальные файлы проекта.

Запускает принудительный цикл сборки Axint Apple вне интерфейса Xcode. Запускает или обновляет сессию Axint, проверяет Swift, запускает Cloud Check, выполняет сборку/тестирование xcodebuild, если присутствует проект или рабочая область, опционально запускает приложение macOS для получения свидетельств выполнения, записывает артефакты .axint/run/latest и возвращает подготовленную для агента подсказку по ремонту. Использование: используйте, когда агенту необходимо подтвердить проверку Swift, Cloud Check, сборку/тестирование Xcode и свидетельства выполнения. Эффекты: запускает дочерние процессы, записывает артефакты .axint/run, может запускать xcodebuild/тесты и вызывать Cloud Check.

Отменяет последний или выбранный запуск Axint, убивая активные дочерние группы процессов. Используйте, когда xcodebuild или средство запуска UI-тестов пережили тайм-аут MCP или закрытие транспорта. Назначение: использовать только для остановки активного запуска Axint или зависшей дочерней группы процессов. Эффекты: деструктивные — убивает активные дочерние группы процессов Axint; сеть не используется.

Читает последнюю или выбранную запись о запуске задания Axint, включая идентификаторы активных дочерних процессов. Используйте это, когда длительный запуск xcodebuild может всё ещё быть активным после тайм-аута MCP или отключения клиента. Использование: применяйте после тайм-аутов MCP или долгих сборок, чтобы возобновить работу, не гадая, активен ли ещё xcodebuild. Эффекты: локальный просмотр запуска/задания только для чтения; не записывает файлы и не использует сеть.

Генерирует начальный файл интента на TypeScript по имени и описанию. Возвращает полную строку исходного кода с defineIntent(), готовую для сохранения в файл .ts - никакие файлы не записываются, сетевые запросы не выполняются. При недопустимых значениях домена возвращает строку с ошибкой. Результат компилируется напрямую с помощью axint.compile. Использование: используйте для создания небольшой заготовки интента на TypeScript; для более полных примеров используйте templates.get, а для Swift-вывода - compile. Эффекты: только чтение сгенерированного TypeScript; не записывает файлы и не использует сеть.

Компилирует минимальную JSON-схему напрямую в Swift, полностью минуя TypeScript DSL. Поддерживает интенты, представления (views), компоненты, виджеты и полноценные приложения через параметр 'type'. Использует ~20 входных токенов против сотен для TypeScript — идеально для LLM-агентов, оптимизирующих бюджет токенов. Возвращает исходный код Swift со статистикой использования токенов, без записи файлов и без сетевых запросов. При неверном вводе возвращает сообщение об ошибке с описанием проблемы. Использование: используйте для генерации Swift из JSON с малым потреблением токенов; используйте compile для полного контроля TypeScript DSL и scaffold для TS-стартеров. Эффекты: только чтение при генерации Swift, не записывает файлы и не использует сеть.

Запускает принудительную сессию агента Axint. Записывает .axint/session/current.json, а также историю сессии, привязанную к токену, обновляет .axint/AXINT_REHYDRATE.md, возвращает компактную рабочую память, контекст документации, токен сессии и точные аргументы axint.workflow.check. Используй этот инструмент первым в AI-агенте или хосте Xcode после нового чата, перезагрузки MCP или сжатия контекста — чтобы агент не мог незаметно отклониться от Axint. Использование: вызывай в начале сессии с доступными инструментами или после сжатия контекста. Результат: запись .axint/session и артефактов регидратации; не требует аутентификации или сети.

Сообщи точную версию работающего MCP-сервера Axint, путь пакета, аптайм, количество зарегистрированных инструментов и инструкции по перезагрузке/обновлению MCP в том же потоке. Используй это как первый инструмент в новом AI-агенте или чате Xcode, чтобы доказать, к какому процессу Axint агент на самом деле подключён. Это возвращает версию работающего MCP-сервера, а не предполагаемую версию из npm, PyPI или документации. Используй: вызывай первым или после перезагрузки MCP, чтобы подтвердить версию подключённого сервера; не используй как запрос к npm/PyPI. Эффект: только чтение; не записывает файлы; не требует авторизации или сети.

Предлагает нативные функции Apple для приложения на основе его описания. Домен — лишь слабая подсказка; решающую роль играет описание. Возвращает ранжированный список функций с рекомендуемыми поверхностями (intent, widget, view, component, store, app), примерной сложностью и однострочным описанием каждой. Используйте, чтобы узнать, что Axint может сгенерировать для приложения, перед вызовом axint.feature. Локальный режим не использует сеть. Применение: используйте перед генерацией, чтобы выбрать поверхности Apple; не заменяет поиск по реестру или валидацию. Эффекты: локальный режим только для чтения; Pro-режим может вызывать endpoint Axint, если настроены учётные данные.

Автоматически исправляет механические ошибки Swift, обнаруженные axint.swift.validate. Обрабатывает более 20 правил исправления: перезаписывает @State let → @State var, вставляет perform() в AppIntents, добавляет заглушки var body в Widgets и Apps, добавляет let date: Date в TimelineEntry, исправляет DispatchQueue.main → Task { @MainActor in }, преобразует nonisolated var → let, удаляет избыточный @MainActor из actors, добавляет Codable+Hashable в ActivityAttributes ContentState и многое другое. Использование: применяйте после swift.validate, если ошибки механические; оставшиеся диагностические сообщения проверяйте вручную. Эффекты: только чтение — вывод исправленного исходного кода; не записывает файлы и не использует сеть.

Проверяет существующий Swift-код на соответствие правилам сборки Axint для Apple (AX700–AX749), включая конкурентность Swift 6 и Live Activities. Ловит баги, которые Xcode прячет за общими ошибками «type does not conform»: отсутствие perform() у AppIntent, отсутствие var body у Widget, @State let вместо var, нарушения Sendable, неверное использование @MainActor на акторах, отсутствие ContentState в ActivityAttributes и ещё более 140. Используйте: запускайте на сгенерированном или отредактированном Swift перед сборкой; используйте вместе с swift.fix для механических исправлений. Результат: только чтение диагностики Swift; не записывает файлы и не использует сеть.

Получает полный исходный код TypeScript конкретного встроенного шаблона по идентификатору. Возвращает полный, компилируемый файл defineIntent() в виде строки - готовый к сохранению как .ts и компиляции с помощью axint.compile. Включает логику perform(), определения параметров и доменно-специфичные шаблоны. Возвращает сообщение об ошибке, если идентификатор не найден (сначала вызовите axint.templates.list, чтобы узнать допустимые идентификаторы). Не записывает файлы, не выполняет сетевых запросов, не имеет побочных эффектов. Использование: используйте после templates.list, чтобы получить полный эталонный шаблон; отредактируйте его перед вызовом compile. Эффекты: источник шаблона только для чтения; не записывает файлы и не использует сеть.

Возвращает список всех встроенных шаблонов-референсов в Axint SDK. Выдаёт JSON-массив объектов { id, name, description } — по одному на шаблон. Шаблоны покрывают сценарии: обмен сообщениями, продуктивность, здоровье, финансы, коммерция, медиа, навигация, умный дом, а также паттерны для сущностей и запросов. Входные параметры не требуются, файлы не создаются, сетевые запросы не выполняются, побочных эффектов нет. Вызывайте, чтобы узнать id шаблонов, затем вызывайте axint.templates.get с конкретным id, чтобы получить полный исходник. Используйте: для поиска допустимых id шаблонов перед templates.get. Эффекты: чтение метаданных шаблонов; не пишет файлы и не использует сеть.

Принимает дизайн-токены из JSON, экспорта объектов JS/TS или CSS-переменных и возвращает enum токенов SwiftUI. Используйте это перед генерацией Swarm-стилей представлений/компонентов, чтобы агенты могли сохранить точные фирменные цвета, размеры, радиусы, отступы и типографику. Файлы не записываются. Использование: перед генерацией представлений/компонентов, когда нужно сохранить дизайн-систему. Результат: только чтение Swift-токенов; файлы не записываются, сеть не используется.

Проверяет последнюю версию пакета Axint и, при необходимости, применяет обновление, сохраняя текущий поток агента. Возвращает точные команды установки, опциональное обновление привязок Xcode MCP, артефакты .axint/upgrade/latest.* и подсказку для продолжения в том же потоке, чтобы AI-агент или хост Xcode могли перезагрузить процесс MCP без запуска с нуля. Использовать: вызывать, когда axint.status показывает устаревший сервер; не предназначен для обновления зависимостей приложений. Эффекты: разрушительный при apply=true — может выполнять установку пакетов, обновлять привязки Xcode и записывать .axint/upgrade; может использовать сеть npm.

Проверяет определение интента на TypeScript без генерации Swift. Прогоняет полный конвейер валидации Axint (134 диагностических правила) и возвращает JSON-массив диагностик: { severity: 'error'|'warning', code: 'AXnnn', line: number, column: number, message: string, suggestion?: string }. Возвращает пустой массив [], если проверка пройдена. Проверяет имена интентов (PascalCase), типы параметров, значения доменов, запросы сущностей, семейства виджетов, свойства представлений и сцены приложений. Используйте: для диагностики TypeScript DSL перед выводом Swift; используйте swift.validate для существующего Swift. Эффекты: диагностика только для чтения; не записывает файлы и не использует сеть.

Шлюз (gate) для агентского workflow, который записывает локальную метку свежести (freshness stamp). Требует текущий сессионный токен Axint от axint.session.start, если только явно не установлено requireSession=false. Использование: применяйте на этапах (stage gates) для подтверждения покрытия workflow; используйте status для проверок версий и run для доказательств сборки/тестирования. Результат: записывает локальную метку свежести workflow в .axint/session; не изменяет исходный код приложения и не использует сеть.

Защищает сессию Xcode агента от сжатия контекста и дрейфа Axint. Проверяет файлы памяти проекта, активную сессию Axint, последний Axint Run или guard proof, а также свежесть длительных задач. Записывает .axint/guard/latest.json и latest.md, чтобы пользователь мог проверить, использовался ли Axint на самом деле во время длительной задачи Xcode. Использование: вызывайте вокруг длительных задач Xcode, при восстановлении контекста, при масштабных правках Swift или перед утверждением runtime proof; вне Xcode используйте workflow.check. Эффекты: записывает .axint/guard proof и может запустить сессию; не редактирует исходный код приложения и не использует сеть.

Записывает файл в проект Xcode через путь Axint guard. Для файлов Swift сразу запускает axint.swift.validate и axint.cloud.check, затем записывает подтверждение .axint/guard/latest.*. Используйте это вместо прямого XcodeWrite, когда агент редактирует Apple-native файлы в ходе длительной задачи. Применение: используйте только для защищённых записей файлов в проекте Xcode; вне Xcode вносите изменения обычным способом и проверяйте после. Результат: записывает запрошенный файл внутри текущей рабочей директории, может создавать каталоги, проверяет Swift и может записывать артефакты guard/check.