byuckchon-frontend-cli 1.9.7 → 1.10.0

package/src/generators/createMonorepo.js

@@ -1,6 +1,8 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
+import { versions } from '../constants/versions.js';
+import { readSettingsAsset } from '../utils/settingsAssets.js';
 import { createApp } from './createApp.js';
 import { scaffoldReviewAutomation } from './scaffoldReviewAutomation.js';
 
@@ -82,6 +84,8 @@ async function writeRootFiles(root, config, scope) {
       [config.appName]: `pnpm --filter @${scope}/${config.appName} dev`,
     },
     devDependencies: {
+      // 루트의 prettier.config.mjs 와 tsconfig.base.json 이 직접 참조한다.
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
       '@types/node': '^22.0.0',
       eslint: '^9.18.0',
       'eslint-config-prettier': '^10.1.8',
@@ -102,58 +106,22 @@ packages:
 `,
   );
 
-  await writeJson(path.join(root, 'turbo.json'), {
-    $schema: 'https://turborepo.org/schema.json',
-    ui: 'tui',
-    globalDependencies: ['tsconfig.base.json', '.env', '.env.*', '!.env*.local'],
-    globalEnv: ['NODE_ENV', 'CI'],
-    tasks: {
-      build: {
-        dependsOn: ['^build'],
-        outputs: ['dist/**', 'build/**', '.next/**', '!.next/cache/**', 'out/**'],
-        inputs: [
-          '$TURBO_DEFAULT$',
-          '!**/*.md',
-          '!**/*.test.ts',
-          '!**/*.test.tsx',
-          '!**/*.spec.ts',
-          '!**/*.spec.tsx',
-        ],
-      },
-      dev: { cache: false, persistent: true },
-      lint: { dependsOn: ['^build'], outputs: [] },
-      typecheck: { dependsOn: ['^build'], outputs: ['.tsbuildinfo', '**/*.tsbuildinfo'] },
-      'tokens:build': { outputs: ['src/tokens.css'] },
-      clean: { cache: false },
-    },
-  });
+  // turbo / .npmrc / .nvmrc 는 참조 문법이 없어서 내용을 복사한다.
+  // 이후 settings 가 바뀌면 `npx byuckchon-settings-sync` 로 갱신한다.
+  await write(path.join(root, 'turbo.json'), await readSettingsAsset('project/turbo.json'));
 
+  // 공통 옵션은 @byuckchon-frontend/settings 가 관리한다.
+  // 이 파일은 모노레포 전용 예외를 얹는 자리로만 남긴다.
   await writeJson(path.join(root, 'tsconfig.base.json'), {
     $schema: 'https://json.schemastore.org/tsconfig',
-    display: `${name} Base`,
+    display: `${config.projectName} Base`,
+    extends: '@byuckchon-frontend/settings/tsconfig/base.json',
     compilerOptions: {
-      target: 'ES2022',
-      lib: ['ES2022'],
-      module: 'ESNext',
-      moduleResolution: 'Bundler',
-      strict: true,
       noUncheckedIndexedAccess: true,
       noImplicitOverride: true,
-      noFallthroughCasesInSwitch: true,
-      useUnknownInCatchVariables: true,
-      exactOptionalPropertyTypes: false,
-      esModuleInterop: true,
       allowSyntheticDefaultImports: true,
-      forceConsistentCasingInFileNames: true,
-      resolveJsonModule: true,
-      isolatedModules: true,
-      verbatimModuleSyntax: false,
-      skipLibCheck: true,
       incremental: true,
-      composite: false,
-      types: [],
     },
-    exclude: ['node_modules', 'dist', 'build', '.turbo', '.next', 'coverage'],
   });
 
   await writeJson(path.join(root, 'tsconfig.json'), {
@@ -162,42 +130,19 @@ packages:
     include: [],
   });
 
-  await write(
-    path.join(root, '.npmrc'),
-    `# pnpm 동작 설정
-# React 버전 통일 및 (향후 Expo/RN 도입 대비) hoisted linker 사용.
-node-linker=hoisted
-
-public-hoist-pattern[]=*react*
-public-hoist-pattern[]=*@types/*
-public-hoist-pattern[]=*eslint*
-public-hoist-pattern[]=*prettier*
-
-strict-peer-dependencies=false
-auto-install-peers=true
-save-exact=false
-save-prefix=^
-prefer-frozen-lockfile=true
-`,
-  );
+  await write(path.join(root, '.npmrc'), await readSettingsAsset('project/npmrc'));
 
-  await write(path.join(root, '.nvmrc'), '20\n');
+  await write(path.join(root, '.nvmrc'), await readSettingsAsset('project/nvmrc'));
 
   await write(
     path.join(root, 'prettier.config.mjs'),
-    `/** @type {import("prettier").Config} */
+    `// 포맷 규칙은 @byuckchon-frontend/settings 가 관리합니다.
+// 이 모노레포 전용 예외가 필요하면 펼쳐서 덮어쓰세요.
+import byuckchon from '@byuckchon-frontend/settings/prettier';
+
+/** @type {import("prettier").Config} */
 export default {
-  semi: true,
-  singleQuote: true,
-  trailingComma: 'all',
-  tabWidth: 2,
-  printWidth: 100,
-  arrowParens: 'always',
-  endOfLine: 'lf',
-  bracketSpacing: true,
-  bracketSameLine: false,
-  jsxSingleQuote: false,
-  plugins: ['prettier-plugin-tailwindcss'],
+  ...byuckchon,
   overrides: [
     {
       files: ['*.json', '*.md', '*.yml', '*.yaml'],
@@ -205,7 +150,7 @@ export default {
     },
   ],
 };
-`,
+`
   );
 
   await write(
@@ -313,106 +258,54 @@ async function writeConfigTypescript(root, scope) {
   const dir = path.join(root, 'packages', 'config-typescript');
   await fs.mkdir(dir, { recursive: true });
 
+  // 프리셋 본체는 @byuckchon-frontend/settings 가 관리한다.
+  // 이 패키지는 모노레포 전용 예외를 얹을 자리로만 남긴다.
   await writeJson(path.join(dir, 'package.json'), {
     name: `@${scope}/config-typescript`,
     version: '0.0.0',
     private: true,
-    description: `Shared TypeScript config presets for @${scope} apps & packages`,
+    description: 'settings 의 TypeScript 프리셋을 이 모노레포용으로 감싼 패키지',
     files: ['base.json', 'library.json', 'react.json', 'next.json', 'node.json'],
-  });
-
-  await writeJson(path.join(dir, 'base.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Base',
-    extends: '../../tsconfig.base.json',
-  });
-
-  await writeJson(path.join(dir, 'react.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'React Web (Vite)',
-    extends: './base.json',
-    compilerOptions: {
-      lib: ['ES2022', 'DOM', 'DOM.Iterable'],
-      jsx: 'react-jsx',
-      moduleResolution: 'Bundler',
-      module: 'ESNext',
-      noEmit: true,
-      allowImportingTsExtensions: true,
-      useDefineForClassFields: true,
-      types: ['vite/client'],
-      noUncheckedIndexedAccess: false,
-    },
-  });
-
-  await writeJson(path.join(dir, 'next.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Next.js (App Router)',
-    extends: './base.json',
-    compilerOptions: {
-      lib: ['ES2022', 'DOM', 'DOM.Iterable'],
-      jsx: 'preserve',
-      module: 'ESNext',
-      moduleResolution: 'Bundler',
-      noEmit: true,
-      allowJs: true,
-      incremental: true,
-      plugins: [{ name: 'next' }],
-      noUncheckedIndexedAccess: false,
+    dependencies: {
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
     },
   });
 
-  await writeJson(path.join(dir, 'library.json'), {
+  const preset = (display, name) => ({
     $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Library (packages/*)',
-    extends: './base.json',
-    compilerOptions: {
-      declaration: true,
-      declarationMap: true,
-      sourceMap: true,
-      outDir: 'dist',
-      rootDir: 'src',
-      composite: true,
-    },
+    display,
+    extends: `@byuckchon-frontend/settings/tsconfig/${name}.json`,
   });
 
-  await writeJson(path.join(dir, 'node.json'), {
-    $schema: 'https://json.schemastore.org/tsconfig',
-    display: 'Node (scripts)',
-    extends: './base.json',
-    compilerOptions: {
-      lib: ['ES2022'],
-      module: 'NodeNext',
-      moduleResolution: 'NodeNext',
-      types: ['node'],
-    },
-  });
+  await writeJson(path.join(dir, 'base.json'), preset('Base', 'base'));
+  await writeJson(path.join(dir, 'react.json'), preset('React Web (Vite)', 'react'));
+  await writeJson(path.join(dir, 'next.json'), preset('Next.js (App Router)', 'next'));
+  await writeJson(path.join(dir, 'library.json'), preset('Library (packages/*)', 'library'));
+  await writeJson(path.join(dir, 'node.json'), preset('Node (scripts)', 'node'));
 }
 
 async function writeConfigEslint(root, scope) {
   const dir = path.join(root, 'packages', 'config-eslint');
   await fs.mkdir(dir, { recursive: true });
 
+  // 규칙 본체는 @byuckchon-frontend/settings 가 관리한다.
+  // 이 패키지는 모노레포 전용 예외를 얹을 자리로만 남긴다.
   await writeJson(path.join(dir, 'package.json'), {
     name: `@${scope}/config-eslint`,
     version: '0.0.0',
     private: true,
     type: 'module',
-    description: `Shared ESLint flat configs for @${scope} apps & packages`,
+    description: 'settings 의 ESLint 프리셋을 이 모노레포용으로 감싼 패키지',
     main: './base.js',
     exports: {
       '.': './base.js',
       './base': './base.js',
       './react': './react.js',
+      './next': './next.js',
     },
-    files: ['base.js', 'react.js'],
+    files: ['base.js', 'react.js', 'next.js'],
     dependencies: {
-      '@eslint/js': '^9.18.0',
-      'eslint-config-prettier': '^10.1.8',
-      'eslint-plugin-import': '^2.32.0',
-      'eslint-plugin-react': '^7.37.4',
-      'eslint-plugin-react-hooks': '^5.1.0',
-      globals: '^15.14.0',
-      'typescript-eslint': '^8.59.1',
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
     },
     peerDependencies: {
       eslint: '^9.0.0',
@@ -420,97 +313,17 @@ async function writeConfigEslint(root, scope) {
     },
   });
 
-  await write(
-    path.join(dir, 'base.js'),
-    `// @ts-check
-import js from '@eslint/js';
-import tseslint from 'typescript-eslint';
-import prettier from 'eslint-config-prettier';
-import importPlugin from 'eslint-plugin-import';
-import globals from 'globals';
+  const reexport = (name, named) => `// 규칙 본체는 @byuckchon-frontend/settings 가 관리합니다.
+// 이 모노레포에만 해당하는 예외는 아래 배열에 이어붙이세요.
+import byuckchon from '@byuckchon-frontend/settings/eslint/${name}';
 
-/**
- * 공통 ESLint flat config (TS 베이스).
- * @type {import("eslint").Linter.Config[]}
- */
-export const baseConfig = [
-  {
-    ignores: [
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/build/**',
-      '**/out/**',
-      '**/.next/**',
-      '**/.turbo/**',
-      '**/coverage/**',
-      '**/*.d.ts',
-    ],
-  },
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-  {
-    languageOptions: {
-      ecmaVersion: 2022,
-      sourceType: 'module',
-      globals: { ...globals.es2022 },
-    },
-    plugins: { import: importPlugin },
-    rules: {
-      'no-console': ['warn', { allow: ['warn', 'error'] }],
-      '@typescript-eslint/consistent-type-imports': [
-        'warn',
-        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
-      ],
-      '@typescript-eslint/no-unused-vars': [
-        'warn',
-        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
-      ],
-    },
-  },
-  prettier,
-];
-
-export default baseConfig;
-`,
-  );
-
-  await write(
-    path.join(dir, 'react.js'),
-    `// @ts-check
-import react from 'eslint-plugin-react';
-import reactHooks from 'eslint-plugin-react-hooks';
-import globals from 'globals';
+/** @type {import("eslint").Linter.Config[]} */
+export const ${named} = [...byuckchon];
 
-import { baseConfig } from './base.js';
+export default ${named};
+`;
 
-/**
- * React (Vite/Next) 앱용 ESLint config.
- * @type {import("eslint").Linter.Config[]}
- */
-export const reactConfig = [
-  ...baseConfig,
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
-    languageOptions: {
-      globals: { ...globals.browser, ...globals.es2022 },
-      parserOptions: { ecmaFeatures: { jsx: true } },
-    },
-    plugins: { react, 'react-hooks': reactHooks },
-    settings: { react: { version: 'detect' } },
-    rules: {
-      ...react.configs.recommended.rules,
-      ...react.configs['jsx-runtime'].rules,
-      ...reactHooks.configs.recommended.rules,
-      'react/prop-types': 'off',
-      'react/react-in-jsx-scope': 'off',
-      'react/no-unescaped-entities': 'off',
-      'react-hooks/rules-of-hooks': 'warn',
-      '@typescript-eslint/no-explicit-any': 'off',
-    },
-  },
-];
-
-export default reactConfig;
-`,
-  );
+  await write(path.join(dir, 'base.js'), reexport('base', 'baseConfig'));
+  await write(path.join(dir, 'react.js'), reexport('react', 'reactConfig'));
+  await write(path.join(dir, 'next.js'), reexport('next', 'nextConfig'));
 }

package/src/generators/createPackageJson.js

@@ -16,6 +16,8 @@ export async function createPackageJson(rootDir, config) {
           dev: 'vite',
           build: 'tsc -b && vite build',
           'tokens:build': 'style-dictionary build --config token.config.js',
+          // PR Check workflow 가 lint / typecheck / build 를 각각 호출한다.
+          typecheck: 'tsc -b',
           lint: 'eslint . --ext ts,tsx',
           preview: 'vite preview',
           format:
@@ -27,8 +29,9 @@ export async function createPackageJson(rootDir, config) {
           dev: 'next dev',
           build: 'next build',
           'tokens:build': 'style-dictionary build --config token.config.js',
+          typecheck: 'tsc --noEmit',
           start: 'next start',
-          lint: 'next lint',
+          lint: 'eslint .',
           format:
             'prettier --write "src/**/*.{ts,tsx,css}" "tools/**/*.{js,cjs,json,md}"',
           'format:check':
@@ -47,6 +50,8 @@ export async function createPackageJson(rootDir, config) {
           }
         : {}),
       zod: versions.zod,
+      clsx: versions.clsx,
+      'tailwind-merge': versions['tailwind-merge'],
     },
     devDependencies: {
       '@types/react': versions['@types/react'],
@@ -54,14 +59,10 @@ export async function createPackageJson(rootDir, config) {
       '@types/node': versions['@types/node'],
       '@trivago/prettier-plugin-sort-imports':
         versions['@trivago/prettier-plugin-sort-imports'],
+      // eslint/prettier/tsconfig/tokens 설정과 motion CSS 가 모두 이 패키지를 참조한다.
+      // (ESLint 플러그인도 이 패키지가 의존성으로 들고 온다)
+      '@byuckchon-frontend/settings': versions['@byuckchon-frontend/settings'],
       eslint: versions.eslint,
-      'eslint-config-expo': versions['eslint-config-expo'],
-      'eslint-import-resolver-typescript':
-        versions['eslint-import-resolver-typescript'],
-      'eslint-plugin-import': versions['eslint-plugin-import'],
-      'eslint-plugin-react': versions['eslint-plugin-react'],
-      'eslint-plugin-react-hooks': versions['eslint-plugin-react-hooks'],
-      'eslint-plugin-unused-imports': versions['eslint-plugin-unused-imports'],
       prettier: versions.prettier,
       'prettier-plugin-tailwindcss': versions['prettier-plugin-tailwindcss'],
       'style-dictionary': versions['style-dictionary'],
@@ -70,9 +71,6 @@ export async function createPackageJson(rootDir, config) {
       ...(isReact
         ? {
             '@tailwindcss/vite': versions['@tailwindcss/vite'],
-            '@typescript-eslint/eslint-plugin':
-              versions['@typescript-eslint/eslint-plugin'],
-            '@typescript-eslint/parser': versions['@typescript-eslint/parser'],
             '@vitejs/plugin-react': versions['@vitejs/plugin-react'],
             vite: versions.vite,
             'vite-plugin-svgr': versions['vite-plugin-svgr'],
@@ -81,6 +79,7 @@ export async function createPackageJson(rootDir, config) {
             '@tailwindcss/postcss': versions['@tailwindcss/postcss'],
             '@svgr/webpack': versions['@svgr/webpack'],
             'eslint-config-next': versions['eslint-config-next'],
+            '@eslint/eslintrc': versions['@eslint/eslintrc'],
           }),
     },
   };

package/src/generators/scaffoldReviewAutomation.js

@@ -7,10 +7,37 @@ const TEMPLATE_ROOT = path.resolve(
   '../../templates/review-automation',
 );
 
-const ESLINT_WORKFLOW_BY_PROJECT_TYPE = {
-  single: 'eslint-convention-review.single.yml',
-  monorepo: 'eslint-convention-review.monorepo.yml',
-};
+const PROJECT_TYPES = ['single', 'monorepo'];
+
+/**
+ * 워크플로 템플릿 이름 규칙
+ *   `<이름>.single.yml` / `<이름>.monorepo.yml` → 유형이 맞는 쪽만 `<이름>.yml` 로 복사
+ *   `<이름>.yml`                                → 유형과 무관하게 항상 복사
+ *
+ * @param {string[]} fileNames 템플릿 디렉터리의 파일 목록
+ * @param {'single' | 'monorepo'} projectType
+ * @returns {Array<{ source: string, target: string }>}
+ */
+function selectWorkflows(fileNames, projectType, exclude = []) {
+  const selected = [];
+
+  for (const fileName of fileNames) {
+    if (!fileName.endsWith('.yml')) continue;
+
+    const withoutExt = fileName.slice(0, -'.yml'.length);
+    const suffix = PROJECT_TYPES.find((type) => withoutExt.endsWith(`.${type}`));
+    const baseName = suffix
+      ? withoutExt.slice(0, -(suffix.length + 1))
+      : withoutExt;
+
+    if (exclude.includes(baseName)) continue;
+    if (suffix && suffix !== projectType) continue;
+
+    selected.push({ source: fileName, target: `${baseName}.yml` });
+  }
+
+  return selected;
+}
 
 function shouldCopyTemplateFile(source) {
   return path.basename(source) !== '.DS_Store';
@@ -38,23 +65,24 @@ async function copyFileIfAllowed(source, target, overwrite) {
  * 프로젝트 루트에 PR 리뷰 자동화 파일을 생성한다.
  *
  * - tools/ 는 ESLint convention rule 및 PR 댓글 게시 스크립트를 제공한다.
- * - .github/workflows/ 는 프로젝트 유형에 맞는 ESLint workflow 하나와
- *   공통 workflow(AI Code Review, PR Check 등)를 제공한다.
+ * - .github/workflows/ 는 프로젝트 유형에 맞는 워크플로를 제공한다.
+ *   템플릿 이름이 `<이름>.single.yml` / `<이름>.monorepo.yml` 이면 유형이 맞는 쪽만
+ *   `<이름>.yml` 로 복사되고, 접미사가 없으면 유형과 무관하게 복사된다.
  *
  * @param {object} args
  * @param {string} args.projectRoot 새로 생성한 프로젝트의 절대 경로
  * @param {'single' | 'monorepo'} args.projectType 생성할 프로젝트 유형
  * @param {boolean} [args.overwrite=true] 기존 파일을 템플릿으로 덮어쓸지
+ * @param {string[]} [args.exclude=[]] 제외할 워크플로 이름 (확장자·유형 접미사 제외)
  * @returns {Promise<{ toolsDir: string, workflows: string[] }>}
  */
 export async function scaffoldReviewAutomation({
   projectRoot,
   projectType,
   overwrite = true,
+  exclude = [],
 }) {
-  const eslintWorkflow = ESLINT_WORKFLOW_BY_PROJECT_TYPE[projectType];
-
-  if (!eslintWorkflow) {
+  if (!PROJECT_TYPES.includes(projectType)) {
     throw new Error(`지원하지 않는 프로젝트 유형입니다: ${projectType}`);
   }
 
@@ -72,33 +100,15 @@ export async function scaffoldReviewAutomation({
   await fs.mkdir(workflowsTargetDir, { recursive: true });
 
   const workflowFiles = await fs.readdir(workflowsTemplateDir);
-  const commonWorkflows = workflowFiles.filter(
-    (fileName) =>
-      fileName.endsWith('.yml') &&
-      !fileName.startsWith('eslint-convention-review.'),
-  );
   const copiedWorkflows = [];
 
-  for (const fileName of commonWorkflows) {
+  for (const { source, target } of selectWorkflows(workflowFiles, projectType, exclude)) {
     const copied = await copyFileIfAllowed(
-      path.join(workflowsTemplateDir, fileName),
-      path.join(workflowsTargetDir, fileName),
+      path.join(workflowsTemplateDir, source),
+      path.join(workflowsTargetDir, target),
       overwrite,
     );
-    if (copied) copiedWorkflows.push(fileName);
-  }
-
-  const eslintWorkflowTarget = path.join(
-    workflowsTargetDir,
-    'eslint-convention-review.yml',
-  );
-  const copiedEslintWorkflow = await copyFileIfAllowed(
-    path.join(workflowsTemplateDir, eslintWorkflow),
-    eslintWorkflowTarget,
-    overwrite,
-  );
-  if (copiedEslintWorkflow) {
-    copiedWorkflows.push('eslint-convention-review.yml');
+    if (copied) copiedWorkflows.push(target);
   }
 
   return { toolsDir: toolsTargetDir, workflows: copiedWorkflows };

package/src/utils/ensureRequiredDependencies.js

@@ -7,6 +7,13 @@ const execFile = promisify(execFileCallback);
 
 const COMMON_DEPENDENCIES = ['@tanstack/react-query', 'zod'];
 
+/**
+ * 스캐폴딩되는 설정 파일들이 참조하는 패키지.
+ * tools/review.config.mjs, eslint.config, prettier.config, tsconfig 가 모두
+ * @byuckchon-frontend/settings 를 import/extends 하므로 없으면 lint·build 가 실패한다.
+ */
+const COMMON_DEV_DEPENDENCIES = ['@byuckchon-frontend/settings'];
+
 const installCommands = {
   npm: ['npm', ['install']],
   pnpm: ['pnpm', ['add']],
@@ -14,6 +21,14 @@ const installCommands = {
   bun: ['bun', ['add']],
 };
 
+/** devDependencies 로 설치할 때 붙이는 플래그 */
+const devFlags = {
+  npm: '--save-dev',
+  pnpm: '-D',
+  yarn: '-D',
+  bun: '-d',
+};
+
 export function hasDependency(pkg, packageName) {
   return Boolean(
     pkg?.dependencies?.[packageName] ||
@@ -36,11 +51,11 @@ export async function ensureRequiredDependencies({
   packageManager,
   run = execFile,
 }) {
-  const missing = requiredDependenciesForFramework(framework).filter(
-    (packageName) => !hasDependency(pkg, packageName),
-  );
+  const notInstalled = (packageName) => !hasDependency(pkg, packageName);
+  const missing = requiredDependenciesForFramework(framework).filter(notInstalled);
+  const missingDev = COMMON_DEV_DEPENDENCIES.filter(notInstalled);
 
-  if (!missing.length) {
+  if (!missing.length && !missingDev.length) {
     return { installed: [], packageManager };
   }
 
@@ -48,11 +63,22 @@ export async function ensureRequiredDependencies({
     ? packageManager
     : 'npm';
   const [command, baseArgs] = installCommands[selectedPackageManager];
-  const packageSpecs = missing.map(
-    (packageName) => `${packageName}@${versions[packageName]}`,
-  );
+  const spec = (packageName) =>
+    versions[packageName] ? `${packageName}@${versions[packageName]}` : packageName;
 
-  await run(command, [...baseArgs, ...packageSpecs], { cwd });
+  if (missing.length) {
+    await run(command, [...baseArgs, ...missing.map(spec)], { cwd });
+  }
+  if (missingDev.length) {
+    await run(
+      command,
+      [...baseArgs, devFlags[selectedPackageManager], ...missingDev.map(spec)],
+      { cwd },
+    );
+  }
 
-  return { installed: missing, packageManager: selectedPackageManager };
+  return {
+    installed: [...missing, ...missingDev],
+    packageManager: selectedPackageManager,
+  };
 }

package/src/utils/settingsAssets.js

@@ -0,0 +1,27 @@
+/**
+ * @byuckchon-frontend/settings 가 관리하는 "파일로 존재해야 하는" 설정을 읽는다.
+ *
+ * eslint / prettier / tsconfig 는 프로젝트가 import·extends 로 참조하므로 여기 없다.
+ * 아래 파일들은 참조 문법이 없어서 생성 시점에 내용을 복사해야 한다.
+ * 이후 settings 가 바뀌면 프로젝트에서 `npx byuckchon-settings-sync` 로 갱신한다.
+ */
+
+import fs from 'node:fs/promises';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+/** settings 패키지 안의 파일 경로를 해석한다. */
+export function resolveSettingsAsset(subpath) {
+  return require.resolve(`@byuckchon-frontend/settings/${subpath}`);
+}
+
+/** settings 가 들고 있는 파일 내용을 문자열로 읽는다. */
+export async function readSettingsAsset(subpath) {
+  return fs.readFile(resolveSettingsAsset(subpath), 'utf8');
+}
+
+/** CLI 가 함께 배포되는 settings 의 실제 버전 (생성 프로젝트가 참조할 버전) */
+export function settingsVersion() {
+  return require('@byuckchon-frontend/settings/package.json').version;
+}