harness

type Artifact struct {
	Name string `json:"name,omitempty"`
	Kind string `json:"kind,omitempty"`
	Path string `json:"path,omitempty"`
}

type ArtifactSpec struct {
	Name        string `json:"name"`
	Kind        string `json:"kind,omitempty"`
	PathHint    string `json:"path_hint,omitempty"`
	Description string `json:"description,omitempty"`
}

type Capabilities struct {
	SchemaVersion string              `json:"schema_version"`
	GlobalFlags   []FlagSpec          `json:"global_flags"`
	Commands      []CommandCapability `json:"commands"`
}

type CheckResult struct {
	Name    string `json:"name"`
	Status  Status `json:"status"`
	Details string `json:"details,omitempty"`
}

type CommandCapability struct {
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	Flags       []FlagSpec     `json:"flags,omitempty"`
	Artifacts   []ArtifactSpec `json:"artifacts,omitempty"`
}

type CommandInput struct {
	Name        string
	SummaryPath string
	DryRun      bool
	Explain     bool
	Execute     ExecuteFunc
}

type CommandOutcome struct {
	Checks    []CheckResult
	Failures  []Failure
	Artifacts []Artifact
	Data      any
}

type CommandSummary struct {
	SchemaVersion string        `json:"schema_version"`
	Command       string        `json:"command"`
	Status        Status        `json:"status"`
	StartedAt     time.Time     `json:"started_at"`
	FinishedAt    time.Time     `json:"finished_at"`
	DurationMs    int64         `json:"duration_ms"`
	Checks        []CheckResult `json:"checks,omitempty"`
	Failures      []Failure     `json:"failures,omitempty"`
	Artifacts     []Artifact    `json:"artifacts,omitempty"`
	Data          any           `json:"data,omitempty"`
}

type Context struct {
	DryRun  bool
	Explain bool
}

type ExecuteFunc func(ctx Context) (CommandOutcome, error)

type Failure struct {
	Code      string `json:"code"`
	Message   string `json:"message"`
	Hint      string `json:"hint,omitempty"`
	Retryable bool   `json:"retryable"`
}

type FailureCode string

type FailureError struct {
	Failure Failure
	Cause   error
}

type FlagSpec struct {
	Name        string `json:"name"`
	Type        string `json:"type,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Default     string `json:"default,omitempty"`
	Description string `json:"description,omitempty"`
}

type Status string