@bifos/dooray-cli 0.10.1 → 0.12.0

package/README.md

@@ -50,7 +50,7 @@ dooray project members <project>              # 멤버 목록
 dooray project workflows <project>            # 워크플로우 목록
 dooray project groups <project>              # 멤버 그룹 목록 (ID / Code)
 dooray project tags <project>                # 태그 목록 (ID / Color / Name / Group / Mandatory)
-dooray project templates <project>          # 템플릿 목록 (ID / Template Name, ADR-027)
+dooray project templates <project>          # 템플릿 목록 (ID / Template Name)
 ```
 
 > **태그 캐시 갱신**: 이전 버전에서 캐시한 태그가 색상 없이 표시되면 `dooray cache clear` 실행 후 다시 조회하세요.
@@ -59,7 +59,7 @@ dooray project templates <project>          # 템플릿 목록 (ID / Template Na
 
 ```bash
 dooray member list <project>                  # 프로젝트 멤버 목록 (이름·organizationMemberId)
-dooray member get <organizationMemberId>      # 멤버 상세 (cache 우회, ADR-021)
+dooray member get <organizationMemberId>      # 멤버 상세 (cache 우회)
 
 # organization 전체 멤버 검색
 dooray member search 홍길동                   # 이름 검색
@@ -83,13 +83,34 @@ dooray post get <project> 42 --json           # JSON 출력
 | 방식 | 예시 |
 |---|---|
 | `<project> <number>` | `dooray post get <project> 42` |
-| Dooray URL positional (`/task/to/<postId>`) | `dooray post get https://x.dooray.com/task/to/<postId>` |
-| Dooray URL positional (브라우저 주소창 복사본) | `dooray post get https://x.dooray.com/task/<projectId>/<postId>` |
+| Dooray URL positional | `dooray post get https://x.dooray.com/task/to/<postId>` |
 | `--id <postId>` | `dooray post get --id <postId>` |
-| `--url <url>` | `dooray post get --url https://x.dooray.com/task/to/...` |
+| `--url <url>` | `dooray post get --url https://x.dooray.com/task/to/<postId>` |
+
+지원 URL 형식 3종 (positional 첫 인자 / `--url` 공통):
+
+- `https://*.dooray.com/task/to/<postId>`
+- `https://*.dooray.com/task/<projectId>/<postId>` — 브라우저 주소창 복사본
+- `https://*.dooray.com/project/tasks/<postId>` — 프로젝트 업무 목록에서 열기
 
 대상: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`.
-AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다 (ADR-020).
+AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다.
+
+**projectId 직접 입력**:
+
+`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.
 
 ### 업무 생성
 
@@ -115,7 +136,18 @@ dooray post create <project> \
 > mandatory-tag 정책 프로젝트(예: `<project>`)에서는 mandatory 그룹마다 1개 이상 `--tag`로 지정해야 한다.
 > 누락 시 클라이언트가 사전 검증으로 후보 목록과 함께 에러 출력.
 
-#### 템플릿 기반 정형 task (ADR-027)
+> **`post create` 출력의 `.id` 는 internal postId (19자리 숫자)입니다.**
+> 이 ID 로 후속 조회·수정·댓글 작업을 할 때는 **`--id <postId>`** 를 사용하세요.
+> `<project> <업무번호>` 의 번호 자리에 postId 를 넣으면 안내 에러가 발생합니다.
+>
+> ```bash
+> # 생성 후 바로 조회하는 패턴
+> POST_ID=$(dooray post create <project> --title "..." --json | jq -r '.id')
+> dooray post get --id "$POST_ID"
+> dooray post comment add --id "$POST_ID" --body "첫 댓글"
+> ```
+
+#### 템플릿 기반 정형 task
 
 ```bash
 # 프로젝트의 템플릿 목록
@@ -166,7 +198,7 @@ dooray post comment add <project> 42 --body "댓글 내용"
 dooray post comment add <project> 42 --body-file ./comment.md
 ```
 
-> table 출력의 Creator 컬럼은 프로젝트 멤버 캐시로 자동 enrich되며, `--json`은 raw 응답을 유지한다 (ADR-021).
+> table 출력의 Creator 컬럼은 프로젝트 멤버 캐시로 자동 enrich되며, `--json`은 raw 응답을 유지한다.
 
 #### 멘션·내부 링크 자동 삽입
 
@@ -190,7 +222,7 @@ dooray post comment add <project> <post-number> --body "..." --link-task <projec
 > `--mention` / `--mention-group` / `--link-task` / `--dry-run` 은 `post create`, `post edit`, `post comment add`, `post comment edit` 4 명령 모두 지원.
 > 이전 버전 캐시는 orgId가 없으므로 첫 호출 시 자동 갱신됩니다 (또는 `dooray cache clear`).
 
