forgeplan fpf search

forgeplan fpf search запрашивает загруженную базу знаний First Principles Framework, используя тот же гибридный конвейер извлечения, который лежит в основе поиска артефактов - производственный BM25 (через крейт bm25 v2.3.2), объединённый с семантическими векторами BGE-M3. Он выполняет поиск по всем 204 разделам FPF и возвращает ранжированные совпадения с идентификаторами разделов и предварительным просмотром.

Представьте это как forgeplan search, направленный на корпус FPF вместо ваших собственных артефактов.

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

При формировании PRD или ADR - получите контекст First Principles по концепции перед написанием ("trust calculus", "bounded context", "explore exploit").
При аудите решения - проверьте позицию фреймворка по шаблону, который вы рассматриваете.
При онбординге - рассматривайте базу знаний как учебник с возможностью поиска.
При написании промптов forgeplan reason --fpf - предварительно просмотрите, что модель увидит в качестве контекста FPF.

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

Для поиска артефактов - используйте forgeplan search вместо этого.
Для чтения целого раздела - используйте forgeplan fpf section <id>.
Для просмотра полного индекса - используйте forgeplan fpf list.

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

forgeplan fpf search [OPTIONS] <QUERY>

Аргументы

  <QUERY>  Поисковый запрос

Опции

      --limit <LIMIT>  Максимальное количество результатов [по умолчанию: 5]
      --semantic       Использовать семантический векторный поиск (требует --features semantic-search;
                       в противном случае возвращается к поиску по ключевым словам)
  -h, --help           Вывести справку
  -V, --version        Вывести версию

Примеры

# По умолчанию: поиск по ключевым словам BM25, 5 лучших результатов
forgeplan fpf search "trust calculus"

# Расширить окно результатов
forgeplan fpf search "explore exploit tradeoff" --limit 10

# Семантический векторный поиск (возвращается к BM25, если функция semantic-search отключена)
forgeplan fpf search "adversarial review" --semantic

forgeplan fpf search "weakest link"

Как работает конвейер

Поиск FPF использует тот же производственный конвейер версии 0.18.0, что и поиск артефактов:

BM25 (крейт bm25 v2.3.2) - токенизация с русской морфологией (Snowball stemmer), когда срабатывает LanguageMode::Detect.
Удаление шума шаблонов - удаляет стандартные заголовки перед ранжированием, чтобы запросы соответствовали содержательному контенту.
Семантическое слияние - косинусное сходство BGE-M3 накладывается сверху, когда включена функция semantic-search.
Пакетный поиск O(N) - эффективен для корпуса из 204 разделов.

Поскольку механика идентична, те же примечания по настройке и устранению неполадок из руководства по поиску v2 применимы и здесь.

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

fpf search - это интерфейс запросов к базе знаний FPF. Он используется как людьми (инспектирование через CLI), так и forgeplan reason --fpf, который извлекает k лучших разделов в качестве контекста для промпта ADI.

загрузка → поиск → (человек читает ИЛИ reason потребляет) → лучшие решения

Смотрите также

forgeplan fpf - родительская команда
forgeplan fpf section - прочитать конкретный результат
forgeplan fpf list - просмотреть все разделы
forgeplan search - поиск артефактов (тот же конвейер)
Руководство по поиску v2 - как работают BM25 + семантическое слияние
forgeplan reason - ADI с контекстом FPF