sync

/polisade:sync — Sync State from Artifact Files

Сканирует файлы артефактов, пересобирает derived-поля в PROJECT_STATE.json (readyToWork, inProgress, blocked, waitingForPM, inReview, artifactIndex).

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

/polisade:sync             # Показать diff (dry-run по умолчанию)
/polisade:sync --apply     # Показать diff и записать после подтверждения

Алгоритм

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

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

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

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

Для неинтерактивного использования (CI, pipe):

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

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

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

Если всё синхронизировано

{
  "status": "in_sync",
  "artifacts_scanned": 12,
  "touched_paths": [],
  "stage_paths": []
}

Если обнаружен drift (dry-run)

{
  "status": "drift_detected",
  "artifacts_scanned": 12,
  "changes": [
    {"field": "readyToWork", "added": ["TASK-005"], "removed": ["TASK-003"]},
    {"field": "inProgress", "added": ["TASK-003"]},
    {"field": "artifactIndex", "added": ["TASK-005"], "changed": ["TASK-003"]}
  ],
  "touched_paths": [".state/PROJECT_STATE.json", ".state/counters.json"],
  "stage_paths": [".state/PROJECT_STATE.json", ".state/counters.json"],
  "dry_run": true
}

После --apply --yes

{
  "status": "applied",
  "artifacts_scanned": 12,
  "changes": [{"field": "readyToWork", "added": ["TASK-005"]}],
  "touched_paths": [".state/PROJECT_STATE.json", ".state/counters.json"],
  "stage_paths": [".state/PROJECT_STATE.json", ".state/counters.json"]
}