tngl 0.2.0

Repo-native TUI graph tool for code relationships
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

mod commands;
mod graph;
mod parser;
mod scanner;
mod tangle;
mod tui;

use anyhow::Result;
use clap::{ArgGroup, Parser, Subcommand};

#[derive(Parser)]
#[command(
    name = "tngl",
    about = "A human-authored, repo-native relational graph tool"
)]
struct Cli {
    #[command(subcommand)]
    command: Command,
}

#[derive(Subcommand)]
enum Command {
    /// Initialise tngl in the current directory
    Init,
    /// Re-scan the file tree and reconcile against graph.tngl
    Update {
        /// Suppress output unless conflicts require user input
        #[arg(long)]
        silent: bool,
    },
    /// Diff the current filesystem against graph.tngl (read-only)
    Status,
    /// Query the graph for specific conditions
    #[command(
        group(
            ArgGroup::new("inspect_query")
                .args([
                    "orphans",
                    "dangling",
                    "edges",
                    "unreachable",
                    "comment_mismatches",
                    "reconcile_comments",
                ])
                .multiple(false)
        )
    )]
    Inspect {
        /// List all isolated nodes (no incoming or outgoing edges)
        #[arg(long)]
        orphans: bool,
        /// List edges pointing to missing files
        #[arg(long)]
        dangling: bool,
        /// Show all edges for a specific node
        #[arg(long)]
        edges: Option<String>,
        /// List nodes not reachable from any other node
        #[arg(long)]
        unreachable: bool,
        /// List mirrored directed/incoming edges with different labels
        #[arg(long)]
        comment_mismatches: bool,
        /// Interactively reconcile mirrored edge label mismatches
        #[arg(long)]
        reconcile_comments: bool,
    },
    /// Mark all unattended orphan nodes as intentional
    MarkOrphans,
    /// List all edges in graph order
    List,
    /// Open tangle/graph.tngl in your editor
    Edit,
    /// Open the interactive TUI canvas
    View {
        /// Launch with a built-in sample graph (no repo required)
        #[arg(long)]
        demo: bool,
    },
    /// Export a static HTML map to tangle/map.html
    Open,
    /// Open the TUI settings panel
    Setup,
}

fn main() -> Result<()> {
    let cli = Cli::parse();

    match cli.command {
        Command::Init => commands::init::run(),
        Command::Update { silent } => commands::update::run(silent),
        Command::Status => commands::status::run(),
        Command::Inspect {
            orphans,
            dangling,
            edges,
            unreachable,
            comment_mismatches,
            reconcile_comments,
        } => {
            if orphans {
                commands::inspect::run_orphans()
            } else if dangling {
                commands::inspect::run_dangling()
            } else if let Some(node) = edges {
                commands::inspect::run_edges(&node)
            } else if unreachable {
                commands::inspect::run_unreachable()
            } else if comment_mismatches {
                commands::inspect::run_comment_mismatches()
            } else if reconcile_comments {
                commands::inspect::run_reconcile_comment_mismatches()
            } else {
                eprintln!(
                    "Specify one of: --orphans, --dangling, --edges <node>, --unreachable, --comment-mismatches, --reconcile-comments"
                );
                Ok(())
            }
        }
        Command::MarkOrphans => commands::intentionalize_orphans::run(),
        Command::List => commands::list::run(),
        Command::Edit => commands::edit::run(),
        Command::View { demo } => commands::view::run(demo),
        Command::Open => commands::open::run(),
        Command::Setup => commands::view::run_setup(),
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use clap::error::ErrorKind;

    #[test]
    fn inspect_rejects_multiple_query_flags() {
        let parsed = Cli::try_parse_from(["tngl", "inspect", "--orphans", "--dangling"]);
        assert!(
            parsed.is_err(),
            "inspect flags should be mutually exclusive"
        );
        let err = parsed.err().expect("expected clap parse error");
        assert_eq!(err.kind(), ErrorKind::ArgumentConflict);
    }

    #[test]
    fn inspect_accepts_single_query_flag() {
        let cli = Cli::try_parse_from(["tngl", "inspect", "--orphans"])
            .expect("single inspect flag should parse");
        match cli.command {
            Command::Inspect { orphans, .. } => assert!(orphans),
            _ => panic!("expected inspect command"),
        }
    }
}