rootr-cli 0.9.0 → 0.13.0

package/lib/client.js

@@ -46,7 +46,23 @@ function hintFor(status, body) {
       '(rootr_workspaces 로 어떤 워크스페이스가 실제로 열리는지 확인할 수 있습니다.)'
     );
   }
-  if (status === 401 || status === 403) {
+  // HINT-WRONG-CAUSE — 서버가 이미 원인을 정확히 말했으면 **덮어쓰지 않는다**.
+  // 예전에는 403 이면 무조건 "API 키/스코프를 확인하세요"를 붙였다. 그래서
+  // "무료 워크스페이스는 5개까지" 라는 정확한 메시지 밑에 엉뚱한 조치가 붙어,
+  // 받는 쪽이 키를 한참 뒤졌다(외부 에이전트 실측 2026-08-30).
+  if (status === 401 || status === 403 || status === 402) {
+    const msg = String((body && (body.message || body.error)) || '');
+    if (/workspace/i.test(msg) && /(at most|limit|한도|최대)/i.test(msg)) {
+      return (
+        '한도 문제이지 키 문제가 아닙니다. 안 쓰는 워크스페이스를 rootr.io > 설정 > 워크스페이스에서 ' +
+        '지우거나, 기존 워크스페이스 **안에** 폴더로 지으세요(rootr_scaffold_apply 에 rootPath 를 주면 됩니다). ' +
+        '요금제를 올려도 됩니다.'
+      );
+    }
+    // 서버가 무슨 일인지 이미 구체적으로 말했으면 그대로 둔다.
+    if (msg && !/^(forbidden|unauthorized|invalid api key|access denied)\.?$/i.test(msg.trim())) {
+      return undefined;
+    }
     return (
       'API 키 또는 워크스페이스 스코프를 확인하세요 (rootr config로 현재 설정 확인). ' +
       '워크스페이스 생성(rootr_create_workspace)은 계정 키(PAT, workspaces:create 스코프)가 필요합니다 — ' +
@@ -348,6 +364,35 @@ export class RootrClient {
     });
   }
 
+  // ── PUBLIC-ANY — 어떤 타입이든 공개 발행 ─────────────────────────────
+  //
+  // 문서·덱만 되던 것을 전 타입으로 열었다(창업자 지시 2026-08-27). 문서는 이
+  // 주소로 불러도 예전 경로로 넘어가므로, **무엇을 공개하든 이것 하나만 쓰면 된다.**
+
+  /**
+   * 공개 발행한다. `{ includeChildren: true }`를 주면 **그 아래 전부**(손자·증손자
+   * 포함)가 각자 공개 주소를 받는다. 안 주면 그 노드 하나만 공개된다.
+   */
+  async publishNode(nodeId, opts = {}) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/publish`, {
+      method: 'POST',
+      body: opts,
+    });
+  }
+
+  /** 공개 설정을 고친다. `{ isPublic: false }`면 닫는다(딸려 나갔던 하위도 같이 닫힌다). */
+  async setNodePublic(nodeId, settings = {}) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/public`, {
+      method: 'PATCH',
+      body: settings,
+    });
+  }
+
+  /** 지금 공개돼 있는지, 주소는 뭔지, 하위까지 공개인지. */
+  async nodePublicStatus(nodeId) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/public-status`);
+  }
+
   // ── DB-PERM-001 / DB-WATCH — 표에 거는 자물쇠와 알림 규칙 ──────────────
   //
   // 노션에 없는 것들이라, 에이전트가 표를 만들어 놓고도 "지원서는 서로 못 보게" 같은
@@ -435,6 +480,37 @@ export class RootrClient {
     });
   }
 
+  /**
+   * Check a designed tree BEFORE building it — the compiler pass of scaffolding.
+   * Needs no workspace, creates nothing. Returns { score, counts, findings, summary }.
+   */
+  async scaffoldReview(tree) {
+    return this.request('/scaffold/review', { method: 'POST', body: { tree } });
+  }
+
+  /**
+   * Check the workspace that was ACTUALLY built (not the tree you sent).
+   * Optional rootPath narrows it to one subtree.
+   */
+  async scaffoldReviewBuilt(workspace, rootPath) {
+    return this.request(`/workspaces/${encodeURIComponent(workspace)}/scaffold/review-built`, {
+      method: 'POST',
+      body: { rootPath },
+    });
+  }
+
+  /**
+   * Run the built workspace: do relations point at real rows, do rollups/formulas
+   * produce values, do views reference real columns, can the form actually collect,
+   * are sheet formulas computed and error-free. Writes nothing.
+   */
+  async scaffoldSelfTest(workspace, rootPath) {
+    return this.request(`/workspaces/${encodeURIComponent(workspace)}/scaffold/selftest`, {
+      method: 'POST',
+      body: { rootPath },
+    });
+  }
+
   /** Apply a scaffold tree to an existing workspace. */
   async scaffoldApply(workspace, { rootPath, tree } = {}) {
     return this.request(`/workspaces/${encodeURIComponent(workspace)}/scaffold/apply`, {
@@ -644,10 +720,21 @@ export class RootrClient {
    * building a table by adding columns one at a time made the order depend on
    * the order of the calls, which is how migrated tables came out scrambled.
    */
-  async createDatabase(workspace, { name, parentId, path, createParents, autoRename, icon, properties, views, rows } = {}) {
+  async createDatabase(workspace, { name, parentId, path, createParents, autoRename, icon, properties, views, rows, rowPageType } = {}) {
     return this.request(`/workspaces/${encodeURIComponent(workspace)}/databases`, {
       method: 'POST',
-      body: { name, parentId, path, createParents, autoRename, icon, properties, views, rows },
+      body: { name, parentId, path, createParents, autoRename, icon, properties, views, rows, rowPageType },
+    });
+  }
+
+  /**
+   * SIGN-001 — 이 표의 행을 열었을 때 나오는 상세 문서를 서명문서로 바꾼다.
+   * 그 뒤로 만들어지는 행마다 서명문서(연구노트)가 붙는다.
+   */
+  async setDatabaseRowPageType(databaseId, rowPageType) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}`, {
+      method: 'PATCH',
+      body: { rowPageType },
     });
   }
 
