forgeplan_fpf_rules

Возвращает активный набор правил FPF - деревья условий, которые определяют рекомендации Forgeplan по действиям. Каждое правило имеет имя, приоритет, категорию действия (EXPLORE / INVESTIGATE / EXPLOIT), условие, которое оценивается по состоянию артефакта, и сообщение, объясняющее результирующее действие. Правила загружаются из .forgeplan/config.yaml (fpf.rules), если он присутствует, в противном случае - из встроенных значений по умолчанию (PRD-041).

Категория: База знаний FPF

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

• “Какие правила действуют в этом рабочем пространстве?” - агент хочет получить список перед отладкой неожиданного действия.
• “Покажи мне только правила EXPLORE” - сузить область просмотра при работе с артефактами с низким уровнем доверия.
• “Правило X из конфигурации или из значений по умолчанию?” - используйте source, чтобы определить, загружено ли пользовательское переопределение.
• “Дай мне однострочное резюме каждого правила” - передайте summary: true, чтобы пропустить полные деревья условий.

Категории действий

Движок Forgeplan рекомендует действия на основе пороговых значений R_eff (настраиваемых через fpf.thresholds в конфигурации). Три категории:

Категория	Диапазон R_eff по умолчанию	Значение	Типичные эффекты правил
EXPLORE	R_eff < explore_reff (по умолчанию 0.33)	Доверие слишком низкое - рассматривать как гипотезу	Добавить доказательства, расширить гипотезы, уменьшить объём
INVESTIGATE	explore_reff ≤ R_eff < investigate_reff (по умолчанию 0.66)	Доверие частичное - тестировать, измерять	Запустить бенчмарки, состязательная ревью, сузить гипотезы
EXPLOIT	R_eff ≥ exploit_reff (по умолчанию 0.66)	Доверие высокое - действовать	Выпустить, активировать, заместить, применить

Глубина влияет на пороговые значения: более высокая глубина (Deep / Critical) повышает планку для EXPLOIT, поэтому критический артефакт требует более сильных доказательств, чем тактический, чтобы попасть в ту же категорию.

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

Имя	Тип	Обязательный	Описание
action	string	no	Фильтровать по одной категории: "EXPLORE" / "INVESTIGATE" / "EXPLOIT". Опустите для всех.
name	string	no	Получить одно правило по точному имени. Вызывает ошибку, если не найдено.
summary	bool	no	Если true, возвращает только {name, priority, action} для каждого правила - без деревьев условий и сообщений. По умолчанию false.
source	string	no	Фильтровать по источнику: "config" (пользовательские переопределения) или "default" (встроенные). Полезно для отладки загрузки конфигурации.

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

Возвращает

Полный режим (по умолчанию):

{
  "source_in_use": "config",
  "count": 14,
  "rules": [
    {
      "name": "low_trust_explore",
      "priority": 10,
      "action": "EXPLORE",
      "condition": {
        "all": [
          { "field": "r_eff", "op": "lt", "value": 0.33 },
          { "field": "status", "op": "eq", "value": "draft" }
        ]
      },
      "message": "R_eff below explore threshold; add evidence before deciding.",
      "source": "config"
    }
  ]
}

Режим сводки (summary: true):

{
  "count": 14,
  "rules": [
    { "name": "low_trust_explore",   "priority": 10, "action": "EXPLORE" },
    { "name": "stale_investigate",   "priority": 20, "action": "INVESTIGATE" },
    { "name": "high_trust_exploit",  "priority": 30, "action": "EXPLOIT" }
  ]
}

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

Перечислить все правила:

{}

Только правила EXPLORE, в виде сводки:

{ "action": "EXPLORE", "summary": true }

Получить конкретное правило по имени:

{ "name": "high_trust_exploit" }

Отладка: действительно ли загружены мои переопределения конфигурации?

{ "source": "config" }

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

forgeplan_fpf_rules                  ← инвентаризация
forgeplan_fpf_check { id: "PRD-19" } ← какое правило применяется для этого артефакта
forgeplan_fpf_section { id: "B.3" }  ← почему движок так считает

Эквивалент CLI

• forgeplan fpf rules - тот же список в терминале.

См. также

• Обзор MCP
• forgeplan_fpf_check - оценивает правила для конкретного артефакта
• forgeplan_fpf_list - каталог базы знаний
• forgeplan_score - вычисляет R_eff, с которым сопоставляются правила