verify-shared-packages

Purpose

1. •워크스페이스 임포트 — @cg/shared, @cg/api, @cg/ui 별칭만 사용하고 직접 상대경로 임포트가 없는지 검증
2. •Re-export 완전성 — 각 패키지의 index.ts가 모든 하위 모듈을 re-export하는지 검증
3. •타입-스키마 정합성 — TypeScript 타입과 Zod 스키마가 올바르게 정렬되어 있는지 검증
4. •상수 일관성 — 상수 값이 코드베이스 전체에서 일관되게 사용되는지 검증

When to Run

• •packages/shared/src/ 하위 파일을 추가하거나 수정한 후
• •packages/api/src/ 또는 packages/ui/src/ 파일을 수정한 후
• •새로운 타입, 상수, 또는 Zod 스키마를 추가한 후
• •패키지 간 의존성을 변경한 후

Related Files

Workflow

Step 1: 직접 상대경로 임포트 방지

도구: Grep

검사: apps/ 디렉토리에서 packages/로의 직접 상대경로 임포트가 없는지 확인합니다.

Grep: pattern="from ['\"]\.\..*packages/" path="apps/" glob="*.{ts,tsx}" output_mode="content"
Grep: pattern="from ['\"].*\/packages\/" path="apps/" glob="*.{ts,tsx}" output_mode="content"

PASS: 출력이 비어있음 (모든 임포트가 @cg/* 별칭 사용) FAIL: 직접 경로로 패키지를 임포트하는 파일이 있음

수정: @cg/shared, @cg/api, @cg/ui 별칭으로 교체

Step 2: Constants re-export 완전성 확인

도구: Bash, Grep

검사: packages/shared/src/constants/ 디렉토리의 모든 .ts 파일이 index.ts에서 re-export되는지 확인합니다.

# constants 디렉토리의 모든 모듈 파일 (index.ts 제외)
ls packages/shared/src/constants/*.ts | grep -v index.ts | sed 's|.*/||;s|\.ts||'

# index.ts에서 export하는 모듈 목록
grep "export.*from" packages/shared/src/constants/index.ts | sed "s|.*'\./||;s|'.*||"

PASS: 두 목록이 일치 FAIL: re-export 되지 않은 파일이 존재

Step 3: Types re-export 완전성 확인

도구: Bash, Grep

검사: packages/shared/src/types/ 디렉토리의 모든 .ts 파일이 index.ts에서 re-export되는지 확인합니다.

# types 디렉토리의 모든 모듈 파일
ls packages/shared/src/types/*.ts | grep -v index.ts | sed 's|.*/||;s|\.ts||'

# index.ts에서 export하는 모듈 목록
grep "export.*from" packages/shared/src/types/index.ts | sed "s|.*'\./||;s|'.*||"

PASS: 두 목록이 일치 FAIL: re-export 되지 않은 타입 파일이 존재

Step 4: Validation re-export 완전성 확인

도구: Bash, Grep

검사: packages/shared/src/validation/ 디렉토리의 모든 .ts 파일이 index.ts에서 re-export되는지 확인합니다.

# validation 디렉토리의 모든 모듈 파일
ls packages/shared/src/validation/*.ts | grep -v index.ts | sed 's|.*/||;s|\.ts||'

# index.ts에서 export하는 모듈 목록
grep "export.*from" packages/shared/src/validation/index.ts | sed "s|.*'\./||;s|'.*||"

PASS: 두 목록이 일치 FAIL: re-export 되지 않은 스키마 파일이 존재

Step 5: 패키지 간 의존성 방향 확인

도구: Grep

검사: 패키지 간 의존성이 올바른 방향인지 확인합니다 (shared → api → apps, shared → ui → apps).

Grep: pattern="@cg/api|@cg/ui" path="packages/shared/src/" glob="*.ts" output_mode="content"
Grep: pattern="@cg/ui" path="packages/api/src/" glob="*.ts" output_mode="content"

PASS: 출력이 비어있음 (의존성 방향 올바름) FAIL: 역방향 의존성이 존재

Output Format

Exceptions

1. •packages/shared/src/types/database.ts — Supabase CLI로 자동 생성되는 파일이므로 직접 편집하지 않음. pnpm db:generate로 갱신
2. •packages/config/ — 설정 패키지(@cg/config)는 tsconfig, ESLint 등 빌드 도구 설정만 포함하며 런타임 코드가 아니므로 re-export 검증 대상이 아님
3. •packages/ui/src/lib/utils.ts — cn() 유틸리티가 @cg/shared를 임포트하지 않고 자체 clsx + tailwind-merge 구현을 사용하는 것은 정상 (UI 패키지의 독립성 유지)