forgeplan fpf ingest

forgeplan fpf ingest загружает спецификацию First Principles Framework в базу знаний рабочего пространства. Он разбирает корпус из 204 разделов (части A/B/C), разбивает его на фрагменты, генерирует эмбеддинги с помощью того же конвейера BGE-M3, который используется для поиска артефактов, и записывает результат в таблицу LanceDB по пути .forgeplan/lance/.

Запускайте его один раз для каждого рабочего пространства, обычно сразу после forgeplan init -y. После загрузки становятся доступны fpf search, fpf section, fpf list, fpf rules и fpf check.

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

Сразу после forgeplan init -y - для заполнения базы знаний перед началом любой работы по рассуждению.
После очистки .forgeplan/lance/ - поскольку lance игнорируется git, свежие клоны требуют повторной загрузки.
После обновления Forgeplan, которое включает новые разделы FPF - повторная загрузка для обновления корпуса.
Когда fpf status сообщает, что база знаний просрочена или пуста.

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

Вам не нужно запускать его перед каждой сессией рассуждения; база знаний сохраняется между вызовами.
Не запускайте его параллельно с forgeplan reason --fpf - сначала дождитесь завершения загрузки.
Это не замена для forgeplan scan-import - эта команда перестраивает индекс артефактов, а не базу знаний FPF.

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

forgeplan fpf ingest [OPTIONS]

Опции

      --path <PATH>  Путь к каталогу разделов FPF
  -h, --help         Вывести справку
  -V, --version      Вывести версию

По умолчанию fpf ingest считывает спецификацию FPF, встроенную в бинарный файл Forgeplan. Передайте --path, чтобы загрузить данные из внешнего каталога разделов - это полезно для локальной разработки спецификации FPF или тестирования исправленного корпуса.

Примеры

# Первоначальная настройка - использует встроенную спецификацию
forgeplan init -y
forgeplan fpf ingest

# Повторная загрузка после обновления
forgeplan fpf ingest
forgeplan fpf status

# Загрузка из внешнего каталога разделов FPF
forgeplan fpf ingest --path ./fpf-sections/

Что происходит

Forgeplan находит встроенную спецификацию FPF (поставляется внутри бинарного файла).
Разделы разбираются на структурированные фрагменты (ID, заголовок, часть, тело).
Эмбеддинги генерируются с помощью BGE-M3 (функция с гейтом - корректно переключается на запасной вариант, если semantic-search отключен).
LanceDB записывает одну строку на раздел в таблицу fpf_kb.
Запись статуса помечается временной меткой загрузки и количеством разделов.

При тёплом кеше fastembed вся операция занимает несколько секунд; при холодном запуске стоимость загрузки модели оплачивается один раз.

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

Загрузка - это шаг начальной загрузки для всего остального в forgeplan fpf:

forgeplan fpf ingest      ← однократно
  ├── fpf search          ← работает после загрузки
  ├── fpf section B.3
  ├── fpf list
  ├── fpf rules
  ├── fpf check PRD-XXX
  └── fpf dashboard

Это также необходимое условие для forgeplan reason --fpf, который извлекает контекст первых принципов в промпт ADI.

См. также

forgeplan fpf - родительская команда
forgeplan fpf status - проверка успешности загрузки
forgeplan fpf search - запрос к загруженной базе знаний
forgeplan init - начальная загрузка рабочего пространства, предшествующая загрузке