ADR-013 Phase 0: plugin lifecycle groundwork (validate, apply-profile, dependency fixes)

shopdb/plugins/manifest_schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://shopdb-flask/plugin-manifest.schema.json",
+  "title": "shopdb-flask plugin manifest",
+  "description": "Shape of a plugin's manifest.json (ADR-002, ADR-013). Known fields are typed; additionalProperties is permitted so existing manifests and future additive fields validate unchanged.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["name", "version", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Machine name. Must equal the plugin directory name. Lowercase, concatenated.",
+      "pattern": "^[a-z][a-z0-9]*$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Plugin version (semver-ish string)."
+    },
+    "description": {
+      "type": "string",
+      "description": "One-line human description."
+    },
+    "display_name": {
+      "type": "string",
+      "description": "Human label for UIs. Falls back to a title-cased name."
+    },
+    "author": {
+      "type": "string"
+    },
+    "dependencies": {
+      "type": "array",
+      "description": "Hard dependencies: plugin names that must be installed and enabled first. A name may carry an optional PEP440 range (e.g. 'employees>=1.1'); the runtime loader uses name-only semantics.",
+      "items": { "type": "string" }
+    },
+    "optional_dependencies": {
+      "type": "array",
+      "description": "Soft couplings: plugins that unlock extra behavior when present, but do not block install/enable. Loader-ignored; adopt/list only WARN when unmet.",
+      "items": { "type": "string" }
+    },
+    "tier": {
+      "type": "string",
+      "description": "core = mandatory, lifecycle refuses to uninstall/disable it; optional = catalog plugin (default).",
+      "enum": ["core", "optional"]
+    },
+    "core_version": {
+      "type": "string",
+      "description": "PEP440 specifier set the framework contract version must satisfy, e.g. '>=0.12.0,<1.0.0'."
+    },
+    "api_prefix": {
+      "type": "string",
+      "description": "URL prefix for the plugin blueprint, e.g. '/api/printedparts'. Must be unique across enabled plugins."
+    },
+    "default_enabled": {
+      "type": "boolean",
+      "description": "Whether install leaves the plugin enabled. Plugins that provision extra tables ship false so a site opts in."
+    },
+    "provides": {
+      "type": "object",
+      "description": "Capabilities this plugin advertises (e.g. asset_type, a features list). Free-form object read by catalog/UI, not the loader."
+    },
+    "settings": {
+      "type": "object",
+      "description": "Plugin-scoped default settings metadata."
+    }
+  }
+}