forgeplan release

forgeplan release снимает клейм - артефакт возвращается в пул кандидатов, и следующий forgeplan dispatch сможет передать его другому агенту. Команда удаляет файл клейма по пути .forgeplan/claims/<id>.yaml.

По умолчанию команда откажет, если клейм держит другой агент - освободить можно только свою работу. Чтобы перебить ограничение (например, после краха саб-агента, который уже не работает), передайте --force. Вызов release на артефакте без активного клейма - это no-op (нет ошибки, ничего не происходит) - поэтому скрипты очистки могут запускаться без предварительной проверки.

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

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

• Агент закончил артефакт - освобождайте, чтобы следующий раунд диспатча передал его кому-то ещё.
• Агент упал или завис - оркестратор запускает release --force, чтобы освободить слот.
• Агент по ошибке схватил не тот ID - освобождайте сразу и пробуйте заново.
• Cleanup в конце сессии - пройдитесь по активным клеймам и снимите каждый перед выходом.

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

• Чтобы удалить сам артефакт - release снимает только клейм. Для удаления артефакта используйте forgeplan delete.
• Чтобы сократить TTL клейма - release снимает клейм полностью. Для нового TTL просто вызовите forgeplan claim ещё раз с новым значением (для держателя это идемпотентно).
• Чтобы освободить клейм упавшего агента без --force - команда откажет, потому что идентичность не совпадает.

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

forgeplan release [OPTIONS] <ID>

Аргументы

  <ID>  Artifact ID to release

Опции

      --agent <AGENT>  Agent identity. Defaults to `cli/<version>` (or empty when --force)
      --force          Force-release regardless of holder (orchestrator escape hatch)
      --json           Output as JSON for machine consumption
  -h, --help           Print help
  -V, --version        Print version

Примеры

Пример 1: Агент освобождает после завершения

forgeplan release PRD-057

Снимает клейм под дефолтной идентичностью cli/<version>. Повторный вызов на уже освобождённом артефакте - no-op (без ошибки).

Пример 2: Оркестратор подбирает за упавшим агентом

forgeplan release RFC-012 --force

Путь обхода, когда агент умер, но его клейм ещё не истёк. Используйте только из оркестратора - саб-агенты никогда не должны принудительно снимать чужие клеймы.

Пример 3: Явная идентичность для shell-скрипта оркестратора

forgeplan release SPEC-018 --agent worker-2

Когда shell-скрипту нужно освободить клейм от имени конкретного агента, передайте --agent явно. Без --force идентичность должна совпадать с текущим держателем, иначе команда откажет.

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

Замыкает multi-agent цикл: dispatch → claim → работа → release → снова dispatch. После release слот возвращается в пул кандидатов, и следующий вызов forgeplan dispatch сможет передать артефакт другому агенту.

См. также

• forgeplan_release - MCP-эквивалент
• forgeplan claim - взять клейм
• forgeplan claims - посмотреть, кто что держит
• forgeplan dispatch - пере-планировать после release