forgeplan stale

forgeplan stale находит каждый артефакт, чей valid_until находится в прошлом. Это “просроченные” кандидаты в конечном автомате жизненного цикла - они ещё не были отменены, но их доказательство больше не является актуальным, поэтому R_eff был ограничен значением 0.1 (просроченный, а не отсутствующий).

В отличие от decay, который показывает предстоящие истечения срока действия, stale реактивен: он перечисляет те, которые вы уже пропустили. Запускайте его в начале сессии, чтобы вы могли renew или reopen их до начала новой работы.

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

В начале сессии, сразу после forgeplan health - устраните просроченную задолженность перед новой работой.
Импорт в “коричневом поле” (Brownfield import) - посмотрите, какие импортированные артефакты уже просрочены.
Перед тем как полагаться на ADR - это решение всё ещё действительно?
CI pipeline (с --json) - предупреждайте, если просроченные артефакты упоминаются в новом коде.

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

В качестве гейта качества при activate - используйте validate и review вместо этого.
Для Note (они автоматически истекают через 90 дней и по умолчанию всё равно скрыты).

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

forgeplan stale [OPTIONS]

Опции

      --json     Вывод в формате JSON для машинной обработки
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Найти все просроченные артефакты

forgeplan stale

Вывод:

Stale artifacts (valid_until expired)
─────────────────────────────────────
ADR-002  LanceDB schema v2    expired  12d ago   R_eff: 0.90 → 0.10
PRD-007  Search intelligence  expired  45d ago   R_eff: 0.80 → 0.10
ADR-004  Auth token strategy  expired   3d ago   R_eff: 1.00 → 0.10

3 artifacts need renewal or reopening

Машиночитаемый формат

forgeplan stale --json | jq '.[] | select(.days_overdue > 30)'

Фильтрует артефакты, просроченные более чем на 30 дней - кандидаты на обновление с высоким приоритетом.

Сортировка в начале сессии

forgeplan health && forgeplan stale
# для каждого просроченного артефакта: renew (продлить) ИЛИ reopen (новый черновик)
forgeplan renew ADR-002 --reason "still valid, extend 6m" --until 2026-10-01
forgeplan reopen PRD-007 --reason "replace with new approach"

Интерпретация вывода

Столбец	Значение
ID / заголовок	идентификатор артефакта
истёк X дн. назад	дней после `valid_until`
Падение R_eff	предыдущий кэшированный R_eff против текущего (ограничен 0.1)

Для каждого просроченного артефакта у вас есть три опции:

renew - решение всё ещё верно; продлите valid_until с новой причиной.
reopen - контекст изменился; создайте новый черновик и отмените старый (связи сохраняются).
deprecate - решение больше не применимо; пометьте его как окончательное с указанием причины.

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

session start → health → stale → renew | reopen | deprecate → start new work

Stale - это ограничитель “не начинайте новую работу, пока накапливается долг”. Протокол Unified Workflow рассматривает устранение просроченных артефактов как обязательное перед началом выполнения задач P0.

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

forgeplan decay - предварительный просмотр предстоящих истечений срока действия
forgeplan renew - продлить valid_until для всё ещё действительных решений
forgeplan reopen - заменить просроченный артефакт новым черновиком (связи)
forgeplan deprecate - конечное состояние для решений, которые больше не действительны
Обзор CLI