From 4842d0f89206f252b17d8ffc9cc498842ee83644 Mon Sep 17 00:00:00 2001
From: Godopu <godopu16@gmail.com>
Date: Fri, 10 Jul 2026 12:38:12 +0900
Subject: [PATCH] docs(handover): save session isolation handover brief to
 workspace root

---
 session_isolation_handover.md | 50 +++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 session_isolation_handover.md

diff --git a/session_isolation_handover.md b/session_isolation_handover.md
new file mode 100644
index 0000000..b88b90c
--- /dev/null
+++ b/session_isolation_handover.md
@@ -0,0 +1,50 @@
+# 📑 Session Isolation Handover Brief (세션 격리 작업 인수인계서)
+
+이 파일은 세션 ID 격리(Session Isolation) 기능의 구현 완료 내용과 다음 재개 단계의 상세 내용을 보관하여, 추후 작업 재개 시 신속하게 컨텍스트를 파악하고 마일스톤을 이행하기 위해 작성되었습니다.
+
+---
+
+## 1. 🏁 Work Accomplished (완료된 작업 및 결과)
+
+1. **Phase 1 — 공통 불변식 구현 및 반영**:
+   - `lib.sh`에 `T1. claimed-set filter` 및 `T2. uniqueness assert`를 반영하여 동일 대화 ID가 복수의 에이전트에 동시 할당되는 것을 오케스트레이터 차원에서 차단했습니다.
+2. **Phase 2 — all-L2 격리 구현 및 실측 통과**:
+   - `create_session.sh`에 `--isolate` 플래그 및 격리 디렉터리(`.mam/agent_homes/<uuid>/`) 생성 로직을 구축했습니다.
+   - 각 에이전트별 매트릭스에 따른 심링크 시딩(Symlink Seeding)을 완벽히 이행하여 로그인 auth는 유지하고 대화 내역은 물리 격리되도록 구현했습니다.
+   - `_validate` 블록에 isolation 스키마(uuid/root 필수) 검증을 추가하고 `find_workspace_uuid` 타겟-세션 모드를 통해 격리 루트 밖으로의 스캔 fallthrough를 원천 방지했습니다.
+3. **Phase 3 — stop 청소 계약 (T6/T6-a) 구현 및 실 실측 완료**:
+   - `stop_session.sh` 에 `--purge-conversation` 이 들어왔을 때, 격리 디렉터리(`isolation.root`)를 안전하게 `rm -rf` (Python `shutil.rmtree`)로 청소하도록 구현했습니다.
+   - **경로 가드(Safeguard)**: 삭제 전 디렉터리가 반드시 `<workspace>/.mam/agent_homes/` 하위의 UUID 폴더인지를 철저히 검증하여 우회/오삭제를 방지했습니다.
+   - **실측 완료**: `test-iso-claude` 와 `test-iso-cline` 세션을 띄운 후 `--purge-conversation`으로 중지시켜 격리 홈이 깨끗이 지워지고, 실제 사용자 HOME에 존재하는 원본 설정 파일들(`.credentials.json`, `settings.json`, `globalState.json` 등)은 **손상 없이 100% 잔존**하는 것을 확인했습니다.
+
+---
+
+## 2. 🔍 Reviewer Cline Feedback & Resolutions (리뷰 피드백 및 조치)
+
+* **Cline의 날카로운 RK2 결함 발견**:
+  - `multi-agent-mux-resume` 스킬의 workflow 및 가이드가 `resolve_session_id.sh` 호출 시 `--session` 옵션을 넘겨주지 않아, 격리 복원 대신 레거시 전역 스캔을 타는 버그를 식별했습니다.
+  - 더불어, 복원 스폰 시 격리 환경변수/실행 인자가 누락되어 격리가 해제되는 구조적 허점을 지적했습니다.
+* **CTO 조치 조기 완료**:
+  - `resume/SKILL.md` 가이드라인과 쉘 스크립트 예제에 `--session "$SESSION_NAME"` 패스스루와 `lib.sh` 디스패치 함수(`isolation_env_prefix`, `isolation_cmd_args`) 호출 및 `eval` 기동을 완전하게 주입하여 **원자적 격리 복원(Atomicity & Re-apply) 체계를 완성**했습니다.
+
+---
+
+## 💾 Preserved Sessions (보존된 에이전트 세션 목록)
+
+메모리 및 환경 리소스를 아끼고 상태를 영속화하기 위해, 활성 중이던 개발용 에이전트 세션을 안전하게 `stopped` 상태로 전환해 두었습니다.
+
+1. **canary-projects-multi-agent-mux-creator-claude** (`status: stopped`)
+   - **Captured ID**: `589d2346-ad0c-496c-ab0c-e6e65191261c`
+2. **canary-projects-multi-agent-mux-reviewer-cline** (`status: stopped`)
+   - **Captured ID**: `1783646396013_uzoty`
+
+---
+
+## ⏭️ Next Steps (나중에 작업을 다시 재개할 때 해야 할 일)
+
+1. **에이전트 세션 부활 (Resume)**:
+   - 격리 복원 가이드가 업데이트된 `resume/SKILL.md` 절차를 이용하여 두 에이전트 세션을 부활시킵니다.
+2. **Phase 4 - 통합 검증 (V1 ~ V4) 테스트 이행**:
+   - `task.session_isolation.md` 에 기록된 통합 및 회귀 검증(V1: 4개 에이전트 동시 기동, V2: 락 충돌 검증, V3: 격리 복원 검증, V4: 레거시 무회귀 검증)을 실측합니다.
+3. **최종 PASS 서명 획득 및 머지**:
+   - 복원된 Cline 리뷰어 세션에 격리 복원 결함 조치본에 대한 최종 PASS 선언을 받고, 최종 커밋을 원격에 Push/Merge하여 세션 격리 개발 프로젝트를 최종 마무리 짓습니다.