@bifos/dooray-cli 0.4.0 → 0.5.2

package/README.md

@@ -34,8 +34,9 @@ dooray doctor
 ### 프로젝트
 
 ```bash
-dooray project list                        # 프로젝트 목록
+dooray project list                        # 프로젝트 목록 (기본: public)
 dooray project list --search ocr           # 코드로 검색
+dooray project list --type private         # 개인 프로젝트 목록
 dooray project members tc-ocr              # 멤버 목록
 dooray project workflows tc-ocr            # 워크플로우 목록
 ```
@@ -53,10 +54,13 @@ dooray post get tc-ocr 42 --json           # JSON 출력
 
 ```bash
 dooray post create tc-ocr \
-  --subject "업무 제목" \
+  --title "업무 제목" \
   --body "본문 마크다운" \
   --to "담당자이름" \
   --priority normal
+
+# 본문을 파일에서 읽기 (--body와 --body-file은 동시 사용 불가)
+dooray post create tc-ocr --title "업무 제목" --body-file ./content.md
 ```
 
 ### 업무 수정
@@ -66,7 +70,10 @@ dooray post create tc-ocr \
 dooray post edit tc-ocr 42
 
 # 비대화형 (AI 에이전트 친화)
-dooray post edit tc-ocr 42 --subject "새 제목" --body "새 본문"
+dooray post edit tc-ocr 42 --title "새 제목" --body "새 본문"
+
+# 본문을 파일에서 읽기
+dooray post edit tc-ocr 42 --body-file ./updated.md
 ```
 
 ### 댓글
@@ -74,6 +81,7 @@ dooray post edit tc-ocr 42 --subject "새 제목" --body "새 본문"
 ```bash
 dooray post comment list tc-ocr 42
 dooray post comment add tc-ocr 42 --body "댓글 내용"
+dooray post comment add tc-ocr 42 --body-file ./comment.md
 ```
 
 ### 상태 변경
@@ -89,8 +97,10 @@ dooray post workflow tc-ocr 42 "진행 중"    # 워크플로우 변경
 dooray wiki list                           # 위키 목록
 dooray wiki pages tc-ocr                   # 페이지 목록
 dooray wiki page get tc-ocr <page-id>      # 페이지 상세
-dooray wiki page create tc-ocr             # 페이지 생성 ($EDITOR)
-dooray wiki page edit tc-ocr <page-id>     # 페이지 수정 ($EDITOR)
+dooray wiki page create tc-ocr --title "..." [--parent <page-id>] [--body "..." | --body-file <path>]
+dooray wiki page edit tc-ocr <page-id> --title "새 제목"                   # 제목만 (비대화형)
+dooray wiki page edit tc-ocr <page-id> --body "..." | --body-file <path>  # 본문만 (비대화형)
+dooray wiki page edit tc-ocr <page-id>                                     # $EDITOR (플래그 없을 때)
 ```
 
 ### 메일
@@ -166,7 +176,7 @@ cp -r skills/dooray-cli ~/.claude/skills/
 
 ## 캐시
 
