nworks 0.4.0 → 0.5.0

package/README.md

@@ -26,7 +26,7 @@ nworks login \
   --bot-id <BOT_ID>
 
 # User OAuth 로그인 (캘린더, 드라이브 등 사용자 API용)
-nworks login --user --scope calendar.read,file,mail
+nworks login --user --scope "calendar.read,file,mail,task,user.read"
 
 # 인증 확인
 nworks whoami
@@ -51,6 +51,12 @@ nworks mail send --to "user@example.com" --subject "제목" --body "내용"
 
 # 받은편지함 조회
 nworks mail list
+
+# 할 일 목록
+nworks task list
+
+# 할 일 생성
+nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
 ```
 
 ## CLI Commands
@@ -158,6 +164,33 @@ nworks mail read --id <mailId>
 
 > **Note**: 메일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope mail`을 실행하세요. 읽기만 필요하면 `mail.read` scope로 충분합니다.
 
+### 할 일 (User OAuth 필요)
+
+```bash
+# 할 일 목록 (기본 카테고리)
+nworks task list
+
+# 미완료만 조회
+nworks task list --status TODO
+
+# 할 일 생성
+nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
+
+# 마감일 지정
+nworks task create --title "배포" --due 2026-03-20
+
+# 할 일 완료 처리
+nworks task update --id <taskId> --status done
+
+# 할 일 미완료로 되돌리기
+nworks task update --id <taskId> --status todo
+
+# 할 일 삭제
+nworks task delete --id <taskId>
+```
+
+> **Note**: 할 일 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope "task user.read"`를 실행하세요. (`user.read`는 사용자 ID 조회에 필요) 읽기만 필요하면 `nworks login --user --scope "task.read user.read"`로 충분합니다.
+
 ### MCP 서버
 
 ```bash
@@ -201,6 +234,8 @@ nworks mcp --list-tools # 등록된 tool 목록
 | `file.read` | 드라이브 읽기 전용 | User OAuth | `drive list/download` |
 | `mail` | 메일 읽기/쓰기 | User OAuth | `mail send/list/read` |
 | `mail.read` | 메일 읽기 전용 | User OAuth | `mail list/read` |
