diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..16b05a0 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,44 @@ +# AGENTS.md — Verstak Sync Server + +## Назначение + +Отдельный сервер синхронизации для Верстака. Обеспечивает синхронизацию vault между устройствами. + +## Правила + +- Sync server не импортирует desktop UI или official plugins. +- Sync server синхронизирует vault metadata, файлы/blobs, plugin state (где разрешено). +- Плагины явно указывают, какие данные можно синхронизировать. +- Sync — не источник правды, а дополнение. + +## API + +``` +POST /api/v1/pair — создание пары устройство-сервер +POST /api/v1/auth — аутентификация +GET /api/v1/devices — список устройств +POST /api/v1/sync — синхронизация операций +GET /api/v1/blob/:hash — скачать blob +PUT /api/v1/blob/:hash — загрузить blob +GET /api/v1/operations — получить операции с последнего sync point +``` + +## Структура + +``` +verstak-sync-server/ + AGENTS.md + cmd/ + server/ + internal/ + api/ + auth/ + device/ + vault/ + blob/ + conflict/ + migrations/ + ... + go.mod + README.md +```