@@ -655,10 +742,13 @@ export class RootrClient {
    * 뷰를 하나 **덧붙인다**(기존 뷰는 그대로). 표를 만들 때만 뷰를 정할 수 있어서,
    * 노션에서 뷰가 넷인 표를 옮기면 하나밖에 못 두던 문제를 푼다.
    */
-  async createDatabaseView(databaseId, { name, type, groupBy, dateProp, endDateProp } = {}) {
+  async createDatabaseView(
+    databaseId,
+    { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths } = {},
+  ) {
     return this.request(`/databases/${encodeURIComponent(databaseId)}/views`, {
       method: 'POST',
-      body: { name, type, groupBy, dateProp, endDateProp },
+      body: { name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths },
     });
   }
 
@@ -712,6 +802,74 @@ export class RootrClient {
     );
   }
 
+  /**
+   * DB-BULK — 고른 행 **전부**에 같은 값을 덮어쓴다(에이랩스 요청 2026-08-27).
+   * 하나라도 잠겨 있거나 남의 행이면 **아무것도 바꾸지 않고** 실패한다.
+   */
+  /**
+   * DB-BULK — 여러 행을 **한 번에 넣는다**. 전부 아니면 전무다.
+   * 칸은 이름으로도 id로도 적을 수 있다.
+   */
+  async bulkCreateRows(databaseId, rows) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/bulk`, {
+      method: 'POST',
+      body: { rows },
+    });
+  }
+
+  /** DB-BULK — **행마다 다른 값**으로 한 번에 고친다. */
+  async bulkUpdateRowsEach(databaseId, updates) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/each`, {
+      method: 'PATCH',
+      body: { updates },
+    });
+  }
+
+  async bulkUpdateRows(databaseId, rowIds, values) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows`, {
+      method: 'PATCH',
+      body: { rowIds, values },
+    });
+  }
+
+  /** DB-BULK — 고른 행을 한 번에 지운다. 서명이 찍힌 행이 섞여 있으면 통째로 거절된다. */
+  async bulkDeleteRows(databaseId, rowIds) {
+    return this.request(`/databases/${encodeURIComponent(databaseId)}/rows/bulk-delete`, {
+      method: 'POST',
+      body: { rowIds },
+    });
+  }
+
+  /**
+   * ROW-PAGE-PICK — 행 하나에 상세 문서를 붙인다.
+   *
+   * `type`을 주면 **이 행만** 그 타입으로 태어난다(문서·서명문서·스프레드시트·
+   * 화이트보드·발표자료·녹음·폼·이슈). 안 주면 표의 기본값(`rowPageType`).
+   * 이미 붙어 있으면 그대로 돌려준다 — 타입을 소급해 바꾸지는 않는다.
+   */
+  async createRowPage(rowId, type) {
+    return this.request(`/database-rows/${encodeURIComponent(rowId)}/page`, {
+      method: 'POST',
+      body: type ? { type } : {},
+    });
+  }
+
+  /**
+   * ROW-PAGE-LINK — **이미 있는 문서를 행에 잇는다**(창업자 지적 2026-08-27).
+   * 문서는 옮기지 않는다 — 있던 자리에 그대로 두고 가리키기만 한다.
+   */
+  async linkRowPage(rowId, nodeId) {
+    return this.request(`/database-rows/${encodeURIComponent(rowId)}/page`, {
+      method: 'POST',
+      body: { nodeId },
+    });
+  }
+
+  /** ROW-PAGE-LINK — 연결만 끊는다. 문서는 지우지 않는다. */
+  async unlinkRowPage(rowId) {
+    return this.request(`/database-rows/${encodeURIComponent(rowId)}/page`, { method: 'DELETE' });
+  }
+
   async deleteRow(databaseId, rowId) {
     return this.request(
       `/databases/${encodeURIComponent(databaseId)}/rows/${encodeURIComponent(rowId)}`,
@@ -719,6 +877,26 @@ export class RootrClient {
     );
   }
 
+  // ---- READ-ACK: 읽음 확인 -------------------------------------------------
+  // 문서·표·폴더에 "읽고 확인 눌러야 한다"를 걸고, 얼마나 읽었는지 본다.
+
+  async readRequirement(nodeId) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/read-requirement`);
+  }
+
+  async setReadRequirement(nodeId, body) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/read-requirement`, {
+      method: 'PUT',
+      body,
+    });
+  }
+
+  async clearReadRequirement(nodeId) {
+    return this.request(`/nodes/${encodeURIComponent(nodeId)}/read-requirement`, {
+      method: 'DELETE',
+    });
+  }
+
   // ---- DB-COL: one column at a time --------------------------------------
   // PATCH /databases/:id replaces the whole properties array, so rebuilding it
   // client-side drops any column left out. These merge server-side instead.
@@ -1291,4 +1469,162 @@ export class RootrClient {
     if (data && Array.isArray(data.links)) return data.links;
     return [];
   }
+
+  // ── SIGN-001: 서명문서 · 연구노트 ────────────────────────────────────
+  //
+  // 마크다운 문서인데 올리는 순간 본문이 얼고, 결재라인에 적힌 사람들이 차례로
+  // 서명하면 서명마다 시점확인(TSA)과 해시 체이닝이 붙는다. 서명·올리기·반려는
+  // 메일로 받은 6자리 확인 코드를 함께 보내야 한다 — 서버가 개인키를 보관하는
+  // 구조에서 "본인이 눌렀다"의 유일한 증거라, 코드 없이 대신 눌러 줄 수는 없다.
+
+  /** 서명문서 만들기 — 본문·모드·결재라인까지 한 번에. */
+  async createSignedDoc(workspaceId, body = {}) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/signed-docs`, {
+      method: 'POST',
+      body,
+    });
+  }
+
+  /** 지금 상태: 결재라인·단계별 진행·서명 목록·본문이 그대로인지. */
+  async getSignedDoc(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}`);
+  }
+
+  /** 결재라인 다시 짜기(올리기 전에만). steps 순서가 곧 서명 순서다. */
+  async setApprovalLine(nodeId, steps) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/approval-line`, {
+      method: 'PUT',
+      body: { steps },
+    });
+  }
+
+  /** 연구노트 프리셋: 기재자(나) → 점검자 두 단계. */
+  async applyResearchNotePreset(nodeId, { reviewerUserId, noteMeta } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/research-note-preset`, {
+      method: 'POST',
+      body: { reviewerUserId, noteMeta },
+    });
+  }
+
+  /** 확인 코드를 본인 메일로 보낸다. 문서 하나용. */
+  async requestSigningCode(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/request-code`, {
+      method: 'POST',
+      body: {},
+    });
+  }
+
+  /** 확인 코드 — 묶음 서명용(워크스페이스 단위로 한 번). */
+  async requestBulkSigningCode(workspaceId) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/signed-docs/request-code`, {
+      method: 'POST',
+      body: {},
+    });
+  }
+
+  /** 올리기 = 본문을 얼리고 기안자가 첫 도장을 찍는다. */
+  async submitSignedDoc(nodeId, { code } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/submit`, {
+      method: 'POST',
+      body: { code },
+    });
+  }
+
+  /** 내 차례에 서명한다. */
+  async signSignedDoc(nodeId, { code } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/sign`, {
+      method: 'POST',
+      body: { code },
+    });
+  }
+
+  /** 반려 — 사유는 필수다. 반려되면 다시 고칠 수 있게 풀린다. */
+  async rejectSignedDoc(nodeId, { comment, code } = {}) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/reject`, {
+      method: 'POST',
+      body: { comment, code },
+    });
+  }
+
+  /** 아직 아무도 서명하지 않은 초안을 다시 열어 고칠 수 있게 한다. */
+  async reopenSignedDoc(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/reopen`, { method: 'POST' });
+  }
+
+  /** 개정본 만들기 — 서명된 문서는 고치는 게 아니라 새 판을 낸다. */
+  async reviseSignedDoc(nodeId, note) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/revise`, {
+      method: 'POST',
+      body: { note },
+    });
+  }
+
+  /** 위변조 검증. 로그인 없이도 열려 있다(본문은 안 내려온다). */
+  async verifySignedDoc(nodeId) {
+    return this.request(`/signed-docs/${encodeURIComponent(nodeId)}/verify`);
+  }
+
+  /** 워크스페이스 서명문서 목록. pendingMine이면 "내 차례인 것"만. */
+  async listSignedDocs(workspaceId, { status, mode, pendingMine } = {}) {
+    const qs = new URLSearchParams();
+    if (status) qs.set('status', status);
+    if (mode) qs.set('mode', mode);
+    if (pendingMine) qs.set('pendingMine', 'true');
+    const q = qs.toString();
+    return this.request(
+      `/workspaces/${encodeURIComponent(workspaceId)}/signed-docs${q ? `?${q}` : ''}`,
+    );
+  }
+
+  /** 묶음 서명 — "이번 주 미점검 12건"을 한 번에. 코드 하나로 전부. */
+  async bulkSignSignedDocs(workspaceId, { nodeIds, code } = {}) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/signed-docs/bulk-sign`, {
+      method: 'POST',
+      body: { nodeIds, code },
+    });
+  }
+
+  /** 워크스페이스 원장(해시 체인) 전체 검증. */
+  async verifyLedger(workspaceId) {
+    return this.request(`/workspaces/${encodeURIComponent(workspaceId)}/ledger/verify`);
+  }
+
+  /**
+   * FEEDBACK — 제보를 보낸다. 다른 메서드와 달리 `request()`를 쓰지 않고 직접
+   * fetch 한다: **API 키가 없어도, 키가 틀렸어도 보낼 수 있어야** 하기 때문이다.
+   * 키가 잘못돼서 아무것도 못 하는 사람의 제보가 바로 우리가 제일 받고 싶은 제보다.
+   * 키가 있으면 붙여서 누가 보냈는지 알 수 있게 하고, 없으면 익명으로 간다.
+   */
+  async sendFeedback({ body, title, kind, contactEmail, reporter, context, workspaceId, client } = {}) {
+    const url = `${this.baseUrl}/feedback`;
+    const headers = {
+      'Content-Type': 'application/json',
+      'x-rootr-client': client || 'cli',
+      ...this.defaultHeaders,
+    };
+    if (this.apiKey) headers['x-api-key'] = this.apiKey;
+    let res;
+    try {
+      res = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ body, title, kind, contactEmail, reporter, context, workspaceId }),
+      });
+    } catch (err) {
+      throw new RootrApiError(`네트워크 오류: ${err.message}`, { hint: `요청 URL: ${url}` });
+    }
+    const text = await res.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : {};
+    } catch {
+      data = { message: text };
+    }
+    if (!res.ok) {
+      throw new RootrApiError(data.message || `제보를 보내지 못했습니다 (HTTP ${res.status})`, {
+        status: res.status,
+      });
+    }
+    return data;
+  }
 }

package/lib/config.js

@@ -43,6 +43,11 @@ export function loadConfig() {
  * its owner belongs to, so it is the right fallback).
  */
 export function keyForWorkspace(cfg, workspace) {
+  // ENV-WINS — 사람이 방금 환경변수로 준 키가 설정파일에 저장된 키보다 세다.
+  // 예전에는 반대였다: `ROOTR_API_KEY=... rootr mcp` 로 다른 서버를 가리켜도
+  // 파일에 워크스페이스로 묶여 있던 옛 키가 조용히 이겨서 "Invalid API key"만
+  // 떴다(2026-08-30 실측). 어느 키가 쓰였는지 화면에 안 나오니 원인이 안 보인다.
+  if (process.env.ROOTR_API_KEY) return process.env.ROOTR_API_KEY;
   if (workspace) {
     const bound = (cfg.keys || []).find((k) => k.workspace === workspace);
     if (bound) return bound.apiKey;