설치 — @comfozi/* 패키지
comfozi는 하나의 앱이 아니라 얼린 base + 조립형 패키지 + 플러그인으로 구성된 멀티패키지 제품입니다. 각 패키지는 독립 repo이며, GitLab 패키지 레지스트리에 @comfozi/* 스코프로 배포됩니다.
1. 레지스트리 인증 (.npmrc)
@comfozi/* 는 GitLab 레지스트리에서 받습니다. 프로젝트 루트 .npmrc에 스코프 레지스트리와 토큰을 설정합니다.
@comfozi:registry=https://gitlab.com/api/v4/packages/npm/
//gitlab.com/api/v4/packages/npm/:_authToken=${GITLAB_TOKEN}
노트
GITLAB_TOKEN은 read_api(최소) 권한의 개인/프로젝트 토큰입니다. 토큰은 커밋하지 말고 환경변수로 주입하세요.
2. 설치
# 앱을 그대로 쓰는 경우 (권장 시작점)
git clone https://gitlab.com/blaybus2026-vibe/comfozi.app
cd comfozi.app
npm install # @comfozi/* 를 GitLab 레지스트리에서 설치
# 개별 패키지만 소비하는 경우
npm install @comfozi/ui-kit @comfozi/contract @comfozi/detectors
glpkg는 이 @comfozi/* 패키지들을 빌드·버전·배포하는 사내 도구입니다. 소비 측은 위처럼 표준 npm install로 받으면 됩니다.
3. 패키지 지도
| 패키지 | 레이어 | 역할 |
|---|---|---|
@comfozi/contract | 🧊 얼린 base | 타입·필드 SSOT · 예외 taxonomy · ExportShape · Detector/Guard/Plugin 인터페이스 |
@comfozi/guards | 🧊 얼린 base | 자동승인 금지 · 필수누락 승인차단 · 승인 항목만 export |
@comfozi/detectors | 🔓 열린 | 규칙 탐지 4종(누락·중복·규격·단위) + ingest |
@comfozi/data · @comfozi/data-raw | 🔓 열린 | 골든20 fixture + 시드 생성기 / 240 파싱 픽스처 |
@comfozi/ui-kit | 🔓 열린 | 검수 인박스 UI + 플러그인 슬롯 호스트 |
@comfozi/parse-fleet · @comfozi/doc-import | 🔓 열린 | 문서 파싱(결정적 → 저신뢰 문서만 CLI-AI 폴백) |
@comfozi/approval-ml · approval-anomaly | 🔓 탐색 | 모델 생성기 · 이상탐지 콜드스타트 |
@comfozi/plugin.* | 🧩 플러그인 | diff-view · gbm-score · explain-card · provenance 등 7종 |