@evolith/core-domain 1.0.1 → 1.0.2

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

@@ -1,59 +0,0 @@
-{
-  "$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

@@ -1,73 +0,0 @@
-{
-  "$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

@@ -1,79 +0,0 @@
-{
-  "$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

@@ -1,51 +0,0 @@
-{
-  "$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

@@ -1,66 +0,0 @@
-{
-  "$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

@@ -1,112 +0,0 @@
-{
-  "$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

@@ -1,158 +0,0 @@
-{
-  "$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

@@ -1,43 +0,0 @@
-{
-  "$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."
-          }
-        }
-      }
-    }
-  }
-}