@devtrack-solution/codesdd 1.2.2 → 1.2.3

package/schemas/sdd/plugin-skill-binding-resolution.schema.json

@@ -0,0 +1,305 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "created_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))$"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "resolved",
+        "fallback"
+      ]
+    },
+    "request": {
+      "type": "object",
+      "properties": {
+        "schema_version": {
+          "default": 1,
+          "type": "number",
+          "const": 1
+        },
+        "feature_ref": {
+          "type": "string",
+          "pattern": "^FEAT-\\d{4}$"
+        },
+        "recommended_skills": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)*$"
+          }
+        },
+        "requested_operation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "requested_capability": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+        },
+        "explicit_plugin_id": {
+          "type": "string",
+          "pattern": "^codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+        },
+        "technology": {
+          "type": "object",
+          "properties": {
+            "language": {
+              "type": "string",
+              "minLength": 1
+            },
+            "framework": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        },
+        "trust_tiers": {
+          "default": [
+            "enterprise-approved",
+            "local-dev",
+            "experimental"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "local-dev",
+              "experimental",
+              "enterprise-approved",
+              "blocked"
+            ]
+          }
+        },
+        "statuses": {
+          "default": [
+            "active"
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "active",
+              "disabled",
+              "blocked",
+              "deprecated"
+            ]
+          }
+        },
+        "require_apply": {
+          "default": false,
+          "type": "boolean"
+        },
+        "require_dry_run": {
+          "default": true,
+          "type": "boolean"
+        },
+        "created_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))$"
+        }
+      },
+      "required": [
+        "schema_version",
+        "feature_ref",
+        "recommended_skills",
+        "trust_tiers",
+        "statuses",
+        "require_apply",
+        "require_dry_run"
+      ],
+      "additionalProperties": false
+    },
+    "selected": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "type": "string",
+          "enum": [
+            "explicit-plugin",
+            "skill-binding",
+            "capability-match"
+          ]
+        },
+        "skill_id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)*$"
+        },
+        "plugin_ref": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string",
+              "pattern": "^codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+            },
+            "version": {
+              "type": "string",
+              "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$"
+            }
+          },
+          "required": [
+            "id",
+            "version"
+          ],
+          "additionalProperties": false
+        },
+        "capability": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1
+        },
+        "binding_priority": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "rank": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "reasons": {
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "source",
+        "plugin_ref",
+        "capability",
+        "rank",
+        "reasons"
+      ],
+      "additionalProperties": false
+    },
+    "candidates": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "string",
+            "enum": [
+              "explicit-plugin",
+              "skill-binding",
+              "capability-match"
+            ]
+          },
+          "skill_id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)*$"
+          },
+          "plugin_ref": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+              },
+              "version": {
+                "type": "string",
+                "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$"
+              }
+            },
+            "required": [
+              "id",
+              "version"
+            ],
+            "additionalProperties": false
+          },
+          "capability": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+          },
+          "operation": {
+            "type": "string",
+            "minLength": 1
+          },
+          "binding_priority": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 100
+          },
+          "rank": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "reasons": {
+            "default": [],
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "source",
+          "plugin_ref",
+          "capability",
+          "rank",
+          "reasons"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "reasons": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "fallback": {
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "enum": [
+            "manual-selection",
+            "llm-guidance",
+            "no-compatible-plugin"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "strategy",
+        "message"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "created_at",
+    "status",
+    "request",
+    "candidates",
+    "reasons"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Skill Binding Resolution",
+  "description": "Machine-readable resolution result for a FEAT recommended skill, plugin binding, and requested capability."
+}

package/schemas/sdd/plugin-skill-binding.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "default": 1,
+      "type": "number",
+      "const": 1
+    },
+    "skill_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)*$"
+    },
+    "plugin_id": {
+      "type": "string",
+      "pattern": "^codesdd-plugin-[a-z0-9][a-z0-9-]*$"
+    },
+    "plugin_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$"
+    },
+    "capabilities": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+      }
+    },
+    "operations": {
+      "default": {},
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "minLength": 1
+      },
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+      }
+    },
+    "priority": {
+      "default": 50,
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "status": {
+      "default": "active",
+      "type": "string",
+      "enum": [
+        "active",
+        "disabled",
+        "deprecated"
+      ]
+    },
+    "rationale": {
+      "type": "string",
+      "minLength": 1
+    },
+    "technology": {
+      "type": "object",
+      "properties": {
+        "language": {
+          "type": "string",
+          "minLength": 1
+        },
+        "framework": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "schema_version",
+    "skill_id",
+    "plugin_id",
+    "capabilities",
+    "operations",
+    "priority",
+    "status"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Skill Binding",
+  "description": "Machine-readable mapping from an SDD skill to compatible CodeSDD enterprise plugin capabilities."
+}

package/schemas/sdd/plugin-validation-manifest.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "number",
+      "const": 1
+    },
+    "operation_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "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))$"
+    },
+    "feature_ref": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{4}$"
+    },
+    "plugin_ref": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "id",
+        "version"
+      ],
+      "additionalProperties": false
+    },
+    "capability": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "passed",
+        "failed",
+        "partial"
+      ]
+    },
+    "validations": {
+      "default": [],
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "command": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "passed",
+              "failed",
+              "skipped"
+            ]
+          },
+          "evidence_ref": {
+            "type": "string"
+          },
+          "coverage": {
+            "type": "object",
+            "properties": {
+              "statements": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "branches": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "functions": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "lines": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "required": [
+          "command",
+          "status"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "schema_version",
+    "operation_id",
+    "generated_at",
+    "feature_ref",
+    "plugin_ref",
+    "capability",
+    "status",
+    "validations"
+  ],
+  "additionalProperties": false,
+  "title": "CodeSDD Plugin Validation Manifest",
+  "description": "Machine-readable validation evidence contract for a CodeSDD enterprise plugin operation."
+}