| name | mm-update |
| version | 0.1.0 |
| description | Самообновление mm-системы из удалённого репозитория. mm раздаётся через git clone + register-skills (не npm), поэтому update = git pull свежего mm из origin/main + повторный register-skills + notice о перезапуске Claude Code. Use when user says "обнови mm", "обнови систему", "/mm update", "update mm", "подтяни свежий mm", "проверь обновления mm". |
mm-update — Self-Update from Git Remote
Обновляет mm-систему до свежей версии из origin/main. mm установлен как git-клон с junction'ами в ~/.claude/skills/ — поэтому обновление это git pull репозитория + повторный прогон register-skills, а не пакетный менеджер.
Ничего не сливает и не ребейзит автоматически. При любом расхождении или ошибке --ff-only — стоп с инструкцией разрулить вручную.
Ручной интерактивный аналог фонового scripts/auto-update.py (ff-only, дёргается из mm-resume); git-поток общий — отличие в том, что здесь показывается changelog и спрашивается подтверждение.
Где работать
Корень репозитория mm:
$env:MM_REPO_ROOT если задан;- иначе текущая рабочая директория (
cwd).
Все git-команды и register-skills выполняй из этого корня.
Процесс
0. Guard: это вообще git-репо?
Проверь, что в корне репо (см. «Где работать») есть .git:
Test-Path (Join-Path $repoRoot ".git")
Если .git нет — mm установлен не как git-репо (например, распакован из tarball). Стоп:
❌ mm установлен не как git-репозиторий — обновлять через git нечем.
Обнови через `npx markdown-memory update` или переустанови mm.
Не продолжай. (По смыслу как auto-update.py: «Not a git repository. Skipping update».)
1. Забрать состояние remote
git fetch origin main
Если git fetch упал (нет сети / нет доступа к origin) — стоп: ⚠️ Не удалось связаться с origin. Проверь сеть и доступ к github.com/mworldorg/markdown-memory. Не продолжай.
2. Сравнить версии
Это поле — единый источник версии системы (repo-wide release). Per-skill version: в каждом SKILL.md гранулярны и здесь не сравниваются.
3. Определить расхождение ветки
git rev-list --left-right --count HEAD...origin/main
Вывод — два числа через таб: первое = ahead (коммиты, которые есть локально, но нет в origin/main), второе = behind (коммиты, которые есть в origin/main, но нет локально). Не перепутай порядок.
4. Развилка по (ahead, behind)
| Состояние | Что делать |
|---|
behind=0, ahead=0 | ✅ Уже синхронизировано с origin/main (версия X). Обновлять нечего. → выход |
behind=0, ahead>0 | ℹ️ Локаль впереди origin/main на N коммит(ов) — машина разработчика или есть незапушенное. Обновлять нечего. → выход |
behind>0, ahead=0 | Показать локаль X → remote Y + changelog (см. ниже), спросить y/n, при y → git pull --ff-only |
behind>0, ahead>0 | ⚠️ Ветки разошлись (N локальных / M удалённых). Авто-обновление отменено — разрули вручную. → выход, без pull |
Changelog (только для случая behind>0, ahead=0):
git log --oneline HEAD..origin/main
Покажи список как есть. Никакого CHANGELOG.md — changelog это git-лог между HEAD и origin/main.
Формат запроса подтверждения:
Доступно обновление mm: версия X → Y
Новые коммиты (N):
<hash> <subject>
...
Подтянуть (git pull --ff-only)? (y/n)
При n — стоп: Обновление отменено.
5. Pull (только при подтверждённом behind>0, ahead=0)
git pull --ff-only origin main
Если --ff-only упал (обычно из-за локальных незакоммиченных правок или непушенных дивергентных коммитов):
- Стоп:
❌ git pull --ff-only не прошёл. Вероятно есть локальные правки в репо mm. Закоммить/стэшни их и повтори /mm update, либо разрули вручную.
- Никогда не делай авто-
merge или rebase чтобы «починить» это. Останавливайся и отдавай решение пользователю.
6. Переджанкшенить скиллы
После успешного pull прогони регистрацию (pull мог добавить/переименовать скиллы):
.\scripts\register-skills.ps1
(На macOS/Linux — python3 scripts/register-skills.py.)
Покажи вывод скрипта.
7. Финал
✅ Обновлено до версии Y.
Перезапусти Claude Code, чтобы подхватить обновлённые скиллы.
Скиллы загружаются на старте сессии — без рестарта новые/изменённые скиллы не активируются.
Ограничения
- Не трогать
config.version. Обновление это потребление релиза, не выпуск. Версию проставляет мейнтейнер при релизе, не этот скилл.
- Вендоренные скиллы (
vendor/) не обновляются отдельной логикой. git pull тянет их вместе со всем репо — это нормально. Перевендоринг (обновление до новой upstream-версии ECC и т.п.) — ручная работа мейнтейнера, не часть /mm update.
- Никогда не делать авто-
merge/rebase: ни при расхождении веток (ahead>0 && behind>0), ни при падении --ff-only.
mm-config.local.json и _generated/ — gitignored, git pull их не трогает. Отдельной защиты добавлять не нужно.- Только
origin/main. Других веток/ремоутов скилл не рассматривает.
Финальный отчёт (пример)
🔄 mm-update
Repo root: <path> (из MM_REPO_ROOT | cwd)
fetch origin main: ✅
Версия: локаль 0.6.0 → remote 0.7.0
Состояние: behind 4, ahead 0
Новые коммиты:
a1b2c3d feat: ...
...
git pull --ff-only: ✅ (4 коммита подтянуто)
register-skills.ps1: ✅ (N junction'ов)
Перезапусти Claude Code, чтобы подхватить обновлённые скиллы.
Edge cases
- Нет
$env:MM_REPO_ROOT и cwd не репо mm — git fetch не найдёт origin/упадёт; сообщи, что запускать надо из корня репо mm или задать MM_REPO_ROOT.
- Detached HEAD —
HEAD...origin/main отработает, но pull в detached не имеет смысла; предупреди и не делай pull.
- Нет интернета —
git fetch упадёт на шаге 1, дальше не идём (см. шаг 1).
- Запуск из worktree — git-команды отрабатывают в контексте worktree; если worktree указывает на тот же origin/main — ок. Иначе предупреди.
Что НЕ делать
- Не делать авто-merge/rebase ни при каких обстоятельствах.
- Не править
config.version и любые файлы — только git pull и register-skills.
- Не пушить, не коммитить, не стэшить за пользователя.
- Не молчать при ошибке — всегда показывай конкретную причину и команду фикса.
- Не обновлять с других веток/ремоутов кроме
origin/main.
