Struct FileMentionResolver 

pub struct FileMentionResolver { /* private fields */ }

File mention resolver for parsing and resolving @ mentions in text.

The resolver parses @filename patterns from text and attempts to resolve them to actual files in the working directory. If a file is found, its content is included in the processed text.

Implementations

impl FileMentionResolver

pub fn new(working_directory: impl Into<PathBuf>) -> Self

Create a new FileMentionResolver with the given working directory.

Arguments

• working_directory - The base directory for resolving relative file paths

Example

let resolver = FileMentionResolver::new("/path/to/project");

pub fn working_directory(&self) -> &Path

Get the working directory.

pub fn parse_mentions(text: &str) -> Vec<String>

Parse @filename patterns from text.

This method extracts all @mentions from the text. It supports:

• Simple mentions: @filename.rs
• Path mentions: @src/main.rs
• Mentions without extensions: @main

Arguments

• text - The text to parse for mentions

Returns

A vector of mention strings (without the @ prefix)

Example

let mentions = FileMentionResolver::parse_mentions("Check @main.rs and @utils");
assert_eq!(mentions, vec!["main.rs", "utils"]);

pub fn try_resolve_path(&self, mention: &str) -> Option<PathBuf>

Try to resolve a file path, attempting common extensions if needed.

This method attempts to find a file matching the mention:

1. First tries the exact path
2. If not found and no extension, tries common extensions

Arguments

• mention - The file mention to resolve (without @ prefix)

Returns

Some(PathBuf) if a matching file is found, None otherwise

pub async fn resolve_mentions( &self, text: &str, ) -> Result<FileMentionResult, ContextError>

Resolve all @ mentions in text and read file contents.

This method:

1. Parses all @mentions from the text
2. Attempts to resolve each mention to a file
3. Reads the content of found files
4. Returns processed text with file contents and list of resolved files

If a file is not found, the mention is left unchanged in the text.

Arguments

• text - The text containing @ mentions

Returns

A FileMentionResult containing the processed text and resolved files

Errors

Returns an error if file reading fails for a resolved file

pub fn resolve_mentions_sync( &self, text: &str, ) -> Result<FileMentionResult, ContextError>

Resolve mentions synchronously (blocking).

This is a convenience method for contexts where async is not available. It uses blocking file I/O.

Arguments

• text - The text containing @ mentions

Returns

A FileMentionResult containing the processed text and resolved files