forgeplan renew

forgeplan renew переводит просроченный артефакт обратно в активное состояние, устанавливая новую дату valid_until и записывая причину продления. Каждый артефакт с оценкой, подкреплённой доказательствами, имеет срок действия; когда этот срок истекает, артефакт становится просроченным и помечается forgeplan health. renew - это быстрый путь, когда проверка подтверждает, что решение всё ещё актуально - без переписывания, без преемника, просто расширенное окно действия и примечание, объясняющее, почему команда доверяет ему ещё один цикл.

Когда использовать

Срок valid_until для ADR истёк, но ежеквартальный архитектурный обзор подтвердил, что решение всё ещё действует - продлите срок действия, указав причину со ссылкой на обзор.
PRD стал просроченным во время медленного спринта, но требования не изменились и всё ещё точны.
Окно измерения EvidencePack истекло, но повторный запуск того же бенчмарка дал эквивалентные результаты.
RefreshReport пришёл к выводу «изменения не требуются», и вы хотите, чтобы исходный артефакт отражал этот результат.

Когда НЕ использовать

Решение фактически изменилось - создайте черновик преемника и используйте forgeplan supersede вместо этого.
Вы хотите переоценить проблему с нуля - используйте forgeplan reopen, чтобы отменить старый артефакт и начать новый черновик.
Артефакт больше не актуален вообще - используйте forgeplan deprecate.
Артефакт всё ещё активен и ещё не просрочен - продление не принесёт пользы, пока valid_until фактически не истечёт.

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

forgeplan renew --reason <REASON> --until <UNTIL> <ID>

Аргументы

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

Опции

      --reason <REASON>  Причина продления
      --until <UNTIL>    Новая дата valid_until (YYYY-MM-DD)
  -h, --help             Вывести справку
  -V, --version          Вывести версию

Примеры

Пример 1: Продление ADR после архитектурного обзора

forgeplan renew ADR-001 --reason "still valid after Q2 architecture review, no changes" --until 2026-10-01

Канонический вариант использования: обзор подтвердил, что решение остаётся в силе, поэтому продлите срок действия и зафиксируйте доказательства этого обзора в причине.

Пример 2: Найти и продлить все просроченные артефакты, которые вы хотите сохранить

forgeplan stale
forgeplan renew PRD-004 --reason "requirements unchanged, confirmed with product" --until 2026-12-31
forgeplan renew RFC-006 --reason "implementation phases still on track" --until 2026-09-15

Запустите forgeplan stale, чтобы увидеть полный список просроченных артефактов, затем продлите те, которые прошли проверку.

Пример 3: Краткосрочное продление, пока готовится последующий документ

forgeplan renew ADR-007 --reason "temporary extension until RFC-018 is ratified" --until 2026-05-01

Полезный промежуточный шаг, когда вы знаете, что замена готовится, но текущее решение должно оставаться авторитетным тем временем.

Как это вписывается в рабочий процесс

renew является частью цикла поддержки решений, который работает параллельно с основным циклом Shape → Validate → Code → Evidence → Activate. По мере старения артефактов valid_until постепенно переводит их в просроченное состояние, и forgeplan health выводит их на проверку. Для каждого просроченного артефакта команда выбирает: продлить (всё ещё актуально), заместить (заменено), отменить (выведено из использования) или переоткрыть (переоценить). renew - это самый низкозатратный вариант - он полностью сохраняет исходный документ и обновляет только метаданные срока действия.

Распространённые ошибки

Ошибка	Причина	Исправление
`Artifact is not in stale state`	Всё ещё `активен`, срок действия ещё не истёк	Дождитесь, пока он станет просроченным, или пропустите - `renew` применяется только к просроченным
`--until must be in the future`	Дата сегодня или раньше	Передайте будущую дату в формате `YYYY-MM-DD`
`Invalid date format`	Неправильный формат (например, `10/01/2026`)	Используйте ISO: `2026-10-01`
`Cannot renew terminal artifact`	Уже `отменён` или `замещён`	Конечные состояния являются окончательными - вместо этого создайте новый черновик

См. также

forgeplan stale - список артефактов с истёкшим сроком valid_until
forgeplan reopen - если решение требует переоценки, а не просто продления
forgeplan deprecate - если решение больше не применимо
forgeplan supersede - если замена уже существует
forgeplan health - выявляет просроченные артефакты, требующие внимания
Руководство по жизненному циклу v2
Методология: Жизненный цикл артефакта