@stage5/lumine 0.3.13 → 0.3.14

package/lib/admin.js

@@ -281,6 +281,63 @@ function buildApprovalOperation({ action, target, options }) {
   throw cliValidationError(APPROVAL_USAGE);
 }
 
+// English skill tags for the Grammarbles bank: import the verdicts two Claude
+// 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> | summary | review [--limit <n>] | accept|retire <questionId> [--reason <text>] | retag <questionId> --skill <code> [--reason <text>]";
+const ENGLISH_IMPORT_MAX = 500;
+
+function buildEnglishOperation({ action, target, options }) {
+  const limitOf = (max, fallback) =>
+    options.adminLimit != null ? parseRequiredInteger(options.adminLimit, "--limit", 1, max) : fallback;
+  if (action === "import") {
+    const pass = String(options.adminPass || "");
+    if (!["a", "b"].includes(pass) || !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.import", "POST", "/cli/admin/english/import", { pass, items }, { requiresRun: false, timeoutMs: 120000 });
+  }
+  // adjudicate / add-questions / relevel: one JSON file of up to 500 entries.
+  const BANK_FILES = {
+    adjudicate: ["english.adjudicate", "/cli/admin/english/adjudicate", "items"],
+    "add-questions": ["english.add_questions", "/cli/admin/english/questions/import", "questions"],
+    relevel: ["english.relevel", "/cli/admin/english/relevel", "items"],
+  };
+  if (BANK_FILES[action]) {
+    const [name, path, key] = BANK_FILES[action];
+    if (!target) throw cliValidationError(ENGLISH_USAGE);
+    const raw = readAdminJsonFile(target, "<file.json>", { maxBytes: 4 * 1024 * 1024 });
+    const list = Array.isArray(raw) ? raw : Array.isArray(raw?.[key]) ? raw[key] : null;
+    if (!list || !list.length || list.length > ENGLISH_IMPORT_MAX) {
+      throw cliValidationError(`The file must hold 1 to ${ENGLISH_IMPORT_MAX} entries (an array, or { ${key}: [...] }).`);
+    }
+    return writeOperation(name, "POST", path, { [key]: list }, { requiresRun: false, timeoutMs: 180000 });
+  }
+  if (action === "summary") {
+    return readOperation("english.summary", "/cli/admin/english/tag-summary", { requiresRun: false });
+  }
+  if (action === "review" && !target) {
+    return readOperation("english.review", withQuery("/cli/admin/english/review", { limit: limitOf(100, 20) }), { requiresRun: false });
+  }
+  if (["accept", "retire", "retag"].includes(action)) {
+    const ref = String(target || "");
+    if (!/^\d+$/.test(ref)) throw cliValidationError(ENGLISH_USAGE);
+    if (action === "retag" && !options.adminSkill) throw cliValidationError(ENGLISH_USAGE);
+    return writeOperation(
+      "english.decide",
+      "POST",
+      `/cli/admin/english/review/${ref}`,
+      { action, skillCode: options.adminSkill || undefined, reason: String(options.adminReason || "").trim() || undefined },
+      { requiresRun: false },
+    );
+  }
+  throw cliValidationError(ENGLISH_USAGE);
+}
+
 function buildTeacherOperation({ action, target, options }) {
   if (!action || action === "audit") {
     return readOperation(
@@ -2172,6 +2229,9 @@ export function parseAdminOperation(options) {
     // Mikey's decisions, any time; each comes with its evidence (approvals.ts).
     return buildApprovalOperation({ action, target, options });
   }
+  if (namespace === "english") {
+    return buildEnglishOperation({ action, target, options });
+  }
   if (namespace === "teachers" || namespace === "teacher") {
     // Approved teachers: an audit any time, and a clean removal of the status.
     return buildTeacherOperation({ action, target, options });
@@ -5813,6 +5873,45 @@ function printApprovalResult({ operation, data }) {
   }
 }
 
+function printEnglishResult({ operation, data }) {
+  if (operation.name === "english.import") {
+    console.log(`Pass ${data.pass}: ${data.stored} stored of ${data.received} (${data.invalid} invalid, ${data.unknownQuestion} unknown questions) · ${data.decided} decided: ${data.auto} accepted automatically, ${data.review} for review (${Object.entries(data.reasons || {}).map(([k, v]) => `${k} ${v}`).join(", ") || "-"})`);
+    return;
+  }
+  if (operation.name === "english.adjudicate") {
+    console.log(`Adjudicated ${data.received}: ${data.keep} kept · ${data.fix} fixed (new versions) · ${data.retire} retired · ${data.skipped?.length || 0} skipped${data.skipped?.length ? ` (${data.skipped.slice(0, 5).map((s) => `${s.ref}: ${s.why}`).join("; ")})` : ""}`);
+    return;
+  }
+  if (operation.name === "english.add_questions") {
+    console.log(`Added ${data.added} of ${data.received} questions · ${data.duplicate} duplicates skipped · ${data.invalid?.length || 0} invalid${data.invalid?.length ? ` (${data.invalid.slice(0, 5).map((s) => `#${s.index}: ${s.why}`).join("; ")})` : ""}`);
+    return;
+  }
+  if (operation.name === "english.relevel") {
+    console.log(`Re-levelled ${data.moved} of ${data.received} · ${data.unchanged} already in place · ${data.invalid} invalid`);
+    return;
+  }
+  if (operation.name === "english.summary") {
+    console.log(`${data.total} questions · passes: ${(data.passes || []).map((row) => `${row.model} ${row.items}`).join(" · ") || "none yet"}`);
+    console.log(`Tag status: ${(data.byStatus || []).map((row) => `${row.status} ${row.items}`).join(" · ") || "none yet"}`);
+    (data.bySkill || []).slice(0, 40).forEach((row) => console.log(`  ${row.skillCode}: ${row.items}`));
+    return;
+  }
+  if (operation.name === "english.review") {
+    const items = data.items || [];
+    if (!items.length) return console.log("Nothing waiting for review.");
+    items.forEach((item) => {
+      console.log(`\n#${item.itemRef} v${item.itemVersion} · ${item.skillCode} · ${item.cefr || "?"}`);
+      console.log(`  ${item.question}`);
+      ["a", "b", "c", "d"].forEach((letter) => console.log(`  ${letter === item.correct_choice ? "*" : " "} ${letter}) ${item[`choice_${letter}`]}`));
+      (item.verdicts || []).forEach((v) => console.log(`  ${v.model}: ${v.primarySkill}${v.ambiguous ? ` · AMBIGUOUS: ${v.ambiguityReason}` : ""}`));
+    });
+    return;
+  }
+  if (operation.name === "english.decide") {
+    console.log(`#${data.ref} v${data.version}: ${data.action} · ${data.skillCode}${data.reason ? ` (${data.reason})` : ""}`);
+  }
+}
+
 function printReviewRequestResult({ operation, data, result }) {
   if (operation.name === "review.list") {
     const items = Array.isArray(data.items) ? data.items : [];
@@ -5999,6 +6098,10 @@ function printAdminResult({ operation, result }) {
     printApprovalResult({ operation, data });
     return;
   }
+  if (operation.name.startsWith("english.")) {
+    printEnglishResult({ operation, data });
+    return;
+  }
   if (operation.name.startsWith("review.")) {
     printReviewRequestResult({ operation, data, result });
     return;

package/lib/commands.js

@@ -2606,6 +2606,9 @@ export function parseArgs(args) {
     draftId: raw.draftId ? String(raw.draftId) : "",
     twinkles: raw.twinkles ? String(raw.twinkles) : "",
     adminReason: raw.reason ? String(raw.reason) : "",
+    adminSkill: raw.skill ? String(raw.skill) : "",
+    adminPass: raw.pass ? String(raw.pass) : "",
+    adminLimit: raw.limit === undefined ? null : raw.limit,
     storageSize: raw.size ? String(raw.size) : "",
     adminAttended: raw.attended ? String(raw.attended) : "",
     adminConfirm: raw.confirm === undefined ? "" : String(raw.confirm),
@@ -3016,6 +3019,7 @@ export function printHelp() {
   lumine admin review list [--type rewards|project|storage|cardcraft] [--status queue|pending|approved|rejected|all] [--cursor <c>] | show <type:id> [--dir <path>] | approve <type:id> [--config <rules.json>] [--size <500MB|1GB|2GB|n MB>] [--reason <text>] | reject|revoke <type:id> [--reason <text>] | propose rewards:<id> --dir <edited-snapshot> --config <rules.json>
   lumine admin approvals list [--status pending|approved|rejected|all] [--type dob|mentor|meetup] | show <id> | approve <id> [--reason <text>] | reject <id> [--reason <text>] | supermod <id> [--reason <text>]   (management approvals with evidence: birthdates, teacher signups, meetups)
   lumine admin teachers audit [--limit <1-100>] | revoke <userId> --reason <text>   (approved teachers, riskiest first; revoke removes the status cleanly)
+  lumine admin english import <verdicts.json> --pass a|b | adjudicate <file> | add-questions <file> | relevel <file> | summary | review [--limit <n>] | accept|retire <questionId> | retag <questionId> --skill <code>   (English skill tags and bank upkeep for Grammarbles; content written by Claude Code agents)
   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>]

package/package.json

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