sh-ui-cli 0.115.0 → 0.117.0

package/data/registry/react/components/tree/types.ts

@@ -0,0 +1,36 @@
+import type * as React from "react";
+
+export interface TreeNode {
+  id: string;
+  label: React.ReactNode;
+  children?: TreeNode[];
+  icon?: React.ReactNode;
+  disabled?: boolean;
+}
+
+export type TreeSize = "sm" | "md";
+
+export interface TreeProps {
+  nodes: TreeNode[];
+  expandedIds?: string[];
+  defaultExpandedIds?: string[];
+  onExpandedChange?: (ids: string[]) => void;
+  selectedId?: string | null;
+  defaultSelectedId?: string | null;
+  onSelect?: (id: string | null) => void;
+  renderLabel?: (node: TreeNode) => React.ReactNode;
+  size?: TreeSize;
+  className?: string;
+}
+
+export interface VisibleNode {
+  id: string;
+  node: TreeNode;
+  level: number;
+  parentId: string | null;
+  hasChildren: boolean;
+  expanded: boolean;
+  disabled: boolean;
+  setSize: number;
+  posInSet: number;
+}

package/data/registry/react/peer-versions.json

@@ -3,12 +3,20 @@
   "versions": {
     "@base-ui/react": "^1.4.1",
     "@tanstack/react-form": "^1.29.1",
+    "@tiptap/core": "^3.26.0",
+    "@tiptap/extension-link": "^3.26.0",
+    "@tiptap/extension-placeholder": "^3.26.0",
+    "@tiptap/extension-text-style": "^3.26.0",
+    "@tiptap/pm": "^3.26.0",
+    "@tiptap/react": "^3.26.0",
+    "@tiptap/starter-kit": "^3.26.0",
     "@vanilla-extract/css": "^1.16.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^1.11.0",
     "react-hook-form": "^7.74.0",
     "shiki": "^4.0.2",
-    "tailwind-merge": "^3.5.0"
+    "tailwind-merge": "^3.5.0",
+    "tiptap-markdown": "^0.9.0"
   }
 }

package/data/registry/react/registry.json

@@ -504,10 +504,12 @@
       "dependencies": [
         "@tiptap/react",
         "@tiptap/pm",
+        "@tiptap/core",
         "@tiptap/starter-kit",
         "@tiptap/extension-placeholder",
         "@tiptap/extension-link",
         "@tiptap/extension-text-style",
+        "tiptap-markdown",
         "lucide-react"
       ],
       "registryDependencies": ["utils"]
@@ -1659,6 +1661,49 @@
       "dependencies": ["@base-ui/react"],
       "registryDependencies": ["utils"]
     },
