@evolith/core-domain 1.0.1 → 1.0.2

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

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

@@ -1,12 +0,0 @@
-# Í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

@@ -1,12 +0,0 @@
-# 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

@@ -1,73 +0,0 @@
-# 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