Struct CodeTools 

pub struct CodeTools { /* private fields */ }

Code analysis service

Implementations

impl CodeTools

pub fn new(work_dir: Option<PathBuf>) -> CodeTools

Create a new CodeTools.

If work_dir is set, relative paths passed to methods will be resolved against it.

pub fn resolve_path(&self, path: &Path) -> PathBuf

Resolve a path, making it absolute if relative and work_dir is set. Returns the original path if it’s already absolute or no work_dir is configured.

pub fn work_dir(&self) -> Option<&Path>

Get the configured working directory

pub fn stats(&self, path: &Path) -> Result<CodeStats, AppError>

Get code statistics for a directory. Resolves relative paths using the configured work_dir.

pub fn repository_map( &self, root: &Path, max_depth: usize, ) -> Result<RepositoryMap, AppError>

Generate a repository map for root up to max_depth.

Hidden entries and common non-source directories (target, node_modules) are skipped.

pub fn symbols(&self, path: &Path) -> Result<Vec<Symbol>, AppError>

Extract top-level Rust-like symbols from a single file.

This is a lightweight, regex-based approach meant for quick inspection. It is not a full parser.

pub fn references( &self, symbol: &str, root: &Path, ) -> Result<Vec<ReferenceHit>, AppError>

Find references to symbol under root.

This performs a simple word-boundary search (\bSYMBOL\b) and returns line-level hits.

pub fn definition( &self, symbol: &str, root: &Path, ) -> Result<Option<DefinitionHit>, AppError>

Find the first definition of symbol under root.

The search is regex-based (functions/structs/enums/types/consts). If multiple definitions exist, the first encountered in directory traversal order is returned.

pub fn cargo_dependencies( &self, root: &Path, ) -> Result<Vec<DependencyGroup>, AppError>

Parse Rust/Cargo dependencies from a Cargo.toml at root.

If root is a directory, this looks for root/Cargo.toml. If root is a file, it is treated as the manifest.

pub fn cargo_clippy( &self, root: &Path, fix: bool, ) -> Result<CommandResult, AppError>

Run cargo clippy within root and return captured stdout/stderr.

This is intended for local developer tooling (CLI) and should not be used for untrusted inputs.

pub fn cargo_test( &self, root: &Path, filter: Option<&str>, ) -> Result<CommandResult, AppError>

Run cargo test within root and return captured stdout/stderr.

The optional filter is passed as the standard cargo test filter argument.

pub fn glob_search( &self, pattern: &str, root: &Path, max_results: usize, ) -> Result<Vec<GlobMatch>, AppError>

Find all files whose paths (relative to root) match the glob pattern.

Supports ** (any path depth), * (any filename chars), ? (one char). Hidden directories and common build directories (target, node_modules) are skipped.

pub fn grep( &self, pattern: &str, root: &Path, file_glob: Option<&str>, context_lines: usize, case_sensitive: bool, max_matches: usize, ) -> Result<Vec<GrepMatch>, AppError>

Search file contents under root for lines matching the regex pattern.

• file_glob: optional glob to restrict which files are searched (e.g. *.rs)
• context_lines: number of context lines to include before and after each match
• case_sensitive: whether the match is case-sensitive
• max_matches: maximum number of GrepMatch entries to return

pub fn batch_read(&self, paths: &[&str]) -> Vec<BatchReadEntry>

Read multiple files in one call.

Each path is resolved through the configured work_dir. Failures are captured per-entry rather than aborting the batch.

pub fn batch_edit(&self, edits: &[EditOp]) -> Vec<EditOpResult>

Apply multiple str-replace edits across files in one call.

Each EditOp replaces all occurrences of old_str with new_str in the target file. Failures are captured per-entry rather than aborting the batch, so callers must inspect EditOpResult::success for each entry.

pub fn outline(&self, path: &Path) -> Result<Vec<OutlineNode>, AppError>

Return a structured outline of all top-level symbols in path.

This is a lightweight wrapper around Self::symbols that strips the absolute path from each entry so the result is presentation-friendly.

Trait Implementations

impl Default for CodeTools

fn default() -> CodeTools

Returns the “default value” for a type.