agentvfs 0.1.6

Virtual filesystem CLI backed by embedded databases 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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! cat command - read file contents.

use clap::Args;
use serde::Serialize;

use crate::commands::Output;
use crate::error::Result;
use crate::fs::FileSystem;
use crate::vault::VaultManager;

#[derive(Args)]
pub struct CatArgs {
    /// Path to the file to read
    pub path: String,

    /// Read a specific version
    #[arg(short, long)]
    pub version: Option<u64>,
}

#[derive(Serialize)]
struct CatOutput {
    path: String,
    content: String,
    size: usize,
    version: Option<u64>,
}

pub fn run(args: CatArgs, output: &Output, vault: Option<String>) -> Result<()> {
    let manager = VaultManager::new()?;
    let backend = match vault {
        Some(name) => manager.open(&name)?,
        None => manager.open_current()?,
    };

    let fs = FileSystem::new(backend.clone());

    let content = if let Some(version_num) = args.version {
        // Read specific version
        let entry = fs.get_entry(&args.path)?;
        if !entry.is_file() {
            return Err(crate::error::VfsError::NotAFile(
                std::path::PathBuf::from(&args.path),
            ));
        }
        backend.get_version_content(entry.id, version_num)?
    } else {
        // Read current version
        fs.read_file(&args.path)?
    };

    if output.is_json() {
        // Try to interpret as UTF-8
        let content_str = String::from_utf8_lossy(&content).to_string();
        output.print_json(&CatOutput {
            path: args.path,
            content: content_str,
            size: content.len(),
            version: args.version,
        });
    } else {
        // Print raw content
        match String::from_utf8(content.clone()) {
            Ok(text) => print!("{}", text),
            Err(_) => {
                // Binary file - print hex dump or error
                eprintln!("(binary file, {} bytes)", content.len());
            }
        }
    }

    Ok(())
}