@runlot/api 0.1.0-rc.73 → 0.1.0-rc.75

package/dist/index.js

@@ -1,5 +1,5 @@
 export const API_VERSION = "v1";
-/** 브라우즈의 공통 질의. 빈 값은 안 싣는다 — 서버가 "비면 기본" 으로 읽는다. */
+/** The shared query for browsing. Empty values are not carried — the server reads "empty means default". */
 function gitQuery(ref, path) {
     const q = new URLSearchParams();
     if (ref !== "")
@@ -8,7 +8,7 @@ function gitQuery(ref, path) {
         q.set("path", path);
     return q.size > 0 ? `?${q.toString()}` : "";
 }
-/** 서버가 돌려준 오류 봉투를 그대로 들고 있는 예외. */
+/** The exception that carries the server's error envelope unchanged. */
 export class ApiError extends Error {
     status;
     code;
@@ -23,10 +23,11 @@ export class ApiError extends Error {
     }
 }
 /**
- * cp-public 클라이언트.
+ * The cp-public client.
  *
- * CLI와 대시보드가 같은 것을 쓴다. 각자 fetch를 부르면 오류 해석이 조금씩
- * 달라지고, 그 차이는 장애 중에 드러난다.
+ * The CLI and the dashboard use the same one. If each called fetch itself, their
+ * error handling would drift a little, and that difference shows up during an
+ * incident.
  */
 function dbPath(org, name) {
     return `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/database`;
@@ -54,13 +55,15 @@ export class Client {
                 body = (await res.json());
             }
             catch {
-                // 오류 응답이 JSON이 아닌 경우(프록시가 만든 502 등)도 같은 예외로
-                // 올린다 — 호출부가 두 가지 실패 모양을 다루지 않게.
+                // An error response that is not JSON (a 502 made by a proxy, for instance)
+                // is raised as the same exception — so the caller does not have to handle
+                // two shapes of failure.
             }
             if (body === undefined && res.status >= 502 && res.status <= 504) {
-                // 엣지가 5xx 의 본문을 자기 HTML 로 바꿨다. 서버가 적은 code·이유는 여기
-                // 없다 — "unknown" 대신 그 사실을 말한다. 2026-09-10 에 등록기관 거절이
-                // 이 모양으로 "unknown: POST … → 502" 가 됐다.
+                // The edge replaced the 5xx body with its own HTML. The code and reason
+                // the server wrote are not here — so say that, rather than "unknown". On
+                // 2026-09-10 a registrar rejection came out this way as
+                // "unknown: POST … → 502".
                 body = {
                     error: {
                         code: "edge_" + res.status,
@@ -74,7 +77,7 @@ export class Client {
             return undefined;
         return (await res.json());
     }
-    /** JSON 이 아닌 본문 (메일 원문). 오류 처리는 request 와 같다. */
+    /** A body that is not JSON (the raw mail). Error handling is the same as request. */
     async text(method, path) {
         const res = await fetch(new URL(path, this.opts.baseUrl), { method, headers: this.headers() });
         if (!res.ok) {
@@ -83,7 +86,7 @@ export class Client {
                 body = (await res.json());
             }
             catch {
-                // request 와 같은 이유
+                // The same reason as in request
             }
             throw new ApiError(res.status, body, `${method} ${path} → ${res.status}`);
         }
@@ -101,8 +104,9 @@ export class Client {
         return this.json("POST", "/v1/auth/dev/login", { subject });
     }
     /**
-     * 가입을 받아 확인 메일을 보낸다. 세션도 비밀번호도 여기서 생기지 않는다 —
-     * 비밀번호는 메일함을 여는 사람이 `verifyEmail` 에서 고른다.
+     * Takes the sign-up and sends the confirmation mail. Neither a session nor a
+     * password is created here — the password is chosen in `verifyEmail` by
+     * whoever opens the mailbox.
      */
     passwordSignUp(email, name) {
         return this.json("POST", "/v1/auth/password/sign-up", {
@@ -113,38 +117,40 @@ export class Client {
     passwordSignIn(email, password) {
         return this.json("POST", "/v1/auth/password/sign-in", { email, password });
     }
-    /** 이메일 존재 여부와 무관하게 같은 accepted 응답을 받는다. */
+    /** The same accepted response comes back whether or not the email exists. */
     passwordForgot(email) {
         return this.json("POST", "/v1/auth/password/forgot", { email });
     }
     passwordReset(token, password) {
         return this.json("POST", "/v1/auth/password/reset", { token, password });
     }
-    /** 확인 링크를 쓰면서 계정의 첫 비밀번호를 정한다. */
+    /** Uses the confirmation link and sets the account's first password. */
     verifyEmail(token, password) {
         return this.json("POST", "/v1/auth/email/verify", { token, password });
     }
     /**
-     * GitHub OAuth 시작 URL. 브라우저가 따라가는 302 라 fetch 로 부르지 않고
-     * `window.location` 에 넣는다. `redirect` 는 서버 허용 목록에 있어야 한다.
+     * The GitHub OAuth start URL. It is a 302 the browser follows, so it goes into
+     * `window.location` rather than being called with fetch. `redirect` has to be
+     * on the server's allow-list.
      */
     githubStartUrl(redirect) {
         const u = new URL("/v1/auth/github/start", this.opts.baseUrl);
         u.searchParams.set("redirect", redirect);
         return u.toString();
     }
-    /** Google OAuth 시작 URL. GitHub 과 같은 대시보드 콜백 모양을 쓴다. */
+    /** The Google OAuth start URL. Uses the same dashboard callback shape as GitHub. */
     googleStartUrl(redirect) {
         const u = new URL("/v1/auth/google/start", this.opts.baseUrl);
         u.searchParams.set("redirect", redirect);
         return u.toString();
     }
     /**
-     * 이 배치의 이름들 (앱 도메인·문서 주소). 인증 없이 부를 수 있다.
+     * The names of this deployment (app domain, docs address). Callable without auth.
      *
-     * 대시보드가 화면에 도메인을 박지 않기 위한 자리다 (docs/environments.md
-     * §3.2) — 박아 두면 dev 화면이 프로덕션 주소를 안내하고, 그 안내는 열리기
-     * 때문에 아무도 틀렸다고 말해 주지 않는다.
+     * This exists so the dashboard does not hard-code a domain into the screen
+     * (docs/environments.md §3.2) — hard-coded, the dev screen tells people a
+     * production address, and because that address opens, nobody ever says it is
+     * wrong.
      */
     siteConfig() {
         return this.json("GET", "/v1/config");
@@ -155,21 +161,22 @@ export class Client {
     listOrgs() {
         return this.json("GET", "/v1/orgs");
     }
-    /** 표시 이름만 바꾼다 (admin). 슬러그는 주소가 되는 이름이라 이 표면에 없다. */
+    /** Changes the display name only (admin). The slug is the name that becomes an address, so it is not on this surface. */
     updateOrg(org, name) {
         return this.json("PATCH", `/v1/orgs/${encodeURIComponent(org)}`, { name });
     }
     /**
-     * 조직을 지운다 (admin). **되돌릴 수 없다.**
+     * Deletes the organization (admin). **This cannot be undone.**
      *
-     * `confirm` 은 조직 슬러그 그대로여야 한다 — 확인이 서버에 있는 이유는
-     * 이 표면을 부르는 곳이 셋(화면·CLI·스크립트)이기 때문이다. 살아 있는
-     * 프로젝트·도메인·저장소·DNS 존이 남아 있으면 409 `org_not_empty` 이고
-     * `details.holdings` 가 무엇이 남았는지 말한다 — **이미 지운 프로젝트는
-     * 세지 않는다.**
+     * `confirm` has to be the organization slug exactly — the confirmation lives on
+     * the server because three places call this surface (the screen, the CLI, and
+     * scripts). If a live project, domain, repository, or DNS zone is left, it is a
+     * 409 `org_not_empty` and `details.holdings` says what is left — **projects
+     * already deleted are not counted.**
      *
-     * 답의 `purgeAfter` 는 행이 실제로 사라지는 시각이다. 돌아온 순간 조직은
-     * 이미 모든 표면에서 사라졌고, 남은 것은 그 시각까지의 보존이다.
+     * The `purgeAfter` in the answer is when the rows actually disappear. By the
+     * moment it returns the organization is already gone from every surface; what
+     * remains is retention until that time.
      */
     deleteOrg(org, confirm) {
         return this.json("DELETE", `/v1/orgs/${encodeURIComponent(org)}`, { confirm });
@@ -178,38 +185,40 @@ export class Client {
         return this.json("POST", "/v1/orgs", { slug, name });
     }
     /**
-     * org 의 최근 알림 (docs/limits.md §3.4).
+     * The organization's recent notifications (docs/limits.md §3.4).
      *
-     * `sentAt` 이 없는 행은 아직 큐에 있거나 받을 이메일이 없는 것이다 — 후자에게
-     * 이 목록이 유일한 통로라, 화면은 두 상태를 같게 그린다.
+     * A row with no `sentAt` is either still queued or has no email address to
+     * reach — and for the second, this list is the only channel, so the screen
+     * draws both states the same way.
      */
     listNotifications(org, limit) {
         const q = limit === undefined ? "" : `?limit=${limit}`;
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/notifications${q}`);
     }
     /**
-     * 요금제와 결제 상태 (docs/billing.md). `enabled` 가 거짓이면 이 배치에 결제가
-     * 없다 — 화면은 문의 주소만 둔다.
+     * The plan and billing state (docs/billing.md). If `enabled` is false, this
+     * deployment has no billing — the screen shows only a contact address.
      */
     getBilling(org) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/billing`);
     }
     /**
-     * 프로 체크아웃 세션. 돌아온 `url` 로 브라우저를 보낸다. 결제가 끝나도 요금제를
-     * 바꾸는 것은 웹훅이라, 돌아온 뒤 `getBilling` 을 다시 읽는다.
+     * A Pro checkout session. Send the browser to the `url` that comes back. Even
+     * once payment finishes, the thing that changes the plan is the webhook, so
+     * read `getBilling` again after the browser returns.
      */
     createBillingCheckout(org, returnTo) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/billing/checkout`, { returnTo });
     }
-    /** 고객 포털(결제 수단·영수증·해지)의 일회용 `url`. */
+    /** A one-time `url` for the customer portal (payment method, receipts, cancellation). */
     createBillingPortal(org, returnTo) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/billing/portal`, { returnTo });
     }
-    /** 결제 수단 임베드의 고객 세션 토큰 (1 시간). 결제 이력 없는 org 는 404. */
+    /** The customer session token for the payment-method embed (1 hour). An org with no payment history gets a 404. */
     createBillingSession(org) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/billing/session`, {});
     }
-    /** 기간 끝 해지 예약(`cancel: true`) 또는 되돌리기. 즉시 회수는 없다. */
+    /** Schedules cancellation at the end of the period (`cancel: true`), or undoes it. There is no immediate revocation. */
     cancelBilling(org, body) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/billing/cancel`, body);
     }
@@ -223,35 +232,37 @@ export class Client {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}`);
     }
     /**
-     * 프로젝트 이름을 바꾼다 (admin). **기본 주소도 함께 움직이고 별칭은 없다** —
-     * 응답이 새 주소를 싣는 이유다. org 슬러그와 달리 바꿀 수 있는 이유는
-     * 그 이름이 org 와일드카드 인증서의 안쪽 라벨이기 때문이다.
+     * Renames the project (admin). **The default address moves with it and there is
+     * no alias** — which is why the response carries the new address. Unlike the
+     * org slug, this name can change because it is the inner label of the org
+     * wildcard certificate.
      */
     updateProject(org, name, next) {
         return this.json("PATCH", this.projectPath(org, name), { name: next });
     }
     /**
-     * 프로젝트 종결을 시작한다 (admin). **되돌릴 수 없고 복구 세대를 남기지
-     * 않는다.** `confirm` 은 프로젝트 이름 그대로여야 한다.
+     * Starts tearing the project down (admin). **This cannot be undone and leaves
+     * no recovery generation.** `confirm` has to be the project name exactly.
      */
     deleteProject(org, name, confirm) {
         return this.json("DELETE", this.projectPath(org, name), { confirm });
     }
-    /** 프로젝트가 사라진 뒤에도 종결 연산의 끝을 본다. */
+    /** Watches the teardown operation to its end even after the project is gone. */
     getOrgOperation(org, opId) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/operations/${encodeURIComponent(opId)}`);
     }
-    /** 프로젝트 첫 화면이 한 번에 받는 것. 사용량은 `getUsage` 를 나란히 부른다. */
+    /** Everything the project's first screen takes in one call. Usage calls `getUsage` alongside it. */
     getProjectOverview(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/overview`);
     }
     listDeployments(org, name) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/deployments`);
     }
-    /** 본문이 곧 번들이다. 다이제스트 하나가 코드와 자산 전부를 덮는다. */
+    /** The body is the bundle. One digest covers all of the code and the assets. */
     /**
-     * 번들을 올린다. `headers` 는 출처 헤더다 (`X-Runlot-Git-*`, openapi
-     * createDeployment) — 본문이 번들 그 자체라 메타는 헤더로만 간다.
+     * Uploads the bundle. `headers` carries the provenance headers
+     * (`X-Runlot-Git-*`, openapi createDeployment) — the body is the bundle
+     * itself, so the metadata can only travel in headers.
      */
     deploy(org, name, bundle, headers = {}) {
         return this.request("POST", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/deployments`, {
@@ -259,7 +270,7 @@ export class Client {
             headers: { ...headers, "Content-Type": "application/gzip" },
         });
     }
-    /** 멱등이다. 두 번 불러도 비밀번호는 굴지 않고 같은 접속 정보가 온다. */
+    /** Idempotent. Called twice, the password is not rolled and the same connection details come back. */
     createDatabase(org, name) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/database`);
     }
@@ -267,17 +278,18 @@ export class Client {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/database`);
     }
     /**
-     * 접속 자격까지. `getDatabase` 와 라우트가 갈린 것은 역할 때문이다 —
-     * viewer 는 여부를 알아도 되지만 비밀번호는 아니다 (proto/openapi.yaml).
+     * The connection credentials as well. The route is split from `getDatabase`
+     * because of roles — a viewer may know whether there is a database, but not
+     * the password (proto/openapi.yaml).
      */
     getDatabaseConnect(org, name) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/database/connect`);
     }
-    /** 접속 끝점만 — 자격 없음. viewer 도 받는다. `runlot port-forward` 가 쓴다. */
+    /** The endpoint only — no credentials. A viewer gets it too. Used by `runlot port-forward`. */
     getDatabaseEndpoint(org, name) {
         return this.json("GET", `${dbPath(org, name)}/endpoint`);
     }
-    /** 단기 기계 자격 발급. 비밀번호는 이 응답에만 실린다. */
+    /** Issues a short-lived machine credential. The password is carried in this response and nowhere else. */
     createDatabaseToken(org, name, ttlSeconds) {
         return this.json("POST", `${dbPath(org, name)}/tokens`, ttlSeconds === undefined ? {} : { ttlSeconds });
     }
@@ -288,61 +300,65 @@ export class Client {
         return this.json("DELETE", `${dbPath(org, name)}/tokens/${encodeURIComponent(user)}`);
     }
     /**
-     * 진단 이미지를 하나 만든다.
+     * Makes one diagnostic image.
      *
-     * **멱등이 아니다** — 부를 때마다 이미지가 하나 생긴다. 그리고 느리다:
-     * 응답은 덤프가 끝난 뒤에 오고, 그동안 그 프로젝트의 액터는 붙잡혀 있다
-     * (proto/openapi.yaml).
+     * **Not idempotent** — every call makes another image. And it is slow: the
+     * response comes after the dump finishes, and that project's actor is held
+     * for the whole of it (proto/openapi.yaml).
      */
     exportDatabase(org, name) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/database/export`);
     }
     /**
-     * 복원이 고를 수 있는 세대 전부. 최신 순이고, `lastCheckedAt` 은 무변경
-     * 스킵의 하트비트다 — 세대가 늘지 않는 것과 백업이 죽은 것을 가른다.
+     * Every generation a restore can choose, newest first. `lastCheckedAt` is the
+     * heartbeat of the no-change skip — it is what tells "no new generations"
+     * apart from "the backup is dead".
      */
     listGenerations(org, name) {
         return this.json("GET", `${this.dbPath(org, name)}/generations`);
     }
     /**
-     * 세대로 되돌린다. **그 사이의 쓰기는 사라진다.**
+     * Rolls back to a generation. **Writes made since then are lost.**
      *
-     * 202 로 끝난다 — 돌아오는 것은 연산 id 이고, 진행은
-     * `getDatabaseOperation` 으로 본다. `latest` 는 서버가 풀지 않는다:
-     * 목록에서 고른 `(epoch, seq)` 를 그대로 싣는다 (proto/openapi.yaml).
+     * It ends at 202 — what comes back is an operation id, and progress is read
+     * through `getDatabaseOperation`. The server does not resolve `latest`: the
+     * `(epoch, seq)` chosen from the list is carried as-is (proto/openapi.yaml).
      */
     restoreDatabase(org, name, epoch, seq) {
         return this.json("POST", `${this.dbPath(org, name)}/restore`, { epoch, seq });
     }
     /**
-     * 백업 **안**의 복원점으로 되돌린다 (pg-feather docs/37): `txnId` 는 그 커밋,
-     * `at` 은 그 시각 이하의 마지막 커밋. 백업 하나가 그 사이의 커밋을 순서대로
-     * 담으므로 되돌릴 자리가 백업 경계에 묶이지 않는다. 그 밖은 restoreDatabase 와
-     * 같다 — 202, 연산 id, 되돌리기 전에 안전 백업 하나.
+     * Rolls back to a restore point **inside** a backup (pg-feather docs/37):
+     * `txnId` is that commit, `at` is the last commit at or before that time. One
+     * backup carries the commits in between in order, so the place you can roll
+     * back to is not tied to a backup boundary. Everything else is as in
+     * restoreDatabase — 202, an operation id, and one safety backup before the
+     * rollback.
      */
     restoreDatabaseTo(org, name, target) {
         return this.json("POST", `${this.dbPath(org, name)}/restore`, target);
     }
     /**
-     * 데이터베이스를 없앤다. `confirm` 은 프로젝트 이름과 **정확히** 같아야
-     * 하고, 다르면 서버가 400 `confirm_mismatch` 로 거절한다.
+     * Removes the database. `confirm` has to match the project name **exactly**;
+     * if it does not, the server refuses with 400 `confirm_mismatch`.
      */
     deleteDatabase(org, name, confirm) {
         return this.json("POST", `${this.dbPath(org, name)}/delete`, { confirm });
     }
-    /** 연산 하나의 진행. 연산 id 는 자격이 아니라 프로젝트 경로 아래에 있다. */
+    /** The progress of one operation. The operation id is not a credential; it lives under the project path. */
     getDatabaseOperation(org, name, opId) {
         return this.json("GET", `${this.dbPath(org, name)}/operations/${encodeURIComponent(opId)}`);
     }
-    /** 되돌릴 수 없는 phase 앞의 연산을 중단한다. */
+    /** Aborts an operation that has not yet reached a phase it cannot come back from. */
     abortDatabaseOperation(org, name, opId) {
         return this.json("POST", `${this.dbPath(org, name)}/operations/${encodeURIComponent(opId)}/abort`);
     }
     // ---- Phase 6 (docs/phase6.md) ----
     /**
-     * 로그 라이브 테일. **JSON 이 아니라 스트림**이라 `request` 를 안 지난다 —
-     * 돌려주는 것은 줄 단위 `LogEvent` 의 async iterable 이고, `signal` 을 abort
-     * 하면 연결이 끊긴다. 오류 응답(4xx/5xx)은 다른 메서드와 같은 `ApiError` 다.
+     * A live tail of the logs. It is **a stream, not JSON**, so it does not go
+     * through `request` — what comes back is an async iterable of line-by-line
+     * `LogEvent`, and aborting `signal` closes the connection. An error response
+     * (4xx/5xx) is the same `ApiError` as in every other method.
      */
     async *tailLogs(org, name, opts = {}) {
         const q = new URLSearchParams();
@@ -362,7 +378,7 @@ export class Client {
                 body = (await res.json());
             }
             catch {
-                // 위의 request 와 같은 이유.
+                // The same reason as in request above.
             }
             throw new ApiError(res.status, body, `GET ${path} → ${res.status}`);
         }
@@ -390,14 +406,14 @@ export class Client {
                 yield JSON.parse(rest);
         }
         finally {
-            // 소비자가 일찍 끝내면(break) 서버 쪽 follow 도 끝나야 한다.
+            // If the consumer ends early (break), the server's follow has to end too.
             await reader.cancel().catch(() => { });
         }
     }
     listSecrets(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/secrets`);
     }
-    /** 값은 이 호출로만 나간다. 어떤 응답에도 값은 없다. */
+    /** The value travels in this call only. It is in no response at all. */
     setSecret(org, name, secret, value) {
         return this.json("PUT", `${this.projectPath(org, name)}/secrets/${encodeURIComponent(secret)}`, { value });
     }
@@ -408,64 +424,66 @@ export class Client {
         const q = hours === undefined ? "" : `?hours=${hours}`;
         return this.json("GET", `${this.projectPath(org, name)}/usage${q}`);
     }
-    // ---- 오브젝트 스토리지 (docs/storage.md §8) ----
-    /** 부여 여부·접두·쿼터·사용량. `usedBytes` 는 노드 보고 주기만큼 늦다. */
+    // ---- Object storage (docs/storage.md §8) ----
+    /** Grant, prefix, quota, usage. `usedBytes` lags by the node's reporting interval. */
     getStorage(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/storage`);
     }
     /**
-     * 스토리지를 부여한다. 멱등이라 두 번 눌러도 접두는 그대로다. 접두·쿼터를
-     * 인자로 받지 않는 것이 요점이다 — 접두는 격리의 경계이고 쿼터는 요금제가
-     * 정한다 (proto/openapi.yaml).
+     * Grants storage. It is idempotent, so pressing twice leaves the prefix as it
+     * was. Taking neither the prefix nor the quota as an argument is the point —
+     * the prefix is the isolation boundary and the quota is set by the plan
+     * (proto/openapi.yaml).
      */
     grantStorage(org, name) {
         return this.json("POST", `${this.projectPath(org, name)}/storage`);
     }
-    /** 부여를 뗀다. **객체는 지워지지 않는다** (docs/storage.md §7). */
+    /** Removes the grant. **The objects are not deleted** (docs/storage.md §7). */
     revokeStorage(org, name) {
         return this.json("DELETE", `${this.projectPath(org, name)}/storage`);
     }
-    // ---- 이메일 (docs/email.md §5) ----
-    /** 부여 여부·주소·발신자·상한·최근 계수. 부여가 없어도 주소는 안내값으로 온다. */
+    // ---- Email (docs/email.md §5) ----
+    /** Grant, address, sender, limits, recent counts. The address comes back as a preview even without a grant. */
     getEmail(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/email`);
     }
-    /** 켠다. **멱등**이다 — 주소는 우리가 정한다. 배포가 `"email": true` 를 읽고 부른다. */
+    /** Turns it on. **Idempotent** — we choose the address. The deploy reads `"email": true` and calls this. */
     grantEmail(org, name) {
         return this.json("POST", `${this.projectPath(org, name)}/email`);
     }
-    /** 끈다. 그 주소로 오는 메일은 이제 550 이다. */
+    /** Turns it off. Mail arriving at that address now gets a 550. */
     revokeEmail(org, name) {
         return this.json("DELETE", `${this.projectPath(org, name)}/email`);
     }
     // ---- AI (docs/ai.md §6) ----
     /**
-     * 모델 카탈로그. **로그인만 하면 볼 수 있다** — 무엇을 살 수 있는지는 org 의
-     * 비밀이 아니고, 이 목록이 곧 가격표다.
+     * The model catalogue. **Being logged in is enough to see it** — what you can
+     * buy is not an organization's secret, and this list is the price table.
      *
-     * 단가는 100 만 토큰당 **마이크로센트** 정수다 (1 µ¢ = 1e-8 USD). 소수 자리를
-     * 서버가 정하지 않는 것이 요점이다 — 작은 호출이 센트로 반올림하면 0 이 된다.
+     * Prices are integer **micro-cents** per million tokens (1 µ¢ = 1e-8 USD).
+     * Not letting the server pick the decimal place is the point — a small call
+     * rounded to cents becomes 0.
      */
     listAIModels() {
         return this.json("GET", "/v1/ai/models");
     }
-    /** 부여 여부·상한·org 잔액·24 h 사용량. 부여가 없어도 상한은 안내값으로 온다. */
+    /** Grant, limits, the org balance, 24 h usage. The limits come back as a preview even without a grant. */
     getAI(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/ai`);
     }
-    /** 켠다. **멱등**이다. 배포가 `"ai": true` 를 읽고 부른다. */
+    /** Turns it on. **Idempotent.** The deploy reads `"ai": true` and calls this. */
     grantAI(org, name) {
         return this.json("POST", `${this.projectPath(org, name)}/ai`);
     }
-    /** 끈다. **원장과 잔액은 그대로다** — 잔액은 org 의 것이고 부여는 프로젝트의 것이다. */
+    /** Turns it off. **The ledger and the balance are untouched** — the balance belongs to the org and the grant belongs to the project. */
     revokeAI(org, name) {
         return this.json("DELETE", `${this.projectPath(org, name)}/ai`);
     }
-    /** org 크레딧 잔액과 자동 충전 설정. 잔액은 마이크로센트이고 음수일 수 있다. */
+    /** The org's credit balance and its automatic top-up settings. The balance is in micro-cents and can be negative. */
     getAICredit(org) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/ai/credit`);
     }
