commands

type BackupListResult struct {
	Backups []backup.BackupEntry `json:"backups"`
}

type CapabilitiesResult struct {
	Query   string            `json:"query"`
	Results []CapabilityMatch `json:"results"`
}

type CapabilityMatch struct {
	Kind    string `json:"kind"` // command | plugin
	Path    string `json:"path,omitempty"`
	Slug    string `json:"slug,omitempty"`
	Summary string `json:"summary"`
	Run     string `json:"run"`
	Score   int    `json:"score"`
}

type CleanResult struct {
	// Removed lists the generated artifacts that were deleted, relative to the project.
	Removed []string `json:"removed"`
	// HostPrune is true when the host-wide `docker system prune` (--all) ran.
	HostPrune bool `json:"host_prune"`
}

type ConfigGetResult struct {
	Key      string `json:"key"`
	Value    string `json:"value"`
	Redacted bool   `json:"redacted"`
}

type ConfigSetResult struct {
	Key     string `json:"key"`
	File    string `json:"file"`
	Created bool   `json:"created"`
}

type ConfigShowResult struct {
	EnvFile string            `json:"env_file"`
	Values  map[string]string `json:"values"`
}

type CreateProjectRequest struct {
	Slug   string
	Domain string
}

type DeployServerInfo struct {
	Env    string `json:"env"`
	Server string `json:"server"`
	Role   string `json:"role"`
	Host   string `json:"host,omitempty"`
}

type DeployStatusResult struct {
	LocalState string             `json:"local_state"`
	Servers    []DeployServerInfo `json:"servers,omitempty"`
	Note       string             `json:"note"`
}

type DoctorImage struct {
	Name     string `json:"name"`
	Upstream string `json:"upstream"` // present | unreachable | not configured | a diagnosis
	Mirror   string `json:"mirror"`   // same values
	Status   string `json:"status"`   // pass | warn | fail
	Remedy   string `json:"remedy,omitempty"`
}

type DoctorImages struct {
	Images []DoctorImage `json:"images"`
	State  string        `json:"state"` // ok | warnings | unhealthy
}

type DoctorReport struct {
	Path       string `json:"path"`       // absolute path of the archive
	Files      int    `json:"files"`      // entries in the archive, manifest.json included
	Bytes      int64  `json:"bytes"`      // archive size
	Redactions int    `json:"redactions"` // total replacements made across all files
}

type DoctorResult struct {
	Checks []doctor.CheckResult `json:"checks"`
}

type EnvListResult struct {
	Envs []env.EnvInfo `json:"envs"`
}

type ExecResult struct {
	Command string `json:"command"`
	Output  string `json:"output"`
	Success bool   `json:"success"`
}

type FunctionInfo struct {
	Name   string `json:"name"`
	Status string `json:"status"`
	URL    string `json:"url"`
	Dir    string `json:"dir"`
}

type HealAction struct {
	Name   string `json:"name"`   // routine, e.g. "jwt"
	Status string `json:"status"` // rotated | would-rotate
	Detail string `json:"detail,omitempty"`
}

type HealResult struct {
	Actions    []HealAction `json:"actions"`
	Rotated    bool         `json:"rotated"`
	DryRun     bool         `json:"dry_run"`
	KeyFile    string       `json:"key_file,omitempty"`
	LogPath    string       `json:"log_path,omitempty"`
	GraceUntil string       `json:"grace_until,omitempty"` // RFC 3339, set when rotated
}

type HelpTopicEntry struct {
	Key     string `json:"key"`
	Title   string `json:"title"`
	Summary string `json:"summary"`
	Body    string `json:"body,omitempty"`
}

type HelpTopicsResult struct {
	Topics []HelpTopicEntry `json:"topics"`
}

type InitResult struct {
	// ProjectDir is the absolute directory init scaffolded into.
	ProjectDir string `json:"project_dir"`
	// Env is the ENV value written to .env; empty when init wrote no .env
	// (--list-presets, --template).
	Env string `json:"env"`
	// FilesWritten lists the files init created or replaced, relative to
	// ProjectDir with forward slashes; empty on --dry-run and --list-presets.
	FilesWritten []string `json:"files_written"`
	// Next lists the commands init suggests running next, in order.
	Next []string `json:"next"`
}

type LogRecord struct {
	// Type is always "log".
	Type string `json:"type"`
	// Service is the compose service/container prefix of the line.
	Service string `json:"service,omitempty"`
	// Time is the timestamp the line starts with, as written.
	Time string `json:"time,omitempty"`
	// Level is the detected level: debug, info, warn or error.
	Level string `json:"level,omitempty"`
	// Message is the line without its service prefix and timestamp.
	Message string `json:"message"`
}

