catalog

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 5, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	ErrEnabledUnresolved = errors.New("backendplugins/catalog: enabled kind unresolved")
	ErrStrictInvalid     = errors.New("backendplugins/catalog: strict mode rejects invalid artifacts")
)

Functions

This section is empty.

Types

type Entry

type Entry struct {
	SafeID     string
	PluginID   string
	ExportKind string
	State      State
	Reason     Reason
	Owners     []string // SafeIDs involved in a conflict
}

Entry is one inspect-ready catalog record.

type Input

type Input struct {
	Discovered   []discovery.Descriptor
	TrustBySafe  map[string]trust.VerifyResult
	BuiltinKinds []string
	EnabledKinds []string
	Strict       bool
	HostMajor    uint32
	HostMinor    uint32
}

Input feeds catalog resolution.

type Reason

type Reason string

Reason is a bounded diagnostic code without full paths or secrets.

const (
	ReasonOK                   Reason = "ok"
	ReasonDuplicatePluginID    Reason = "duplicate_plugin_id"
	ReasonDuplicateExportKind  Reason = "duplicate_export_kind"
	ReasonBuiltinCollision     Reason = "builtin_collision"
	ReasonProtocolIncompatible Reason = "protocol_incompatible"
	ReasonInvalidUnused        Reason = "invalid_unused"
	ReasonEnabledMissing       Reason = "enabled_missing"
	ReasonEnabledInvalid       Reason = "enabled_invalid"
	ReasonUntrusted            Reason = "untrusted"
	ReasonDigestMismatch       Reason = "digest_mismatch"
)

type Snapshot

type Snapshot struct {
	Entries []Entry
}

Snapshot is an immutable catalog view.

func Resolve

func Resolve(in Input) (Snapshot, error)

Resolve builds a deterministic conflict-aware catalog snapshot. It never silently picks one of two colliding artifacts.

type State

type State string

State is a bounded inspect-safe artifact/export state.

const (
	StateBuiltin        State = "builtin"
	StateDiscovered     State = "discovered"
	StateIncompatible   State = "incompatible"
	StateInvalid        State = "invalid"
	StateUntrusted      State = "untrusted"
	StateDigestMismatch State = "digest_mismatch"
	StateConflict       State = "conflict"
	StateConfigured     State = "configured"
	StateActive         State = "active"
	StateFailed         State = "failed"
	StateStopped        State = "stopped"
)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL