# task-650.1 완료 보고서
> 작성: 라(Ra) 개발3팀장 | 2026-03-17 | dev3-team

---

## SCQA

**S**: 봇 세션마다 Claude Code가 고유 프로젝트 해시를 생성하여, `/home/jay/.claude/projects/-home-jay--cokacdir-workspace-<hash>/memory/MEMORY.md`가 없어서 auto-memory 에러가 반복 발생하고 있었다.

**C**: 각 봇 세션은 독립된 hash를 갖기 때문에 MEMORY.md를 수동으로 만들지 않으면 모든 봇이 서로 다른 메모리 경로를 참조하여 세션 간 컨텍스트 단절이 발생한다.

**Q**: 매 프롬프트 실행 시마다 현재 세션의 memory 디렉토리를 자동 생성하고 아누의 MEMORY.md를 심링크로 연결하여 문제를 100ms 이내로 해결할 수 있는가?

**A**: `ensure-bot-memory.sh` 스크립트 + `~/.claude/settings.json` UserPromptSubmit 훅 등록으로 완전 해결. 실측 실행시간 5ms (요구사항 100ms의 5%). pytest 7/7 통과, pyright 에러 0건, black/isort PASS.

---

## 생성 파일 목록

| 파일 | 내용 |
|---|---|
| `/home/jay/workspace/scripts/ensure-bot-memory.sh` | 핵심 훅 스크립트 (66줄) |
| `/home/jay/workspace/tests/test_ensure_bot_memory.py` | pytest 테스트 7개 |

## 변경 파일

| 파일 | 내용 |
|---|---|
| `~/.claude/settings.json` | UserPromptSubmit 훅 배열에 `ensure-bot-memory.sh` 추가 |
| `/home/jay/workspace/scripts/bot-status-watchdog.py:68` | 기존 버그 수정 (범위 외, 자체 해결) |

---

## 스펙 전수 체크

- [x] **1. 훅 스크립트 생성**: `/home/jay/workspace/scripts/ensure-bot-memory.sh` 생성, 실행 권한 설정 ✅
- [x] **2. 프로젝트 해시 추출 로직**: `sed 's/^\///; s/\//-/g; s/\./-/g'` 패턴으로 정확히 변환 ✅
- [x] **3. 훅 등록**: `~/.claude/settings.json` UserPromptSubmit 배열에 추가 (덮어쓰기 없음) ✅
- [x] **4. workspace 임시 파일 보고**: autoset 디렉토리에 253개 임시 파일 (PDF 2개, PNG 6개, JPG 245개) — 보고만 수행, 자동 삭제 금지 ✅

---

## 테스트 결과

```
tests/test_ensure_bot_memory.py - 7 passed in 0.07s

TestScriptExists::test_script_exists            PASSED
TestScriptExists::test_script_executable        PASSED
TestHookRegistered::test_hook_in_settings       PASSED
TestSymlinkCreation::test_symlink_creation_in_new_dir  PASSED
TestSkipIfExists::test_skip_if_symlink_exists   PASSED (실행시간: <100ms 확인)
TestExecutionTime::test_execution_time_under_100ms  PASSED (avg <100ms)
TestWorkspaceCleanup::test_report_temp_files    PASSED
```

---

## 실제 동작 검증

현재 세션(`9455623C`)에서 스크립트 실행:
```
실행 전: ~/.claude/projects/-home-jay--cokacdir-workspace-9455623C/memory/ 없음
실행 후: MEMORY.md -> /home/jay/.claude/projects/-home-jay--cokacdir-workspace-autoset/memory/MEMORY.md
실행 시간: 5ms (100ms 기준 대비 95% 여유)
```

---

## 발견 이슈 및 해결

### 자체 해결 (1건)

1. **`bot-status-watchdog.py` parse_since_time(None) AttributeError** — `if since_str is None: return None` 추가 + 타입 힌트 `str | None`으로 수정
   - 상세: `scripts/bot-status-watchdog.py:68` 타입 힌트 `str` → `str | None`, None 가드 추가
   - 범위 외 사유: task-650.1과 무관한 기존 버그. 그러나 테스트 스위트 차단 원인이므로 자체 해결.
   - 검증: `test_bot_watchdog.py::TestParseSinceTime::test_parse_invalid_format` PASS

### 범위 외 미해결 (2건)

1. **`test_bot_watchdog.py::TestCheckAndRecoverStuckBots` 2건 실패** — 범위 외 사유: `check_and_recover_stuck_bots(data)` vs `check_and_recover_stuck_bots()` 인터페이스 불일치. task-650.1 이전부터 존재하는 기존 버그. 인터페이스 변경은 다른 팀 코드 영향 가능성 있어 dev3 독립 결정 불가.
   - ⚠️ 기존 테스트 실패 2건 (본 작업 범위 외): `TestCheckAndRecoverStuckBots::test_recover_stuck_bots`, `TestCheckAndRecoverStuckBots::test_no_stuck_bots`

---

## QC 자동 검증 결과

```json
{
  "summary": "4 PASS, 1 FAIL, 5 SKIP",
  "pyright_check": "PASS (0 errors, 0 warnings)",
  "style_check": "PASS (black: OK, isort: OK)",
  "tdd_check": "PASS",
  "data_integrity": "FAIL (finish-task.sh 실행 전 — 정상)",
  "test_runner": "(본 작업 테스트 7/7 PASS; 기존 bot_watchdog 2건 범위 외 실패)"
}
```