> Перевод даётся для удобства чтения. Нормативным является английский оригинал.

# Инструменты

Эталонная оснастка спецификации Мета-Вселенной. Это минимальные эталонные
реализации, назначение которых - сделать спеку проверяемой, а не быть продуктом.
Спецификация ссылается на них по **логическому имени команды**
(`mu-fingerprint`, `mu-validate`, ...); эта папка есть текущая реализация.

| Команда | Файл | Назначение |
|---------|------|---------|
| `mu-fingerprint` | `mu-fingerprint.ps1` | Эталонная реализация канонизации **Семантического отпечатка**, заданной в [MMAS-Interchange](../02-architecture/MMAS-Interchange.md). |
| `mu-validate` | `mu-validate.ps1` | Эталонный валидатор MUIF: прогоняет машинно проверяемые Абстрактные процедуры тестирования (V0-V2) и выдаёт [Отчёт валидации](../schemas/validation-report.schema.json). Код выхода 0, если нет ошибок. |
| `mu-requirements` | `mu-requirements.ps1` | Пересоздаёт [`REQUIREMENTS-INDEX.md`](../REQUIREMENTS-INDEX.md) из Нормативных документов. |
| `mu-spec-index` | `mu-spec-index.ps1` | Пересоздаёт [`spec-index.yaml`](../spec-index.yaml), машиночитаемый указатель всех документов. |
| `mu-test` | `../tests/run-tests.ps1` | Прогоняет Семантический набор тестов. |

## Замечание о реализации

Эталонные инструменты сейчас реализованы на **PowerShell Core (`pwsh`)**,
который работает на Windows, macOS и Linux. Выбор пал на него потому, что спека
сочиняется без предположения о наличии оснастки Node или Python. **Независимый от
языка CLI** (`mu-*`, плюс `mu-diff`) стоит в [дорожной карте](../MATURATION-ROADMAP.md);
логические имена команд выше устойчивы, так что документы и CI не зависят от
языка реализации.

## Вызов

```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
```

Пример:

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