Files
gravity_web/docs/devlog/entries/20260308-001.md
Variet 1060476113 feat(server,frontend): real-time sync architecture with message accumulator
- Add message-accumulator.js: cascades diff-based message accumulation
- Add 3-second cascade polling with broadcastToAll (was undefined!)
- Add /api/bridge/approve endpoint: tries accept/reject Step→Command→Terminal
- Add persistent approve/reject buttons in chat header toolbar
- Frontend: loadSessionMessages (trajectory + accumulated), applyNewMessages (WS push)
- Status change detection: _prevStatusKey tracking prevents unnecessary re-renders
- actionInProgress flag prevents DOM replacement during button fetch
- Known issues: Trajectory 341 hard limit, Cascade no command-approval state
2026-03-08 14:05:59 +09:00

31 lines
1.4 KiB
Markdown

# 실시간 동기화 아키텍처 구현
- **시간**: 2026-03-08 08:42~13:58
- **Commit**: `pending`
- **Vikunja**: #251 → done
## 결정 사항
### Trajectory API 한계 → Message Accumulator 패턴
- Trajectory API가 341개로 하드캡, 페이지네이션 파라미터 무시됨
- Cascades API가 최신 task/notify만 제공 (1개씩)
- **해결**: 서버사이드 `message-accumulator.js`로 cascade 스냅샷을 3초마다 diff하여 새 메시지 누적 저장
- 초기 로드: trajectory(341) + accumulated messages 합산
### 실시간 Push vs Polling
- Bridge WS 이벤트(step_changed)에 의존만으로는 누락 발생 가능
- **3초 interval polling**을 백업으로 추가하여 안정성 보장
- WS 이벤트 + polling 이중 구조
### 승인 버튼: 자동 감지 vs 수동
- Cascade API에 command approval 대기 필드 없음 (status는 항상 RUNNING)
- stepCount 정체 감지(6초)로 추정 시도 → 불안정
- **최종 결정**: 헤더에 영구적 ✅ 승인 / ❌ 거절 버튼 추가 (always accessible)
## 미완료
- [ ] 승인 버튼 자동 감지 안정화 (isWaiting 정확도 개선)
- [ ] inline 승인 버튼(chat 내부)과 헤더 버튼 간 상태 동기화
- [ ] 대화 중간 메시지 누락 문제 (서버 재시작 시 accumulator 초기화)
- [ ] isWaiting→isRunning 전환 시 DOM 리렌더링으로 인한 스크롤 점프 미세 조정