byuckchon-frontend-cli 1.9.7 → 1.10.1

package/README.md

@@ -225,25 +225,78 @@ https://www.figma.com/design/.../?node-id=12-34
 | **Components** 화 (♦ 마름모 아이콘)     | 반복 UI 가 component 면 모델이 "이거 디자인 시스템 컴포넌트구나" 인식 → 코드에서도 재사용 컴포넌트를 만듭니다. |
 | frame 별로 **"Copy link to selection"** | 일반 share link 는 파일 전체. 특정 frame URL 을 받아야 AI 가 그것만 정확히 가져옵니다. |
 
+### 디자인 토큰 빌드
+
+`bc init`으로 생성한 프로젝트에는 토큰 변환 설정이 함께 들어갑니다.
+
+```text
+token.config.js     # @byuckchon-frontend/settings/tokens 프리셋을 사용
+src/tokens.json     # 디자이너가 Figma(Tokens Studio)에서 export 한 파일을 여기에 덮어씀
+src/tokens.css      # 아래 명령으로 자동 생성 (직접 수정하지 않음)
+```
+
+```bash
+npm run tokens:build
+```
+
+color는 `@theme`의 `--color-*`로, typography는 `@utility text-*`로, motion 등 나머지 토큰은
+`:root` 변수로 출력됩니다. duration 값이 단위 없는 숫자면 `ms`가 자동으로 붙고, settings에 없는
+`--motion-*` 이름이 있으면 경고가 나옵니다. 변환 규칙은 `@byuckchon-frontend/settings`가
+관리하므로, 규칙이 바뀌면 패키지 버전만 올리면 기존 프로젝트에도 그대로 반영됩니다.
+
 ### ESLint Convention Review
 
 `bc init`과 `bc adopt`는 프로젝트 루트에 아래 파일을 준비합니다.
 
 ```text
-.github/workflows/eslint-convention-review.yml
-tools/eslint-rules/
-tools/post-eslint-review-comments.cjs
+.github/workflows/eslint-convention-review.yml   # 컨벤션 인라인 댓글
+.github/workflows/pr-check.yml                   # lint / typecheck / build 통과 여부 (bc init 전용)
+.github/workflows/pr-description.yml             # 커밋 내역을 PR 본문에 반영
+.github/pull_request_template.md
+tools/review.config.mjs
 ```
 
+`pr-check.yml` 은 `bc init` 으로 생성한 프로젝트에만 추가됩니다.
+스크립트 이름·대상 브랜치·패키지 매니저를 전제하기 때문에, 기존 프로젝트에
+`bc adopt` 할 때는 추가하지 않습니다. 필요하면 위 파일을 참고해 직접 만드세요.
+
+워크플로 템플릿은 프로젝트 유형에 맞는 것만 복사됩니다.
+(`<이름>.single.yml` / `<이름>.monorepo.yml` → `<이름>.yml`)
+단일 프로젝트는 npm, 모노레포는 pnpm + turbo 기준으로 만들어집니다.
+
+복사된 파일이므로 **프로젝트 소유**입니다. 대상 브랜치나 단계를 자유롭게 고치세요.
+settings 를 올려도 이 파일은 바뀌지 않습니다.
+
 PR이 `dev` 브랜치를 대상으로 할 때, workflow가 기계적으로 판별 가능한 규칙을 검사하고
 변경 줄에 댓글을 게시합니다.
 
+컨벤션 규칙과 댓글 게시 스크립트는 `@byuckchon-frontend/settings`가 제공합니다.
+프로젝트에 규칙 사본을 두지 않으므로, 규칙이 바뀌면 settings 버전만 올리면 됩니다.
+
 | 구분 | 담당 | 결과 |
 | --- | --- | --- |
 | 일반 lint | 기존 ESLint 규칙 | Actions annotation |
 | Convention Review | 파일명, export 방식, boolean 변수명 등 | PR 인라인 `BLOCKING` 또는 `WARNING` 댓글 |
 | AI 리뷰 | 설계·예외 처리·비즈니스 판단 | 별도 AI 리뷰 workflow에서 구성 |
 
+### PR 본문 자동 작성
+
+`pr-description.yml` 이 PR 의 커밋을 타입별로 묶어 description 에 채워 넣습니다.
+
+```markdown
+### ✨ 기능
+- **settings** — tsconfig 프리셋 추가 (a1b2c3d)
+
+### 🐛 수정
+- letterSpacing % → em 변환 (b2c3d4e)
+```
+
+사람이 쓴 내용은 건드리지 않고 `<!-- byuckchon:commits:start -->` 마커 사이만 갱신하며,
+커밋을 추가로 푸시하면 목록도 따라 갱신됩니다. 머지 커밋은 제외하고, 컨벤션을 안 지킨
+커밋은 버리지 않고 "분류 없음"으로 모읍니다.
+
+생성되는 `.github/pull_request_template.md` 에 마커가 미리 들어 있습니다.
+
 같은 지적은 숨김 marker를 기준으로 중복 게시하지 않고, 메시지가 바뀌면 기존 댓글을 갱신합니다.
 모노레포에서는 workflow와 `tools/`가 루트에 한 번만 존재하며, PR에서 변경된 TypeScript 파일을
 대상으로 검사합니다.
