commands

type AddResult struct {
	Service           string            `json:"service"`
	Added             bool              `json:"added"`
	Message           string            `json:"message,omitempty"`
	Preview           string            `json:"preview,omitempty"`
	ConnectionStrings map[string]string `json:"connectionStrings,omitempty"`
}

type AzureYaml struct {
	Reqs     []Prerequisite         `yaml:"reqs"`
	Services map[string]ReqsService `yaml:"services,omitempty"`
}

type BulkServiceControlResult struct {
	Success      bool                   `json:"success"`
	Message      string                 `json:"message"`
	Results      []ServiceControlResult `json:"results"`
	SuccessCount int                    `json:"successCount"`
	FailureCount int                    `json:"failureCount"`
	TotalTime    string                 `json:"totalDuration"` // Human-readable duration string
}

type CleanDependenciesError struct {
	Count   int
	Details []string
}

type CollectedLogs struct {
	// Entries holds log entries when no context extraction is needed.
	// Initialized to empty slice (not nil) so JSON marshaling produces [] not null.
	Entries []service.LogEntry

	// EntriesWithContext holds log entries with surrounding context lines.
	// Populated when contextLines > 0 and a level filter is active.
	// Initialized to empty slice (not nil) so JSON marshaling produces [] not null.
	EntriesWithContext []LogEntryWithContext

	// HasContext indicates whether EntriesWithContext is populated (true)
	// or Entries is populated (false).
	HasContext bool

	// DashboardAvailable indicates whether the dashboard was reachable.
	DashboardAvailable bool

	// ServiceCount is the number of services discovered via dashboard.
	ServiceCount int

	// Source is the log source that was used ("local", "azure", "all").
	Source string

	// Warnings holds non-fatal warning messages (e.g., "Azure logs unavailable").
	// CLI displays these via cliout.Warning; MCP can include them in responses.
	Warnings []string
}

type DashboardClient interface {
	Ping(ctx context.Context) error
	GetServices(ctx context.Context) ([]*serviceinfo.ServiceInfo, error)
	StreamLogs(ctx context.Context, serviceName string, logs chan<- service.LogEntry) error
	GetAzureLogs(ctx context.Context, services []string, tail int, since time.Time) ([]service.LogEntry, error)
	GetAzureStatus(ctx context.Context) (*service.AzureStatus, error) //nolint:staticcheck // backward-compatible API
	StreamAzureLogs(ctx context.Context, logs chan<- service.LogEntry) error
}

type DependencyInstaller struct {
	// contains filtered or unexported fields
}

type DepsOptions struct {
	Verbose  bool
	Clean    bool
	NoCache  bool
	Force    bool
	DryRun   bool     // Show what would be installed without installing
	Check    bool     // Verify dependencies are installed without installing (non-zero exit if missing)
	Services []string // Filter to specific services by name
}

type DepsResult struct {
	Success  bool            `json:"success"`
	Projects []InstallResult `json:"projects"`
	Message  string          `json:"message,omitempty"`
	Error    string          `json:"error,omitempty"`
}

type DetectedProjects struct {
	Node   []types.NodeProject
	Python []types.PythonProject
	Dotnet []types.DotnetProject
	// ServicesByDir maps a project directory to the names of the azure.yaml
	// services that share it. Used to label a single (deduped) install with the
	// services it covers when several services point at one directory. Nil/empty
	// entries fall back to the directory name.
	ServicesByDir map[string][]string
}

type DetectedRequirement struct {
	Name             string // Tool identifier (e.g., "node", "docker")
	InstalledVersion string // Currently installed version (e.g., "22.3.0")
	MinVersion       string // Normalized minimum version (e.g., "22.0.0")
	CheckRunning     bool   // Whether tool must be running
	Source           string // What triggered detection (e.g., "package.json", "AppHost.cs")
}

type DetectedService struct {
	Name           string            `json:"name"`
	Language       string            `json:"language"`
	Framework      string            `json:"framework,omitempty"`
	Project        string            `json:"project"`
	Ports          []string          `json:"ports,omitempty"`
	Command        string            `json:"command,omitempty"`
	PackageManager string            `json:"packageManager,omitempty"`
	Environment    map[string]string `json:"environment,omitempty"`
	Type           string            `json:"type,omitempty"`
	Mode           string            `json:"mode,omitempty"`
	Uses           []string          `json:"uses,omitempty"`
	IsWorkspace    bool              `json:"isWorkspace,omitempty"`
}

