PageCraft Folders

Этот skill учит агента управлять папками страниц в PageCraft через V1 REST API: создавать иерархию, переименовывать, перемещать между папками, удалять (каскадно).

Когда применять

• Пользователь просит организовать страницы в папки — построить структуру/иерархию.
• Нужно переименовать или переместить папку.
• Нужно удалить папку — отдельную или вместе со всем содержимым.
• Нужен срез существующей иерархии (плоский список или дерево).

Жёсткие правила

1. Перед folders-delete.mjs без --yes ВСЕГДА вызывай folders-get.mjs <id> — если total_pages_count + total_subfolders_count > 0, скрипт сам остановится и выведет counts. Это защита от случайного каскадного удаления.
2. Перемещение СТРАНИЦЫ между папками — НЕ в этом скилле. Используй pagecraft-pages/scripts/pages-update.mjs с { "folder_id": N | null } в payload. Этот скилл двигает только сами папки.
3. Контракт PUT — точный: «поле не передано» = не менять. «parent_id: null» = переместить папку в корень. Не путай с отсутствием поля.
4. Cross-site move запрещён: parent_id должен указывать на папку того же сайта, иначе 422.
5. Циклы запрещены: нельзя сделать папку потомком самой себя (прямо или транзитивно), иначе 422.