sh-ui-cli 0.67.0 → 0.67.2

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.67.2",
+      "date": "2026-05-09",
+      "title": "patch — MCP instructions 에 v0.65~0.67 신규 툴/라우팅 가이드 반영 + migrations 노트",
+      "type": "patch",
+      "highlights": [
+        "**MCP `instructions` 갱신** — `sh_ui_add_app` (모노레포에 앱 추가), `sh_ui_migrate_to_v065` (v0.64.x → v0.65 자동 마이그레이션) 사용 시점을 명시. AI 가 사용자 의도 (\"admin 앱 추가\", \"컴포넌트 중복 emit 정리\") 와 툴 호출을 직접 매핑.",
+        "**모노레포 라우팅 가이드 추가** — `sh_ui_add_component` 가 monorepo 에선 컴포넌트는 ui-core 단일 SoT, tokens 는 각 ui-app 으로 라우팅. CLI `sh-ui add` 는 v0.67+ walk-up 으로 어느 디렉토리에서든 자동 라우팅 (apps/web 에서 tokens → ui-web hintApp 추론).",
+        "**v0.67.1 preset 보존 정책 명시** — rose/emerald/violet 등 풍부한 preset 도 'custom' 과 동일하게 tokens.css 단일 진실로 보존. `sh_ui_add_component` 의 `tokens` 가 rebuild 대신 보존하는 케이스 확장.",
+        "**`apps/docs/migrations/v0.65.md`** 에 v0.66/0.67 후속 개선 섹션 추가 — sh_ui_add_app, walk-up 라우팅, preset 회귀 fix 까지 한 페이지에서 흐름 파악 가능."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.67.2"
+    },
+    {
+      "version": "0.67.1",
+      "date": "2026-05-09",
+      "title": "patch — sh-ui add tokens 가 rose/emerald/violet preset 에서 throw 하던 회귀 수정",
+      "type": "patch",
+      "highlights": [
+        "**`sh-ui add tokens` 가 rose/emerald/violet preset 에서 `해석 실패: {color.rose.50}` 로 throw 하던 회귀 수정** — CLI 의 풍부한 preset (rose/emerald/violet) 은 packages/tokens 의 primitives.json 에 색 스케일이 없어 `buildTokens` 가 해석 불가. injectCssTheme 이 create 시점에 resolved hex 를 박아둔 tokens.css 를 단일 진실로 두고, 재실행 시 'custom' 과 동일하게 보존하도록 가드 확장.",
+        "**tokens.css 미존재 + non-buildable preset → 친절한 에러** — `sh-ui init --theme rose` 후 `sh-ui add tokens` 같은 흐름은 preset 사용법 안내와 함께 종료 (해결책: `sh-ui create --theme rose` 또는 theme.base 를 neutral/slate/zinc 로 변경).",
+        "**buildable bases (neutral/slate/zinc) 는 정상 빌드** — 회귀 가드 6개 (`add-tokens-presets.test.js`) — 보존 / 친절한 에러 / 정상 빌드 모두 검증."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.67.1"
+    },
     {
       "version": "0.67.0",
       "date": "2026-05-09",

package/package.json

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

package/src/add.mjs

@@ -6,6 +6,7 @@ import { spawn } from "node:child_process";
 import { select } from "@inquirer/prompts";
 import { formatUnifiedDiff } from "./diff.mjs";
 import { getRegistryRoot, getTokensRoot, getPeerVersionsPath } from "./paths.mjs";
+import { THEME_BASES } from "./constants.js";
 
 /**
  * 기존 파일과 registry 파일 내용이 다를 때 keep/overwrite 결정.
@@ -185,6 +186,29 @@ async function addTokens(config, cwd, diffMode, summary, conflictResolver) {
     return;
   }
 
+  // CLI 가 THEME_PRESETS 에서 알지만 primitives.json 의 THEME_BASES 에 없는 풍부한 preset
+  // (rose/emerald/violet 등) 도 buildTokens 가 `{color.rose.50}` 등을 해석할 수 없어 throw.
+  // create 시점에 injectCssTheme 이 resolved hex 를 박아둔 tokens.css 가 단일 진실 —
+  // sh-ui add tokens 는 보존만. base 가 buildable 하지 않으면 같은 정책 적용.
+  const base = config.theme?.base;
+  if (base && !THEME_BASES.includes(base)) {
+    if (!existsSync(dest)) {
+      throw new Error(
+        `'${base}' preset 의 tokens.css 가 아직 없습니다. 이 preset 은 ` +
+        `sh-ui add tokens 로 빌드 불가 (primitives 미정의 — buildable: ${THEME_BASES.join('/')}). ` +
+        `해결: sh-ui create --theme ${base} 로 새 프로젝트 스캐폴드, 또는 ` +
+        `sh-ui.config.json 의 theme.base 를 ${THEME_BASES.join('/')} 중 하나로 변경 후 재실행.`,
+      );
+    }
+    if (!diffMode) {
+      console.log(
+        `↷ tokens → ${relative(cwd, dest)} ('${base}' preset — tokens.css 보존, ` +
+        `색 조정은 파일 직접 편집 또는 sh-ui create --theme <new> 로 재스캐폴드)`
+      );
+    }
+    return;
+  }
+
   const { buildTokens } = await loadTokensBuilder();
   const content = await buildTokens(config);
 

package/src/mcp.mjs

@@ -164,6 +164,22 @@ function buildServerInstructions(cliName) {
 
 \`create-next-app\` + \`sh_ui_init\` 조합은 **쓰지 말 것** — 위 두 경로가 더 짧고 sh-ui 관용에 맞다.
 
+## 기존 모노레포에 새 앱 추가하는 경우 (v0.66+)
+
+이미 sh-ui monorepo 가 있고 사용자가 "admin 앱 추가", "dashboard 같은 앱 더 만들고 싶어" 류 요청을 하면 \`sh_ui_add_app\` MCP 툴 사용 (Bash 직접 호출보다 우선).
+
+  - 인자: name (필수), port, plugins (선택), theme (앱별 다른 톤 가능), cssFramework, cwd
+  - 산출물: \`apps/{name}/\` (Next.js + arch overlay) + \`packages/ui/ui-apps/ui-{name}/\` (tokens-only role, v0.65 layout). 새 ui-app 만 theme/css 적용 — 다른 앱 영향 X.
+  - 앱별로 다른 톤을 원하면 각 앱 별도 호출 (예: 마케팅 사이트 = rose, admin = emerald). 컴포넌트는 ui-core 단일 SoT 라 두 앱이 자동 공유.
+
+## v0.64.x → v0.65 마이그레이션 (v0.66+)
+
+사용자가 "v0.64 모노레포에서 컴포넌트 중복 emit 정리하고 싶어" / "ui-app 들에 같은 컴포넌트가 N 번 있어" 류 요청 또는 사용자가 v0.64.x 시절 만든 모노레포라면 \`sh_ui_migrate_to_v065\` 사용:
+
+  - **dryRun 기본** — 변경 plan 미리보기 후 사용자 확인. 컨텐츠 충돌 시 abort (자동 병합 안 함).
+  - apply: 모든 ui-app 의 \`src/{components,hooks,lib}/\` → \`packages/ui/ui-core/\` 단일 SoT 로 dedup 이동, ui-app 에 \`role: "tokens-only"\` 마커, \`apps/*\` 의 \`@workspace/ui-{app}/components/...\` 임포트를 \`@workspace/ui-core/...\` 로 일괄 재작성.
+  - 적용 후 사용자에게 \`pnpm install\` 안내.
+
 ## 이미 있는 프로젝트에 sh-ui 를 얹는 경우 (MCP 툴 사용)
 
 기존 Next.js/Vite/Flutter 프로젝트에 sh-ui 컴포넌트만 추가하고 싶을 때:
@@ -178,6 +194,14 @@ function buildServerInstructions(cliName) {
 - \`sh_ui_add_component\` / \`sh_ui_remove_component\` — 설치/삭제
 - \`sh_ui_get_changelog\` — 최근 변경 내역
 
+### 모노레포 라우팅 (v0.65+)
+
+monorepo 에서 \`sh_ui_add_component\` 호출 시:
+- **컴포넌트/훅/lib** → \`packages/ui/ui-core/\` 단일 SoT (ui-app 마다 복제 X). 모든 앱이 \`@workspace/ui-core/components/<name>\` 으로 import.
+- **\`tokens\`** → 각 \`packages/ui/ui-apps/ui-{app}/\` (앱별 다른 톤 가능). \`--app <name>\` 으로 대상 명시 가능.
+
+CLI \`sh-ui add <name>\` 은 monorepo 의 어느 디렉토리에서든 (apps/web/, root, ui-core, ui-apps/ui-{app}) 실행해도 자동 라우팅 (v0.67+ walk-up). \`apps/web/\` 안에서 \`sh-ui add tokens\` 실행하면 hintApp='web' 으로 ui-web 자동 선택.
+
 ## UI 짤 때 사고 순서 (raw HTML 기본값 회피)
 
 새 위젯·페이지를 작성할 때 \`<aside>\` / \`<nav>\` / \`<header>\` / \`<table>\` / \`<button>\` 같은 시맨틱 태그를 raw 로 쓰기 전에:
@@ -222,7 +246,7 @@ function buildServerInstructions(cliName) {
 
 ### 기존 프로젝트 톤만 바꾸고 싶을 때
 
-> v0.61.2 부터 \`theme.base: "custom"\` 인 프로젝트에서 \`sh_ui_add_component\` 의 \`tokens\` 는 no-op (보존). 색을 바꾸려면 새 base64 를 만들고 새 디렉토리로 \`force: true\` 재스캐폴드하는 게 정석. 부분 편집을 원해도 \`tokens.css\` 직접 수정 후 \`sh_ui_encode_theme\` 로 새 base64 백업까지 같이 — 그 base64 를 메모리에 갱신해야 다음 재스캐폴드와 일관됨.
+> v0.61.2 부터 \`theme.base: "custom"\` 인 프로젝트에서 \`sh_ui_add_component\` 의 \`tokens\` 는 no-op (보존). v0.67.1 부터 \`rose\`/\`emerald\`/\`violet\` 같은 풍부한 preset 도 동일 — tokens.css 단일 진실로 보존. 색을 바꾸려면 새 base64 를 만들고 새 디렉토리로 \`force: true\` 재스캐폴드하는 게 정석. 부분 편집을 원해도 \`tokens.css\` 직접 수정 후 \`sh_ui_encode_theme\` 로 새 base64 백업까지 같이 — 그 base64 를 메모리에 갱신해야 다음 재스캐폴드와 일관됨.
 `;
 }