설정 변경이 시스템을 무너뜨릴 때

pkill -f clawdbot-gateway
clawdbot gateway run

clawdbot config set gateway.reload.mode hot

에러 메시지: AbortError: This operation was aborted
              ↑
         무엇이 abort 됐나?

설정 변경 후 크래시
              ↑
         왜 설정 변경만 해도?

tail -50 ~/.clawdbot/logs/gateway.err.log

[reload] config change requires gateway restart (meta.lastTouchedAt)
[clawdbot] Unhandled promise rejection: AbortError: This operation was aborted

1. 사용자: "TTS 음성을 변경"
   ↓
2. 설정 저장됨
   ↓
3. meta.lastTouchedAt 타임스탬프 자동 업데이트 (시스템이 자동)
   ↓
4. config watcher가 파일 변경 감지
   ↓
5. buildGatewayReloadPlan()에서 변경 경로 분석
   - "messages.tts.elevenlabs.voiceId" → reload rule 있음 ✓
   - "meta.lastTouchedAt" → reload rule 없음 ❌
   ↓
6. 결론: "재시작이 필요하다"
   ↓
7. SIGUSR1 신호로 graceful restart 시도
   ↓
8. 진행 중인 HTTP 요청들이 abort됨
   ↓
9. AbortError → unhandled rejection handler에 도달
   ↓
10. process.exit(1) → 크래시

const BASE_RELOAD_RULES_TAIL = [
+   { prefix: "meta", kind: "none" },  // ← 추가
    { prefix: "identity", kind: "none" },
    { prefix: "wizard", kind: "none" },
];

export function installUnhandledRejectionHandler() {
    process.on("unhandledRejection", (reason, _promise) => {
        if (isUnhandledRejectionHandled(reason))
            return;
 
+       // Graceful shutdown 중 발생하는 AbortError는 정상
+       if (reason instanceof Error && reason.name === "AbortError") {
+           console.error("[clawdbot] AbortError during shutdown (ignored):", reason.message);
+           return;  // ← 프로세스 종료 안 함
+       }
 
        console.error("[clawdbot] Unhandled promise rejection:", formatUncaughtError(reason));
        process.exit(1);
    });
}

설정 파일 변경 감지
    ↓
어떤 경로가 변경됐는가? (diffConfigPaths)
    ↓
그 경로의 reload rule은?
    ├─ kind: "none" → 재시작 불필요
    ├─ kind: "hot" → hot reload
    └─ (rule 없음) → 재시작 필수
    ↓
필요한 경우 SIGUSR1 신호 전송

1. SIGUSR1 신호 수신
2. 새로운 요청은 받지 않음
3. 진행 중인 요청이 끝날 때까지 대기
4. (또는 timeout이면 abort)
5. 모든 연결 종료 (abort)
6. 프로세스 재시작

// ❌ 나쁜 구조
config = {
    settings: {...},
    metadata: {...},  // 섞여있음
}
 
// ✅ 좋은 구조
config = {
    settings: {...},  // 비즈니스 설정
    metadata: {...},  // 시스템 메타데이터
    // 둘의 변경이 다르게 처리됨
}

// ❌ 너무 일반적
process.on("unhandledRejection", () => process.exit(1));
 
// ✅ 맥락을 고려
process.on("unhandledRejection", (reason) => {
    if (isExpectedDuringShutdown(reason))
        return;  // 로그만 남기고 진행
 
    if (isCritical(reason))
        process.exit(1);  // 치명적이면 종료
});

// ❌ 수동으로 rule 작성
const RELOAD_RULES = [
    { prefix: "a", kind: "none" },
    { prefix: "b", kind: "hot" },
    // ... 언젠가 누군가 새로운 항목 추가하는데 rule 빼먹을 수 있음
];
 
// ✅ 검증 로직 추가
function validateReloadRules(config: Config, rules: ReloadRule[]) {
    const configPrefixes = Object.keys(config);
    const rulePrefixes = rules.map(r => r.prefix);
 
    const missing = configPrefixes.filter(p => !rulePrefixes.includes(p));
    if (missing.length > 0) {
        throw new Error(`Missing reload rules for: ${missing.join(', ')}`);
    }
}

# 설정 변경
clawdbot gateway config patch {
  "messages": {
    "tts": {
      "elevenlabs": {
        "voiceSettings": { "stability": 0.7 }
      }
    }
  }
}

✅ 게이트웨이 재시작 안 됨
✅ 설정 변경 반영됨
✅ 진행 중이던 작업 계속됨

# 게이트웨이 재시작 (수정된 파일 로드)
pkill -f clawdbot-gateway
clawdbot gateway run --bind loopback --port 18789 &

/usr/local/lib/node_modules/clawdbot/dist/
├── gateway/config-reload.js      ← 우리가 수정
└── infra/unhandled-rejections.js ← 우리가 수정

clawdbot update
# 또는
curl -fsSL https://molt.bot/install.sh | bash