-    /** org 원장 한 장. 커서는 `ledger_id` — 시각으로 자르면 같은 밀리초가 갈린다. */
+    /** One page of the org ledger. The cursor is `ledger_id` — cutting on time splits the same millisecond. */
     listAILedger(org, opts = {}) {
         const q = new URLSearchParams();
         if (opts.limit)
@@ -476,20 +494,22 @@ export class Client {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/ai/ledger${qs ? "?" + qs : ""}`);
     }
     /**
-     * 크레딧 충전 체크아웃. **돌아온 브라우저는 증거가 아니다** — 잔액을 올리는
-     * 것은 `order.paid` 웹훅 하나이고, 화면은 성공 사건 뒤에 잔액을 폴링한다.
+     * The credit top-up checkout. **A browser coming back is not evidence** — the
+     * one thing that raises the balance is the `order.paid` webhook, and the
+     * screen polls the balance after the success event.
      */
     createAICreditCheckout(org, microCents, returnTo) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/ai/credit/checkout`, { microCents, returnTo });
     }
     /**
-     * 자동 충전을 켜거나 끈다. **켜는 것은 명시 동의다** (docs/ai.md §3.5) — 화면이
-     * 청구 조건을 그대로 보여 주고 체크를 받은 뒤에만 부른다.
+     * Turns automatic top-up on or off. **Turning it on is explicit consent**
+     * (docs/ai.md §3.5) — the screen shows the charging terms verbatim and calls
+     * this only after the box is checked.
      */
     setAIAutoTopup(org, body) {
         return this.json("PUT", `/v1/orgs/${encodeURIComponent(org)}/ai/autotopup`, body);
     }
