%% planner_state.mmd - section 7 planner state machine (stateDiagram-v2)
%%
%% Placeholders (substituted by render_architecture.load_mermaid):
%%   STATES placeholder:      state declarations (`state Foo { ... }` or
%%                            bare `state`).
%%   TRANSITIONS placeholder: transition list (`A --> B: <label>`).
%%
%% placeholder names are written as bare tokens (no double-curly)
%% so load_mermaid's single-pass str.replace cannot corrupt this header.
%%
%% Renderer selects one of a small library of per-generation state machines
%% (render_architecture._planner_state_for_generation) and fills in the
%% template. BYOP / SEARCH generations skip this section and emit a prose
%% placeholder at call site rather than rendering this template.
stateDiagram-v2
    {{STATES}}

    {{TRANSITIONS}}