@stage5/lumine 0.3.27 → 0.3.28

package/lib/admin.js

@@ -370,7 +370,7 @@ function buildApprovalOperation({ action, target, options }) {
 // Code agent passes wrote (no model is called), then review what they could
 // not settle (Mikey 2026-10-06: bulk AI work runs on Claude Code agents).
 const ENGLISH_USAGE =
-  "Use: lumine admin english import <verdicts.json> --pass a|b | adjudicate <verdicts.json> | add-questions <questions.json> | relevel <moves.json> | mastery <userId> --reason <why> | backfill-distractors | summary | review [--limit <n>] | accept|retire <questionId> [--reason <text>] | retag <questionId> --skill <code> [--reason <text>] | build-candidates [--after <questionId>] [--limit <n>] | build-import <verdicts.json>";
+  "Use: lumine admin english import <verdicts.json> --pass a|b | adjudicate <verdicts.json> | add-questions <questions.json> | relevel <moves.json> | mastery <userId> --reason <why> | backfill-distractors | summary | review [--limit <n>] | accept|retire <questionId> [--reason <text>] | retag <questionId> --skill <code> [--reason <text>] | build-candidates [--after <questionId>] [--limit <n>] | build-import <verdicts.json> | check-candidates [--after <questionId>] [--limit <n>] | check-import <verdicts.json> | check-broken [--after <questionId>] [--limit <n>]";
 const ENGLISH_IMPORT_MAX = 500;
 
 function buildEnglishOperation({ action, target, options }) {
@@ -421,6 +421,25 @@ function buildEnglishOperation({ action, target, options }) {
     }
     return writeOperation("english.build_import", "POST", "/cli/admin/english/build-chunks/import", { items }, { requiresRun: false, timeoutMs: 180000 });
   }
+  // Grammar Quest item checks (Mikey 2026-10-10): every item as each question
+  // type shows it, still waiting for the agent pass's verdict; importing its
+  // verdicts; and the items it found broken, for Mikey to decide on.
+  if (action === "check-candidates" || action === "check-broken") {
+    // the parser leaves an omitted --after as ""
+    const after = options.adminAfter ? parseRequiredInteger(options.adminAfter, "--after", 0, 2147483647) : 0;
+    return action === "check-candidates"
+      ? readOperation("english.check_candidates", withQuery("/cli/admin/english/item-checks/candidates", { after, limit: limitOf(1000, 200) }), { requiresRun: false })
+      : readOperation("english.check_broken", withQuery("/cli/admin/english/item-checks/broken", { after, limit: limitOf(500, 100) }), { requiresRun: false });
+  }
+  if (action === "check-import") {
+    if (!target) throw cliValidationError(ENGLISH_USAGE);
+    const raw = readAdminJsonFile(target, "<verdicts.json>", { maxBytes: 4 * 1024 * 1024 });
+    const items = Array.isArray(raw) ? raw : Array.isArray(raw?.items) ? raw.items : null;
+    if (!items || !items.length || items.length > ENGLISH_IMPORT_MAX) {
+      throw cliValidationError(`The file must hold 1 to ${ENGLISH_IMPORT_MAX} verdicts (an array, or { items: [...] }).`);
+    }
+    return writeOperation("english.check_import", "POST", "/cli/admin/english/item-checks/import", { items }, { requiresRun: false, timeoutMs: 300000 });
+  }
   // One learner's per-skill mastery and the sentences a report may use.
   // Private learner data: a reason is required and every read is audited.
   if (action === "mastery") {
@@ -2701,7 +2720,7 @@ export function parseAdminOperation(options) {
     // reviews as the admin controls on the website quest page. Mikey's own
     // decision, any time, never in a daily run.
     const usage =
-      "Usage: lumine admin meetup list [--status review|active|completed|all] | approve-crew <crewId> | approve-grownup <crewId> | request-changes <crewId> --note <text> | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | parent-reply <crewId> <memberUserId> --note <text> | funnel [--days <1-90>] | branches [list|show|approve|reject|merge] | show <crewId> | approve-plan <crewId> [--note <text>] | send-back <crewId> --note <text> | approve <crewId> --attended <userId,userId,...> [--note <text>] | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>.";
+      "Usage: lumine admin meetup list [--status review|active|completed|all] | approve-crew <crewId> | approve-grownup <crewId> | request-changes <crewId> --note <text> | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | parent-reply <crewId> <memberUserId> --note <text> | funnel [--days <1-90>] | branches [list|show|approve|reject|merge] | show <crewId> | approve-plan <crewId> [--note <text>] | send-back <crewId> --note <text> | approve <crewId> --attended <userId,userId,...> [--note <text>] | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | set-branch <crewId> <userId> --branch <name> [--note <text>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>.";
     const note = String(options.note || "").trim();
     if (note.length > 1000) {
       throw cliValidationError("--note must be at most 1000 characters.");
@@ -2889,6 +2908,30 @@ export function parseAdminOperation(options) {
         { requiresRun: false },
       );
     }
+    if (action === "set-branch") {
+      // Staff correct a member's branch (Mikey 2026-10-10) instead of a
+      // database write: an official branch (verified at once), a name in the
+      // branch registry, or "Not a Twinkle student". Former students get the
+      // branch they went to. The note is private to admins; nobody is messaged.
+      const crewId = parseRequiredInteger(target, "Crew ID", 1);
+      const memberId = parseRequiredInteger(extra, "Member user ID", 1);
+      const branch = String(options.adminBranch || "").trim();
+      if (!branch) {
+        throw cliValidationError(
+          'lumine admin meetup set-branch <crewId> <userId> needs --branch "<official branch>" (or --branch "Not a Twinkle student").',
+        );
+      }
+      if (branch.includes(",")) {
+        throw cliValidationError("set-branch takes exactly one --branch.");
+      }
+      return writeOperation(
+        "meetup.set-branch",
+        "POST",
+        `/cli/admin/meetup-quest/crews/${crewId}/members/${memberId}/branch`,
+        { branch, note },
+        { requiresRun: false },
+      );
+    }
     if (action === "request-changes") {
       const crewId = parseRequiredInteger(target, "Crew ID", 1);
       if (!note) throw cliValidationError("request-changes needs --note <what the whole crew must change>.");
@@ -5973,6 +6016,12 @@ function printMeetupCrew(crew) {
       `  Who-are-you check #${check.checkId} · ${check.username} (${check.userId}) · crew #${check.crewId} · ${check.status}${check.askNote ? ` · asked: "${check.askNote}"` : ""} · ${answer}${check.reviewedBy ? ` · ${check.status} by ${check.reviewedBy}` : ""}${check.staffNote ? ` · note: ${check.staffNote}` : ""}`,
     );
   }
+  // staff's branch corrections (admins only), newest first
+  for (const change of crew.branchChanges || []) {
+    console.log(
+      `  Branch set by ${change.actorUsername || "staff"} ${shortDate(change.createdAt)} · ${change.username} (${change.userId}): "${change.oldBranch || "none"}" -> "${change.newBranch}"${change.note ? ` · private note: ${change.note}` : ""}`,
+    );
+  }
   for (const parent of crew.parentContacts || []) {
     console.log(
       `  Parent of ${parent.childUsername}: ${parent.status}${parent.verifiedGuardian ? " (guardian on file)" : parent.staffVerified ? " (staff verified)" : " (child-typed address: NOT verified)"} · ${parent.email}${parent.question ? ` · asks: "${parent.question}"` : ""}`,
@@ -6129,6 +6178,16 @@ function printMeetupResult({ operation, data, result }) {
     if (data.crew) printMeetupCrew(data.crew);
     return;
   }
+  if (operation.name === "meetup.set-branch") {
+    const r = data.result || {};
+    console.log(
+      result?.changed === false
+        ? `Member ${r.userId} on crew #${r.crewId} already has branch "${r.branch}". Nothing changed.`
+        : `Member ${r.userId} on crew #${r.crewId}: branch "${r.oldBranch || "none"}" -> "${r.branch}"${r.branchVerified ? " (verified)" : r.branchStatus === "pending" ? " (waits for its branch decision)" : ""}.`,
+    );
+    if (data.crew) printMeetupCrew(data.crew);
+    return;
+  }
   if (operation.name === "meetup.show" || operation.name === "meetup.parent-reply") {
     printMeetupCrew(data.crew || {});
     return;

package/lib/commands.js

@@ -3200,7 +3200,7 @@ export function printHelp() {
   lumine admin reward-review list [--status pending|approved|all] [--cursor <id>] [--json]
   lumine admin cardcraft-review list [--status pending|approved|all] [--cursor <id>] | show <id> | approve|reject|revoke <id> [--reason <text>]
   lumine admin storage list [--status pending|approved|rejected|all] [--cursor <id>] | show <user-id-or-username> | approve <request-id> [--size <500MB|1GB|2GB|n MB>] [--reason <text>] | reject <request-id> [--reason <text>] | grant <user-id-or-username> --size <500MB|1GB|2GB|n MB> [--reason <text>]
-  lumine admin meetup list [--status review|active|completed|all] | approve-crew <crewId> | approve-grownup <crewId> | request-changes <crewId> --note <text> | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | parent-reply <crewId> <memberUserId> --note <text> | funnel [--days <1-90>] | branches [list [--status pending|official|rejected|all] | show <id> | approve <id> | reject <id> [--note <text>] | merge <id> --into <officialId>] | show <crewId> | approve-plan <crewId> [--note <text>] | send-back <crewId> --note <text> | approve <crewId> --attended <userId,userId,...> [--note <text>] | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>   (Bridge Builder meetup quest)
+  lumine admin meetup list [--status review|active|completed|all] | approve-crew <crewId> | approve-grownup <crewId> | request-changes <crewId> --note <text> | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | parent-reply <crewId> <memberUserId> --note <text> | funnel [--days <1-90>] | branches [list [--status pending|official|rejected|all] | show <id> | approve <id> | reject <id> [--note <text>] | merge <id> --into <officialId>] | show <crewId> | approve-plan <crewId> [--note <text>] | send-back <crewId> --note <text> | approve <crewId> --attended <userId,userId,...> [--note <text>] | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | set-branch <crewId> <userId> --branch "<name>" [--note <text>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>   (Bridge Builder meetup quest)
   lumine admin meetup story list | show <crewId> | approve <crewId> [--note <text>] [--no-announce] | send-back <crewId> --note <text> | unpublish <crewId> --note <text>   (Bridge Builder story pages: publishes only what every tagged member's parent allowed)
   lumine admin reward-activity [--date YYYY-MM-DD] [--days <1..31>] [--build <id>] [--json]
   lumine admin chat-reports list [--status pending|open|reviewing|resolved|dismissed|all] [--cursor <id>] [--json]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage5/lumine",
-  "version": "0.3.27",
+  "version": "0.3.28",
   "description": "Command line tools for launching Lumine builds on Twinkle.",
   "type": "module",
   "bin": {

package/sdk/LUMINE_ADMIN.md

@@ -5083,11 +5083,14 @@ For total JEV cost, include `dailyAiCosts.byProviderModel` for TypeSafe/JEV acro
 
 ## Bridge Builder crew reviews (no daily run required)
 
+On the website, Zero and Ciel acting for an admin can make these staff decisions too (who-are-you checks, branch corrections, crew, plan and branch reviews), through the same routes the admin's own taps use and only after the admin's yes on the approval card (Mikey, 2026-10-10). A member's Zero or Ciel still cannot.
+
 - `lumine admin meetup list` shows steps waiting for staff. Use `list --status active` to include crews making requested changes.
 - `lumine admin meetup show <crewId>` shows canonical progress, approval status, shared feedback, and private staff evidence.
 - `lumine admin meetup approve-crew <crewId>` and `approve-grownup <crewId>` approve the corresponding ready step.
 - `lumine admin meetup request-changes <crewId> --note <text>` holds the current crew or grown-up step, displays the note to **every crew member**, and announces it in the crew chat. The note is required (maximum 1,000 characters). Members use **Request review again** after making changes; this alerts staff and returns the step to the queue without approving it.
 - `lumine admin meetup send-back <crewId> --note <text>` is for a pending plan or video. Those steps keep their existing revise-and-submit flow.
 - `lumine admin meetup info <crewId> <userId> --decision ask|accept|ask-again|withdraw` is a **private identity check**. Its question and answer are visible only to the named member and staff. Use `request-changes`, not `info`, for instructions the whole crew needs to see.
+- `lumine admin meetup set-branch <crewId> <userId> --branch <name> [--note <text>]` corrects a member's branch instead of a database write. `--branch` must be an official branch (a registry alias such as `Busan` resolves to its official name, `Haeundae`), a name still pending in the branch registry, or `"Not a Twinkle student"`. Former Twinkle students get the branch they went to. An official branch is verified at once; a pending name waits for its branch decision. The crew's progress, tier and staff alerts follow the new branch; approvals already given stay. The same branch again changes nothing. The private note and the change history are shown only to admins (`meetup show`, the crew page's staff panel); nobody is messaged. The command refuses members who left and crews that are not active.
 
 Every decision requires Mikey's authorization for that crew and action. Mutations are audited and idempotent; `--output <path>` is an explicit request to retain the canonical JSON. General write receipts omit private crew details.