@stage5/lumine 0.3.29 → 0.3.31

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> | check-candidates [--after <questionId>] [--limit <n>] | check-import <verdicts.json> | check-broken [--after <questionId>] [--limit <n>] | check-apply <fixes.json> | check-verify <checked.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>] [--fault] | 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>] | check-apply <fixes.json> | check-verify <checked.json> | check-follow-faulty [--after <next>] [--limit <n>] | lesson-candidates [--after <skillCode>] [--limit <n>] | lesson-import <lessons.json> | lesson-approve <approvals.json> | lessons [--status draft|approved]";
 const ENGLISH_IMPORT_MAX = 500;
 
 function buildEnglishOperation({ action, target, options }) {
@@ -444,6 +444,34 @@ function buildEnglishOperation({ action, target, options }) {
     }
     return writeOperation("english.check_verify", "POST", "/cli/admin/english/item-checks/verify", { items }, { requiresRun: false, timeoutMs: 300000 });
   }
+  // the round-21 catch-up (boss misses uncounted, versions found at fault
+  // broken for every learner, every check followed again): one page per
+  // call, repeat with the reply's `next` until it is null
+  if (action === "check-follow-faulty") {
+    const after = options.adminAfter ? String(options.adminAfter) : "";
+    if (after && !/^(?:[ufc]:)?\d+:\d+$/.test(after)) throw cliValidationError("--after takes the last reply's next (<phase:id:version>).");
+    return writeOperation("english.check_follow_faulty", "POST", "/cli/admin/english/item-checks/follow-faulty", { after, limit: limitOf(200, 100) }, { requiresRun: false, timeoutMs: 300000 });
+  }
+  // Grammar Quest lessons (Mikey 2026-10-11): what the writing pass draws on
+  // (each rule-first point with live sound questions on it), importing
+  // drafts, approving reviewed versions [{ skillCode, version }], the list
+  if (action === "lesson-candidates") {
+    const after = options.adminAfter ? String(options.adminAfter) : "";
+    return readOperation("english.lesson_candidates", withQuery("/cli/admin/english/lessons/candidates", { after, limit: limitOf(64, 20) }), { requiresRun: false });
+  }
+  if (action === "lesson-import" || action === "lesson-approve") {
+    if (!target) throw cliValidationError(ENGLISH_USAGE);
+    const raw = readAdminJsonFile(target, "<file.json>", { maxBytes: 2 * 1024 * 1024 });
+    const items = Array.isArray(raw) ? raw : Array.isArray(raw?.items) ? raw.items : null;
+    if (!items || !items.length || items.length > 100) throw cliValidationError("The file must hold 1 to 100 entries (an array, or { items: [...] }).");
+    const path = action === "lesson-import" ? "/cli/admin/english/lessons/import" : "/cli/admin/english/lessons/approve";
+    return writeOperation(action === "lesson-import" ? "english.lesson_import" : "english.lesson_approve", "POST", path, { items }, { requiresRun: false, timeoutMs: 180000 });
+  }
+  if (action === "lessons") {
+    const status = options.adminStatus || "";
+    if (status && !["draft", "approved"].includes(status)) throw cliValidationError("--status is draft or approved.");
+    return readOperation("english.lessons", withQuery("/cli/admin/english/lessons", status ? { status } : {}), { requiresRun: false });
+  }
   if (action === "check-apply") {
     if (!target) throw cliValidationError(ENGLISH_USAGE);
     const raw = readAdminJsonFile(target, "<fixes.json>", { maxBytes: 4 * 1024 * 1024 });
@@ -487,7 +515,14 @@ function buildEnglishOperation({ action, target, options }) {
       "english.decide",
       "POST",
       `/cli/admin/english/review/${ref}`,
-      { action, skillCode: options.adminSkill || undefined, reason: String(options.adminReason || "").trim() || undefined },
+      {
+        action,
+        skillCode: options.adminSkill || undefined,
+        reason: String(options.adminReason || "").trim() || undefined,
+        // retire --fault (Mikey 10-11): the question was at fault, so Grammar
+        // Quest forgives every miss on it; a duplicate or off-topic retire isn't
+        ...(action === "retire" && options.adminFault ? { fault: true } : {}),
+      },
       { requiresRun: false },
     );
   }

package/lib/commands.js

@@ -2440,6 +2440,7 @@ export function parseArgs(args) {
   const positional = [];
   const booleanFlags = new Set([
     "remove",
+    "fault",
     "noAnnounce",
     "noLeaseKeeper",
     "noOpen",
@@ -2759,6 +2760,8 @@ export function parseArgs(args) {
     twinkles: raw.twinkles ? String(raw.twinkles) : "",
     adminReason: raw.reason ? String(raw.reason) : "",
     adminSkill: raw.skill ? String(raw.skill) : "",
+    // admin english retire --fault: the question was at fault (Grammar Quest forgives its misses)
+    adminFault: Boolean(raw.fault),
     // --branch may repeat (a building two branches share); --branches A,B too
     adminBranch: [raw.branch, raw.branches].filter(Boolean).join(","),
     adminPass: raw.pass ? String(raw.pass) : "",

package/package.json

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