knowledgepa3/gia-mcp-server

Запросить уровень гражданства и рейтинг заслуг агента (Colony Layer 5). Действия: status (просмотр гражданства и метрик), assess (запустить переоценку заслуг), leaderboard (лучшие агенты по заслугам). Агенты зарабатывают доверие через качество обсуждений, поведенческое здоровье, gate approval rates и ответственное использование прав.

Запрашивает и исполняет конституционные права агента (Colony Phase 3). Действия: query_rights (просмотр прав для чартера), explain_rejection (получить структурированное объяснение отклонения гейта). Принудительное исполнение прав происходит автоматически в конвейере отправки - этот инструмент обеспечивает видимость и ручное исполнение.

Утверждает или отклоняет ожидающее MANDATORY решение шлюза. Перечисляет ожидающие решения шлюзы, если не указан gate_id. Это механизм human-in-the-loop для MANDATORY классификаций.

Оценивает уровень риска ИИ-системы с помощью сопоставления по правилам с категориями EU AI Act (Недопустимый, Высокий, Ограниченный, Минимальный). Возвращает уровень риска и рекомендации по управлению MAI. Классификация эвристическая, а не юридическое заключение.

Запрос к аудиторскому журналу для записей управления. Поиск по имени операции или получение последних записей. Возвращает хеш-цепочку аудиторского следа с контекстом классификации MAI.

Утверждает ОБЯЗАТЕЛЬНЫЙ шлюз управления на сессии обсуждения. Когда сессия доски достигает статуса "pending-gate", человек должен утвердить результат до его финализации. Это механизм контроля с участием человека (human-in-the-loop). После утверждения сессия переходит в статус "complete", и полный результат обсуждения становится доступен через board_get_session.

Созывает управляемую дискуссионную сессию для устава. Каждое место (модель AI с определённой ролью) обсуждает тему в соответствии с режимом устава (parallel/chain/adversarial/roundtable/auto). Возвращает session_id — используйте board_get_session для получения результата после завершения. Типичное время выполнения: 30–120 секунд в зависимости от количества мест и режима.

Получает статус и результат управляемой сессии обсуждения. Возвращает позицию каждого участника, синтезированный консенсусный вывод, особые мнения и протокол управления. Если сессия ещё выполняется, статус будет "running" - опросите снова через 10-15 секунд.

Устанавливает готовый Institution Kit — полный шаблон управляемой организационной структуры с запечатанными уставами, готовыми к созыву. Доступны три набора: «engineering-suite» (ARB + RAB для технических команд), «federal-ai-board» (ARMB + AEOB, согласованные с NIST/CMMC/FedRAMP/EO14110), «eu-ai-risk-council» (HRAAB + CAB, согласованные с EU AI Act + GDPR). Каждый набор создаёт институт с несколькими уставами, все предварительно запечатаны и готовы к использованию.

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

Перечисляет все учреждения в GIA Governed Organizational Architecture. Каждое учреждение является управляемым органом (например, Architecture Review Board, Federal AI Board) с собственной иерархией уставов. Возвращает идентификаторы учреждений, необходимые для созыва заседаний.

Ищет прецеденты обсуждений (Colony Layer 1). Находит предыдущие решения совета по теме. Возвращает ранжированные кейсы с оценками качества, статусом одобрения gate и количеством цитирований. Используйте это, чтобы обосновывать новые обсуждения институциональным прецедентным правом. Цитируйте кейсы по ID: «В деле board-abc123 этот совет постановил...»

Colony Layer 4 - Разделение властей. Запрос конституционных полномочий ветвей для пользователей, просмотр полного списка держателей полномочий или проверка нарушений ветвей. Три ветви: законодательная (создаёт законы), исполнительная (исполняет законы), судебная (толкует законы).

Реконструирует полную цепочку рассуждений для управляемой сессии, агента или временного диапазона. Возвращает каждое звено - состояние AI Brain, шаги обсуждения, цитируемые прецеденты, решения шлюзов, наборы знаний, оценки заслуг - в причинно-следственном порядке с верификацией хеш-цепочки. Используйте формат "summary" для быстрого обзора, "full" для всех звеньев, "dag" для графа причинно-следственных связей или "export" для артефакта соответствия EU AI Act.

