save progress

2025-12-26 22:03:32 +02:00
parent 9a4cd2e0f7
commit e6c47c8f50
3634 changed files with 253222 additions and 56632 deletions
--- a/docs/schemas/plugin-manifest.schema.json
+++ b/docs/schemas/plugin-manifest.schema.json
@@ -0,0 +1,157 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schema.stella-ops.org/plugin-manifest/v2.json",
+  "title": "StellaOps Plugin Manifest",
+  "description": "Schema for plugin.json manifest files (v2.0)",
+  "type": "object",
+  "required": ["id", "name", "assembly"],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "description": "Schema version. Current version is 2.0",
+      "default": "2.0",
+      "enum": ["1.0", "2.0"]
+    },
+    "id": {
+      "type": "string",
+      "description": "Unique plugin identifier in format: stellaops.{module}.{plugin}",
+      "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)*$",
+      "examples": ["stellaops.router.tcp", "stellaops.scanner.lang.dotnet"]
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable display name",
+      "minLength": 1,
+      "maxLength": 100
+    },
+    "version": {
+      "type": "string",
+      "description": "Plugin version (SemVer)",
+      "default": "1.0.0",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.]+)?(?:\\+[a-zA-Z0-9.]+)?$"
+    },
+    "assembly": {
+      "$ref": "#/$defs/assemblyDescriptor"
+    },
+    "type": {
+      "type": "string",
+      "description": "Entry point type for plugin initialization (fully qualified type name)",
+      "examples": ["StellaOps.Router.Tcp.TcpTransportPlugin"]
+    },
+    "capabilities": {
+      "type": "array",
+      "description": "Plugin capabilities",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*(?::[a-zA-Z0-9*.-]+)?$"
+      },
+      "examples": [["signing:ES256", "transport:tcp", "analyzer:dotnet"]]
+    },
+    "platforms": {
+      "type": "array",
+      "description": "Supported platforms. Empty array means all platforms",
+      "items": {
+        "type": "string",
+        "enum": ["*", "linux", "linux-x64", "linux-arm64", "win", "win-x64", "win-arm64", "osx", "osx-x64", "osx-arm64"]
+      },
+      "default": []
+    },
+    "compliance": {
+      "type": "array",
+      "description": "Compliance standards",
+      "items": {
+        "type": "string"
+      },
+      "examples": [["NIST", "FIPS-140-3", "GOST", "eIDAS", "KCMVP", "GM/T"]]
+    },
+    "jurisdiction": {
+      "type": "string",
+      "description": "Jurisdiction restriction",
+      "enum": ["world", "russia", "china", "eu", "korea", "usa"],
+      "default": "world"
+    },
+    "priority": {
+      "type": "integer",
+      "description": "Loading priority (0-100). Higher priority plugins are loaded first",
+      "minimum": 0,
+      "maximum": 100,
+      "default": 100
+    },
+    "enabled": {
+      "type": "boolean",
+      "description": "Whether the plugin is enabled by default",
+      "default": true
+    },
+    "enabledByDefault": {
+      "type": "boolean",
+      "description": "Whether the plugin is enabled by default in new installations",
+      "default": false
+    },
+    "options": {
+      "type": "object",
+      "description": "Plugin-specific configuration options",
+      "additionalProperties": true
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional metadata",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "author": {
+          "type": "string",
+          "description": "Plugin author"
+        },
+        "license": {
+          "type": "string",
+          "description": "License identifier (SPDX)"
+        },
+        "homepage": {
+          "type": "string",
+          "format": "uri",
+          "description": "Plugin homepage URL"
+        },
+        "repository": {
+          "type": "string",
+          "format": "uri",
+          "description": "Source repository URL"
+        }
+      }
+    },
+    "dependencies": {
+      "type": "array",
+      "description": "Plugin dependencies (other plugin IDs)",
+      "items": {
+        "type": "string"
+      }
+    },
+    "conditionalCompilation": {
+      "type": "string",
+      "description": "Conditional compilation symbol required to build this plugin"
+    }
+  },
+  "$defs": {
+    "assemblyDescriptor": {
+      "type": "object",
+      "description": "Descriptor for the plugin assembly location",
+      "required": ["path"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "Relative path to the assembly DLL from the plugin directory",
+          "examples": ["StellaOps.Router.Tcp.dll"]
+        },
+        "sha256": {
+          "type": "string",
+          "description": "SHA256 hash of the assembly for integrity verification",
+          "pattern": "^[a-fA-F0-9]{64}$"
+        },
+        "signaturePath": {
+          "type": "string",
+          "description": "Path to signature file (.sig) for cosign verification"
+        }
+      }
+    }
+  }
+}