plugins/_plugin_validator/webui/plugin-validator-guidance.md

• Store gate pattern: wrap store-backed UI in <template x-if="$store.myStore"> and mount cleanup on the inner element.
• Store definition: use createStore from /js/AlpineStore.js; do not register Alpine stores inline in HTML or via alpine:init.
• Notifications: use toastFrontendError, toastFrontendSuccess, or backend notification helpers; do not render inline error boxes.
• Python extensions: use extensions/python/<point>/ for named lifecycle hooks and extensions/python/_functions/<module>/<qualname>/<start|end>/ for implicit @extensible hooks. The flattened extensions/python/<module>_<qualname>_<start|end>/ layout is stale and should be flagged.
• API handlers: subclass ApiHandler and return a dict or Response.
• Tools: subclass Tool from helpers.tool.
• AgentContext imports: use from agent import AgentContext, AgentContextType, never helpers.context.
• Hooks runtime targeting: use sys.executable only for framework runtime work and /opt/venv/bin/python for agent-runtime installs.
• execute.py pattern: expose main() and end with if __name__ == "__main__": sys.exit(main()).
• Community contribution: plugin name must match ^[a-z0-9_]+$, match the directory name, and stay unique in the published index.
• LICENSE: a file named LICENSE at the plugin root is optional for local-only plugins but required at the repository root before Plugin Index submission; if missing, rate Structure Validation as warning (not pass) and state that clearly in findings.