@bifos/dooray-cli 0.10.1 → 0.11.0

package/README.md

@@ -91,6 +91,22 @@ dooray post get <project> 42 --json           # JSON 출력
 대상: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`.
 AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다 (ADR-020).
 
+**projectId 직접 입력** (Issue #78, ADR-030):
+
+`member=me` 응답에 없는 프로젝트 (다른 팀 / 권한만 있는 프로젝트) 도 projectId (15+자리 numeric) 를 직접 입력하면 자동으로 cache 우회.
+
+```bash
+# 코드 매칭 (기존)
+dooray post search <project> "keyword"
+
+# projectId 직접 입력 — member 아닌 프로젝트도 자동화 가능
+dooray post search 1234567890123456789 "keyword"
+dooray post list 1234567890123456789
+dooray member list 1234567890123456789
+```
+
+권한 검증은 후속 API 호출 시점 — 권한 없으면 4xx.
+
 ### 업무 생성
 
 ```bash
@@ -383,6 +399,22 @@ dooray wiki page file list "https://<tenant>.dooray.com/wiki/<wikiId>/<pageId>"
 dooray wiki page file upload --id <pageId> --project <project> --file ./README.md
 ```
 
+`--json` 옵션으로 자동화 파이프라인에서 동일 parse 코드를 사용할 수 있습니다 (ADR-031):
+
+```bash
+# download — { outputPath, fileName, size }
+dooray wiki page file download <project> <page-id> --file-id <id> -o ./ --json
+
+# download-all — { count, succeeded, failed } (부분 실패 시 exit 1)
+dooray wiki page file download-all <project> <page-id> -o ./ --json | jq '.failed'
+
+# delete — { fileId, status: "deleted" }
+dooray wiki page file delete <project> <page-id> --file-id <id> --json
+
+# upload — res.result raw (--quiet 는 id 만)
+dooray wiki page file upload <project> <page-id> --file ./report.pdf --json
+```
+
 **주의**:
 - `upload` 시 multipart 필드 순서 (`type` → `file`) 가 중요.
   클라이언트가 자동으로 강제 (ADR-029 참조)
@@ -474,6 +506,25 @@ dooray post file upload <project> <number> ./report.pdf
 dooray post file delete <project> <number> <file-id>
 ```
 
+자동화 스크립트에서 `--json` 옵션으로 구조화된 출력을 파이프로 가공할 수 있습니다 (ADR-031):
+
+```bash
+# download — { outputPath, fileName, size }
+dooray post file download <project> <number> --file-id <id> -o ./ --json
+# 출력: {"outputPath": "./<fileName>", "fileName": "...", "size": 12345}
+
+# download-all — { count, succeeded, failed } (부분 실패 시 exit 1)
+dooray post file download-all <project> <number> -o ./ --json | jq '.failed'
+# 출력: [] 또는 [{"fileId": "...", "error": "..."}]
+
+# delete — { fileId, status: "deleted" }
+dooray post file delete <project> <number> --file-id <id> --json
+# 출력: {"fileId": "...", "status": "deleted"}
+
+# upload — res.result raw (--quiet 는 id 만)
+dooray post file upload <project> <number> ./report.pdf --json
+```
+
 URL/`--id`/`--url` 모드에서는 sub-id를 옵션으로 전달:
 ```bash
 dooray post file download --url <url> --file-id <fileId> -o ./downloads

package/dist/index.js

@@ -1206,6 +1206,7 @@ var setupCommand = new import_commander4.Command("setup").description("\uB300\uD
 var import_commander5 = require("commander");
 
 // src/resolvers/project.ts
+var PROJECT_ID_RE = /^\d{15,}$/;
 async function fetchAllProjects(client, options) {
   const all = [];
   let page = 0;
@@ -1243,6 +1244,9 @@ async function ensurePrivateProjects(client) {
   return items;
 }
 async function resolveProject(client, input2) {
+  if (PROJECT_ID_RE.test(input2)) {
+    return input2;
+  }
   const projects = await ensureProjects(client);
   const match = projects.find((p) => p.code === input2 || p.id === input2);
   if (match) return match.id;
@@ -1253,7 +1257,8 @@ async function resolveProject(client, input2) {
   }
   throw new DoorayCliError(
     `\uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input2}
