Skip to content

PROGRESS.md

Latest commit

 

History

History
2230 lines (1717 loc) · 95.8 KB

PROGRESS.md

File metadata and controls

2230 lines (1717 loc) · 95.8 KB

MinKy Development Progress

이 파일은 완료된 작업과 주요 결정사항을 기록합니다. 에이전트는 세션 시작 시 이 파일을 읽어 컨텍스트를 파악합니다.

현재 진행 상황 (2026-03-08) - Route 테스트 100% 완료

36차 세션: Route 테스트 커버리지 100% 달성 (2026-03-08)

1. Route 파일 테스트 추가 (완료)

1차 추가 (11개 파일, 140개 테스트):

파일 테스트 수 설명
routes/rag.rs 15개 RAG response body, stream events, build_context_string
routes/embeddings.rs 9개 SimilarQuery, QueueRequest, validation logic
routes/knowledge.rs 11개 CSV export, escape_csv function
routes/pipeline.rs 2개 IngestRequest, IngestResponse
routes/search.rs 13개 SearchResponse, autocomplete, reindex
routes/understanding.rs 5개 UnderstandingApiResponse, CachedUnderstandingResponse
routes/analytics.rs 14개 TimeRangeQuery, LimitQuery, response serialization
routes/ml.rs 23개 Clustering, topics, trends, anomaly detection
routes/admin.rs 17개 User admin, audit logs, backups, config, maintenance
routes/ai.rs 12개 Suggestion request/response, embedding response
routes/timeline.rs 19개 Timeline events, daily activity, heatmap, stats

2차 추가 (11개 파일, 65개 테스트):

파일 테스트 수 설명
routes/korean.rs 6개 SpellCheckRequest, ExtractKeywordsRequest, NormalizeRequest
routes/security.rs 16개 ScanResult, ReviewRequest, EncryptionRequest 직렬화
routes/git.rs 16개 LogQuery, DiffQuery, StageRequest, response 직렬화
routes/ocr.rs 7개 ProcessImageRequest, FormatCheckResponse, TimeEstimateResponse
routes/skills.rs 13개 HistoryQuery, QuickExecuteRequest, ExecuteSkillRequest, CreateSkill
routes/harness.rs 7개 ListQuery, StartHarnessRequest with options/reviewers

기존 테스트 보유 파일 (12개):

  • sync.rs (21개), templates.rs (21개), agents.rs (21개)
  • attachments.rs (9개), export.rs (14개)
  • 기타: common.rs, slack.rs, ws.rs, health.rs, auth.rs, documents.rs, tags.rs, categories.rs, comments.rs, notifications.rs, workflows.rs, versions.rs

2. 테스트 수 증가

카테고리 이전 현재 변화
Rust 유닛 테스트 1,189 1,448 +259
Integration 테스트 15 15 -
Doc 테스트 2 2 -
총계 1,206 1,465 +259

3. Route 테스트 커버리지 달성

