Struct PluginManifest 

pub struct PluginManifest {
    pub name: String,
    pub version: String,
    pub description: String,
    pub author: String,
    pub license: String,
    pub plugin_type: String,
    pub runtime: String,
    pub sdk_version: String,
    pub hooks: Vec<String>,
    pub config_schema: Option<Value>,
    pub capabilities: Option<Capabilities>,
    pub homepage: Option<String>,
}

Plugin manifest — the on-disk .progit-plugin.json.

Backwards compatible with v0.1 manifests: missing fields fall back to permissive defaults. New plugins should set capabilities explicitly.

Fields

name: String

Unique plugin id (also the directory name).

version: String

Semver of the plugin itself.

description: String

One-line summary, shown in the plugin browser.

author: String

Author handle or organisation.

license: String

SPDX identifier (LSL-1.0, LUL-1.0, Apache-2.0, …).

plugin_type: String

Free-form classification: notifier | integration | analytics | …

runtime: String

lua or wasm.

sdk_version: String

Required SDK API version (">=0.2", "^0.2", "0.2" exact). Defaults to ">=0.1.0" for legacy manifests.

hooks: Vec<String>

Hooks the plugin claims to implement. Cross-checked against the hooks the Lua / Wasm side actually registers.

config_schema: Option<Value>

JSON Schema for the plugin’s slice of .project/config.kdl. Treated as opaque JSON until a host-side schema validator lands.

capabilities: Option<Capabilities>

Capability declaration — what this plugin is allowed to do. Missing = fully permissive (with a deprecation warning).

homepage: Option<String>

Optional homepage / source URL for the marketplace.

Implementations

impl PluginManifest

pub fn load(path: &Path) -> ManifestResult<Self>

Load and parse a manifest from disk.

pub fn from_str(json: &str) -> ManifestResult<Self>

Parse a manifest from a JSON string.

pub fn effective_capabilities(&self) -> Capabilities

Effective capabilities — declared block, or the legacy permissive default. Use this everywhere the runtime asks “may I?”.

pub fn capabilities_implicit(&self) -> bool

Was the capability block omitted? (Used to emit a one-shot deprecation warning on plugin load.)

pub fn check_sdk_compat(&self, sdk_api_version: &str) -> ManifestResult<()>

Reject the plugin if its sdk_version constraint is incompatible with the running SDK’s API version.

pub fn check_hooks(&self, observed: &[&str]) -> ManifestResult<()>

Confirm every hook implemented by the plugin’s runtime side is also declared in the manifest. Caller passes the hooks observed from the Lua/Wasm side.

Trait Implementations

impl Clone for PluginManifest

fn clone(&self) -> PluginManifest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PluginManifest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PluginManifest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PluginManifest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.