Отчёты

Отчёт открывает закрытый модерационный кейс об одной точной версии объекта. Это не публичная дискуссия, не GitHub issue и не запись в паспорте. Содержимое ограничено и предварительно просматривается перед отправкой.

Preview ничего не записывает на сервер. Confirm отправляет ровно один предварительный просмотр после --confirm. List показывает закрытые кейсы этой учётной записи. Веб-сайт может открыть кейс того же типа; CLI — это путь, который привязывает точный дайджест содержимого, который у вас уже есть.

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

Команда	Изменяемость	Подтверждение	Когда
ai-stp report preview	plan	none	подготовка и отображение точного ограниченного содержимого без отправки
ai-stp report confirm	apply	explicit_flag	отправка ровно одного предварительного просмотра после явного подтверждения
ai-stp report list	read	none	список закрытых кейсов отчётов текущей учётной записи

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

Предпросмотр

ai-stp report preview \
  --kind component \
  --id <stable_id> \
  --version 1.0 \
  --content-digest sha256:... \
  --idempotency-key <key> \
  --json

--kind — component или setup. --id, --version, --content-digest и --idempotency-key обязательны.

Необязательный контекст, когда он у вас есть:

ai-stp report preview \
  --kind setup \
  --id <stable_id> \
  --version 1.0 \
  --content-digest sha256:... \
  --harness-id codex \
  --harness-version 0.140.1 \
  --provider-version 1.2.3 \
  --operation-id <operation_id> \
  --error-code AI_STP_PRECONDITION_FAILED \
  --validation-snapshot-id <snapshot_id> \
  --diagnostics-file ./diagnostics.txt \
  --vulnerability \
  --idempotency-key <key> \
  --json

--harness-id, --harness-version, --provider-version и --operation-id необязательны. --error-code — связанный зарегистрированный код ошибки. --validation-snapshot-id повторяемый. --diagnostics-file — ограниченный предварительно просмотренный файл UTF-8. --vulnerability отмечает возможную уязвимость безопасности.

Не помещайте секреты, токены, содержимое .env или персональные данные в файл диагностики. Preview показывает ровно то, что было бы отправлено.

Поля успеха: plan_id, plan_digest, report, submitted. report повторяет object_kind, stable_id, version, content_digest, idempotency_key и необязательные поля, которые вы задали. submitted равен false.

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

ai-stp report confirm \
  --plan-id <plan_id> \
  --plan-digest sha256:... \
  --confirm \
  --json

--plan-id, --plan-digest и --confirm обязательны. Дайджест — тот, что вернул preview. Изменившееся содержимое — это новый preview.

Поля успеха: case_id, object_kind, stable_id, version, state, vulnerability, created_at. Кейс закрыт: это не публичная ветка.

Список

ai-stp report list --json

Поля успеха: items, каждый с case_id, object_kind, stable_id, version, state, vulnerability, created_at.

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

registry version --kind component --id <id> --version 1.0
→ скопируйте дайджест содержимого из проверенного паспорта
→ report preview --kind component --id <id> --version 1.0 --content-digest sha256:... --idempotency-key <key>
→ прочитайте содержимое
→ report confirm --plan-id <plan_id> --plan-digest sha256:... --confirm
→ report list

Если preview неверен, не подтверждайте. Создавайте новый preview с новым ключом идемпотентности только тогда, когда намерение действительно отличается.

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

Команда	Поля для чтения
preview	plan_id, plan_digest, report, submitted
confirm	case_id, state, vulnerability, created_at
list	items

Отказы

Что вы видите	Что это означает	Что делать
AI_STP_AUTH_REQUIRED	нет выполненного входа	task start --intent account --idempotency-key account-session-01 --json
AI_STP_USER_DECISION_REQUIRED	--confirm был пропущен	передайте --confirm после чтения preview
AI_STP_VALIDATION_ERROR	отсутствует --kind, --id, --version, --content-digest или --idempotency-key	исправьте запрос
AI_STP_PLAN_STALE	--plan-digest больше не совпадает с сохранённым preview	сделайте preview снова
AI_STP_NOT_FOUND	id плана неизвестен	сначала report preview
AI_STP_CONFLICT	ключ идемпотентности уже именует другое содержимое	новый ключ для нового намерения
AI_STP_PRECONDITION_FAILED	файл диагностики не является ограниченным UTF-8, или дайджест не от этой версии	уменьшите файл; скопируйте дайджест из паспорта версии
помещение токена в диагностику	отчёты не должны содержать секреты	отредактируйте; сделайте preview снова

Отметка об уязвимости не публикует CVE и не удаляет объект сама по себе. Она помечает закрытый кейс. Триаж персоналом выполняется на сервере.

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

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

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

ai-stp task intents --json

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

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