@stage5/lumine 0.3.65 → 0.3.67

package/lib/admin-arena.js

@@ -14,7 +14,7 @@ import path from "node:path";
 //                              re-importing a folder retires that paper's earlier items
 //   status --item <id> --to live|retired|checked
 export const ARENA_USAGE =
-  "Usage: lumine admin arena queue | import --dir <paper folder> [--audio audio/<exam>/<paper>] [--live] [--confirm] | status --item <id> --to live|retired|checked [--confirm] [--json]";
+  "Usage: lumine admin arena queue | marking [--cursor <id>] [--limit <1-200>] | import --dir <paper folder> [--audio audio/<exam>/<paper>] [--live] [--confirm] | status --item <id> --to live|retired|checked [--confirm] [--json]";
 const MAX_ITEMS = 300;
 
 function validationError(message) {
@@ -50,6 +50,18 @@ function readPaper(dir) {
 }
 
 export function buildArenaOperation({ action, options }) {
+  if (action === "marking") {
+    const cursor = Number(options.adminCursor || 0);
+    const limit = Number(options.adminLimit ?? 100);
+    if (!Number.isSafeInteger(cursor) || cursor < 0 || !Number.isInteger(limit) || limit < 1 || limit > 200) {
+      throw validationError("Use a non-negative --cursor and --limit from 1 to 200.");
+    }
+    return {
+      name: "arena.marking", method: "GET",
+      path: `/cli/admin/arena/marking?cursor=${cursor}&limit=${limit}`,
+      body: undefined, mutates: false, requiresRun: false,
+    };
+  }
   if (!action || action === "queue") {
     return {
       name: "arena.queue",
@@ -102,6 +114,14 @@ export function buildArenaOperation({ action, options }) {
 }
 
 export function formatArenaResult({ operation, data }) {
+  if (operation.name === "arena.marking") {
+    const entries = data?.entries || [];
+    return [
+      `Checked ${data?.scannedBattles ?? 0} completed battles; ${entries.length} need follow-up on this page.`,
+      ...entries.map((row) => `Battle ${row.battleId}, member ${row.userId}, ${row.examKey}: ${row.reasons.join(", ")} (${row.pendingAnswers} answers pending; ${row.xpEarned}/${row.xpExpected} XP and ${row.coinsEarned}/${row.coinsExpected} Coins paid)`),
+      ...(data?.nextCursor ? [`Continue: lumine admin arena marking --cursor ${data.nextCursor} --json`] : ["End of marking/reward census."]),
+    ];
+  }
   if (operation.name === "arena.queue") {
     const types = data?.types || [];
     if (!types.length) return ["No live Arena items yet."];

package/lib/admin.js

@@ -3016,7 +3016,7 @@ export function parseAdminOperation(options) {
   if (namespace === "word-games") {
     if (action === "status") return readOperation("word-games.status", "/cli/admin/word-games/status", { requiresRun: false });
     if (action === "candidates") return readOperation("word-games.candidates", withQuery("/cli/admin/word-games/candidates", {
-      level: parseRequiredInteger(target, "word level", 1, 5), after: options.adminAfter || 0, limit: options.adminLimit || 50,
+      level: parseRequiredInteger(target, "word level (0 means unassigned)", 0, 5), after: options.adminAfter || 0, limit: options.adminLimit || 50,
     }), { requiresRun: false });
     if (action === "import" && target) {
       const raw = readAdminJsonFile(target, "<reviewed-words.json>", { maxBytes: 256 * 1024 });
@@ -3039,7 +3039,7 @@ export function parseAdminOperation(options) {
         reason,
       }, { requiresRun: false, mutates: true });
     }
-    throw cliValidationError("Use: lumine admin word-games status | candidates <1-5> [--after <id>] [--limit <n>] | import <reviewed-words.json> [--dry-run] | champions --build <id> | confirm|disqualify <YYYY-MM> <userId> --build <id> --reason \"<evidence>\"");
+    throw cliValidationError("Use: lumine admin word-games status | candidates <0-5> (0 = unassigned) [--after <id>] [--limit <n>] | import <reviewed-words.json> [--dry-run] | champions --build <id> | confirm|disqualify <YYYY-MM> <userId> --build <id> --reason \"<evidence>\"");
   }
   if (namespace === "english") {
     return buildEnglishOperation({ action, target, options });

package/package.json

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

package/sdk/LUMINE_ADMIN.md

@@ -5539,7 +5539,7 @@ need no app update. Keep prepared inventory distinct from verified live stock.
 
 ## Word Search vocabulary upkeep
 
-Every full daily website-management run adds reviewed Word Master words across all five difficulty bands, with accurate definitions and natural example sentences. Use `lumine admin word-games status`, `candidates <1-5> --after <id> --limit 100`, and `import <reviewed-words.json> --dry-run` followed by the reviewed import. File shape: `{items:[{wordId,word,wordLevel,definition,example}]}` (up to 100). Candidate exports are unreviewed; use agent judgment and check the current censor table before importing. No paid batch APIs. The import is audited and preserves active generation and today's existing puzzles; future banks include the additions. The app receives all five ready banks in its normal HTML and has a bundled checked fallback, so word selection never creates a loading screen or separate word request. Report additions per difficulty and text corrections. Repository agents follow `agent-guides/word-search-vocabulary.md` for the full procedure. A scoped management request does not start this full-run duty.
+Every full daily website-management run adds reviewed Word Master words across all five difficulty bands, with accurate definitions and natural example sentences. Use `lumine admin word-games status`, `candidates <0-5> --after <id> --limit 100`, and `import <reviewed-words.json> --dry-run` followed by the reviewed import. File shape: `{items:[{wordId,word,wordLevel,definition,example}]}` (up to 100). Candidate level 0 includes unassigned words (zero or NULL), not a sixth difficulty; assign a reviewed level 1–5 on import. Candidate exports are unreviewed; use agent judgment and check the current censor table before importing. No paid batch APIs. The import is audited and preserves active generation and today's existing puzzles; future banks include the additions. The app receives all five ready banks in its normal HTML and has a bundled checked fallback, so word selection never creates a loading screen or separate word request. Report additions per difficulty and text corrections. Repository agents follow `agent-guides/word-search-vocabulary.md` for the full procedure. A scoped management request does not start this full-run duty.
 
 ## Word Search monthly champions