intent

type Candidate struct {
	Profile, Ring, Label                string
	Experiment, Variant, ExperimentRing string
}

type Change struct {
	Dir   string
	Files map[string][]byte
	// Notes are follow-ups for the human (printed after the file list).
	Notes []string
	// Done lists side effects already performed, e.g. a published release.
	Done []string
}

type Doc struct {
	Kind policy.Kind
	Name string
	Path string // canonical repo-relative path
	// contains filtered or unexported fields
}

type Enable struct {
	MCP  *policy.MCPServer
	Hook *policy.Hook
	// Name of the toggle (defaults to the MCP server name; required for hooks).
	Name string
	// For is who gets it: "all" (a profile change), a ring name, "N%",
	// "group:<g>" or "user:<id>" (a client-axis Toggle).
	For     string
	Owner   string
	Expires string // YYYY-MM-DD; default 90 days from Now
	Now     time.Time
}

type Explained struct {
	Kind   policy.Kind `json:"kind"`
	Name   string      `json:"name"`
	Source string      `json:"source"`
	YAML   string      `json:"yaml"`
}

type InitOptions struct {
	Org      string
	Tools    map[string]string // tool -> version
	Provider string
	Project  string            // Google Cloud project, provider vertex
	Models   map[string]string // alias -> model id
	// ToolModels maps a tool to the alias it starts on instead of default (set by Complete).
	ToolModels map[string]string
	Gateway    string
	// GatewayEngine: "" (halo-proxy), kong, or external (your own API gateway).
	GatewayEngine string
	Issuer        string
	ClientID      string   // OIDC client id (portal login); optional
	Admins        []string // identity.adminGroups (ring0 team and portal admins); optional
	Safety        string
	Rollout       string
}

type ModelSwitch struct {
	Alias, Model string
	Canary       bool
}

type Repo struct {
	Dir  string
	Root *policy.Root
	Org  *policy.Org
}

type Upgrade struct {
	Tool, Version string
	// Release is the digest of the release carrying the new pin; Baseline the
	// digest rings return to on rollback. Both may be left empty for PlanUpgrade
	// (the caller builds and publishes the candidate, then calls Finish).
	Release, Baseline string
	// Label is the candidate release's version label (default "<tool>-<version>").
	Label string
}

type UpgradePlan struct {
	Name      string
	Candidate Candidate
	// Change holds the treatment profile, the experiment and ring stubs;
	// Change.Load() gives the policy to build the candidate from.
	Change *Change
	// contains filtered or unexported fields
}