migrate

type AgentReport struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace"`
	// Kind is the object's API and kind, such as kagent.dev/v1alpha2 Agent.
	Kind string `json:"kind"`
	// Owner is the HelmRelease the provenance labels name (namespace/name).
	Owner  string `json:"owner,omitempty"`
	Action string `json:"action"`
	Reason string `json:"reason,omitempty"`
}

type CRDReport struct {
	Name   string `json:"name"`
	Action string `json:"action"`
	Reason string `json:"reason,omitempty"`
}

type ChartInfo struct {
	OCIURL string `json:"ociUrl"`
	// TargetSemver is the range every source moves to.
	TargetSemver string `json:"targetSemver"`
	// TargetSemverFilter is the tag filter every source moves to; absent
	// when each source keeps its own.
	TargetSemverFilter *string `json:"targetSemverFilter,omitempty"`
	// LatestVersion is the newest published version in that range, "" when
	// none exists (no source is moved then).
	LatestVersion string `json:"latestVersion,omitempty"`
	// SchemaVersion / SchemaSource say which values.schema.json judged the
	// rewrites.
	SchemaVersion string `json:"schemaVersion"`
	SchemaSource  string `json:"schemaSource"`
}

type ContractReport struct {
	// AgentsDeleted are the old line's agent objects removed from the
	// namespace.
	AgentsDeleted []string `json:"agentsDeleted"`
	// CRDs is the fate of the five CRDs the 0.x -> 1.x hop removes
	// (cluster-scoped, so the same in every namespace's report); absent on
	// 1.x -> 2.x, where the platform removes the kagent.dev CRDs.
	CRDs []CRDReport `json:"crds,omitempty"`
}

type Options struct {
	// Namespaces are the managed namespaces (the default one first): the
	// releases rendering into them are migrated, their reports written there.
	Namespaces []string
	// GitOpsNamespaces are searched for Generic-chart HelmReleases with a
	// targetNamespace in Namespaces, next to what the provenance labels name.
	GitOpsNamespaces []string
	// HarnessName is the platform Harness every agent runs on; composed as
	// agent.harness when it is not the chart default.
	HarnessName string
	// ChartOCIURL identifies the agent chart's sources; TargetSemver is the
	// range they move to, and its major picks the hop (1.x or 2.x).
	ChartOCIURL  string
	TargetSemver string
	// TargetSemverFilter is the ref.semverFilter the sources move to with
	// the range; empty removes one, nil leaves each source's as it is.
	TargetSemverFilter *string
	// ReportConfigMap names the report per namespace.
	ReportConfigMap string
	// DryRun prints the report and writes nothing.
	DryRun bool
	// KagentAPIVersion is the served version of the kagent API the target
	// chart renders into: kagent.dev for 1.x, api.kagent.dev for 2.x.
	KagentAPIVersion string
	// HelmReleaseAPIVersion / OCIRepositoryAPIVersion are the served Flux APIs.
	HelmReleaseAPIVersion   string
	OCIRepositoryAPIVersion string
	// Version is the agent-manager version recorded in the report.
	Version string
}

type ReleaseReport struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace"`
	// TargetNamespace is where the release renders when it is not its own.
	TargetNamespace string `json:"targetNamespace,omitempty"`
	Ownership       string `json:"ownership"`
	Action          string `json:"action"`
	Reason          string `json:"reason,omitempty"`
	// ChartVersion is the deployed chart version (status.history), else the
	// last attempted revision.
	ChartVersion string        `json:"chartVersion,omitempty"`
	Changes      *ValueChanges `json:"changes,omitempty"`
	// Diff is the rewrite as a unified diff of the manifest (GitOps-owned and
	// external releases; never written).
	Diff string `json:"diff,omitempty"`
	// Warnings are what the rewrite cannot settle and the write does not
	// wait for (a sub-agent binding to a template that does not exist).
	Warnings []string `json:"warnings,omitempty"`
	// Template is the object the release renders on the target line (a
	// kagent.dev AgentTemplate on 1.x, an api.kagent.dev Agent on 2.x), as
	// the wait phase saw it.
	Template *TemplateReport `json:"template,omitempty"`
}

type Report struct {
	Namespace string  `json:"namespace"`
	Phase     string  `json:"phase"`
	Summary   string  `json:"summary"`
	Run       RunInfo `json:"run"`
	// Changed is true when this run wrote something in the namespace.
	Changed bool `json:"changed"`
	// Releases are the Generic-chart releases rendering into the namespace.
	Releases []ReleaseReport `json:"releases"`
	// Sources are the OCIRepositories of the agent chart those releases use.
	Sources []SourceReport `json:"sources"`
	// Agents are the old line's agent objects found in the namespace:
	// kagent.dev/v1alpha2 Agents (0.x -> 1.x) or kagent.dev/v1alpha3
	// AgentTemplates (1.x -> 2.x).
	Agents []AgentReport `json:"agents"`
	// Pending names what gates the next phase.
	Pending []string `json:"pending,omitempty"`
	// Warnings are what the wait phase found when nothing gates on it any
	// more (an object not Ready in a namespace that has nothing left to
	// contract).
	Warnings []string `json:"warnings,omitempty"`
	// Contract is what the contract phase did, when it ran.
	Contract *ContractReport `json:"contract,omitempty"`
}

type Result struct {
	Reports []*Report
}

type RunInfo struct {
	At      string `json:"at"`
	DryRun  bool   `json:"dryRun"`
	Version string `json:"version"`
	Harness string `json:"harness"`
	// Path is the hop the target range picks: "0.x -> 1.x" or "1.x -> 2.x".
	Path  string    `json:"path"`
	Chart ChartInfo `json:"chart"`
}

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

type SkillPin struct {
	Name string `json:"name"`
	// Source is the reference as the 0.x values carried it (repository@ref
	// with its path, or the OCI reference).
	Source string `json:"source"`
	// Pinned is the commit id or the digest reference written.
	Pinned string `json:"pinned"`
}

type SourceReport struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace"`
	Ownership string `json:"ownership"`
	Action    string `json:"action"`
	From      string `json:"from,omitempty"`
	To        string `json:"to,omitempty"`
	// FromSemverFilter and ToSemverFilter are the source's ref.semverFilter
	// before and after, beside the range.
	FromSemverFilter string `json:"fromSemverFilter,omitempty"`
	ToSemverFilter   string `json:"toSemverFilter,omitempty"`
	Reason           string `json:"reason,omitempty"`
	Diff             string `json:"diff,omitempty"`
}

type StatusReader interface {
	Status(ctx context.Context, loc agents.Location, name string) (*agents.Status, error)
}

type TemplateReport struct {
	Name    string `json:"name"`
	Exists  bool   `json:"exists"`
	Verdict string `json:"verdict,omitempty"`
	Summary string `json:"summary,omitempty"`
}

type TemplateStatus struct {
	Client     dynamic.Interface
	APIVersion string
	Harness    string
}

type ValueChanges struct {
	// Removed are the 0.x keys dropped (dotted paths).
	Removed []string `json:"removed,omitempty"`
	// Renamed are the keys moved, as "old -> new".
	Renamed []string `json:"renamed,omitempty"`
	// Set are the keys the platform adds, as "key=value".
	Set []string `json:"set,omitempty"`
	// Skills are the skill references pinned, one per entry whose written
	// form changed.
	Skills []SkillPin `json:"skills,omitempty"`
	// DriftIgnoreRemoved are the v1alpha2 driftDetection.ignore paths dropped
	// from the HelmRelease.
	DriftIgnoreRemoved []string `json:"driftIgnoreRemoved,omitempty"`
}