의미어코드 릴리즈 준비 — 라이선스 결격 해소 + 잔여 정제 + 전수 왕복 회귀
개요
2026-07-07 감사 후속 조치. 의미어코드 코드북 정본(실어휘코드북v2.psv/실어휘코드북v2_한글.psv, 4,164행)의
릴리즈 결격 사유(라이선스 저작자 표시 누락, 한글글로스 fallback 27건, 왕복 회귀 미검증, 레거시 파일 혼재)를 해소했다.
무엇을 했는지
1. NOTICE/LICENSE 작성
/Users/ef/crowny-butler/libs/실어휘코드북-NOTICE.md 신규 작성.
- 소스 4종(Concepticon 3.4.0/CC BY 4.0, GWA Base Concepts/CC BY, PWN SemCor/WordNet License, OMW/CC BY·CC BY-SA 혼재)별 저작자 표시 문구 명시.
- 코드북 자체 배포 라이선스 = CC BY 4.0 계승.
- BabelNet/KorLex 혼입 재검증:
grep -il 'babelnet\|korlex'두 정본 psv → 0건.libs/의미어*전체 → 1건(의미어코드_스펙v1.md뿐이며 그 1건도 §2-2 "편입 금지" 정책 조항 + 참고문헌 링크일 뿐 실데이터 혼입 아님). 혼입 없음 검증(2026-07-07) 확정.
2. 한글글로스 fallback 27건 정제
실어휘코드북v2_한글.psv에서 col8(한글글로스)이 영문 원문 그대로 남아있던 27행을 자연스러운 한국어로 번역·교체.
예: CUT NUT→썬 빈랑, BROTHER-IN-LAW→매부, ORION'S BELT→오리온 벨트, COCK(Warfare/hunting 문맥, 총의 공이치기)→공이치기 등.
- 수정 전 백업:
실어휘코드북v2_한글.psv.bak-glossfix - 검증:
awk -F'|' 'NF!=8'→ 5건(모두 주석#행, 데이터행 아님), 데이터행수 4164 불변, CR 0건, 후행 개행 보존, 잔여 영문전용 글로스 0건.
3. 전수 왕복 회귀 스위트
신규/Users/ef/crowny-butler/libs/의미어왕복회귀.한선 작성·컴파일·실행(crownyc, exit0).
- 검증항목: ①주소조립(A==P4374+O729+S) ②주소분해(온톨/장/순번 —
의미어코어v2.한선의 실동작 확정 함수 재사용) ③ISA 디스패처 항등(연산0 분기) ④재조립 ⑤주소 유일성(사전 기반) - 4095 배열캡·480k 문자열풀 회피: 버퍼바이트 정수 줄스캔 스트리밍(
갑옷코어라우터.한선의 기 검증 패턴 재사용, crownycode 학습 HIT). - 결과: 4,164/4,164 PASS, 실패 0, 주소충돌 0. Node.js 독립 재구현으로 교차검증도 동일 결과.
- 기록:
/Users/ef/crowny-butler/data/의미어왕복회귀-2026-07-07.psv - VM 함정 발견:
버퍼잘라(BUF_SLICE, opcode395) 내장함수 주석은 "버퍼,시작,길이"로 오기돼있으나 실제 C구현은 3번째 인자를 절대 끝offset으로 받는다. 길이로 오인해 호출하면 파싱 결과가 전부 깨지며 조용히 실패(첫 실행 시 4163/4164 주소충돌로 발현).crowny-knowledge.sh add로 feedback 셀 #22173 기록.
4. 레거시 정리 — 이동 보류(참조 존재)
실어휘코드북.psv/실어휘코드북_O.psv(둘 다 /Users/ef/crowny-butler/ 루트에 위치, libs/ 아님)를
legacy-코드북/로 이동하기 전 참조 검사(grep -rl '실어휘코드북\.psv\|실어휘코드북_O' --include='*.한선' --include='*.js' --include='*.sh') 결과 22개 파일에서 참조 확인 → 이동하지 않고 참조 목록만 보고(작업 지시대로).
런타임 실참조: 의미어디코더.js(CODEBOOK_O = path.join(DIR,'실어휘코드북_O.psv'), fs.readFileSync 실사용). 나머지는 주로 .한선 파일 내 출처 주석/구버전 데이터.
전체 22개 참조 파일: 의미어학습파이프.js 의미어E2E실증.js 신규어학습.js 커버리지확장.js 의미어디코더.js 의미어검색.js 신규어폐루프.js 의미어통합데모.js data/병합5000.js libs/통합파이프검증.한선 libs/실데이터개선.한선 libs/어텐션특징실데이터.한선 libs/다차원임베딩어텐션.한선 libs/다토큰문맥어텐션.한선 libs/실데이터앙상블.한선 libs/실어휘O학습.한선 libs/자연어의미장v2.한선 libs/계층실데이터.한선 libs/통합파이프4완성.한선 libs/의미장대규모.한선 libs/자연어의미장.한선 libs/온톨로지인코딩v2.한선 libs/실어휘4164분류.한선 libs/K4어텐션실투입.한선
※ 실어휘코드북v2_한글.psv의 기존 백업 3종(.bak-07070007/.bak-07070532/.bak-glossfix)은 레거시가 아니라 현행 릴리즈 파일의 안전백업이므로 이동 대상에서 제외.관련 파일 경로
/Users/ef/crowny-butler/libs/실어휘코드북-NOTICE.md(신규)/Users/ef/crowny-butler/libs/실어휘코드북v2_한글.psv(col8 27건 수정)/Users/ef/crowny-butler/libs/실어휘코드북v2_한글.psv.bak-glossfix(수정 전 백업)/Users/ef/crowny-butler/libs/의미어왕복회귀.한선(신규)/Users/ef/crowny-butler/data/의미어왕복회귀-2026-07-07.psv(신규, 결과기록)/Users/ef/crowny-butler/의미어디코더.js(레거시 psv 실참조 확인, 미이동)
잔여 이슈
실어휘코드북.psv/실어휘코드북_O.psv레거시 정리는 22개 참조 파일을 v2 체계로 먼저 마이그레이션한 뒤 재시도 필요(특히의미어디코더.js는 v1 SemCode 공식(729 단일블록)을 쓰고 있어 v2 4374/729 이중블록 공식과 불일치 — 별도 마이그레이션 작업 필요).버퍼잘라내장함수 주석(hanseonc_high.c) 자체는 오기 상태로 남아있음 — 코드 정정은 별도 승인 필요(정본 컴파일러 소스 수정 범위 밖으로 이번 작업에서는 knowledge 기록만).