Публикация

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

Повседневная публикация — intent publish. Движок drain'ит plan и confirm in-process. Не набирайте publication plan, если вы не восстанавливаете остановившийся план.

ai-stp task start --intent publish --idempotency-key publish-session-01 --json

Следуйте continuations. Expert plan / status / confirm ниже — для операторов, у которых уже есть hash плана.

План не делает версию публичной. Confirm делает. Неудавшаяся проверка не должна оставлять частично опубликованную версию. author_verified по-прежнему не означает, что содержимое безопасно.

Таблица команд

Команда	Изменяемость	Подтверждение	Когда
ai-stp task start --intent publish	apply	none	повседневная публикация; drain plan/confirm
ai-stp attestation sign	apply	explicit_flag	подписание точных тестовых данных, зависящих от учётных данных, активным ключом устройства
publication plan	plan	none	expert: создание неизменяемого серверного плана для одной точной выпущенной версии компонента
ai-stp publication status	read	none	чтение текущего серверного состояния одного плана публикации
publication confirm	apply	explicit_flag	expert: подтверждение одного точного неистёкшего хеша плана публикации

--json — глобальный флаг. Передавайте его всегда.

attestation sign требует --confirm. publication confirm требует --plan-hash и --confirm. Для всего графа сетапа используйте setup publish plan / setup publish confirm вместо подтверждения каждого участника вручную.

Подпись аттестации

Подписание наблюдаемых тестовых данных локально. Выходной файл — JSON только для владельца. Команда не загружает его.

ai-stp attestation sign \
  --id <stable_id> \
  --version 1.0 \
  --check-id <check_id> \
  --policy-version <policy> \
  --harness-id codex \
  --harness-version 0.140.1 \
  --provider-version 1.2.3 \
  --test-case-id <case_id> \
  --result passed \
  --output ./attestation.json \
  --confirm \
  --json

Обязательны: --id, --version, --check-id, --policy-version, --harness-id, --harness-version, --provider-version, --test-case-id (повторяемый), --result (passed или failed), --output, --confirm. --tool-version — повторяемый name=version.

Поля успеха: object_digest, subject, check_id, policy_version, harness_id, harness_version, provider_version, test_case_ids, result, account_id, device_id, attested_at, signature, output_path, attestation_digest.

Передайте --output в publication plan --attestation-file позже. Не помещайте секреты в файл аттестации.

План публикации

ai-stp publication plan --id <stable_id> --version 1.0 --json
ai-stp publication plan \
  --id <stable_id> \
  --version 1.0 \
  --attestation-file ./attestation.json \
  --json

--id — стабильный идентификатор выпущенного компонента. --version — точный локальный X.Y. --attestation-file повторяемый.

Версия должна быть уже выпущена (component version release). Устройство активной сессии должно совпадать с подписантом любой прикреплённой аттестации.

Поля успеха: plan_id, plan_hash, state, object_kind, stable_id, version, content_digest, component_verified, policy_version, actor_id, device_id, effects, evidence, expires_at. Читайте effects перед подтверждением. component_verified здесь — это записанный бит плана, а не причина пропустить проверку хеша.

Статус

ai-stp publication status --plan-id <plan_id> --json

--plan-id обязателен. Ответ — то же представление publication-plan. Подтверждайте только неистёкший план, чей plan_hash по-прежнему совпадает.

Подтверждение

ai-stp publication confirm \
  --plan-id <plan_id> \
  --plan-hash sha256:... \
  --confirm \
  --json

--plan-id и --plan-hash обязательны. --confirm — явный флаг. Хеш — тот, что вернул plan. Изменившийся план — это новый план.

Ответ — представление плана в его новом state. Следуйте через publication status, если конверт говорит ждать, или через owner version show, чтобы увидеть публичную версию.

Счастливый путь

task start --intent publish --idempotency-key publish-session-01 --json
→ follow continuations until there are none

Expert (уже есть hash плана):

component passport validate --id <id>
→ component version release --id <id>
→ attestation sign … --output ./attestation.json --confirm   # когда требуются доказательства
→ publication plan --id <id> --version <X.Y> --attestation-file ./attestation.json
→ publication status --plan-id <plan_id>
→ publication confirm --plan-id <plan_id> --plan-hash <hash> --confirm
→ owner version show --kind component --id <id> --version <X.Y>

Встроенный участник:

component publish --from-setup <setup> --setup-version <X.Y> --component-id <id>
→ publication confirm --plan-id <plan_id> --plan-hash <hash> --confirm

Весь граф сетапа: Команды сетапа setup publish plan, затем setup publish confirm --set-digest … --confirm.

Именованные поля успеха

Команда	Поля для чтения
attestation sign	output_path, attestation_digest, signature, result
publication plan / status / confirm	plan_id, plan_hash, state, effects, evidence, expires_at

Также читайте content_digest, component_verified и policy_version в плане. Они должны совпадать с версией, которую вы планировали.

Отказы

Что вы видите	Что это означает	Что делать
AI_STP_AUTH_REQUIRED	нет выполненного входа	task start --intent account --idempotency-key account-session-01 --json
AI_STP_USER_DECISION_REQUIRED	--confirm был пропущен	передайте --confirm после чтения effects
AI_STP_VALIDATION_ERROR	отсутствует --id, --version, --plan-id или --plan-hash	прочитайте дескриптор
AI_STP_PRECONDITION_FAILED	аттестация не привязана к этой версии, устройству и учётной записи	подпишите снова на этом устройстве после входа
AI_STP_PLAN_STALE / истёкший expires_at	план больше не актуален	publication plan снова
AI_STP_PERMISSION_DENIED	эта учётная запись не может публиковать данный id	owner object show
AI_STP_CONFLICT	параллельная публикация той же версии	publication status; не подтверждайте второй хеш
AI_STP_NOT_FOUND	версия никогда не была выпущена локально, или id плана неизвестен	component version list
интерпретация component_verified как безопасности	происхождение и проверки, а не гарантия	читайте Доверие и безопасность

Публичная версия должна происходить из публичного репозитория GitHub на точном коммите и подпути. Происхождение только из локальных источников отклоняется на этапе планирования.

Связанные ссылки

• Публикация компонента
• Команды сетапа
• Объекты владельца
• Оценка
• Публикация
• Авторство
• Проверки безопасности
• Доверие и безопасность
• Карта команд

Флаги берутся из continuation argv

ai-stp task intents --json

Не дампьте help --agent как прелюдию. Флаги текущей задачи — в continuation argv.

Эта страница группирует команды публикации для удобства поиска. Установленный CLI является источником флагов, схем и next_actions. Если эта страница и CLI расходятся, следуйте CLI.