forgeplan blocked

Перечисляет артефакты, которые не могут быть продвинуты, потому что одна или несколько их зависимостей ещё не active (или, что хуже, deprecated/stale). Для каждого заблокированного артефакта выводится цепочка блокировщиков, чтобы вы могли точно видеть, что нужно разблокировать.

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

Начало спринта - выявление застрявшей работы до её назначения
Ежедневный стендап - “что ждёт меня?”
Гейт CI - сбой, если что-либо критической глубины заблокировано
Аудит зависимостей во время заморозки релиза

Не использовать, когда

Вам нужен полный порядок выполнения → используйте forgeplan order
Вам нужны слепые пятна качества → используйте forgeplan blindspots
Вам нужен необработанный граф зависимостей → используйте forgeplan graph

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

forgeplan blocked [OPTIONS] [ID]

Аргументы

  [ID]  Конкретный ID артефакта для проверки (необязательно)

Опции

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

Примеры

Показать всё, что заблокировано в рабочем пространстве:

forgeplan blocked

Проверить один конкретный артефакт:

forgeplan blocked PRD-046

Машиночитаемый формат для дашборда:

forgeplan blocked --json | jq '.[] | .id'

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

PRD-046  Docs v0.18.0 catch-up         [draft]
  blocked by:
    RFC-005  Graph expansion           [draft]     ← ещё не active
    ADR-008  Cloudflare Pages choice   [draft]     ← ещё не active

RFC-007  Embed cache policy            [draft]
  blocked by:
    EVID-019 Benchmark results         [missing]   ← ссылка, но не существует

Индикатор	Значение
`[draft]`	Блокировщик существует, но ещё не `active`
`[stale]`	Блокировщик превысил дату `valid_until`
`[deprecated]`	Блокировщик был `deprecated` - обновите связь
`[missing]`	Указанный ID не существует - неработающая ссылка

Код выхода 0, если ничего не заблокировано, 1 в противном случае - удобно для гейтов CI.

Как это вписывается

blocked - это runtime представление графа зависимостей:

order    →  planned sequence (игнорирует статус)
blocked  →  current obstacles (учитывает статус)
graph    →  полная картина

Комбинируйте с order для перепланирования с учётом блокировщиков и с health, чтобы увидеть, какая часть проекта застряла.

См. также

forgeplan order - топологическая последовательность
forgeplan graph - полный граф зависимостей
forgeplan blindspots - решения без доказательств
forgeplan health - сводка по проекту