bijux-cli 0.4.1

Command-line runtime for automation, plugin-driven tools, and interactive workflows with structured output.
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

#![forbid(unsafe_code)]
//! Read-only contract schema inventory interfaces for maintainer tooling.

/// Structured schema inventory queried from durable contracts.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ContractsSchemaQuery {
    /// Stable schema ids exposed by contract types.
    pub schema_ids: Vec<String>,
    /// Schema inventory version marker.
    pub schema_version: String,
}

/// Structured compatibility lanes for durable schema/versioned surfaces.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct VersionCompatibilityLaneQuery {
    /// Compatibility lane inventory format version.
    pub schema_version: String,
    /// Version-compatibility lanes per product surface.
    pub surfaces: Vec<VersionCompatibilitySurface>,
}

/// Version compatibility lane for one surface contract.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct VersionCompatibilitySurface {
    /// Stable surface identifier.
    pub surface: String,
    /// Current versions expected for normal production usage.
    pub current_versions: Vec<String>,
    /// Explicitly accepted previous versions.
    pub accepted_previous_versions: Vec<String>,
    /// Known refused versions to keep failures deterministic.
    pub refused_versions: Vec<String>,
}

/// Query contracts/schema inventory without presentation formatting.
#[must_use]
pub fn contracts_schema_query() -> ContractsSchemaQuery {
    ContractsSchemaQuery {
        schema_ids: vec![
            "command-envelope-v1".to_string(),
            "output-envelope-v1".to_string(),
            "error-envelope-v1".to_string(),
            "config-schema-registry-v1".to_string(),
            "plugin-manifest-v2".to_string(),
            "product-mount-descriptor-v1".to_string(),
        ],
        schema_version: "v4".to_string(),
    }
}

/// Query version-compatibility lanes without presentation formatting.
#[must_use]
pub fn version_compatibility_lanes_query() -> VersionCompatibilityLaneQuery {
    VersionCompatibilityLaneQuery {
        schema_version: "v1".to_string(),
        surfaces: vec![
            VersionCompatibilitySurface {
                surface: "cli-command-envelope".to_string(),
                current_versions: vec!["command-envelope-v1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "command-envelope-v0".to_string(),
                    "command-envelope-v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "cli-output-envelope".to_string(),
                current_versions: vec!["output-envelope-v1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "output-envelope-v0".to_string(),
                    "output-envelope-v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "cli-error-envelope".to_string(),
                current_versions: vec!["error-envelope-v1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "error-envelope-v0".to_string(),
                    "error-envelope-v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "config-schema-registry".to_string(),
                current_versions: vec!["config-schema-registry-v1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "config-schema-registry-v0".to_string(),
                    "config-schema-registry-v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "mount-descriptor".to_string(),
                current_versions: vec!["product-mount-descriptor-v1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "product-mount-descriptor-v0".to_string(),
                    "product-mount-descriptor-v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "graph-spec".to_string(),
                current_versions: vec!["bijux-dag/v0.1".to_string()],
                accepted_previous_versions: vec![
                    "v1".to_string(),
                    "v0.1".to_string(),
                    "0.1".to_string(),
                ],
                refused_versions: vec!["v9".to_string(), "bijux-dag/v9".to_string()],
            },
            VersionCompatibilitySurface {
                surface: "run-manifest".to_string(),
                current_versions: vec!["run-manifest/v0.1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "run-manifest/v0".to_string(),
                    "run-manifest/v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "artifact-index".to_string(),
                current_versions: vec!["run-dir-schema/v0.1".to_string()],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "run-dir-schema/v0".to_string(),
                    "run-dir-schema/v2".to_string(),
                ],
            },
            VersionCompatibilitySurface {
                surface: "replay-bundle".to_string(),
                current_versions: vec![
                    "export-bundle/v0.1".to_string(),
                    "proof-bundle/v0.1".to_string(),
                ],
                accepted_previous_versions: Vec::new(),
                refused_versions: vec![
                    "export-bundle/v0".to_string(),
                    "proof-bundle/v0".to_string(),
                    "export-bundle/v2".to_string(),
                    "proof-bundle/v2".to_string(),
                ],
            },
        ],
    }
}