-    /** 메일 로그 한 장 (docs/email.md §6.1). 시각 역순, 커서. */
+    /** One page of the mail log (docs/email.md §6.1). Newest first, cursor-paged. */
     listMailLog(org, name, opts = {}) {
         const q = new URLSearchParams();
         if (opts.direction)
@@ -501,106 +521,118 @@ export class Client {
         const qs = q.toString();
         return this.json("GET", `${this.projectPath(org, name)}/email/log${qs ? "?" + qs : ""}`);
     }
-    /** 메일 한 통의 메타. */
+    /** The metadata of one message. */
     getMailLog(org, name, mailId) {
         return this.json("GET", `${this.projectPath(org, name)}/email/log/${encodeURIComponent(mailId)}`);
     }
-    /** 원문의 URL — 화면이 내려받기 링크로 쓴다 (.eml). */
+    /** The URL of the raw message — the screen uses it as a download link (.eml). */
     mailLogRawURL(org, name, mailId) {
         return new URL(`${this.projectPath(org, name)}/email/log/${encodeURIComponent(mailId)}/raw`, this.opts.baseUrl).toString();
     }
-    /** 원문 텍스트. 화면의 상세가 헤더·본문을 그리는 재료. */
+    /** The raw text. What the detail view draws the headers and body from. */
     getMailLogRaw(org, name, mailId) {
         return this.text("GET", `${this.projectPath(org, name)}/email/log/${encodeURIComponent(mailId)}/raw`);
     }
-    // ---- 최종 사용자 인증 (docs/auth.md §9) ----
+    // ---- End-user authentication (docs/auth.md §9) ----
     /**
-     * 부여 여부·설정·프로바이더·호스트. **가입자는 안 온다** — 그 표는 프로젝트
-     * DB 안이고 (docs/auth.md §6) 워커의 `env.auth` 만 본다.
+     * Grant, settings, providers, hosts. **The signed-up users do not come** —
+     * that table is inside the project DB (docs/auth.md §6) and only the worker's
+     * `env.auth` sees it.
      *
-     * `providers` 에는 client id 만 있다. 클라이언트 시크릿은 봉인돼 어느
-     * 응답에도 안 나온다.
+     * `providers` carries the client id only. The client secret is sealed and
+     * appears in no response.
      */
     getAuth(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/auth`);
     }
     /**
-     * 인증을 켠다 (member). 멱등이다.
+     * Turns auth on (member). Idempotent.
      *
-     * **데이터베이스가 없으면 409 `database_required`** 다 — 가입자 표가
-     * 프로젝트 DB 안이라 부여만 세우면 워커가 뜨는 순간 표가 없다. 부르는 쪽은
-     * 그 코드를 잡아 `"database": true` 선언을 안내한다 — 배포는 순서로 이 코드를 안 본다.
+     * **With no database it is 409 `database_required`** — the user table lives
+     * inside the project DB, so standing up the grant alone leaves no table the
+     * moment the worker starts. The caller catches that code and points at the
+     * `"database": true` declaration — the deploy never sees this code, because
+     * its ordering rules it out.
      */
     grantAuth(org, name) {
         return this.json("POST", `${this.projectPath(org, name)}/auth`);
     }
     /**
-     * 설정을 바꾼다 (member). **부분 갱신이다** — 준 칸만 바뀐다. 스위치 하나에
-     * 전체를 실어 보내면 두 사람이 같은 카드를 만질 때 나중 저장이 앞 저장을
-     * 덮는다. 부여가 없으면 404 `not_granted`.
+     * Changes the settings (member). **A partial update** — only the fields given
+     * change. Sending the whole thing on one switch means that when two people
+     * touch the same card, the later save overwrites the earlier one. With no
+     * grant it is 404 `not_granted`.
      */
     updateAuthSettings(org, name, settings) {
         return this.json("PATCH", `${this.projectPath(org, name)}/auth`, { settings });
     }
     /**
-     * 인증을 해제한다 (admin). **가입자는 안 지워진다** — `runlot_auth` 의 표는
-     * 프로젝트 DB 에 남고, 다시 켜면 같은 사람들이 그대로 로그인한다.
+     * Turns auth off (admin). **The signed-up users are not deleted** — the
+     * `runlot_auth` tables stay in the project DB, and turning it back on lets the
+     * same people log in unchanged.
      */
     revokeAuth(org, name) {
         return this.json("DELETE", `${this.projectPath(org, name)}/auth`);
     }
     /**
-     * 소셜 프로바이더를 등록하거나 교체한다 (admin). 같은 PUT 이라 멱등이다.
+     * Registers or replaces a social provider (admin). It is the same PUT, so it
+     * is idempotent.
      *
-     * **`clientSecret` 은 다시 볼 수 없다.** 콜백 URL 은 호스트마다
-     * `https://<host>/__runlot/auth/callback/<provider>` 이고, 호스트 목록은
-     * 응답의 `hosts` 에 있다.
+     * **`clientSecret` cannot be read back.** The callback URL is
+     * `https://<host>/__runlot/auth/callback/<provider>` for each host, and the
+     * list of hosts is in the response's `hosts`.
      */
     setAuthProvider(org, name, provider, clientId, clientSecret) {
         return this.json("PUT", `${this.projectPath(org, name)}/auth/providers/${encodeURIComponent(provider)}`, { clientId, clientSecret });
     }
     /**
-     * 프로바이더를 뗀다 (admin). 그 프로바이더로만 가입한 사람은 로그인할 길을
-     * 잃지만 사용자 행은 남는다 — 다시 등록하면 같은 계정으로 돌아온다.
+     * Removes a provider (admin). Someone who signed up only through that provider
+     * loses their way in, but the user row stays — register it again and they come
+     * back to the same account.
      */
     deleteAuthProvider(org, name, provider) {
         return this.json("DELETE", `${this.projectPath(org, name)}/auth/providers/${encodeURIComponent(provider)}`);
     }
-    // ---- 배포 접근 제어 (docs/access.md §7) ----
+    // ---- Deployment access control (docs/access.md §7) ----
     /**
-     * 이 배포에 누가 닿을 수 있는가. **값은 없다** — 비밀번호도 우회 시크릿도
-     * 해시로만 살고, 여기 오는 것은 `hasPassword`·`hasBypass` 라는 사실이다.
+     * Who can reach this deployment. **No values** — both the password and the
+     * bypass secret live only as hashes, and what comes back here is the fact that
+     * there is one: `hasPassword` and `hasBypass`.
      *
-     * 정책을 한 번도 안 정한 프로젝트는 `mode: "public"` 에 `updatedAt` 이
-     * 없다. 화면이 그 둘을 가르는 이유는 §7 — 빈 상태 대신 상태 문장이다.
+     * A project that has never set a policy is `mode: "public"` with no
+     * `updatedAt`. The screen tells those two apart for the reason in §7 — a
+     * sentence about the state instead of an empty state.
      */
     getAccess(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/access`);
     }
     /**
-     * 정책을 바꾼다 (admin). `password` 를 안 보내면 **있던 비밀번호가 남는다** —
-     * 모드만 바꾸는 저장이 비밀번호를 지우면 되돌아왔을 때 다시 정해야 한다.
+     * Changes the policy (admin). Without a `password`, **the existing password
+     * stays** — if a save that only changes the mode wiped the password, coming
+     * back to that mode would mean setting it again.
      */
     setAccess(org, name, mode, password) {
         return this.json("PUT", `${this.projectPath(org, name)}/access`, { mode, password });
     }
     /**
-     * 자동화 우회 시크릿을 만든다 (admin). **값은 이 답에만 있다** — 화면은
-     * 받은 즉시 한 번 보여주고 다시 못 가져온다. 다시 부르면 옛 값이 죽는다.
+     * Makes a bypass secret for automation (admin). **The value is in this answer
+     * and nowhere else** — the screen shows it once on arrival and can never fetch
+     * it again. Calling again kills the old value.
      */
     newAccessBypass(org, name) {
         return this.json("POST", `${this.projectPath(org, name)}/access/bypass`);
     }
-    /** 우회를 뗀다 (admin). 없는 우회를 떼는 것도 성공이다. */
+    /** Removes the bypass (admin). Removing one that does not exist also succeeds. */
     revokeAccessBypass(org, name) {
         return this.json("DELETE", `${this.projectPath(org, name)}/access/bypass`);
     }
     /**
-     * 보호된 배포로 돌아가는 1 회용 주소를 받는다 (docs/access.md §3.4-3).
+     * Gets a one-time address back into a protected deployment (docs/access.md §3.4-3).
      *
-     * 프로젝트 경로 아래가 **아니다**: 부르는 화면이 아는 것은 호스트네임뿐이고
-     * (원 요청이 그리로 갔다), org·프로젝트 이름은 서버가 그것에서 유도한다.
-     * 받은 `redirect` 로 `location.replace` 하는 것이 호출부의 일이다.
+     * It is **not** under the project path: all the calling screen knows is the
+     * hostname (the original request went there), and the server derives the org
+     * and project names from it. Doing `location.replace` with the `redirect` that
+     * comes back is the caller's job.
      */
     authorizeAccess(to, next) {
         return this.json("POST", "/v1/access/authorize", { to, next });
@@ -608,7 +640,7 @@ export class Client {
     listMembers(org) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/members`);
     }
-    /** 초대가 아니다 — 사용자는 이미 한 번 로그인해 있어야 한다 (404 `user_not_found`). */
+    /** This is not an invite — the user must already have logged in once (404 `user_not_found`). */
     addMember(org, provider, subject, role) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/members`, { provider, subject, role });
     }
@@ -616,67 +648,71 @@ export class Client {
         return this.json("PUT", `/v1/orgs/${encodeURIComponent(org)}/members/${encodeURIComponent(userId)}`, { role });
     }
     /**
-     * 남을 빼는 것은 admin, **자기를 빼는 것은 탈퇴**라 누구나 할 수 있다
-     * (docs/members.md). 마지막 admin 은 둘 다 못 한다 (409 `last_admin`).
+     * Removing someone else is admin; **removing yourself is leaving**, which
+     * anyone can do (docs/members.md). The last admin can do neither
+     * (409 `last_admin`).
      */
     removeMember(org, userId) {
         return this.json("DELETE", `/v1/orgs/${encodeURIComponent(org)}/members/${encodeURIComponent(userId)}`);
     }
-    // --- 초대 (docs/members.md) ---
-    /** 대기·만료된 초대 (admin). 수락·폐기된 것은 이력이라 안 온다. */
+    // --- Invites (docs/members.md) ---
+    /** Pending and expired invites (admin). Accepted and revoked ones are history, so they do not come. */
     listInvites(org) {
         return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/invites`);
     }
     /**
-     * 이메일로 부른다 (admin). **같은 주소로 다시 부르면 재발송**이다 — 새 행이
-     * 아니라 같은 행이 갱신되고 서버가 201 대신 200 을 준다.
+     * Invites by email (admin). **Calling again with the same address is a
+     * resend** — the same row is updated rather than a new one created, and the
+     * server gives 200 instead of 201.
      */
     createInvite(org, email, role) {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/invites`, { email, role });
     }
-    /** 폐기 (admin). 아직 안 나간 메일은 안 나간다. */
+    /** Revokes an invite (admin). Mail that has not gone out yet does not go out. */
     revokeInvite(org, inviteId) {
         return this.json("DELETE", `/v1/orgs/${encodeURIComponent(org)}/invites/${encodeURIComponent(inviteId)}`);
     }
     /**
-     * 초대 미리보기. **세션이 없어도 된다** — 링크를 받은 사람은 아직 로그인
-     * 전이고, 로그인하기 전에 무엇을 수락하는지 알아야 한다.
+     * A preview of the invite. **No session needed** — whoever got the link has
+     * not logged in yet, and they need to know what they are accepting before
+     * they do.
      */
     getInvite(token) {
         return this.json("GET", `/v1/invites/${encodeURIComponent(token)}`);
     }
-    /** 수락 (로그인 필요). 이미 멤버면 역할은 안 바뀐다. */
+    /** Accepts (login required). If they are already a member the role does not change. */
     acceptInvite(token) {
         return this.json("POST", `/v1/invites/${encodeURIComponent(token)}/accept`);
     }
     // --- domains: D1 hostnames methods ---
-    /** 기본 호스트네임과 커스텀 도메인이 함께 온다 (viewer). */
+    /** The default hostname and the custom domains come together (viewer). */
     listHostnames(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/hostnames`);
     }
     /**
-     * 커스텀 도메인을 건다 (member).
+     * Attaches a custom domain (member).
      *
-     * 멱등이다 — 같은 이름을 다시 보내면 있던 행이 그대로 온다. 응답의 `verify`
-     * 가 고객이 넣어야 하는 CNAME·TXT 다.
+     * Idempotent — sending the same name again returns the existing row
+     * unchanged. The response's `verify` is the CNAME and TXT the customer has to
+     * add.
      */
     addHostname(org, name, hostname) {
         return this.json("POST", `${this.projectPath(org, name)}/hostnames`, { hostname });
     }
