sh-ui-cli 0.71.1 → 0.71.2

package/bin/sh-ui.mjs

@@ -109,7 +109,47 @@ try {
     }
     case "doctor": {
       const { doctor } = await import("../src/doctor.mjs");
-      await doctor({ cwd: process.cwd() });
+      const { existsSync, readdirSync } = await import("node:fs");
+      const { resolve } = await import("node:path");
+      // add 와 같은 walk-up + monorepo 라우팅. standalone 이면 그 root 1개,
+      // monorepo 면 packages/ui/ui-core + ui-apps/ui-* 모두 순회.
+      const ctx = findShUiContext(process.cwd());
+      if (!ctx) {
+        console.error(
+          "✗ sh-ui.config.json 또는 pnpm-workspace.yaml 을 cwd 부터 부모 트리에서 찾지 못했습니다.",
+        );
+        process.exit(1);
+      }
+      let anyFailed = false;
+      const targets = [];
+      if (ctx.kind === "config") {
+        targets.push(ctx.root);
+      } else {
+        const uiCore = resolve(ctx.root, "packages/ui/ui-core");
+        if (existsSync(resolve(uiCore, "sh-ui.config.json"))) targets.push(uiCore);
+        const uiAppsRoot = resolve(ctx.root, "packages/ui/ui-apps");
+        if (existsSync(uiAppsRoot)) {
+          for (const name of readdirSync(uiAppsRoot)) {
+            const dir = resolve(uiAppsRoot, name);
+            if (existsSync(resolve(dir, "sh-ui.config.json"))) targets.push(dir);
+          }
+        }
+        if (targets.length === 0) {
+          console.error(
+            "✗ monorepo 에서 sh-ui.config.json 가지는 패키지를 찾지 못했습니다.\n" +
+              "  packages/ui/ui-core/ 또는 packages/ui/ui-apps/ui-*/ 에 있어야 합니다.",
+          );
+          process.exit(1);
+        }
+      }
+      for (const target of targets) {
+        if (targets.length > 1) {
+          console.log(`\n────  ${target.replace(ctx.root + "/", "")}  ────`);
+        }
+        const result = await doctor({ cwd: target });
+        if (!result.ok) anyFailed = true;
+      }
+      if (anyFailed) process.exit(1);
       break;
     }
     case "theme": {

package/data/changelog/versions.json

@@ -2,6 +2,18 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.71.2",
+      "date": "2026-05-09",
+      "title": "fix(doctor) — monorepo walk-up + 컴포넌트-only 패키지 인식",
+      "type": "patch",
+      "highlights": [
+        "**doctor 의 walk-up + monorepo 라우팅** — `add` 와 같은 정책을 적용. monorepo 어느 디렉토리 (apps/web, ui-core 안 등) 에서 실행해도 `packages/ui/ui-core` 와 모든 `packages/ui/ui-apps/ui-*` 를 자동 순회. 각 패키지마다 헤더 출력 + 결과 집계, 하나라도 fail 이면 exit 1.",
+        "**컴포넌트-only 패키지 인식** — ui-core 처럼 `paths.tokens` 가 없는 패키지는 의도된 형태. 이전엔 'theme 미설정 / 토큰 검증 스킵' 로 fail/warn 폭발 → 이제 ✓ '(컴포넌트 only — 토큰 없음, 검증 스킵)' 한 줄로 정리.",
+        "**doctor 함수 시그니처** — `process.exit()` 직접 호출 대신 `{ ok, failCount, warnCount }` 반환. 호출부 (bin) 가 monorepo 순회 후 집계 exit. API consumer (테스트, 향후 lint:doctor 등) 도 활용 가능."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.71.2"
+    },
     {
       "version": "0.71.1",
       "date": "2026-05-09",

package/package.json

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

package/src/doctor.mjs

@@ -72,16 +72,18 @@ async function loadConfig(cwd, report) {
     const config = JSON.parse(await readFile(configPath, "utf8"));
     const issues = [];
     if (!config.platform) issues.push("platform 미설정");
-    if (!config.theme) issues.push("theme 미설정");
     if (!config.paths) issues.push("paths 미설정");
+    // theme 은 컴포넌트-only 패키지 (monorepo ui-core, paths.tokens 없음) 에서는
+    // 의도적으로 비어 있다 — 그땐 누락이라고 보지 않음.
+    if (!config.theme && config.paths?.tokens) issues.push("theme 미설정");
     if (issues.length > 0) {
       report.fail("sh-ui.config.json", `필수 필드 누락: ${issues.join(", ")}`);
       return null;
     }
+    const themeInfo = config.theme?.base ? `theme.base=${config.theme.base}` : "(컴포넌트 only)";
     report.ok(
       "sh-ui.config.json",
-      `platform=${config.platform} theme.base=${config.theme?.base ?? "?"} ` +
-        `cssFramework=${config.cssFramework ?? "(기본 plain)"}`,
+      `platform=${config.platform} ${themeInfo} cssFramework=${config.cssFramework ?? "(기본 plain)"}`,
     );
     return config;
   } catch (err) {
@@ -93,10 +95,11 @@ async function loadConfig(cwd, report) {
 function checkTokensFile(config, cwd, report) {
   const rel = config.paths?.tokens;
   if (!rel) {
-    // 모노레포 ui-core 처럼 tokens 를 가지지 않는 패키지 — 이 경우 검사 스킵.
-    report.warn(
+    // 모노레포 ui-core 처럼 토큰을 가지지 않는 컴포넌트-only 패키지 — 이 케이스는
+    // 정상이라 안내 한 줄만 ok 로 표시 (warn 으로 노이즈 만들지 않음).
+    report.ok(
       "paths.tokens",
-      "config 에 paths.tokens 가 없습니다 — 토큰 검증 스킵.",
+      "(컴포넌트 only — 토큰 없음, 검증 스킵)",
     );
     return null;
   }
@@ -171,6 +174,14 @@ async function checkCssEntry(config, cwd, tokensPath, report) {
  */
 async function checkInstalledComponents(config, cwd, definedVars, report) {
   if (!definedVars) {
+    // tokens 없는 컴포넌트-only 패키지 — 의존성 검증은 의미 없음. 조용히 ok.
+    if (!config.paths?.tokens) {
+      report.ok(
+        "컴포넌트 토큰 의존성",
+        "(컴포넌트 only — 검증 스킵)",
+      );
+      return;
+    }
     report.warn(
       "컴포넌트 토큰 의존성",
       "tokens.css 가 없어 검증 스킵.",
@@ -290,6 +301,10 @@ function effectiveFramework(entry, cssFramework) {
   return hasVariant ? cssFramework : "plain";
 }
 
+/**
+ * @returns {Promise<{ ok: boolean, failCount: number, warnCount: number }>}
+ *          호출부가 exit code 결정. 한 cwd 에서 다른 cwd 로 이어 호출 가능 (monorepo 순회).
+ */
 export async function doctor({ cwd }) {
   console.log(`sh-ui doctor — ${relative(process.cwd(), cwd) || "."}\n`);
   const report = new Report();
@@ -297,7 +312,7 @@ export async function doctor({ cwd }) {
   const config = await loadConfig(cwd, report);
   if (!config) {
     report.render();
-    process.exit(1);
+    return { ok: false, failCount: report.failCount, warnCount: report.warnCount };
   }
 
   const tokensPath = checkTokensFile(config, cwd, report);
@@ -312,5 +327,5 @@ export async function doctor({ cwd }) {
   await checkInstalledComponents(config, cwd, definedVars, report);
 
   report.render();
-  if (report.failCount > 0) process.exit(1);
+  return { ok: report.failCount === 0, failCount: report.failCount, warnCount: report.warnCount };
 }