launcher

type CLI struct {
	// Global CLI args
	EnvFile string           `help:"Load environment variables from a dotenv file (default: .env.local when present)"`
	DataDir string           `name:"data-dir" help:"Application data directory for on-disk runtime state"`
	Version kong.VersionFlag `short:"V" help:"Show the application version"`

	// CLI subcommands
	Serve   ServeCmd   `cmd:"" help:"Start the application server"`
	DB      DBCmd      `cmd:"" help:"Database backup, restore, and migration commands"`
	Secrets SecretsCmd `cmd:"" help:"Generate application secrets"`
	Setup   SetupCmd   `cmd:"" help:"Bootstrap the first admin account (fresh database only)"`
	Health  HealthCmd  `cmd:"" help:"Check application health" aliases:"hc"`
}

type DBCmd struct {
	MigrateUp      MigrateUpCmd      `cmd:"" name:"migrate:up" help:"Run database migrations"`
	MigrateDown    MigrateDownCmd    `cmd:"" name:"migrate:down" help:"Rollback the most recent migration"`
	MigrateStatus  MigrateStatusCmd  `cmd:"" name:"migrate:status" help:"Check database migration status"`
	MigrateVersion MigrateVersionCmd `cmd:"" name:"migrate:version" help:"Print the current migration version"`
	Export         DBExportCmd       `cmd:"" help:"Export schema & data or data only (SQL format)"`
	Import         DBImportCmd       `cmd:"" help:"Import from a SQL file"`
	Dump           DBDumpCmd         `cmd:"" help:"Dump schema & data or data only (custom format)"`
	Restore        DBRestoreCmd      `cmd:"" help:"Restore from a dump file (custom format)"`
}

type DBDumpCmd struct {
	Mode string `arg:"" help:"Dump scope: all (schema & data) or data"`
}

type DBExportCmd struct {
	Mode string `arg:"" help:"Export scope: all (schema & data) or data"`
}

type DBImportCmd struct {
	File   string `arg:"" help:"Path to the .sql file"`
	Force  bool   `help:"Skip the confirmation prompt"`
	DryRun bool   `help:"Print the psql command without running it"`
}

type DBRestoreCmd struct {
	Mode   string `arg:"" help:"Restore scope: all, data, or schema"`
	File   string `arg:"" help:"Path to the .dump file"`
	Force  bool   `help:"Skip the confirmation prompt"`
	DryRun bool   `help:"Print the pg_restore command without running it"`
}

type HealthCmd struct {
	Addr string `help:"Server health endpoint URL (default: from config)"`
	Live bool   `help:"Check live server via HTTP"`
}

type MigrateDownCmd struct {
	// Count rolls back this many migrations (default 1).
	Count  int  `help:"Number of migrations to roll back (default: 1)"`
	Force  bool `help:"Skip the confirmation prompt"`
	DryRun bool `help:"Print what would be rolled back without changing anything"`
}

type MigrateStatusCmd struct{}

type MigrateUpCmd struct {
	// To applies up to this version (inclusive); 0 means all.
	To int64 `help:"Apply migrations only up to this version (default: all)"`
}

type MigrateVersionCmd struct{}

type SecretsCmd struct {
	// Apply writes to this env file; it is distinct from global --env-file.
	Apply   bool   `help:"Update the env file with new secrets"`
	RSA     bool   `help:"Generate JWT keys using RSA algorithm (2048-bit)"`
	MLDSA   bool   `help:"Generate post-quantum ML-DSA-87 JWT keys (FIPS 204)"`
	OutFile string `name:"out" default:".env.local" help:"Env file to update when using --apply"`
}

type ServeCmd struct {
	Host string `help:"Host to bind to"`
	Port string `help:"Port to bind to"`
}

type SetupCmd struct {
	AdminEmail    string `help:"Email address for the admin account"`
	AdminPassword string `help:"Password for the admin account (omit to be prompted, hidden input)"`
	Username      string `default:"admin" help:"Username for the admin account"`
}