@pmate/cli 0.20.3 → 0.20.5

package/dist/index.d.ts

@@ -168,6 +168,14 @@ type QuizCommandArgs = {
     apiBaseUrl?: string;
     linkBaseUrl?: string;
     activate: boolean;
+} | {
+    type: Command.Quiz;
+    action: "update-step";
+    paperId: string;
+    stepId: string;
+    filePath: string;
+    apiBaseUrl?: string;
+    linkBaseUrl?: string;
 };
 type LinearPrCommandArgs = {
     type: Command.Linear;
@@ -592,6 +600,7 @@ type ServiceCommandArgs = {
     page: number;
     history: boolean;
     search?: string;
+    follow: boolean;
 };
 type VercelProjectsCommandArgs = {
     type: Command.Vercel;

package/dist/index.js

@@ -12712,7 +12712,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_node_fs16 = require("fs");
 var import_node_path21 = __toESM(require("path"));
-var import_chalk3 = __toESM(require("chalk"));
+var import_chalk4 = __toESM(require("chalk"));
 
 // src/cli.ts
 var import_chalk = __toESM(require("chalk"));
@@ -18370,6 +18370,38 @@ async function appendQuizPaperStep({
     data
   };
 }
+async function updateQuizPaperStep({
+  fetchImpl = fetch,
+  apiBaseUrl,
+  linkBaseUrl,
+  paperId,
+  stepId,
+  step,
+  token
+}) {
+  const trimmedApiBaseUrl = apiBaseUrl.replace(/\/+$/, "");
+  const trimmedLinkBaseUrl = linkBaseUrl.replace(/\/+$/, "");
+  const previewLink = `${trimmedLinkBaseUrl}/?paper=${encodeURIComponent(paperId)}`;
+  const data = await requestJson(
+    fetchImpl,
+    `${trimmedApiBaseUrl}/api/quiz/papers/${encodeURIComponent(paperId)}/steps/${encodeURIComponent(stepId)}`,
+    {
+      method: "PATCH",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(step)
+    },
+    `\u66F4\u65B0\u9898\u76EE\uFF08${stepId}\uFF09`
+  );
+  return {
+    apiBaseUrl: trimmedApiBaseUrl,
+    paperId,
+    previewLink,
+    data
+  };
+}
 async function reorderQuizPaperSteps({
   fetchImpl = fetch,
   apiBaseUrl,
@@ -18512,6 +18544,22 @@ var QuizCommandHandler = class {
       ui.info("stepId", String(step.stepId));
       return;
     }
+    if (args.action === "update-step") {
+      const resolvedFilePath = import_node_path14.default.resolve(process.cwd(), args.filePath);
+      const step = JSON.parse((0, import_node_fs9.readFileSync)(resolvedFilePath, "utf8"));
+      step.stepId = args.stepId;
+      const result = await updateQuizPaperStep({
+        apiBaseUrl,
+        linkBaseUrl,
+        paperId: args.paperId,
+        stepId: args.stepId,
+        step,
+        token: session.token
+      });
+      ui.success("Quiz \u9898\u76EE\u5DF2\u66F4\u65B0", result.previewLink);
+      ui.info("stepId", args.stepId);
+      return;
+    }
     if (args.action === "reorder") {
       const result = await reorderQuizPaperSteps({
         apiBaseUrl,
@@ -20017,6 +20065,8 @@ var import_node_fs14 = require("fs");
 var import_node_os6 = __toESM(require("os"));
 var import_node_path19 = __toESM(require("path"));
 var import_node_child_process9 = require("child_process");
+var import_node_readline = require("readline");
+var import_chalk3 = __toESM(require("chalk"));
 var ServiceRuntimeRunner = class {
   async deploy(service, options = {}) {
     switch (service.runtimeType) {
@@ -20069,6 +20119,61 @@ var ServiceRuntimeRunner = class {
     ui.title(`Logs for ${namespace}/${appName}`);
     ui.info("Source", { mode: options.history ? "history" : "online" });
     this.renderPage(page);
+    if (options.follow) {
+      await this.followLogs(namespace, appName, {
+        page: options.page ?? 0,
+        history: options.history ?? false,
+        search: options.search,
+        seedItems: page.data
+      });
+    }
+  }
+  async followLogs(namespace, appName, options) {
+    const recent = [...options.seedItems];
+    const interactive = this.createFollowConsole((state) => {
+      this.renderFollowSnapshot(recent, state);
+    });
+    let running = true;
+    interactive?.rl.on("close", () => {
+      running = false;
+    });
+    const seen = new Set(options.seedItems.map((item) => item.hash));
+    ui.info(
+      "Follow",
+      interactive ? "enabled (poll every 2s, Ctrl+C to stop, /help for filters)" : "enabled (poll every 2s, Ctrl+C to stop)"
+    );
+    interactive?.renderPrompt();
+    while (running) {
+      await this.sleep(2e3);
+      let page;
+      try {
+        page = await this.fetchLogPage(namespace, appName, {
+          page: options.page,
+          history: options.history,
+          search: options.search
+        });
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ui.warn("Follow fetch failed", { message });
+        continue;
+      }
+      const newItems = page.data.filter((item) => !seen.has(item.hash));
+      if (newItems.length === 0) {
+        continue;
+      }
+      const ordered = [...newItems].reverse();
+      for (const item of ordered) {
+        seen.add(item.hash);
+        recent.unshift(item);
+        if (recent.length > 200) {
+          recent.pop();
+        }
+        if (this.matchFollowFilter(item, interactive?.state)) {
+          ui.plain(this.renderLogLine(item));
+          interactive?.renderPrompt();
+        }
+      }
+    }
   }
   getDeploy(service) {
     return service.deploy ?? {};
@@ -20333,6 +20438,14 @@ var ServiceRuntimeRunner = class {
       headers: { Accept: "application/json" }
     });
     const payload = await response.json();
+    if (response.status === 404 && /resource not found/i.test(payload.message || "")) {
+      return {
+        page: options.page,
+        totalPage: 0,
+        pageSize: 100,
+        data: []
+      };
+    }
     if (!response.ok || !payload.success || !payload.data) {
       throw new Error(payload.message || `Log request failed: ${response.status}`);
     }
@@ -20346,9 +20459,391 @@ var ServiceRuntimeRunner = class {
       items: page.data.length
     });
     for (const item of page.data) {
-      const ts = new Date(item.time).toISOString();
-      ui.plain(`${ts} [${item.type}] ${JSON.stringify(item.data)} #${item.hash}`);
+      ui.plain(this.renderLogLine(item));
+    }
+  }
+  renderLogLine(item) {
+    const ts = import_chalk3.default.white(new Date(item.time).toISOString());
+    const resolvedLevel = this.resolveItemLevel(item);
+    const isErrorLike = resolvedLevel === "error" || /error|failed/i.test(item.type);
+    const type = isErrorLike ? import_chalk3.default.bold.red(`[${item.type}]`) : import_chalk3.default.bold.blue(`[${item.type}]`);
+    const level = resolvedLevel ? `${isErrorLike ? import_chalk3.default.bold.red(resolvedLevel.toUpperCase()) : import_chalk3.default.bold.yellow(resolvedLevel.toUpperCase())} ` : "";
+    const data = this.formatLogData(item.data);
+    const hash = import_chalk3.default.gray(`#${item.hash}`);
+    return `${ts} ${level}${type} ${data} ${hash}`;
+  }
+  formatLogData(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+      return import_chalk3.default.gray(this.formatAnyValue(value));
+    }
+    const objectValue = value;
+    const entries = Object.entries(objectValue);
+    if (entries.length === 0) {
+      return "{}";
+    }
+    const body = entries.map(([key, item]) => `${import_chalk3.default.bold.white(key)}: ${import_chalk3.default.gray(this.formatAnyValue(item))}`).join(", ");
+    return `{ ${body} }`;
+  }
+  formatAnyValue(value) {
+    if (typeof value === "string") {
+      return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean" || value === null) {
+      return String(value);
+    }
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  }
+  createFollowConsole(onFilterChanged) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+      return void 0;
+    }
+    const state = {};
+    const rl = (0, import_node_readline.createInterface)({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: true
+    });
+    const renderPrompt = () => {
+      const hints = [];
+      if (state.search) hints.push(`search=${state.search}`);
+      if (state.type) hints.push(`type=${state.type}`);
+      if (state.level) hints.push(`level=${state.level}`);
+      if (state.whereExpr) hints.push(`where=${state.whereExpr}`);
+      const suffix = hints.length ? ` (${hints.join(", ")})` : "";
+      rl.setPrompt(import_chalk3.default.gray(`filter>${suffix} `));
+      rl.prompt();
+    };
+    rl.on("line", (raw) => {
+      const line = raw.trim();
+      if (!line) {
+        renderPrompt();
+        return;
+      }
+      if (line === "/help") {
+        ui.info("Follow commands", [
+          "/search <text>  set keyword filter on event + payload",
+          "/type <event>   set event type filter",
+          "/level <lvl>    set level filter (debug|info|warn|error)",
+          "<text>          wildcard match on event + payload (equivalent to *text*)",
+          "<expr>          set JSON field filter (supports &&, ||, ())",
+          "                e.g. datamode=prompt && (type=task_end || level=error)",
+          "/clear          clear all filters",
+          "/quit           exit follow mode"
+        ]);
+        renderPrompt();
+        return;
+      }
+      if (line === "/clear") {
+        delete state.search;
+        delete state.type;
+        delete state.level;
+        delete state.whereExpr;
+        delete state.whereAst;
+        ui.success("Filters cleared");
+        onFilterChanged?.(state);
+        renderPrompt();
+        return;
+      }
+      if (line === "/quit" || line === "/exit") {
+        rl.close();
+        return;
+      }
+      if (line.startsWith("/search ")) {
+        const value = line.slice("/search ".length).trim();
+        state.search = value || void 0;
+        ui.success("Updated search filter", { search: state.search });
+        onFilterChanged?.(state);
+        renderPrompt();
+        return;
+      }
+      if (line.startsWith("/type ")) {
+        const value = line.slice("/type ".length).trim();
+        state.type = value || void 0;
+        ui.success("Updated type filter", { type: state.type });
+        onFilterChanged?.(state);
+        renderPrompt();
+        return;
+      }
+      if (line.startsWith("/level ")) {
+        const value = line.slice("/level ".length).trim().toLowerCase();
+        if (value !== "debug" && value !== "info" && value !== "warn" && value !== "error") {
+          ui.warn("Invalid level", { value, allowed: ["debug", "info", "warn", "error"] });
+          renderPrompt();
+          return;
+        }
+        state.level = value;
+        ui.success("Updated level filter", { level: state.level });
+        onFilterChanged?.(state);
+        renderPrompt();
+        return;
+      }
+      if (!line.startsWith("/")) {
+        if (this.isPlainWildcardInput(line)) {
+          state.search = line;
+          delete state.whereExpr;
+          delete state.whereAst;
+          ui.success("Updated wildcard filter", { search: state.search });
+          onFilterChanged?.(state);
+          renderPrompt();
+          return;
+        }
+        try {
+          const parsed = this.parseWhereExpression(line);
+          state.whereExpr = line;
+          state.whereAst = parsed;
+          ui.success("Updated where filter", { where: state.whereExpr });
+          onFilterChanged?.(state);
+        } catch {
+          ui.warn("Unknown follow command", { command: line, hint: "Type /help" });
+        }
+        renderPrompt();
+        return;
+      }
+      ui.warn("Unknown follow command", { command: line, hint: "Type /help" });
+      renderPrompt();
+    });
+    return { rl, state, renderPrompt };
+  }
+  matchFollowFilter(item, state) {
+    if (!state) return true;
+    if (state.type && !item.type.includes(state.type)) {
+      return false;
+    }
+    if (state.level && this.resolveItemLevel(item) !== state.level) {
+      return false;
+    }
+    if (state.search) {
+      const haystack = `${item.type} ${JSON.stringify(item.data)}`;
+      if (!haystack.toLowerCase().includes(state.search.toLowerCase())) {
+        return false;
+      }
+    }
+    if (state.whereAst && !this.evaluateWhereNode(item, state.whereAst)) {
+      return false;
+    }
+    return true;
+  }
+  renderFollowSnapshot(recent, state) {
+    const matched = recent.filter((item) => this.matchFollowFilter(item, state));
+    ui.info("Filter snapshot", {
+      matched: matched.length,
+      recent: recent.length,
+      shown: Math.min(matched.length, 20)
+    });
+    const toShow = matched.slice(0, 20);
+    for (const item of toShow.reverse()) {
+      ui.plain(this.renderLogLine(item));
+    }
+  }
+  resolveItemLevel(item) {
+    if (item.level) return item.level;
+    if (!item.data || typeof item.data !== "object" || Array.isArray(item.data)) {
+      return void 0;
+    }
+    const level = item.data.level;
+    if (level === "debug" || level === "info" || level === "warn" || level === "error") {
+      return level;
+    }
+    return void 0;
+  }
+  parseWhereExpression(expr) {
+    const tokens = this.tokenizeWhere(expr);
+    if (tokens.length === 0) {
+      throw new Error("Expression is empty");
+    }
+    let idx = 0;
+    const parsePrimary = () => {
+      const token = tokens[idx];
+      if (!token) {
+        throw new Error("Unexpected end of expression");
+      }
+      if (token.kind === "lparen") {
+        idx += 1;
+        const node = parseOr();
+        const closing = tokens[idx];
+        if (!closing || closing.kind !== "rparen") {
+          throw new Error("Missing closing ')' ");
+        }
+        idx += 1;
+        return node;
+      }
+      if (token.kind !== "ident") {
+        throw new Error(`Expected field name, got "${token.raw}"`);
+      }
+      const rawKey = token.value;
+      idx += 1;
+      const op = tokens[idx];
+      if (!op || op.kind !== "eq") {
+        throw new Error(`Expected "=" after "${rawKey}"`);
+      }
+      idx += 1;
+      const valueToken = tokens[idx];
+      if (!valueToken || valueToken.kind !== "ident" && valueToken.kind !== "quoted") {
+        throw new Error(`Expected value after "${rawKey}="`);
+      }
+      idx += 1;
+      return {
+        kind: "clause",
+        clause: {
+          path: this.normalizeWhereKey(rawKey),
+          expected: this.parseWhereValue(valueToken.value)
+        }
+      };
+    };
+    const parseAnd = () => {
+      let node = parsePrimary();
+      while (tokens[idx]?.kind === "and") {
+        idx += 1;
+        node = { kind: "and", left: node, right: parsePrimary() };
+      }
+      return node;
+    };
+    const parseOr = () => {
+      let node = parseAnd();
+      while (tokens[idx]?.kind === "or") {
+        idx += 1;
+        node = { kind: "or", left: node, right: parseAnd() };
+      }
+      return node;
+    };
+    const ast = parseOr();
+    if (idx < tokens.length) {
+      throw new Error(`Unexpected token "${tokens[idx].raw}"`);
+    }
+    return ast;
+  }
+  normalizeWhereKey(key) {
+    const raw = key.trim();
+    if (raw === "datamode") return "data.mode";
+    if (raw === "type") return "type";
+    if (raw === "level") return "level";
+    if (raw === "taskid") return "data.taskId";
+    return raw;
+  }
+  parseWhereValue(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "true") return true;
+    if (trimmed === "false") return false;
+    if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+      return Number(trimmed);
     }
+    if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+      return trimmed.slice(1, -1);
+    }
+    return trimmed;
+  }
+  tokenizeWhere(expr) {
+    const tokens = [];
+    let i = 0;
+    const input = expr.trim();
+    while (i < input.length) {
+      const ch = input[i];
+      if (/\s/.test(ch)) {
+        i += 1;
+        continue;
+      }
+      if (ch === "(") {
+        tokens.push({ kind: "lparen", raw: ch });
+        i += 1;
+        continue;
+      }
+      if (ch === ")") {
+        tokens.push({ kind: "rparen", raw: ch });
+        i += 1;
+        continue;
+      }
+      if (ch === "=") {
+        tokens.push({ kind: "eq", raw: ch });
+        i += 1;
+        continue;
+      }
+      if (ch === "&" && input[i + 1] === "&") {
+        tokens.push({ kind: "and", raw: "&&" });
+        i += 2;
+        continue;
+      }
+      if (ch === "|" && input[i + 1] === "|") {
+        tokens.push({ kind: "or", raw: "||" });
+        i += 2;
+        continue;
+      }
+      if (ch === '"' || ch === "'") {
+        const quote = ch;
+        i += 1;
+        let value = "";
+        while (i < input.length && input[i] !== quote) {
+          value += input[i];
+          i += 1;
+        }
+        if (i >= input.length) {
+          throw new Error("Unterminated quoted string");
+        }
+        i += 1;
+        tokens.push({ kind: "quoted", raw: `${quote}${value}${quote}`, value });
+        continue;
+      }
+      let raw = "";
+      while (i < input.length) {
+        const c = input[i];
+        if (/\s/.test(c) || c === "(" || c === ")" || c === "=") break;
+        if (c === "&" && input[i + 1] === "&" || c === "|" && input[i + 1] === "|") break;
+        raw += c;
+        i += 1;
+      }
+      if (!raw) {
+        throw new Error(`Unexpected token near "${input.slice(i)}"`);
+      }
+      tokens.push({ kind: "ident", raw, value: raw });
+    }
+    return tokens;
+  }
+  readPathValue(source, pathExpr) {
+    const path22 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
+    let cursor = source;
+    for (const segment of path22) {
+      if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) {
+        return void 0;
+      }
+      cursor = cursor[segment];
+    }
+    return cursor;
+  }
+  equalsExpected(actual, expected) {
+    if (actual === void 0) return false;
+    if (typeof expected === "number") {
+      if (typeof actual === "number") return actual === expected;
+      if (typeof actual === "string" && /^-?\d+(\.\d+)?$/.test(actual.trim())) {
+        return Number(actual) === expected;
+      }
+      return false;
+    }
+    if (typeof expected === "boolean") {
+      if (typeof actual === "boolean") return actual === expected;
+      if (typeof actual === "string") return actual.toLowerCase() === String(expected);
+      return false;
+    }
+    if (typeof actual === "string") return actual === expected;
+    if (typeof actual === "number" || typeof actual === "boolean") {
+      return String(actual) === expected;
+    }
+    return false;
+  }
+  isPlainWildcardInput(input) {
+    return !/[=()]/.test(input) && !input.includes("&&") && !input.includes("||");
+  }
+  evaluateWhereNode(item, node) {
+    if (node.kind === "clause") {
+      const actual = this.readPathValue(item, node.clause.path);
+      return this.equalsExpected(actual, node.clause.expected);
+    }
+    if (node.kind === "and") {
+      return this.evaluateWhereNode(item, node.left) && this.evaluateWhereNode(item, node.right);
+    }
+    return this.evaluateWhereNode(item, node.left) || this.evaluateWhereNode(item, node.right);
   }
   resolveTemplatePath(templateName) {
     const candidates = [
@@ -20623,7 +21118,8 @@ var ServiceCommandHandler = class {
         await runtime.log(record, {
           page: args.page,
           history: args.history,
-          search: args.search
+          search: args.search,
+          follow: args.follow
         });
         return;
       }
@@ -21819,6 +22315,7 @@ function parseServiceArgs(tokens) {
     let page = 0;
     let history = false;
     let search;
+    let follow = false;
     while (rest.length > 0) {
       const token = rest.shift();
       switch (token) {
@@ -21837,6 +22334,10 @@ function parseServiceArgs(tokens) {
         case "--search":
           search = requireValue5(rest, token);
           break;
+        case "--follow":
+        case "-f":
+          follow = true;
+          break;
         case "--json":
           json = true;
           break;
@@ -21848,7 +22349,7 @@ function parseServiceArgs(tokens) {
     const namespace = parsedRef.namespace;
     const name = parsedRef.objectId;
     if (action === "log") {
-      return { type: "service" /* Service */, action, namespace, name, baseUrl, json, page, history, search };
+      return { type: "service" /* Service */, action, namespace, name, baseUrl, json, page, history, search, follow };
     }
     if (action === "deploy" || action === "init") {
       return { type: "service" /* Service */, action, namespace, name, cwd, baseUrl, json };
@@ -22201,136 +22702,137 @@ var pkg = JSON.parse(
   (0, import_node_fs16.readFileSync)(import_node_path21.default.resolve(__dirname, "..", "package.json"), "utf8")
 );
 var HELP_TEXT = [
-  import_chalk3.default.bold(`pmate v${pkg.version}`),
+  import_chalk4.default.bold(`pmate v${pkg.version}`),
   "",
-  import_chalk3.default.bold("Usage:"),
-  `  ${import_chalk3.default.cyan("pmate")} ${import_chalk3.default.gray("[options]")}`,
+  import_chalk4.default.bold("Usage:"),
+  `  ${import_chalk4.default.cyan("pmate")} ${import_chalk4.default.gray("[options]")}`,
   "",
-  import_chalk3.default.bold("Options:"),
-  `  ${import_chalk3.default.green("-h, --help")}       Show this help output`,
-  `  ${import_chalk3.default.green("-v, --version")}    Print the current version`,
-  `  ${import_chalk3.default.green("-n, --name <n>")}   Print a greeting for <n>`,
+  import_chalk4.default.bold("Options:"),
+  `  ${import_chalk4.default.green("-h, --help")}       Show this help output`,
+  `  ${import_chalk4.default.green("-v, --version")}    Print the current version`,
+  `  ${import_chalk4.default.green("-n, --name <n>")}   Print a greeting for <n>`,
   "",
-  import_chalk3.default.bold("Commands:"),
-  `  ${import_chalk3.default.cyan("list [path]")}      List apps from .pmate.yaml in the target folder`,
-  `  ${import_chalk3.default.cyan("login")}            Log in and store a session in ~/.pmate/session.json`,
-  `  ${import_chalk3.default.gray("                  [--app <app-id>]")}`,
-  `  ${import_chalk3.default.cyan("add-dns")}          Add a DNS record via Aliyun DNS`,
-  `  ${import_chalk3.default.gray("                  --type <t> --value <v> --rr <rr> [--ttl <n>] [--domain <name>]")}`,
-  `  ${import_chalk3.default.cyan("sts")}              Request an OSS STS token from the CI server`,
-  `  ${import_chalk3.default.cyan("bucket")}           Manage OSS buckets`,
-  `  ${import_chalk3.default.gray("                  --create --name <bucket> [--subdomain <name> --domain <name>]")}`,
-  `  ${import_chalk3.default.cyan("delete")}           Tear down app resources created by init`,
-  `  ${import_chalk3.default.gray("                  [app] <app-name> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.cyan("dev")}              Run the dev script for app dir from .pmate.yaml`,
-  `  ${import_chalk3.default.gray("                  <app-name> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.cyan("env")}              Manage app env vars on the server`,
-  `  ${import_chalk3.default.gray("                  <app-name> --list|--set <key> --value <value> [--delete <key>] [--cwd <dir>] [--verbose|-v]")}`,
-  `  ${import_chalk3.default.cyan("pr")}               Create or update GitHub PRs with AI assistance`,
-  `  ${import_chalk3.default.gray("                  merge [<pr>] (defaults: --squash --delete-branch)")}`,
-  `  ${import_chalk3.default.cyan("commit")}           Create an AI-generated commit from local changes`,
-  `  ${import_chalk3.default.gray("                  [--push] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.cyan("summary")}          Summarize a GitHub PR with AI`,
-  `  ${import_chalk3.default.gray("                  --pr <id> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.cyan("quiz")}             Manage quiz papers on quiz-api`,
-  `  ${import_chalk3.default.gray("                  create-draft --paper-id <id>")}`,
-  `  ${import_chalk3.default.gray("                  update-meta --paper-id <id> --file <metadata.json>")}`,
-  `  ${import_chalk3.default.gray("                  append-step --paper-id <id> --file <step.json>")}`,
-  `  ${import_chalk3.default.gray("                  reorder --paper-id <id> --step-ids <id1,id2,...>")}`,
-  `  ${import_chalk3.default.gray("                  activate --paper-id <id>")}`,
-  `  ${import_chalk3.default.gray("                  view --paper-id <id>")}`,
-  `  ${import_chalk3.default.gray("                  edit-step --paper-id <id> --step-id <step-id> --file <step.json> [--new-paper-id <id>] [--activate]")}`,
-  `  ${import_chalk3.default.cyan("linear")}           Create Linear issues`,
-  `  ${import_chalk3.default.gray("                  (default) create via REPL")}`,
-  `  ${import_chalk3.default.gray("                  create --repl [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  create --title <title> [--desc <markdown>]")}`,
-  `  ${import_chalk3.default.gray("                         [--team-id <id>|--team-key <key>] [--priority <0-4>]")}`,
-  `  ${import_chalk3.default.gray("                         [--parent-id <id>] [--state-id <id>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  cycle [--team-id <id>|--team-key <key>] [--account <title>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  teams [--account <title>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  whoami [--account <title>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  update <issue> [--title <title>] [--desc <markdown>]")}`,
-  `  ${import_chalk3.default.gray("                         [--team-id <id>|--team-key <key>] [--priority <0-4>]")}`,
-  `  ${import_chalk3.default.gray("                         [--parent-id <id>] [--state-id <id>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  view <issue> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  sub-issues <issue> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  comment <issue> --body <markdown> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  comments <issue> [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  user-issues <user> [--cycle <number>] [--status <status>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  issues [--query <text>] [--user <user>] [--status <status>] [--cycle <number>]")}`,
-  `  ${import_chalk3.default.gray("                         [--team-id <id>|--team-key <key>] [--limit <1-250>] [--cwd <dir>]")}`,
-  `  ${import_chalk3.default.gray("                  --pr [--cwd <dir>] (legacy)")}`,
-  `  ${import_chalk3.default.gray("                  --repl [--cwd <dir>] (legacy)")}`,
-  `  ${import_chalk3.default.gray("                  --screen-shot [--cwd <dir>] (legacy)")}`,
-  `  ${import_chalk3.default.cyan("notion")}           View, create, or update Notion pages`,
-  `  ${import_chalk3.default.gray("                  view <page-id|url>")}`,
-  `  ${import_chalk3.default.gray("                  create --title <title> (--parent <page-id|url>|--private) [--content <text>|--file <path>]")}`,
-  `  ${import_chalk3.default.gray("                  update <page-id|url> --content <text> [--append]")}`,
-  `  ${import_chalk3.default.gray("                  update <page-id|url> --file <path> [--append]")}`,
-  `  ${import_chalk3.default.cyan("qrcode")}           Capture a QR code screenshot and decode it`,
-  `  ${import_chalk3.default.cyan("oss")}              Manage OSS buckets`,
-  `  ${import_chalk3.default.gray("                  list")}`,
-  `  ${import_chalk3.default.gray("                  upload --file <path> --key <key>")}`,
-  `  ${import_chalk3.default.cyan("random")}           Generate random strings for tokens`,
-  `  ${import_chalk3.default.gray("                  [--length <n>] [--charset base64url|hex|alnum|ascii]")}`,
-  `  ${import_chalk3.default.gray("                  [--count <n>]")}`,
-  `  ${import_chalk3.default.gray("                  --easy [--words <n>] [--digits <n>] [--separator <s>] [--count <n>]")}`,
-  `  ${import_chalk3.default.cyan("collect")}          Collect threads/messages from Electron chat app via CDP`,
-  `  ${import_chalk3.default.gray("                  --list [--endpoint <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  --thread <name> [--endpoint <url>] [--json]")}`,
-  `  ${import_chalk3.default.cyan("agent")}            Manage agent registry entries via agent-ui-api`,
-  `  ${import_chalk3.default.gray("                  namespaces [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  list [--namespace <ns>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
-  `  ${import_chalk3.default.gray("                  create [<namespace>] --file <path> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  default namespace: pmate; default base URL: https://agent-api.pmate.chat")}`,
-  `  ${import_chalk3.default.cyan("ns")}               Manage registered namespaces`,
-  `  ${import_chalk3.default.gray("                  list [--chain <chain>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  get <namespace> [--chain <chain>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  create <namespace> [--chain <chain>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.cyan("role")}             Manage role definitions via auth-api`,
-  `  ${import_chalk3.default.gray("                  definition list [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  definition create <role> [--display-name <name>] [--description <text>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  default base URL: https://auth-api-v2.pmate.chat")}`,
-  `  ${import_chalk3.default.cyan("account")}          View accounts and manage account role bindings`,
-  `  ${import_chalk3.default.gray("                  view (--account <id> | --mobile <mobile> | --nickname <nickname>) [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  role list --account <id> [--namespace <ns>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  role add --account <id> --namespace <ns> --role <role> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  role remove --account <id> --namespace <ns> --role <role> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  default base URL: https://auth-api-v2.pmate.chat")}`,
-  `  ${import_chalk3.default.cyan("store")}            Manage @pmate/store namespaces, tables, and kv stores`,
-  `  ${import_chalk3.default.gray("                  namespace list [--chain <chain>] [--indexer-base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  table list|get|exists|create|update|delete <name> [options]")}`,
-  `  ${import_chalk3.default.gray("                  kv list|get|exists|set|delete <name> [options]")}`,
-  `  ${import_chalk3.default.gray("                  defaults: chain=pmate namespace=pmate env base URLs from BLOCKCHAIN_BASE_URL / INDEXER_BASE_URL")}`,
-  `  ${import_chalk3.default.cyan("app")}              Manage app registry entries via apps-api`,
-  `  ${import_chalk3.default.gray("                  list [--ns <namespace>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
-  `  ${import_chalk3.default.gray("                  create --file <path> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  default base URL: https://apps-api.pmate.chat")}`,
-  `  ${import_chalk3.default.cyan("service")}          Manage service registry entries via apps-api`,
-  `  ${import_chalk3.default.gray("                  list [--namespace <ns>] [--repo <owner/name|https://github.com/owner/name>] [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
-  `  ${import_chalk3.default.gray("                  create --file <path> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
-  `  ${import_chalk3.default.gray("                  deploy <ns:objectId> [--cwd <dir>] [--base-url <url>]")}`,
-  `  ${import_chalk3.default.gray("                  init <ns:objectId> [--cwd <dir>] [--base-url <url>]")}`,
-  `  ${import_chalk3.default.gray("                  log <ns:objectId> [--page <n>] [--history] [--search <keyword>] [--base-url <url>]")}`,
-  `  ${import_chalk3.default.gray("                  default base URL: https://apps-api.pmate.chat")}`,
-  `  ${import_chalk3.default.cyan("vercel")}           Wrap common Vercel CLI inspection commands`,
-  `  ${import_chalk3.default.gray("                  projects [--scope <scope>]")}`,
-  `  ${import_chalk3.default.gray("                  deploys --project <name> [--last-week] [--scope <scope>]")}`
+  import_chalk4.default.bold("Commands:"),
+  `  ${import_chalk4.default.cyan("list [path]")}      List apps from .pmate.yaml in the target folder`,
+  `  ${import_chalk4.default.cyan("login")}            Log in and store a session in ~/.pmate/session.json`,
+  `  ${import_chalk4.default.gray("                  [--app <app-id>]")}`,
+  `  ${import_chalk4.default.cyan("add-dns")}          Add a DNS record via Aliyun DNS`,
+  `  ${import_chalk4.default.gray("                  --type <t> --value <v> --rr <rr> [--ttl <n>] [--domain <name>]")}`,
+  `  ${import_chalk4.default.cyan("sts")}              Request an OSS STS token from the CI server`,
+  `  ${import_chalk4.default.cyan("bucket")}           Manage OSS buckets`,
+  `  ${import_chalk4.default.gray("                  --create --name <bucket> [--subdomain <name> --domain <name>]")}`,
+  `  ${import_chalk4.default.cyan("delete")}           Tear down app resources created by init`,
+  `  ${import_chalk4.default.gray("                  [app] <app-name> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.cyan("dev")}              Run the dev script for app dir from .pmate.yaml`,
+  `  ${import_chalk4.default.gray("                  <app-name> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.cyan("env")}              Manage app env vars on the server`,
+  `  ${import_chalk4.default.gray("                  <app-name> --list|--set <key> --value <value> [--delete <key>] [--cwd <dir>] [--verbose|-v]")}`,
+  `  ${import_chalk4.default.cyan("pr")}               Create or update GitHub PRs with AI assistance`,
+  `  ${import_chalk4.default.gray("                  merge [<pr>] (defaults: --squash --delete-branch)")}`,
+  `  ${import_chalk4.default.cyan("commit")}           Create an AI-generated commit from local changes`,
+  `  ${import_chalk4.default.gray("                  [--push] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.cyan("summary")}          Summarize a GitHub PR with AI`,
+  `  ${import_chalk4.default.gray("                  --pr <id> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.cyan("quiz")}             Manage quiz papers on quiz-api`,
+  `  ${import_chalk4.default.gray("                  create-draft --paper-id <id>")}`,
+  `  ${import_chalk4.default.gray("                  update-meta --paper-id <id> --file <metadata.json>")}`,
+  `  ${import_chalk4.default.gray("                  append-step --paper-id <id> --file <step.json>")}`,
+  `  ${import_chalk4.default.gray("                  update-step --paper-id <id> --step-id <step-id> --file <step.json>")}`,
+  `  ${import_chalk4.default.gray("                  reorder --paper-id <id> --step-ids <id1,id2,...>")}`,
+  `  ${import_chalk4.default.gray("                  activate --paper-id <id>")}`,
+  `  ${import_chalk4.default.gray("                  view --paper-id <id>")}`,
+  `  ${import_chalk4.default.gray("                  edit-step --paper-id <id> --step-id <step-id> --file <step.json> [--new-paper-id <id>] [--activate]")}`,
+  `  ${import_chalk4.default.cyan("linear")}           Create Linear issues`,
+  `  ${import_chalk4.default.gray("                  (default) create via REPL")}`,
+  `  ${import_chalk4.default.gray("                  create --repl [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  create --title <title> [--desc <markdown>]")}`,
+  `  ${import_chalk4.default.gray("                         [--team-id <id>|--team-key <key>] [--priority <0-4>]")}`,
+  `  ${import_chalk4.default.gray("                         [--parent-id <id>] [--state-id <id>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  cycle [--team-id <id>|--team-key <key>] [--account <title>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  teams [--account <title>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  whoami [--account <title>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  update <issue> [--title <title>] [--desc <markdown>]")}`,
+  `  ${import_chalk4.default.gray("                         [--team-id <id>|--team-key <key>] [--priority <0-4>]")}`,
+  `  ${import_chalk4.default.gray("                         [--parent-id <id>] [--state-id <id>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  view <issue> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  sub-issues <issue> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  comment <issue> --body <markdown> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  comments <issue> [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  user-issues <user> [--cycle <number>] [--status <status>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  issues [--query <text>] [--user <user>] [--status <status>] [--cycle <number>]")}`,
+  `  ${import_chalk4.default.gray("                         [--team-id <id>|--team-key <key>] [--limit <1-250>] [--cwd <dir>]")}`,
+  `  ${import_chalk4.default.gray("                  --pr [--cwd <dir>] (legacy)")}`,
+  `  ${import_chalk4.default.gray("                  --repl [--cwd <dir>] (legacy)")}`,
+  `  ${import_chalk4.default.gray("                  --screen-shot [--cwd <dir>] (legacy)")}`,
+  `  ${import_chalk4.default.cyan("notion")}           View, create, or update Notion pages`,
+  `  ${import_chalk4.default.gray("                  view <page-id|url>")}`,
+  `  ${import_chalk4.default.gray("                  create --title <title> (--parent <page-id|url>|--private) [--content <text>|--file <path>]")}`,
+  `  ${import_chalk4.default.gray("                  update <page-id|url> --content <text> [--append]")}`,
+  `  ${import_chalk4.default.gray("                  update <page-id|url> --file <path> [--append]")}`,
+  `  ${import_chalk4.default.cyan("qrcode")}           Capture a QR code screenshot and decode it`,
+  `  ${import_chalk4.default.cyan("oss")}              Manage OSS buckets`,
+  `  ${import_chalk4.default.gray("                  list")}`,
+  `  ${import_chalk4.default.gray("                  upload --file <path> --key <key>")}`,
+  `  ${import_chalk4.default.cyan("random")}           Generate random strings for tokens`,
+  `  ${import_chalk4.default.gray("                  [--length <n>] [--charset base64url|hex|alnum|ascii]")}`,
+  `  ${import_chalk4.default.gray("                  [--count <n>]")}`,
+  `  ${import_chalk4.default.gray("                  --easy [--words <n>] [--digits <n>] [--separator <s>] [--count <n>]")}`,
+  `  ${import_chalk4.default.cyan("collect")}          Collect threads/messages from Electron chat app via CDP`,
+  `  ${import_chalk4.default.gray("                  --list [--endpoint <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  --thread <name> [--endpoint <url>] [--json]")}`,
+  `  ${import_chalk4.default.cyan("agent")}            Manage agent registry entries via agent-ui-api`,
+  `  ${import_chalk4.default.gray("                  namespaces [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  list [--namespace <ns>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  create [<namespace>] --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  default namespace: pmate; default base URL: https://agent-api.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("ns")}               Manage registered namespaces`,
+  `  ${import_chalk4.default.gray("                  list [--chain <chain>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  get <namespace> [--chain <chain>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  create <namespace> [--chain <chain>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.cyan("role")}             Manage role definitions via auth-api`,
+  `  ${import_chalk4.default.gray("                  definition list [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  definition create <role> [--display-name <name>] [--description <text>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  default base URL: https://auth-api-v2.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("account")}          View accounts and manage account role bindings`,
+  `  ${import_chalk4.default.gray("                  view (--account <id> | --mobile <mobile> | --nickname <nickname>) [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  role list --account <id> [--namespace <ns>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  role add --account <id> --namespace <ns> --role <role> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  role remove --account <id> --namespace <ns> --role <role> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  default base URL: https://auth-api-v2.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("store")}            Manage @pmate/store namespaces, tables, and kv stores`,
+  `  ${import_chalk4.default.gray("                  namespace list [--chain <chain>] [--indexer-base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  table list|get|exists|create|update|delete <name> [options]")}`,
+  `  ${import_chalk4.default.gray("                  kv list|get|exists|set|delete <name> [options]")}`,
+  `  ${import_chalk4.default.gray("                  defaults: chain=pmate namespace=pmate env base URLs from BLOCKCHAIN_BASE_URL / INDEXER_BASE_URL")}`,
+  `  ${import_chalk4.default.cyan("app")}              Manage app registry entries via apps-api`,
+  `  ${import_chalk4.default.gray("                  list [--ns <namespace>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  create --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  default base URL: https://apps-api.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("service")}          Manage service registry entries via apps-api`,
+  `  ${import_chalk4.default.gray("                  list [--namespace <ns>] [--repo <owner/name|https://github.com/owner/name>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  get <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  view <ns:objectId> [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  create --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  deploy <ns:objectId> [--cwd <dir>] [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  init <ns:objectId> [--cwd <dir>] [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  log <ns:objectId> [--page <n>] [--history] [--search <keyword>] [--follow|-f] [--base-url <url>]")}`,
+  `  ${import_chalk4.default.gray("                  default base URL: https://apps-api.pmate.chat")}`,
+  `  ${import_chalk4.default.cyan("vercel")}           Wrap common Vercel CLI inspection commands`,
+  `  ${import_chalk4.default.gray("                  projects [--scope <scope>]")}`,
+  `  ${import_chalk4.default.gray("                  deploys --project <name> [--last-week] [--scope <scope>]")}`
 ].join("\n");
 function parseArgs(argv) {
   const result = { help: false, version: false, rest: [] };
@@ -22836,7 +23338,7 @@ function parseQuizArgs(tokens) {
   const rest = [...tokens];
   const action = rest.shift();
   if (!action) {
-    throw new Error("Missing quiz action. Usage: quiz create-draft|update-meta|append-step|reorder|activate|view|edit-step");
+    throw new Error("Missing quiz action. Usage: quiz create-draft|update-meta|append-step|update-step|reorder|activate|view|edit-step");
   }
   if (action === "create-draft") {
     let paperId;
@@ -22947,6 +23449,53 @@ function parseQuizArgs(tokens) {
       linkBaseUrl
     };
   }
+  if (action === "update-step") {
+    let paperId;
+    let stepId;
+    let filePath;
+    let apiBaseUrl;
+    let linkBaseUrl;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--paper-id":
+          paperId = requireValue8(rest, token);
+          break;
+        case "--step-id":
+          stepId = requireValue8(rest, token);
+          break;
+        case "--file":
+          filePath = requireValue8(rest, token);
+          break;
+        case "--base-url":
+          apiBaseUrl = requireValue8(rest, token);
+          break;
+        case "--link-base":
+          linkBaseUrl = requireValue8(rest, token);
+          break;
+        default:
+          throw new Error(`Unknown quiz update-step option: ${token}`);
+      }
+    }
+    if (!paperId) {
+      throw new Error("Missing --paper-id. Usage: quiz update-step --paper-id <id> --step-id <id> --file <step.json>.");
+    }
+    if (!stepId) {
+      throw new Error("Missing --step-id. Usage: quiz update-step --paper-id <id> --step-id <id> --file <step.json>.");
+    }
+    if (!filePath) {
+      throw new Error("Missing --file. Usage: quiz update-step --paper-id <id> --step-id <id> --file <step.json>.");
+    }
+    return {
+      type: "quiz" /* Quiz */,
+      action: "update-step",
+      paperId,
+      stepId,
+      filePath,
+      apiBaseUrl,
+      linkBaseUrl
+    };
+  }
   if (action === "reorder") {
     let paperId;
     let stepIdsRaw;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/cli",
-  "version": "0.20.3",
+  "version": "0.20.5",
   "description": "CLI utilities for the pMate project",
   "license": "MIT",
   "bin": {