Jednorázová kontrola verze CLI může roztočit restartovací smyčku
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Lokální služba po restartu krátce zmizela a správce procesů ji opakovaně spouštěl. Log uváděl pouze selhání příkazu agent-cli --version, přestože stejný příkaz vzápětí ručně několikrát prošel.
Root cause
Sekce “Root cause”Startup gate spouštěla kontrolu identity právě jednou:
const result = await runBounded({ executable, args: ['--version'] });if (result.exitCode !== 0) throw new Error('version check failed');Externí CLI může přechodně selhat kvůli souběžnému startu, krátkodobě nedostupnému lokálnímu prostředku nebo jiné inicializaci. Jediný pokus nerozlišil přechodnou chybu od trvale chybné binárky. KeepAlive pak z jedné falešně negativní kontroly vytvořil viditelnou restartovací smyčku.
Fix
Sekce “Fix”Kontrola zůstala fail-closed, ale dostala malý pevný počet pokusů a krátkou prodlevu:
for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt += 1) { const result = await runBounded({ executable, args: ['--version'] }); if (result.exitCode === 0 && result.stdout.trim()) return result.stdout.trim(); if (attempt < MAX_ATTEMPTS) await delay(RETRY_DELAY_MS);}throw new Error('version check failed after bounded attempts');Regresní test používá stub, který první pokusy záměrně odmítne a poté vrátí platnou verzi. Trvale nefunkční nebo nespustitelná binárka dál zastaví službu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Hledej startup kontroly externích procesů, které po jediném nenulovém návratu okamžitě ukončí dlouho běžící službu.
- Anti-pattern:
spawn --versionjednou + proces manager s automatickým restartem bez rozlišení dočasné a trvalé chyby. - Lepší přístup: Několik bounded pokusů, přesná finální diagnostika a test oddělující přechodné selhání od trvalé neplatnosti.
Sister bugs / související
Sekce “Sister bugs / související”Příbuzná je race mezi odstraněním a opětovným zavedením macOS LaunchAgentu: i tam je krátký přechodný stav bezpečně řešen bounded retry místo nekonečného čekání.