rootr-cli 0.34.1 → 0.35.0

package/README.ko.md

@@ -482,7 +482,7 @@ rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
 | 도구 | 설명 |
 |---|---|
 | `rootr_create_issue_tracker` | 이슈 트래커 생성 |
-| `rootr_list_issues` | 이슈 목록(state/label/type/assignee/검색어 필터) |
+| `rootr_list_issues` | 이슈 목록(state/label/type/assignee/검색어 필터). 나눠 받기: `limit`(1~200)·`cursor`(직전 `nextCursor`) → `nextCursor`·`total` |
 | `rootr_create_issue` | 이슈 생성(labels/type/parentIssueId 지원) |
 | `rootr_get_issue` | 이슈 상세 조회 |
 | `rootr_update_issue` | 이슈 갱신(닫기: state=CLOSED + stateReason) |
@@ -490,12 +490,14 @@ rootr memory forget <id>                         # 폐기(--hard면 행 삭제)
 | `rootr_update_issue_tracker` | 트래커 설정 — **외부 참여**(`read` 보기만 · `login` 로그인한 사람만 작성 · `anyone` 누구나 작성), 라벨·유형 |
 | `rootr_submit_public_issue` | **웹게시한** 트래커에 밖에서 이슈 올리기(공개 주소로, `asGuest`+`guestName` 이면 손님으로, 페이지 블록은 `blockId`, `files:[{filename, contentBase64}]` 첨부) |
 | `rootr_comment_public_issue` | 웹게시한 트래커의 이슈에 댓글(`files` 첨부, `read:true` 면 공개 댓글 읽기) |
