apiforge 0.1.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

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,
}

#[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 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
    #[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,
}

#[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>,
}