📦 SARA 통합 인수인계서 (최신·단일 시드)

📦 새 대화방 인계 스냅샷 (2026-06-02 #11 — 최신·이 블록만 읽으면 이어받음)

이 블록이 이전 모든 NOW를 대체한다. 과거 진행 이력(#2~#10 · 05-30 야간 큐 · UI/effort 트랙)은 🗄️ 이력 아카이브로 이동했다. 불변 핵심·경로·broker 규칙·확정사실·스키마는 아래 본문 그대로. 현재 = SARA→코디 위임((다) CLI 러너) 완료 + 자동위임 ON(활성화 완료). - ✅ SARA→코디 위임((다) CLI 러너) 완료 + 자동위임 ON(SARA_CODI_CLI=1, SARA 재기동 반영). 검증 2건 PASS. 커밋·pytest·RDS id 등 경과 상세 = 🗄️ 이력 아카이브 2026-06-02. - 되돌리기(자동위임 OFF): .env에서 SARA_CODI_CLI 제거/0 → 재기동(코드 inert, 머지 되돌림 불필요). 다음 (우선순위 미정 — 사용자 결정): 1. 자동위임 첫 실사용 관측 — ON 이후 실제 task 위임을 아직 안 돌려봄. 첫 위임 시 ResultContract 발행·EVALUATOR verdict·activity_logs 기록·broker 게이트 실동작을 라이브로 확인(PROBE는 정적/best-effort까지만). 2. 🆕 EVALUATOR 웹페이지 실사용 평가 (제안·결정 2건 대기) — 코드 충족 검증을 넘어, 실제 띄워 조작한 증거(스크린샷+콘솔/네트워크 에러)로 실사용 문제·개선안까지 판정. Playwright(MCP) 손 + 비전 눈, 5단계(preview→drive→capture→evaluate→evidence 계약). 미결: ① 탐색 깊이(검증기준 플로우만 vs +자유탐색) ② 비전 평가 포함 여부. 상세 = 🔍 EVALUATOR 웹 실사용 평가 — 설계 제안. 정리 대기(삭제는 사용자): activity_logs 행 7659(VERIFY- 태그) · 임시 _verify_rds_insert_2026-06-02.py · 미커밋 config/settings.json(effort 드리프트·무관). 잔여(미착수): untracked 보존 · summary flip(B-2) · Q8 write-op · Q1 persist 고아 chain · custom_title/notion_url 드리프트 · SARA_WORKSPACE repo 해석 · (선택)GPT 협의 도구 적용. 상세 링크 = 멀티에이전트 세부 상의 §10 · 협의 결과(#28) · 이력 아카이브.

📝 페이지 갱신 기본 규칙 (인수인계서·하위 페이지 공통)

"갱신"은 단순 최신 내용 추가가 아니라 다음을 모두 포함한다. 1. 최신 내용 추가 — NOW(최근 작업)를 맨 앞·중심에 둔다. 2. 중복 제거 — 누적된 과거 스냅샷·중복 서술은 통합하거나 제거한다. 3. 결론 통합 — 합의·결정 결과는 별도 나열이 아니라 기존 계획(로드맵·구현 단위)에 흡수해 정리한다. 4. 완료 항목 아카이브 이동 — 완료된 Phase·작업 서술 블록은 🗄️ 이력 아카이브로 옮기고 본문엔 링크+요약만 남긴다. 5. 불변 핵심 보존 — 경로/포트·인증·위험작업 규칙·확정사실·스키마는 길이와 무관하게 항상 유지한다. 6. 작업 트래커 동기화 (필수) — 노션 페이지를 갱신할 때는 작업 트래커 DB(✅ 작업 트래커 — SARA 구축, collection://37ebefdd-4151-4b7c-81f3-3325da9e43be) 갱신을 반드시 포함한다. 대기·진행중 행의 실제 완료 여부를 확인해 상태(대기/진행중/완료/보류)를 갱신하고, 신규 작업은 행을 추가한다(컬럼: 작업/Phase/담당/상태/우선순위/그룹1/그룹2/비고). 적용 범위 = SARA 허브 및 모든 하위 페이지. RDS 아티팩트 변경 후엔 SHOW TABLES/DESCRIBE 교차검증(확정사실 9).

📦 SARA 통합 인수인계서 (불변 핵심)

새 대화방은 위 최신 스냅샷 + 이 본문만 읽으면 이어받는다. 과거 진행 이력은 🗄️ 이력 아카이브.

0. 한 줄 요약

VS Code 안의 단독 SARA 채팅 패널을 claude-agent-sdk로 구축하는 프로젝트. Phase 1(패널)·2b(권한 게이트)·2a(자동 인계)·2a-ext(Webview+노션 비동기+UI) 전부 완료. 채티↔GPT 자동 협의 SW(agent-dialogue-hub) 완료. 멀티에이전트 통합(③→②→① 순) 진행 중이며, SARA→코디 위임((다) CLI 러너)은 완료·자동위임 ON.

1. 핵심 위치

• SARA C:\dev\SARA (:8770) — 2026-05-29 tools 하위에서 독립 리포로 분리(원격 github.com/delix0731/SARA private, 히스토리 보존 subtree split). SARA_HOST=100.108.234.45(Tailscale). 자동재시작 = 예약작업 SaraWatchdog(1분 주기, :8770 미점유 시만 기동; 구 Startup .bat은 .disabled).
• agent-dialogue-hub C:\dev\tools\agent-dialogue-hub (:8780) — 채티↔GPT 협의 엔진. HUB_HOST=100.108.234.45(Tailscale, 모바일 접속)·HUB_PORT=8780(.env). 자동재시작 = 예약작업 HubWatchdog(1분 주기, :8780 미점유 시만 기동, dup-guard; hub_watchdog.bat/.vbs). ⚠ PC 재부팅 시에도 1분 내 자동 기동.
• broker C:\dev\tools\cody-permission-broker (:7777)
• cmdboard C:\dev\cmdboard (RDS, BOARD_DB_*) · notion-bulk C:\dev\tools\notion-bulk
• sara-memory(읽기전용 RDS 조회): MCP C:\dev\SARA\custom_tools\(sara-memory 등록) + 독립 CLI C:\dev\tools\sara-memory-cli\.

2. 인증 · 작업 모드 · MCP

• 인증: 구독 OAuth / setup-token, API 키 미사용(ANTHROPIC_API_KEY 비움). GPT만 OpenAI API(gpt-5.5).
• 작업 모드 = 자동위임 ON(2026-06-02 활성화). SARA가 task/verify 메시지를 코디 claude -p 서브프로세스로 위임((다) CLI 러너, SARA_CODI_CLI=1). SARA 본체는 읽기전용(enable_write_tools:false, Bash 없음). 위험작업은 broker 게이트(텔레그램 승인/차단)로 통제 — 파괴·되돌리기 불가 작업은 확인 체크포인트 권장. 수동(채티 .md → 사용자 코디 dispatch)은 폴백/구축용.
• 위임 안전 골격(관측 5종): ①git/RDS 권위(코디 자기보고 아님) ②종단 계약 항상 발행(성공/실패/timeout/stall/크래시 전 경로) ③독립 EVALUATOR가 evidence 검증 ④스냅샷 기반 재개/롤백 ⑤NDJSON 전사 영속화 + stall 워치독.
• SARA 등록 MCP: notion-anchor-mcp · desktop-notify · github · aws-api · sara-memory. claude-code는 미등록(위임은 claude -p 서브프로세스 경유) + broker 훅.

3. 노션 비동기 구조 (목표)

[빠른 경로]   기록 발생 → cmdboard RDS 큐에 즉시 write → 작업 계속 (지연 0)
[느린 경로]   백그라운드 워커가 '미반영' 행 polling → notion-bulk로 노션 반영 → '동기화 완료'

병목은 노션(수십 초)이지 RDS(수 ms)가 아니므로 1차 저장소를 RDS로 통일해도 체감 손실 없음. 적용 범위 = 모든 노션 문서 갱신. 인계 요약 원칙: NOW 중심 + 불변 핵심 항상 보존. 구조 = ① NOW → ② 직전 결정·맥락 → ③ 불변 핵심 → ④ 과거 이력(링크).

4. ✅ 확정 사실

1. 세션 인계 저장소 = cmdboard RDS 단독. 비파괴 테이블 sara_continuation(017).
2. 노션 갱신 1차 저장소 = cmdboard RDS 통일. 백그라운드 워커가 notion-bulk로 반영.
3. 패널 = VS Code Webview 익스텐션. Simple Browser 폐기.
4. 인계 임계치 = 65% (ResultMessage.usage).
5. 연동 채널 = SARA → cmdboard RDS 직접(SQLAlchemy), BOARD_DB_*.
6. 프로젝트 셀렉터 = SARA가 cmdboard projects 직접 조회.
7. 노션 갱신은 전부 RDS 비동기 경유(모든 문서). 큐(G2)·워커(B-2) 완성됨.
8. 인계/인수인계서는 최근 작업 중심, 불변 핵심은 항상 보존(§3).
9. RDS 아티팩트 변경 후 SHOW TABLES/DESCRIBE 교차검증 의무.
10. 페이지 갱신은 위 §페이지 갱신 기본 규칙을 따른다(최신추가·중복제거·결론통합·완료 아카이브 이동·불변 보존·트래커 동기화).

sara_continuation 스키마 (마이그레이션 017)

실제 파일 migrations/017_sara_continuation.sql이 기준. 14컬럼. status = active/handing_off/handed_off/closed, usage_ratio(0.65 트리거)·parent_id(계보)·model·context_window 포함.

5. broker 권한 게이트 (차단/허용 기준)

• 게이트 대상 = Bash/Write/Edit/MultiEdit/NotebookEdit. 읽기전용 통과.
• 🟢 허용: master/main 일반 push(AUTO_ALLOW, 핫픽스 9cacf78).
• 🟡 텔레그램 승인 게이트: force push(--force/-f/--force-with-lease)·git reset --hard(risk_approvals, 미응답 120초 fail-safe deny) · aws-api 삭제·종료.
• 🔴 차단(HARD_DENY): rm -rf 등 · aws-api SG/IAM 정책 변경 · 운영 파일 쓰기 · deploy 금지 시간대.

6. ↩ 되돌리기

• 신규 테이블/큐는 비파괴(DROP으로 원복).
• 익스텐션·하네스 이식은 기존 자산 보존 후 점진 이행. 하네스는 vendored copy(직접 import 금지)라 cmdboard 변경이 SARA를 깨지 않음.
• 인계 시 요약 생성 실패 → 인계 보류, 기존 세션 유지.
• broker 핫픽스는 변경 전 백업 + git revert로 원복.
• [page] 🚨 [긴급·1순위] 멀티에이전트 통합 아키텍처 — 세부 상의 (cmdboard 자원 참조)