/ax:todo                      # 기본: 점검 + 비교 + 업데이트 제안 (전체 실행)
/ax:todo --sync               # + Confluence 동기화 실행
/ax:todo --compare-only       # 비교만 실행 (리포트 없이)
/ax:todo --report-only        # 진행현황 리포트만 출력
/ax:todo --dry-run            # 변경 없이 미리보기

┌────────────────────────────────────────────────────────────┐
│ 1단계: project-todo.md 파싱                                 │
│     ↓                                                       │
│ 2단계: 진행현황 분석 (Phase별 통계, 완료율)                   │
│     ↓                                                       │
│ 3단계: Confluence ToDo 조회 (페이지 ID 설정 시)              │
│     ↓                                                       │
│ 4단계: 비교 및 차이점 분석 (SyncDiff 생성)                   │
│     ↓                                                       │
│ 5단계: 리포트 출력 (Markdown 형식)                           │
│     ↓                                                       │
│ 6단계: 업데이트 제안 (코드베이스 컨텍스트 기반)              │
│     ↓ (--sync 옵션 시)                                      │
│ 7단계: Confluence 동기화 실행                                │
└────────────────────────────────────────────────────────────┘

from backend.services import todo_sync_service

# 시스템 ToDo 로드
system_todo = await todo_sync_service.load_system_todo("project-todo.md")
print(f"총 {len(system_todo.items)}개 항목, 버전: {system_todo.version}")

# 진행현황 리포트 생성
report = await todo_sync_service.generate_progress_report(system_todo)

print(f"완료율: {report.completion_rate}%")
print(f"완료: {report.completed}, 진행중: {report.in_progress}, 대기: {report.pending}")

# Confluence ToDo 로드 (CONFLUENCE_TODO_PAGE_ID 환경변수 필요)
confluence_todo = await todo_sync_service.load_confluence_todo()

# 시스템 vs Confluence 비교
diff = await todo_sync_service.compare(system_todo, confluence_todo)

if diff.has_diff:
    print(f"차이점 발견: {diff.summary}")

# Markdown 형식 리포트
markdown_report = report.to_markdown()
print(markdown_report)

# 📊 ToDo 진행현황 리포트

**생성일시**: 2026-01-17 10:30:00

---

## 📈 전체 현황

| 항목 | 건수 | 비율 |
|------|------|------|
| ✅ 완료 | 45 | 75% |
| 🚧 진행중 | 10 | 16.7% |
| 📋 대기 | 5 | 8.3% |
| **합계** | **60** | **100%** |

**완료율**: 75%

---

## 📁 Phase별 현황

| Phase | 완료 | 진행중 | 대기 | 완료율 |
|-------|------|--------|------|--------|
| Phase 1 | 15 | 0 | 0 | 100% |
| Phase 2 | 20 | 0 | 0 | 100% |
| Phase 3 | 8 | 7 | 5 | 40% |
| Phase 4 | 2 | 3 | 0 | 40% |

---

## 💡 권장 사항

- Phase 3에 미완료 항목이 5개 있습니다. 우선 처리하거나 스코프 조정을 검토하세요.

# 코드베이스 컨텍스트 기반 업데이트 제안
suggestions = await todo_sync_service.suggest_updates(
    system_todo,
    codebase_context="git diff output here..."
)

for suggestion in suggestions:
    print(f"- {suggestion}")

# Confluence에 동기화 (원장 → 미러)
result = await todo_sync_service.sync_to_confluence(system_todo)
print(f"동기화 결과: {result['status']}")

┌─────────────────────────────────────────────────┐
│  project-todo.md (원장)                          │
│         │                                        │
│         ├──→ /ax:todo --sync ──→ Confluence     │
│         │                        (읽기 전용 미러) │
│         │                                        │
│         └──← 수동 업데이트 (사용자/Claude)        │
└─────────────────────────────────────────────────┘

Project TODO (720932) ─────────────── 스프린트 단위 진행현황
    │
    ├── EXT_Desk_D01 ToDo List (753719) ── Play별 세부 작업
    ├── EXT_Desk_D02 ToDo List (TBD)
    └── ...

Play DB (720899) ──────────────────── 세부 작업 페이지 링크만 포함

CONFLUENCE_TODO_PAGE_ID=720932
CONFLUENCE_PLAY_DB_PAGE_ID=720899

# 1. Project TODO 하위에 페이지 생성
await confluence.create_page(
    title=f"{play_id} ToDo List",
    body_md=todo_content,
    parent_id="720932"  # Project TODO
)

# 2. Project TODO에 링크 추가
await confluence.append_to_page(
    page_id="720932",
    append_md=f"- [{play_id} ToDo List](page_url)"
)

# 3. Play DB에 링크 추가
await confluence.append_to_page(
    page_id="720899",
    append_md=f"- [{play_id} ToDo List](page_url)"
)

🔄 ToDo 점검 시작...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 1. project-todo.md 파싱
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 파싱 완료
   버전: 0.5.0
   총 항목: 60개
   Phase 수: 4개

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 2. 진행현황 분석
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

| 상태 | 건수 | 비율 |
|------|------|------|
| ✅ 완료 | 45 | 75% |
| 🚧 진행중 | 10 | 16.7% |
| 📋 대기 | 5 | 8.3% |

**완료율**: 75%

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 3. Confluence 비교
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

| 차이점 | 건수 |
|--------|------|
| 시스템에만 있음 | 3 |
| Confluence에만 있음 | 0 |
| 상태 차이 | 2 |
| 내용 차이 | 1 |

⚠️ 시스템과 Confluence 간 6개 차이점 발견

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 4. 업데이트 제안
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- [Phase3-5] 'WF-06 Confluence Sync...' - 관련 코드가 변경되었습니다. 완료 상태로 업데이트하세요.
- [Phase3-8] 'Teams 연동...' - 이전 Phase 항목이 아직 미완료입니다. 상태를 확인하세요.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 점검 완료
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 Confluence에 동기화하려면: /ax:todo --sync

... (위 출력에 이어서)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📤 5. Confluence 동기화
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 동기화 완료
   Page ID: 123456789
   동기화된 항목: 60개