lean-ctx 3.7.1

Context Runtime for AI Agents with CCP. 63 MCP tools, 10 read modes, 60+ compression patterns, cross-session memory (CCP), persistent AI knowledge with temporal facts + contradiction detection, multi-agent context sharing, LITM-aware positioning, AAAK compact format, adaptive compression with Thompson Sampling bandits. Supports 24+ AI tools. Reduces LLM token consumption by up to 99%.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

//! Tool handler for `ctx_repomap` — PageRank-based repo map.

use crate::core::repomap;

/// Handle a repo map request.
///
/// - `project_root`: project root path
/// - `max_tokens`: token budget (default 2048)
/// - `focus_files`: optional list of files to boost in ranking
/// - `session_files`: files from the active session (injected by MCP wrapper)
pub fn handle(
    project_root: &str,
    max_tokens: usize,
    focus_files: &[String],
    session_files: &[String],
) -> String {
    let graph = repomap::RepoGraph::build(project_root);

    if graph.files.is_empty() {
        return format!(
            "No indexable files found in '{project_root}'. \
             Ensure it contains source files (.rs, .ts, .py, etc.)."
        );
    }

    let ranked = repomap::rank_symbols(&graph, session_files, focus_files);

    if ranked.is_empty() {
        return format!(
            "No symbols extracted from {} files in '{project_root}'.",
            graph.files.len()
        );
    }

    repomap::fit_to_budget(&ranked, max_tokens)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn nonexistent_root_returns_helpful_message() {
        let result = handle("/tmp/nonexistent_repo_map_test_dir", 2048, &[], &[]);
        assert!(
            result.contains("No indexable files") || result.contains("No symbols"),
            "unexpected: {result}"
        );
    }
}