+    "tree": {
+      "name": "tree",
+      "type": "component",
+      "files": [
+        {
+          "src": "components/tree/index.tsx",
+          "dest": "{components}/tree/index.tsx",
+          "frameworks": ["plain"]
+        },
+        {
+          "src": "components/tree/types.ts",
+          "dest": "{components}/tree/types.ts",
+          "frameworks": ["plain", "tailwind", "css-modules"]
+        },
+        {
+          "src": "components/tree/flatten.ts",
+          "dest": "{components}/tree/flatten.ts",
+          "frameworks": ["plain", "tailwind", "css-modules"]
+        },
+        {
+          "src": "components/tree/styles.css",
+          "dest": "{components}/tree/styles.css",
+          "frameworks": ["plain"]
+        },
+        {
+          "src": "components/tree/index.tailwind.tsx",
+          "dest": "{components}/tree/index.tsx",
+          "frameworks": ["tailwind"]
+        },
+        {
+          "src": "components/tree/index.module.tsx",
+          "dest": "{components}/tree/index.tsx",
+          "frameworks": ["css-modules"]
+        },
+        {
+          "src": "components/tree/styles.module.css",
+          "dest": "{components}/tree/styles.module.css",
+          "frameworks": ["css-modules"]
+        }
+      ],
+      "dependencies": [],
+      "registryDependencies": ["utils"]
+    },
     "carousel": {
       "name": "carousel",
       "type": "component",

package/data/registry/react/tokens-used.json

@@ -1,6 +1,6 @@
 {
   "$description": "컴포넌트별 토큰 의존성 (var(--*) 추출). build-registry-tokens.mjs 가 자동 생성.",
-  "$generated": "2026-06-01T06:54:04.570Z",
+  "$generated": "2026-06-18T06:02:23.309Z",
   "components": {
     "button": {
       "plain": [
@@ -1931,6 +1931,45 @@
       ],
       "vanilla-extract": []
     },
+    "tree": {
+      "plain": [
+        "--background-muted",
+        "--border-width-strong",
+        "--duration-fast",
+        "--ease-standard",
+        "--foreground",
+        "--foreground-muted",
+        "--radius",
+        "--ring",
+        "--space-2",
+        "--space-4",
+        "--text-xs",
+        "--weight-medium"
+      ],
+      "tailwind": [
+        "--border-width-strong",
+        "--duration-fast",
+        "--radius",
+        "--space-2",
+        "--space-4",
+        "--text-xs"
+      ],
+      "css-modules": [
+        "--background-muted",
+        "--border-width-strong",
+        "--duration-fast",
+        "--ease-standard",
+        "--foreground",
+        "--foreground-muted",
+        "--radius",
+        "--ring",
+        "--space-2",
+        "--space-4",
+        "--text-xs",
+        "--weight-medium"
+      ],
+      "vanilla-extract": []
+    },
     "carousel": {
       "plain": [
         "--background",

package/data/summaries/react.json

@@ -42,7 +42,7 @@
     "page-toc": "페이지 자동 목차 — 헤딩 스캔 · slugify · IntersectionObserver active 추적 · smooth scroll. routeKey 로 라우트 변경 자동 재스캔, levels/excludeSelector 커스터마이즈.",
     "code-editor": "CodeMirror 6 기반 코드 에디터 — js/ts/jsx/tsx/json/css/html/markdown, sh-ui 토큰 테마, readOnly·placeholder·minHeight/maxHeight. controlled(value/onChange) · uncontrolled(defaultValue) 모두 지원.",
     "markdown-editor": "마크다운 에디터 — CodeEditor + react-markdown 라이브 프리뷰 합성, GFM 지원, raw HTML 차단으로 XSS 방어. controlled(value/onChange) · uncontrolled(defaultValue) 모두 지원.",
-    "rich-text-editor": "Tiptap 3 기반 WYSIWYG 에디터 — HTML 입출력, 기본 toolbar(헤딩·리스트·인용·코드·링크·강조), readOnly·placeholder. controlled(value/onChange) · uncontrolled(defaultValue) 모두 지원.",
+    "rich-text-editor": "Tiptap 3 기반 WYSIWYG 에디터 — format='html'(기본) 또는 format='markdown'(tiptap-markdown 직렬화) I/O, 기본 toolbar(헤딩·리스트·인용·코드·링크·강조), readOnly·placeholder. submitOnEnter+onSubmit(Enter 전송·Shift+Enter 줄바꿈), extensions(추가 확장 주입)·onCreate(에디터 인스턴스 접근). controlled(value/onChange) · uncontrolled(defaultValue) 모두 지원.",
     "base": "CSS 리셋 — base.css.",
     "breakpoints": "반응형 미디어 쿼리 토큰 — breakpoints.css.",
     "focus-ring": "공용 포커스 링 스타일 — focus-ring.css.",
@@ -57,6 +57,7 @@
     "form-tanstack": "TanStack Form 인스턴스 → sh-ui FormStore 어댑터. `adaptTanstackForm(tanstackInstance, config)` — TanStack Form 이 state owner. @tanstack/react-form 은 peerDependency.",
     "calendar": "내부 캘린더 위젯 (DatePicker 가 사용). single / multiple / range 모드. CalendarMessages 로 a11y 텍스트 override. 일반적으로 직접 사용보다 DatePicker / DateRangePicker 권장.",
     "scroll-area": "커스텀 스크롤 컨테이너 — composite export ScrollArea (Base UI). 내부에서 viewport + scrollbar + thumb + corner 를 자동 구성하며 OS-native 스크롤바를 대체한다. orientation: \"vertical\" | \"horizontal\" | \"both\" (기본 vertical). 외부 height/width 가 정해진 컨테이너 안에서 사용. viewportClassName 으로 viewport 의 패딩/레이아웃 분리 적용. 스크롤바는 hover/scrolling 시 fade in, prefers-reduced-motion 존중.",
+    "tree": "계층 데이터 트리 뷰 — Tree 단일 export + TreeNode 타입(`@/components/ui/tree/types`). nodes(TreeNode[]: id/label/children/icon/disabled) 를 평탄화해 role=tree 로 렌더. 확장: expandedIds/onExpandedChange(controlled) 또는 defaultExpandedIds(uncontrolled). 선택: selectedId/onSelect(controlled) 또는 defaultSelectedId(uncontrolled). 키보드 네비(화살표·Home/End·Enter·typeahead), renderLabel 커스텀 렌더러, size(sm/md). Base UI 비의존 자체 구현.",
     "sheet": "화면 가장자리에서 슬라이드 인 하는 side drawer — separate exports: Sheet / SheetTrigger / SheetClose / SheetContent / SheetTitle / SheetDescription / SheetHeader / SheetFooter / SheetCloseX (Base UI Drawer 래핑, 포커스 트랩). 글로벌 알림함 · 작업 큐 · 보조 패널 같은 사이드바 무관 모달 시트용. 사이드바 인근 detail 패널은 SidebarPanel, 중앙 강제 모달은 Dialog 권장. SheetContent 의 side: \"right\" | \"left\" | \"top\" | \"bottom\" (기본 right) 으로 진입 방향 지정. SheetTrigger·SheetClose 는 자체 button — 다른 엘리먼트 슬롯은 `render` prop. ESC/바깥 클릭/포커스 복귀 자동, prefers-reduced-motion 시 transform 트랜지션 제거."
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.115.0",
+  "version": "0.117.0",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {
@@ -25,13 +25,13 @@
     "components"
   ],
   "dependencies": {
-    "@inquirer/prompts": "^8.4.3",
+    "@inquirer/prompts": "^8.5.2",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "fs-extra": "^11.3.5",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.8"
   },
   "publishConfig": {
     "access": "public"

package/src/add.mjs

@@ -5,6 +5,7 @@ import { pathToFileURL } from "node:url";
 import { spawn } from "node:child_process";
 import { select } from "@inquirer/prompts";
 import { formatUnifiedDiff } from "./diff.mjs";
+import { suggest } from "./levenshtein.mjs";
 import { getRegistryRoot, getTokensRoot, getPeerVersionsPath } from "./paths.mjs";
 import { THEME_BASES } from "./constants.js";
 import {
@@ -20,6 +21,25 @@ import {
   rewriteCrossComponentImports,
 } from "./css-bundle.mjs";
 
+export const HELP_TEXT = `sh-ui add — 컴포넌트 소스를 프로젝트로 복사 + 필요한 패키지 자동 설치
+
+사용법:
+  sh-ui add <component...>
+  sh-ui add tokens          설정 기반 토큰 파일 생성 (특수값)
+
+옵션:
+  --skip-install   외부 패키지 자동 설치 생략
+  --diff           파일을 쓰지 않고 변경 내역(unified diff)만 출력
+  --force          기존 파일을 모두 덮어쓰기 (prompt 없음)
+  --keep           기존 파일을 모두 유지 (prompt 없음)
+  --app <name>     monorepo 라우팅 시 대상 ui-{name} 명시
+
+예:
+  sh-ui add button
+  sh-ui add button card --diff
+  sh-ui add tokens
+`;
+
 /**
  * 기존 파일과 registry 파일 내용이 다를 때 keep/overwrite 결정.
  * strategy 가 "prompt" 면 사용자에게 묻고, 그 외엔 즉시 결정.
@@ -336,6 +356,16 @@ function effectiveFramework(entry, cssFramework) {
   return hasVariant ? cssFramework : "plain";
 }
 
+/** 컴포넌트 not-found 에러 메시지. 가까운 후보가 있으면 "혹시 …?" 를 덧붙인다. */
+export function buildNotFoundMessage(name, platform, candidates) {
+  const hits = suggest(name, candidates);
+  const hint = hits.length ? ` 혹시 ${hits.join(", ")}?` : "";
+  return (
+    `'${name}' 컴포넌트를 ${platform} 레지스트리에서 찾을 수 없습니다.${hint}` +
+    ` 전체 목록: sh-ui list --all`
+  );
+}
+
 async function addComponent(name, config, cwd, installed, pendingDeps, diffMode, summary, conflictResolver, validationCtx) {
   const registryRoot = getRegistryRoot(config.platform);
   const registry = JSON.parse(
@@ -344,7 +374,7 @@ async function addComponent(name, config, cwd, installed, pendingDeps, diffMode,
   const entry = registry.components?.[name];
   if (!entry) {
     throw new Error(
-      `'${name}' 컴포넌트를 ${config.platform} 레지스트리에서 찾을 수 없습니다.`,
+      buildNotFoundMessage(name, config.platform, Object.keys(registry.components ?? {})),
     );
   }
 

package/src/commands.mjs

@@ -0,0 +1,6 @@
+// CLI 최상위 명령 목록 — bin 라우터와 did-you-mean 추천이 공유.
+export const KNOWN_COMMANDS = [
+  "create", "init", "add", "list", "doctor", "upgrade-cli",
+  "theme", "tokens", "mcp", "rename-app", "migrate", "migrate-v065",
+  "remove", "rm",
+];

package/src/create/generator.js

@@ -678,6 +678,10 @@ async function inferMonorepoPlatform(cwd) {
  * @param {string} [options.onConflict]           'prompt' | 'keep' | 'overwrite'
  */
 export async function addComponent(options = {}) {
+  // monorepo 라우팅은 컴포넌트별 registry 조회를 직접 하지 않고 add() 로 위임한다.
+  // 따라서 not-found 처리(오타 추천 포함)는 add.mjs 의 addComponent 가 공유 헬퍼
+  // buildNotFoundMessage 로 던지는 메시지를 그대로 쓴다 — standalone 경로와 동일,
+  // 메시지 로직 중복 없음 (DRY).
   const { add } = await import('../add.mjs');
 
   const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();

package/src/doctor.mjs

@@ -18,6 +18,20 @@ import {
   findMissingTokens,
 } from "./tokens-validate.mjs";
 
+export const HELP_TEXT = `sh-ui doctor — 프로젝트 정합성 점검
+
+사용법:
+  sh-ui doctor
+
+점검 항목:
+  config    sh-ui.config.json 존재·필드 유효성
+  tokens    tokens.css 정의·필요 변수 누락 여부
+  설치된 컴포넌트   소스/스타일 파일 정합성
+
+예:
+  sh-ui doctor
+`;
+
 const ICON = { ok: "✓", warn: "⚠", fail: "✗" };
 
 class Report {

package/src/init.mjs

@@ -13,6 +13,25 @@ import {
   CSS_FRAMEWORKS_PLANNED,
 } from "./constants.js";
 
+export const HELP_TEXT = `sh-ui init — sh-ui.config.json 생성 (기존 프로젝트에 sh-ui 얹기)
+
+사용법:
+  sh-ui init [options]
+
+옵션:
+  --platform <react|flutter>   타겟 플랫폼
+  --base <neutral|zinc|...>    색 베이스
+  --radius <none|sm|md|lg|xl|full>  모서리 반경
+  --mode <light|dark|light-dark>    색 모드
+  --cssFramework <plain|tailwind|css-modules>  CSS 전략 (vanilla-extract 예정)
+  --force                      기존 sh-ui.config.json 덮어쓰기
+  --yes                        대화형 프롬프트 생략 (기본값 채택)
+
+예:
+  sh-ui init
+  sh-ui init --platform react --base neutral --mode light-dark --yes
+`;
+
 const CHOICES = {
   platform: INIT_PLATFORMS,
   base: THEME_BASES,

package/src/levenshtein.mjs

@@ -0,0 +1,36 @@
+// 의존성 없는 편집거리 + 후보 제안. diff.mjs 가 LCS 를 자체 구현한 관행을 따른다.
+
+/** 두 문자열의 Levenshtein 편집거리 (삽입/삭제/치환 비용 1). */
+export function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  if (m === 0) return n;
+  if (n === 0) return m;
+  let prev = Array.from({ length: n + 1 }, (_, j) => j);
+  let curr = new Array(n + 1);
+  for (let i = 1; i <= m; i++) {
+    curr[0] = i;
+    for (let j = 1; j <= n; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[n];
+}
+
+/**
+ * input 과 가까운 candidates 를 거리 오름차순으로 반환.
+ * @param {string} input
+ * @param {string[]} candidates
+ * @param {{max?: number, maxDistance?: number}} [opts]
+ * @returns {string[]} 거리 <= maxDistance 인 후보 상위 max 개 (없으면 빈 배열)
+ */
+export function suggest(input, candidates, { max = 3, maxDistance = 2 } = {}) {
+  return candidates
+    .map((name) => ({ name, dist: levenshtein(input, name) }))
+    .filter((c) => c.dist <= maxDistance)
+    .sort((a, b) => a.dist - b.dist || a.name.localeCompare(b.name))
+    .slice(0, max)
+    .map((c) => c.name);
+}

package/src/list.mjs

@@ -3,6 +3,19 @@ import { existsSync } from "node:fs";
 import { resolve, relative } from "node:path";
 import { getRegistryRoot } from "./paths.mjs";
 
+export const HELP_TEXT = `sh-ui list — 현재 설치된 컴포넌트 목록 표시
+
+사용법:
+  sh-ui list
+
+옵션:
+  --all   설치되지 않은 컴포넌트까지 모두 표시
+
+예:
+  sh-ui list
+  sh-ui list --all
+`;
+
 function resolveDest(template, config) {
   return template.replace(/\{([a-zA-Z0-9_]+)\}/g, (m, key) => {
     const v = config.paths?.[key];

package/src/mcp.mjs

@@ -56,6 +56,20 @@ import { THEME_PRESET_NAMES } from "./create/theme/presets.js";
 import { decodeTheme } from "./create/theme/decode.js";
 import { encodeTheme } from "./create/theme/encode.js";
 
+export const HELP_TEXT = `sh-ui mcp — IDE-내 AI 용 MCP 서버 / 설정
+
+사용법:
+  sh-ui mcp                          MCP 서버(stdio) 시작
+  sh-ui mcp init --client <name>     IDE MCP 설정 파일에 sh-ui 엔트리 자동 추가
+
+옵션 (mcp init):
+  --client <name>   claude-code | cursor | claude-desktop | codex
+
+예:
+  sh-ui mcp
+  sh-ui mcp init --client claude-code
+`;
+
 const PLATFORMS = INIT_PLATFORMS;
 const BASES = THEME_BASES;
 const RADII = THEME_RADII;

package/src/migrate-bundled.mjs

@@ -16,6 +16,20 @@ import { existsSync } from "node:fs";
 import { resolve, relative, dirname, join } from "node:path";
 import { upsertSection, stripStylesImport } from "./css-bundle.mjs";
 
+export const HELP_TEXT = `sh-ui migrate bundled — cssStrategy=bundled 로 전환
+
+사용법:
+  sh-ui migrate bundled          per-component styles.css → 단일 sh-ui-components.css
+
+옵션:
+  --apply             실제 적용 (미지정 시 미리보기)
+  --bundle <path>     번들 CSS 파일 경로 명시
+
+예:
+  sh-ui migrate bundled
+  sh-ui migrate bundled --apply
+`;
+
 async function loadConfig(cwd) {
   const configPath = resolve(cwd, "sh-ui.config.json");
   if (!existsSync(configPath)) {

package/src/migrate-v065.mjs

@@ -14,6 +14,20 @@ import * as fsp from "node:fs/promises";
 import path from "node:path";
 import { createHash } from "node:crypto";
 
+export const HELP_TEXT = `sh-ui migrate-v065 — v0.64.x → v0.65 자동 마이그레이션
+
+사용법:
+  sh-ui migrate-v065             ui-app 컴포넌트를 ui-core 단일 SoT 로 dedup 이동
+
+옵션:
+  --dry-run   변경 plan 만 출력 (기본값 — 미지정 시 동작)
+  --apply     실제 적용
+
+예:
+  sh-ui migrate-v065
+  sh-ui migrate-v065 --apply
+`;
+
 const COMPONENT_KINDS = ["components", "hooks", "lib"];
 
 async function fileExists(p) {

package/src/remove.mjs

@@ -2,6 +2,21 @@ import { readFile, rm, rmdir, readdir, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { dirname, resolve, relative } from "node:path";
 import { getRegistryRoot } from "./paths.mjs";
+
+export const HELP_TEXT = `sh-ui remove — 설치된 컴포넌트 파일 삭제
+
+사용법:
+  sh-ui remove <component...>
+
+옵션:
+  --force     사용자가 수정한 파일도 삭제
+  --dry-run   변경 대상만 출력하고 실제로는 삭제하지 않음
+
+예:
+  sh-ui remove button
+  sh-ui remove button card --dry-run
+`;
+
 import {
   removeSection,
   isStyleFile,

package/src/rename-app.mjs

@@ -19,6 +19,21 @@ import { spawn } from "node:child_process";
 import { join, relative, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 
+export const HELP_TEXT = `sh-ui rename-app — monorepo 의 앱 이름 일괄 변경
+
+사용법:
+  sh-ui rename-app <old> <new>   apps/<old>/, ui-<old>/ 디렉토리 + 모든 import/path 패턴
+
+옵션:
+  --yes            대화형 확인 생략
+  --dry-run        변경 대상만 출력하고 실제로는 변경하지 않음
+  --skip-install   변경 후 pnpm install 생략
+
+예:
+  sh-ui rename-app web admin
+  sh-ui rename-app web admin --dry-run
+`;
+
 /** 텍스트 파일로 처리할 확장자 (전체 파일을 읽어 치환). */
 const TEXT_EXT = new Set([
   ".ts", ".tsx", ".js", ".mjs", ".cjs",

package/src/theme-extract.mjs

@@ -17,6 +17,19 @@ import { resolve, relative } from "node:path";
 import { parseBlocks } from "./tokens-diff.mjs";
 import { encodeTheme } from "./create/theme/encode.js";
 
+export const HELP_TEXT = `sh-ui theme — 현재 토큰을 테마 코드로 추출
+
+사용법:
+  sh-ui theme extract            tokens.css 의 색·radius 를 base64 로 추출 (stdout)
+
+옵션:
+  --out <path>   추출 결과를 stdout 대신 파일로 저장
+
+예:
+  sh-ui theme extract
+  sh-ui theme extract --out theme.txt
+`;
+
 /**
  * Dart 의 ShUiColorTokens 필드명 ↔ TOKEN_KEYS (hyphen) 매핑.
  * inject.js 의 DART_FIELD_SOURCES 와 같은 매핑을 reverse 로 사용.

package/src/tokens-cmd.mjs

@@ -17,6 +17,18 @@ import { THEME_BASES } from "./constants.js";
 import { parseBlocks, diffBlocks, applyAdditions } from "./tokens-diff.mjs";
 import { parseDartTokens, diffDartTokens } from "./tokens-diff-dart.mjs";
 
+export const HELP_TEXT = `sh-ui tokens — tokens.css 비교/업그레이드
+
+사용법:
+  sh-ui tokens diff                    tokens.css 와 buildTokens 결과 비교
+  sh-ui tokens upgrade --apply         추가된 변수만 적용 (사용자 편집 보존)
+  sh-ui tokens upgrade --replace       buildTokens 결과로 통째 덮어쓰기
+
+예:
+  sh-ui tokens diff
+  sh-ui tokens upgrade --apply
+`;
+
 async function loadTokensBuilder() {
   const url = pathToFileURL(resolve(getTokensRoot(), "build.mjs")).href;
   return import(url);

package/src/upgrade-cli.mjs

@@ -15,6 +15,19 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 
+export const HELP_TEXT = `sh-ui upgrade-cli — sh-ui-cli 자체를 최신으로 업그레이드
+
+사용법:
+  sh-ui upgrade-cli              최신 버전 확인 + 변경 내역 미리보기
+
+옵션:
+  --apply   실제 설치 후 진단 (미지정 시 미리보기만)
+
+예:
+  sh-ui upgrade-cli
+  sh-ui upgrade-cli --apply
+`;
+
 const CLI_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const REGISTRY_URL = "https://registry.npmjs.org/sh-ui-cli/latest";