> Esta traducción se ofrece por comodidad. El texto normativo es el original en inglés.

# Herramientas

Herramientas de referencia para la especificación del Meta-Universo. Son
implementaciones de referencia mínimas, pensadas para hacer verificable la
especificación, no un producto. La especificación se refiere a ellas por su
**nombre lógico de comando** (`mu-fingerprint`, `mu-validate`, ...); esta carpeta
es la implementación actual.

| Comando | Fichero | Propósito |
|---------|------|---------|
| `mu-fingerprint` | `mu-fingerprint.ps1` | Implementación de referencia de la canonicalización de la **Huella semántica** definida en [MMAS-Interchange](../02-architecture/MMAS-Interchange.md). |
| `mu-validate` | `mu-validate.ps1` | Validador MUIF de referencia: ejecuta los Procedimientos abstractos de prueba comprobables por máquina (V0-V2) y emite un [Informe de validación](../schemas/validation-report.schema.json). Sale con 0 si no hay errores. |
| `mu-requirements` | `mu-requirements.ps1` | Regenera [`REQUIREMENTS-INDEX.md`](../REQUIREMENTS-INDEX.md) a partir de los documentos normativos. |
| `mu-spec-index` | `mu-spec-index.ps1` | Regenera [`spec-index.yaml`](../spec-index.yaml), el índice legible por máquina de todos los documentos. |
| `mu-test` | `../tests/run-tests.ps1` | Ejecuta el Kit de pruebas semánticas. |

## Nota de implementación

Las herramientas de referencia están implementadas hoy en **PowerShell Core
(`pwsh`)**, que funciona en Windows, macOS y Linux. Se eligió porque la
especificación se redacta sin dar por supuesta una cadena de herramientas de Node
o Python. Una **CLI neutral respecto del lenguaje** (`mu-*`, más `mu-diff`) está
en la [hoja de ruta](../MATURATION-ROADMAP.md); los nombres lógicos de comando de
arriba son estables, de modo que los documentos y la CI no dependen del lenguaje
de implementación.

## Invocación

```text
# logical command                         # current implementation
mu-fingerprint <file>                      pwsh tools/mu-fingerprint.ps1 <file>
mu-validate    <file>                      pwsh tools/mu-validate.ps1 <file>
mu-test                                    pwsh tests/run-tests.ps1
```

Ejemplo:

```text
mu-fingerprint examples/minimal-person/person.muif.json
# sha256:a628b2afb96dc673f7e2f9161569e573fc70892d10a6997fad7aaa14b04a639d
```