llmwiki-tooling 0.1.1

CLI for managing LLM-wikis with Obsidian-style wikilinks.
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

pub mod agent;
pub mod frontmatter_cmd;
pub mod init;
pub mod links;
pub mod lint;
pub mod refs;
pub mod rename;
pub mod sections;

use std::collections::{HashMap, HashSet};
use std::ops::Range;
use std::path::{Path, PathBuf};

/// Edits collected during read phase for later application.
pub(crate) type FileEdits = Vec<(PathBuf, String, Vec<(Range<usize>, String)>)>;

/// Per-directory statistics from scanning markdown files.
#[derive(Default)]
pub(crate) struct DirStats {
    pub file_count: usize,
    pub frontmatter_fields: HashMap<String, usize>,
    pub section_headings: HashMap<String, usize>,
}

/// Check if a path is a markdown file.
pub(crate) fn is_markdown_file(path: &Path) -> bool {
    path.extension().is_some_and(|ext| ext == "md") && path.is_file()
}

/// Check if two slash-separated paths share at least one path component.
pub(crate) fn share_name_component(a: &str, b: &str) -> bool {
    let a_parts: HashSet<&str> = a.split('/').collect();
    let b_parts: HashSet<&str> = b.split('/').collect();
    !a_parts.is_disjoint(&b_parts)
}

/// Detect potential mirror directory pairs based on file count and shared name components.
pub(crate) fn detect_mirror_candidates(dirs: &[(String, usize)]) -> Vec<(&str, &str, usize)> {
    let mut candidates = Vec::new();
    for i in 0..dirs.len() {
        for j in (i + 1)..dirs.len() {
            let (dir_a, count_a) = &dirs[i];
            let (dir_b, count_b) = &dirs[j];
            if count_a == count_b && *count_a > 0 && share_name_component(dir_a, dir_b) {
                candidates.push((dir_a.as_str(), dir_b.as_str(), *count_a));
            }
        }
    }
    candidates
}