-  \uAC1C\uC778 \uD504\uB85C\uC81D\uD2B8\uB77C\uBA74: dooray project list --type private \uB85C \uCE90\uC2DC\uB97C \uAC31\uC2E0\uD558\uC138\uC694`,
+  \uAC1C\uC778 \uD504\uB85C\uC81D\uD2B8\uB77C\uBA74: dooray project list --type private \uB85C \uCE90\uC2DC\uB97C \uAC31\uC2E0\uD558\uC138\uC694
+  member=me \uC751\uB2F5\uC5D0 \uC5C6\uB294 \uD504\uB85C\uC81D\uD2B8\uB294 projectId (15+\uC790\uB9AC numeric) \uC9C1\uC811 \uC785\uB825\uC73C\uB85C \uC6B0\uD68C \uAC00\uB2A5 (ADR-030)`,
     EXIT_PARAM_ERROR
   );
 }
@@ -3767,7 +3772,49 @@ var fileListCommand = new import_commander29.Command("list").description("\uC5C5
 var import_commander30 = require("commander");
 var import_promises9 = require("fs/promises");
 var import_node_path6 = require("path");
+
+// src/formatters/file-output.ts
+function emitDownloadResult(globalOpts, result) {
+  if (globalOpts.json) {
+    printJson(result);
+  } else {
+    process.stdout.write(`${result.outputPath}
+`);
+  }
+}
+function emitDownloadAllResult(globalOpts, data) {
+  if (globalOpts.json) {
+    printJson(data);
+  } else if (globalOpts.quiet) {
+    for (const s of data.succeeded) {
+      process.stdout.write(`${s.path}
+`);
+    }
+    if (data.failed.length > 0) {
+      process.stderr.write(`${data.failed.length} failed
+`);
+    }
+  } else {
+    process.stdout.write(`
+\uC644\uB8CC: ${data.succeeded.length}/${data.count}
+`);
+  }
+}
+function emitDeleteResult(globalOpts, result) {
+  if (globalOpts.json) {
+    printJson({ fileId: result.fileId, status: "deleted" });
+  } else if (globalOpts.quiet) {
+    process.stdout.write(`${result.fileId}
+`);
+  } else {
+    process.stdout.write(`\uD30C\uC77C(${result.fileId})\uC774 \uC0AD\uC81C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
+`);
+  }
+}
+
+// src/commands/post/file/download.ts
 var fileDownloadCommand = new import_commander30.Command("download").description("\uCCA8\uBD80\uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC").argument("[arg1]", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC, Dooray URL, \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg2]", "\uC5C5\uBB34 \uBC88\uD638 \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg3]", "\uD30C\uC77C ID (positional \uBAA8\uB4DC)").option("--id <postId>", "Dooray post ID (project/post-number \uB300\uC2E0)").option("--url <url>", "Dooray \uC5C5\uBB34 URL (project/post-number \uB300\uC2E0)").option("--file-id <fileId>", "\uD30C\uC77C ID (positional \uB300\uCCB4)").option("-o, --output <dir>", "\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC", ".").action(async (arg1, arg2, arg3, opts) => {
+  const globalOpts = fileDownloadCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   let projectArg;
@@ -3814,11 +3861,11 @@ var fileDownloadCommand = new import_commander30.Command("download").description
     urlOpt: opts.url
   });
   const { buffer, fileName } = await client.downloadPostFile(projectId, postId, fileId);
-  const outputPath = (0, import_node_path6.join)(opts.output, fileName);
+  const safeName = (0, import_node_path6.basename)(decodeURIComponent(fileName));
+  const outputPath = (0, import_node_path6.join)(opts.output, safeName);
   await (0, import_promises9.writeFile)(outputPath, Buffer.from(buffer));
   stopSpinner(true, "\uB2E4\uC6B4\uB85C\uB4DC \uC644\uB8CC");
-  process.stdout.write(`${outputPath}
-`);
+  emitDownloadResult(globalOpts, { outputPath, fileName: safeName, size: buffer.byteLength });
 });
 
 // src/commands/post/file/download-all.ts