@@ -317,8 +370,9 @@ bc chat --resume <session-id>
 - 기존 모노레포에 `bc adopt`를 적용할 때, 모노레포용 `review.config.mjs`는
   `packages/config-eslint/react.js` 구조를 전제로 합니다. ESLint 설정 구조가 다르면 해당 import를
   프로젝트에 맞게 조정해야 합니다.
-- AI Code Review와 typecheck·lint·build·test를 담당하는 PR Check workflow는 현재 자동 생성 대상이
-  아닙니다. 팀의 AI 제공자·테스트 전략에 맞춰 별도로 추가해야 합니다.
+- AI Code Review workflow는 자동 생성 대상이 아닙니다. 팀의 AI 제공자에 맞춰 별도로 추가해야 합니다.
+- PR Check workflow는 lint · typecheck · build 만 실행합니다. 테스트는 팀의 전략에 맞춰
+  생성된 `pr-check.yml` 에 단계를 추가하세요.
 
 ## 제품 로드맵
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byuckchon-frontend-cli",
-  "version": "1.9.7",
+  "version": "1.10.1",
   "description": "Byuckchon Frontend Workbench — project starter + AI chat + codebase RAG + OpenAPI codegen",
   "type": "module",
   "engines": {
@@ -14,9 +14,12 @@
     "start": "node bin/index.js",
     "chat": "node bin/index.js chat",
     "init": "node bin/index.js init",
-    "config": "node bin/index.js config show"
+    "config": "node bin/index.js config show",
+    "release": "changeset publish",
+    "version-packages": "changeset version"
   },
   "dependencies": {
+    "@byuckchon-frontend/settings": "^1.6.0",
     "@ai-sdk/anthropic": "^3.0.85",
     "@ai-sdk/openai": "^3.0.73",
     "ai": "^6.0.208",
@@ -65,5 +68,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/RevolutionaryWarrior/byuckchon-frontend-cli.git"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8"
   }
 }

package/src/commands/adopt.js

@@ -188,25 +188,34 @@ export async function adoptCommand(opts = {}) {
       projectRoot: reviewProjectRoot,
       projectType,
       overwrite: false,
+      // PR Check 는 스크립트 이름·브랜치·패키지 매니저를 전제하므로
+      // 기존 프로젝트에 말없이 깔면 CI 가 곧바로 실패한다. bc init 전용으로 둔다.
+      exclude: ['pr-check'],
     });
 
     if (reviewAutomation.workflows.length) {
       console.log(
         chalk.green(
-          `  ✓ ESLint Convention Review 설정 추가: ${path.join(reviewProjectRoot, '.github', 'workflows')}`,
+          `  ✓ PR 워크플로 추가: ${path.join(reviewProjectRoot, '.github', 'workflows')}`,
+        ),
+      );
+      console.log(chalk.dim(`    ${reviewAutomation.workflows.join(', ')}`));
+      console.log(
+        chalk.dim(
+          '    (PR Check 워크플로는 기존 프로젝트의 스크립트·브랜치 설정을 전제하므로 추가하지 않습니다)',
         ),
       );
     } else {
       console.log(
         chalk.dim(
-          `  ESLint Convention Review 설정 유지: ${path.join(reviewProjectRoot, '.github', 'workflows')} (이미 존재)`,
+          `  PR 워크플로 유지: ${path.join(reviewProjectRoot, '.github', 'workflows')} (이미 존재)`,
         ),
       );
     }
   } catch (error) {
     console.log(
       chalk.yellow(
-        `  ⚠ ESLint Convention Review 설정을 추가하지 못했습니다: ${error.message}`,
+        `  ⚠ PR 워크플로를 추가하지 못했습니다: ${error.message}`,
       ),
     );
   }

package/src/constants/versions.js

