@evolith/core-domain 1.0.0 → 1.0.1

package/rulesets/schema/ruleset-sdlc.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/rulesets/schema/ruleset-sdlc.schema.json",
+  "title": "SDLC Ruleset Schema",
+  "type": "object",
+  "required": ["$id", "gates"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "$id": { "type": "string", "format": "uri" },
+    "title": { "type": "string" },
+    "description": { "type": "string" },
+    "version": { "type": "string" },
+    "effectiveDate": { "type": "string", "format": "date" },
+    "gates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["phase", "name", "description", "mandatoryEvidence"],
+        "properties": {
+          "phase": { "type": "integer" },
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "playbookRef": { "type": "string", "description": "Relative path to the operational playbook that procedurally implements this gate." },
+          "accountableRole": { "type": "string" },
+          "waiverAuthority": { "type": "string" },
+          "waiverRequiredFields": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "mandatoryEvidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["artifact", "validation"],
+              "properties": {
+                "artifact": { "type": "string" },
+                "schemaRef": { "type": "string" },
+                "templateRef": { "type": "string", "description": "Relative path to the canonical Markdown template that authors must use for this artifact." },
+                "status": { "type": "string" },
+                "validation": { "type": "string" }
+              }
+            }
+          },
+          "blockingCriteria": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["criterion", "action"],
+              "properties": {
+                "criterion": { "type": "string" },
+                "action": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/rulesets/schema/ruleset-standard.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/rulesets/schema/ruleset-standard.schema.json",
+  "title": "Standard Ruleset Schema",
+  "type": "object",
+  "properties": {
+    "$schema": { "type": "string" },
+    "$id": { "type": "string", "format": "uri" },
+    "title": { "type": "string" },
+    "description": { "type": "string" },
+    "version": { "type": "string" },
+    "effectiveDate": { "type": "string", "format": "date" },
+    "adrId": { "type": "string" },
+    "adrTitle": { "type": "string" },
+    "status": { "type": "string" },
+    "date": { "type": "string" },
+    "exitCriteria": {
+      "type": "object"
+    },
+    "references": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "rules": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/rule"
+      }
+    },
+    "principles": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/rule"
+      }
+    }
+  },
+  "anyOf": [
+    { "required": ["rules"] },
+    { "required": ["principles"] }
+  ],
+  "definitions": {
+    "rule": {
+      "type": "object",
+      "properties": {
+        "id": { "type": "string" },
+        "severity": { "type": "string" },
+        "category": { "type": "string" },
+        "title": { "type": "string" },
+        "principle": { "type": "string" },
+        "description": { "type": "string" },
+        "statement": { "type": "string" },
+        "rationale": { "type": "string" },
+        "validationQuery": { "type": "string" },
+        "blocking": { "type": "boolean" },
+        "enforcement": { "type": "string" },
+        "layer": { "type": "string" },
+        "examples": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "structure": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "anyOf": [
+        { "required": ["id", "title", "description"] },
+        { "required": ["id", "principle", "statement"] },
+        { "required": ["title", "description"] }
+      ]
+    }
+  }
+}

