@evolith/core-domain 1.0.1 → 1.0.3

package/rulesets/schema/adr.schema.json

@@ -1,138 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://evolith.dev/schema/adr.schema.json",
-  "title": "Architecture Decision Record",
-  "description": "JSON Schema for validating Evolith ADR artifacts. Applies to all ADRs in reference/architecture/adrs/",
-  "type": "object",
-  "required": ["status", "date", "context", "decision", "consequences"],
-  "additionalProperties": false,
-  "properties": {
-    "status": {
-      "type": "string",
-      "enum": ["Proposed", "Accepted", "Deprecated", "Superseded"],
-      "description": "ADR lifecycle status. Proposed ADRs require Architecture Board review before merge."
-    },
-    "date": {
-      "type": "string",
-      "format": "date",
-      "description": "Date when the decision was made or proposed. ISO 8601 format (YYYY-MM-DD)."
-    },
-    "owner": {
-      "type": "string",
-      "description": "Accountable owner for this decision (name or role)."
-    },
-    "scope": {
-      "type": "string",
-      "description": "Scope category: Technology Stack, Architecture Pattern, Security, etc."
-    },
-    "satelliteOrigin": {
-      "type": "string",
-      "description": "If promoted from satellite, reference the original satellite ADR ID."
-    },
-    "context": {
-      "type": "string",
-      "minLength": 50,
-      "description": "Decision context, business drivers, architectural pressure, and constraints. Must be substantive."
-    },
-    "decisionDrivers": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["driver", "description"],
-        "additionalProperties": false,
-        "properties": {
-          "driver": { "type": "string" },
-          "description": { "type": "string" }
-        }
-      },
-      "minItems": 1,
-      "description": "List of decision drivers that forced this architectural choice."
-    },
-    "optionsConsidered": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["option", "summary", "pros", "cons"],
-        "additionalProperties": false,
-        "properties": {
-          "option": { "type": "string" },
-          "summary": { "type": "string" },
-          "pros": { "type": "string" },
-          "cons": { "type": "string" },
-          "rejected": { "type": "boolean", "default": false }
-        }
-      },
-      "minItems": 2,
-      "description": "At minimum two options must be documented. Include pros and cons for each."
-    },
-    "decision": {
-      "type": "string",
-      "minLength": 50,
-      "description": "Clear statement of the selected option and the reasoning behind it."
-    },
-    "consequences": {
-      "type": "object",
-      "required": ["positive", "negative"],
-      "additionalProperties": false,
-      "properties": {
-        "positive": {
-          "type": "array",
-          "items": { "type": "string" },
-          "minItems": 1,
-          "description": "Positive outcomes resulting from this decision."
-        },
-        "negative": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Trade-offs, costs, and negative consequences."
-        },
-        "followUpActions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["action", "owner", "dueDate"],
-            "additionalProperties": false,
-            "properties": {
-              "action": { "type": "string" },
-              "owner": { "type": "string" },
-              "dueDate": { "type": "string", "format": "date" }
-            }
-          },
-          "description": "Follow-up actions required after this decision. Tracked for compliance."
-        }
-      }
-    },
-    "complianceTraceability": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "parentPRD": {
-          "type": "string",
-          "description": "Reference to the parent PRD that authorized this decision."
-        },
-        "functionalStory": {
-          "type": "string",
-          "description": "Functional Story ID that triggered this ADR."
-        },
-        "technicalStory": {
-          "type": "string",
-          "description": "Technical Story ID tracing implementation back to this decision."
-        },
-        "affectedBoundedContext": {
-          "type": "string",
-          "description": "Bounded context(s) affected by this decision."
-        },
-        "relatedADRs": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Array of ADR IDs that are related to or superseded by this decision."
-        }
-      }
-    },
-    "references": {
-      "type": "array",
-      "items": { "type": "string", "format": "uri" },
-      "description": "External references: standards, RFCs, vendor docs."
-    }
-  }
-}

package/rulesets/schema/agile-backlog.schema.json

