nworks 0.6.2 → 0.7.0

package/README.md

@@ -26,7 +26,7 @@ nworks login \
   --bot-id <BOT_ID>
 
 # User OAuth 로그인 (캘린더, 드라이브 등 사용자 API용)
-nworks login --user --scope "calendar,calendar.read,file,mail,task,user.read"
+nworks login --user --scope "calendar,calendar.read,file,mail,task,board,user.read"
 
 # 인증 확인
 nworks whoami
@@ -60,6 +60,12 @@ nworks task list
 
 # 할 일 생성
 nworks task create --title "코드 리뷰" --body "PR #382 리뷰"
+
+# 게시판 목록
+nworks board list
+
+# 게시판 글 작성
+nworks board create --board <boardId> --title "공지사항" --body "내용"
 ```
 
 ## CLI Commands
@@ -217,6 +223,27 @@ 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"`로 충분합니다.
 
+### 게시판 (User OAuth 필요)
+
+```bash
+# 게시판 목록
+nworks board list
+
+# 게시판 글 목록
+nworks board posts --board <boardId>
+
+# 글 상세 조회
+nworks board read --board <boardId> --post <postId>
+
+# 글 작성
+nworks board create --board <boardId> --title "공지사항" --body "내용"
+
+# 알림 발송 + 댓글 비활성화
+nworks board create --board <boardId> --title "공지" --body "내용" --notify --no-comment
+```
+
+> **Note**: 게시판 API는 User OAuth가 필요합니다. 먼저 `nworks login --user --scope board`를 실행하세요. 읽기만 필요하면 `board.read` scope로 충분합니다.
+
 ### MCP 서버
 
 ```bash
@@ -263,6 +290,8 @@ nworks mcp --list-tools # 등록된 tool 목록
 | `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` 필요) |
+| `board` | 게시판 읽기/쓰기 | User OAuth | `board list/posts/read/create` |
+| `board.read` | 게시판 읽기 전용 | User OAuth | `board list/posts/read` |
 
 > **Tip**: scope를 변경한 후에는 토큰을 재발급해야 합니다.
 > ```bash
@@ -319,7 +348,7 @@ NWORKS_VERBOSE=1           # optional, 디버그 로깅
 - ~~**v0.4** — 메일 (`nworks mail send/list/read`)~~
 - ~~**v0.5** — 할 일 (`nworks task list/create/update/delete`)~~
 - ~~**v0.6** — 캘린더 쓰기 (`nworks calendar create/update/delete`)~~
-- **v0.7** — 게시판 (`nworks board list/post/read`)
+- ~~**v0.7** — 게시판 (`nworks board list/posts/read/create`)~~
 
 ## License
 

package/dist/index.js

@@ -7,7 +7,7 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { createRequire } from "module";
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 
 // src/commands/login.ts
 import { Command } from "commander";
@@ -1756,9 +1756,223 @@ var deleteCommand2 = new Command9("delete").description("Delete a task (requires
 });
 var taskCommand = new Command9("task").description("Task operations (requires User OAuth with task scope)").addCommand(listCommand4).addCommand(createCommand2).addCommand(updateCommand2).addCommand(deleteCommand2);
 
-// src/commands/mcp-cmd.ts
+// src/commands/board.ts
 import { Command as Command10 } from "commander";
 
