@thebackstoryis/engineering-with-ai 0.2.9

package/config/evidence-depth.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/evidence-depth.schema.json",
+  "title": "EWAI evidence depth contracts",
+  "oneOf": [
+    { "$ref": "#/$defs/preparation" },
+    { "$ref": "#/$defs/run" },
+    { "$ref": "#/$defs/comparison" }
+  ],
+  "$defs": {
+    "depth": { "enum": ["bounded", "standard", "deep"] },
+    "dimensionId": { "enum": ["architecture", "data", "security", "product", "delivery", "governance", "operations"] },
+    "preparation": {
+      "type": "object",
+      "required": ["schema", "preparationDigest", "dimensions", "gaps", "activePersonas"],
+      "properties": {
+        "schema": { "const": "ewai.evidence-depth-preparation/v1" },
+        "preparationDigest": { "type": "string" },
+        "dimensions": { "type": "array", "minItems": 7, "maxItems": 7 },
+        "gaps": { "type": "array", "maxItems": 200 },
+        "activePersonas": { "type": "array", "maxItems": 8 }
+      },
+      "additionalProperties": true
+    },
+    "run": {
+      "type": "object",
+      "required": ["schema", "runId", "contentDigest", "preparationDigest", "dimensions", "gaps", "grouping"],
+      "properties": {
+        "schema": { "const": "ewai.evidence-depth-run/v1" },
+        "runId": { "type": "string" },
+        "contentDigest": { "type": "string" },
+        "preparationDigest": { "type": "string" },
+        "dimensions": { "type": "array", "minItems": 7, "maxItems": 7 },
+        "gaps": { "type": "array", "maxItems": 200 },
+        "grouping": { "type": "object" }
+      },
+      "additionalProperties": true
+    },
+    "comparison": {
+      "type": "object",
+      "required": ["schema", "leftRunId", "rightRunId", "changes", "unexplained", "reproducible"],
+      "properties": {
+        "schema": { "const": "ewai.evidence-depth-comparison/v1" },
+        "leftRunId": { "type": "string" },
+        "rightRunId": { "type": "string" },
+        "changes": { "type": "object" },
+        "unexplained": { "type": "array" },
+        "reproducible": { "type": "boolean" }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/config/intent.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/intent-v1.json",
+  "type": "object",
+  "required": ["schema", "slug", "title", "status", "personas"],
+  "properties": {
+    "schema": { "const": "ewai.intent/v1" },
+    "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "title": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["draft", "ready", "superseded", "retired"] },
+    "intent_map": {
+      "type": ["string", "null"],
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "personas": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["ref", "role", "depth"],
+        "properties": {
+          "ref": { "type": "string", "minLength": 1 },
+          "role": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "depth": { "type": "integer", "minimum": 1, "maximum": 5 },
+          "reason": { "type": "string" }
+        }
+      }
+    },
+    "relationships": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "target"],
+        "properties": {
+          "type": {
+            "enum": [
+              "depends-on",
+              "enables",
+              "complements",
+              "conflicts-with",
+              "supersedes",
+              "relates-to"
+            ]
+          },
+          "target": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*/[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "rationale": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "delivery_shape": {
+      "type": ["object", "null"],
+      "required": ["recommendation", "reason", "suggested_children", "blocking_questions", "reviewed_decision"],
+      "properties": {
+        "recommendation": {
+          "enum": ["single", "split", "decision-required"]
+        },
+        "reason": { "type": "string", "minLength": 1 },
+        "suggested_children": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "domain": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+              "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+              "title": { "type": "string" },
+              "outcome": { "type": "string" },
+              "depends_on": {
+                "type": "array",
+                "items": { "type": "string" }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "blocking_questions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "reviewed_decision": {
+          "type": ["string", "null"],
+          "enum": ["keep-as-one", "split", "refine-split", "defer", null]
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/config/knowledge-proposals-proposal.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineering-with-ai.local/schemas/knowledge-proposal.json",
+  "title": "EWAI knowledge proposal bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "sourceRef", "sourceDigest", "proposals"],
+  "properties": {
+    "schema": {"const": "ewai.knowledge-proposal-bundle/v1"},
+    "sourceRef": {"type": "string", "pattern": "^(meeting-evidence|retrospective):[a-z0-9][a-z0-9.-]{0,119}$"},
+    "sourceDigest": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "proposals": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 200,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "title", "destination", "evidenceAnchors", "rationale", "uncertainty", "relationships", "proposedMarkdown"],
+        "properties": {
+          "id": {"type": "string", "pattern": "^KNP-[0-9]{3,}$"},
+          "kind": {"enum": ["project-persona", "system", "process", "data-concept", "journey", "requirement", "feature-candidate", "risk", "policy", "constraint", "standard", "decision", "pattern", "anti-pattern", "runbook", "sop"]},
+          "title": {"type": "string", "minLength": 1, "maxLength": 200},
+          "destination": {"type": "string", "minLength": 1, "maxLength": 300},
+          "evidenceAnchors": {"type": "array", "minItems": 1, "maxItems": 30, "items": {"type": "string", "minLength": 1, "maxLength": 180}},
+          "rationale": {"type": "string", "minLength": 1, "maxLength": 1600},
+          "uncertainty": {"type": "string", "maxLength": 1200},
+          "relationships": {"type": "array", "maxItems": 30, "items": {"type": "string", "minLength": 1, "maxLength": 300}},
+          "proposedMarkdown": {"type": "string", "minLength": 1, "maxLength": 100000}
+        }
+      }
+    }
+  }
+}

package/config/lifecycle-event.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/lifecycle-event/v1",
+  "title": "EWAI lifecycle event envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "id", "name", "occurredAt", "project", "scope", "facts", "source", "evidence", "personas", "stream", "idempotencyKey"],
+  "properties": {
+    "schema": { "const": "ewai.lifecycle-event/v1" },
+    "id": { "type": "string", "format": "uuid" },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120,
+      "examples": ["ewai.knowledge-proposals.materialised", "ewai.policy.evaluation.recorded"]
+    },
+    "occurredAt": { "type": "string", "format": "date-time" },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 120 },
+        "name": { "type": "string", "minLength": 1, "maxLength": 160 }
+      }
+    },
+    "scope": { "type": "object" },
+    "facts": {
+      "type": "object",
+      "description": "Event-specific bounded safe facts from the runtime lifecycle catalogue. Policy events contain identifiers, outcomes and digests only; policy source bodies are never included."
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key"],
+      "properties": {
+        "key": { "type": "string", "minLength": 1, "maxLength": 400 },
+        "revision": { "type": "string", "maxLength": 200 }
+      }
+    },
+    "evidence": { "type": "array", "maxItems": 24, "items": { "type": "string", "minLength": 1, "maxLength": 400 } },
+    "personas": {
+      "type": "array",
+      "maxItems": 12,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "tier", "reason"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 160 },
+          "name": { "type": "string", "minLength": 1, "maxLength": 160 },
+          "tier": { "enum": ["core", "premium", "personal", "project"] },
+          "reason": { "type": "string", "minLength": 1, "maxLength": 300 }
+        }
+      }
+    },
+    "stream": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "sequence"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "sequence": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "idempotencyKey": { "type": "string", "minLength": 16, "maxLength": 160 }
+  }
+}