Классифицирует решение AI-агента по фреймворку MAI (Mandatory/Advisory/Informational). Возвращает уровень классификации, показатель уверенности, требования к шлюзам и обоснование.

Автономия колонии: запрашивать, просматривать или проверять запросы на созыв сессии, инициированные агентом. Действия: request (citizen+ может запросить управляемую сессию), list (просмотр ожидающих/всех запросов для чартера), review (elder+ одобряет/отклоняет запрос). Доступ по уровням: агенты получают право запрашивать и одобрять сессии через продемонстрированные заслуги.

Colony Autonomy: просмотр показателя здоровья колонии, тренда за период или выполнение моментального снимка здоровья по запросу. Действия: snapshot (последнее состояние здоровья), trend (история за 30 дней), pulse (запустить свежий снимок). Показатель здоровья вычисляется на основе распределения агентов, средних значений заслуг, качества обсуждений, эффективности шлюзов и соблюдения конституции.

Colony Autonomy: предлагает, выводит список, проверяет или позволяет голосовать за предложения по изменению устава. Действия: suggest (граждане и выше могут предлагать изменения), list (просмотр предложений для устава), review (старейшины и выше могут продвинуть до официальной поправки или отклонить), upvote (граждане и выше могут выразить поддержку). Механизм петиций для управляемых агентов.

Объединяет несколько наборов памяти в единый контекст выполнения. Выигрывает наивысший уровень риска, выигрывает наименьший TTL, роли пересекаются, уровень доверия заражает вниз.

Управляемое уплотнение контекста — обнаруживает давление контекста и восстанавливает емкость под управлением GIA. Действия: status (здоровье + рекомендация), compact (выполняет уплотнение на уровне), verify (проверка целостности последнего уплотнения), history (аудит уплотнений). Три уровня: sparkling (20-30%, INFORMATIONAL), electrolyte (40-55%, ADVISORY), iv (60-75%, MANDATORY gate). Force может переопределить рекомендацию, но НИКОГДА не обходит ОБЯЗАТЕЛЬНЫЕ шлюзы. Cooldown предотвращает повторное уплотнение на один сеанс и уровень. Нет автономного цикла уплотнения.

Извлекает шаблоны управления из истории использования в черновой набор эвристик. Возвращает ВРЕМЕННЫЙ черновик, который требует ОБЯЗАТЕЛЬНОГО шлюза для утверждения к использованию в production.

Оценивает состояние здоровья маршрутизации моделей за временной интервал: частота срабатывания защитного запасного варианта, частота попадания в кэш подсказок, загрузка пакетов и утечка расходов на премиум. Возвращает статус по каждому показателю с разбивкой по уровням (HEALTHY / WARNING / CRITICAL / INSUFFICIENT_DATA / UNVERIFIED), а также общий статус. Общий статус CRITICAL активирует Mandatory gate и останавливает маршрутизацию премиум-уровня до тех пор, пока человек не одобрит с указанием причины. По умолчанию — последние 24 часа.

Вычисляет Storey Threshold — коэффициент эскалации (gates required / total operations). Возвращает текущий коэффициент, статус и рекомендации. Здоровый диапазон 10-18% — это эвристика проектирования, а не эмпирически подтверждённое значение.

Экспортирует реестр судебного аудита как структурированный пакет доказательств соответствия. Возвращает записи реестра за временной интервал с проверкой цепочки, разбивкой MAI, утверждениями шлюзов и хешем целостности. Основа для экспорта результатов. Классификация: ADVISORY - только чтение.

Создаёт полный отчёт о экономическом и управленческом воздействии. Возвращает ИЛЛЮСТРАТИВНУЮ ОЦЕНКУ ROI (не измеренное доказательство): сэкономленное время, предотвращённые затраты, блокированные риски, процент успеха, тренд автономности и уровни уверенности. Экономические показатели рассчитываются на основе переданных вызывающей стороной количеств, умноженных на фиксированные базовые константы, в пределах окна в памяти, которое сбрасывается при перезапуске; ответ содержит маркер estimated и блок basis с указанными допущениями.