package/rulesets/schema/security-scan-report.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/security-scan-report.schema.json",
+  "title": "Security Scan Report",
+  "description": "JSON Schema for the Security Scan Report artifact required by the RC Stamped gate (Phase 4). Aggregates SAST, DAST, SCA, and dependency-vulnerability findings against the production CVE policy.",
+  "type": "object",
+  "required": ["releaseCandidate", "scannedAt", "findings", "policy", "result"],
+  "additionalProperties": false,
+  "properties": {
+    "releaseCandidate": { "type": "string" },
+    "scannedAt": { "type": "string", "format": "date-time" },
+    "scanners": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "type"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string" },
+          "type": { "type": "string", "enum": ["SAST", "DAST", "SCA", "Secrets", "Container", "IaC"] },
+          "version": { "type": "string" }
+        }
+      }
+    },
+    "findings": {
+      "type": "object",
+      "required": ["critical", "high", "medium", "low"],
+      "additionalProperties": false,
+      "properties": {
+        "critical": { "type": "integer", "minimum": 0 },
+        "high": { "type": "integer", "minimum": 0 },
+        "medium": { "type": "integer", "minimum": 0 },
+        "low": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "openFindings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "severity", "component", "remediation"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "description": "CVE id, scanner finding id, or internal ticket id." },
+          "severity": { "type": "string", "enum": ["Critical", "High", "Medium", "Low"] },
+          "component": { "type": "string" },
+          "remediation": { "type": "string", "enum": ["Fix", "Mitigate", "Waiver"] },
+          "owner": { "type": "string" },
+          "dueDate": { "type": "string", "format": "date" }
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "required": ["maxCritical", "maxHigh"],
+      "additionalProperties": false,
+      "properties": {
+        "maxCritical": { "type": "integer", "minimum": 0 },
+        "maxHigh": { "type": "integer", "minimum": 0 },
+        "maxMedium": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "result": { "type": "string", "enum": ["PASS", "FAIL", "WAIVED"] },
+    "waivers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["findingId", "justification", "owner", "expirationDate", "approvalAuthority"],
+        "additionalProperties": false,
+        "properties": {
+          "findingId": { "type": "string" },
+          "justification": { "type": "string" },
+          "owner": { "type": "string" },
+          "expirationDate": { "type": "string", "format": "date" },
+          "approvalAuthority": { "type": "string", "description": "Architecture Board or Executive Risk Acceptance for High/Critical CVEs." }
+        }
+      }
+    }
+  }
+}

package/rulesets/schema/source-registry.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/source-registry.schema.json",
+  "title": "External Knowledge Source Registry Entry",
+  "description": "Versioned SRC-* registry schema recording external source metadata and KI-* linkage.",
+  "type": "object",
+  "required": [
+    "source_registry_id",
+    "source_license",
+    "edition_or_url",
+    "retention_mode",
+    "content_fingerprint",
+    "review_cadence",
+    "ki_links"
+  ],
+  "properties": {
+    "source_registry_id": {
+      "type": "string",
+      "pattern": "^SRC-[A-Z0-9-]+$"
+    },
+    "source_license": {
+      "type": "string",
+      "minLength": 1
+    },
+    "edition_or_url": {
+      "type": "string",
+      "minLength": 1
+    },
+    "retention_mode": {
+      "enum": ["citation", "full-reference", "permanent"]
+    },
+    "content_fingerprint": {
+      "type": "string",
+      "minLength": 1
+    },
+    "review_cadence": {
+      "type": "string",
+      "pattern": "^[0-9]+-(months|years|weeks)$"
+    },
+    "ki_links": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^KI-[A-Z0-9-]+$"
+      },
+      "uniqueItems": true
+    }
+  },
+  "additionalProperties": false
+}

package/rulesets/schema/technical-feasibility.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/technical-feasibility.schema.json",
+  "title": "Technical Feasibility",
+  "description": "JSON Schema for validating Evolith Technical Feasibility and NFR artifacts. Phase 1 required artifact for technical and architectural alignment.",
+  "type": "object",
+  "required": ["initiativeId", "technicalSummary", "qualityAttributes", "technicalConstraints"],
+  "additionalProperties": false,
+  "properties": {
+    "initiativeId": {
+      "type": "string",
+      "description": "Reference to the originating Discovery Canvas ID."
+    },
+    "technicalSummary": {
+      "type": "string",
+      "minLength": 50,
+      "description": "Brief technical description of the implementation case based on Discovery Canvas."
+    },
+    "qualityAttributes": {
+      "type": "object",
+      "required": ["latencyMs", "concurrencyRequestsSec", "availabilitySla"],
+      "additionalProperties": false,
+      "properties": {
+        "latencyMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Target latency in milliseconds (e.g. at p95)."
+        },
+        "concurrencyRequestsSec": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Estimated target concurrency in requests per second."
+        },
+        "availabilitySla": {
+          "type": "string",
+          "description": "Target availability SLA percentage (e.g., 99.9%)."
+        },
+        "securityCompliance": {
+          "type": "string",
+          "description": "Security protocols and compliance constraints."
+        }
+      }
+    },
+    "technicalConstraints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "description": "Platform, stack, or cloud constraints."
+    },
+    "approvalStatus": {
+      "type": "string",
+      "enum": ["Draft", "Under Review", "Approved", "Rejected"],
+      "default": "Draft"
+    },
+    "approver": {
+      "type": "string",
+      "description": "Name of the approving architect."
+    },
+    "approvalDate": {
+      "type": "string",
+      "format": "date"
+    }
+  }
+}

