![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
apidev update-check
```

`apidev update-check` явно проверяет последнюю опубликованную версию в npm. Обычные команды `apidev` не выполняют сетевую проверку обновлений при запуске.

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

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

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

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

Каждый runtime package поставляет PyInstaller `onedir` payload, чтобы ускорить запуск CLI после установки через npm.
