sh-ui-cli 0.94.0 → 0.96.0

package/data/changelog/versions.json

@@ -2,6 +2,31 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.96.0",
+      "date": "2026-05-15",
+      "title": "vite 스캐폴드 P0 fix — i18n + sentry plugins 패치 충돌 + create_project appName 인자",
+      "type": "minor",
+      "highlights": [
+        "**P0 — vite.config.ts plugins 배열 패치 anchor 경합 fix** — `--i18n react-i18next` 와 `--observability sentry` 를 동시에 켜면 sentry plugin 호출이 viteStaticCopy 의 `targets: [...]` 배열 안에 inject 되던 회귀 (피드백 #3). 두 patch 가 같은 정규식 anchor 를 두고 경합한 결과. balanced-bracket walker + top-level entry splitter 로 통합 (`appendVitePluginEntry` helper) — 두 옵션 모두 plugins 의 top-level entry 로 안전하게 append. all-options 동시 ON smoke 회귀 가드 추가.",
+        "**`sh_ui_create_project` 의 `appName` 인자** — monorepo 첫 앱 이름을 호출 시점에 지정. describe_template 의 동일 인자와 1:1 시그니처 일치. 기존엔 'web' 고정이라 사용자가 12+ 파일을 손 rename 해야 했음. CLI `--app` 플래그도 같이 노출. 미지정 시 기본 'web' (호환 유지).",
+        "**i18n 켜면 Home.tsx / App.tsx 자동 patch** — `useTranslation` import + `{t('greeting')}` 사용으로 변환. locale 시드 (ko='안녕하세요', en='Hello') 덕분에 첫 화면이 사용자 언어로 즉시 표시 — i18n 셋업 동작을 한눈에 확인 (피드백 #2/#3). fsd/flat × standalone/monorepo 4 조합 모두 처리.",
+        "**`sh_ui_describe_template` file plan 에 `.gitignore` mock-rename** — finalizeProject 가 fs 단계에서 `gitignore` → `.gitignore` 로 바꾸지만, describe_template 출력엔 그 변환이 반영 안 돼 점 없는 raw 파일명이 노출되던 buglet (피드백 #3) 수정. file plan ↔ 실제 emit 1:1 정합성 유지."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.96.0"
+    },
+    {
+      "version": "0.95.0",
+      "date": "2026-05-15",
+      "title": "MCP describe_template 옵션 누락 fix + staleness 경고 — 외부 AI 가 stale MCP 알아채게",
+      "type": "minor",
+      "highlights": [
+        "**`sh_ui_describe_template` 가 tauri/i18n/locales/observability 받음** — describeTemplate 자체는 옵션을 처리하지만 MCP 핸들러의 inputSchema 에 누락되어 외부 AI 가 옵션을 명시해도 무시됐다. preview 가 항상 기본 파일만 나열되던 회귀 (#3) 해결. create_project ↔ describe_template 파일 plan 1:1 일치 보장.",
+        "**MCP staleness 경고 자동 prepend** — 서버 start 시 https://registry.npmjs.org/sh-ui-cli/latest 비동기 조회 (3s timeout). 현재 버전보다 latest 가 높으면 모든 tool 응답 상단에 `⚠ sh-ui MCP X.Y.Z (latest: …)` 한 줄 prepend. 외부 AI 가 stale MCP 를 정상 출력으로 오해하던 회귀 (#8) 차단. 오프라인 / DNS 실패는 조용히 skip — best-effort.",
+        "**`SH_UI_SKIP_STALENESS_CHECK=1` 옵트아웃** — CI / 오프라인 / 사용자가 경고 끄고 싶을 때 env var 한 줄. test runner 가 외부 fetch 없이 결정적으로 돌게 함."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.95.0"
+    },
     {
       "version": "0.94.0",
       "date": "2026-05-15",

package/package.json

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

package/src/create/describeTemplate.js

@@ -400,9 +400,10 @@ function finalize(groups) {
   for (let i = groups.length - 1; i >= 0; i--) {
     const kept = [];
     for (const p of groups[i].paths) {
-      if (!seen.has(p)) {
-        seen.add(p);
-        kept.push(p);
+      const finalPath = applyFinalizeRenames(p);
+      if (!seen.has(finalPath)) {
+        seen.add(finalPath);
+        kept.push(finalPath);
       }
     }
     groups[i] = {
@@ -417,3 +418,23 @@ function finalize(groups) {
   files.sort();
   return { files, groups: cleaned };
 }
+
+/**
+ * generator.js 의 `finalizeProject` 가 실제 fs 단계에서 적용하는 rename 을
+ * file plan 텍스트 레벨에서 mock-apply (v0.96.0+ — 피드백 #3 buglet).
+ *
+ * 현재 규칙:
+ *  - basename 이 정확히 'gitignore' 인 경로 → '.gitignore' 로 prefix dot 추가.
+ *    (npm publish 가 .gitignore 를 strip 하므로 템플릿엔 점 없이 두고 emit 후 dot-prefix.)
+ *  - 이미 '.gitignore' 인 경로 (예: tauri-shell 의 src-tauri/.gitignore) 는 그대로.
+ *
+ * 미래에 다른 fs-level rename 이 추가되면 여기에 같이 등록 (describeTemplate 의
+ * file-plan ↔ create_project 의 실제 emit 1:1 정합성 유지).
+ */
+function applyFinalizeRenames(p) {
+  const slash = p.lastIndexOf('/');
+  const dir = slash === -1 ? '' : p.slice(0, slash + 1);
+  const base = slash === -1 ? p : p.slice(slash + 1);
+  if (base === 'gitignore') return dir + '.gitignore';
+  return p;
+}

package/src/create/generator.js

@@ -372,6 +372,8 @@ export async function createProject(options = {}) {
         i18n: options.i18n ?? 'none',
         locales: options.locales ?? 'ko,en',
         observability: options.observability ?? 'none',
+        appName: options.appName ?? null,
+        port: options.port ?? null,
       });
     }
 
@@ -422,7 +424,11 @@ export async function createProject(options = {}) {
   if (projectType === 'standalone') {
     await generateStandalone(targetDir, projectName, plugins, theme, cssFramework, arch, themeBase);
   } else {
-    await generateMonorepo(targetDir, projectName, plugins, { yes: options.yes, theme, css: cssFramework, arch, themeBase });
+    await generateMonorepo(targetDir, projectName, plugins, {
+      yes: options.yes, theme, css: cssFramework, arch, themeBase,
+      appName: options.appName ?? null,
+      port: options.port ?? null,
+    });
   }
 
   await finalizeProject(targetDir, { dryRun: options.dryRun });
@@ -1144,6 +1150,162 @@ export function GlobalProvider({ children }: { children: ReactNode }) {
 
   // vite.config.ts 에 vite-plugin-static-copy 삽입.
   await patchViteConfigForI18n(targetDir, { i18nDirRel });
+
+  // 랜딩 컴포넌트 (Home.tsx 또는 fsd 의 src/app/App.tsx) 가 i18n 을 즉시 사용하도록 패치.
+  // v0.94 에서 ko 시드가 '안녕하세요' 로 들어가니 첫 화면이 한국어로 떠 사용자가 i18n 동작을 즉시 인지 (피드백 #2/#3).
+  await patchLandingForI18n(targetDir, { arch });
+}
+
+/**
+ * i18n 활성화 시 첫 화면을 `useTranslation` 으로 바꾸어 'greeting' 키를 사용한다.
+ * 이 patch 가 없으면 사용자가 i18n 셋업이 동작하는지 즉시 확인할 길이 없음.
+ *
+ * 대상 파일 (존재하는 첫 번째):
+ *   - fsd + vite-standalone: src/app/App.tsx  (inline `<h1>Hello World</h1>`)
+ *   - fsd + vite-app(monorepo): src/Home.tsx  (App.tsx 가 <Home /> import)
+ *   - flat: src/Home.tsx
+ *
+ * 이미 useTranslation 을 쓰고 있으면 no-op (재진입 안전).
+ * 형태가 예상과 다르면 silent skip — 사용자 코드를 깨뜨리지 않는 게 우선.
+ */
+async function patchLandingForI18n(targetDir, { arch }) {
+  const candidates =
+    arch.name === 'fsd'
+      ? [
+          path.join(targetDir, 'src/Home.tsx'),       // vite-app monorepo
+          path.join(targetDir, 'src/app/App.tsx'),    // vite-standalone fsd
+        ]
+      : [
+          path.join(targetDir, 'src/Home.tsx'),       // flat (vite-app + vite-standalone 공통)
+        ];
+
+  for (const filePath of candidates) {
+    if (!(await fs.pathExists(filePath))) continue;
+    let src = await fs.readFile(filePath, 'utf-8');
+    if (src.includes('useTranslation')) continue; // 이미 적용됨
+
+    // 형태가 예상과 다르면 (Hello World 가 없으면) skip.
+    if (!src.includes('Hello World')) continue;
+
+    // 1) import { useTranslation } from 'react-i18next' 를 import 블록 뒤에 (없으면 파일 맨 앞에) 추가.
+    const i18nImport = `import { useTranslation } from 'react-i18next';\n`;
+    const lastImportIdx = src.lastIndexOf('import ');
+    if (lastImportIdx >= 0) {
+      const importLineEnd = src.indexOf('\n', lastImportIdx) + 1;
+      src = src.slice(0, importLineEnd) + i18nImport + src.slice(importLineEnd);
+    } else {
+      // import 없는 파일 (flat Home.tsx) — 파일 맨 앞에 import + 빈 줄.
+      src = i18nImport + '\n' + src;
+    }
+
+    // 2) 컴포넌트 함수 본문 첫 줄에 `const { t } = useTranslation();` 추가.
+    //    export default function ... () {  또는  export default function ... () {\n...return (
+    //    형태를 가정. 매치 실패 시 silent skip.
+    const fnMatch = src.match(/export default function \w+\s*\([^)]*\)\s*\{\n/);
+    if (!fnMatch) continue;
+    const insertAt = fnMatch.index + fnMatch[0].length;
+    src = src.slice(0, insertAt) + `  const { t } = useTranslation();\n` + src.slice(insertAt);
+
+    // 3) Hello World 텍스트를 {t('greeting')} 으로 치환.
+    src = src.replace(/Hello World/g, "{t('greeting')}");
+
+    await fs.writeFile(filePath, src);
+  }
+}
+
+/**
+ * vite.config.ts 의 `plugins: [ ... ]` 배열에서 top-level entry 들을 분리해
+ * 새 entry 를 append 한 뒤 canonical 멀티라인 형태로 재방출한다.
+ *
+ * - balanced bracket 으로 outer `]` 를 찾으므로 `viteStaticCopy({ targets: [...] })`
+ *   처럼 안쪽에 `[]` 가 있어도 안전.
+ * - 두 개 이상의 patch (i18n + sentry 등) 가 같은 vite.config.ts 를 순차로
+ *   건드릴 때 anchor 경합으로 entry 가 안쪽 배열에 inject 되던 v0.92~0.95 회귀의 원인을 제거.
+ *
+ * 입력 src 가 예상 형태가 아니면 (`plugins: [` 못 찾음 / unbalanced bracket)
+ * `null` 을 반환 → 호출부에서 patch 포기.
+ *
+ * @param {string} src — vite.config.ts 전체 소스
+ * @param {string} callSource — 추가할 plugin 호출 소스 (예: "viteStaticCopy({ ... })"). 선행 indent / 후행 comma 없이 entry 본문만.
+ * @returns {string | null}
+ */
+function appendVitePluginEntry(src, callSource) {
+  const openMatch = src.match(/plugins:\s*\[/);
+  if (!openMatch) return null;
+
+  // plugins: 라인의 들여쓰기 추출 → 안쪽 entry 는 한 단계(=2 space) 더 깊게.
+  const pluginsLineStart = src.lastIndexOf('\n', openMatch.index) + 1;
+  const pluginsIndent = src.slice(pluginsLineStart, openMatch.index).match(/^[ \t]*/)[0];
+  const entryIndent = pluginsIndent + '  ';
+
+  const arrStart = openMatch.index + openMatch[0].length; // `[` 직후
+  // balanced bracket walk — `]` 깊이 0 지점이 outer 닫는 `]`.
+  let depth = 1;
+  let i = arrStart;
+  let inStr = null;
+  while (i < src.length && depth > 0) {
+    const ch = src[i];
+    if (inStr) {
+      if (ch === '\\' && i + 1 < src.length) { i += 2; continue; }
+      if (ch === inStr) inStr = null;
+      i++;
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === '`') { inStr = ch; i++; continue; }
+    if (ch === '[' || ch === '(' || ch === '{') depth++;
+    else if (ch === ']' || ch === ')' || ch === '}') depth--;
+    if (depth === 0) break;
+    i++;
+  }
+  if (depth !== 0) return null;
+  const arrEnd = i; // outer `]` 의 인덱스
+
+  const inner = src.slice(arrStart, arrEnd);
+  const entries = splitTopLevelPluginEntries(inner);
+  entries.push(callSource);
+
+  const rebuilt =
+    '\n' +
+    entries.map((e) => entryIndent + e).join(',\n') +
+    ',\n' +
+    pluginsIndent;
+  return src.slice(0, arrStart) + rebuilt + src.slice(arrEnd);
+}
+
+/**
+ * plugins 배열 내부 문자열을 top-level `,` 기준으로 split.
+ * `()` `[]` `{}` 와 문자열 리터럴 ('`, ', ") 안의 `,` 는 무시.
+ *
+ * @param {string} s
+ * @returns {string[]}
+ */
+function splitTopLevelPluginEntries(s) {
+  const entries = [];
+  let depth = 0;
+  let inStr = null;
+  let buf = '';
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i];
+    if (inStr) {
+      buf += ch;
+      if (ch === '\\' && i + 1 < s.length) { buf += s[i + 1]; i++; continue; }
+      if (ch === inStr) inStr = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === '`') { inStr = ch; buf += ch; continue; }
+    if (ch === '(' || ch === '[' || ch === '{') { depth++; buf += ch; continue; }
+    if (ch === ')' || ch === ']' || ch === '}') { depth--; buf += ch; continue; }
+    if (ch === ',' && depth === 0) {
+      const t = buf.trim();
+      if (t) entries.push(t);
+      buf = '';
+      continue;
+    }
+    buf += ch;
+  }
+  const t = buf.trim();
+  if (t) entries.push(t);
+  return entries;
 }
 
 /**
@@ -1167,22 +1329,17 @@ async function patchViteConfigForI18n(targetDir, { i18nDirRel }) {
   const insertImportAt = src.indexOf('\n', lastImportIdx) + 1;
   src = src.slice(0, insertImportAt) + importLine + '\n' + src.slice(insertImportAt);
 
-  const pluginCall = `    viteStaticCopy({
+  // entry 본문만 넘기고 indent / 후행 comma 는 helper 가 붙인다.
+  const pluginCall = `viteStaticCopy({
       // i18n locale 파일을 public/locales 로 미러 — i18next-http-backend 의 loadPath 와 매칭.
       targets: [
         { src: '${i18nDirRel}/locales/*', dest: 'locales' },
       ],
-    }),`;
+    })`;
 
-  // plugins: [ ... ] 의 시작 직후에 새 plugin 삽입.
-  const pluginsMatch = src.match(/plugins:\s*\[/);
-  if (pluginsMatch) {
-    const insertAt = pluginsMatch.index + pluginsMatch[0].length;
-    src = src.slice(0, insertAt) + '\n' + pluginCall + src.slice(insertAt);
-  } else {
-    // 형태가 예상과 다르면 패치 포기 — config 가 깨지지 않도록.
-    return;
-  }
+  const patched = appendVitePluginEntry(src, pluginCall);
+  if (!patched) return; // 형태가 예상과 다르면 patch 포기 — config 가 깨지지 않도록.
+  src = patched;
 
   await fs.writeFile(viteConfigPath, src);
 }
@@ -1353,30 +1510,29 @@ async function patchViteConfigForSentry(targetDir) {
   }
 
   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}`;
-      },
-    );
+    // i18n 의 viteStaticCopy 처럼 plugins 배열 안에 nested `[]` 가 있을 수 있으므로
+    // balanced-bracket helper 로 outer entry append.
+    const sentryCall = `sentryVitePlugin({
+      org: process.env.SENTRY_ORG,
+      project: process.env.SENTRY_PROJECT,
+      authToken: process.env.SENTRY_AUTH_TOKEN,
+      disable: !process.env.SENTRY_AUTH_TOKEN,
+    })`;
+    const patched = appendVitePluginEntry(cfg, sentryCall);
+    if (patched) cfg = patched;
   }
 
   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`,
-      );
     }
+    // server 가 없는 변종은 build 삽입 위치가 모호 → 보수적으로 skip (사용자가 수동 추가).
   }
 
   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' } = {}) {
+async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch, themeBase, platform = 'next', tauri = false, i18n = 'none', locales = 'ko,en', observability = 'none', appName: appNameOpt = null, port: portOpt = null } = {}) {
   await fs.copy(path.join(TEMPLATES_DIR, 'monorepo'), targetDir);
 
   // Update root package.json
@@ -1400,16 +1556,19 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
   }
   await fs.writeJson(turboPath, turbo, { spaces: 2 });
 
-  // Create first app
-  const appName = yes ? 'web' : await input({
-    message: '첫 번째 앱 이름:',
-    default: 'web',
-  });
+  // Create first app — `appName` 인자가 주어지면 그대로, 아니면 yes 모드 default 'web' / 대화모드 prompt.
+  // v0.96.0+ — describe_template 와 동일한 시그니처 (피드백 #3 의 API 일관성 항목).
+  const appName = appNameOpt
+    ? validateProjectName(appNameOpt, 'appName')
+    : (yes ? 'web' : await input({
+        message: '첫 번째 앱 이름:',
+        default: 'web',
+      }));
 
-  const port = yes ? '3000' : await input({
+  const port = portOpt ?? (yes ? '3000' : await input({
     message: '포트 번호:',
     default: '3000',
-  });
+  }));
 
   const appsDir = path.join(targetDir, 'apps', appName);
   if (platform === 'vite') {

package/src/create/index.mjs

@@ -101,6 +101,10 @@ export async function runCreate(rest) {
       i18n: flags.i18n,
       locales: flags.locales,
       observability: flags.observability,
+      // create 컨텍스트에서는 --app 이 첫 앱 이름 (monorepo). 같은 플래그가
+      // add-component 컨텍스트에서는 대상 앱 선택 — 의미가 컨텍스트마다 다름.
+      appName: flags.app,
+      port: flags.port,
       yes: flags.yes,
       dryRun: flags.dryRun,
     });

package/src/mcp.mjs

@@ -113,11 +113,66 @@ async function captureConsole(fn) {
 }
 
 function textResult(text) {
-  return { content: [{ type: "text", text }] };
+  return { content: withStaleness([{ type: "text", text }]) };
 }
 
 function jsonResult(data) {
-  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  return { content: withStaleness([{ type: "text", text: JSON.stringify(data, null, 2) }]) };
+}
+
+/**
+ * Staleness 경고 — npm registry 에서 latest sh-ui-cli 버전을 조회해 현재와 다르면
+ * 모든 tool 응답 상단에 한 줄 경고 prepend (v0.95.0+).
+ *
+ * 왜 필요: npx 가 sh-ui-cli 를 한 번 fetch 한 뒤 ~/.npm/_npx 캐시에 박아두면, 사용자
+ * `~/.claude.json` 에 `sh-ui-cli` (버전 비고정) 로 등록해도 MCP 가 오래된 버전으로
+ * 계속 실행된다. AI 에이전트는 "응답이 정상 응답" 으로 받아들이므로 stale 임을 의심
+ * 못 함 — 사용자 (ai-org 케이스) 가 직접 발견할 때까지 잘못된 plan 으로 작업.
+ *
+ * 모듈 변수 — startMcpServer 가 fire-and-forget 으로 채움. 첫 응답 직전에 미완료
+ * 면 경고 없이 진행 (best-effort).
+ */
+let STALE_WARNING = "";
+
+function withStaleness(content) {
+  if (!STALE_WARNING) return content;
+  return [{ type: "text", text: STALE_WARNING }, ...content];
+}
+
+/**
+ * 비동기로 npm registry 조회 → 더 높은 버전이 있으면 STALE_WARNING 셋업.
+ * 3초 timeout · 모든 실패 (오프라인 / DNS / 차단) 는 조용히 무시.
+ */
+async function checkStaleness(currentVersion, cliName) {
+  try {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 3000);
+    const res = await fetch(`https://registry.npmjs.org/${cliName}/latest`, {
+      signal: ctrl.signal,
+    });
+    clearTimeout(timer);
+    if (!res.ok) return;
+    const data = await res.json();
+    const latest = typeof data.version === "string" ? data.version : null;
+    if (!latest || latest === currentVersion) return;
+    if (!isSemverGreater(latest, currentVersion)) return;
+    STALE_WARNING =
+      `⚠ sh-ui MCP ${currentVersion} (latest: ${latest}) — stale. ` +
+      `최신 옵션·버그픽스를 받으려면: \n` +
+      `  • ~/.claude.json (또는 다른 MCP 설정) 의 args 를 ["sh-ui-cli@latest", "mcp"] 로 변경 후 재시작\n` +
+      `  • npx 캐시가 박혀 있으면 \`npx clear-npx-cache\` 한 번 실행`;
+  } catch {
+    // best-effort.
+  }
+}
+
+function isSemverGreater(a, b) {
+  const parse = (s) => s.split("-")[0].split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const [aMaj, aMin, aPatch] = parse(a);
+  const [bMaj, bMin, bPatch] = parse(b);
+  if (aMaj !== bMaj) return aMaj > bMaj;
+  if (aMin !== bMin) return aMin > bMin;
+  return aPatch > bPatch;
 }
 
 async function loadRegistry(platform) {
@@ -346,6 +401,13 @@ return (
 
 export async function startMcpServer() {
   const { version, name: cliName } = await readPackageMeta();
+
+  // fire-and-forget — server 가 첫 tool 요청 받기 전에 끝나면 경고 prepend, 아니면 다음 요청부터.
+  // env SH_UI_SKIP_STALENESS_CHECK=1 로 disable 가능 (CI / 오프라인 환경).
+  if (!process.env.SH_UI_SKIP_STALENESS_CHECK) {
+    void checkStaleness(version, cliName);
+  }
+
   const server = new McpServer(
     { name: "sh-ui", version },
     {
@@ -421,6 +483,15 @@ export async function startMcpServer() {
             "observability provider — platform=vite 일 때만 의미. 'sentry' 로 설정 시 @sentry/react + " +
             "@sentry/vite-plugin 셋업 + SentryProvider + .env.example 자동 emit. GlitchTip self-hosted 도 같은 SDK — DSN 만 변경. 기본 'none'.",
           ),
+        // monorepo 첫 앱 이름 — describe_template 와 시그니처 1:1 일치 (v0.96.0+).
+        // standalone 일 땐 무시 (프로젝트 루트가 곧 앱). 미지정 시 'web'.
+        appName: z.string().min(1).optional()
+          .describe(
+            "monorepo 첫 앱 이름. structure=monorepo 일 때만 의미 — apps/{appName}/ + packages/ui/ui-apps/ui-{appName}/ 동시 생성. " +
+            "기본 'web'. describe_template 의 동일 인자와 1:1 대응 (v0.96.0+).",
+          ),
+        port: z.string().optional()
+          .describe("monorepo 첫 앱의 dev 포트. 기본 '3000'. structure=monorepo 일 때만 의미."),
       },
     },
     async (input) => {
@@ -498,6 +569,8 @@ export async function startMcpServer() {
             i18n: input.i18n,
             locales: input.locales,
             observability: input.observability,
+            appName: input.appName,
+            port: input.port,
             yes: true, // 사전 검사를 마쳤으니 generator 의 confirm 프롬프트 우회
           }),
         );
@@ -942,6 +1015,16 @@ export async function startMcpServer() {
           .describe("CSS 프레임워크. 기본 plain. css-modules 면 page.module.css 등 추가"),
         appName: z.string().optional()
           .describe("monorepo 첫 앱 이름. 기본 web"),
+        // vite 전용 — sh_ui_create_project 의 동일 옵션과 1:1 대응. describe ↔ create 가 같은
+        // file-plan 을 보장하려면 여기서 받아 describeTemplate 에 전달해야 한다 (v0.95.0+).
+        tauri: z.boolean().optional()
+          .describe("Tauri 2.x 데스크탑 셸 emit (platform=vite 전용). 기본 false"),
+        i18n: z.enum(I18N_LIBRARIES).optional()
+          .describe(`i18n 라이브러리 (platform=vite 전용). 옵션: ${I18N_LIBRARIES.join(', ')}. 기본 none`),
+        locales: z.string().optional()
+          .describe(`i18n 활성화 시 locale 코드 (comma-separated, 예: "ko,en"). 기본 "${I18N_DEFAULT_LOCALES}"`),
+        observability: z.enum(OBSERVABILITY_PROVIDERS).optional()
+          .describe(`observability 백엔드 (platform=vite 전용). 옵션: ${OBSERVABILITY_PROVIDERS.join(', ')}. 기본 none`),
       },
     },
     async (input) => {
@@ -953,6 +1036,10 @@ export async function startMcpServer() {
           plugins: input.plugins,
           cssFramework: input.cssFramework,
           appName: input.appName,
+          tauri: input.tauri,
+          i18n: input.i18n,
+          locales: input.locales,
+          observability: input.observability,
         });
         return jsonResult(result);
       } catch (e) {