package/config/lifecycle-handler.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/lifecycle-handler/v1",
+  "title": "EWAI lifecycle handler manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "id", "name", "publisher", "version", "compatibility", "entrypoint", "digest", "events", "limits"],
+  "properties": {
+    "schema": { "const": "ewai.lifecycle-handler/v1" },
+    "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{2,127}$" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "publisher": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,79}$" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 120 }
+      }
+    },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "compatibility": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["protocols", "eventSchemas"],
+      "properties": {
+        "protocols": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } },
+        "eventSchemas": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }
+      }
+    },
+    "entrypoint": { "type": "string", "minLength": 1, "maxLength": 240 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "events": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 120 } },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["timeoutMs", "maxOutputBytes"],
+      "properties": {
+        "timeoutMs": { "type": "integer", "minimum": 100, "maximum": 30000 },
+        "maxOutputBytes": { "type": "integer", "minimum": 256, "maximum": 65536 }
+      }
+    },
+    "description": { "type": "string", "maxLength": 500 }
+  }
+}

package/config/lifecycle-hook-ack.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/lifecycle-hook-ack/v1",
+  "title": "EWAI lifecycle hook acknowledgement",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "status"],
+  "properties": {
+    "schema": { "const": "ewai.lifecycle-hook-ack/v1" },
+    "status": { "enum": ["accepted", "rejected"] },
+    "code": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,79}$" },
+    "message": { "type": "string", "maxLength": 500 },
+    "metadata": {
+      "type": "object",
+      "maxProperties": 12,
+      "additionalProperties": { "type": ["string", "number", "boolean", "null"] }
+    }
+  }
+}

