CrownyDoc 문서함 견적서 제안서 도면 + 새 문서 문서편집기 프로젝트문서 기술백서

한선씨 2026-06-27 8KB 읽기 8분

cowork 한선씨·셀코어 감사 보고서

날짜: 2026-06-27
대상 경로: /Users/ef/crowny-cowork/
감사 항목: .한선 컴파일 상태 / JS 한선씨 동반 / 셀코어 로직DB 적용 여부

1. 컴파일 결과 — 전체 10파일 성공

파일	줄수	컴파일
인증.한선	38	✅ OK
세팅싱크.한선	46	✅ OK
소통상태.한선	33	✅ OK
오너피드.한선	33	✅ OK
지원분류.한선	40	✅ OK
협업.한선	16	✅ OK
태스크교환.한선	15	✅ OK
커밋체인.한선	43	✅ OK
고도화.한선	48	✅ OK
코워크서버.한선	162	✅ OK
합계	474줄	10/10 성공

런타임 주의사항

hanseonc_high 인증.한선 | crownyc run 파이프라인이 60초 안에 완료되지 않았다. 원인 후보: 해시_SHA256() 내장함수(opcode 291, hanseonc_high.c L1313 확인됨)가 외부 호출을 사용하거나, crownyc run이 stdin 대기 상태로 진입하는 것. 컴파일 자체는 성공이지만 CI 수준의 런타임 통과 검증은 미완료.

2. JS 모듈 한선씨 동반 현황

총줄수 비교

구분	파일수	총 줄수
.한선 파일	10	474줄
.js 파일	9	3,309줄
한선씨 비율		~12.5%

헌법 기준 70% 미달. 위반 상태.

모듈별 동반 현황

JS 모듈	줄수	동반 .한선	상태
auth-tier.js	504	인증.한선, 세팅싱크.한선	✅
collab.js	150	협업.한선, 고도화.한선	✅
support.js	134	지원분류.한선	✅
tasks.js	57	태스크교환.한선	✅
owner.js	54	오너피드.한선	✅
server.js	2,108	코워크서버.한선 (불완전)	⚠️ 갭
bundle-build.js	17	없음	❌
crowny-admin-init.js	54	없음	❌
crowny-admin-server.js	227	없음	❌

코워크서버.한선 vs server.js 갭 (가장 심각)

코워크서버.한선(162줄)은 초기 프로토타입이다. server.js(2,108줄)에는 40+개 라우트가 있으나, 코워크서버.한선이 커버하는 것은 4개뿐이다:

/api/status, /api/libs, /api/workers, /api/activity

커버되지 않는 주요 라우트:

