@bifos/dooray-cli 0.10.0 → 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
@@ -209,6 +225,22 @@ interactive ($EDITOR) 모드에서는 위 6개 옵션이 무시되고 stderr 경
 `post edit --dry-run --json` 사용 시 출력에 `users: { to, cc }` 가 포함되어 API 호출 없이 변경 결과 미리보기 가능.
 `post create --dry-run` 은 본문만 출력하며 `users` 는 포함하지 않음.
 
+**그룹 cc / mention 사용 예 (Issue #76 fix)**:
+
+```bash
+# code 부분일치
+dooray post create <project> ... --cc-group "개발"
+
+# code 정확 일치
+dooray post create <project> ... --mention-group "all"
+
+# 19자리 id 직접 입력 (response shape robustness 또는 code 누락 그룹 회피)
+dooray post create <project> ... --cc-group "<19자리 group id>"
+
+# 후보 탐색
+dooray project groups <project>
+```
+
 ```bash
 dooray post edit <project> <post-number> --cc-group dev-team --dry-run --json | jq '.users.cc'
 # 출력 예: [{ "type": "group", "group": { "projectMemberGroupId": "...", "members": [] } }, ...]
@@ -367,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 참조)
@@ -458,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
   );
 }
@@ -1549,13 +1554,15 @@ var projectWorkflowsCommand = new import_commander7.Command("workflows").descrip
 var import_commander8 = require("commander");
 
 // src/resolvers/member-group.ts
+var GROUP_ID_RE = /^\d{15,}$/;
 async function fetchAllMemberGroups(client, projectId) {
   const all = [];
   let page = 0;
   const size = RESOLVER_FETCH_PAGE_SIZE;
   while (true) {
     const res = await client.getProjectMemberGroups(projectId, { page, size });
-    for (const g of res.result) {
+    const groups = res.result.flat();
+    for (const g of groups) {
       all.push({ id: g.id, code: g.code });
     }
     const total = res.totalCount ?? all.length;
@@ -1576,17 +1583,30 @@ function hasValidCode(g) {
 }
 async function resolveMemberGroup(client, projectId, input2) {
   const groups = await ensureMemberGroups(client, projectId);
+  if (GROUP_ID_RE.test(input2)) {
+    const found = groups.find((g) => g.id === input2);
+    if (found) {
+      return { id: found.id, code: found.code ?? "" };
+    }
+    throw new DoorayCliError(
+      `\uADF8\uB8F9 id \uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: "${input2}"
+\uC804\uCCB4 \uBAA9\uB85D\uC740 \`dooray project groups <project>\` \uB85C \uD655\uC778\uD558\uC138\uC694.`,
+      EXIT_PARAM_ERROR
+    );
+  }
   const valid = groups.filter(hasValidCode);
   const skipped = groups.length - valid.length;
   if (skipped > 0) {
     process.stderr.write(
-      `\u26A0  ${skipped}\uAC1C \uADF8\uB8F9\uC5D0 code \uAC00 \uC5C6\uC5B4 \uB9E4\uCE6D\uC5D0\uC11C \uC81C\uC678\uD588\uC2B5\uB2C8\uB2E4 (Dooray API \uC751\uB2F5 mismatch \u2014 ADR-026).
+      // ADR 번호 정정: ADR-026 → ADR-028
+      `\u26A0  ${skipped}\uAC1C \uADF8\uB8F9\uC5D0 code \uAC00 \uC5C6\uC5B4 \uB9E4\uCE6D\uC5D0\uC11C \uC81C\uC678\uD588\uC2B5\uB2C8\uB2E4 (ADR-028).
+   id \uC9C1\uC811 \uC785\uB825 (15+\uC790\uB9AC numeric) \uB610\uB294 UI \uC218\uB3D9 cc / \`--cc <member>\` \uC6B0\uD68C \uAC00\uB2A5.
 `
     );
   }
   const adapter = valid.map((g) => ({ name: g.code, id: g.id, code: g.code }));
   const match = matchByName(adapter, input2, "\uADF8\uB8F9", (g) => `${g.code} (${g.id})`, {
-    helpHint: "dooray project groups <project>"
+    helpHint: "\uC804\uCCB4 \uBAA9\uB85D: `dooray project groups <project>` / id \uC9C1\uC811 \uC785\uB825\uB3C4 \uAC00\uB2A5 (15+\uC790\uB9AC numeric \u2014 code \uB204\uB77D \uADF8\uB8F9\uB3C4 \uB9E4\uCE6D, ADR-028)"
   });
   return { id: match.id, code: match.code };
 }
