sdd-sync

name	sdd:sync
workflow_step	2
description	Инициализация и синхронизация субмодулей. Вызывать после клонирования репы (субмодули ещё не инициализированы), после изменения веток в manifest.yaml, или когда submodule пути показывают detached HEAD.

sdd:sync — синхронизация субмодулей

Вход

Нет обязательных параметров. Опционально: PATH=<submodule-path> для обновления одного субмодуля.

Алгоритм

Шаг 0: проверка git-репозитория

git rev-parse --git-dir 2>/dev/null

Если команда завершается с ненулевым кодом — остановить выполнение:

ERROR: not a git repository.
Clone first: git clone <repo-url> && cd <repo-dir>

Дальнейшие шаги не выполняются.

Режим 1: Полная синхронизация (без PATH)

1. Определить состояние субмодулей:

   git submodule status
   

   • Если строки начинаются с - → субмодули не инициализированы
   • Если строки начинаются с + или пустой → инициализированы, но могут быть устаревшими
   • Если строки начинаются с U → merge-конфликт

2. Если обнаружены неинициализированные субмодули:

   make setup
   

   (выполняет git submodule update --init --recursive + настройку hooks)

3. В любом случае синхронизировать все субмодули до версий из .gitmodules:

   git submodule update --remote --merge
   

4. Проверить результат:

   git submodule status
   

   Убедиться, что нет строк с - или U.

Режим 2: Один субмодуль (с PATH)

git submodule update --remote --merge -- <PATH>

После — показать статус только для указанного субмодуля.

Обработка особых случаев

При каждом stop-условии ниже — перед выводом сообщения пользователю записать error-лог через Bash tool:

TS=$(date +%Y%m%dT%H%M%S)
mkdir -p ".logs/sync"
cat > ".logs/sync/sync-${TS}-error.md" << 'EOF'
---
skill: sdd:sync
timestamp: <TS>
---

## Errors

- **step:** <шаг, где произошла ошибка>
  **what:** <текст ошибки>
  **why:** <ожидалось / получено>
  **reproduce:** <точная Bash-команда или входные данные>
EOF

• not a git repository: остановиться на шаге 0 с сообщением ERROR: not a git repository и инструкцией по клонированию. make setup не вызывать.
• detached HEAD: после git submodule update --remote --merge субмодуль должен быть на ветке из .gitmodules. Если detached HEAD сохраняется — предложить git -C <path> checkout <branch>.
• Merge-конфликт (U): не пытаться разрешить автоматически; показать инструкцию по ручному разрешению.
• Ошибка сети: показать ошибку. Определить хост репозитория через git remote get-url origin, извлечь hostname и предложить ssh -T git@<hostname> для проверки SSH-доступа. Если remote недоступен или URL не в SSH-формате — предложить проверить сетевой доступ к хосту репозитория.

Вывод

Статус субмодулей: X инициализированы, Y не инициализированы
Выполняю: make setup  ← (только если есть неинициализированные)
Выполняю: git submodule update --remote --merge
OK: все субмодули синхронизированы

Post-completion hook

После успешного завершения синхронизации автоматически запусти скилл sdd:audit — без дополнительного запроса пользователя. При ошибке (make завершился с ненулевым кодом, merge-конфликт, недоступность сети, detached HEAD) sdd:audit NOT вызывается.