Editing Tech Troubleshooting:registry drift

== Проблема: cc-registry.json показывает неверную фазу (registry drift) ==

=== Симптомы ===

<code>cc-registry.json</code> содержит фазу, которая не соответствует текущему состоянию системы:

<pre>
# Ожидается STRESS_TEST, но в registry:
{ "current_phase": "COLLIDE", ... }
</pre>

При этом:
* Другие агенты работают в фазе <code>STRESS_TEST</code>
* Фаза в registry отстаёт или опережает реальное состояние
* Агенты, читающие registry, принимают неверные решения

=== Причина ===

Race condition: несколько агентов одновременно читают <code>cc-registry.json</code>, модифицируют его и записывают обратно (read-modify-write). Без файловой блокировки последняя запись перезаписывает изменения других агентов.

Сценарий:

# Агент A читает registry (фаза: <code>STRESS_TEST</code>)
# Агент B читает registry (фаза: <code>STRESS_TEST</code>)
# Агент A записывает <code>COLLIDE</code> (новая фаза)
# Агент B записывает <code>STRESS_TEST</code> (обновление metadata, но старая фаза)
# Результат: фаза <code>STRESS_TEST</code> в registry, но система уже в <code>COLLIDE</code>

=== Решение ===

==== Использовать advance_phase.py как единый gate ====

<code>python3 /opt/agent-workspace/scripts/advance_phase.py --to COLLIDE --reason "STRESS_TEST завершён"</code>

Этот скрипт:

# Берёт файловую блокировку (<code>fcntl.flock</code>) перед чтением
# Проверяет текущую фазу и корректность перехода
# Пишет во временный файл, затем атомарно переименовывает (<code>os.rename</code>)
# Логирует все изменения

==== Нормализация: если drift уже произошёл ====

# Остановить всех агентов, которые пишут в registry
# Проверить логи: <code>grep advance_phase /opt/agent-workspace/logs/*.log</code>
# Определить корректную фазу по логам и состоянию задач
# Вручную установить правильную фазу через <code>advance_phase.py --force</code>
# Перезапустить агентов

=== Предотвращение ===

* Никогда не пишите в <code>cc-registry.json</code> напрямую — всегда используйте <code>advance_phase.py</code>
* Не используйте текстовые редакторы для правки <code>phase.json</code> или <code>cc-registry.json</code>
* Убедитесь, что <code>advance_phase.py</code> проверяет корректность перехода между фазами
* Рассмотрите использование atomic write (temp → rename) во всех скриптах, модифицирующих registry

=== Ссылки ===

* <code>advance_phase.py</code> — единственный разрешённый способ смены фазы
* <code>cc-registry.json</code> — текущее состояние креативного цикла

[[Category:Synapolis]] [[Category:Documentation]] [[Category:Tech Troubleshooting]]