type ExecutionContext struct {
	CacheEnabled    bool
	ReqsOnlyMissing bool
}

type FixResult struct {
	Name      string `json:"name"`
	Fixed     bool   `json:"fixed"`
	Found     bool   `json:"found"`
	Path      string `json:"path,omitempty"`
	Message   string `json:"message"`
	Satisfied bool   `json:"satisfied"`
}

type GenerateConfig struct {
	DryRun     bool   // Don't write files, just show what would happen
	WorkingDir string // Directory to start search from
}

type GenerateResult struct {
	Reqs          []DetectedRequirement
	AzureYamlPath string
	Created       bool // True if azure.yaml was created vs updated
	Added         int  // Number of reqs added
	Skipped       int  // Number of existing reqs preserved
}

type InitResult struct {
	Services      []DetectedService `json:"services"`
	AzureYamlPath string            `json:"azureYamlPath"`
	Created       bool              `json:"created"`
	Enriched      bool              `json:"enriched"`
}

type InstallResult struct {
	Type    string `json:"type"`
	Dir     string `json:"dir,omitempty"`
	Path    string `json:"path,omitempty"`
	Manager string `json:"manager,omitempty"`
	Success bool   `json:"success"`
	Error   string `json:"error,omitempty"`
}

type LogContext struct {
	Before []string `json:"before,omitempty"`
	After  []string `json:"after,omitempty"`
}

type LogEntryWithContext struct {
	Service   string      `json:"service"`
	Message   string      `json:"message"`
	Level     string      `json:"level"`
	Timestamp time.Time   `json:"timestamp"`
	IsStderr  bool        `json:"isStderr,omitempty"`
	Context   *LogContext `json:"context,omitempty"`
}

type LogManagerInterface interface {
	GetBuffer(serviceName string) (*service.LogBuffer, bool)
	GetAllBuffers() map[string]*service.LogBuffer
}

type LogServiceSummary struct {
	Service string `json:"service"`
	Info    int    `json:"info"`
	Warn    int    `json:"warn"`
	Error   int    `json:"error"`
	Debug   int    `json:"debug"`
	Unknown int    `json:"unknown,omitempty"`
	Total   int    `json:"total"`
}

type LogSource string

type LogSummaryResult struct {
	Total     int                 `json:"total"`
	StartTime *time.Time          `json:"startTime,omitempty"`
	EndTime   *time.Time          `json:"endTime,omitempty"`
	Services  []LogServiceSummary `json:"services"`
}

type Prerequisite struct {
	Name       string `yaml:"name"`
	MinVersion string `yaml:"minVersion"`
	// Custom tool configuration (optional)
	Command       string   `yaml:"command,omitempty"`       // Override command to execute
	Args          []string `yaml:"args,omitempty"`          // Override arguments
	VersionPrefix string   `yaml:"versionPrefix,omitempty"` // Override version prefix to strip
	VersionField  int      `yaml:"versionField,omitempty"`  // Override which field contains version
	// Runtime check configuration (optional)
	CheckRunning         bool     `yaml:"checkRunning,omitempty"`         // Whether to check if the tool is running
	RunningCheckCommand  string   `yaml:"runningCheckCommand,omitempty"`  // Command to check if tool is running
	RunningCheckArgs     []string `yaml:"runningCheckArgs,omitempty"`     // Arguments for running check command
	RunningCheckExpected string   `yaml:"runningCheckExpected,omitempty"` // Expected substring in output (optional)
	RunningCheckExitCode *int     `yaml:"runningCheckExitCode,omitempty"` // Expected exit code (default: 0)
	// Install URL configuration (optional)
	InstallURL string `yaml:"installUrl,omitempty"` // URL to installation page (overrides built-in)
}

type PrerequisiteChecker struct {
	// contains filtered or unexported fields
}

type ProjectInfo struct {
	Project  map[string]any          `json:"project" jsonschema:"description=Project metadata"`
	Services []ProjectServiceSummary `json:"services" jsonschema:"description=Summary of services defined in the project"`
}

type ProjectServiceSummary struct {
	Name      string `json:"name" jsonschema:"description=Service name"`
	Language  string `json:"language" jsonschema:"description=Programming language"`
	Framework string `json:"framework" jsonschema:"description=Framework used"`
	Project   string `json:"project" jsonschema:"description=Project directory path"`
}

