nworks 0.4.0 → 0.6.1

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.
Files changed (6) hide show
  1. package/README.md +69 -7
  2. package/dist/index.js +774 -51
  3. package/dist/index.js.map +1 -1
  4. package/dist/mcp.js +562 -45
  5. package/dist/mcp.js.map +1 -1
  6. package/package.json +1 -1
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,mail
29
+ nworks login --user --scope "calendar,calendar.read,file,mail,task,user.read"
30
30
 
31
31
  # 인증 확인
32
32
  nworks whoami
@@ -40,6 +40,9 @@ nworks directory members
40
40
  # 오늘 일정 조회
41
41
  nworks calendar list
42
42
 
43
+ # 일정 생성
44
+ nworks calendar create --title "회의" --start "2026-03-14T14:00+09:00" --end "2026-03-14T15:00+09:00"
45
+
43
46
  # 드라이브 파일 목록
44
47
  nworks drive list
45
48
 
@@ -51,6 +54,12 @@ nworks mail send --to "user@example.com" --subject "제목" --body "내용"
51
54
 
52
55
  # 받은편지함 조회
53
56
  nworks mail list
57
+
58
+ # 할 일 목록
59
+ nworks task list
60
+
61
+ # 할 일 생성
62
+ nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
54
63
  ```
55
64
 
56
65
  ## CLI Commands
@@ -98,14 +107,37 @@ nworks directory members # 조직 구성원 목록
98
107
  # 오늘 일정 조회
99
108
  nworks calendar list
100
109
 
101
- # 기간 지정
102
- nworks calendar list --from 2026-03-01T00:00:00+09:00 --until 2026-03-31T23:59:59+09:00
110
+ # 기간 지정 (타임존 필수)
111
+ nworks calendar list --from "2026-03-14T00:00:00+09:00" --until "2026-03-14T23:59:59+09:00"
103
112
 
104
113
  # 특정 사용자의 일정
105
114
  nworks calendar list --user <userId>
115
+
116
+ # 일정 생성
117
+ nworks calendar create --title "회의" --start "2026-03-14T14:00:00+09:00" --end "2026-03-14T15:00:00+09:00"
118
+
119
+ # 초 생략 가능
120
+ nworks calendar create --title "회의" --start "2026-03-14T14:00+09:00" --end "2026-03-14T15:00+09:00"
121
+
122
+ # 장소/설명 포함
123
+ nworks calendar create --title "점심 미팅" --start "2026-03-14T12:00+09:00" --end "2026-03-14T13:00+09:00" \
124
+ --location "강남 식당" --description "분기 리뷰"
125
+
126
+ # 참석자 지정 + 알림
127
+ nworks calendar create --title "팀 회의" --start "2026-03-14T10:00+09:00" --end "2026-03-14T11:00+09:00" \
128
+ --attendees "user1@example.com,user2@example.com" --notify
129
+
130
+ # 일정 수정
131
+ nworks calendar update --id <eventId> --title "변경된 제목"
132
+
133
+ # 시간 변경
134
+ nworks calendar update --id <eventId> --start "2026-03-14T15:00+09:00" --end "2026-03-14T16:00+09:00"
135
+
136
+ # 일정 삭제
137
+ nworks calendar delete --id <eventId>
106
138
  ```
107
139
 
108
- > **Note**: 캘린더 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope calendar.read`를 실행하세요.
140
+ > **Note**: 캘린더 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope "calendar calendar.read"`를 실행하세요.
109
141
 
110
142
  ### 드라이브 (User OAuth 필요)
111
143
 
@@ -158,6 +190,33 @@ nworks mail read --id <mailId>
158
190
 
159
191
  > **Note**: 메일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope mail`을 실행하세요. 읽기만 필요하면 `mail.read` scope로 충분합니다.
160
192
 
193
+ ### 할 일 (User OAuth 필요)
194
+
195
+ ```bash
196
+ # 할 일 목록 (기본 카테고리)
197
+ nworks task list
198
+
199
+ # 미완료만 조회
200
+ nworks task list --status TODO
201
+
202
+ # 할 일 생성
203
+ nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
204
+
205
+ # 마감일 지정
206
+ nworks task create --title "배포" --due 2026-03-20
207
+
208
+ # 할 일 완료 처리
209
+ nworks task update --id <taskId> --status done
210
+
211
+ # 할 일 미완료로 되돌리기
212
+ nworks task update --id <taskId> --status todo
213
+
214
+ # 할 일 삭제
215
+ nworks task delete --id <taskId>
216
+ ```
217
+
218
+ > **Note**: 할 일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope "task user.read"`를 실행하세요. (`user.read`는 사용자 ID 조회에 필요) 읽기만 필요하면 `nworks login --user --scope "task.read user.read"`로 충분합니다.
219
+
161
220
  ### MCP 서버
162
221
 
163
222
  ```bash
@@ -196,11 +255,14 @@ nworks mcp --list-tools # 등록된 tool 목록
196
255
  | `bot` | Bot 메시지 전송 | Service Account | `message send` |
197
256
  | `bot.read` | Bot 채널/구성원 조회 | Service Account | `message members` |
198
257
  | `user.read` | 조직 구성원 조회 | Service Account | `directory members` |
199
- | `calendar.read` | 캘린더 일정 조회 | User OAuth | `calendar list` |
258
+ | `calendar` | 캘린더 쓰기 | User OAuth | `calendar create/update/delete` (+ `calendar.read` 필요) |
259
+ | `calendar.read` | 캘린더 읽기 | User OAuth | `calendar list` |
200
260
  | `file` | 드라이브 읽기/쓰기 | User OAuth | `drive list/upload/download` |
201
261
  | `file.read` | 드라이브 읽기 전용 | User OAuth | `drive list/download` |
202
262
  | `mail` | 메일 읽기/쓰기 | User OAuth | `mail send/list/read` |
203
263
  | `mail.read` | 메일 읽기 전용 | User OAuth | `mail list/read` |
264
+ | `task` | 할 일 읽기/쓰기 | User OAuth | `task list/create/update/delete` (+ `user.read` 필요) |
265
+ | `task.read` | 할 일 읽기 전용 | User OAuth | `task list` (+ `user.read` 필요) |
204
266
 
205
267
  > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
206
268
  > ```bash
@@ -255,8 +317,8 @@ NWORKS_VERBOSE=1 # optional, 디버그 로깅
255
317
  - ~~**v0.2** — 캘린더 일정 조회 + User OAuth~~
256
318
  - ~~**v0.3** — 드라이브 파일 조회/업로드/다운로드 (`nworks drive`)~~
257
319
  - ~~**v0.4** — 메일 (`nworks mail send/list/read`)~~
258
- - **v0.5** — 할 일 (`nworks task list/create/update/delete`)
259
- - **v0.6** — 캘린더 쓰기 (`nworks calendar create/update/delete`)
320
+ - ~~**v0.5** — 할 일 (`nworks task list/create/update/delete`)~~
321
+ - ~~**v0.6** — 캘린더 쓰기 (`nworks calendar create/update/delete`)~~
260
322
  - **v0.7** — 게시판 (`nworks board list/post/read`)
261
323
 
262
324
  ## License