first cycle lab release

docs/phase3-results.md

@@ -0,0 +1,41 @@
+# Phase 3: mod wrappers
+
+Phase 3 завершена: `mcpack add`, `remove`, `update <mod>`, `update --all`
+делегируют операции закреплённому packwiz. Config/путь source/бинарник
+проверяются до вызова; оригинальные prompts, stdout/stderr и exit code
+packwiz сохраняются. Add поддерживает штатные Modrinth version URLs.
+
+## Реальная integration-проверка
+
+`bash scripts/verify-phase3.sh` успешно выполнен в тестовом clone
+`.tools/phase3-check.m9vdq6/clone`. Лог: `.tools/phase3-integration.log`;
+diff source: `.tools/phase3-check.m9vdq6/source-changes.diff`.
+
+1. Remove Backpacks удалил `.pw.toml` и обновил index.
+2. Add version URL создал metadata для 3.26.6.2174 / `pJxNzk4X`;
+   уже установленный Core сохранился.
+3. Update одного мода заменил Backpacks на 3.26.7.2182 / `Igmp9PwW`.
+4. Для update --all снова установлена старая версия. Команда реально
+   обновила её, после чего metadata вернулась к 3.26.7.2182.
+5. После каждого состояния успешен full build: `phase3-remove`,
+   `phase3-add`, `phase3-update`, `phase3-all`. Для всех прошли Compose
+   config и SHA256SUMS, source metadata осталась консистентной.
+
+Тестовые versions менялись только в clone, чтобы сохранить неизменяемые
+готовые релизы. Основной pack остаётся 0.0.4 с прежними тремя модами;
+активный сервер и мир не изменялись и не перезапускались.
+
+## Автоматические проверки
+
+`npm test`: 16/16 успешны. Помимо 12 build-тестов проверены:
+
+- точное отображение команд/аргументов packwiz, включая --all и --yes;
+- отклонение неверных комбинаций до запуска tool;
+- выбор source directory через config при вызове из другого cwd;
+- literal search argv без shell execution;
+- сохранение stdout/stderr и тестового exit code 17;
+- отказ при изменённом hash packwiz.
+
+Bash/Node syntax и `git diff --check` успешны. Реальные GUI/server проверки
+новых модов не входят в Phase 3; wrappers меняют source, не deployment.
+Пользовательские команды и контракт — [mods.md](mods.md).