rhei-cli 0.1.0

Command-line driver for the Rhei agent runtime.
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
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

use rhei_core::ast::Task;

use crate::rhei_output::common::{fmt_prior_list, rhei_groups, title_case_kind, RheiGroup};

pub struct GithubIssuesOutput {
    pub include_content: bool,
    pub include_metadata: bool,
}

impl GithubIssuesOutput {
    /// Render the provided Rhei into a single GitHub-friendly Markdown document.
    pub fn to_markdown(&self, rhei: &rhei_core::ast::Rhei) -> String {
        let mut out = String::new();

        out.push_str("# Rhei: ");
        out.push_str(&rhei.title);
        out.push_str("\n\n");

        for section in &rhei.content_sections {
            // Project-contributed sections are printed inside their rhei's
            // block; only the manifest's own sections belong up here.
            if section.rhei.is_some() {
                continue;
            }
            out.push_str("## ");
            out.push_str(&section.title);
            out.push('\n');
            if !section.content.is_empty() {
                out.push_str(section.content.trim_end());
                out.push('\n');
            }
            out.push('\n');
        }

        let groups = rhei_groups(rhei);
        match groups.as_slice() {
            // A plan that is not a merged project keeps the flat shape: one
            // `## Tasks` chapter, mirroring how it was authored.
            [] => {
                out.push_str("## Tasks\n\n");
                for task in &rhei.tasks {
                    self.render_node(task, 3, &mut out);
                }
            }
            groups => {
                for group in groups {
                    self.render_group(rhei, group, &mut out);
                }
            }
        }

        out.trim_end().to_string()
    }

    /// Render one rhei of a merged project: its heading, its own content
    /// sections, then its tickets — so the document reads workstream by
    /// workstream instead of as one flat list under shared headings.
    fn render_group(&self, rhei: &rhei_core::ast::Rhei, group: &RheiGroup, out: &mut String) {
        out.push_str("## ");
        out.push_str(&group.heading());
        out.push_str("\n\n");

        for section in &rhei.content_sections {
            if section.rhei.as_deref() != Some(group.id.as_str()) || section.content.is_empty() {
                continue;
            }
            out.push_str("### ");
            out.push_str(group.section_title(&section.title));
            out.push('\n');
            out.push_str(section.content.trim_end());
            out.push_str("\n\n");
        }

        let mut empty = true;
        for task in rhei.tasks.iter().filter(|task| group.owns(task)) {
            self.render_node(task, 3, out);
            empty = false;
        }
        if empty {
            // A rhei with no tickets is a real, valid state (a freshly created
            // one). Saying so beats a heading with nothing under it.
            out.push_str("_No tickets yet._\n\n");
        }
    }

    fn render_node(&self, task: &Task, level: u8, out: &mut String) {
        let hashes = "#".repeat(level as usize);
        out.push_str(&hashes);
        out.push(' ');
        out.push_str(&title_case_kind(&task.kind));
        out.push(' ');
        out.push_str(&task.id.to_string());
        out.push_str(": ");
        out.push_str(&task.title);
        out.push('\n');

        if self.include_metadata {
            out.push_str("- State: ");
            out.push_str(&task.state);
            out.push('\n');
            if !task.prior.is_empty() {
                out.push_str("- Prior: ");
                out.push_str(&fmt_prior_list(&task.prior));
                out.push('\n');
            }
            if let Some(ref assignee) = task.assignee {
                out.push_str("- Assignee: ");
                out.push_str(assignee);
                out.push('\n');
            }
        }

        let content = task.content.trim();
        if self.include_content && !content.is_empty() {
            out.push('\n');
            out.push_str(content);
            out.push('\n');
        }

        out.push('\n');

        for child in &task.children {
            self.render_node(child, level + 1, out);
        }
    }
}

/// Convenience: render rhei to GitHub issues-style Markdown with all sections enabled.
pub fn to_github_markdown(rhei: &rhei_core::ast::Rhei) -> String {
    GithubIssuesOutput { include_content: true, include_metadata: true }.to_markdown(rhei)
}