Variet
1060476113
- 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
5.3 KiB
5.3 KiB
Known Issues & Lessons Learned — Gravity Web
이 파일은 SSOT(Single Source of Truth)입니다. 디버깅이나 구현 전에 반드시 이 파일을 확인하세요. 세션 종료 시 새로 발견된 이슈를 이 파일에 추가합니다.
공통 이슈
[2026-03-08] PowerShell curl — Invoke-WebRequest 충돌
- 증상:
curl명령이 예상과 다른 응답 형식을 반환 - 원인: PowerShell에서
curl은Invoke-WebRequest의 별칭 - 해결: **
curl.exe**를 명시적으로 사용 - 주의: HTTP 관련 모든 명령에서
curl.exe사용 필수
[2026-03-08] PowerShell npm — 실행 정책 오류
- 증상:
npm run명령이 실행 정책 관련 오류로 실패 - 원인: PowerShell 스크립트 실행 정책이 제한적으로 설정됨
- 해결:
cmd /c npm run dev형식으로 cmd를 통해 실행 - 주의: npm 관련 명령은 항상
cmd /c접두어 사용
[2026-03-08] Vikunja API — POST 시 필드 덮어씌움
- 증상: 태스크 업데이트 시 기존 라벨/설명이 사라짐
- 원인: Vikunja API POST 시 body에 없는 필드를 빈값으로 덮어씀
- 해결:
vikunja_helper.py사용 (GET → 기존 필드 보존 → POST 패턴) - 주의: 절대로
Invoke-RestMethod -Method Post -Body '{\"done\": true}'같은 직접 API 호출 금지
[2026-03-08] PowerShell JSON 파이프 — 이스케이핑 문제
- 증상: PowerShell에서 JSON을 파이프로 전달할 때 따옴표/특수문자가 깨짐
- 원인: PowerShell의 이스케이핑 규칙이 bash와 다름
- 해결: JSON 처리가 필요하면
.py스크립트로 만들어 실행 - 주의: 복잡한 API 호출은 반드시 Python 헬퍼 스크립트 사용
CDP 관련 이슈
[2026-03-08] CDP 연결 — Antigravity.exe 직접 실행 필수
- 증상:
antigravity .CLI로 실행 시 CDP 포트가 열리지 않음 - 원인: CLI 래퍼가
ELECTRON_RUN_AS_NODE=1을 설정하여 CDP 비활성화 - 해결:
"%LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe" --remote-debugging-port=9000으로 직접 실행 - 주의: 기존 Antigravity 프로세스가 있으면 새 인스턴스가 합류하여 별도 CDP 포트 열리지 않음. 모든 인스턴스 종료 후 실행
프로젝트별 이슈
[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 - 원인: 이전 서버 프로세스가 종료되지 않은 상태에서 재시작
- 해결: 서버 시작 전 기존 프로세스를 포트 기반으로 종료
$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개 제한, 페이지네이션 불가
- 증상:
GetCascadeTrajectoryRPC가 항상 처음 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는 미정의 함수 호출 시 런타임 에러만 발생하고 서버는 죽지 않아 발견이 어려움