@bifos/dooray-cli 0.5.2 → 0.5.4

package/README.md

@@ -39,6 +39,17 @@ dooray project list --search ocr           # 코드로 검색
 dooray project list --type private         # 개인 프로젝트 목록
 dooray project members tc-ocr              # 멤버 목록
 dooray project workflows tc-ocr            # 워크플로우 목록
+dooray project groups tc-ocr              # 멤버 그룹 목록 (ID / Code)
+dooray project tags tc-ocr                # 태그 목록 (ID / Color / Name / Group / Mandatory)
+```
+
+> **태그 캐시 갱신**: 이전 버전에서 캐시한 태그가 색상 없이 표시되면 `dooray cache clear` 실행 후 다시 조회하세요.
+
+### 멤버
+
+```bash
+dooray member list tc-ocr                  # 프로젝트 멤버 목록 (이름·organizationMemberId)
+dooray member get <organizationMemberId>   # 멤버 상세 (cache 우회, ADR-021)
 ```
 
 ### 업무
@@ -50,6 +61,17 @@ dooray post get tc-ocr 42                  # 업무 상세
 dooray post get tc-ocr 42 --json           # JSON 출력
 ```
 
+#### 업무 식별 방식 (post 하위 12개 명령 공통)
+
+| 방식 | 예시 |
+|---|---|
+| `<project> <number>` | `dooray post get tc-ocr 42` |
+| Dooray URL positional | `dooray post get https://x.dooray.com/task/to/4319587406666362045` |
+| `--id <postId>` | `dooray post get --id 4319587406666362045` |
+| `--url <url>` | `dooray post get --url https://x.dooray.com/task/to/...` |
+
+대상: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`. AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다 (ADR-020).
+
 ### 업무 생성
 
 ```bash
@@ -61,8 +83,18 @@ dooray post create tc-ocr \
 
 # 본문을 파일에서 읽기 (--body와 --body-file은 동시 사용 불가)
 dooray post create tc-ocr --title "업무 제목" --body-file ./content.md
+
+# 메타 옵션: --tag(반복) / --parent / --workflow / --milestone
+dooray post create tc-ocr \
+  --title "업무 제목" --body "본문" --to "담당자이름" \
+  --tag "버그" --tag "긴급" \
+  --parent "tc-ocr/337" \
+  --workflow "진행 중" \
+  --milestone "Sprint 12"
 ```
 
+> mandatory-tag 정책 프로젝트(예: `tc-ocr`)에서는 mandatory 그룹마다 1개 이상 `--tag`로 지정해야 한다. 누락 시 클라이언트가 사전 검증으로 후보 목록과 함께 에러 출력.
+
 ### 업무 수정
 
 ```bash
@@ -84,6 +116,41 @@ dooray post comment add tc-ocr 42 --body "댓글 내용"
 dooray post comment add tc-ocr 42 --body-file ./comment.md
 ```
 
+> table 출력의 Creator 컬럼은 프로젝트 멤버 캐시로 자동 enrich되며, `--json`은 raw 응답을 유지한다 (ADR-021).
+
+#### comment list 필터 옵션
+
+```bash
+# 최신 5개 (desc 정렬)
+dooray post comment list tc-ocr 42 --latest 5
+
+# 특정 시간 이후 댓글만
+dooray post comment list tc-ocr 42 --since 2026-04-27
+
+# 작성자 이름으로 필터 (부분일치)
+dooray post comment list tc-ocr 42 --from-author 홍길동
+
+# 오름차순 / 내림차순 정렬
+dooray post comment list tc-ocr 42 --sort asc
+dooray post comment list tc-ocr 42 --sort desc
+dooray post comment list tc-ocr 42 --reverse   # --sort desc alias
+```
+
+#### comment latest
+
+최신 댓글 1개(또는 N개)를 빠르게 조회한다.
+
+```bash
+# 최신 댓글 1개
+dooray post comment latest tc-ocr 42
+
+# 최신 3개
+dooray post comment latest tc-ocr 42 -n 3
+
+# URL로도 가능
+dooray post comment latest --url <dooray-url>
+```
+
 ### 상태 변경
 
 ```bash
@@ -151,6 +218,15 @@ dooray post file upload <project> <number> ./report.pdf
 dooray post file delete <project> <number> <file-id>
 ```
 
+URL/`--id`/`--url` 모드에서는 sub-id를 옵션으로 전달:
+```bash
+dooray post file download --url <url> --file-id <fileId> -o ./downloads
+dooray post file delete   --url <url> --file-id <fileId>
+dooray post file upload   --url <url> --file ./report.pdf
+dooray post comment edit  --url <url> --comment-id <commentId> --body "..."
+dooray post comment delete --url <url> --comment-id <commentId>
+```
+
 ## 출력 모드
 
 | 플래그 | 설명 | 용도 |