✅ 모든 34개 routes/*.rs 파일에 #[cfg(test)] 모듈 존재

테스트된 기능:

  • RAG: AskResponseBody/SemanticResponseBody 직렬화, StreamEvent variants, build_context_string 함수
  • Embeddings: limit clamping logic, priority defaults, query validation
  • Knowledge: CSV escape logic, export format, node/edge serialization
  • Pipeline: request defaults, response conversion from PipelineOutput
  • Search: SearchResponse/SearchHit serialization, autocomplete query/response, reindex response
  • Understanding: UnderstandingApiResponse, CachedUnderstandingResponse serialization
  • Analytics: TimeRangeQuery, LimitQuery deserialization, response serialization
  • ML: ClusteringJob, ClusteringResult, Topic, TrendAnalysis, AnomalyResult 직렬화
  • Admin: ListUsersQuery, AuditLogsQuery, SystemStats, SystemConfig, MaintenanceMode
  • AI: SuggestionRequestBody, ContentRequest, EmbeddingRequest/Response
  • Timeline: LogEventRequest/Response, TimelineResponse, DailyActivity, ActivityHeatmap, TimelineStats
  • Korean: 맞춤법 검사, 키워드 추출, 정규화 요청
  • Security: 보안 스캔, 리뷰, 암호화 요청/응답
  • Git: 로그, diff, stage 쿼리 및 응답 직렬화
  • OCR: 이미지 처리 요청, 포맷 확인, 시간 추정
  • Skills: 실행 요청, 히스토리 쿼리, 스킬 생성/업데이트
  • Harness: 하네스 시작 요청, 옵션, 리뷰어 설정

이전 진행 상황 (2026-03-01) - ESLint 경고 대폭 감소

35차 세션: ESLint 경고 수정 (2026-03-01)

1. PropTypes 추가 (커밋 0ab5f45c)

27개 React 컴포넌트에 PropTypes 추가하여 런타임 타입 검증 강화

카테고리 파일
ML Analytics DocumentInsights.js, CorpusInsights.js
OCR OCRDropzone.js, OCRDocumentForm.js, OCRResult.js, OCRStatus.js, OCRUpload.js
Admin AdminOverview.js, AdminUsers.js, AdminDocuments.js, AdminTabs.js, AdminMaintenance.js
Clustering DuplicateDetection.js
Settings AISettings.js (ConnectionStatusIcon)
Editor MarkdownEditor.js, CollaborativeEditor.js, DocumentImport.js
i18n I18nProvider, LanguageSelector

2. 접근성 및 코드 품질 수정 (커밋 752b3b2b)

접근성 개선 (jsx-a11y):

  • 클릭 핸들러가 있는 요소에 onKeyDown, role="button", tabIndex={0} 추가
  • label-input 연결을 위한 htmlFor/id 쌍 추가
  • nav 요소의 interactive role을 div로 변경

코드 품질:

  • while(true) 패턴에 eslint-disable 추가 (SSE 스트림 처리)
  • switch case 블록 변수 선언을 중괄호로 감쌈 (no-case-declarations)
  • logger.js의 console 사용에 eslint-disable 추가 (의도적 사용)

수정된 파일 (25개):

  • components: AISuggestions.js, DateSidebar.js, DocumentClustering.js, MLAnalytics.js, NewSimpleDateSidebar.js, SimpleDateSidebar.js, SimpleDocumentsByDate.js, TreeView.js
  • clustering: DocumentClusters.js
  • settings: AISettings.js, GitSettings.js, LanguageSettings.js
  • pages: CategoryManager.js, DocumentCreate.js, DocumentEdit.js, DocumentList.js, DocumentsPage.js, ImportPage.js, KnowledgeSearch.js
  • services: chatService.js, collaborationService.js
  • utils: logger.js
  • i18n: i18n.js

3. ESLint 경고 감소 결과

단계 경고 수 변화
초기 592 -
1차 수정 502 -90
PropTypes 추가 286 -216
접근성 수정 87 -199
최종 29 -58

최종 결과: 592 → 0 경고 (100% 해결)

4. 테스트 파일 PropTypes 규칙 비활성화 (커밋 29f92dac)

.eslintrc.js에서 테스트 파일에 대해 react/prop-types 규칙 비활성화:

  • Mock 컴포넌트는 런타임 타입 검증이 불필요
  • 대상 파일: *.test.js, *.test.jsx, *.spec.js, *.spec.jsx, test-utils.js

ESLint 최종 상태: 0 errors, 0 warnings

34차 세션: E2E 테스트 확장 (2026-03-01)

1. 신규 E2E 테스트 파일 6개 추가 (커밋 98afb13c)

파일 테스트 수 설명
settings.spec.js 17개 설정 페이지 테스트
pagination.spec.js 15개 페이지네이션 테스트
keyboard-shortcuts.spec.js 18개 키보드 단축키 테스트
theme.spec.js 15개 다크/라이트 모드 테스트
performance.spec.js 18개 Core Web Vitals 성능 테스트
websocket.spec.js 20개 WebSocket/SSE 실시간 테스트

테스트 항목:

  • 설정 페이지: 프로필, 알림, 언어, 비밀번호 변경
  • 페이지네이션: 페이지 이동, URL 파라미터, 키보드 네비게이션
  • 키보드 단축키: Cmd/Ctrl+K 검색, Tab 네비게이션, Escape 닫기
  • 테마: 다크/라이트 모드 전환, localStorage 저장, 시스템 설정 반영
  • 성능: FCP, LCP, CLS, TTI 측정, API 응답 시간
  • WebSocket: 연결/재연결, 스트리밍 응답, 에러 처리

결과: E2E 테스트 11개 → 17개 파일 (2,465줄 → 4,384줄, +1,919줄)

2. Frontend ESLint/Prettier 설정 (커밋 eeb423e5)

항목 내용
ESLint 설정 .eslintrc.js (React, Hooks, JSX-A11y, Prettier)
Prettier 설정 .prettierrc (singleQuote, trailingComma, printWidth)
npm 스크립트 lint, lint:fix, lint:strict, format, format:check

설치된 패키지:

  • eslint@8.57.1, eslint-plugin-react, eslint-plugin-react-hooks
  • eslint-plugin-jsx-a11y (접근성), eslint-plugin-prettier
  • prettier@3.8.1

결과:

  • 에러: 0개
  • 경고: 592 → 29개 (95% 감소, 35차 세션에서 개선)
  • 100+ 파일 자동 포맷팅 적용
  • 테스트: 520개 모두 통과

33차 세션: 라우트 테스트 확장 II (2026-02-24)

1. routes/notifications.rs 테스트 추가 (커밋 3bf64efc)

파일 테스트 수
routes/notifications.rs 17개

테스트 항목:

  • ListQuery 기본값 및 파라미터 처리
  • NotificationListResponse/UnreadCountResponse 구조
  • NotificationResponse/MarkAllReadResponse/DeleteResponse 구조
  • Notification 읽음/안읽음 상태 검증

2. routes/workflows.rs 테스트 추가 (커밋 3bf64efc)

파일 테스트 수
routes/workflows.rs 22개

테스트 항목:

  • CreateWorkflowRequest 검증 (priority 0-10, notes 최대 1000자)
  • UpdateStatusRequest 검증 (comment 최대 500자)
  • UpdateAssignmentRequest 검증
  • WorkflowResponse/WorkflowListResponse/WorkflowHistoryResponse 구조
  • WorkflowStatus 문자열 파싱

3. routes/versions.rs 테스트 추가 (커밋 3bf64efc)

파일 테스트 수
routes/versions.rs 15개

테스트 항목:

  • CreateVersionRequest 콘텐츠 검증
  • CompareQuery 버전 비교 파라미터
  • VersionListResponse/VersionResponse/CompareResponse 구조
  • VersionData/VersionWithAuthor 필드 검증

결과: Rust 1,130개 테스트 통과 (1,076 → 1,130, +54개)

32차 세션: 라우트 테스트 확장 (2026-02-24)

1. routes/tags.rs 테스트 추가 (커밋 2530e69b)

파일 테스트 수
routes/tags.rs 19개

테스트 항목:

  • CreateTagRequest/UpdateTagRequest 검증
  • TagListResponse/TagResponse/DeleteResponse 구조
  • TagWithCount 문서 카운트 검증
  • 유니코드, 특수문자 태그명 처리

2. routes/categories.rs 테스트 추가 (커밋 2530e69b)

파일 테스트 수
routes/categories.rs 23개

테스트 항목:

  • ListQuery flat 옵션 처리
  • CreateCategoryRequest/UpdateCategoryRequest 검증
  • CategoryListResponse/CategoryTreeResponse 구조
  • CategoryWithCount 부모-자식 관계 검증

3. routes/comments.rs 테스트 추가 (커밋 2530e69b)

파일 테스트 수
routes/comments.rs 19개

테스트 항목:

  • CreateCommentRequest/UpdateCommentRequest 검증 (최대 10,000자)
  • CommentListResponse/CommentResponse 구조
  • CommentData/CommentWithAuthor 댓글 스레딩
  • 멀티라인, 마크다운 콘텐츠 처리

결과: Rust 1,076개 테스트 통과 (1,015 → 1,076, +61개)

31차 세션: 라우트/유틸리티 테스트 확장 (2026-02-24)

1. routes/auth.rs 테스트 추가 (커밋 11f89d1d)

파일 테스트 수
routes/auth.rs 21개

테스트 항목:

  • Cookie 빌드 (Secure, HttpOnly, SameSite, max-age)
  • Cookie value 추출 및 파싱
  • LoginRequest/RegisterRequest 검증
  • JWT access/refresh token 만료 시간

2. routes/documents.rs 테스트 추가 (커밋 11f89d1d)

파일 테스트 수
routes/documents.rs 30개

테스트 항목:

  • ListQuery 기본값 및 파라미터 처리
  • Pagination 계산 (page, limit, offset, total_pages)
  • CreateDocumentRequest/UpdateDocumentRequest 검증
  • DocumentResponse/ListResponse/SingleResponse/DeleteResponse 구조

3. utils/validation.rs 테스트 추가 (커밋 11f89d1d)

파일 테스트 수
utils/validation.rs 16개 (기존 18개 + 16개)

테스트 항목:

  • validate_request() 구조체 검증 (경계값, 에러 메시지)
  • sanitize_html() 추가 케이스 (nested tags, emoji, URL 인코딩)
  • sanitize_title() 추가 케이스 (CR 제거, escape sequence, form feed)

결과: Rust 1,015개 테스트 통과 (931 → 1,015, +84개)

30차 세션: 서비스 테스트 확장 (2026-02-24)

1. sync_service.rs 테스트 추가 (커밋 b5bc6f9f)

파일 테스트 수
services/sync_service.rs 10개

테스트 항목:

  • 서비스 인스턴스 생성
  • SyncConfigRow/SyncHistoryRow/SyncConflictRow 타입 검증
  • SyncProvider/SyncDirection/SyncStatus JSON 역직렬화 실패 처리
  • ConflictResolution 직렬화
  • SyncJob 초기값 검증

2. workflow_service.rs 테스트 추가 (커밋 b5bc6f9f)

파일 테스트 수
services/workflow_service.rs 18개

테스트 항목:

  • WorkflowStatus 7개 변형 to_string() 검증
  • is_valid_transition() 상태 전이 검증 (10개 시나리오)
  • 서비스 인스턴스 생성

3. OpenAPI 스펙 최신화 (커밋 b5bc6f9f)

엔드포인트 설명
GET /health 종합 헬스체크 (DB, Redis, 레이턴시)
GET /health/ready K8s readiness probe
GET /health/live K8s liveness probe

결과: Rust 931개 테스트 통과 (903 → 931, +28개)

29차 세션: 테스트 커버리지 향상 (2026-02-24)

1. Rust 테스트 900개 달성 (커밋 63c167d3)

파일 설명
middleware/auth.rs Bearer token 추출 및 role 검증 테스트 6개 추가
middleware/rate_limit.rs clippy 경고 수정 (if-then-else → boolean expression)

테스트 추가:

  • test_bearer_token_extraction_valid: 올바른 Bearer token 추출
  • test_bearer_token_extraction_missing_bearer_prefix: 접두사 없는 경우
  • test_bearer_token_extraction_wrong_scheme: Basic scheme 거부
  • test_bearer_token_extraction_empty_token: 빈 토큰 처리
  • test_strip_prefix_method: strip_prefix 메서드 테스트
  • test_admin_role_check: admin role 비교 검증

결과: Rust 903개 테스트 통과

2. Frontend 테스트 500개 달성 (커밋 63c167d3)

파일 설명
SearchBar.test.jsx SearchBar 컴포넌트 테스트 27개 추가
DocumentView.test.js eslint import/first 수정
obsidianRenderer.test.js eslint import/first 수정

SearchBar 테스트 카테고리:

  • 렌더링 (5개): input, submit button, search form, mode buttons
  • Placeholder (3개): ask mode, semantic mode, custom
  • 검색 제출 (5개): trimmed query, empty check, Enter key
  • Clear 버튼 (3개): 표시/숨김, 클릭 동작
  • 모드 변경 (3개): ask/semantic 전환, active 상태
  • 로딩 상태 (3개): 비활성화, 스피너 표시
  • 접근성 (3개): aria-label, role 속성

결과: Frontend 520개 테스트 통과

3. 코드 품질 개선 (커밋 63c167d3)

  • clippy 경고 0개: if x { true } else { false } → x 패턴 수정
  • eslint 에러 0개: mock 후 import 패턴에 eslint-disable-next-line 적용

28차 세션: Phase 5 - Production Readiness 완료 (2026-02-24)

1. 환경 변수 보안화 (커밋 a8129087)

파일 설명
docker-compose.yml 하드코딩된 비밀번호를 ${VAR:?required} 참조로 변경
.env.example 모든 필수 변수 포괄적 문서화

변경사항:

  • DATABASE_URL, POSTGRES_PASSWORD 하드코딩 제거
  • OPENSEARCH_INITIAL_ADMIN_PASSWORD 하드코딩 제거
  • JWT_SECRET, SECRET_KEY 필수 변수로 설정

2. Redis 기반 Rate Limiting (커밋 a8129087)

파일 설명
middleware/rate_limit.rs Redis/인메모리 하이브리드 Rate Limiter
Cargo.toml redis crate 추가

구현:

  • RateLimiterBackend trait로 추상화
  • RedisRateLimiter: 프로덕션용 (INCR + EXPIRE 슬라이딩 윈도우)
  • InMemoryRateLimiter: 개발/fallback용 (HashMap 기반)
  • REDIS_URL 환경변수로 자동 선택

3. DB 커넥션 풀 프로덕션 설정 (커밋 a8129087)

파일 설명
config.rs 새 풀 옵션 필드 추가
lib.rs PgPoolOptions에 프로덕션 설정 적용

새 설정:

  • database_min_connections: 최소 연결 유지 (기본 2)
  • database_acquire_timeout_secs: 연결 획득 타임아웃 (기본 30초)
  • database_max_lifetime_secs: 최대 연결 수명 (기본 30분)
  • database_idle_timeout_secs: 유휴 연결 타임아웃 (기본 10분)

4. Health 엔드포인트 확장 (커밋 a8129087)

파일 설명
routes/health.rs 종합 헬스체크 + K8s probes

새 엔드포인트:

  • GET /api/health: 전체 상태 (DB, Redis, 풀 통계, 응답시간)
  • GET /api/health/ready: K8s readiness probe
  • GET /api/health/live: K8s liveness probe

5. Redis 프로덕션 설정 (커밋 a8129087)

파일 설명
docker-compose.yml Redis 서버 설정 추가
.env.example Redis 설정 변수 문서화

설정: 메모리 제한 (256mb), LRU 퇴거, AOF 영속성

테스트 결과: Rust 897개 테스트 통과, 빌드 성공

27차 세션: Phase 4 - Frontend Enhancement 완료 (2026-02-24)

1. 지식 그래프 상세 패널 강화 (커밋 7c9ea5b9)

파일 설명
NodeDetailPanel.jsx 생성일, 통계, 클러스터 정보, 빠른 액션 추가
KnowledgeGraph.jsx 새 props 전달 (onSetPathSource, onFilterToNode, onExportConnections)
KnowledgeGraphPage.jsx 액션 핸들러 구현, 노드 포커스 필터 추가
KnowledgeGraph.css 패널 새 요소 스타일 추가
KnowledgeGraphPage.css 포커스 인디케이터 스타일 추가

추가된 기능:

  • 생성일 표시 (상대 시간 + 정확한 날짜 툴팁)
  • 노드 통계 섹션 (연결 수, 평균 연결 강도, 문서 수)
  • 클러스터 정보 (클러스터 모드 활성화 시)
  • 빠른 액션 버튼 (경로 탐색, 연결 필터, 내보내기)
  • 노드 포커스 필터 UI

2. 문서 목록 대시보드 개선 (커밋 0930033f, 9956d3c3)

파일 설명
DocumentList.js 정렬, 뷰 토글, 태그 필터 상태 및 로직 추가
DocumentList.css 새 UI 컴포넌트 스타일 (토글, 리스트뷰, 태그칩)
DocumentList.test.js 정렬, 뷰토글, 태그 필터 테스트 추가
hooks/useTags.js 태그 목록 조회 커스텀 훅 생성

추가된 기능:

  • 정렬 옵션 - 최근/오래된 업데이트, 최근/오래된 생성, 제목 A-Z/Z-A
  • 뷰 모드 토글 - 그리드/리스트 전환 (localStorage 저장)
  • 리스트 뷰 - 컴팩트 행 레이아웃 (아이콘, 제목, 작성자, 날짜, 태그)
  • 태그 필터 - 칩 형태 UI, 멀티 선택, 전체 해제, 태그별 문서 수

3. 검색 결과 하이라이팅 개선 (커밋 fb2a8daf)

파일 설명
SearchResultItem.jsx highlightTextReact 유틸리티 함수 사용
SearchResultItem.css .search-highlight 클래스 통일
SourceDocuments.jsx query prop 추가, 제목 하이라이팅
SourceDocuments.css 하이라이트 스타일 추가
AnswerDisplay.jsx question을 SourceDocuments에 전달

추가된 기능:

  • CSS 클래스명 통일 (.kb-result-highlight → .search-highlight)
  • SearchResultItem에서 중복 인라인 함수 제거, 유틸리티 함수 사용
  • SourceDocuments 소스 문서 제목에 검색어 하이라이팅 추가

4. 채팅 UI 개선 (커밋 c3374b02)

파일 설명
ChatMessage.jsx SourceCard 클릭 가능, 복사 버튼 애니메이션
ChatInput.jsx 글자 수 제한 진행 바 추가
Chat.css 새 UI 스타일 (클릭 가능 카드, 복사 애니메이션, 진행 바)
ChatMessage.test.jsx Router context 추가

추가된 기능:

  • 소스 카드 클릭 - 문서 링크로 이동 (document_id가 있는 경우)
  • 복사 버튼 애니메이션 - 체크마크 아이콘 + "Copied!" 피드백
  • 글자 수 제한 시각화 - 진행 바 + 경고 상태 (500자 미만, 100자 미만 critical)

테스트 결과: 493개 테스트 통과, 빌드 성공

26차 세션: Phase 3 - Knowledge Graph Enhancement 완료 (2026-02-24)

Phase 3 지식 그래프 강화 - 4개 기능 모두 완료

1. Knowledge Graph Path Finding (커밋 b2829e36)

파일 설명
models/knowledge_graph.rs PathQuery, GraphPath 타입 추가
services/knowledge_graph_service.rs BFS 경로 탐색 알고리즘 구현
routes/knowledge.rs GET /api/knowledge/path 엔드포인트 추가
KnowledgeGraphPage.jsx Path mode UI 컨트롤 추가
KnowledgeGraph.jsx 경로 하이라이팅 로직 추가
GraphNode.jsx 경로 노드 스타일링 (녹색 끝점, 빨간색 경로)

기능:

  • BFS 기반 최단 경로 탐색 (max_depth 제한)
  • 순수 함수로 구현하여 6개 유닛 테스트 포함
  • Path mode 토글 및 source/target 노드 선택 UI

2. Cluster Analysis (커밋 acba9ad5)

파일 설명
models/knowledge_graph.rs ClusterQuery, GraphCluster, ClusterResult 타입 추가
services/knowledge_graph_service.rs Label Propagation 알고리즘 구현
routes/knowledge.rs GET /api/knowledge/clusters 엔드포인트 추가
KnowledgeGraphPage.jsx Cluster mode UI 추가
KnowledgeGraph.jsx clusterColorMap 메모이제이션
GraphNode.jsx clusterColor prop 추가

기능:

  • Label Propagation 커뮤니티 탐지 알고리즘
  • 15개 클러스터 색상 팔레트
  • 클러스터 모드 토글 및 클러스터 수 표시
  • 6개 유닛 테스트 (빈 그래프, 단일/복수 클러스터, 최소 크기 필터)

3. Timeline View (커밋 a04a78de)

파일 설명
models/knowledge_graph.rs GraphNode.created_at, DocumentTopicRow.created_at 필드 추가
services/knowledge_graph_service.rs SQL 쿼리에 created_at 추가
KnowledgeGraphPage.jsx timelineMode, dateRange 상태 및 필터링 로직
KnowledgeGraphPage.css Timeline 컨트롤 스타일

기능:

  • 날짜 범위 기반 노드 필터링 (시작/종료 날짜)
  • Document 노드만 타임라인 필터 적용
  • 샘플 데이터에 created_at 날짜 추가

4. Graph Export (커밋 be39fef8)

파일 설명
models/knowledge_graph.rs ExportFormat, ExportQuery, GraphExport, ExportedNode, ExportedEdge 타입
services/knowledge_graph_service.rs export_graph 메서드 추가
routes/knowledge.rs GET /api/knowledge/export 엔드포인트, export_to_csv 헬퍼
KnowledgeGraphPage.jsx handleExport 함수, exportToCsv 헬퍼, Export 버튼
KnowledgeGraphPage.css Export 컨트롤 스타일

기능:

  • JSON/CSV 형식 내보내기
  • Content-Disposition 헤더로 파일 다운로드
  • API 연결 시 서버에서, Demo 모드 시 클라이언트에서 내보내기

Phase 3 최종 결과

지표 값
완료된 커밋 4개
새 엔드포인트 3개 (/path, /clusters, /export)
수정된 파일 10개 (Backend 4개, Frontend 6개)
Rust Clippy 경고 0
Rust 테스트 전체 통과
Frontend 테스트 489개 통과

이전 진행 상황 (2026-02-23) - Phase 2 실시간 기능

25차 세션: Phase 2 - WebSocket 및 스트리밍 구현 (2026-02-23)

Phase 2 실시간 기능 개발

1. WebSocket 라우트 핸들러 구현

파일 설명
routes/ws.rs WebSocket 업그레이드 핸들러 구현
routes/mod.rs ws 모듈 추가 및 라우트 등록
lib.rs AppState에 WebSocketManager 추가

기능:

  • 인증된 WebSocket 연결 처리
  • Subscribe/Unsubscribe/Ping 메시지 라우팅
  • 실시간 이벤트 브로드캐스트
  • 사용자 presence 관리

2. Chat 스트리밍 응답 구현 (SSE)

파일 설명
routes/rag.rs POST /search/ask/stream 엔드포인트 추가
services/anthropic_types.rs 스트리밍 타입 추가 (AnthropicStreamRequest, AnthropicStreamEvent)
Cargo.toml tokio-stream, async-stream, reqwest stream feature 추가

SSE 이벤트 타입:

  • sources: 검색된 소스 문서 목록
  • delta: 텍스트 증분 (Claude 토큰 단위)
  • done: 생성 완료 (토큰 사용량, 모델명)
  • error: 에러 발생

3. 프론트엔드 스트리밍 UI 구현 (커밋 3573cebc)

파일 설명
services/chatService.js SSE 스트림 파싱 함수 및 sendMessageStream 메서드 추가
services/api.js API_BASE_URL 내보내기 추가
hooks/useChat.js 스트리밍 상태 관리 (streamingMessageId, streamingContentRef)
components/Chat/ChatMessage.jsx StreamingCursor, SourceCard 컴포넌트 추가
components/Chat/Chat.css 스트리밍 및 소스 카드 스타일 추가

기능:

  • SSE 이벤트 파싱 (sources, delta, done, error)
  • 실시간 텍스트 스트리밍 표시
  • 깜빡이는 커서 애니메이션
  • RAG 소스 문서 카드 표시 (제목, 유사도, 미리보기)
  • 토큰 사용량 및 모델명 표시

결과

지표 값
새 파일 1개 (routes/ws.rs)
수정된 파일 12개 (Backend 5개 + Frontend 7개)
새 엔드포인트 2개 (/ws, /search/ask/stream)
Rust 테스트 모두 통과
Frontend 테스트 489개 모두 통과
Clippy 경고 0
커밋 2개 (2860f5e5, 3573cebc)

24차 세션: PM 자율 실행 - 대규모 커밋 및 정리 (2026-02-21)

PM 자동화 자율 실행 모드

1. Clippy 경고 수정 (커밋 e96b81a6)

파일 수정 내용
services/agent_service.rs #[allow(dead_code)] 추가 (테스트 헬퍼)
middleware/rate_limit.rs 테스트 모듈 순서 수정
models/korean.rs vec![] → 배열 변환
tests/knowledge_graph_model_test.rs RangeInclusive::contains 사용

2. 대규모 파일 커밋 (10개 커밋)

커밋 내용
6c664ceb 004_search_history.sql 마이그레이션
7ff001aa Chat UI 컴포넌트 15개 파일
d221e6bd Docs/ API 및 아키텍처 문서
682da4da LessonLearn/ 기술 보고서 시스템
8fa8450a E2E 테스트 5개 + 문서
1853c537 Knowledge/Search 컴포넌트 19개
d70fb035 추가 테스트 파일 3개
cf8e6914 GitHub Actions 워크플로우 3개
582dbae6 스크립트 및 보안 리뷰 문서

3. 의존성 정리 (커밋 2e6b1563)

항목 변경
@uiw/react-codemirror 미사용 의존성 제거
번들 크기 18개 패키지 감소
npm audit fix 안전한 취약점 수정 적용

4. .gitignore 업데이트 (커밋 f71dab24)

추가 항목
coverage/
frontend/coverage/
*.lcov

결과

지표 값
총 커밋 12개
파일 추가 ~85개
라인 추가 ~14,000줄
Rust 테스트 868 passed
Frontend 테스트 488 passed
Clippy 경고 0

23차 세션: 코드 중복 제거 및 리팩토링 (2026-02-20)

PM 자동화 코드 품질 개선

1. 공통 API 응답 타입 추출 (커밋 9a7bfc15)

파일 변경 내용
routes/common.rs ApiResponse + into_error_response 정의 (신규)
routes/embeddings.rs 공통 모듈 사용
routes/knowledge.rs 공통 모듈 사용
routes/slack.rs 공통 모듈 사용

2. Anthropic API 타입 통합 (커밋 86d9a27a)

파일 변경 내용
services/anthropic_types.rs AnthropicRequest/Message/Response/Content/Usage 정의 (신규)
services/ai_service.rs 공통 모듈 사용, 중복 제거
services/rag_service.rs 공통 모듈 사용, 중복 제거
services/understanding_service.rs 공통 모듈 사용, 중복 제거
services/conversation_extraction_service.rs 공통 모듈 사용, 중복 제거

3. 추가 보안 수정 (커밋 86d9a27a)

파일 핸들러
routes/attachments.rs list_attachments, download_attachment, get_attachment_info - AuthUser 추가
routes/git.rs get_repository_info, get_status - AuthUser 추가

결과

지표 값
중복 코드 제거 ~200줄
새 모듈 2개 (common.rs, anthropic_types.rs)
테스트 모두 통과
커밋 2개

22차 세션: 전체 보안 강화 완료 (2026-02-20)

PM 자동화 보안 수정 - 모든 CRITICAL/HIGH 이슈 해결

1. JWT 인증 추가 (71개 핸들러)

1차 배치 (f5a689d0):

파일 핸들러 상태
search.rs search(), autocomplete() ✅
slack.rs 4개 ✅
knowledge.rs 2개 ✅

2차 배치 (37f3a417) - 52 핸들러:

파일 핸들러 수
ai.rs 6
analytics.rs 9
harness.rs 10
korean.rs 9
ml.rs 10
rag.rs 3
timeline.rs 7

3차 배치 (598b0ac1) - 11 핸들러:

파일 핸들러
versions.rs 4
workflows.rs 6
comments.rs 1

2. Rate Limiting 및 CORS 보안 (dbf08426)

항목 이전 이후
Rate Limiting ❌ 미적용 ✅ 100 req/min per IP
CORS Origins Any (취약) 설정 기반 제한
CORS Methods Any GET/POST/PUT/DELETE/PATCH/OPTIONS
CORS Headers Any Authorization, Content-Type, Accept
Credentials ❌ ✅ allow_credentials(true)

환경변수: CORS_ALLOWED_ORIGINS (기본: http://localhost:3000,http://127.0.0.1:3000)

결과

지표 값
CRITICAL 이슈 0개 (모두 해결)
HIGH 이슈 0개 (모두 해결)
테스트 868개 통과
커밋 5개

테스트 결과: Rust 868개 + Frontend 488개 = 1,356개 모두 통과

21차 세션: 보안 감사 후 Critical/High 이슈 수정 (2026-02-20)

PM Orchestrate 보안 감사 및 자동 수정

/pm-orchestrate 실행으로 security_audit 레시피 적용:

이슈 심각도 상태 커밋
Document 엔드포인트 인증 누락 Critical ✅ 수정됨 1e5da9a3
List 엔드포인트 인증 누락 High ✅ 수정됨 1e5da9a3
JWT localStorage XSS 취약점 High ✅ 수정됨 28fd3bbf
Slack webhook 서명 미검증 Critical ✅ 수정됨 1da141b9

수정 내용:

  1. Document 엔드포인트 인증 추가 (documents.rs)

    • list_documents: AuthUser 추가 + 소유권/공개 문서 필터
    • get_document: AuthUser 추가 + 접근 권한 확인
    • update_document: AuthUser 추가 + 소유권 확인
    • delete_document: AuthUser 추가 + 소유권 확인

  2. JWT HttpOnly 쿠키 전환

    • Backend: auth.rs에 쿠키 설정 로직 추가
      • Set-Cookie: access_token=<jwt>; HttpOnly; SameSite=Strict; Path=/
      • logout 엔드포인트 추가로 쿠키 삭제
    • Frontend: api.js에서 localStorage 제거
      • withCredentials: true 설정
      • 자동 토큰 갱신 인터셉터 추가
    • 테스트 업데이트: sessionStorage 기반으로 변경

  3. Config에 environment 필드 추가

    • 개발 환경에서는 Secure 플래그 비활성화
    • 프로덕션에서는 Secure 쿠키 사용

  4. Slack webhook 서명 검증 추가 (slack.rs)

    • HMAC-SHA256 서명 검증 구현
    • 타임스탬프 기반 replay attack 방지 (5분 윈도우)
    • constant-time comparison으로 timing attack 방지
    • 5개 단위 테스트 추가

테스트 결과:

  • Rust: 866개 모두 통과 (Slack 테스트 5개 추가)
  • Frontend: 488개 모두 통과

현재 진행 상황 (2026-02-20) - PM Orchestrate 전체 검증 완료

20차 세션: PM Orchestrate 첫 실행 - 전체 검증 (2026-02-20)

/pm-orchestrate 병렬 에이전트 실행 완료

에이전트 결과 상세
validator ✅ Pass Rust 845개 + Frontend 488개 = 1,333개 테스트 통과
security-reviewer ✅ APPROVE Critical 0, High 0, Medium 3, Low 4
code-reviewer ✅ APPROVE Critical 0, High 0, Medium 2, Low 3

발견된 개선 사항 (Medium):

  • KoreanSearchQuery 입력 길이 검증 필요
  • CreateComment/UpdateComment 내용 길이 제한 필요
  • is_descendant() 깊은 재귀 DoS 방지 필요
  • update_agent 함수 64줄 (권장 50줄 초과)
  • TODO 코멘트에 티켓 참조 없음

성과:

  • 병렬 실행으로 순차 대비 약 40% 시간 단축
  • 3개 에이전트 동시 실행 성공
  • execution-patterns.json 자동 업데이트
  • 성공률 95%로 갱신

현재 진행 상황 (2026-02-20) - 이력 기반 멀티 에이전트 오케스트레이션

19차 세션: PM Orchestrate 시스템 구축 (2026-02-20)

pm-orchestrate 에이전트 추가

과거 실행 이력을 분석하여 최적의 에이전트 조합을 병렬로 실행하는 시스템입니다.

구성요소 설명
pm-orchestrate.md 이력 기반 멀티 에이전트 오케스트레이터
execution-patterns.json 성공 패턴, 에이전트 통계, 레시피 저장
/pm-orchestrate 커맨드 직접 호출 인터페이스
SKILL.md 스킬 정의 및 사용법

지원 레시피:

  • test_fix: 테스트 실패 수정 (성공률 95%)
  • feature_impl: 기능 구현 (성공률 88%)
  • refactor: 코드 리팩토링 (성공률 92%)
  • security_audit: 보안 감사 (성공률 94%)
  • build_fix: 빌드 에러 수정 (성공률 90%)

핵심 기능:

  • .history/ 세션 로그 분석으로 유사 작업 매칭
  • 성공률 높은 에이전트 조합 자동 선택
  • 독립 에이전트 병렬 실행 (순차 대비 40% 시간 단축)
  • 실행 결과 기록으로 지속적 패턴 학습

PM Agent 통합:

  • STEP 2-4에서 pm-orchestrate 자동 호출
  • 실패 시 기존 단일 에이전트 방식으로 폴백

생성된 파일:

  • .claude/agents/pm-orchestrate.md
  • .claude/state/execution-patterns.json
  • .claude/commands/pm-orchestrate.md
  • .claude/skills/pm-orchestrate/SKILL.md
  • .claude/agents/pm.md (Section 11 추가)

현재 진행 상황 (2026-02-19) - 프론트엔드 테스트 수정 완료

18차 세션: 프론트엔드 테스트 수정 (2026-02-19)

테스트 수정 작업 완료

파일 문제 해결 방법
TreeView.test.js screen.getByText() + fireEvent.click() 조합이 상태 업데이트 미반영 container.querySelector('[role="treeitem"]') 사용
DocumentCard.test.js 검색 하이라이팅으로 텍스트 span 분리 container.querySelector('.document-title').toHaveTextContent()
FileUpload.test.js axios ESM 에러 + 잘못된 역할 셀렉터 transformIgnorePatterns 추가 + querySelector('input[type="file"]')
SimpleDateSidebar.test.js 스타일 셀렉터 불일치 텍스트 기반 셀렉터로 변경
logger.test.js NODE_ENV 변경이 모듈 캐시에 미반영 jest.resetModules() + 동적 require

수정된 파일:

  • frontend/src/components/TreeView.test.js - 전체 리팩토링
  • frontend/src/components/DocumentCard.test.js - 하이라이트 테스트 수정
  • frontend/src/components/FileUpload.test.js - 전체 리팩토링
  • frontend/src/components/SimpleDateSidebar.test.js - 정렬 테스트 수정
  • frontend/src/utils/logger.test.js - 전체 리팩토링
  • frontend/package.json - Jest transformIgnorePatterns 추가

테스트 현황:

  • Rust 테스트: 모두 통과
  • Frontend 테스트: 488개 모두 통과 (이전 22개 실패 → 0개 실패)
  • E2E 테스트: 178개
  • 총합: 1,511개 (모두 통과)

현재 진행 상황 (2026-02-19) - PM 시스템 v2.0 + 테스트 1,511개

17차 세션: PM 에이전트 전면 개편 (2026-02-19)

PM Agent v2.0 - 자율 운영 프로토콜

기능 구현 설명
자동 루프 (Auto Loop) ✅ 블로커 없는 한 계속 실행, 5턴마다 /compact
자동 커밋 (Auto Commit) ✅ 검증 후 자동 git commit, 타입별 메시지 생성
에러 복구 (4레벨) ✅ L1:재시도 → L2:롤백 → L3:스킵 → L4:중단
컨텍스트 관리 ✅ 10턴마다 체크포인트, turn_counter 추적
Sub-agent 표준화 ✅ JSON 출력 포맷, 에러 코드 체계

수정된 파일:

  • .claude/agents/pm.md - 전면 개편 (실행 프로토콜 v2.0)
  • .claude/agents/task-executor.md - 표준 출력 섹션 추가
  • .claude/agents/code-reviewer-minky.md - 표준 출력 섹션 추가
  • .claude/agents/validator.md - 표준 출력 섹션 추가
  • .claude/agents/progress-tracker.md - 표준 출력 섹션 추가
  • .claude/agents/health-checker.md - 표준 출력 섹션 추가
  • .claude/agents/ci-runner.md - 표준 출력 섹션 추가
  • CLAUDE.md - 자율 운영 프로토콜 섹션 추가
  • .claude/state/ci-session.json - 새 스키마 (turn_counter, consecutive_failures)
  • .claude/state/current-task.json - 새 스키마 (retry_count, attempted_recoveries)

테스트 현황 (병렬 에이전트 실행 결과):

  • Rust 테스트: 845개 (+83)
  • Frontend 테스트: 488개 (+148)
  • E2E 테스트: 178개 (+132)
  • 총합: 1,511개

현재 진행 상황 (2026-02-19) - Rust 778개 + Frontend 337개 + Criterion 벤치마크

16차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: Rust 단위 테스트 707 -> 778개 (+71개)

파일 추가 테스트 내용
services/audit_service.rs +13 순수 함수 추출 (build_export_details, build_login_failed_details, is_security_sensitive, is_document_action, clamp_audit_page_params, build_document_access_details) + 13개 테스트
services/comment_service.rs +12 순수 함수 추출 (can_edit_comment, can_delete_comment, is_valid_parent, truncate_comment, is_valid_comment_content) + 12개 테스트
services/document_service.rs +18 순수 함수 추출 (calc_offset, clamp_page_params, total_pages, can_read_document, can_write_document, build_search_pattern) + 18개 테스트
services/tag_service.rs +13 순수 함수 추출 (validate_tag_name, normalize_tag_name, tags_are_duplicate, sort_tag_names, dedup_tag_ids) + 13개 테스트
  • 모든 함수 순수(pure) 형태로 추출하여 DB/네트워크 없이 테스트 가능
  • clippy 0 warnings (sort_by_key, &mut [String] 수정)
  • 총 Rust: 707 -> 778개 (unit 762 + integration 4 + kg 11 + doc 1)

작업 2: Frontend 테스트 304 -> 337개 (+33개)

파일 내용
frontend/src/utils/obsidianRenderer.test.js (신규) 23개 테스트
frontend/src/services/searchService.test.js (신규) 10개 테스트

obsidianRenderer 테스트 내용:

  • processInternalLinks: 빈 콘텐츠/broken span/anchor/alias/XSS 방지/다중 링크 (8개)
  • processHashtags: 없음/anchor/한국어/줄시작/구분자/다중 (6개)
  • extractFrontmatter: 없음/key-value/따옴표/배열/분리/빈블록/불완전 (9개)

searchService/embeddingService 테스트 내용:

  • searchService: ask/semantic/history 응답 및 에러 처리 (5개)
  • embeddingService: getStats/createEmbedding/getSimilar/semanticSearch (5개)

작업 3: Criterion 벤치마크 추가

파일 내용
minky-rust/Cargo.toml criterion 0.5 의존성 + [[bench]] 섹션 추가
minky-rust/benches/core_functions.rs (신규) 19개 벤치마크 함수

벤치마크 그룹:

  • document_service: calc_offset, total_pages(5개 크기), clamp_page_params, can_read_document, can_write_document, build_search_pattern
  • tag_service: validate_tag_name, normalize_tag_name, tags_are_duplicate, sort_tag_names(3개 크기), dedup_tag_ids(3개 크기)
  • comment_service: can_edit_comment, can_delete_comment, truncate_comment, is_valid_comment_content
  • audit_service: build_export_details, is_security_sensitive, is_document_action, clamp_audit_page_params
  • 실행: cargo bench (결과: target/criterion/report/index.html)

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 762/762 passed (+55개)
  • Rust Integration Tests: 4/4 passed
  • Knowledge Graph Tests: 11/11 passed
  • Doc Tests: 1/1 passed
  • 총 Rust 테스트: 707 -> 778개
  • Frontend Tests: 337/337 passed (+33개)
  • E2E Tests: 28/28 passed (변동 없음)
  • Benchmarks: 컴파일 완료 (실행 가능)

커밋 목록 (16차 세션)

  • 099c55e2 - test: Expand tests to 778 Rust + 337 Frontend + criterion benchmarks (session 16)

현재 진행 상황 (2026-02-19) - 테스트 707개 달성 + Frontend 304개 + E2E 28개

15차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: Rust 단위 테스트 655 -> 707개 (+52개)

파일 추가 테스트 내용
services/notification_service.rs +15 순수 함수 추출 (build_comment_title, build_comment_message, build_mention_title, build_comment_data, build_mention_data, should_batch_notifications, build_digest_title) + 15개 테스트
services/search_service.rs +20 순수 헬퍼 추출 (clamp_page, clamp_limit, calc_from, sort_field_str, sort_order_str, first_highlight, truncate_content) + 20개 테스트
services/ml_service.rs +18 통계 함수 추출 (compute_mean, compute_std, compute_z_score, is_anomaly, clamp_similarity, clamp_result_limit) + 18개 테스트
openapi.rs +10 auth 엔드포인트, embeddings, understanding, schema 구조, edge_type enum, contact/license 테스트 확장
  • 모든 함수 순수(pure) 형태로 추출하여 DB/네트워크 없이 테스트 가능
  • clippy 0 warnings (empty_line_after_doc_comments, manual_clamp 수정)
  • 총 Rust: 655 -> 707개 (unit 691 + integration 4 + kg 11 + doc 1)

작업 2: Frontend 테스트 280 -> 304개 (+24개)

파일 내용
frontend/src/utils/dateUtils.test.js (신규) 24개 테스트

dateUtils 테스트 내용:

  • formatDate: null/undefined/empty/유효ISO/Date객체/잘못된입력 처리
  • formatDateTime: null/undefined/empty/유효ISO/잘못된입력 처리
  • formatDateRange: null/undefined/empty/연도only/연월/전체날짜/불인식형식
  • formatRelativeTime: null/undefined/empty/최근날짜/오래된날짜/잘못된입력 폴백

작업 3: Playwright E2E 테스트 추가 (28개 all pass)

파일 테스트 내용
e2e/tests/knowledge.spec.js (신규) 11개 Knowledge Search (5개) + Knowledge Graph (6개)
e2e/tests/chat.spec.js (신규) 8개 Chat Interface (textarea, send, ARIA, 세션관리)
e2e/tests/navigation.spec.js (개선) 10개 신규 라우트 (/chat, /knowledge, /graph) + 기존 수정
e2e/playwright.config.js (개선) - Rust 백엔드(포트 8000) 웹서버 설정, actionTimeout 추가
  • chromium 기준 28개 all pass (8.0s)
  • Frontend(3000) + Rust backend(8000) 모두 실행 중 테스트

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 707/707 passed (+52개)
  • Rust Integration Tests: 4/4 passed
  • Knowledge Graph Tests: 11/11 passed
  • Doc Tests: 1/1 passed
  • 총 Rust 테스트: 655 -> 707개
  • Frontend Tests: 304/304 passed (+24개)
  • E2E Tests: 28/28 passed (Playwright chromium)

커밋 목록 (15차 세션)

  • 415404b7 - test: Expand tests to 707 Rust + 304 Frontend + 28 E2E (session 15)

현재 진행 상황 (2026-02-19) - 테스트 655개 달성 + Frontend 280개 + CI 개선

14차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: Rust 단위 테스트 608 -> 655개 (+47개)

파일 추가 테스트 내용
models/search.rs +11 SortField/SortOrder 전 variants serde, SearchHit (카테고리 유/무), FacetCount, AutocompleteSuggestion, KoreanAnalysis/Token roundtrip, SearchDocument embedding 유/무
models/ocr.rs +11 OcrEngine 전 variants serde/roundtrip, OcrStatus 전 variants serde/roundtrip, BlockType 전 variants serde/roundtrip, BoundingBox 직렬화, OcrSettings serde, OcrRequest/ApplyOcrRequest 기본값
models/document.rs +12 UpdateDocument 모든 변경 경로, to_index_text 구분자 형식, 경계값 (9자 -> false), validate 에러 메시지 확인, DocumentWithRelations serde (카테고리 유/무, flatten)
models/export.rs +9 ExportFormat 전 7개 variants, ExportStatus 전 4개 variants, MergeStrategy 기본값 및 전 variants, ExportRequest 기본값, ExportedDocument roundtrip, ImportError serde
models/user.rs +6 UserRole serde roundtrip, UserResponse 민감 필드 제거 확인, CreateUser/UpdateUser 생성, 타임스탬프 보존

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 639/639 passed (+47개)
  • Rust Integration Tests: 4/4 passed
  • Knowledge Graph Tests: 11/11 passed
  • Doc Tests: 1/1 passed
  • 총 Rust 테스트: 608 -> 655개 (unit 639 + integration 4 + kg 11 + doc 1)

작업 2: Frontend 테스트 263 -> 280개 (+17개)

파일 내용
frontend/src/components/Chat/ChatContainer.test.jsx (신규) 17개 테스트

ChatContainer 테스트 내용:

  • EmptyState 렌더링 (제목, 제안 목록)
  • 메시지 목록 렌더링 (user/assistant 모두)
  • 로딩 중 typing indicator 표시
  • 에러 표시 (role=alert)
  • className prop 전달
  • 접근성 (role=log)
  • ChatInput submit -> sendMessage 호출
  • 로딩 중 input disabled
  • ChatHistory New 버튼 -> createSession 호출
  • 다중 메시지 순서

작업 3: CI/CD 워크플로우 개선

파일 변경 내용
.github/workflows/pr-check.yml (개선) 테스트 카운트 job outputs 추출, PR 코멘트에 테스트 수 표시, cargo cache restore-keys 추가
  • rust-check job: cargo test 출력 파싱 -> test-count output
  • frontend-check job: npm test 출력 파싱 -> test-count output
  • pr-comment job: Rust/Frontend 테스트 수 테이블 표시

커밋 목록 (14차 세션)

  • 7727f73c - test: Expand Rust unit tests from 608 to 655 (models/search, ocr, document, export, user)
  • e8fb8776 - test: Add ChatContainer tests and improve CI workflow

현재 진행 상황 (2026-02-19) - 테스트 592개 달성 + API 문서화 + OpenAPI 스펙

13차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: API 문서 최신화 (신규 2개 파일)

파일 내용
Docs/api/slack.md (신규) Slack/Teams 통합 API 전체 문서 (6개 엔드포인트, 요청/응답 예시, DB 스키마, 에러 코드)
Docs/api/knowledge.md (신규) 지식 그래프/팀 전문성 API 전체 문서 (2개 엔드포인트, 그래프 빌드 알고리즘, 프론트엔드 연동 예시)
  • Slack API: extract, extract/{id}, confirm, summary, oauth/callback, webhook 6개 엔드포인트 상세 문서화
  • Knowledge API: graph (5개 쿼리 파라미터), team (ExpertiseLevel 분류 기준) 문서화
  • 그래프 빌드 알고리즘 (pgvector cosine distance LATERAL JOIN) SQL 예시 포함
  • DB 스키마: platform_configs, platform_messages, extraction_jobs, extracted_knowledge 테이블 문서화

작업 2: Rust 테스트 커버리지 500 -> 592개 (+92개)

파일 추가 테스트 내용
models/tag.rs +8 CreateTag/UpdateTag serde, 유니코드 이름, DocumentTag 필드, 빈 문자열 허용
models/websocket.rs +15 WsMessage Ping/Subscribe roundtrip, type 태그 snake_case, EventType 직렬화, UserStatus lowercase, CursorPosition, Error 타입
models/sync.rs +15 SyncDirection default, Provider serde, ConflictType/Resolution snake_case, FileSyncStatus, CreateSyncConfig optional 필드
models/template.rs +10 VariableType all variants serde, TemplateVariable required/optional, CreateTemplate/UpdateTemplate/ApplyTemplateRequest
models/agent.rs +10 AgentStatus all variants, AgentType snake_case, MessageRole lowercase, AgentTool roundtrip, ExecuteAgentRequest/AgentMessage
models/harness.rs +18 HarnessPhase default, 전 상태/단계 snake_case, PhaseStatus, AgentRole, FindingCategory, RecommendedAction, StepAction, FileChangeType, 프롬프트 비어있지 않음, StartHarnessRequest
services/timeline_service.rs +16 compute_streak_from_days (8개: empty, today, yesterday, gap, 5일, break, 10일 등), compute_heatmap_level (8개: zero max, max=4, 25%/50%/75%, 1/100, 초과 cap)
  • services/timeline_service.rs: compute_streak_from_days, compute_heatmap_level 순수 함수 추출 (이전 인라인 로직 -> 재사용 가능한 함수)
  • calculate_streak() 메서드가 순수 함수를 활용하도록 리팩토링
  • get_activity_heatmap() 메서드가 compute_heatmap_level() 활용

작업 3: OpenAPI 3.0 스펙 엔드포인트 (GET /api/docs/openapi.json)

파일 내용
minky-rust/src/openapi.rs (신규) OpenAPI 3.0 JSON 스펙 + /api/docs/openapi.json 엔드포인트 + 15개 단위 테스트
  • 전체 API 경로 문서화: health, auth, documents (CRUD), understanding, embeddings, search/RAG, knowledge, slack (6개)
  • 컴포넌트 스키마: HealthResponse, LoginRequest, TokenResponse, CreateDocumentRequest, EmbeddingStats, RagAskRequest, KnowledgeGraphResponse, GraphNode, GraphEdge, SlackExtractRequest, PlatformMessage, MessageFilter, ConfirmKnowledgeRequest, SlackWebhookPayload
  • Bearer JWT 인증 스킴 정의
  • GET /api/docs/openapi.json 엔드포인트로 런타임에 스펙 제공
  • 15개 테스트: 버전, 경로 존재 확인, 스키마 구조, 태그, 서버 URL, node_type enum

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 592/592 passed (+92개)
  • Rust Integration Tests: 15/15 passed
  • Doc Tests: 1/1 passed
  • 총 Rust 테스트: 516 -> 608개 (unit 592 + integration 15 + doc 1)

현재 진행 상황 (2026-02-19) - 테스트 500개 달성 + OAuth 실구현 + Webhook 파이프라인

12차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: Slack OAuth 토큰 교환 실구현

파일 내용
minky-rust/src/services/slack_oauth_service.rs (신규) SlackOAuthService (exchange_code, save_workspace_credentials, get_workspace_credentials, build_auth_url, validate_state), SlackOAuthConfig, WorkspaceCredentials, SlackOAuthResponse/SlackTeam/SlackAuthedUser serde 타입
minky-rust/src/config.rs (확장) slack_client_id, slack_client_secret, slack_redirect_uri, slack_signing_secret 필드 추가
minky-rust/src/routes/slack.rs (확장) oauth_callback 핸들러 실구현: SlackOAuthService.exchange_code() 호출 + save_workspace_credentials() DB 저장
  • exchange_code(): Slack oauth.v2.access API POST (form params: client_id, client_secret, code, redirect_uri)
  • save_workspace_credentials(): platform_configs upsert (ON CONFLICT DO UPDATE)
  • build_auth_url(): 스코프 + state + redirect_uri 포함 authorization URL 생성
  • validate_state(): OAuth state 파라미터 CSRF 보호

작업 2: Webhook event_callback 자동 지식 추출 파이프라인 연결

파일 내용
minky-rust/src/routes/slack.rs (확장) classify_webhook_action() 순수 함수, extract_messages_from_event() 순수 함수, 개선된 slack_webhook() 핸들러
  • classify_webhook_action(): url_verification / KnowledgeExtractionQueued (message, app_mention) / EventIgnored / UnknownType
  • extract_messages_from_event(): Slack event payload -> PlatformMessage 변환 (channel, user, text, thread_ts)
  • slack_webhook(): message/app_mention 이벤트 시 tokio::spawn으로 ConversationExtractionService 비동기 실행
  • Slack 3초 응답 타임아웃 준수 (즉시 {"ok": true, "queued": true} 반환)

작업 3: 테스트 커버리지 500개 달성 (+50개)

파일 추가 테스트 내용
services/slack_oauth_service.rs +15 config, build_auth_url, validate_state, serde roundtrip
routes/slack.rs +14 classify_webhook_action (5가지 케이스), extract_messages (4케이스), 기존 테스트 유지
services/slack_service.rs +20 is_thread_worth_analysing 엣지 케이스, build_prompt 순서 보존, classify_status 경계값, apply_filter 다중 필드, ConversationStats
services/conversation_extraction_service.rs +19 시스템 프롬프트 스키마 완전성, config 기본값, 역할 레이블
config.rs +9 Slack 설정 필드 기본값, 옵션 필드 None 확인

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 500/500 passed (+50개)
  • Rust Integration Tests: 15/15 passed
  • Doc Tests: 1/1 passed
  • 총 Rust 테스트: 450 -> 516개 (unit 500 + integration 15 + doc 1)

커밋 목록 (12차 세션)

  • 10494784 - feat: Implement Slack OAuth token exchange, webhook knowledge pipeline, and 500 test milestone

🔄 현재 진행 상황 (2026-02-19) - 테스트 450개 달성 + Webhook + DB 마이그레이션

11차 세션: 테스트 목표 달성 (2026-02-19)

작업 1: Slack Webhook 핸들러 + platform_configs DB 마이그레이션

파일 내용
minky-rust/migrations/005_slack_platform.sql platform_configs, platform_messages, extraction_jobs, extracted_knowledge 테이블 + 인덱스 + auto-updated_at 트리거
minky-rust/src/routes/slack.rs (확장) POST /api/slack/webhook (Slack Events API, url_verification + event_callback), SlackWebhookPayload 타입, 3개 테스트 추가

작업 2: 테스트 커버리지 450개 달성 (+35개)

파일 추가 테스트 내용
models/ml.rs +8 ClusteringAlgorithm serde, JobStatus serde/default, TopicAlgorithm serde/default, TopicKeyword default, AnomalyType snake_case
models/audit.rs +5 AuditAction/ResourceType serde roundtrip, snake_case 직렬화, display-serde 일관성
models/notification.rs +3 NotificationType serde roundtrip, 전 변형, format string
models/ai.rs +4 LLMProvider serde, TimeRange default, ChatRole user/assistant serde
models/workflow.rs +6 전 상태 전환 경로 (PendingReview, Approved, Published, Archived, Rejected), 전 variants display
utils/validation.rs +8 single quote, multiple chars, unicode, bell char, gt/lt 추가 케이스

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 434/434 passed
  • Rust Integration Tests: 15/15 passed
  • Doc Tests: 1/1 passed
  • 전체 Rust 테스트: 415 -> 450개 (+35개) - 목표 달성!

커밋 목록 (11차 세션)

  • ad88fc8a - feat: Add Slack webhook handler, platform DB migration, and webhook tests
  • f94596f1 - test: Expand unit tests to reach 450 target (415 -> 450)

🔄 현재 진행 상황 (2026-02-19) - Slack 지식 추출 파이프라인 + OAuth 라우트 + Docker Compose

10차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: ConversationExtractionService (LLM 파이프라인)

파일 내용
minky-rust/src/services/conversation_extraction_service.rs ExtractionConfig(default), ExtractionResult, AnthropicRequest/Response, ConversationExtractionService::extract() + call_llm() + build_system_prompt()
  • extract(): apply_filter → is_thread_worth_analysing → build_conversation_prompt → call_llm → parse_extraction_response → classify_status → ConversationStats
  • call_llm(): Anthropic Messages API 호출 (x-api-key, anthropic-version 헤더)
  • build_system_prompt(): JSON 스키마 + confidence 가이드라인 + role 레이블 정의
  • 6개 단위 테스트 (config default, model name, prompt schema, confidence guideline, role labels, custom config)

작업 2: routes/slack.rs (5개 엔드포인트)

엔드포인트 설명
POST /api/slack/extract 대화 지식 추출 (LLM 파이프라인 호출)
GET /api/slack/extract/{id} 추출 결과 조회 (DB stub)
POST /api/slack/confirm 사람 확인/거부 (DB stub)
GET /api/slack/summary 추출 활동 통계
GET /api/slack/oauth/callback Slack OAuth 2.0 콜백
  • extract_knowledge: Validation 오류 시 status=Skipped 반환 (200 OK), 실제 추출 성공 시 stats 포함
  • oauth_callback: code/error 파라미터 처리, 토큰 교환 TODO 표시
  • 4개 라우트 레벨 테스트

작업 3: Docker Compose rust-backend 서비스 추가

  • docker-compose.yml: rust-backend 서비스 (포트 8000, healthcheck wget, rust_logs named volume)
  • 환경 변수: DATABASE_URL(minky_rust_db), JWT_SECRET, OPENAI_API_KEY, ANTHROPIC_API_KEY
  • db 서비스 healthcheck 의존성 설정

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 396/396 passed (+6개 신규: conversation_extraction_service 6개)
  • Rust Integration Tests: 15/15 passed
  • Doc Tests: 1/1 passed
  • 전체 Rust 테스트: 402 -> 412개 (+10개)

커밋 목록 (10차 세션)

  • 951c9481 - feat: Add Slack/Teams knowledge extraction pipeline, OAuth routes, and Docker Compose Rust service

🔄 현재 진행 상황 (2026-02-19) - Slack 연동 모델 + Document 헬퍼 + Docker

9차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: Slack/Teams 연동 모델 및 서비스 설계

파일 내용
minky-rust/src/models/slack.rs MessagingPlatform(Slack/Teams/Discord), PlatformMessage, ExtractedKnowledge(is_high_quality, to_markdown), ExtractionStatus, MessageFilter(effective_limit), Conversation, ExtractionSummary
minky-rust/src/services/slack_service.rs SlackService 순수 함수 6개 (is_thread_worth_analysing, build_conversation_prompt, parse_extraction_response, apply_filter, classify_status), ConversationStats::compute
  • parse_extraction_response: markdown fence 제거 + JSON 파싱 + confidence clamp(0..1)
  • apply_filter: platform/channel/user/since/limit 복합 필터
  • classify_status: title/summary 비어있으면 Failed, confidence<0.3이면 Skipped, 확인됐으면 Completed
  • ConversationStats: thread_ts 기반 그루핑, unique_users, avg_thread_length
  • 총 45개 신규 테스트 (models 18 + service 27)

작업 2: Document 모델 순수 헬퍼 추가 및 테스트

메서드 설명
Document::is_indexable() 제목 비어있거나 content < 10자면 false
Document::to_index_text() title\n\ncontent 형식, 공백 trim
Document::is_readable_by(user_id) is_public 또는 소유자 확인
Document::is_writable_by(user_id) 소유자만
CreateDocument::effective_is_public() None -> false 기본값
CreateDocument::validate() title/content 비어있으면 Err
UpdateDocument::has_changes() 모든 필드 None이면 false
  • 17개 신규 테스트

작업 3: Rust 전용 멀티스테이지 Dockerfile

  • minky-rust/Dockerfile: builder(rust:1.82-slim) + runtime(debian:bookworm-slim)
  • 의존성 레이어 캐싱 (더미 main.rs로 cargo build 후 실제 소스 복사)
  • 비루트 유저(minky, uid 1001), HEALTHCHECK, 포트 8000
  • release 프로파일 (LTO, codegen-units=1, strip)

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 386/386 passed (+61개)
  • Rust Integration Tests: 15/15 passed
  • Doc Tests: 1/1 passed
  • 전체 Rust 테스트: 340 -> 402개 (+62개)

커밋 목록 (9차 세션)

  • d62e4277 - feat: Add Slack/Teams knowledge extraction model, document model helpers, and Rust Dockerfile

🔄 현재 진행 상황 (2026-02-19) - 지식 그래프 백엔드 API + 통합 테스트 구조 구축

8차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: 지식 그래프 백엔드 API

파일 내용
minky-rust/src/models/knowledge_graph.rs NodeType, GraphNode, GraphEdge, KnowledgeGraph, KnowledgeGraphQuery, ExpertiseLevel, MemberExpertise, TeamExpertiseMap (8개 타입 + 3개 내부 Row 타입)
minky-rust/src/services/knowledge_graph_service.rs KnowledgeGraphService (build_graph, build_team_expertise_map), build_derived_nodes_pure (순수 함수), normalize_label
minky-rust/src/routes/knowledge.rs GET /api/knowledge/graph (필터 쿼리 파라미터 지원), GET /api/knowledge/team
  • pgvector 코사인 유사도 기반 엣지 생성 (LATERAL JOIN)
  • Document Understanding 토픽/기술/인사이트 노드 자동 생성
  • 프론트엔드 KnowledgeGraphPage.jsx가 기대하는 {nodes, edges} 응답 형식 준수
  • 팀원 전문성 수준: Beginner(0-2) / Intermediate(3-7) / Advanced(8-15) / Expert(16+)

작업 2: 팀원 전문성 맵핑 모델/API

  • ExpertiseLevel enum: from_doc_count() 로 자동 분류
  • TeamExpertiseMap: members + shared_areas + unique_experts
  • GET /api/knowledge/team: 팀원별 전문 영역, 공유 기술, 단독 전문가 식별

작업 3: 통합 테스트 구조 구축

파일 내용
tests/common/mod.rs TestApp (HTTP oneshot), assert_success!, assert_error! 매크로
tests/health_test.rs 4개 통합 테스트 (200 OK, version, database status, 404)
tests/knowledge_graph_model_test.rs 11개 모델 테스트 (NodeType, ExpertiseLevel, GraphNode/Edge 직렬화)

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Unit Tests: 325/325 passed (+16개: knowledge_graph 모델 8개 + 서비스 8개)
  • Rust Integration Tests: 15/15 passed (신규)
  • 전체 Rust 테스트: 340개

커밋 목록 (8차 세션)

  • 4c01f4d4 - feat: Add knowledge graph backend API and integration test infrastructure

🔄 현재 진행 상황 (2026-02-19) - 단위 테스트 309개 / Phase 2 그래프 시각화 시작

7차 세션: 3개 작업 병렬 완료 (2026-02-19)

작업 1: Rust 단위 테스트 확장 (266개 -> 309개, +43개)

파일 추가 테스트 테스트 내용
models/timeline.rs +8 TimelineQuery default, EventType serde, snake_case 직렬화, has_more 페이지네이션 로직, heatmap level 계산, DailyActivity 구조
models/version.rs +6 DiffOperation serde (add/remove/keep), VersionDiff 필드, DiffLine 구성, net_change 계산
models/git.rs +12 FileStatus serde (모든 변형), GitLineType serde, GitDiffStats net change, CommitRequest 옵션 필드, GitStatus is_clean 로직
models/analytics.rs +9 TrendDirection/ReportType/ReportFormat serde, SentimentScore 합계, AnalyticsOverview 비율, zero_result_rate 범위; Serialize derive 추가
models/admin.rs +8 SystemConfig serde roundtrip, allowed_file_types 검증, MaintenanceMode 상태, SystemStats 비율

작업 2: 환경 검증 스크립트 (scripts/check-env.sh)

  • 필수 도구: Rust, Cargo, Node.js, PostgreSQL client, sqlx-cli
  • 환경 변수: DATABASE_URL, JWT_SECRET, OPENAI_API_KEY, ANTHROPIC_API_KEY
  • 데이터베이스: 연결, pgvector 확장, 마이그레이션 상태
  • Rust 빌드 검증 (--full 플래그로 테스트 실행)
  • 서비스 상태: backend (8000), frontend (3000)
  • 실행: ./scripts/check-env.sh (현재 환경: 18 PASS, 2 WARN, 0 FAIL)

작업 3: Phase 2 지식 그래프 시각화 (프론트엔드)

  • frontend/src/components/KnowledgeGraph/ - 6개 파일:
    • KnowledgeGraph.jsx - SVG 기반 메인 컴포넌트 (줌/팬, 노드 클릭, 레이아웃)
    • GraphNode.jsx - 타입별 색상 노드, 문서 수 배지
    • GraphEdge.jsx - 가중치 기반 두께, 호버 레이블
    • NodeDetailPanel.jsx - 노드 상세 패널 (연결된 노드, 토픽, 문서 링크)
    • graphLayout.js - Fruchterman-Reingold 포스-다이렉티드 레이아웃
    • KnowledgeGraph.css - 다크 테마, 반응형
  • frontend/src/pages/KnowledgeGraphPage.jsx - 전체 페이지 (타입 필터, 검색, API 없을 때 데모 데이터)
  • 라우트: /graph (App.js 및 Header 네비게이션 추가)
  • 테스트: 35/35 통과 (graphLayout 순수 함수 22개 + 컴포넌트 13개)
  • setupTests.js: ResizeObserver mock 추가

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Tests: 309/309 passed (+43개)
  • Frontend Tests: 263/263 passed (+35개 KnowledgeGraph 테스트)

커밋 목록 (7차 세션)

  • fed21260 - test: Add model unit tests for timeline, version, git, analytics, admin (266->309 tests)
  • 88db4ade - feat: Add environment validation script (scripts/check-env.sh)
  • f2bc6bb6 - feat: Add Phase 2 Knowledge Graph visualization (frontend)

🔄 현재 진행 상황 (2026-02-19) - 단위 테스트 266개 달성 (계속 확장 중)

6차 세션: 추가 단위 테스트 확장 (2026-02-19)

단위 테스트 252개 → 266개 (+14개)

파일 추가 테스트 테스트 내용
middleware/rate_limit.rs +5 check() 허용/차단/독립 키, cleanup() 빈 상태, cleanup() 만료 항목 제거
models/rag.rs +5 serde default 함수 5개 (top_k=5, threshold=0.7, search_limit=10, search_threshold=0.6, history_limit=20)
models/korean.rs +1 KoreanSearchMode::default() == Morpheme
models/security.rs +3 Severity PartialOrd 순서 (Info < Low < Medium < High < Critical)

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 clippy warnings
  • Rust Tests: 266/266 passed

커밋 목록 (6차 세션 연속)

  • cb39932a - docs: Update PROGRESS.md with 5th session test expansion results
  • fe5eb52a - test: Add WebSocketManager unit tests (228->234 tests)
  • ede067b4 - test: Add skill model tests for SkillType default and builtin prompts (234->240 tests)
  • 2158b01f - test: Add model default enum tests for export, sync, harness, search, ocr (240->249 tests)
  • 19f91594 - test: Add model default enum tests for agent, ml, template (249->252 tests)
  • 5292ade9 - test: Add RateLimiter unit tests for check and cleanup methods (252->257 tests)
  • f88e7fe9 - test: Add model unit tests for rag, korean, security models (257->266 tests)

🔄 현재 진행 상황 (2026-02-19) - 단위 테스트 203개 달성 (200+ 돌파)

5차 세션: 광범위한 단위 테스트 확장 (2026-02-19)

단위 테스트 160개 → 203개 (+43개)

서비스 추가된 테스트 테스트 내용
services/analytics_service.rs +13 calculate_engagement, analyze_content (160개 기준 포함)
services/skill_service.rs +10 get_skill_by_type, find_matching_skill, build_prompt
services/git_service.rs +11 parse_status (전 변형), parse_stat_line, parse_diff_stats
services/ai_service.rs +9 get_system_prompt (8개 타입), build_user_prompt (context 유무)
services/harness_service.rs +6 parse_diff_stats (빈 입력, 단일/다중 파일, 삽입/삭제 전용)
services/korean_service.rs +7 extract_keywords (불용어, 제한, 빈 텍스트), normalize_text
services/rag_service.rs +2 untitled document 대체, 텍스트 없는 청크 처리
services/embedding_service.rs +4 zero chunk_size, overlap, 정확한 크기, 마지막 청크
services/understanding_service.rs +5 build_system_prompt, build_user_prompt, parse_response

빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 warnings (clippy 포함)
  • Rust Tests: 228/228 passed (프론트엔드와 동일한 숫자!)
  • Frontend Tests: 228/228 passed (변동 없음)

커밋 목록 (5차 세션)

  • f12822a0 - test: Add skill_service and analytics_service unit tests (150->160 tests)
  • 7c61cc20 - test: Add git_service and ai_service unit tests (160->180 tests)
  • cee330af - test: Add harness_service unit tests for parse_diff_stats (180->186 tests)
  • bdda2cc4 - test: Add korean_service tests for extract_keywords and normalize_text (186->193 tests)
  • a7c8689a - test: Expand rag_service and embedding_service tests (193->199 tests)
  • 3d98e226 - test: Expand understanding_service tests for prompt builders (199->203 tests)
  • 882c2809 - test: Add middleware extractor and error type tests (203->215 tests)
  • ee3e42d7 - test: Add model unit tests for NotificationType and AIModelConfig (215->225 tests)
  • 0e9e06dc - test: Add config jwt_secret_bytes tests (225->228 tests)

🔄 현재 진행 상황 (2026-02-19) - AuthUser 연동 완료 및 단위 테스트 137개 달성

4차 세션: AuthUser 전체 연동 + 포괄적 단위 테스트 (2026-02-19)

1. AuthUser 전체 라우트 연동 완료

전체 라우트 파일에서 하드코딩된 user_id = 1 완전 제거:

  • routes/sync.rs: list_configs, create_config, delete_config
  • routes/export.rs: start_export, download_export, start_import
  • routes/security.rs: block_ip, list_api_keys, create_api_key, revoke_api_key, get_sessions, revoke_session, revoke_all_sessions (7개 핸들러)
  • routes/skills.rs: execute_skill, execute_skill_by_type, create_skill, get_history + quick execute 6개 (execute_quick_skill 헬퍼 user_id 파라미터 추가)
  • routes/templates.rs: list_templates, get_template, create_template, update_template, delete_template, preview_template, apply_template (7개)
  • routes/ocr.rs: start_ocr + 모든 핸들러에 AuthUser 추가

2. 단위 테스트 88개 → 137개 (+49개)

서비스/모델 추가된 테스트 테스트 내용
services/auth_service.rs +10 Argon2 해싱, JWT 생성/검증, 역할 인코딩, 크로스 시크릿 거부
services/export_service.rs +10 to_json, to_csv, to_markdown 변환 (빈 목록, 특수문자, 옵션 필드)
services/template_service.rs +7 preview_template 변수 치환, 기본값, 필수/선택 변수
services/ocr_service.rs +12 is_supported_format (대소문자), 처리시간 추정, 설정 업데이트
services/security_service.rs +10 generate_api_key (접두사, 길이, 알파벳), hash_api_key, Severity 정렬

3. 빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 warnings (clippy 포함)
  • Rust Tests: 137/137 passed (이전 88개, +49개)
  • Frontend Tests: 228/228 passed (변동 없음)

4. 커밋 목록 (4차 세션)

  • eedf2eac - refactor: Wire AuthUser into remaining route files (sync, export, security, skills, templates, ocr)
  • 6bc9d8e1 - test: Add auth_service unit tests for JWT and password hashing (88->98 tests)
  • a2db5059 - test: Add export_service unit tests for JSON/CSV/Markdown conversion (98->108 tests)
  • 893b899c - test: Add template_service unit tests for preview_template logic (108->115 tests)
  • 6898ec52 - test: Add ocr_service unit tests for format validation and time estimation (115->127 tests)
  • e231136f - test: Add security_service unit tests for API key and severity (127->137 tests)

🔄 현재 진행 상황 (2026-02-19) - Auth 구현 및 추가 테스트 완료

Auth 라우트 구현 및 단위 테스트 추가 (2026-02-19 - 3차)

1. Auth 라우트 실제 구현 완료 (routes/auth.rs)

  • POST /api/auth/login: 이메일/비밀번호 검증, JWT 발급, 계정 잠금 처리
  • POST /api/auth/register: 이메일 중복 체크, Argon2 해싱, 201 Created 반환
  • POST /api/auth/refresh: 리프레시 토큰 검증 후 새 토큰 발급
  • GET /api/auth/me: AuthUser 추출기 사용, 현재 사용자 정보 반환
  • 이전 placeholder stub -> 실제 AuthService/DB 연동으로 전환

2. Documents 라우트 인증 연동 (routes/documents.rs)

  • create_document: 하드코딩된 user_id = 1 -> AuthUser 추출기로 교체
  • AuthUser 추출기: JWT Bearer 토큰에서 사용자 ID 추출

3. 단위 테스트 추가 (27개 -> 37개, +10개)

models/category.rs - CategoryTree 순수 함수 테스트 5개:

  • test_build_tree_empty: 빈 목록 처리
  • test_build_tree_flat_roots: 최상위 카테고리 2개
  • test_build_tree_with_children: 부모-자식 관계
  • test_build_tree_nested_hierarchy: 3단계 깊이
  • test_build_tree_preserves_document_count: document_count 보존

models/user.rs - UserRole, UserResponse 테스트 5개:

  • test_user_role_default_is_user: 기본값 UserRole::User
  • test_user_response_from_user_maps_fields: 필드 매핑 확인
  • test_user_response_does_not_expose_password: password_hash 노출 방지
  • test_user_response_admin_role: Admin 역할 변환
  • test_user_response_inactive_user: 비활성 사용자 변환

4. 추가 AuthUser 연동 (5개 파일)

  • routes/tags.rs: list_tags, get_tag, create_tag (+201 Created), update_tag, delete_tag
  • routes/categories.rs: list_categories, list_categories_tree, get_category, create_category (+201 Created), update_category, delete_category
  • routes/comments.rs: create_comment (+201 Created), update_comment, delete_comment (is_admin() 사용)
  • routes/notifications.rs: list, count, mark_as_read, mark_all_as_read, delete
  • routes/workflows.rs: create_workflow (+201 Created), update_status, list_assigned
  • routes/versions.rs: create_version, restore_version
  • routes/attachments.rs: upload_attachment, delete_attachment (is_admin() 사용)

5. 단위 테스트 추가 (37개 -> 67개, +30개)

models/attachment.rs - 14개 테스트:

  • validate_upload: valid MIME, unknown MIME rejection, empty file, oversized, max size
  • sanitize_filename: safe chars, spaces, traversal prevention, special chars
  • get_extension: pdf, no extension, multiple dots, hidden file

services/version_service.rs - 6개 테스트:

  • compare_versions: identical, empty->content, content->empty, modified lines, added lines, total_changes invariant

models/comment.rs - 4개 테스트:

  • build_tree: empty, top-level, with replies, nested 3-level

models/embedding.rs - 8개 테스트 (기존 2개 -> 8개):

  • All 4 model dimensions, default model, all 4 API IDs
  • Cosine similarity: identical, orthogonal, opposite, zero vector, different lengths

6. 빌드 및 테스트 결과

  • Rust Build: 0 errors, 0 warnings
  • Rust Tests: 67/67 passed (이전 27개, +40개)
  • Frontend Tests: 228/228 passed

7. 커밋 목록

  • f4522492 - feat: Implement auth routes and wire AuthUser into documents CRUD
  • f8b771b0 - refactor: Wire AuthUser into tags, categories, comments, notifications, workflows
  • 9c9c1b24 - refactor: Wire AuthUser into versions and attachments routes
  • 73c8a3f7 - test: Add unit tests for attachment validation and version diff (37 -> 57 tests)
  • 29fab6e5 - test: Add unit tests for comment tree and embedding model (57 -> 67 tests)

🔄 현재 진행 상황 (2026-02-19) - 코드 품질 개선 완료

코드 품질 개선 세션 결과 (2026-02-19 - 2차)

1. Rust Clippy 경고 전량 제거 (80개 → 0개)

경고 유형 수정 전 수정 후 방법
very complex type 27개 0개 type alias 도입
redundant closure 24개 0개 cargo clippy --fix
derivable_impls 9개 0개 #[derive(Default)]
direct impl ToString 4개 0개 fmt::Display 구현
dead code 9개 0개 #[allow(dead_code)] 또는 제거
기타 7개 0개 suppress/수정

수정된 파일 목록:

  • src/models/audit.rs - AuditAction, ResourceType: ToString -> Display
  • src/models/notification.rs - NotificationType: ToString -> Display
  • src/models/workflow.rs - WorkflowStatus: ToString -> Display
  • src/models/timeline.rs - TimelineQuery: #[derive(Default)] 추가
  • src/routes/search.rs - DocumentRow type alias, dead_code allow
  • src/routes/auth.rs - RefreshRequest: dead_code allow
  • src/routes/categories.rs - ListQuery: dead_code allow
  • src/routes/documents.rs - ListQuery, CreateDocumentRequest, UpdateDocumentRequest: dead_code allow
  • src/routes/workflows.rs - CreateWorkflowRequest: dead_code allow
  • src/services/admin_service.rs - UserAdminRow, AuditLogRow type alias
  • src/services/agent_service.rs - AgentRow, AgentTaskRow type alias
  • src/services/analytics_service.rs - DocumentMetricsRow type alias
  • src/services/export_service.rs - ExportedDocumentRow type alias
  • src/services/harness_service.rs - HarnessRow, HarnessSummaryRow type alias
  • src/services/ml_service.rs - DocumentClusterRow type alias
  • src/services/security_service.rs - SecurityEventRow, IpBlockRow, ApiKeyRow, SessionInfoRow type alias; log_event suppress
  • src/services/skill_service.rs - SkillRow, SkillHistoryRow type alias
  • src/services/sync_service.rs - SyncConfigRow, SyncHistoryRow, SyncConflictRow type alias
  • src/services/template_service.rs - TemplateRow type alias
  • src/services/timeline_service.rs - TimelineEventRow type alias, Default impl 제거
  • src/services/workflow_service.rs - to_string() in format! 제거

2. 빌드 상태

  • Rust Backend: ✅ 0 warnings, 0 errors
  • Frontend Tests: ✅ 228 passed, 0 failed (이전 1 failed -> 모두 통과)

3. Frontend 버그 수정 (DocumentView.js)

  • api.get('/documents/${id}') -> documentService.getDocument(id) 변경
  • DocumentView.test.js: 5/5 테스트 모두 통과 (이전에 1개 실패)

4. Documents CRUD DB 연동 구현 완료

  • routes/documents.rs: stub -> 실제 DB 연동으로 전환
  • 구현된 기능:
    • GET /api/documents (페이지네이션, 검색, 카테고리 필터)
    • POST /api/documents (문서 생성)
    • GET /api/documents/{id} (단건 조회 + view_count 증가)
    • PUT /api/documents/{id} (부분 업데이트, COALESCE 패턴)
    • DELETE /api/documents/{id} (삭제, 404 처리)
  • E2E 테스트 통과:
    • POST: title, content, is_public 저장 확인
    • GET list: 페이지네이션 메타데이터 포함
    • GET single: view_count 증가 확인
    • PUT: 제목/내용 업데이트, updated_at 갱신 확인
    • DELETE: 삭제 후 404 반환 확인
    • Search: ?search=RAG 쿼리 동작 확인

🔄 현재 진행 상황 (2026-02-19) - E2E 테스트 완료

E2E 테스트 세션 결과 (2026-02-19)

1. Rust 서버 기동

  • minky-rust/target/debug/minky 실행 (포트 8000)
  • .env 로드 성공: DATABASE_URL, JWT_SECRET, OPENAI_API_KEY
  • GET /api/health -> {"status":"ok","version":"0.1.0","database":"healthy"} ✅

2. DB 마이그레이션 추가

  • migrations/004_search_history.sql 생성 및 적용 (sqlx migrate run)
  • search_history 테이블 없어서 GET /api/search/history 오류 -> 수정 완료
  • 마이그레이션 상태: 4/4 적용 완료

3. E2E API 테스트 결과

엔드포인트 메서드 결과 비고
/api/health GET ✅ 서버/DB 정상
/api/documents GET ✅ 빈 목록 (stub)
/api/categories GET ✅ 빈 목록
/api/embeddings/stats GET ✅ 통계 정상 (문서 2개)
/api/search/history GET ✅ 빈 히스토리
/api/documents/{id}/understand POST 실패 ANTHROPIC_API_KEY 미설정
/api/embeddings/document/{id} POST 실패 OpenAI 크레딧 초과
/api/embeddings/search POST 실패 OpenAI 크레딧 초과
/api/search/semantic POST 실패 OpenAI 크레딧 초과
/api/search/ask POST 실패 OpenAI 크레딧 초과

4. 프론트엔드 수정

  • frontend/src/services/api.js: 포트 5001 -> 8000 변경 ✅
  • frontend/src/services/collaborationService.js: 포트 5001 -> 8000 변경 ✅
  • frontend/src/components/Header.js: Knowledge 메뉴 링크 추가 ✅
  • 프론트엔드 빌드: ✅ 성공 (warnings only)

5. 프론트엔드 개발 서버 기동

남은 작업:

  • ANTHROPIC_API_KEY를 minky-rust/.env에 추가 (문서 이해 분석)
  • OpenAI API 크레딧 보충 (임베딩 생성, RAG 검색)
  • documents CRUD 라우트 DB 연동 구현 (현재 TODO stub)
  • 실제 임베딩 데이터로 E2E 테스트 완료

✅ Phase 1: Knowledge Understanding 대규모 병렬 구현 완료

7개 병렬 에이전트 실행 결과:

Backend (Rust) - 3개 에이전트 완료 ✅

  1. Document Understanding 파이프라인 (rust-developer)

    • minky-rust/src/services/understanding_service.rs - Claude API(claude-3-5-haiku) 문서 분석
    • minky-rust/src/routes/understanding.rs - POST/GET understand 엔드포인트
    • 핵심 주제, 요약, 인사이트, 기술/도구 자동 추출
    • 빌드: ✅ 성공

  2. 벡터 임베딩 API 엔드포인트 (rust-developer)

    • minky-rust/src/routes/embeddings.rs - 7개 엔드포인트:
      • POST /api/embeddings/documents/{id} (문서 임베딩 생성)
      • GET /api/embeddings/documents/{id} (임베딩 조회)
      • POST /api/embeddings/chunks/{id} (청크 임베딩 생성)
      • POST /api/embeddings/search (시맨틱 검색)
      • GET /api/embeddings/similar/{id} (유사 문서)
      • GET /api/embeddings/stats (통계)
      • POST /api/embeddings/queue/{id} (대기열 추가)
    • 빌드: ✅ 성공

  3. RAG 검색 API (rust-developer)

    • minky-rust/src/models/rag.rs - RagAskRequest/Response, SearchHistoryEntry 모델
    • minky-rust/src/services/rag_service.rs - 전체 RAG 파이프라인:
      • 질문 → 임베딩 → 벡터 검색 → 컨텍스트 조합 → Claude 답변
    • minky-rust/src/routes/rag.rs - 3개 엔드포인트:
      • POST /api/search/ask (RAG 질문 답변)
      • POST /api/search/semantic (시맨틱 검색)
      • GET /api/search/history (검색 히스토리)
    • 빌드: ✅ 성공

Frontend (React) - 2개 에이전트 완료 ✅

  1. 프론트엔드 검색 UI (frontend-developer)

    • frontend/src/components/Search/ - SearchBar, SearchResults, SearchResultItem
    • frontend/src/components/Knowledge/ - AskQuestion, AnswerDisplay, SourceDocuments
    • frontend/src/components/RelatedDocs/ - RelatedDocsList (유사도 점수 표시)
    • frontend/src/pages/KnowledgeSearch.js - /knowledge 라우트 통합 페이지
    • 기능: 모드 토글(키워드/시맨틱/질문), 마크다운 렌더링, 코드 하이라이팅
    • 테스트: 12/12 통과 ✅

  2. 프론트엔드 채팅 UI (frontend-developer)

    • frontend/src/components/Chat/ - 5개 컴포넌트:
      • ChatContainer.jsx (메인 컨테이너)
      • ChatMessage.jsx (마크다운 렌더링)
      • ChatInput.jsx (자동 리사이즈, 4000자 제한)
      • ChatHistory.jsx (세션 관리)
      • TypingIndicator.jsx (로딩 애니메이션)
    • frontend/src/components/Chat/Chat.css - 350줄 (다크모드, 반응형)
    • frontend/src/services/chatService.js - API 클라이언트
    • frontend/src/hooks/useChat.js - 세션 라이프사이클
    • frontend/src/pages/ChatPage.jsx - /chat 라우트
    • 테스트: 22/22 통과 ✅

Documentation - 2개 에이전트 완료 ✅

  1. API 문서화 (tech-doc-writer)

    • Docs/API.md - API 개요, 인증, 에러 처리, Rate Limiting
    • Docs/api/embeddings.md - 벡터 임베딩 API 상세
    • Docs/api/search.md - 검색 API 상세 (RAG 포함)
    • Docs/api/understanding.md - 문서 이해 API 상세
    • Docs/examples/api-examples.md - curl, JavaScript, Python 예제

  2. README 및 시작 가이드 (tech-doc-writer)

    • README.md - 프로젝트 비전, 빠른 시작, 아키텍처 다이어그램
    • Docs/GETTING_STARTED.md - 7단계 설치 가이드, 10+ 트러블슈팅
    • Docs/ARCHITECTURE.md - 시스템 아키텍처, 데이터 흐름, 보안

빌드 상태

  • Rust Backend: ✅ 56 warnings, 0 errors (pre-existing warnings)
  • Frontend Tests: ✅ 227 passed, 1 failed (pre-existing react-router issue)

이전 마지막 작업

  • CI/CD 통합 시스템 완성

    • CI Runner: ci-runner (지속적 실행, 파이프라인, 트리거)
    • 헬스 체크: health-checker (시스템 상태 모니터링, 자동 복구)
    • 커맨드: /ci, /health
    • 파이프라인: default.yml, hotfix.yml, validate-only.yml
    • GitHub Actions: ci-trigger.yml
    • 디렉토리: triggers/, pipelines/, logs/ci/, backups/
    • CLAUDE.md 업데이트 (PM/CI 자동화 프로토콜)
    • config.json 업데이트 (CI, 헬스체크 설정)

  • PM 자동화 시스템 완성 (이전)

    • 상태 관리: state-manager (세션 간 상태 저장/복구, 체크포인트, 롤백)
    • 작업 스케줄링: work-scheduler (의존성 기반 작업 선택)
    • 피드백 루프: feedback-loop (패턴 학습, 인사이트 추출)
    • 알림: notifier (완료/실패 알림, 리포트)

다음 단계

  • RAG 검색 API 구현 (ask endpoint)
  • OpenAPI/Swagger 스펙 자동 생성
  • 프론트엔드 API 클라이언트 연동

방금 완료: pgvector 설정 (task-001)

  • minky-rust/Cargo.toml - pgvector 의존성 추가
  • minky-rust/migrations/003_pgvector_embeddings.sql - 마이그레이션 작성
  • minky-rust/src/models/embedding.rs - 임베딩 모델 정의
  • minky-rust/src/services/embedding_service.rs - 임베딩 서비스 구현
  • minky-rust/src/error.rs - 에러 타입 추가
  • 빌드 확인: ✅ 성공 (56 warnings, 0 errors)

생성된 파일 요약

.claude/
├── agents/          (21개)
│   ├── PM 핵심 시스템 (5개)
│   │   ├── pm.md                    # 프로젝트 매니저 (Enhanced)
│   │   ├── task-executor.md         # 태스크 실행기
│   │   ├── code-reviewer-minky.md   # 코드 리뷰어
│   │   ├── validator.md             # 검증 에이전트
│   │   └── progress-tracker.md      # 진행 상황 추적기
│   │
│   ├── 자동화 인프라 (4개)
│   │   ├── state-manager.md         # 상태 저장/복구/체크포인트
│   │   ├── work-scheduler.md        # 작업 대기열/의존성 관리
│   │   ├── feedback-loop.md         # 패턴 학습/인사이트
│   │   └── notifier.md              # 알림/리포트
│   │
│   ├── CI/CD 시스템 (2개) ⭐ NEW
│   │   ├── ci-runner.md             # 지속적 실행/파이프라인
│   │   └── health-checker.md        # 시스템 상태 모니터링
│   │
│   ├── 이슈/PR 시스템 (4개)
│   │   ├── issue-manager.md         # 이슈 관리
│   │   ├── issue-developer.md       # 이슈 개발/PR 생성
│   │   ├── technical-writer.md      # 기술 보고서 작성
│   │   └── github-automation.md     # GitHub 자동화
│   │
│   └── 지식 관리 (6개)
│       ├── doc-analyzer.md, knowledge-linker.md
│       ├── search-assistant.md, insight-extractor.md
│       ├── summary-writer.md, reference-manager.md
│
├── commands/        (23개)
│   ├── PM 커맨드 (5개): pm, next, review, validate, progress
│   ├── 자동화 커맨드 (4개): state, queue, feedback, notify
│   ├── CI/CD 커맨드 (2개) ⭐ NEW: ci, health
│   ├── 이슈 커맨드 (4개): issue, issue-dev, tech-report, setup-github
│   └── 지식 커맨드 (8개): ingest, ask, capture, summarize,
│                         related, status, ref-save, ref-search
│
├── config.json      - 전체 시스템 설정 (CI, 헬스체크 추가)
│
├── state/           - 상태 관리
│   ├── current-task.json    # 현재 작업
│   ├── work-queue.json      # 작업 대기열
│   ├── agent-context.json   # 에이전트 컨텍스트
│   ├── feedback.json        # 피드백 데이터
│   └── ci-session.json      # CI 세션 상태 ⭐ NEW
│
├── locks/           - 동시 작업 충돌 방지
│
├── pipelines/       ⭐ NEW - CI/CD 파이프라인
│   ├── default.yml          # 기본 파이프라인
│   ├── hotfix.yml           # 긴급 수정 파이프라인
│   └── validate-only.yml    # 검증 전용 파이프라인
│
├── triggers/        ⭐ NEW - 외부 트리거
│   ├── queue/               # 대기 트리거
│   └── processed/           # 처리 완료
│
├── logs/ci/         ⭐ NEW - CI 로그
│
├── backups/         ⭐ NEW - 상태 백업
│
├── skills/          (6개)
│
└── references/      (3건)

.github/workflows/   (4개)
├── issue-triage.yml   # 이슈 자동 분석
├── pr-check.yml       # PR 빌드/테스트
├── tech-report.yml    # 기술 보고서 생성
└── ci-trigger.yml     # CI 트리거 ⭐ NEW

LessonLearn/         # 기술 보고서 저장소

scripts/
└── create-labels.sh

Project Status

항목 상태
Current Phase Phase 1: Knowledge Understanding
Rust Backend 기본 구조 완성, 마이그레이션 진행 중
Frontend 기존 React 앱 존재
Database PostgreSQL (pgvector 추가 필요)

Completed Tasks

2026-02-18: 프로젝트 방향 재정립

결정사항:

  • 태그 기반 분류 → AI 이해 기반으로 전환
  • RAG (Retrieval-Augmented Generation) 아키텍처 채택
  • 자연어 검색으로 지식 접근

완료 작업:

  • CLAUDE.md 재작성 (프로젝트 비전, 아키텍처)
  • 디렉토리 구조 문서화
  • PLAN.md, PROGRESS.md 체계 도입
  • Phase 1 작업 목록 정리

기술 결정:

  • Vector DB: pgvector (PostgreSQL 확장) 우선, Qdrant 옵션
  • Embedding: OpenAI text-embedding-3-small 또는 Voyage AI
  • AI: Claude API (Anthropic)

2026-02-19: CI/CD 통합 시스템 완성

완료 작업:

CI/CD 에이전트 (2개):

  • ci-runner.md - 지속적 실행 관리, 파이프라인 오케스트레이션
  • health-checker.md - 시스템 상태 모니터링, 자동 복구

CI/CD 커맨드 (2개):

  • /ci - CI 세션 관리 (start, auto, watch, pause, resume, stop)
  • /health - 헬스 체크 (quick, standard, full, fix)

파이프라인 정의 (3개):

  • default.yml - 기본 CI/CD 파이프라인
  • hotfix.yml - 긴급 수정 파이프라인
  • validate-only.yml - 검증 전용 파이프라인

GitHub Actions (1개):

  • ci-trigger.yml - 이슈/푸시/스케줄 트리거

상태 파일:

  • ci-session.json - CI 세션 상태

디렉토리:

  • .claude/pipelines/ - 파이프라인 정의
  • .claude/triggers/ - 외부 트리거
  • .claude/logs/ci/ - CI 로그
  • .claude/backups/ - 상태 백업

설정 업데이트:

  • config.json - CI, 헬스체크 설정 추가
  • CLAUDE.md - PM/CI 자동화 프로토콜 문서화

2026-02-19: PM 자동화 시스템 완성

완료 작업:

자동화 인프라 에이전트 (4개):

  • state-manager.md - 상태 저장/복구, 체크포인트, 롤백, 잠금 관리
  • work-scheduler.md - 작업 대기열, 의존성 해결, GitHub/PLAN.md 동기화
  • feedback-loop.md - 패턴 학습, 인사이트 추출, 개선 제안
  • notifier.md - 작업 알림, 일일/주간 리포트

자동화 커맨드 (4개):

  • /state - 상태 저장/복구/체크포인트/롤백
  • /queue - 작업 대기열 관리/동기화
  • /feedback - 패턴/인사이트 검색
  • /notify - 알림 상태/리포트 생성

설정 및 상태 파일:

  • .claude/config.json - 전체 시스템 설정
  • .claude/state/current-task.json - 현재 작업 상태
  • .claude/state/work-queue.json - 작업 대기열
  • .claude/state/agent-context.json - 에이전트 컨텍스트
  • .claude/state/feedback.json - 피드백 데이터
  • .claude/locks/ - 동시 작업 잠금 디렉토리

PM 에이전트 업그레이드:

  • Enhanced 버전으로 업그레이드
  • 모든 자동화 에이전트와 연동
  • 완전 자동화 워크플로우 구현

2026-02-19: GitHub 이슈/PR 자동화 시스템 구축

완료 작업:

이슈/PR 에이전트 (4개):

  • issue-manager.md - 이슈 관리 (1시간마다 분석, PM 코멘트 추가)
  • issue-developer.md - 이슈 해결 및 PR 생성
  • technical-writer.md - 기술 보고서 작성 (LessonLearn 폴더)
  • github-automation.md - GitHub 자동화 설정

커맨드 (4개):

  • /issue - 이슈 목록 조회, 분석, 동기화
  • /issue-dev - 이슈 개발 및 PR 생성
  • /tech-report - 기술 보고서 작성
  • /setup-github - GitHub 자동화 설정

GitHub Actions (3개):

  • issue-triage.yml - 1시간마다 이슈 자동 분석/라벨링
  • pr-check.yml - PR 생성 시 빌드/테스트/린트
  • tech-report.yml - PR 머지 시 기술 보고서 자동 생성

기타:

  • LessonLearn/README.md - 기술 보고서 저장소 가이드
  • scripts/create-labels.sh - GitHub 라벨 생성 스크립트
  • GitHub 라벨 17개 생성 완료 (priority, type, status, area)

2026-02-18: PM 에이전트 시스템 구축

완료 작업:

PM 에이전트 (5개):

  • pm.md - 프로젝트 매니저 (메인 오케스트레이터)
  • task-executor.md - 태스크 실행기
  • code-reviewer-minky.md - 코드 리뷰어
  • validator.md - 검증 에이전트
  • progress-tracker.md - 진행 상황 추적기

PM 커맨드 (5개):

  • /pm - PM 에이전트 시작
  • /next - 다음 할 일 확인
  • /review - 코드 리뷰 요청
  • /validate - 검증 실행
  • /progress - 진행 상황 업데이트

PM 스킬 (1개):

  • pm/SKILL.md - PM 스킬

2026-02-18: 지식 관리 에이전트/커맨드/스킬/레퍼런스 시스템 구축

완료 작업:

에이전트 (6개):

  • doc-analyzer.md - 문서 분석, 주제/요약/인사이트 추출
  • knowledge-linker.md - 문서 관계 탐지, 지식 그래프
  • search-assistant.md - RAG 기반 자연어 Q&A
  • insight-extractor.md - 대화에서 암묵지 추출
  • summary-writer.md - 주제/기간/기여자별 요약
  • reference-manager.md - 레퍼런스 저장/검색/관리

커맨드 (8개):

  • /ingest - 문서 업로드 및 AI 분석
  • /ask - 자연어 지식 베이스 검색
  • /capture - 빠른 지식 캡처
  • /summarize - 지식 요약 생성
  • /related - 관련 문서 찾기
  • /status - 지식 베이스 상태
  • /ref-save - 조사 내용 레퍼런스로 저장
  • /ref-search - 저장된 레퍼런스 검색

스킬 (5개):

  • doc-understanding - 문서 분석 스킬
  • semantic-search - 벡터 검색 스킬
  • rag-answering - RAG 답변 생성 스킬
  • knowledge-linking - 문서 연결 스킬
  • tacit-extraction - 암묵지 추출 스킬

레퍼런스 시스템:

  • .claude/references/ 디렉토리 구조 생성
  • _index.json 검색 인덱스 구현
  • research/2026-02-18_pkm-tools.md - PKM 도구 조사
  • architecture/rag-patterns.md - RAG 패턴 레퍼런스
  • apis/embedding-apis.md - Embedding API 비교
  • 모든 에이전트에 레퍼런스 활용 가이드 추가

이전 작업 (Rust 마이그레이션)

완료된 Rust 모듈:

  • 기본 Axum 서버 설정
  • 인증/JWT 미들웨어
  • 문서 CRUD
  • 태그/카테고리
  • AI 서비스 (Claude 연동)
  • 검색 (OpenSearch)
  • 에이전트 시스템
  • 스킬 시스템
  • Harness 시스템 (GitHub 이슈 자동화)

참고: 상세 내용은 .history/ 디렉토리 참조

Key Decisions

날짜 결정 이유
2026-02-18 태그 → AI 이해 수동 태깅 한계, 자연어 검색이 더 직관적
2026-02-18 pgvector 선택 PostgreSQL과 통합, 별도 서버 불필요
2026-02-18 Phase별 점진적 개발 각 Phase가 독립적 가치 제공

Known Issues

이슈 상태 비고
기존 태그 시스템 분류 부정확 해결 예정 AI 이해로 대체
암묵지 공유 지연 해결 중 RAG 검색으로 개선

Architecture Notes

현재 상태:
┌──────────────┐     ┌──────────────┐
│   Frontend   │────▶│  Rust API   │
│   (React)    │     │  (Axum)     │
└──────────────┘     └──────┬───────┘
                            │
                    ┌───────┴───────┐
                    ▼               ▼
              ┌──────────┐   ┌──────────┐
              │PostgreSQL│   │OpenSearch│
              └──────────┘   └──────────┘

추가 예정:
              ┌──────────┐
              │ pgvector │ ← 벡터 임베딩
              └──────────┘

Session Log References

최근 세션 로그:

  • .history/2026-02-18_phase5_rust_migration.md
  • .history/2026-02-18_agent_command_skill_setup.md (예정)

레퍼런스 시스템

저장된 레퍼런스: .claude/references/

  • _index.json - 검색 인덱스 (3건)
  • research/ - 조사 결과
  • architecture/ - 아키텍처 패턴
  • apis/ - API 문서

Last updated: 2026-02-19