@bifos/dooray-cli 0.5.2 → 0.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -41,6 +41,13 @@ dooray project members tc-ocr # 멤버 목록
41
41
  dooray project workflows tc-ocr # 워크플로우 목록
42
42
  ```
43
43
 
44
+ ### 멤버
45
+
46
+ ```bash
47
+ dooray member list tc-ocr # 프로젝트 멤버 목록 (이름·organizationMemberId)
48
+ dooray member get <organizationMemberId> # 멤버 상세 (cache 우회, ADR-021)
49
+ ```
50
+
44
51
  ### 업무
45
52
 
46
53
  ```bash
@@ -50,6 +57,17 @@ dooray post get tc-ocr 42 # 업무 상세
50
57
  dooray post get tc-ocr 42 --json # JSON 출력
51
58
  ```
52
59
 
60
+ #### 업무 식별 방식 (post 하위 12개 명령 공통)
61
+
62
+ | 방식 | 예시 |
63
+ |---|---|
64
+ | `<project> <number>` | `dooray post get tc-ocr 42` |
65
+ | Dooray URL positional | `dooray post get https://x.dooray.com/task/to/4319587406666362045` |
66
+ | `--id <postId>` | `dooray post get --id 4319587406666362045` |
67
+ | `--url <url>` | `dooray post get --url https://x.dooray.com/task/to/...` |
68
+
69
+ 대상: `post get`/`edit`/`done`/`workflow`, `post comment list`/`add`/`edit`/`delete`, `post file list`/`upload`/`download`/`download-all`/`delete`. AI 에이전트는 사용자 메시지의 Dooray URL을 그대로 첫 인자로 전달하면 가장 빠르다 (ADR-020).
70
+
53
71
  ### 업무 생성
54
72
 
55
73
  ```bash
@@ -61,8 +79,18 @@ dooray post create tc-ocr \
61
79
 
62
80
  # 본문을 파일에서 읽기 (--body와 --body-file은 동시 사용 불가)
63
81
  dooray post create tc-ocr --title "업무 제목" --body-file ./content.md
82
+
83
+ # 메타 옵션: --tag(반복) / --parent / --workflow / --milestone
84
+ dooray post create tc-ocr \
85
+ --title "업무 제목" --body "본문" --to "담당자이름" \
86
+ --tag "버그" --tag "긴급" \
87
+ --parent "tc-ocr/337" \
88
+ --workflow "진행 중" \
89
+ --milestone "Sprint 12"
64
90
  ```
65
91
 
92
+ > mandatory-tag 정책 프로젝트(예: `tc-ocr`)에서는 mandatory 그룹마다 1개 이상 `--tag`로 지정해야 한다. 누락 시 클라이언트가 사전 검증으로 후보 목록과 함께 에러 출력.
93
+
66
94
  ### 업무 수정
67
95
 
68
96
  ```bash
@@ -84,6 +112,8 @@ dooray post comment add tc-ocr 42 --body "댓글 내용"
84
112
  dooray post comment add tc-ocr 42 --body-file ./comment.md
85
113
  ```
86
114
 
115
+ > table 출력의 Creator 컬럼은 프로젝트 멤버 캐시로 자동 enrich되며, `--json`은 raw 응답을 유지한다 (ADR-021).
116
+
87
117
  ### 상태 변경
88
118
 
89
119
  ```bash
@@ -151,6 +181,15 @@ dooray post file upload <project> <number> ./report.pdf
151
181
  dooray post file delete <project> <number> <file-id>
152
182
  ```
153
183
 
184
+ URL/`--id`/`--url` 모드에서는 sub-id를 옵션으로 전달:
185
+ ```bash
186
+ dooray post file download --url <url> --file-id <fileId> -o ./downloads
187
+ dooray post file delete --url <url> --file-id <fileId>
188
+ dooray post file upload --url <url> --file ./report.pdf
189
+ dooray post comment edit --url <url> --comment-id <commentId> --body "..."
190
+ dooray post comment delete --url <url> --comment-id <commentId>
191
+ ```
192
+
154
193
  ## 출력 모드
155
194
 
156
195
  | 플래그 | 설명 | 용도 |