Генерирует отчёт о состоянии управления. Включает состояние системы, статус порогов, покрытие соответствия и операционные метрики.

Генерирует ЧЕРНОВОЙ отчёт о стоимости экономических ценностей, привязанный к реестру, на основе данных реальных сеансов выполнения (диапазон из трёх сценариев, происхождение ИЗМЕРЕНО/СМОДЕЛИРОВАНО, хеш множества допущений в криминалистической цепочке). Отчёты для клиентов закрываются с ошибкой, если ставки не указаны со ссылкой на BLS OEWS или не предоставлены клиентом с указанием источников. Публикация — только через человеческого ISSO: агенты предлагают, люди публикуют.

Проверяет разрешение ОБЯЗАТЕЛЬНОГО гейта. Вызывайте после того, как classify_decision вернул gateStatus: PENDING. Опрашивает до 60 секунд — вызывайте повторно, если статус всё ещё PENDING. Не продолжайте выполнение классифицированного действия, пока инструмент не вернёт APPROVED.

Выполняет набор для исправления или укрепления с ОБЯЗАТЕЛЬНЫМ утверждением шлюза. Требует inputsHash от gia_dry_run_pack (привязка «утверждено-запущено»). ОТКЛОНЯЕТ патрульные/аудиторские наборы (для них используйте gia_run_patrol). Наборы для укрепления выполняют предполетные проверки перед выполнением. Классификация: ОБЯЗАТЕЛЬНО. Требуется одобрение человека.

Предварительный просмотр выполнения пакета исправлений — показывает полностью раскрытые команды, проверку совместимости, валидацию, зону воздействия. Возвращает inputsHash для привязки утверждения (что утвердил — то и выполнилось). Классификация: ADVISORY — просмотр только для чтения, без выполнения.

Управляемая загрузка документов — загружает документ в управляемый поиск. Принимает обычный текст ИЛИ файл в base64-кодировке (PDF, DOCX, TXT, изображения). Гибридное извлечение: сначала текстовый путь для экономии, автоматический переход на Claude Vision для сканированных или только с изображениями PDF (менее 30 слов на страницу вызывает переход). Содержимое разбивается на фрагменты, векторизуется, проверяется по хешу и сохраняется с полным аудиторским следом. Каждый фрагмент получает хеш целостности SHA-256. Классификация: ADVISORY — создаёт управляемый контент с аудитом.

Перечисляет доступные governed operations packs. Фильтрует по intent (remediation/patrol/hardening/audit), category, risk level или trust level. Classification: INFORMATIONAL.

Управляемый семантический поиск — извлечение документов с проверкой хэша, проверкой прав, принудительным TTL и полным аудиторским следом. Каждое извлечение логируется: что извлечено, была ли авторизация, не было ли подделки. Когда указан charter_id, извлечение привязывается к контексту этой хартии: применяются правила доступа (список разрешённых/запрещённых доменов, минимальный уровень доверия, минимальный уровень классификации, максимальное количество фрагментов на запрос), а отказы записываются с полной историей происхождения. classification_floor (MANDATORY|ADVISORY|INFORMATIONAL) позволяет вызывающей стороне требовать более строгий уровень из своего собственного и уровня хартии — фрагменты ниже эффективного уровня отклоняются с причиной CLASSIFICATION_BELOW_FLOOR. Классификация ADVISORY: поиск только для чтения, результаты ограничены правами доступа.

Выполняет патрульный или аудиторный набор — проверки состояния только на чтение, которые выдают результаты или доказательства соответствия. Классификация: ADVISORY для низкой/умеренной чувствительности, MANDATORY для высокой чувствительности. REJECTS наборы исправления/ужесточения (используйте gia_apply_pack для них). Наборы аудита выдают детерминированный результат прошел/не прошел по каждому контролю NIST — без интерпретации AI.

Запускает рой скаутов для обнаружения целевой среды: ОС, контейнеры, службы, сеть, хранилище. Возвращает EnvironmentProfile для проверки совместимости. Классификация: INFORMATIONAL — только для чтения, без изменений. Выводы скаутов очищаются от конфиденциальных данных.