-    /** 배경 검증과 같은 판정을 즉시 부른다 (member). */
+    /** Runs the same check the background verifier makes, right now (member). */
     verifyHostname(org, name, host) {
         return this.json("POST", `${this.projectPath(org, name)}/hostnames/${encodeURIComponent(host)}/verify`);
     }
-    /** 커스텀 도메인을 뗀다 (member). 기본 호스트네임은 400 이다. */
+    /** Detaches a custom domain (member). The default hostname gives a 400. */
     deleteHostname(org, name, host) {
         return this.json("DELETE", `${this.projectPath(org, name)}/hostnames/${encodeURIComponent(host)}`);
     }
     // --- domains: D2 dns methods ---
-    /** 이 조직의 존 목록. `rrsets` 는 없다 — 단건 조회에만 실려요. */
+    /** The organization's zones. No `rrsets` — those ride only on a single-zone lookup. */
     listZones(org) {
         return this.json("GET", this.dnsPath(org));
     }
-    /** 멱등이에요. 이미 있는 존은 그대로 돌아와요. */
+    /** Idempotent. A zone that already exists comes back unchanged. */
     createZone(org, name) {
         return this.json("POST", this.dnsPath(org), { name });
     }
@@ -687,8 +723,9 @@ export class Client {
         return this.json("DELETE", `${this.dnsPath(org)}/${encodeURIComponent(zone)}`);
     }
     /**
-     * rrset 하나를 **통째로** 바꿔요. `records` 가 그 (이름, 타입) 의 새 전부라,
-     * 값 하나를 더하려면 지금 값을 함께 보내야 해요.
+     * Replaces one rrset **whole**. `records` is the complete new set for that
+     * (name, type), so adding a single value means sending the current ones with
+     * it.
      */
     putRRset(org, zone, name, type, ttl, records) {
         return this.json("PUT", this.rrsetPath(org, zone, name, type), { ttl, records });
@@ -704,39 +741,40 @@ export class Client {
     setZoneDS(org, zone, ds) {
         return this.json("PUT", `${this.dnsPath(org)}/${encodeURIComponent(zone)}/dnssec/ds`, { ds });
     }
-    /** DNS 표면의 공통 접두. */
+    /** The shared prefix of the DNS surface. */
     dnsPath(org) {
         return `/v1/orgs/${encodeURIComponent(org)}/dns/zones`;
     }
-    /** `@` 도 `*` 도 이름으로 와요. 네 군데에 같은 문자열을 적지 않아요. */
+    /** Both `@` and `*` arrive as a name. Keeps the same string out of four places. */
     rrsetPath(org, zone, name, type) {
         return (`${this.dnsPath(org)}/${encodeURIComponent(zone)}` +
             `/rrsets/${encodeURIComponent(name)}/${encodeURIComponent(type)}`);
     }
     // --- domains: D3 domains methods ---
     /**
-     * 이름을 찾아본다 (member 이상).
+     * Looks a name up (member or above).
      *
-     * `priceCents` 는 첫 등록 1 년, `renewalCents` 는 갱신 1 년이다. 둘이
-     * 나뉘어 있는 이유는 첫해 할인이 흔해서다 — 하나로 접으면 "1 달러에 사서
-     * 다음 해 15 달러" 를 화면이 말할 수 없다.
+     * `priceCents` is the first year of registration; `renewalCents` is one year
+     * of renewal. They are separate because a first-year discount is common —
+     * folded into one, the screen cannot say "buy it for $1, then $15 next year".
      */
     checkDomains(org, names) {
         return this.json("POST", `${this.domainsPath(org)}/check`, { names });
     }
     /**
-     * 도메인을 산다 (admin — 돈을 써요).
+     * Buys a domain (admin — this spends money).
      *
-     * **ICANN 검증 메일이 `contact.email` 로 가요.** 화면은 사기 전에 그
-     * 사실을 알려야 해요 (docs/domains.md §5.5).
+     * **The ICANN verification mail goes to `contact.email`.** The screen has to
+     * say so before the purchase (docs/domains.md §5.5).
      *
-     * 같은 요청을 다시 보내는 것이 안전해요 — 끝난 도메인이면 그대로 오고,
-     * 중간에 멈춘 구매면 그 자리에서 이어 가요.
+     * Sending the same request again is safe — a finished domain comes back
+     * unchanged, and a purchase that stopped part way resumes from where it
+     * stopped.
      */
     purchaseDomain(org, body) {
         return this.json("POST", this.domainsPath(org), body);
     }
-    /** 이미 가진 도메인을 가져와요 (admin). 등록기관을 부르지 않고 존만 만들어요. */
+    /** Imports a domain you already own (admin). Creates the zone only; the registrar is not called. */
     importDomain(org, name) {
         return this.json("POST", `${this.domainsPath(org)}/import`, { name });
     }
@@ -750,11 +788,11 @@ export class Client {
         return this.json("POST", `${this.domainPath(org, name)}/renew`, { years });
     }
     /**
-     * 자동 갱신 **의사**만 바꿔요.
+     * Changes only the **intent** to auto-renew.
      *
-     * 등록기관 쪽 자동 갱신은 그대로 켜져 있어요 — 도메인은 하루 늦으면 잃는
-     * 자산이라 우리가 먼저 갱신하고 뒤에 청구해요. 화면은 이 사실을 함께
-     * 말해야 해요.
+     * Auto-renew at the registrar stays on — a domain is an asset you lose if you
+     * are a day late, so we renew first and bill afterwards. The screen has to say
+     * this alongside.
      */
     setDomainAutoRenew(org, name, enabled) {
         return this.json("POST", `${this.domainPath(org, name)}/auto-renew`, { enabled });
@@ -762,37 +800,37 @@ export class Client {
     setDomainLock(org, name, locked) {
         return this.json("POST", `${this.domainPath(org, name)}/lock`, { locked });
     }
-    /** 이전 코드예요. 감사에 발급 사실이 남고 **코드는 남지 않아요**. */
+    /** The transfer auth code. The audit records that one was issued and **not the code itself**. */
     domainAuthCode(org, name) {
         return this.json("POST", `${this.domainPath(org, name)}/auth-code`);
     }
-    /** 지금 등록기관에서 다시 읽어요 (member). */
+    /** Re-reads from the registrar right now (member). */
     syncDomain(org, name) {
         return this.json("POST", `${this.domainPath(org, name)}/sync`);
     }
-    /** 도메인 표면의 공통 접두. 열 군데에 같은 문자열을 적지 않아요. */
+    /** The shared prefix of the domain surface. Keeps the same string out of ten places. */
     domainsPath(org) {
         return `/v1/orgs/${encodeURIComponent(org)}/domains`;
     }
     domainPath(org, name) {
         return `${this.domainsPath(org)}/${encodeURIComponent(name)}`;
     }
-    /** 프로젝트 표면의 공통 접두다. */
+    /** The shared prefix of the project surface. */
     projectPath(org, name) {
         return `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}`;
     }
-    /** 데이터베이스 표면의 공통 접두다. 다섯 군데에 같은 문자열을 적지 않는다. */
+    /** The shared prefix of the database surface. Keeps the same string out of five places. */
     dbPath(org, name) {
         return `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/database`;
     }
-    // ---- 자체 Git 호스팅 (docs/git-hosting.md §12.1, §19) ----
+    // ---- Self-hosted Git (docs/git-hosting.md §12.1, §19) ----
     //
-    // **저장소 조작은 git 이 하고 우리는 메타데이터만 다룬다.** `pushRepo` 같은
-    // 것이 여기 없는 이유다 — git 을 감싸는 API 는 git 의 모든 플래그를 다시
-    // 구현하거나 사용자를 가둔다.
+    // **git does the repository work and we handle only the metadata.** That is
+    // why there is nothing like `pushRepo` here — an API that wraps git either
+    // reimplements every one of git's flags or boxes the user in.
     //
-    // 저장소는 **프로젝트의 것**이다. 그래서 모든 메서드가 (org, project) 로
-    // 시작한다 — 데이터베이스·시크릿과 같은 모양이다.
+    // A repository **belongs to a project**. That is why every method starts with
+    // (org, project) — the same shape as the database and the secrets.
     listRepos(org, project) {
         return this.json("GET", this.repoPath(org, project));
     }
@@ -808,7 +846,7 @@ export class Client {
     deleteRepo(org, project, name) {
         return this.json("DELETE", `${this.repoPath(org, project)}/${encodeURIComponent(name)}`);
     }
-    /** ref 이력. force-push 로 잃은 커밋을 되찾는 단서가 여기 있다. */
+    /** The ref history. The lead for recovering a commit lost to a force-push is here. */
     listRefUpdates(org, project, name) {
         return this.json("GET", `${this.repoPath(org, project)}/${encodeURIComponent(name)}/ref-updates`);
     }
@@ -824,14 +862,14 @@ export class Client {
     listAccessTokens() {
         return this.json("GET", "/v1/me/tokens");
     }
-    /** 평문은 이 응답에 **한 번만** 실린다. */
+    /** The plaintext is carried in this response **once** and never again. */
     createAccessToken(body) {
         return this.json("POST", "/v1/me/tokens", body);
     }
     revokeAccessToken(tokenId) {
         return this.json("DELETE", `/v1/me/tokens/${encodeURIComponent(tokenId)}`);
     }
-    // ---- 브라우즈 (docs/git-hosting.md §12.2) ----
+    // ---- Browsing (docs/git-hosting.md §12.2) ----
     getRepoRefs(org, project, name) {
         return this.json("GET", `${this.repoPath(org, project)}/${encodeURIComponent(name)}/refs`);
     }
@@ -850,7 +888,7 @@ export class Client {
         const qs = q.size > 0 ? `?${q.toString()}` : "";
         return this.json("GET", `${this.repoPath(org, project)}/${encodeURIComponent(name)}/commits${qs}`);
     }
-    /** 저장소 표면의 공통 접두다. 프로젝트 아래에 있다 (§19). */
+    /** The shared prefix of the repository surface. It sits under the project (§19). */
     repoPath(org, project) {
         return `${this.projectPath(org, project)}/repos`;
     }