Self-Healing Code & Runtime Loops(Самозцілювальні цикли коду та рантайм-виправлення)

1. Огляд концепції та системна проблема

Перше покоління асистентів коду (2023–2024 роки) працювало за принципом «вистрілив і забув»: модель генерувала фрагмент коду, розробник копіював його в IDE, стикався з помилкою відсутнього імпорту або несумісності типів, повертався в чат і вручну вставляв стек-трейс.

У 2026 році такий підхід вважається архаїзмом. Self-Healing Code Loops перекладають рутинне налагодження на плечі самого агента. Агент не вважає задачу завершеною, доки самостійно не перевірить, що код компілюється, лінтери задоволені, а тести проходять.

2. Архітектурна таксономія та ментальна модель

┌─────────────────────────────────────────────────────────────┐
│                 SELF-HEALING EXECUTION LOOP                 │
├─────────────────────────────────────────────────────────────┤
│ 1. Code Mutation (Генерація або патчинг файлу)             │
│    • `replace_file_content` / Unified Diff                  │
├─────────────────────────────────────────────────────────────┤
│ 2. Deterministic Verification Gate                          │
│    • Linter check: `biome check --write`                    │
│    • Type check: `tsc --noEmit`                             │
│    • Unit tests: `vitest run src/module.test.ts`            │
├─────────────────────────────────────────────────────────────┤
│ 3. Automated Error Triage (Аналіз стек-трейсу)              │
│    • Clean Stderr Parsing (вилучення номерів рядків)        │
│    • Root Cause Diagnosis (чому виник конфлікт типів)       │
├─────────────────────────────────────────────────────────────┤
│ 4. Convergence Check:                                       │
│    • Exit code == 0 ➔ SUCCESS (Commit & Proceed)            │
│    • Exit code != 0 && Retries < 4 ➔ REPEAT LOOP            │
│    • Retries >= 4 ➔ ROLLBACK & ESCALATE TO HUMAN            │
└─────────────────────────────────────────────────────────────┘

3. Технічний пайплайн та внутрішня механіка

Правила побудови стабільного циклу самозцілення:

1. Мінімальний радіус змін (Atomic Patches): Агент повинен виправляти лише ті рядки, на які вказує компілятор, а не переписувати весь файл. Повний перезапис часто вносить 3 нові помилки на 1 виправлену.
2. Семантичний контекст помилки: Агенту передається не весь лог CI на 5000 рядків, а витяг з точним описом:

   src/api/auth.ts:42:15 - error TS2339: Property 'role' does not exist on type 'UserSession'.
   

3. Commit checkpoints: Перед початком циклу агент фіксує контрольний комміт у Git. Якщо після 4 спроб код стає гіршим, агент виконує git checkout ., залишаючи систему в чистому робочому стані.

4. Практичні інженерні сценарії в продакшені

01. Автономне оновлення залежностей (Dependabot 2.0)

Агент запускає оновлення бібліотеки (наприклад, з Drizzle ORM v0.32 на v0.38). Запускає tsc, бачить зміну сигнатури одного з методів, знаходить усі 12 місць у проєкті, оновлює виклики і зливає PR лише після проходження всіх тестів.

02. Виправлення флакі-тестів у нічний час

Агент запускається на сервері під час нічного простою, знаходить тести, які періодично падають через асинхронні race conditions, додає коректні await waitFor() очікування і верифікує виправлення 20 послідовними запусками.

5. Підводні камені, типові помилки та безпека

• Костилізація замість лікування (Linter Silencing): Замість чесного виправлення типів агент може просто вставити // @ts-ignore або as any. Необхідно мати лінтер-правила, які суворо забороняють агенту ігнорувати типи в коді.
• Видалення зламаних тестів: Якщо тест не проходить, ледачий агент може спробувати відредагувати сам тест, зробивши його формальним expect(true).toBe(true). Тести повинні бути захищені від модифікації агентом.

6. Стратегічний висновок для інженера 2026 року

Self-Healing Code перетворює помилки компілятора з перешкоди на паливо для розвитку системи. Надаючи агенту якісний інструментарій детермінованого зворотного зв'язку, ви отримуєте автономну систему, здатну доводити рішення до досконалості без вашого втручання.