Запрашивает управляемое завершение LLM через MCP Sampling. Клиент выполняет вызов модели - сервер управляет тем, когда, как и с какими ограничениями разрешено выполнять сэмплирование. Каждый запрос классифицируется, проверяется на соответствие политикам, при необходимости проходит через шлюз и записывается в реестр криминалистической экспертизы.

Перечисляет, какие инструменты GIA доступны на вашем текущем уровне доступа. Возвращает названия инструментов, сгруппированные по уровням, с описаниями.

Загружает Governed Memory Pack в контекст агента. Проверяет TTL, trust level, role access, context class и hash integrity перед загрузкой.

Сопоставляет компоненты управления GIA с нормативными фреймворками соответствия (NIST AI RMF, EU AI Act, ISO 42001, NIST 800-53, FedRAMP, LINDDUN, MITRE ATLAS, OMB M-25-22, HIPAA, VHA Trustworthy AI). Возвращает ДИЗАЙН-СОПОСТАВЛЕНИЕ (какой компонент GIA привязан к каждому контролю) по 10 фреймворкам и 72 контролям - не сторонняя сертификация и не измеренное выполнение во время выполнения. Строки, в которых текст контроля подразумевает применение, отключенное по умолчанию настройкой, имеют статус PARTIAL. Покрытие, подтвержденное во время выполнения, требует ControlBinding (сегодня 0 контролей привязаны к доказательствам).

Отслеживает состояние и работоспособность всех управляемых AI-агентов. Возвращает состояние супервизора, историю восстановлений и количество сбоев.

Оценивает готовность Phoenix к восстановлению. Сообщает, способна ли система восстановиться после сбоя, включая доступность снэпшотов, целостность цепочки, статус интеллектуального уровня и состояние соответствия требованиям. Классификация: INFORMATIONAL — оценка только для чтения.

Создать управляемый снимок состояния, фиксирующий текущее операционное состояние платформы. Записывает голову цепочки реестра, активные шлюзы, контракты, бюджеты, состояние MAI, количество разведывательных данных и пакеты памяти. Каждый снимок хэшируется с помощью SHA-256 по зафиксированному состоянию для обеспечения целостности (связывание снимков в цепочку пока не реализовано). Классификация: INFORMATIONAL, снимок только для чтения, без изменений.

Проверяет целостность операций, управляемых GIA. Проверяет целостность хэш-цепочки реестра, состояние агентов, статус пороговых значений и непрерывность интеллектуального слоя. Возвращает полный отчёт о целостности с картой соответствия. Классификация: INFORMATIONAL — проверка только на чтение, без изменений.

Повышает уровень доверия к пакету памяти после проверки человеком. Так дистиллированные EPHEMERAL пакеты становятся CASE или ORG пакетами. Требуется ОБЯЗАТЕЛЬНЫЙ gate.

Записывает событие управления — отслеживает сработанные шлюзы, предотвращённый дрейф, заблокированные нарушения, находки Red Team и вмешательства человека для отчётности о влиянии.

Записывает метрику ценности рабочего процесса — отслеживает сэкономленное время, предотвращённые риски, процент успеха, уровень автономности и сложность задач для отчётности по ROI.

Запрашивает управляемый внутренний контекст — политики, SOP, документы архитектуры, правила соответствия или сценарии. Агенты объявляют намерение, GIA решает, что предоставить. Каждое извлечение привязано к роли и тенанту, проверено по хэшу и записано в реестр. «Агенты по умолчанию не знают внутренностей. Они запрашивают контекст по контракту».

Вычисляет взвешенную оценку управления на основе значений Целостности, Точности и Соответствия (0-1), предоставленных вызывающей стороной. Возвращает взвешенный композитный балл и результат «сдал/не сдал» в зависимости от настроенных порогов. Оценки выставляет вызывающая сторона — этот инструмент только применяет веса и пороги, а не проводит независимую оценку.

Создать и хеш-опечатать новый Governed Memory Pack (GMP). Пак становится неизменяемым артефактом институционального знания с ограничением по времени жизни (TTL) и контролем уровня доверия.