@@ -1,91 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://evolith.dev/schema/agile-backlog.schema.json",
-  "title": "Agile Backlog",
-  "description": "JSON Schema for validating Evolith Agile Backlog artifacts. Grouped, prioritized, and versioned user stories for an Epic or Initiative.",
-  "type": "object",
-  "required": ["epicName", "productOwner", "items"],
-  "additionalProperties": false,
-  "properties": {
-    "epicName": {
-      "type": "string",
-      "minLength": 5,
-      "description": "Name of the Epic or Initiative this backlog belongs to."
-    },
-    "epicId": {
-      "type": "string",
-      "description": "Formal Epic identifier."
-    },
-    "productOwner": {
-      "type": "string",
-      "description": "Name of the accountable Product Owner."
-    },
-    "status": {
-      "type": "string",
-      "enum": ["Draft", "Refined", "In Execution", "Completed"],
-      "default": "Draft"
-    },
-    "sprint": {
-      "type": "integer",
-      "description": "Current sprint number."
-    },
-    "items": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "type", "title", "priority", "status"],
-        "additionalProperties": false,
-        "properties": {
-          "id": {
-            "type": "string",
-            "pattern": "^(US|TS|EN|DEBT)-\\d{3}$"
-          },
-          "type": {
-            "type": "string",
-            "enum": ["Functional", "Technical", "Enabler", "Debt"]
-          },
-          "title": {
-            "type": "string"
-          },
-          "size": {
-            "type": "string",
-            "enum": ["S", "M", "L", "XL"]
-          },
-          "priority": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 10,
-            "description": "Priority: 1 = highest."
-          },
-          "status": {
-            "type": "string",
-            "enum": ["Draft", "Ready", "In Progress", "Done", "Blocked"]
-          },
-          "sprint": {
-            "type": "integer",
-            "description": "Sprint where this item is planned or completed."
-          },
-          "dependencies": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "IDs of stories this item depends on."
-          }
-        }
-      },
-      "minItems": 1,
-      "description": "Prioritized list of backlog items."
-    },
-    "velocity": {
-      "type": "number",
-      "description": "Current team velocity (story points per sprint)."
-    },
-    "totalPoints": {
-      "type": "number",
-      "description": "Total story points in this backlog."
-    },
-    "lastUpdated": {
-      "type": "string",
-      "format": "date"
-    }
-  }
-}

package/rulesets/schema/ballpark-estimation.schema.json

@@ -1,109 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://evolith.dev/schema/ballpark-estimation.schema.json",
-  "title": "Ballpark Estimation",
-  "description": "JSON Schema for validating Evolith Ballpark Estimation artifacts. Phase 1 artifact for technical feasibility and team sizing.",
-  "type": "object",
-  "required": ["technicalFeasibilityId", "team", "estimates", "technicalConstraints"],
-  "additionalProperties": false,
-  "properties": {
-    "technicalFeasibilityId": {
-      "type": "string",
-      "description": "Reference to the parent Technical Feasibility Canvas."
-    },
-    "team": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["role", "count"],
-        "additionalProperties": false,
-        "properties": {
-          "role": {
-            "type": "string",
-            "enum": ["Tech Lead", "Backend Engineer", "Frontend Engineer", "QA Engineer", "DevOps Engineer", "Architect", "Product Owner"]
-          },
-          "count": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 20
-          }
-        }
-      },
-      "minItems": 1
-    },
-    "durationSprints": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 52,
-      "description": "Estimated duration in sprints (2-week sprints default)."
-    },
-    "estimates": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["component", "size"],
-        "additionalProperties": false,
-        "properties": {
-          "component": { "type": "string" },
-          "size": {
-            "type": "string",
-            "enum": ["S", "M", "L", "XL", "XXL"],
-            "description": "T-Shirt size: S=1-3 days, M=4-7 days, L=1-2 weeks, XL=2-4 weeks, XXL=4+ weeks"
-          },
-          "assumptions": { "type": "string" },
-          "risks": {
-            "type": "array",
-            "items": { "type": "string" }
-          }
-        }
-      },
-      "minItems": 1,
-      "description": "Component-level T-Shirt sizing."
-    },
-    "technicalConstraints": {
-      "type": "object",
-      "required": ["cpuCoreLimit", "memoryGbLimit", "storageTbLimit"],
-      "additionalProperties": false,
-      "properties": {
-        "cpuCoreLimit": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Maximum allowed CPU cores."
-        },
-        "memoryGbLimit": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Maximum allowed RAM in gigabytes."
-        },
-        "storageTbLimit": {
-          "type": "number",
-          "minimum": 0,
-          "description": "Maximum allowed storage in terabytes."
-        },
-        "maxMonthlyComputeHours": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Maximum monthly compute hours."
-        }
-      }
-    },
-    "scopeExclusions": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Explicitly excluded components or functionality."
-    },
-    "approvalStatus": {
-      "type": "string",
-      "enum": ["Draft", "Approved", "Rejected"],
-      "default": "Draft"
-    },
-    "architectSignOff": {
-      "type": "string",
-      "description": "Architect or Tech Lead who approved this estimation."
-    },
-    "approvalDate": {
-      "type": "string",
-      "format": "date"
-    }
-  }
-}

