plugincatalog

type ApplicationContributionView struct {
	ID    string `json:"id"`
	Title string `json:"title,omitempty"`
}

type Catalog interface {
	Plugins(tenant string) ([]PluginView, error)
	Plugin(tenant, id string) (PluginView, bool, error)
	Instances(tenant string) ([]InstanceView, error)
	Instance(tenant, id string) (InstanceView, bool, error)
}

type ConnectorContributionView struct {
	ID        string `json:"id"`
	Title     string `json:"title,omitempty"`
	Direction string `json:"direction,omitempty"`
	Host      string `json:"host,omitempty"`
}

type ContributesView struct {
	Drivers      []DriverContributionView      `json:"drivers,omitempty"`
	Applications []ApplicationContributionView `json:"applications,omitempty"`
	Connectors   []ConnectorContributionView   `json:"connectors,omitempty"`
}

type DriverContributionView struct {
	ID                string `json:"id"`
	Title             string `json:"title,omitempty"`
	Descriptor        string `json:"descriptor,omitempty"`
	ConfigSchema      string `json:"configSchema,omitempty"`
	Discovery         string `json:"discovery,omitempty"`
	CapabilityCatalog string `json:"capabilityCatalog,omitempty"`
}

type InstanceView struct {
	Tenant         string `json:"tenant"`
	EdgeID         string `json:"edge_id"`
	ID             string `json:"id"`
	Plugin         string `json:"plugin"`
	Version        string `json:"version"`
	DesiredEnabled bool   `json:"desired_enabled"`
	ObservedState  string `json:"observed_state"`
	Health         string `json:"health"`
	DataPreserved  bool   `json:"data_preserved"`
	ConfigPresent  bool   `json:"config_present"`
	// Drift 表示 desired_revision 与 applied_revision 不一致（期望已变、Edge 未确认）。
	Drift bool `json:"drift"`
	// Stale 表示 observed 投影过期或所属 edge 离线；只标记，绝不改写 desired。
	Stale   bool        `json:"stale"`
	Metrics MetricsView `json:"metrics"`
}

type MetricsView struct {
	CPUTime      int64   `json:"cpu_ms"`
	RSSBytes     int64   `json:"rss_bytes"`
	Handles      int     `json:"handles"`
	Goroutines   int     `json:"goroutines"`
	MessageRate  float64 `json:"message_rate"`
	RestartCount int     `json:"restart_count"`
	LastHealthy  int64   `json:"last_healthy"`
}

type Observed struct {
	HostOnline bool
	State      pluginhost.State
	Health     pluginhost.Health
}

type PermissionsView struct {
	Hardware   []string `json:"hardware,omitempty"`
	Network    []string `json:"network,omitempty"`
	Filesystem []string `json:"filesystem,omitempty"`
	Secrets    []string `json:"secrets,omitempty"`
}

type PluginView struct {
	ID            string          `json:"id"`
	Kind          string          `json:"kind"`
	Version       string          `json:"version"`
	Source        string          `json:"source"`
	Digest        string          `json:"digest"`
	Verified      bool            `json:"verified"`
	Compatibility string          `json:"compatibility,omitempty"`
	Protocol      int             `json:"protocol"`
	Permissions   PermissionsView `json:"permissions"`
	Contributes   ContributesView `json:"contributes"`
}

type ProjectionInstance struct {
	TenantID   int64
	Tenant     string
	EdgeID     string
	InstanceID string
	PluginID   string
	Version    string
	Enabled    bool
	Isolation  string
	// Config 只含非敏感标量与 secret://<name> handle（写入时已拒绝明文凭据）。
	Config map[string]string
	// ConfigPresent 只表示「有非敏感配置」，绝不携带 secret 明文。
	ConfigPresent bool
	// SecretRefs 只含 secret://<name> handle 名。
	SecretRefs []string

	HasObserved bool
	// ObservedVersion 是 Edge 上报的实际版本，与 desired Version 分别承载：
	// 只有 observed 的实例（Server 无期望态）不得把上报值塞进 desired 子视图。
	ObservedVersion string
	State           string
	Health          string
	Detail          string
	RestartCount    int
	LastHealthy     int64
	ReportedAt      int64
	MessageRate     float64

	EdgeOnline      bool
	DesiredRevision uint64
	AppliedRevision uint64
	Drift           bool
	Stale           bool
	LastAckAt       int64
	UpdatedAt       int64
	RowRevision     uint64
}

type ProjectionSource interface {
	// Installations 返回租户可见的已安装插件公开事实（Edge 上报投影）。
	Installations(tenant string) ([]api.PluginInstallationStatusData, error)
	// Instances 返回租户可见的插件实例合成事实（desired + observed）。
	Instances(tenant string) ([]ProjectionInstance, error)
}

type Reader interface {
	// Lockfile 返回安装锁文件。
	Lockfile() (*registry.LockFile, error)
	// Manifest 返回 pluginID 的已安装 manifest。
	Manifest(pluginID string) (*registry.Manifest, error)
	// DesiredStates 返回租户的期望实例状态；空 tenant 表示全部租户（开发/全局形态）。
	DesiredStates(tenant string) ([]plugincontrol.InstanceState, error)
	// Observed 返回单实例的观测运行时状态；ok=false 表示 Host 未运行或无法观测。
	Observed(tenant, instanceID string) (Observed, bool)
	// Metrics 返回点时刻资源指标；ok=false 表示不可用。
	Metrics(tenant, instanceID string) (pluginhost.Metrics, bool)
}

type SourceReader struct {
	LockfileFn func() (*registry.LockFile, error)
	ManifestFn func(pluginID string) (*registry.Manifest, error)
	DesiredFn  func(tenant string) ([]plugincontrol.InstanceState, error)
	ObservedFn func(tenant, instanceID string) (Observed, bool)
	MetricsFn  func(tenant, instanceID string) (pluginhost.Metrics, bool)
}