Документировать WSL и git-коммиты через терминал WSL

This commit is contained in:
2026-07-07 16:53:59 +03:00
parent 0c1afc6919
commit 6e52c53906
+31 -2
View File
@@ -50,13 +50,40 @@
| Репозиторий | Минимум |
|-------------|---------|
| EventHubBack | `make test` / `make eunit` / целевые API-тесты |
| EventHubBack | `make test` / `make eunit` / целевые API-тесты (см. §2.1 WSL) |
| EventHubFrontAdmin | `npm run lint`, `npm run build` |
| EventHubSpec | ревью текста, ссылки на код |
---
## 3. Спецификация (после успешных тестов)
## 2.1. Локальная разработка (WSL)
Окружение: **WSL + asdf** (Erlang/OTP 28, rebar3). PowerShell/Windows — только IDE; сборка и тесты — в WSL.
```bash
cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubBack
bash scripts/wsl-ext4-dirs.sh # один раз: logs/data на ext4
bash scripts/fix-rebar-unit-symlink.sh # перед CT, если rebar сломал unit/api
rebar3 as test eunit
rebar3 ct --suite=api_admins_SUITE
```
### Git-коммиты — только из WSL-терминала
Коммиты из **Agent Shell / PowerShell** ломаются: Cursor подставляет `--trailer "Co-authored-by: Cursor <cursoragent@cursor.com>"`, а PowerShell падает на `<`.
**Правило:** `git add` / `git commit` / `git push` — в WSL (`bash -lic` или встроенный терминал WSL), не через Agent.
```bash
cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubBack # или EventHubSpec
git status
git add <files>
git commit -m "сообщение. Refs EventHub/EventHubBack#N"
```
Attribution в Cursor (Settings → Agent → Attribution) можно выключить, но WSL-терминал надёжнее.
---
Если изменение затрагивает **поведение, API, модель данных или роли**:
@@ -97,6 +124,7 @@
- Код фичи — в репозитории-владельце; `EventHubSpec` — для документации и процесса.
- Метки во всех репозиториях держать одинаковыми (`sync-labels.ps1`).
- Секреты и токены не коммитить; Gitea token — только в env / `~/.cursor/secrets/`.
- **Git commit/push — из WSL-терминала**, не из Agent Shell (см. §2.1).
---
@@ -104,5 +132,6 @@
| Дата | Изменение |
|------|-----------|
| 2026-07-07 | §2.1: WSL-окружение, git-коммиты только из WSL-терминала |
| 2026-07-07 | Правило: варианты решения и утверждение перед реализацией |
| 2026-07-07 | Первая версия: Gitea workflow, gate тестирования, sync спеки |