type LogSummary struct {
	Service    string
	TotalLines int
	ErrorCount int
	WarnCount  int
	TopErrors  []string // up to 5 most frequent error messages (deduped)
	LastLine   string
}

type LogVolume struct {
	Service     string
	LinesPerMin float64
	BytesPerMin float64
	ErrorRate   float64 // errors / total lines in sample window
}

type LogsDocument struct {
	// Records are the log lines in the order docker printed them.
	Records []LogRecord `json:"records"`
}

type LogsEnd struct {
	// Lines is the number of record lines that were written.
	Lines int `json:"lines"`
}

type LogsOptions struct {
	Search  string
	Grep    string // regex pattern for --grep
	Errors  bool
	Level   string // debug|info|warn|error
	Compact bool
	Quiet   bool
	Tail    int
	Follow  bool
	Since   string // relative (1h, 30m) or absolute RFC3339
	Until   string // relative or absolute RFC3339
	JSON    bool   // structured JSON output per line
	NoColor bool
	Plain   bool // disable highlighting for piping
	Service []string
}

type LogsResult struct {
	Service string `json:"service,omitempty"`
	Lines   int    `json:"lines"`
	Output  string `json:"output"`
}

type MigrateStatusResult struct {
	Migrations         []MigrationStatusEntry `json:"migrations"`
	LedgerNeedsUpgrade bool                   `json:"ledger_needs_upgrade"`
}

type MigrationStatusEntry struct {
	Name      string    `json:"name"`
	Applied   bool      `json:"applied"`
	AppliedAt time.Time `json:"applied_at,omitempty"`
}

type PilotEnums struct {
	StatusState      []string // statusData.state
	DoctorState      []string // doctorData.state
	ConfigListSource []string // configListKey.source
}

type PluginInstallResult struct {
	Name      string `json:"name"`
	Installed bool   `json:"installed"`
	Message   string `json:"message,omitempty"`
}

type PluginListEntry struct {
	Name          string `json:"name"`
	Version       string `json:"version,omitempty"`
	Category      string `json:"category,omitempty"`
	Installed     bool   `json:"installed"`
	Running       bool   `json:"running"`
	PublishStatus string `json:"publish_status,omitempty"`
}

type PluginListResult struct {
	Plugins []PluginListEntry `json:"plugins"`
}

type ResetResult struct {
	// Removed lists the generated paths that were deleted, relative to the project.
	Removed []string `json:"removed"`
	// KeptData is true when the database volumes were left in place (--keep-data).
	KeptData bool `json:"kept_data"`
}

type RestartResult struct {
	// Restarted names the services that were restarted.
	Restarted []string `json:"restarted"`
	// Mode is the strategy that ran: all, services, smart or quick.
	Mode string `json:"mode"`
}

type ServiceListResult struct {
	Services []service.PSEntry `json:"services"`
}

type StackUpdateResult struct {
	RunID      string       `json:"run_id"`
	Status     string       `json:"status"`
	DryRun     bool         `json:"dry_run"`
	ResumeStep string       `json:"resume_step,omitempty"`
	Steps      []stack.Step `json:"steps"`
}

type StartResult struct {
	Services []StartService `json:"services"`
	// URLs lists the endpoints the stack answers on, without the display labels.
	URLs       []string `json:"urls"`
	DurationMS int64    `json:"duration_ms"`
}

type StartService struct {
	Name string `json:"name"`
	// Status is the container state: running, missing or unknown.
	Status string `json:"status"`
	// Health is the Docker healthcheck result: healthy, unhealthy, starting
	// or none (the service declares no healthcheck).
	Health string `json:"health"`
}

type StopResult struct {
	// Stopped names the services that were running and are now stopped; empty
	// when none was running or the running set could not be read.
	Stopped []string `json:"stopped"`
	// VolumesRemoved is true when --volumes deleted the data volumes.
	VolumesRemoved bool `json:"volumes_removed"`
}

type UninstallResult struct {
	// Removed lists the paths that were deleted, relative to the project.
	Removed []string `json:"removed"`
	// KeptData is true when the database volumes were left in place (no --purge).
	KeptData bool `json:"kept_data"`
}

type UpdateResult struct {
	Plan    plan.Plan    `json:"plan"`
	Applied bool         `json:"applied"` // false under --plan
	Steps   []UpdateStep `json:"steps"`
}

type UpdateStep struct {
	Name   string `json:"name"`
	Status string `json:"status"` // pending (plan) | done | skipped
	Detail string `json:"detail,omitempty"`
}

type VersionResult struct {
	BuildDate    string   `json:"buildDate"`
	Capabilities []string `json:"capabilities"`
	Commit       string   `json:"commit"`
	GoVersion    string   `json:"goVersion"`
	Platform     string   `json:"platform"`
	Version      string   `json:"version"`
}