@pmate/cli 0.20.1 → 0.20.3

package/dist/index.d.ts

@@ -121,12 +121,31 @@ type SummaryCommandArgs = {
 };
 type QuizCommandArgs = {
     type: Command.Quiz;
-    action: "publish";
+    action: "create-draft";
+    paperId: string;
+    apiBaseUrl?: string;
+    linkBaseUrl?: string;
+} | {
+    type: Command.Quiz;
+    action: "update-meta";
+    paperId: string;
     filePath: string;
+    apiBaseUrl?: string;
+    linkBaseUrl?: string;
+} | {
+    type: Command.Quiz;
+    action: "append-step";
     paperId: string;
+    filePath: string;
+    apiBaseUrl?: string;
+    linkBaseUrl?: string;
+} | {
+    type: Command.Quiz;
+    action: "reorder";
+    paperId: string;
+    stepIds: string[];
     apiBaseUrl?: string;
     linkBaseUrl?: string;
-    activate: boolean;
 } | {
     type: Command.Quiz;
     action: "activate";

package/dist/index.js

@@ -13271,7 +13271,14 @@ var LoginCommandHandler = class {
     if (!token) {
       response.statusCode = 400;
       response.setHeader("Content-Type", "text/html; charset=utf-8");
-      response.end(this.renderHtml("Login failed", "Missing sessionId in redirect URL."));
+      response.end(
+        this.renderHtml({
+          state: "error",
+          title: "Login failed",
+          message: "Missing sessionId in redirect URL.",
+          hint: "Please retry from your terminal with `pmate login`."
+        })
+      );
       rejectToken(new Error("Login callback did not include sessionId."));
       return;
     }
@@ -13280,30 +13287,106 @@ var LoginCommandHandler = class {
     response.setHeader("Connection", "close");
     response.end(
       this.renderHtml(
-        "Login complete",
-        "You can close this tab and return to the terminal."
+        {
+          state: "success",
+          title: "Login complete",
+          message: "You can close this tab and return to the terminal.",
+          hint: "This window is only used to hand the session back to PMate CLI."
+        }
       ),
       () => resolveToken(token)
     );
   }
-  renderHtml(title, message) {
+  renderHtml(input) {
+    const badgeBg = input.state === "success" ? "#ecfdf3" : "#fff1f2";
+    const badgeText = input.state === "success" ? "#027a48" : "#be123c";
+    const dotColor = input.state === "success" ? "#10b981" : "#f43f5e";
+    const stateText = input.state === "success" ? "Ready" : "Action required";
+    const hint = input.hint?.trim();
     return `<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>${title}</title>
+    <title>${input.title}</title>
     <style>
-      body { font-family: -apple-system, BlinkMacSystemFont, sans-serif; padding: 32px; color: #111; }
-      main { max-width: 560px; margin: 10vh auto; }
-      h1 { font-size: 28px; margin-bottom: 12px; }
-      p { font-size: 16px; line-height: 1.5; }
+      :root {
+        color-scheme: light;
+      }
+      * {
+        box-sizing: border-box;
+      }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        font-family: ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+        color: #0f172a;
+        background:
+          radial-gradient(circle at 18% 18%, #e0f2fe 0, transparent 36%),
+          radial-gradient(circle at 82% 14%, #e0e7ff 0, transparent 34%),
+          linear-gradient(180deg, #f8fafc 0%, #eef2ff 100%);
+        display: grid;
+        place-items: center;
+        padding: 24px;
+      }
+      main {
+        width: min(560px, 100%);
+        border-radius: 28px;
+        border: 1px solid rgba(15, 23, 42, 0.08);
+        background: rgba(255, 255, 255, 0.9);
+        box-shadow:
+          0 22px 56px rgba(15, 23, 42, 0.14),
+          inset 0 1px 0 rgba(255, 255, 255, 0.75);
+        backdrop-filter: blur(8px);
+        padding: 28px;
+      }
+      .badge {
+        display: inline-flex;
+        align-items: center;
+        gap: 8px;
+        border-radius: 999px;
+        padding: 8px 12px;
+        font-size: 14px;
+        font-weight: 600;
+        background: ${badgeBg};
+        color: ${badgeText};
+      }
+      .dot {
+        width: 10px;
+        height: 10px;
+        border-radius: 999px;
+        background: ${dotColor};
+      }
+      h1 {
+        margin: 16px 0 8px;
+        font-size: 32px;
+        line-height: 1.18;
+        letter-spacing: -0.03em;
+      }
+      p {
+        margin: 0;
+        font-size: 16px;
+        line-height: 1.6;
+        color: #334155;
+      }
+      .hint {
+        margin-top: 16px;
+        border-radius: 14px;
+        background: rgba(148, 163, 184, 0.14);
+        padding: 12px 14px;
+        font-size: 14px;
+      }
     </style>
   </head>
   <body>
     <main>
-      <h1>${title}</h1>
-      <p>${message}</p>
+      <div class="badge">
+        <span class="dot"></span>
+        <span>${stateText}</span>
+      </div>
+      <h1>${input.title}</h1>
+      <p>${input.message}</p>
+      ${hint ? `<p class="hint">${hint}</p>` : ""}
     </main>
   </body>
 </html>`;
@@ -17964,24 +18047,24 @@ init_sessionStore();
 
 // src/services/QuizService.ts
 var INTRO_STEP_COUNT = 2;
-var QUIZ_APP_ID = "quiz";
+var QUIZ_APP_ID = "pmate:quiz";
 var DEFAULT_MIN_LENGTHS = Object.freeze({
-  knowledgeSummary: 36,
+  teachingArticle: 36,
   explanation: 60
 });
 var INTRO_MIN_LENGTHS = Object.freeze({
-  knowledgeSummary: 90,
-  knowledgeNote: 36,
+  teachingArticle: 90,
+  teachingTip: 36,
   explanation: 90
 });
 var FIELD_RULES = Object.freeze({
-  knowledgeSummary: Object.freeze({
-    label: "knowledgeSummary\uFF08\u77E5\u8BC6\u8BB2\u89E3\uFF09",
+  teachingArticle: Object.freeze({
+    label: "teachingArticle\uFF08\u6559\u5B66\u77ED\u6587\uFF09",
     defaultHint: "\u77E5\u8BC6\u8BB2\u89E3\u81F3\u5C11\u8981\u5148\u628A\u9898\u76EE\u524D\u63D0\u8BF4\u6E05\u695A\uFF0C\u518D\u8BA9\u7528\u6237\u53BB\u9009\u7B54\u6848\u3002",
     introHint: "\u5F00\u573A\u9898\u81F3\u5C11\u8981\u8BB2\u6E05\u5B83\u662F\u4EC0\u4E48\u3001\u89E3\u51B3\u4EC0\u4E48\u95EE\u9898\uFF0C\u4EE5\u53CA\u8BFB\u8005\u63A5\u4E0B\u6765\u8BE5\u5E26\u7740\u4EC0\u4E48\u7406\u89E3\u8DEF\u5F84\u7EE7\u7EED\u5F80\u4E0B\u770B\u3002"
   }),
-  knowledgeNote: Object.freeze({
-    label: "knowledgeNote\uFF08\u8865\u5145\u8BF4\u660E\uFF09",
+  teachingTip: Object.freeze({
+    label: "teachingTip\uFF08\u8865\u5145\u8BF4\u660E\uFF09",
     introHint: "\u5F00\u573A\u9898\u8981\u8865\u5145\u4E3A\u4EC0\u4E48\u5BB9\u6613\u8BEF\u89E3\uFF0C\u6216\u8005\u7B2C\u4E00\u6B21\u8BFB\u8FD9\u5757\u5185\u5BB9\u65F6\u5E94\u8BE5\u5148\u770B\u54EA\u91CC\u3002"
   }),
   explanation: Object.freeze({
@@ -18021,9 +18104,9 @@ function validateQuizPaperPayload(payload) {
     assertMinLength(
       step,
       index,
-      "knowledgeSummary",
-      DEFAULT_MIN_LENGTHS.knowledgeSummary,
-      FIELD_RULES.knowledgeSummary.defaultHint
+      "teachingArticle",
+      DEFAULT_MIN_LENGTHS.teachingArticle,
+      FIELD_RULES.teachingArticle.defaultHint
     );
     assertMinLength(
       step,
@@ -18038,16 +18121,16 @@ function validateQuizPaperPayload(payload) {
     assertMinLength(
       step,
       index,
-      "knowledgeSummary",
-      INTRO_MIN_LENGTHS.knowledgeSummary,
-      FIELD_RULES.knowledgeSummary.introHint
+      "teachingArticle",
+      INTRO_MIN_LENGTHS.teachingArticle,
+      FIELD_RULES.teachingArticle.introHint
     );
     assertMinLength(
       step,
       index,
-      "knowledgeNote",
-      INTRO_MIN_LENGTHS.knowledgeNote,
-      FIELD_RULES.knowledgeNote.introHint
+      "teachingTip",
+      INTRO_MIN_LENGTHS.teachingTip,
+      FIELD_RULES.teachingTip.introHint
     );
     assertMinLength(
       step,
@@ -18195,6 +18278,131 @@ async function activateQuizPaper({
     data: activated
   };
 }
+async function createQuizDraft({
+  fetchImpl = fetch,
+  apiBaseUrl,
+  linkBaseUrl,
+  paperId,
+  token
+}) {
+  const trimmedApiBaseUrl = apiBaseUrl.replace(/\/+$/, "");
+  const trimmedLinkBaseUrl = linkBaseUrl.replace(/\/+$/, "");
+  const previewLink = `${trimmedLinkBaseUrl}/?paper=${encodeURIComponent(paperId)}`;
+  const data = await requestJson(
+    fetchImpl,
+    `${trimmedApiBaseUrl}/api/quiz/papers`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ paperId })
+    },
+    "\u521B\u5EFA\u8349\u7A3F"
+  );
+  return {
+    apiBaseUrl: trimmedApiBaseUrl,
+    paperId,
+    previewLink,
+    data
+  };
+}
+async function updateQuizPaperMetadata({
+  fetchImpl = fetch,
+  apiBaseUrl,
+  linkBaseUrl,
+  paperId,
+  metadata,
+  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)}`,
+    {
+      method: "PATCH",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(metadata)
+    },
+    "\u66F4\u65B0\u8BD5\u5377\u5143\u4FE1\u606F"
+  );
+  return {
+    apiBaseUrl: trimmedApiBaseUrl,
+    paperId,
+    previewLink,
+    data
+  };
+}
+async function appendQuizPaperStep({
+  fetchImpl = fetch,
+  apiBaseUrl,
+  linkBaseUrl,
+  paperId,
+  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`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(step)
+    },
+    `\u8FFD\u52A0\u9898\u76EE\uFF08${String(step?.stepId ?? "unknown-step")}\uFF09`
+  );
+  return {
+    apiBaseUrl: trimmedApiBaseUrl,
+    paperId,
+    previewLink,
+    data
+  };
+}
+async function reorderQuizPaperSteps({
+  fetchImpl = fetch,
+  apiBaseUrl,
+  linkBaseUrl,
+  paperId,
+  stepIds,
+  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/reorder`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        stepIds
+      })
+    },
+    "\u91CD\u6392\u9898\u76EE\u987A\u5E8F"
+  );
+  return {
+    apiBaseUrl: trimmedApiBaseUrl,
+    paperId,
+    previewLink,
+    data
+  };
+}
 async function viewQuizPaper({
   fetchImpl = fetch,
   apiBaseUrl,
@@ -18257,26 +18465,76 @@ var QuizCommandHandler = class {
     const apiBaseUrl = args.apiBaseUrl || DEFAULT_QUIZ_API_BASE_URL;
     const linkBaseUrl = args.linkBaseUrl || DEFAULT_QUIZ_LINK_BASE_URL;
     if (args.action === "activate") {
-      const result2 = await activateQuizPaper({
+      const result = await activateQuizPaper({
+        apiBaseUrl,
+        linkBaseUrl,
+        paperId: args.paperId,
+        token: session.token
+      });
+      ui.success("Quiz \u5DF2\u6FC0\u6D3B\u53D1\u5E03", result.link);
+      return;
+    }
+    if (args.action === "create-draft") {
+      const result = await createQuizDraft({
         apiBaseUrl,
         linkBaseUrl,
         paperId: args.paperId,
         token: session.token
       });
-      ui.success("Quiz \u5DF2\u6FC0\u6D3B\u53D1\u5E03", result2.link);
+      ui.success("Quiz \u8349\u7A3F\u5DF2\u521B\u5EFA", result.previewLink);
+      ui.info("\u72B6\u6001", "draft");
+      return;
+    }
+    if (args.action === "update-meta") {
+      const resolvedFilePath = import_node_path14.default.resolve(process.cwd(), args.filePath);
+      const metadata = JSON.parse((0, import_node_fs9.readFileSync)(resolvedFilePath, "utf8"));
+      const result = await updateQuizPaperMetadata({
+        apiBaseUrl,
+        linkBaseUrl,
+        paperId: args.paperId,
+        metadata,
+        token: session.token
+      });
+      ui.success("Quiz \u5143\u4FE1\u606F\u5DF2\u66F4\u65B0", result.previewLink);
+      return;
+    }
+    if (args.action === "append-step") {
+      const resolvedFilePath = import_node_path14.default.resolve(process.cwd(), args.filePath);
+      const step = JSON.parse((0, import_node_fs9.readFileSync)(resolvedFilePath, "utf8"));
+      const result = await appendQuizPaperStep({
+        apiBaseUrl,
+        linkBaseUrl,
+        paperId: args.paperId,
+        step,
+        token: session.token
+      });
+      ui.success("Quiz \u9898\u76EE\u5DF2\u8FFD\u52A0", result.previewLink);
+      ui.info("stepId", String(step.stepId));
+      return;
+    }
+    if (args.action === "reorder") {
+      const result = await reorderQuizPaperSteps({
+        apiBaseUrl,
+        linkBaseUrl,
+        paperId: args.paperId,
+        stepIds: args.stepIds,
+        token: session.token
+      });
+      ui.success("Quiz \u9898\u76EE\u987A\u5E8F\u5DF2\u66F4\u65B0", result.previewLink);
+      ui.info("\u6570\u91CF", String(args.stepIds.length));
       return;
     }
     if (args.action === "view") {
-      const result2 = await viewQuizPaper({
+      const result = await viewQuizPaper({
         apiBaseUrl,
         linkBaseUrl,
         paperId: args.paperId,
         token: session.token
       });
-      ui.success("Quiz \u8BD5\u5377\u5DF2\u627E\u5230", result2.previewLink);
-      ui.info("\u72B6\u6001", result2.paperStatus);
-      if (typeof result2.stepCount === "number") {
-        ui.info("\u9898\u76EE\u6570", String(result2.stepCount));
+      ui.success("Quiz \u8BD5\u5377\u5DF2\u627E\u5230", result.previewLink);
+      ui.info("\u72B6\u6001", result.paperStatus);
+      if (typeof result.stepCount === "number") {
+        ui.info("\u9898\u76EE\u6570", String(result.stepCount));
       }
       return;
     }
@@ -18291,13 +18549,13 @@ var QuizCommandHandler = class {
       if (targetIndex < 0) {
         throw new Error(`\u672A\u627E\u5230 stepId=${args.stepId}\uFF0C\u65E0\u6CD5\u66F4\u65B0\u8BE5\u9898\u76EE\u3002`);
       }
-      const resolvedFilePath2 = import_node_path14.default.resolve(process.cwd(), args.filePath);
-      const nextStep = JSON.parse((0, import_node_fs9.readFileSync)(resolvedFilePath2, "utf8"));
+      const resolvedFilePath = import_node_path14.default.resolve(process.cwd(), args.filePath);
+      const nextStep = JSON.parse((0, import_node_fs9.readFileSync)(resolvedFilePath, "utf8"));
       nextStep.stepId = args.stepId;
       const nextSteps = [...basePaper.steps];
       nextSteps[targetIndex] = nextStep;
       const nextPaperId = args.newPaperId || `${args.paperId}-rev-${this.timestampTag()}`;
-      const result2 = await publishQuizPaper({
+      const result = await publishQuizPaper({
         apiBaseUrl,
         linkBaseUrl,
         paperId: nextPaperId,
@@ -18311,37 +18569,20 @@ var QuizCommandHandler = class {
         token: session.token,
         activate: args.activate
       });
-      if (result2.status === "draft") {
-        ui.success("Quiz \u5355\u9898\u4FEE\u8BA2\u7A3F\u5DF2\u521B\u5EFA", result2.previewLink);
+      if (result.status === "draft") {
+        ui.success("Quiz \u5355\u9898\u4FEE\u8BA2\u7A3F\u5DF2\u521B\u5EFA", result.previewLink);
         ui.info("\u6765\u6E90\u8BD5\u5377", args.paperId);
         ui.info("\u4FEE\u8BA2\u9898\u76EE", args.stepId);
         ui.info("\u65B0\u8BD5\u5377", nextPaperId);
         ui.info("\u4E0B\u4E00\u6B65", `pmate quiz activate --paper-id ${nextPaperId}`);
         return;
       }
-      ui.success("Quiz \u5355\u9898\u4FEE\u8BA2\u7A3F\u5DF2\u53D1\u5E03", result2.link);
+      ui.success("Quiz \u5355\u9898\u4FEE\u8BA2\u7A3F\u5DF2\u53D1\u5E03", result.link);
       ui.info("\u6765\u6E90\u8BD5\u5377", args.paperId);
       ui.info("\u4FEE\u8BA2\u9898\u76EE", args.stepId);
       ui.info("\u65B0\u8BD5\u5377", nextPaperId);
       return;
     }
-    const resolvedFilePath = import_node_path14.default.resolve(process.cwd(), args.filePath);
-    const payload = JSON.parse((0, import_node_fs9.readFileSync)(resolvedFilePath, "utf8"));
-    const result = await publishQuizPaper({
-      apiBaseUrl,
-      linkBaseUrl,
-      paperId: args.paperId,
-      payload,
-      token: session.token,
-      activate: args.activate
-    });
-    if (result.status === "draft") {
-      ui.success("Quiz \u8349\u7A3F\u5DF2\u521B\u5EFA", result.previewLink);
-      ui.info("\u72B6\u6001", "draft");
-      ui.info("\u4E0B\u4E00\u6B65", `pmate quiz activate --paper-id ${args.paperId}`);
-      return;
-    }
-    ui.success("Quiz \u5DF2\u53D1\u5E03", result.link);
   }
   timestampTag() {
     const now = /* @__PURE__ */ new Date();
@@ -21992,7 +22233,10 @@ var HELP_TEXT = [
   `  ${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("                  publish --file <json> --paper-id <id> [--activate]")}`,
+  `  ${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]")}`,
@@ -22592,50 +22836,158 @@ function parseQuizArgs(tokens) {
   const rest = [...tokens];
   const action = rest.shift();
   if (!action) {
-    throw new Error("Missing quiz action. Usage: quiz publish|activate|view");
+    throw new Error("Missing quiz action. Usage: quiz create-draft|update-meta|append-step|reorder|activate|view|edit-step");
   }
-  if (action === "publish") {
-    let filePath;
+  if (action === "create-draft") {
     let paperId;
     let apiBaseUrl;
     let linkBaseUrl;
-    let activate = false;
     while (rest.length > 0) {
       const token = rest.shift();
       switch (token) {
+        case "--paper-id":
+          paperId = 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 create-draft option: ${token}`);
+      }
+    }
+    if (!paperId) {
+      throw new Error("Missing --paper-id. Usage: quiz create-draft --paper-id <id>.");
+    }
+    return {
+      type: "quiz" /* Quiz */,
+      action: "create-draft",
+      paperId,
+      apiBaseUrl,
+      linkBaseUrl
+    };
+  }
+  if (action === "update-meta") {
+    let paperId;
+    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 "--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-meta option: ${token}`);
+      }
+    }
+    if (!paperId) {
+      throw new Error("Missing --paper-id. Usage: quiz update-meta --paper-id <id> --file <metadata.json>.");
+    }
+    if (!filePath) {
+      throw new Error("Missing --file. Usage: quiz update-meta --paper-id <id> --file <metadata.json>.");
+    }
+    return {
+      type: "quiz" /* Quiz */,
+      action: "update-meta",
+      paperId,
+      filePath,
+      apiBaseUrl,
+      linkBaseUrl
+    };
+  }
+  if (action === "append-step") {
+    let paperId;
+    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 "--file":
+          filePath = requireValue8(rest, token);
+          break;
         case "--base-url":
           apiBaseUrl = requireValue8(rest, token);
           break;
         case "--link-base":
           linkBaseUrl = requireValue8(rest, token);
           break;
-        case "--activate":
-          activate = true;
-          break;
         default:
-          throw new Error(`Unknown quiz publish option: ${token}`);
+          throw new Error(`Unknown quiz append-step option: ${token}`);
       }
     }
+    if (!paperId) {
+      throw new Error("Missing --paper-id. Usage: quiz append-step --paper-id <id> --file <step.json>.");
+    }
     if (!filePath) {
-      throw new Error("Missing --file. Usage: quiz publish --file <json> --paper-id <id>.");
+      throw new Error("Missing --file. Usage: quiz append-step --paper-id <id> --file <step.json>.");
+    }
+    return {
+      type: "quiz" /* Quiz */,
+      action: "append-step",
+      paperId,
+      filePath,
+      apiBaseUrl,
+      linkBaseUrl
+    };
+  }
+  if (action === "reorder") {
+    let paperId;
+    let stepIdsRaw;
+    let apiBaseUrl;
+    let linkBaseUrl;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      switch (token) {
+        case "--paper-id":
+          paperId = requireValue8(rest, token);
+          break;
+        case "--step-ids":
+          stepIdsRaw = 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 reorder option: ${token}`);
+      }
     }
     if (!paperId) {
-      throw new Error("Missing --paper-id. Usage: quiz publish --file <json> --paper-id <id>.");
+      throw new Error("Missing --paper-id. Usage: quiz reorder --paper-id <id> --step-ids <id1,id2,...>.");
+    }
+    if (!stepIdsRaw) {
+      throw new Error("Missing --step-ids. Usage: quiz reorder --paper-id <id> --step-ids <id1,id2,...>.");
+    }
+    const stepIds = stepIdsRaw.split(",").map((item) => item.trim()).filter(Boolean);
+    if (stepIds.length === 0) {
+      throw new Error("Invalid --step-ids. At least one step id is required.");
     }
     return {
       type: "quiz" /* Quiz */,
-      action: "publish",
-      filePath,
+      action: "reorder",
       paperId,
+      stepIds,
       apiBaseUrl,
-      linkBaseUrl,
-      activate
+      linkBaseUrl
     };
   }
   if (action === "activate") {

package/package.json

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