@evolith/core-domain 1.0.0 → 1.0.1

package/rulesets/schema/adr.schema.json

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

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

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

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

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

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