-#### 참조자(cc) / 담당자(to) 변경 (ADR-025)
+#### 참조자(cc) / 담당자(to) 변경
 
 ```bash
 # 멤버/그룹 추가 (기존 참조자 유지 + dedupe)
@@ -209,7 +241,7 @@ interactive ($EDITOR) 모드에서는 위 6개 옵션이 무시되고 stderr 경
 `post edit --dry-run --json` 사용 시 출력에 `users: { to, cc }` 가 포함되어 API 호출 없이 변경 결과 미리보기 가능.
 `post create --dry-run` 은 본문만 출력하며 `users` 는 포함하지 않음.
 
-**그룹 cc / mention 사용 예 (Issue #76 fix)**:
+**그룹 cc / mention 사용 예**:
 
 ```bash
 # code 부분일치
@@ -230,7 +262,7 @@ dooray post edit <project> <post-number> --cc-group dev-team --dry-run --json |
 # 출력 예: [{ "type": "group", "group": { "projectMemberGroupId": "...", "members": [] } }, ...]
 ```
 
-#### 생성 후 태그 변경 (Issue #66)
+#### 생성 후 태그 변경
 
 ```bash
 # 기존 태그 유지 + 신규 추가 (dedupe)
@@ -244,7 +276,7 @@ dooray post edit --id <postId> --tag-remove "<group>: <name>"
 ```
 
 `--title` / `--body` 없이 단독 호출 가능 — 기존 본문은 자동 재전송.
-mandatory tag 그룹은 `post create` 와 동일하게 사전 검증 (ADR-019).
+mandatory tag 그룹은 `post create` 와 동일하게 사전 검증.
 
 #### 상위 업무 변경 (`--parent`)
 
@@ -261,7 +293,7 @@ dooray post edit --id <postId> --title "<원제목>" --parent <other-parent-post
 
 interactive ($EDITOR) 모드에서 `--parent` 사용 시 무시 + stderr 경고.
 **parent 만 단독 변경하려면 `--title "<원제목>"` 동반 필요** — `post edit` 는 본문 변경(`--title`/`--body`) 동반 시에만 non-interactive 분기로 들어감.
-parent 변경은 그 분기 안에서만 수행됨. (Issue #60)
+parent 변경은 그 분기 안에서만 수행됨.
 
 `--dry-run --json` 출력의 `parentChange` 필드는 **사용자 입력 원문 그대로** (`<project>/<number>` 또는 raw postId).
 resolver 처리 전 미리보기 값이며 실제 호출 대상 `postId` 가 아님.
@@ -269,7 +301,7 @@ dry-run 은 API 미호출 원칙을 유지해 `resolvePostRef` 도 건너뜀.
 
 #### `--to` / `--cc` / `--mention` 입력 형식 (자동 분기)
 
-이름 외에도 이메일 / organizationMemberId 직접 입력 가능 — **동명이인 우회 + ID 직접 입력** (Issue #58):
+이름 외에도 이메일 / organizationMemberId 직접 입력 가능 — **동명이인 우회 + ID 직접 입력**:
 
 ```bash
 # 이름 (이전부터 지원, 부분일치)
@@ -353,7 +385,7 @@ dooray wiki page edit <project> <page-id> --body "..." | --body-file <path>  #
 dooray wiki page edit <project> <page-id>                                     # $EDITOR (플래그 없을 때)
 ```
 
-#### 위키 페이지 첨부파일 (Issue #70)
+#### 위키 페이지 첨부파일
 
 post 의 `post file` 명령군과 동일 패턴 — `<project> <page-id>` 외에도 `--id`/`--url`/positional URL 지원.
 
@@ -383,11 +415,42 @@ 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 코드를 사용할 수 있습니다:
+
+```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 (general) — res.result raw (--quiet 는 id 만)
+dooray wiki page file upload <project> <page-id> --file ./report.pdf --json
+
+# upload (inline_image) — res.result + markdownSnippet 필드 추가
+dooray wiki page file upload <project> <page-id> --file ./diagram.png --type inline_image --json
+# 출력 예:
+# {
+#   "id": "<id>",
+#   "attachFileId": "<attachFileId>",
+#   "name": "diagram.png",
+#   "size": 12345,
+#   "type": "inline_image",
+#   "markdownSnippet": "![diagram.png](/wikis/<wikiId>/files/<attachFileId>)"
+# }
+
+# 자동화: markdownSnippet 을 jq 로 추출해 본문에 삽입
+SNIPPET=$(dooray wiki page file upload <project> <page-id> --file ./diagram.png --type inline_image --json | jq -r '.markdownSnippet')
+```
+
 **주의**:
 - `upload` 시 multipart 필드 순서 (`type` → `file`) 가 중요.
-  클라이언트가 자동으로 강제 (ADR-029 참조)
+  클라이언트가 자동으로 강제
 - `inline_image` 로 올린 파일은 본문에 markdown 으로 박혀야 위키에서 보임.
-  upload stdout 의 snippet 을 복사해서 `dooray wiki page edit` 으로 본문에 직접 추가
+  `--json` 의 `markdownSnippet` 을 복사하거나 jq 로 추출해 `dooray wiki page edit` 본문에 직접 추가
 - `delete` 는 confirm 없이 즉시 삭제 (실수 방지 책임은 호출자)
 
 #### 위키 페이지 댓글
@@ -474,6 +537,25 @@ dooray post file upload <project> <number> ./report.pdf
 dooray post file delete <project> <number> <file-id>
 ```
 
