forgeplan_init

Инициализирует новое рабочее пространство Forgeplan в текущем каталоге. Агент вызывает эту команду как первое обращение к MCP, когда обнаруживает проект, у которого еще нет .forgeplan/ - например, после git clone на новой машине или при создании совершенно нового проекта с нуля. Вызовы MCP неявно неинтерактивны (без запросов), что эквивалентно команде CLI forgeplan init -y.

Категория: Рабочее пространство и данные

Когда агент вызывает эту команду

Первый вызов MCP при свежем клонировании - .forgeplan/lance/ еще не существует, агенту нужен рабочий индекс.
Создание нового проекта с нуля - агент будет последовательно вызывать init → new prd → validate.
Восстановление после очистки рабочего пространства - пользователь случайно удалил .forgeplan/; агент воссоздает структуру, а затем вызывает forgeplan_import или forgeplan_scan_import для восстановления.

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

Имя	Тип	Обязательный	Описание
`force`	`bool`	no (по умолчанию: `false`)	Принудительная повторная инициализация, даже если рабочее пространство существует.

Источник схемы: crates/forgeplan-mcp/src/server.rs::InitParams

Возвращает

JSON-объект статуса, подтверждающий создание рабочего пространства. Сообщает, был ли выполнен скан-импорт и сколько артефактов было импортировано. Если force=false и каталог уже содержит .forgeplan/, возвращает объект ошибки, который агент должен показать пользователю, а не молча перезаписывать.

Пример формы ответа:

{
  "ok": true,
  "workspace": "/abs/path/.forgeplan",
  "tables_created": ["artifacts", "links", "evidence"],
  "scan_imported": 0
}

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

{ "force": false, "scan": true }

В типичном контексте агента:

Агент только что клонировал репозиторий, который отслеживает markdown-файлы .forgeplan/*/, но не производный индекс LanceDB. Он запускает init с scan: true, чтобы воссоздать индекс из отслеживаемых файлов.

{ "scan": true }

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

forgeplan_init обычно является самым первым вызовом MCP в новой сессии, за которым следует forgeplan_list или forgeplan_health для проверки состояния. Для деструктивной повторной инициализации агент должен сначала вызвать forgeplan_export, сохранить JSON, и только затем передать force: true.

Эквивалент CLI

forgeplan init - та же операция, интерактивный запрос пропускается с помощью -y

См. также

Обзор MCP
forgeplan_import - восстановление из экспортного JSON
forgeplan_list - проверка рабочего пространства после инициализации