skillpack-one 0.1.0-alpha.10

package/schemas/eval-dataset.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/eval-dataset.schema.json",
+  "title": "Skill evaluation dataset",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "split", "locale", "examples"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "$ref": "#/$defs/id" },
+    "split": { "enum": ["train", "dev", "test", "adversarial", "tasks"] },
+    "locale": { "type": "string", "pattern": "^[a-z]{2,3}(?:-[A-Z]{2})?$" },
+    "protected": { "type": "boolean" },
+    "examples": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "prompt", "expectedCategory", "expectedAtoms", "mustNotRoute"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "prompt": { "type": "string", "minLength": 1 },
+          "expectedCategory": {
+            "oneOf": [
+              { "$ref": "#/$defs/id" },
+              { "type": "null" }
+            ]
+          },
+          "expectedAtoms": {
+            "type": "array",
+            "minItems": 0,
+            "uniqueItems": true,
+            "items": { "$ref": "#/$defs/id" }
+          },
+          "acceptableAtomGroups": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/id" }
+            }
+          },
+          "mustNotRoute": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "$ref": "#/$defs/id" }
+          },
+          "task": { "type": "string", "minLength": 1 },
+          "rubric": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "tags": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "$ref": "#/$defs/id" }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+  }
+}

package/schemas/eval-run.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/eval-run.schema.json",
+  "title": "Skill evaluation run",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "dataset", "datasetDigest", "harness", "startedAt", "completedAt", "metrics", "passed"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "dataset": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "datasetDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "registryDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "harness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "model": { "type": "string", "minLength": 1 }
+      }
+    },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" },
+    "metrics": {
+      "type": "object",
+      "minProperties": 1,
+      "propertyNames": { "pattern": "^[a-z][A-Za-z0-9]*$" },
+      "additionalProperties": { "type": "number", "minimum": 0 }
+    },
+    "passed": { "type": "boolean" },
+    "failures": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["exampleId", "reason"],
+        "properties": {
+          "exampleId": { "type": "string", "minLength": 1 },
+          "reason": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/evolution-attempt.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/evolution-attempt.schema.json",
+  "title": "Bounded Skill evolution attempt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "proposal", "createdAt", "baseRevision", "candidateRevision", "editBudget", "edits", "acceptanceRule", "selection", "protectedRegressions", "decision"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "$ref": "#/$defs/id" },
+    "proposal": { "$ref": "#/$defs/id" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "baseRevision": { "$ref": "#/$defs/revision" },
+    "candidateRevision": { "$ref": "#/$defs/revision" },
+    "editBudget": { "type": "integer", "minimum": 1, "maximum": 64 },
+    "edits": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/edit" } },
+    "acceptanceRule": { "const": "strict-improvement" },
+    "selection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["dataset", "before", "after"],
+      "properties": {
+        "dataset": { "$ref": "#/$defs/id" },
+        "before": { "type": "number", "minimum": 0 },
+        "after": { "type": "number", "minimum": 0 }
+      }
+    },
+    "protectedRegressions": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "reasons"],
+      "properties": {
+        "status": { "enum": ["accepted", "rejected"] },
+        "reasons": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "revision": { "type": "string", "pattern": "^[0-9a-f]{40,64}$" },
+    "edit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operation", "path", "rationale"],
+      "properties": {
+        "operation": { "enum": ["add", "delete", "replace"] },
+        "path": { "type": "string", "pattern": "^/" },
+        "before": { "type": "string" },
+        "after": { "type": "string" },
+        "rationale": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/schemas/evolution-pattern.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/evolution-pattern.schema.json",
+  "title": "Persistent evolution knowledge pattern",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "status", "summary", "problem", "rootCause", "response", "confidence", "scope", "evidence", "supersedes", "createdAt", "updatedAt"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "$ref": "#/$defs/id" },
+    "status": { "enum": ["active", "superseded", "archived"] },
+    "summary": { "type": "string", "minLength": 1 },
+    "problem": { "type": "string", "minLength": 1 },
+    "rootCause": { "type": "string", "minLength": 1 },
+    "response": { "type": "string", "minLength": 1 },
+    "confidence": { "enum": ["hypothesis", "observed", "replicated"] },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["skills", "packs", "harnesses"],
+      "properties": {
+        "skills": { "$ref": "#/$defs/idsAllowEmpty" },
+        "packs": { "$ref": "#/$defs/idsAllowEmpty" },
+        "harnesses": { "$ref": "#/$defs/idsAllowEmpty" }
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "ref", "note"],
+        "properties": {
+          "kind": { "enum": ["task-run", "proposal", "decision", "paper", "user-feedback"] },
+          "ref": { "type": "string", "minLength": 1 },
+          "locator": { "type": "string", "minLength": 1 },
+          "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+          "note": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "supersedes": { "$ref": "#/$defs/idsAllowEmpty" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "idsAllowEmpty": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/id" }
+    }
+  }
+}

