@bstage-sdk/cli 0.8.7 → 0.9.0

package/dist/index.js

@@ -20,8 +20,8 @@ import {
 } from "./chunk-MSXSJHUT.js";
 
 // src/index.ts
-import { readFileSync as readFileSync5 } from "fs";
-import { dirname as dirname10, join as join17 } from "path";
+import { readFileSync as readFileSync6 } from "fs";
+import { dirname as dirname11, join as join19 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { Command } from "commander";
 
@@ -1130,7 +1130,7 @@ async function aiDoctorCommand(o, deps = {}) {
 }
 
 // src/commands/build.ts
-import { resolve as resolve2, join as join6, relative as relative2, sep as sep3 } from "path";
+import { resolve as resolve2, join as join8, relative as relative2, sep as sep3 } from "path";
 import { readFile as readFile2, access, readdir, rename, mkdir, rm } from "fs/promises";
 import { build as viteBuild, loadEnv } from "vite";
 import pc7 from "picocolors";
@@ -1261,6 +1261,181 @@ __reg__.forEach(__registerTemplate__);
   };
 }
 
+// src/vite/bundledPackagesPlugin.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { dirname as dirname5, isAbsolute as isAbsolute2, join as join5 } from "path";
+
+// src/build/manifest.ts
+import { writeFile as writeFile2 } from "fs/promises";
+import { join as join4 } from "path";
+var MANIFEST_FILE = "manifest.json";
+var MANIFEST_ENTRY = "template.js";
+var MAX_MANIFEST_BYTES = 16 * 1024;
+var PORTAL_ELEMENT_NAME_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/;
+var MAX_ELEMENT_NAME_LEN = 100;
+var SEMVER_RE = /^(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+var MAX_SEMVER_LEN = 64;
+var FRAMEWORK_RE = /^[a-z][a-z0-9-]{0,31}$/;
+function parseSemver(v) {
+  if (v.length === 0 || v.length > MAX_SEMVER_LEN) return null;
+  const m = SEMVER_RE.exec(v);
+  if (!m) return null;
+  const pre = m[4] ? m[4].split(".") : [];
+  if (pre.some((id) => /^\d+$/.test(id) && (id.length > 1 && id.startsWith("0") || id.length > 9)))
+    return null;
+  return { core: [Number(m[1]), Number(m[2]), Number(m[3])], pre };
+}
+function isValidSemver(v) {
+  return parseSemver(v) !== null;
+}
+function comparePre(a, b) {
+  if (a.length === 0 || b.length === 0) return Math.sign(b.length - a.length);
+  for (let i = 0; i < Math.min(a.length, b.length); i++) {
+    const [x, y] = [a[i], b[i]];
+    if (x === y) continue;
+    const [xn, yn] = [/^\d+$/.test(x), /^\d+$/.test(y)];
+    if (xn && yn) return Math.sign(Number(x) - Number(y));
+    if (xn !== yn) return xn ? -1 : 1;
+    return x < y ? -1 : 1;
+  }
+  return Math.sign(a.length - b.length);
+}
+function compareSemver(a, b) {
+  const [pa, pb] = [parseSemver(a), parseSemver(b)];
+  if (!pa || !pb) throw new Error(`invalid semver: ${pa ? b : a}`);
+  for (let i = 0; i < 3; i++) {
+    if (pa.core[i] !== pb.core[i]) return Math.sign(pa.core[i] - pb.core[i]);
+  }
+  return comparePre(pa.pre, pb.pre);
+}
+function pickSdkVersion(versions) {
+  const all = [...new Set(versions)];
+  if (all.length === 0 || !all.every(isValidSemver)) return void 0;
+  return [...all].sort((a, b) => compareSemver(a, b) || (a < b ? -1 : a > b ? 1 : 0))[0];
+}
+function isValidBridgeProtocol(v) {
+  return typeof v === "number" && Number.isSafeInteger(v) && v >= 1;
+}
+function pickBridgeProtocol(values) {
+  const all = [...values];
+  if (all.length === 0 || !all.every(isValidBridgeProtocol)) return void 0;
+  return Math.min(...all);
+}
+function createManifest(input) {
+  const { elementName, sdkVersion } = input;
+  if (elementName.length > MAX_ELEMENT_NAME_LEN || !PORTAL_ELEMENT_NAME_RE.test(elementName)) {
+    return {
+      ok: false,
+      reason: `name ${JSON.stringify(elementName)}\uC774 \uD3EC\uD138 Custom Element \uADDC\uCE59(${PORTAL_ELEMENT_NAME_RE.source}, ${MAX_ELEMENT_NAME_LEN}\uC790 \uC774\uD558)\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`
+    };
+  }
+  if (sdkVersion === void 0 || !isValidSemver(sdkVersion)) {
+    return {
+      ok: false,
+      reason: "\uBC88\uB4E4\uC5D0\uC11C @bstage-sdk/core \uBC84\uC804\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4"
+    };
+  }
+  const explicit = input.framework?.toLowerCase();
+  const framework = explicit && FRAMEWORK_RE.test(explicit) ? explicit : input.bundlesReact ? "react" : "vanilla";
+  const manifest = {
+    elementName,
+    entry: MANIFEST_ENTRY,
+    sdkVersion,
+    framework,
+    ...isValidBridgeProtocol(input.bridgeProtocol) ? { bridgeProtocol: input.bridgeProtocol } : {}
+  };
+  const json = JSON.stringify(manifest, null, 2) + "\n";
+  if (Buffer.byteLength(json, "utf-8") > MAX_MANIFEST_BYTES) {
+    return { ok: false, reason: `manifest\uAC00 \uC0C1\uD55C(${MAX_MANIFEST_BYTES}\uBC14\uC774\uD2B8)\uC744 \uB118\uC2B5\uB2C8\uB2E4` };
+  }
+  return { ok: true, manifest, json };
+}
+async function emitManifest(dir, input) {
+  const result = createManifest(input);
+  if (result.ok) await writeFile2(join4(dir, MANIFEST_FILE), result.json, "utf-8");
+  return result;
+}
+
+// src/vite/bundledPackagesPlugin.ts
+function readBridgeProtocol(pkg) {
+  const bstage = pkg.bstage;
+  if (typeof bstage !== "object" || bstage === null) return null;
+  const value = bstage.bridgeProtocol;
+  return isValidBridgeProtocol(value) ? value : null;
+}
+var UNKNOWN_VERSION = "unknown";
+var CORE_PACKAGE = "@bstage-sdk/core";
+var REACT_PACKAGE = "@bstage-sdk/react";
+var TRACKED_SCOPE = "@bstage-sdk/";
+var SDK_PATH_RE = new RegExp(
+  `${TRACKED_SCOPE.slice(0, -1).replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[/\\\\+]([a-z0-9][a-z0-9-]*)`,
+  "g"
+);
+function guessSdkPackage(id) {
+  const matches = [...id.matchAll(SDK_PATH_RE)];
+  const last = matches[matches.length - 1];
+  return last ? { name: `${TRACKED_SCOPE}${last[1]}`, version: UNKNOWN_VERSION, bridgeProtocol: null } : null;
+}
+function moduleFilePath(id) {
+  if (id.startsWith("\0")) return null;
+  const path = id.split("?")[0];
+  return isAbsolute2(path) ? path : null;
+}
+function makePackageLookup() {
+  const cache = /* @__PURE__ */ new Map();
+  function readPackage(dir) {
+    let raw;
+    try {
+      raw = readFileSync4(join5(dir, "package.json"), "utf-8");
+    } catch {
+      return void 0;
+    }
+    try {
+      const pkg = JSON.parse(raw);
+      if (typeof pkg.name !== "string") return void 0;
+      return {
+        name: pkg.name,
+        version: typeof pkg.version === "string" ? pkg.version : UNKNOWN_VERSION,
+        bridgeProtocol: readBridgeProtocol(pkg)
+      };
+    } catch {
+      return null;
+    }
+  }
+  function lookupDir(dir) {
+    const cached = cache.get(dir);
+    if (cached !== void 0) return cached;
+    const found = readPackage(dir);
+    const parent = dirname5(dir);
+    const result = found !== void 0 ? found : parent === dir ? null : lookupDir(parent);
+    cache.set(dir, result);
+    return result;
+  }
+  return (file3) => lookupDir(dirname5(file3));
+}
+function createBundledPackagesPlugin() {
+  let bundled = /* @__PURE__ */ new Map();
+  let bridgeProtocols = /* @__PURE__ */ new Map();
+  const plugin = {
+    name: "bstage-bundled-packages",
+    apply: "build",
+    generateBundle(_options, bundle) {
+      const lookup = makePackageLookup();
+      const found = Object.values(bundle).flatMap((output) => output.type === "chunk" ? Object.entries(output.modules) : []).filter(([, info]) => info.renderedLength > 0).map(([id]) => {
+        const file3 = moduleFilePath(id);
+        return (file3 ? lookup(file3) : null) ?? guessSdkPackage(id);
+      }).filter((pkg) => pkg !== null && pkg.name.startsWith(TRACKED_SCOPE));
+      const names = [...new Set(found.map((p5) => p5.name))];
+      const copiesOf = (name) => found.filter((p5) => p5.name === name);
+      bundled = new Map(names.map((name) => [name, new Set(copiesOf(name).map((p5) => p5.version))]));
+      bridgeProtocols = new Map(
+        names.map((name) => [name, new Set(copiesOf(name).map((p5) => p5.bridgeProtocol))])
+      );
+    }
+  };
+  return { plugin, getBundled: () => bundled, getBridgeProtocols: () => bridgeProtocols };
+}
+
 // src/build/credentialCheck.ts
 var CLIENT_MARKER = "X-BSTAGE-APP-ID";
 var APP_ID_PREFIX = "bsa_";
@@ -1372,13 +1547,13 @@ function ignoredLiquidNotice(files) {
 }
 
 // src/liquid/validate.ts
-import { readdirSync as readdirSync2, readFileSync as readFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { readdirSync as readdirSync2, readFileSync as readFileSync5 } from "fs";
+import { join as join7 } from "path";
 import { LiquidError as LiquidError2 } from "liquidjs";
 
 // src/liquid/render.ts
 import { readFile } from "fs/promises";
-import { join as join4 } from "path";
+import { join as join6 } from "path";
 import { Liquid, LiquidError } from "liquidjs";
 var LiquidPreviewError = class extends Error {
   constructor(message, file3, line) {
@@ -1390,7 +1565,7 @@ var LiquidPreviewError = class extends Error {
 };
 function createEngine(root) {
   const engine = new Liquid({
-    root: [join4(root, "public")],
+    root: [join6(root, "public")],
     extname: ".liquid",
     strictVariables: false
   });
@@ -1427,15 +1602,15 @@ async function readData(dataPath) {
   }
 }
 async function renderTemplate(engine, root, type, name) {
-  const dir = join4(root, "public", type, name);
-  const templatePath = join4(dir, "template.liquid");
+  const dir = join6(root, "public", type, name);
+  const templatePath = join6(dir, "template.liquid");
   let source;
   try {
     source = await readFile(templatePath, "utf-8");
   } catch {
     throw new LiquidPreviewError("template.liquid\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4", templatePath);
   }
-  const data = await readData(join4(dir, "data.json"));
+  const data = await readData(join6(dir, "data.json"));
   try {
     const html = await engine.parseAndRender(source, data);
     return { html };
@@ -1474,7 +1649,7 @@ function readEntries(dir) {
 }
 function readText(path) {
   try {
-    return readFileSync4(path, "utf-8");
+    return readFileSync5(path, "utf-8");
   } catch {
     return null;
   }
@@ -1483,7 +1658,7 @@ function validateTemplate(engine, root, id) {
   const issues = [];
   const dir = `public/${id}`;
   try {
-    const source = readText(join5(root, dir, "template.liquid"));
+    const source = readText(join7(root, dir, "template.liquid"));
     if (source !== null) {
       engine.parse(source);
       if (PARTIAL_TAG_RE.test(source)) {
@@ -1511,7 +1686,7 @@ function validateTemplate(engine, root, id) {
       message: `\uD3F4\uB354 \uC774\uB984 "${name}"\uC740 \uADDC\uCE59\uC5D0 \uB9DE\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 \uC18C\uBB38\uC790\uB85C \uC2DC\uC791\uD558\uACE0 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uB9CC \uC4F0\uC138\uC694(CDN \uACBD\uB85C\uAC00 \uB429\uB2C8\uB2E4).`
     });
   }
-  const raw = readText(join5(root, dir, "data.json"));
+  const raw = readText(join7(root, dir, "data.json"));
   if (raw !== null) {
     try {
       JSON.parse(raw);
@@ -1523,7 +1698,7 @@ function validateTemplate(engine, root, id) {
       });
     }
   }
-  if (readText(join5(root, dir, "layout.json")) !== null) {
+  if (readText(join7(root, dir, "layout.json")) !== null) {
     issues.push({
       level: "warn",
       path: `${dir}/layout.json`,
@@ -1535,10 +1710,10 @@ function validateTemplate(engine, root, id) {
 function findMisnamedTemplates(root) {
   const issues = [];
   for (const surface of SURFACES) {
-    const surfaceDir = join5(root, "public", surface);
+    const surfaceDir = join7(root, "public", surface);
     for (const entry of readEntries(surfaceDir)) {
       if (!entry.isDirectory || entry.name.startsWith(".")) continue;
-      const files = readEntries(join5(surfaceDir, entry.name)).filter((e) => e.isFile);
+      const files = readEntries(join7(surfaceDir, entry.name)).filter((e) => e.isFile);
       if (files.length === 0) continue;
       if (files.some((f) => f.name === "template.liquid")) continue;
       if (files.every((f) => STRIPPED_FILES.includes(f.name))) continue;
@@ -1705,16 +1880,22 @@ async function buildEntry(ctx, entryInfo) {
   console.log(`
 Building template: ${label}`);
   const { plugin: metaPlugin, getMeta } = createMetaPlugin();
-  const outDir = join6(DIST_DIR, STAGING_DIR);
+  const { plugin: bundledPlugin, getBundled, getBridgeProtocols } = createBundledPackagesPlugin();
+  const outDir = join8(DIST_DIR, STAGING_DIR);
   const viteConfig2 = createViteConfig({ entry, outDir });
   await viteBuild({
     ...viteConfig2,
     configFile: false,
     root: cwd,
     logLevel: "info",
-    plugins: [...viteConfig2.plugins ?? [], metaPlugin, createRegisterPlugin()]
+    plugins: [
+      ...viteConfig2.plugins ?? [],
+      metaPlugin,
+      createRegisterPlugin(),
+      bundledPlugin
+    ]
   });
-  const bundlePath = join6(cwd, outDir, "template.js");
+  const bundlePath = join8(cwd, outDir, "template.js");
   let bundleSize = 0;
   let usesClient = false;
   try {
@@ -1751,7 +1932,7 @@ ${pc7.red("Error")} ${e.message}`);
   if (previousOwner !== void 0) {
     console.error(
       `
-${pc7.red("Error")} ${label}: \uC0B0\uCD9C\uBB3C \uC704\uCE58 "${join6(DIST_DIR, outputName)}"\uAC00 ${previousOwner}\uC640 \uACB9\uCE69\uB2C8\uB2E4.
+${pc7.red("Error")} ${label}: \uC0B0\uCD9C\uBB3C \uC704\uCE58 "${join8(DIST_DIR, outputName)}"\uAC00 ${previousOwner}\uC640 \uACB9\uCE69\uB2C8\uB2E4.
   \uB450 \uD15C\uD50C\uB9BF\uC774 \uAC19\uC740 \uC790\uB9AC\uB85C \uB098\uAC08 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`
     );
     process.exit(1);
@@ -1767,11 +1948,36 @@ ${pc7.red("Error")} ${label}: name "${elementName}"\uC744 ${elementNameOwner}\uA
     process.exit(1);
   }
   ctx.takenElementNames.set(elementName, label);
-  const finalDir = outputName ? join6(cwd, DIST_DIR, outputName) : join6(cwd, DIST_DIR);
+  const finalDir = outputName ? join8(cwd, DIST_DIR, outputName) : join8(cwd, DIST_DIR);
   await mkdir(finalDir, { recursive: true });
-  await rename(join6(cwd, outDir, "template.js"), join6(finalDir, "template.js"));
+  await rename(join8(cwd, outDir, "template.js"), join8(finalDir, "template.js"));
   const output = relative2(cwd, finalDir).split(sep3).join("/");
   console.log(`  ${output}/template.js  (${formatSize(bundleSize)})`);
+  const bundled = getBundled();
+  const manifest = await emitManifest(finalDir, {
+    elementName,
+    sdkVersion: pickSdkVersion(bundled.get(CORE_PACKAGE) ?? []),
+    bridgeProtocol: pickBridgeProtocol(getBridgeProtocols().get(CORE_PACKAGE) ?? []),
+    framework: bundleMeta?.framework,
+    bundlesReact: bundled.has(REACT_PACKAGE)
+  });
+  if (manifest.ok) {
+    const { sdkVersion, bridgeProtocol } = manifest.manifest;
+    console.log(
+      `  ${output}/${MANIFEST_FILE}  (sdkVersion ${sdkVersion}, bridgeProtocol ${bridgeProtocol ?? "\uC5C6\uC74C"})`
+    );
+    if (bridgeProtocol === void 0) {
+      console.warn(
+        `  ${pc7.yellow("\u26A0")} \uBC88\uB4E4\uC5D0 \uC2E4\uB9B0 bstage-core \uC911 bridgeProtocol\uC744 \uC54C \uC218 \uC5C6\uB294 \uC0AC\uBCF8\uC774 \uC788\uC2B5\uB2C8\uB2E4(\uD544\uB4DC \uC5C6\uB294 \uC61B core\xB7\uADC0\uC18D \uC2E4\uD328).
+    \uC774 \uD15C\uD50C\uB9BF\uC740 \uACA9\uB9AC(iframe) \uBC30\uCE58\uB97C \uC4F8 \uC218 \uC5C6\uACE0 inline\uC73C\uB85C\uB9CC \uB3D9\uC791\uD569\uB2C8\uB2E4. SDK\uB97C \uC62C\uB9B0 \uB4A4 \uB2E4\uC2DC \uBE4C\uB4DC\uD558\uC138\uC694.`
+      );
+    }
+  } else {
+    console.warn(
+      `  ${pc7.yellow("\u26A0")} ${output}/${MANIFEST_FILE}\uC744 \uB9CC\uB4E4\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2014 ${manifest.reason}.
+    \uC774 \uD15C\uD50C\uB9BF\uC740 \uACA9\uB9AC(iframe) \uBC30\uCE58\uB97C \uC4F8 \uC218 \uC5C6\uACE0 inline\uC73C\uB85C\uB9CC \uB3D9\uC791\uD569\uB2C8\uB2E4.`
+    );
+  }
   return { usesClient, output };
 }
 function printCredentialReport(env2, referenced) {
@@ -1814,7 +2020,7 @@ ${pc7.red("\u2717")} \uAC80\uC99D \uC2E4\uD328 \u2014 \uC704 \uD56D\uBAA9\uC744
   );
 }
 async function printLegacyHint(cwd) {
-  if (!await exists(join6(cwd, LEGACY_ROOT))) return;
+  if (!await exists(join8(cwd, LEGACY_ROOT))) return;
   console.error(
     `
   ${LEGACY_ROOT}/ \uC774 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4. \uBE4C\uB4DC \uC0B0\uCD9C\uBB3C \uACBD\uB85C \uADDC\uCE59\uC774 \uBC14\uB00C\uBA74\uC11C
@@ -1839,7 +2045,7 @@ function printLiquidIssues(issues) {
   }
 }
 async function bundleAll(cwd, entries, bundleEntry) {
-  await rm(join6(cwd, DIST_DIR), { recursive: true, force: true });
+  await rm(join8(cwd, DIST_DIR), { recursive: true, force: true });
   const ctx = {
     cwd,
     takenOutputs: /* @__PURE__ */ new Map(),
@@ -1852,7 +2058,7 @@ async function bundleAll(cwd, entries, bundleEntry) {
   for (const entry of entries) {
     results.push(await bundleEntry(ctx, entry));
   }
-  await rm(join6(cwd, DIST_DIR, STAGING_DIR), { recursive: true, force: true });
+  await rm(join8(cwd, DIST_DIR, STAGING_DIR), { recursive: true, force: true });
   return results;
 }
 async function reportCredentials(cwd, results) {
@@ -2219,8 +2425,8 @@ async function waitForCompletedBuild(ctx, deps, build, json) {
 }
 
 // src/portal/config.ts
-import { mkdir as mkdir2, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname5, join as join7 } from "path";
+import { mkdir as mkdir2, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
+import { dirname as dirname6, join as join9 } from "path";
 import { loadEnv as loadEnv2 } from "vite";
 var LOCAL_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]"]);
 function normalizePortalUrl(url) {
@@ -2238,11 +2444,11 @@ function normalizePortalUrl(url) {
   return u.origin + path;
 }
 function linkPath(cwd) {
-  return join7(cwd, ".bstage", "project.json");
+  return join9(cwd, ".bstage", "project.json");
 }
 async function saveLink(cwd, link) {
-  await mkdir2(dirname5(linkPath(cwd)), { recursive: true });
-  await writeFile2(linkPath(cwd), JSON.stringify(link, null, 2) + "\n");
+  await mkdir2(dirname6(linkPath(cwd)), { recursive: true });
+  await writeFile3(linkPath(cwd), JSON.stringify(link, null, 2) + "\n");
 }
 function linkFromEnv(env2) {
   const { BSTAGE_PORTAL_URL, BSTAGE_ORG, BSTAGE_SPACE, BSTAGE_REPO, BSTAGE_SURFACE } = env2;
@@ -2337,13 +2543,13 @@ async function resolvePortalUrl(explicit, cwd, env2 = process.env, phaseFlag, op
 }
 
 // src/portal/credentials.ts
-import { chmod, mkdir as mkdir3, readFile as readFile4, rename as rename2, rm as rm2, writeFile as writeFile3 } from "fs/promises";
+import { chmod, mkdir as mkdir3, readFile as readFile4, rename as rename2, rm as rm2, writeFile as writeFile4 } from "fs/promises";
 import { homedir } from "os";
-import { dirname as dirname6, join as join8 } from "path";
+import { dirname as dirname7, join as join10 } from "path";
 var UNKNOWN_ORG = "*";
 function credentialsPath(env2 = process.env) {
-  const base = env2.XDG_CONFIG_HOME || join8(homedir(), ".config");
-  return join8(base, "bstage", "credentials.json");
+  const base = env2.XDG_CONFIG_HOME || join10(homedir(), ".config");
+  return join10(base, "bstage", "credentials.json");
 }
 function hasEntry(bucket, org) {
   return Object.prototype.hasOwnProperty.call(bucket, org);
@@ -2397,10 +2603,10 @@ async function readCredentialFile(env2) {
 }
 async function writeCredentialFile(env2, data) {
   const p5 = credentialsPath(env2);
-  await mkdir3(dirname6(p5), { recursive: true, mode: 448 });
-  await chmod(dirname6(p5), 448);
+  await mkdir3(dirname7(p5), { recursive: true, mode: 448 });
+  await chmod(dirname7(p5), 448);
   const tmp = `${p5}.${process.pid}.${Date.now()}.tmp`;
-  await writeFile3(tmp, JSON.stringify(data, null, 2) + "\n", { mode: 384 });
+  await writeFile4(tmp, JSON.stringify(data, null, 2) + "\n", { mode: 384 });
   await chmod(tmp, 384);
   await rename2(tmp, p5);
 }
@@ -2679,7 +2885,7 @@ import pc12 from "picocolors";
 import { existsSync as existsSync5, realpathSync as realpathSync2, statSync, watch } from "fs";
 import { readFile as readFile5 } from "fs/promises";
 import { createServer } from "http";
-import { join as join9, relative as relative3, sep as sep4 } from "path";
+import { join as join11, relative as relative3, sep as sep4 } from "path";
 
 // src/liquid/routes.ts
 var RELOAD_PATH = "/__bstage__/reload";
@@ -2939,7 +3145,7 @@ async function sendTemplate(ctx, route2, res) {
   }
 }
 async function sendAsset(ctx, path, res) {
-  const full = join9(ctx.publicDir, path);
+  const full = join11(ctx.publicDir, path);
   if (!isInside(ctx.publicDir, full)) return sendHtml(res, 404, notFoundPage());
   try {
     const body = await readFile5(full);
@@ -2965,7 +3171,7 @@ function subscribeReload(ctx, res) {
 async function route(ctx, pathname, res) {
   const inventory = ctx.inventory.get();
   const ids = inventory.templates.map((t) => t.id);
-  const match = resolveRoute(pathname, ids, (rel) => isFile(join9(ctx.publicDir, rel)));
+  const match = resolveRoute(pathname, ids, (rel) => isFile(join11(ctx.publicDir, rel)));
   if (match === null) return sendHtml(res, 404, notFoundPage());
   switch (match.kind) {
     case "index":
@@ -3027,7 +3233,7 @@ async function startLiquidDevServer(options) {
   const { root, port, log: log3 } = options;
   const ctx = {
     root,
-    publicDir: join9(root, "public"),
+    publicDir: join11(root, "public"),
     engine: createEngine(root),
     clients: /* @__PURE__ */ new Set(),
     inventory: createInventoryCache(root)
@@ -3183,7 +3389,7 @@ import { resolve as resolve3 } from "path";
 
 // src/commands/init/scaffold.ts
 import { chmodSync, mkdirSync as mkdirSync3, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname7, join as join10 } from "path";
+import { dirname as dirname8, join as join12 } from "path";
 import { agentsMd, claudeMd, skillsFor as skillsFor2 } from "@bstage-sdk/ai-toolkit";
 
 // src/templates/env.ts
@@ -3792,7 +3998,7 @@ function rethrowWithPath(path, err) {
 }
 function writeScaffold(projectDir, scaffold) {
   for (const dir of scaffold.dirs) {
-    const full = join10(projectDir, dir);
+    const full = join12(projectDir, dir);
     try {
       mkdirSync3(full, { recursive: true });
     } catch (err) {
@@ -3800,9 +4006,9 @@ function writeScaffold(projectDir, scaffold) {
     }
   }
   for (const file3 of scaffold.files) {
-    const full = join10(projectDir, file3.path);
+    const full = join12(projectDir, file3.path);
     try {
-      mkdirSync3(dirname7(full), { recursive: true });
+      mkdirSync3(dirname8(full), { recursive: true });
       writeFileSync2(full, file3.content, "utf-8");
       if (EXECUTABLE_PATHS.has(file3.path)) chmodSync(full, 493);
     } catch (err) {
@@ -4352,7 +4558,7 @@ async function fetchLatestVersion(packageName) {
 
 // src/commands/i18n.ts
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname8, join as join11, resolve as resolve4 } from "path";
+import { dirname as dirname9, join as join13, resolve as resolve4 } from "path";
 import pc15 from "picocolors";
 function latestKey(phase, tier, target) {
   const segments = tier === DEFAULT_TRANSLATION_TIER ? [TRANSLATION_CDN_BASE_KEY, phase, target] : [TRANSLATION_CDN_BASE_KEY, phase, target, tier];
@@ -4412,14 +4618,14 @@ async function i18nPullCommand(options) {
   }
   const versionBase = `${TRANSLATION_CDN_ORIGIN}/${latest.cdnPath.replace(TRANSLATION_CDN_BUCKET_PREFIX, "")}`;
   console.log(pc15.dim(`  version: ${latest.version}`));
-  const cacheDir = join11(root, ".bstage", "i18n", target);
+  const cacheDir = join13(root, ".bstage", "i18n", target);
   mkdirSync4(cacheDir, { recursive: true });
   let refDict = null;
   const fetched = [];
   for (const locale of TRANSLATION_LANGUAGES) {
     try {
       const dict = await fetchJson(`${versionBase}/${locale}/translation.json`);
-      writeFileSync3(join11(cacheDir, `${locale}.json`), JSON.stringify(dict, null, 2));
+      writeFileSync3(join13(cacheDir, `${locale}.json`), JSON.stringify(dict, null, 2));
       fetched.push(locale);
       if (locale === options.ref) refDict = dict;
       console.log(pc15.green(`  \u2713 ${locale} (${Object.keys(dict).length})`));
@@ -4439,7 +4645,7 @@ async function i18nPullCommand(options) {
     return;
   }
   const outPath = resolve4(root, options.out);
-  mkdirSync4(dirname8(outPath), { recursive: true });
+  mkdirSync4(dirname9(outPath), { recursive: true });
   writeFileSync3(outPath, generateTypeModule(refDict, { version: latest.version, ref: options.ref }));
   console.log(pc15.green(`[bstage] \uD0C0\uC785 \uC0DD\uC131: ${options.out} (${Object.keys(refDict).length} \uD0A4)`));
   console.log(
@@ -4571,12 +4777,12 @@ async function mapLimit(items, limit, fn) {
 
 // src/commands/doctor/report.ts
 import { readFile as readFile9 } from "fs/promises";
-import { join as join15 } from "path";
+import { join as join17 } from "path";
 
 // src/commands/doctor/checks.ts
 import { existsSync as existsSync7 } from "fs";
 import { readFile as readFile6, readdir as readdir2 } from "fs/promises";
-import { join as join12 } from "path";
+import { join as join14 } from "path";
 var RECOMMENDED_DEPS = [
   {
     pkg: "@bstage-sdk/design",
@@ -4638,7 +4844,7 @@ function diagnoseFiles(root, expected) {
   return expected.map((f) => ({
     path: f.path,
     note: f.note,
-    present: (f.anyOf ?? [f.path]).some((candidate) => existsSync7(join12(root, candidate)))
+    present: (f.anyOf ?? [f.path]).some((candidate) => existsSync7(join14(root, candidate)))
   }));
 }
 function diagnoseScripts(scripts, expected) {
@@ -4652,7 +4858,7 @@ function diagnoseRecommendedDeps(deps, recommended) {
   return recommended.map((d) => ({ ...d, declared: d.pkg in deps }));
 }
 async function diagnosePnpmWorkspace(root) {
-  if (!existsSync7(join12(root, "pnpm-lock.yaml"))) {
+  if (!existsSync7(join14(root, "pnpm-lock.yaml"))) {
     return {
       relevant: false,
       allowBuildsDeclared: false,
@@ -4662,7 +4868,7 @@ async function diagnosePnpmWorkspace(root) {
   }
   let yaml = null;
   try {
-    yaml = await readFile6(join12(root, "pnpm-workspace.yaml"), "utf-8");
+    yaml = await readFile6(join14(root, "pnpm-workspace.yaml"), "utf-8");
   } catch {
   }
   return {
@@ -4673,7 +4879,7 @@ async function diagnosePnpmWorkspace(root) {
   };
 }
 async function diagnoseLayout(root) {
-  const legacyRoot = join12(root, "src", "templates");
+  const legacyRoot = join14(root, "src", "templates");
   let legacyTemplates = [];
   let legacyPresent = false;
   try {
@@ -4685,14 +4891,14 @@ async function diagnoseLayout(root) {
   return {
     legacyPresent,
     legacyTemplates,
-    pagesPresent: existsSync7(join12(root, "src", "pages")),
-    slotsPresent: existsSync7(join12(root, "src", "slots"))
+    pagesPresent: existsSync7(join14(root, "src", "pages")),
+    slotsPresent: existsSync7(join14(root, "src", "slots"))
   };
 }
 
 // src/commands/doctor/migrations.ts
 import { readFile as readFile7 } from "fs/promises";
-import { dirname as dirname9, join as join13 } from "path";
+import { dirname as dirname10, join as join15 } from "path";
 import { fileURLToPath } from "url";
 async function readApplicableMigrations(resolve5) {
   const md = await readBundledMigrationDoc();
@@ -4729,7 +4935,7 @@ async function selectApplicableMigrations(entries, resolve5) {
     for (const req of e.requirements) {
       const { version, relevant } = await resolve5(req.pkg);
       if (!relevant) continue;
-      if (version === null || compareSemver(version, req.version) < 0) {
+      if (version === null || compareSemver2(version, req.version) < 0) {
         applies = true;
         break;
       }
@@ -4752,14 +4958,14 @@ function normalizeMigrationPkg(short) {
   return short.startsWith("@") ? short : `@bstage-sdk/${short}`;
 }
 async function readBundledMigrationDoc() {
-  const here = dirname9(fileURLToPath(import.meta.url));
+  const here = dirname10(fileURLToPath(import.meta.url));
   const candidates = [
-    join13(here, "MIGRATION.md"),
+    join15(here, "MIGRATION.md"),
     // 배포물: dist/ 옆 (cli/dist/MIGRATION.md)
-    join13(here, "..", "..", "..", "docs", "MIGRATION.md"),
+    join15(here, "..", "..", "..", "docs", "MIGRATION.md"),
     // dev(dist): cli/dist → repo/docs
     // dev(src): cli/src/commands/doctor → repo/docs (모듈 분리로 한 단계 깊어졌다)
-    join13(here, "..", "..", "..", "..", "..", "docs", "MIGRATION.md")
+    join15(here, "..", "..", "..", "..", "..", "docs", "MIGRATION.md")
   ];
   for (const path of candidates) {
     try {
@@ -4774,7 +4980,7 @@ function cleanRange(spec) {
   const m = /(\d+\.\d+\.\d+)/.exec(spec);
   return m ? m[1] : null;
 }
-function compareSemver(a, b) {
+function compareSemver2(a, b) {
   const pa = a.split(".").map((n) => parseInt(n, 10));
   const pb = b.split(".").map((n) => parseInt(n, 10));
   for (let i = 0; i < 3; i++) {
@@ -4786,7 +4992,7 @@ function compareSemver(a, b) {
 
 // src/commands/doctor/skills.ts
 import { readFile as readFile8 } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join16 } from "path";
 import {
   VERSION as TOOLKIT_VERSION,
   AGENTS_MANAGED_VERSION,
@@ -4811,7 +5017,7 @@ async function diagnoseSkills(root, kind) {
     skillsFor4(kind).map(async (skill) => {
       let installed;
       try {
-        installed = await readFile8(join14(root, ".claude", "skills", skill.name, "SKILL.md"), "utf-8");
+        installed = await readFile8(join16(root, ".claude", "skills", skill.name, "SKILL.md"), "utf-8");
       } catch {
         return { name: skill.name, status: "missing" };
       }
@@ -4829,7 +5035,7 @@ function resolveSkillKind(detected) {
 async function diagnoseAgentsMd(root, pkgName, kind = "sdk") {
   let content;
   try {
-    content = await readFile8(join14(root, "AGENTS.md"), "utf-8");
+    content = await readFile8(join16(root, "AGENTS.md"), "utf-8");
   } catch {
     return { status: "missing", managedBlock: null };
   }
@@ -4859,7 +5065,7 @@ var CLI_PACKAGE = "@bstage-sdk/cli";
 async function readProjectPackage(root) {
   let pkgJson = null;
   try {
-    pkgJson = JSON.parse(await readFile9(join15(root, "package.json"), "utf-8"));
+    pkgJson = JSON.parse(await readFile9(join17(root, "package.json"), "utf-8"));
   } catch {
   }
   return {
@@ -4899,7 +5105,7 @@ async function diagnoseVersions(deps, installed, isBstageProject, isLiquid) {
       pkg,
       installed: inst,
       latest: lat,
-      outdated: !!inst && !!lat && compareSemver(inst, lat) < 0
+      outdated: !!inst && !!lat && compareSemver2(inst, lat) < 0
     };
   });
   return { versions, latestChecked };
@@ -4951,7 +5157,7 @@ async function diagnose2(root) {
 }
 async function readInstalledVersion(root, pkg) {
   try {
-    const raw = await readFile9(join15(root, "node_modules", pkg, "package.json"), "utf-8");
+    const raw = await readFile9(join17(root, "node_modules", pkg, "package.json"), "utf-8");
     const parsed = JSON.parse(raw);
     return parsed.version ?? null;
   } catch {
@@ -6329,7 +6535,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 { join as join18 } from "path";
 import pc27 from "picocolors";
 var DOC_ORDER = [
   ["GETTING_STARTED.md", "\uBE60\uB978 \uC2DC\uC791 \uAC00\uC774\uB4DC"],
@@ -6348,7 +6554,7 @@ var DOC_ORDER = [
 ];
 var CORE_DOCS_SEGMENTS = ["node_modules", "@bstage-sdk", "core", "docs"];
 async function docsCommand() {
-  const docsDir = join16(process.cwd(), ...CORE_DOCS_SEGMENTS);
+  const docsDir = join18(process.cwd(), ...CORE_DOCS_SEGMENTS);
   if (!existsSync8(docsDir)) {
     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)."));
@@ -6476,8 +6682,8 @@ function reportStoredOnly(portalUrl, stored, json) {
 // src/index.ts
 function readVersion() {
   try {
-    const here = dirname10(fileURLToPath2(import.meta.url));
-    return JSON.parse(readFileSync5(join17(here, "..", "package.json"), "utf-8")).version || "0.0.0";
+    const here = dirname11(fileURLToPath2(import.meta.url));
+    return JSON.parse(readFileSync6(join19(here, "..", "package.json"), "utf-8")).version || "0.0.0";
   } catch {
     return "0.0.0";
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bstage-sdk/cli",
-  "version": "0.8.7",
+  "version": "0.9.0",
   "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.7",
-    "@bstage-sdk/core": "0.8.7"
+    "@bstage-sdk/ai-toolkit": "0.9.0",
+    "@bstage-sdk/core": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",
-    "@bstage-sdk/design": "0.8.7"
+    "@bstage-sdk/design": "0.9.0"
   },
   "license": "MIT",
   "scripts": {