doksnet 1.1.2

A CLI tool for documentation-code mapping verification using cryptographic hashes
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

use anyhow::{anyhow, Result};
use dialoguer::{Confirm, Input};
use uuid::Uuid;

use crate::config::{DoksConfig, Mapping};
use crate::hash::hash_content;
use crate::partition::Partition;

pub fn handle() -> Result<()> {
    // Find the .doks file
    let doks_file_path = DoksConfig::find_doks_file()
        .ok_or_else(|| anyhow!("No .doks file found. Run 'doksnet new' first."))?;

    let mut config = DoksConfig::from_file(&doks_file_path)?;

    println!("📝 Adding new documentation-code mapping");
    println!("Current default documentation file: {}", config.default_doc);

    // Get documentation partition
    let doc_partition_str: String = Input::new()
        .with_prompt("Documentation partition (e.g., README.md:10-20 or README.md:10-20@5-15)")
        .with_initial_text(format!("{}:", config.default_doc))
        .interact_text()?;

    let doc_partition = Partition::parse(&doc_partition_str)?;
    let doc_content = doc_partition
        .extract_content()
        .map_err(|e| anyhow!("Failed to extract documentation content: {}", e))?;

    println!("\n📄 Documentation content preview:");
    println!("---");
    println!("{}", doc_content.chars().take(200).collect::<String>());
    if doc_content.len() > 200 {
        println!("... (truncated)");
    }
    println!("---");

    let confirm_doc = Confirm::new()
        .with_prompt("Is this the correct documentation content?")
        .default(true)
        .interact()?;

    if !confirm_doc {
        println!("❌ Documentation selection cancelled");
        return Ok(());
    }

    // Get code partition
    let code_partition_str: String = Input::new()
        .with_prompt("Code partition (e.g., src/main.rs:15-30 or src/lib.rs:5-25@10-50)")
        .interact_text()?;

    let code_partition = Partition::parse(&code_partition_str)?;
    let code_content = code_partition
        .extract_content()
        .map_err(|e| anyhow!("Failed to extract code content: {}", e))?;

    println!("\n💻 Code content preview:");
    println!("---");
    println!("{}", code_content.chars().take(200).collect::<String>());
    if code_content.len() > 200 {
        println!("... (truncated)");
    }
    println!("---");

    let confirm_code = Confirm::new()
        .with_prompt("Is this the correct code content?")
        .default(true)
        .interact()?;

    if !confirm_code {
        println!("❌ Code selection cancelled");
        return Ok(());
    }

    // Optional description
    let description: String = Input::new()
        .with_prompt("Optional description for this mapping")
        .allow_empty(true)
        .interact_text()?;

    let description = if description.trim().is_empty() {
        None
    } else {
        Some(description.trim().to_string())
    };

    // Generate hashes
    let doc_hash = hash_content(&doc_content);
    let code_hash = hash_content(&code_content);

    // Create mapping
    let mapping = Mapping {
        id: Uuid::new_v4().to_string(),
        doc_partition: doc_partition_str,
        code_partition: code_partition_str,
        doc_hash,
        code_hash,
        description,
    };

    config.add_mapping(mapping);
    config.to_file(&doks_file_path)?;

    println!("✅ Successfully added mapping!");
    println!("📊 Total mappings: {}", config.mappings.len());

    Ok(())
}