@thebackstoryis/engineering-with-ai 0.2.9

package/config/pack.schema.json

@@ -0,0 +1,250 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/pack-v1.json",
+  "type": "object",
+  "required": ["schema", "id", "name", "version", "type"],
+  "properties": {
+    "schema": { "const": "ewai.pack/v1" },
+    "id": { "type": "string", "pattern": "^(?:ewai\\.[a-z0-9.-]+|org\\.[a-z0-9-]+\\.[a-z0-9.-]+)$" },
+    "name": { "type": "string", "minLength": 1 },
+    "description": { "type": "string", "minLength": 1 },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "type": { "enum": ["core", "technology", "stack", "persona", "organisation", "design-system"] },
+    "requires": { "type": "array", "items": { "type": "string" } },
+    "detection": {
+      "type": "object",
+      "properties": {
+        "files": { "type": "array", "items": { "type": "string" } },
+        "dependencies": { "type": "array", "items": { "type": "string" } },
+        "any_files": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 240, "not": { "pattern": "(^/|^!|[*?]|[\\\\{}()\\[\\]]|(^|/)\\.\\.(/|$))" } } },
+        "any_patterns": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 240, "not": { "pattern": "(^/|^!|[\\\\{}()\\[\\]]|(^|/)\\.\\.(/|$))" } } }
+      },
+      "additionalProperties": false
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "deployment": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["target"],
+        "properties": {
+          "target": { "type": "string" },
+          "reference": { "type": "string" }
+        }
+      }
+    },
+    "source_map": {
+      "type": "object",
+      "required": ["profiles"],
+      "properties": {
+        "profiles": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/sourceMapProfile" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "boilerplates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "source"],
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "source": { "type": "string" },
+          "version": { "type": "string" },
+          "digest": { "type": "string" },
+          "notes": { "type": "string" }
+        }
+      }
+    },
+    "blueprint": {
+      "type": "object",
+      "required": ["publisher", "compatibility", "modules"],
+      "properties": {
+        "publisher": {
+          "type": "object",
+          "required": ["id", "name"],
+          "properties": {
+            "id": { "$ref": "#/$defs/slug" },
+            "name": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "compatibility": {
+          "type": "object",
+          "required": ["ewai"],
+          "properties": {
+            "ewai": { "type": "string", "pattern": "^[0-9]+\\.x$" }
+          },
+          "additionalProperties": false
+        },
+        "modules": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/blueprintModule" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "design_system": { "$ref": "design-system.schema.json" }
+  },
+  "$defs": {
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "contentPath": {
+      "type": "string",
+      "minLength": 1,
+      "not": { "pattern": "(^/|(^|[\\\\/])\\.\\.([\\\\/]|$))" }
+    },
+    "sourceMapProfile": {
+      "type": "object",
+      "required": ["id", "patterns", "analyser", "classification"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+        "patterns": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 240,
+            "not": { "pattern": "(^/|^!|[\\\\{}()\\[\\]]|(^|/)\\.\\.(/|$))" }
+          }
+        },
+        "analyser": { "enum": ["inventory-only", "text-summary", "structured-keys", "tree-sitter", "power-platform-metadata", "salesforce-metadata"] },
+        "classification": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "priority": { "type": "integer", "minimum": -10000, "maximum": 10000 },
+        "repositories": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "max_bytes": { "type": "integer", "minimum": 1, "maximum": 900000 }
+      },
+      "additionalProperties": false
+    },
+    "standard": {
+      "type": "object",
+      "required": ["id", "title", "source"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "title": { "type": "string", "minLength": 1 },
+        "source": { "$ref": "#/$defs/contentPath" }
+      },
+      "additionalProperties": false
+    },
+    "persona": {
+      "type": "object",
+      "required": ["id", "source"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1 },
+        "source": { "$ref": "#/$defs/contentPath" }
+      },
+      "additionalProperties": false
+    },
+    "policyContribution": {
+      "type": "object",
+      "required": ["id", "title", "source"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "title": { "type": "string", "minLength": 1 },
+        "source": { "$ref": "#/$defs/contentPath" }
+      },
+      "additionalProperties": false
+    },
+    "blueprintBoilerplate": {
+      "type": "object",
+      "required": ["id", "name", "source", "version", "digest", "licence", "compatibility"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "licence": { "type": "string", "minLength": 1 },
+        "compatibility": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "starterTarget": {
+      "type": "object",
+      "required": ["role", "source_path"],
+      "properties": {
+        "role": { "$ref": "#/$defs/slug" },
+        "source_path": { "$ref": "#/$defs/contentPath" }
+      },
+      "additionalProperties": false
+    },
+    "blueprintStarterPack": {
+      "type": "object",
+      "required": ["id", "name", "source", "version", "digest", "licence", "compatibility", "targets"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "licence": { "type": "string", "minLength": 1 },
+        "compatibility": { "type": "string", "minLength": 1 },
+        "targets": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/starterTarget" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "blueprintModule": {
+      "type": "object",
+      "required": ["id", "name", "description", "required"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "required": { "type": "boolean" },
+        "standards": { "type": "array", "items": { "$ref": "#/$defs/standard" } },
+        "personas": { "type": "array", "items": { "$ref": "#/$defs/persona" } },
+        "policies": { "type": "array", "items": { "$ref": "#/$defs/policyContribution" } },
+        "design_systems": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^(?:ewai\\.[a-z0-9.-]+|org\\.[a-z0-9-]+\\.[a-z0-9.-]+)$" }
+        },
+        "starter_packs": { "type": "array", "items": { "$ref": "#/$defs/blueprintStarterPack" } },
+        "boilerplates": { "type": "array", "items": { "$ref": "#/$defs/blueprintBoilerplate" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "type": { "const": "organisation" } }, "required": ["type"] },
+      "then": {
+        "required": ["description", "blueprint"],
+        "properties": {
+          "id": { "pattern": "^org\\.[a-z0-9-]+\\.[a-z0-9.-]+$" },
+          "requires": { "items": { "pattern": "^org\\.[a-z0-9-]+\\.[a-z0-9.-]+$" } }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "type": { "const": "design-system" } }, "required": ["type"] },
+      "then": {
+        "required": ["description", "design_system"],
+        "properties": {
+          "requires": { "items": { "pattern": "^(?:ewai\\.[a-z0-9.-]+|org\\.[a-z0-9-]+\\.[a-z0-9.-]+)$" } }
+        }
+      }
+    }
+  ]
+}

package/config/persona-pack.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/persona-pack-v1.json",
+  "title": "EWAI Persona Pack",
+  "type": "object",
+  "required": ["schema", "id", "version", "content"],
+  "properties": {
+    "schema": {"const": "ewai.persona-pack/v1"},
+    "id": {"const": "ewai.personas.professional"},
+    "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"},
+    "content": {
+      "type": "object",
+      "required": ["personas"],
+      "properties": {
+        "personas": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$"}
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/config/persona.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/persona-v1.json",
+  "type": "object",
+  "required": ["schema", "id", "name", "version", "category", "pack", "tier"],
+  "properties": {
+    "schema": { "const": "ewai.persona/v1" },
+    "id": { "type": "string", "pattern": "^[a-z0-9.-]+$" },
+    "name": { "type": "string", "minLength": 1 },
+    "version": { "type": "string" },
+    "category": { "type": "string", "minLength": 1 },
+    "pack": { "type": "string", "minLength": 1 },
+    "tier": { "enum": ["core", "professional", "enterprise", "personal", "project"] },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "capabilities": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/config/policy-evaluation.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/policy-evaluation-v1.json",
+  "oneOf": [
+    { "$ref": "#/$defs/evaluation" },
+    { "$ref": "#/$defs/review" },
+    { "$ref": "#/$defs/exception" }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "outcome": { "enum": ["allow", "deny", "review-required", "allow-with-controls", "unassessed"] },
+    "evidence": { "type": "array", "minItems": 1, "maxItems": 40, "items": { "type": "string", "minLength": 1, "maxLength": 500 } },
+    "evaluation": {
+      "type": "object",
+      "required": ["schema", "revision", "intent", "policyDigest", "factsDigest", "governingOutcome", "consideredOutcomes", "matchedRules", "unmatchedPolicies", "controls", "requiredReviews", "limitations", "authority", "evaluationDigest"],
+      "properties": {
+        "schema": { "const": "ewai.policy-design-evaluation/v1" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "intent": { "type": "object" },
+        "policyDigest": { "$ref": "#/$defs/digest" },
+        "factsDigest": { "$ref": "#/$defs/digest" },
+        "evaluationDigest": { "$ref": "#/$defs/digest" },
+        "governingOutcome": { "$ref": "#/$defs/outcome" },
+        "consideredOutcomes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/outcome" } },
+        "matchedRules": { "type": "array", "items": { "type": "object" } },
+        "unmatchedPolicies": { "type": "array", "items": { "type": "object" } },
+        "controls": { "type": "array", "items": { "type": "object" } },
+        "requiredReviews": { "type": "array", "items": { "type": "object" } },
+        "limitations": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+        "authority": { "type": "object" }
+      },
+      "additionalProperties": false
+    },
+    "review": {
+      "type": "object",
+      "required": ["schema", "decisionDigest", "evaluationDigest", "intentReference", "ruleId", "reviewerRole", "reviewedBy", "decision", "rationale", "evidence", "controls", "reviewedAt", "authority"],
+      "properties": {
+        "schema": { "const": "ewai.policy-review/v1" },
+        "decisionDigest": { "$ref": "#/$defs/digest" },
+        "evaluationDigest": { "$ref": "#/$defs/digest" },
+        "intentReference": { "type": "string" },
+        "ruleId": { "type": "string" },
+        "reviewerRole": { "type": "string" },
+        "reviewedBy": { "type": "string", "minLength": 1 },
+        "decision": { "enum": ["allow", "deny", "allow-with-controls"] },
+        "rationale": { "type": "string", "minLength": 1 },
+        "evidence": { "$ref": "#/$defs/evidence" },
+        "controls": { "type": "array", "items": { "type": "string" } },
+        "reviewedAt": { "type": "string", "format": "date-time" },
+        "authority": { "type": "object" }
+      },
+      "additionalProperties": false
+    },
+    "exception": {
+      "type": "object",
+      "required": ["schema", "decisionDigest", "evaluationDigest", "intentReference", "ruleId", "reviewerRole", "approvedBy", "owner", "scope", "rationale", "compensatingControls", "evidence", "expiresAt", "approvedAt", "authority"],
+      "properties": {
+        "schema": { "const": "ewai.policy-exception/v1" },
+        "decisionDigest": { "$ref": "#/$defs/digest" },
+        "evaluationDigest": { "$ref": "#/$defs/digest" },
+        "intentReference": { "type": "string" },
+        "ruleId": { "type": "string" },
+        "reviewerRole": { "type": "string" },
+        "approvedBy": { "type": "string", "minLength": 1 },
+        "owner": { "type": "string", "minLength": 1 },
+        "scope": { "type": "object", "minProperties": 1 },
+        "rationale": { "type": "string", "minLength": 1 },
+        "compensatingControls": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "evidence": { "$ref": "#/$defs/evidence" },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "approvedAt": { "type": "string", "format": "date-time" },
+        "authority": { "type": "object" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/config/policy-facts.schema.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/policy-facts-v1.json",
+  "oneOf": [
+    { "$ref": "#/$defs/proposal" },
+    { "$ref": "#/$defs/confirmed" }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "value": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "dimension": { "enum": ["resource", "operation", "data_entity", "data_classification", "actor", "environment", "destination", "model", "ai_use", "retention"] },
+    "intent": {
+      "type": "object",
+      "required": ["reference", "revision", "digest"],
+      "properties": {
+        "reference": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*/[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "digest": { "$ref": "#/$defs/digest" }
+      },
+      "additionalProperties": false
+    },
+    "persona": {
+      "type": "object",
+      "required": ["id", "name", "tier"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 160 },
+        "name": { "type": "string", "minLength": 1, "maxLength": 160 },
+        "tier": { "enum": ["core", "personal", "project", "premium"] }
+      },
+      "additionalProperties": false
+    },
+    "source": {
+      "type": "object",
+      "required": ["kind", "reference"],
+      "properties": {
+        "kind": { "enum": ["observed", "model-proposal", "persona-hypothesis"] },
+        "reference": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "persona": { "$ref": "#/$defs/persona" }
+      },
+      "additionalProperties": false
+    },
+    "fact": {
+      "type": "object",
+      "required": ["id", "dimension", "values", "rationale", "source"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "dimension": { "$ref": "#/$defs/dimension" },
+        "values": { "type": "array", "minItems": 1, "maxItems": 40, "uniqueItems": true, "items": { "$ref": "#/$defs/value" } },
+        "rationale": { "type": "string", "minLength": 1, "maxLength": 1200 },
+        "source": { "$ref": "#/$defs/source" }
+      },
+      "additionalProperties": false
+    },
+    "confirmedFact": {
+      "type": "object",
+      "required": ["id", "dimension", "values", "rationale", "provenance"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "dimension": { "$ref": "#/$defs/dimension" },
+        "values": { "type": "array", "minItems": 1, "maxItems": 40, "uniqueItems": true, "items": { "$ref": "#/$defs/value" } },
+        "rationale": { "type": "string", "minLength": 1, "maxLength": 1200 },
+        "provenance": { "$ref": "#/$defs/source" }
+      },
+      "additionalProperties": false
+    },
+    "proposal": {
+      "type": "object",
+      "required": ["schema", "revision", "preparedAt", "intent", "policyDigest", "proposalDigest", "facts", "authority"],
+      "properties": {
+        "schema": { "const": "ewai.policy-fact-proposal/v1" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "preparedAt": { "type": "string", "format": "date-time" },
+        "intent": { "$ref": "#/$defs/intent" },
+        "policyDigest": { "$ref": "#/$defs/digest" },
+        "proposalDigest": { "$ref": "#/$defs/digest" },
+        "facts": { "type": "array", "minItems": 1, "maxItems": 200, "items": { "$ref": "#/$defs/fact" } },
+        "authority": {
+          "type": "object",
+          "required": ["authoritative", "requiresNamedHumanConfirmation"],
+          "properties": {
+            "authoritative": { "const": false },
+            "requiresNamedHumanConfirmation": { "const": true }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "confirmed": {
+      "type": "object",
+      "required": ["schema", "revision", "intent", "policyDigest", "proposalDigest", "facts", "confirmation", "authority", "factsDigest"],
+      "properties": {
+        "schema": { "const": "ewai.confirmed-policy-facts/v1" },
+        "revision": { "type": "integer", "minimum": 1 },
+        "intent": { "$ref": "#/$defs/intent" },
+        "policyDigest": { "$ref": "#/$defs/digest" },
+        "proposalDigest": { "$ref": "#/$defs/digest" },
+        "factsDigest": { "$ref": "#/$defs/digest" },
+        "facts": { "type": "array", "minItems": 1, "maxItems": 200, "items": { "$ref": "#/$defs/confirmedFact" } },
+        "confirmation": {
+          "type": "object",
+          "required": ["confirmedBy", "confirmedAt", "decisions"],
+          "properties": {
+            "confirmedBy": { "type": "string", "minLength": 1, "maxLength": 160 },
+            "confirmedAt": { "type": "string", "format": "date-time" },
+            "decisions": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 200,
+              "items": {
+                "type": "object",
+                "required": ["factId", "disposition"],
+                "properties": {
+                  "factId": { "$ref": "#/$defs/slug" },
+                  "disposition": { "enum": ["confirmed", "rejected"] },
+                  "values": { "type": "array", "minItems": 1, "maxItems": 40, "items": { "$ref": "#/$defs/value" } }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "authority": {
+          "type": "object",
+          "required": ["authoritative", "source", "modelAuthority", "personaAuthority"],
+          "properties": {
+            "authoritative": { "const": true },
+            "source": { "const": "named-human-confirmation" },
+            "modelAuthority": { "const": false },
+            "personaAuthority": { "const": false }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/config/portfolio.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/portfolio-v1.json",
+  "title": "Engineering With AI portfolio",
+  "type": "object",
+  "required": ["schema", "id", "name", "owner", "members", "dependencies"],
+  "properties": {
+    "schema": { "const": "ewai.portfolio/v1" },
+    "id": { "$ref": "#/$defs/slug" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "owner": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "members": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 100,
+      "items": { "$ref": "#/$defs/member" }
+    },
+    "dependencies": {
+      "type": "array",
+      "maxItems": 400,
+      "items": { "$ref": "#/$defs/dependency" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "maxLength": 100
+    },
+    "member": {
+      "type": "object",
+      "required": ["id", "kind", "name", "owner"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "kind": { "enum": ["portfolio", "programme", "project"] },
+        "name": { "type": "string", "minLength": 1, "maxLength": 160 },
+        "owner": { "type": "string", "minLength": 1, "maxLength": 160 },
+        "parent": { "$ref": "#/$defs/slug" },
+        "repository": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "project_path": { "type": "string", "minLength": 1, "maxLength": 500 }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "kind": { "const": "project" } }, "required": ["kind"] },
+          "then": { "required": ["repository", "project_path"] },
+          "else": {
+            "not": { "anyOf": [{ "required": ["repository"] }, { "required": ["project_path"] }] }
+          }
+        }
+      ],
+      "additionalProperties": false
+    },
+    "dependency": {
+      "type": "object",
+      "required": ["id", "from", "to", "rationale", "owner"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "from": { "$ref": "#/$defs/slug" },
+        "to": { "$ref": "#/$defs/slug" },
+        "rationale": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "owner": { "type": "string", "minLength": 1, "maxLength": 160 }
+      },
+      "additionalProperties": false
+    }
+  }
+}
+