Snippet Mode vs Page Mode — DEJAN Codebase Explorer

Dimension	Snippet Mode	Page Mode
Optimization Target	Extractive grounding snippet	Full webpage content
Artifact Evaluated	3-line search snippet	Full page text with context
Edit Mechanism	Whole-snippet replacement	Line-numbered XML patch edits
Ideator Role	`ideator_snippet`	`ideator_page`
Ranker Role	`ranker` (`RANKER_SYSTEM`)	`ranker` (`PAGE_RANKER_SYSTEM`)
Input Token Cost	Baseline (~2K input tokens/round)	~25× higher (full page input per candidate)
Output Artifact	Optimized search snippet	Content brief with specific line edits
Human-in-the-Loop Mode	Not supported	Supported (`human=True`)

flowchart TD
    subgraph SnippetMode["Snippet Mode (Lightweight)"]
        direction TB
        S_In["Extractive 3-Line Snippet"] --> S_Idea["ideator_snippet"]
        S_Idea --> S_Edit["Whole-Snippet Replacement"]
        S_Edit --> S_Rank["ranker (RANKER_SYSTEM)"]
        S_Rank --> S_Out["Optimized Search Snippet"]
    end

    subgraph PageMode["Page Mode (Deep / HITL)"]
        direction TB
        P_In["Full Webpage Content"] --> P_Idea["ideator_page"]
        P_Idea --> P_Edit["Line-Numbered Patch Edit"]
        P_Edit --> P_Rank["ranker (PAGE_RANKER_SYSTEM)"]
        P_Rank --> P_Out["Content Brief & Edits"]
    end

Referenced by