pagecraft-block-catalog

⚡ Этот скилл — для вызова через тул Skill(pagecraft-block-catalog), не через Read .../SKILL.md. Если ты сюда попал через Read — остановись, вызови Skill(pagecraft-block-catalog).

PageCraft Block Catalog

Скилл-обёртка над подачей блока в глобальный каталог и отслеживанием модерации. Сам не содержит HTTP-логики — дёргает скрипты pagecraft-api/scripts/. Здесь — правила и флоу.

Что это НЕ

Не путать с pagecraft-block-publish. «Опубликовать блок» (publish) = залить/обновить свой приватный блок в PageCraft. Каталог — это следующий шаг: подать уже опубликованный блок на рассмотрение модератором, чтобы он стал доступен всем (scope=global).

Порядок такой: сначала pagecraft-block-publish (блок получает id), потом этот скилл (заявка в каталог).

Когда триггерится

«отправь в каталог», «подай блок на рассмотрение», «опубликуй в общий/глобальный каталог», «какой статус заявки», «приняли ли блок», «почему отклонили», «отозвать заявку».

Статусы заявки

Статус	Значение
pending	На рассмотрении. Можно отозвать.
approved	Принят — блок в глобальном каталоге (target_global_block_id).
rejected	Отклонён. Причина в review_message — поправить и подать заново.
withdrawn	Отозван автором.

Алгоритм

1. Подать блок в каталог

Блок должен быть уже опубликован (есть id в block.json).

node .claude/skills/pagecraft-api/scripts/submit-block.js blocks/{slug}
# или по числовому id:
node .claude/skills/pagecraft-api/scripts/submit-block.js {id}

Скрипт создаёт заявку (pending) и печатает её ID. Если активная заявка уже есть — API вернёт 409 (нельзя подать дважды).

2. Проверить статус

node .claude/skills/pagecraft-api/scripts/list-submissions.js
# фильтр:
node .claude/skills/pagecraft-api/scripts/list-submissions.js --status rejected

Показывает все заявки владельца ключа. Для rejected печатает причину, для approved — id глобального блока.

3. Если отклонили (rejected)

1. Прочитать review_message (из list-submissions.js --status rejected).
2. Внести правки в блок (через pagecraft-schema-block / pagecraft-markdown-block / pagecraft-block-ssr / pagecraft-block-design).
3. Переопубликовать: pagecraft-block-publish.
4. Подать заново: submit-block.js (шаг 1).

4. Отозвать заявку

Только пока pending:

node .claude/skills/pagecraft-api/scripts/withdraw-submission.js <submission-id>

<submission-id> — ID заявки (из list-submissions.js), не id блока.

Что не делает этот скилл

• Не делает HTTP напрямую — это pagecraft-api.
• Не одобряет/отклоняет заявки — модерация только в админ-UI PageCraft (в публичном API недоступна).
• Не публикует и не правит блок — это pagecraft-block-publish и скиллы-редакторы.

Типичные ошибки

• Подать неопубликованный блок — у блока нет id. Сначала pagecraft-block-publish.
• Повторная подача при активной заявке — 409. Сначала дождаться вердикта или отозвать.
• Путать id блока и id заявки в withdraw-submission.js — нужен id заявки из list-submissions.js.
• Отозвать не-pending заявку — 400. Отзыв возможен только в статусе pending.