OS 및 권한 경계 분석을 통한 AI 메모리 파이프라인 복구

I thought my AI memory hook was broken. It turned out to be Windows, WSL, uv, and one missing login

UB3DQY2026년 4월 13일8분intermediate

AI 요약

Context

Claude Code와 Codex를 위한 Markdown 기반 메모리 시스템 구축 중 Stop 훅의 지속적인 실패 발생. 단일 런타임으로 오인한 설계로 인해 하위 프로세스 및 OS 경계에서 발생하는 예외 상황을 포착하지 못한 구조적 한계 존재.

Transcript Shape 분석을 통한 파서 로직 수정 및 Content-based Threshold 도입으로 캡처 정확도 향상
Local Timeout 초과로 인한 stdout 폐쇄 대응을 위해 BrokenPipeError 예외 처리 로직 추가
Windows 호스트와 WSL 런타임 간 ~/.claude 상태 분리에 따른 인증 세션 불일치 해결
단일 프로세스 관점을 탈피하여 'UI Hook → Python Process → WSL Boundary → Claude CLI'로 이어지는 런타임 체인 구조로 재설계
하위 프로세스의 Generic Exit Code 1 문제를 해결하기 위해 각 런타임 경계별 개별 인증 및 실행 환경 검증 단계 도입

실천 포인트

1. 프로세스/OS/인증 경계를 넘나드는 시스템 설계 시 런타임을 개별 체인으로 분리하여 검토했는가?

2. 하위 프로세스의 stdout/stderr가 부모 프로세스의 Timeout 설정과 일치하여 Pipe Broken 현상을 방지했는가?

3. 호스트 OS와 가상화 환경(WSL 등) 간의 인증 상태(Credentials) 및 환경 변수 독립성을 확인했는가?

4. '스크립트 실행 성공'이 아닌 '최종 Side Effect 발생'까지의 전체 파이프라인을 End-to-End로 테스트했는가?

태그