agent-file-tools 0.35.2

Agent File Tools — tree-sitter powered code analysis for AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use std::path::Path;

use crate::cache_freshness::{self, FileFreshness, FreshnessVerdict};

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ContributionFreshness {
    Fresh {
        metadata_changed: bool,
        freshness: FileFreshness,
    },
    Stale,
    Deleted,
}

impl ContributionFreshness {
    pub fn is_fresh(self) -> bool {
        matches!(self, ContributionFreshness::Fresh { .. })
    }

    pub fn freshness(self) -> Option<FileFreshness> {
        match self {
            ContributionFreshness::Fresh { freshness, .. } => Some(freshness),
            ContributionFreshness::Stale | ContributionFreshness::Deleted => None,
        }
    }
}

pub fn verify_contribution_file(path: &Path, cached: &FileFreshness) -> ContributionFreshness {
    match cache_freshness::verify_file(path, cached) {
        FreshnessVerdict::HotFresh => ContributionFreshness::Fresh {
            metadata_changed: false,
            freshness: *cached,
        },
        FreshnessVerdict::ContentFresh {
            new_mtime,
            new_size,
        } => ContributionFreshness::Fresh {
            metadata_changed: true,
            freshness: FileFreshness {
                mtime: new_mtime,
                size: new_size,
                content_hash: cached.content_hash,
            },
        },
        FreshnessVerdict::Stale => ContributionFreshness::Stale,
        FreshnessVerdict::Deleted => ContributionFreshness::Deleted,
    }
}

pub fn contribution_is_fresh(path: &Path, cached: &FileFreshness) -> bool {
    verify_contribution_file(path, cached).is_fresh()
}