lean-ctx 3.7.5

Context Runtime for AI Agents with CCP. 69 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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

pub mod ctx_agent;
pub mod ctx_analyze;
pub mod ctx_architecture;
pub mod ctx_artifacts;
pub mod ctx_benchmark;
pub mod ctx_cache;
pub mod ctx_call;
pub mod ctx_callgraph;
pub mod ctx_compile;
pub mod ctx_compose;
pub mod ctx_compress;
pub mod ctx_compress_memory;
pub mod ctx_context;
pub mod ctx_control;
pub mod ctx_cost;
pub mod ctx_dedup;
pub mod ctx_delta;
pub mod ctx_discover;
pub mod ctx_discover_tools;
pub mod ctx_edit;
pub mod ctx_execute;
pub mod ctx_expand;
pub mod ctx_feedback;
pub mod ctx_fill;
pub mod ctx_gain;
pub mod ctx_graph;
pub mod ctx_handoff;
pub mod ctx_heatmap;
pub mod ctx_impact;
pub mod ctx_index;
pub mod ctx_intent;
pub mod ctx_knowledge;
pub mod ctx_ledger;
pub mod ctx_load_tools;
pub mod ctx_metrics;
pub mod ctx_multi_read;
pub mod ctx_multi_repo;
pub mod ctx_outline;
pub mod ctx_overview;
pub mod ctx_pack;
pub mod ctx_plan;
pub mod ctx_plugins;
pub mod ctx_prefetch;
pub mod ctx_preload;
pub mod ctx_proof;
pub mod ctx_provider;
pub mod ctx_radar;
pub mod ctx_read;
pub mod ctx_refactor;
pub mod ctx_repomap;
pub mod ctx_response;
pub mod ctx_retrieve;
pub mod ctx_review;
pub mod ctx_routes;
pub mod ctx_rules;
pub mod ctx_search;
pub mod ctx_semantic_search;
pub mod ctx_session;
pub mod ctx_share;
pub mod ctx_shell;
pub mod ctx_smart_read;
pub mod ctx_smells;
pub mod ctx_symbol;
pub mod ctx_task;
pub mod ctx_tree;
pub mod ctx_url_read;
pub mod ctx_verify;
pub mod ctx_workflow;
pub mod shell_alias;

/// Resolve a relative path against session state (sync version).
/// Thin wrapper over [`crate::core::path_resolve::resolve_tool_path`].
/// Must be called within `tokio::task::block_in_place`.
pub(crate) fn resolve_path_sync(
    session: &crate::core::session::SessionState,
    raw: &str,
) -> Result<String, String> {
    crate::core::path_resolve::resolve_tool_path(
        session.project_root.as_deref(),
        session.shell_cwd.as_deref(),
        raw,
    )
}

#[cfg(test)]
mod adoption_tests {
    use super::*;
    use crate::core::terse::mcp_compress::{compress_description, DescriptionMode};
    use crate::server::tool_trait::McpTool;

    /// Tools that compete with native harness tools must steer the agent toward
    /// the ctx_* equivalent in the FIRST line of their description: under Max
    /// compression (Lazy mode) only the first line survives, so steering placed
    /// later would be dropped and adoption suffers (#168).
    #[test]
    fn native_competing_tools_steer_in_first_line() {
        let tools: Vec<(&str, Box<dyn McpTool>)> = vec![
            ("ctx_read", Box::new(ctx_read::CtxReadTool)),
            ("ctx_search", Box::new(ctx_search::CtxSearchTool)),
            ("ctx_shell", Box::new(ctx_shell::CtxShellTool)),
            ("ctx_tree", Box::new(ctx_tree::CtxTreeTool)),
        ];
        for (name, tool) in tools {
            let def = tool.tool_def();
            let desc = def.description.as_deref().unwrap_or("");
            let first = desc.lines().next().unwrap_or("");

            assert!(
                first.contains("Prefer over native"),
                "{name}: first line must steer toward ctx_* over native: {first:?}"
            );
            assert!(
                first.len() <= 80,
                "{name}: first line is {} bytes (>80 truncates under Lazy mode): {first:?}",
                first.len()
            );

            // Steering must survive Max-compression (Lazy keeps only line 1).
            let lazy = compress_description(name, desc, DescriptionMode::Lazy);
            assert!(
                lazy.contains("native"),
                "{name}: steering lost under Lazy compression: {lazy:?}"
            );
        }
    }
}