nworks 0.3.3 → 0.5.0

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
@@ -26,7 +26,7 @@ nworks login \
26
26
  --bot-id <BOT_ID>
27
27
 
28
28
  # User OAuth 로그인 (캘린더, 드라이브 등 사용자 API용)
29
- nworks login --user --scope calendar.read,file
29
+ nworks login --user --scope "calendar.read,file,mail,task,user.read"
30
30
 
31
31
  # 인증 확인
32
32
  nworks whoami
@@ -45,6 +45,18 @@ nworks drive list
45
45
 
46
46
  # 파일 업로드
47
47
  nworks drive upload --file ./report.pdf
48
+
49
+ # 메일 전송
50
+ nworks mail send --to "user@example.com" --subject "제목" --body "내용"
51
+
52
+ # 받은편지함 조회
53
+ nworks mail list
54
+
55
+ # 할 일 목록
56
+ nworks task list
57
+
58
+ # 할 일 생성
59
+ nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
48
60
  ```
49
61
 
50
62
  ## CLI Commands
@@ -131,6 +143,54 @@ nworks drive download --file-id <fileId> --out ./downloads --name report.pdf
131
143
 
132
144
  > **Note**: 드라이브 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope file`을 실행하세요. 읽기만 필요하면 `file.read` scope로 충분합니다.
133
145
 
146
+ ### 메일 (User OAuth 필요)
147
+
148
+ ```bash
149
+ # 메일 전송
150
+ nworks mail send --to "user@example.com" --subject "제목" --body "내용"
151
+
152
+ # CC/BCC 포함
153
+ nworks mail send --to "user@example.com" --cc "cc@example.com" --subject "제목" --body "내용"
154
+
155
+ # 받은편지함 목록
156
+ nworks mail list
157
+
158
+ # 읽지 않은 메일만
159
+ nworks mail list --unread
160
+
161
+ # 메일 상세 조회
162
+ nworks mail read --id <mailId>
163
+ ```
164
+
165
+ > **Note**: 메일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope mail`을 실행하세요. 읽기만 필요하면 `mail.read` scope로 충분합니다.
166
+
167
+ ### 할 일 (User OAuth 필요)
168
+
169
+ ```bash
170
+ # 할 일 목록 (기본 카테고리)
171
+ nworks task list
172
+
173
+ # 미완료만 조회
174
+ nworks task list --status TODO
175
+
176
+ # 할 일 생성
177
+ nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
178
+
179
+ # 마감일 지정
180
+ nworks task create --title "배포" --due 2026-03-20
181
+
182
+ # 할 일 완료 처리
183
+ nworks task update --id <taskId> --status done
184
+
185
+ # 할 일 미완료로 되돌리기
186
+ nworks task update --id <taskId> --status todo
187
+
188
+ # 할 일 삭제
189
+ nworks task delete --id <taskId>
190
+ ```
191
+
192
+ > **Note**: 할 일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope "task user.read"`를 실행하세요. (`user.read`는 사용자 ID 조회에 필요) 읽기만 필요하면 `nworks login --user --scope "task.read user.read"`로 충분합니다.
193
+
134
194
  ### MCP 서버
135
195
 
136
196
  ```bash
@@ -172,6 +232,10 @@ nworks mcp --list-tools # 등록된 tool 목록
172
232
  | `calendar.read` | 캘린더 일정 조회 | User OAuth | `calendar list` |
173
233
  | `file` | 드라이브 읽기/쓰기 | User OAuth | `drive list/upload/download` |
174
234
  | `file.read` | 드라이브 읽기 전용 | User OAuth | `drive list/download` |
235
+ | `mail` | 메일 읽기/쓰기 | User OAuth | `mail send/list/read` |
236
+ | `mail.read` | 메일 읽기 전용 | User OAuth | `mail list/read` |
237
+ | `task` | 할 일 읽기/쓰기 | User OAuth | `task list/create/update/delete` (+ `user.read` 필요) |
238
+ | `task.read` | 할 일 읽기 전용 | User OAuth | `task list` (+ `user.read` 필요) |
175
239
 
176
240
  > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
177
241
  > ```bash
@@ -225,7 +289,10 @@ NWORKS_VERBOSE=1 # optional, 디버그 로깅
225
289
  - ~~**v0.1** — 메시지, 조직 구성원, MCP 서버~~
226
290
  - ~~**v0.2** — 캘린더 일정 조회 + User OAuth~~
227
291
  - ~~**v0.3** — 드라이브 파일 조회/업로드/다운로드 (`nworks drive`)~~
228
- - **v0.4** — 게시판, 메일 (`nworks board`, `nworks mail`)
292
+ - ~~**v0.4** — 메일 (`nworks mail send/list/read`)~~
293
+ - ~~**v0.5** — 할 일 (`nworks task list/create/update/delete`)~~
294
+ - **v0.6** — 캘린더 쓰기 (`nworks calendar create/update/delete`)
295
+ - **v0.7** — 게시판 (`nworks board list/post/read`)
229
296
 
230
297
  ## License
231
298