+// src/api/board.ts
+var BASE_URL6 = "https://www.worksapis.com/v1.0";
+async function authedFetch5(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 handleError5(res) {
+  if (res.status === 401) {
+    throw new AuthError("User token expired. Run `nworks login --user --scope board` 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);
+}
+function safeParseJson(text) {
+  const safe = text.replace(
+    /"((?:board|post|domain|user)Id)"\s*:\s*(\d{16,})/g,
+    '"$1":"$2"'
+  );
+  return JSON.parse(safe);
+}
+async function listBoards(count = 20, cursor, profile = "default") {
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  const url2 = `${BASE_URL6}/boards?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch5(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError5(res);
+  const text = await res.text();
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] Response: ${text}`);
+  }
+  const data = safeParseJson(text);
+  return { boards: data.boards ?? [], responseMetaData: data.responseMetaData };
+}
+async function listPosts(boardId, count = 20, cursor, profile = "default") {
+  const params = new URLSearchParams();
+  params.set("count", String(count));
+  if (cursor) params.set("cursor", cursor);
+  const url2 = `${BASE_URL6}/boards/${boardId}/posts?${params.toString()}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch5(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError5(res);
+  const text = await res.text();
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] Response: ${text}`);
+  }
+  const data = safeParseJson(text);
+  return { posts: data.posts ?? [], responseMetaData: data.responseMetaData };
+}
+async function readPost(boardId, postId, profile = "default") {
+  const url2 = `${BASE_URL6}/boards/${boardId}/posts/${postId}`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] GET ${url2}`);
+  }
+  const res = await authedFetch5(url2, { method: "GET" }, profile);
+  if (!res.ok) return handleError5(res);
+  const text = await res.text();
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] Response: ${text}`);
+  }
+  return safeParseJson(text);
+}
+async function createPost(opts) {
+  const profile = opts.profile ?? "default";
+  const body = {
+    title: opts.title,
+    body: opts.body ?? ""
+  };
+  if (opts.enableComment !== void 0) body.enableComment = opts.enableComment;
+  if (opts.sendNotifications !== void 0) body.sendNotifications = opts.sendNotifications;
+  const url2 = `${BASE_URL6}/boards/${opts.boardId}/posts`;
+  if (process.env["NWORKS_VERBOSE"] === "1") {
+    console.error(`[nworks] POST ${url2}`);
+    console.error(`[nworks] Body: ${JSON.stringify(body, null, 2)}`);
+  }
+  const res = await authedFetch5(
+    url2,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    },
+    profile
+  );
+  if (res.status === 201 || res.ok) {
+    const text = await res.text();
+    if (process.env["NWORKS_VERBOSE"] === "1") {
+      console.error(`[nworks] Response: ${text}`);
+    }
+    return safeParseJson(text);
+  }
+  return handleError5(res);
+}
+
+// src/commands/board.ts
+var listCommand5 = new Command10("list").description("List boards (requires User OAuth with board or board.read scope)").option("--count <n>", "Items per page (default: 20)", "20").option("--cursor <cursor>", "Pagination cursor").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listBoards(
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.profile
+    );
+    const boards = result.boards.map((b) => ({
+      boardId: b.boardId,
+      boardName: b.boardName,
+      description: b.description ?? ""
+    }));
+    output(
+      { boards, count: boards.length, nextCursor: result.responseMetaData?.nextCursor ?? null },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var postsCommand = new Command10("posts").description("List posts in a board (requires User OAuth with board or board.read scope)").requiredOption("--board <boardId>", "Board ID").option("--count <n>", "Items per page (default: 20)", "20").option("--cursor <cursor>", "Pagination cursor").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const result = await listPosts(
+      opts.board,
+      parseInt(opts.count, 10),
+      opts.cursor,
+      opts.profile
+    );
+    const posts = result.posts.map((p) => ({
+      postId: p.postId,
+      title: p.title,
+      userName: p.userName ?? "",
+      readCount: p.readCount ?? 0,
+      commentCount: p.commentCount ?? 0,
+      createdTime: p.createdTime ?? ""
+    }));
+    output(
+      { posts, count: posts.length, nextCursor: result.responseMetaData?.nextCursor ?? null },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var readCommand2 = new Command10("read").description("Read a post detail (requires User OAuth with board or board.read scope)").requiredOption("--board <boardId>", "Board ID").requiredOption("--post <postId>", "Post ID").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const post = await readPost(
+      opts.board,
+      opts.post,
+      opts.profile
+    );
+    output(
+      {
+        postId: post.postId,
+        boardId: post.boardId,
+        title: post.title,
+        body: post.body ?? "",
+        userName: post.userName ?? "",
+        readCount: post.readCount ?? 0,
+        commentCount: post.commentCount ?? 0,
+        createdTime: post.createdTime ?? "",
+        updatedTime: post.updatedTime ?? ""
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var createCommand3 = new Command10("create").description("Create a post in a board (requires User OAuth with board scope)").requiredOption("--board <boardId>", "Board ID").requiredOption("--title <title>", "Post title").option("--body <text>", "Post body").option("--no-comment", "Disable comments").option("--notify", "Send notification").option("--profile <name>", "Profile name", "default").option("--json", "JSON output").action(async (opts) => {
+  try {
+    const post = await createPost({
+      boardId: opts.board,
+      title: opts.title,
+      body: opts.body,
+      enableComment: opts.comment,
+      sendNotifications: opts.notify ?? false,
+      profile: opts.profile
+    });
+    output(
+      {
+        success: true,
+        postId: post.postId,
+        boardId: post.boardId,
+        title: post.title
+      },
+      opts
+    );
+  } catch (err) {
+    const error48 = err;
+    errorOutput({ code: error48.code, message: error48.message }, opts);
+    process.exitCode = 1;
+  }
+});
+var boardCommand = new Command10("board").description("Board operations (requires User OAuth)").addCommand(listCommand5).addCommand(postsCommand).addCommand(readCommand2).addCommand(createCommand3);
+
+// src/commands/mcp-cmd.ts
+import { Command as Command11 } from "commander";
+
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -16136,6 +16350,127 @@ function registerTools(server) {
       }
     }
   );
+  server.tool(
+    "nworks_board_list",
+    "\uAC8C\uC2DC\uD310 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth board \uB610\uB294 board.read scope \uD544\uC694)",
+    {
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 20)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C")
+    },
+    async ({ count, cursor }) => {
+      try {
+        const result = await listBoards(count ?? 20, cursor);
+        const boards = result.boards.map((b) => ({
+          boardId: b.boardId,
+          boardName: b.boardName,
+          description: b.description ?? ""
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ boards, count: boards.length, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_board_posts",
+    "\uAC8C\uC2DC\uD310\uC758 \uAE00 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth board \uB610\uB294 board.read scope \uD544\uC694)",
+    {
+      boardId: external_exports.string().describe("\uAC8C\uC2DC\uD310 ID"),
+      count: external_exports.number().optional().describe("\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218 (\uAE30\uBCF8: 20, \uCD5C\uB300: 40)"),
+      cursor: external_exports.string().optional().describe("\uD398\uC774\uC9C0\uB124\uC774\uC158 \uCEE4\uC11C")
+    },
+    async ({ boardId, count, cursor }) => {
+      try {
+        const result = await listPosts(boardId, count ?? 20, cursor);
+        const posts = result.posts.map((p) => ({
+          postId: p.postId,
+          title: p.title,
+          userName: p.userName ?? "",
+          readCount: p.readCount ?? 0,
+          commentCount: p.commentCount ?? 0,
+          createdTime: p.createdTime ?? ""
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify({ posts, count: posts.length, nextCursor: result.responseMetaData?.nextCursor ?? null }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_board_read",
+    "\uAC8C\uC2DC\uD310 \uAE00\uC758 \uC0C1\uC138 \uB0B4\uC6A9\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (User OAuth board \uB610\uB294 board.read scope \uD544\uC694)",
+    {
+      boardId: external_exports.string().describe("\uAC8C\uC2DC\uD310 ID"),
+      postId: external_exports.string().describe("\uAE00 ID")
+    },
+    async ({ boardId, postId }) => {
+      try {
+        const post = await readPost(boardId, postId);
+        return {
+          content: [{ type: "text", text: JSON.stringify({
+            postId: post.postId,
+            boardId: post.boardId,
+            title: post.title,
+            body: post.body ?? "",
+            userName: post.userName ?? "",
+            readCount: post.readCount ?? 0,
+            commentCount: post.commentCount ?? 0,
+            createdTime: post.createdTime ?? "",
+            updatedTime: post.updatedTime ?? ""
+          }) }]
+        };
+      } catch (err) {
+        const error48 = err;
+        return {
+          content: [{ type: "text", text: `Error: ${error48.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "nworks_board_create",
+    "\uAC8C\uC2DC\uD310\uC5D0 \uAE00\uC744 \uC791\uC131\uD569\uB2C8\uB2E4 (User OAuth board scope \uD544\uC694)",
+    {
+      boardId: external_exports.string().describe("\uAC8C\uC2DC\uD310 ID"),
+      title: external_exports.string().describe("\uAE00 \uC81C\uBAA9"),
+      body: external_exports.string().optional().describe("\uAE00 \uBCF8\uBB38"),
+      enableComment: external_exports.boolean().optional().describe("\uB313\uAE00 \uD5C8\uC6A9 (\uAE30\uBCF8: true)"),
+      sendNotifications: external_exports.boolean().optional().describe("\uC54C\uB9BC \uBC1C\uC1A1 (\uAE30\uBCF8: false)")
+    },
+    async ({ boardId, title, body, enableComment, sendNotifications }) => {
+      try {
+        const post = await createPost({
+          boardId,
+          title,
+          body,
+          enableComment,
+          sendNotifications
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ success: true, postId: post.postId, boardId: post.boardId, title: post.title }) }]
+        };
+      } 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",
@@ -16177,7 +16512,7 @@ async function startMcpServer() {
 }
 
 // src/commands/mcp-cmd.ts
-var mcpCommand = new Command10("mcp").description("Start MCP server (stdio transport)").option("--list-tools", "List available MCP tools").action(async (opts) => {
+var mcpCommand = new Command11("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");
@@ -16192,7 +16527,7 @@ var mcpCommand = new Command10("mcp").description("Start MCP server (stdio trans
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version: version2 } = require2("../package.json");
-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");
+var program = new Command12().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);
@@ -16202,6 +16537,7 @@ program.addCommand(calendarCommand);
 program.addCommand(driveCommand);
 program.addCommand(mailCommand);
 program.addCommand(taskCommand);
+program.addCommand(boardCommand);
 program.addCommand(mcpCommand);
 program.parse();
 //# sourceMappingURL=index.js.map