bundle

type BundleAddCmd struct {
	Name string `arg:"" help:"Deploy name ('host' for local system; any other string is a container deploy name)"`
	Ref  string `arg:"" optional:"" help:"Box or candy reference (local name, ./path.yml, or github.com/org/repo[/box/<n>|/candy/<n>][@ref])"`

	// Candy overlays (repeatable).
	AddCandy []string `name:"add-candy" help:"Extra candy to apply on top of the base image (repeatable)"`

	// Plan-level flags.
	Tag      string `name:"tag" help:"Image CalVer tag (empty = newest local CalVer resolved via the ai.opencharly.version OCI label)"`
	DryRun   bool   `name:"dry-run" help:"Print the plan without executing"`
	NodeOnly bool   `` /* 147-byte string literal not displayed */
	Format   string `name:"format" default:"table" enum:"table,json" help:"Output format for --dry-run"`
	Pull     bool   `name:"pull" help:"Force re-fetch of remote refs / image pull"`
	Verify   bool   `name:"verify" help:"Re-run candy tests: on the host after install"`

	// Host-only gates.
	WithServices     bool   `name:"with-services" help:"Install systemd services (host target only)"`
	AllowRepoChanges bool   `name:"allow-repo-changes" help:"Allow repo config mutations (host target only)"`
	AllowRootTasks   bool   `name:"allow-root-tasks" help:"Allow arbitrary root cmd: tasks (host target only)"`
	SkipIncompatible bool   `name:"skip-incompatible" help:"Skip candies without host-matching format (host target only)"`
	BuilderImage     string `name:"builder-image" help:"Override the compile builder image"`
	DevLocalPkg      bool   `` /* 340-byte string literal not displayed */
	AssumeYes        bool   `name:"assume-yes" short:"y" help:"Assume yes; implies all allow-* gates plus skip sudo preflight"`

	// Disposable + lifecycle classification (see /charly-internals:disposable).
	Disposable bool   `` /* 131-byte string literal not displayed */
	Lifecycle  string `` /* 147-byte string literal not displayed */
	// contains filtered or unexported fields
}

type BundleCmd struct {
	Add BundleAddCmd `cmd:"" help:"Apply a deploy: 'host' targets the local system; any other name targets a container"`
	Del BundleDelCmd `cmd:"" help:"Tear down a deploy by name"`

	FromImage BundleFromBoxCmd `` /* 149-byte string literal not displayed */

	Export BundleExportCmd `cmd:"" help:"Export effective config as charly.yml"`
	Import BundleImportCmd `cmd:"" help:"Import charly.yml file(s) into config"`
	Path   BundlePathCmd   `cmd:"" help:"Print charly.yml file path"`
	Reset  BundleResetCmd  `cmd:"" help:"Remove charly.yml overrides"`
	Show   BundleShowCmd   `cmd:"" help:"Show current charly.yml overrides"`
	Status BundleStatusCmd `cmd:"" help:"Show sync status between charly.yml and quadlet files"`
}

type BundleDelCmd struct {
	Name string `arg:"" help:"Deploy name (literal 'host' or a container deploy name)"`

	AssumeYes       bool `name:"assume-yes" short:"y" help:"Skip confirmation prompts"`
	KeepRepoChanges bool `name:"keep-repo-changes" help:"Don't revert repo config even at zero refcount"`
	KeepServices    bool `name:"keep-services" help:"Don't disable systemd units (just stop tracking)"`
	KeepImage       bool `name:"keep-image" help:"Don't remove the synthesized overlay image (container target only)"`
	DryRun          bool `name:"dry-run" help:"Print the teardown plan without executing"`
}

type BundleExportCmd struct {
	Boxes  []string `arg:"" optional:"" help:"Boxes to export (default: all with overrides)"`
	Output string   `short:"o" help:"Write to file instead of stdout"`
	All    bool     `help:"Export all enabled boxes with all runtime fields"`
}

type BundleFromBoxCmd struct {
	Ref       string   `arg:"" help:"Full image ref (local or registry), e.g. ghcr.io/opencharly/selkies-kde-nvidia:latest"`
	Name      string   `arg:"" optional:"" help:"Deploy name (default: the image-ref basename without tag)"`
	Instance  string   `short:"i" name:"instance" help:"Instance name"`
	Env       []string `short:"e" name:"env" sep:"none" help:"Set container env var (KEY=VALUE)"`
	Port      []string `short:"p" help:"Remap host port (newHost:containerPort)"`
	Cluster   string   `name:"cluster" help:"Target a K8s cluster profile instead of a local pod (emits Kustomize via the K8s from-box path)"`
	Namespace string   `name:"namespace" help:"K8s namespace override (--cluster only)"`
}

type BundleImportCmd struct {
	Files   []string `arg:"" help:"Deploy YAML files to import (merged left-to-right)"`
	Replace bool     `help:"Replace entire charly.yml instead of merging with existing"`
	Box     string   `name:"box" help:"Import only this box's config"`
}

type BundlePathCmd struct{}

type BundleResetCmd struct {
	Box      string `arg:"" optional:"" help:"Box to reset (omit to clear all)"`
	Instance string `short:"i" name:"instance" help:"Instance name"`
}

type BundleShowCmd struct {
	Box      string `arg:"" optional:"" help:"Show overrides for a specific box"`
	Instance string `short:"i" name:"instance" help:"Instance name"`
}

type BundleStatusCmd struct{}

type DeployFromBoxOpts struct {
	Engine         string // "podman" | "docker" (auto-detected if empty)
	ImageRef       string // fully-qualified registry/name:tag
	DeploymentName string // optional override; defaults to the basename of ImageRef without tag
	Instance       string // optional "image/instance" suffix
	ClusterName    string // cluster profile name
	Namespace      string // optional override of the cluster's default namespace
	DeployOverlay  *spec.Deploy
	OutputDir      string // defaults to <cwd>/.opencharly/k8s
	ProjectDir     string // for the self-loaded kind:k8s cluster lookup (resolveK8sSpec)
}

type DeployRef struct {
	Raw    string          // original input
	Kind   RefKind         // box or candy
	Source RefSource       // local-name | local-path | remote
	Name   string          // resolved short name (ripgrep, fedora-coder, …)
	Path   string          // absolute path (local-path only; unset for local-name)
	Remote *spec.ParsedRef // populated for remote refs
}

type K8sGenerateOpts struct {
	DeploymentName string // the deployment's base name
	Instance       string // "" for the bare overlay; non-empty for image/instance
	ImageRef       string // fully qualified image ref (registry/name:tag)
	Deploy         spec.Deploy
	Capabilities   *spec.BoxMetadata
	Cluster        *spec.ResolvedK8s
	OutputDir      string // usually <projectDir>/.opencharly/k8s
}

type RefKind string

type RefSource string