CIF/CVF 사료 정리 — crowny-image 죽은 코드 표시 + CIF-R 명명
개요
권고4(사료 정리) 실행: crowny-image의 미배선 구(v2) 변환 경로를 삭제 없이 표시하고, CIF_SPEC.md를 실체와 일치하도록 "CIF-R(래스터 쿼드트리)"로 정체성 명명 + 적용범위 절 신설. CIF변환기.한선의 허위 방사형 퍼짐 필드 주석도 정정. 소거는 아카이브 원칙에 따라 rm 없이 주석 부착만 수행(라이브 서비스 최소침습).
무엇을 했는지
- server.js 죽은 v2 경로 표시 (
enqueueConvert/rawToCIF/tritTreeEncode)
enqueueConvert( 호출은 자기 정의 1건뿐, 외부 호출 0건(전체 리포 기준).
rawToCIF/tritTreeEncode는 enqueueConvert 내부에서만 도달 — 같은 죽은 체인.
- 삭제 대신 각 함수 정의 직전에 주석만 부착:
// [DEPRECATED 2026-07-12] 미배선 죽은 경로 — 라이브는 rasterToCIFv3(CIF-R)·civToPixelBuffer(CIF-V)
- 라이브 경로(rasterToCIFv3, civToPixelBuffer)는 무변경.- CIF_SPEC.md — CIF-R 명명 + 적용범위 절
CIFV_SPEC.md, civToPixelBuffer)와의 구분 명시.
- §0 적용범위 절 신설: 부드러운/합성 콘텐츠 전용, 사진·노이즈·고주파 부적합.
2026-06-11 실측 인용(CIF-CVF-4K-밸런싱-분석.md) — 노이즈/고주파 128px: CIF-R 312KB vs
PNG 15KB = CIF/PNG 20.8배 참패(이전 버전 문서 작성 시 표 열을 CIF/PNG 반대로 옮겨적어
한 차례 재수정함 — 최종본은 원본 표와 일치).
- 버전이력에 2026-07-12 문서 갱신 항목 추가(정체성 명명 + 적용범위 근거 명시).- CIF변환기.한선 — 퍼짐 필드 주석 정정
t[18..23] 퍼짐 (반지름=3t, 강도=3t) (마치 방사형 확산이 실동작하는 것처럼 읽히는 주석)
→ t[18..23] 퍼짐은 미구현(사산) — 방사형은 CIF-V op8로 실동작 승계(CIF벡터.한선)
- grep 확인: "퍼짐" 키는 씨앗생성()에서 항상 0으로만 대입되고, 다른 어디서도 계산/대입되지
않음(값은 항상 0, 주석만 방사형 취급).검증
node --check server.js→ 통과.launchctl kickstart -k gui/$(id -u)/com.crowny.image→/health200 ({"상태":"정상",...}).- 회귀:
~/.claude/scripts/civ.sh 데모(CIF-V) → PNG 512×512 33306B 정상 렌더. - 회귀:
POST /encode4×4 체커보드 픽셀 →{씨앗수:9, 압축률:1050}→GET /png/:id→ HTTP 200,
file로 PNG 4×4 8-bit RGB 확인(CIF-R 경로 무손상).관련 파일
/Users/ef/crowny-image/server.js(주석 3건 추가, 로직 무변경)/Users/ef/crowny-image/CIF_SPEC.md(제목/개요/§0/버전이력 갱신)/Users/ef/crowny-image/CIF변환기.한선(주석 1건 정정)/Users/ef/crowny-image/CIFV_SPEC.md(참조만, 무변경)- 근거:
/Users/ef/CrownyDoc/projects/2026-06-11-CIF-CVF-4K-밸런싱-분석.md
잔여 이슈
- CIF_SPEC.md 본문 2~9절은 여전히 "CIF는..."(구 명칭) 표현이 다수 남아있음 — 이번 작업은
- crowny-image는 git 저장소가 아님(
.git없음) — 커밋/crowny-hub 인수인계 불가, 변경사항은