@evolith/core-domain 1.0.1 → 1.0.3

package/README.md

@@ -0,0 +1,102 @@
+# @evolith/core-domain
+
+> Domain and application logic for the Evolith governance framework.
+
+[![npm version](https://img.shields.io/npm/v/@evolith/core-domain)](https://www.npmjs.com/package/@evolith/core-domain)
+[![license](https://img.shields.io/npm/l/@evolith/core-domain)](./LICENSE)
+
+## Overview
+
+`@evolith/core-domain` is the heart of the Evolith architecture governance framework. It provides the **domain model, application use-cases, and rule evaluation engine** used by all Evolith surfaces (Core API, MCP Server, CLI).
+
+Built on **Domain-Driven Design** principles with hexagonal architecture — all dependencies point inward; infrastructure is injected via ports.
+
+## Installation
+
+```bash
+npm install @evolith/core-domain
+```
+
+## What's inside
+
+| Layer | What it provides |
+|-------|-----------------|
+| **Domain** | Phase, Gate, Verdict, Satellite Manifest, Workflow Definition, RBAC, Audit entities |
+| **Application** | `EvaluateGateUseCase`, `ValidateBlueprintUseCase`, `ValidateWorkflowUseCase`, Architecture Drift detection, Satellite evaluation pipeline |
+| **Ports** | `IFileSystem`, `ILogger`, `IConfigParser`, `IRulesetRepository`, `IEventBus` — inject your own adapters |
+| **Gates** | Phase-gate validator, composable validation engine, OPA/Native dual-engine parity |
+
+## Usage
+
+```ts
+import { EvaluateGateUseCase } from '@evolith/core-domain/application/use-cases';
+import { loadDefaultWorkflow } from '@evolith/core-domain/domain/services';
+
+// Load the default SDLC workflow
+const workflow = loadDefaultWorkflow();
+
+// Evaluate a phase gate
+const useCase = new EvaluateGateUseCase(rulesetRepo, fileSystem, logger);
+const result = await useCase.execute({ projectId, phase, artifacts });
+```
+
+> **Runtime requirement:** set `WORKSPACE_ROOT` to the directory containing the `rulesets/` folder.
+> In Docker: `ENV WORKSPACE_ROOT=/app/corpus`. Locally: the monorepo root is used automatically.
+
+## Key exports
+
+```ts
+// Domain entities
+import { Phase, Verdict, GateDecision } from '@evolith/core-domain';
+
+// Use cases
+import { EvaluateGateUseCase }      from '@evolith/core-domain/application/use-cases';
+import { ValidateBlueprintUseCase } from '@evolith/core-domain/application/use-cases';
+import { ValidateWorkflowUseCase }  from '@evolith/core-domain/application/use-cases';
+
+// Validators
+import { PhaseGateValidatorService }      from '@evolith/core-domain/application/validators';
+import { ComposableValidationEngine }     from '@evolith/core-domain/application/validators/modes';
+
+// Services
+import { loadDefaultWorkflow }            from '@evolith/core-domain/domain/services';
+import { SatelliteEvaluationPipeline }    from '@evolith/core-domain/application/services';
+
+// Ports (interfaces for your adapters)
+import type { IFileSystem, ILogger }      from '@evolith/core-domain/domain/interfaces';
+import type { IRulesetRepository }        from '@evolith/core-domain';
+```
+
+## Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `WORKSPACE_ROOT` | *(monorepo root)* | Base directory containing `rulesets/` |
+
+## Architecture
+
+```
+@evolith/core-domain
+├── domain/          # Entities, value objects, ports (no external deps)
+│   ├── entities/    # Phase, Gate, Verdict, Satellite...
+│   ├── ports/       # IFileSystem, ILogger, IRulesetRepository...
+│   └── services/    # Workflow loading, domain services
+├── application/     # Use cases, validators, pipelines
+│   ├── use-cases/   # EvaluateGate, ValidateBlueprint, ValidateWorkflow
+│   ├── validators/  # PhaseGateValidator, ComposableValidationEngine
+│   └── services/    # SatelliteEvaluationPipeline, AuditService
+└── infrastructure/  # In-memory adapters (for testing)
+    ├── events/      # InMemoryEventBus
+    └── audit/       # InMemoryAuditRepository
+```
+
+## Part of the Evolith suite
+
+| Package | Role |
+|---------|------|
+| **`@evolith/core-domain`** | Domain logic and rule engine ← you are here |
+| [`@evolith/infra-providers`](https://www.npmjs.com/package/@evolith/infra-providers) | Infrastructure adapters (filesystem, logger, config) |
+
+## License
+
+UNLICENSED — proprietary. Copyright © Beyondnet.

package/dist/domain/services/default-workflow-definition.js

@@ -88,7 +88,10 @@ class DefaultWorkflowDefinition {
 }
 exports.DefaultWorkflowDefinition = DefaultWorkflowDefinition;
 function loadDefaultWorkflow() {
-    const content = fs.readFileSync(path.join(__dirname, '../../../rulesets/sdlc/default-workflow.yaml'), 'utf-8');
+    const rulesetBase = process.env.WORKSPACE_ROOT
+        ? path.join(process.env.WORKSPACE_ROOT, 'rulesets')
+        : path.join(__dirname, '../../../rulesets');
+    const content = fs.readFileSync(path.join(rulesetBase, 'sdlc/default-workflow.yaml'), 'utf-8');
     return new DefaultWorkflowDefinition(yaml_1.default.parse(content));
 }
 //# sourceMappingURL=default-workflow-definition.js.map

package/dist/domain/services/default-workflow-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-workflow-definition.js","sourceRoot":"","sources":["../../../src/domain/services/default-workflow-definition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"default-workflow-definition.js","sourceRoot":"","sources":["../../../src/domain/services/default-workflow-definition.ts"],"names":[],"mappings":"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"}

package/dist/gates/decision/gate-decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"gate-decision.js","sourceRoot":"","sources":["../../../src/gates/decision/gate-decision.ts"],"names":[],"mappings":";;;AA6BA,4CAiBC;AAMD,8DAIC;AAhDD,0DAAkG;AAEzF,uGAFS,gCAAsB,OAET;AAmB/B,SAAgB,gBAAgB,CAC9B,MAAc,EACd,KAAa,EACb,KAAa,EACb,UAAoB,EACpB,SAAS,GAAG,QAAQ;IAEpB,MAAM,OAAO,GAAY,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAO,CAAC,IAAI,CAAC;IAC9F,OAAO;QACL,MAAM;QACN,KAAK;QACL,OAAO;QACP,KAAK;QACL,UAAU;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;KACV,CAAC;AACJ,CAAC;AAMD,SAAgB,yBAAyB,CACvC,MAAsE;IAEtE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAA,gCAAsB,EAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AACxE,CAAC"}
+{"version":3,"file":"gate-decision.js","sourceRoot":"","sources":["../../../src/gates/decision/gate-decision.ts"],"names":[],"mappings":";;;AA6BA,4CAiBC;AAMD,8DAIC;AAhDD,0DAA+E;AAEtE,uGAFS,gCAAsB,OAET;AAmB/B,SAAgB,gBAAgB,CAC9B,MAAc,EACd,KAAa,EACb,KAAa,EACb,UAAoB,EACpB,SAAS,GAAG,QAAQ;IAEpB,MAAM,OAAO,GAAY,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,iBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAO,CAAC,IAAI,CAAC;IAC9F,OAAO;QACL,MAAM;QACN,KAAK;QACL,OAAO;QACP,KAAK;QACL,UAAU;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS;KACV,CAAC;AACJ,CAAC;AAMD,SAAgB,yBAAyB,CACvC,MAAsE;IAEtE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAA,gCAAsB,EAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolith/core-domain",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Shared Domain and Application logic for Evolith Core",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,7 +48,6 @@
   },
   "files": [
     "dist",
-    "rulesets",
     "README.md"
   ],
   "publishConfig": {

package/rulesets/README.es.md

@@ -1,170 +0,0 @@
-# Hub de Reglas de Evolith
-
-> **Bilingual navigation:** [English version](./README.md)
-
-Reglas de gobernanza machine-readable que los repositorios satélite heredan y contra las cuales validan.
-
----
-
-## Propósito
-
-> **Meta:** convertir la constitución escrita por humanos en reglas automatizadas exigibles en CI que los satélites no puedan eludir en silencio.
->
-> **Objetivos:** versionar cada regla, validar cada artefacto contra un schema y custodiar automáticamente cada transición de fase.
-
-Los Rulesets de Evolith son la **capa de ejecución machine-readable** del framework de gobernanza Evolith. Mientras `reference/` contiene estándares escritos por humanos, ADRs y documentación, `rulesets/` contiene las reglas concretas, esquemas y contratos que las herramientas (CLI, pipelines CI, linters) consumen para **validar** el cumplimiento de satélites.
-
----
-
-## Categorías de Reglas
-
-Si estás integrando un nuevo repositorio satélite, lee las categorías en este orden — del contrato de herencia a la validación de artefactos:
-
-| Documento | Descripción | Objetivo / Meta | Tipo | Obligatorio |
-|---|---|---|---|---|
-| [Reglas de Gobernanza](./governance/README.es.md) | Contrato `evolith.yaml` y reglas de herencia | Gobernar la herencia de satélites | Categoría de reglas | Sí |
-| [Reglas de Arquitectura](./architecture/README.es.md) | Reglas de progresión de fase F1/F2/F3 | Custodiar las fases de arquitectura | Categoría de reglas | Sí |
-| [Reglas Codificadas desde ADRs](./adr/README.es.md) | Reglas derivadas de ADRs aceptados | Hacer cumplir las decisiones automáticamente | Categoría de reglas | Sí |
-| [Reglas Transversales](./cross-cutting/README.es.md) | Baseline de cumplimiento, Definition of Done, manifiesto y taxonomía | Hacer cumplir las reglas transversales | Categoría de reglas | Sí |
-| [Reglas SDLC](./sdlc/README.es.md) | Definiciones de quality gates y thresholds | Hacer cumplir la calidad del ciclo de vida | Categoría de reglas | Sí |
-| [Reglas Anti-Corrupción](./acl/README.es.md) | Gobernanza de integración con sistemas externos | Proteger los límites del dominio | Categoría de reglas | Sí |
-| [Reglas del CLI](./cli/README.es.md) | Preparación de release del Smart CLI y paridad con Core | Custodiar los releases del CLI | Categoría de reglas | Sí |
-| [Reglas de Evidencia](./evidence/README.es.md) | Manifests de evidencia auditable | Estandarizar la evidencia | Categoría de reglas | Sí |
-| [Reglas MCP](./mcp/README.es.md) | Cumplimiento del protocolo MCP | Validar la exposición MCP | Categoría de reglas | Sí |
-| [Reglas de Observabilidad](./observability/README.es.md) | Evidencia de telemetría para operación | Verificar la evidencia de telemetría | Categoría de reglas | Sí |
-| [Rulesets Topologicos](./topologies/README.es.md) | Reglas ejecutables Native y OPA especificas por topologia | Gobernar la validacion topologica | Categoria de reglas | Si |
-| [Schemas](./schema/README.es.md) | JSON Schema para validación de artefactos Evolith | Validar la estructura de artefactos | Colección de schemas | Sí |
-| [Políticas OPA](./opa/README.es.md) | Políticas OPA y sus schemas de entrada | Validar gobernanza y reglas de arquitectura | Colección de políticas | Sí |
-
----
-
-## Estructura de Directorios
-
-```
-rulesets/
-├── compliance-baseline/        # Punto de entrada WS1 del baseline de cumplimiento
-│   └── compliance-baseline.rules.json
-├── definition-of-done/         # Punto de entrada WS1 de Definition of Done
-│   └── definition-of-done.rules.json
-├── engineering-manifesto/      # Punto de entrada WS1 del Manifiesto de Ingeniería
-│   └── engineering-manifesto.rules.json
-├── repository-taxonomy/        # Punto de entrada WS1 de Taxonomía del Repositorio
-│   └── repository-taxonomy.rules.json
-├── phase-gates/                # Punto de entrada WS1 de gates de fase SDLC
-│   └── phase-gates.rules.json
-├── quality-thresholds/         # Punto de entrada WS1 de umbrales de calidad
-│   └── quality-thresholds.rules.json
-├── satellite-contracts/        # Punto de entrada WS1 de Satellite Contracts
-│   └── satellite-contracts.rules.json
-├── opa/                        # Políticas OPA y schemas de entrada
-│   ├── schemas/                # Schemas de entrada de políticas OPA (9 schemas)
-│   ├── *.rego                  # Archivos de políticas Rego
-│   └── README.es.md            # Índice OPA
-├── schema/                     # Definiciones de JSON Schema (19 schemas)
-│   ├── adr.schema.json         # Validación de artefacto ADR
-│   ├── prd.schema.json         # Validación de artefacto PRD
-│   ├── discovery-canvas.schema.json     # Fase 1
-│   ├── technical-feasibility.schema.json # Fase 1
-│   ├── ballpark-estimation.schema.json   # Fase 1
-│   ├── evolith-user-story.schema.json    # Fase 1
-│   ├── agile-backlog.schema.json          # Fase 1
-│   ├── cli-impact-analysis.schema.json   # Fase 1-2
-│   ├── functional-story.schema.json      # Fase 2
-│   ├── technical-story.schema.json       # Fase 3
-│   ├── test-summary-report.schema.json   # Fase 4
-│   ├── release-notes.schema.json         # Fase 5
-│   ├── evolith-yaml.schema.json          # Gobernanza satelite
-│   └── topology-manifest.schema.json     # Contrato de manifiesto topologico
-├── architecture/               # Alias de compatibilidad F1/F2/F3 y guía de migración
-│   └── README.md               # Resuelve alias mediante manifiestos topológicos
-├── topologies/                 # Reglas ejecutables especificas por topologia
-│   └── README.es.md
-├── adr/                        # Reglas encoding ADR
-│   ├── adr-0002-hexagonal-architecture.rules.json
-│   ├── adr-0005-cicd-quality-gates.rules.json
-│   ├── adr-0018-testing-pyramid.rules.json
-│   ├── adr-0032-protocol-selection.rules.json
-│   ├── adr-0040-multi-runtime.rules.json
-│   ├── adr-0050-gitflow-branching.rules.json
-│   └── adr-0010-multi-tenancy.rules.json
-├── cross-cutting/              # Solo aliases — los archivos canónicos están en sus carpetas de dominio arriba
-│   ├── compliance-baseline.rules.json    # alias → compliance-baseline/compliance-baseline.rules.json
-│   ├── definition-of-done.rules.json     # alias → definition-of-done/definition-of-done.rules.json
-│   ├── engineering-manifesto.rules.json  # alias → engineering-manifesto/engineering-manifesto.rules.json
-│   └── repository-taxonomy.rules.json    # alias → repository-taxonomy/repository-taxonomy.rules.json
-├── acl/                        # Reglas Anti-Corruption Layer
-│   ├── anti-corruption-layer.rules.json  # Aplicación ACL
-│   └── anti-corruption-layer.rules.es.json
-├── sdlc/                       # Reglas de gates SDLC
-│   ├── phase-gates.rules.json
-│   └── quality-thresholds.rules.json
-├── cli/                        # Reglas de release y paridad del Smart CLI
-│   ├── release-readiness.rules.json
-│   └── core-parity.rules.json
-├── evidence/                   # Contrato de evidencia auditable
-│   └── evidence-manifest.rules.json
-├── mcp/                        # Reglas de exposición del protocolo MCP
-│   └── protocol-compliance.rules.json
-├── observability/              # Reglas de evidencia de telemetría
-│   └── telemetry-evidence.rules.json
-└── governance/                 # Reglas de gobernanza federada
-    ├── inheritance.rules.json
-    ├── satellite-contracts.rules.json
-    ├── open-core-boundary.rules.json  # Frontera Core vs Enterprise
-    └── executive-scorecards.rules.json  # Métricas DORA + SPACE
-```
-
----
-
-El artefacto canónico de reglas topológicas es el archivo declarado por cada `topology.manifest.json`; los artefactos actuales del eje progresivo viven bajo `reference/architecture/topologies/progressive-axis/`. Los consumidores deben resolver el manifiesto en lugar de construir rutas legacy `rulesets/architecture/f*.rules.json`.
-
-## Cómo Funcionan los Rulesets
-
-```mermaid
-flowchart LR
-    classDef core fill:#14532d,stroke:#22c55e,color:#fff
-    classDef sat fill:#1e3a5f,stroke:#3b82f6,color:#fff
-    classDef tool fill:#4a3800,stroke:#f59e0b,color:#fff
-
-    R["rulesets/\n(Evolith Core)"]:::core
-    S["evolith.yaml\n(Satellite)"]:::sat
-    T["CLI / CI\nValidation"]:::tool
-
-    R -->|"inheritance"| S
-    S -->|"validate"| T
-    T -->|"block / pass"| S
-```
-
-1. **Evolith Core** publica rulesets
-2. **Satélites** declaran `evolith.yaml` heredando versiones específicas de reglas
-3. **CLI / CI** valida satélite contra reglas heredadas
-4. **Failures** bloquean phase gates o merge
-
----
-
-## Principios Clave
-
-| Principio | Descripción |
-|---|---|
-| **Reglas versionadas** | Cada regla tiene versión; satélites hacen pin a versión específica |
-| **Fail-fast validation** | CI debe fallar en violaciones de reglas; sin bypass sin waiver explícito |
-| **Topology-aware** | F1/F2/F3 permanecen como aliases de compatibilidad progressive-axis mientras los manifiestos topologicos gobiernan validacion especifica mas amplia |
-| **Herencia federada** | Satélites heredan de Core; no modifican reglas del Core |
-| **Schema-first** | Todos los artefactos tienen JSON Schema para validación machine |
-
----
-
-## Documentos Relacionados
-
-| Documento | Descripción | Objetivo / Meta | Tipo | Obligatorio |
-|---|---|---|---|---|
-| [AGENTS.md](../AGENTS.es.md) | Reglas y convenciones de agentes | Gobernar las contribuciones de agentes | Estándar | Sí |
-| [Taxonomía del Repositorio](../reference/governance/standards/repository-taxonomy.es.md) | Qué va dónde en Evolith | Mantener el repositorio organizado | Estándar de gobernanza | Sí |
-| [Guía de Herencia de Repositorios Hijos](../reference/governance/standards/onboarding/child-repository-inheritance-guide.es.md) | Cómo los productos heredan de Evolith | Estandarizar la herencia | Guía | Sí |
-| [Hub de Navegación](../reference/navigation/README.es.md) | Navegación completa del repositorio | Centralizar la navegación | Hub de navegación | No |
-
----
-
-<div align="center">
-  <sub>Evolith — Enterprise Architecture Platform | Rulesets Hub</sub>
-</div>

package/rulesets/README.md

@@ -1,170 +0,0 @@
-# Evolith Rulesets Hub
-
-> **Navegación bilingüe:** [Versión en Español](./README.es.md)
-
-Machine-readable governance rules that satellite repositories inherit and validate against.
-
----
-
-## Purpose
-
-> **Goal:** turn the human-authored constitution into automated, CI-enforceable rules that satellites cannot silently bypass.
->
-> **Objectives:** version every rule, validate every artifact against a schema, and gate every phase transition automatically.
-
-Evolith Rulesets are the **machine-readable enforcement layer** of the Evolith governance framework. While `reference/` contains human-authored standards, ADRs, and documentation, `rulesets/` contains the concrete rules, schemas, and contracts that tools (CLI, CI pipelines, linters) consume to **validate** satellite compliance.
-
----
-
-## Rule Categories
-
-If you are onboarding a new satellite repository, read the categories in this order — from inheritance contract to artifact validation:
-
-| Document | Description | Goal / Objective | Type | Mandatory |
-|---|---|---|---|---|
-| [Governance Rules](./governance/README.md) | `evolith.yaml` contract and inheritance rules | Govern satellite inheritance | Ruleset category | Yes |
-| [Architecture Rules](./architecture/README.md) | F1/F2/F3 phase progression rules | Gate architecture phases | Ruleset category | Yes |
-| [ADR-Encoded Rules](./adr/README.md) | Rules derived from accepted ADRs | Enforce ADR decisions automatically | Ruleset category | Yes |
-| [Cross-Cutting Rules](./cross-cutting/README.md) | Compliance baseline, Definition of Done, manifesto, and taxonomy rules | Enforce cross-cutting compliance | Ruleset category | Yes |
-| [SDLC Rules](./sdlc/README.md) | Quality gates and threshold definitions | Enforce lifecycle quality | Ruleset category | Yes |
-| [Anti-Corruption Layer Rules](./acl/README.md) | External system integration governance | Protect domain boundaries | Ruleset category | Yes |
-| [CLI Rules](./cli/README.md) | Smart CLI release readiness and Core parity | Gate CLI releases | Ruleset category | Yes |
-| [Evidence Rules](./evidence/README.md) | Auditable evidence manifests | Standardize evidence | Ruleset category | Yes |
-| [MCP Rules](./mcp/README.md) | MCP protocol compliance | Validate MCP exposure | Ruleset category | Yes |
-| [Observability Rules](./observability/README.md) | Telemetry evidence for operations | Verify telemetry evidence | Ruleset category | Yes |
-| [Topology Rulesets](./topologies/README.md) | Executable topology-specific Native and OPA rules | Govern topology validation | Ruleset category | Yes |
-| [Schemas](./schema/README.md) | JSON Schema for validating Evolith artifacts | Validate artifact structure | Schema collection | Yes |
-| [OPA Policies](./opa/README.md) | OPA policies and their input schemas | Validate governance and architectural rules | Policy collection | Yes |
-
----
-
-## Directory Structure
-
-```
-rulesets/
-├── compliance-baseline/        # WS1 executable compliance baseline entrypoint
-│   └── compliance-baseline.rules.json
-├── definition-of-done/         # WS1 executable Definition of Done entrypoint
-│   └── definition-of-done.rules.json
-├── engineering-manifesto/      # WS1 executable Engineering Manifesto entrypoint
-│   └── engineering-manifesto.rules.json
-├── repository-taxonomy/        # WS1 executable Repository Taxonomy entrypoint
-│   └── repository-taxonomy.rules.json
-├── phase-gates/                # WS1 executable SDLC phase-gates entrypoint
-│   └── phase-gates.rules.json
-├── quality-thresholds/         # WS1 executable quality-thresholds entrypoint
-│   └── quality-thresholds.rules.json
-├── satellite-contracts/        # WS1 executable Satellite Contracts entrypoint
-│   └── satellite-contracts.rules.json
-├── opa/                        # OPA policies and inputs schemas
-│   ├── schemas/                # OPA policy input schemas (9 schemas)
-│   ├── *.rego                  # Rego policy files
-│   └── README.md               # OPA index
-├── schema/                     # JSON Schema definitions (19 schemas)
-│   ├── adr.schema.json         # ADR artifact validation
-│   ├── prd.schema.json         # PRD artifact validation
-│   ├── discovery-canvas.schema.json     # Phase 1
-│   ├── technical-feasibility.schema.json # Phase 1
-│   ├── ballpark-estimation.schema.json   # Phase 1
-│   ├── evolith-user-story.schema.json    # Phase 1
-│   ├── agile-backlog.schema.json          # Phase 1
-│   ├── cli-impact-analysis.schema.json   # Phase 1-2
-│   ├── functional-story.schema.json      # Phase 2
-│   ├── technical-story.schema.json       # Phase 3
-│   ├── test-summary-report.schema.json   # Phase 4
-│   ├── release-notes.schema.json         # Phase 5
-│   ├── evolith-yaml.schema.json          # Satellite governance
-│   └── topology-manifest.schema.json     # Topology manifest contract
-├── architecture/               # F1/F2/F3 compatibility aliases and migration guidance
-│   └── README.md               # Resolves aliases through topology manifests
-├── topologies/                 # Topology-specific executable rules
-│   └── README.md
-├── adr/                        # ADR-encoded rules (7 ADRs)
-│   ├── adr-0002-hexagonal-architecture.rules.json
-│   ├── adr-0005-cicd-quality-gates.rules.json
-│   ├── adr-0018-testing-pyramid.rules.json
-│   ├── adr-0032-protocol-selection.rules.json
-│   ├── adr-0040-multi-runtime.rules.json
-│   ├── adr-0050-gitflow-branching.rules.json
-│   └── adr-0010-multi-tenancy.rules.json
-├── cross-cutting/              # Aliases only — canonical files are in domain-specific dirs above
-│   ├── compliance-baseline.rules.json    # alias → compliance-baseline/compliance-baseline.rules.json
-│   ├── definition-of-done.rules.json     # alias → definition-of-done/definition-of-done.rules.json
-│   ├── engineering-manifesto.rules.json  # alias → engineering-manifesto/engineering-manifesto.rules.json
-│   └── repository-taxonomy.rules.json    # alias → repository-taxonomy/repository-taxonomy.rules.json
-├── acl/                        # Anti-Corruption Layer rules (NEW)
-│   ├── anti-corruption-layer.rules.json  # ACL enforcement
-│   └── anti-corruption-layer.rules.es.json
-├── sdlc/                       # SDLC gate rules
-│   ├── phase-gates.rules.json
-│   └── quality-thresholds.rules.json
-├── cli/                        # Smart CLI release and parity rules
-│   ├── release-readiness.rules.json
-│   └── core-parity.rules.json
-├── evidence/                   # Auditable evidence contract
-│   └── evidence-manifest.rules.json
-├── mcp/                        # MCP protocol exposure rules
-│   └── protocol-compliance.rules.json
-├── observability/              # Telemetry evidence rules
-│   └── telemetry-evidence.rules.json
-└── governance/                 # Federated governance rules
-    ├── inheritance.rules.json
-    ├── satellite-contracts.rules.json
-    ├── open-core-boundary.rules.json  # Core vs Enterprise separation
-    └── executive-scorecards.rules.json  # DORA + SPACE metrics
-```
-
----
-
-The canonical topology rule artifact is the file declared by each `topology.manifest.json`; the current progressive-axis artifacts live under `reference/architecture/topologies/progressive-axis/`. Consumers must resolve the manifest rather than construct legacy `rulesets/architecture/f*.rules.json` paths.
-
-## How Rulesets Work
-
-```mermaid
-flowchart LR
-    classDef core fill:#14532d,stroke:#22c55e,color:#fff
-    classDef sat fill:#1e3a5f,stroke:#3b82f6,color:#fff
-    classDef tool fill:#4a3800,stroke:#f59e0b,color:#fff
-
-    R["rulesets/\n(Evolith Core)"]:::core
-    S["evolith.yaml\n(Satellite)"]:::sat
-    T["CLI / CI\nValidation"]:::tool
-
-    R -->|"inheritance"| S
-    S -->|"validate"| T
-    T -->|"block / pass"| S
-```
-
-1. **Evolith Core** publishes rulesets
-2. **Satellites** declare `evolith.yaml` inheriting specific rule versions
-3. **CLI / CI** validates satellite against inherited rules
-4. **Failures** block phase gates or merge
-
----
-
-## Key Principles
-
-| Principle | Description |
-|---|---|
-| **Versioned rules** | Every rule has a version; satellites pin to a specific version |
-| **Fail-fast validation** | CI must fail on rule violations; no bypass without explicit waiver |
-| **Topology-aware** | F1/F2/F3 remain progressive-axis compatibility aliases while topology manifests drive broader topology-specific validation |
-| **Federated inheritance** | Satellites inherit from Core; they do not modify Core rules |
-| **Schema-first** | All artifacts have JSON Schema for machine validation |
-
----
-
-## Related Documents
-
-| Document | Description | Goal / Objective | Type | Mandatory |
-|---|---|---|---|---|
-| [AGENTS.md](../AGENTS.md) | Agent rules and conventions | Govern agent contributions | Standard | Yes |
-| [Repository Taxonomy](../reference/governance/standards/repository-taxonomy.md) | What goes where in Evolith | Keep the repository organized | Governance standard | Yes |
-| [Child Repository Inheritance](../reference/governance/standards/onboarding/child-repository-inheritance-guide.md) | How products inherit from Evolith | Standardize inheritance | Guide | Yes |
-| [Navigation Hub](../reference/navigation/README.md) | Full repository navigation | Centralize navigation | Navigation hub | No |
-
----
-
-<div align="center">
-  <sub>Evolith — Enterprise Architecture Platform | Rulesets Hub</sub>
-</div>

package/rulesets/acl/README.es.md

@@ -1,41 +0,0 @@
-# Anti-Corruption Layer (ACL) Rules — Index
-
-> **Navegación Bilingüe:** [English Version](./README.md)
-
-## Overview
-
-The Anti-Corruption Layer ruleset governs all integrations with external systems (Jira, Trello, Linear, GitHub, Confluence, etc.). ACLs normalize and validate external data against Evolith Core artifacts, preventing external chaos from contaminating governance.
-
-## Files
-
-| File | Description |
-|------|-------------|
-| `anti-corruption-layer.rules.json` | Machine-readable ACL rules (EN) |
-| `anti-corruption-layer.rules.es.json` | Machine-readable ACL rules (ES) |
-
-## Principles
-
-| ID | Principle | Severity | Blocking |
-|----|-----------|----------|----------|
-| **ACL-01** | Schema Validation Before Ingestion | MUST | Yes |
-| **ACL-02** | Transformation Traceability | MUST | Yes |
-| **ACL-03** | Reject Non-Compliant Data | MUST | Yes |
-| **ACL-04** | ACL Version Synchronization with Core | MUST | Yes |
-| **ACL-05** | Explicit Contract Required | SHOULD | No |
-| **ACL-06** | Isolate External Dependencies | MUST | Yes |
-
-## Key Definitions
-
-**Anti-Corruption Layer (ACL):** Integration layer that normalizes and validates external data against Core schemas. Acts as a protective barrier between external system chaos and Evolith governance.
-
-**External System:** Any tool outside Evolith Core that provides data to satellite products (Jira, Trello, Linear, GitHub, Confluence, spreadsheets, etc.)
-
-**Transformation Traceability:** Audit trail from external entity to Core entity showing what transformation was applied and why.
-
-## Reference
-
-- [Evolith Product Vision Master — Section 3.2 ACLs](../../reference/product-suite/vision/evolith-product-vision-master.es.md)
-- [Evolith Core Inheritance Rules](../governance/inheritance.rules.json)
-
----
-[Back to Rulesets Hub](../README.es.md)

package/rulesets/acl/README.md

@@ -1,41 +0,0 @@
-# Anti-Corruption Layer (ACL) Rules — Index
-
-> **Bilingual Navigation:** [Spanish Version](./README.es.md)
-
-## Overview
-
-The Anti-Corruption Layer ruleset governs all integrations with external systems (Jira, Trello, Linear, GitHub, Confluence, etc.). ACLs normalize and validate external data against Evolith Core artifacts, preventing external chaos from contaminating governance.
-
-## Files
-
-| File | Description |
-|------|-------------|
-| `anti-corruption-layer.rules.json` | Machine-readable ACL rules (EN) |
-| `anti-corruption-layer.rules.es.json` | Machine-readable ACL rules (ES) |
-
-## Principles
-
-| ID | Principle | Severity | Blocking |
-|----|-----------|----------|----------|
-| **ACL-01** | Schema Validation Before Ingestion | MUST | Yes |
-| **ACL-02** | Transformation Traceability | MUST | Yes |
-| **ACL-03** | Reject Non-Compliant Data | MUST | Yes |
-| **ACL-04** | ACL Version Synchronization with Core | MUST | Yes |
-| **ACL-05** | Explicit Contract Required | SHOULD | No |
-| **ACL-06** | Isolate External Dependencies | MUST | Yes |
-
-## Key Definitions
-
-**Anti-Corruption Layer (ACL):** Integration layer that normalizes and validates external data against Core schemas. Acts as a protective barrier between external system chaos and Evolith governance.
-
-**External System:** Any tool outside Evolith Core that provides data to satellite products (Jira, Trello, Linear, GitHub, Confluence, spreadsheets, etc.)
-
-**Transformation Traceability:** Audit trail from external entity to Core entity showing what transformation was applied and why.
-
-## Reference
-
-- [Evolith Product Vision Master — Section 3.2 ACLs](../../reference/product-suite/vision/evolith-product-vision-master.md)
-- [Evolith Core Inheritance Rules](../governance/inheritance.rules.json)
-
----
-[Back to Rulesets Hub](../README.md)