sh-ui-cli 0.92.0 → 0.93.0

package/data/changelog/versions.json

@@ -2,6 +2,21 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.93.0",
+      "date": "2026-05-14",
+      "title": "vite 프리셋 Sentry observability opt-in (--observability sentry)",
+      "type": "minor",
+      "highlights": [
+        "**`--observability sentry` 옵션** — vite preset 에 opt-in Sentry 셋업 추가. `@sentry/react` (deps) + `@sentry/vite-plugin` (devDeps) + `Sentry.init({...})` (DSN 가드, browserTracing + replay PII 보호 디폴트) + `SentryProvider` (ErrorBoundary wrap) + `.env.example` 자동 emit. DSN 빈 값이면 init 자동 skip — dev/CI 안전. ai-org 처럼 error tracking 부터 들어가는 워크로드 5분 boilerplate 제거.",
+        "**enum 디자인** — `observability: z.enum(['none', 'sentry'])` future-extensible. GlitchTip 등 Sentry-protocol 호환 서비스는 같은 SDK + DSN 만 변경하면 동작 (라이브러리 lock-in 아님). 추후 `glitchtip` / `bugsnag` 등 enum 확장 자연스럽게.",
+        "**Source map upload 자동 셋업** — `vite.config.ts` 에 `sentryVitePlugin({ org, project, authToken, disable: !SENTRY_AUTH_TOKEN })` 자동 추가 + `build.sourcemap: true`. SENTRY_AUTH_TOKEN 이 env 에 있으면 빌드 시 source map 자동 업로드, 없으면 plugin disable. CI 친화.",
+        "**i18n + Sentry 동시 시 wrapper 순서 보장** — SentryProvider 가 OUTERMOST (모든 children error 캐치) → I18nProvider → ThemeProvider → QueryClientProvider. Smoke V20 가 wrapper index 순서 단언으로 회귀 가드.",
+        "**Vite types 자동 reference** — emit 된 `sentry.ts` 가 `/// <reference types=\"vite/client\" />` triple-slash 로 `import.meta.env.VITE_SENTRY_DSN` 타입 정확. 사용자 tsconfig 손댈 필요 X.",
+        "**guards + 회귀** — `observability + platform !== 'vite'` 조합은 CLI + MCP 양쪽에서 명시적 Korean 에러. Smoke V18 (positive), V19 (default opt-out 회귀), V20 (i18n + sentry combo wrapper 순서). docs `/create` 페이지도 observability 토글 노출."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.93.0"
+    },
     {
       "version": "0.92.0",
       "date": "2026-05-14",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.92.0",
+  "version": "0.93.0",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

package/src/api.d.ts

@@ -145,6 +145,8 @@ export interface DescribeTemplateOptions {
   i18n?: 'none' | 'react-i18next';
   /** i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en' */
   locales?: string;
+  /** vite 전용 — Sentry observability opt-in. v0.93.0+ */
+  observability?: 'none' | 'sentry';
 }
 
 export interface DescribeTemplateGroup {

package/src/constants.js

@@ -60,3 +60,8 @@ export const INIT_DEFAULTS = {
 export const I18N_LIBRARIES = ['none', 'react-i18next'];
 export const I18N_DEFAULT = 'none';
 export const I18N_DEFAULT_LOCALES = 'ko,en';
+
+// ─── observability (vite preset 전용 — v0.93.0+) ───
+// 'none' 디폴트 — opt-in 으로 @sentry/react + @sentry/vite-plugin 설치 + 셋업.
+// GlitchTip self-hosted 도 같은 SDK — DSN 만 변경. 향후 bugsnag 등 추가 시 enum 확장.
+export const OBSERVABILITY_PROVIDERS = ['none', 'sentry'];

package/src/create/cli-args.js

@@ -4,6 +4,7 @@ import {
   CSS_FRAMEWORKS_SUPPORTED,
   CSS_FRAMEWORKS_PLANNED,
   I18N_LIBRARIES,
+  OBSERVABILITY_PROVIDERS,
 } from '../constants.js';
 import { allPlugins } from './plugins/index.js';
 import { allArchitectures } from './architectures/index.js';
@@ -13,7 +14,7 @@ const VALID_STRUCTURES = CREATE_STRUCTURES;
 const VALID_PLUGINS = allPlugins.map((p) => p.name);
 const VALID_ARCHES = allArchitectures.map((a) => a.name);
 
-const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales'];
+const VALUE_FLAGS = ['platform', 'structure', 'plugins', 'theme', 'app', 'css', 'arch', 'port', 'i18n', 'locales', 'observability'];
 const BOOL_FLAGS = ['yes', 'help', 'dry-run', 'tauri'];
 
 const SUBCOMMANDS = ['add-app', 'add-component'];
@@ -79,6 +80,9 @@ export const parseArgs = (argv) => {
     if (name === 'i18n' && !I18N_LIBRARIES.includes(value)) {
       throw new Error(`--i18n 은 ${I18N_LIBRARIES.join('/')} 중 하나여야 함 (받은 값: ${value})`);
     }
+    if (name === 'observability' && !OBSERVABILITY_PROVIDERS.includes(value)) {
+      throw new Error(`--observability 는 ${OBSERVABILITY_PROVIDERS.join('/')} 중 하나여야 함 (받은 값: ${value})`);
+    }
     if (name === 'css' && !CSS_FRAMEWORKS_SUPPORTED.includes(value)) {
       // planned 값은 '곧 옵니다' 신호로 분기 — 사용자 의도가 더 명확히 전달.
       if (CSS_FRAMEWORKS_PLANNED.includes(value)) {

package/src/create/describeTemplate.js

@@ -38,6 +38,7 @@ import { CSS_FRAMEWORK_DEFAULT } from '../constants.js';
  * @property {boolean} [tauri]                        platform=vite (standalone/monorepo 둘 다) 일 때 Tauri 2.x 셸 같이 emit
  * @property {'none'|'react-i18next'} [i18n]          vite 전용 — react-i18next 셋업
  * @property {string} [locales]                       i18n 활성화 시 생성할 locale 코드 (comma-separated, default 'ko,en')
+ * @property {'none'|'sentry'} [observability]        vite 전용 — Sentry 셋업 (v0.93.0+)
  */
 
 /**
@@ -68,6 +69,7 @@ export function describeTemplate(opts = {}) {
     tauri = false,
     i18n = 'none',
     locales = 'ko,en',
+    observability = 'none',
   } = opts;
 
   if (platform === 'flutter') {
@@ -116,6 +118,17 @@ export function describeTemplate(opts = {}) {
         ];
         groups.push(makeGroup('i18n', `i18n (${i18n})`, i18nFiles));
       }
+      if (observability === 'sentry') {
+        const isFsd = safeArchName === 'fsd';
+        const obsBase = isFsd ? 'src/shared/observability' : 'src/lib/observability';
+        const providersBase = isFsd ? 'src/app/providers' : 'src/components/providers';
+        groups.push(makeGroup('sentry', `Sentry observability`, [
+          `${obsBase}/sentry.ts`,
+          `${obsBase}/index.ts`,
+          `${providersBase}/SentryProvider.tsx`,
+          '.env.example',
+        ]));
+      }
       return finalize(groups);
     }
 
@@ -180,6 +193,18 @@ export function describeTemplate(opts = {}) {
       groups.push(makeGroup('i18n', `i18n (${i18n}, apps/${appName}/)`, i18nFiles));
     }
 
+    if (observability === 'sentry') {
+      const isFsd = safeArchName === 'fsd';
+      const obsBase = isFsd ? 'src/shared/observability' : 'src/lib/observability';
+      const providersBase = isFsd ? 'src/app/providers' : 'src/components/providers';
+      groups.push(makeGroup('sentry', `Sentry observability (apps/${appName}/)`, [
+        `apps/${appName}/${obsBase}/sentry.ts`,
+        `apps/${appName}/${obsBase}/index.ts`,
+        `apps/${appName}/${providersBase}/SentryProvider.tsx`,
+        `apps/${appName}/.env.example`,
+      ]));
+    }
+
     return finalize(groups);
   }
 

package/src/create/generator.js

@@ -231,6 +231,13 @@ export async function createProject(options = {}) {
     );
   }
 
+  // observability 옵션도 vite preset 전용. v0.93.0+.
+  if (options.observability && options.observability !== 'none' && platform !== 'vite') {
+    throw new Error(
+      `observability='${options.observability}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${platform}). --observability none 또는 --platform vite 사용.`,
+    );
+  }
+
   // arch 결정 — platform 확정 후. 사용자가 --arch 미지정 시:
   //   - next  → DEFAULT_ARCH ('fsd')
   //   - flutter → 현재 Flutter arch 디스크립터 없음 → null. 미래에 flutter arch 추가되면
@@ -355,6 +362,7 @@ export async function createProject(options = {}) {
         tauri: !!options.tauri,
         i18n: options.i18n ?? 'none',
         locales: options.locales ?? 'ko,en',
+        observability: options.observability ?? 'none',
       });
     } else {
       await generateMonorepo(targetDir, projectName, [], {
@@ -363,6 +371,7 @@ export async function createProject(options = {}) {
         tauri: options.tauri,
         i18n: options.i18n ?? 'none',
         locales: options.locales ?? 'ko,en',
+        observability: options.observability ?? 'none',
       });
     }
 
@@ -529,6 +538,11 @@ export async function addApp(options = {}) {
       `i18n='${options.i18n}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${platform}).`,
     );
   }
+  if (options.observability && options.observability !== 'none' && platform !== 'vite') {
+    throw new Error(
+      `observability='${options.observability}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${platform}). --observability none 또는 --platform vite 사용.`,
+    );
+  }
 
   const appName = validateProjectName(
     options.name ?? await input({
@@ -583,6 +597,7 @@ export async function addApp(options = {}) {
       tauri: !!options.tauri,
       i18n: options.i18n ?? 'none',
       locales: options.locales ?? 'ko,en',
+      observability: options.observability ?? 'none',
     });
   } else {
     await generateApp(appsDir, appName, port, plugins, arch, css);
@@ -846,7 +861,7 @@ async function generateStandalone(targetDir, projectName, plugins, theme, css, a
   await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css, themeBase);
 }
 
-async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase, { tauri = false, i18n = 'none', locales = 'ko,en' } = {}) {
+async function generateViteStandalone(targetDir, projectName, theme, css, arch, themeBase, { tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateStandalone 과 같은 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'vite-standalone'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -892,6 +907,10 @@ async function generateViteStandalone(targetDir, projectName, theme, css, arch,
     const localesArr = parseLocales(locales);
     await emitI18n(targetDir, { arch, locales: localesArr });
   }
+
+  if (observability === 'sentry') {
+    await emitSentry(targetDir, { arch, i18nActive: i18n === 'react-i18next' });
+  }
 }
 
 /**
@@ -1127,7 +1146,183 @@ function parseLocales(input) {
   return cleaned.length > 0 ? cleaned : ['ko', 'en'];
 }
 
-async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', tauri = false, i18n = 'none', locales = 'ko,en' } = {}) {
+/**
+ * Sentry observability 셋업 emit (v0.93.0+). vite preset 전용 opt-in.
+ *
+ * - shared/observability/sentry.ts — Sentry.init (DSN 있을 때만)
+ * - shared/observability/index.ts  — Sentry + ErrorBoundary re-export
+ * - app/providers/SentryProvider.tsx — ErrorBoundary wrapper
+ * - GlobalProvider 재작성 — Sentry > [I18n?] > Theme > Query 순서
+ * - package.json — @sentry/react + @sentry/vite-plugin 추가
+ * - vite.config.ts — sentryVitePlugin 삽입 + sourcemap: true
+ * - .env.example — Sentry 변수 안내 블록 추가
+ *
+ * @param {string} targetDir — 앱 디렉토리
+ * @param {object} opts
+ * @param {object} opts.arch — arch descriptor
+ * @param {boolean} [opts.i18nActive] — i18n 도 같이 켜져 있는지 (GlobalProvider wrapping 순서)
+ */
+async function emitSentry(targetDir, { arch, i18nActive = false }) {
+  const isFsd = arch.name === 'fsd';
+  const obsDirRel = isFsd ? 'src/shared/observability' : 'src/lib/observability';
+  const obsAlias = isFsd ? '@/shared/observability' : '@/lib/observability';
+  const providersDirRel = isFsd ? 'src/app/providers' : 'src/components/providers';
+  const apiAlias = isFsd ? '@/shared/api/queryClient' : '@/lib/api/queryClient';
+
+  const obsDir = path.join(targetDir, obsDirRel);
+  await fs.ensureDir(obsDir);
+
+  const sentryTs = `/// <reference types="vite/client" />
+import * as Sentry from '@sentry/react';
+
+// VITE_SENTRY_DSN 이 있을 때만 init — 로컬 dev 에선 자동 skip.
+// GlitchTip self-hosted 도 같은 SDK — DSN 만 변경.
+if (import.meta.env.VITE_SENTRY_DSN) {
+  Sentry.init({
+    dsn: import.meta.env.VITE_SENTRY_DSN,
+    release: import.meta.env.VITE_APP_VERSION,
+    environment: import.meta.env.MODE,
+    tracesSampleRate: 0.1,
+    replaysOnErrorSampleRate: 1.0,
+    replaysSessionSampleRate: 0,
+    integrations: [
+      Sentry.browserTracingIntegration(),
+      Sentry.replayIntegration({ maskAllText: true, blockAllMedia: true }),
+    ],
+  });
+}
+
+export { Sentry };
+`;
+  await fs.writeFile(path.join(obsDir, 'sentry.ts'), sentryTs);
+
+  await fs.writeFile(
+    path.join(obsDir, 'index.ts'),
+    `export { Sentry } from './sentry';\nexport { ErrorBoundary } from '@sentry/react';\n`,
+  );
+
+  const providersDir = path.join(targetDir, providersDirRel);
+  await fs.ensureDir(providersDir);
+  const sentryProvider = `import { type ReactNode } from 'react';
+import { ErrorBoundary } from '${obsAlias}';
+
+function Fallback({ error }: { error: unknown }) {
+  return (
+    <div style={{ padding: '2rem', textAlign: 'center' }}>
+      <h1 style={{ fontSize: '1.5rem', fontWeight: 600 }}>오류가 발생했습니다</h1>
+      <p style={{ marginTop: '0.5rem', color: 'var(--foreground-muted)' }}>
+        {error instanceof Error ? error.message : '알 수 없는 오류'}
+      </p>
+    </div>
+  );
+}
+
+export function SentryProvider({ children }: { children: ReactNode }) {
+  return (
+    <ErrorBoundary fallback={({ error }) => <Fallback error={error} />}>
+      {children}
+    </ErrorBoundary>
+  );
+}
+`;
+  await fs.writeFile(path.join(providersDir, 'SentryProvider.tsx'), sentryProvider);
+
+  // GlobalProvider rewrite — Sentry outermost, then optional I18n, then Theme + Query.
+  const globalProviderPath = path.join(targetDir, providersDirRel, 'GlobalProvider', 'index.tsx');
+  const i18nImport = i18nActive ? `import { I18nProvider } from '../I18nProvider';\n` : '';
+  const innerOpen = i18nActive ? '      <I18nProvider>\n        ' : '      ';
+  const innerClose = i18nActive ? '\n      </I18nProvider>' : '';
+  const globalProvider = `import { QueryClientProvider } from '@tanstack/react-query';
+import { type ReactNode, useState } from 'react';
+import { createQueryClient } from '${apiAlias}';
+import { ThemeProvider } from '../theme/ThemeProvider';
+${i18nImport}import { SentryProvider } from '../SentryProvider';
+
+export function GlobalProvider({ children }: { children: ReactNode }) {
+  const [queryClient] = useState(() => createQueryClient());
+  return (
+    <SentryProvider>
+${innerOpen}<ThemeProvider>
+          <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+        </ThemeProvider>${innerClose}
+    </SentryProvider>
+  );
+}
+`;
+  await fs.writeFile(globalProviderPath, globalProvider);
+
+  // package.json deps
+  const pkgPath = path.join(targetDir, 'package.json');
+  const pkg = await fs.readJson(pkgPath);
+  pkg.dependencies = pkg.dependencies ?? {};
+  pkg.devDependencies = pkg.devDependencies ?? {};
+  pkg.dependencies['@sentry/react'] = '^8.45.0';
+  pkg.devDependencies['@sentry/vite-plugin'] = '^2.22.7';
+  pkg.dependencies = sortObjectKeys(pkg.dependencies);
+  pkg.devDependencies = sortObjectKeys(pkg.devDependencies);
+  await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+
+  await patchViteConfigForSentry(targetDir);
+
+  // .env.example
+  const envExamplePath = path.join(targetDir, '.env.example');
+  const envBlock = `# Sentry observability (v0.93.0+) — 비워두면 init 자동 skip.
+VITE_SENTRY_DSN=
+VITE_APP_VERSION=
+# Source map upload (vite build 시).
+SENTRY_AUTH_TOKEN=
+SENTRY_ORG=
+SENTRY_PROJECT=
+`;
+  if (await fs.pathExists(envExamplePath)) {
+    const existing = await fs.readFile(envExamplePath, 'utf-8');
+    if (!existing.includes('VITE_SENTRY_DSN')) {
+      await fs.writeFile(envExamplePath, existing + '\n' + envBlock);
+    }
+  } else {
+    await fs.writeFile(envExamplePath, envBlock);
+  }
+}
+
+async function patchViteConfigForSentry(targetDir) {
+  const viteCfgPath = path.join(targetDir, 'vite.config.ts');
+  if (!(await fs.pathExists(viteCfgPath))) {
+    throw new Error(`vite.config.ts 가 ${targetDir} 에 없습니다.`);
+  }
+  let cfg = await fs.readFile(viteCfgPath, 'utf-8');
+
+  if (!cfg.includes("@sentry/vite-plugin")) {
+    cfg = cfg.replace(
+      /import { defineConfig } from 'vite';/,
+      `import { defineConfig } from 'vite';\nimport { sentryVitePlugin } from '@sentry/vite-plugin';`,
+    );
+  }
+
+  if (!cfg.includes("sentryVitePlugin(")) {
+    cfg = cfg.replace(
+      /(plugins:\s*\[[^\]]*?)(\s*\])/s,
+      (_, before, close) => {
+        const sep = /,\s*$/.test(before) ? ' ' : ', ';
+        return `${before}${sep}sentryVitePlugin({\n      org: process.env.SENTRY_ORG,\n      project: process.env.SENTRY_PROJECT,\n      authToken: process.env.SENTRY_AUTH_TOKEN,\n      disable: !process.env.SENTRY_AUTH_TOKEN,\n    })${close}`;
+      },
+    );
+  }
+
+  if (!cfg.includes("sourcemap:")) {
+    if (cfg.includes("server: {")) {
+      cfg = cfg.replace(/(\n\s*server:\s*\{)/, `\n  build: { sourcemap: true },$1`);
+    } else if (cfg.includes("plugins: [")) {
+      cfg = cfg.replace(
+        /(plugins:\s*\[[^\]]*?\][^,\n]*[,;]?\n)/s,
+        `$1  build: { sourcemap: true },\n`,
+      );
+    }
+  }
+
+  await fs.writeFile(viteCfgPath, cfg);
+}
+
+async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
   await fs.copy(path.join(TEMPLATES_DIR, 'monorepo'), targetDir);
 
   // Update root package.json
@@ -1159,7 +1354,7 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
 
   const appsDir = path.join(targetDir, 'apps', appName);
   if (platform === 'vite') {
-    await generateViteApp(appsDir, appName, port, arch, css, { tauri, i18n, locales });
+    await generateViteApp(appsDir, appName, port, arch, css, { tauri, i18n, locales, observability });
   } else {
     await generateApp(appsDir, appName, port, plugins, arch, css);
   }
@@ -1260,7 +1455,7 @@ async function generateApp(targetDir, appName, port, plugins, arch, css = 'tailw
   }
 }
 
-async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind', { tauri = false, i18n = 'none', locales = 'ko,en' } = {}) {
+async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind', { tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none' } = {}) {
   // 베이스 (arch-neutral) + arch 오버레이 — generateApp 과 동일 패턴.
   await fs.copy(path.join(TEMPLATES_DIR, 'vite-app'), targetDir, {
     filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
@@ -1333,6 +1528,10 @@ async function generateViteApp(targetDir, appName, port, arch, css = 'tailwind',
     const localesArr = parseLocales(locales);
     await emitI18n(targetDir, { arch, locales: localesArr });
   }
+
+  if (observability === 'sentry') {
+    await emitSentry(targetDir, { arch, i18nActive: i18n === 'react-i18next' });
+  }
 }
 
 /**

package/src/create/index.mjs

@@ -17,8 +17,8 @@ const THEME_PRESETS_LIST = THEME_PRESET_NAMES.join('|');
 export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next.js / Flutter)
 
 사용법:
-  sh-ui create [name] [options]
-  sh-ui create add-app [name] [--port <n>] [--platform <next|vite>] [--plugins ..] [--theme ..] [--css ..] [--tauri] [--i18n <react-i18next|none>] [--locales ko,en]
+  sh-ui create [name] [options] [--observability <none|sentry>]
+  sh-ui create add-app [name] [--port <n>] [--platform <next|vite>] [--plugins ..] [--theme ..] [--css ..] [--tauri] [--i18n <react-i18next|none>] [--locales ko,en] [--observability <none|sentry>]
   sh-ui create add-component <name> [--app <name>]
 
 옵션:
@@ -30,6 +30,7 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
   --css <${CSS_FRAMEWORKS_SUPPORTED.join('|')}>                        CSS 프레임워크. base 파일까지 분기 emit (tailwind/plain/css-modules)
   --i18n <react-i18next|none>        vite 전용 — react-i18next 셋업 emit (i18n config + I18nProvider). 기본 none (v0.92.0+)
   --locales <ko,en>                  i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 'ko,en'
+  --observability <none|sentry>      vite 전용 — Sentry 셋업 emit (@sentry/react + vite-plugin + SentryProvider). 기본 none (v0.93.0+)
   --yes                              디렉토리 덮어쓰기 + 모노레포 기본값 자동 채택
   --dry-run                          파일을 쓰지 않고 작성될 파일 목록만 출력
   -h, --help                         이 도움말
@@ -79,6 +80,7 @@ export async function runCreate(rest) {
       tauri: flags.tauri,
       i18n: flags.i18n,
       locales: flags.locales,
+      observability: flags.observability,
     });
   } else if (command === 'add-component') {
     // 호환 별칭 — 신규 진입점은 `sh-ui add <name>` (bin/sh-ui.mjs 가 walk-up 으로 라우팅).
@@ -98,6 +100,7 @@ export async function runCreate(rest) {
       tauri: flags.tauri,
       i18n: flags.i18n,
       locales: flags.locales,
+      observability: flags.observability,
       yes: flags.yes,
       dryRun: flags.dryRun,
     });

package/src/mcp.mjs

@@ -48,6 +48,7 @@ import {
   CSS_FRAMEWORKS_SUPPORTED,
   I18N_LIBRARIES,
   I18N_DEFAULT_LOCALES,
+  OBSERVABILITY_PROVIDERS,
 } from "./constants.js";
 import { allPlugins } from "./create/plugins/index.js";
 import { allArchitectures } from "./create/architectures/index.js";
@@ -414,6 +415,11 @@ export async function startMcpServer() {
             `i18n 활성화 시 생성할 locale 코드 (comma-separated, 2글자 또는 'ko-KR' 류). 기본 '${I18N_DEFAULT_LOCALES}'. 첫 locale 이 fallbackLng. ` +
             "i18n='none' 이면 무시.",
           ),
+        observability: z.enum(OBSERVABILITY_PROVIDERS).optional()
+          .describe(
+            "observability provider — platform=vite 일 때만 의미. 'sentry' 로 설정 시 @sentry/react + " +
+            "@sentry/vite-plugin 셋업 + SentryProvider + .env.example 자동 emit. GlitchTip self-hosted 도 같은 SDK — DSN 만 변경. 기본 'none'.",
+          ),
       },
     },
     async (input) => {
@@ -453,6 +459,15 @@ export async function startMcpServer() {
           }],
         };
       }
+      if (input.observability && input.observability !== "none" && input.platform !== "vite") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: `observability='${input.observability}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${input.platform}).`,
+          }],
+        };
+      }
       const targetParent = resolveCwd(input);
       const targetDir = resolve(targetParent, input.name);
       if (existsSync(targetDir) && !input.force) {
@@ -481,6 +496,7 @@ export async function startMcpServer() {
             tauri: input.tauri,
             i18n: input.i18n,
             locales: input.locales,
+            observability: input.observability,
             yes: true, // 사전 검사를 마쳤으니 generator 의 confirm 프롬프트 우회
           }),
         );
@@ -524,6 +540,11 @@ export async function startMcpServer() {
           .describe(
             `i18n 활성화 시 생성할 locale 코드 (comma-separated). 기본 '${I18N_DEFAULT_LOCALES}'. 첫 locale 이 fallbackLng. i18n='none' 이면 무시.`,
           ),
+        observability: z.enum(OBSERVABILITY_PROVIDERS).optional()
+          .describe(
+            "observability provider — platform=vite 일 때만 의미. 'sentry' 로 설정 시 @sentry/react + " +
+            "@sentry/vite-plugin 셋업 + SentryProvider + .env.example 자동 emit. GlitchTip self-hosted 도 같은 SDK — DSN 만 변경. 기본 'none'.",
+          ),
         cwd: z.string().optional()
           .describe("모노레포 루트 (pnpm-workspace.yaml 있는 곳). 기본 process.cwd()"),
       },
@@ -552,6 +573,15 @@ export async function startMcpServer() {
           }],
         };
       }
+      if (input.observability && input.observability !== "none" && input.platform && input.platform !== "vite") {
+        return {
+          isError: true,
+          content: [{
+            type: "text",
+            text: `observability='${input.observability}' 은 platform=vite 일 때만 지원합니다 (현재 platform=${input.platform}).`,
+          }],
+        };
+      }
       const text = await captureConsole(() =>
         addApp({
           name: input.name,
@@ -563,6 +593,7 @@ export async function startMcpServer() {
           tauri: input.tauri,
           i18n: input.i18n,
           locales: input.locales,
+          observability: input.observability,
           cwd: resolveCwd(input),
         }),
       );