forgeplan_order

Возвращает все артефакты в топологическом порядке - родители перед потомками, основываясь исключительно на структурных связях (based_on, refines, supersedes, contradicts). Каждый узел классифицируется как ready (нет невыполненных предварительных условий) или blocked. Циклы в графе обнаруживаются и сообщаются отдельно.

Категория: Панели мониторинга и Графы

Когда агент вызывает его

• Планирование спринта - сначала работайте со списком ready, чтобы избежать блокировки.
• Планирование релиза - определение порядка активации для пакета артефактов-черновиков.
• Обнаружение циклов - поиск циклических ссылок (например, два PRD взаимно based_on друг друга).
• Проверка импорта - после forgeplan_import убедитесь, что граф является DAG.

Входные параметры

Входные параметры отсутствуют. Вызовите этот инструмент с пустым объектом {}.

Возвращает

{
  "order": [
    { "id": "EPIC-003", "kind": "epic", "ready": true },
    { "id": "PRD-039", "kind": "prd", "ready": true },
    { "id": "RFC-006", "kind": "rfc", "ready": false, "blocked_by": ["PRD-039"] },
    { "id": "ADR-004", "kind": "adr", "ready": false, "blocked_by": ["RFC-006"] }
  ],
  "ready_count": 2,
  "blocked_count": 2,
  "cycles": []
}

Если циклы существуют, они сообщаются:

{
  "order": [...],
  "cycles": [
    ["PRD-042", "PRD-043", "PRD-042"]
  ]
}

Пример вызова

{}

Типичная последовательность

1. forgeplan_order - получить полную последовательность.
2. Выбрать первый узел с ready: true.
3. forgeplan_get → forgeplan_validate → forgeplan_activate.
4. Повторно запустить forgeplan_order - нижестоящие узлы теперь должны стать готовыми.

Эквивалент CLI

forgeplan order

См. также

• forgeplan_blocked - сфокусированный вид только на заблокированных артефактах.
• forgeplan_graph - рендеринг того же графа с помощью Mermaid.
• Руководство по методологии