@@ -3752,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;
@@ -3799,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
@@ -3811,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,
@@ -3823,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
@@ -3908,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;
@@ -3955,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
@@ -4264,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;
@@ -4320,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}
 `);
-    process.stdout.write(`name:         ${res.result.name}
+    } else {
+      process.stdout.write(`attachFileId: ${res.result.attachFileId}
 `);
-    process.stdout.write(`size:         ${res.result.size}
+      process.stdout.write(`name:         ${res.result.name}
 `);
-    process.stdout.write(`type:         ${res.result.type}
+      process.stdout.write(`size:         ${res.result.size}
 `);
-    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})
+      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})
+`);
+      }
     }
   } catch (e) {
     stopSpinner(false);
@@ -4344,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;
@@ -4392,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;
@@ -4408,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, {
@@ -4428,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;
@@ -4511,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;
@@ -5560,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.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.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.0",
+  "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>` |
@@ -111,6 +112,7 @@ dooray doctor                                 # 설정 검증
 | 참조자(cc) 멤버/그룹 추가 | `dooray post edit <project> <number> --cc-group <code>` — 기존 참조자 유지 + 그룹 추가 (dedupe, ADR-025) |
 | 참조자 전체 교체 | `dooray post edit <project> <number> --cc-clear --cc <name>` — 기존 참조자 비우고 신규 멤버만 |
 | 신규 업무 + 그룹 cc | `dooray post create <project> --title "..." --cc-group <code>` — 생성 시 그룹 참조자 포함 |
+| `--cc-group <code\|id>` / `--mention-group <code\|id>` | 그룹 매칭 — 15+자리 numeric → id 직접 / 그 외 → code matchByName (부분일치, ADR-028) |
 | 상위 업무 설정/변경 | `dooray post edit <project> <number> --title "<원제목>" --parent <ref>` (`<ref>`: `<project>/<number>` 또는 raw postId. `--title` 필수, unset 미지원) |
 | `dooray post edit --id <postId> --tag <name>` | 태그 추가 (반복, dedupe) |
 | `dooray post edit --id <postId> --tag-clear --tag <name>` | 태그 전체 교체 |
@@ -206,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/` 에 그대로 설치.
@@ -451,6 +463,35 @@ dooray post comment latest <project> <number>
 
 ---
 
+## 그룹 멘션 / cc 시 AI agent 동선 (Issue #76, ADR-028)
+
+자연어 그룹명을 사용자가 지칭했을 때 AI agent 의 의사결정 순서:
+
+1. **사용자가 명확한 code 를 줬으면 바로 시도**
+   ```bash
+   dooray post create <project> --mention-group "<code>"
+   ```
+   부분일치 가능 (예: "AI-Data" → "AI-Data파트" 매칭).
+
+2. **부분일치 모호 / 매칭 실패 시 후보 탐색**
+   ```bash
+   dooray project groups <project>
+   ```
+   ID + Code 표 출력.
+   AI agent 가 자연어 의도와 가장 가까운 code 선택 후 재시도.
+
+3. **모든 컬럼이 빈값일 때 (response shape 이상) 회피**
+   - ADR-028 fix 이후 거의 발생 안 함 (`fetchAllMemberGroups` 가 nested array 정규화)
+   - 만약 발생 시: 사용자에게 그룹 id (UI 의 그룹 URL 에서 19자리 numeric) 확인 요청
+   - `--cc-group <id>` / `--mention-group <id>` 직접 입력
+   - 또는 그룹 멤버를 개별 `--cc <member>` / `--mention <member>` 로 지정
+
+4. **모호한 자연어 매핑은 사용자에게 확인**
+   - 후보가 여러 개일 때 임의 선택 금지 — 사용자에게 선택지 제시
+   - 예: "AI-Data파트 / AI-Data실험팀 — 어느 그룹인가요?"
+
+순서 고정 — 멤버 먼저, 그룹 다음 (기존 정책 유지).
+
 ## 멘션·링크 자동 삽입 (first-class)
 
 `post create`, `post edit`, `post comment add`, `post comment edit` 모두 지원:
@@ -557,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/`에 캐시된다.