package/rulesets/schema/build-vs-compose.schema.json

@@ -1,98 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://evolith.dev/schema/build-vs-compose.schema.json",
-  "title": "Build-versus-Compose Analysis",
-  "description": "JSON Schema for the Build-versus-Compose analysis that Discovery must produce before native development is approved (Product Vision Master §5.3). Mandatory Business Sign-Off (Phase 1) gate evidence.",
-  "type": "object",
-  "required": [
-    "initiative",
-    "alternatives",
-    "disposition",
-    "threeYearCost",
-    "licensing",
-    "security",
-    "providerReplaceability",
-    "proofOfConcept"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "initiative": {
-      "type": "string",
-      "description": "Identifier or name of the capability under evaluation."
-    },
-    "alternatives": {
-      "type": "array",
-      "minItems": 1,
-      "description": "Open-source, free-tier, and commercial capabilities evaluated, with their functional coverage.",
-      "items": {
-        "type": "object",
-        "required": ["name", "kind", "functionalCoverage"],
-        "additionalProperties": false,
-        "properties": {
-          "name": { "type": "string" },
-          "kind": { "type": "string", "enum": ["open-source", "free-tier", "commercial"] },
-          "functionalCoverage": {
-            "type": "string",
-            "description": "How much of the required functionality the alternative covers (e.g. 'full', 'partial — missing X')."
-          }
-        }
-      }
-    },
-    "disposition": {
-      "type": "string",
-      "enum": ["Adopt", "Embed", "Integrate", "Extend", "Build", "Reject"],
-      "description": "Governed disposition for the evaluated capability."
-    },
-    "threeYearCost": {
-      "type": "object",
-      "required": ["currency", "totalCost", "operatingBurden"],
-      "additionalProperties": false,
-      "properties": {
-        "currency": { "type": "string" },
-        "totalCost": { "type": "number", "minimum": 0, "description": "Three-year total cost of ownership." },
-        "operatingBurden": { "type": "string", "description": "Ongoing operating and maintenance burden." }
-      }
-    },
-    "licensing": {
-      "type": "object",
-      "required": ["license", "redistributionConstraints"],
-      "additionalProperties": false,
-      "properties": {
-        "license": { "type": "string" },
-        "redistributionConstraints": { "type": "string", "description": "Licensing and redistribution constraints that apply." }
-      }
-    },
-    "security": {
-      "type": "object",
-      "required": ["tenantIsolation", "dataOwnership"],
-      "additionalProperties": false,
-      "properties": {
-        "tenantIsolation": { "type": "string", "description": "How tenant isolation is preserved." },
-        "dataOwnership": { "type": "string", "description": "Where data ownership and residency land." }
-      }
-    },
-    "providerReplaceability": {
-      "type": "string",
-      "description": "How replaceable the provider is, and the cost of switching away."
-    },
-    "proofOfConcept": {
-      "type": "object",
-      "required": ["required"],
-      "additionalProperties": false,
-      "properties": {
-        "required": { "type": "boolean" },
-        "notes": { "type": "string" }
-      }
-    },
-    "nativeJustification": {
-      "type": "string",
-      "description": "Explicit justification for native implementation. Required when disposition is 'Build'."
-    }
-  },
-  "allOf": [
-    {
-      "if": { "properties": { "disposition": { "const": "Build" } } },
-      "then": { "required": ["nativeJustification"] }
-    }
-  ]
-}

package/rulesets/schema/cli-impact-analysis.schema.json

