@bifos/dooray-cli 0.4.0 → 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
@@ -34,12 +34,20 @@ dooray doctor
34
34
  ### 프로젝트
35
35
 
36
36
  ```bash
37
- dooray project list # 프로젝트 목록
37
+ dooray project list # 프로젝트 목록 (기본: public)
38
38
  dooray project list --search ocr # 코드로 검색
39
+ dooray project list --type private # 개인 프로젝트 목록
39
40
  dooray project members tc-ocr # 멤버 목록
40
41
  dooray project workflows tc-ocr # 워크플로우 목록
41
42
  ```
42
43
 
44
+ ### 멤버
45
+
46
+ ```bash
47
+ dooray member list tc-ocr # 프로젝트 멤버 목록 (이름·organizationMemberId)
48
+ dooray member get <organizationMemberId> # 멤버 상세 (cache 우회, ADR-021)
49
+ ```
50
+
43
51
  ### 업무
44
52
 
45
53
  ```bash
@@ -49,16 +57,40 @@ dooray post get tc-ocr 42 # 업무 상세
49
57
  dooray post get tc-ocr 42 --json # JSON 출력
50
58
  ```
51
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
+
52
71
  ### 업무 생성
53
72
 
54
73
  ```bash
55
74
  dooray post create tc-ocr \
56
- --subject "업무 제목" \
75
+ --title "업무 제목" \
57
76
  --body "본문 마크다운" \
58
77
  --to "담당자이름" \
59
78
  --priority normal
79
+
80
+ # 본문을 파일에서 읽기 (--body와 --body-file은 동시 사용 불가)
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"
60
90
  ```
61
91
 
92
+ > mandatory-tag 정책 프로젝트(예: `tc-ocr`)에서는 mandatory 그룹마다 1개 이상 `--tag`로 지정해야 한다. 누락 시 클라이언트가 사전 검증으로 후보 목록과 함께 에러 출력.
93
+
62
94
  ### 업무 수정
63
95
 
64
96
  ```bash
@@ -66,7 +98,10 @@ dooray post create tc-ocr \
66
98
  dooray post edit tc-ocr 42
67
99
 
68
100
  # 비대화형 (AI 에이전트 친화)
69
- dooray post edit tc-ocr 42 --subject "새 제목" --body "새 본문"
101
+ dooray post edit tc-ocr 42 --title "새 제목" --body "새 본문"
102
+
103
+ # 본문을 파일에서 읽기
104
+ dooray post edit tc-ocr 42 --body-file ./updated.md
70
105
  ```
71
106
 
72
107
  ### 댓글
@@ -74,8 +109,11 @@ dooray post edit tc-ocr 42 --subject "새 제목" --body "새 본문"
74
109
  ```bash
75
110
  dooray post comment list tc-ocr 42
76
111
  dooray post comment add tc-ocr 42 --body "댓글 내용"
112
+ dooray post comment add tc-ocr 42 --body-file ./comment.md
77
113
  ```
78
114
 
115
+ > table 출력의 Creator 컬럼은 프로젝트 멤버 캐시로 자동 enrich되며, `--json`은 raw 응답을 유지한다 (ADR-021).
116
+
79
117
  ### 상태 변경
80
118
 
81
119
  ```bash
@@ -89,8 +127,10 @@ dooray post workflow tc-ocr 42 "진행 중" # 워크플로우 변경
89
127
  dooray wiki list # 위키 목록
90
128
  dooray wiki pages tc-ocr # 페이지 목록
91
129
  dooray wiki page get tc-ocr <page-id> # 페이지 상세
92
- dooray wiki page create tc-ocr # 페이지 생성 ($EDITOR)
93
- dooray wiki page edit tc-ocr <page-id> # 페이지 수정 ($EDITOR)
130
+ dooray wiki page create tc-ocr --title "..." [--parent <page-id>] [--body "..." | --body-file <path>]
131
+ dooray wiki page edit tc-ocr <page-id> --title "새 제목" # 제목만 (비대화형)
132
+ dooray wiki page edit tc-ocr <page-id> --body "..." | --body-file <path> # 본문만 (비대화형)
133
+ dooray wiki page edit tc-ocr <page-id> # $EDITOR (플래그 없을 때)
94
134
  ```
95
135
 
96
136
  ### 메일
@@ -141,6 +181,15 @@ dooray post file upload <project> <number> ./report.pdf
141
181
  dooray post file delete <project> <number> <file-id>
142
182
  ```
143
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
+
144
193
  ## 출력 모드
145
194
 
146
195
  | 플래그 | 설명 | 용도 |
@@ -166,7 +215,7 @@ cp -r skills/dooray-cli ~/.claude/skills/
166
215
 
167
216
  ## 캐시
168
217
 
169
- 프로젝트, 멤버, 워크플로우 정보는 `~/.dooray/cache/`에 캐시됩니다.
218
+ 프로젝트, 멤버, 워크플로우, 위키 정보는 `~/.dooray/cache/`에 캐시됩니다.
170
219
 
171
220
  ```bash
172
221
  dooray cache clear # 캐시 삭제