인증 라우트(login/logout/me/accounts)
설정 번들 API(/api/setting-bundle)
블록체인 노드/커밋 API (/api/node/*, /api/commit*)
지원 티켓 API (/api/support/*)
오너 피드 API (/api/feed, /api/owner/*)
협업 작업 API (/api/work*)
태스크 교환 API (/api/task*)
패키지 다운로드 인증 게이팅 (/api/download/*, /api/packages)
원격 컴파일 실행 (/api/compile)
설치 스크립트 생성(generateRunBundle, generateSetupScript 등)

또한 코워크서버.한선 58번째 줄에서 설정() 내장함수를 배열 읽기 용도로 잘못 사용 중이다:

// L57: 잘못된 사용 (설정=쓰기 내장함수)
변수 아이디 = 설정(키목록, i, 0)

// 올바른 배열 인덱스 읽기
변수 아이디 = 키목록[i]

설정(배열, 인덱스, 새값)은 배열 쓰기 함수다. 컴파일은 통과하지만 의도한 읽기 동작과 다르다.

3. 셀코어 로직DB 적용 현황

전체 .한선 파일에 가져오기 "셀코어" 없음. 셀코어 미사용 상태.

server.js 81번째 줄에 셀코어 경로 참조가 있으나, 이는 카탈로그 디렉토리 목록용이며 실제 셀코어 룰 엔진 사용이 아니다. server.js 2003번째 줄에 '셀코어.한선' 문자열이 있으나, 이는 라이브러리 이름 목록의 예시 항목이다.

셀코어 적용이 필요한 위치 (우선순위 순)

위치	대상 함수	이유
지원분류.한선 L4-12	`분류(코어변경, 보안, 삭제, 라이브영향, 범위밖, 질문, 문서수정, 모호)`	8파라미터 if-else → 셀코어 분류룰 8개로 변환. 티켓 유형이 늘어날 때 코드 수정 없이 룰 추가 가능
협업.한선 L3-6	`승인결정(공유, 구축, 특허, 요청있음, 범위밖)`	4상 승인 결정 → 셀코어 조건 룰로 추출해 오너 설정으로 변경 가능
소통상태.한선 L5-11	`대화상태(상태, 마지막사용자)`	지원 채팅 상태기계 → 셀코어 전이 룰로 변환. 상태 추가가 룰 추가로 해결됨
고도화.한선 L29-34	`고도화결정(활성노드, 미처리, 승인대기, 평균레벨점수)`	플랫폼 성숙도 4상 판정 → 셀코어 룰로 누적 학습 가능
오너피드.한선 L5-12	`피드분류(종류)`, `세션행동(미반영수)`	오너 메시지 이벤트 처리 → 셀코어 이벤트버스 룰 패턴 적합
태스크교환.한선 L3-7	`다음상태(현재, 이벤트)`	태스크 상태기계 → 셀코어 전이룰(현재상태+이벤트 → 다음상태)
세팅싱크.한선 L12-17	`사상결정(티어번호)`	티어→4상 매핑 → 셀코어 조건 룰(단순하지만 패턴 통일성)

셀코어 적용 예시 (지원분류.한선 기준)

javascript// 현재 방식 (if-else)
함수 분류(코어변경, 보안, ...) {
  만약 (범위밖 == 1) { 반환 "타" }
  만약 (코어변경 == 1 또는 보안 == 1 ...) { 반환 "음" }
  ...
}

// 셀코어 적용 방식
가져오기 "셀코어"

변수 룰_범위밖 = 룰생성("범위밖", 100)
룰_범위밖 = 룰조건추가(룰_범위밖, "범위밖", "==", 1)
룰_범위밖 = 룰변경추가(룰_범위밖, "결정", "타")

변수 룰_신중 = 룰생성("신중작업", 90)
룰_신중 = 룰조건추가(룰_신중, "코어변경", "==", 1)
룰_신중 = 룰변경추가(룰_신중, "결정", "음")
// ... 추가 룰 등록

4. 미동반 JS 파일 — 동반 .한선 작성 필요

bundle-build.js (17줄)

역할: buildBundleNow() 코어 로직을 서브프로세스에서 실행 (execSync tar 격리)
동반 필요: 번들빌드.한선 — 번들 키 생성, 파일 선택 로직, 타임스탬프 생성

crowny-admin-init.js (54줄)

역할: HTTP 서버 생성 시 /api/admin/* 핸들러를 자동 래핑
동반 필요: 관리자초기화.한선 — 라우트 래핑 결정 로직 (if startsWith('/api/admin/'))

crowny-admin-server.js (227줄)

역할: 어드민 패널 API (로그인/세션/요청관리/디스패치/triggers)
동반 필요: 관리자서버.한선 — 세션 TTL 관리, 요청 큐 처리 4상 결정

5. 종합 지표

항목	현황	기준	판정
컴파일 성공률	10/10 (100%)	100%	✅ 통과
런타임 검증	미완료 (타임아웃)	전체 통과	⚠️ 요검증
한선씨 비율	12.5%	70% 이상	❌ 위반
셀코어 적용	0/10 파일	4상 결정은 전부	❌ 미적용
JS 미동반	3개 파일(298줄)	0개	❌ 위반
코워크서버.한선 포화도	4/40+ 라우트	핵심 커버	⚠️ 갭

6. 권장 조치 순서

즉시: 코워크서버.한선 L57 설정() → 키목록[i] 수정
이번 세션: 지원분류.한선 + 협업.한선 + 소통상태.한선에 셀코어 적용 (3파일, 가장 로직이 명확)
다음 세션: bundle-build.js, crowny-admin-init.js, crowny-admin-server.js 동반 .한선 작성
중기: 코워크서버.한선을 server.js 핵심 라우트(인증/설정번들/패키지/지원/태스크) 커버로 확장
지속: 런타임 타임아웃 원인 파악 (인증.한선 실행 시 crownyc run이 stdin 대기 여부 확인)