@@ -1,114 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://evolith.dev/schema/cli-impact-analysis.schema.json",
-  "title": "CLI Impact Analysis",
-  "description": "JSON Schema for validating Evolith CLI Impact Analysis artifacts. Documents CLI capabilities required for scaffolding, validation, and handoff in Phases 1 and 2.",
-  "type": "object",
-  "required": ["initiativeId", "phases"],
-  "additionalProperties": false,
-  "properties": {
-    "initiativeId": {
-      "type": "string",
-      "description": "Reference to the initiative or epic this analysis belongs to."
-    },
-    "phases": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "phase1": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "scaffoldingCapabilities": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "capability": { "type": "string" },
-                  "command": { "type": "string" },
-                  "description": { "type": "string" },
-                  "status": {
-                    "type": "string",
-                    "enum": ["Available", "Pending", "Not Applicable"]
-                  }
-                }
-              }
-            },
-            "validationCapabilities": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "validationType": { "type": "string" },
-                  "command": { "type": "string" },
-                  "description": { "type": "string" },
-                  "status": {
-                    "type": "string",
-                    "enum": ["Available", "Pending", "Not Applicable"]
-                  }
-                }
-              }
-            },
-            "traceabilityCapabilities": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "capability": { "type": "string" },
-                  "command": { "type": "string" },
-                  "description": { "type": "string" },
-                  "status": {
-                    "type": "string",
-                    "enum": ["Available", "Pending", "Not Applicable"]
-                  }
-                }
-              }
-            }
-          }
-        },
-        "phase2": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "scaffoldingCapabilities": {
-              "type": "array",
-              "items": { "type": "string" }
-            },
-            "validationCapabilities": {
-              "type": "array",
-              "items": { "type": "string" }
-            },
-            "traceabilityCapabilities": {
-              "type": "array",
-              "items": { "type": "string" }
-            }
-          }
-        }
-      }
-    },
-    "rulesCompliance": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "evolithRulesApplied": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "List of Evolith rules this CLI analysis complies with."
-        },
-        "deviationNotes": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Any deviations from standard rules and justification."
-        }
-      }
-    },
-    "status": {
-      "type": "string",
-      "enum": ["Draft", "Reviewed", "Approved"],
-      "default": "Draft"
-    }
-  }
-}

package/rulesets/schema/discovery-canvas.schema.json

@@ -1,92 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://evolith.dev/schema/discovery-canvas.schema.json",
-  "title": "Discovery Canvas",
-  "description": "JSON Schema for validating Evolith Discovery Canvas artifacts. Phase 1 required artifact for initiative registration.",
-  "type": "object",
-  "required": ["initiativeName", "sponsor", "businessContext", "problemStatement", "expectedQualityAttributes"],
-  "additionalProperties": false,
-  "properties": {
-    "initiativeName": {
-      "type": "string",
-      "minLength": 5,
-      "description": "Official name of the initiative."
-    },
-    "sponsor": {
-      "type": "string",
-      "minLength": 3,
-      "description": "Executive sponsor (primary stakeholder)."
-    },
-    "businessContext": {
-      "type": "string",
-      "minLength": 20,
-      "description": "Description of current business scenario. Must be written in business language."
-    },
-    "problemStatement": {
-      "type": "string",
-      "minLength": 20,
-      "description": "Description of the problem or opportunity to solve."
-    },
-    "expectedQualityAttributes": {
-      "type": "object",
-      "required": ["latencyMs", "concurrencyRequestsSec", "availabilitySla"],
-      "properties": {
-        "latencyMs": { "type": "integer", "minimum": 0 },
-        "concurrencyRequestsSec": { "type": "integer", "minimum": 0 },
-        "availabilitySla": { "type": "string" },
-        "securityCompliance": { "type": "string" }
-      },
-      "description": "Expected technical quality attributes (Latency, Scalability, Security, Availability)."
-    },
-    "targetAudience": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "actor": { "type": "string" },
-          "role": { "type": "string" },
-          "painPoint": { "type": "string" }
-        }
-      },
-      "description": "Primary and secondary actors impacted by this initiative."
-    },
-    "assumptions": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Technical and business assumptions that constrain the initiative."
-    },
-    "constraints": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Known constraints: timeline, regulatory, technical stack, cloud quotas."
-    },
-    "successCriteria": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "criterion": { "type": "string" },
-          "metric": { "type": "string" },
-          "baseline": { "type": "string" }
-        }
-      },
-      "description": "High-level success criteria with qualitative or quantitative metrics."
-    },
-    "approvalStatus": {
-      "type": "string",
-      "enum": ["Draft", "Submitted", "Approved", "Rejected"],
-      "default": "Draft"
-    },
-    "approvedBy": {
-      "type": "string",
-      "description": "Name of Ideation Hub approver."
-    },
-    "approvalDate": {
-      "type": "string",
-      "format": "date",
-      "description": "Date of approval. ISO 8601 format."
-    }
-  }
-}