reinforce: create wiki documents for autonomous engine architecture and resilience audit

10_Wiki/Projects/Datacollector_MAC_Engine_Audit.md

@@ -0,0 +1,61 @@
+---
+id: datacollector-mac-engine-audit-2026-05-11
+title: Datacollector_MAC Engine Audit (2026-05-11)
+category: 10_Wiki/Projects
+status: verified
+canonical_id: self
+aliases: [엔진 안정성 감사 리포트, Datacollector Resilience Audit]
+source_trust_level: A
+confidence_score: 1.0
+created_at: 2026-05-11
+updated_at: 2026-05-11
+last_reinforced: 2026-05-11
+verification_status: validated
+applied_in:
+  - path: /Volumes/Data/project/Antigravity/Datacollector_MAC/src/lib/engine.ts
+  - path: /Volumes/Data/project/Antigravity/Datacollector_MAC/src/lib/diagnostics.ts
+tags: [audit, datacollector, resilience]
+---
+
+# [[Datacollector_MAC Engine Audit (2026-05-11)]]
+
+## 📌 감사 개요
+
+`Datacollector_MAC` 프로젝트의 핵심 엔진(`engine.ts`)과 진단 레이어(`diagnostics.ts`)의 실제 코드를 전수 조사하여, 자율 에이전트의 안정성과 결함 허용 능력을 평가한 기록입니다.
+
+## 📖 감사 결과 (Grounded Findings)
+
+### 1. 이미 구현된 강점
+- **영속성 기반 복구**: Zustand `persist` 미들웨어를 통해 큐와 상태가 로컬 스토리지에 보존됨. 브라우저 종료 후 재기동 시 `paused` 상태에서 안전하게 재개 가능함.
+- **다단계 장애 복구**: 인증 실패 시 자동 Re-auth, 일반 에러 시 3단계 지수 백오프, 치명적 장애 시 백엔드 브릿지 서버 재시작 오케스트레이션이 완비됨.
+- **결함 격리**: 서킷 브레이커 패턴이 전 API 호출에 적용되어 외부 장애가 엔진으로 전파되는 것을 차단함.
+
+### 2. 발견된 취약점 및 개선 권고 (Action Items)
+- **이중 보호 간섭**: 서킷 브레이커와 엔진 백오프 카운터가 독립적으로 작동하여, 서킷 OPEN 시 실제 네트워크 시도 없이 재시도 횟수만 소모되는 현상 발견.
+  - *권고*: 엔진 에러 핸들러에서 `[CIRCUIT OPEN]` 메시지 감지 시 카운터를 소모하지 않고 대기하도록 수정.
+- **태스크 메타데이터 부족**: 작업 실패 시 어떤 단계(`pipelineStage`)에서 실패했는지가 큐 아이템에 구조화되어 저장되지 않음.
+  - *권고*: `QueueItem` 인터페이스에 `lastFailure` 객체 추가.
+- **Watchdog 수동성**: 현재 Watchdog(`kickIfStalled`)이 외부 트리거에 의존함.
+  - *권고*: 엔진 기동 시 `setInterval` 기반의 자동 Watchdog 활성화.
+
+## 💻 적용된 지식 모델
+
+- [[System_Resilience_and_Fault_Tolerance]]
+- [[Autonomous_Queue_Processing_Engine]]
+
+## 🧪 검증 결과
+
+- **정보 상태:** validated
+- **검증 근거:** `src/lib/engine.ts` 및 `src/lib/diagnostics.ts` 소스 코드 정밀 분석 완료.
+- **효과:** 현재 시스템은 고부하 환경에서도 세션을 복구하고 작업을 지속할 수 있는 충분한 수준의 Resilience를 확보하고 있음.
+
+## 🔗 지식 연결 (Graph)
+
+- **Parent:** [[10_Wiki/Projects]]
+- **Related:** [[Datacollector_MAC]], [[Knowledge_Engine_Architecture]]
+
+## 🕓 변경 이력 (Changelog)
+
+| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
+|------|-----------|-----------|--------|
+| 2026-05-11 | 실제 코드 분석 기반의 감사 리포트 생성 | CREATE | A |