@evolith/core-domain 1.0.0 → 1.0.1

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

@@ -0,0 +1,421 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://evolith.dev/schema/topology-manifest.schema.json",
+  "title": "Evolith Topology Manifest",
+  "description": "JSON Schema for validating topology.manifest.json files in the Multi-Topology Reference Corpus. The manifest is technical-only and exposes topology context for CLI, MCP, and Service CORE API resolution.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "spec", "businessBoundary"],
+  "additionalProperties": false,
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "evolith.dev/topology/v1",
+      "description": "Topology manifest API version."
+    },
+    "kind": {
+      "type": "string",
+      "const": "TopologyManifest",
+      "description": "Manifest kind."
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["id", "name", "dimension", "status", "version", "governance"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "description": "Stable topology identifier in kebab-case, for example modular-monolith, serverless, data-mesh, or agentic-ai."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 3,
+          "description": "Human-readable topology name."
+        },
+        "dimension": {
+          "type": "string",
+          "enum": ["progressive-axis", "execution", "integration", "data", "ai"],
+          "description": "Dimensional family for this topology profile."
+        },
+        "status": {
+          "type": "string",
+          "enum": ["draft", "proposed", "accepted", "deprecated"],
+          "description": "Governance status of the topology profile."
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Semantic version of the topology manifest contract instance."
+        },
+        "governance": {
+          "type": "object",
+          "required": ["owner", "criticality"],
+          "additionalProperties": false,
+          "properties": {
+            "owner": {
+              "type": "string",
+              "minLength": 3,
+              "description": "Organizational unit accountable for this topology (e.g. Architecture Board, Platform Engineering)."
+            },
+            "criticality": {
+              "type": "string",
+              "enum": ["P0", "P1", "P2"],
+              "description": "Business criticality tier: P0 = critical, P1 = high, P2 = medium."
+            },
+            "supersedes": {
+              "type": "array",
+              "items": { "type": "string", "pattern": "^ADR-\\d{4}$" },
+              "uniqueItems": true,
+              "description": "ADR IDs that this topology supersedes (optional)."
+            },
+            "replaces": {
+              "type": "array",
+              "items": { "type": "string", "pattern": "^ADR-\\d{4}$" },
+              "uniqueItems": true,
+              "description": "ADR IDs replaced by this topology (optional)."
+            }
+          }
+        }
+      }
+    },
+    "spec": {
+      "type": "object",
+      "required": [
+        "summary",
+        "topologyType",
+        "compatibility",
+        "artifacts",
+        "operationalInterfaces"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 20,
+          "description": "Technical purpose and applicability of the topology."
+        },
+        "topologyType": {
+          "type": "string",
+          "enum": [
+            "modular-monolith",
+            "distributed-modules",
+            "microservices",
+            "serverless",
+            "edge-computing",
+            "event-driven",
+            "data-mesh",
+            "agentic-ai"
+          ],
+          "description": "Canonical topology archetype governed by this manifest."
+        },
+        "compatibility": {
+          "type": "object",
+          "required": ["progressiveAxis", "composableWith"],
+          "additionalProperties": false,
+          "properties": {
+            "progressiveAxis": {
+              "type": "object",
+              "required": ["phase", "profile"],
+              "additionalProperties": false,
+              "properties": {
+                "phase": {
+                  "type": "string",
+                  "enum": ["F1", "F2", "F3", "cross"],
+                  "description": "Progressive architecture compatibility phase. Use cross for topologies that combine with multiple F1/F2/F3 phases."
+                },
+                "profile": {
+                  "type": "string",
+                  "enum": ["modular-monolith", "distributed-modules", "microservices", "cross"],
+                  "description": "Compatibility mapping for the progressive-axis model."
+                }
+              }
+            },
+            "composableWith": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+              },
+              "uniqueItems": true,
+              "description": "Topology identifiers that can be combined with this manifest."
+            }
+          }
+        },
+        "artifacts": {
+          "type": "object",
+          "required": ["adrs", "rulesets", "opaPolicies", "aiRulesets", "umsContracts"],
+          "additionalProperties": false,
+          "properties": {
+            "adrs": {
+              "type": "array",
+              "items": { "$ref": "#/definitions/repositoryPath" },
+              "uniqueItems": true,
+              "description": "Accepted or draft ADRs governing this topology."
+            },
+            "rulesets": {
+              "type": "array",
+              "items": { "$ref": "#/definitions/repositoryPath" },
+              "uniqueItems": true,
+              "description": "Native machine-readable rulesets for this topology."
+            },
+            "opaPolicies": {
+              "type": "array",
+              "items": { "$ref": "#/definitions/repositoryPath" },
+              "uniqueItems": true,
+              "description": "OPA/Rego policies for this topology."
+            },
+            "aiRulesets": {
+              "type": "array",
+              "items": { "$ref": "#/definitions/repositoryPath" },
+              "uniqueItems": true,
+              "description": "AI-consumable rulesets and context artifacts for this topology."
+            },
+            "umsContracts": {
+              "type": "array",
+              "items": { "$ref": "#/definitions/repositoryPath" },
+              "uniqueItems": true,
+              "description": "Technical UMS contract references related to this topology."
+            }
+          }
+        },
+        "corpus": {
+          "type": "object",
+          "description": "Explicit inventory of the topology maturity corpus required by R-27. Required when the topology is accepted.",
+          "required": ["guidance", "configurationContract", "fixtures", "nativeEvaluator", "tests", "evidence"],
+          "additionalProperties": false,
+          "properties": {
+            "guidance": {
+              "type": "object",
+              "required": ["profile", "maturityGuide"],
+              "additionalProperties": false,
+              "properties": {
+                "profile": { "$ref": "#/definitions/repositoryPath" },
+                "maturityGuide": { "$ref": "#/definitions/repositoryPath" }
+              }
+            },
+            "configurationContract": { "$ref": "#/definitions/repositoryPath" },
+            "fixtures": {
+              "type": "object",
+              "required": ["valid", "invalid"],
+              "additionalProperties": false,
+              "properties": {
+                "valid": { "$ref": "#/definitions/repositoryPath" },
+                "invalid": { "$ref": "#/definitions/repositoryPath" }
+              }
+            },
+            "nativeEvaluator": { "$ref": "#/definitions/repositoryPath" },
+            "tests": {
+              "type": "object",
+              "required": ["positive", "negative"],
+              "additionalProperties": false,
+              "properties": {
+                "positive": { "$ref": "#/definitions/repositoryPath" },
+                "negative": { "$ref": "#/definitions/repositoryPath" }
+              }
+            },
+            "evidence": { "$ref": "#/definitions/repositoryPath" }
+          }
+        },
+        "operationalBudgets": {
+          "type": "object",
+          "description": "Architectural envelopes for execution-tier and AI-tier topologies (GT-165 / GT-219 / ADR-0095 / ADR-0096). These are technical ceilings used by operators to verify the topology's viability, not financial plans — Tracker still owns roi/cost/budget decisions per businessBoundary.",
+          "additionalProperties": false,
+          "properties": {
+            "latencyBudgetMs": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "p99 end-to-end execution budget in milliseconds. The topology is considered non-viable above this ceiling."
+            },
+            "coldStartCeilingMs": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum acceptable cold-start latency in milliseconds before the topology choice must be revisited."
+            },
+            "costCeilingPerExecutionCents": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Architectural ceiling for cost per execution in whole cents. Above this envelope the topology's economics fail; financial planning still lives in Tracker."
+            },
+            "tokenBudgetPerExecution": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum tokens consumed per AI execution. Above this ceiling the agentic topology is non-viable."
+            },
+            "credentialRotationIntervalHours": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum hours between credential rotations for agentic AI topologies."
+            },
+            "sandboxTimeoutMs": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum milliseconds an agentic sandbox execution may run before forced termination."
+            }
+          }
+        },
+        "operationalInterfaces": {
+          "type": "object",
+          "required": ["cli", "mcp", "coreApi"],
+          "additionalProperties": false,
+          "properties": {
+            "cli": {
+              "type": "object",
+              "required": ["validators"],
+              "additionalProperties": false,
+              "properties": {
+                "validators": {
+                  "type": "array",
+                  "items": { "$ref": "#/definitions/kebabIdentifier" },
+                  "uniqueItems": true,
+                  "description": "CLI validators that can resolve this topology."
+                }
+              }
+            },
+            "mcp": {
+              "type": "object",
+              "required": ["resources", "tools", "prompts"],
+              "additionalProperties": false,
+              "properties": {
+                "resources": {
+                  "type": "array",
+                  "items": { "$ref": "#/definitions/mcpUri" },
+                  "uniqueItems": true
+                },
+                "tools": {
+                  "type": "array",
+                  "items": { "$ref": "#/definitions/kebabIdentifier" },
+                  "uniqueItems": true
+                },
+                "prompts": {
+                  "type": "array",
+                  "items": { "$ref": "#/definitions/kebabIdentifier" },
+                  "uniqueItems": true
+                }
+              }
+            },
+            "coreApi": {
+              "type": "object",
+              "required": ["endpoints"],
+              "additionalProperties": false,
+              "properties": {
+                "endpoints": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "pattern": "^(GET|POST) /[a-z0-9/:{}-]+$"
+                  },
+                  "uniqueItems": true,
+                  "description": "Service CORE API read or validation endpoints that expose this topology."
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "businessBoundary": {
+      "type": "object",
+      "required": ["technicalOnly", "trackerOwns"],
+      "additionalProperties": false,
+      "properties": {
+        "technicalOnly": {
+          "type": "boolean",
+          "const": true,
+          "description": "Topology manifests are Phase 1 technical ideation artifacts and must not contain business data."
+        },
+        "trackerOwns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["timing", "ownership", "prioritization", "roi", "cost", "budget", "funnel-0"]
+          },
+          "uniqueItems": true,
+          "minItems": 7,
+          "maxItems": 7,
+          "description": "Business concerns reserved for Evolith Tracker via ACL and Funnel 0."
+        }
+      }
+    }
+  },
+  "definitions": {
+    "repositoryPath": {
+      "type": "string",
+      "pattern": "^(reference|rulesets|packages|sdk|apps)/[A-Za-z0-9._/-]+$",
+      "description": "Repository-relative path without leading slash."
+    },
+    "kebabIdentifier": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+    },
+    "mcpUri": {
+      "type": "string",
+      "pattern": "^evolith://[a-z0-9/{}/:-]+$"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "metadata": {
+            "properties": { "status": { "const": "accepted" } },
+            "required": ["status"]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "spec": { "required": ["corpus"] }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "metadata": {
+            "properties": { "status": { "const": "accepted" } },
+            "required": ["status"]
+          },
+          "spec": {
+            "properties": {
+              "topologyType": { "enum": ["serverless", "edge-computing"] }
+            },
+            "required": ["topologyType"]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "spec": { "required": ["operationalBudgets"] }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "metadata": {
+            "properties": { "status": { "const": "accepted" } },
+            "required": ["status"]
+          },
+          "spec": {
+            "properties": {
+              "topologyType": { "const": "agentic-ai" }
+            },
+            "required": ["topologyType"]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "spec": {
+            "required": ["operationalBudgets"],
+            "properties": {
+              "operationalBudgets": {
+                "required": ["tokenBudgetPerExecution", "credentialRotationIntervalHours", "sandboxTimeoutMs"]
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/rulesets/sdlc/README.es.md

@@ -0,0 +1,12 @@
+# Índice de Reglas SDLC
+
+Reglas que definen los gates de fase, los umbrales de calidad y los requisitos de evidencia.
+
+| Conjunto de Reglas | Archivo | Descripción |
+|---|---|---|
+| **Gates de Fase** | [phase-gates.rules.json](./phase-gates.rules.json) | Criterios de salida obligatorios por fase SDLC |
+| **Umbrales de Calidad** | [quality-thresholds.rules.json](./quality-thresholds.rules.json) | Líneas base canónicas de métricas: cobertura >= 80%, complejidad <= 15, etc. |
+
+---
+
+Volver al [Rulesets Hub](../README.es.md)

package/rulesets/sdlc/README.md

@@ -0,0 +1,12 @@
+# SDLC Rules Index
+
+Rules defining phase gates, quality thresholds, and evidence requirements.
+
+| Rule Set | File | Description |
+|---|---|---|
+| **Phase Gates** | [phase-gates.rules.json](./phase-gates.rules.json) | Mandatory exit criteria per SDLC phase |
+| **Quality Thresholds** | [quality-thresholds.rules.json](./quality-thresholds.rules.json) | Canonical metric baselines: coverage >= 80%, complexity <= 15, etc. |
+
+---
+
+Back to [Rulesets Hub](../README.md)

package/rulesets/sdlc/default-workflow.yaml

@@ -0,0 +1,73 @@
+# Default SDLC Workflow Definition
+#
+# This is the canonical phase/transition definition for the Evolith SDLC.
+# Tenants can override this by providing their own workflow definition
+# (YAML, DB, or API) through the IWorkflowDefinitionProvider interface.
+#
+# Phases are evaluated sequentially by default. Custom transition rules
+# can be added per tenant to allow skipping, branching, or conditional flows.
+
+name: evolith-default
+description: Default Evolith SDLC workflow — 6 sequential phases
+phases:
+  - value: phase-0
+    label: Foundation
+    description: Repository initialized
+    order: 0
+    artifacts: []
+    gateChecks: []
+
+  - value: phase-1
+    label: Structure
+    description: Project scaffolded
+    order: 1
+    artifacts: []
+    gateChecks: []
+
+  - value: phase-2
+    label: Governance
+    description: Rulesets and ACL configured
+    order: 2
+    artifacts: []
+    gateChecks: []
+
+  - value: phase-3
+    label: Architecture
+    description: ADRs and contexts defined
+    order: 3
+    artifacts: []
+    gateChecks: []
+
+  - value: phase-4
+    label: Production
+    description: CI/CD and containers
+    order: 4
+    artifacts: []
+    gateChecks: []
+
+  - value: phase-5
+    label: Observability
+    description: DORA metrics and dashboards
+    order: 5
+    artifacts: []
+    gateChecks: []
+
+transitions:
+  - from: phase-0
+    to: phase-1
+  - from: phase-1
+    to: phase-2
+  - from: phase-2
+    to: phase-3
+  - from: phase-3
+    to: phase-4
+  - from: phase-4
+    to: phase-5
+
+# Gate-to-phase mapping aligns the gate-evidence phases with workflow phases.
+gateMapping:
+  discovery: phase-1
+  design: phase-2
+  construction: phase-3
+  qa: phase-4
+  release: phase-5