apiforge 0.4.0

Production-grade API release automation CLI. From merged code to healthy pods in production — one command.
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
147
148
149
150
151
152
153
154
155
156

use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(
    name = "apiforge",
    about = "Production API release automation CLI",
    version,
    long_about = "From merged code to healthy pods in production — one command, zero tribal knowledge required."
)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,

    /// Enable debug output
    #[arg(long, global = true, env = "APIFORGE_DEBUG")]
    pub debug: bool,

    /// Config file path
    #[arg(long, global = true, default_value = "apiforge.toml")]
    pub config: String,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Initialize apiforge in current project
    Init(InitArgs),

    /// Validate environment and dependencies
    Doctor,

    /// Release a new version
    Release(ReleaseArgs),

    /// Roll back to previous release
    Rollback(RollbackArgs),

    /// Show release history
    History(HistoryArgs),

    /// Show current deployment status
    Status,

    /// Configuration management commands
    Config(ConfigArgs),
}

#[derive(Parser)]
pub struct InitArgs {
    /// Project name
    #[arg(long)]
    pub name: Option<String>,

    /// Force overwrite existing config
    #[arg(long)]
    pub force: bool,
}

#[derive(Parser)]
pub struct ReleaseArgs {
    /// Version bump type
    #[arg(value_parser = ["major", "minor", "patch"])]
    pub bump: String,

    /// Preview all steps without making changes
    #[arg(long)]
    pub dry_run: bool,

    /// Skip Docker build and push
    #[arg(long)]
    pub skip_docker: bool,

    /// Skip Kubernetes rollout
    #[arg(long)]
    pub skip_k8s: bool,

    /// Skip CloudFront cache invalidation
    #[arg(long)]
    pub skip_cloudfront: bool,

    /// Skip GitHub Release creation
    #[arg(long)]
    pub skip_github: bool,

    /// Skip all notifications
    #[arg(long)]
    pub skip_notify: bool,

    /// Skip changelog generation
    #[arg(long)]
    pub no_changelog: bool,

    /// Output format
    #[arg(long, value_parser = ["text", "json"], default_value = "text")]
    pub output: String,

    /// Skip confirmation prompt
    #[arg(long, short)]
    pub yes: bool,
}

#[derive(Parser)]
pub struct RollbackArgs {
    /// Version to roll back to (auto-detected from release history when omitted)
    #[arg(long)]
    pub to: Option<String>,

    /// Preview rollback without making changes
    #[arg(long)]
    pub dry_run: bool,

    /// Skip notifications
    #[arg(long)]
    pub skip_notify: bool,

    /// Skip confirmation prompt
    #[arg(long, short)]
    pub yes: bool,
}

#[derive(Parser)]
pub struct HistoryArgs {
    /// Maximum number of entries to show
    #[arg(long, default_value = "20")]
    pub limit: usize,

    /// Output format
    #[arg(long, value_parser = ["text", "json"], default_value = "text")]
    pub output: String,

    /// Filter by status
    #[arg(long, value_parser = ["success", "failed"])]
    pub filter: Option<String>,
}

#[derive(Parser)]
pub struct ConfigArgs {
    #[command(subcommand)]
    pub command: ConfigCommands,
}

#[derive(Subcommand)]
pub enum ConfigCommands {
    /// Validate configuration file with detailed output
    Validate(ConfigValidateArgs),
}

#[derive(Parser)]
pub struct ConfigValidateArgs {
    /// Output format
    #[arg(long, value_parser = ["text", "json"], default_value = "text")]
    pub output: String,

    /// Show verbose output with all checks
    #[arg(long)]
    pub verbose: bool,
}