migrate

/polisade:migrate — Schema Migration

Обновляет PROJECT_STATE.json и knowledge.json до текущей версии схемы. Добавляет недостающие поля, создаёт artifactIndex, устанавливает schemaVersion. Также добавляет testing.strategy в knowledge.json если отсутствует.

VCS bootstrap: если settings.vcsProvider отсутствует — добавляет "github". Если PM вручную переключил провайдер на bitbucket-server — создаёт .env.example (reference) и .env (stub для заполнения токенов) из plugin templates, добавляет некомментированную .env в .gitignore. Заполненный .env не перезаписывается (идемпотентность). ⚠️ Под GigaCode Filesystem Guard сам скрипт миграции может не запуститься (install-dir read-protected, #127) — тогда .env/.env.example автоматически не появятся; PM создаёт .env вручную из .env.example (cp .env.example .env) и заполняет токены (#131).

Использование

/polisade:migrate            # Dry-run — показать что изменится
/polisade:migrate --apply    # Показать diff и применить после подтверждения

Алгоритм

1. Определить корень проекта.
2. Запустить миграцию в режиме dry-run:

python3 {plugin_root}/scripts/polisade_migrate.py {project_root}

1. Распарсить JSON-ответ, показать список миграций пользователю.
2. Если пользователь подтверждает — применить:

python3 {plugin_root}/scripts/polisade_migrate.py {project_root} --apply --yes

Формат вывода

polisade_migrate.py всегда печатает один JSON-документ на stdout (контракт OPS-108 — json.loads(stdout) обязан проходить). PM-friendly сообщения и подтверждение интерактивного prompt'а уходят на stderr. Полная таблица контрактов — docs/config-reference.md § Script JSON output contracts.

Если схема актуальна

{
  "status": "up_to_date",
  "schemaVersion": 7,
  "polisadeVersion": "3.0.0",
  "touched_paths": [],
  "stage_paths": []
}

Если нужна миграция (dry-run)

{
  "status": "migration_needed",
  "current_schema": 3,
  "target_schema": 6,
  "migrations": [
    "Update schemaVersion: 3 → 7",
    "Add settings.debt.autoCreateTask: true (preserve legacy auto-TASK behavior)"
  ],
  "touched_paths": [".state/PROJECT_STATE.json"],
  "stage_paths": [".state/PROJECT_STATE.json"],
  "dry_run": true
}