Method plan_query_with_trace

graphlite/src/plan/optimizer.rs:199–308

Plan a query with detailed tracing for EXPLAIN

(
        &mut self,
        document: &Document,
    )

    /// Plan a query with detailed tracing for EXPLAIN
    pub fn plan_query_with_trace(
        &mut self,
        document: &Document,
    ) -> Result<PlanTrace, PlanningError> {
        let mut tracer = PlanTracer::new();

        // Parse phase (already done, but record it)
        tracer.trace_step(
            PlanningPhase::Parsing,
            "Parse GQL query into AST".to_string(),
            TraceMetadata::empty(),
        );

        // Extract query from document
        let query = match &document.statement {
            crate::ast::Statement::Query(q) => q,
            _ => {
                return Err(PlanningError::InvalidQuery(
                    "Document does not contain a query statement".to_string(),
                ))
            }
        };

        // Generate logical plan
        tracer.start_step(
            PlanningPhase::LogicalPlanGeneration,
            "Create logical plan from AST".to_string(),
        );
        let logical_plan = self.create_logical_plan(query)?;
        tracer.end_step(
            PlanningPhase::LogicalPlanGeneration,
            "Logical plan created successfully".to_string(),
            None,
            None,
            None,
            TraceMetadata::with_estimates(logical_plan.root.estimate_cardinality(), 0.0),
        );

        // Optimize logical plan
        tracer.start_step(
            PlanningPhase::LogicalOptimization,
            "Apply logical optimizations".to_string(),
        );
        let optimized_logical = self.optimize_logical_plan(logical_plan.clone())?;
        tracer.end_step(
            PlanningPhase::LogicalOptimization,
            format!(
                "Applied {} optimization level",
                self.optimization_level_name()
            ),
            None,
            None,
            None,
            TraceMetadata::with_optimization(self.optimization_level_name()),
        );

        // Convert to physical plan
        tracer.start_step(