@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

package/schemas/sdd/codesdd-plugin.schema.json

@@ -0,0 +1,645 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 3
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$"
+    },
+    "contract_version": {
+      "type": "number",
+      "const": 1
+    },
+    "vendor": {
+      "type": "string",
+      "minLength": 2
+    },
+    "codesdd_compat": {
+      "type": "object",
+      "properties": {
+        "versions": {
+          "type": "string",
+          "minLength": 1
+        },
+        "sdd_contract_versions": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991
+          }
+        }
+      },
+      "required": [
+        "versions",
+        "sdd_contract_versions"
+      ],
+      "additionalProperties": false
+    },
+    "technology": {
+      "type": "object",
+      "properties": {
+        "language": {
+          "type": "string",
+          "minLength": 1
+        },
+        "framework": {
+          "type": "string"
+        },
+        "runtime": {
+          "type": "string"
+        },
+        "package_manager": {
+          "type": "string"
+        },
+        "min_versions": {
+          "default": {},
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "language",
+        "min_versions"
+      ],
+      "additionalProperties": false
+    },
+    "package_governance": {
+      "type": "object",
+      "properties": {
+        "package_name": {
+          "type": "string",
+          "pattern": "^@devtrack-solution\\/codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+        },
+        "sdk_package": {
+          "default": "@devtrack-solution/codesdd-plugin-sdk",
+          "type": "string",
+          "pattern": "^@devtrack-solution\\/codesdd-plugin-sdk$"
+        },
+        "sdk_version": {
+          "default": "*",
+          "type": "string",
+          "pattern": "^(?:[~^]?\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?|[<>]=?\\d+\\.\\d+\\.\\d+(?:\\s+<\\d+\\.\\d+\\.\\d+)?|\\*)$"
+        },
+        "package_kind": {
+          "type": "string",
+          "enum": [
+            "frontend",
+            "backend",
+            "full-stack",
+            "generator",
+            "validator",
+            "evidence",
+            "agent-adapter",
+            "policy-pack"
+          ]
+        },
+        "versioning": {
+          "default": "semver",
+          "type": "string",
+          "const": "semver"
+        },
+        "registry": {
+          "default": "workspace",
+          "type": "string",
+          "enum": [
+            "workspace",
+            "npm",
+            "private-npm",
+            "artifact-registry",
+            "custom"
+          ]
+        },
+        "keywords": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "internal_package": {
+          "default": false,
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "package_name",
+        "sdk_package",
+        "sdk_version",
+        "package_kind",
+        "versioning",
+        "registry",
+        "keywords",
+        "internal_package"
+      ],
+      "additionalProperties": false
+    },
+    "language_runtime": {
+      "type": "object",
+      "properties": {
+        "language": {
+          "type": "string",
+          "enum": [
+            "typescript",
+            "javascript",
+            "python",
+            "java",
+            "go",
+            "rust",
+            "csharp",
+            "php",
+            "ruby",
+            "shell",
+            "other"
+          ]
+        },
+        "runtime": {
+          "type": "string",
+          "minLength": 1
+        },
+        "bridge": {
+          "type": "string",
+          "enum": [
+            "node-library",
+            "stdio-json",
+            "process-cli",
+            "http-local",
+            "container",
+            "wasm"
+          ]
+        },
+        "input_transport": {
+          "type": "string",
+          "enum": [
+            "sdk-call",
+            "stdin-json",
+            "stdout-json",
+            "file-envelope",
+            "http-json"
+          ]
+        },
+        "output_transport": {
+          "type": "string",
+          "enum": [
+            "sdk-call",
+            "stdin-json",
+            "stdout-json",
+            "file-envelope",
+            "http-json"
+          ]
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "package_manager": {
+          "type": "string",
+          "minLength": 1
+        },
+        "min_versions": {
+          "default": {},
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "env_allowlist": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z_][A-Z0-9_]*$"
+          }
+        }
+      },
+      "required": [
+        "language",
+        "runtime",
+        "bridge",
+        "input_transport",
+        "output_transport",
+        "args",
+        "min_versions",
+        "env_allowlist"
+      ],
+      "additionalProperties": false
+    },
+    "capabilities": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 20
+          },
+          "input_schema": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          },
+          "output_schema": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string"
+            },
+            "additionalProperties": {}
+          },
+          "deterministic": {
+            "type": "boolean"
+          },
+          "idempotent": {
+            "type": "boolean"
+          },
+          "supports_dry_run": {
+            "type": "boolean"
+          },
+          "supports_apply": {
+            "type": "boolean"
+          },
+          "supports_rollback": {
+            "default": false,
+            "type": "boolean"
+          },
+          "write_scope": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "risk_tier": {
+            "default": "medium",
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "approval": {
+            "default": "maintainer",
+            "type": "string",
+            "enum": [
+              "none",
+              "maintainer",
+              "security",
+              "architecture-board"
+            ]
+          }
+        },
+        "required": [
+          "name",
+          "description",
+          "input_schema",
+          "output_schema",
+          "deterministic",
+          "idempotent",
+          "supports_dry_run",
+          "supports_apply",
+          "supports_rollback",
+          "write_scope",
+          "risk_tier",
+          "approval"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "execution": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "timeout_seconds": {
+          "default": 120,
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 3600
+        },
+        "env_allowlist": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[A-Z_][A-Z0-9_]*$"
+          }
+        },
+        "network": {
+          "default": "disabled",
+          "type": "string",
+          "enum": [
+            "disabled",
+            "restricted",
+            "enabled"
+          ]
+        },
+        "process_spawn": {
+          "default": "forbidden",
+          "type": "string",
+          "enum": [
+            "forbidden",
+            "declared"
+          ]
+        },
+        "working_directory": {
+          "default": ".",
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "command",
+        "args",
+        "timeout_seconds",
+        "env_allowlist",
+        "network",
+        "process_spawn",
+        "working_directory"
+      ],
+      "additionalProperties": false
+    },
+    "artifacts": {
+      "type": "object",
+      "properties": {
+        "writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "forbidden_writes": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "naming_conventions": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "writes",
+        "forbidden_writes",
+        "naming_conventions"
+      ],
+      "additionalProperties": false
+    },
+    "supply_chain": {
+      "type": "object",
+      "properties": {
+        "checksum": {
+          "type": "string"
+        },
+        "signature": {
+          "type": "string"
+        },
+        "provenance": {
+          "type": "string"
+        },
+        "sbom": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "minLength": 2
+        },
+        "support_sla": {
+          "type": "string",
+          "minLength": 1
+        },
+        "deprecation_window": {
+          "type": "string",
+          "minLength": 1
+        },
+        "policy_packs": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "trust_tier": {
+          "type": "string",
+          "enum": [
+            "local-dev",
+            "experimental",
+            "enterprise-approved",
+            "blocked"
+          ]
+        },
+        "allowed_domains": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "risk_tier": {
+          "default": "medium",
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high",
+            "critical"
+          ]
+        }
+      },
+      "required": [
+        "owner",
+        "support_sla",
+        "deprecation_window",
+        "policy_packs",
+        "trust_tier",
+        "allowed_domains",
+        "risk_tier"
+      ],
+      "additionalProperties": false
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "commands": {
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "coverage_target": {
+          "default": 95,
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "security_checks": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "dependency_checks": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "required": [
+        "commands",
+        "coverage_target",
+        "security_checks",
+        "dependency_checks"
+      ],
+      "additionalProperties": false
+    },
+    "compression": {
+      "default": {
+        "enabled": false,
+        "engine": "none",
+        "mode": "pretooluse",
+        "exclude_commands": [],
+        "tee": "failures",
+        "max_output_tokens": 4000
+      },
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "engine": {
+          "default": "none",
+          "type": "string",
+          "enum": [
+            "rtk",
+            "headroom",
+            "builtin",
+            "none"
+          ]
+        },
+        "mode": {
+          "default": "pretooluse",
+          "type": "string",
+          "const": "pretooluse"
+        },
+        "exclude_commands": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tee": {
+          "default": "failures",
+          "type": "string",
+          "enum": [
+            "failures",
+            "always",
+            "never"
+          ]
+        },
+        "max_output_tokens": {
+          "default": 4000,
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 64000
+        }
+      },
+      "required": [
+        "enabled",
+        "engine",
+        "mode",
+        "exclude_commands",
+        "tee",
+        "max_output_tokens"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "id",
+    "name",
+    "version",
+    "contract_version",
+    "vendor",
+    "codesdd_compat",
+    "technology",
+    "capabilities",
+    "execution",
+    "artifacts",
+    "supply_chain",
+    "governance",
+    "validation",
+    "compression"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Enterprise Plugin Manifest",
+  "description": "Machine-readable contract for a CodeSDD enterprise plugin manifest."
+}