Memory Architecture — 3-Tier Persistence

#!/usr/bin/env python3
"""memory-manager.py — MEMORY.md 자동 생성 및 관리"""
import json
import subprocess
from pathlib import Path
from datetime import date

def get_project_hash():
    cwd = subprocess.run(['pwd'], capture_output=True, text=True).stdout.strip()
    return cwd.replace('/', '-').lstrip('-')

def get_git_info():
    info = {}
    try:
        info['branch'] = subprocess.run(
            ['git', 'branch', '--show-current'], capture_output=True, text=True
        ).stdout.strip()
        info['recent_commits'] = subprocess.run(
            ['git', 'log', '--oneline', '-5'], capture_output=True, text=True
        ).stdout.strip()
        info['dirty_count'] = len(subprocess.run(
            ['git', 'status', '--short'], capture_output=True, text=True
        ).stdout.strip().split('\n'))
    except:
        pass
    return info

def setup_memory_structure(project_dir: str = '.'):
    """프로젝트에 memory 구조 초기화"""
    proj_hash = get_project_hash()
    memory_dir = Path.home() / '.claude' / 'projects' / proj_hash / 'memory'
    memory_dir.mkdir(parents=True, exist_ok=True)
    
    memory_index = memory_dir / 'MEMORY.md'
    if not memory_index.exists():
        git = get_git_info()
        content = f"""# MEMORY.md — {date.today()}

## Architecture State
<!-- 핵심 기술 결정, 마이그레이션 이력 -->
- Stack: [여기에 기술 스택]
- Branch: {git.get('branch', 'unknown')}

## Current Work  
<!-- 진행 중인 작업, 블로커 -->
- 작업 중: [여기에 현재 태스크]

## Key Decisions (recent)
<!-- 최근 아키텍처 결정 -->

## More Detail On-Demand
- [user_profile.md](user_profile.md)
- [feedback_patterns.md](feedback_patterns.md)
"""
        memory_index.write_text(content)
        print(f"✅ MEMORY.md 생성: {memory_index}")
    else:
        # 날짜 업데이트
        content = memory_index.read_text()
        lines = content.split('\n')
        lines[0] = f"# MEMORY.md — {date.today()}"
        memory_index.write_text('\n'.join(lines))
        print(f"✅ MEMORY.md 날짜 업데이트: {memory_index}")
    
    # line count 체크
    line_count = len(memory_index.read_text().split('\n'))
    if line_count > 200:
        print(f"⚠️  MEMORY.md {line_count}줄 — 200줄 이내 권장 (현재 모두 로드됨)")
    
    print(f"📍 Memory directory: {memory_dir}")
    return memory_dir

def create_feature_list(features: list, output_path: str = 'feature_list.json'):
    """장기 실행 태스크를 위한 JSON feature list 생성"""
    feature_list = [
        {
            'id': i + 1,
            'category': f.get('category', 'general'),
            'description': f.get('description', ''),
            'verification_steps': f.get('verification_steps', []),
            'passes': False,
            'notes': ''
        }
        for i, f in enumerate(features)
    ]
    
    with open(output_path, 'w') as file:
        json.dump({'features': feature_list, 'total': len(features), 'completed': 0}, file, indent=2, ensure_ascii=False)
    
    print(f"✅ {output_path} 생성 ({len(features)} features)")
    print("⚠️  JSON 형식 사용: 모델이 부적절하게 수정하는 것을 방지")

if __name__ == '__main__':
    memory_dir = setup_memory_structure()
    print(f"\n다음 세션에서 Claude Code는 자동으로 MEMORY.md를 로드합니다.")
    print(f"첫 200줄이 항상 컨텍스트에 포함됩니다.")