Files

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

4.0 KiB

Raw Permalink Blame History

description

description
세션 종료 시 devlog 기록 + git commit + Vikunja 동기화 (끝, 마무리, 커밋해, 완료)

세션 종료 프로토콜

작업 완료, "끝", "마무리", "커밋해" 등 요청 시 이 워크플로우를 실행합니다.

// turbo-all

0. 학습 기록 (실패/시행착오 저장)

이번 세션에서 발생한 실패, 시행착오, 새로 알게 된 사실을 정리합니다:

.agents/references/known-issues.md에 추가할 항목이 있는지 확인
있다면 아래 포맷으로 추가:

### [날짜] [키워드] — 한줄 요약
- **증상**: ...
- **원인**: ...
- **해결**: ...
- **주의**: ...

1. Devlog 기록

Index 업데이트 (필수 — 매 작업)

오늘 날짜의 index 파일에 완료된 작업 1줄을 추가합니다.

파일: docs/devlog/YYYY-MM-DD.md
형식:

| NNN | HH:MM | 작업 설명 | `커밋해시` | ✅ 또는 🔧 |

Entry 작성 (선택적 — 필요할 때만)

Important

Entry는 git/Vikunja/wiki에 없는 정보가 있을 때만 작성합니다.

Entry 작성 기준:

✅ 설계 결정이 있었을 때 (왜 A가 아닌 B를 선택했는지)
✅ 미완료 사항이 있을 때 (다음 세션이 이어받아야 할 맥락)
✅ 삽질/트러블슈팅이 있었을 때 (같은 실수 방지)

Entry 불필요:

❌ 단순 버그 픽스 (커밋 메시지로 충분)
❌ 문서 업데이트 (git diff로 충분)
❌ 이미 Vikunja 태스크에 상세 설명이 있는 경우

Entry 파일: docs/devlog/entries/YYYYMMDD-NNN.md

# 작업 제목

- **시간**: YYYY-MM-DD HH:MM~HH:MM
- **Commit**: `해시`
- **Vikunja**: #태스크번호 → done/진행중

## 결정 사항
- 왜 이 방식을 선택했는지

## 미완료
- 남은 작업 (있을 경우)

2. Vikunja 동기화

Caution

반드시 vikunja_helper.py 사용. 직접 API 호출 금지. Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다.

2-1. 커밋 전수 검사

이번 세션의 모든 커밋을 하나씩 검사하고 Vikunja에 매핑합니다.

git log --oneline -20

커밋 유형	Vikunja 액션
기존 태스크 해당 작업 완료	`C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py done {ID}`
신규 작업 완료 (기존 태스크 없음)	`C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --done --labels Backend,Priority:High`
작업 중 발견된 미완료 TODO	`C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\vikunja_helper.py create "제목" "설명" --labels Backend,Priority:Mid`

Important

모든 커밋이 기존 또는 신규 태스크에 매핑되었는지 확인.

2-2. Wiki 동기화 (해당 시에만)

코드 변경	대상 Wiki
서버 변경	Architecture
CDP 관련	Architecture
프론트엔드 변경	Architecture

C:\ProgramData\miniforge3\envs\gravity_web\python.exe .agents\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md

3. Git Commit & Push

git add -A
git status --short

git commit -m "커밋 메시지"

git push origin main

커밋 메시지 컨벤션:

<type>(<scope>): <description>

type: feat|fix|refactor|test|docs|chore|ci|infra
scope: server|frontend|cdp|infra (선택)

4. 최종 체크리스트

Warning

아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다.

known-issues 업데이트됨 (새 이슈가 있었다면)
devlog index 업데이트됨
devlog entry 작성됨 (필요한 경우만)
Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반)
Wiki 동기화됨 (해당 시)
git push 완료
사용자에게 완료 보고

4.0 KiB Raw Permalink Blame History