빌드: workspace 검증과 패키징을 선언적 task graph로 전환한다

[developer-1px]

상위·선행 이슈

• 상위: 전략: FE 생태계 수렴 기준으로 저장소 구현 모양을 표준화한다 #412
• 선행: TypeScript shared profile과 project graph

배경

루트 verify:companions와 pack:companions는 모든 package를 긴 shell chain으로 직접 나열한다. package를 추가할 때 workspaces, verify, pack과 dependency pre-script를 여러 곳에서 수정해야 한다.

외부 수렴 근거

• npm Workspaces: 전체 또는 선택 workspace에서 동일 script 실행
• TypeScript build mode: project reference graph에 따른 build ordering
• Nx Run Tasks: project graph에서 task graph, 병렬 실행과 dependency ordering 파생

별도 orchestrator 채택 여부는 수렴하지 않았으므로, 먼저 현재 npm workspace에서 가능한 최소 선언 구조를 기준으로 한다.

목표

workspace와 package metadata를 task 대상의 정본으로 삼아 수동 package 목록을 제거한다.

범위

• verify 대상 파생
• pack 대상 파생
• package dependency ordering
• missing optional script 처리
• release check 구성

보존할 계약

• package별 verify 의미
• release gate 범위
• standard/docs/site/browser 검증
• dry-run package 검증

제외 범위

• 근거 없는 Nx/Turborepo 도입
• remote cache
• CI provider 변경
• 검증 단계 삭제

완료 조건

• 새 library workspace 추가 시 루트 package 목록을 중복 수정하지 않는다.
• build와 verify 순서는 dependency graph로 설명된다.
• 현재 release check가 검증하는 범위를 그대로 증명한다.

검증

• npm run verify
• npm run release:check 또는 동일 범위의 dry-run
• 신규 임시 workspace 없이 정적 대상 누락 검사

[developer-1px]

진행 계획

1. root의 package 나열과 각 workspace script/배포 여부를 대조해 현재 task 대상 계약을 고정합니다.
2. npm workspace metadata에서 verify·pack 대상을 파생하는 최소 runner를 구현합니다.
3. #417의 TypeScript project graph를 build ordering의 정본으로 사용하고 package별 verify 의미는 보존합니다.
4. 누락 script 처리, release gate 동등성, dry-run package 검증을 자동 검사합니다.
5. 전체 검증 후 커밋·푸시하고 빌드: TypeScript 설정과 project graph를 통합한다 #424 위 스택 PR을 등록합니다.

#418은 #417의 solution graph가 명시된 상태를 선행 조건으로 하므로 build/417-typescript-project-graph에서 분기합니다.

[developer-1px]

구현 및 검증 결과

• scripts/workspace-tasks.mjs가 root workspaces와 package metadata에서 15개 library를 파생합니다.
• runtime·dev dependency를 topological sort해 verify와 test 선행 build 순서를 계산합니다.
• package build는 tsc -b tsconfig.json으로 project references를 따르고 수동 prebuild package 목록을 제거했습니다.
• root verify:libraries, pack:libraries, workspace:check로 수동 package chain을 대체했습니다.
• release:check와 verify의 standards/docs/site/browser/perf 범위는 유지했습니다.
• pack runner가 15개 dry-run tarball을 검사하고 .tsbuildinfo 누출을 실패 처리합니다.

검증

• npm run workspace:check 통과: 15 library workspace와 solution/reference 일치
• clean 상태의 단독 React Hook Form verify 통과: test-only Zod dependency 자동 build 증명
• npm run verify:libraries 통과
• npm run verify 통과: library 전체, docs, site typecheck 23 tests, Pages build/smoke, Playwright 53 tests
• npm run release:check 통과: standards, conformance 215 tests, docs, perf budget, 15 package dry-run 포함
• git diff --check 통과

pack 검증 중 발견한 build metadata 배포 누출과 v3 guard 불일치는 선행 PR #424의 db40562b, caa8061b 커밋으로도 보완했습니다.

[developer-1px]

PR을 등록했습니다: #425

• 커밋: cd3f904a
• base: build/417-typescript-project-graph (빌드: TypeScript 설정과 project graph를 통합한다 #424 위 스택)
• 원격 commit, 변경 파일, base/head를 다시 읽어 상관관계를 확인했습니다.
• 로컬 verify, release:check, pre-push solution build가 모두 통과했습니다.
• 빌드: TypeScript 설정과 project graph를 통합한다 #424 병합 뒤 base를 main으로 전환해야 합니다.