wiring

type Entry struct {
	// ConfigPath is the client config file holding the owned key.
	ConfigPath string
	// Group and ClientID reproduce the link's endpoint composition so
	// status can rebuild the planned value against the current port.
	Group    string
	ClientID string
	// Hashes is the canonical value-hash history, newest last. The
	// current value matching any of them means gridctl wrote it.
	Hashes []string
	// CreatedByGridctl is false for adopted entries: gridctl owns them
	// now but did not author their current value.
	CreatedByGridctl bool
	// Pack tags the record with the pack that applied it (empty = not
	// pack-managed).
	Pack     string
	SyncedAt time.Time
}

type LockFile struct {
	// Records maps client slug → entry name → record.
	Records map[string]map[string]*Entry
}

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

type Result struct {
	Client      string `json:"client"`
	Name        string `json:"name"`
	Target      string `json:"target,omitempty"`
	Action      string `json:"action"`
	Detail      string `json:"detail,omitempty"`
	Remediation string `json:"remediation,omitempty"`
	Error       string `json:"error,omitempty"`
}

type Row struct {
	Client      string     `json:"client"`
	Name        string     `json:"name"`
	Channel     string     `json:"channel"`
	Pack        string     `json:"pack,omitempty"`
	Target      string     `json:"target,omitempty"`
	State       string     `json:"state"`
	Detail      string     `json:"detail,omitempty"`
	Remediation string     `json:"remediation,omitempty"`
	SyncedAt    *time.Time `json:"synced_at,omitempty"`
}

type StatusOptions struct {
	// Port anchors the planned-value comparison (staleness) to the
	// current gateway port.
	Port int
	// ServerName is the default entry name scanned for foreign and
	// missing rows (default "gridctl").
	ServerName string
}

type SyncOptions struct {
	// Clients restricts the pass to these slugs. Empty means every
	// detected client.
	Clients []string
	// ServerName is the entry key to write (default "gridctl";
	// "gridctl-<group>" for group links).
	ServerName string
	// GatewayURL, Port, Group, and ClientID compose the entry exactly as
	// `gridctl link` flags do.
	GatewayURL string
	Port       int
	Group      string
	ClientID   string
	// Force overwrites foreign and drifted entries (after backup).
	Force bool
	// DryRun reports the plan without writing anything.
	DryRun bool
	// Pack tags recorded entries with the applying pack. Empty keeps any
	// existing tag (a plain link or sync never strips pack ownership).
	Pack string
}