package/rulesets/schema/technical-story.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/technical-story.schema.json",
+  "title": "Technical Story",
+  "description": "JSON Schema for validating Evolith Technical Story artifacts. Engineering implementation work items traceable to Functional Stories.",
+  "type": "object",
+  "required": ["id", "title", "status", "functionalStoryId", "implementation", "testing", "definitionOfDone"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^TS-\\d{3}$",
+      "description": "Technical Story ID following pattern TS-XXX."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 10,
+      "description": "Technical story title in engineering language."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["Draft", "Ready", "In Progress", "Done", "Blocked"],
+      "default": "Draft"
+    },
+    "functionalStoryId": {
+      "type": "string",
+      "pattern": "^FS-\\d{3}$",
+      "description": "Parent Functional Story ID this Technical Story implements."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["Backend", "Frontend", "Infrastructure", "Security", "Migration"],
+      "description": "Engineering domain classification."
+    },
+    "boundedContext": {
+      "type": "string",
+      "description": "Bounded context for this implementation."
+    },
+    "implementation": {
+      "type": "object",
+      "required": ["approach", "filesAffected", "dependencies"],
+      "additionalProperties": false,
+      "properties": {
+        "approach": { "type": "string" },
+        "filesAffected": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of files to be created or modified."
+        },
+        "dependencies": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "External packages, services, or ADRs this story depends on."
+        }
+      }
+    },
+    "testing": {
+      "type": "object",
+      "required": ["unit", "integration", "e2e"],
+      "additionalProperties": false,
+      "properties": {
+        "unit": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "coverageTarget": { "type": "number", "minimum": 0, "maximum": 100 },
+            "testCases": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "integration": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "approach": { "type": "string" },
+            "testCases": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "e2e": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "scenarios": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+    "definitionOfDone": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1,
+      "description": "Checklist of items that must be completed before this story is Done."
+    },
+    "relatedADRs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "ADRs that constrain or enable this implementation."
+    },
+    "observabilityRequirements": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "type": { "type": "string", "enum": ["Metric", "Log", "Trace"] },
+          "name": { "type": "string" },
+          "dashboard": { "type": "string" }
+        }
+      },
+      "description": "OTel metrics, logs, or traces required for this story's production path."
+    }
+  }
+}

package/rulesets/schema/test-summary-report.schema.json

