docs: 세션 종료 — devlog + known-issues + STATUS.md 업데이트

- known-issues: WebDAV 501, anime action 분기 누락, 함수명 불일치 3건
- devlog: 007~013 (7건 추가)
- STATUS.md: NC 4모듈, Foreman, unified 라우팅 반영
- Vikunja: #418 done, #439 created+done
- Wiki: Status 페이지 동기화
This commit is contained in:
2026-03-18 21:50:06 +09:00
parent 28ae0d5853
commit 7a3df96a95
3 changed files with 40 additions and 5 deletions

View File

@@ -2,7 +2,7 @@
> AI 에이전트는 **세션 시작 시** 이 문서를 읽어 전체 맥락을 파악합니다.
> **세션 종료 시** 변경사항을 이 문서에 반영합니다.
> Last updated: 2026-03-17
> Last updated: 2026-03-18
## 시스템 개요
@@ -10,11 +10,12 @@ Hybrid Skill-Based AI Agent v3 — 사용자가 디스코드에서 자연어 명
```
Discord 메시지
Orchestrator.classify() — NLU 분류
unified prompt (Gemini 분류) → JSON 파싱
├── chat → 즉답
├── clarify → 질문
├── anime → AnimeTool (파이프라인)
── task → TaskPipeline.execute() → Gemini CLI agent 모드
├── anime → handle_anime_message (AnimePipeline)
── nextcloud → NCHandler (Files/Calendar/Mail/Contacts)
└── task → Gemini CLI agent 모드
```
## 핵심 설계 결정 (불변)
@@ -42,6 +43,13 @@ Discord 메시지
| Gitea Wiki 관리 | `.agent/workflows/helpers/wiki_helper.py` | Wiki 페이지 CRUD | ✅ |
| Discord Bot | `api/discord_bot.py` | 이벤트 핸들러 + NLU 라우팅 (~310줄) | ✅ |
| 커뮤니티 트렌드 | `tools/community_scraper.py` | DCInside 갤러리 인기글 스크래핑 + 랭킹 + 본문 조회 (Gemini Skill) | ✅ |
| NC 파일 관리 | `tools/nc_files.py` | Nextcloud WebDAV 파일 목록/검색/공유 (PROPFIND 폴백) | ✅ |
| NC 캘린더 | `tools/nc_calendar.py` | CalDAV 일정 CRUD (조회/추가/수정/삭제) | ✅ |
| NC 메일 | `tools/nc_mail.py` | IMAP 메일 조회/검색 (Mailcow PLAIN auth) | ✅ |
| NC 연락처 | `tools/nc_contacts.py` | CardDAV 연락처 조회/검색 | ✅ |
| NC 핸들러 | `handlers/nc_handler.py` | 자연어→NC 도구 라우팅 (Embed 응답) | ✅ |
| AI Foreman | `core/foreman.py` | 목표 분해 + 상담 + Vikunja 일괄 등록 (/goal) | ✅ |
| 통합 분류 라우팅 | `api/discord_bot.py` | unified prompt→JSON→모드별 핸들러 라우팅 | ✅ |
| CLI Bridge | - | Gemini CLI 영속 프로세스 (PTY 미지원으로 보류) | ⏸️ |
## 모듈 상태
@@ -53,12 +61,15 @@ Discord 메시지
| Gemini 래퍼 | `core/gemini_caller.py` | ✅ | text/agent 모드 |
| 컨텍스트 | `core/context_manager.py` | ✅ | 관련 파일 선별 + 토큰 예산 |
| 애니 파이프라인 | `tools/anime_pipeline.py` | ✅ | v2 에피소드 추출, 그룹 필터링, 자막 보호 |
| Discord Bot | `api/discord_bot.py` | ✅ | 레거시 800줄 제거, ~310줄 |
| Discord Bot | `api/discord_bot.py` | ✅ | unified classify→route, ~470줄 |
| 커뮤니티 스크래퍼 | `tools/community_scraper.py` | ✅ | DCInside 스크래퍼 + 4종 정렬 + Gemini Skill |
| NC 4모듈 | `tools/nc_*.py` | ✅ | Files/Calendar/Mail/Contacts |
| AI Foreman | `core/foreman.py` | ✅ | 목표 분해 + 상담 + Vikunja 등록 |
| 에이전트 워크플로우 | `.agent/` | ✅ | STATUS.md + 수칙 업데이트 |
## 최근 마일스톤
- **2026-03-18**: Nextcloud 4모듈 + NC핸들러 + AI Foreman v0.1 + unified 분류→라우팅 구현
- **2026-03-17**: 커뮤니티 트렌드 스크래퍼 구현 (DCInside 인기글 + Gemini Skill)
- **2026-03-16**: 에이전트 수칙 업데이트 + STATUS.md 도입 + .agents 통합
- **2026-03-15**: MCP 서버 제거 → CLI 직접 실행 전환