package/schemas/evolution-proposal.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/evolution-proposal.schema.json",
+  "title": "Governed Skill evolution proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "createdAt", "targetSkill", "baseRevision", "candidateRevision", "rollbackRevision", "observation", "allowedFiles", "changedFiles", "generationDatasets", "evaluationDatasets", "permissionBefore", "permissionAfter", "approvals"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "$ref": "#/$defs/id" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "targetSkill": { "$ref": "#/$defs/id" },
+    "baseRevision": { "$ref": "#/$defs/revision" },
+    "candidateRevision": { "$ref": "#/$defs/revision" },
+    "rollbackRevision": { "$ref": "#/$defs/revision" },
+    "observation": { "type": "string", "minLength": 1 },
+    "authorship": { "$ref": "#/$defs/authorship" },
+    "knowledgePatterns": { "$ref": "#/$defs/ids" },
+    "allowedFiles": { "$ref": "#/$defs/files" },
+    "changedFiles": { "$ref": "#/$defs/files" },
+    "generationDatasets": { "$ref": "#/$defs/ids" },
+    "evaluationDatasets": { "$ref": "#/$defs/ids" },
+    "permissionBefore": { "$ref": "#/$defs/permissions" },
+    "permissionAfter": { "$ref": "#/$defs/permissions" },
+    "approvals": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "approvedBy", "approvedAt", "reason"],
+        "properties": {
+          "type": { "enum": ["permission-expansion", "promotion", "destructive-maintenance"] },
+          "approvedBy": { "type": "string", "minLength": 1 },
+          "approvedAt": { "type": "string", "format": "date-time" },
+          "reason": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "revision": { "type": "string", "pattern": "^[0-9a-f]{40,64}$" },
+    "files": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "ids": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["network", "filesystem", "shell", "secrets", "externalCommunication"],
+      "properties": {
+        "network": { "enum": ["none", "read", "write"] },
+        "filesystem": { "enum": ["none", "read", "workspace-write", "unrestricted-write"] },
+        "shell": { "enum": ["none", "allowlisted", "unrestricted"] },
+        "secrets": { "enum": ["none", "named-read"] },
+        "externalCommunication": { "enum": ["none", "draft", "send"] }
+      }
+    },
+    "authorship": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "author"],
+      "properties": {
+        "mode": { "enum": ["human", "model-assisted", "model-generated"] },
+        "author": { "type": "string", "minLength": 1 },
+        "generator": { "type": "string", "minLength": 1 }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "mode": { "enum": ["model-assisted", "model-generated"] } }, "required": ["mode"] },
+          "then": {
+            "properties": { "generator": { "type": "string", "minLength": 1 } },
+            "required": ["generator"]
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/lifecycle-security-review.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/lifecycle-security-review.schema.json",
+  "title": "Lifecycle security review for reusable agent capabilities",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "subject", "reviewedAt", "reviewer", "stages"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "$ref": "#/$defs/id" },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "version"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "type": { "enum": ["skill", "mcp-server", "plugin", "harness"] },
+        "version": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "minLength": 1 }
+      }
+    },
+    "reviewedAt": { "type": "string", "format": "date-time" },
+    "reviewer": { "type": "string", "minLength": 1 },
+    "stages": {
+      "type": "array",
+      "minItems": 6,
+      "maxItems": 6,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["stage", "status", "threats", "evidence", "residualRisk"],
+        "properties": {
+          "stage": { "enum": ["authoring", "storage", "retrieval", "selection", "execution", "evolution"] },
+          "status": { "enum": ["pass", "fail", "not-applicable"] },
+          "threats": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+          "evidence": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+          "residualRisk": { "type": "string", "minLength": 1 },
+          "rationale": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+  }
+}

package/schemas/skill-contract.schema.json