package/config/meeting-evidence-candidate.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwithai.dev/schemas/meeting-evidence-candidate.schema.json",
+  "title": "EWAI meeting evidence candidate bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "sourceId",
+    "sourceDigest",
+    "candidates"
+  ],
+  "properties": {
+    "schema": {
+      "const": "ewai.meeting-candidate-bundle/v1"
+    },
+    "sourceId": {
+      "type": "string",
+      "pattern": "^meeting\\\\.[a-z0-9][a-z0-9-]{0,59}\\\\.[a-f0-9]{12}$"
+    },
+    "sourceDigest": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "candidates": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 500,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "type",
+          "observedStatement",
+          "interpretation",
+          "lineAnchors",
+          "confidence"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^MEC-[0-9]{3,}$"
+          },
+          "type": {
+            "enum": [
+              "task",
+              "decision",
+              "process",
+              "risk",
+              "system",
+              "policy",
+              "requirement",
+              "assumption",
+              "open-question"
+            ]
+          },
+          "observedStatement": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 600
+          },
+          "interpretation": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1000
+          },
+          "lineAnchors": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 20,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "start",
+                "end"
+              ],
+              "properties": {
+                "start": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "end": {
+                  "type": "integer",
+                  "minimum": 1
+                }
+              }
+            }
+          },
+          "confidence": {
+            "enum": [
+              "low",
+              "medium",
+              "high"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/config/organisation-policy.schema.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://engineeringwith.ai/schemas/organisation-policy-v1.json",
+  "type": "object",
+  "required": ["schema", "id", "title", "version", "publisher", "provenance", "review_roles", "unmatched_outcome", "rules"],
+  "properties": {
+    "schema": { "const": "ewai.organisation-policy/v1" },
+    "id": { "$ref": "#/$defs/slug" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "publisher": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 160 }
+      },
+      "additionalProperties": false
+    },
+    "provenance": {
+      "type": "object",
+      "required": ["kind", "summary", "sources"],
+      "properties": {
+        "kind": { "enum": ["owner-declared", "regulatory", "contractual", "adapted"] },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 800 },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 40,
+          "items": { "$ref": "#/$defs/sourceReference" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "review_roles": {
+      "type": "array",
+      "maxItems": 40,
+      "items": { "$ref": "#/$defs/reviewRole" }
+    },
+    "unmatched_outcome": { "$ref": "#/$defs/outcome" },
+    "rules": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 500,
+      "items": { "$ref": "#/$defs/rule" }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "valueId": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "outcome": { "enum": ["allow", "deny", "review-required", "allow-with-controls", "unassessed"] },
+    "sourceReference": {
+      "type": "object",
+      "required": ["id", "label"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "label": { "type": "string", "minLength": 1, "maxLength": 240 }
+      },
+      "additionalProperties": false
+    },
+    "reviewRole": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "name": { "type": "string", "minLength": 1, "maxLength": 160 }
+      },
+      "additionalProperties": false
+    },
+    "conditionValues": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 40,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/valueId" }
+    },
+    "conditions": {
+      "type": "object",
+      "minProperties": 1,
+      "properties": {
+        "resource": { "$ref": "#/$defs/conditionValues" },
+        "operation": { "$ref": "#/$defs/conditionValues" },
+        "data_entity": { "$ref": "#/$defs/conditionValues" },
+        "data_classification": { "$ref": "#/$defs/conditionValues" },
+        "actor": { "$ref": "#/$defs/conditionValues" },
+        "environment": { "$ref": "#/$defs/conditionValues" },
+        "destination": { "$ref": "#/$defs/conditionValues" },
+        "model": { "$ref": "#/$defs/conditionValues" },
+        "ai_use": { "$ref": "#/$defs/conditionValues" },
+        "retention": { "$ref": "#/$defs/conditionValues" }
+      },
+      "additionalProperties": false
+    },
+    "control": {
+      "type": "object",
+      "required": ["id", "title", "description", "evidence"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 160 },
+        "description": { "type": "string", "minLength": 1, "maxLength": 800 },
+        "evidence": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 5,
+          "uniqueItems": true,
+          "items": { "enum": ["claim", "task", "automated-test", "named-human", "specialist-review"] }
+        }
+      },
+      "additionalProperties": false
+    },
+    "exception": {
+      "type": "object",
+      "required": ["permitted"],
+      "properties": {
+        "permitted": { "type": "boolean" },
+        "review_role": { "$ref": "#/$defs/slug" }
+      },
+      "additionalProperties": false
+    },
+    "rule": {
+      "type": "object",
+      "required": ["id", "title", "description", "when", "outcome", "controls", "exceptions"],
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 160 },
+        "description": { "type": "string", "minLength": 1, "maxLength": 1200 },
+        "when": { "$ref": "#/$defs/conditions" },
+        "outcome": { "$ref": "#/$defs/outcome" },
+        "review_role": { "$ref": "#/$defs/slug" },
+        "controls": { "type": "array", "maxItems": 40, "items": { "$ref": "#/$defs/control" } },
+        "exceptions": { "$ref": "#/$defs/exception" }
+      },
+      "additionalProperties": false
+    }
+  }
+}