+| `task` | 할 일 읽기/쓰기 | User OAuth | `task list/create/update/delete` (+ `user.read` 필요) |
+| `task.read` | 할 일 읽기 전용 | User OAuth | `task list` (+ `user.read` 필요) |
 
 > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
 > ```bash
@@ -255,7 +290,7 @@ NWORKS_VERBOSE=1           # optional, 디버그 로깅
 - ~~**v0.2** — 캘린더 일정 조회 + User OAuth~~
 - ~~**v0.3** — 드라이브 파일 조회/업로드/다운로드 (`nworks drive`)~~
 - ~~**v0.4** — 메일 (`nworks mail send/list/read`)~~
-- **v0.5** — 할 일 (`nworks task list/create/update/delete`)
+- ~~**v0.5** — 할 일 (`nworks task list/create/update/delete`)~~
 - **v0.6** — 캘린더 쓰기 (`nworks calendar create/update/delete`)
 - **v0.7** — 게시판 (`nworks board list/post/read`)
 

package/dist/index.js

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { createRequire } from "module";
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/commands/login.ts
 import { Command } from "commander";
@@ -1276,9 +1276,280 @@ var readCommand = new Command8("read").description("Read a specific mail (requir
 });
 var mailCommand = new Command8("mail").description("Mail operations (requires User OAuth with mail scope)").addCommand(sendCommand2).addCommand(listCommand3).addCommand(readCommand);
 
-// src/commands/mcp-cmd.ts
+// src/commands/task.ts
 import { Command as Command9 } from "commander";
 
+// src/api/task.ts
+var BASE_URL5 = "https://www.worksapis.com/v1.0";
+async function authedFetch3(url2, init, profile) {
+  const token = await getValidUserToken(profile);
+  const headers = new Headers(init.headers);
+  headers.set("Authorization", `Bearer ${token}`);
+  return fetch(url2, { ...init, headers });
+}
+async function handleError3(res) {
+  if (res.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope task` again.");
+  }
+  let code = "UNKNOWN";
+  let description = `HTTP ${res.status}`;
+  try {
+    const body = await res.json();
+    code = body.code ?? code;
+    description = body.description ?? description;
+  } catch {
+  }
+  throw new ApiError(code, description, res.status);
+}
+async function resolveUserId(userId, profile) {
+  if (userId !== "me") return userId;
+  const url2 = `${BASE_URL5}/users/me`;
+  const res = await authedFetch3(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError3(res);
+  const data = await res.json();
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] Resolved "me" \u2192 ${data.userId}`);
+  }
+  return data.userId;
+}
+async function listTasks(categoryId = "default", userId = "me", count = 50, cursor, status = "ALL", profile = "default") {
+  const params = new URLSearchParams();
+  params.set("categoryId", categoryId);
+  params.set("count", String(count));
+  params.set("status", status);
+  if (cursor) params.set("cursor", cursor);
+  const url2 = `${BASE_URL5}/users/${userId}/tasks?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch3(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError3(res);
+  const data = await res.json();
+  return { tasks: data.tasks ?? [], responseMetaData: data.responseMetaData };
+}
+async function createTask(opts) {
+  const userId = opts.userId ?? "me";
+  const profile = opts.profile ?? "default";
+  const resolvedUserId = await resolveUserId(userId, profile);
+  const assignorId = opts.assignorId ?? resolvedUserId;
+  const assigneeIds = opts.assigneeIds ?? [resolvedUserId];
+  const body = {
+    assignorId,
+    assignees: assigneeIds.map((id) => ({ assigneeId: id, status: "TODO" })),
+    title: opts.title,
+    content: opts.content ?? "",
+    completionCondition: "ANY_ONE"
+  };
+  if (opts.dueDate) body.dueDate = opts.dueDate;
+  if (opts.categoryId) body.categoryId = opts.categoryId;
+  const url2 = `${BASE_URL5}/users/${userId}/tasks`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+    console.error(`[nworks] Body: ${JSON.stringify(body, null, 2)}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (res.status === 201) {
+    return await res.json();
+  }
+  if (!res.ok) return handleError3(res);
+  return await res.json();
+}
+async function updateTask(opts) {
+  const profile = opts.profile ?? "default";
+  const body = {};
+  if (opts.title !== void 0) body.title = opts.title;
+  if (opts.content !== void 0) body.content = opts.content;
+  if (opts.dueDate !== void 0) body.dueDate = opts.dueDate;
+  const url2 = `${BASE_URL5}/tasks/${opts.taskId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] PATCH ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (!res.ok) return handleError3(res);
+  return await res.json();
+}
+async function completeTask(taskId, profile = "default") {
+  const url2 = `${BASE_URL5}/tasks/${taskId}/complete`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    { method: "POST" },
+    profile
+  );
+  if (res.status === 204) return;
+  if (!res.ok) return handleError3(res);
+}
+async function incompleteTask(taskId, profile = "default") {
+  const url2 = `${BASE_URL5}/tasks/${taskId}/incomplete`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    { method: "POST" },
+    profile
+  );
+  if (res.status === 204) return;
+  if (!res.ok) return handleError3(res);
+}
+async function deleteTask(taskId, profile = "default") {
+  const url2 = `${BASE_URL5}/tasks/${taskId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] DELETE ${url2}`);
+  }
+  const res = await authedFetch3(
+    url2,
+    { method: "DELETE" },
+    profile
+  );
+  if (res.status === 204) return;
+  if (!res.ok) return handleError3(res);
+}
+
+// src/commands/task.ts
+var listCommand4 = new Command9("list").description("List tasks (requires User OAuth with task or task.read scope)").option("--category <categoryId>", "Category ID (default: default)", "default").option("--status <status>", "Filter: TODO or ALL (default: ALL)", "ALL").option("--count <n>", "Items per page (default: 50)", "50").option("--cursor <cursor>", "Pagination cursor").option("--user <userId>", "Target user ID (default: me)").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listTasks(
+      opts.category,
+      opts.user ?? "me",
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.status,
+      opts.profile
+    );
+    const tasks = result.tasks.map((t) => ({
+      taskId: t.taskId,
+      title: t.title,
+      status: t.status,
+      dueDate: t.dueDate ?? "",
+      assignor: t.assignorName ?? t.assignorId,
+      created: t.createdTime
+    }));
+    output(
+      {
+        tasks,
+        count: tasks.length,
+        nextCursor: result.responseMetaData?.nextCursor ?? null
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var createCommand = new Command9("create").description("Create a task (requires User OAuth with task scope)").requiredOption("--title <title>", "Task title").option("--body <content>", "Task content/description").option("--due <date>", "Due date (YYYY-MM-DD)").option("--category <categoryId>", "Category ID").option("--assignee <userIds>", "Assignee user IDs (comma-separated)").option("--user <userId>", "Creator user ID (default: me)").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const assigneeIds = opts.assignee ? opts.assignee.split(",").map((s) => s.trim()) : void 0;
+    const result = await createTask({
+      title: opts.title,
+      content: opts.body,
+      dueDate: opts.due,
+      categoryId: opts.category,
+      assigneeIds,
+      userId: opts.user ?? "me",
+      profile: opts.profile
+    });
+    output(
+      {
+        success: true,
+        taskId: result.taskId,
+        title: result.title,
+        status: result.status,
+        dueDate: result.dueDate
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var updateCommand = new Command9("update").description("Update a task (requires User OAuth with task scope)").requiredOption("--id <taskId>", "Task ID").option("--title <title>", "New title").option("--body <content>", "New content").option("--due <date>", "New due date (YYYY-MM-DD)").option("--status <status>", "Set status: done or todo").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const profile = opts.profile;
+    const taskId = opts.id;
+    const status = opts.status;
+    if (status) {
+      if (status.toLowerCase() === "done") {
+        await completeTask(taskId, profile);
+      } else if (status.toLowerCase() === "todo") {
+        await incompleteTask(taskId, profile);
+      } else {
+        throw new Error("Invalid status. Use 'done' or 'todo'.");
+      }
+    }
+    const hasFieldUpdate = opts.title || opts.body || opts.due;
+    if (hasFieldUpdate) {
+      const result = await updateTask({
+        taskId,
+        title: opts.title,
+        content: opts.body,
+        dueDate: opts.due,
+        profile
+      });
+      output(
+        {
+          success: true,
+          taskId: result.taskId,
+          title: result.title,
+          status: result.status,
+          dueDate: result.dueDate
+        },
+        opts
+      );
+    } else if (status) {
+      output(
+        { success: true, taskId, status: status.toLowerCase() === "done" ? "DONE" : "TODO" },
+        opts
+      );
+    } else {
+      throw new Error("Specify at least one of: --title, --body, --due, --status");
+    }
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var deleteCommand = new Command9("delete").description("Delete a task (requires User OAuth with task scope)").requiredOption("--id <taskId>", "Task ID").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    await deleteTask(
+      opts.id,
+      opts.profile
+    );
+    output({ success: true, taskId: opts.id, message: "Task deleted" }, opts);
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var taskCommand = new Command9("task").description("Task operations (requires User OAuth with task scope)").addCommand(listCommand4).addCommand(createCommand).addCommand(updateCommand).addCommand(deleteCommand);
+
+// src/commands/mcp-cmd.ts
+import { Command as Command10 } from "commander";
+
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -15413,6 +15684,142 @@ function registerTools(server) {
       }
     }
   );
+  server.tool(
+    "nworks_task_list",
+    "\uD560 \uC77C \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth task \uB610\uB294 task.read scope \uD544\uC694)",
+    {
+      categoryId: external_exports.string().optional().describe("\uCE74\uD14C\uACE0\uB9AC ID (\uAE30\uBCF8: default)"),
+      status: external_exports.enum(["TODO", "ALL"]).optional().describe("\uD544\uD130: TODO \uB610\uB294 ALL (\uAE30\uBCF8: ALL)"),
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 50, \uCD5C\uB300: 100)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C"),
+      userId: external_exports.string().optional().describe("\uB300\uC0C1 \uC0AC\uC6A9\uC790 ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ categoryId, status, count, cursor, userId }) => {
+      try {
+        const result = await listTasks(
+          categoryId ?? "default",
+          userId ?? "me",
+          count ?? 50,
+          cursor,
+          status ?? "ALL"
+        );
+        const tasks = result.tasks.map((t) => ({
+          taskId: t.taskId,
+          title: t.title,
+          status: t.status,
+          dueDate: t.dueDate,
+          assignor: t.assignorName ?? t.assignorId,
+          created: t.createdTime
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ tasks, count: tasks.length, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_create",
+    "\uD560 \uC77C\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4 (User OAuth task scope \uD544\uC694). \uAE30\uBCF8\uC801\uC73C\uB85C \uC790\uAE30 \uC790\uC2E0\uC5D0\uAC8C \uD560\uB2F9\uB429\uB2C8\uB2E4.",
+    {
+      title: external_exports.string().describe("\uD560 \uC77C \uC81C\uBAA9"),
+      content: external_exports.string().optional().describe("\uD560 \uC77C \uB0B4\uC6A9"),
+      dueDate: external_exports.string().optional().describe("\uB9C8\uAC10\uC77C (YYYY-MM-DD)"),
+      categoryId: external_exports.string().optional().describe("\uCE74\uD14C\uACE0\uB9AC ID"),
+      assigneeIds: external_exports.array(external_exports.string()).optional().describe("\uB2F4\uB2F9\uC790 user ID \uBAA9\uB85D (\uBBF8\uC9C0\uC815 \uC2DC \uC790\uAE30 \uC790\uC2E0)"),
+      userId: external_exports.string().optional().describe("\uC0DD\uC131\uC790 user ID (\uBBF8\uC9C0\uC815 \uC2DC me)")
+    },
+    async ({ title, content, dueDate, categoryId, assigneeIds, userId }) => {
+      try {
+        const result = await createTask({
+          title,
+          content,
+          dueDate,
+          categoryId,
+          assigneeIds,
+          userId: userId ?? "me"
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, taskId: result.taskId, title: result.title, status: result.status, dueDate: result.dueDate }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_update",
+    "\uD560 \uC77C\uC744 \uC218\uC815\uD569\uB2C8\uB2E4 (User OAuth task scope \uD544\uC694). \uC0C1\uD0DC \uBCC0\uACBD(done/todo)\uACFC \uD544\uB4DC \uC218\uC815\uC744 \uBAA8\uB450 \uC9C0\uC6D0\uD569\uB2C8\uB2E4.",
+    {
+      taskId: external_exports.string().describe("\uD560 \uC77C ID"),
+      status: external_exports.enum(["done", "todo"]).optional().describe("\uC0C1\uD0DC \uBCC0\uACBD: done \uB610\uB294 todo"),
+      title: external_exports.string().optional().describe("\uC0C8 \uC81C\uBAA9"),
+      content: external_exports.string().optional().describe("\uC0C8 \uB0B4\uC6A9"),
+      dueDate: external_exports.string().optional().describe("\uC0C8 \uB9C8\uAC10\uC77C (YYYY-MM-DD)")
+    },
+    async ({ taskId, status, title, content, dueDate }) => {
+      try {
+        if (status) {
+          if (status === "done") {
+            await completeTask(taskId);
+          } else {
+            await incompleteTask(taskId);
+          }
+        }
+        if (title !== void 0 || content !== void 0 || dueDate !== void 0) {
+          const result = await updateTask({ taskId, title, content, dueDate });
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, taskId: result.taskId, title: result.title, status: result.status, dueDate: result.dueDate }) }]
+          };
+        }
+        if (status) {
+          return {
+            content: [{ type: "text", text: JSON.stringify({ success: true, taskId, status: status === "done" ? "DONE" : "TODO" }) }]
+          };
+        }
+        return {
+          content: [{ type: "text", text: "Error: status, title, content, dueDate \uC911 \uD558\uB098 \uC774\uC0C1\uC744 \uC9C0\uC815\uD558\uC138\uC694." }],
+          isError: true
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_task_delete",
+    "\uD560 \uC77C\uC744 \uC0AD\uC81C\uD569\uB2C8\uB2E4 (User OAuth task scope \uD544\uC694)",
+    {
+      taskId: external_exports.string().describe("\uC0AD\uC81C\uD560 \uD560 \uC77C ID")
+    },
+    async ({ taskId }) => {
+      try {
+        await deleteTask(taskId);
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, taskId, message: "Task deleted" }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
   server.tool(
     "nworks_whoami",
     "\uD604\uC7AC \uC778\uC99D\uB41C NAVER WORKS \uACC4\uC815 \uC815\uBCF4\uB97C \uD655\uC778\uD569\uB2C8\uB2E4",
@@ -15454,7 +15861,7 @@ async function startMcpServer() {
 }
 
 // src/commands/mcp-cmd.ts
-var mcpCommand = new Command9("mcp").description("Start MCP server (stdio transport)").option("--list-tools", "List available MCP tools").action(async (opts) => {
+var mcpCommand = new Command10("mcp").description("Start MCP server (stdio transport)").option("--list-tools", "List available MCP tools").action(async (opts) => {
   if (opts.listTools) {
     console.log("nworks_message_send     \u2014 Send message to user or channel");
     console.log("nworks_message_members  \u2014 List channel members");
@@ -15469,7 +15876,7 @@ var mcpCommand = new Command9("mcp").description("Start MCP server (stdio transp
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version: version2 } = require2("../package.json");
-var program = new Command10().name("nworks").description("NAVER WORKS CLI \u2014 built for humans and AI agents").version(version2).option("--json", "Always output JSON").option("-v, --verbose", "Debug logging").option("--dry-run", "Print request without calling API").option("-p, --profile <name>", "Profile name", "default");
+var program = new Command11().name("nworks").description("NAVER WORKS CLI \u2014 built for humans and AI agents").version(version2).option("--json", "Always output JSON").option("-v, --verbose", "Debug logging").option("--dry-run", "Print request without calling API").option("-p, --profile <name>", "Profile name", "default");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(whoamiCommand);
@@ -15478,6 +15885,7 @@ program.addCommand(directoryCommand);
 program.addCommand(calendarCommand);
 program.addCommand(driveCommand);
 program.addCommand(mailCommand);
+program.addCommand(taskCommand);
 program.addCommand(mcpCommand);
 program.parse();
 //# sourceMappingURL=index.js.map