@@ -1,50 +1,16 @@
-export const versions = {
-  // Core frameworks
-  react: '^18.3.1',
-  'react-dom': '^18.3.1',
-  'next-react': '^19.2.1',
-  'next-react-dom': '^19.2.1',
-  next: '15.1.9',
-
-  // Build tool (React only)
-  vite: '^6.0.0',
-  '@vitejs/plugin-react': '^4.3.0',
-  'vite-plugin-svgr': '^4.3.0',
-  '@svgr/webpack': '^8.1.0',
-
-  // TypeScript
-  typescript: '^5.7.0',
-  '@types/react': '^18.3.3',
-  '@types/react-dom': '^18.3.0',
-  '@types/node': '^22.0.0',
+/**
+ * 검증된 스택 버전 매트릭스.
+ *
+ * 본체는 @byuckchon-frontend/settings 가 관리한다.
+ * 여기서는 settings 자신의 버전만 얹는다 — 자기 자신의 버전을 자기가 들고 있으면
+ * 어긋나기 때문에, CLI 와 함께 설치된 settings 의 실제 버전을 읽어서 쓴다.
+ */
 
-  // State & Data
-  zustand: '^5.0.3',
-  axios: '^1.8.4',
-  'react-router-dom': '^7.5.0',
-  '@tanstack/react-query': '^5.74.4',
+import { versions as shared } from '@byuckchon-frontend/settings/versions';
 
-  // Styling
-  tailwindcss: '^4.1.4',
-  '@tailwindcss/vite': '^4.1.4',
-  '@tailwindcss/postcss': '^4',
+import { settingsVersion } from '../utils/settingsAssets.js';
 
-  // Linting
-  eslint: '^8.57.0',
-  'eslint-config-expo': '^8.0.0',
-  'eslint-config-next': '^15.0.0',
-  'eslint-import-resolver-typescript': '^3.6.0',
-  'eslint-plugin-import': '^2.29.0',
-  'eslint-plugin-react': '^7.34.0',
-  'eslint-plugin-react-hooks': '^4.6.0',
-  '@typescript-eslint/eslint-plugin': '^7.0.0',
-  '@typescript-eslint/parser': '^7.0.0',
-
-  // Formatting
-  prettier: '^3.3.0',
-  'prettier-plugin-tailwindcss': '^0.6.11',
-  'style-dictionary': '^5.4.0',
-  zod: '^3.24.3',
-  '@trivago/prettier-plugin-sort-imports': '^5.2.2',
-  'eslint-plugin-unused-imports': '^4.1.4',
+export const versions = {
+  ...shared,
+  '@byuckchon-frontend/settings': `^${settingsVersion()}`,
 };

package/src/generators/createApp.js

@@ -92,17 +92,18 @@ async function createAppPackageJson(appDir, config, scope) {
           }
         : {}),
       zod: versions.zod,
+      clsx: versions.clsx,
+      'tailwind-merge': versions['tailwind-merge'],
     },
     devDependencies: {
       [`@${scope}/config-eslint`]: 'workspace:*',
       [`@${scope}/config-typescript`]: 'workspace:*',
+      // global.d.ts, App.css(motion), token.config.js 가 직접 참조한다.
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
       '@types/react': versions['@types/react'],
       '@types/react-dom': versions['@types/react-dom'],
       '@types/node': versions['@types/node'],
-      // 모노레포 앱은 flat config(@scope/config-eslint) 를 쓰므로 ESLint 9 필요.
-      // (단일 프로젝트의 eslintrc + eslint 8 과 별개)
-      eslint: '^9.18.0',
-      'eslint-plugin-unused-imports': versions['eslint-plugin-unused-imports'],
+      eslint: versions.eslint,
       prettier: versions.prettier,
       'prettier-plugin-tailwindcss': versions['prettier-plugin-tailwindcss'],
       'style-dictionary': versions['style-dictionary'],
@@ -135,32 +136,18 @@ async function applyMonorepoConventions(appDir, config, scope) {
   const isReact = config.framework === 'react';
 
   // 루트에서 관리하는 설정들은 앱 레벨에서 제거.
-  await rm(path.join(appDir, '.eslintrc.cjs'));
-  await rm(path.join(appDir, '.prettierrc'));
+  await rm(path.join(appDir, 'eslint.config.js'));
+  await rm(path.join(appDir, 'eslint.config.mjs'));
+  await rm(path.join(appDir, 'prettier.config.js'));
   await rm(path.join(appDir, '.gitignore'));
   await rm(path.join(appDir, '.vscode'));
 
-  // 공유 ESLint 프리셋을 extends 하는 flat config.
+  // 공유 ESLint 프리셋을 그대로 쓴다.
+  // 규칙 본체는 @byuckchon-frontend/settings 가 관리하고,
+  // 이 모노레포 전용 예외는 packages/config-eslint 에서 얹는다.
   await write(
     path.join(appDir, 'eslint.config.mjs'),
-    `import { reactConfig } from '@${scope}/config-eslint/react';
-import unusedImports from 'eslint-plugin-unused-imports';
-
-export default [
-  ...reactConfig,
-  {
-    plugins: { 'unused-imports': unusedImports },
-    rules: {
-      'no-unused-vars': 'off',
-      '@typescript-eslint/no-unused-vars': 'off',
-      'unused-imports/no-unused-imports': 'error',
-      'unused-imports/no-unused-vars': [
-        'warn',
-        { vars: 'all', varsIgnorePattern: '^_', args: 'after-used', argsIgnorePattern: '^_' },
-      ],
-    },
-  },
-];
+    `export { default } from '@${scope}/config-eslint/${isReact ? 'react' : 'next'}';
 `
   );
 
@@ -174,11 +161,8 @@ export default [
         {
           extends: `@${scope}/config-typescript/react.json`,
           compilerOptions: {
+            // 공통 옵션은 config-typescript → settings 프리셋에 있다.
             tsBuildInfoFile: './node_modules/.tmp/tsconfig.tsbuildinfo',
-            noUnusedLocals: true,
-            noUnusedParameters: true,
-            noUncheckedSideEffectImports: true,
-            moduleDetection: 'force',
             baseUrl: '.',
             paths: {
               '@/*': ['src/*'],