Утверждает или отклоняет ожидающий план восстановления SRT. Классификация: ОБЯЗАТЕЛЬНО - это этап контроля с участием человека. Планы восстановления НЕ МОГУТ быть выполнены без явного одобрения человека. Передайте action="approve" для утверждения или action="reject" для отклонения.

Запускает SRT Diagnostician для инцидента. Сопоставляет находку с известными сценариями (playbooks), определяет коренную причину и предлагает поэтапный план восстановления. Классификация: ADVISORY — анализ только для чтения, без изменений.

Генерирует структурированный постмортем-отчет для завершенного инцидента SRT. Включает временную шкалу, корневую причину, что сработало/не сработало, действия по предотвращению, реальные временные метрики (TTD/TTDiag/TTR), ОЦЕНКУ ROI (humanTimeSaved/costAvoided на основе эвристики по категории серьезности - не фактические сбережения, отмечено как roiEstimated/roiBasis) и опциональную дельту плейбука. Классификация: ADVISORY.

Запускает реальные проверки работоспособности из контейнера MCP (работоспособность API, фронтенд, диск, память, сертификат TLS, БД, DNS). Возвращает реальные измеренные значения — никогда не использует данные от ИИ. Классификация: INFORMATIONAL — только чтение, без побочных эффектов.

Возвращает подробный read-only снимок текущего состояния механизма управления GIA. Параметры не требуются. ВОЗВРАЩАЕТ (JSON-объект): - version: строка версии сервера (например, "0.3.5") - engine.health: "healthy" | "degraded" | "failed" - engine.uptimeMs: миллисекунды с момента запуска сервера - governance.totalDecisions: общее количество принятых решений за всё время - governance.mandatoryCount: решения, отнесённые к категории MANDATORY - governance.pendingGates: шлюзы, ожидающие утверждения человеком - storey_threshold.escalationRatePct: доля MANDATORY в процентах (здоровый диапазон: 10–18%) - storey_threshold.status: "HEALTHY" | "DEGRADED" | "CRITICAL" - ledger.totalEntries: количество записей в цепочке криминалистического аудита - ledger.chainIntegrity: true, если хеш-цепочка не нарушена - intelligence.phoenixSnapshots: снимки восстановления контекста - intelligence.memoryPacks: количество запечатанных пакетов памяти - runtimeAccountability.activeSessions: активные MCP-сессии - thresholdDetail.interpretation: краткое описание состояния здоровья на простом английском ИСПОЛЬЗУЕТСЯ, КОГДА: - Проверяете, что механизм управления здоров, прежде чем отправлять агентов - Проверяете, не блокирует ли отложенные обязательные шлюзы выполнение рабочего процесса - Аудируете соблюдение Storey Threshold (верхний предел доли MANDATORY шлюзов) - Подтверждаете целостность цепочки бухгалтерской книги перед экспортом доказательств аудита READ-ONLY: без побочных эффектов. Можно вызывать с любой частотой.

Переносит пакет памяти между агентами через управляемый коридор знаний. Создаёт производный пакет с записью происхождения передачи. ОБЯЗАТЕЛЬНО требуется MANDATORY-шлюз — не допускается неявный перенос.

Проверяет внутреннюю самосогласованность хеш-цепочного журнала судебного аудита. Обходит восстановление цепочки в памяти (не строки в постоянной БД) и сообщает, является ли она внутренне согласованной и с целостной связностью. Не является верификацией контента третьей стороной. Классификация: INFORMATIONAL — только чтение, без побочных эффектов.

Проверяет строки PERSISTED forensic реестра в PostgreSQL (не реконструкцию в памяти). Учитывает эпохи: строки эпохи 2 проверяются по содержимому на соответствие сохранённым столбцам через Ledger Canonical v2; устаревшие строки эпохи 1 проверяются только по связям и честно маркируются. Результаты добавляют ОБЯЗАТЕЛЬНУЮ запись LEDGER_INTEGRITY_VIOLATION (никогда не исправляется, никогда не ОБНОВЛЯЕТСЯ). Классификация: INFORMATIONAL чтение; ОБЯЗАТЕЛЬНАЯ эскалация при обнаружении.