-프로젝트, 멤버, 워크플로우 정보는 `~/.dooray/cache/`에 캐시됩니다.
+프로젝트, 멤버, 워크플로우, 위키 정보는 `~/.dooray/cache/`에 캐시됩니다.
 
 ```bash
 dooray cache clear    # 캐시 삭제

package/dist/index.js

@@ -195,23 +195,25 @@ var import_node_os2 = require("os");
 var CACHE_DIR = (0, import_node_path2.join)((0, import_node_os2.homedir)(), ".dooray", "cache");
 var ME_PATH = (0, import_node_path2.join)(CACHE_DIR, "me.json");
 var PROJECTS_PATH = (0, import_node_path2.join)(CACHE_DIR, "projects.json");
+var PROJECTS_PRIVATE_PATH = (0, import_node_path2.join)(CACHE_DIR, "projects-private.json");
 var MEMBERS_DIR = (0, import_node_path2.join)(CACHE_DIR, "members");
 var WORKFLOWS_DIR = (0, import_node_path2.join)(CACHE_DIR, "workflows");
+var WIKIS_PATH = (0, import_node_path2.join)(CACHE_DIR, "wikis.json");
 async function ensureDir2(dir) {
   await (0, import_promises2.mkdir)(dir, { recursive: true });
 }
-async function readJson(path) {
+async function readJson(path3) {
   try {
-    const raw = await (0, import_promises2.readFile)(path, "utf-8");
+    const raw = await (0, import_promises2.readFile)(path3, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
   }
 }
-async function writeJson(path, data) {
-  const dir = path.substring(0, path.lastIndexOf("/"));
+async function writeJson(path3, data) {
+  const dir = path3.substring(0, path3.lastIndexOf("/"));
   await ensureDir2(dir);
-  await (0, import_promises2.writeFile)(path, JSON.stringify(data, null, 2) + "\n");
+  await (0, import_promises2.writeFile)(path3, JSON.stringify(data, null, 2) + "\n");
 }
 function isExpired(updatedAt, ttlMs) {
   if (!updatedAt) return true;
@@ -232,6 +234,12 @@ async function getProjects() {
 async function setProjects(items) {
   await writeJson(PROJECTS_PATH, { updatedAt: now(), data: items });
 }
+async function getPrivateProjects() {
+  return readJson(PROJECTS_PRIVATE_PATH);
+}
+async function setPrivateProjects(items) {
+  await writeJson(PROJECTS_PRIVATE_PATH, { updatedAt: now(), data: items });
+}
 function membersPath(projectId) {
   return (0, import_node_path2.join)(MEMBERS_DIR, `${projectId}.json`);
 }
@@ -250,6 +258,12 @@ async function getWorkflows(projectId) {
 async function setWorkflows(projectId, items) {
   await writeJson(workflowsPath(projectId), { updatedAt: now(), data: items });
 }
+async function getWikis() {
+  return readJson(WIKIS_PATH);
+}
+async function setWikis(items) {
+  await writeJson(WIKIS_PATH, { updatedAt: now(), data: items });
+}
 async function clearCache() {
   try {
     await (0, import_promises2.rm)(CACHE_DIR, { recursive: true, force: true });
@@ -289,11 +303,24 @@ cacheCommand.command("refresh").description("\uCE90\uC2DC \uAC31\uC2E0 (API \uD0
 // src/commands/doctor.ts
 var import_commander3 = require("commander");
 var import_chalk3 = __toESM(require("chalk"));
+var import_path = __toESM(require("path"));
+var import_promises4 = __toESM(require("fs/promises"));
 
 // src/api/client.ts
 var import_ky = __toESM(require("ky"));
 var import_promises3 = require("fs/promises");
 var import_node_path3 = require("path");
+
+// src/utils/dooray-message.ts
+function normalizeDoorayMessage(raw) {
+  try {
+    return decodeURIComponent(raw.replace(/\+/g, " "));
+  } catch {
+    return raw;
+  }
+}
+
+// src/api/client.ts
 function joinIds(ids) {
   return ids && ids.length > 0 ? ids.join(",") : void 0;
 }
@@ -304,7 +331,7 @@ async function toDoorayCliError(error) {
     try {
       const body = await error.response.json();
       throw new DoorayCliError(
-        `API \uD638\uCD9C \uC2E4\uD328: ${body.header.resultMessage}`,
+        `API \uD638\uCD9C \uC2E4\uD328: ${normalizeDoorayMessage(body.header.resultMessage)}`,
         exitCode
       );
     } catch (e) {
@@ -538,6 +565,20 @@ var DoorayApiClient = class {
       return toDoorayCliError(e);
     }
   }
+  async updateWikiPageTitle(wikiId, pageId, body) {
+    try {
+      return await this.api.put(`wiki/v1/wikis/${wikiId}/pages/${pageId}/title`, { json: body }).json();
+    } catch (e) {
+      return toDoorayCliError(e);
+    }
+  }
+  async updateWikiPageContent(wikiId, pageId, body) {
+    try {
+      return await this.api.put(`wiki/v1/wikis/${wikiId}/pages/${pageId}/content`, { json: body }).json();
+    } catch (e) {
+      return toDoorayCliError(e);
+    }
+  }
   // ─── Post Files ─────────────────────────────────────
   async getPostFiles(projectId, postId) {
     try {
@@ -636,6 +677,7 @@ var PROJECTS_TTL_MS = 36e5;
 var MEMBERS_TTL_MS = 36e5;
 var WORKFLOWS_TTL_MS = 864e5;
 var ME_TTL_MS = 864e5;
+var WIKIS_TTL_MS = 864e5;
 
 // src/resolvers/me.ts
 async function ensureMe(client) {
@@ -675,6 +717,35 @@ var doctorCommand = new import_commander3.Command("doctor").description("\uC124\
   console.log(`  \uD504\uB85C\uC81D\uD2B8:   ${stats.projectCount}\uAC1C`);
   console.log(`  \uBA64\uBC84:       ${stats.memberProjectCount}\uAC1C \uD504\uB85C\uC81D\uD2B8`);
   console.log(`  \uC6CC\uD06C\uD50C\uB85C\uC6B0: ${stats.workflowProjectCount}\uAC1C \uD504\uB85C\uC81D\uD2B8`);
+  const claudeDir = import_path.default.join(
+    process.env.HOME ?? process.env.USERPROFILE ?? "",
+    ".claude"
+  );
+  const claudeDirExists = await import_promises4.default.access(claudeDir).then(() => true).catch(() => false);
+  if (claudeDirExists) {
+    console.log(import_chalk3.default.bold("\n\u{1F527} Claude Code \uC2A4\uD0AC\n"));
+    const skillDst = import_path.default.join(claudeDir, "skills", "dooray-cli");
+    try {
+      const stat2 = await import_promises4.default.lstat(skillDst);
+      if (stat2.isSymbolicLink()) {
+        const target = await import_promises4.default.readlink(skillDst);
+        const targetExists = await import_promises4.default.access(target).then(() => true).catch(() => false);
+        if (targetExists) {
+          console.log(`  dooray-cli: ${import_chalk3.default.green("\u2705 \uC124\uCE58\uB428 (\uC2EC\uBCFC\uB9AD \uB9C1\uD06C)")}`);
+        } else {
+          console.log(
+            `  dooray-cli: ${import_chalk3.default.yellow("\u26A0\uFE0F \uB9C1\uD06C \uAE68\uC9D0 \u2014 dooray setup\uC73C\uB85C \uC7AC\uC124\uCE58")}`
+          );
+        }
+      } else {
+        console.log(`  dooray-cli: ${import_chalk3.default.green("\u2705 \uC124\uCE58\uB428 (\uBCF5\uC0AC\uBCF8)")}`);
+      }
+    } catch {
+      console.log(
+        `  dooray-cli: ${import_chalk3.default.red("\u274C \uBBF8\uC124\uCE58 \u2014 dooray setup\uC73C\uB85C \uC124\uCE58")}`
+      );
+    }
+  }
   console.log();
   if (apiKeyOk && baseUrlOk) {
     console.log(import_chalk3.default.green("\u2713 \uAE30\uBCF8 \uC124\uC815\uC774 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
@@ -688,6 +759,8 @@ var doctorCommand = new import_commander3.Command("doctor").description("\uC124\
 // src/commands/setup.ts
 var import_commander4 = require("commander");
 var import_chalk4 = __toESM(require("chalk"));
+var import_path2 = __toESM(require("path"));
+var import_promises5 = __toESM(require("fs/promises"));
 var setupCommand = new import_commander4.Command("setup").description("\uB300\uD654\uD615 \uCD08\uAE30 \uC124\uC815 \uB9C8\uBC95\uC0AC").action(async () => {
   const { input, select, password, confirm } = await import("@inquirer/prompts");
   const existing = await getConfig();
@@ -760,6 +833,45 @@ var setupCommand = new import_commander4.Command("setup").description("\uB300\uD
         theme: { prefix: "\u{1F512}" }
       });
     }
+    const claudeDir = import_path2.default.join(
+      process.env.HOME ?? process.env.USERPROFILE ?? "",
+      ".claude"
+    );
+    const claudeDirExists = await import_promises5.default.access(claudeDir).then(() => true).catch(() => false);
+    if (claudeDirExists) {
+      const isNpx = /_npx[/\\]/.test(__dirname) || /\.npm[/\\]_npx/.test(__dirname) || /npx-/.test(__dirname);
+      if (isNpx) {
+        console.log(
+          import_chalk4.default.yellow(
+            "  \u26A0 npx \uD658\uACBD\uC5D0\uC11C\uB294 \uC2A4\uD0AC \uC124\uCE58\uAC00 \uBD88\uAC00\uD569\uB2C8\uB2E4. npm i -g @bifos/dooray-cli \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694."
+          )
+        );
+      } else {
+        const installSkill = await confirm({
+          message: "Claude Code \uC2A4\uD0AC\uC744 \uC124\uCE58\uD558\uC2DC\uACA0\uC2B5\uB2C8\uAE4C?",
+          default: true,
+          theme: { prefix: "\u{1F527}" }
+        });
+        if (installSkill) {
+          try {
+            const skillSrc = import_path2.default.resolve(__dirname, "../skills/dooray-cli");
+            const skillsDir = import_path2.default.join(claudeDir, "skills");
+            const skillDst = import_path2.default.join(skillsDir, "dooray-cli");
+            await import_promises5.default.mkdir(skillsDir, { recursive: true });
+            await import_promises5.default.lstat(skillDst).then(() => import_promises5.default.rm(skillDst, { recursive: true, force: true })).catch(() => {
+            });
+            await import_promises5.default.symlink(skillSrc, skillDst);
+            console.log(import_chalk4.default.green("  \u2713 Claude Code \uC2A4\uD0AC \uC124\uCE58 \uC644\uB8CC"));
+          } catch (err) {
+            console.log(
+              import_chalk4.default.yellow(
+                `  \u26A0 \uC2A4\uD0AC \uC124\uCE58 \uC2E4\uD328: ${err instanceof Error ? err.message : String(err)}`
+              )
+            );
+          }
+        }
+      }
+    }
     const config = {
       version: 1,
       apiKey,
@@ -791,12 +903,12 @@ var setupCommand = new import_commander4.Command("setup").description("\uB300\uD
 var import_commander5 = require("commander");
 
 // src/resolvers/project.ts
-async function fetchAllProjects(client) {
+async function fetchAllProjects(client, options) {
   const all = [];
   let page = 0;
   const size = 100;
   while (true) {
-    const res = await client.getProjects({ page, size });
+    const res = await client.getProjects({ page, size, type: options?.type });
     for (const p of res.result) {
       all.push({
         id: p.id,
@@ -818,12 +930,27 @@ async function ensureProjects(client) {
   await setProjects(items);
   return items;
 }
+async function ensurePrivateProjects(client) {
+  const entry = await getPrivateProjects();
+  if (entry && !isExpired(entry.updatedAt, PROJECTS_TTL_MS)) {
+    return entry.data;
+  }
+  const items = await fetchAllProjects(client, { type: "private" });
+  await setPrivateProjects(items);
+  return items;
+}
 async function resolveProject(client, input) {
   const projects = await ensureProjects(client);
   const match = projects.find((p) => p.code === input || p.id === input);
   if (match) return match.id;
+  const privateCached = await getPrivateProjects();
+  if (privateCached && !isExpired(privateCached.updatedAt, PROJECTS_TTL_MS)) {
+    const privateMatch = privateCached.data.find((p) => p.code === input || p.id === input);
+    if (privateMatch) return privateMatch.id;
+  }
   throw new DoorayCliError(
-    `\uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input}`,
+    `\uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input}
+  \uAC1C\uC778 \uD504\uB85C\uC81D\uD2B8\uB77C\uBA74: dooray project list --type private \uB85C \uCE90\uC2DC\uB97C \uAC31\uC2E0\uD558\uC138\uC694`,
     EXIT_PARAM_ERROR
   );
 }
@@ -871,13 +998,16 @@ function stopSpinner(success, text) {
 }
 
 // src/commands/project/list.ts
-var projectListCommand = new import_commander5.Command("list").description("\uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C").option("-s, --search <keyword>", "code \uD544\uD130\uB9C1").action(async (opts) => {
+var projectListCommand = new import_commander5.Command("list").description("\uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C").option("-s, --search <keyword>", "code \uD544\uD130\uB9C1").addOption(
+  new import_commander5.Option("-t, --type <type>", "\uD504\uB85C\uC81D\uD2B8 \uD0C0\uC785 \uD544\uD130").choices(["public", "private"]).default("public")
+).action(async (opts) => {
   const globalOpts = projectListCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
-  startSpinner("\uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C \uC911...");
-  const projects = await ensureProjects(client);
-  stopSpinner(true, "\uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C \uC644\uB8CC");
+  const isPrivate = opts.type === "private";
+  startSpinner(isPrivate ? "\uAC1C\uC778 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C \uC911..." : "\uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C \uC911...");
+  const projects = isPrivate ? await ensurePrivateProjects(client) : await ensureProjects(client);
+  stopSpinner(true, isPrivate ? "\uAC1C\uC778 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C \uC644\uB8CC" : "\uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D \uC870\uD68C \uC644\uB8CC");
   let filtered = projects;
   if (opts.search) {
     const keyword = opts.search.toLowerCase();
@@ -1154,11 +1284,10 @@ var postGetCommand = new import_commander10.Command("get").description("\uC5C5\u
 
 // src/commands/post/edit.ts
 var import_commander11 = require("commander");
-var import_promises5 = __toESM(require("fs/promises"));
 
 // src/editor/index.ts
 var import_node_child_process = require("child_process");
-var import_promises4 = __toESM(require("fs/promises"));
+var import_promises6 = __toESM(require("fs/promises"));
 var import_tmp = __toESM(require("tmp"));
 var import_js_yaml = __toESM(require("js-yaml"));
 function openInEditor(content) {
@@ -1172,7 +1301,7 @@ function openInEditor(content) {
   const tmpFile = import_tmp.default.fileSync({ prefix: "dooray-", postfix: ".md" });
   return new Promise(async (resolve, reject) => {
     try {
-      await import_promises4.default.writeFile(tmpFile.name, content, "utf-8");
+      await import_promises6.default.writeFile(tmpFile.name, content, "utf-8");
       const child = (0, import_node_child_process.spawn)(editor, [tmpFile.name], {
         stdio: "inherit"
       });
@@ -1188,7 +1317,7 @@ function openInEditor(content) {
               EXIT_PARAM_ERROR
             );
           }
-          const result = await import_promises4.default.readFile(tmpFile.name, "utf-8");
+          const result = await import_promises6.default.readFile(tmpFile.name, "utf-8");
           resolve(result);
         } catch (e) {
           reject(e);
@@ -1281,14 +1410,25 @@ function parseWikiFrontmatter(content) {
   };
 }
 
-// src/commands/post/edit.ts
-async function resolveUsers(client, projectId, emails) {
-  const users = [];
-  for (const email of emails) {
-    const memberId = await resolveMember(client, projectId, email);
-    users.push({ type: "member", member: { organizationMemberId: memberId } });
+// src/utils/body-input.ts
+var import_promises7 = require("fs/promises");
+async function readBodyInput(opts) {
+  if (opts.body != null && opts.bodyFile != null) {
+    throw new DoorayCliError(
+      "--body\uC640 --body-file\uC740 \uD568\uAED8 \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+      EXIT_PARAM_ERROR
+    );
   }
-  return users;
+  if (opts.bodyFile) {
+    if (opts.bodyFile === "-") return readStdin();
+    return (0, import_promises7.readFile)(opts.bodyFile, "utf-8");
+  }
+  if (opts.body === "-") return readStdin();
+  return opts.body ?? "";
+}
+async function readBodyInputOrNull(opts) {
+  if (opts.body == null && opts.bodyFile == null) return null;
+  return readBodyInput(opts);
 }
 async function readStdin() {
   if (process.stdin.isTTY) {
@@ -1303,18 +1443,17 @@ async function readStdin() {
   }
   return Buffer.concat(chunks).toString("utf-8");
 }
-async function resolveBody(opts) {
-  if (opts.body) {
-    if (opts.body === "-") return readStdin();
-    return opts.body;
-  }
-  if (opts.bodyFile) {
-    if (opts.bodyFile === "-") return readStdin();
-    return import_promises5.default.readFile(opts.bodyFile, "utf-8");
+
+// src/commands/post/edit.ts
+async function resolveUsers(client, projectId, emails) {
+  const users = [];
+  for (const email of emails) {
+    const memberId = await resolveMember(client, projectId, email);
+    users.push({ type: "member", member: { organizationMemberId: memberId } });
   }
-  return null;
+  return users;
 }
-var postEditCommand = new import_commander11.Command("edit").description("\uC5C5\uBB34 \uC218\uC815 ($EDITOR \uB610\uB294 --subject/--body \uC635\uC158)").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<post-number>", "\uC5C5\uBB34 \uBC88\uD638").option("--subject <title>", "\uC81C\uBAA9 \uBCC0\uACBD (non-interactive)").option("--body <text>", "\uBCF8\uBB38 \uBCC0\uACBD (- \uC785\uB825 \uC2DC stdin, non-interactive)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin, non-interactive)").action(async (project, postNumberStr, opts) => {
+var postEditCommand = new import_commander11.Command("edit").description("\uC5C5\uBB34 \uC218\uC815 ($EDITOR \uB610\uB294 --title/--body \uC635\uC158)").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<post-number>", "\uC5C5\uBB34 \uBC88\uD638").option("--title <title>", "\uC81C\uBAA9 \uBCC0\uACBD (non-interactive)").option("--subject <subject>", "--title\uC758 deprecated alias").option("--body <text>", "\uBCF8\uBB38 \uBCC0\uACBD (- \uC785\uB825 \uC2DC stdin, non-interactive)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin, non-interactive)").action(async (project, postNumberStr, opts) => {
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   startSpinner("\uC5C5\uBB34 \uC870\uD68C \uC911...");
@@ -1324,9 +1463,15 @@ var postEditCommand = new import_commander11.Command("edit").description("\uC5C5
   const post = res.result;
   const members = await ensureMembers(client, projectId);
   stopSpinner(true, "\uC5C5\uBB34 \uC870\uD68C \uC644\uB8CC");
-  const nonInteractive = opts.subject || opts.body || opts.bodyFile;
+  const title = opts.title ?? opts.subject;
+  if (opts.subject && !opts.title) {
+    process.stderr.write(
+      "\u26A0  --subject\uB294 deprecated\uC785\uB2C8\uB2E4. \uB300\uC2E0 --title\uC744 \uC0AC\uC6A9\uD574\uC8FC\uC138\uC694.\n"
+    );
+  }
+  const nonInteractive = title || opts.body || opts.bodyFile;
   if (nonInteractive) {
-    const newBody = await resolveBody(opts);
+    const newBody = await readBodyInputOrNull(opts);
     startSpinner("\uC5C5\uBB34 \uC218\uC815 \uC911...");
     const toUsers = post.users.to.map((u) => ({
       type: u.type,
@@ -1341,7 +1486,7 @@ var postEditCommand = new import_commander11.Command("edit").description("\uC5C5
       group: u.group
     }));
     await client.updatePost(projectId, postId, {
-      subject: opts.subject ?? post.subject,
+      subject: title ?? post.subject,
       body: {
         mimeType: "text/x-markdown",
         content: newBody ?? post.body.content
@@ -1379,32 +1524,6 @@ var postEditCommand = new import_commander11.Command("edit").description("\uC5C5
 
 // src/commands/post/create.ts
 var import_commander12 = require("commander");
-var import_promises6 = __toESM(require("fs/promises"));
-async function readBody(opts) {
-  if (opts.bodyFile) {
-    if (opts.bodyFile === "-") {
-      return readStdin2();
-    }
-    return import_promises6.default.readFile(opts.bodyFile, "utf-8");
-  }
-  if (opts.body === "-") {
-    return readStdin2();
-  }
-  return "";
-}
-async function readStdin2() {
-  if (process.stdin.isTTY) {
-    throw new DoorayCliError(
-      "stdin\uC5D0\uC11C \uC77D\uC73C\uB824\uBA74 \uD30C\uC774\uD504\uB85C \uB370\uC774\uD130\uB97C \uC804\uB2EC\uD574\uC8FC\uC138\uC694.",
-      EXIT_PARAM_ERROR
-    );
-  }
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf-8");
-}
 async function resolveUsers2(client, projectId, inputs) {
   const users = [];
   for (const input of inputs) {
@@ -1413,17 +1532,29 @@ async function resolveUsers2(client, projectId, inputs) {
   }
   return users;
 }
-var postCreateCommand = new import_commander12.Command("create").description("\uC5C5\uBB34 \uC0DD\uC131").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").requiredOption("--subject <title>", "\uC5C5\uBB34 \uC81C\uBAA9").option("--to <members...>", "\uB2F4\uB2F9\uC790 (\uC774\uB984 \uB610\uB294 \uC774\uBA54\uC77C, \uC5EC\uB7EC \uBA85 \uAC00\uB2A5)").option("--cc <members...>", "\uCC38\uC870\uC790 (\uC774\uB984 \uB610\uB294 \uC774\uBA54\uC77C, \uC5EC\uB7EC \uBA85 \uAC00\uB2A5)").option("--body <text>", "\uBCF8\uBB38 \uD14D\uC2A4\uD2B8 (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--priority <level>", "\uC6B0\uC120\uC21C\uC704 (highest, high, normal, low, lowest)", "normal").option("--due-date <date>", "\uB9C8\uAC10\uC77C (ISO 8601 \uD615\uC2DD)").action(async (project, opts) => {
+var postCreateCommand = new import_commander12.Command("create").description("\uC5C5\uBB34 \uC0DD\uC131").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").option("--title <title>", "\uC5C5\uBB34 \uC81C\uBAA9").option("--subject <subject>", "--title\uC758 deprecated alias").option("--to <members...>", "\uB2F4\uB2F9\uC790 (\uC774\uB984 \uB610\uB294 \uC774\uBA54\uC77C, \uC5EC\uB7EC \uBA85 \uAC00\uB2A5)").option("--cc <members...>", "\uCC38\uC870\uC790 (\uC774\uB984 \uB610\uB294 \uC774\uBA54\uC77C, \uC5EC\uB7EC \uBA85 \uAC00\uB2A5)").option("--body <text>", "\uBCF8\uBB38 \uD14D\uC2A4\uD2B8 (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--priority <level>", "\uC6B0\uC120\uC21C\uC704 (highest, high, normal, low, lowest)", "normal").option("--due-date <date>", "\uB9C8\uAC10\uC77C (ISO 8601 \uD615\uC2DD)").action(async (project, opts) => {
   const globalOpts = postCreateCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
-  const bodyContent = await readBody(opts);
+  const subject = opts.title ?? opts.subject;
+  if (!subject) {
+    throw new DoorayCliError(
+      "--title\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.",
+      EXIT_PARAM_ERROR
+    );
+  }
+  if (opts.subject && !opts.title) {
+    process.stderr.write(
+      "\u26A0  --subject\uB294 deprecated\uC785\uB2C8\uB2E4. \uB300\uC2E0 --title\uC744 \uC0AC\uC6A9\uD574\uC8FC\uC138\uC694.\n"
+    );
+  }
+  const bodyContent = await readBodyInput(opts);
   startSpinner("\uC5C5\uBB34 \uC0DD\uC131 \uC911...");
   const projectId = await resolveProject(client, project);
   const toUsers = opts.to ? await resolveUsers2(client, projectId, opts.to) : [];
   const ccUsers = opts.cc ? await resolveUsers2(client, projectId, opts.cc) : [];
   const res = await client.createPost(projectId, {
-    subject: opts.subject,
+    subject,
     body: { mimeType: "text/x-markdown", content: bodyContent },
     users: { to: toUsers, cc: ccUsers },
     priority: opts.priority,
@@ -1488,36 +1619,11 @@ var commentListCommand = new import_commander15.Command("list").description("\uB
 
 // src/commands/post/comment/add.ts
 var import_commander16 = require("commander");
-var import_promises7 = __toESM(require("fs/promises"));
-async function readStdin3() {
-  if (process.stdin.isTTY) {
-    throw new DoorayCliError(
-      "stdin\uC5D0\uC11C \uC77D\uC73C\uB824\uBA74 \uD30C\uC774\uD504\uB85C \uB370\uC774\uD130\uB97C \uC804\uB2EC\uD574\uC8FC\uC138\uC694.",
-      EXIT_PARAM_ERROR
-    );
-  }
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf-8");
-}
-async function resolveBody2(opts) {
-  if (opts.body) {
-    if (opts.body === "-") return readStdin3();
-    return opts.body;
-  }
-  if (opts.bodyFile) {
-    if (opts.bodyFile === "-") return readStdin3();
-    return import_promises7.default.readFile(opts.bodyFile, "utf-8");
-  }
-  return null;
-}
 var commentAddCommand = new import_commander16.Command("add").description("\uB313\uAE00 \uCD94\uAC00").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<post-number>", "\uC5C5\uBB34 \uBC88\uD638").option("--body <text>", "\uB313\uAE00 \uBCF8\uBB38 (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").action(async (project, postNumberStr, opts) => {
   const globalOpts = commentAddCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
-  let bodyContent = await resolveBody2(opts);
+  let bodyContent = await readBodyInputOrNull(opts);
   if (bodyContent == null) {
     bodyContent = await openInEditor("");
     if (!bodyContent.trim()) {
@@ -1544,31 +1650,6 @@ var commentAddCommand = new import_commander16.Command("add").description("\uB31
 
 // src/commands/post/comment/edit.ts
 var import_commander17 = require("commander");
-var import_promises8 = __toESM(require("fs/promises"));
-async function readStdin4() {
-  if (process.stdin.isTTY) {
-    throw new DoorayCliError(
-      "stdin\uC5D0\uC11C \uC77D\uC73C\uB824\uBA74 \uD30C\uC774\uD504\uB85C \uB370\uC774\uD130\uB97C \uC804\uB2EC\uD574\uC8FC\uC138\uC694.",
-      EXIT_PARAM_ERROR
-    );
-  }
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf-8");
-}
-async function resolveBody3(opts) {
-  if (opts.body) {
-    if (opts.body === "-") return readStdin4();
-    return opts.body;
-  }
-  if (opts.bodyFile) {
-    if (opts.bodyFile === "-") return readStdin4();
-    return import_promises8.default.readFile(opts.bodyFile, "utf-8");
-  }
-  return null;
-}
 var commentEditCommand = new import_commander17.Command("edit").description("\uB313\uAE00 \uC218\uC815 ($EDITOR \uB610\uB294 --body \uC635\uC158)").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<post-number>", "\uC5C5\uBB34 \uBC88\uD638").argument("<comment-id>", "\uB313\uAE00 ID").option("--body <text>", "\uB313\uAE00 \uBCF8\uBB38 \uBCC0\uACBD (- \uC785\uB825 \uC2DC stdin, non-interactive)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin, non-interactive)").action(async (project, postNumberStr, commentId, opts) => {
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
@@ -1583,7 +1664,7 @@ var commentEditCommand = new import_commander17.Command("edit").description("\uB
 `);
     process.exit(1);
   }
