FUCK TEAMBUILDING

У меня к этому Mac подключён по USB диктофон HiDock (модель H1, H1E или P1). Я не
программист. Пожалуйста, настрой всё сам и преврати мои записи в текстовые
расшифровки. Делай всё за меня, коротко поясняя шаги. Ничего с устройства не
удаляй.

1. Убедись, что установлены Homebrew и libusb (`brew install libusb`) и есть
   Python 3.
2. Склонируй открытый репозиторий с проверенным кодом доступа к HiDock:
   `git clone https://github.com/sgeraldes/hidock-next` в текущую папку. В нём есть
   `apps/desktop/src/hidock_device.py` (класс HiDockJensen) и
   `apps/desktop/src/constants.py` (USB-идентификаторы устройств).
3. Создай Python-виртуальное окружение и установи в него `pyusb`.
4. Напиши скрипт `sync.py`, который:
   - Сам находит подключённый HiDock на USB по вендор-ID (0x10D6 и 0x3887) и
     product-ID из constants.py — не хардкодь одну модель.
   - Подключается через HiDockJensen (libusb-backend, указывающий на dylib libusb
     из Homebrew), получает список записей и для каждой ещё не обработанной:
     - скачивает байты через stream_file. Файлы устройства `.hda` — это на самом
       деле MP3: сохраняй их как `.mp3` без конвертации;
     - отправляет аудио в AssemblyAI: POST /v2/upload (сырые байты) → POST
       /v2/transcript с {"speaker_labels": true, "language_detection": true} →
       опрашивай GET /v2/transcript/{id} пока status не станет completed.
       (language_detection обязателен — без него неанглийское аудио может вернуться
       пустым. Не отправляй language_code вместе с language_detection.)
     - записывает Markdown-файл: короткий фронтматтер (title/date/duration/language)
       и транскрипт блоками `### Speaker X · mm:ss`;
     - отмечает готовую запись в маленьком файле-журнале (леджере), чтобы никогда
       не обрабатывать её повторно.
   - Печатает компактный отчёт (сколько новых / готово / ошибок).
   - Читает ключ AssemblyAI из переменной окружения ASSEMBLYAI_API_KEY.
5. Запусти его, подставив мой ключ: ASSEMBLYAI_API_KEY=ВСТАВЬТЕ-СЮДА-СВОЙ-КЛЮЧ
6. Если устройство не найдено или видишь «health check failed» — попроси меня
   вынуть и снова вставить HiDock, затем повтори. На macOS для USB-команд может
   понадобиться запуск без песочницы.

Когда закончишь, скажи, в какой папке лежат текстовые расшифровки.

# Cardputer ADV — прошивка «cli ai audio»

## Команды
- Сборка: `~/.platformio/penv/bin/pio run`
- Прошивка: только через /flash
- Проверка на устройстве: /check — обязательна перед «готово»

## Чего нельзя делать никогда
1. Ставить флаг -DBOARD_HAS_PSRAM. У этого чипа PSRAM физически нет.
2. Включать микрофон, не выключив динамик. Они делят одни провода.
   Строго: Speaker.end() → Mic.begin() → запись → Mic.end() → Speaker.begin()
3. Вызывать SD.begin() раньше SPI.begin(40,39,14,12).
4. Держать Wi-Fi включённым во время записи. На батарее это роняет карту.
5. Понижать версии библиотек: M5Cardputer 1.1.0+, M5Unified 0.2.9+, M5GFX 0.2.10+.
   Ниже — устройство не заведётся, причём молча, без ошибки.
6. Переходить на pioarduino / Arduino 3.x. Там сломан захват звука.

## Что значит «готово»
Собралось — это не готово. Готово — это когда прошли /check на живом
устройстве, включая проверку на батарее (не на USB).

## Матчасть
Подробности в docs/CARDPUTER-ADV-FIRMWARE.md. Перед правками аудио,
карты памяти, питания или клавиатуры открой соответствующий раздел
этого файла целиком, а не полагайся на общие знания об ESP32.

---
paths:
  - "src/audio/**"
---

# Аудио на Cardputer ADV

Микрофон и динамик — это один чип ES8311, и они делят одни и те же провода.
Работать одновременно не могут. Отсюда строгий порядок вызовов
(см. памятку, пункт 2). Побочный эффект: пикнуть во время записи нельзя.

