Struct OperationContext 

pub struct OperationContext { /* private fields */ }

Context for a single CLI operation (install, update, validate, etc.)

This context object flows through the operation call chain, providing operation-scoped state like warning deduplication. It uses Mutex for interior mutability to support async operations that may span multiple threads.

Thread Safety

This struct is thread-safe and can be shared across async .await points. Uses Mutex for interior mutability, which has minimal overhead since contention is unlikely (warnings are infrequent).

Lifecycle

1. Created at the start of a CLI command (InstallCommand::execute(), etc.)
2. Passed down through resolver → extractor → parser call chain
3. Automatically cleaned up when the operation completes

Examples

use agpm_cli::core::OperationContext;
use std::path::Path;

// Create context at operation start
let ctx = OperationContext::new();

// Use for warning deduplication
if ctx.should_warn_file(Path::new("invalid.md")) {
    eprintln!("Warning: Invalid file");
}

// Same file won't warn again
assert!(!ctx.should_warn_file(Path::new("invalid.md")));

Implementations

impl OperationContext

pub fn new() -> Self

Create a new operation context.

Call this at the start of each CLI operation that needs state tracking.

Examples

use agpm_cli::core::OperationContext;

let ctx = OperationContext::new();

pub fn should_warn_file(&self, path: &Path) -> bool

Check if we should warn about a file and mark it as warned.

Returns true if this is the first warning for this file in this operation, false if we’ve already warned about it (deduplicated).

Deduplication Strategy

Uses filename-based keys (not full paths) to handle different path representations consistently:

• /foo/bar/test.md and ./bar/test.md both key on "test.md"
• This works across worktrees, relative paths, and symlinks

Arguments

• path - Path to the file being processed

Returns

• true - First warning for this file, caller should display the warning
• false - Already warned about this file, caller should skip the warning

Examples

use agpm_cli::core::OperationContext;
use std::path::Path;

let ctx = OperationContext::new();
let path = Path::new("agents/invalid.md");

// First call returns true
assert!(ctx.should_warn_file(path));

// Second call returns false (deduplicated)
assert!(!ctx.should_warn_file(path));

pub fn warning_count(&self) -> usize

Get the count of unique files that have been warned about.

Useful for diagnostics and testing.

Examples

use agpm_cli::core::OperationContext;
use std::path::Path;

let ctx = OperationContext::new();

assert_eq!(ctx.warning_count(), 0);

ctx.should_warn_file(Path::new("file1.md"));
ctx.should_warn_file(Path::new("file2.md"));

assert_eq!(ctx.warning_count(), 2);

Trait Implementations

impl Debug for OperationContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OperationContext

fn default() -> OperationContext

Returns the “default value” for a type.