Skip to main content

lean_ctx/cli/
read_cmd.rs

1use std::path::Path;
2
3use crate::core::compressor;
4use crate::core::deps as dep_extract;
5use crate::core::entropy;
6use crate::core::io_boundary;
7use crate::core::patterns::deps_cmd;
8use crate::core::protocol;
9use crate::core::roles;
10use crate::core::signatures;
11
12fn resolve_cli_path(raw: &str) -> String {
13    if let Ok(abs) = std::path::Path::new(raw).canonicalize() {
14        return abs.to_string_lossy().to_string();
15    }
16    if Path::new(raw).is_relative() {
17        if let Ok(cwd) = std::env::current_dir() {
18            return cwd.join(raw).to_string_lossy().into_owned();
19        }
20    }
21    raw.to_string()
22}
23use crate::core::tokens::count_tokens;
24
25use super::common::print_savings;
26
27pub fn cmd_read(args: &[String]) {
28    if args.is_empty() {
29        eprintln!(
30            "Usage: lean-ctx read <file> [--mode auto|full|map|signatures|aggressive|entropy] [--fresh]"
31        );
32        std::process::exit(1);
33    }
34
35    let raw_path = &args[0];
36    let path = if Path::new(raw_path).is_relative() {
37        std::env::current_dir().ok().map_or_else(
38            || raw_path.clone(),
39            |cwd| cwd.join(raw_path).to_string_lossy().into_owned(),
40        )
41    } else {
42        raw_path.clone()
43    };
44    let path = path.as_str();
45    let mode = args
46        .iter()
47        .position(|a| a == "--mode" || a == "-m")
48        .and_then(|i| args.get(i + 1))
49        .map_or("auto", std::string::String::as_str);
50    let force_fresh = args.iter().any(|a| a == "--fresh" || a == "--no-cache");
51
52    let short = protocol::shorten_path(path);
53
54    // Apply the same secret-path policy in CLI mode as in MCP tools.
55    // Default is warn; enforce depends on active role/policy.
56    if let Ok(abs) = std::fs::canonicalize(path) {
57        match io_boundary::check_secret_path_for_tool("cli_read", &abs) {
58            Ok(Some(w)) => eprintln!("{w}"),
59            Ok(None) => {}
60            Err(e) => {
61                eprintln!("{e}");
62                std::process::exit(1);
63            }
64        }
65    } else {
66        // Best-effort: still check the raw path string.
67        let raw = std::path::Path::new(path);
68        match io_boundary::check_secret_path_for_tool("cli_read", raw) {
69            Ok(Some(w)) => eprintln!("{w}"),
70            Ok(None) => {}
71            Err(e) => {
72                eprintln!("{e}");
73                std::process::exit(1);
74            }
75        }
76    }
77
78    #[cfg(unix)]
79    {
80        #[cfg(unix)]
81        if let Some(out) = crate::daemon_client::try_daemon_tool_call_blocking_text(
82            "ctx_read",
83            Some(serde_json::json!({
84                "path": path,
85                "mode": mode,
86                "fresh": force_fresh,
87            })),
88        ) {
89            let filtered = super::common::filter_daemon_output(&out);
90            if !filtered.trim().is_empty() {
91                println!("{filtered}");
92                return;
93            }
94        }
95    }
96    super::common::daemon_fallback_hint();
97
98    if !force_fresh && mode == "full" {
99        use crate::core::cli_cache::{self, CacheResult};
100        match cli_cache::check_and_read(path) {
101            CacheResult::Hit { entry, file_ref } => {
102                let msg = cli_cache::format_hit(&entry, &file_ref, &short);
103                println!("{msg}");
104                let sent = count_tokens(&msg);
105                super::common::cli_track_read_cached(path, "full", entry.original_tokens, sent);
106                return;
107            }
108            CacheResult::Miss { content } if content.is_empty() => {
109                eprintln!("Error: could not read {path}");
110                std::process::exit(1);
111            }
112            CacheResult::Miss { content } => {
113                let line_count = content.lines().count();
114                println!("{short} [{line_count}L]");
115                println!("{content}");
116                let tok = count_tokens(&content);
117                super::common::cli_track_read(path, "full", tok, tok);
118                return;
119            }
120        }
121    }
122
123    let content = match crate::tools::ctx_read::read_file_lossy(path) {
124        Ok(c) => c,
125        Err(e) => {
126            eprintln!("Error: {e}");
127            std::process::exit(1);
128        }
129    };
130
131    let ext = Path::new(path)
132        .extension()
133        .and_then(|e| e.to_str())
134        .unwrap_or("");
135    let line_count = content.lines().count();
136    let original_tokens = count_tokens(&content);
137
138    let mode = if mode == "auto" {
139        if crate::tools::ctx_read::is_instruction_file(path) {
140            "full".to_string()
141        } else {
142            let sig = crate::core::mode_predictor::FileSignature::from_path(path, original_tokens);
143            let predictor = crate::core::mode_predictor::ModePredictor::new();
144            predictor
145                .predict_best_mode(&sig)
146                .unwrap_or_else(|| "full".to_string())
147        }
148    } else if mode != "full" && crate::tools::ctx_read::is_instruction_file(path) {
149        "full".to_string()
150    } else {
151        mode.to_string()
152    };
153    let mode = mode.as_str();
154
155    match mode {
156        "map" => {
157            let sigs = signatures::extract_signatures(&content, ext);
158            let dep_info = dep_extract::extract_deps(&content, ext);
159
160            let mut output_buf = format!("{short} [{line_count}L]");
161            if !dep_info.imports.is_empty() {
162                output_buf.push_str(&format!("\n  deps: {}", dep_info.imports.join(", ")));
163            }
164            if !dep_info.exports.is_empty() {
165                output_buf.push_str(&format!("\n  exports: {}", dep_info.exports.join(", ")));
166            }
167            let key_sigs: Vec<_> = sigs
168                .iter()
169                .filter(|s| s.is_exported || s.indent == 0)
170                .collect();
171            if !key_sigs.is_empty() {
172                output_buf.push_str("\n  API:");
173                for sig in &key_sigs {
174                    output_buf.push_str(&format!("\n    {}", sig.to_compact()));
175                }
176            }
177            println!("{output_buf}");
178            let sent = count_tokens(&output_buf);
179            print_savings(original_tokens, sent);
180            super::common::cli_track_read(path, "map", original_tokens, sent);
181        }
182        "signatures" => {
183            let sigs = signatures::extract_signatures(&content, ext);
184            let mut output_buf = format!("{short} [{line_count}L]");
185            for sig in &sigs {
186                output_buf.push_str(&format!("\n{}", sig.to_compact()));
187            }
188            println!("{output_buf}");
189            let sent = count_tokens(&output_buf);
190            print_savings(original_tokens, sent);
191            super::common::cli_track_read(path, "signatures", original_tokens, sent);
192        }
193        "aggressive" => {
194            let compressed = compressor::aggressive_compress(&content, Some(ext));
195            println!("{short} [{line_count}L]");
196            println!("{compressed}");
197            let sent = count_tokens(&compressed);
198            print_savings(original_tokens, sent);
199            super::common::cli_track_read(path, "aggressive", original_tokens, sent);
200        }
201        "entropy" => {
202            let result = entropy::entropy_compress(&content);
203            let avg_h = entropy::analyze_entropy(&content).avg_entropy;
204            println!("{short} [{line_count}L] (H̄={avg_h:.1})");
205            for tech in &result.techniques {
206                println!("{tech}");
207            }
208            println!("{}", result.output);
209            let sent = count_tokens(&result.output);
210            print_savings(original_tokens, sent);
211            super::common::cli_track_read(path, "entropy", original_tokens, sent);
212        }
213        _ => {
214            let mut output = format!("{short} [{line_count}L]\n{content}");
215            let config = crate::core::config::Config::load();
216            let level = crate::core::config::CompressionLevel::effective(&config);
217            if level.is_active() {
218                let terse_result = crate::core::terse::pipeline::compress(&output, &level, None);
219                if terse_result.quality_passed && terse_result.savings_pct >= 3.0 {
220                    output = terse_result.output;
221                }
222            }
223            println!("{output}");
224            let sent = count_tokens(&output);
225            super::common::cli_track_read(path, "full", original_tokens, sent);
226        }
227    }
228}
229
230pub fn cmd_diff(args: &[String]) {
231    if args.len() < 2 {
232        eprintln!("Usage: lean-ctx diff <file1> <file2>");
233        std::process::exit(1);
234    }
235
236    let content1 = match crate::tools::ctx_read::read_file_lossy(&args[0]) {
237        Ok(c) => c,
238        Err(e) => {
239            eprintln!("Error reading {}: {e}", args[0]);
240            std::process::exit(1);
241        }
242    };
243
244    let content2 = match crate::tools::ctx_read::read_file_lossy(&args[1]) {
245        Ok(c) => c,
246        Err(e) => {
247            eprintln!("Error reading {}: {e}", args[1]);
248            std::process::exit(1);
249        }
250    };
251
252    let diff = compressor::diff_content(&content1, &content2);
253    let original = count_tokens(&content1) + count_tokens(&content2);
254    let sent = count_tokens(&diff);
255
256    println!(
257        "diff {} {}",
258        protocol::shorten_path(&args[0]),
259        protocol::shorten_path(&args[1])
260    );
261    println!("{diff}");
262    print_savings(original, sent);
263    crate::core::stats::record("cli_diff", original, sent);
264}
265
266pub fn cmd_grep(args: &[String]) {
267    if args.is_empty() {
268        eprintln!("Usage: lean-ctx grep <pattern> [path]");
269        std::process::exit(1);
270    }
271
272    let pattern = &args[0];
273    let raw_path = args.get(1).map_or(".", std::string::String::as_str);
274    let abs_path = resolve_cli_path(raw_path);
275    let path = abs_path.as_str();
276
277    #[cfg(unix)]
278    {
279        #[cfg(unix)]
280        if let Some(out) = crate::daemon_client::try_daemon_tool_call_blocking_text(
281            "ctx_search",
282            Some(serde_json::json!({
283                "pattern": pattern,
284                "path": path,
285            })),
286        ) {
287            let out = super::common::filter_daemon_output(&out);
288            println!("{out}");
289            if out.trim_start().starts_with("0 matches") {
290                std::process::exit(1);
291            }
292            return;
293        }
294    }
295    super::common::daemon_fallback_hint();
296
297    let (out, original) = crate::tools::ctx_search::handle(
298        pattern,
299        path,
300        None,
301        20,
302        crate::tools::CrpMode::effective(),
303        true,
304        roles::active_role().io.allow_secret_paths,
305    );
306    println!("{out}");
307    super::common::cli_track_search(original, count_tokens(&out));
308    if original == 0 && out.trim_start().starts_with("0 matches") {
309        std::process::exit(1);
310    }
311}
312
313pub fn cmd_find(args: &[String]) {
314    if args.is_empty() {
315        eprintln!("Usage: lean-ctx find <pattern> [path]");
316        std::process::exit(1);
317    }
318
319    let raw_pattern = &args[0];
320    let path = args.get(1).map_or(".", std::string::String::as_str);
321
322    let is_glob = raw_pattern.contains('*') || raw_pattern.contains('?');
323    let glob_matcher = if is_glob {
324        glob::Pattern::new(&raw_pattern.to_lowercase()).ok()
325    } else {
326        None
327    };
328    let substring = raw_pattern.to_lowercase();
329
330    let mut found = false;
331    for entry in ignore::WalkBuilder::new(path)
332        .hidden(true)
333        .git_ignore(true)
334        .git_global(true)
335        .git_exclude(true)
336        .max_depth(Some(10))
337        .build()
338        .flatten()
339    {
340        let name = entry.file_name().to_string_lossy().to_lowercase();
341        let matches = if let Some(ref g) = glob_matcher {
342            g.matches(&name)
343        } else {
344            name.contains(&substring)
345        };
346        if matches {
347            println!("{}", entry.path().display());
348            found = true;
349        }
350    }
351
352    crate::core::stats::record("cli_find", 0, 0);
353
354    if !found {
355        std::process::exit(1);
356    }
357}
358
359pub fn cmd_ls(args: &[String]) {
360    let mut raw_path = ".";
361    let mut depth = 3usize;
362    let mut show_hidden = false;
363    let mut i = 0;
364
365    while i < args.len() {
366        let arg = &args[i];
367        if arg == "--depth" {
368            i += 1;
369            if let Some(d) = args.get(i).and_then(|s| s.parse::<usize>().ok()) {
370                depth = d.min(10);
371            }
372        } else if arg == "--all" || arg == "-a" {
373            show_hidden = true;
374        } else if arg.starts_with('-') {
375            eprintln!("Error: lean-ctx ls does not support flag '{arg}'.\n");
376            eprintln!("lean-ctx ls is a compressed directory tree viewer for AI context, not a drop-in ls replacement.");
377            eprintln!("The shell hook (lean-ctx -t ls {arg} ...) passes flags to system ls transparently.\n");
378            eprintln!("Usage: lean-ctx ls [path] [--depth N] [--all]");
379            std::process::exit(1);
380        } else {
381            raw_path = arg;
382        }
383        i += 1;
384    }
385
386    let abs_path = resolve_cli_path(raw_path);
387    let path = abs_path.as_str();
388
389    #[cfg(unix)]
390    {
391        #[cfg(unix)]
392        if let Some(out) = crate::daemon_client::try_daemon_tool_call_blocking_text(
393            "ctx_tree",
394            Some(serde_json::json!({
395                "path": path,
396                "depth": depth,
397                "show_hidden": show_hidden,
398            })),
399        ) {
400            println!("{}", super::common::filter_daemon_output(&out));
401            return;
402        }
403    }
404    super::common::daemon_fallback_hint();
405
406    let (out, _original) = crate::tools::ctx_tree::handle(path, depth, show_hidden);
407    println!("{out}");
408    super::common::cli_track_tree(0, count_tokens(&out));
409}
410
411pub fn cmd_deps(args: &[String]) {
412    let path = args.first().map_or(".", std::string::String::as_str);
413
414    if let Some(result) = deps_cmd::detect_and_compress(path) {
415        println!("{result}");
416        crate::core::stats::record("cli_deps", 0, 0);
417    } else {
418        eprintln!("No dependency file found in {path}");
419        std::process::exit(1);
420    }
421}