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
3.9 KiB
3.9 KiB
description
| description |
|---|
| Gravity Web 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조 |
서비스 연동 정보
Caution
이 파일에는 API 토큰이 포함되어 있습니다.
.gitignore에.agents/추가 필수.
로컬 환경
| 항목 | 값 |
|---|---|
| Node.js | 시스템 설치 (node, npm) |
| Python (helper) | C:\ProgramData\miniforge3\envs\gravity_web\python.exe |
| 프로젝트 루트 | c:\Users\Cafe-Variet-E495\Desktop\gravity_web\gravity_web |
| Shell | PowerShell (curl = Invoke-WebRequest 별칭이므로 반드시 curl.exe 사용) |
| 서버 실행 | cd server && cmd /c node index.js (port 3300) |
Python 실행 규칙
# ✅ 항상 전체 경로 사용 (python은 Windows Store 리다이렉트됨)
$PYTHON = "C:\ProgramData\miniforge3\envs\gravity_web\python.exe"
& $PYTHON .agents\workflows\helpers\vikunja_helper.py list todo
# ❌ 금지: bare python / inline one-liner
python script.py # PATH 문제
python -c "import json; ..." # PowerShell 이스케이핑 깨짐
curl.exe ... | python -c "..." # 파이프 + 인라인 = 100% 실패
Warning
PowerShell에서 inline Python one-liner는 절대 사용 금지. 따옴표/특수문자가 깨집니다. 반드시
.py파일을/tmp/에 만들어서 실행하세요.
서버 시작/종료 패턴
# 서버 시작 전 기존 프로세스 정리 (EADDRINUSE 방지)
$existing = Get-NetTCPConnection -LocalPort 3300 -ErrorAction SilentlyContinue
if ($existing) {
Stop-Process -Id (Get-Process -Id $existing.OwningProcess).Id -Force
Start-Sleep -Seconds 1
}
cmd /c "cd server && node index.js"
Gitea (Git Repository)
| 항목 | 값 |
|---|---|
| Base URL | https://git.variet.net |
| API Base | https://git.variet.net/api/v1 |
| Repo | Variet/gravity_web |
| Token | 3a01b4b15a39921572e64c413353e870d4d2161b |
| Auth Header | -H "Authorization: token 3a01b4b15a39921572e64c413353e870d4d2161b" |
Vikunja (Task Management)
| 항목 | 값 |
|---|---|
| Base URL | https://plan.variet.net |
| API Base | https://plan.variet.net/api/v1 |
| Project ID | 9 |
| Token | tk_070f8e0b715e818bb7178c3815ed5389040eddca |
| Auth Header | -H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca" |
Vikunja 태스크 조회
Tip
태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다.
C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py list todo
기타 서비스
| 서비스 | URL | 용도 |
|---|---|---|
| Uptime Kuma | https://status.variet.net |
서비스 모니터링 |
| Authentik | https://auth.variet.net |
SSO 인증 |
AI 작업 프로토콜
Important
아래 규칙은 모든 작업에 자동 적용됩니다. 유저가 별도 지시하지 않아도 따릅니다.
Vikunja = Single Source of Truth (SSOT)
- Vikunja가 유일한 작업 현황 관리 도구입니다.
- 새 TODO 발견 시 → Vikunja에 태스크 생성
- 작업 완료 시 → Vikunja 태스크 완료 처리
Vikunja 태깅 규칙
영역 라벨 (필수, 1개 이상): Backend / Frontend / Infra / Test
우선순위 라벨 (필수, 1개): Priority:High / Priority:Mid / Priority:Low
커밋 메시지 컨벤션
<type>(<scope>): <description>
type: feat|fix|refactor|test|docs|chore|ci|infra
scope: server|frontend|cdp|infra (선택)
PowerShell 주의사항
curl→ PowerShell에서Invoke-WebRequest의 별칭. 반드시curl.exe사용npm→ PowerShell에서 실행 정책 문제 시cmd /c npm사용- JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 →
.py스크립트 파일로 만들어 실행 권장