@@ -0,0 +1,208 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/skill-contract.schema.json",
+  "title": "Skill capability contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "kind",
+    "version",
+    "name",
+    "summary",
+    "outcomes",
+    "artifacts",
+    "inputs",
+    "outputs",
+    "preconditions",
+    "failures",
+    "sideEffects",
+    "permissions",
+    "taxonomy",
+    "routing",
+    "provenance",
+    "evaluations"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "id": { "$ref": "#/$defs/id" },
+    "kind": { "enum": ["atom", "category", "meta"] },
+    "version": { "$ref": "#/$defs/semver" },
+    "name": { "$ref": "#/$defs/localizedString" },
+    "summary": { "$ref": "#/$defs/localizedString" },
+    "outcomes": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "artifacts": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "inputs": { "$ref": "#/$defs/ports" },
+    "outputs": { "$ref": "#/$defs/ports" },
+    "preconditions": { "$ref": "#/$defs/stringArray" },
+    "failures": { "$ref": "#/$defs/stringArray" },
+    "sideEffects": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "none",
+          "filesystem-read",
+          "filesystem-write",
+          "network-read",
+          "network-write",
+          "shell-execution",
+          "external-communication",
+          "financial-action",
+          "destructive-action",
+          "privileged-action"
+        ]
+      }
+    },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["network", "filesystem", "shell", "secrets", "externalCommunication"],
+      "properties": {
+        "network": { "enum": ["none", "read", "write"] },
+        "filesystem": { "enum": ["none", "read", "workspace-write", "unrestricted-write"] },
+        "shell": { "enum": ["none", "allowlisted", "unrestricted"] },
+        "secrets": { "enum": ["none", "named-read"] },
+        "externalCommunication": { "enum": ["none", "draft", "send"] }
+      }
+    },
+    "taxonomy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["primaryCategory", "lifecycle", "modalities", "dependencies", "risk"],
+      "properties": {
+        "primaryCategory": { "$ref": "#/$defs/id" },
+        "secondaryCategories": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/id" }
+        },
+        "lifecycle": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "enum": ["discover", "plan", "create", "transform", "analyze", "verify", "publish", "operate", "govern"] }
+        },
+        "modalities": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "enum": ["code", "text", "document", "table", "slide", "image", "audio", "video", "browser-state", "structured-data", "physical-proxy", "system-state"] }
+        },
+        "dependencies": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "enum": ["tool-agnostic", "product-specific", "mcp-backed", "cli-backed", "api-backed", "harness-backed"] }
+        },
+        "risk": { "enum": ["read-only", "reversible-write", "external-communication", "high-stakes", "destructive", "privileged"] }
+      }
+    },
+    "routing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["positiveTriggers", "negativeTriggers", "confusableWith"],
+      "properties": {
+        "positiveTriggers": { "$ref": "#/$defs/localizedStringArrays" },
+        "negativeTriggers": { "$ref": "#/$defs/localizedStringArrays" },
+        "confusableWith": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/id" }
+        }
+      }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["origin", "license"],
+      "properties": {
+        "origin": { "type": "string", "minLength": 1 },
+        "license": { "type": "string", "minLength": 1 },
+        "derivedFrom": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "evaluations": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/id" }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "kind": { "const": "atom" } }, "required": ["kind"] },
+      "then": {
+        "properties": {
+          "outcomes": { "type": "array", "maxItems": 1 }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 96 },
+    "semver": { "type": "string", "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$" },
+    "stringArray": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "localizedString": {
+      "type": "object",
+      "minProperties": 1,
+      "required": ["en"],
+      "properties": { "en": { "type": "string", "minLength": 1 } },
+      "propertyNames": { "pattern": "^[a-z]{2,3}(?:-[A-Z][a-z]{3})?(?:-[A-Z]{2}|-[0-9]{3})?$" },
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "localizedStringArrays": {
+      "type": "object",
+      "minProperties": 1,
+      "required": ["en"],
+      "properties": {
+        "en": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      },
+      "propertyNames": { "pattern": "^[a-z]{2,3}(?:-[A-Z][a-z]{3})?(?:-[A-Z]{2}|-[0-9]{3})?$" },
+      "additionalProperties": {
+        "type": "array",
+        "minItems": 1,
+        "uniqueItems": true,
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "ports": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "type", "required"],
+        "properties": {
+          "name": { "$ref": "#/$defs/id" },
+          "type": { "type": "string", "minLength": 1 },
+          "required": { "type": "boolean" },
+          "description": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/skill-effect.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/skill-effect.schema.json",
+  "title": "Paired Skill effect result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "dataset", "harness", "baseline", "candidate", "certifiable", "metrics", "passed", "failures"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "dataset": { "$ref": "#/$defs/id" },
+    "harness": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "baseline": { "const": "without-skill" },
+    "candidate": { "const": "with-skill" },
+    "certifiable": { "type": "boolean" },
+    "metrics": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskCompletionLift", "rubricPassLift", "blockedRateChange"],
+      "properties": {
+        "taskCompletionLift": { "type": "number", "minimum": -1, "maximum": 1 },
+        "rubricPassLift": { "type": "number", "minimum": -1, "maximum": 1 },
+        "blockedRateChange": { "type": "number", "minimum": -1, "maximum": 1 },
+        "averageCostUsdChange": { "type": "number" },
+        "averageLatencyMsChange": { "type": "number" }
+      }
+    },
+    "passed": { "type": "boolean" },
+    "failures": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+  }
+}

package/schemas/skill-relation-graph.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/WnagoiYy/skillpack-one/schemas/skill-relation-graph.schema.json",
+  "title": "Reviewed Skill relation graph",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "nodes", "edges"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "kind": { "enum": ["atom", "category", "meta", "pack"] }
+        }
+      }
+    },
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from", "to", "type", "evidence"],
+        "properties": {
+          "from": { "$ref": "#/$defs/id" },
+          "to": { "$ref": "#/$defs/id" },
+          "type": { "enum": ["confusable-with", "compose-with", "depends-on", "packaged-in"] },
+          "evidence": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+  }
+}