type RemoveResult struct {
	Service string `json:"service"`
	Removed bool   `json:"removed"`
	Message string `json:"message,omitempty"`
}

type ReqResult struct {
	Name       string `json:"name"`
	Installed  bool   `json:"installed"`
	Version    string `json:"version,omitempty"`
	Required   string `json:"required"`
	Satisfied  bool   `json:"satisfied"`
	Running    bool   `json:"running,omitempty"`
	CheckedRun bool   `json:"checkedRunning,omitempty"`
	Message    string `json:"message,omitempty"`
	IsPodman   bool   `json:"isPodman,omitempty"`   // True when Podman is aliased to Docker
	InstallURL string `json:"installUrl,omitempty"` // URL to installation page
}

type ReqsDockerConfig struct {
	Image string `yaml:"image,omitempty"`
}

type ReqsResult struct {
	Satisfied bool        `json:"satisfied"`
	Reqs      []ReqResult `json:"reqs"`
}

type ReqsService struct {
	Image  string            `yaml:"image,omitempty"`
	Docker *ReqsDockerConfig `yaml:"docker,omitempty"`
}

type RequirementStatus struct {
	Name           string `json:"name" jsonschema:"description=Requirement name (e.g. node, python, docker)"`
	Required       string `json:"required" jsonschema:"description=Required version"`
	Installed      string `json:"installed,omitempty" jsonschema:"description=Installed version if found"`
	Met            bool   `json:"met" jsonschema:"description=Whether requirement is satisfied"`
	InstallCommand string `json:"installCommand,omitempty" jsonschema:"description=Command to install if missing"`
}

type RequirementsResult struct {
	Requirements []RequirementStatus `json:"requirements" jsonschema:"description=List of requirements and their status"`
	AllMet       bool                `json:"allMet" jsonschema:"description=Whether all requirements are satisfied"`
}

type ResultFormatter struct{}

type ServiceControlResult struct {
	ServiceName string `json:"serviceName"`
	Success     bool   `json:"success"`
	Message     string `json:"message"`
	Status      string `json:"status,omitempty"`
	Error       string `json:"error,omitempty"`
	Duration    string `json:"duration,omitempty"` // Human-readable duration string
}

type ServiceController struct {
	// contains filtered or unexported fields
}

type ServiceDetails struct {
	Name      string            `json:"name" jsonschema:"description=Service name"`
	Language  string            `json:"language" jsonschema:"description=Programming language (e.g. python, javascript, dotnet)"`
	Framework string            `json:"framework" jsonschema:"description=Framework used (e.g. flask, express, aspnet)"`
	Project   string            `json:"project" jsonschema:"description=Path to the project directory"`
	Status    string            `json:"status,omitempty" jsonschema:"description=Current running status"`
	Health    string            `json:"health,omitempty" jsonschema:"description=Health check status"`
	URL       string            `json:"url,omitempty" jsonschema:"description=Local URL where service is running"`
	Port      int               `json:"port,omitempty" jsonschema:"description=Port number the service is listening on"`
	PID       int               `json:"pid,omitempty" jsonschema:"description=Process ID of the running service"`
	Env       map[string]string `json:"env,omitempty" jsonschema:"description=Environment variables configured for the service"`
}

type ServicesResult struct {
	Project  map[string]any   `json:"project" jsonschema:"description=Project metadata including name and directory"`
	Services []ServiceDetails `json:"services" jsonschema:"description=List of services with their status and configuration"`
}

type TestOptions struct {
	Type            string
	Coverage        bool
	ServiceFilter   string
	Watch           bool
	UpdateSnapshots bool
	FailFast        bool
	Parallel        bool
	Threshold       int
	Verbose         bool
	DryRun          bool
	OutputFormat    string
	OutputDir       string
	Stream          bool
	NoStream        bool
	Timeout         time.Duration
	Save            bool
	NoSave          bool
	Environment     string
	Changed         bool
	ChangedBase     string
}

type ToolConfig struct {
	Command       string   // The command to execute
	Args          []string // Arguments to get version
	VersionPrefix string   // Prefix to strip from version output (e.g., "v" for node)
	VersionField  int      // Which field contains version (0 = whole output, 1 = second field, etc.)
}