forgeplan delete

Окончательно удаляет артефакт из рабочего пространства. Это удаляет файл markdown с диска и каскадно распространяется по индексу LanceDB, удаляя все связи, где артефакт фигурирует как источник или цель.

Удаление является деструктивным и необратимым. Если вы не исправляете настоящую ошибку (например, тестовый артефакт, ID с опечаткой, дубликат), вам почти наверняка потребуется forgeplan deprecate или forgeplan supersede - оба варианта сохраняют историю решений, что является основной целью методологии.

Использование

forgeplan delete [OPTIONS] <ID>

Аргументы

  <ID>  ID артефакта

Опции

      --yes      Пропустить подтверждение
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Что делает команда

1. Интерактивно подтверждает удаление (пропустить с --yes).
2. Удаляет файл markdown из .forgeplan/<kind>s/<id>.md.
3. Удаляет строку артефакта из таблицы artifacts в LanceDB.
4. Каскадно удаляет все связи в таблице links, где артефакт является источником или целью.
5. Оставляет другие артефакты нетронутыми - но они теперь могут ссылаться на удалённый ID.

Примеры

Удалить бесхозную Note после интерактивного подтверждения:

forgeplan delete NOTE-042

Скриптовое удаление (без запроса):

forgeplan delete NOTE-042 --yes

Безопасность: когда НЕ следует удалять

НЕ следует удалять активный артефакт как способ его «отмены». Методология рассматривает отменённые решения как полноценную часть истории - они остаются доступными для обнаружения и объясняют, почему проект пошёл по другому пути.

Ситуация	Вместо этого сделайте
Решение было замещено новым	forgeplan supersede <old> --by <new>
Решение больше не актуально	forgeplan deprecate <id> --reason "..."
Артефакт является сиротой (артефакт без связей) и ещё не содержит контента	Удаление допустимо
Вы создали ID с опечаткой (PRD-0001 вместо PRD-1)	Удаление допустимо
Экспериментальная Note, которая никогда не была связана	Удаление допустимо

Эмпирическое правило: если что-либо ссылается на артефакт, отмените его. Если это тупиковый заглушка без истории, удалите.

Перед удалением - сделайте резервную копию

Каскадное удаление связей нельзя отменить без восстановления git или более раннего экспорта. Перед массовым удалением выполните:

forgeplan export --output backup-$(date +%Y%m%d).json

А для спокойствия:

cp -r .forgeplan .forgeplan-backup-$(date +%Y%m%d)

Затем вы можете выполнить forgeplan import backup.json для восстановления, если пожалеете об операции. См. руководство AGENT-ENFORCEMENT, чтобы узнать, почему rm -rf .forgeplan является запрещённым сокращением.

Примечания

• delete не проверяет, ссылаются ли другие артефакты на цель. Ответственность вызывающего лежит на том, чтобы убедиться, что никакое активное решение не зависит от него.
• Удалённые артефакты немедленно исчезают из forgeplan health, forgeplan list и результатов поиска.
• Если вы удалили по ошибке и ещё не сделали коммит, git checkout .forgeplan/<kind>s/<id>.md с последующим forgeplan scan-import восстановит файл и переиндексирует его.

См. также

• Обзор CLI
• forgeplan deprecate - конечный статус, сохраняет историю
• forgeplan supersede - заменить более новым решением
• forgeplan export - сделать резервную копию перед массовым удалением
• Руководство по методологии