🗄️ 인수인계서 이력 아카이브

완료된 인수인계서·설계 조각을 모아둔 이력 보관소. 운영 원칙: 완료된 Phase·확정된 설계는 여기로 옥긴다. 최신 작업 시드는 항상 📦 SARA 통합 인수인계서 하나. 새 대화방은 아카이브를 읽을 필요 없다(필요 시 참고만).

운영 방식 (기본 설정)

• 통합 인수인계서의 항목이 완료되면 그 서술 블록을 이 아카이브로 이동(링크+요약) → 통합본은 1순위·진행중 중심으로 가볍게 유지.
• (삭제) 표시된 과거 조각 페이지는 사용자 수동 삭제 대상. 내용은 아래에 요약으로 남긴다.

아카이브 목록

✅ Phase 1 — 단독 SARA 패널 (완료, 2026-05-26)

C:\dev\tools\vscode_sara 패널 런타임 스캐폴드 생성·검증. 대화/세션 resume/커스텀 도구/외부 MCP/파일 업로드 동작. 구독 OAuth/setup-token 인증, FastAPI :8770, 패널 자동시작(tasks.json + Ctrl+Alt+S). 원본: (삭제) 📦 인수인계서 — SARA Phase 1.

✅ Phase 2b — broker 권한 게이트 (완료)

sara/permission_hook.py → cody-permission-broker(:7777) /permission. 게이트 대상 = Bash/Write/Edit/MultiEdit/NotebookEdit, 읽기전용 통과. AUTO_ALLOW·fail-safe deny 검증 완료.

✅ Phase 2a 설계 — 자동 세션 인계 (확정, 2026-05-26)

3개 메커니즘(영속/복원/자동인계) 확정. 연동 채널 = SARA→cmdboard RDS 직접(SQLAlchemy, BOARD_DB_*), 임계치 65%, 신규 비파괴 테이블 sara_continuation, 프로젝트 셀렉터 포함. 원본: (삭제) 🔁 Phase 2a 설계 / (삭제) 📦 인수인계서 — Phase 2a 착수. → 현재 통합본의 Phase 2a·2a-ext로 이어짐.

아카이브 목록 (2026-05-30 추가 — Phase 2a/2a-ext 완료분 + 멀티에이전트 1차)

✅ Phase 2a 구현 — 자동 세션 인계 (완료, 2026-05-27)

sara_continuation(마이그레이션 017) RDS 적용. G1(017 작성·push, 197970a) · G5(continuation_manager.py persist/restore/handoff 65%, 8d1d799) 코드+단위검증 완료. 저장소 = cmdboard RDS 단독.

✅ Phase 2a-ext — Webview 전환 + 노션 비동기화 + UI 이식 (완료, 2026-05-28~29)

• G2 노션 비동기 큐(notion_sync_queue 018, c01d460) · G3 Webview 익스텐션 골격(12d9acb) · G4 SDK 멈춤/인터럽트(e517765) · G6 UI 이식(1010068) + /projects RDS 직접(0e48888) + G6-2 세션 사이드바(8e2bfc8) + 단축키 Ctrl+Alt+S(ecc2759) + cmd창 숨김(cbccccf) + G6-3 세션 제목 자동요약(61b0464).
• G7 프로젝트연결/노션링크/필터(cbedc15·c9cf67d) · G8 Tailscale 원격 + CSP 동적화(d23bb20) · G9 컨텍스트 측정(4c7dfa0) · G10 동시답변 차단(1799caa) · G11 메시지 저장/복원(ecbd6b9).
• G12 노션캐시 인수인계서 B-1(019, a640c0b) · g13 메시지 편집/재생성(e4df320) · aws-api stdio 등록(656c858) · g15 첫화면 복원 결정적 정렬(f17fa92) · SARA UI 핫픽스(8c75146).

✅ broker 권한 게이트 보강 (완료, 2026-05-27~29)

master/main 일반 push 자동허용 핫픽스(9cacf78) · force push·git reset --hard 텔레그램 승인 게이트(risk_approvals, e0ffcba) · aws-api call_aws 분류(삭제·종료=텔레그램 / SG·IAM 정책=차단 / 읽기=허용, 689d366).

✅ agent-dialogue-hub — 채티↔GPT 자동 협의 SW (완료, 2026-05-29~30)

신규 허브 C:\dev\tools\agent-dialogue-hub(:8780). 채티(claude-agent-sdk)↔GPT(OpenAI API, gpt-5.5) 자동 핑퐁 협의. PoC H1~H6 + A(프로젝트 셀렉터 동적화) + B-1(합의 종료 시 notion_sync_queue enqueue) + B-2(SARA 워커가 큐 소비 → 노션 child_page 생성) 코드·검증·push 완료. 마이그레이션 020. 커밋 hub a49682d · SARA 82670c1. 분담: hub = 협의 엔진·enqueue / SARA(:8770) = 큐 소비 워커. (B 성공경로 E2E는 본 페이지군 자동 생성으로 입증.)

