![APIDev](https://unpkg.com/@ai-devtools/apidev/assets/logo.png)

# APIDev

APIDev — CLI-инструмент для контрактной разработки API. Он помогает держать YAML-контракты, сгенерированный transport layer и OpenAPI-описание в синхронном состоянии.

## Установка

```bash
npm i -g @ai-devtools/apidev
```

После установки доступна команда:

```bash
apidev --help
```

## Для чего нужен APIDev

- описывать API-операции в едином contract format;
- проверять контракты перед генерацией;
- смотреть план изменений без записи файлов;
- генерировать предсказуемые Python-артефакты transport layer;
- использовать `apidev gen --check` как CI-gate против drift между контрактами и сгенерированным кодом.

## Основные команды

```bash
apidev init
apidev validate
apidev diff
apidev gen
apidev gen --check
```

## Как устроена npm-установка

Пакет `@ai-devtools/apidev` устанавливает команду `apidev` и автоматически подтягивает platform package для текущей ОС и архитектуры.

Поддерживаемые runtime packages:

- `@ai-devtools/apidev-linux-x64`;
- `@ai-devtools/apidev-macos-arm64`;
- `@ai-devtools/apidev-windows-x64`.

Пакет `@ai-devtools/apidev-macos-arm64-onedir` публикуется отдельно как дополнительный release target и не выбирается root shim по умолчанию.
