인수인계서 — 세션 56 (kdyextract Galaxy Con 28개 + kdyupdate)
작성일: 2026-03-08 이전 세션: session55
작업 요약
/kdyextract Mode A로 Galaxy Con (260301) 프로젝트에서 범용 재사용 코드 28개 파일을 추출하여 3개 신규 카테고리에 배치. /kdyupdate로 CLAUDE.md 카탈로그 동기화 완료.
수정 파일 (33개)
| # | 파일 | 변경 내용 |
|---|---|---|
| 1 | 02-reusable-code/15-crawler-patterns/README.md | 크롤러 패턴 모듈 문서 신규 |
| 2 | 02-reusable-code/15-crawler-patterns/types.ts | 범용 크롤러 타입 (RawItem, NormalizedItem, SourceAdapter) |
| 3 | 02-reusable-code/15-crawler-patterns/config.ts | 설정 프레임워크 |
| 4 | 02-reusable-code/15-crawler-patterns/cli.ts | CLI 프레임워크 |
| 5 | 02-reusable-code/15-crawler-patterns/sources/base-source.ts | HTML 크롤러 추상 베이스 |
| 6 | 02-reusable-code/15-crawler-patterns/sources/base-api-source.ts | REST API 크롤러 추상 베이스 |
| 7 | 02-reusable-code/15-crawler-patterns/pipeline/fetcher.ts | HTTP 클라이언트 + RateLimiter |
| 8 | 02-reusable-code/15-crawler-patterns/pipeline/deduplicator.ts | 퍼지 중복 제거 (Dice coefficient) |
| 9 | 02-reusable-code/15-crawler-patterns/pipeline/cross-source-dedup.ts | 5계층 교차소스 중복 제거 |
| 10 | 02-reusable-code/15-crawler-patterns/pipeline/completeness.ts | 데이터 완성도 점수 |
| 11 | 02-reusable-code/15-crawler-patterns/pipeline/normalizer.ts | 정규화 오케스트레이터 |
| 12 | 02-reusable-code/15-crawler-patterns/pipeline/validator.ts | Zod 검증 프레임워크 |
| 13 | 02-reusable-code/15-crawler-patterns/pipeline/run-pipeline.ts | 파이프라인 오케스트레이션 |
| 14 | 02-reusable-code/15-crawler-patterns/pipeline/global-text.ts | 영어 날짜/금액 파서 |
| 15 | 02-reusable-code/15-crawler-patterns/pipeline/korean-text.ts | 한국어 날짜/금액 파서 |
| 16 | 02-reusable-code/15-crawler-patterns/pipeline/currency-converter.ts | 다통화 변환 |
| 17 | 02-reusable-code/15-crawler-patterns/storage/db-writer.ts | 범용 DB upsert + 로깅 |
| 18 | 02-reusable-code/16-algorithm-engines/README.md | 알고리즘 엔진 모듈 문서 신규 |
| 19 | 02-reusable-code/16-algorithm-engines/physics/boids.ts | Boids 군집 알고리즘 |
| 20 | 02-reusable-code/16-algorithm-engines/physics/n-body.ts | N-Body 중력 시뮬레이션 |
| 21 | 02-reusable-code/16-algorithm-engines/canvas/BoidsCanvas.tsx | Boids 캔버스 렌더러 |
| 22 | 02-reusable-code/16-algorithm-engines/canvas/BoidsBackground.tsx | 전체화면 Boids 배경 |
| 23 | 02-reusable-code/16-algorithm-engines/canvas/GalaxyCanvas.tsx | 은하계 인터랙티브 캔버스 |
| 24 | 02-reusable-code/16-algorithm-engines/canvas/MandelbrotCanvas.tsx | WebGL 만델브로 프랙탈 |
| 25 | 02-reusable-code/16-algorithm-engines/canvas/FluidCanvas.tsx | WebGL 2.0 유체역학 시뮬레이션 |
| 26 | 02-reusable-code/16-algorithm-engines/canvas/JuliaPreview.tsx | 줄리아 집합 프리뷰 |
| 27 | 02-reusable-code/17-verification-patterns/README.md | 검증 패턴 모듈 문서 신규 |
| 28 | 02-reusable-code/17-verification-patterns/types.ts | 검증 타입 (TrustSignals, VerificationResult) |
| 29 | 02-reusable-code/17-verification-patterns/trust-score.ts | 가중치 기반 신뢰 점수 (0-100) |
| 30 | 02-reusable-code/17-verification-patterns/url-verification.ts | URLhaus + VirusTotal 이중 검증 |
| 31 | 02-reusable-code/17-verification-patterns/index.ts | 검증 오케스트레이터 |
| 32 | CLAUDE.md | 폴더 구조 + 추출 이력 + 에이전트 폴더 항목 |
| 33 | 02-reusable-code/README.md | 파일 인덱스 섹션 추가 |
상세 변경 사항
1. 15-crawler-patterns/ — 웹 크롤링 파이프라인 프레임워크
- Galaxy Con의 공모전 크롤러 시스템에서 범용 패턴 추출
RawContest→RawItem,NormalizedContest→NormalizedItem으로 범용화- 소스 팩토리, DB 라이터, 카테고리 맵퍼를 외부 주입 방식으로 변경
- 통화 변환 타겟 통화를 파라미터화 (hardcoded KRW → configurable)
- 5단계 파이프라인: 수집 → 정규화 → 중복제거 → 검증 → 저장
2. 16-algorithm-engines/ — 알고리즘 엔진 + 캔버스 시각화
- Boids 군집 알고리즘, N-Body 중력 시뮬레이션 (순수 물리 엔진)
- WebGL 프랙탈 (만델브로, 줄리아), Navier-Stokes 유체역학
- N-Body에서 공모전 데이터 매핑 제거 → 범용
StarInput인터페이스 - GalaxyCanvas에서 라우터/목데이터 제거 → 범용 data/callback props
3. 17-verification-patterns/ — 엔티티 신뢰도 검증
- Trust Score 가중치 엔진 (configurable weights)
- URL 안전성 이중 검증 (URLhaus + VirusTotal)
ContestVerificationInput→VerificationInput으로 범용화- DB 의존성 제거 → 외부 주입 (checkKnownEntity, verifyBusiness)
4. kdyupdate — CLAUDE.md 카탈로그 동기화
- 04-agents/ 폴더 구조에 GitHub 에이전트 5개 항목 추가
- 스킬 테이블(26개), 에이전트 테이블(13개)은 이미 동기화 상태
터치하지 않은 영역
docs/references/_COMPONENT_MAP.md— inception 미실행~/.claude/skills/— 글로벌 스킬 동기화 미실행- Galaxy Con 원본 프로젝트 — 변경 없음
알려진 이슈
- 추출된 파일들의
import경로가 상대 경로로 되어 있어, 실제 프로젝트에/kdypick으로 적용 시 경로 조정 필요 - 15-crawler-patterns/의
RetryPolicy의존성이 인라인 재시도 로직으로 대체됨 — 기존03-utils/retry-policy.ts와 통합 검토 필요
다음 작업 제안
/kdysync실행 — kdyintel, kdymarket, kdymcp, kdyspike 글로벌 스킬 동기화/inception실행 — 신규 3개 카테고리 (15/16/17) 연결 등록- 실 프로젝트에서
/kdypick으로 15-crawler-patterns/ 적용 테스트