CrownyCode Phase 3 고도화 — 복합 규칙 엔진 + 메타 계층 v2

2026-05-27 | Phase 3 진입. 컴포저 v2 + 도메인 태깅 + 유사도 매핑 + 핫 캐시 통합 완료.

개요

크라우니코드 에이전트를 EVOLUTION_PLAN의 Phase 3 단계로 진입시켜, 단순 패턴 매칭에서 조건부·우선순위·도메인 인식 조합 + 의미 클러스터 + 핫 패스 캐시로 고도화. KPS Quadcode 흐름(clone → improved → original) 준수.

무엇을 했는지

1. 컴포저 v2 — 조건부 조합 + 우선순위 + 도메인

composer/rules_v2.dat 신규. 기존 4필드 → 8필드 형식:

복합intent | 필요패턴 | 조합순서 | 추가코드 | 도메인 | 우선순위 | 조건 | 비고

• 조건: IF:has(X) UNLESS:has(X) WHEN:domain=X HOT:N 4종
• 우선순위: 1(최고)~9(최저), 같은 intent에 여러 규칙이 있을 때 자동 선택
• 도메인 태그: 셀코어/금융/서버/자료구조/문자열/수학/파일/DB/IoT/메타/기본
• 총 75 규칙 (P1=16, P2=17, P3=42, 조건부 5)
• 매처 composer/rules_meta.sh (match/list/stats/validate)

2. 도메인 태깅 시스템

intent/domain_tags.dat — 130+ prefix/키워드 → 도메인+레벨 매핑. intent/tag_intent.sh — 정확/prefix/keyword 3단계 매칭. data/intent_tags.cache — 학습DB 21,173 intent 전체 태깅 (1회 빌드).

매칭 결과: selcore_workflow → 셀코어|3|prefix:selcore_, quick_sort → 알고리즘|2|exact.

3. 유사도 매핑 엔진

intent/similarity.sh — 트라이그램 + 자카드 유사도.

• score <a> <b> — 0~1 점수
• near <intent> [N] — 가까운 N개 추천
• cluster <intent> [임계] — 임계 이상 클러스터
• build [임계] — 전체 인덱스 사전 빌드

예시: tcp_server 근처 → tcp_echo_server(0.61), http_server(0.47), hanseon_tcp_server(0.45).

4. 핫 패스 캐시

data/hot_cache.sh — LRU 캐시 + 사용 빈도 추적.

• usage_freq.dat — 사용 빈도+마지막접근 시각
• hot_cache.dat — 인코딩된 코드 직접 캐싱 (개행 \n 인코딩)
• hit / access / promote / evict / top / candidates
• 임계 3회 도달 시 핫 후보로 자동 식별

5. agent.sh v2 통합

• search_pattern() 진입 시 hot_cache hit 우선 (캐시 히트 시 즉시 반환)
• 새 명령 추가: agent.sh v2 [rule|tag|near|hot|stats]
• 기존 흐름 무손상 — v2는 추가 레이어로만 동작

6. KPS Quadcode 흐름 완료

[1] clone "Phase 3 고도화 v2"
[2] improved (작업 + 검증)
[3] original ← promote (백업: crownycode-original-backup-20260527145044)

관련 파일

파일	역할
/Users/ef/Downloads/CrownyTVM/crownycode-agent/composer/rules_v2.dat	75 규칙 v2
…/composer/rules_meta.sh	v2 매처
…/intent/domain_tags.dat	130+ 도메인 매핑
…/intent/tag_intent.sh	자동 태깅기
…/intent/similarity.sh	유사도 엔진
…/data/hot_cache.sh	핫 캐시 매니저
…/data/intent_tags.cache	21,173 intent 태깅 캐시
…/agent.sh	v2 통합 (hot 체크 + v2 서브커맨드)
백업	crownycode-original-backup-20260527145044/

검증

v2 형식 검증: 성공 (75/75)
rules_meta match selcore_db        → P1 매칭 (셀코어DB import 포함)
tag_intent tag finance_ledger       → 금융|3|prefix:finance_
similarity score tcp/udp_server     → 0.50
hot_cache top                       → 톱 사용빈도 추적
agent.sh v2 stats                   → 통합 통계 정상 출력

잔여 이슈 / 다음 단계

도메인 태깅 default 94%: 21,173 intent 중 19,872개가 미매핑. domain_tags.dat 확장 필요 (특히 학습DB의 영어 intent들).

유사도 인덱스 전체 빌드: O(N²)이라 21K intent에 시간 소요. prefix 버킷 도입 권장.

Phase 4 진입 준비:

패턴 유추 엔진 (기존 패턴 → 변형 자동 생성)

의미어 합성 (A+B → C 자동 발견)

역방향 학습 (에러 → 수정 규칙 추출)

agent.sh의 run_agent 흐름도 v2 rule_meta match를 호출해서 조건부/우선순위가 실제 코드 생성에 반영되게 통합 필요 (현재는 v2 명령에서만 호출 가능).

agent.sh v2 hot 자동 승격: 핫 후보를 검출해서 캐시 자동 승격하는 cron 훅.

비중

크라우니코드 비중: 58% (변화 없음 — 인프라 작업)
패턴 직접매칭: 25,095 / 규칙 변환: 13,018 / 클로드 생성: 16,011
학습DB: 11,014(CrownyOS) + 34,733(홈) + 3,052,060(주DB) 패턴
태깅 캐시: 21,173 intent