+자동화 스크립트에서 `--json` 옵션으로 구조화된 출력을 파이프로 가공할 수 있습니다:
+
+```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
@@ -486,7 +568,7 @@ dooray post comment delete --url <url> --comment-id <commentId>
 ### 댓글 첨부 파일 (`post comment file *`)
 
 자동화로 댓글에 인라인 이미지 / 파일을 삽입할 때 사용.
-4 명령 (list/upload/download/delete) 모두 `<project> <post-number> <comment-id>` 또는 `--id <postId> --comment-id <logId>` / `--url <url> --comment-id <logId>` 패턴 지원 (ADR-020).
+4 명령 (list/upload/download/delete) 모두 `<project> <post-number> <comment-id>` 또는 `--id <postId> --comment-id <logId>` / `--url <url> --comment-id <logId>` 패턴 지원.
 
 ```bash
 # 첨부 목록
@@ -503,7 +585,7 @@ dooray post comment file delete <project> <post-num> <comment-id> <file-id> --ye
 ```
 
 > Dooray REST API 가 댓글 전용 attachment endpoint 를 제공하지 않아 내부적으로
-> post-level files API 와 댓글 본문 PUT 의 합성으로 동작 (ADR-024). 단일 명령
+> post-level files API 와 댓글 본문 PUT 의 합성으로 동작한다. 단일 명령
 > = 단일 파일 — 다중 파일은 호출자가 반복 호출.
 
 ## 출력 모드
@@ -550,7 +632,7 @@ dooray feedback --last --title "재현" --body "추가 설명" --dry-run  # 미
 dooray feedback --dry-run
 ```
 
-> **개인정보 보호 (ADR-023)**: `--last` 모드에서 argv는 `--api-key`/`--token`/`Authorization` 등 시크릿 패턴을 자동 마스킹 후 저장합니다. cwd/env는 미저장.
+> **개인정보 보호**: `--last` 모드에서 argv는 `--api-key`/`--token`/`Authorization` 등 시크릿 패턴을 자동 마스킹 후 저장합니다. cwd/env는 미저장.
 
 ## 캐시
 

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
   );
 }
