@bstage-sdk/cli 0.8.2 → 0.8.4

package/dist/MIGRATION.md

@@ -51,6 +51,65 @@
 
 ---
 
+## → cli 0.8.4 · ai-toolkit 0.8.4
+
+### `bstage doctor`가 포털 배치 진단을 함께 본다 — `자동` · `선택`
+
+**영향**
+
+- 로그인(`bstage login`)·링크(`bstage link`)된 디렉터리에서 `bstage doctor`를 실행하는 모든 프로젝트. 로그인·링크가 없으면 지금과 같다(포털 진단 절만 "건너뜀"으로 표시).
+- **종료 코드가 새로 생긴다.** 포털 진단에 `error` 심각도 항목이 하나라도 있으면 `bstage doctor`가 **1**로 끝난다. 예전엔 항상 0이었다. CI·스크립트에서 doctor의 종료 코드를 실패로 처리하고 있다면 확인한다(로컬 진단 결과는 여전히 종료 코드에 영향이 없다).
+- 감지: `bstage doctor --json` 출력에 `portal` 필드가 있으면 이 버전 이상이다.
+
+**변경 내용**
+
+- 로컬 진단 뒤에 **"포털 진단"** 절이 붙는다. 이 레포(링크된 레포)의 배치마다 포털이 판정한 문제를 심각도(`✗` error · `!` warn · `·` info), 제목, 상세, 조치와 함께 보여 준다 — 스테이지 커스텀 페이지 꺼짐, 배치 게시 꺼짐, 게시된 빌드 없음, 게시 빌드의 APP ID·KEY 문제(만료·스코프·짝 불일치·앞뒤 공백), 다시 빌드하지 않은 환경변수, 반영하지 않은 새 성공 빌드, 최신 빌드 실패 등. 문제가 없으면 `✓ 문제 없음`이다.
+- 배치는 30개까지(동시 4개) 진단한다. **`--placement <id|경로|슬롯 id>`**로 하나만 볼 수 있다(`bstage deploy --placement`와 같은 정확 일치). `--placement`를 줬는데 링크가 없으면 종료 코드 2, 토큰이 없으면 3이다.
+- `--json`(stdout 객체 하나)에 **`portal`** 필드가 더해진다(기존 필드는 그대로): `{ status: 'ok'|'skipped'|'unsupported'|'error', reason?, hint?, omitted?, placements: [{ placementId, path, slotId, surface, findings: [{ id, severity, title, detail?, fix?, evidence? }], error? }] }`. `findings[].id`(예: `appkey.expired`, `placement.not_deployed`)는 바뀌지 않는 식별자라 스크립트·에이전트가 분기에 쓸 수 있다. 진단 요청이 실패한 배치는 `error`에 이유가 담기고 `status`는 `error`다.
+- 포털 서버가 아직 진단을 지원하지 않으면(`status: 'unsupported'`) 그 절만 건너뛴다. CLI 토큰은 `read` 등급이면 된다.
+- `bstage-deploy` 스킬: 배포 후 401이 나거나 페이지가 기대와 다르면 `bstage doctor --json`부터 실행해 `portal.placements[].findings`의 `id`·`fix`를 따르도록 안내한다.
+
+**적용**
+
+1. (자동) CLI를 올리면 된다. 스킬 문구는 `npx @bstage-sdk/cli@latest ai update`로 갱신한다.
+2. (판단) CI에서 `bstage doctor`를 돌리고 있다면 새 종료 코드 1을 실패로 볼지 정한다. 로그인·링크가 없는 CI라면 영향이 없다.
+
+## → cli 0.8.3 · ai-toolkit 0.8.3
+
+### sandbox 포털 기본 주소가 공개 주소로 바뀌었다 — `자동`
+
+**영향**
+
+- sandbox 포털에 로그인·배포하는 모든 프로젝트. 할 일은 없다.
+- 사외(파트너) 환경에서 `bstage login`이 `ENOTFOUND`로 실패하던 문제가 풀린다.
+
+**변경 내용**
+
+- sandbox 포털 기본 주소: 예전 사내망 전용 주소(사설 IP) → `bstage-portal.sandstage.in`(공개).
+- 옛 주소로 저장된 `.bstage/project.json`·로그인 토큰·`BSTAGE_PORTAL_URL`·`--portal` 값은 새 주소로 바꿔 읽는다. 다시 `bstage link`·`bstage login` 하지 않아도 된다. 토큰 파일은 다음 로그인 때 새 주소 키로 합쳐진다.
+- 스킴 없이 준 포털 주소(예: `BSTAGE_PORTAL_URL=bstage-portal.sandstage.in`)는 https로 본다. 예전에는 `Invalid URL`로 실패했다.
+
+**적용**
+
+1. (자동) CLI를 올리면 된다. 옛 버전에서 사외 로그인이 필요하면 `npx bstage login --portal https://bstage-portal.sandstage.in` 또는 `BSTAGE_PORTAL_URL=https://bstage-portal.sandstage.in`(스킴 포함)을 쓴다.
+
+### 템플릿 `name`은 폴더명과 같을 필요가 없다(문서 정정) — `자동`
+
+**영향**
+
+- 코드·빌드 동작은 바뀌지 않는다. 문서만 바로잡았다.
+- `AGENTS.md`와 `bstage-template` 스킬이 "`createTemplate`의 `name`은 폴더명과 동일해야 한다"고 안내했지만, 빌드는 그런 검사를 하지 않는다. 이 문구를 따라 페이지 폴더명을 `name`에 맞추느라 배포 경로가 의도와 달라질 수 있었다(예: `/todos`로 내보내려던 페이지가 `/garen-todos`로 나감).
+
+**변경 내용**
+
+- `name`은 Custom Element 태그명이다. 소문자로 시작하고 하이픈을 1개 이상 넣고 소문자·숫자·하이픈만 쓴다. 레포 안에서 템플릿마다 달라야 한다(`bstage build`가 검사).
+- 배포 경로(페이지)와 슬롯 자리는 폴더 위치가 정한다(`src/pages/{경로}/`). 그래서 `name`은 폴더명과 같을 필요가 없다. 예: 폴더 `src/pages/todos` + `name: 'garen-todos'`.
+- **AGENTS.md 관리 영역 v16**: 위 내용으로 템플릿 작성 절을 고쳤다. `bstage-template` 스킬도 같은 내용으로 고쳤다.
+
+**적용**
+
+1. (자동) `npx @bstage-sdk/cli@latest ai update` — 스킬·`AGENTS.md` 관리 영역을 v16으로 갱신한다.
+
 ## → cli 0.7.0
 
 ### 페이지 배치를 CLI로 만든다 — `bstage placement create` — `자동` · `선택`

package/dist/{chunk-COUDGZIA.js → chunk-MSXSJHUT.js}

@@ -67,7 +67,10 @@ var TRANSLATION_CDN_BASE_KEY = "static/i18n";
 var TRANSLATION_CDN_BUCKET_PREFIX = "cdn.bstage.in/";
 var PORTAL_HOSTS = {
   real: "portal.bstage.in",
-  sandbox: "bstage-portal.sandbox.bstage.systems"
+  sandbox: "bstage-portal.sandstage.in"
+};
+var LEGACY_PORTAL_HOSTS = {
+  "bstage-portal.sandbox.bstage.systems": "bstage-portal.sandstage.in"
 };
 var PORTAL_HOST_ENV_KEY = "VITE_BSTAGE_PORTAL_HOST";
 function getAuthHost(mode, phase, tenantId) {
@@ -2129,6 +2132,7 @@ export {
   TRANSLATION_CDN_BASE_KEY,
   TRANSLATION_CDN_BUCKET_PREFIX,
   PORTAL_HOSTS,
+  LEGACY_PORTAL_HOSTS,
   PORTAL_HOST_ENV_KEY,
   resolveProjectTarget,
   appKeyEnvDefine,

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   APP_KEY_VAR,
   DEFAULT_TRANSLATION_TIER,
   LEGACY_APP_KEY_VAR,
+  LEGACY_PORTAL_HOSTS,
   LOGIN_PATH,
   PORTAL_HOSTS,
   PORTAL_HOST_ENV_KEY,
@@ -16,7 +17,7 @@ import {
   isPublicPhase,
   resolvePhase,
   resolveProjectTarget
-} from "./chunk-COUDGZIA.js";
+} from "./chunk-MSXSJHUT.js";
 
 // src/index.ts
 import { readFileSync as readFileSync5 } from "fs";
@@ -155,6 +156,18 @@ var PortalClient = class {
     );
     return unwrap(body, "placements");
   }
