Struct FileActivityTracker 

pub struct FileActivityTracker { /* private fields */ }

Tracks file modification activity for timeout detection.

This tracker monitors AI-generated files in the .agent/ directory to detect ongoing work that may not produce stdout/stderr output. It tracks modification times and distinguishes meaningful AI progress from log churn and system artifacts.

Implementations

impl FileActivityTracker

pub const fn new() -> Self

Create a new file activity tracker.

pub fn check_for_recent_activity( &self, workspace: &dyn Workspace, timeout: Duration, ) -> Result<bool>

Check if any AI-generated files have been modified within timeout.

This method scans two areas for evidence of recent agent work:

1. .agent/ whitelist – files representing meaningful AI progress (PLAN.md, ISSUES.md, NOTES.md, STATUS.md, commit-message.txt, .agent/tmp/*.xml).
2. Workspace recursive scan (max depth 8) – any file outside excluded noise directories (.git/, target/, tmp/, node_modules/, .agent/) and excluded extensions (*.log, *.swp, *.tmp, *.bak, *~). This detects coding work (source edits, test writes, Cargo.toml changes) that produces no stdout/stderr output, including files nested deeply inside workspace crates (e.g. crate/src/mod/file.rs).

Returns Ok(true) if recent activity is detected, Ok(false) if no recent activity, or Err if a required directory read fails.

Arguments

• workspace - The workspace to read files from
• timeout - The recency window (typically 300 seconds)

Errors

Returns error if the .agent/ directory exists but cannot be read.

Trait Implementations

impl Default for FileActivityTracker

fn default() -> Self

Returns the “default value” for a type.