api

type ArtifactTaskValidation struct {
	Task               string            `json:"task"`
	Kind               string            `json:"kind"`
	Success            bool              `json:"success"`
	InputCheck         string            `json:"inputCheck"`
	OutputCheck        string            `json:"outputCheck"`
	DeclaredInputs     []string          `json:"declaredInputs"`
	MaterializedInputs []string          `json:"materializedInputs"`
	DependencyOutputs  []string          `json:"dependencyOutputs"`
	DeclaredOutputs    []string          `json:"declaredOutputs"`
	ProducedOutputs    []string          `json:"producedOutputs"`
	ObservedWrites     []string          `json:"observedWrites"`
	UndeclaredWrites   []string          `json:"undeclaredWrites"`
	MissingOutputs     []string          `json:"missingOutputs"`
	DurationMs         int64             `json:"durationMs"`
	Error              string            `json:"error,omitempty"`
	Log                string            `json:"log,omitempty"`
	Issues             []ValidationIssue `json:"issues,omitempty"`
}

type ArtifactValidationResult struct {
	Success bool                     `json:"success"`
	Tasks   []ArtifactTaskValidation `json:"tasks"`
	Issues  []ValidationIssue        `json:"issues,omitempty"`
}

type DBInstance struct {
	Name            string `json:"name"`
	URL             string `json:"url,omitempty"`
	Host            string `json:"host,omitempty"`
	Port            int    `json:"port,omitempty"`
	ContainerPort   int    `json:"containerPort,omitempty"`
	User            string `json:"user,omitempty"`
	Password        string `json:"password,omitempty"`
	Flavor          string `json:"flavor,omitempty"`
	PostgresVersion int    `json:"postgresVersion,omitempty"`
	Image           string `json:"image,omitempty"`
	SidecarImage    string `json:"sidecarImage,omitempty"`
	ContainerName   string `json:"containerName,omitempty"`
	VolumeName      string `json:"volumeName,omitempty"`
	SnapshotRoot    string `json:"snapshotRoot,omitempty"`
}

type DebugAttachConfig struct {
	Name         string `json:"name,omitempty"`
	Type         string `json:"type,omitempty"`
	Request      string `json:"request,omitempty"`
	Mode         string `json:"mode,omitempty"`
	Host         string `json:"host,omitempty"`
	Port         int    `json:"port,omitempty"`
	DebugAdapter string `json:"debugAdapter,omitempty"`
	CWD          string `json:"cwd,omitempty"`
}

type DebugStatus struct {
	Type     string            `json:"type,omitempty"`
	Host     string            `json:"host,omitempty"`
	Port     int               `json:"port,omitempty"`
	PortName string            `json:"portName,omitempty"`
	Protocol string            `json:"protocol,omitempty"`
	Binary   string            `json:"binary,omitempty"`
	Package  string            `json:"package,omitempty"`
	Attach   DebugAttachConfig `json:"attach,omitempty"`
}

type DoctorResult struct {
	Worktree     string   `json:"worktree"`
	InstanceID   string   `json:"instanceId,omitempty"`
	Project      string   `json:"project,omitempty"`
	Target       string   `json:"target,omitempty"`
	CLIScope     string   `json:"cliScope,omitempty"`
	ChecksPassed bool     `json:"checksPassed"`
	Checks       []string `json:"checks"`
	Warnings     []string `json:"warnings,omitempty"`
}

type Event struct {
	TS            string    `json:"ts"`
	Type          EventType `json:"type"`
	InstanceID    string    `json:"instanceId,omitempty"`
	Worktree      string    `json:"worktree,omitempty"`
	Target        string    `json:"target,omitempty"`
	Task          string    `json:"task,omitempty"`
	Mode          RunMode   `json:"mode,omitempty"`
	State         NodeState `json:"state,omitempty"`
	PreviousState NodeState `json:"previousState,omitempty"`
	Stream        string    `json:"stream,omitempty"`
	Line          string    `json:"line,omitempty"`
	CacheKey      string    `json:"cacheKey,omitempty"`
	PID           int       `json:"pid,omitempty"`
	Files         []string  `json:"files,omitempty"`
	AffectedTasks []string  `json:"affectedTasks,omitempty"`
	PromptID      string    `json:"promptId,omitempty"`
	PromptKind    string    `json:"promptKind,omitempty"`
	Prompt        string    `json:"prompt,omitempty"`
	Error         string    `json:"error,omitempty"`
	Success       *bool     `json:"success,omitempty"`
}

