docs.sync.pluginmanifest

Plugin manifest reconciliation detects inconsistencies between your plugin.yaml and Betty Framework registries by comparing active skills and commands, identifying missing entries, orphaned mappings, and metadata mismatches across permissions, runtime, and handlers.

The reconciliation process reports missing commands that exist in plugin.yaml but lack registry entries, orphaned registry mappings with no corresponding plugin definitions, and metadata mismatches that indicate sync problems requiring resolution.

Yes. The Skill generates plugin.preview.yaml and plugin_manifest_diff.md outputs so you can review all detected inconsistencies and proposed changes before committing updates to your registries and plugin manifest.

You need PyYAML as a dependency to load and parse registry files and plugin.yaml data. The Skill builds lookup indexes from both sources and performs mismatch analysis to generate reconciliation reports.

The reconciliation builds indexes of active skills and commands from registry files, compares them against plugin.yaml definitions, and flags mismatches in permissions, runtime configuration, and handler mappings that indicate sync drift.

Manual registry edits and plugin updates can create orphaned entries and metadata inconsistencies. Regular reconciliation prevents command registration failures, runtime errors from stale handler references, and permission drift between plugin definitions and active registry state.