@@ -3826,9 +3873,10 @@ var import_commander31 = require("commander");
 var import_promises10 = require("fs/promises");
 var import_node_path7 = require("path");
 var fileDownloadAllCommand = new import_commander31.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 \uCCAB \uC778\uC790\uC5D0 Dooray URL)").argument("[post-number]", "\uC5C5\uBB34 \uBC88\uD638 (project\uC640 \uD568\uAED8 \uC0AC\uC6A9)").option("--id <postId>", "Dooray post ID (project/post-number \uB300\uC2E0)").option("--url <url>", "Dooray \uC5C5\uBB34 URL (project/post-number \uB300\uC2E0)").option("-o, --output <dir>", "\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC", ".").action(async (project, postNumberStr, opts) => {
+  const globalOpts = fileDownloadAllCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
-  const spinner = startSpinner("\uCCA8\uBD80\uD30C\uC77C \uBAA9\uB85D \uC870\uD68C \uC911...");
+  startSpinner("\uCCA8\uBD80\uD30C\uC77C \uBAA9\uB85D \uC870\uD68C \uC911...");
   const { projectId, postId } = await resolvePostInput(client, {
     projectArg: project,
     postNumberArg: postNumberStr,
@@ -3838,23 +3886,38 @@ var fileDownloadAllCommand = new import_commander31.Command("download-all").desc
   const res = await client.getPostFiles(projectId, postId);
   if (res.result.length === 0) {
     stopSpinner(true, "\uCCA8\uBD80\uD30C\uC77C \uC5C6\uC74C");
-    process.stdout.write("\uCCA8\uBD80\uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
+    if (globalOpts.json) {
+      printJson({ count: 0, succeeded: [], failed: [] });
+    } else if (!globalOpts.quiet) {
+      process.stdout.write("\uCCA8\uBD80\uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
+    }
     return;
   }
+  stopSpinner(true, `${res.result.length}\uAC1C \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC \uC2DC\uC791`);
   await (0, import_promises10.mkdir)(opts.output, { recursive: true });
-  const downloaded = [];
+  const succeeded = [];
+  const failed = [];
   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_path7.join)(opts.output, fileName);
-    await (0, import_promises10.writeFile)(outputPath, Buffer.from(buffer));
-    downloaded.push(outputPath);
-  }
-  stopSpinner(true, `${downloaded.length}\uAC1C \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC \uC644\uB8CC`);
-  for (const path3 of downloaded) {
-    process.stdout.write(`${path3}
+    try {
+      const { buffer, fileName } = await client.downloadPostFile(projectId, postId, file.id);
+      const safeName = (0, import_node_path7.basename)(decodeURIComponent(fileName));
+      const outputPath = (0, import_node_path7.join)(opts.output, safeName);
+      await (0, import_promises10.writeFile)(outputPath, Buffer.from(buffer));
+      succeeded.push({ path: outputPath, fileName: safeName });
+      if (!globalOpts.json && !globalOpts.quiet) {
+        process.stdout.write(`\u2713 ${safeName}
+`);
+      }
+    } catch (e) {
+      failed.push({ fileId: file.id, error: e instanceof Error ? e.message : String(e) });
+      if (!globalOpts.json) {
+        process.stderr.write(`\u2717 ${file.name} (${file.id}): ${e instanceof Error ? e.message : String(e)}
 `);
+      }
+    }
   }
+  emitDownloadAllResult(globalOpts, { count: res.result.length, succeeded, failed });
+  if (failed.length > 0) process.exitCode = 1;
 });
 
 // src/commands/post/file/upload.ts
@@ -3923,6 +3986,7 @@ var fileUploadCommand = new import_commander32.Command("upload").description("\u
 // src/commands/post/file/delete.ts
 var import_commander33 = require("commander");
 var fileDeleteCommand = new import_commander33.Command("delete").description("\uCCA8\uBD80\uD30C\uC77C \uC0AD\uC81C").argument("[arg1]", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC, Dooray URL, \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg2]", "\uC5C5\uBB34 \uBC88\uD638 \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg3]", "\uD30C\uC77C ID (positional 3\uAC1C \uBAA8\uB4DC)").option("--id <postId>", "Dooray post ID (project/post-number \uB300\uC2E0)").option("--url <url>", "Dooray \uC5C5\uBB34 URL (project/post-number \uB300\uC2E0)").option("--file-id <fileId>", "\uD30C\uC77C ID (positional \uB300\uCCB4)").action(async (arg1, arg2, arg3, opts) => {
+  const globalOpts = fileDeleteCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   let projectArg;
@@ -3970,8 +4034,7 @@ var fileDeleteCommand = new import_commander33.Command("delete").description("\u
   });
   await client.deletePostFile(projectId, postId, fileId);
   stopSpinner(true, "\uC0AD\uC81C \uC644\uB8CC");
-  process.stdout.write(`\uD30C\uC77C(${fileId})\uC774 \uC0AD\uC81C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
-`);
+  emitDeleteResult(globalOpts, { fileId });
 });
 
 // src/commands/wiki/list.ts
@@ -4279,6 +4342,7 @@ var wikiPageFileListCommand = new import_commander39.Command("list").description
 // src/commands/wiki/page-file/upload.ts
 var import_commander40 = require("commander");
 var wikiPageFileUploadCommand = new import_commander40.Command("upload").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uCCA8\uBD80\uD30C\uC77C \uC5C5\uB85C\uB4DC (multipart type \uC21C\uC11C \uAC15\uC81C, ADR-029)").argument("[arg1]", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC, Dooray Wiki URL, \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C \uACBD\uB85C").argument("[arg2]", "page-id \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C \uACBD\uB85C").argument("[arg3]", "\uD30C\uC77C \uACBD\uB85C (positional 3\uAC1C \uBAA8\uB4DC)").option("--id <pageId>", "\uC704\uD0A4 \uD398\uC774\uC9C0 ID").option("--url <url>", "Dooray Wiki URL").option("--project <code>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC (--id \uBAA8\uB4DC\uC5D0\uC11C wikiId \uD574\uC11D\uC6A9)").option("--file <path>", "\uC5C5\uB85C\uB4DC\uD560 \uD30C\uC77C \uACBD\uB85C (positional \uB300\uCCB4)").option("--type <type>", "\uD30C\uC77C \uD0C0\uC785: general | inline_image (\uAE30\uBCF8 general)", "general").action(async (arg1, arg2, arg3, opts) => {
+  const globalOpts = wikiPageFileUploadCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   const fileType = opts.type;
@@ -4335,18 +4399,25 @@ var wikiPageFileUploadCommand = new import_commander40.Command("upload").descrip
   try {
     const res = await client.uploadWikiPageFile(wikiId, pageId, filePath, fileType);
     stopSpinner(true, "\uC5C5\uB85C\uB4DC \uC644\uB8CC");
-    process.stdout.write(`attachFileId: ${res.result.attachFileId}
+    if (globalOpts.json) {
+      printJson(res.result);
+    } else if (globalOpts.quiet) {
+      process.stdout.write(`${res.result.id}
+`);
+    } else {
+      process.stdout.write(`attachFileId: ${res.result.attachFileId}
 `);
-    process.stdout.write(`name:         ${res.result.name}
+      process.stdout.write(`name:         ${res.result.name}
 `);
-    process.stdout.write(`size:         ${res.result.size}
+      process.stdout.write(`size:         ${res.result.size}
 `);
-    process.stdout.write(`type:         ${res.result.type}
+      process.stdout.write(`type:         ${res.result.type}
 `);
-    if (fileType === "inline_image") {
-      process.stdout.write("\n\uBCF8\uBB38 \uC0BD\uC785\uC6A9 markdown snippet (\uC9C1\uC811 wiki page edit \uC73C\uB85C \uBCF8\uBB38\uC5D0 \uBC15\uC73C\uC138\uC694):\n");
-      process.stdout.write(`  ![${res.result.name}](/wikis/${wikiId}/files/${res.result.attachFileId})
+      if (fileType === "inline_image") {
+        process.stdout.write("\n\uBCF8\uBB38 \uC0BD\uC785\uC6A9 markdown snippet (\uC9C1\uC811 wiki page edit \uC73C\uB85C \uBCF8\uBB38\uC5D0 \uBC15\uC73C\uC138\uC694):\n");
+        process.stdout.write(`  ![${res.result.name}](/wikis/${wikiId}/files/${res.result.attachFileId})
 `);
+      }
     }
   } catch (e) {
     stopSpinner(false);
@@ -4359,6 +4430,7 @@ var import_commander41 = require("commander");
 var import_promises11 = require("fs/promises");
 var import_node_path9 = require("path");
 var wikiPageFileDownloadCommand = new import_commander41.Command("download").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uCCA8\uBD80\uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC").argument("[arg1]", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC, Dooray Wiki URL, \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg2]", "page-id \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg3]", "\uD30C\uC77C ID (positional 3\uAC1C \uBAA8\uB4DC)").option("--id <pageId>", "\uC704\uD0A4 \uD398\uC774\uC9C0 ID").option("--url <url>", "Dooray Wiki URL").option("--project <code>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC (--id \uBAA8\uB4DC\uC5D0\uC11C wikiId \uD574\uC11D\uC6A9)").option("--file-id <fileId>", "\uD30C\uC77C ID (positional \uB300\uCCB4)").option("-o, --output <dir>", "\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC", ".").action(async (arg1, arg2, arg3, opts) => {
+  const globalOpts = wikiPageFileDownloadCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   let projectArg;
@@ -4407,11 +4479,11 @@ var wikiPageFileDownloadCommand = new import_commander41.Command("download").des
   startSpinner("\uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC \uC911...");
   try {
     const { buffer, fileName } = await client.downloadWikiPageFile(wikiId, pageId, fileId);
-    const outputPath = (0, import_node_path9.join)(opts.output, (0, import_node_path9.basename)(fileName));
+    const safeName = (0, import_node_path9.basename)(decodeURIComponent(fileName));
+    const outputPath = (0, import_node_path9.join)(opts.output, safeName);
     await (0, import_promises11.writeFile)(outputPath, Buffer.from(buffer));
     stopSpinner(true, `\uB2E4\uC6B4\uB85C\uB4DC \uC644\uB8CC: ${outputPath}`);
-    process.stdout.write(`${outputPath}
-`);
+    emitDownloadResult(globalOpts, { outputPath, fileName: safeName, size: buffer.byteLength });
   } catch (e) {
     stopSpinner(false);
     throw e;
@@ -4423,6 +4495,7 @@ var import_commander42 = require("commander");
 var import_promises12 = require("fs/promises");
 var import_node_path10 = require("path");
 var wikiPageFileDownloadAllCommand = new import_commander42.Command("download-all").description("\uC704\uD0A4 \uD398\uC774\uC9C0\uC758 \uBAA8\uB4E0 \uCCA8\uBD80\uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC (general + inline image)").argument("[project]", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC (\uB610\uB294 \uCCAB \uC778\uC790\uC5D0 Dooray Wiki URL)").argument("[page-id]", "\uC704\uD0A4 \uD398\uC774\uC9C0 ID (project\uC640 \uD568\uAED8 \uC0AC\uC6A9)").option("--id <pageId>", "\uC704\uD0A4 \uD398\uC774\uC9C0 ID (--project \uB3D9\uBC18 \uD544\uC694)").option("--url <url>", "Dooray Wiki URL").option("--project <code>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC (--id \uBAA8\uB4DC\uC5D0\uC11C wikiId \uD574\uC11D\uC6A9)").option("-o, --output <dir>", "\uC800\uC7A5 \uB514\uB809\uD1A0\uB9AC", ".").action(async (project, pageIdArg, opts) => {
+  const globalOpts = wikiPageFileDownloadAllCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   const { wikiId, pageId } = await resolveWikiPageInput(client, {
@@ -4443,40 +4516,44 @@ var wikiPageFileDownloadAllCommand = new import_commander42.Command("download-al
   }
   if (allFiles.length === 0) {
     stopSpinner(true, "\uCCA8\uBD80\uD30C\uC77C \uC5C6\uC74C");
-    process.stdout.write("\uCCA8\uBD80\uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
+    if (globalOpts.json) {
+      printJson({ count: 0, succeeded: [], failed: [] });
+    } else if (!globalOpts.quiet) {
+      process.stdout.write("\uCCA8\uBD80\uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n");
+    }
     return;
   }
   stopSpinner(true, `${allFiles.length}\uAC1C \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC \uC2DC\uC791`);
   await (0, import_promises12.mkdir)(opts.output, { recursive: true });
-  let successCount = 0;
-  const failures = [];
+  const succeeded = [];
+  const failed = [];
   for (const f of allFiles) {
     try {
       const { buffer, fileName } = await client.downloadWikiPageFile(wikiId, pageId, f.id);
-      await (0, import_promises12.writeFile)((0, import_node_path10.join)(opts.output, fileName), Buffer.from(buffer));
-      process.stdout.write(`\u2713 ${fileName}
+      const safeName = (0, import_node_path10.basename)(decodeURIComponent(fileName));
+      const outputPath = (0, import_node_path10.join)(opts.output, safeName);
+      await (0, import_promises12.writeFile)(outputPath, Buffer.from(buffer));
+      succeeded.push({ path: outputPath, fileName: safeName });
+      if (!globalOpts.json && !globalOpts.quiet) {
+        process.stdout.write(`\u2713 ${safeName}
 `);
-      successCount++;
+      }
     } catch (e) {
-      failures.push({ fileId: f.id, error: e instanceof Error ? e.message : String(e) });
-      process.stderr.write(`\u2717 ${f.name} (${f.id}): ${e instanceof Error ? e.message : String(e)}
+      failed.push({ fileId: f.id, error: e instanceof Error ? e.message : String(e) });
+      if (!globalOpts.json) {
+        process.stderr.write(`\u2717 ${f.name} (${f.id}): ${e instanceof Error ? e.message : String(e)}
 `);
+      }
     }
   }
-  process.stdout.write(`
-\uC644\uB8CC: ${successCount}/${allFiles.length}
-`);
-  if (failures.length > 0) {
-    throw new DoorayCliError(
-      `${failures.length}\uAC1C \uD30C\uC77C \uB2E4\uC6B4\uB85C\uB4DC \uC2E4\uD328 (\uC131\uACF5: ${successCount}/${allFiles.length})`,
-      EXIT_API_ERROR
-    );
-  }
+  emitDownloadAllResult(globalOpts, { count: allFiles.length, succeeded, failed });
+  if (failed.length > 0) process.exitCode = 1;
 });
 
 // src/commands/wiki/page-file/delete.ts
 var import_commander43 = require("commander");
 var wikiPageFileDeleteCommand = new import_commander43.Command("delete").description("\uC704\uD0A4 \uD398\uC774\uC9C0 \uCCA8\uBD80\uD30C\uC77C \uC0AD\uC81C").argument("[arg1]", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC, Dooray Wiki URL, \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg2]", "page-id \uB610\uB294 (`--id`/`--url` \uBAA8\uB4DC\uC77C \uB54C) \uD30C\uC77C ID").argument("[arg3]", "\uD30C\uC77C ID (positional 3\uAC1C \uBAA8\uB4DC)").option("--id <pageId>", "\uC704\uD0A4 \uD398\uC774\uC9C0 ID").option("--url <url>", "Dooray Wiki URL").option("--project <code>", "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC (--id \uBAA8\uB4DC\uC5D0\uC11C wikiId \uD574\uC11D\uC6A9)").option("--file-id <fileId>", "\uD30C\uC77C ID (positional \uB300\uCCB4)").action(async (arg1, arg2, arg3, opts) => {
+  const globalOpts = wikiPageFileDeleteCommand.optsWithGlobals();
   const config = await getConfigOrThrow();
   const client = new DoorayApiClient(config.apiKey, config.baseUrl);
   let projectArg;
@@ -4526,8 +4603,7 @@ var wikiPageFileDeleteCommand = new import_commander43.Command("delete").descrip
   try {
     await client.deleteWikiPageFile(wikiId, pageId, fileId);
     stopSpinner(true, "\uC0AD\uC81C \uC644\uB8CC");
-    process.stdout.write(`\uD30C\uC77C(${fileId})\uC774 \uC0AD\uC81C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
-`);
+    emitDeleteResult(globalOpts, { fileId });
   } catch (e) {
     stopSpinner(false);
     throw e;
@@ -5575,7 +5651,7 @@ function sanitizeArgv(argv) {
 
 // src/index.ts
 var program = new import_commander61.Command();
-program.name("dooray").description("Dooray REST API CLI").version("0.10.1").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.11.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.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.10.1",
+  "version": "0.11.0",
   "description": "CLI tool for Dooray project management — AI agent & terminal friendly",
   "keywords": [
     "dooray",

package/skills/dooray-cli/SKILL.md

@@ -62,7 +62,7 @@ dooray doctor                                 # 설정 검증
 | 멤버 상세 (organizationMemberId) | `dooray member get <organizationMemberId>` (cache 우회, ADR-021) |
 | organization 전체 멤버 검색 | `dooray member search <keyword>` (이름 기본), `--email`(이메일 exact), `--user-code`(사번 like), `--user-code-exact`(사번 exact), `--page`/`--size` |
 | 업무 목록 조회 | `dooray post list <project>` |
-| 업무 검색 | `dooray post search <project> "<keyword>"` |
+| 업무 검색 | `dooray post search <project|projectId> "<keyword>"` — projectId (15+자리 numeric) 직접 입력 시 cache 우회 (ADR-030) |
 | 업무 상세 보기 | `dooray post get <project> <number>` |
 | 업무 생성 | `dooray post create <project> --title "..." [--body "..." \| --body-file <path>]` (`--tag`/`--parent`/`--workflow`/`--milestone` 지원) |
 | 템플릿 기반 업무 생성 | `dooray post create <project> --template <name\|id>` — body/users/tags 자동 채움 (사용자 옵션 우선 override, ADR-027) |
@@ -104,6 +104,7 @@ dooray doctor                                 # 설정 검증
 | 전체 첨부파일 다운로드 | `dooray post file download-all <project> <number>` |
 | 첨부파일 업로드 | `dooray post file upload <project> <number> <file-path>` |
 | 첨부파일 삭제 | `dooray post file delete <project> <number> <file-id>` |
+| file 명령군 자동화 파싱 | `dooray post file <verb> ... --json` — `download` = `{outputPath,fileName,size}`, `download-all` = `{count,succeeded,failed}` (부분 실패 시 exit 1), `delete` = `{fileId,status}`, `upload` = `res.result` raw (ADR-031) |
 | 댓글 첨부 목록 | `dooray post comment file list <project> <number> <comment-id>` |
 | 댓글 파일 업로드 | `dooray post comment file upload <project> <number> <comment-id> <path>` |
 | 댓글 파일 다운로드 | `dooray post comment file download <project> <number> <comment-id> <file-id>` |
@@ -207,6 +208,16 @@ dooray wiki pages <project> --json
 dooray wiki page get <project> <pageId> --json
 ```
 
+### 첨부파일 일괄 다운로드 후 실패 분리 (ADR-031)
+
+```bash
+# --json 으로 구조화 출력 → jq 로 성공/실패 분리
+RESULT=$(dooray post file download-all <project> <number> -o ./ --json)
+echo "$RESULT" | jq -r '.failed[] | "\(.fileId): \(.error)"' >&2
+echo "$RESULT" | jq -r '.succeeded[].path'
+# exit code 1 이 설정되어 있으면 실패 있는 상태
+```
+
 ### 위키 페이지 첨부파일 — 스킬 파일 팀 공유 (Issue #70)
 
 **스킬 파일 팀 공유**: 팀 위키에 스킬 파일 (예: `SKILL.md`) 을 `wiki page file upload` 로 첨부 → 팀원이 `wiki page file download-all` 로 일괄 받아 `~/.claude/skills/` 에 그대로 설치.
@@ -587,6 +598,24 @@ POST_ID=$(dooray post create <project> \
 템플릿 본문의 `${year}` / `${month}` 등 매크로는 Dooray 가 자동 치환 (`interpolation=true` 기본).
 사용자 정의 변수는 미지원 — 필요 시 client 측 string replace 로 처리.
 
+## projectId 직접 입력 시나리오 (Issue #78, ADR-030)
+
+AI agent 가 `member=me` 응답에 없는 프로젝트의 업무를 다뤄야 할 때:
+
+1. **사용자가 projectId (15+자리 numeric) 를 줬으면 그대로 명령에 사용**:
+   ```bash
+   dooray post search 1234567890123456789 "keyword"
+   ```
+
+2. **사용자가 코드만 줬고 cache 매칭 실패 (member 아닌 프로젝트)**:
+   - 에러 메시지의 ADR-030 안내 확인
+   - 사용자에게 "프로젝트 ID 가 필요합니다 — Dooray UI 의 프로젝트 URL 에서 확인 가능" 요청
+   - 또는 `dooray project list --type private` 로 private 캐시 갱신 시도
+
+3. **권한 없는 projectId 입력 시**: resolver 통과 후 후속 API 4xx 발생 — 에러 메시지에서 권한 부재 확인 후 사용자에게 보고
+
+권한 검증이 resolver 단보다 한 단계 지연되는 trade-off — AI 친화적 자동화 우선 (ADR-030).
+
 ## 캐시
 
 프로젝트, 멤버, 워크플로우, 위키 정보는 `~/.dooray/cache/`에 캐시된다.