@@ -0,0 +1,158 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/test-summary-report.schema.json",
+  "title": "Test Summary Report",
+  "description": "JSON Schema for validating Evolith Test Summary Report artifacts. Required for RC Stamped gate (Phase 4).",
+  "type": "object",
+  "required": ["releaseCandidate", "date", "qualityGates", "testPyramid", "securityScan", "storyValidation"],
+  "additionalProperties": false,
+  "properties": {
+    "releaseCandidate": {
+      "type": "string",
+      "pattern": "^RC-\\d+\\.\\d+\\.\\d+$",
+      "description": "Release Candidate identifier following pattern RC-X.Y.Z."
+    },
+    "date": {
+      "type": "string",
+      "format": "date",
+      "description": "Date when test summary was generated."
+    },
+    "qualityGates": {
+      "type": "object",
+      "required": ["coverage", "complexity", "cves", "techDebt"],
+      "additionalProperties": false,
+      "properties": {
+        "coverage": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "value": { "type": "number", "minimum": 0, "maximum": 100 },
+            "threshold": { "type": "number" },
+            "passed": { "type": "boolean" }
+          }
+        },
+        "complexity": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "maxCyclomatic": { "type": "number" },
+            "threshold": { "type": "number" },
+            "passed": { "type": "boolean" }
+          }
+        },
+        "cves": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "critical": { "type": "integer", "minimum": 0 },
+            "high": { "type": "integer", "minimum": 0 },
+            "medium": { "type": "integer" },
+            "passed": { "type": "boolean" }
+          }
+        },
+        "techDebt": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ratio": { "type": "number" },
+            "threshold": { "type": "number" },
+            "passed": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "testPyramid": {
+      "type": "object",
+      "required": ["unit", "integration", "e2e", "total"],
+      "additionalProperties": false,
+      "properties": {
+        "unit": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "count": { "type": "integer" },
+            "percentage": { "type": "number" },
+            "target": { "type": "number" }
+          }
+        },
+        "integration": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "count": { "type": "integer" },
+            "percentage": { "type": "number" },
+            "target": { "type": "number" }
+          }
+        },
+        "e2e": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "count": { "type": "integer" },
+            "percentage": { "type": "number" },
+            "target": { "type": "number" }
+          }
+        },
+        "total": {
+          "type": "integer",
+          "description": "Total test count across all layers."
+        },
+        "passed": {
+          "type": "boolean",
+          "description": "Whether pyramid distribution matches target within tolerance."
+        }
+      }
+    },
+    "securityScan": {
+      "type": "object",
+      "required": ["tool", "criticalFindings", "highFindings", "passed"],
+      "additionalProperties": false,
+      "properties": {
+        "tool": { "type": "string" },
+        "criticalFindings": { "type": "integer" },
+        "highFindings": { "type": "integer" },
+        "mediumFindings": { "type": "integer" },
+        "passed": { "type": "boolean" }
+      }
+    },
+    "storyValidation": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["storyId", "criteria", "result"],
+        "additionalProperties": false,
+        "properties": {
+          "storyId": { "type": "string" },
+          "criteria": { "type": "string" },
+          "result": { "type": "string", "enum": ["Passed", "Failed", "Waived"] }
+        }
+      },
+      "description": "Acceptance criteria validation per Functional Story."
+    },
+    "waivers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["criterion", "justification", "owner", "expirationDate"],
+        "additionalProperties": false,
+        "properties": {
+          "criterion": { "type": "string" },
+          "justification": { "type": "string" },
+          "owner": { "type": "string" },
+          "expirationDate": { "type": "string", "format": "date" }
+        }
+      },
+      "description": "Explicit waivers for failed gates. Must include justification and expiration."
+    },
+    "signOff": {
+      "type": "object",
+      "required": ["qaLead", "techLead", "date"],
+      "additionalProperties": false,
+      "properties": {
+        "qaLead": { "type": "string" },
+        "techLead": { "type": "string" },
+        "date": { "type": "string", "format": "date" }
+      }
+    }
+  }
+}

package/rulesets/schema/topology-composition.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/topology-composition.schema.json",
+  "title": "Topology Composition",
+  "description": "JSON Schema for an Evolith cross-topology composition manifest. A composition declares two or more canonical topologies whose manifests explicitly allow the combination via spec.compatibility.composableWith. See topology-dimensions.md §3.",
+  "type": "object",
+  "required": ["name", "topologies"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "topologies": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "type": "object",
+        "required": ["profile", "config"],
+        "additionalProperties": false,
+        "properties": {
+          "profile": {
+            "type": "string",
+            "enum": [
+              "modular-monolith",
+              "distributed-modules",
+              "microservices",
+              "serverless",
+              "edge-computing",
+              "event-driven",
+              "data-mesh",
+              "agentic-ai"
+            ],
+            "description": "Canonical topology archetype."
+          },
+          "config": {
+            "type": "string",
+            "description": "Relative path to the per-topology configuration fixture validated against the topology's configurationContract."
+          }
+        }
+      }
+    }
+  }
+}