-  let edited = await resolveBody3(opts);
+  let edited = await readBodyInputOrNull(opts);
   if (edited == null) {
     const original = comment.body.content;
     edited = await openInEditor(original);
@@ -1647,7 +1728,7 @@ var fileListCommand = new import_commander19.Command("list").description("\uC5C5
 
 // src/commands/post/file/download.ts
 var import_commander20 = require("commander");
-var import_promises9 = require("fs/promises");
+var import_promises8 = require("fs/promises");
 var import_node_path4 = require("path");
 var fileDownloadCommand = new import_commander20.Command("download").description("\uCCA8\uBD80\uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<post-number>", "\uC5C5\uBB34 \uBC88\uD638").argument("<file-id>", "\uD30C\uC77C ID").option("-o, --output <dir>", "\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC", ".").action(async (project, postNumberStr, fileId, opts) => {
   const config = await getConfigOrThrow();
@@ -1657,7 +1738,7 @@ var fileDownloadCommand = new import_commander20.Command("download").description
   const postId = await resolvePost(client, projectId, Number(postNumberStr));
   const { buffer, fileName } = await client.downloadPostFile(projectId, postId, fileId);
   const outputPath = (0, import_node_path4.join)(opts.output, fileName);
-  await (0, import_promises9.writeFile)(outputPath, Buffer.from(buffer));
+  await (0, import_promises8.writeFile)(outputPath, Buffer.from(buffer));
   stopSpinner(true, "\uB2E4\uC6B4\uB85C\uB4DC \uC644\uB8CC");
   process.stdout.write(`${outputPath}
 `);
@@ -1665,7 +1746,7 @@ var fileDownloadCommand = new import_commander20.Command("download").description
 
 // src/commands/post/file/download-all.ts
 var import_commander21 = require("commander");
-var import_promises10 = require("fs/promises");
+var import_promises9 = require("fs/promises");
 var import_node_path5 = require("path");
 var fileDownloadAllCommand = new import_commander21.Command("download-all").description("\uC5C5\uBB34\uC758 \uBAA8\uB4E0 \uCCA8\uBD80\uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<post-number>", "\uC5C5\uBB34 \uBC88\uD638").option("-o, --output <dir>", "\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC", ".").action(async (project, postNumberStr, opts) => {
   const config = await getConfigOrThrow();
@@ -1679,18 +1760,18 @@ var fileDownloadAllCommand = new import_commander21.Command("download-all").desc
     process.stdout.write("\uCCA8\uBD80\uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
     return;
   }
-  await (0, import_promises10.mkdir)(opts.output, { recursive: true });
+  await (0, import_promises9.mkdir)(opts.output, { recursive: true });
   const downloaded = [];
   for (const file of res.result) {
     spinner.text = `\uB2E4\uC6B4\uB85C\uB4DC \uC911: ${file.name} (${downloaded.length + 1}/${res.result.length})`;
     const { buffer, fileName } = await client.downloadPostFile(projectId, postId, file.id);
     const outputPath = (0, import_node_path5.join)(opts.output, fileName);
-    await (0, import_promises10.writeFile)(outputPath, Buffer.from(buffer));
+    await (0, import_promises9.writeFile)(outputPath, Buffer.from(buffer));
     downloaded.push(outputPath);
   }
   stopSpinner(true, `${downloaded.length}\uAC1C \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC \uC644\uB8CC`);
-  for (const path of downloaded) {
-    process.stdout.write(`${path}
+  for (const path3 of downloaded) {
+    process.stdout.write(`${path3}
 `);
   }
 });
@@ -1807,6 +1888,31 @@ async function resolveWiki(client, projectCode) {
   }
   return project.wikiId;
 }
+async function resolveWikiHomePageId(client, wikiId) {
+  const cached = await getWikis();
+  const fresh = cached && !isExpired(cached.updatedAt, WIKIS_TTL_MS);
+  let wikis;
+  if (fresh) {
+    wikis = cached.data;
+  } else {
+    const res = await client.getWikis({ size: 100 });
+    wikis = res.result.map((w) => ({
+      id: w.id,
+      projectId: w.project.id,
+      name: w.name,
+      homePageId: w.home.pageId
+    }));
+    await setWikis(wikis);
+  }
+  const wiki = wikis.find((w) => w.id === wikiId);
+  if (!wiki?.homePageId) {
+    throw new DoorayCliError(
+      `\uC704\uD0A4\uC758 home \uD398\uC774\uC9C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (wikiId: ${wikiId})`,
+      EXIT_API_ERROR
+    );
+  }
+  return wiki.homePageId;
+}
 
 // src/commands/wiki/pages.ts
 var wikiPagesCommand = new import_commander25.Command("pages").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uBAA9\uB85D \uC870\uD68C").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").option("--parent <page-id>", "\uBD80\uBAA8 \uD398\uC774\uC9C0 ID").action(async (project, opts) => {
@@ -1835,43 +1941,18 @@ var wikiPageGetCommand = new import_commander26.Command("get").description("\uC7
 
 // src/commands/wiki/page-create.ts
 var import_commander27 = require("commander");
-var import_promises11 = __toESM(require("fs/promises"));
-async function readBody2(opts) {
-  if (opts.bodyFile) {
-    if (opts.bodyFile === "-") {
-      return readStdin5();
-    }
-    return import_promises11.default.readFile(opts.bodyFile, "utf-8");
-  }
-  if (opts.body === "-") {
-    return readStdin5();
-  }
-  return "";
-}
-async function readStdin5() {
-  if (process.stdin.isTTY) {
-    throw new DoorayCliError(
-      "stdin\uC5D0\uC11C \uC77D\uC73C\uB824\uBA74 \uD30C\uC774\uD504\uB85C \uB370\uC774\uD130\uB97C \uC804\uB2EC\uD574\uC8FC\uC138\uC694.",
-      EXIT_PARAM_ERROR
-    );
-  }
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf-8");
-}
 var wikiPageCreateCommand = new import_commander27.Command("create").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC0DD\uC131").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").requiredOption("--title <title>", "\uD398\uC774\uC9C0 \uC81C\uBAA9").option("--parent <page-id>", "\uBD80\uBAA8 \uD398\uC774\uC9C0 ID").option("--body <text>", "\uBCF8\uBB38 \uD14D\uC2A4\uD2B8 (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").action(async (project, opts) => {
   const globalOpts = wikiPageCreateCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
-  const bodyContent = await readBody2(opts);
+  const bodyContent = await readBodyInput(opts);
   startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC0DD\uC131 \uC911...");
   const wikiId = await resolveWiki(client, project);
+  const parentPageId = opts.parent ?? await resolveWikiHomePageId(client, wikiId);
   const res = await client.createWikiPage(wikiId, {
     subject: opts.title,
     body: { mimeType: "text/x-markdown", content: bodyContent },
-    parentPageId: opts.parent ?? ""
+    parentPageId
   });
   stopSpinner(true, "\uC704\uD0A4 \uD398\uC774\uC9C0 \uC0DD\uC131 \uC644\uB8CC");
   if (globalOpts.json) {
@@ -1886,26 +1967,53 @@ var wikiPageCreateCommand = new import_commander27.Command("create").description
 
 // src/commands/wiki/page-edit.ts
 var import_commander28 = require("commander");
-var wikiPageEditCommand = new import_commander28.Command("edit").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 ($EDITOR)").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<page-id>", "\uD398\uC774\uC9C0 ID").action(async (project, pageId) => {
+var wikiPageEditCommand = new import_commander28.Command("edit").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 (\uD50C\uB798\uADF8 \uC5C6\uC73C\uBA74 $EDITOR)").argument("<project>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uB610\uB294 ID").argument("<page-id>", "\uD398\uC774\uC9C0 ID").option("--title <title>", "\uD398\uC774\uC9C0 \uC81C\uBAA9 (\uC9C0\uC815 \uC2DC $EDITOR \uC0DD\uB7B5)").option("--body <text>", "\uBCF8\uBB38 \uD14D\uC2A4\uD2B8 (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").option("--body-file <path>", "\uBCF8\uBB38 \uD30C\uC77C \uACBD\uB85C (- \uC785\uB825 \uC2DC stdin\uC5D0\uC11C \uC77D\uAE30)").action(async (project, pageId, opts) => {
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
-  startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC870\uD68C \uC911...");
+  const hasTitle = opts.title != null;
+  const hasBody = opts.body != null || opts.bodyFile != null;
+  const nonInteractive = hasTitle || hasBody;
+  startSpinner("\uC704\uD0A4 \uC815\uBCF4 \uC870\uD68C \uC911...");
   const wikiId = await resolveWiki(client, project);
-  const res = await client.getWikiPage(wikiId, pageId);
-  const page = res.result;
-  stopSpinner(true, "\uC704\uD0A4 \uD398\uC774\uC9C0 \uC870\uD68C \uC644\uB8CC");
-  const original = serializeWikiFrontmatter(page);
-  const edited = await openInEditor(original);
-  if (original === edited) {
-    process.stdout.write("\uBCC0\uACBD\uC0AC\uD56D \uC5C6\uC74C\n");
+  if (!nonInteractive) {
+    const res = await client.getWikiPage(wikiId, pageId);
+    const page = res.result;
+    stopSpinner(true, "\uC704\uD0A4 \uD398\uC774\uC9C0 \uC870\uD68C \uC644\uB8CC");
+    const original = serializeWikiFrontmatter(page);
+    const edited = await openInEditor(original);
+    if (original === edited) {
+      process.stdout.write("\uBCC0\uACBD\uC0AC\uD56D \uC5C6\uC74C\n");
+      return;
+    }
+    const parsed = parseWikiFrontmatter(edited);
+    startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 \uC911...");
+    await client.updateWikiPage(wikiId, pageId, {
+      subject: parsed.title,
+      body: { mimeType: "text/x-markdown", content: parsed.body }
+    });
+    stopSpinner(true, "\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 \uC644\uB8CC");
+    process.stdout.write(`\uC704\uD0A4 \uD398\uC774\uC9C0\uAC00 \uC218\uC815\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${pageId}
+`);
     return;
   }
-  const parsed = parseWikiFrontmatter(edited);
-  startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 \uC911...");
-  await client.updateWikiPage(wikiId, pageId, {
-    subject: parsed.title,
-    body: { mimeType: "text/x-markdown", content: parsed.body }
-  });
+  stopSpinner(true, "\uC704\uD0A4 \uC815\uBCF4 \uC870\uD68C \uC644\uB8CC");
+  if (hasTitle && hasBody) {
+    const bodyContent = await readBodyInput(opts);
+    startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 \uC911...");
+    await client.updateWikiPage(wikiId, pageId, {
+      subject: opts.title,
+      body: { mimeType: "text/x-markdown", content: bodyContent }
+    });
+  } else if (hasTitle) {
+    startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uC81C\uBAA9 \uC218\uC815 \uC911...");
+    await client.updateWikiPageTitle(wikiId, pageId, { subject: opts.title });
+  } else {
+    const bodyContent = await readBodyInput(opts);
+    startSpinner("\uC704\uD0A4 \uD398\uC774\uC9C0 \uBCF8\uBB38 \uC218\uC815 \uC911...");
+    await client.updateWikiPageContent(wikiId, pageId, {
+      body: { mimeType: "text/x-markdown", content: bodyContent }
+    });
+  }
   stopSpinner(true, "\uC704\uD0A4 \uD398\uC774\uC9C0 \uC218\uC815 \uC644\uB8CC");
   process.stdout.write(`\uC704\uD0A4 \uD398\uC774\uC9C0\uAC00 \uC218\uC815\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${pageId}
 `);
@@ -2086,7 +2194,7 @@ ${mail.body}
 
 // src/commands/mail/send.ts
 var import_commander31 = require("commander");
-var import_promises12 = require("fs/promises");
+var import_promises10 = require("fs/promises");
 
 // src/api/smtpClient.ts
 var import_nodemailer = __toESM(require("nodemailer"));
@@ -2140,7 +2248,7 @@ var mailSendCommand = new import_commander31.Command("send").description("\uBA54
   const config = await getConfigOrThrow();
   let body = opts.body ?? "";
   if (opts.bodyFile) {
-    body = await (0, import_promises12.readFile)(opts.bodyFile, "utf-8");
+    body = await (0, import_promises10.readFile)(opts.bodyFile, "utf-8");
   }
   if (!body) {
     process.stderr.write("\uC624\uB958: --body \uB610\uB294 --body-file\uC744 \uC9C0\uC815\uD558\uC138\uC694\n");
@@ -2171,7 +2279,7 @@ var mailSendCommand = new import_commander31.Command("send").description("\uBA54
 
 // src/commands/mail/reply.ts
 var import_commander32 = require("commander");
-var import_promises13 = require("fs/promises");
+var import_promises11 = require("fs/promises");
 var import_imapflow2 = require("imapflow");
 async function getMessageId(config, uid) {
   const imap = getImapConfigOrThrow(config);
@@ -2203,7 +2311,7 @@ var mailReplyCommand = new import_commander32.Command("reply").description("\uBA
   const config = await getConfigOrThrow();
   let body = opts.body ?? "";
   if (opts.bodyFile) {
-    body = await (0, import_promises13.readFile)(opts.bodyFile, "utf-8");
+    body = await (0, import_promises11.readFile)(opts.bodyFile, "utf-8");
   }
   if (!body) {
     process.stderr.write("\uC624\uB958: --body \uB610\uB294 --body-file\uC744 \uC9C0\uC815\uD558\uC138\uC694\n");
@@ -2240,7 +2348,7 @@ var mailReplyCommand = new import_commander32.Command("reply").description("\uBA
 
 // src/index.ts
 var program = new import_commander33.Command();
-program.name("dooray").description("Dooray REST API CLI").version("0.4.0").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--quiet", "ID\uB9CC \uCD9C\uB825").option("--no-color", "\uC0C9\uC0C1 \uBE44\uD65C\uC131\uD654");
+program.name("dooray").description("Dooray REST API CLI").version("0.5.2").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--quiet", "ID\uB9CC \uCD9C\uB825").option("--no-color", "\uC0C9\uC0C1 \uBE44\uD65C\uC131\uD654");
 program.hook("preAction", () => {
   const opts = program.opts();
   if (opts.color === false || process.env.NO_COLOR) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bifos/dooray-cli",
-  "version": "0.4.0",
+  "version": "0.5.2",
   "description": "CLI tool for Dooray project management — AI agent & terminal friendly",
   "keywords": [
     "dooray",
@@ -22,6 +22,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md"
   ],
   "engines": {

package/skills/dooray-cli/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: dooray-cli
+description: Dooray 업무 관리 CLI. 프로젝트/업무/댓글/위키 조회·생성·수정. AI 에이전트가 두레이 업무를 자동화할 때 사용.
+---
+
+# dooray-cli
+
+NHN Dooray REST API를 래핑한 CLI 도구. 업무 조회, 생성, 수정, 댓글, 위키 등을 터미널에서 수행한다.
+
+## 설치
+
+```bash
+npm install -g @bifos/dooray-cli
+```
+
+## 초기 설정
+
+대화형 마법사로 한 번에 설정:
+
+```bash
+dooray setup   # API endpoint 선택, API key 입력, 메일 설정까지 대화형으로 진행
+```
+
+또는 개별 수동 설정:
+
+```bash
+dooray config set base-url https://api.dooray.com
+dooray config set api-key <YOUR_API_TOKEN>   # https://{org}.dooray.com/setting/api/token
+dooray doctor                                 # 설정 검증
+```
+
+## 출력 모드
+
+| 플래그 | 설명 | 용도 |
+|--------|------|------|
+| (없음) | 사람이 읽기 좋은 테이블 | 기본 |
+| `--json` | JSON 출력 (stdout) | 파싱, 체이닝 |
+| `--quiet` | ID만 출력 | 스크립팅 |
+
+**AI 에이전트는 `--json`을 사용하여 구조화된 데이터를 파싱하라.**
+
+---
+
+## 의도 → 커맨드 매핑
+
+자연어 요청을 커맨드로 변환할 때 아래 표를 참고한다.
+
+| 의도 | 커맨드 |
+|------|--------|
+| 초기 설정 (대화형) | `dooray setup` |
+| 프로젝트 찾기 | `dooray project list --search <keyword>` |
+| 개인 프로젝트 목록 | `dooray project list --type private` |
+| 프로젝트 멤버 보기 | `dooray project members <project>` |
+| 업무 목록 조회 | `dooray post list <project>` |
+| 업무 검색 | `dooray post search <project> "<keyword>"` |
+| 업무 상세 보기 | `dooray post get <project> <number>` |
+| 업무 생성 | `dooray post create <project> --title "..." --body "..."` 또는 `--body-file <path>` (`--body`와 `--body-file`은 동시 사용 불가) |
+| 업무 제목/본문 수정 | `dooray post edit <project> <number> --title "..." --body "..."` 또는 `--body-file <path>` |
+| 업무 완료 처리 | `dooray post done <project> <number>` |
+| 업무 워크플로우 변경 | `dooray post workflow <project> <number> <workflow>` |
+| 댓글 조회 | `dooray post comment list <project> <number>` |
+| 댓글 추가 | `dooray post comment add <project> <number> --body "..."` 또는 `--body-file <path>` |
+| 댓글 수정 | `dooray post comment edit <project> <number> <comment-id> --body "..."` 또는 `--body-file <path>` |
+| 댓글 삭제 | `dooray post comment delete <project> <number> <comment-id>` |
+| 위키 목록 | `dooray wiki list` |
+| 위키 페이지 목록 | `dooray wiki pages <project>` |
+| 위키 페이지 상세 | `dooray wiki page get <project> <page-id>` |
+| 위키 페이지 생성 | `dooray wiki page create <project> --title "..." [--parent <page-id>] [--body "..."]` (--parent 생략 시 위키 home 페이지 아래 생성) |
+| 위키 페이지 수정 (제목) | `dooray wiki page edit <project> <page-id> --title "..."` |
+| 위키 페이지 수정 (본문) | `dooray wiki page edit <project> <page-id> --body "..."` 또는 `--body-file ./new.md` |
+| 위키 페이지 수정 (에디터) | `dooray wiki page edit <project> <page-id>` (플래그 없으면 $EDITOR 열림) |
+| 메일 목록 조회 | `dooray mail list` |
+| 안읽은 메일 | `dooray mail list --unread` |
+| 메일 제목 검색 | `dooray mail list --search "<keyword>"` |
+| 메일 상세 | `dooray mail get <uid>` |
+| 메일 발송 | `dooray mail send --to "..." --subject "..." --body "..."` |
+| 메일 답장 | `dooray mail reply <uid> --body "..."` |
+| 첨부파일 목록 | `dooray post file list <project> <number>` |
+| 첨부파일 다운로드 | `dooray post file download <project> <number> <file-id>` |
+| 전체 첨부파일 다운로드 | `dooray post file download-all <project> <number>` |
+| 첨부파일 업로드 | `dooray post file upload <project> <number> <file-path>` |
+| 첨부파일 삭제 | `dooray post file delete <project> <number> <file-id>` |
+
+> **제목 옵션 네이밍**: `post` 와 `wiki page` 모두 `--title` 표준. `post`의 `--subject`는 deprecated alias로 당분간 동작하되, 새 코드에서는 `--title` 사용을 권장.
+
+---
+
+## 제약사항 (Dooray API 한계)
+
+CLI로 처리 **불가능한** 작업. 아래 항목을 요청받으면 웹 UI 사용을 안내할 것.
+
+| 작업 | 대체 경로 | 근거 |
+|---|---|---|
+| 위키 페이지 **삭제** | 웹 UI (`https://{tenant}.dooray.com/wiki/...`) | Dooray REST API에 해당 엔드포인트 없음 (위키 댓글·첨부파일 삭제는 있지만 페이지 자체는 없음, `docs/dooray-api-reference.md` §7 참조) |
+| 프로젝트 삭제 | 웹 UI (admin 페이지) | API 미지원 |
+
+위키 페이지를 잘못 만든 경우(테스트/중복) **soft delete(빈 제목·본문) 우회 금지** — 페이지가 트리에 남아 사용자 혼란 유발.
+
+---
+
+## 워크플로우 판단 기준
+
+1. **"내 프로젝트", "개인 프로젝트" 언급 시** → `dooray project list --type private --json` 으로 개인 프로젝트 먼저 조회
+2. **프로젝트 코드를 모르면** → `dooray project list --search <keyword>` 로 먼저 찾기
+3. **업무 번호를 모르면** → `dooray post search <project> "<keyword>"` 로 검색
+4. **워크플로우 이름을 모르면** → `dooray project workflows <project>` 로 확인
+5. **멤버 이름을 모르면** → `dooray project members <project>` 로 확인
+6. **결과를 다음 액션에 사용하려면** → `--json` 플래그로 구조화된 데이터 획득
+
+---
+
+## 체이닝 예시
+
+### 업무 찾아서 완료 처리
+
+```bash
+# 1. 업무 검색으로 번호 확인
+dooray post search tc-ocr "graceful shutdown" --json
+# → [{ "number": 42, "subject": "graceful shutdown 구현", ... }]
+
+# 2. 완료 처리
+dooray post done tc-ocr 42
+```
+
+### 프로젝트 찾아서 업무 생성
+
+```bash
+# 1. 프로젝트 코드 확인
+dooray project list --search "AI서비스" --json
+# → [{ "code": "ai-service-dev", ... }]
+
+# 2. 업무 생성
+dooray post create ai-service-dev \
+  --title "주간보고 2026-W14" \
+  --body "## 이번 주 성과\n- 항목1\n- 항목2" \
+  --to "김철수"
+```
+
+### 업무 상세 조회 후 댓글 추가
+
+```bash
+# 1. 업무 조회
+dooray post get tc-ocr 42 --json
+
+# 2. 댓글 추가
+dooray post comment add tc-ocr 42 --body "진행 상황 업데이트: 80% 완료"
+```
+
+### 위키 페이지 조회
+
+```bash
+# 1. 위키 페이지 목록
+dooray wiki pages tc-ocr --json
+# → [{ "id": "3052841366755571094", "subject": "설계 문서", ... }]
+
+# 2. 페이지 내용 조회
+dooray wiki page get tc-ocr 3052841366755571094 --json
+```
+
+---
+
+## 커맨드 상세
+
+### 업무 생성 (non-interactive)
+
+```bash
+dooray post create <project> \
+  --title "제목" \
+  --body "본문 마크다운" \
+  --to "담당자이름" \           # 여러 명: --to "김철수" --to "이영희"
+  --cc "참조자이름" \
+  --priority normal \           # highest, high, normal, low, lowest
+  --due-date "2026-04-30T18:00:00+09:00"
+```
+
+본문이 길면 파일로 (`--body`와 `--body-file`은 함께 사용 불가):
+```bash
+dooray post create <project> --title "제목" --body-file ./content.md
+```
+
+### 업무 수정 (non-interactive)
+
+```bash
+# 제목만 변경
+dooray post edit <project> <number> --title "새 제목"
+
+# 본문만 변경
+dooray post edit <project> <number> --body "새 본문"
+
+# 제목 + 본문 동시 변경
+dooray post edit <project> <number> --title "새 제목" --body-file ./updated.md
+```
+
+### 댓글 추가 (non-interactive)
+
+```bash
+dooray post comment add <project> <number> --body "댓글 내용"
+dooray post comment add <project> <number> --body-file ./comment.md
+```
+
+---
+
+## 에러 핸들링
+
+CLI 에러 발생 시 복구 방법:
+
+| 에러 메시지 | 원인 | 복구 방법 |
+|------------|------|-----------|
+| `프로젝트를 찾을 수 없습니다: xxx` | 프로젝트 코드/ID 오류 | `dooray project list --search "xxx"` 로 정확한 코드 확인 |
+| `복수의 멤버가 매칭됩니다: "김"` | 이름이 모호함 | 에러 메시지의 후보 목록에서 정확한 이름으로 재시도 |
+| `멤버를 찾을 수 없습니다: xxx` | 해당 프로젝트에 멤버 없음 | `dooray project members <project>` 로 멤버 목록 확인 |
+| `워크플로우를 찾을 수 없습니다: xxx` | 워크플로우 이름 오류 | `dooray project workflows <project>` 로 확인 |
+| `API 호출 실패 (401)` | API 키 만료/오류 | `dooray doctor` 로 설정 검증 |
+
+---
+
+## 캐시
+
+프로젝트, 멤버, 워크플로우, 위키 정보는 `~/.dooray/cache/`에 캐시된다.
+캐시가 오래된 것 같으면:
+
+```bash
+dooray cache clear   # 전체 캐시 삭제 (다음 실행 시 자동 갱신)
+```