Method build_context

src/context/builder.rs:32–76

Builds a complete task context for the given query. Pipeline: 1. Extract symbol names from the query 2. Search for matching nodes via FTS and exact name lookup 3. Expand graph around entry points using BFS traversal 4. Extract code blocks by reading source files 5. Build and return `TaskContext`

(
        &self,
        query: &str,
        options: &BuildContextOptions,
    )

    /// 4. Extract code blocks by reading source files
    /// 5. Build and return `TaskContext`
    pub async fn build_context(
        &self,
        query: &str,
        options: &BuildContextOptions,
    ) -> Result<TaskContext> {
        debug_assert!(!query.is_empty(), "build_context called with empty query");
        debug_assert!(options.max_nodes > 0, "max_nodes must be positive");
        // Step 1-3: find relevant subgraph and entry points
        let symbols = extract_symbols_from_query(query);
        let entry_points = self.find_entry_points(query, &symbols, options).await?;
        let subgraph = self.expand_subgraph(&entry_points, options).await?;

        // Step 4: extract code blocks from source files
        let code_blocks = if options.include_code {
            // Share one file-content cache across extract + merge so each
            // source file is read at most once for this request.
            let mut file_cache: HashMap<String, Option<String>> = HashMap::new();
            let blocks = self.extract_code_blocks(&entry_points, options, &mut file_cache);
            if options.merge_adjacent {
                self.merge_adjacent_blocks(blocks, &mut file_cache)
            } else {
                blocks
            }
        } else {
            Vec::new()
        };

        // Collect unique related files
        let related_files = Self::collect_related_files(&subgraph);

        // Build summary
        let summary = Self::build_summary(query, &entry_points, &subgraph);

        let seen_node_ids: Vec<String> = entry_points.iter().map(|n| n.id.clone()).collect();

        Ok(TaskContext {
            query: query.to_string(),
            summary,
            subgraph,
            entry_points,
            code_blocks,
            related_files,
            seen_node_ids,
        })
    }

    /// Finds the relevant subgraph for a query without extracting code blocks.
    ///