rootr-cli 0.17.1 → 0.17.2

package/lib/client.js

@@ -7,6 +7,7 @@
  */
 
 import { currentRateLimitSink } from './context.js';
+import { t as tr } from './i18n.js';
 
 /** Copy the API's X-RateLimit-* headers into the ambient per-call sink, if any. */
 function captureRateLimit(res) {
@@ -40,10 +41,17 @@ function hintFor(status, body) {
   const detail = body && (body.message || body.error || '');
   if (status === 403 && typeof detail === 'string' && /does not belong to this workspace/i.test(detail)) {
     return (
-      '이 키는 다른 워크스페이스 전용 키입니다. 목록에 보인다고 접근되는 것은 아닙니다.\n' +
-      '조치: rootr.io > 설정 > API 키에서 계정 키(PAT)를 발급해 `rootr config --api-key <키>` 로 등록하거나, ' +
-      '그 워크스페이스용 키를 `rootr config --add-key <키> --workspace <워크스페이스 id>` 로 추가하세요. ' +
-      '(rootr_workspaces 로 어떤 워크스페이스가 실제로 열리는지 확인할 수 있습니다.)'
+      tr(
+        '이 키는 다른 워크스페이스 전용 키입니다. 목록에 보인다고 접근되는 것은 아닙니다.\n' +
+          '조치: rootr.io > 설정 > API 키에서 계정 키(PAT)를 발급해 `rootr config --api-key <키>` 로 등록하거나, ' +
+          '그 워크스페이스용 키를 `rootr config --add-key <키> --workspace <워크스페이스 id>` 로 추가하세요. ' +
+          '(rootr_workspaces 로 어떤 워크스페이스가 실제로 열리는지 확인할 수 있습니다.)',
+        'This key belongs to a different workspace. Being listed is not the same as being reachable.\n' +
+          'Fix: create an account key (PAT) under rootr.io > Settings > API keys and register it with ' +
+          '`rootr config --api-key <key>`, or add a key for that workspace with ' +
+          '`rootr config --add-key <key> --workspace <workspace id>`. ' +
+          '(rootr_workspaces shows which workspaces actually open.)',
+      )
     );
   }
   // HINT-WRONG-CAUSE — 서버가 이미 원인을 정확히 말했으면 **덮어쓰지 않는다**.
@@ -54,9 +62,14 @@ function hintFor(status, body) {
     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 를 주면 됩니다). ' +
-        '요금제를 올려도 됩니다.'
+        tr(
+          '한도 문제이지 키 문제가 아닙니다. 안 쓰는 워크스페이스를 rootr.io > 설정 > 워크스페이스에서 ' +
+            '지우거나, 기존 워크스페이스 **안에** 폴더로 지으세요(rootr_scaffold_apply 에 rootPath 를 주면 됩니다). ' +
+            '요금제를 올려도 됩니다.',
+          'This is a quota problem, not a key problem. Delete unused workspaces under ' +
+            'rootr.io > Settings > Workspaces, or build **inside** an existing workspace as a folder ' +
+            '(pass rootPath to rootr_scaffold_apply). Upgrading the plan also works.',
+        )
       );
     }
     // 서버가 무슨 일인지 이미 구체적으로 말했으면 그대로 둔다.
