heddle-core 0.10.3

An AI-native version control system
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

// SPDX-License-Identifier: Apache-2.0
//! Git-overlay guide content (machine path).
//!
//! Single typed value — not micro-functions. Human ANSI formatting stays CLI.

use serde::Serialize;

/// Machine-facing git-overlay guide (JSON / structured output).
#[derive(Debug, Clone, PartialEq, Eq, Serialize)]
pub struct GitOverlayGuide {
    pub topic: &'static str,
    pub summary: &'static str,
    pub steps: &'static [&'static str],
}

/// Canonical git-overlay guide payload.
pub const GIT_OVERLAY_GUIDE: GitOverlayGuide = GitOverlayGuide {
    topic: "git-overlay",
    summary: "Use Heddle as the daily loop with explicit Git projection compatibility: status, diff, commit, start --path, ready, land, push, undo, verify.",
    steps: &[
        "heddle status",
        "heddle init",
        "heddle diff",
        "heddle capture -m <message>",
        "heddle start <name> --path ../<name>",
        "heddle ready",
        "heddle land --thread <name>",
        "heddle push",
        "heddle undo",
        "heddle verify",
    ],
};

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

    #[test]
    fn guide_shape() {
        assert_eq!(GIT_OVERLAY_GUIDE.topic, "git-overlay");
        assert_eq!(GIT_OVERLAY_GUIDE.steps.len(), 10);
        let v = serde_json::to_value(&GIT_OVERLAY_GUIDE).unwrap();
        assert_eq!(v["steps"].as_array().unwrap().len(), 10);
    }
}