qxctl: агентная административная командная строка Symphony

qxctl — административный и запросный CLI Symphony на Go, ориентированный прежде всего на агентов. Он оперирует командами; доменные векторы владеют операциями и смыслами, стоящими за ними. Его зафиксированный в репозитории реестр привязывает каждую листовую исполняемую команду к стабильной машинной идентичности и проверенным свидетельствам администрирования возможностей.

Что охватывает qxctl

qxctl реализует администрирование для:

Проверки репозитория и контрактов
Администрирования валидатора, предупреждений, инвариантов, возможностей, жизненного цикла, сеансов, сверки, привязок и Maestro
Администрирования идентичности SSIAG, аудита STAV и производителя Accordare
Реализованной грамматики векторных движков (skvi, sclv, sacv, sodv, ssfv, а также разделы SCV и SHV)

Текущий реестр содержит 373 исполняемые команды.

Безопасная модель вызова

qxctl вызывает точные установки с проверенными квитанциями, используя ограниченные подпроцессы, жёсткие сроки, проверки идентичности и дайджеста ответа, транзакции ожидаемого состояния и долговременное восстановление. Он никогда не принимает пути к адаптерам или «сырые» версии вместо квитанций.

Реестр привязок движков v2

Реестр привязок движков v2 поддерживает восемь установленных ролей движков и ограниченный набор будущих идентичностей ролей. Унаследованное состояние v1 читается параллельно; миграция на v2 требует явной привязанной к дайджесту операции compare-and-swap через qxctl и никогда не является операцией выбора версии.

Команды реестра

Сгенерируйте и проверьте ожидаемый реестр из tools/qxctl:

Registry generation and verification

go run ./cmd/qxctl commands expected --json > COMMANDS.json
go run ./cmd/qxctl commands verify --input COMMANDS.json --json

Установленный клиент может выдавать свидетельства, привязанные к исполняемому файлу:

Manifest from installed qxctl

qxctl commands manifest --json

Ожидаемые свидетельства содержат null вместо версии клиента, дайджеста исполняемого файла и дайджеста квитанции. Наблюдаемые свидетельства привязывают точную версию клиента и дайджест исполняемого файла, а также дайджест квитанции, если он доступен. Обе формы используют symphony.qxctl.command-registry.v1.

qxctl владеет грамматикой и представлением команд. Он не владеет семантикой векторов или канонической истиной знаний. Только проверенные изменения исходного кода утверждают новую идентичность qxcmd, независимо от класса вызывающей стороны.

Группы команд

knowledge

Межвекторный жизненный цикл и администрирование постоянных сеансов SSFV.

lifecycle

Профиль, владение, наблюдение, отчёт, загрузка, применение и восстановление.

engines

Реестр привязок движков и миграция.

reconcile

Сверка рабочих деревьев координатора.

session

Аутентифицированные сеансы и потоки обслуживания SSFV.

maestro

Производный инвентарь рецепторов и свидетельства стыковки.

validate

Защищённая политика предупреждений и администрирование валидатора.

Векторные команды

skvi, sclv, sacv, sodv, ssfv, shv и будущая грамматика accord/evolution.