@@ -64,16 +77,21 @@ function hintFor(status, body) {
       return undefined;
     }
     return (
-      'API 키 또는 워크스페이스 스코프를 확인하세요 (rootr config로 현재 설정 확인). ' +
-      '워크스페이스 생성(rootr_create_workspace)은 계정 키(PAT, workspaces:create 스코프)가 필요합니다 — ' +
-      '워크스페이스 키(docs:read/docs:write/graph:read/ask/webhooks:manage 스코프)로는 할 수 없습니다.'
+      tr(
+        'API 키 또는 워크스페이스 스코프를 확인하세요 (rootr config로 현재 설정 확인). ' +
+          '워크스페이스 생성(rootr_create_workspace)은 계정 키(PAT, workspaces:create 스코프)가 필요합니다 — ' +
+          '워크스페이스 키(docs:read/docs:write/graph:read/ask/webhooks:manage 스코프)로는 할 수 없습니다.',
+        'Check the API key and the workspace scopes (`rootr config` shows the current setup). ' +
+          'Creating a workspace (rootr_create_workspace) needs an account key (PAT with workspaces:create) — ' +
+          'a workspace key (docs:read/docs:write/graph:read/ask/webhooks:manage) cannot do it.',
+      )
     );
   }
   if (status === 412) {
-    return '문서가 그 사이 변경되었습니다: 다시 읽고 재시도하세요.';
+    return tr('문서가 그 사이 변경되었습니다: 다시 읽고 재시도하세요.', 'The document changed in the meantime: read it again and retry.');
   }
   if (status === 409) {
-    return body && (body.message || body.error) ? undefined : '충돌이 발생했습니다.';
+    return body && (body.message || body.error) ? undefined : tr('충돌이 발생했습니다.', 'Conflict.');
   }
   return undefined;
 }
@@ -90,16 +108,22 @@ export class RootrClient {
 
   _requireWorkspace() {
     if (!this.workspace) {
-      throw new RootrApiError('워크스페이스가 설정되지 않았습니다.', {
-        hint: 'rootr config --workspace <id> 로 설정하거나 ROOTR_WORKSPACE 환경변수를 지정하세요.',
+      throw new RootrApiError(tr('워크스페이스가 설정되지 않았습니다.', 'No workspace is configured.'), {
+        hint: tr(
+          'rootr config --workspace <id> 로 설정하거나 ROOTR_WORKSPACE 환경변수를 지정하세요.',
+          'Set one with `rootr config --workspace <id>`, or the ROOTR_WORKSPACE environment variable.',
+        ),
       });
     }
   }
 
   _requireApiKey() {
     if (!this.apiKey) {
-      throw new RootrApiError('API 키가 설정되지 않았습니다.', {
-        hint: 'rootr config --api-key <key> 로 설정하거나 ROOTR_API_KEY 환경변수를 지정하세요.',
+      throw new RootrApiError(tr('API 키가 설정되지 않았습니다.', 'No API key is configured.'), {
+        hint: tr(
+          'rootr config --api-key <key> 로 설정하거나 ROOTR_API_KEY 환경변수를 지정하세요.',
+          'Set one with `rootr config --api-key <key>`, or the ROOTR_API_KEY environment variable.',
+        ),
       });
     }
   }
@@ -138,7 +162,7 @@ export class RootrClient {
         body,
       });
     } catch (err) {
-      throw new RootrApiError(`네트워크 오류: ${err.message}`, { hint: `요청 URL: ${url}` });
+      throw new RootrApiError(tr(`네트워크 오류: ${err.message}`, `Network error: ${err.message}`), { hint: tr(`요청 URL: ${url}`, `Request URL: ${url}`) });
     }
 
     captureRateLimit(res);
@@ -665,7 +689,7 @@ export class RootrClient {
     });
     if (data && Array.isArray(data.errors) && data.errors.length) {
       const msg = data.errors.map((e) => e.message || String(e)).join('; ');
-      throw new RootrApiError(`ask 오류: ${msg}`, { body: data.errors });
+      throw new RootrApiError(tr(`ask 오류: ${msg}`, `ask failed: ${msg}`), { body: data.errors });
     }
     return (data && data.data && data.data.ask) || { text: '', citations: [] };
   }
@@ -1265,7 +1289,7 @@ export class RootrClient {
     const url = this.attachmentRawUrl(attachmentId);
     const res = await fetch(url);
     if (!res.ok) {
-      throw new RootrApiError(`오디오 다운로드 실패 (HTTP ${res.status})`, { status: res.status });
+      throw new RootrApiError(tr(`오디오 다운로드 실패 (HTTP ${res.status})`, `Audio download failed (HTTP ${res.status})`), { status: res.status });
     }
     return Buffer.from(await res.arrayBuffer());
   }
@@ -1724,7 +1748,7 @@ export class RootrClient {
         body: JSON.stringify({ body, title, kind, contactEmail, reporter, context, workspaceId }),
       });
     } catch (err) {
-      throw new RootrApiError(`네트워크 오류: ${err.message}`, { hint: `요청 URL: ${url}` });
+      throw new RootrApiError(tr(`네트워크 오류: ${err.message}`, `Network error: ${err.message}`), { hint: tr(`요청 URL: ${url}`, `Request URL: ${url}`) });
     }
     const text = await res.text();
     let data;