@@ -1994,12 +1999,15 @@ async function resolvePost(client, projectId, postNumber) {
 // src/utils/dooray-url.ts
 var TASK_URL_RE = /^https?:\/\/[\w.-]+\.dooray\.com\/task\/to\/(\d+)(?:[/?#].*)?$/;
 var TASK_URL_ALT_RE = /^https?:\/\/[\w.-]+\.dooray\.com\/task\/(?:\d+)\/(\d+)(?:[/?#].*)?$/;
+var TASK_PROJECT_TASKS_RE = /^https?:\/\/[\w.-]+\.dooray\.com\/project\/tasks\/(\d+)(?:[/?#].*)?$/;
 var WIKI_URL_RE = /^https?:\/\/[\w.-]+\.dooray\.com\/wiki\/(\d+)\/(\d+)(?:[/?#].*)?$/;
 function parseDoorayTaskUrl(input2) {
   const m1 = TASK_URL_RE.exec(input2);
   if (m1) return m1[1];
   const m2 = TASK_URL_ALT_RE.exec(input2);
   if (m2) return m2[1];
+  const m3 = TASK_PROJECT_TASKS_RE.exec(input2);
+  if (m3) return m3[1];
   return null;
 }
 function parseDoorayWikiUrl(input2) {
@@ -2012,7 +2020,18 @@ function isLikelyDoorayUrl(input2) {
 }
 
 // src/resolvers/post-input.ts
-var INPUT_HELP = "\uC5C5\uBB34\uB97C \uC2DD\uBCC4\uD560 \uC815\uBCF4\uAC00 \uBD80\uC871\uD569\uB2C8\uB2E4. \uB2E4\uC74C \uC911 \uD558\uB098\uB97C \uC785\uB825\uD558\uC138\uC694:\n  - <project> <post-number>     \uC608: tc-ocr 337\n  - --id <postId>                \uC608: --id 4319587406666362045\n  - <Dooray URL>                 \uC608: https://x.dooray.com/task/to/4319587406666362045";
+function classifyPostInputToken(token) {
+  if (/^https?:\/\//.test(token)) return "url";
+  if (/^\d{15,}$/.test(token)) return "postId";
+  if (/^\d+$/.test(token)) return "postNumber";
+  return "project";
+}
+var URL_FORMAT_HINT = "\uC9C0\uC6D0 \uD615\uC2DD:\n  https://x.dooray.com/task/to/{postId}\n  https://x.dooray.com/task/{projectId}/{postId}\n  https://x.dooray.com/project/tasks/{postId}";
+var INPUT_HELP = `\uC5C5\uBB34\uB97C \uC2DD\uBCC4\uD560 \uC815\uBCF4\uAC00 \uBD80\uC871\uD569\uB2C8\uB2E4. \uB2E4\uC74C \uC911 \uD558\uB098\uB97C \uC785\uB825\uD558\uC138\uC694:
+  - <project> <post-number>     \uC608: my-project 337
+  - --id <postId>                \uC608: --id 1234567890123456789
+  - <Dooray URL>
+  ${URL_FORMAT_HINT}`;
 async function resolveByPostId(client, postId) {
   const res = await client.getPostStandalone(postId);
   const d = res.result;
@@ -2043,13 +2062,28 @@ async function resolvePostInput(client, args) {
     if (!postId) {
       throw new DoorayCliError(
         `--url \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: "${urlOpt}"
-\uC608: https://x.dooray.com/task/to/4319587406666362045`,
+${URL_FORMAT_HINT}`,
         EXIT_PARAM_ERROR
       );
     }
     return resolveByPostId(client, postId);
   }
   if (idOpt) {
+    const idType = classifyPostInputToken(idOpt);
+    if (idType === "postNumber") {
+      throw new DoorayCliError(
+        `"${idOpt}" \uB294 \uC5C5\uBB34 \uBC88\uD638\uB85C \uBCF4\uC785\uB2C8\uB2E4. <project> <post-number> \uD615\uC2DD\uC744 \uC4F0\uC138\uC694:
+  dooray post get <project> ${idOpt}`,
+        EXIT_PARAM_ERROR
+      );
+    }
+    if (idType === "url") {
+      throw new DoorayCliError(
+        `"${idOpt}" \uB294 URL \uD615\uC2DD\uC785\uB2C8\uB2E4. --url \uC635\uC158\uC744 \uC4F0\uC138\uC694:
+  dooray post get --url "${idOpt}"`,
+        EXIT_PARAM_ERROR
+      );
+    }
     return resolveByPostId(client, idOpt);
   }
   if (projectArg && !postNumberArg && isLikelyDoorayUrl(projectArg)) {
@@ -2057,13 +2091,28 @@ async function resolvePostInput(client, args) {
     if (!postId) {
       throw new DoorayCliError(
         `Dooray URL \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: "${projectArg}"
-\uC608: https://x.dooray.com/task/to/4319587406666362045`,
+${URL_FORMAT_HINT}`,
         EXIT_PARAM_ERROR
       );
     }
     return resolveByPostId(client, postId);
   }
   if (projectArg && postNumberArg) {
+    const numType = classifyPostInputToken(postNumberArg);
+    if (numType === "postId") {
+      throw new DoorayCliError(
+        `"${postNumberArg}" \uB294 \uB0B4\uBD80 ID(postId)\uB85C \uBCF4\uC785\uB2C8\uB2E4.
+\uC5C5\uBB34 \uBC88\uD638(#N)\uAC00 \uC544\uB2CC \uB0B4\uBD80 ID \uB85C \uC870\uD68C\uD558\uB824\uBA74 --id \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uC138\uC694:
+  dooray post get --id ${postNumberArg}`,
+        EXIT_PARAM_ERROR
+      );
+    }
+    if (numType !== "postNumber") {
+      throw new DoorayCliError(
+        `<post-number>\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: "${postNumberArg}"`,
+        EXIT_PARAM_ERROR
+      );
+    }
     const projectId = await resolveProject(client, projectArg);
     const num = Number(postNumberArg);
     if (!Number.isFinite(num) || num <= 0) {
@@ -3767,7 +3816,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 +3905,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 +3917,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 +3930,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 +4030,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 +4078,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
@@ -4278,7 +4385,15 @@ var wikiPageFileListCommand = new import_commander39.Command("list").description
 
 // src/commands/wiki/page-file/upload.ts
 var import_commander40 = require("commander");
+
+// src/utils/wiki-snippet.ts
+function wikiInlineImageSnippet(wikiId, attachFileId, name) {
+  return `![${name}](/wikis/${wikiId}/files/${attachFileId})`;
+}
+
+// src/commands/wiki/page-file/upload.ts
 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 +4450,35 @@ 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) {
+      const payload = fileType === "inline_image" ? {
+        ...res.result,
+        markdownSnippet: wikiInlineImageSnippet(
+          wikiId,
+          res.result.attachFileId,
+          res.result.name
+        )
+      } : res.result;
+      printJson(payload);
+    } 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(
+          `  ${wikiInlineImageSnippet(wikiId, res.result.attachFileId, res.result.name)}
+`
+        );
+      }
     }
   } catch (e) {
     stopSpinner(false);
@@ -4359,6 +4491,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 +4540,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 +4556,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 +4577,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 +4664,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 +5712,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.12.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.12.0",
   "description": "CLI tool for Dooray project management — AI agent & terminal friendly",
   "keywords": [
     "dooray",
@@ -11,14 +11,14 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/jon890/dooray-cli.git"
+    "url": "git+https://github.com/jon890/dooray-cli.git"
   },
   "homepage": "https://github.com/jon890/dooray-cli#readme",
   "bugs": {
     "url": "https://github.com/jon890/dooray-cli/issues"
   },
   "bin": {
-    "dooray": "./dist/index.js"
+    "dooray": "dist/index.js"
   },
   "files": [
     "dist",

package/skills/dooray-cli/SKILL.md

@@ -47,8 +47,13 @@ dooray doctor                                 # 설정 검증
 
 > **공통 (post 하위 16개 명령)**: 아래 명령은 `<project> <number>` 외에도 `--id <postId>`, `--url <url>`, 또는 첫 인자에 Dooray URL 을 직접 받는다.
 > `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`, `post comment file list`/`upload`/`download`/`delete`.
-> URL 형식: `https://*.dooray.com/task/to/<postId>` 또는 브라우저 주소창 복사본 `https://*.dooray.com/task/<projectId>/<postId>`.
-> **사용자가 URL을 줬으면 그대로 첫 인자로 전달**하는 것이 가장 빠른 경로 (resolve 단계 단축, ADR-020).
+>
+> 지원 URL 형식 3종 (positional 첫 인자 / `--url` 공통):
+> - `https://*.dooray.com/task/to/<postId>`
+> - `https://*.dooray.com/task/<projectId>/<postId>` — 브라우저 주소창 복사본
+> - `https://*.dooray.com/project/tasks/<postId>` — 프로젝트 업무 목록 → 업무 열기
+>
+> **사용자가 URL을 줬으면 그대로 첫 인자로 전달**하는 것이 가장 빠른 경로 (resolve 단계 단축).
 
 | 의도 | 커맨드 |
 |------|--------|
@@ -59,17 +64,17 @@ dooray doctor                                 # 설정 검증
 | 프로젝트 멤버 그룹 목록 | `dooray project groups <project>` (ID / Code) |
 | 프로젝트 태그 목록 | `dooray project tags <project>` (ID / Color / Name / Group / Mandatory) |
 | 프로젝트 템플릿 목록 | `dooray project templates <project>` (id / templateName) |
-| 멤버 상세 (organizationMemberId) | `dooray member get <organizationMemberId>` (cache 우회, ADR-021) |
+| 멤버 상세 (organizationMemberId) | `dooray member get <organizationMemberId>` (cache 우회) |
 | 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 get <project> <number>` |
+| 업무 검색 | `dooray post search <project|projectId> "<keyword>"` — projectId (15+자리 numeric) 직접 입력 시 cache 우회 |
+| 업무 상세 보기 | `dooray post get <project> <number>` (번호) / `dooray post get --id <postId>` (internal ID) |
 | 업무 생성 | `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) |
+| 템플릿 기반 업무 생성 | `dooray post create <project> --template <name\|id>` — body/users/tags 자동 채움 (사용자 옵션 우선 override) |
 | 업무 제목/본문 수정 | `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>` (`--sort`, `--reverse`, `--latest`, `--since`, `--from-author` 필터. table: Creator 자동 채움, `--json`: raw, ADR-021) |
+| 댓글 조회 | `dooray post comment list <project> <number>` (`--sort`, `--reverse`, `--latest`, `--since`, `--from-author` 필터. table: Creator 자동 채움, `--json`: raw) |
 | 최신 댓글 조회 | `dooray post comment latest <project> <number>` — 최신 댓글 1개 빠른 조회. `-n <N>`으로 N개 지정 |
 | 단일 댓글 조회 | `dooray post comment get <project> <number> <comment-id>` — 본문·메타·attachments 직접 fetch. `--id`/`--url` + `--comment-id` 모드 지원 |
 | 댓글 추가 | `dooray post comment add <project> <number> --body "..."` 또는 `--body-file <path>` |
@@ -83,7 +88,7 @@ dooray doctor                                 # 설정 검증
 | 위키 페이지 수정 (본문) | `dooray wiki page edit <project> <page-id> --body "..."` 또는 `--body-file ./new.md` |
 | 위키 페이지 수정 (에디터) | `dooray wiki page edit <project> <page-id>` (플래그 없으면 $EDITOR 열림) |
 | 위키 페이지 첨부 목록 | `dooray wiki page file list <project> <page-id>` (general + inline 합산, type 컬럼) |
-| 위키 페이지 첨부 업로드 | `dooray wiki page file upload <project> <page-id> --file <path> [--type inline_image]` (multipart type 순서 ADR-029) |
+| 위키 페이지 첨부 업로드 | `dooray wiki page file upload <project> <page-id> --file <path> [--type inline_image]` (multipart `type` 필드를 `file` 앞에 전송) |
 | 위키 페이지 첨부 다운로드 | `dooray wiki page file download <project> <page-id> --file-id <id> -o <dir>` |
 | 위키 페이지 첨부 일괄 다운로드 | `dooray wiki page file download-all <project> <page-id> -o <dir>` (files + images 전부) |
 | 위키 페이지 첨부 삭제 | `dooray wiki page file delete <project> <page-id> --file-id <id>` (confirm 없음) |
@@ -104,14 +109,15 @@ 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 |
 | 댓글 첨부 목록 | `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>` |
 | 댓글 파일 삭제 | `dooray post comment file delete <project> <number> <comment-id> <file-id> --yes` |
-| 참조자(cc) 멤버/그룹 추가 | `dooray post edit <project> <number> --cc-group <code>` — 기존 참조자 유지 + 그룹 추가 (dedupe, ADR-025) |
+| 참조자(cc) 멤버/그룹 추가 | `dooray post edit <project> <number> --cc-group <code>` — 기존 참조자 유지 + 그룹 추가 (dedupe) |
 | 참조자 전체 교체 | `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) |
+| `--cc-group <code\|id>` / `--mention-group <code\|id>` | 그룹 매칭 — 15+자리 numeric → id 직접 / 그 외 → code matchByName (부분일치) |
 | 상위 업무 설정/변경 | `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>` | 태그 전체 교체 |
@@ -186,7 +192,7 @@ dooray post comment add <project> 42 --body "진행 상황 업데이트: 80% 완
 ### 시나리오 — 댓글에 스크린샷 자동 첨부
 
 스크립트가 스크린샷을 댓글에 삽입하거나, 에이전트가 결과 파일을 첨부 댓글로 보고할 때 사용.
-Dooray REST API 가 댓글 전용 attachment endpoint 를 미지원하므로 내부적으로 post-level files API + 댓글 본문 PUT 합성으로 동작 (ADR-024).
+Dooray REST API 가 댓글 전용 attachment endpoint 를 미지원하므로 내부적으로 post-level files API + 댓글 본문 PUT 합성으로 동작한다.
 
 ```bash
 # 1. 댓글을 먼저 만든다 (텍스트만, --json 으로 commentId 획득)
@@ -207,7 +213,17 @@ dooray wiki pages <project> --json
 dooray wiki page get <project> <pageId> --json
 ```
 
-### 위키 페이지 첨부파일 — 스킬 파일 팀 공유 (Issue #70)
+### 첨부파일 일괄 다운로드 후 실패 분리
+
+```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 이 설정되어 있으면 실패 있는 상태
+```
+
+### 위키 페이지 첨부파일 — 스킬 파일 팀 공유
 
 **스킬 파일 팀 공유**: 팀 위키에 스킬 파일 (예: `SKILL.md`) 을 `wiki page file upload` 로 첨부 → 팀원이 `wiki page file download-all` 로 일괄 받아 `~/.claude/skills/` 에 그대로 설치.
 
@@ -222,6 +238,30 @@ dooray wiki page file download-all <project> <page-id> -o ~/.claude/skills/my-sk
 dooray wiki page file list <project> <page-id>
 ```
 
+### 위키 페이지 인라인 이미지 업로드 후 본문 자동 삽입
+
+`--type inline_image` 로 업로드 시 `--json` 응답에 `markdownSnippet` 필드가 포함됩니다.
+jq 로 추출해 본문에 바로 삽입하는 자동화가 가능합니다.
+
+```bash
+# 1. 인라인 이미지 업로드 — --json 으로 markdownSnippet 추출
+SNIPPET=$(dooray wiki page file upload <project> <page-id> \
+  --file ./diagram.png --type inline_image --json \
+  | jq -r '.markdownSnippet')
+# SNIPPET = "![diagram.png](/wikis/<wikiId>/files/<attachFileId>)"
+
+# 2. 기존 본문 조회
+CURRENT_BODY=$(dooray wiki page get <project> <page-id> --json | jq -r '.body.content')
+
+# 3. snippet 을 본문 끝에 추가해 업데이트
+NEW_BODY="${CURRENT_BODY}
+
+${SNIPPET}"
+dooray wiki page edit <project> <page-id> --body "$NEW_BODY"
+```
+
+**참고**: `general` 타입은 `markdownSnippet` 없음. `--quiet` 은 id 만 출력 (snippet 미포함).
+
 ### 위키 페이지 댓글 — 회의록 결정사항 자동 누적
 
 **회의록 결정사항 자동 누적**: 회의록 위키 페이지에 자동화 봇이 `wiki page comment add` 로 결정사항을 댓글로 누적, `wiki page comment list --latest 20` 으로 최근 토론 흐름 추적.
@@ -262,25 +302,39 @@ dooray wiki page comment latest <project> <page-id>
 
 ## 커맨드 상세
 
-### 업무 식별 방식 (post 하위 16개 명령 공통, ADR-020)
+### 업무 식별 방식 (post 하위 16개 명령 공통)
 
 아래 16개 명령은 4가지 입력을 모두 받는다:
 `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`, `post comment file list`/`upload`/`download`/`delete`.
 
 ```bash
-# (1) 기존 positional — 가장 익숙한 형태
+# (1) 기존 positional — 가장 익숙한 형태 (<number> 는 업무 번호 #N)
 dooray post get <project> 42
 
 # (2) Dooray URL을 첫 인자로 — 사용자 메시지에서 URL을 그대로 복사할 때 최적
+#     지원 형식 3종 모두 동일하게 작동
 dooray post get https://x.dooray.com/task/to/<postId>
+dooray post get https://x.dooray.com/task/<projectId>/<postId>
+dooray post get https://x.dooray.com/project/tasks/<postId>
 
-# (3) --id <postId>
+# (3) --id <postId>  — post create 결과의 .id 를 그대로 전달
 dooray post get --id <postId>
 
-# (4) --url <url>
+# (4) --url <url>  — URL 형식 3종 모두 지원
 dooray post get --url https://x.dooray.com/task/to/<postId>
 ```
 
+> ⚠️ **`post create` 결과 `.id` 는 internal postId (19자리 숫자)입니다.**
+> 이 숫자를 `<project> <업무번호>` 의 번호 자리에 넣으면 안내 에러가 발생합니다.
+> 후속 조회·수정·댓글은 반드시 **`--id <postId>`** 를 사용하세요.
+>
+> ```bash
+> POST_ID=$(dooray post create <project> --title "..." --json | jq -r '.id')
+> dooray post get --id "$POST_ID"                          # ✅ --id 사용
+> dooray post comment add --id "$POST_ID" --body "댓글"   # ✅ --id 사용
+> # dooray post get <project> "$POST_ID"                  # ❌ 안내 에러 발생
+> ```
+
 **우선순위 / 충돌 규칙**: `--id`+`--url` 동시 지정 → 에러.
 `--id`/`--url`+positional 동시 지정 → 에러.
 URL/`--id`/`--url` 모드는 standalone API(`getPost(postId)`)로 resolve 단계를 단축.
@@ -339,7 +393,7 @@ dooray post edit <project> <number> --body "새 본문"
 dooray post edit <project> <number> --title "새 제목" --body-file ./updated.md
 ```
 
-### 참조자(cc) / 담당자(to) 변경 — 멤버 · 그룹 (ADR-025)
+### 참조자(cc) / 담당자(to) 변경 — 멤버 · 그룹
 
 ```bash
 # 기존 참조자 유지 + 그룹 추가 (dedupe: organizationMemberId / projectMemberGroupId)
@@ -361,7 +415,7 @@ dooray post edit --id "$POST_ID" --cc-group qa-team --dry-run --json \
 
 > interactive (`$EDITOR`) 모드에서는 위 옵션이 무시되고 stderr 경고가 출력됩니다.
 
-## 동명이인 우회 — 이메일 / memberId 직접 (Issue #58)
+## 동명이인 우회 — 이메일 / memberId 직접
 
 이름이 동일한 멤버가 여러 명이라 `--cc 홍길동` 이 모호로 실패할 때:
 
@@ -379,7 +433,7 @@ dooray post edit --id "$POST_ID" --cc "$MEMBER_ID"
 - 이메일 정규형 — searchMembers exact
 - 그 외 — 이름 부분일치
 
-## 신규 업무 생성 후 그룹 cc 첨부 (ADR-025)
+## 신규 업무 생성 후 그룹 cc 첨부
 
 자동화 패턴:
 1. audit 리포트 분석
@@ -400,7 +454,7 @@ dooray post edit --id "$POST_ID" --cc-group qa-team
 
 ---
 
-## 자식 업무 먼저 → 후속 부모 지정 (Issue #60)
+## 자식 업무 먼저 → 후속 부모 지정
 
 ```bash
 # 1. 자식 업무 생성 (parent 모르고)
@@ -414,7 +468,7 @@ dooray post edit --id "$CHILD_ID" --title "subtask A" --parent <project>/<parent
 
 ---
 
-## 태그 사후 분류 자동화 (Issue #66)
+## 태그 사후 분류 자동화
 
 분류 분석 결과를 받아 태그를 재분류하는 자동화는 단독 호출 패턴이 효율적:
 
@@ -426,7 +480,7 @@ dooray post edit --id "$POST_ID" --tag "분류: $CATEGORY"
 ```
 
 태그만 변경하는 시나리오에서 `--title` / `--body` 강제 없음.
-mandatory 그룹은 친절한 에러 메시지로 안내 (ADR-019).
+mandatory 그룹은 친절한 에러 메시지로 안내.
 
 ---
 
@@ -452,7 +506,7 @@ dooray post comment latest <project> <number>
 
 ---
 
-## 그룹 멘션 / cc 시 AI agent 동선 (Issue #76, ADR-028)
+## 그룹 멘션 / cc 시 AI agent 동선
 
 자연어 그룹명을 사용자가 지칭했을 때 AI agent 의 의사결정 순서:
 
@@ -470,7 +524,7 @@ dooray post comment latest <project> <number>
    AI agent 가 자연어 의도와 가장 가까운 code 선택 후 재시도.
 
 3. **모든 컬럼이 빈값일 때 (response shape 이상) 회피**
-   - ADR-028 fix 이후 거의 발생 안 함 (`fetchAllMemberGroups` 가 nested array 정규화)
+   - 최근 수정 이후 거의 발생 안 함 (`fetchAllMemberGroups` 가 nested array 정규화)
    - 만약 발생 시: 사용자에게 그룹 id (UI 의 그룹 URL 에서 19자리 numeric) 확인 요청
    - `--cc-group <id>` / `--mention-group <id>` 직접 입력
    - 또는 그룹 멤버를 개별 `--cc <member>` / `--mention <member>` 로 지정
@@ -554,7 +608,7 @@ dooray feedback --last --title "에러 제목" --body "추가 설명" --dry-run
 dooray feedback --last --title "에러 제목" --body "추가 설명"            # 실제 등록
 ```
 
-> **참고**: `--last` 모드는 `trackLastRun: true` (ADR-023 opt-in)가 설정된 경우에만 직전 실패 명령이 자동 기록됨.
+> **참고**: `--last` 모드는 `trackLastRun: true` (opt-in)가 설정된 경우에만 직전 실패 명령이 자동 기록됨.
 > argv는 시크릿 패턴(`--api-key`/`--token`/`Authorization`) 마스킹 후 저장.
 
 ## 에러 핸들링
@@ -571,7 +625,7 @@ CLI 에러 발생 시 복구 방법:
 
 ---
 
-## 정형 task 자동화 (Issue #59 / ADR-027)
+## 정형 task 자동화
 
 매주 같은 형식의 task 를 만드는 자동화는 템플릿 + override 패턴이 효율적:
 
@@ -587,6 +641,24 @@ POST_ID=$(dooray post create <project> \
 템플릿 본문의 `${year}` / `${month}` 등 매크로는 Dooray 가 자동 치환 (`interpolation=true` 기본).
 사용자 정의 변수는 미지원 — 필요 시 client 측 string replace 로 처리.
 
+## projectId 직접 입력 시나리오
+
+AI agent 가 `member=me` 응답에 없는 프로젝트의 업무를 다뤄야 할 때:
+
+1. **사용자가 projectId (15+자리 numeric) 를 줬으면 그대로 명령에 사용**:
+   ```bash
+   dooray post search 1234567890123456789 "keyword"
+   ```
+
+2. **사용자가 코드만 줬고 cache 매칭 실패 (member 아닌 프로젝트)**:
+   - 에러 메시지의 안내 확인
+   - 사용자에게 "프로젝트 ID 가 필요합니다 — Dooray UI 의 프로젝트 URL 에서 확인 가능" 요청
+   - 또는 `dooray project list --type private` 로 private 캐시 갱신 시도
+
+3. **권한 없는 projectId 입력 시**: resolver 통과 후 후속 API 4xx 발생 — 에러 메시지에서 권한 부재 확인 후 사용자에게 보고
+
+권한 검증이 resolver 단보다 한 단계 지연되는 trade-off — AI 친화적 자동화 우선.
+
 ## 캐시
 
 프로젝트, 멤버, 워크플로우, 위키 정보는 `~/.dooray/cache/`에 캐시된다.