type EventType string

type FlushIssue struct {
	Task    string `json:"task,omitempty"`
	Kind    string `json:"kind"`
	Message string `json:"message"`
	LogPath string `json:"logPath,omitempty"`
}

type FlushRequest struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"createdAt"`
	SyncPath  string    `json:"syncPath"`
}

type FlushResult struct {
	RequestID  string         `json:"requestId"`
	InstanceID string         `json:"instanceId"`
	Worktree   string         `json:"worktree"`
	Project    string         `json:"project,omitempty"`
	Target     string         `json:"target"`
	Mode       RunMode        `json:"mode"`
	Started    bool           `json:"started"`
	Synced     bool           `json:"synced"`
	Success    bool           `json:"success"`
	TimedOut   bool           `json:"timedOut,omitempty"`
	DurationMs int64          `json:"durationMs"`
	UpdatedAt  time.Time      `json:"updatedAt,omitempty"`
	Nodes      []NodeStatus   `json:"nodes,omitempty"`
	Services   []FlushService `json:"services,omitempty"`
	Issues     []FlushIssue   `json:"issues,omitempty"`
}

type FlushService struct {
	Task    string    `json:"task"`
	State   NodeState `json:"state"`
	PID     int       `json:"pid,omitempty"`
	Alive   bool      `json:"alive"`
	Ready   bool      `json:"ready"`
	Error   string    `json:"error,omitempty"`
	LogPath string    `json:"logPath,omitempty"`
}

type GraphAffectedResult struct {
	Files            []string          `json:"files"`
	DirectlyAffected []string          `json:"directlyAffected"`
	Downstream       []string          `json:"downstream"`
	Explanations     []GraphFileImpact `json:"explanations,omitempty"`
	UnmatchedFiles   []string          `json:"unmatchedFiles,omitempty"`
}

type GraphFileImpact struct {
	File     string `json:"file"`
	Task     string `json:"task"`
	Affected bool   `json:"affected"`
	Reason   string `json:"reason"`
	Input    string `json:"input,omitempty"`
	Relative string `json:"relative,omitempty"`
	Ignore   string `json:"ignore,omitempty"`
}

type Instance struct {
	ID         string                `json:"id"`
	Label      string                `json:"label"`
	Worktree   string                `json:"worktree"`
	CreatedAt  time.Time             `json:"createdAt"`
	Ports      map[string]int        `json:"ports"`
	Env        map[string]string     `json:"env"`
	DB         DBInstance            `json:"db"`
	Processes  map[string]ProcessRef `json:"processes"`
	Supervisor SupervisorRef         `json:"supervisor,omitempty"`
	LastRun    RunConfig             `json:"lastRun,omitempty"`
}

type InstanceSummary struct {
	ID       string            `json:"id"`
	Label    string            `json:"label"`
	Worktree string            `json:"worktree"`
	Ports    map[string]int    `json:"ports"`
	DB       DBInstance        `json:"db"`
	Target   string            `json:"target,omitempty"`
	States   map[string]string `json:"states,omitempty"`
}

type LogEvent struct {
	TS         string `json:"ts"`
	InstanceID string `json:"instanceId"`
	Task       string `json:"task"`
	Stream     string `json:"stream"`
	Line       string `json:"line"`
}

type NodeState string

type NodeStatus struct {
	Name       string       `json:"name"`
	Kind       string       `json:"kind"`
	State      NodeState    `json:"state"`
	LastRunKey string       `json:"lastRunKey,omitempty"`
	LastError  string       `json:"lastError,omitempty"`
	PID        int          `json:"pid,omitempty"`
	LogPath    string       `json:"logPath,omitempty"`
	Debug      *DebugStatus `json:"debug,omitempty"`
}

type OrderValidationResult struct {
	Success          bool                 `json:"success"`
	Complete         bool                 `json:"complete"`
	MaxOrders        int                  `json:"maxOrders"`
	TotalOrders      int                  `json:"totalOrders,omitempty"`
	DiscoveredOrders int                  `json:"discoveredOrders"`
	BaselineDigest   string               `json:"baselineDigest,omitempty"`
	Runs             []ValidationOrderRun `json:"runs"`
	Issues           []ValidationIssue    `json:"issues,omitempty"`
}

type ProcessRef struct {
	PID       int       `json:"pid"`
	StartedAt time.Time `json:"startedAt"`
}

type RunConfig struct {
	Project     string  `json:"project"`
	Target      string  `json:"target"`
	Mode        RunMode `json:"mode"`
	MaxParallel int     `json:"maxParallel,omitempty"`
	Detached    bool    `json:"detached,omitempty"`
}

type RunMode string

type RunResult struct {
	Target     string   `json:"target"`
	Mode       RunMode  `json:"mode"`
	InstanceID string   `json:"instanceId"`
	Success    bool     `json:"success"`
	DurationMs int64    `json:"durationMs"`
	FailedNode string   `json:"failedNode,omitempty"`
	CacheHits  []string `json:"cacheHits"`
	StartedAt  string   `json:"startedAt"`
	FinishedAt string   `json:"finishedAt"`
}

type StatusResult struct {
	InstanceID string            `json:"instanceId"`
	Worktree   string            `json:"worktree,omitempty"`
	Target     string            `json:"target"`
	Mode       RunMode           `json:"mode,omitempty"`
	UpdatedAt  time.Time         `json:"updatedAt,omitempty"`
	Ports      map[string]int    `json:"ports,omitempty"`
	DB         DBInstance        `json:"db,omitempty"`
	URLs       map[string]string `json:"urls,omitempty"`
	Supervisor *SupervisorStatus `json:"supervisor,omitempty"`
	Nodes      []NodeStatus      `json:"nodes"`
}

type SupervisorRef struct {
	PID       int       `json:"pid"`
	ExecPID   int       `json:"execPid,omitempty"`
	StartedAt time.Time `json:"startedAt"`
	LogPath   string    `json:"logPath,omitempty"`
}

type SupervisorStatus struct {
	PID       int       `json:"pid,omitempty"`
	ExecPID   int       `json:"execPid,omitempty"`
	Alive     bool      `json:"alive"`
	StartedAt time.Time `json:"startedAt,omitempty"`
	LogPath   string    `json:"logPath,omitempty"`
}

type UpgradeResult struct {
	Command       []string `json:"command"`
	Package       string   `json:"package"`
	VersionTarget string   `json:"versionTarget"`
	Success       bool     `json:"success"`
	DurationMs    int64    `json:"durationMs"`
	Error         string   `json:"error,omitempty"`
	Output        string   `json:"output,omitempty"`
}

type ValidationIssue struct {
	Severity ValidationIssueSeverity `json:"severity"`
	Kind     string                  `json:"kind"`
	Task     string                  `json:"task,omitempty"`
	Path     string                  `json:"path,omitempty"`
	Message  string                  `json:"message"`
}

type ValidationIssueSeverity string

type ValidationMode string

type ValidationOrderRun struct {
	Index             int      `json:"index"`
	Tasks             []string `json:"tasks"`
	Success           bool     `json:"success"`
	FailedTask        string   `json:"failedTask,omitempty"`
	Error             string   `json:"error,omitempty"`
	Log               string   `json:"log,omitempty"`
	OutputDigest      string   `json:"outputDigest,omitempty"`
	OutputDifferences []string `json:"outputDifferences,omitempty"`
	DurationMs        int64    `json:"durationMs"`
}

type ValidationResult struct {
	Project    string                    `json:"project"`
	Target     string                    `json:"target"`
	Worktree   string                    `json:"worktree"`
	Mode       ValidationMode            `json:"mode"`
	Success    bool                      `json:"success"`
	DurationMs int64                     `json:"durationMs"`
	Artifacts  *ArtifactValidationResult `json:"artifacts,omitempty"`
	Orders     *OrderValidationResult    `json:"orders,omitempty"`
	Issues     []ValidationIssue         `json:"issues,omitempty"`
}

type VersionResult struct {
	Version     string `json:"version"`
	ModulePath  string `json:"modulePath"`
	GoVersion   string `json:"goVersion"`
	VCSRevision string `json:"vcsRevision,omitempty"`
	VCSTime     string `json:"vcsTime,omitempty"`
	Modified    bool   `json:"modified,omitempty"`
}