-| `rootr_search_public_issues` | 웹게시한 트래커를 밖에서 찾기 — `q`(제목·본문·#번호·쓴 사람), `labels`(모두 가진 것), `state`, `sort`(newest·oldest·comments) |
+| `rootr_search_public_issues` | 웹게시한 트래커를 밖에서 찾기 — `q`(제목·본문·#번호·쓴 사람), `labels`(모두 가진 것), `state`, `sort`(newest·oldest·comments), `limit`·`cursor` 로 나눠 받기 |
 
 CLI: `rootr issue tracker <트래커> --participation anyone` · `rootr issue list|create|comment …` ·
 `rootr issue list <공개 주소> --q "결제" --label 버그` · `rootr issue submit <공개 주소> --title "…" --name <이름> --file 화면.png --file 로그.txt` ·
 `rootr issue reply <공개 주소> <#번호> "<댓글>" [--file <경로>]`.
-첨부는 그림(png·jpg·gif·webp)·pdf·txt·csv·log·docx·xlsx·pptx·zip, 한 파일 10MB·글 하나에 10개까지입니다(확장자와 파일 첫 바이트가 맞아야 함).
+목록은 **나눠 받습니다**(CLI 0.35+): 깃발이 없으면 예전처럼 최신 500건, `--limit 1~200` 은 한 페이지(맨 아래에 다음 `--cursor` 를 알려 줌),
+`--all` 은 끝까지 이어 받습니다 — 예: `rootr issue list /지원/피드백 --state ALL --all --json`.
+첨부는 그림(png·jpg·gif·webp)·pdf·txt·csv·log·docx·xlsx·pptx·zip, 한 파일 75MB(손님 25MB)·글 하나에 10개까지입니다(확장자와 파일 첫 바이트가 맞아야 함).
 외부 참여는 **트래커 설정**이라 페이지(PAGE)에 `issues` 블록으로 끼운 트래커도 같은 규칙을 따릅니다.
 
 #### 웹훅 (webhooks:manage 스코프)

package/README.md

@@ -314,9 +314,17 @@ rootr issue submit https://rootr.io/ko/p/AbCd123 --title "Button does nothing" -
 rootr issue submit https://rootr.io/ko/p/AbCd123 --title "Crash" --file shot.png --file app.log --name "Kim"   # with files
 rootr issue reply https://rootr.io/ko/p/AbCd123 12 "Same here" --name "Lee"
 rootr issue list https://rootr.io/ko/p/AbCd123 --q "payment" --label bug --sort comments   # search a published tracker
+rootr issue list /support/feedback --state ALL --limit 100            # one page; the last line prints the next --cursor
+rootr issue list /support/feedback --state ALL --limit 100 --cursor <next cursor>
+rootr issue list /support/feedback --state ALL --all --json           # every issue, page by page (200 at a time)
 ```
 
-Outside attachments: images (png·jpg·gif·webp), pdf, txt·csv·log, docx·xlsx·pptx, zip — 10MB per file, 10 per
+Issue lists are **paged** (CLI 0.35+): without flags you get the newest 500 as before; `--limit 1..200` gives
+one page and prints `--cursor <…>` for the next, `--all` follows the cursors to the end. MCP
+`rootr_list_issues` / `rootr_search_public_issues` take `limit` and `cursor` and return `nextCursor` (null on the
+last page) and `total`.
+
+Outside attachments: images (png·jpg·gif·webp), pdf, txt·csv·log, docx·xlsx·pptx, zip — 75MB per file signed in (25MB as a guest), 10 per
 issue/comment; the extension and the file's first bytes must agree. MCP: `rootr_submit_public_issue` /
 `rootr_comment_public_issue` take `files: [{ filename, contentBase64 }]` (contents, never a path), and
 `rootr_search_public_issues` searches a published tracker the way a visitor does.

package/bin/rootr.js

@@ -18,6 +18,7 @@ import {
 import { setGlobalDocMailSink } from '../lib/context.js';
 import { resolveTarget, requireResolved, resolveMoveDestination } from '../lib/resolve.js';
 import { t as tr, lang } from '../lib/i18n.js';
+import { issuePageArgs, collectIssuePages } from '../lib/issue-paging.js';
 import { domainPaymentHelp, slotLine } from '../lib/domain-billing.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -89,6 +90,7 @@ const USAGE_KO = `Rootr CLI v${pkg.version}
   rootr issue tracker <트래커> [--participation read|login|anyone] [--json]  트래커 설정 보기·외부 참여 바꾸기(MANAGE)
   rootr issue list <트래커|공개 주소> [--state OPEN|CLOSED|ALL] [--q <검색어>] [--label <라벨>]… [--sort newest|oldest|comments] [--json]
                                                    이슈 목록·검색(공개 주소면 밖에서 — 제목·본문·#번호·쓴 사람, 페이지 블록은 --block)
+              [--limit <1~200>] [--cursor <다음 커서>] [--all]  나눠 받기 — 깃발 없으면 최신 500건, --all 은 끝까지
   rootr issue create <트래커> --title "<제목>" [--body "<본문>"]  이슈 올리기(내 계정으로)
   rootr issue comment <트래커> <#번호> "<댓글>"       이슈에 댓글
   rootr issue submit <공개 주소> --title "<제목>" [--body …] [--file <경로>]… [--name <이름>] [--block <블록 id>] [--password <비번>]
@@ -245,6 +247,7 @@ usage:
   rootr issue tracker <tracker> [--participation read|login|anyone] [--json]  show tracker settings / change outside participation (MANAGE)
   rootr issue list <tracker|public URL> [--state OPEN|CLOSED|ALL] [--q <text>] [--label <name>]… [--sort newest|oldest|comments] [--json]
                                                    list/search issues (a public URL searches a PUBLISHED tracker from outside — title, body, #number, author; --block for a page)
+              [--limit <1-200>] [--cursor <next cursor>] [--all]  paging — no flag = newest 500, --all = everything
   rootr issue create <tracker> --title "<title>" [--body "<body>"]  file an issue (as your account)
   rootr issue comment <tracker> <#number> "<comment>"  comment on an issue
   rootr issue submit <public URL> --title "<title>" [--body …] [--file <path>]… [--name <name>] [--block <block id>] [--password <pw>]
@@ -2216,6 +2219,23 @@ function issuesOf(res) {
   return Array.isArray(res) ? res : Array.isArray(res?.issues) ? res.issues : [];
 }
 
+/** 목록 아래 한 줄 — 몇 건 중 몇 건, 다음 페이지 받는 법. */
+function issuePageFooter(res, shown) {
+  const total = typeof res?.total === 'number' ? res.total : res?.truncated?.total;
+  if (res?.nextCursor) {
+    console.log(
+      tr(
+        `… 전체 ${total ?? '?'}건 중 ${shown}건. 다음 페이지: 같은 조건에 --cursor ${res.nextCursor}  (끝까지: --all)`,
+        `… ${shown} of ${total ?? '?'}. Next page: same filters plus --cursor ${res.nextCursor}  (everything: --all)`,
+      ),
+    );
+  } else if (res?.truncated) {
+    console.log(tr(`… ${res.truncated.total}건 중 ${res.truncated.shown}건 (나머지는 --limit/--cursor 또는 --all)`, `… ${res.truncated.shown} of ${res.truncated.total} (rest: --limit/--cursor or --all)`));
+  } else if (typeof total === 'number' && total > shown) {
+    console.log(tr(`… 전체 ${total}건 중 ${shown}건`, `… ${shown} of ${total}`));
+  }
+}
+
 function issueNumberOf(raw) {
   const n = Number(String(raw ?? '').replace(/^#/, ''));
   if (!Number.isSafeInteger(n) || n < 1) throw new Error(tr(`이슈 번호가 아닙니다: ${raw}`, `Not an issue number: ${raw}`));
@@ -2283,19 +2303,26 @@ async function cmdIssue(args) {
   }
   if (sub === 'list') {
     const target = args._[1];
-    if (!target) throw new Error(usage('rootr issue list <path|id|공개 주소> [--state OPEN|CLOSED|ALL] [--q <text>] [--label <이름>]… [--sort newest|oldest|comments] [--json]'));
+    if (!target) throw new Error(usage('rootr issue list <path|id|공개 주소> [--state OPEN|CLOSED|ALL] [--q <text>] [--label <이름>]… [--sort newest|oldest|comments] [--limit <1~200>] [--cursor <다음 커서>] [--all] [--json]'));
+    const pg = issuePageArgs(args);
     // ISSUE-PUBLIC-SEARCH — 공개 주소(…/p/{slug})나 --block 이면 웹게시한 트래커를 **밖에서** 찾는다(키 없이, 서버 검색).
     if (/\/p\//.test(String(target)) || typeof args.block === 'string') {
       const slug = publicSlugOf(target);
       const pass = typeof args.password === 'string' ? await client.unlockPublicNode(slug, args.password) : undefined;
-      const res = await client.searchPublicIssues(slug, {
-        blockId: typeof args.block === 'string' ? args.block : undefined,
-        q: typeof args.q === 'string' ? args.q : undefined,
-        state: typeof args.state === 'string' ? args.state : undefined,
-        labels: args.__all.label || [],
-        sort: typeof args.sort === 'string' ? args.sort : undefined,
-        pass,
-      });
+      const res = await collectIssuePages(
+        ({ limit, cursor }) =>
+          client.searchPublicIssues(slug, {
+            blockId: typeof args.block === 'string' ? args.block : undefined,
+            q: typeof args.q === 'string' ? args.q : undefined,
+            state: typeof args.state === 'string' ? args.state : undefined,
+            labels: args.__all.label || [],
+            sort: typeof args.sort === 'string' ? args.sort : undefined,
+            pass,
+            limit,
+            cursor,
+          }),
+        pg,
+      );
       if (args.json) return console.log(JSON.stringify(res, null, 2));
       const list = res?.issues || [];
       if (!list.length) return console.log(tr('조건에 맞는 이슈가 없습니다.', 'No matching issues.'));
@@ -2304,17 +2331,23 @@ async function cmdIssue(args) {
         const labels = (i.labels || []).map((l) => l.name).join(',');
         console.log(`#${i.number}\t${i.state}\t${i.title}${labels ? `\t[${labels}]` : ''}${who ? `\t${who}` : ''}${i.commentCount ? `\t💬${i.commentCount}` : ''}`);
       }
-      if (res.truncated) console.log(tr(`… ${res.truncated.total}건 중 ${res.truncated.shown}건`, `… ${res.truncated.shown} of ${res.truncated.total}`));
+      issuePageFooter(res, list.length);
       return;
     }
     const id = await resolveNodeId(client, target);
-    const list = issuesOf(await client.listIssues(id, { state: args.state, q: typeof args.q === 'string' ? args.q : undefined }));
-    if (args.json) return console.log(JSON.stringify(list, null, 2));
+    const res = await collectIssuePages(
+      ({ limit, cursor }) => client.listIssues(id, { state: args.state, q: typeof args.q === 'string' ? args.q : undefined, limit, cursor }),
+      pg,
+    );
+    const list = issuesOf(res);
+    // --json: 깃발 없이는 예전처럼 배열(스크립트 호환), --all 도 배열(전부). --limit/--cursor 면 다음 커서가 필요하니 { issues, nextCursor, total }.
+    if (args.json) return console.log(JSON.stringify(pg.paged && !pg.all ? { issues: list, nextCursor: res?.nextCursor ?? null, total: res?.total } : list, null, 2));
     if (!list.length) return console.log(tr('이슈가 없습니다.', 'No issues.'));
     for (const i of list) {
       const who = i.guestName ? tr(`${i.guestName} (외부)`, `${i.guestName} (guest)`) : i.author?.name ?? '';
       console.log(`#${i.number}\t${i.state}\t${i.title}${who ? `\t${who}` : ''}${i.commentCount ? `\t💬${i.commentCount}` : ''}`);
     }
+    issuePageFooter(res, list.length);
     return;
   }
   if (sub === 'create') {

package/lib/client.js

@@ -1038,12 +1038,15 @@ export class RootrClient {
    * ISSUE-PUBLIC-SEARCH — 공개 트래커(또는 페이지 블록)의 목록을 서버에서 찾는다. `q` 는 제목·본문·번호(#12)·(이름을 싣는 모드면) 쓴 사람,
    * `labels` 는 이름(모두 가진 것), `state` OPEN|CLOSED, `sort` newest|oldest|comments. 키 없이 부른다(공개 읽기).
    */
-  async searchPublicIssues(slug, { blockId, q, state, labels, sort, pass } = {}) {
+  async searchPublicIssues(slug, { blockId, q, state, labels, sort, pass, limit, cursor } = {}) {
     const qs = new URLSearchParams();
     if (q) qs.set('q', q);
     if (state && String(state).toUpperCase() !== 'ALL') qs.set('state', String(state).toUpperCase());
     for (const l of [].concat(labels || [])) if (l) qs.append('label', l);
     if (sort) qs.set('sort', sort);
+    // ISSUE-PAGING — limit(1~200)·cursor(직전 응답 nextCursor). 둘 다 없으면 서버가 예전처럼 500건.
+    if (limit !== undefined && limit !== null) qs.set('limit', String(limit));
+    if (cursor) qs.set('cursor', cursor);
     if (pass) qs.set('pass', pass);
     const tail = qs.toString();
     return this.request(`${this._publicIssuesBase(slug, blockId)}${tail ? `?${tail}` : ''}`, { noAuth: true });
@@ -1073,13 +1076,16 @@ export class RootrClient {
     return this.request(`${this._publicIssuesBase(slug, blockId)}/${encodeURIComponent(String(number))}${qs}`, { noAuth: true });
   }
 
-  async listIssues(trackerId, { state, label, type, assigneeId, q } = {}) {
+  async listIssues(trackerId, { state, label, type, assigneeId, q, limit, cursor } = {}) {
     const params = new URLSearchParams();
     if (state) params.set('state', state);
     if (label) params.set('label', label);
     if (type) params.set('type', type);
     if (assigneeId) params.set('assigneeId', assigneeId);
     if (q) params.set('q', q);
+    // ISSUE-PAGING — 응답 { issues, nextCursor, total }. 둘 다 없으면 예전처럼 최신 500개.
+    if (limit !== undefined && limit !== null) params.set('limit', String(limit));
+    if (cursor) params.set('cursor', cursor);
     const qs = params.toString();
     return this.request(`/issue-trackers/${encodeURIComponent(trackerId)}/issues${qs ? `?${qs}` : ''}`);
   }

package/lib/issue-paging.js

@@ -0,0 +1,44 @@
+import { t as tr } from './i18n.js';
+
+/**
+ * ISSUE-PAGING — `--limit <1~200>` · `--cursor <다음 커서>` · `--all`(끝까지). 깃발이 없으면 예전처럼 한 번(서버가 최신 500개).
+ * `--all` 은 200개씩 nextCursor 가 없을 때까지 받는다. 옛 서버(페이지 모르는)는 nextCursor 를 안 주므로 한 번에 멈춘다.
+ */
+export function issuePageArgs(args) {
+  const out = { all: args.all === true, limit: undefined, cursor: undefined };
+  if (args.limit !== undefined) {
+    const n = Number(args.limit);
+    if (args.limit === true || !Number.isInteger(n) || n < 1 || n > 200) {
+      throw new Error(tr('--limit 은 1~200 사이 정수입니다(예: --limit 100). 끝까지 받으려면 --all.', '--limit must be an integer 1–200 (e.g. --limit 100). Use --all to fetch everything.'));
+    }
+    out.limit = n;
+  }
+  if (args.cursor !== undefined) {
+    if (typeof args.cursor !== 'string' || !args.cursor) throw new Error(tr('--cursor 에는 직전 결과의 다음 커서를 넣으세요.', '--cursor needs the previous result\'s next cursor.'));
+    out.cursor = args.cursor;
+  }
+  out.paged = out.all || out.limit !== undefined || out.cursor !== undefined;
+  return out;
+}
+
+/** 페이지를 이어 받는다. fetchPage({limit, cursor}) → { issues, nextCursor?, total?, truncated? }. */
+export async function collectIssuePages(fetchPage, { all, limit, cursor }) {
+  if (!all) return fetchPage({ limit, cursor });
+  const size = limit ?? 200;
+  let cur = cursor;
+  let last = null;
+  const issues = [];
+  for (let guard = 0; guard < 100_000; guard++) {
+    const res = await fetchPage({ limit: size, cursor: cur });
+    issues.push(...(Array.isArray(res?.issues) ? res.issues : Array.isArray(res) ? res : []));
+    last = res;
+    const next = res?.nextCursor;
+    if (!next || next === cur) break;
+    cur = next;
+  }
+  const out = { ...(last && !Array.isArray(last) ? last : {}), issues, nextCursor: null };
+  delete out.truncated;
+  if (typeof out.total !== 'number') out.total = issues.length;
+  return out;
+}
+

package/lib/mcp-tools/issues.js

@@ -31,6 +31,26 @@ function slugOf(target) {
   return m ? decodeURIComponent(m[1]) : t;
 }
 
+/**
+ * ISSUE-PAGING — 다음 페이지가 있으면 에이전트가 놓치지 않게 한 줄 안내를 붙인다(서버 응답은 그대로 두고 `next` 만 더한다).
+ * 옛 서버(페이지 모르는)는 nextCursor 가 없어 안내도 없다 — 대신 truncated 가 있으면 그걸로 알린다.
+ */
+export function withPageHint(result) {
+  if (!result || typeof result !== 'object' || !Array.isArray(result.issues)) return result;
+  const n = result.issues.length;
+  if (result.nextCursor) {
+    const total = typeof result.total === 'number' ? ` of ${result.total}` : '';
+    return {
+      ...result,
+      next: `More issues remain (this page ${n}${total}). Call again with cursor="${result.nextCursor}" and the same filters to get the next page.`,
+    };
+  }
+  if (result.truncated && result.nextCursor === undefined) {
+    return { ...result, next: `Only ${result.truncated.shown} of ${result.truncated.total} returned — pass limit (1–200) and then cursor=<nextCursor> to page through the rest.` };
+  }
+  return result;
+}
+
 /** Issue tracker tools: create tracker, list/create/get/update issues, comment. */
 export function registerIssueTools(server) {
   server.registerTool(
@@ -68,8 +88,11 @@ export function registerIssueTools(server) {
     {
       title: 'List issues in a tracker',
       description:
-        'List issues in a Rootr (루터) issue tracker, optionally filtered by state (OPEN/CLOSED/ALL), label id, ' +
-        'type id, or a text query. Use rootr_get_issue for full details of one issue.',
+        'List issues in a Rootr (루터) issue tracker, newest number first, optionally filtered by state (OPEN/CLOSED/ALL), ' +
+        'label id, type id, or a text query. Paged: pass `limit` (1–200) and, for the next page, `cursor` = the previous ' +
+        'result\'s `nextCursor` (keep the same filters). Without limit/cursor you get the newest 500. Returns ' +
+        '{ issues, nextCursor, total } — `nextCursor` null means the last page; `total` = all issues matching the filters. ' +
+        'Use rootr_get_issue for full details of one issue.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         trackerId: z.string().describe(`Issue tracker node id${NODE_TARGET_HINT}`),
@@ -77,14 +100,16 @@ export function registerIssueTools(server) {
         q: z.string().optional().describe('Free-text search within issues'),
         label: z.string().optional().describe('Label id to filter by'),
         type: z.string().optional().describe('Issue type id to filter by'),
+        limit: z.number().int().min(1).max(200).optional().describe('Page size 1–200 (omit with cursor too = newest 500, as before)'),
+        cursor: z.string().max(400).optional().describe('`nextCursor` from the previous call, unchanged (same filters) — next page'),
       },
     },
-    async ({ trackerId, state, q, label, type }) => {
+    async ({ trackerId, state, q, label, type, limit, cursor }) => {
       try {
         const client = makeClient();
         trackerId = await resolveNodeId(client, trackerId);
-        const result = await client.listIssues(trackerId, { state, q, label, type });
-        return jsonResult(result);
+        const result = await client.listIssues(trackerId, { state, q, label, type, limit, cursor });
+        return jsonResult(withPageHint(result));
       } catch (err) {
         return errorResult(err);
       }
@@ -311,8 +336,9 @@ export function registerIssueTools(server) {
         'what an outside visitor sees. `q` matches title, body, number ("#12" or "12") and, when the tracker shows authors ' +
         '(participation login/anyone), the author name; `labels` = label names (issues having all of them); `state` OPEN|CLOSED; ' +
         '`sort` newest (default) | oldest | comments. Returns { participation, issues:[{number,title,state,body,labels,createdAt,' +
-        'closedAt,commentCount,author}], truncated? } (≤500 per call). No key needed. For a tracker in YOUR workspace prefer ' +
-        'rootr_list_issues (internal fields).',
+        'closedAt,commentCount,author}], truncated?, nextCursor?, total? }. Paged: `limit` (1–200) and `cursor` = the previous ' +
+        'result\'s `nextCursor` (same q/state/labels/sort); without them you get up to 500 (truncated tells you there were more). ' +
+        'No key needed. For a tracker in YOUR workspace prefer rootr_list_issues (internal fields).',
       annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
       inputSchema: {
         url: PUBLIC_TARGET.url,
@@ -322,14 +348,16 @@ export function registerIssueTools(server) {
         state: z.enum(['OPEN', 'CLOSED', 'ALL']).optional().describe('Default ALL'),
         labels: z.array(z.string().max(100)).max(20).optional().describe('Label names — issues having all of them'),
         sort: z.enum(['newest', 'oldest', 'comments']).optional(),
+        limit: z.number().int().min(1).max(200).optional().describe('Page size 1–200'),
+        cursor: z.string().max(400).optional().describe('`nextCursor` from the previous call, unchanged (same q/state/labels/sort)'),
       },
     },
-    async ({ url, blockId, password, q, state, labels, sort }) => {
+    async ({ url, blockId, password, q, state, labels, sort, limit, cursor }) => {
       try {
         const client = makeClient();
         const slug = slugOf(url);
         const pass = password ? await client.unlockPublicNode(slug, password) : undefined;
-        return jsonResult(await client.searchPublicIssues(slug, { blockId, q, state, labels, sort, pass }));
+        return jsonResult(withPageHint(await client.searchPublicIssues(slug, { blockId, q, state, labels, sort, pass, limit, cursor })));
       } catch (err) {
         return errorResult(err);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rootr-cli",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "description": "Official Rootr CLI + MCP server — read, write, edit and search Rootr documents from the shell or from an AI agent.",
   "type": "module",
   "bin": {