gid-core 0.3.2

Graph-Indexed Development core library — graph-based project management and 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
53
54
55
56
57
58
59
60
61
62
63
64
65

use std::path::Path;
use anyhow::{Context, Result};
use crate::graph::Graph;

/// Load a graph from a YAML file.
pub fn load_graph(path: &Path) -> Result<Graph> {
    let content = std::fs::read_to_string(path)
        .with_context(|| format!("Failed to read graph file: {}", path.display()))?;
    let graph: Graph = serde_yaml::from_str(&content)
        .with_context(|| format!("Failed to parse graph YAML: {}", path.display()))?;
    Ok(graph)
}

/// Save a graph to a YAML file.
pub fn save_graph(graph: &Graph, path: &Path) -> Result<()> {
    // Ensure parent directory exists
    if let Some(parent) = path.parent() {
        std::fs::create_dir_all(parent)?;
    }
    let yaml = serde_yaml::to_string(graph)?;
    std::fs::write(path, yaml)
        .with_context(|| format!("Failed to write graph file: {}", path.display()))?;
    Ok(())
}

/// Find the graph file in a project directory.
/// Searches: .gid/graph.yml, .gid/graph.yaml, graph.yml, graph.yaml
pub fn find_graph_file(project_dir: &Path) -> Option<std::path::PathBuf> {
    let candidates = [
        project_dir.join(".gid/graph.yml"),
        project_dir.join(".gid/graph.yaml"),
        project_dir.join(".gid/graph.db"),
        project_dir.join("graph.yml"),
        project_dir.join("graph.yaml"),
        project_dir.join("graph.db"),
    ];
    candidates.into_iter().find(|p| p.exists())
}

/// Find the graph file by walking up from a starting directory.
/// Like `git` searching for `.git/`, this walks up the directory tree
/// until it finds a `.gid/graph.yml` (or reaches the filesystem root).
pub fn find_graph_file_walk_up(start_dir: &Path) -> Option<std::path::PathBuf> {
    let mut current = start_dir.to_path_buf();
    loop {
        if let Some(found) = find_graph_file(&current) {
            return Some(found);
        }
        if !current.pop() {
            return None;
        }
    }
}

/// Find the `.gid/` directory by walking up from a starting directory.
/// Returns the parent directory that contains `.gid/`, not the `.gid/` path itself.
pub fn find_project_root(start_dir: &Path) -> Option<std::path::PathBuf> {
    find_graph_file_walk_up(start_dir)
        .and_then(|graph_path| {
            // graph_path is like /foo/bar/.gid/graph.yml → parent.parent = /foo/bar
            graph_path.parent()
                .and_then(|gid_dir| gid_dir.parent())
                .map(|p| p.to_path_buf())
        })
}