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

.agents/references/known-issues.md

@@ -46,4 +46,46 @@
 
 ## 프로젝트별 이슈
 
-(세션 진행 중 발견되는 이슈를 여기에 추가)
+### [2026-03-08] Python 실행 — Windows Store 리다이렉트
+- **증상**: `python` 명령이 Microsoft Store 페이지를 열거나 빈 출력 반환
+- **원인**: Windows 기본 `python`이 App Execution Alias(Microsoft Store 리다이렉트)로 설정됨
+- **해결**: **`C:\ProgramData\miniforge3\envs\gravity_web\python.exe`** 전체 경로 사용
+- **주의**: 워크플로우 내 모든 `python` 호출을 전체 경로로 교체할 것
+
+### [2026-03-08] PowerShell inline Python — 따옴표 깨짐
+- **증상**: `python -c "import json; ..."` 또는 파이프 `| python -c "..."` 에서 SyntaxError
+- **원인**: PowerShell이 쌍따옴표/홑따옴표/중괄호를 자체 해석하여 Python에 전달 시 깨짐
+- **해결**: `.py` 스크립트 파일을 `/tmp/`에 생성 후 전체 경로 Python으로 실행
+- **주의**: **절대** `python -c` 인라인 실행 금지. `curl.exe ... | python -c` 조합은 100% 실패
+
+### [2026-03-08] 서버 포트 — EADDRINUSE
+- **증상**: `node index.js` 시작 시 `Error: listen EADDRINUSE: address already in use :::3300`
+- **원인**: 이전 서버 프로세스가 종료되지 않은 상태에서 재시작
+- **해결**: 서버 시작 전 기존 프로세스를 포트 기반으로 종료
+  ```powershell
+  $p = Get-NetTCPConnection -LocalPort 3300 -ErrorAction SilentlyContinue
+  if ($p) { Stop-Process -Id $p.OwningProcess -Force; Start-Sleep 1 }
+  ```
+- **주의**: `Stop-Process -Name node` 는 다른 Node 프로세스까지 죽일 수 있으므로 포트 기반 종료 권장
+
+---
+
+## Antigravity SDK/API 제한사항
+
+### [2026-03-08] Trajectory API — 341개 제한, 페이지네이션 불가
+- **증상**: `GetCascadeTrajectory` RPC가 항상 처음 341개 스텝만 반환
+- **원인**: API 서버 측 하드 제한. `startStepIndex`, `endStepIndex`, `stepIndexRange` 파라미터 모두 무시됨
+- **해결**: 서버 사이드 `message-accumulator.js`로 cascades diff를 누적하여 step 341+ 이후 메시지 보존
+- **주의**: trajectory만으로는 전체 대화 히스토리를 표시할 수 없음
+
+### [2026-03-08] Cascade API — 명령 승인 대기 상태 미제공
+- **증상**: `run_command(SafeToAutoRun=false)` 대기 중에도 cascade status는 `CASCADE_RUN_STATUS_RUNNING` 유지
+- **원인**: Cascade API에 command approval 관련 별도 필드 없음
+- **해결**: stepCount 변화 정체(6초)로 추정 + 헤더에 영구적 승인/거절 버튼 추가
+- **주의**: 자동 감지는 정확하지 않음. 사용자가 직접 버튼 클릭이 더 신뢰성 있음
+
+### [2026-03-08] broadcastToAll 미정의 버그
+- **증상**: bridge WS 이벤트가 브라우저에 전혀 전달되지 않음 (실시간 업데이트 불가)
+- **원인**: `index.js`에서 `broadcastToAll()` 함수를 호출하지만 정의가 누락되어 있었음
+- **해결**: `broadcastToAll` 함수 정의 추가 (wsClients 순회하여 JSON 전송)
+- **주의**: JS는 미정의 함수 호출 시 런타임 에러만 발생하고 서버는 죽지 않아 발견이 어려움