forgeplan_fpf_search

Search the FPF (First Principles Framework) knowledge base — 204 structured sections covering reasoning, trust calculus (B.3), ADI cycle (B.5), bounded contexts, and more. The default is BM25 keyword search with Russian morphology; passing semantic: true switches to BGE-M3 vector search when the semantic-search build feature is compiled in, with graceful fallback otherwise.

Category: FPF Knowledge Base

When an agent calls it

Looking up a principle — “what does FPF say about trust calculus?” → agents often hit B.3.
Grounding ADI reasoning — before generating hypotheses, fetch relevant FPF context.
Decision support — fpf_search "explore exploit" surfaces the exploration/exploitation balance rules.
Onboarding — help a new agent discover FPF vocabulary quickly.

The pipeline is identical to regular forgeplan_search: BM25 tokenizer with template noise stripping + Russian Snowball stemmer, optional vector rerank with BGE-M3.

Input parameters

Name	Type	Required	Description
`query`	`string`	yes	Search query (1-8192 chars, trimmed non-empty).
`limit`	`integer`	no (default: `5`, max: `50`)	Max results to return.
`semantic`	`bool`	no (default: `false`)	Use vector search via BGE-M3. Falls back to keyword if `semantic-search` feature is not compiled.

Schema source: crates/forgeplan-mcp/src/server.rs::FpfSearchParams

Returns

{
  "query": "trust calculus",
  "mode": "keyword",
  "results": [
    {
      "id": "B.3",
      "title": "Trust Calculus",
      "score": 9.41,
      "snippet": "Trust is not binary. It is a calculus over evidence, context, and recency…",
      "path": "B. Principles > B.3 Trust Calculus"
    }
  ],
  "total": 5,
  "warning": null
}

On fallback:

{
  "mode": "keyword",
  "warning": "semantic search requested but semantic-search feature not compiled — fell back to keyword"
}

Example invocation

{ "query": "trust calculus", "limit": 5 }

Semantic variant:

{ "query": "how do agents handle uncertainty", "semantic": true }

Typical sequence

forgeplan_fpf_search with the concept you need.
forgeplan_fpf_section with the top id — read full body.
Feed the section into forgeplan_reason for ADI reasoning with FPF grounding.

CLI equivalent

forgeplan fpf search "trust calculus"
forgeplan fpf search "uncertainty" --semantic