gobby-wiki 0.8.0

Gobby wiki CLI shell
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

use super::types::SynthesisSource;

pub(super) struct FrontmatterFields<'a> {
    pub title: &'a str,
    pub source_kind: &'a str,
    pub handoff_id: &'a str,
    pub synthesis_mode: &'a str,
    pub degraded_sources: &'a [&'a str],
    pub aliases: &'a [String],
    pub extra_tags: &'a [String],
    /// Vault-relative path of the raw source a compile-emitted stub page was
    /// synthesized from (`raw/<src-id>.md`). Recompiles match on it to update
    /// the existing page in place instead of minting a slug-suffixed sibling.
    /// `None` on article pages.
    pub source_path: Option<&'a str>,
}

pub(super) fn render_frontmatter(markdown: &mut String, fields: &FrontmatterFields<'_>) {
    markdown.push_str("---\n");
    markdown.push_str("title: ");
    markdown.push_str(&yaml_scalar(fields.title));
    markdown.push('\n');
    if !fields.aliases.is_empty() {
        markdown.push_str("aliases:\n");
        for alias in fields.aliases {
            markdown.push_str("  - ");
            markdown.push_str(&yaml_scalar(alias));
            markdown.push('\n');
        }
    }
    markdown.push_str("source_kind: ");
    markdown.push_str(&yaml_scalar(fields.source_kind));
    markdown.push('\n');
    markdown.push_str("tags:\n");
    markdown.push_str("  - gwiki\n");
    markdown.push_str("  - compiled\n");
    for tag in fields.extra_tags {
        markdown.push_str("  - ");
        markdown.push_str(&yaml_scalar(tag));
        markdown.push('\n');
    }
    // Compile/upkeep-written pages always (re)enter the lifecycle at draft:
    // fresh content needs a new lint/librarian and audit pass to re-earn
    // reviewed/verified.
    markdown.push_str("lifecycle: draft\n");
    markdown.push_str("compile_handoff: ");
    markdown.push_str(&yaml_scalar(fields.handoff_id));
    markdown.push('\n');
    markdown.push_str("synthesis_mode: ");
    markdown.push_str(&yaml_scalar(fields.synthesis_mode));
    markdown.push('\n');
    if let Some(source_path) = fields.source_path {
        markdown.push_str("source_path: ");
        markdown.push_str(&yaml_scalar(source_path));
        markdown.push('\n');
    }
    if !fields.degraded_sources.is_empty() {
        markdown.push_str("degraded: true\n");
        markdown.push_str("degraded_sources:\n");
        for source in fields.degraded_sources {
            markdown.push_str("  - ");
            markdown.push_str(source);
            markdown.push('\n');
        }
    }
    markdown.push_str("---\n\n");
}

pub(super) fn render_source_excerpts(markdown: &mut String, sources: &[SynthesisSource]) {
    if sources.is_empty() {
        markdown.push_str("No accepted sources were recorded.\n\n");
        return;
    }

    for source in sources {
        markdown.push_str("- ");
        markdown.push_str(&source.title);
        markdown.push_str(": ");
        if let Some(chunk) = source.chunks.first() {
            markdown.push_str(chunk);
        } else {
            markdown.push_str("Accepted source has no extracted body text.");
        }
        markdown.push('\n');
    }
    markdown.push('\n');
}

pub(super) fn render_list_section(markdown: &mut String, title: &str, values: &[String]) {
    markdown.push_str("## ");
    markdown.push_str(title);
    markdown.push_str("\n\n");
    if values.is_empty() {
        markdown.push_str("- None recorded.\n\n");
        return;
    }
    for value in values {
        markdown.push_str("- ");
        markdown.push_str(value);
        markdown.push('\n');
    }
    markdown.push('\n');
}

pub(super) fn yaml_scalar(value: &str) -> String {
    let mut escaped = String::with_capacity(value.len());
    for ch in value.chars() {
        match ch {
            '\\' => escaped.push_str("\\\\"),
            '"' => escaped.push_str("\\\""),
            '\n' => escaped.push_str("\\n"),
            '\r' => escaped.push_str("\\r"),
            '\t' => escaped.push_str("\\t"),
            '\0' => escaped.push_str("\\u0000"),
            '\u{0008}' => escaped.push_str("\\b"),
            '\u{000C}' => escaped.push_str("\\f"),
            '\u{007F}' => escaped.push_str("\\u007f"),
            ch if ch.is_control() => escaped.push_str(&format!("\\u{:04x}", ch as u32)),
            ch => escaped.push(ch),
        }
    }
    format!("\"{escaped}\"")
}