pubuilder 0.3.0 → 0.5.0

package/dist/cli.js

@@ -1,239 +1,243 @@
 #!/usr/bin/env node
-import { readFileSync as I, existsSync as w, readdirSync as N, realpathSync as q, writeFileSync as v } from "node:fs";
-import { join as g } from "node:path";
-import { fileURLToPath as G } from "node:url";
-import { createJiti as J } from "jiti";
-const M = { width: 1440, height: 900 };
-function E(t, n, e) {
-  e != null && t.append(n, String(e));
-}
-function W(t, n) {
-  const e = t.indexOf("#"), r = e >= 0 ? t.slice(e) : "", s = e >= 0 ? t.slice(0, e) : t, i = s.indexOf("?"), a = i >= 0 ? s.slice(0, i) : s, o = new URLSearchParams(i >= 0 ? s.slice(i + 1) : "");
-  for (const [c, h] of Object.entries(n.query))
-    if (o.delete(c), Array.isArray(h))
-      for (const m of h) E(o, c, m);
+import { readFileSync as O, existsSync as v, readdirSync as D, mkdirSync as j, writeFileSync as R, rmSync as W, realpathSync as nt } from "node:fs";
+import { join as f } from "node:path";
+import { fileURLToPath as ot } from "node:url";
+import { createJiti as rt } from "jiti";
+import { createServer as st } from "node:http";
+import { homedir as it, constants as at } from "node:os";
+import { spawn as X } from "node:child_process";
+import { createInterface as ct } from "node:readline";
+const lt = { width: 1440, height: 900 };
+function L(n, t, e) {
+  e != null && n.append(t, String(e));
+}
+function ut(n, t) {
+  const e = n.indexOf("#"), o = e >= 0 ? n.slice(e) : "", r = e >= 0 ? n.slice(0, e) : n, s = r.indexOf("?"), a = s >= 0 ? r.slice(0, s) : r, i = new URLSearchParams(s >= 0 ? r.slice(s + 1) : "");
+  for (const [p, g] of Object.entries(t.query))
+    if (i.delete(p), Array.isArray(g))
+      for (const w of g) L(i, p, w);
     else
-      E(o, c, h);
-  const l = o.toString();
-  return `${a}${l ? `?${l}` : ""}${r}`;
-}
-function b(t) {
-  const n = [], e = /* @__PURE__ */ new Set(), r = (s, i, a) => {
-    for (const o of s) {
-      if (!o.path) throw new Error("[pubuilder] page.path는 필수입니다");
-      if (!o.title) throw new Error(`[pubuilder] "${o.path}"의 title이 없습니다`);
-      if (e.has(o.path)) throw new Error(`[pubuilder] 중복 path: ${o.path}`);
-      if (e.add(o.path), n.push({
-        id: o.path,
-        path: o.path,
-        title: o.title,
-        external: o.external ?? /^https?:\/\//.test(o.path),
-        parentId: i,
+      L(i, p, g);
+  const h = i.toString();
+  return `${a}${h ? `?${h}` : ""}${o}`;
+}
+function M(n) {
+  const t = [], e = /* @__PURE__ */ new Set(), o = (r, s, a) => {
+    for (const i of r) {
+      if (!i.path) throw new Error("[pubuilder] page.path는 필수입니다");
+      if (!i.title) throw new Error(`[pubuilder] "${i.path}"의 title이 없습니다`);
+      if (e.has(i.path)) throw new Error(`[pubuilder] 중복 path: ${i.path}`);
+      if (e.add(i.path), t.push({
+        id: i.path,
+        path: i.path,
+        title: i.title,
+        external: i.external ?? /^https?:\/\//.test(i.path),
+        parentId: s,
         depth: a
-      }), o.variants?.length) {
-        if (o.external ?? /^https?:\/\//.test(o.path))
-          throw new Error(`[pubuilder] 외부 페이지에는 variants를 사용할 수 없습니다: ${o.path}`);
-        for (const l of o.variants) {
-          if (!l.title) throw new Error(`[pubuilder] "${o.path}" variant의 title이 없습니다`);
-          const c = W(o.path, l);
-          if (e.has(c)) throw new Error(`[pubuilder] 중복 path: ${c}`);
-          e.add(c), n.push({
-            id: c,
-            path: c,
-            title: l.title,
+      }), i.variants?.length) {
+        if (i.external ?? /^https?:\/\//.test(i.path))
+          throw new Error(`[pubuilder] 외부 페이지에는 variants를 사용할 수 없습니다: ${i.path}`);
+        for (const h of i.variants) {
+          if (!h.title) throw new Error(`[pubuilder] "${i.path}" variant의 title이 없습니다`);
+          const p = ut(i.path, h);
+          if (e.has(p)) throw new Error(`[pubuilder] 중복 path: ${p}`);
+          e.add(p), t.push({
+            id: p,
+            path: p,
+            title: h.title,
             external: !1,
-            parentId: o.path,
+            parentId: i.path,
             depth: a + 1
           });
         }
       }
-      o.children?.length && r(o.children, o.path, a + 1);
+      i.children?.length && o(i.children, i.path, a + 1);
     }
   };
-  if (r(t.pages, null, 0), n.length === 0) throw new Error("[pubuilder] pages가 비어 있습니다");
-  return { nodes: n, viewport: t.viewport ?? M };
-}
-const p = "  ";
-function V(t) {
-  return t.split("/").map((n) => /^\[{1,2}\.{0,3}.*\]{1,2}$/.test(n) && n.startsWith("[") ? "1" : n).join("/");
-}
-function $(t) {
-  return JSON.stringify(t);
-}
-function k(t, n, e) {
-  const r = p.repeat(n), s = [];
-  t.path.includes("[") && s.push(`${r}// TODO: 샘플 경로로 교체 (예: ${V(t.path)})`);
-  const i = e.has(t.path) ? " // TODO: title 확인" : "";
-  if (!t.children?.length && !t.variants?.length && !t.external)
-    return s.push(`${r}{ path: ${$(t.path)}, title: ${$(t.title)} },${i}`), s;
-  if (s.push(`${r}{`), s.push(`${r}${p}path: ${$(t.path)},`), s.push(`${r}${p}title: ${$(t.title)},${i}`), t.external && s.push(`${r}${p}external: true,`), t.variants?.length) {
-    s.push(`${r}${p}variants: [`);
-    for (const o of t.variants)
-      s.push(
-        `${r}${p}${p}{ title: ${$(o.title)}, query: ${$(o.query)} },`
+  if (o(n.pages, null, 0), t.length === 0) throw new Error("[pubuilder] pages가 비어 있습니다");
+  return { nodes: t, viewport: n.viewport ?? lt };
+}
+const P = "  ";
+function pt(n) {
+  return n.split("/").map((t) => /^\[{1,2}\.{0,3}.*\]{1,2}$/.test(t) && t.startsWith("[") ? "1" : t).join("/");
+}
+function A(n) {
+  return JSON.stringify(n);
+}
+function Z(n, t, e) {
+  const o = P.repeat(t), r = [];
+  n.path.includes("[") && r.push(`${o}// TODO: 샘플 경로로 교체 (예: ${pt(n.path)})`);
+  const s = e.has(n.path) ? " // TODO: title 확인" : "";
+  if (!n.children?.length && !n.variants?.length && !n.external)
+    return r.push(`${o}{ path: ${A(n.path)}, title: ${A(n.title)} },${s}`), r;
+  if (r.push(`${o}{`), r.push(`${o}${P}path: ${A(n.path)},`), r.push(`${o}${P}title: ${A(n.title)},${s}`), n.external && r.push(`${o}${P}external: true,`), n.variants?.length) {
+    r.push(`${o}${P}variants: [`);
+    for (const i of n.variants)
+      r.push(
+        `${o}${P}${P}{ title: ${A(i.title)}, query: ${A(i.query)} },`
       );
-    s.push(`${r}${p}],`);
+    r.push(`${o}${P}],`);
   }
-  if (t.children?.length) {
-    s.push(`${r}${p}children: [`);
-    for (const o of t.children) s.push(...k(o, n + 2, e));
-    s.push(`${r}${p}],`);
+  if (n.children?.length) {
+    r.push(`${o}${P}children: [`);
+    for (const i of n.children) r.push(...Z(i, t + 2, e));
+    r.push(`${o}${P}],`);
   }
-  return s.push(`${r}},`), s;
+  return r.push(`${o}},`), r;
 }
-function A(t, n = {}) {
-  const e = n.newPaths ?? /* @__PURE__ */ new Set(), r = [
-    'import { defineIA } from "pubuilder"',
+function G(n, t = {}) {
+  const e = t.newPaths ?? /* @__PURE__ */ new Set(), o = [
+    'import { defineIA } from "pubuilder/config"',
     "",
     "export default defineIA({"
   ];
-  t.viewport && r.push(`${p}viewport: ${$(t.viewport)},`), r.push(`${p}pages: [`);
-  for (const s of t.pages) r.push(...k(s, 2, e));
-  return r.push(`${p}],`), r.push("})"), r.push(""), r.join(`
+  n.viewport && o.push(`${P}viewport: ${A(n.viewport)},`), o.push(`${P}pages: [`);
+  for (const r of n.pages) o.push(...Z(r, 2, e));
+  return o.push(`${P}],`), o.push("})"), o.push(""), o.join(`
 `);
 }
-function d(t) {
-  return t === "/" ? [] : t.replace(/^\//, "").split("/");
-}
-function z(t, n) {
-  return t.length >= n.length ? !1 : t.every((e, r) => e === n[r]);
-}
-function B(t) {
-  const n = [...t].sort((s, i) => {
-    const a = d(s.routePath).length - d(i.routePath).length;
-    return a !== 0 ? a : s.routePath.localeCompare(i.routePath);
-  }), e = [], r = [];
-  for (const s of n) {
-    const i = d(s.routePath), a = {
-      path: s.routePath,
-      title: s.title ?? i.at(-1) ?? "/"
+function E(n) {
+  return n === "/" ? [] : n.replace(/^\//, "").split("/");
+}
+function ht(n, t) {
+  return n.length >= t.length ? !1 : n.every((e, o) => e === t[o]);
+}
+function dt(n) {
+  const t = [...n].sort((r, s) => {
+    const a = E(r.routePath).length - E(s.routePath).length;
+    return a !== 0 ? a : r.routePath.localeCompare(s.routePath);
+  }), e = [], o = [];
+  for (const r of t) {
+    const s = E(r.routePath), a = {
+      path: r.routePath,
+      title: r.title ?? s.at(-1) ?? "/"
     };
-    let o;
-    for (const l of r)
-      z(l.segments, i) && (!o || l.segments.length > o.segments.length) && (o = l);
-    o ? (o.page.children ??= []).push(a) : e.push(a), r.push({ segments: i, page: a });
+    let i;
+    for (const h of o)
+      ht(h.segments, s) && (!i || h.segments.length > i.segments.length) && (i = h);
+    i ? (i.page.children ??= []).push(a) : e.push(a), o.push({ segments: s, page: a });
   }
   return e;
 }
-function R(t, n) {
-  const e = d(t), r = d(n);
-  for (let s = 0; s < r.length; s++) {
-    const i = r[s];
-    if (/^\[\[\.\.\..+\]\]$/.test(i))
-      return s <= e.length;
-    if (/^\[\.\.\..+\]$/.test(i))
-      return s < e.length;
-    if (s >= e.length) return !1;
-    if (!/^\[.+\]$/.test(i) && i !== e[s])
+function U(n, t) {
+  const e = E(n), o = E(t);
+  for (let r = 0; r < o.length; r++) {
+    const s = o[r];
+    if (/^\[\[\.\.\..+\]\]$/.test(s))
+      return r <= e.length;
+    if (/^\[\.\.\..+\]$/.test(s))
+      return r < e.length;
+    if (r >= e.length) return !1;
+    if (!/^\[.+\]$/.test(s) && s !== e[r])
       return !1;
   }
-  return r.length === e.length;
+  return o.length === e.length;
 }
-function F(t, n = []) {
-  for (const e of t)
-    n.push({ page: e, segments: d(e.path) }), e.children && F(e.children, n);
-  return n;
+function Y(n, t = []) {
+  for (const e of n)
+    t.push({ page: e, segments: E(e.path) }), e.children && Y(e.children, t);
+  return t;
 }
-function D(t) {
-  return t.external ?? /^https?:\/\//.test(t.path);
+function C(n) {
+  return n.external ?? /^https?:\/\//.test(n.path);
 }
-function X(t, n) {
-  const e = structuredClone(t), r = F(e.pages), s = r.filter((u) => !D(u.page)), i = (u) => s.some(
-    (f) => f.page.path === u.routePath || R(f.page.path, u.routePath)
-  ), a = n.filter((u) => !i(u)), o = (u) => n.some(
-    (f) => f.routePath === u.page.path || R(u.page.path, f.routePath)
-  ), l = s.filter((u) => !o(u)).map((u) => u.page.path), c = [], h = [...r], m = [...a].sort(
-    (u, f) => d(u.routePath).length - d(f.routePath).length
+function ft(n, t) {
+  const e = structuredClone(n), o = Y(e.pages), r = o.filter((d) => !C(d.page)), s = (d) => r.some(
+    (c) => c.page.path === d.routePath || U(c.page.path, d.routePath)
+  ), a = t.filter((d) => !s(d)), i = (d) => t.some(
+    (c) => c.routePath === d.page.path || U(d.page.path, c.routePath)
+  ), h = r.filter((d) => !i(d)).map((d) => d.page.path), p = [], g = [...o], w = [...a].sort(
+    (d, c) => E(d.routePath).length - E(c.routePath).length
   );
-  for (const u of m) {
-    const f = d(u.routePath), y = { path: u.routePath, title: u.title ?? f.at(-1) ?? "/" };
-    let P;
-    for (const x of h) {
-      if (D(x.page)) continue;
-      const S = x.segments;
-      S.length >= f.length || S.every((L, U) => L === f[U]) && (!P || S.length > P.segments.length) && (P = x);
+  for (const d of w) {
+    const c = E(d.routePath), l = { path: d.routePath, title: d.title ?? c.at(-1) ?? "/" };
+    let u;
+    for (const S of g) {
+      if (C(S.page)) continue;
+      const $ = S.segments;
+      $.length >= c.length || $.every((y, I) => y === c[I]) && (!u || $.length > u.segments.length) && (u = S);
     }
-    P ? (P.page.children ??= []).push(y) : e.pages.push(y), h.push({ page: y, segments: f }), c.push(u.routePath);
+    u ? (u.page.children ??= []).push(l) : e.pages.push(l), g.push({ page: l, segments: c }), p.push(d.routePath);
   }
-  return { config: e, added: c, removed: l };
+  return { config: e, added: p, removed: h };
 }
-const Q = /^page\.(tsx|jsx|ts|js)$/, Z = /^\(.+\)$/, H = /^\(\.{1,3}\)/;
-function O(t) {
-  for (const n of ["app", "src/app"])
-    if (w(g(t, n))) return g(t, n);
+const mt = /^page\.(tsx|jsx|ts|js)$/, gt = /^\(.+\)$/, wt = /^\(\.{1,3}\)/;
+function J(n) {
+  for (const t of ["app", "src/app"])
+    if (v(f(n, t))) return f(n, t);
   return null;
 }
-function K(t) {
-  const n = [];
-  for (const e of t) {
-    if (e.startsWith("@") || e.startsWith("_") || H.test(e)) return null;
-    Z.test(e) || n.push(e);
+function $t(n) {
+  const t = [];
+  for (const e of n) {
+    if (e.startsWith("@") || e.startsWith("_") || wt.test(e)) return null;
+    gt.test(e) || t.push(e);
   }
-  return `/${n.join("/")}`;
+  return `/${t.join("/")}`;
 }
-function Y(t) {
-  const n = t.match(
+function yt(n) {
+  const t = n.match(
     /export\s+const\s+metadata\s*(?::\s*[A-Za-z_$][\w$.]*\s*)?=\s*\{(?:[^{}]*?[,\s])?title\s*:\s*(['"])((?:\\.|(?!\1)[^\\])*)\1/
   );
-  return n ? n[2] : void 0;
+  return t ? t[2] : void 0;
 }
-function _(t, n, e) {
-  for (const r of N(t, { withFileTypes: !0 }))
-    r.isDirectory() ? _(g(t, r.name), [...n, r.name], e) : Q.test(r.name) && e.push({ file: g(t, r.name), segments: n });
+function Q(n, t, e) {
+  for (const o of D(n, { withFileTypes: !0 }))
+    o.isDirectory() ? Q(f(n, o.name), [...t, o.name], e) : mt.test(o.name) && e.push({ file: f(n, o.name), segments: t });
 }
-const tt = {
+const bt = {
   name: "next-app",
-  detect(t) {
-    return O(t) !== null;
+  detect(n) {
+    return J(n) !== null;
   },
-  scan(t) {
-    const n = O(t);
-    if (!n) return [];
+  scan(n) {
+    const t = J(n);
+    if (!t) return [];
     const e = [];
-    _(n, [], e);
-    const r = [];
-    for (const { file: s, segments: i } of e) {
-      const a = K(i);
-      a !== null && r.push({
+    Q(t, [], e);
+    const o = [];
+    for (const { file: r, segments: s } of e) {
+      const a = $t(s);
+      a !== null && o.push({
         routePath: a,
         isDynamic: /\[.+\]/.test(a),
-        title: Y(I(s, "utf8"))
+        title: yt(O(r, "utf8"))
       });
     }
-    return r;
+    return o;
   }
-}, T = /\.(tsx|jsx|ts|js)$/, et = /* @__PURE__ */ new Set(["_app", "_document", "_error", "404", "500"]);
-function j(t) {
-  for (const n of ["pages", "src/pages"])
-    if (w(g(t, n))) return g(t, n);
+}, H = /\.(tsx|jsx|ts|js)$/, St = /* @__PURE__ */ new Set(["_app", "_document", "_error", "404", "500"]);
+function B(n) {
+  for (const t of ["pages", "src/pages"])
+    if (v(f(n, t))) return f(n, t);
   return null;
 }
-function C(t, n, e) {
-  for (const r of N(t, { withFileTypes: !0 })) {
-    if (r.isDirectory()) {
-      if (n.length === 0 && r.name === "api") continue;
-      C(g(t, r.name), [...n, r.name], e);
+function q(n, t, e) {
+  for (const o of D(n, { withFileTypes: !0 })) {
+    if (o.isDirectory()) {
+      if (t.length === 0 && o.name === "api") continue;
+      q(f(n, o.name), [...t, o.name], e);
       continue;
     }
-    if (!T.test(r.name)) continue;
-    const s = r.name.replace(T, "");
-    if (et.has(s)) continue;
-    const a = `/${(s === "index" ? n : [...n, s]).join("/")}`;
+    if (!H.test(o.name)) continue;
+    const r = o.name.replace(H, "");
+    if (St.has(r)) continue;
+    const a = `/${(r === "index" ? t : [...t, r]).join("/")}`;
     e.push({ routePath: a, isDynamic: /\[.+\]/.test(a) });
   }
 }
-const nt = {
+const Pt = {
   name: "next-pages",
-  detect(t) {
-    return j(t) !== null;
+  detect(n) {
+    return B(n) !== null;
   },
-  scan(t) {
-    const n = j(t);
-    if (!n) return [];
+  scan(n) {
+    const t = B(n);
+    if (!t) return [];
     const e = [];
-    return C(n, [], e), e;
+    return q(t, [], e), e;
   }
-}, rt = `import { defineIA } from "pubuilder"
+}, vt = `import { defineIA } from "pubuilder/config"
 
 // pubuilder scan은 아직 이 프로젝트의 라우팅 방식을 지원하지 않아요 (v1은 Next.js 전용).
 // 아래 예시를 참고해 앱의 화면 구조를 직접 작성해주세요.
@@ -252,79 +256,579 @@ export default defineIA({
     },
   ],
 })
-`, st = [tt, nt];
-function ot(t) {
-  const n = g(t, "package.json");
-  if (!w(n)) return !1;
+`;
+class m extends Error {
+  constructor(t, e, o = 400) {
+    super(`${t}: ${e}`), this.code = t, this.status = o;
+  }
+}
+function It(n) {
+  let t;
+  try {
+    t = new URL(n);
+  } catch {
+    throw new m("INVALID_FIGMA_URL", "URL 형식이 아니에요");
+  }
+  if (!/(^|\.)figma\.com$/.test(t.hostname))
+    throw new m("INVALID_FIGMA_URL", "figma.com 링크가 아니에요");
+  const e = t.pathname.match(/^\/(?:design|file)\/([A-Za-z0-9]+)(?:\/|$)/);
+  if (!e) throw new m("INVALID_FIGMA_URL", "fileKey를 찾지 못했어요");
+  const o = t.searchParams.get("node-id");
+  if (!o)
+    throw new m("INVALID_FIGMA_URL", "node-id가 없어요. Figma에서 프레임 우클릭 → Copy link로 복사해주세요");
+  return { fileKey: e[1], nodeId: o.replace(/-/g, ":") };
+}
+function F(n) {
+  return f(n, ".pubuilder", "credentials.json");
+}
+function K(n) {
+  const t = F(n.homeDir);
+  if (v(t))
+    try {
+      const o = JSON.parse(O(t, "utf8"));
+      if (o.figmaToken) return o.figmaToken;
+    } catch {
+    }
+  if (n.env.FIGMA_TOKEN) return n.env.FIGMA_TOKEN;
+  const e = f(n.projectRoot, ".env");
+  if (v(e)) {
+    const o = O(e, "utf8").split(`
+`).find((r) => r.trim().startsWith("FIGMA_TOKEN="));
+    if (o) {
+      const r = o.slice(o.indexOf("=") + 1).trim().replace(/^["']|["']$/g, "");
+      if (r) return r;
+    }
+  }
+  return null;
+}
+function Tt(n, t) {
+  j(f(n, ".pubuilder"), { recursive: !0 }), R(F(n), JSON.stringify({ figmaToken: t }, null, 2), { mode: 384 });
+}
+function Et(n) {
+  W(F(n), { force: !0 });
+}
+function At(n) {
+  return n.length <= 5 ? "*".repeat(n.length) : `${n.slice(0, 5)}${"*".repeat(Math.max(4, n.length - 5))}`;
+}
+async function Ot(n, t, e, o = fetch) {
+  const r = { "X-Figma-Token": t }, s = await o(
+    `https://api.figma.com/v1/files/${n.fileKey}/nodes?ids=${encodeURIComponent(n.nodeId)}`,
+    { headers: r }
+  );
+  if (s.status === 403) throw new m("FIGMA_API_ERROR", "Figma 토큰이 유효하지 않아요. 스킬함 설정에서 토큰을 확인해주세요", 403);
+  if (!s.ok) throw new m("FIGMA_API_ERROR", `Figma API 오류 (${s.status})`, 502);
+  const i = (await s.json()).nodes[n.nodeId]?.document;
+  if (!i) throw new m("FIGMA_API_ERROR", "해당 노드를 찾지 못했어요. URL의 node-id를 확인해주세요", 404);
+  const h = await o(
+    `https://api.figma.com/v1/images/${n.fileKey}?ids=${encodeURIComponent(n.nodeId)}&format=png&scale=2`,
+    { headers: r }
+  );
+  if (!h.ok) throw new m("FIGMA_API_ERROR", `이미지 export 실패 (${h.status})`, 502);
+  const g = (await h.json()).images[n.nodeId];
+  if (!g) throw new m("FIGMA_API_ERROR", "이미지 export URL이 비어 있어요", 502);
+  const w = await (await o(g)).arrayBuffer();
+  j(e, { recursive: !0 });
+  const d = n.nodeId.replace(/[^A-Za-z0-9_-]/g, "-"), c = f(e, `${n.fileKey}-${d}.png`);
+  return R(c, Buffer.from(w)), { nodeJson: i, imagePath: c };
+}
+function V(n) {
+  const t = n.match(/^---\n([\s\S]*?)\n---/);
+  if (!t) return {};
+  const e = (o) => t[1].match(new RegExp(`^${o}:\\s*(.+)$`, "m"))?.[1].trim();
+  return { name: e("name"), description: e("description") };
+}
+class Rt {
+  projectRoot;
+  homeDir;
+  constructor(t) {
+    this.projectRoot = t.projectRoot, this.homeDir = t.homeDir;
+  }
+  settingsPath() {
+    return f(this.projectRoot, ".pubuilder", "settings.json");
+  }
+  loadSettings() {
+    if (!v(this.settingsPath())) return { skills: {} };
+    try {
+      return JSON.parse(O(this.settingsPath(), "utf8"));
+    } catch {
+      return { skills: {} };
+    }
+  }
+  saveSettings(t) {
+    j(f(this.projectRoot, ".pubuilder"), { recursive: !0 }), R(this.settingsPath(), JSON.stringify(t, null, 2));
+  }
+  scanDir(t, e) {
+    if (!v(t)) return [];
+    const o = [];
+    for (const r of D(t, { withFileTypes: !0 })) {
+      if (!r.isDirectory()) continue;
+      const s = f(t, r.name, "SKILL.md");
+      if (!v(s)) continue;
+      const a = V(O(s, "utf8"));
+      o.push({
+        id: `${e}:${r.name}`,
+        name: a.name ?? r.name,
+        description: a.description ?? "",
+        source: e,
+        path: s
+      });
+    }
+    return o;
+  }
+  scanAll() {
+    return [
+      ...this.scanDir(f(this.projectRoot, ".claude", "skills"), "project"),
+      ...this.scanDir(f(this.homeDir, ".claude", "skills"), "global"),
+      ...this.scanDir(f(this.projectRoot, ".pubuilder", "skills"), "uploaded")
+    ];
+  }
+  /** 기본값: project·uploaded on, global off (스펙 결정) */
+  list() {
+    const t = this.loadSettings();
+    return this.scanAll().map(({ path: e, ...o }) => ({
+      ...o,
+      enabled: t.skills[o.id] ?? o.source !== "global"
+    }));
+  }
+  setEnabled(t, e) {
+    if (!this.scanAll().some((r) => r.id === t)) throw new m("NOT_FOUND", `스킬 없음: ${t}`, 404);
+    const o = this.loadSettings();
+    o.skills[t] = e, this.saveSettings(o);
+  }
+  upload(t, e) {
+    const o = V(e), r = (o.name ?? t.replace(/\.md$/i, "")).trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(r))
+      throw new m("INVALID_NAME", `스킬 이름이 유효하지 않아요: ${r}`, 400);
+    const s = f(this.projectRoot, ".pubuilder", "skills", r);
+    return j(s, { recursive: !0 }), R(f(s, "SKILL.md"), e), { id: `uploaded:${r}`, name: r, description: o.description ?? "", source: "uploaded", enabled: !0 };
+  }
+  /** 삭제는 uploaded만 — 유저의 .claude/skills를 지우는 사고 방지 (스펙) */
+  remove(t) {
+    if (!t.startsWith("uploaded:")) throw new m("FORBIDDEN", "업로드된 스킬만 삭제할 수 있어요", 403);
+    if (!this.scanAll().some((s) => s.id === t)) throw new m("NOT_FOUND", `스킬 없음: ${t}`, 404);
+    const e = t.slice(9), o = f(this.projectRoot, ".pubuilder", "skills", e);
+    W(o, { recursive: !0 });
+    const r = this.loadSettings();
+    delete r.skills[t], this.saveSettings(r);
+  }
+  enabledSkillContents() {
+    const t = this.loadSettings();
+    return this.scanAll().filter((e) => t.skills[e.id] ?? e.source !== "global").map((e) => ({ name: e.name, content: O(e.path, "utf8") }));
+  }
+}
+function Nt(n) {
+  const { selection: t, figma: e } = n, o = n.skills.length ? `
+# 적용할 스킬 지침
+
+다른 스킬은 사용하지 말고, 아래에 명시된 스킬 지침만 따르세요.
+
+${n.skills.map((r) => `## 스킬: ${r.name}
+
+${r.content}`).join(`
+
+---
+
+`)}
+` : `
+다른 스킬은 스스로 판단해 사용하지 마세요. 아래에 명시된 스킬 지침만 따르세요 (이번 요청에는 없음).
+`;
+  return `이 프로젝트의 특정 UI 블록을 Figma 시안대로 수정하는 퍼블리싱 작업입니다.
+
+# 대상 블록
+- 페이지 라우트: ${t.pagePath}
+- CSS selector (렌더된 DOM 기준): ${t.selector}
+- 태그/라벨: <${t.tag}> "${t.label}" (선택 단위: ${t.granularity})
+- 렌더된 outerHTML 스냅샷 (소스 파일을 찾는 단서):
+\`\`\`html
+${n.outerHTML}
+\`\`\`
+
+# Figma 시안
+- 링크: ${e.url}
+- 렌더 이미지 (Read 도구로 반드시 열어 육안 확인): ${e.imagePath}
+- 노드 JSON:
+\`\`\`json
+${JSON.stringify(e.nodeJson, null, 2)}
+\`\`\`
+${o}
+# 작업 순서
+1. 위 라우트와 outerHTML 스냅샷을 단서로, 이 블록을 렌더링하는 소스 컴포넌트 파일을 찾으세요.
+2. Figma 렌더 이미지를 Read 도구로 열어 시안을 육안으로 확인하세요. 노드 JSON의 수치(색상/간격/타이포)를 우선 근거로 쓰되, JSON에만 있고 이미지에 보이지 않는 요소는 구현하지 마세요.
+3. 해당 블록만 시안대로 수정하세요. 블록 바깥의 코드는 건드리지 마세요.
+4. 수정 후 타입체크(pnpm type-check)가 있으면 실행해 통과를 확인하세요.
+5. 마지막 메시지에 수정한 파일 경로를 나열하세요.`;
+}
+function xt(n) {
+  let t;
+  try {
+    t = JSON.parse(n);
+  } catch {
+    return [];
+  }
+  if (t.type === "result")
+    return [
+      t.subtype === "success" ? { type: "done", text: String(t.result ?? "완료") } : { type: "error", text: String(t.result ?? t.subtype ?? "실패") }
+    ];
+  if (t.type === "assistant") {
+    const e = [];
+    for (const o of t.message?.content ?? [])
+      if (o.type === "text" && o.text && e.push({ type: "log", text: o.text }), o.type === "tool_use") {
+        const r = o.input?.file_path ?? o.input?.command ?? "";
+        e.push({ type: "tool", text: `${o.name}: ${r}`.trim() });
+      }
+    return e;
+  }
+  return [];
+}
+const z = 600 * 1e3, kt = {
+  run({ prompt: n, cwd: t, onEvent: e, signal: o }) {
+    return new Promise((r) => {
+      const s = X("claude", [
+        "-p",
+        n,
+        "--output-format",
+        "stream-json",
+        "--verbose",
+        "--permission-mode",
+        "acceptEdits",
+        "--allowedTools",
+        "Read,Glob,Grep,Edit,Write,Bash(pnpm type-check:*)",
+        // 유저/프로젝트 settings.json을 배제 — allowedTools는 기존 허용 규칙에 "추가"만 하므로,
+        // 설정을 로드하면 개발자 머신의 관대한 allow 규칙이 화이트리스트를 무력화한다 (e2e에서 확인)
+        "--setting-sources",
+        ""
+      ], { cwd: t, env: process.env });
+      let a = !1;
+      const i = (c) => {
+        a || (a = !0, clearTimeout(p), c && e(c), r());
+      }, h = () => {
+        s.kill("SIGKILL"), i({ type: "error", text: "에이전트가 10분간 응답이 없어 중단했어요" });
+      };
+      let p = setTimeout(h, z);
+      const g = () => {
+        a || (clearTimeout(p), p = setTimeout(h, z));
+      };
+      o?.addEventListener("abort", () => {
+        s.kill("SIGKILL"), i({ type: "error", text: "사용자가 중단했어요" });
+      }), s.on("error", (c) => {
+        i({
+          type: "error",
+          text: c.code === "ENOENT" ? "claude CLI를 찾지 못했어요. https://claude.com/claude-code 에서 설치 후 claude login 해주세요" : `claude 실행 실패: ${c.message}`
+        });
+      });
+      const w = [];
+      s.stderr.on("data", (c) => w.push(String(c)));
+      let d = !1;
+      ct({ input: s.stdout }).on("line", (c) => {
+        g();
+        const l = xt(c);
+        for (const u of l)
+          e(u), (u.type === "done" || u.type === "error") && (d = !0);
+      }), s.on("close", (c) => {
+        if (c !== 0 && !d) {
+          const l = w.join("").trim();
+          i({ type: "error", text: l || `claude가 코드 ${c}로 종료됐어요. claude login 상태를 확인해주세요` });
+        } else
+          i();
+      });
+    });
+  }
+}, _t = 20;
+class jt {
+  constructor(t) {
+    this.adapter = t;
+  }
+  jobs = /* @__PURE__ */ new Map();
+  active = null;
+  seq = 0;
+  start(t) {
+    if (this.active && !this.active.finished) throw new m("BUSY", "이미 퍼블리싱이 실행 중이에요", 409);
+    const e = `job-${++this.seq}`, o = new AbortController(), r = { id: e, events: [], listeners: /* @__PURE__ */ new Set(), controller: o, done: Promise.resolve(), finished: !1 }, s = (a) => {
+      r.events.push(a);
+      for (const i of r.listeners) i(a);
+    };
+    return r.done = this.adapter.run({ ...t, onEvent: s, signal: o.signal }).catch((a) => s({ type: "error", text: a instanceof Error ? a.message : String(a) })).finally(() => {
+      r.finished = !0, this.evictFinishedJobs();
+    }), this.jobs.set(e, r), this.active = r, e;
+  }
+  /** finished job이 상한을 넘으면 가장 오래된 것부터 제거 (active job은 finished=false라 대상에서 제외) */
+  evictFinishedJobs() {
+    const t = [...this.jobs.entries()].filter(([, e]) => e.finished).map(([e]) => e);
+    for (; t.length > _t; ) {
+      const e = t.shift();
+      if (e === void 0) break;
+      this.jobs.delete(e);
+    }
+  }
+  /** SSE 핸들러가 헤더 전송 전에 job 존재를 확인할 때 사용 (subscribe는 replay 부작용이 있어 분리) */
+  has(t) {
+    return this.jobs.has(t);
+  }
+  subscribe(t, e) {
+    const o = this.jobs.get(t);
+    if (!o) throw new m("NOT_FOUND", `job 없음: ${t}`, 404);
+    for (const r of o.events) e(r);
+    return o.listeners.add(e), () => o.listeners.delete(e);
+  }
+  cancel(t) {
+    const e = this.jobs.get(t);
+    if (!e) throw new m("NOT_FOUND", `job 없음: ${t}`, 404);
+    e.controller.abort();
+  }
+  waitFor(t) {
+    const e = this.jobs.get(t);
+    if (!e) throw new m("NOT_FOUND", `job 없음: ${t}`, 404);
+    return e.done;
+  }
+}
+const Dt = 4816, Ft = 1024 * 1024, Lt = /^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?$/;
+function _(n) {
+  return new Promise((t, e) => {
+    const o = [];
+    let r = 0;
+    n.on("data", (s) => {
+      if (r += s.length, r > Ft) {
+        e(new m("PAYLOAD_TOO_LARGE", "요청 본문이 너무 커요 (1MB 초과)", 413)), n.destroy();
+        return;
+      }
+      o.push(s);
+    }), n.on("end", () => {
+      if (o.length === 0) {
+        t(void 0);
+        return;
+      }
+      try {
+        t(JSON.parse(Buffer.concat(o).toString("utf8")));
+      } catch {
+        e(new m("INVALID_JSON", "JSON 파싱에 실패했어요", 400));
+      }
+    }), n.on("error", e);
+  });
+}
+function T(n, t, e) {
+  const o = JSON.stringify(e);
+  n.writeHead(t, { "content-type": "application/json" }), n.end(o);
+}
+async function Mt(n) {
+  const t = n.projectRoot, e = n.homeDir ?? it(), o = n.adapter ?? kt, r = n.figmaFetch ?? fetch, s = new Rt({ projectRoot: t, homeDir: e }), a = new jt(o);
+  async function i(c) {
+    const l = await _(c), { selection: u, outerHTML: S, figmaUrl: $ } = l ?? {}, y = It(String($ ?? ""));
+    if (typeof u != "object" || u === null || typeof u.pagePath != "string" || typeof u.selector != "string" || typeof S != "string")
+      throw new m("INVALID_JSON", "selection/outerHTML 형식이 올바르지 않아요", 400);
+    const I = K({ projectRoot: t, homeDir: e, env: process.env });
+    if (!I) throw new m("NO_FIGMA_TOKEN", "Figma 토큰이 설정되지 않았어요. 스킬함 설정에서 등록해주세요", 401);
+    const { nodeJson: x, imagePath: k } = await Ot(y, I, f(t, ".pubuilder/cache"), r), b = Nt({
+      selection: u,
+      outerHTML: S ?? "",
+      figma: { url: String($), nodeJson: x, imagePath: k },
+      skills: s.enabledSkillContents()
+    });
+    return { status: 202, body: { jobId: a.start({ prompt: b, cwd: t }) } };
+  }
+  function h(c, l, u) {
+    if (!a.has(u)) throw new m("NOT_FOUND", `job 없음: ${u}`, 404);
+    l.writeHead(200, {
+      "content-type": "text/event-stream",
+      "cache-control": "no-cache",
+      connection: "keep-alive"
+    });
+    let S = () => {
+    };
+    const $ = (y) => {
+      l.write(`data: ${JSON.stringify(y)}
+
+`), (y.type === "done" || y.type === "error") && (S(), l.end());
+    };
+    S = a.subscribe(u, $), c.on("close", S);
+  }
+  const p = st((c, l) => {
+    (async () => {
+      try {
+        const u = c.headers.origin;
+        if (u && !Lt.test(u)) {
+          T(l, 403, { code: "FORBIDDEN", message: "허용되지 않은 origin이에요" });
+          return;
+        }
+        if (u && (l.setHeader("Access-Control-Allow-Origin", u), l.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,PATCH,DELETE"), l.setHeader("Access-Control-Allow-Headers", "content-type")), c.method === "OPTIONS") {
+          l.writeHead(204), l.end();
+          return;
+        }
+        const $ = new URL(c.url ?? "/", "http://localhost").pathname, y = c.method ?? "GET";
+        if (y === "GET" && $ === "/api/health") {
+          T(l, 200, { ok: !0 });
+          return;
+        }
+        if (y === "GET" && $ === "/api/skills") {
+          T(l, 200, s.list());
+          return;
+        }
+        if (y === "POST" && $ === "/api/skills") {
+          const b = await _(c), N = s.upload(b.filename, b.content);
+          T(l, 201, N);
+          return;
+        }
+        const I = $.match(/^\/api\/skills\/([^/]+)$/);
+        if (I && y === "PATCH") {
+          const b = decodeURIComponent(I[1]), N = await _(c);
+          s.setEnabled(b, N.enabled), l.writeHead(204), l.end();
+          return;
+        }
+        if (I && y === "DELETE") {
+          const b = decodeURIComponent(I[1]);
+          s.remove(b), l.writeHead(204), l.end();
+          return;
+        }
+        if (y === "GET" && $ === "/api/settings/figma-token") {
+          const b = K({ projectRoot: t, homeDir: e, env: process.env });
+          T(l, 200, { configured: b != null, masked: b ? At(b) : null });
+          return;
+        }
+        if (y === "PUT" && $ === "/api/settings/figma-token") {
+          const b = await _(c);
+          Tt(e, b.token), l.writeHead(204), l.end();
+          return;
+        }
+        if (y === "DELETE" && $ === "/api/settings/figma-token") {
+          Et(e), l.writeHead(204), l.end();
+          return;
+        }
+        if (y === "POST" && $ === "/api/publish") {
+          const { status: b, body: N } = await i(c);
+          T(l, b, N);
+          return;
+        }
+        const x = $.match(/^\/api\/publish\/([^/]+)\/events$/);
+        if (x && y === "GET") {
+          h(c, l, x[1]);
+          return;
+        }
+        const k = $.match(/^\/api\/publish\/([^/]+)$/);
+        if (k && y === "DELETE") {
+          a.cancel(k[1]), l.writeHead(204), l.end();
+          return;
+        }
+        T(l, 404, { code: "NOT_FOUND", message: "해당 경로를 찾을 수 없어요" });
+      } catch (u) {
+        if (u instanceof m) {
+          T(l, u.status, { code: u.code, message: u.message });
+          return;
+        }
+        const S = u instanceof Error ? u.message : String(u);
+        T(l, 500, { code: "INTERNAL", message: S });
+      }
+    })();
+  }), g = n.port ?? Dt;
+  await new Promise((c) => p.listen(g, "127.0.0.1", c));
+  const w = p.address();
+  return {
+    port: typeof w == "object" && w ? w.port : g,
+    close() {
+      p.close();
+    }
+  };
+}
+async function tt(n, t) {
+  const e = await Mt({ projectRoot: n, port: t.port ?? 4816 });
+  return console.log(`[pubuilder] 컴패니언 서버 실행 중: http://localhost:${e.port}`), console.log("[pubuilder] 미니맵의 퍼블리싱 패널이 이 서버에 연결됩니다. Ctrl+C로 종료."), e;
+}
+function et(n) {
+  const t = n.indexOf("--port");
+  if (t === -1) return;
+  const e = Number(n[t + 1]);
+  if (!Number.isInteger(e) || e < 0 || e > 65535)
+    throw new Error("--port 값이 유효하지 않아요 (0-65535)");
+  return e;
+}
+async function Gt(n, t) {
+  const e = t.indexOf("--"), o = e === -1 ? [] : t.slice(e + 1);
+  if (o.length === 0)
+    return console.error("사용법: pubuilder dev [--port N] -- <dev 명령> (예: pubuilder dev -- next dev)"), 1;
+  const r = await tt(n, { port: et(t.slice(0, e === -1 ? void 0 : e)) });
+  return new Promise((s) => {
+    const a = X(o[0], o.slice(1), { cwd: n, stdio: "inherit", env: process.env }), i = () => a.kill("SIGINT"), h = () => a.kill("SIGTERM");
+    process.on("SIGINT", i), process.on("SIGTERM", h);
+    const p = () => {
+      process.off("SIGINT", i), process.off("SIGTERM", h), r.close();
+    };
+    a.on("error", (g) => {
+      console.error(`[pubuilder] 명령 실행 실패: ${g.message}`), p(), s(1);
+    }), a.on("close", (g, w) => {
+      p(), s(w ? 128 + (at.signals[w] ?? 0) : g ?? 0);
+    });
+  });
+}
+const Ut = [bt, Pt];
+function Ct(n) {
+  const t = f(n, "package.json");
+  if (!v(t)) return !1;
   try {
-    const e = JSON.parse(I(n, "utf8"));
+    const e = JSON.parse(O(t, "utf8"));
     return !!(e.dependencies?.next ?? e.devDependencies?.next);
   } catch {
     return console.warn("[pubuilder] package.json 파싱 실패 — JSON 문법을 확인해주세요"), !1;
   }
 }
-function it(t) {
-  if (!ot(t)) return null;
-  const n = st.filter((s) => s.detect(t));
-  if (n.length === 0) return null;
-  const e = /* @__PURE__ */ new Map(), r = [];
-  for (const s of n)
-    for (const i of s.scan(t)) {
-      const a = e.get(i.routePath);
+function Jt(n) {
+  if (!Ct(n)) return null;
+  const t = Ut.filter((r) => r.detect(n));
+  if (t.length === 0) return null;
+  const e = /* @__PURE__ */ new Map(), o = [];
+  for (const r of t)
+    for (const s of r.scan(n)) {
+      const a = e.get(s.routePath);
       if (a) {
-        console.warn(`[pubuilder] path 충돌: ${i.routePath} (${a} 우선, ${s.name} 무시)`);
+        console.warn(`[pubuilder] path 충돌: ${s.routePath} (${a} 우선, ${r.name} 무시)`);
         continue;
       }
-      e.set(i.routePath, s.name), r.push(i);
+      e.set(s.routePath, r.name), o.push(s);
     }
-  return r;
+  return o;
 }
-async function at(t) {
-  const e = await J(import.meta.url).import(t, { default: !0 });
+async function Ht(n) {
+  const e = await rt(import.meta.url).import(n, { default: !0 });
   if (!e || !Array.isArray(e.pages))
     throw new Error("[pubuilder] ia.config.ts의 default export에서 pages 배열을 찾지 못했어요");
   return e;
 }
-async function ut(t, n) {
-  const e = it(t), r = g(t, "ia.config.ts");
+async function Bt(n, t) {
+  const e = Jt(n), o = f(n, "ia.config.ts");
   if (e === null)
-    return console.error("[pubuilder] 지원하지 않는 라우팅 방식이에요. v1은 Next.js(App/Pages Router) 전용입니다."), !w(r) && !n.dryRun && (v(r, rt), console.log(`[pubuilder] 작성법 안내가 담긴 예시 템플릿을 생성했어요: ${r}`)), { kind: "unsupported" };
-  if (w(r)) {
-    const o = await at(r), { config: l, added: c, removed: h } = X(o, e);
-    b(l), n.dryRun || v(r, A(l, { newPaths: new Set(c) }));
-    for (const m of c) console.log(`[pubuilder] + 추가됨: ${m}`);
-    for (const m of h) console.log(`[pubuilder] - 라우트에서 사라짐 (config엔 유지): ${m}`);
-    return c.length === 0 && h.length === 0 && console.log("[pubuilder] 변경 없음"), n.dryRun && console.log("[pubuilder] (dry-run) 파일은 수정하지 않았어요"), { kind: "merged", added: c, removed: h };
-  }
-  const i = { pages: B(e) };
-  b(i);
-  const a = e.map((o) => o.routePath);
-  return n.dryRun ? console.log(`[pubuilder] (dry-run) 생성 예정: ${a.length}개 라우트. 파일은 수정하지 않았어요.`) : (v(r, A(i, { newPaths: new Set(a) })), console.log(`[pubuilder] ia.config.ts 초안을 생성했어요 (${a.length}개 라우트). title과 [param] 샘플 경로를 다듬어주세요.`)), { kind: "created", paths: a };
-}
-async function ct(t) {
-  const [n, ...e] = t;
-  if (n !== "scan")
-    return console.error("사용법: pubuilder scan [--dry-run]"), 1;
+    return console.error("[pubuilder] 지원하지 않는 라우팅 방식이에요. v1은 Next.js(App/Pages Router) 전용입니다."), !v(o) && !t.dryRun && (R(o, vt), console.log(`[pubuilder] 작성법 안내가 담긴 예시 템플릿을 생성했어요: ${o}`)), { kind: "unsupported" };
+  if (v(o)) {
+    const i = await Ht(o), { config: h, added: p, removed: g } = ft(i, e);
+    M(h), t.dryRun || R(o, G(h, { newPaths: new Set(p) }));
+    for (const w of p) console.log(`[pubuilder] + 추가됨: ${w}`);
+    for (const w of g) console.log(`[pubuilder] - 라우트에서 사라짐 (config엔 유지): ${w}`);
+    return p.length === 0 && g.length === 0 && console.log("[pubuilder] 변경 없음"), t.dryRun && console.log("[pubuilder] (dry-run) 파일은 수정하지 않았어요"), { kind: "merged", added: p, removed: g };
+  }
+  const s = { pages: dt(e) };
+  M(s);
+  const a = e.map((i) => i.routePath);
+  return t.dryRun ? console.log(`[pubuilder] (dry-run) 생성 예정: ${a.length}개 라우트. 파일은 수정하지 않았어요.`) : (R(o, G(s, { newPaths: new Set(a) })), console.log(`[pubuilder] ia.config.ts 초안을 생성했어요 (${a.length}개 라우트). title과 [param] 샘플 경로를 다듬어주세요.`)), { kind: "created", paths: a };
+}
+async function Kt(n) {
+  const [t, ...e] = n;
   try {
-    return (await ut(process.cwd(), { dryRun: e.includes("--dry-run") })).kind === "unsupported" ? 1 : 0;
-  } catch (r) {
-    return console.error(`[pubuilder] 실패: ${r instanceof Error ? r.message : String(r)}`), 1;
+    return t === "scan" ? (await Bt(process.cwd(), { dryRun: e.includes("--dry-run") })).kind === "unsupported" ? 1 : 0 : t === "serve" ? (await tt(process.cwd(), { port: et(e) }), await new Promise(() => {
+    })) : t === "dev" ? await Gt(process.cwd(), e) : (console.error("사용법: pubuilder scan [--dry-run] | pubuilder serve [--port N] | pubuilder dev [--port N] -- <명령>"), 1);
+  } catch (o) {
+    return console.error(`[pubuilder] 실패: ${o instanceof Error ? o.message : String(o)}`), 1;
   }
 }
-function lt() {
-  const t = process.argv[1];
-  if (!t) return !1;
+function Vt() {
+  const n = process.argv[1];
+  if (!n) return !1;
   try {
-    return q(t) === G(import.meta.url);
+    return nt(n) === ot(import.meta.url);
   } catch {
     return !1;
   }
 }
-lt() && ct(process.argv.slice(2)).then(
-  (t) => process.exit(t),
+Vt() && Kt(process.argv.slice(2)).then(
+  (n) => process.exit(n),
   () => process.exit(1)
 );
 export {
-  ct as main,
-  ut as runScan
+  Kt as main,
+  Bt as runScan
 };