✅ 멀티에이전트 통합 아키텍처 — 합의 도출 (완료, 2026-05-30, hub session #19)

hub 자동 협의로 4미결 결론. 상세 = 협의 결과 페이지 + 멀티에이전트 세부 상의 §10. 요지: ① ROUTER(chat/task/verify_required 3분류)+EVALUATOR(task성만) 이식, 외부 /chat 응답 불변·내부계약만, PLANNER/CODI는 disabled adapter ② full-dump 유지, RAG 전환 = 점유율 AND 재현율 게이트 동시 충족 시만 ③ 최우선 = truncate 제거 + 자식 전량 RDS 캐시(G2 큐), 주입은 summary 기본, page_id 집합 diff + tombstone ④ 스키마 cmdboard 단일소유, contract vendoring 버전고정, 하네스 vendored copy + commit hash. 실행순서 ③→②→[차단해제: cmdboard 하네스 실파일 대조]→①.

아카이브 목록 (2026-06-01 추가 — B-1 활성화 + diag + ⓑ 위임 진단/구현)

✅ B-1 노션캐시 활성화·검증 (완료, 2026-06-01, daf1c18)

master/origin daf1c18(FF, base fbc6b71). .env NOTION_CHILD_CACHE=1 + 재기동(라이브). 라이브 전부 통과: sara_notion_cache 6신규컬럼(summary_md/full_md/deleted_at/cache_bytes/estimated_tokens/load_ms) DESCRIBE · primary 행 full_md/summary_md+계측 3필드 · refresh→enqueue_child_cache→워커 cache_child_page pending→done(자식 본문 실적재) · tombstone(deleted_at) 실기록. 변경 요지(지시문 codi_notion_cache_b1.md): 읽기 SELECT 12컬럼+deleted_at IS NULL, _cache_upsert full_md/summary_md 기록+재캐시 시 deleted_at=NULL, 워커 cache_child_page 실구현(NOTION_CHILD_CACHE 전용 게이트, NOTION_WRITE_OPS와 독립), refresh는 root/primary 인라인 + 비primary 자식만 enqueue. 주입은 full 유지 → summary flip은 B-2(=①, 미착수).

✅ diag 진단 시스템 (완료, 2026-06-01, 298a80e)

SARA 턴마다 ('diag', …) SSE 1회 발행(관측 전용·백워드 호환) + 패널 진단 요약 바 + "🔍 진단 복사" 버튼. 라우트·위임여부·raw도구·도구순서·EVALUATOR판정·커밋실검증·소요·결과head(마스킹)를 추측 없이 채티에 전달. 브랜치 _bridge_e2e. (#4에서 verify_error 필드 추가 + 검증블록 try/except 회복탄력성 보강.)

✅ ⓑ 위임 두 레버 + subagent 강제 구현 (코드 완료, 2026-06-01)

• 레버1·2 + T0/T1 (6f3efd4): 레버1 = sara/agent.py disallowed_tools로 built-in raw 6종 하드블록(SDK allowed_tools는 자동승인 목록일 뿐이라 누수 근본원인) + sara/permission_hook.py broker_gate base매칭(MCP 프리픽스 우회 차단). 레버2 = sara/codi_bridge.py intent==GENERAL일 때만 코드작업→task 오버라이드. vendored router_evaluator.py diff 0. pytest 107 passed + 신규 14. 라이브 T1(BRIDGE=0) PASS = raw 미사용·커밋 0.
• subagent_type=codi 강제 + diag fix (f470578, 115 passed): .claude/agents/codi.md 등록 + .claude/settings.json broker 훅 verbatim 복제 + broker_gate Agent 분기 deny-on-mismatch + 계약 4항 + diag 크래시 fix + 단위 5케이스. 상세 = 인수인계서 #4 / 세부 상의 §11.

⚠ 위임 라이브 검증 — T2 FAIL → PROBE-0 FAIL (미해결, #25로 이월, 2026-06-01)

• T2(BRIDGE=1) FAIL = 위임 진입(route=task·delegated)했으나 실커밋 0. 당시 추정 원인 3 중 ②(broker가 로컬 commit 차단)는 오진으로 판명 — broker는 이미 로컬 commit AUTO_ALLOW, T2 시간대 broker 요청 0건(차단 주체는 SDK 샌드박스).
• PROBE-0(codi 인식) FAIL = f470578 라이브 검증에서 "Agent type 'codi' not found". claude mcp serve가 cwd .claude/agents/를 적재하지 않음(§8.3 "broker 경유 강제"의 전제인 "서브에이전트 로드"가 NO). §3 강제·§4 diag는 PASS. → #25 재설계: claude mcp serve --help 실측 → SDK agents 옵션 주입 → 인프로세스 서브에이전트 전환 순. SARA_CODI_BRIDGE 기본 OFF 유지.
• ⚠ 교훈: 코디가 리포에 없는 커밋(beb0f3a)을 "완료"로 보고한 전례 → 완료 보고는 항상 git/RDS 실대조 후 신뢰. (#4도 f470578를 git/db 재현으로 검증함.)
• SARA 자율 테스트 부산물 커밋 1ae03fa(마커 ok→oktest) 되돌리기 보류.

✅ hub viewer UI + GPT 읽기도구 (완료, 2026-06-01 / 05-30)

hub viewer 헤더 토픽 기본접힘 토글(a386947, push 완료) · GPT 깃허브·노션 읽기 function-calling 3종(f3282ae, Responses API 전환). 상세는 인수인계서 본문 이력 블록.

아카이브 목록 (2026-06-02 추가 — SARA→코디 위임 (다) CLI 러너 완료·활성화)

인수인계서 스냅샷 #2~#10에서 이동. 위임 채널 확정→구현→검증→플립→활성화까지의 전체 경과.

✅ 방안 (다) CLI 러너 선정 (확정, #25)

SARA→코디 위임 = codi를 별도 claude -p 서브프로세스로 실행(cmdboard codi_runner_cli 패턴 이식). 기각: (가) claude mcp serve는 cwd .claude/agents/ 미적재(PROBE-0 "Agent type 'codi' not found" 원인). 미채택: (나) SDK 네이티브 서브에이전트(동작하나 스킬·플러그인 opt-in·프로세스 격리 약함). (다) 채택 = 스킬·플러그인 풀 네이티브 + 진짜 프로세스 격리 + cmdboard 하네스 재사용 + .claude/settings.json broker 훅 실작동 + codi 미인식 문제 소멸.

✅ (다) 발행 전 선결 확인 5건 (cmdboard 이식 시 깨지는 지점)

A. --max-turns 부재(설치 CLI v2.1.154) → argv 제거·timeout_s 대체. B. broker 훅 = --bare만 없으면 자동로드 + --setting-sources user,project,local 명시. C. 위험값 bypassPermissions를 cmdboard 안전검사가 못 잡음 → allowlist 차단(acceptEdits 치환). D. activity_logs payload 키 = commit(not commit_sha), 정규키 재사용·확장은 sara_codi_cli_result 1키 중첩. E. --effort(low~max)·--fallback-model(--print 전용) 표기 확정.

✅ GPT 협의 도구(읽기) 코디 지시문 작성 (2026-06-01, 선택·후순위)

hub GPT 어댑터 로컬읽기 3종(local_read_file/local_list_dir/local_search) + web_fetch(B) 지시문 작성(codi_gpt_local_read·codi_gpt_web_tools). 산출물 .md 디스크 미저장, 실질 추가가치 = web_fetch만.

✅ (다) CLI 러너 구현 (완료, 코디 38dbb79)

4파일 +2180: sara/codi_cli_runner.py(vendored 핵심+관측 5종) · custom_tools/codi_run.py(codi_run SDK MCP, 게이트 OFF) · tests/test_codi_cli_runner.py(34) · sara/codi_bridge.py(SARA_CODI_CLI=1 분기 _delegate_via_cli, 기본 OFF). vendored pin = delix0731/cmdboard@feat/admin-unify-bundleB:bc4215b. 관측 5종 = ①git/RDS 권위 ②종단계약 항상 발행 ③독립 EVALUATOR ④스냅샷 재개/롤백 ⑤NDJSON 전사+stall. 지시문 codi_cli_runner_2026-06-02.md. 채티 검증: 커밋·4파일·master 미변경·vendored pin 일치·argv 금지토큰 차단·게이트 OFF·테스트 34·broker 우회 0건.

✅ 검증 2건 PASS + P-6 + 활성화 (완료, 2026-06-02, master 38dbb79)

① pytest 149 passed(.venv + uv run --with pytest; codi_cli_runner 34). ② RDS 실 INSERT 라이브 — _persist_activity→activity_logs id=7659(action='codi_cli_result', task_id=1393, 정규키+중첩 contract). P-6 = master FF 머지 547cd6a..38dbb79(broker AUTO_ALLOW, CI 없어 자동배포 0) + .env SARA_CODI_CLI=1 플립. 활성화 = SARA 재기동(PID 31288, 헬스 /settings·/active 200) → task/verify 메시지 코디 claude -p 자동위임 ON. 되돌리기 = .env에서 SARA_CODI_CLI 제거/0 → 재기동(코드 inert, 머지 되돌림 불필요).

✅ 사무실 PC(poinimos01 100.101.40.17) tailnet 접속 (해결, 2026-06-02)

원인 = 집 PC의 별도 WireGuard VPN(full-tunnel 0.0.0.0/0) kill-switch가 Tailscale(100.64.0.0/10) 응답까지 차단(SARA·방화벽·터널은 정상, sara.log에 200 다수). 조치 = WireGuard "Block untunneled traffic(kill-switch)" 체크 해제. 대안(회사 트래픽 full-tunnel 유지 시) = AllowedIPs에서 100.64.0.0/10 제외. 되돌리기 = 체크 재선택.