@devtrack-solution/codesdd 1.2.2 → 1.2.4-rc3

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

@@ -0,0 +1,729 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "entries": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "manifest": {
+            "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
+          },
+          "source": {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "local",
+                  "workspace",
+                  "enterprise-catalog"
+                ]
+              },
+              "uri": {
+                "type": "string",
+                "minLength": 1
+              },
+              "checksum": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "uri"
+            ],
+            "additionalProperties": false
+          },
+          "status": {
+            "default": "active",
+            "type": "string",
+            "enum": [
+              "active",
+              "disabled",
+              "blocked",
+              "deprecated"
+            ]
+          },
+          "registered_at": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          },
+          "notes": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "manifest",
+          "source",
+          "status",
+          "registered_at",
+          "notes"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "generated_at",
+    "entries"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Registry State",
+  "description": "Machine-readable state contract for registered CodeSDD enterprise plugins."
+}