Пишем 16 кГц моно. Не 44100: файл получается почти в три раза меньше,
меньше нагрузка на карту и на Wi-Fi, ниже пиковый ток. Качество не страдает —
распознавание речи всё равно приводит звук к 16 кГц.

Если запись слишком тихая — поднимать усиление микрофона (регистр 0x16,
значения 0x03–0x05) уже ПОСЛЕ вызова Mic.begin(). Не крутить magnification:
это программное усиление, оно поднимает шум вместе с голосом.

---
description: Собрать и прошить Cardputer ADV
disable-model-invocation: true
---

PIO=~/.platformio/penv/bin/pio
PORT=/dev/cu.usbmodem2101

1. Собери: `$PIO run`
2. Дождись порта — он пропадает после ребута, это норма, не ошибка:
   `for i in $(seq 1 12); do [ -e $PORT ] && break; sleep 1; done`
3. Залей: `$PIO run -t upload --upload-port $PORT`
4. Снова дождись порта тем же циклом.
5. НЕ запускай `pio device monitor` — он зависает. Читай лог отдельным
   скриптом с таймаутом.
6. Скажи, что прошилось и что написано в первых строках лога.

Если устройство не отвечает: выключатель OFF → зажать кнопку G0 →
воткнуть USB → отпустить. Это делает человек — попроси и жди.

---
description: Проверка новой сборки на живом устройстве
disable-model-invocation: true
---

Проверь по порядку. Пункты со значком 👤 может подтвердить только человек —
останавливайся, спрашивай результат и жди ответа. Не додумывай и не отмечай
их выполненными сам.

1. 👤 Прошилось, устройство загрузилось, на экране видна строка загрузки,
   паники нет.
2. 👤 Карта памяти определилась: тест записи проходит, свободное место
   показывает адекватную цифру.
3. 👤 Запись 10 секунд на 16 кГц: файл появился на карте, открывается,
   звук слышно. Отправка на сервер прошла целиком — в логе сервера
   должно быть «complete», а не «truncated».
4. 👤 То же самое на рабочей частоте записи, если она отличается.
5. 👤 Три записи подряд без перезагрузки — карта не отваливается.
6. 👤 Запись во время отправки предыдущего файла (если это уже реализовано) —
   следим за памятью, устройство не перезагружается.
7. 👤 ВСЁ ТО ЖЕ САМОЕ на батарее, а не на USB. Это главный пункт: на USB
   проблемы с питанием не проявляются. Не пропускать и не предлагать
   пропустить.
8. 👤 Если на карте лежат другие прошивки — они по-прежнему грузятся.
   Перед экспериментами с картой напомни сделать резервную копию
   файла настроек.

Если хоть один пункт не прошёл — задача не закрыта. Не пиши «готово»,
опиши, что именно сломалось, и предложи гипотезу.

{
  "permissions": {
    "allow": ["Bash(~/.platformio/penv/bin/pio run*)"],
    "ask":   ["Bash(~/.platformio/penv/bin/pio run -t upload*)"],
    "deny":  ["Bash(rm -rf *)", "Bash(diskutil eraseVolume*)"]
  },
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{ "type": "command", "command": ".claude/hooks/guard.sh" }]
    }]
  }
}

#!/usr/bin/env bash
content=$(cat | jq -r '.tool_input.content // .tool_input.new_string // ""')

if echo "$content" | grep -q 'BOARD_HAS_PSRAM'; then
  echo "Стоп: у этого чипа нет PSRAM, флаг всё ломает." >&2
  exit 2
fi

if echo "$content" | grep -qE 'M5Cardputer\s*@\s*1\.0'; then
  echo "Стоп: старая версия библиотеки — клавиатура работать не будет." >&2
  exit 2
fi
exit 0

mkdir -p .claude/{rules,skills,hooks} docs
cp CARDPUTER-ADV-FIRMWARE.md docs/
claude

1. /init — Claude сам просмотрит проект и набросает черновик CLAUDE.md. Замени его содержимое разделом «Шаг 1» отсюда.
2. Попроси: «прочитай docs/CARDPUTER-ADV-FIRMWARE.md и разнеси матчасть по файлам в .claude/rules — отдельно распиновка, аудио, карта памяти, сборка; каждому пропиши paths».
3. Попроси написать команды /flash и /check и хук guard.sh по описанию выше.