forgeplan update

Обновляет метаданные артефакта (заголовок, статус, глубина) или заменяет его содержимое без повторной генерации файла из шаблона. Это низкоуровневый запасной выход, когда вам нужно изменить одно поле, не переписывая весь артефакт.

Для большинства переходов жизненного цикла используйте специализированные команды - они запускают гейты валидации и обеспечивают соблюдение конечного автомата. Используйте update только в том случае, если нет специализированной команды или если вы пишете скрипт для массового редактирования.

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

forgeplan update [OPTIONS] <ID>

Аргументы

  <ID>  Идентификатор артефакта

Опции

      --status <STATUS>  Новый статус (черновик, активный, замещённый, устаревший)
      --title <TITLE>    Новый заголовок
      --depth <DEPTH>    Новая глубина (тактическая, стандартная, глубокая)
      --body <BODY>      Новое содержимое тела (используйте @filepath для чтения из файла)
  -h, --help             Вывести справку
  -V, --version          Вывести версию

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

Загружает markdown-файл из .forgeplan/<kind>s/<id>.md.
Парсит frontmatter и тело.
Применяет предоставленные переопределения (заголовок, статус, глубина, тело).
Перезаписывает файл с обновлённым frontmatter.
Повторно индексирует артефакт в LanceDB, чтобы поиск и граф оставались синхронизированными.

Метка времени updated_at в frontmatter обновляется автоматически.

Примеры

Переименовать артефакт:

forgeplan update PRD-001 --title "Authentication & SSO"

Изменить глубину (например, после переоценки роутинга):

forgeplan update PRD-001 --depth deep

Заменить тело из файла:

forgeplan update NOTE-042 --body @./draft.md

Принудительно установить статус (пропуская конечный автомат жизненного цикла - используйте с осторожностью):

forgeplan update PRD-001 --status active

Предпочитайте команды жизненного цикла для изменения статуса

Прямое редактирование --status обходит гейт валидации. Для PRD / RFC / ADR / Epic / Spec это может создать «активные» артефакты, которые не пройдут forgeplan validate. Вместо этого используйте специализированные команды:

Цель	Команда
черновик → активный	`forgeplan activate`
активный → замещённый	`forgeplan supersede`
активный → устаревший	`forgeplan deprecate`
просроченный → активный	`forgeplan renew`
просроченный → черновик (новая копия)	`forgeplan reopen`

Прямое редактирование markdown-файлов часто быстрее

Поскольку markdown-файлы являются источником истины (ADR-003), редактирование .forgeplan/<kind>s/<id>.md в вашем редакторе с последующим запуском forgeplan scan-import часто является наиболее эргономичным рабочим процессом - особенно для редактирования тела, обновления структурированных полей или пакетных изменений. forgeplan update особенно полезен, когда вы пишете скрипты или хотите избежать открытия файла.

Примечания

Флаг --body заменяет всё тело целиком. Режим частичного редактирования отсутствует.
Используйте префикс @filepath для чтения содержимого тела из файла вместо передачи его непосредственно в командной строке.
После любого прямого редактирования (через CLI или редактор) индекс LanceDB является кешем, а не источником истины. Если вы подозреваете расхождение, запустите forgeplan scan-import для перестроения индекса.

Смотрите также

Обзор CLI
forgeplan activate - предпочтительный способ изменения статуса
forgeplan scan-import - перестроение индекса после прямого редактирования
forgeplan validate - проверка того, что артефакт по-прежнему валиден
Руководство по методологии