@@ -1734,7 +1758,7 @@ export class RootrClient {
       data = { message: text };
     }
     if (!res.ok) {
-      throw new RootrApiError(data.message || `제보를 보내지 못했습니다 (HTTP ${res.status})`, {
+      throw new RootrApiError(data.message || tr(`제보를 보내지 못했습니다 (HTTP ${res.status})`, `Could not send feedback (HTTP ${res.status})`), {
         status: res.status,
       });
     }

package/lib/credentials.js

@@ -1,6 +1,7 @@
 import { loadConfig, saveConfig, upsertKey } from './config.js';
 import { RootrClient } from './client.js';
 import { parseRootrUrl } from './resolve.js';
+import { t as tr } from './i18n.js';
 
 /**
  * Every credential this machine can use, default key first. An account key
@@ -90,9 +91,13 @@ export async function resolveWorkspaceSwitch(wantedRaw, cfg = loadConfig()) {
   const candidates = candidateClients(cfg);
   if (!candidates.length) {
     return {
-      error:
+      error: tr(
         '이 컴퓨터에 등록된 Rootr 키가 없습니다.\n' +
-        '조치: rootr.io > 설정 > API 키에서 계정 키(PAT)를 발급받아 `rootr config --api-key <키>` 로 등록하세요.',
+          '조치: rootr.io > 설정 > API 키에서 계정 키(PAT)를 발급받아 `rootr config --api-key <키>` 로 등록하세요.',
+        'No Rootr key is registered on this machine.\n' +
+          'Fix: create an account key (PAT) under rootr.io > Settings > API keys, then register it with ' +
+          '`rootr config --api-key <key>`.',
+      ),
     };
   }
 
@@ -151,28 +156,48 @@ export async function resolveWorkspaceSwitch(wantedRaw, cfg = loadConfig()) {
   if (target) {
     const scoped = lastRejection && lastRejection.status === 403;
     return {
-      error:
+      error: tr(
         `"${target.name || target.id}" (${target.id}) 는 접근 권한 목록에는 있지만, 등록된 키로는 열 수 없습니다` +
-        `${target.role ? ` (내 역할: ${target.role})` : ''}.\n` +
-        (scoped
-          ? '원인: 지금 등록된 키가 다른 워크스페이스 전용 키입니다 (워크스페이스 키는 자기 워크스페이스 밖에서 403).\n'
-          : `원인: ${lastRejection ? lastRejection.message : '알 수 없음'}\n`) +
-        '조치 (둘 중 하나, 사용자가 직접):\n' +
-        '1) rootr.io > 설정 > API 키에서 계정 키(PAT)를 발급 → `rootr config --api-key <키>` (모든 워크스페이스에 통함)\n' +
-        `2) 그 워크스페이스용 키를 발급 → \`rootr config --add-key <키> --workspace ${target.id}\``,
+          `${target.role ? ` (내 역할: ${target.role})` : ''}.\n` +
+          (scoped
+            ? '원인: 지금 등록된 키가 다른 워크스페이스 전용 키입니다 (워크스페이스 키는 자기 워크스페이스 밖에서 403).\n'
+            : `원인: ${lastRejection ? lastRejection.message : '알 수 없음'}\n`) +
+          '조치 (둘 중 하나, 사용자가 직접):\n' +
+          '1) rootr.io > 설정 > API 키에서 계정 키(PAT)를 발급 → `rootr config --api-key <키>` (모든 워크스페이스에 통함)\n' +
+          `2) 그 워크스페이스용 키를 발급 → \`rootr config --add-key <키> --workspace ${target.id}\``,
+        `"${target.name || target.id}" (${target.id}) is on your access list, but none of the registered keys opens it` +
+          `${target.role ? ` (your role: ${target.role})` : ''}.\n` +
+          (scoped
+            ? 'Cause: the registered key belongs to a different workspace (a workspace key gets 403 outside its own).\n'
+            : `Cause: ${lastRejection ? lastRejection.message : 'unknown'}\n`) +
+          'Fix (either one, done by you):\n' +
+          '1) Create an account key (PAT) under rootr.io > Settings > API keys → `rootr config --api-key <key>` (works everywhere)\n' +
+          `2) Create a key for that workspace → \`rootr config --add-key <key> --workspace ${target.id}\``,
+      ),
     };
   }
+  const visibleList = visible.map((w) => `${w.name || w.slug || ''}(${w.id})`).join(', ');
   const seenList = visible.length
-    ? `\n지금 보이는 워크스페이스: ${visible.map((w) => `${w.name || w.slug || ''}(${w.id})`).join(', ')}`
+    ? tr(`\n지금 보이는 워크스페이스: ${visibleList}`, `\nWorkspaces visible to you: ${visibleList}`)
     : '';
   return {
     error:
       listed === 0
-        ? '등록된 키로 워크스페이스 목록을 조회하지 못했습니다 (키가 만료/취소되었거나 목록 권한이 없음).\n' +
-          '조치: rootr.io > 설정 > API 키에서 계정 키(PAT)를 새로 발급해 `rootr config --api-key <키>` 로 등록하세요.'
-        : `"${wanted}" 워크스페이스가 내 소속 목록에 없습니다.${seenList}\n` +
-          '조치: 주소가 맞는지 확인하고, 다른 계정의 워크스페이스라면 그 계정으로 발급한 키를 ' +
-          '`rootr config --add-key <키>` 로 등록하세요.',
+        ? tr(
+            '등록된 키로 워크스페이스 목록을 조회하지 못했습니다 (키가 만료/취소되었거나 목록 권한이 없음).\n' +
+              '조치: rootr.io > 설정 > API 키에서 계정 키(PAT)를 새로 발급해 `rootr config --api-key <키>` 로 등록하세요.',
+            'Could not list workspaces with the registered keys (expired/revoked, or no listing scope).\n' +
+              'Fix: create a fresh account key (PAT) under rootr.io > Settings > API keys and register it with ' +
+              '`rootr config --api-key <key>`.',
+          )
+        : tr(
+            `"${wanted}" 워크스페이스가 내 소속 목록에 없습니다.${seenList}\n` +
+              '조치: 주소가 맞는지 확인하고, 다른 계정의 워크스페이스라면 그 계정으로 발급한 키를 ' +
+              '`rootr config --add-key <키>` 로 등록하세요.',
+            `"${wanted}" is not in your workspace list.${seenList}\n` +
+              'Fix: check the address, and if it belongs to another account, register a key issued by that ' +
+              'account with `rootr config --add-key <key>`.',
+          ),
   };
 }
 

package/lib/i18n.js

@@ -0,0 +1,40 @@
+/**
+ * CLI 출력 언어.
+ *
+ * 왜: npm 페이지를 영문으로 바꾸고 나니, 그걸 읽고 설치한 사람이 `rootr --help`에서
+ * 한글 화면을 만난다. 도구 설명(에이전트가 읽는 스키마)은 원래 영어인데 사람이 보는
+ * 쪽만 한국어였다.
+ *
+ * 규칙 (위가 우선):
+ *   1. ROOTR_LANG=ko|en  — 명시 지정
+ *   2. LC_ALL / LC_MESSAGES / LANG 이 ko 로 시작하면 한국어
+ *   3. 그 외에는 영어
+ *
+ * 한국어 사용자는 대개 로케일이 ko_KR 이라 그대로 한국어를 보고, 로케일이 C/en 인
+ * 서버에서 한국어를 원하면 ROOTR_LANG=ko 를 주면 된다.
+ */
+
+function detect() {
+  const explicit = (process.env.ROOTR_LANG || '').trim().toLowerCase();
+  if (explicit.startsWith('ko')) return 'ko';
+  if (explicit.startsWith('en')) return 'en';
+  const locale = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || '';
+  return locale.toLowerCase().startsWith('ko') ? 'ko' : 'en';
+}
+
+let cached = null;
+
+export function lang() {
+  if (cached === null) cached = detect();
+  return cached;
+}
+
+/** 테스트에서 언어를 고정할 때만 쓴다. */
+export function setLang(value) {
+  cached = value === null ? null : value;
+}
+
+/** t('한국어', 'English') — 현재 언어에 맞는 쪽을 돌려준다. */
+export function t(ko, en) {
+  return lang() === 'ko' ? ko : en;
+}

package/lib/mcp-tools/memory.js

@@ -2,6 +2,25 @@ import { z } from 'zod';
 
 import { jsonResult, textResult, errorResult, makeClient } from './shared.js';
 
+/**
+ * 저장되는 값은 한국어 네 가지로 고정 — 화면·CLI·이미 쌓인 행이 전부 그 값을 쓴다.
+ * 도구 설명은 전부 영어인데 이 enum만 한국어라 영어권 에이전트가 걸려 넘어졌다.
+ * 입력만 영어로 받아 한국어로 바꿔 넘긴다(저장·출력은 그대로).
+ */
+const MEMORY_KIND_ALIASES = {
+  instruction: '지시',
+  person: '사람',
+  people: '사람',
+  project: '프로젝트',
+  reference: '참고',
+  ref: '참고',
+};
+
+const MEMORY_KIND = z.preprocess(
+  (v) => (typeof v === 'string' ? (MEMORY_KIND_ALIASES[v.trim().toLowerCase()] ?? v) : v),
+  z.enum(['지시', '사람', '프로젝트', '참고']),
+);
+
 /**
  * MEM-001 — 에이전트 메모리.
  *
@@ -52,12 +71,13 @@ export function registerMemoryTools(server) {
               'what you do next time. Required for a new memory; may be omitted with `memoryId` to edit ' +
               'only kind/source/related.',
           ),
-        kind: z
-          .enum(['지시', '사람', '프로젝트', '참고'])
+        kind: MEMORY_KIND
           .optional()
           .describe(
-            'What kind of fact: 지시 = how the team wants work done, 사람 = someone\'s role/preference, ' +
-              '프로젝트 = ongoing work or constraints, 참고 = a pointer to an external resource',
+            'What kind of fact. Korean values are canonical and what gets stored; the English aliases in ' +
+              'parentheses are accepted and normalized. 지시 (instruction) = how the team wants work done, ' +
+              '사람 (person) = someone\'s role/preference, 프로젝트 (project) = ongoing work or constraints, ' +
+              '참고 (reference) = a pointer to an external resource',
           ),
         source: z
           .string()
@@ -122,7 +142,7 @@ export function registerMemoryTools(server) {
           .string()
           .optional()
           .describe('Optional keyword filter. Omit to get everything — the list is meant to be read whole.'),
-        kind: z.enum(['지시', '사람', '프로젝트', '참고']).optional().describe('Only this kind'),
+        kind: MEMORY_KIND.optional().describe('Only this kind (English aliases accepted)'),
         limit: z.number().optional().describe('Max memories to return'),
         workspace: z
           .string()

package/lib/mcp.js

@@ -24,6 +24,7 @@ import { registerFeedbackTools } from './mcp-tools/feedback.js';
 import { registerMemoryTools } from './mcp-tools/memory.js';
 import { withRateLimitSink } from './context.js';
 import { makeClient } from './mcp-tools/shared.js';
+import { t as tr } from './i18n.js';
 
 /** Warn once the workspace has burned this share of its quota. */
 const QUOTA_WARN_AT = 0.8;
@@ -32,12 +33,18 @@ function quotaNotice({ limit, remaining, window, upgradeUrl }) {
   if (!Number.isFinite(limit) || !Number.isFinite(remaining) || limit <= 0) return null;
   if (remaining <= 0) return null; // already blocked — the 429 says it better
   if (remaining > Math.ceil(limit * (1 - QUOTA_WARN_AT))) return null;
-  const per = window === 'day' ? '오늘' : '이번 시간';
-  const refill = window === 'day' ? '내일 자정(KST)' : '다음 정시';
-  return (
+  const per = tr(window === 'day' ? '오늘' : '이번 시간', window === 'day' ? 'today' : 'this hour');
+  const refill = tr(
+    window === 'day' ? '내일 자정(KST)' : '다음 정시',
+    window === 'day' ? 'midnight KST' : 'the top of the next hour',
+  );
+  return tr(
     `\n\n⚠️ ${per} 남은 조회 ${remaining}/${limit}회. ` +
-    `다 쓰면 ${refill}까지 조회가 멈춥니다` +
-    (upgradeUrl ? `. 한도를 늘리려면: ${upgradeUrl}` : '.')
+      `다 쓰면 ${refill}까지 조회가 멈춥니다` +
+      (upgradeUrl ? `. 한도를 늘리려면: ${upgradeUrl}` : '.'),
+    `\n\n⚠️ ${remaining}/${limit} reads left ${per}. ` +
+      `Once they run out, reads pause until ${refill}` +
+      (upgradeUrl ? `. To raise the limit: ${upgradeUrl}` : '.'),
   );
 }
 
@@ -95,16 +102,21 @@ function memoryBriefing(memories) {
   if (!live.length) return null;
   const line = (m) => {
     const flags = [];
-    if (m.status === '확인필요') flags.push('확인필요');
+    if (m.status === '확인필요') flags.push(tr('확인필요', 'needs review'));
     const tail = flags.length ? ` [${flags.join('·')}]` : '';
-    const src = m.source ? ` (출처: ${m.source})` : '';
+    const src = m.source ? tr(` (출처: ${m.source})`, ` (source: ${m.source})`) : '';
     return `- ${m.content}${tail}${src}`;
   };
-  return (
+  const body = live.map(line).join('\n');
+  return tr(
     `\n\n---\n🧠 이 워크스페이스가 이미 아는 것 (${live.length}건) — 일을 시작하기 전에 읽으세요.\n` +
-    live.map(line).join('\n') +
-    `\n"확인필요"는 출처 문서가 바뀌었다는 뜻입니다 — 맞는지 확인하고 쓰세요.\n` +
-    `새로 알게 된 규칙·결정·함정이 있으면 rootr_remember로 한 줄 남겨 두세요.`
+      body +
+      `\n"확인필요"는 출처 문서가 바뀌었다는 뜻입니다 — 맞는지 확인하고 쓰세요.\n` +
+      `새로 알게 된 규칙·결정·함정이 있으면 rootr_remember로 한 줄 남겨 두세요.`,
+    `\n\n---\n🧠 What this workspace already knows (${live.length}) — read this before starting work.\n` +
+      body +
+      `\n"needs review" means the source document changed — check it before relying on it.\n` +
+      `When you learn a new rule, decision or gotcha, leave one line with rootr_remember.`,
   );
 }
 

package/lib/resolve.js

@@ -1,4 +1,5 @@
 import { RootrApiError } from './client.js';
+import { t as tr } from './i18n.js';
 
 /**
  * Web-app route segments that address a single node: rootr.io/{locale?}/w/{ws}/{kind}/{id}
@@ -43,19 +44,34 @@ export async function resolveTarget(client, target) {
   const url = parseRootrUrl(target);
   if (url) {
     if (!url.nodeId) {
-      throw new RootrApiError(`이 주소는 문서가 아니라 워크스페이스 화면을 가리킵니다: ${target}`, {
-        hint: `해당 워크스페이스로 전환하려면 rootr_use_workspace 에 ${url.workspaceId} 를 넘기세요.`,
+      throw new RootrApiError(
+        tr(
+          `이 주소는 문서가 아니라 워크스페이스 화면을 가리킵니다: ${target}`,
+          `This URL points at a workspace screen, not a document: ${target}`,
+        ),
+        {
+        hint: tr(
+          `해당 워크스페이스로 전환하려면 rootr_use_workspace 에 ${url.workspaceId} 를 넘기세요.`,
+          `To switch to that workspace, pass ${url.workspaceId} to rootr_use_workspace.`,
+        ),
       });
     }
     // The URL carries the workspace it lives in, so a mismatch is knowable
     // BEFORE the API answers 404 — say so instead of letting it look missing.
     if (client.workspace && url.workspaceId !== client.workspace) {
       throw new RootrApiError(
-        `이 주소는 다른 워크스페이스(${url.workspaceId})의 노드입니다. 현재 활성 워크스페이스는 ${client.workspace} 입니다.`,
+        tr(
+          `이 주소는 다른 워크스페이스(${url.workspaceId})의 노드입니다. 현재 활성 워크스페이스는 ${client.workspace} 입니다.`,
+          `This URL is a node in another workspace (${url.workspaceId}). The active workspace is ${client.workspace}.`,
+        ),
         {
           hint:
-            `먼저 rootr_use_workspace 로 ${url.workspaceId} 로 전환하세요. ` +
-            '전환이 안 되면 그 워크스페이스에 쓸 수 있는 키가 없는 것입니다 (rootr_workspaces 로 확인).',
+            tr(
+              `먼저 rootr_use_workspace 로 ${url.workspaceId} 로 전환하세요. ` +
+                '전환이 안 되면 그 워크스페이스에 쓸 수 있는 키가 없는 것입니다 (rootr_workspaces 로 확인).',
+              `Switch to ${url.workspaceId} with rootr_use_workspace first. ` +
+                'If the switch fails, you have no key that opens that workspace (check with rootr_workspaces).',
+            ),
         },
       );
     }
@@ -76,7 +92,7 @@ export async function resolveTarget(client, target) {
 
 export function requireResolved(resolved) {
   if (!resolved.existed || !resolved.id) {
-    throw new RootrApiError(`경로를 찾을 수 없습니다: ${resolved.path}`);
+    throw new RootrApiError(tr(`경로를 찾을 수 없습니다: ${resolved.path}`, `Path not found: ${resolved.path}`));
   }
   return resolved.id;
 }
@@ -107,13 +123,13 @@ export async function resolveMoveDestination(client, dest) {
     return { parentId: existingNode.id };
   }
   if (trailingSlash) {
-    throw new RootrApiError(`대상 폴더를 찾을 수 없습니다: ${destPath}`);
+    throw new RootrApiError(tr(`대상 폴더를 찾을 수 없습니다: ${destPath}`, `Destination folder not found: ${destPath}`));
   }
 
   const lastSlash = destPath.lastIndexOf('/');
   const parentPath = lastSlash > 0 ? destPath.slice(0, lastSlash) : '';
   const name = destPath.slice(lastSlash + 1);
-  if (!name) throw new RootrApiError(`잘못된 대상 경로: ${dest}`);
+  if (!name) throw new RootrApiError(tr(`잘못된 대상 경로: ${dest}`, `Invalid destination path: ${dest}`));
 
   if (!parentPath) {
     return { parentId: null, name };
@@ -121,7 +137,7 @@ export async function resolveMoveDestination(client, dest) {
   const parent = await client.getNodeByPath(parentPath);
   const parentNode = parent && (parent.node || parent);
   if (!parentNode) {
-    throw new RootrApiError(`대상 폴더를 찾을 수 없습니다: ${parentPath}`);
+    throw new RootrApiError(tr(`대상 폴더를 찾을 수 없습니다: ${parentPath}`, `Destination folder not found: ${parentPath}`));
   }
   return { parentId: parentNode.id, name };
 }

package/package.json

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