forgeplan claims

forgeplan claims показывает все активные клеймы в воркспейсе - какой агент сейчас работает над каким артефактом и через сколько истекает его клейм. Клеймы отсортированы по времени до истечения, ближайшие - сверху, чтобы самые срочные слоты бросались в глаза. Истёкшие клеймы пропускаются (считаются освобождёнными).

Команда только читает и не берёт лок: оркестратор может опрашивать её хоть раз в секунду, не замедляя агентов, которые в это же время пишут клеймы. Если файл клейма повреждён или превышает лимит размера, он молча пропускается и попадает в счётчик skipped в выводе - потом forgeplan health это покажет, чтобы можно было прибрать.

Аналог forgeplan_claims на MCP-стороне.

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

• Оркестратор мониторит на каждом раунде планирования: «какая работа сейчас в процессе?».
• Саб-агент перед собственным клеймом: «не опередил ли меня кто-то по этому артефакту?».
• Health-проверка - ненулевой skipped сигнализирует о повреждённых файлах клеймов, требующих внимания.
• Восстановление после краша - посмотреть клеймы, которые никто живой не держит, и принудительно их освободить через forgeplan release --force.

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

• Нужен lifecycle-статус (draft / active / superseded) - это отдельно от клеймов; используйте forgeplan list или forgeplan show <id>.
• Хотите изменить состояние - эта команда только читает. Для записи используйте forgeplan claim и forgeplan release.
• Нужна долгосрочная история - клеймы эфемерны (максимум 24 часа TTL). Для истории запросов используйте forgeplan activity.

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

forgeplan claims [OPTIONS]

Опции

      --json     Output as JSON for machine consumption
  -h, --help     Print help
  -V, --version  Print version

Примеры

Пример 1: Дефолтный text-режим

forgeplan claims

Печатает таблицу живых клеймов, отсортированных по сроку истечения. Типичный вывод:

ID        agent      expires_in   note
PRD-057   worker-1   12m          implementing FR-003
RFC-012   worker-2   58m          -

Пример 2: JSON-вывод для опроса оркестратором

forgeplan claims --json | jq '.claims[] | select(.agent_id == "worker-1")'

Фильтрует активные клеймы до конкретного агента. Полезно в скрипте диспетчера, которому нужно решить - перепланировать новую работу на этого агента или нет.

Пример 3: Найти повреждённые файлы клеймов

forgeplan claims --json | jq '.skipped'

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

Место в рабочем процессе

Это слой мониторинга в multi-agent цикле. Между раундами dispatch оркестратор вызывает claims, чтобы видеть живую работу; каждый саб-агент вызывает её перед собственным claim, чтобы не столкнуться. Совмещайте с forgeplan dispatch - планировщик сам читает клеймы внутри себя и исключает уже заклеймённые артефакты из плана.

См. также

• forgeplan_claims - MCP-эквивалент
• forgeplan claim - взять клейм
• forgeplan release - снять клейм
• forgeplan dispatch - план multi-agent работы