Function renderBudgetExplanation

plugins/plugin-eval/src/renderers/markdown.js:353–413

(payload)

}

function renderBudgetExplanation(payload) {
  const budgetPayload = ensureBudgetPayload(payload);
  const budgets = budgetPayload.budgets;
  const whyBullets = [
    `- Budget method: ${budgets.method}.`,
    `- Trigger and invoke tokens matter most because they are closest to always-loaded or frequently-loaded context.`,
    ...(budgets.invocation_policy?.explicit_only_skill_count > 0
      ? [
          `- Explicit-only skills are excluded from trigger and invoke budgets, but their standalone load ceiling is shown separately.`,
        ]
      : []),
    ...(budgetPayload.baselineEvidence
      ? [`- Baseline corpus: skills=${budgetPayload.baselineEvidence.skillSamples}, plugins=${budgetPayload.baselineEvidence.pluginSamples}.`]
      : []),
  ];
  const fixFirst = ["- Nothing to fix from this view alone; use the next step to validate or contextualize the estimate."];

  if (["heavy", "excessive"].includes(budgets.trigger_cost_tokens.band) || ["heavy", "excessive"].includes(budgets.invoke_cost_tokens.band)) {
    fixFirst.unshift("- The active budget is heavy enough that measured usage is worth collecting before tuning copy or structure.");
  }

  return [
    `# Budget Explanation: ${budgetPayload.target.name}`,
    "",
    section("At a Glance", [
      ...renderBudgets(budgets).split("\n"),
    ]),
    "",
    section("Why It Matters", whyBullets),
    "",
    section("Fix First", fixFirst),
    "",
    section("Recommended Next Step", renderNextAction(budgetPayload.nextAction)),
    "",
    section("Details", [
      detailsBlock(
        "Trigger components",
        budgets.trigger_cost_tokens.components.map((component) => `- ${component.label}: ${component.tokens} tokens`).join("\n"),
      ),
      detailsBlock(
        "Invoke components",
        budgets.invoke_cost_tokens.components.map((component) => `- ${component.label}: ${component.tokens} tokens`).join("\n"),
      ),
      detailsBlock(
        "Deferred components",
        budgets.deferred_cost_tokens.components.length > 0
          ? budgets.deferred_cost_tokens.components.map((component) => `- ${component.label}: ${component.tokens} tokens`).join("\n")
          : "- None",
      ),
      budgets.explicit_only_invoke_cost_tokens
        ? detailsBlock(
            "Explicit-only skill components",
            budgets.explicit_only_invoke_cost_tokens.components.length > 0
              ? budgets.explicit_only_invoke_cost_tokens.components.map((component) => `- ${component.label}: ${component.tokens} tokens`).join("\n")
              : "- None",
          )
        : "",
      detailsBlock("Use From Codex Chat", renderWorkflowGuide(budgetPayload.workflowGuide)),