prompt

type Block struct {
	Name   string
	Always bool
	Render func(in *Input) string
}

type Input struct {
	// Mode is the active engine mode: BUILDER, PLANNER, or MINER.
	Mode string
	// Iteration is the loop iteration (1-based). Blocks that must appear only
	// in the first prompt (pre-flight diagnostics, auto-fix results) check it.
	Iteration int
	// ProjectCtx is the compact structural project overview ("" disables).
	ProjectCtx string
	// RepoMap is the deterministic project map ("" disables).
	RepoMap string
	// Stacks are the repo's detected languages ("go", "node", "ts", ...)
	// with their evidence files. They render a one-line STACK hint ("STACK:
	// go (go.mod, main.go)") and bias the skill-catalog ranking so
	// stack-specific skills follow the repo instead of the model's guess.
	Stacks []Stack
	// Skills is the full installed skill catalog (empty disables the block).
	Skills []SkillEntry
	// UserPrompt is the current turn's query, used to relevance-filter the
	// skills catalog when it exceeds the tuning threshold.
	UserPrompt string
	// ScopeHint is the smart-scope markdown (relevance-ranked files extracted
	// from the user prompt) shown only on iteration 1 so the model focuses
	// exploration. Empty disables.
	ScopeHint string
	// MemoryWarm is the BM25-selected cross-session memory excerpt ("" skips).
	MemoryWarm string
	// KnowledgeHints is the Smart Context Graph summary — a compact list of
	// previously analyzed files related to the current prompt, with their
	// content hashes so the model can skip stale re-reads. "" when knowledge
	// store is disabled or no match.
	KnowledgeHints string
	// NotesHints is the distilled self-aware context — facts/decisions/gotchas/
	// hot files recalled from past sessions (from the notes store). Shown only
	// when relevant so the model starts with verified prior knowledge.
	NotesHints string
	// LSPAvailable is the number of reachable language servers (0 = none).
	LSPAvailable int
	// Preflight holds engine-gathered diagnostics + code windows, shown only
	// on iteration 1 so the cached prefix stays stable afterwards.
	Preflight string
	// PreflightAuto reports fixes the engine already applied pre-turn; the
	// model must not redo them. Shown only on iteration 1.
	PreflightAuto string
	// PlanMode renders the read-only PLAN-pass directive when set.
	PlanMode bool
	// ActivePlan carries the active task plan from .brocode/current_plan.md.
	ActivePlan string
	// AgentPrompt carries custom instructions from an active user-defined CustomAgent.
	AgentPrompt string
	// SessionEditSummary lists files changed in the current session so modes
	// like MINER can reference prior edits without re-scanning. Populated by
	// the engine when tool.ChangesLen() > 0 at turn start.
	SessionEditSummary string
	// ModelTier classifies the active model's instruction-following capability
	// so the prompt builder can inject a proportional number of rules:
	// "weak" (5 rules), "medium" (10 rules), "strong" (full 17 rules).
	// Empty defaults to "strong" (all rules).
	ModelTier string
	// MemoryIndex is a compact table of contents for project memory sections.
	// Always loaded into context so the agent knows WHAT knowledge exists
	// even after compaction. Empty disables.
	MemoryIndex string
	// Tuning carries the runtime surface (block toggles, rule toggles, skill
	// catalog budgets). Nil falls back to DefaultTuning.
	Tuning *Tuning
}

type Rule struct {
	ID   string
	Text string
}

type SkillEntry struct {
	Name        string
	Description string
	Path        string
}

type Stack struct {
	Name  string
	Files []string
}

type Tuning struct {
	// BlockEnabled toggles named blocks off (nil/absent = all enabled).
	// The identity + mode blocks are Always and cannot be disabled.
	BlockEnabled map[string]bool `json:"blocks,omitempty"`
	// RulesOff lists rule IDs to disable, keyed by mode ("BUILDER", "PLANNER",
	// "MINER"). Rule IDs are the stable identifiers in rules.go (b1, b2, ...).
	RulesOff map[string][]string `json:"rules_off,omitempty"`
	// SkillCatalogThreshold: above this many installed skills, the catalog is
	// relevance-filtered instead of listed in full.
	SkillCatalogThreshold int `json:"skill_catalog_threshold"`
	// SkillCatalogCap is the max skills listed when filtering is active.
	SkillCatalogCap int `json:"skill_catalog_cap"`
	// SkillCatalogMin keeps at least this many skills even with a weak prompt.
	SkillCatalogMin int `json:"skill_catalog_min"`
}