+  /**
+   * `GET .../placements/{id}/diagnosis` — 배치 하나가 "왜 기대대로 안 뜨는가"를 서버가 판정한 결과.
+   * 이 경로가 없는 구버전 서버는 404(CLI 토큰이면 등급 허용 목록 403)로 답한다 — 해석은 호출자 몫이다.
+   * `findings`가 빠진 응답도 빈 배열로 맞춰 호출자가 분기하지 않게 한다.
+   */
+  async getPlacementDiagnosis(org, space, placementId) {
+    const d = await this.json(
+      "GET",
+      `${this.stage(org, space)}/placements/${enc(placementId)}/diagnosis`
+    );
+    return { ...d, findings: d.findings ?? [] };
+  }
   /**
    * `expectedLiveBuildId`는 CAS(compare-and-swap) — 서버 측 live 빌드와 다르면 409.
    * 응답은 배치 전체가 아니라 `{id, liveBuildId}`만 온다(포털 핸들러 그대로).
@@ -2211,7 +2224,10 @@ import { dirname as dirname5, join as join7 } from "path";
 import { loadEnv as loadEnv2 } from "vite";
 var LOCAL_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]"]);
 function normalizePortalUrl(url) {
-  const u = new URL(url);
+  const raw = url.trim();
+  const u = new URL(/^[a-z][a-z0-9+.-]*:\/\//i.test(raw) ? raw : `https://${raw}`);
+  const current = LEGACY_PORTAL_HOSTS[u.hostname];
+  if (current) u.hostname = current;
   if (u.protocol !== "https:" && !(u.protocol === "http:" && LOCAL_HOSTS.has(u.hostname))) {
     fail(
       ExitCode.PRECONDITION,
@@ -2345,14 +2361,32 @@ function sanitize(tokens) {
   });
   return Object.fromEntries(buckets.filter(([, bucket]) => Object.keys(bucket).length > 0));
 }
+function canonicalPortalKey(portal) {
+  try {
+    return normalizePortalUrl(portal);
+  } catch {
+    return portal;
+  }
+}
+function mergeByCanonicalPortal(tokens) {
+  return Object.entries(tokens).reduce((acc, [portal, bucket]) => {
+    const key = canonicalPortalKey(portal);
+    const existing = acc[key] ?? {};
+    const merged = key === portal ? { ...existing, ...bucket } : { ...bucket, ...existing };
+    return { ...acc, [key]: merged };
+  }, {});
+}
 function migrate(raw) {
   if (!raw || typeof raw !== "object") return { version: 2, tokens: {} };
   const obj = raw;
   if (obj.version === 2 && obj.tokens && typeof obj.tokens === "object") {
-    return { version: 2, tokens: sanitize(obj.tokens) };
+    return {
+      version: 2,
+      tokens: mergeByCanonicalPortal(sanitize(obj.tokens))
+    };
   }
   const tokens = Object.entries(obj).filter(([, v]) => isEntry(v)).map(([portal, v]) => [portal, { [UNKNOWN_ORG]: v }]);
-  return { version: 2, tokens: Object.fromEntries(tokens) };
+  return { version: 2, tokens: mergeByCanonicalPortal(Object.fromEntries(tokens)) };
 }
 async function readCredentialFile(env2) {
   try {
@@ -4416,6 +4450,122 @@ async function i18nPullCommand(options) {
   console.log(pc15.dim("  \uC0DD\uC131 \uD30C\uC77C\uC744 \uD55C \uBC88 import\uD558\uBA74 useBstageTranslations().t() \uD0A4\uAC00 \uC881\uD600\uC9D1\uB2C8\uB2E4."));
 }
 
+// src/commands/doctor/portal.ts
+var MAX_DIAGNOSED_PLACEMENTS = 30;
+var DIAGNOSIS_CONCURRENCY = 4;
+function portalHasErrorFinding(p5) {
+  return (p5?.placements ?? []).some((row) => row.findings.some((f) => f.severity === "error"));
+}
+async function diagnosePortal(opts, deps = {}) {
+  const explicit = Boolean(opts.placement);
+  const ctx = await openContext(deps, explicit);
+  if (!("client" in ctx)) return ctx;
+  const { client, link } = ctx;
+  let all;
+  try {
+    all = await client.listPlacements(link.organizationId, link.spaceId, link.surface);
+  } catch (err) {
+    return {
+      status: "error",
+      reason: `\uBC30\uCE58 \uBAA9\uB85D\uC744 \uAC00\uC838\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4 \u2014 ${describeError(err)}`,
+      placements: []
+    };
+  }
+  const targets = explicit ? requireTargets(all, link.repoId, opts.placement) : selectPlacements(all, link.repoId);
+  if (targets.length === 0) {
+    return {
+      status: "ok",
+      reason: "\uC774 \uB808\uD3EC\uC5D0 \uC5F0\uACB0\uB41C \uBC30\uCE58\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+      hint: "bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984>",
+      placements: []
+    };
+  }
+  const picked = targets.slice(0, MAX_DIAGNOSED_PLACEMENTS);
+  const omitted = targets.length - picked.length;
+  const outcomes = await mapLimit(picked, DIAGNOSIS_CONCURRENCY, (p5) => diagnoseOne(ctx, p5));
+  if (outcomes.every((o) => o.unsupported)) {
+    return {
+      status: "unsupported",
+      reason: "\uD3EC\uD138 \uC11C\uBC84\uAC00 \uC544\uC9C1 \uBC30\uCE58 \uC9C4\uB2E8\uC744 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.",
+      placements: []
+    };
+  }
+  const placements = outcomes.map((o) => o.row);
+  return {
+    status: placements.some((r) => r.error !== void 0) ? "error" : "ok",
+    placements,
+    ...omitted > 0 ? { omitted } : {}
+  };
+}
+async function openContext(deps, explicit) {
+  const cwd = deps.cwd ?? process.cwd();
+  const env2 = deps.env ?? process.env;
+  const hasLink = await loadLink(cwd, env2) !== null;
+  try {
+    return await resolveContext({ cwd, env: env2, fetch: deps.fetch });
+  } catch (err) {
+    if (explicit) throw err;
+    const reason = scrub(err instanceof Error ? err.message : String(err));
+    const isAuth = err instanceof CliExit && err.code === ExitCode.AUTH;
+    const hint = isAuth ? "bstage login" : hasLink ? void 0 : "bstage link";
+    return { status: "skipped", reason, ...hint ? { hint } : {}, placements: [] };
+  }
+}
+async function diagnoseOne(ctx, p5) {
+  const base = {
+    placementId: p5.id,
+    path: p5.path ?? "",
+    slotId: p5.slotId ?? "",
+    surface: p5.surface
+  };
+  try {
+    const d = await ctx.client.getPlacementDiagnosis(
+      ctx.link.organizationId,
+      ctx.link.spaceId,
+      p5.id
+    );
+    return {
+      row: {
+        ...base,
+        path: d.path || base.path,
+        slotId: d.slotId || base.slotId,
+        surface: d.surface ?? base.surface,
+        findings: d.findings
+      },
+      unsupported: false
+    };
+  } catch (err) {
+    return {
+      row: { ...base, findings: [], error: describeError(err) },
+      unsupported: isUnsupported(err)
+    };
+  }
+}
+var PLACEMENT_NOT_FOUND = "\uBC30\uCE58\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4";
+function isUnsupported(err) {
+  if (!(err instanceof PortalError)) return false;
+  if (err.status === 404) return !err.message.includes(PLACEMENT_NOT_FOUND);
+  return err.status === 403 && err.message.includes("\uD1A0\uD070 \uB4F1\uAE09\uC73C\uB85C \uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294");
+}
+function describeError(err) {
+  if (err instanceof PortalError && err.status > 0) {
+    return scrub(`${err.message} (HTTP ${err.status})`);
+  }
+  return scrub(err instanceof Error ? err.message : String(err));
+}
+async function mapLimit(items, limit, fn) {
+  const results = new Array(items.length);
+  let next = 0;
+  const worker = async () => {
+    while (next < items.length) {
+      const i = next++;
+      results[i] = await fn(items[i]);
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+  return results;
+}
+
 // src/commands/doctor/report.ts
 import { readFile as readFile9 } from "fs/promises";
 import { join as join15 } from "path";
@@ -4817,18 +4967,93 @@ async function fetchLatestVersion2(packageName) {
 }
 
 // src/commands/doctor/render.ts
+import pc17 from "picocolors";
+
+// src/commands/doctor/renderPortal.ts
 import pc16 from "picocolors";
+var MARKERS = {
+  error: pc16.red("\u2717"),
+  warn: pc16.yellow("!"),
+  info: pc16.dim("\xB7")
+};
+function clean(s) {
+  return (s ?? "").replace(/\t/g, " ").replace(/[\p{Cc}\p{Cf}\p{Co}\p{Cs}\p{Zl}\p{Zp}\p{Variation_Selector}\u00ad\u180e]/gu, "");
+}
+function marker(severity) {
+  return MARKERS[severity] ?? pc16.dim("\xB7");
+}
+function portalNeedsWork(p5) {
+  return p5 !== void 0 && (p5.status === "error" || portalHasErrorFinding(p5));
+}
+function hintSuffix(reason, hint) {
+  return hint && !(reason ?? "").includes(hint) ? ` (\uD560 \uC77C: ${hint})` : "";
+}
+function formatFinding(f) {
+  const lines = [`    ${marker(f.severity)} ${clean(f.title)} ${pc16.dim(`[${clean(f.id)}]`)}`];
+  if (f.detail) lines.push(pc16.dim(`      ${clean(f.detail)}`));
+  if (f.fix) lines.push(pc16.dim(`      \uC870\uCE58: ${clean(f.fix)}`));
+  return lines;
+}
+function formatPlacement(row) {
+  const label = clean(row.path || row.slotId || row.placementId);
+  const lines = [`  ${pc16.bold(label)}`];
+  if (row.error !== void 0) {
+    lines.push(`    ${pc16.red("\u2717")} \uC9C4\uB2E8\uC744 \uBC1B\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4 \u2014 ${clean(row.error)}`);
+  } else if (row.findings.length === 0) {
+    lines.push(`    ${pc16.green("\u2713")} \uBB38\uC81C \uC5C6\uC74C`);
+  } else {
+    lines.push(...row.findings.flatMap(formatFinding));
+  }
+  return lines;
+}
+function formatPortal(p5) {
+  const lines = [pc16.bold("\uD3EC\uD138 \uC9C4\uB2E8")];
+  if (p5.status === "skipped") {
+    lines.push(
+      pc16.dim(
+        `  \uAC74\uB108\uB700 \u2014 ${clean(p5.reason) || "\uB85C\uADF8\uC778\xB7\uB9C1\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."}${hintSuffix(p5.reason, p5.hint)}`
+      )
+    );
+  } else if (p5.status === "unsupported") {
+    lines.push(
+      pc16.dim(`  \uAC74\uB108\uB700 \u2014 ${clean(p5.reason) || "\uD3EC\uD138 \uC11C\uBC84\uAC00 \uC544\uC9C1 \uC9C4\uB2E8\uC744 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4."}`)
+    );
+  } else if (p5.placements.length === 0) {
+    lines.push(
+      p5.status === "error" ? pc16.red(`  \u2717 ${clean(p5.reason) || "\uD3EC\uD138 \uC9C4\uB2E8\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4."}`) : pc16.dim(
+        `  ${clean(p5.reason) || "\uC9C4\uB2E8\uD560 \uBC30\uCE58\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."}${hintSuffix(p5.reason, p5.hint)}`
+      )
+    );
+  } else {
+    lines.push(...p5.placements.flatMap(formatPlacement));
+  }
+  if (p5.omitted) {
+    lines.push(
+      pc16.dim(
+        `  (\uBC30\uCE58\uAC00 \uB9CE\uC544 ${p5.omitted}\uAC1C\uB294 \uC9C4\uB2E8\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2014 bstage doctor --placement <\uACBD\uB85C|\uC2AC\uB86F id>\uB85C \uB530\uB85C \uBCF4\uC138\uC694.)`
+      )
+    );
+  }
+  return lines;
+}
+function printPortal(p5) {
+  if (!p5) return;
+  for (const line of formatPortal(p5)) console.log(line);
+  console.log("");
+}
+
+// src/commands/doctor/render.ts
 function printVersions(r) {
-  console.log(pc16.bold("\u{1F4E6} SDK \uBC84\uC804"));
+  console.log(pc17.bold("\u{1F4E6} SDK \uBC84\uC804"));
   if (!r.latestChecked) {
-    console.log(pc16.dim("  \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC870\uD68C\uB97C \uAC74\uB108\uB6F0\uC5B4 \uC124\uCE58 \uBC84\uC804\uB9CC \uD45C\uC2DC\uD569\uB2C8\uB2E4."));
+    console.log(pc17.dim("  \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC870\uD68C\uB97C \uAC74\uB108\uB6F0\uC5B4 \uC124\uCE58 \uBC84\uC804\uB9CC \uD45C\uC2DC\uD569\uB2C8\uB2E4."));
   }
   const nameWidth = Math.max(12, ...r.versions.map((v) => v.pkg.replace("@bstage-sdk/", "").length));
   for (const v of r.versions) {
     const name = v.pkg.replace("@bstage-sdk/", "").padEnd(nameWidth);
     const inst = v.installed ?? "?";
     if (v.latest && v.installed) {
-      const arrow = v.outdated ? pc16.yellow(`\u2192  ${v.latest}  (\uB4A4\uCC98\uC9D0)`) : pc16.green("(\uCD5C\uC2E0)");
+      const arrow = v.outdated ? pc17.yellow(`\u2192  ${v.latest}  (\uB4A4\uCC98\uC9D0)`) : pc17.green("(\uCD5C\uC2E0)");
       console.log(`  ${name} ${inst.padEnd(8)} ${arrow}`);
     } else {
       console.log(`  ${name} ${inst}`);
@@ -4837,89 +5062,89 @@ function printVersions(r) {
   console.log("");
 }
 function printFiles(r) {
-  console.log(pc16.bold("\u{1F4C1} init \uAE30\uBCF8 \uD30C\uC77C (\uCC38\uACE0)"));
+  console.log(pc17.bold("\u{1F4C1} init \uAE30\uBCF8 \uD30C\uC77C (\uCC38\uACE0)"));
   const absent = r.files.filter((f) => !f.present);
   if (absent.length === 0) {
-    console.log(pc16.green("  \u2713 init \uAE30\uBCF8 \uAD6C\uC131\uACFC \uB3D9\uC77C"));
+    console.log(pc17.green("  \u2713 init \uAE30\uBCF8 \uAD6C\uC131\uACFC \uB3D9\uC77C"));
   } else {
-    console.log(pc16.dim("  init \uAE30\uBCF8\uAC12\uACFC\uC758 \uCC28\uC774\uC77C \uBFD0 \u2014 \uD504\uB85C\uC81D\uD2B8\uAC00 \uB2E4\uB974\uAC8C \uCC98\uB9AC \uC911\uC774\uBA74 \uBB34\uC2DC\uD558\uC138\uC694."));
+    console.log(pc17.dim("  init \uAE30\uBCF8\uAC12\uACFC\uC758 \uCC28\uC774\uC77C \uBFD0 \u2014 \uD504\uB85C\uC81D\uD2B8\uAC00 \uB2E4\uB974\uAC8C \uCC98\uB9AC \uC911\uC774\uBA74 \uBB34\uC2DC\uD558\uC138\uC694."));
     for (const f of r.files) {
-      if (f.present) console.log(`  ${pc16.green("\u2713")} ${f.path}`);
-      else console.log(`  ${pc16.dim("\xB7")} ${f.path.padEnd(20)} ${pc16.dim(`\uC5C6\uC74C (${f.note})`)}`);
+      if (f.present) console.log(`  ${pc17.green("\u2713")} ${f.path}`);
+      else console.log(`  ${pc17.dim("\xB7")} ${f.path.padEnd(20)} ${pc17.dim(`\uC5C6\uC74C (${f.note})`)}`);
     }
   }
   console.log("");
 }
 function printLayout(r) {
-  console.log(pc16.bold("\u{1F5C2}  \uD15C\uD50C\uB9BF \uB514\uB809\uD1A0\uB9AC"));
+  console.log(pc17.bold("\u{1F5C2}  \uD15C\uD50C\uB9BF \uB514\uB809\uD1A0\uB9AC"));
   if (r.layout.legacyPresent) {
-    console.log(`  ${pc16.yellow("\u2192")} ${pc16.yellow("src/templates/ \uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 (\uC61B \uAD6C\uC870)")}`);
-    console.log(pc16.dim("      \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C \uACBD\uB85C\uAC00 \uD3F4\uB354 \uAD6C\uC870\uB97C \uB530\uB77C\uAC00\uB3C4\uB85D \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4."));
-    console.log(pc16.dim("      \uD398\uC774\uC9C0 \u2192 src/pages/{\uACBD\uB85C}/  \xB7  \uC704\uC82F \u2192 src/slots/{\uC544\uBB34\uC774\uB984}/"));
+    console.log(`  ${pc17.yellow("\u2192")} ${pc17.yellow("src/templates/ \uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 (\uC61B \uAD6C\uC870)")}`);
+    console.log(pc17.dim("      \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C \uACBD\uB85C\uAC00 \uD3F4\uB354 \uAD6C\uC870\uB97C \uB530\uB77C\uAC00\uB3C4\uB85D \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4."));
+    console.log(pc17.dim("      \uD398\uC774\uC9C0 \u2192 src/pages/{\uACBD\uB85C}/  \xB7  \uC704\uC82F \u2192 src/slots/{\uC544\uBB34\uC774\uB984}/"));
     if (r.layout.legacyTemplates.length > 0) {
-      console.log(pc16.dim(`      \uC62E\uACA8\uC57C \uD560 \uD15C\uD50C\uB9BF: ${r.layout.legacyTemplates.join(", ")}`));
+      console.log(pc17.dim(`      \uC62E\uACA8\uC57C \uD560 \uD15C\uD50C\uB9BF: ${r.layout.legacyTemplates.join(", ")}`));
     }
-    console.log(pc16.dim('      \uBCC0\uD658: \uC5D0\uC774\uC804\uD2B8\uC5D0\uAC8C "bstage \uB9C8\uC774\uADF8\uB808\uC774\uC158" \uC694\uCCAD'));
+    console.log(pc17.dim('      \uBCC0\uD658: \uC5D0\uC774\uC804\uD2B8\uC5D0\uAC8C "bstage \uB9C8\uC774\uADF8\uB808\uC774\uC158" \uC694\uCCAD'));
   } else if (!r.layout.pagesPresent && !r.layout.slotsPresent) {
-    console.log(`  ${pc16.dim("\xB7")} src/pages/ \xB7 src/slots/ \uB458 \uB2E4 \uC5C6\uC74C`);
+    console.log(`  ${pc17.dim("\xB7")} src/pages/ \xB7 src/slots/ \uB458 \uB2E4 \uC5C6\uC74C`);
   } else {
-    console.log(pc16.green("  \u2713 src/pages/ \xB7 src/slots/ \uAD6C\uC870"));
+    console.log(pc17.green("  \u2713 src/pages/ \xB7 src/slots/ \uAD6C\uC870"));
   }
   console.log("");
 }
 function printPnpmWorkspace(r) {
   if (!r.pnpmWorkspace.relevant) return;
-  console.log(pc16.bold("\u{1F4E6} pnpm workspace \uC124\uC815"));
+  console.log(pc17.bold("\u{1F4E6} pnpm workspace \uC124\uC815"));
   if (r.pnpmWorkspace.allowBuildsDeclared) {
-    console.log(pc16.green("  \u2713 pnpm-workspace.yaml\uC5D0 allowBuilds \uC120\uC5B8\uB428"));
+    console.log(pc17.green("  \u2713 pnpm-workspace.yaml\uC5D0 allowBuilds \uC120\uC5B8\uB428"));
   } else {
-    console.log(`  ${pc16.yellow("\u2192")} ${pc16.yellow("pnpm-workspace.yaml\uC5D0 allowBuilds \uC5C6\uC74C")}`);
+    console.log(`  ${pc17.yellow("\u2192")} ${pc17.yellow("pnpm-workspace.yaml\uC5D0 allowBuilds \uC5C6\uC74C")}`);
     console.log(
-      pc16.dim("      pnpm\uC740 \uC758\uC874\uC131 build script\uB97C \uAE30\uBCF8 \uCC28\uB2E8\uD558\uACE0, pnpm 11\uC740 \uADF8\uAC83\uC744 \uC5D0\uB7EC\uB85C \uB0B8\uB2E4")
+      pc17.dim("      pnpm\uC740 \uC758\uC874\uC131 build script\uB97C \uAE30\uBCF8 \uCC28\uB2E8\uD558\uACE0, pnpm 11\uC740 \uADF8\uAC83\uC744 \uC5D0\uB7EC\uB85C \uB0B8\uB2E4")
     );
     console.log(
-      pc16.dim("      \u2192 `pnpm install`\uC774 ERR_PNPM_IGNORED_BUILDS\uB85C \uC2E4\uD328\uD558\uACE0 `pnpm dev`\uB3C4 \uC8FD\uB294\uB2E4")
+      pc17.dim("      \u2192 `pnpm install`\uC774 ERR_PNPM_IGNORED_BUILDS\uB85C \uC2E4\uD328\uD558\uACE0 `pnpm dev`\uB3C4 \uC8FD\uB294\uB2E4")
     );
-    console.log(pc16.dim("      \uCD94\uAC00: pnpm-workspace.yaml\uC5D0 `allowBuilds:` + `esbuild: true`"));
-    console.log(pc16.dim("      \uB610\uB294 `pnpm approve-builds`\uB85C \uB300\uD654\uC2DD \uC120\uD0DD"));
+    console.log(pc17.dim("      \uCD94\uAC00: pnpm-workspace.yaml\uC5D0 `allowBuilds:` + `esbuild: true`"));
+    console.log(pc17.dim("      \uB610\uB294 `pnpm approve-builds`\uB85C \uB300\uD654\uC2DD \uC120\uD0DD"));
   }
   if (r.pnpmWorkspace.filePresent && !r.pnpmWorkspace.packagesDeclared) {
-    console.log(`  ${pc16.yellow("\u2192")} ${pc16.yellow("pnpm-workspace.yaml\uC5D0 packages \uC5C6\uC74C")}`);
-    console.log(pc16.dim("      pnpm 9\uB294 \uC774 \uD30C\uC77C\uC774 \uC788\uC73C\uBA74 workspace \uB8E8\uD2B8\uB85C \uBCF4\uACE0 packages\uB97C \uC694\uAD6C\uD55C\uB2E4"));
-    console.log(pc16.dim("      \u2192 pnpm 9\uC5D0\uC11C `ERROR packages field missing or empty`\uB85C \uC8FD\uB294\uB2E4"));
-    console.log(pc16.dim("      \uCD94\uAC00: pnpm-workspace.yaml \uB9E8 \uC704\uC5D0 `packages:` + `- '.'`"));
+    console.log(`  ${pc17.yellow("\u2192")} ${pc17.yellow("pnpm-workspace.yaml\uC5D0 packages \uC5C6\uC74C")}`);
+    console.log(pc17.dim("      pnpm 9\uB294 \uC774 \uD30C\uC77C\uC774 \uC788\uC73C\uBA74 workspace \uB8E8\uD2B8\uB85C \uBCF4\uACE0 packages\uB97C \uC694\uAD6C\uD55C\uB2E4"));
+    console.log(pc17.dim("      \u2192 pnpm 9\uC5D0\uC11C `ERROR packages field missing or empty`\uB85C \uC8FD\uB294\uB2E4"));
+    console.log(pc17.dim("      \uCD94\uAC00: pnpm-workspace.yaml \uB9E8 \uC704\uC5D0 `packages:` + `- '.'`"));
   } else if (r.pnpmWorkspace.packagesDeclared) {
-    console.log(pc16.green("  \u2713 pnpm-workspace.yaml\uC5D0 packages \uC120\uC5B8\uB428"));
+    console.log(pc17.green("  \u2713 pnpm-workspace.yaml\uC5D0 packages \uC120\uC5B8\uB428"));
   }
   console.log("");
 }
 function printScriptRow(sc) {
   if (sc.actual === null) {
-    console.log(`  ${pc16.yellow("\u2192")} ${sc.name} ${pc16.yellow("\uC5C6\uC74C")}`);
+    console.log(`  ${pc17.yellow("\u2192")} ${sc.name} ${pc17.yellow("\uC5C6\uC74C")}`);
   } else {
     console.log(
-      `  ${pc16.yellow("\u2192")} ${sc.name} ${pc16.yellow("\uB2E4\uB984")} ${pc16.dim(`\u2014 \uD604\uC7AC \`${sc.actual}\``)}`
+      `  ${pc17.yellow("\u2192")} ${sc.name} ${pc17.yellow("\uB2E4\uB984")} ${pc17.dim(`\u2014 \uD604\uC7AC \`${sc.actual}\``)}`
     );
     if (sc.actual.includes("--noEmit") && !sc.actual.includes("-p ")) {
       console.log(
-        pc16.dim(
+        pc17.dim(
           "      \uC8FC\uC758: solution-style tsconfig\uC5D0\uC11C `tsc --noEmit`\uC740 \uC544\uBB34 \uD30C\uC77C\uB3C4 \uAC80\uC0AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4."
         )
       );
     }
   }
-  console.log(pc16.dim(`      ${sc.why}`));
-  console.log(pc16.dim(`      \uAD8C\uC7A5: "${sc.name}": "${sc.expected}"`));
+  console.log(pc17.dim(`      ${sc.why}`));
+  console.log(pc17.dim(`      \uAD8C\uC7A5: "${sc.name}": "${sc.expected}"`));
 }
 function printScripts(r) {
-  console.log(pc16.bold("\u{1F6E0}  package.json \uC2A4\uD06C\uB9BD\uD2B8"));
+  console.log(pc17.bold("\u{1F6E0}  package.json \uC2A4\uD06C\uB9BD\uD2B8"));
   const scriptIssues = r.scripts.filter((sc) => sc.actual !== sc.expected);
   if (scriptIssues.length === 0) {
-    console.log(pc16.green("  \u2713 init \uAE30\uBCF8 \uAD6C\uC131\uACFC \uB3D9\uC77C"));
+    console.log(pc17.green("  \u2713 init \uAE30\uBCF8 \uAD6C\uC131\uACFC \uB3D9\uC77C"));
   } else {
     for (const sc of r.scripts) {
       if (sc.actual === sc.expected) {
-        console.log(`  ${pc16.green("\u2713")} ${sc.name}`);
+        console.log(`  ${pc17.green("\u2713")} ${sc.name}`);
         continue;
       }
       printScriptRow(sc);
@@ -4929,76 +5154,76 @@ function printScripts(r) {
 }
 function printLiquid(r) {
   if (r.liquid === null) return;
-  console.log(pc16.bold("\u{1F4A7} liquid \uAC80\uC99D"));
+  console.log(pc17.bold("\u{1F4A7} liquid \uAC80\uC99D"));
   const errors = r.liquid.issues.filter((i) => i.level === "error");
   const warns = r.liquid.issues.filter((i) => i.level === "warn");
   if (errors.length === 0 && warns.length === 0) {
-    console.log(pc16.green("  \u2713 \uADDC\uC57D\xB7\uBB38\uBC95 \uC774\uC0C1 \uC5C6\uC74C"));
+    console.log(pc17.green("  \u2713 \uADDC\uC57D\xB7\uBB38\uBC95 \uC774\uC0C1 \uC5C6\uC74C"));
   }
-  for (const i of errors) console.log(`  ${pc16.red("\u2717")} ${i.path}  ${pc16.red(i.message)}`);
-  for (const i of warns) console.log(`  ${pc16.yellow("\u26A0")} ${i.path}  ${pc16.dim(i.message)}`);
+  for (const i of errors) console.log(`  ${pc17.red("\u2717")} ${i.path}  ${pc17.red(i.message)}`);
+  for (const i of warns) console.log(`  ${pc17.yellow("\u26A0")} ${i.path}  ${pc17.dim(i.message)}`);
   if (errors.length > 0) {
     console.log(
-      pc16.dim("      \uACE0\uCE5C \uB4A4 `bstage build`\uB85C \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694 \u2014 \uD3EC\uD138 \uBE4C\uB4DC\uB3C4 \uAC19\uC740 \uAC80\uC0AC\uB97C \uD569\uB2C8\uB2E4.")
+      pc17.dim("      \uACE0\uCE5C \uB4A4 `bstage build`\uB85C \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694 \u2014 \uD3EC\uD138 \uBE4C\uB4DC\uB3C4 \uAC19\uC740 \uAC80\uC0AC\uB97C \uD569\uB2C8\uB2E4.")
     );
   }
   console.log("");
 }
 function printRecommendedDeps(r) {
   if (r.recommendedDeps.length === 0) return;
-  console.log(pc16.bold("\u{1F9F1} \uAD8C\uC7A5 \uC758\uC874\uC131"));
+  console.log(pc17.bold("\u{1F9F1} \uAD8C\uC7A5 \uC758\uC874\uC131"));
   if (r.recommendedDeps.every((d) => d.declared)) {
-    console.log(pc16.green("  \u2713 \uBAA8\uB450 \uC120\uC5B8\uB428"));
+    console.log(pc17.green("  \u2713 \uBAA8\uB450 \uC120\uC5B8\uB428"));
   } else {
     for (const d of r.recommendedDeps) {
       if (d.declared) {
-        console.log(`  ${pc16.green("\u2713")} ${d.pkg}`);
+        console.log(`  ${pc17.green("\u2713")} ${d.pkg}`);
         continue;
       }
-      console.log(`  ${pc16.yellow("\u2192")} ${d.pkg} ${pc16.yellow("\uBBF8\uC120\uC5B8")} ${pc16.dim(`\u2014 ${d.note}`)}`);
-      console.log(pc16.dim(`      ${d.why}`));
-      console.log(pc16.dim(`      \uCD94\uAC00: npm i ${d.pkg} (\uD504\uB85C\uC81D\uD2B8 \uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800\uB85C)`));
+      console.log(`  ${pc17.yellow("\u2192")} ${d.pkg} ${pc17.yellow("\uBBF8\uC120\uC5B8")} ${pc17.dim(`\u2014 ${d.note}`)}`);
+      console.log(pc17.dim(`      ${d.why}`));
+      console.log(pc17.dim(`      \uCD94\uAC00: npm i ${d.pkg} (\uD504\uB85C\uC81D\uD2B8 \uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800\uB85C)`));
     }
   }
   console.log("");
 }
 function printMigrations(r) {
-  console.log(pc16.bold("\u{1F4D6} \uC801\uC6A9 \uAC00\uB2A5\uD55C \uB9C8\uC774\uADF8\uB808\uC774\uC158"));
+  console.log(pc17.bold("\u{1F4D6} \uC801\uC6A9 \uAC00\uB2A5\uD55C \uB9C8\uC774\uADF8\uB808\uC774\uC158"));
   if (r.migrations.length === 0) {
-    console.log(pc16.dim("  \uD574\uB2F9 \uD56D\uBAA9 \uC5C6\uC74C."));
+    console.log(pc17.dim("  \uD574\uB2F9 \uD56D\uBAA9 \uC5C6\uC74C."));
   } else {
     for (const m of r.migrations) {
-      console.log(`  ${pc16.cyan(`\u2192 ${m.label}`)}`);
+      console.log(`  ${pc17.cyan(`\u2192 ${m.label}`)}`);
       for (const item of m.items) console.log(`    \u2022 ${item}`);
     }
   }
   console.log("");
 }
 function printAgentsMd(r) {
-  console.log(pc16.bold("\u{1F4DD} AGENTS.md"));
+  console.log(pc17.bold("\u{1F4DD} AGENTS.md"));
   switch (r.agentsMd.status) {
     case "ok":
-      console.log(pc16.green("  \u2713 \uAD00\uB9AC \uC601\uC5ED \uCD5C\uC2E0"));
+      console.log(pc17.green("  \u2713 \uAD00\uB9AC \uC601\uC5ED \uCD5C\uC2E0"));
       break;
     case "missing":
-      console.log(pc16.dim("  \xB7 \uD30C\uC77C \uC5C6\uC74C \u2014 bstage \uD504\uB85C\uC81D\uD2B8\uB77C\uBA74 init/\uB9C8\uC774\uADF8\uB808\uC774\uC158\uC73C\uB85C \uC0DD\uC131\uD558\uC138\uC694."));
+      console.log(pc17.dim("  \xB7 \uD30C\uC77C \uC5C6\uC74C \u2014 bstage \uD504\uB85C\uC81D\uD2B8\uB77C\uBA74 init/\uB9C8\uC774\uADF8\uB808\uC774\uC158\uC73C\uB85C \uC0DD\uC131\uD558\uC138\uC694."));
       break;
     case "stale":
       if (r.agentsMd.downgrade) {
         console.log(
-          pc16.yellow("  ! \uAD00\uB9AC \uC601\uC5ED\uC774 \uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804") + pc16.dim(
+          pc17.yellow("  ! \uAD00\uB9AC \uC601\uC5ED\uC774 \uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804") + pc17.dim(
             " \u2014 \uC774 CLI\uAC00 \uC624\uB798\uB3FC \uAC31\uC2E0\uD558\uBA74 \uC61B \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uC544\uAC11\uB2C8\uB2E4(\uD558\uD5A5). \uCD5C\uC2E0 CLI(npx @bstage-sdk/cli@latest)\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694."
           )
         );
         break;
       }
       console.log(
-        pc16.yellow("  \u2192 \uAD00\uB9AC \uC601\uC5ED\uC774 \uC624\uB798\uB428") + pc16.dim(" \u2014 `bstage ai update`\uB85C \uAC31\uC2E0(\uC790\uC720 \uC601\uC5ED\uC740 \uBCF4\uC874).")
+        pc17.yellow("  \u2192 \uAD00\uB9AC \uC601\uC5ED\uC774 \uC624\uB798\uB428") + pc17.dim(" \u2014 `bstage ai update`\uB85C \uAC31\uC2E0(\uC790\uC720 \uC601\uC5ED\uC740 \uBCF4\uC874).")
       );
       break;
     case "legacy":
       console.log(
-        pc16.yellow("  \u2192 \uB808\uAC70\uC2DC \uD3EC\uB9F7(\uAD00\uB9AC \uC601\uC5ED \uB9C8\uCEE4 \uC5C6\uC74C)") + pc16.dim(
+        pc17.yellow("  \u2192 \uB808\uAC70\uC2DC \uD3EC\uB9F7(\uAD00\uB9AC \uC601\uC5ED \uB9C8\uCEE4 \uC5C6\uC74C)") + pc17.dim(
           " \u2014 `bstage ai install`\uB85C \uC2A4\uD0AC\uC744 \uBA3C\uC800 \uC124\uCE58\uD55C \uB4A4, `bstage-migrate` \uC2A4\uD0AC\uB85C reconcile(SDK \uC601\uC5ED \uAD50\uCCB4 + \uC0AC\uC6A9\uC790 \uB0B4\uC6A9 \uBCF4\uC874)."
         )
       );
@@ -5007,29 +5232,29 @@ function printAgentsMd(r) {
   console.log("");
 }
 function printSkills(r) {
-  console.log(pc16.bold("\u{1F9E9} \uC5D0\uC774\uC804\uD2B8 \uC2A4\uD0AC (.claude/skills/)"));
+  console.log(pc17.bold("\u{1F9E9} \uC5D0\uC774\uC804\uD2B8 \uC2A4\uD0AC (.claude/skills/)"));
   const skillsNeedWork = r.skills.filter((s) => s.status !== "ok");
   if (r.skillsSkipped) {
     console.log(
-      pc16.yellow("  ! sdk\uC640 liquid\uAC00 \uC11E\uC5EC \uC788\uC5B4 \uC2A4\uD0AC \uAC80\uC0AC\uB97C \uAC74\uB108\uB701\uB2C8\uB2E4 \u2014 \uD558\uB098\uB9CC \uB0A8\uACA8 \uC8FC\uC138\uC694.")
+      pc17.yellow("  ! sdk\uC640 liquid\uAC00 \uC11E\uC5EC \uC788\uC5B4 \uC2A4\uD0AC \uAC80\uC0AC\uB97C \uAC74\uB108\uB701\uB2C8\uB2E4 \u2014 \uD558\uB098\uB9CC \uB0A8\uACA8 \uC8FC\uC138\uC694.")
     );
   } else if (skillsNeedWork.length === 0) {
-    console.log(pc16.green("  \u2713 \uBAA8\uB4E0 \uC2A4\uD0AC \uCD5C\uC2E0"));
+    console.log(pc17.green("  \u2713 \uBAA8\uB4E0 \uC2A4\uD0AC \uCD5C\uC2E0"));
   } else {
     for (const s of r.skills) {
-      if (s.status === "ok") console.log(`  ${pc16.green("\u2713")} ${s.name}`);
+      if (s.status === "ok") console.log(`  ${pc17.green("\u2713")} ${s.name}`);
       else if (s.status === "missing")
-        console.log(`  ${pc16.yellow("\u2192")} ${s.name.padEnd(16)} ${pc16.yellow("\uBBF8\uC124\uCE58")}`);
+        console.log(`  ${pc17.yellow("\u2192")} ${s.name.padEnd(16)} ${pc17.yellow("\uBBF8\uC124\uCE58")}`);
       else if (s.status === "newer")
         console.log(
-          `  ${pc16.yellow("!")} ${s.name.padEnd(16)} ${pc16.yellow("\uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804")}` + pc16.dim(
+          `  ${pc17.yellow("!")} ${s.name.padEnd(16)} ${pc17.yellow("\uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804")}` + pc17.dim(
             " \u2014 \uC774 CLI\uAC00 \uC624\uB798\uB3FC \uC61B \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uB9BD\uB2C8\uB2E4(\uD558\uD5A5). \uCD5C\uC2E0 CLI(npx @bstage-sdk/cli@latest)\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694."
           )
         );
-      else console.log(`  ${pc16.yellow("\u2192")} ${s.name.padEnd(16)} ${pc16.yellow("\uAD6C\uBC84\uC804/\uC218\uC815\uB428")}`);
+      else console.log(`  ${pc17.yellow("\u2192")} ${s.name.padEnd(16)} ${pc17.yellow("\uAD6C\uBC84\uC804/\uC218\uC815\uB428")}`);
     }
     console.log(
-      pc16.dim(
+      pc17.dim(
         "  \uC544\uB798\uC5D0\uC11C \uC790\uB3D9 \uB3D9\uAE30\uD654\uD569\uB2C8\uB2E4 \u2014 bstage-* \uC2A4\uD0AC\uB9CC \uB36E\uC5B4\uC4F0\uBA70, \uADF8 \uC678 \uC0AC\uC6A9\uC790 \uC2A4\uD0AC\uC740 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4."
       )
     );
@@ -5039,36 +5264,43 @@ function printSkills(r) {
 function printNextSteps(r) {
   const agentsNeedsWork = r.agentsMd.status === "legacy" || r.agentsMd.status === "stale";
   const liquidBroken = (r.liquid?.issues ?? []).some((i) => i.level === "error");
-  const hasWork = r.versions.some((v) => v.outdated) || r.migrations.length > 0 || agentsNeedsWork || liquidBroken;
+  const portalBroken = portalNeedsWork(r.portal);
+  const migrationWork = r.versions.some((v) => v.outdated) || r.migrations.length > 0 || agentsNeedsWork || liquidBroken;
+  const hasWork = migrationWork || portalBroken;
+  if (portalBroken) {
+    console.log(pc17.yellow("\uC704 \uD3EC\uD138 \uC9C4\uB2E8 \uD56D\uBAA9\uC744 \uBA3C\uC800 \uD574\uACB0\uD558\uC138\uC694 \u2014 \uAC01 \uD56D\uBAA9\uC758 \uC870\uCE58\uB97C \uB530\uB974\uBA74 \uB429\uB2C8\uB2E4."));
+  }
   if (liquidBroken) {
     console.log(
-      pc16.yellow("\uC704 liquid \uAC80\uC99D \uC624\uB958\uB97C \uBA3C\uC800 \uACE0\uCE58\uC138\uC694 \u2014 \uADF8\uB300\uB85C push\uD558\uBA74 \uD3EC\uD138 \uBE4C\uB4DC\uAC00 \uB9C9\uD799\uB2C8\uB2E4.")
+      pc17.yellow("\uC704 liquid \uAC80\uC99D \uC624\uB958\uB97C \uBA3C\uC800 \uACE0\uCE58\uC138\uC694 \u2014 \uADF8\uB300\uB85C push\uD558\uBA74 \uD3EC\uD138 \uBE4C\uB4DC\uAC00 \uB9C9\uD799\uB2C8\uB2E4.")
     );
   }
-  if (hasWork) {
+  if (migrationWork) {
     console.log(
-      pc16.dim(
+      pc17.dim(
         "\uB2E4\uC74C \uB2E8\uACC4: \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC2A4\uD0AC\uC744 \uC2E4\uD589\uD574 \uC704 \uD56D\uBAA9\uC744 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uB9DE\uCDB0 \uC801\uC6A9\uD558\uC138\uC694.\n  \uC0C1\uC138 \uAC00\uC774\uB4DC: SDK \uBB38\uC11C\uC758 MIGRATION.md (\uC704 \uD56D\uBAA9\uBCC4 \uC801\uC6A9 \uC808\uCC28)"
       )
     );
-  } else {
-    console.log(pc16.green("\u2713 \uCD5C\uC2E0 \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uB9C8\uC774\uADF8\uB808\uC774\uC158\uC774 \uD544\uC694 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  } else if (!hasWork) {
+    console.log(pc17.green("\u2713 \uCD5C\uC2E0 \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uB9C8\uC774\uADF8\uB808\uC774\uC158\uC774 \uD544\uC694 \uC5C6\uC2B5\uB2C8\uB2E4."));
     if (r.files.some((f) => !f.present)) {
-      console.log(pc16.dim("  (\uC704 init \uAE30\uBCF8 \uD30C\uC77C \uCC28\uC774\uB294 \uC120\uD0DD \uC0AC\uD56D\uC785\uB2C8\uB2E4.)"));
+      console.log(pc17.dim("  (\uC704 init \uAE30\uBCF8 \uD30C\uC77C \uCC28\uC774\uB294 \uC120\uD0DD \uC0AC\uD56D\uC785\uB2C8\uB2E4.)"));
     }
     if (r.recommendedDeps.some((d) => !d.declared)) {
-      console.log(pc16.dim("  (\uC704 \uAD8C\uC7A5 \uC758\uC874\uC131\uC740 \uBC84\uC804\uACFC \uBB34\uAD00\uD569\uB2C8\uB2E4 \u2014 \uC4F8 \uAC70\uBA74 \uB530\uB85C \uCD94\uAC00\uD558\uC138\uC694.)"));
+      console.log(pc17.dim("  (\uC704 \uAD8C\uC7A5 \uC758\uC874\uC131\uC740 \uBC84\uC804\uACFC \uBB34\uAD00\uD569\uB2C8\uB2E4 \u2014 \uC4F8 \uAC70\uBA74 \uB530\uB85C \uCD94\uAC00\uD558\uC138\uC694.)"));
     }
   }
   console.log("");
 }
 function printReport(r) {
   console.log("");
-  console.log(`${pc16.cyan(pc16.bold("bstage doctor"))} ${pc16.dim(`\u2014 ${r.project ?? "(\uC774\uB984 \uC5C6\uC74C)"}`)}`);
+  console.log(`${pc17.cyan(pc17.bold("bstage doctor"))} ${pc17.dim(`\u2014 ${r.project ?? "(\uC774\uB984 \uC5C6\uC74C)"}`)}`);
   console.log("");
   if (!r.isBstageProject) {
-    console.log(pc16.yellow("\uC774 \uB514\uB809\uD1A0\uB9AC\uB294 bstage \uD15C\uD50C\uB9BF \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2CC \uAC83 \uAC19\uC2B5\uB2C8\uB2E4."));
-    console.log(pc16.dim("  package.json\uC5D0 @bstage-sdk/* \uC758\uC874\uC131\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(pc17.yellow("\uC774 \uB514\uB809\uD1A0\uB9AC\uB294 bstage \uD15C\uD50C\uB9BF \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2CC \uAC83 \uAC19\uC2B5\uB2C8\uB2E4."));
+    console.log(pc17.dim("  package.json\uC5D0 @bstage-sdk/* \uC758\uC874\uC131\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log("");
+    printPortal(r.portal);
     return;
   }
   printVersions(r);
@@ -5081,15 +5313,24 @@ function printReport(r) {
   printMigrations(r);
   printAgentsMd(r);
   printSkills(r);
+  printPortal(r.portal);
   printNextSteps(r);
 }
 
 // src/commands/doctor.ts
-async function doctorCommand(options) {
-  const root = process.cwd();
-  const report2 = await diagnose2(root);
+async function doctorCommand(options, deps = {}) {
+  const root = deps.cwd ?? process.cwd();
+  const [local, portal] = await Promise.all([
+    diagnose2(root),
+    diagnosePortal(
+      { placement: options.placement },
+      { cwd: root, env: deps.env, fetch: deps.fetch }
+    )
+  ]);
+  const report2 = { ...local, portal };
+  if (portalHasErrorFinding(portal)) process.exitCode = ExitCode.FAILURE;
   if (options.json) {
-    console.log(JSON.stringify(report2, null, 2));
+    printJson(report2);
     return;
   }
   printReport(report2);
@@ -5098,7 +5339,7 @@ async function doctorCommand(options) {
 
 // src/commands/link.ts
 import * as p4 from "@clack/prompts";
-import pc17 from "picocolors";
+import pc18 from "picocolors";
 var clackSelect = async (message, items) => {
   const options = items.map((i) => ({
     value: i.value,
@@ -5210,15 +5451,15 @@ function printLinked(link, repoLabel, repoFromOrigin, json) {
     return;
   }
   if (repoFromOrigin) {
-    console.log(pc17.dim(`  git origin(${repoLabel})\uACFC \uC77C\uCE58\uD558\uB294 \uB808\uD3EC\uB97C \uAE30\uBCF8\uAC12\uC73C\uB85C \uC120\uD0DD\uD588\uC2B5\uB2C8\uB2E4.`));
+    console.log(pc18.dim(`  git origin(${repoLabel})\uACFC \uC77C\uCE58\uD558\uB294 \uB808\uD3EC\uB97C \uAE30\uBCF8\uAC12\uC73C\uB85C \uC120\uD0DD\uD588\uC2B5\uB2C8\uB2E4.`));
   }
   console.log(
-    pc17.green(
+    pc18.green(
       `\u2713 \uC5F0\uACB0\uD588\uC2B5\uB2C8\uB2E4: ${link.organizationId} / ${link.spaceId} / ${repoLabel} [${link.surface}]`
     )
   );
   console.log(
-    pc17.dim(
+    pc18.dim(
       "  .bstage/project.json \uC5D0 \uC800\uC7A5 (gitignore \uB300\uC0C1). CI\uC5D0\uC11C\uB294 BSTAGE_ORG\xB7BSTAGE_SPACE\xB7BSTAGE_REPO\xB7BSTAGE_SURFACE\xB7BSTAGE_PORTAL_URL \uD658\uACBD\uBCC0\uC218\uB97C \uC4F0\uC138\uC694."
     )
   );
@@ -5273,7 +5514,7 @@ async function linkCommand(options, deps = {}) {
 }
 
 // src/commands/list.ts
-import pc18 from "picocolors";
+import pc19 from "picocolors";
 
 // src/portal/buildRepo.ts
 function buildMatchesRepo(b, repo) {
@@ -5305,10 +5546,10 @@ function artifactKinds(build) {
 function renderList(placements, builds, repo) {
   const mine = placements.filter((p5) => p5.stageRepoId === repo.id);
   const lines = [];
-  lines.push(pc18.bold("\uBC30\uCE58"));
+  lines.push(pc19.bold("\uBC30\uCE58"));
   if (mine.length === 0) {
     lines.push(
-      pc18.yellow(
+      pc19.yellow(
         "  \uC774 \uB808\uD3EC\uC5D0 \uC5F0\uACB0\uB41C \uBC30\uCE58\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. bstage placement create \uB85C \uD398\uC774\uC9C0 \uBC30\uCE58\uB97C \uBA3C\uC800 \uB9CC\uB4DC\uC138\uC694."
       )
     );
@@ -5327,10 +5568,10 @@ function renderList(placements, builds, repo) {
     );
   }
   lines.push("");
-  lines.push(pc18.bold("\uCD5C\uADFC \uBE4C\uB4DC"));
+  lines.push(pc19.bold("\uCD5C\uADFC \uBE4C\uB4DC"));
   const recent = builds.filter((b) => buildMatchesRepo(b, repo));
   lines.push(
-    recent.length === 0 ? pc18.dim("  \uBE4C\uB4DC \uC774\uB825\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.") : table([
+    recent.length === 0 ? pc19.dim("  \uBE4C\uB4DC \uC774\uB825\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.") : table([
       ["\uBE4C\uB4DC", "\uC0C1\uD0DC", "\uC885\uB958", "\uCEE4\uBC0B", "\uC694\uCCAD \uC2DC\uAC01"],
       ...recent.map((b) => [
         b.id,
@@ -5344,7 +5585,7 @@ function renderList(placements, builds, repo) {
   if (mine.length === 0) {
     lines.push("");
     lines.push(
-      pc18.yellow(
+      pc19.yellow(
         "\uC774 \uB808\uD3EC\uC5D0 \uBC30\uCE58\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uB2E4\uC74C: bstage placement create --template <\uC0B0\uCD9C\uBB3C \uC774\uB984> [--path /\uACBD\uB85C] \u2192 bstage deploy. \uC704\uC82F(\uC2AC\uB86F) \uBC30\uCE58\uB294 \uD3EC\uD138 \uD654\uBA74(\uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0)\uC5D0\uC11C \uB9CC\uB4ED\uB2C8\uB2E4. (bstage-deploy \uC2A4\uD0AC \uCC38\uC870)"
       )
     );
@@ -5370,12 +5611,12 @@ async function listCommand(options, deps = {}) {
     printJson({ link, placements: mine, builds: myBuilds });
     return;
   }
-  out(pc18.dim(`${link.organizationId} / ${link.spaceId} [${link.surface}]`));
+  out(pc19.dim(`${link.organizationId} / ${link.spaceId} [${link.surface}]`));
   out(renderList(placements, builds, repo));
 }
 
 // src/commands/logs.ts
-import pc19 from "picocolors";
+import pc20 from "picocolors";
 function statusLine(build) {
   return `[bstage] \uBE4C\uB4DC ${build.id} \xB7 ${build.status}${build.failureReason ? ` \xB7 ${build.failureReason}` : ""}`;
 }
@@ -5389,7 +5630,7 @@ async function latestBuildId(ctx) {
   return latest.id;
 }
 function logSink(json) {
-  return json ? (delta) => void process.stderr.write(pc19.dim(delta)) : (delta) => void process.stdout.write(delta);
+  return json ? (delta) => void process.stderr.write(pc20.dim(delta)) : (delta) => void process.stdout.write(delta);
 }
 async function logsCommand(buildId, options, deps = {}) {
   const out = deps.out ?? ((s) => void process.stdout.write(s));
@@ -5413,17 +5654,17 @@ async function report(client, org, space, id, build, options, out, following) {
     return;
   }
   if (following) {
-    console.error(pc19.dim(`
+    console.error(pc20.dim(`
 ${statusLine(build)}`));
     return;
   }
   const log3 = await client.getBuildLog(org, space, id);
   out(log3.endsWith("\n") ? log3 : log3 + "\n");
-  console.error(pc19.dim(statusLine(build)));
+  console.error(pc20.dim(statusLine(build)));
 }
 
 // src/commands/placement.ts
-import pc20 from "picocolors";
+import pc21 from "picocolors";
 
 // src/portal/pagePlacement.ts
 function normalizePagePath(raw) {
@@ -5494,7 +5735,7 @@ async function ensureBuildWithArtifact(ctx, repo, template, options, deps) {
   const latest = options.build ? void 0 : latestSucceeded(await ctx.client.listBuilds(org, space, RECENT_BUILDS), repo);
   const found = latest && resolvePageArtifact(latest, template, surface);
   if (latest && found) return { build: latest, artifact: found };
-  if (!options.json) console.error(pc20.dim(`[bstage] ${buildReason(latest, options)}`));
+  if (!options.json) console.error(pc21.dim(`[bstage] ${buildReason(latest, options)}`));
   if (!options.skipGitCheck) await precheckGit(deps, repo.defaultBranch);
   const created = await createAndAnnounceBuild(ctx, options.json);
   const done = await waitForCompletedBuild(ctx, deps, created, options.json);
@@ -5525,9 +5766,9 @@ function reportExisting(owner, resolved, repoId, options, out) {
       return;
     }
     out(
-      `${pc20.green("\u2713")} ${label} \uC5D0 \uC774 \uB808\uD3EC\uC758 '${resolved.artifact.name}' \uBC30\uCE58\uAC00 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4 (${owner.id}).`
+      `${pc21.green("\u2713")} ${label} \uC5D0 \uC774 \uB808\uD3EC\uC758 '${resolved.artifact.name}' \uBC30\uCE58\uAC00 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4 (${owner.id}).`
     );
-    out(pc20.dim(`  \uB2E4\uC74C: ${nextCommand(label)}`));
+    out(pc21.dim(`  \uB2E4\uC74C: ${nextCommand(label)}`));
     return;
   }
   const who = `\uBC30\uCE58 ${owner.id}, \uC0B0\uCD9C\uBB3C ${owner.artifact ?? "-"}${owner.stageRepoId === repoId ? "" : ", \uB2E4\uB978 \uB808\uD3EC"}`;
@@ -5601,9 +5842,9 @@ function reportCreated(created, resolved, options, out) {
     return;
   }
   out(
-    `${pc20.green("\u2713")} \uBC30\uCE58\uB97C \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4: ${label} \u2190 ${resolved.artifact.name} (${created.id}, \uBE4C\uB4DC ${resolved.build.id} \xB7 ${shortSha(resolved.build.commitSha)})`
+    `${pc21.green("\u2713")} \uBC30\uCE58\uB97C \uB9CC\uB4E4\uC5C8\uC2B5\uB2C8\uB2E4: ${label} \u2190 ${resolved.artifact.name} (${created.id}, \uBE4C\uB4DC ${resolved.build.id} \xB7 ${shortSha(resolved.build.commitSha)})`
   );
-  out(pc20.dim(`  \uC544\uC9C1 \uB77C\uC774\uBE0C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uB2E4\uC74C: ${nextCommand(label)}`));
+  out(pc21.dim(`  \uC544\uC9C1 \uB77C\uC774\uBE0C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uB2E4\uC74C: ${nextCommand(label)}`));
 }
 async function placementCreateCommand(options, deps = {}) {
   if (options.json && !options.yes) {
@@ -5656,7 +5897,7 @@ async function placementCreateCommand(options, deps = {}) {
 
 // src/commands/login.ts
 import { hostname as osHostname } from "os";
-import pc21 from "picocolors";
+import pc22 from "picocolors";
 
 // src/portal/openBrowser.ts
 import { execFile as execFile2 } from "child_process";
@@ -5724,7 +5965,7 @@ async function loginWithToken(portalUrl, token, options, deps, env2) {
     return;
   }
   console.log(
-    pc21.green(`\u2713 ${portalUrl} \uC5D0 ${me.user.email} \uB85C \uB85C\uADF8\uC778\uD588\uC2B5\uB2C8\uB2E4 (\uC870\uC9C1 ${organizationId}).`)
+    pc22.green(`\u2713 ${portalUrl} \uC5D0 ${me.user.email} \uB85C \uB85C\uADF8\uC778\uD588\uC2B5\uB2C8\uB2E4 (\uC870\uC9C1 ${organizationId}).`)
   );
 }
 function nextIntervalOnSlowDown(interval, retryAfterSec) {
@@ -5735,11 +5976,11 @@ function printDeviceCodePrompt(userCode, verificationUriComplete, expiresIn) {
   console.log("");
   console.log(`  \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC544\uB798 \uCF54\uB4DC\uB97C \uD655\uC778\uD558\uACE0 \uC2B9\uC778\uD558\uC138\uC694.`);
   console.log("");
-  console.log(`    \uCF54\uB4DC  ${pc21.bold(userCode)}`);
-  console.log(`    \uC8FC\uC18C  ${pc21.underline(verificationUriComplete)}`);
+  console.log(`    \uCF54\uB4DC  ${pc22.bold(userCode)}`);
+  console.log(`    \uC8FC\uC18C  ${pc22.underline(verificationUriComplete)}`);
   console.log("");
   console.log(
-    pc21.dim(
+    pc22.dim(
       `  \uD130\uBBF8\uB110\uC758 \uCF54\uB4DC\uC640 \uBE0C\uB77C\uC6B0\uC800\uC758 \uCF54\uB4DC\uAC00 \uAC19\uC740\uC9C0 \uAF2D \uD655\uC778\uD558\uC138\uC694. ${Math.round(expiresIn / 60)}\uBD84 \uC548\uC5D0 \uC2B9\uC778\uB418\uC9C0 \uC54A\uC73C\uBA74 \uB9CC\uB8CC\uB429\uB2C8\uB2E4.`
     )
   );
@@ -5780,7 +6021,7 @@ async function openVerificationUri(portalUrl, verificationUriComplete, options,
   if (!sameOrigin(portalUrl, verificationUriComplete)) {
     if (!options.json) {
       console.log(
-        pc21.yellow(
+        pc22.yellow(
           "  \uC2B9\uC778 \uC8FC\uC18C\uAC00 \uD3EC\uD138\uACFC \uB2E4\uB978 \uC0AC\uC774\uD2B8\uC785\uB2C8\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB97C \uC5F4\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2014 \uC8FC\uC18C\uB97C \uD655\uC778\uD55C \uB4A4 \uC9C1\uC811 \uC5F4\uC5B4 \uC8FC\uC138\uC694."
         )
       );
@@ -5789,7 +6030,7 @@ async function openVerificationUri(portalUrl, verificationUriComplete, options,
   }
   const opened = await (deps.openBrowser ?? openBrowser)(verificationUriComplete);
   if (!opened && !options.json) {
-    console.log(pc21.dim("  \uBE0C\uB77C\uC6B0\uC800\uB97C \uC790\uB3D9\uC73C\uB85C \uC5F4\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC704 \uC8FC\uC18C\uB97C \uC9C1\uC811 \uC5F4\uC5B4 \uC8FC\uC138\uC694."));
+    console.log(pc22.dim("  \uBE0C\uB77C\uC6B0\uC800\uB97C \uC790\uB3D9\uC73C\uB85C \uC5F4\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uC704 \uC8FC\uC18C\uB97C \uC9C1\uC811 \uC5F4\uC5B4 \uC8FC\uC138\uC694."));
   }
 }
 function sameOrigin(a, b) {
@@ -5854,13 +6095,13 @@ function reportIssued(portalUrl, issued, organizationId, json) {
     });
     return;
   }
-  console.log(pc21.green(`\u2713 ${portalUrl} \uC5D0 \uB85C\uADF8\uC778\uD588\uC2B5\uB2C8\uB2E4.`));
+  console.log(pc22.green(`\u2713 ${portalUrl} \uC5D0 \uB85C\uADF8\uC778\uD588\uC2B5\uB2C8\uB2E4.`));
   console.log(
-    pc21.dim(
+    pc22.dim(
       `  \uC870\uC9C1 ${orgLabel(organizationId ?? UNKNOWN_ORG)} \xB7 \uD1A0\uD070 ${issued.prefix}\u2026 \xB7 \uB4F1\uAE09 ${issued.permission} \xB7 ${scopeLabel(issued.allSpaces, issued.spaceIds)} \xB7 \uB9CC\uB8CC ${issued.expiresAt.slice(0, 10)}`
     )
   );
-  console.log(pc21.dim("  \uB2E4\uC74C: \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC\uC5D0\uC11C bstage link"));
+  console.log(pc22.dim("  \uB2E4\uC74C: \uD504\uB85C\uC81D\uD2B8 \uB514\uB809\uD130\uB9AC\uC5D0\uC11C bstage link"));
 }
 async function loginCommand(options, deps = {}) {
   const env2 = deps.env ?? process.env;
@@ -5877,7 +6118,7 @@ async function loginCommand(options, deps = {}) {
 }
 
 // src/commands/logout.ts
-import pc22 from "picocolors";
+import pc23 from "picocolors";
 async function logoutCommand(options, deps = {}) {
   const cwd = deps.cwd ?? process.cwd();
   const env2 = deps.env ?? process.env;
@@ -5891,16 +6132,16 @@ async function logoutCommand(options, deps = {}) {
   const removed = await deleteCredential(portalUrl, options.org, env2);
   if (removed.length === 0) {
     const scope = options.org ? `\uC870\uC9C1 ${options.org} \uC758 ` : "";
-    console.log(pc22.yellow(`${portalUrl} \uC5D0 \uC800\uC7A5\uB41C ${scope}\uC790\uACA9\uC99D\uBA85\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.`));
+    console.log(pc23.yellow(`${portalUrl} \uC5D0 \uC800\uC7A5\uB41C ${scope}\uC790\uACA9\uC99D\uBA85\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.`));
   } else {
     const orgs = removed.map(orgLabel).join(", ");
-    console.log(pc22.green(`\u2713 ${portalUrl} \uC790\uACA9\uC99D\uBA85\uC744 \uC0AD\uC81C\uD588\uC2B5\uB2C8\uB2E4 \u2014 \uC870\uC9C1 ${orgs}`));
+    console.log(pc23.green(`\u2713 ${portalUrl} \uC790\uACA9\uC99D\uBA85\uC744 \uC0AD\uC81C\uD588\uC2B5\uB2C8\uB2E4 \u2014 \uC870\uC9C1 ${orgs}`));
   }
-  console.log(pc22.dim("  \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uD1A0\uD070 \uC790\uCCB4\uB97C \uD3D0\uAE30\uD558\uBA74 \uB2E4\uB978 \uAE30\uAE30\uC5D0\uC11C\uB3C4 \uBB34\uD6A8\uAC00 \uB429\uB2C8\uB2E4."));
+  console.log(pc23.dim("  \uD3EC\uD138 \uD654\uBA74\uC5D0\uC11C \uD1A0\uD070 \uC790\uCCB4\uB97C \uD3D0\uAE30\uD558\uBA74 \uB2E4\uB978 \uAE30\uAE30\uC5D0\uC11C\uB3C4 \uBB34\uD6A8\uAC00 \uB429\uB2C8\uB2E4."));
 }
 
 // src/commands/publish.ts
-import pc23 from "picocolors";
+import pc24 from "picocolors";
 function parseOnOff(v) {
   const s = v.toLowerCase();
   if (s === "on") return true;
@@ -5939,13 +6180,13 @@ async function togglePlacement(ctx, p5, enabled) {
 }
 function printResults2(results, enabled, out) {
   for (const r of results) {
-    const mark = r.status === "failed" ? pc23.red("\u2717") : r.status === "conflict" ? pc23.yellow("!") : pc23.green("\u2713");
+    const mark = r.status === "failed" ? pc24.red("\u2717") : r.status === "conflict" ? pc24.yellow("!") : pc24.green("\u2713");
     const stateLabel = r.status === "unchanged" ? "\uBCC0\uACBD \uC5C6\uC74C" : `\uAC8C\uC2DC ${r.enabled ? "on" : "off"}`;
-    const suffix = r.message && r.status !== "unchanged" ? pc23.dim(`  ${r.message}`) : "";
+    const suffix = r.message && r.status !== "unchanged" ? pc24.dim(`  ${r.message}`) : "";
     out(`${mark} ${r.label}  ${stateLabel}${suffix}`);
   }
   if (!enabled) {
-    out(pc23.dim("  \uB77C\uC774\uBE0C \uBC84\uC804 \uD3EC\uC778\uD130\uB294 \uC720\uC9C0\uB429\uB2C8\uB2E4 \u2014 \uB2E4\uC2DC \uCF1C\uBA74 \uAC19\uC740 \uBE4C\uB4DC\uAC00 \uC989\uC2DC \uC11C\uBE59\uB429\uB2C8\uB2E4."));
+    out(pc24.dim("  \uB77C\uC774\uBE0C \uBC84\uC804 \uD3EC\uC778\uD130\uB294 \uC720\uC9C0\uB429\uB2C8\uB2E4 \u2014 \uB2E4\uC2DC \uCF1C\uBA74 \uAC19\uC740 \uBE4C\uB4DC\uAC00 \uC989\uC2DC \uC11C\uBE59\uB429\uB2C8\uB2E4."));
   }
 }
 function reportOutcome2(results, options, enabled, out) {
@@ -5985,7 +6226,7 @@ async function publishCommand(state, options, deps = {}) {
 }
 
 // src/commands/rollback.ts
-import pc24 from "picocolors";
+import pc25 from "picocolors";
 function pickRollbackTarget(builds, repo, currentLive) {
   const ok = builds.filter((b) => buildMatchesRepo(b, repo) && b.status === "SUCCEEDED").sort((a, b) => a.requestedAt < b.requestedAt ? 1 : -1);
   if (!currentLive) return ok[0] ?? null;
@@ -6070,16 +6311,16 @@ async function rollbackCommand(buildId, options, deps = {}) {
   reportOutcome(results, options, out);
   if (!options.json) {
     out(
-      pc24.dim("  \uB418\uB3CC\uB9B0 \uB4A4\uC5D0\uB3C4 \uCD5C\uC2E0 \uBE4C\uB4DC\uB294 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 \u2014 bstage deploy \uB85C \uB2E4\uC2DC \uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.")
+      pc25.dim("  \uB418\uB3CC\uB9B0 \uB4A4\uC5D0\uB3C4 \uCD5C\uC2E0 \uBE4C\uB4DC\uB294 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4 \u2014 bstage deploy \uB85C \uB2E4\uC2DC \uC62C\uB9B4 \uC218 \uC788\uC2B5\uB2C8\uB2E4.")
     );
   }
 }
 
 // src/commands/skills.ts
-import pc25 from "picocolors";
+import pc26 from "picocolors";
 async function skillsInstallCommand(options) {
   console.warn(
-    pc25.yellow(
+    pc26.yellow(
       "bstage skills install\uC740 bstage ai install\uB85C \uBC14\uB00C\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC74C \uB9B4\uB9AC\uC988\uC5D0\uC11C \uC81C\uAC70\uB429\uB2C8\uB2E4."
     )
   );
@@ -6089,7 +6330,7 @@ async function skillsInstallCommand(options) {
 // src/commands/docs.ts
 import { existsSync as existsSync8, readdirSync as readdirSync3 } from "fs";
 import { join as join16 } from "path";
-import pc26 from "picocolors";
+import pc27 from "picocolors";
 var DOC_ORDER = [
   ["GETTING_STARTED.md", "\uBE60\uB978 \uC2DC\uC791 \uAC00\uC774\uB4DC"],
   ["API_REFERENCE.md", "createTemplate, hooks, BstageClient, PlatformBridge API"],
@@ -6109,10 +6350,10 @@ var CORE_DOCS_SEGMENTS = ["node_modules", "@bstage-sdk", "core", "docs"];
 async function docsCommand() {
   const docsDir = join16(process.cwd(), ...CORE_DOCS_SEGMENTS);
   if (!existsSync8(docsDir)) {
-    console.log(pc26.yellow("SDK \uBB38\uC11C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(pc26.dim("  @bstage-sdk/core\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694 (npm install \uD6C4 \uC7AC\uC2DC\uB3C4)."));
+    console.log(pc27.yellow("SDK \uBB38\uC11C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(pc27.dim("  @bstage-sdk/core\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694 (npm install \uD6C4 \uC7AC\uC2DC\uB3C4)."));
     console.log(
-      pc26.dim(
+      pc27.dim(
         "  SDK \uC758\uC874\uC774 \uC5C6\uB294 \uB808\uD3EC\uC5D0\uB294 \uC774 \uACBD\uB85C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 liquid \uADDC\uC57D\xB7\uB370\uC774\uD130\uB294 bstage-liquid \uC2A4\uD0AC\uC744 \uBCF4\uC138\uC694."
       )
     );
@@ -6124,24 +6365,24 @@ async function docsCommand() {
   const known = new Set(DOC_ORDER.map(([f]) => f));
   const extras = [...present].filter((f) => !known.has(f)).sort();
   console.log("");
-  console.log(pc26.bold("bstage SDK \uBB38\uC11C"));
-  console.log(pc26.dim(`  ${docsDir}`));
+  console.log(pc27.bold("bstage SDK \uBB38\uC11C"));
+  console.log(pc27.dim(`  ${docsDir}`));
   console.log("");
   for (const [file3, desc] of ordered) {
-    console.log(`  ${pc26.cyan(file3.padEnd(22))} ${pc26.dim(desc)}`);
+    console.log(`  ${pc27.cyan(file3.padEnd(22))} ${pc27.dim(desc)}`);
   }
   for (const file3 of extras) {
-    console.log(`  ${pc26.cyan(file3.padEnd(22))}`);
+    console.log(`  ${pc27.cyan(file3.padEnd(22))}`);
   }
   console.log("");
   console.log(
-    pc26.dim("\uD30C\uC77C\uC744 \uC5F4\uC5B4 \uC0C1\uC138 \uB0B4\uC6A9\uC744 \uD655\uC778\uD558\uC138\uC694. \uCEE4\uB9E8\uB4DC \uB3C4\uC6C0\uB9D0\uC740 `bstage <command> --help`.")
+    pc27.dim("\uD30C\uC77C\uC744 \uC5F4\uC5B4 \uC0C1\uC138 \uB0B4\uC6A9\uC744 \uD655\uC778\uD558\uC138\uC694. \uCEE4\uB9E8\uB4DC \uB3C4\uC6C0\uB9D0\uC740 `bstage <command> --help`.")
   );
   console.log("");
 }
 
 // src/commands/whoami.ts
-import pc27 from "picocolors";
+import pc28 from "picocolors";
 function jsonEntry(c, active) {
   return {
     organizationId: c.organizationId,
@@ -6155,21 +6396,21 @@ function jsonEntry(c, active) {
 }
 function printCredentials(stored, activeOrg) {
   if (stored.length === 0) return;
-  console.log(pc27.dim("\uC800\uC7A5\uB41C \uD1A0\uD070"));
+  console.log(pc28.dim("\uC800\uC7A5\uB41C \uD1A0\uD070"));
   const rows = stored.map((c) => [
     `  \uC870\uC9C1 ${orgLabel(c.organizationId)}`,
     `\uB4F1\uAE09 ${c.permission ?? "-"}`,
     scopeLabel(c.allSpaces, c.spaceIds),
     `\uB9CC\uB8CC ${c.expiresAt ? c.expiresAt.slice(0, 10) : "-"}`,
-    c.organizationId === activeOrg ? pc27.dim("(\uC0AC\uC6A9 \uC911)") : ""
+    c.organizationId === activeOrg ? pc28.dim("(\uC0AC\uC6A9 \uC911)") : ""
   ]);
   console.log(table(rows));
 }
 function printMe(me, portalUrl) {
-  console.log(`${pc27.bold(me.user.email)}  ${pc27.dim(portalUrl)}`);
+  console.log(`${pc28.bold(me.user.email)}  ${pc28.dim(portalUrl)}`);
   for (const m of me.memberships) {
     const stages = Object.entries(m.stageRoles ?? {}).map(([s, r]) => `${s}:${r}`).join(", ");
-    console.log(`  \uC870\uC9C1 ${m.organizationId}  ${m.organizationRole ?? ""}  ${pc27.dim(stages)}`);
+    console.log(`  \uC870\uC9C1 ${m.organizationId}  ${m.organizationRole ?? ""}  ${pc28.dim(stages)}`);
   }
 }
 async function whoamiCommand(options, deps = {}) {
@@ -6225,10 +6466,10 @@ function reportStoredOnly(portalUrl, stored, json) {
     });
     return;
   }
-  console.log(pc27.dim(portalUrl));
+  console.log(pc28.dim(portalUrl));
   printCredentials(stored);
   console.log(
-    pc27.yellow("  \uC5EC\uB7EC \uC870\uC9C1\uC758 \uD1A0\uD070\uC774 \uC788\uC2B5\uB2C8\uB2E4 \u2014 --org <id> \uB85C \uC870\uC9C1\uC744 \uC9C0\uC815\uD558\uBA74 \uACC4\uC815 \uC815\uBCF4\uB3C4 \uBD05\uB2C8\uB2E4.")
+    pc28.yellow("  \uC5EC\uB7EC \uC870\uC9C1\uC758 \uD1A0\uD070\uC774 \uC788\uC2B5\uB2C8\uB2E4 \u2014 --org <id> \uB85C \uC870\uC9C1\uC744 \uC9C0\uC815\uD558\uBA74 \uACC4\uC815 \uC815\uBCF4\uB3C4 \uBD05\uB2C8\uB2E4.")
   );
 }
 
@@ -6248,8 +6489,11 @@ program.command("build").description(
 ).option("--json", "\uAC80\uC99D \uACB0\uACFC\xB7\uC0B0\uCD9C\uBB3C \uC694\uC57D\uC744 JSON\uC73C\uB85C \uCD9C\uB825 (liquid\xB7\uD63C\uD569 \uB808\uD3EC)").action((options) => buildCommand(options));
 program.command("docs").description("\uC124\uCE58\uB41C SDK \uBB38\uC11C \uBAA9\uB85D\xB7\uACBD\uB85C \uCD9C\uB825").action(docsCommand);
 program.command("doctor").description(
-  "SDK \uBC84\uC804\xB7\uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8 \uB4DC\uB9AC\uD504\uD2B8 \uC9C4\uB2E8 (\uC9C4\uB2E8 + SDK \uC18C\uC720 \uC2A4\uD0AC \uC790\uB3D9 \uB3D9\uAE30\uD654; package.json\xB7\uD6C5\uC740 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC74C)"
-).option("--json", "\uAD6C\uC870\uD654 \uCD9C\uB825 (\uC2A4\uD0AC\xB7CI\uC6A9)").action(doctorCommand);
+  "SDK \uBC84\uC804\xB7\uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8 \uB4DC\uB9AC\uD504\uD2B8 + \uD3EC\uD138 \uBC30\uCE58 \uC9C4\uB2E8 (\uC9C4\uB2E8 + SDK \uC18C\uC720 \uC2A4\uD0AC \uC790\uB3D9 \uB3D9\uAE30\uD654; package.json\xB7\uD6C5\uC740 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC74C)"
+).option("--json", "\uAD6C\uC870\uD654 \uCD9C\uB825 (\uC2A4\uD0AC\xB7CI\uC6A9)").option(
+  "--placement <target>",
+  "\uD3EC\uD138 \uC9C4\uB2E8\uC744 \uBC30\uCE58 \uD558\uB098\uB85C \uC881\uD798 (id\xB7\uACBD\uB85C\xB7\uC2AC\uB86F id). \uB9C1\uD06C\xB7\uB85C\uADF8\uC778\uC774 \uC5C6\uC73C\uBA74 \uC885\uB8CC \uCF54\uB4DC 2\xB73"
+).action((o) => runCommand(() => doctorCommand(o)));
 program.command("dev").description("\uC778\uC99D \uD504\uB85D\uC2DC \uD3EC\uD568 \uB85C\uCEEC \uAC1C\uBC1C \uC11C\uBC84 (liquid \uB808\uD3EC\uB294 liquidjs \uD504\uB9AC\uBDF0)").option("-p, --port <port>", "Dev server port", "5173").option(
   "--phase <phase>",
   "Target phase (dev, qa, real, sandbox). \uC0DD\uB7B5 \uC2DC .env\uC758 VITE_BSTAGE_PHASE, \uADF8\uAC83\uB3C4 \uC5C6\uC73C\uBA74 sandbox"
@@ -6304,6 +6548,8 @@ program.addHelpText(
   $ bstage dev                   \uB85C\uCEEC \uAC1C\uBC1C \uC11C\uBC84 (\uC778\uC99D \uD504\uB85D\uC2DC \xB7 liquid \uB808\uD3EC\uB294 liquidjs \uD504\uB9AC\uBDF0)
   $ bstage build                 IIFE \uBC88\uB4E4 \uBE4C\uB4DC (dist/{\uACBD\uB85C} \xB7 dist/{\uC2AC\uB86F})
   $ bstage doctor                SDK \uBC84\uC804\xB7\uB4DC\uB9AC\uD504\uD2B8 \uC9C4\uB2E8
+  $ bstage doctor --placement /me
+                                  \uBC30\uCE58 \uD558\uB098\uB9CC \uD3EC\uD138 \uC9C4\uB2E8 (\uAC8C\uC2DC\xB7\uBE4C\uB4DC\xB7\uC571 \uD0A4 \uBB38\uC81C\uC640 \uC870\uCE58)
   $ bstage ai install            \uC5D0\uC774\uC804\uD2B8 \uC2A4\uD0AC\xB7AGENTS.md \uC124\uCE58/\uCD5C\uC2E0\uD654 (+ \uC2DC\uD06C\uB9BF \uAC00\uB4DC)
   $ bstage ai doctor             \uC5D0\uC774\uC804\uD2B8 \uC790\uC0B0 \uCD5C\uC2E0 \uC5EC\uBD80 \uC9C4\uB2E8
   $ bstage i18n pull             \uD50C\uB7AB\uD3FC \uBC88\uC5ED \uBC1B\uAE30 + \uD0C0\uC785 \uC0DD\uC131

package/dist/vite/preset.js

@@ -3,7 +3,7 @@ import {
   appKeyEnvDefine,
   bstageDevPlugin,
   createViteConfig
-} from "../chunk-COUDGZIA.js";
+} from "../chunk-MSXSJHUT.js";
 export {
   appKeyEnvAliasPlugin,
   appKeyEnvDefine,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bstage-sdk/cli",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "bstage SDK CLI — build b.stage templates",
   "type": "module",
   "publishConfig": {
@@ -32,14 +32,14 @@
     "liquidjs": "^10.24.0",
     "picocolors": "^1.1.1",
     "vite": "^7.0.0",
-    "@bstage-sdk/ai-toolkit": "0.8.2",
-    "@bstage-sdk/core": "0.8.2"
+    "@bstage-sdk/ai-toolkit": "0.8.4",
+    "@bstage-sdk/core": "0.8.4"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",
-    "@bstage-sdk/design": "0.8.2"
+    "@bstage-sdk/design": "0.8.4"
   },
   "license": "MIT",
   "scripts": {