claude-harness/openspec/changes/dsh-superpowers-git/proposal.md

Proposal: install сам тянет свежий superpowers с git

Issue: #67. Связано: #49 (закрыт), #48 (роадмап), change dsh-install-source. Ответ владельца 24.10.2026: «а давай инстал будет тащить сам свежую версию с гита».

Why

После #49 install-time источник задаётся явно: --superpowers-from, $DSH_SUPERPOWERS_SOURCE или ручной клон в ~/.dsh/superpowers. Это снимает зависимость от ~/.claude, но перекладывает получение источника на человека и не обновляет его: клон, сделанный полгода назад, остаётся «свежим» навсегда, а WARN: legacy superpowers source на машине владельца так и висит, потому что пиннинга нет.

Владелец хочет, чтобы dsh/install.sh --skills сам получал свежий superpowers: первый запуск — клон, следующие — обновление. Явные флаги остаются для офлайна, зеркал и отладки и сеть не трогают.

What Changes

• git — источник по умолчанию. --skills клонирует https://github.com/obra/superpowers в $DSH_HOME/superpowers (depth 1), если клона нет, и обновляет fetch --depth 1 + reset --hard FETCH_HEAD, если есть. URL переопределяется $DSH_SUPERPOWERS_REPO (зеркала, локальные репозитории в тестах).
• Порядок источников: явный источник (--superpowers-from, $DSH_SUPERPOWERS_SOURCE) → git-клон (обновить/создать) → legacy-кэш Claude Code → legacy ~/.claude/skills. Ручная копия ~/.dsh/superpowers без .git используется как есть с WARN (совместимость с #49).
• Сеть и ошибки. Нет сети при существующем клоне — WARN, работа из кэша. Нет сети, нет клона, нет других источников — FAIL с кодом 1 и подсказкой --superpowers-from. Оборванный клон не оставляется на диске.
• --check остаётся офлайновым: не клонирует и не обновляет, показывает ok: superpowers source (<path>, git <sha>) для git-клона, WARN для ручной копии без .git, legacy и «нет источника» — как в #49.
• Тесты без сети: локальный git-репозиторий через DSH_SUPERPOWERS_REPO (file://), проверка первого клона, обновления до нового коммита, офлайна и --check.
• Документация. README/PORT: quick start без ручного клона, офлайн-путь, DSH_SUPERPOWERS_REPO, --check с sha.

Non-goals

• Вендоринг superpowers в репозиторий — отклонён в #49 (D-1) и остаётся отклонённым.
• Пиннинг тега/коммита и проверка подписи: «свежая версия» = последний коммит default-ветки; воспроизводимость установки обеспечивается глубиной 1 и записанным sha в выводе, а не неизменностью источника.
• Субмодули и LFS в клоне superpowers.
• Обновление ролей/локальных скиллов из сети: они по-прежнему из репозитория обвязки.