Кадастр

Знайте, какая у вас инфраструктура, где что находится и какие правила действуют.

Кадастр — это адресная книга и свод правил для ваших серверов, сервисов, сетей, доменов, репозиториев и политик развёртывания. Он даёт людям и ИИ-агентам одно место, где можно задать такие вопросы, как:

• Где может работать это приложение?

• Оно должно оставаться приватным или может быть публичным?

• Занят ли порт или имя хоста?

• Какой конвейер и репозиторий владеют им?

• Актуален ли ответ, проверен ли он или оспаривается?

Кадастр собирает эти факты вместе, объясняет, откуда взят каждый ответ, и проверяет предлагаемые файлы развёртывания на соответствие вашим правилам.

Это карта, а не панель управления. Кадастр не развёртывает рабочие нагрузки, не изменяет DNS или VPN, не управляет контейнерами и не раскрывает секретные значения. Обновление Кадастра обновляет только карту; он никогда не изменяет вашу рабочую инфраструктуру.

Зачем это нужно?

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

Кадастр превращает эти разрозненные знания в ответы с указанием происхождения и чёткими предупреждениями, когда информация устарела, не проверена или оспаривается. Вместо догадок вызывающий получает подходящие варианты, отклонённые варианты, задействованные правила и доказательства, стоящие за ними.

Прочитайте Что делает Кадастр для простого объяснения и примера.

Related MCP server: codegraph-mcp

Быстрый старт с Docker

Создайте пустой постоянный каталог с помощью образа проекта:

docker run --rm \
  -v cadastre-data:/var/lib/cadastre \
  ghcr.io/thedancingdeveloper-org/cadastre:main \
  init --data-dir /var/lib/cadastre --empty

Затем подтвердите, что он готов:

docker run --rm \
  -v cadastre-data:/var/lib/cadastre \
  ghcr.io/thedancingdeveloper-org/cadastre:main \
  status --data-dir /var/lib/cadastre

Образ main соответствует последней успешной сборке основной ветки. Для производственных развёртываний следует закреплять подписанный неизменяемый дайджест, публикуемый конвейером выпуска. Если пакет не виден вашему Docker-клиенту, выполните аутентификацию в ghcr.io или соберите образ локально.

Чтобы исследовать без создания живого каталога, клонируйте репозиторий и запросите его вымышленный пример:

uv tool install cadastre
cadastre --catalog examples/catalog brief
cadastre --catalog examples/catalog context-for \
  "an internal application that needs a GPU"

Продолжите с Использование Кадастра для настройки каталога, общих команд, коллекторов и удалённого доступа.

Необязательно: реестр работ Manifest

Кадастр также включает опциональный модуль, который отвечает на вопросы что осталось сделать, что важнее всего и было ли это выпущено. Он записывает рабочие элементы, инициативы и ссылки на задачи и запросы на слияние в forge, собирает локальные списки задач Markdown, состояние Git-чекаута и доказательства из GitHub issues/PR, а также сообщает, где декларация и forge расходятся — никогда не записывая в forge.

Он выключен, если каталог не включает его в modules.yaml. Без такого файла схема, документ OpenAPI, справка CLI, HTTP-маршруты и список инструментов MCP идентичны сборке, которая никогда о нём не слышала. См. Использование Кадастра, чтобы включить его, и MANIFEST.md для описания дизайна.

Создан для ИИ-агентов

Этот репозиторий и продукт явно дружелюбны к ИИ.

Кадастр предлагает структурированные интерфейсы MCP, HTTP, CLI JSON, JSON Schema и OpenAPI. Ответы несут происхождение и состояние доверия, а context-for возвращает факты и исключения, относящиеся к одному решению, и check проверяет предлагаемый артефакт перед развёртыванием. AGENTS.md предоставляет инструкции на уровне репозитория для кодирующих агентов.

Такая конструкция даёт агенту полезную достоверную информацию, не превращая Кадастр в плоскость управления инфраструктурой.

Узнать больше

Лицензия

Кадастр доступен по лицензии MIT.