Команды компонента

Группа команд component: обнаружение, паспорт, источник и публикация.

Команды компонента

Компонент — одна часть сетапа, одного из восьми kind. Группа component — как эта установка находит нативные файлы, записывает локальный паспорт, привязывает внешний источник и готовит версию к публикации.

Сайт показывает каталог. Он не обнаруживает файл на этой машине, не пишет локальный паспорт и не извлекает embedded-член. Эти шаги остаются в CLI. Выбор, сборка и установка — другие группы.

Повседневная регистрация — intent author. Повседневная публикация — publish. Discover, passport, source и component publish ниже — expert recovery.

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

Дочерние страницы

Страница	Что покрывает
Обнаружение и adopt	нативное обнаружение, локальный поиск, scaffold, adopt, forget
Паспорт компонента	show, suggest, update, validate, quality
Источник компонента	parse, resolve, search, архивные наблюдения GitHub
Публикация компонента	promote, version, fork, skill validate

Перед копированием мутирующей команды читайте дочернюю страницу. Этот обзор называет каждый путь component.*. Он не заменяет happy path, поля успеха и отказы на тех страницах.

Что такое компонент

У компонента есть kind, точная версия X.Y, паспорт и источник. Закрытые kind: instruction, skill, mcp, hook, command, agent, plugin, setting и cli. command — именованный slash-вызов; cli — отдельный исполняемый процесс. Память, правила, параметры и вспомогательные инструменты — содержимое instruction, skill или setting. Это не отдельные kind.

Локальный черновик — не опубликованная версия. Adopt пути регистрирует его здесь. Release номера X.Y замораживает текущий head. Публикация всё равно требует серверный план и явное подтверждение. author_verified и component_verified независимы: ни одно не является гарантией безопасности.

Рабочий цикл

discover / find / scaffold plan → apply
→ adopt
→ passport show → suggest → update → validate
→ source parse → resolve → evidence show
→ version release
→ component publish  or  publication plan
→ publication confirm

Пропускайте шаг, только если предыдущий конверт уже сделал его ненужным. Механическую проверку не пропускайте. Не считайте component find поиском по каталогу: это registry search. Не считайте component publish финальной публичной записью: это publication confirm или setup publish confirm.

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

--json глобальный. Это не свойство одной команды. Всегда передавайте его. mutability говорит, что команда делает. confirmation — каким токеном подтверждается решение.

Обнаружение и adopt

Команда	Mutability	Confirmation	Когда
component discover	`read`	`none`	перечислить нативные компоненты в корнях harness и одном проекте
`ai-stp component find`	`read`	`none`	искать в локальном реестре; без модели, без сети
component scaffold plan	`plan`	`none`	показать точные файлы scaffold и digest
component scaffold apply	`apply`	`plan_digest`	создать ровно подтверждённый scaffold
`ai-stp component template render`	`read`	`none`	отрендерить portable-шаблон для одного harness
component adopt	`apply`	`none`	зарегистрировать один найденный путь в локальном реестре
`ai-stp component forget`	`apply`	`none`	пометить зарегистрированный компонент удалённым, историю сохранить

Паспорт

Команда	Mutability	Confirmation	Когда
`ai-stp component passport show`	`read`	`none`	показать текущий локальный черновик паспорта
`ai-stp component passport suggest`	`read`	`none`	предложить факты манифеста, не записывая их
`ai-stp component passport update`	`apply`	`plan_digest`	добавить подтверждённый JSON-patch как новую ревизию
`ai-stp component passport validate`	`read`	`none`	назвать каждый структурный блокер публикации
`ai-stp component passport quality`	`read`	`none`	необязательные подсказки автору; trust не меняет

Источник

Команда	Mutability	Confirmation	Когда
`ai-stp component source parse`	`read`	`none`	разобрать внешний источник как недоверенный intent
`ai-stp component source resolve`	`read`	`none`	привязать GitHub-intent к одному полному commit SHA
`ai-stp component source search`	`read`	`none`	искать имена в каталоге; остальные полосы — по флагу
`ai-stp component source evidence refresh`	`apply`	`none`	обновить официальные архивные наблюдения GitHub
`ai-stp component source evidence show`	`read`	`none`	показать последние локальные архивные наблюдения
`ai-stp component source evidence history`	`read`	`none`	ограниченная append-only история наблюдений

Публикация

Команда	Mutability	Confirmation	Когда
component publish	`plan`	`none`	извлечь один embedded-член в обычный план публикации
`ai-stp component version list`	`read`	`none`	все записанные версии и следующий minor
`ai-stp component version release`	`apply`	`none`	дать текущему head неизменяемый `X.Y`
`ai-stp component fork`	`apply`	`none`	скопировать одну записанную версию под новой идентичностью
`ai-stp component skill validate`	`read`	`none`	проверить skill-пакет по Agent Skills Specification

Токены подтверждения

plan_digest не всегда пишется как --expected-plan-digest. Читайте дескриптор. component scaffold apply берёт --expected-plan-digest. component passport update берёт --expected-revision текущего head. Ни одна из этих команд не берёт --confirm. Boolean рядом с точным digest спрашивал бы одно решение дважды.

component adopt, component forget, component version release и component fork — apply с confirmation: none. Назвать путь, id или версию и есть решение. Не выдумывайте флаг --confirm.

component publish — это plan. Он не делает объект публичным. Подтверждайте возвращённый план на Publication.

Чего эта группа никогда не делает

не пишет нативное состояние harness — это делает только public provider через Установку;
не вызывает model API и не просит ключ модели;
не кладёт секреты, тела .env и токены в паспорт;
не считает author_verified доказательством безопасности версии;
не восстанавливает target из backup — это install plan --action rollback;
не выдаёт доступ к major-линии — это Доступ.

Согласие на непроверенных издателей живёт в Согласии, не здесь. Поиск по каталогу — в Реестре. Сборка смешанного сетапа из каталога, Git, пакета и path-источников — в Командах сетапа.

Типичные отказы

Что видно	Что это значит	Что делать
`AI_STP_VALIDATION_ERROR`	обязательная опция отсутствует или неверна	прочитать дескриптор; добавить названный флаг
`AI_STP_NOT_FOUND`	id, путь или версия здесь нет	сначала discover или find; не угадывать id
`AI_STP_USER_DECISION_REQUIRED`	путь отвечает более чем одному harness или kind	передать `--harness` или `--kind`, как в дескрипторе
`AI_STP_PLAN_STALE`	байты scaffold или паспорта изменились	построить новый план, показать, подтвердить снова
`AI_STP_CONFLICT`	ожидаемая ревизия больше не head	`passport show`, затем новый patch
`AI_STP_AUTH_REQUIRED`	облачному шагу публикации нужна сессия	`task start --intent account --idempotency-key account-session-01 --json`
команды нет в machine help	этой установки её нет	остановиться; не подменять похожей командой

Мутирующая команда без --json смешивает человеческий текст в stdout. Добавьте --json и читайте один конверт.

Связанные страницы

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

ai-stp task intents --json

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

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