Skip to content

planner

diapason.learning.spec_search.plan.planner

LearningPlanner: converts a diagnosis into a frozen LearningPlan.

Makes a single structured-output teacher call (no tools, no multi-turn) to generate typed edits for each failure cluster. Post-processes the edits with risk tier assignment and patch/replace downgrade.

See spec §6.

LearningPlanner

Converts a diagnosis into a frozen LearningPlan.

Parameters

teacher_engine : CloudEngine (or mock) for the planner call. teacher_model : Frontier model id. session_id : Current session id. session_dir : Path for persisting plan.json and teacher_traces/plan.jsonl. prompt_reader : Callable that takes a target string and returns the current prompt content. Used by the patch/replace downgrade logic.

run(*, diagnosis_md, clusters)

Execute the plan phase.

Parameters

diagnosis_md : The teacher's diagnosis markdown from phase 1. clusters : Failure clusters from phase 1.

Returns

LearningPlan The frozen plan, also persisted to plan.json.