@stage5/lumine 0.3.28 → 0.3.30

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>]";
+  "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>]";
 const ENGLISH_IMPORT_MAX = 500;
 
 function buildEnglishOperation({ action, target, options }) {
@@ -431,6 +431,36 @@ function buildEnglishOperation({ action, target, options }) {
       ? 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 });
   }
+  // Mikey's approved fixes: [{ questionId, version, fix? }] — the stored
+  // proposed fix, or one given (a tidy), applied as a new version
+  // checks from before fingerprints: [{ questionId, version, question,
+  // choices, key }] as the pass saw them; matches are kept, the rest dropped
+  if (action === "check-verify") {
+    if (!target) throw cliValidationError(ENGLISH_USAGE);
+    const raw = readAdminJsonFile(target, "<checked.json>", { maxBytes: 8 * 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} items (an array, or { items: [...] }).`);
+    }
+    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 });
+  }
+  if (action === "check-apply") {
+    if (!target) throw cliValidationError(ENGLISH_USAGE);
+    const raw = readAdminJsonFile(target, "<fixes.json>", { maxBytes: 4 * 1024 * 1024 });
+    const items = Array.isArray(raw) ? raw : Array.isArray(raw?.items) ? raw.items : null;
+    if (!items || !items.length || items.length > 200) {
+      throw cliValidationError("The file must hold 1 to 200 fixes (an array, or { items: [...] }).");
+    }
+    return writeOperation("english.check_apply", "POST", "/cli/admin/english/item-checks/apply", { items }, { requiresRun: false, timeoutMs: 300000 });
+  }
   if (action === "check-import") {
     if (!target) throw cliValidationError(ENGLISH_USAGE);
     const raw = readAdminJsonFile(target, "<verdicts.json>", { maxBytes: 4 * 1024 * 1024 });
@@ -465,7 +495,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.28",
+  "version": "0.3.30",
   "description": "Command line tools for launching Lumine builds on Twinkle.",
   "type": "module",
   "bin": {