recommend

Documentation

Overview

Package recommend produces a filtered, grouped view of which plugins provide a set of requested capabilities. Pure + deterministic (design V2): no ranking (inventory carries no quality/popularity signal — design review D13).

NOTE: the inventory is manifest-derived (registry manifests + sibling plugin.json checkouts); it does NOT carry runtime-factory-verified signal. Providers carry real Kind ("registry"|"external"|"local-plugin") + ReleaseStatus ("released"| "local-only") fields, surfaced as-is for the consumer to interpret.

Index

• type CapabilityHit
• type Options
• type ProviderSummary
• type Recommendation
  • func Recommend(inv *inventory.Inventory, opts Options) *Recommendation

Types

type CapabilityHit

type CapabilityHit struct {
	ID        string            `json:"id"`
	Category  string            `json:"category"`
	Name      string            `json:"name"`
	Providers []ProviderSummary `json:"providers"`
}

CapabilityHit groups providers of one capability.

type Options

type Options struct {
	Capabilities         []string
	Categories           []string
	IncludeUncategorized bool
}

Options selects capabilities to recommend for.

type ProviderSummary

type ProviderSummary struct {
	Name          string `json:"name"`
	Kind          string `json:"kind"`
	ReleaseStatus string `json:"releaseStatus,omitempty"`
	Source        string `json:"source,omitempty"`
}

ProviderSummary is a compact provider descriptor (real inventory fields).

type Recommendation

type Recommendation struct {
	Requested    []string        `json:"requested"`
	Capabilities []CapabilityHit `json:"capabilities"`
	Unmatched    []string        `json:"unmatched,omitempty"`
}

Recommendation is the filtered + grouped result.

func Recommend

func Recommend(inv *inventory.Inventory, opts Options) *Recommendation

Recommend filters inv to requested capabilities and groups their providers. It is pure: it performs no ranking (the inventory carries no quality or popularity signal) and produces a deterministic ordering.