@stage5/lumine 0.3.67 → 0.3.69

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 | 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]";
+  "Usage: lumine admin arena queue | marking [--cursor <id>] [--limit <1-200>] | import (--dir <paper folder> | --additive --file <reviewed-items.json>) [--audio audio/<exam>/<paper>] [--live] [--confirm] | status --item <id> --to live|retired|checked [--confirm] | today-queue [--cursor <id>] [--limit <1-100>] | today-member --user <id> | today-import --file <reviewed-questions.json> [--confirm] [--json]";
 const MAX_ITEMS = 300;
 
 function validationError(message) {
@@ -49,7 +49,39 @@ function readPaper(dir) {
     .sort((a, b) => a.number - b.number);
 }
 
+function readAdditiveItems(file) {
+  const resolved = path.resolve(file);
+  if (fs.statSync(resolved).size > 5_000_000) {
+    throw validationError("The additive import file must be under 5 MB.");
+  }
+  const items = JSON.parse(fs.readFileSync(resolved, "utf8"));
+  if (!Array.isArray(items) || !items.length || items.length > MAX_ITEMS ||
+      items.some((item) => !item || typeof item !== "object" || Array.isArray(item))) {
+    throw validationError(`An additive import file must contain an array of 1 to ${MAX_ITEMS} reviewed items.`);
+  }
+  return items;
+}
+
 export function buildArenaOperation({ action, options }) {
+  if (action === "today-queue") {
+    const cursor = Number(options.adminCursor || 0);
+    const limit = Number(options.adminLimit ?? 50);
+    if (!Number.isSafeInteger(cursor) || cursor < 0 || !Number.isInteger(limit) || limit < 1 || limit > 100) throw validationError("Use a non-negative --cursor and --limit from 1 to 100.");
+    return { name: "arena.today.queue", method: "GET", path: `/cli/admin/arena/today/queue?cursor=${cursor}&limit=${limit}`, mutates: false, requiresRun: false };
+  }
+  if (action === "today-member") {
+    const id = Number(options.adminUser);
+    if (!Number.isSafeInteger(id) || id <= 0) throw validationError("Use today-member --user <member id>.");
+    return { name: "arena.today.member", method: "GET", path: `/cli/admin/arena/today/member/${id}`, mutates: false, requiresRun: false };
+  }
+  if (action === "today-import") {
+    if (!options.adminFile) throw validationError("Use today-import --file <reviewed-questions.json> [--confirm].");
+    const file = path.resolve(options.adminFile);
+    if (fs.statSync(file).size > 1000000) throw validationError("The import file must be under 1 MB.");
+    const payload = JSON.parse(fs.readFileSync(file, "utf8"));
+    const confirm = confirmed(options);
+    return { name: confirm ? "arena.today.import" : "arena.today.preview", method: "POST", path: "/cli/admin/arena/today/import", body: { ...payload, dryRun: !confirm }, mutates: confirm, requiresRun: false };
+  }
   if (action === "marking") {
     const cursor = Number(options.adminCursor || 0);
     const limit = Number(options.adminLimit ?? 100);
@@ -73,7 +105,11 @@ export function buildArenaOperation({ action, options }) {
     };
   }
   if (action === "import") {
-    const items = readPaper(options.adminDir);
+    const additive = Boolean(options.adminArenaAdditive);
+    if ((options.adminFile && options.adminDir) || (options.adminFile && !additive)) {
+      throw validationError("Use --dir for a complete paper, or --additive with exactly one of --file or --dir for a refill.");
+    }
+    const items = options.adminFile ? readAdditiveItems(options.adminFile) : readPaper(options.adminDir);
     const confirm = confirmed(options);
     return {
       name: confirm ? "arena.import" : "arena.import.preview",
@@ -84,8 +120,9 @@ export function buildArenaOperation({ action, options }) {
         live: Boolean(options.adminArenaLive),
         dryRun: !confirm,
         ...(options.adminArenaAudio ? { audioPrefix: options.adminArenaAudio } : {}),
-        // the folder name is the paper; re-importing it retires its earlier copy
-        paper: path.basename(path.resolve(options.adminDir)),
+        // Full papers retain their replacement semantics. Additive refills
+        // preserve the existing bank without retiring another paper's items.
+        ...(!additive ? { paper: path.basename(path.resolve(options.adminDir)) } : {}),
       },
       mutates: confirm,
       requiresRun: false,
@@ -114,6 +151,14 @@ export function buildArenaOperation({ action, options }) {
 }
 
 export function formatArenaResult({ operation, data }) {
+  if (operation.name === "arena.today.queue") return [
+    ...(data?.members || []).map(m => `#${m.userId} ${m.username}: ${m.ready} questions ready${m.refillDue ? `; refill to ${m.target}` : ""} (preferences v${m.revision})`),
+    data?.nextCursor ? `Continue: lumine admin arena today-queue --cursor ${data.nextCursor} --json` : "End of Today’s Q queue.",
+  ];
+  if (operation.name === "arena.today.member") return [JSON.stringify(data, null, 2)];
+  if (operation.name === "arena.today.preview" || operation.name === "arena.today.import") return [
+    `${data?.dryRun ? "Dry run" : "Saved"}: ${data?.questions?.length || 0} reviewed personal questions.${data?.dryRun ? " Add --confirm to make new questions available." : ""}`,
+  ];
   if (operation.name === "arena.marking") {
     const entries = data?.entries || [];
     return [

package/lib/admin-build-plans.js

@@ -74,6 +74,12 @@ export function buildBuildPlansOperation({ action, options }) {
   throw validationError(BUILD_PLANS_USAGE);
 }
 
+function formatStepCoverage(row) {
+  if (!Number.isFinite(row.steps)) return ""; // Older API response.
+  if (row.stepsPassed == null) return `; steps ?/${row.steps} verified (no step grading yet)`;
+  return `; steps ${row.stepsPassed}/${row.steps} verified, ${row.stepsUnverified ?? 0} unverified, ${row.stepsNeedWork ?? 0} need work`;
+}
+
 function formatRow(row) {
   const ratio = row.energyRatio == null ? "?" : `${row.energyRatio}x`;
   const milestone =
@@ -86,7 +92,7 @@ function formatRow(row) {
     : row.wouldStall
       ? ` would stall (${row.wouldStall})`
       : "";
-  return `Build ${row.buildId}: milestone ${milestone} (${row.milestonesDone} done), ${row.runs} runs, Energy ${ratio} of estimate, ${row.evaluations ?? "?"} gradings, non-pass streak ${row.consecutiveNonPass ?? "?"}, ${row.passed}/${row.criteria} passing, ${row.unverified} unverified${state};${coverage}${row.flags?.length ? ` [${row.flags.join(", ")}]` : ""}`;
+  return `Build ${row.buildId}: milestone ${milestone} (${row.milestonesDone} done), ${row.runs} runs, Energy ${ratio} of estimate, ${row.evaluations ?? "?"} gradings, non-pass streak ${row.consecutiveNonPass ?? "?"}, ${row.passed}/${row.criteria} passing, ${row.unverified} unverified${formatStepCoverage(row)}${state};${coverage}${row.flags?.length ? ` [${row.flags.join(", ")}]` : ""}`;
 }
 
 export function formatBuildPlansResult({ operation, data }) {
@@ -110,7 +116,7 @@ export function formatBuildPlansResult({ operation, data }) {
   for (const result of data?.results || []) {
     lines.push(
       result?.ok
-        ? `${result.replayed ? "(already rechecked by this request) " : ""}Build ${result.buildId}: milestone ${result.milestoneIndex + 1} ${result.verdict}, ${result.passed}/${result.criteria} passing, ${result.unverified} unverified${result.milestoneCompleted ? ", milestone completed" : ""}${result.stalled ? `, stalled (${result.stalled.reason})` : ""}${result.fileCoverage ? `; files ${result.fileCoverage.shownFiles}/${result.fileCoverage.totalFiles} + ${result.fileCoverage.toolFilesRead || 0} read in ${result.fileCoverage.toolRounds || 0} rounds` : ""}${result.usage ? `; cost ${result.usage.energyUnits} Energy units (${result.usage.inputTokens} in / ${result.usage.outputTokens} out tokens), not charged to the creator` : ""}`
+        ? `${result.replayed ? "(already rechecked by this request) " : ""}Build ${result.buildId}: milestone ${result.milestoneIndex + 1} ${result.verdict}, ${result.passed}/${result.criteria} passing, ${result.unverified} unverified${formatStepCoverage(result)}${result.milestoneCompleted ? ", milestone completed" : ""}${result.stalled ? `, stalled (${result.stalled.reason})` : ""}${result.fileCoverage ? `; files ${result.fileCoverage.shownFiles}/${result.fileCoverage.totalFiles} + ${result.fileCoverage.toolFilesRead || 0} read in ${result.fileCoverage.toolRounds || 0} rounds` : ""}${result.usage ? `; cost ${result.usage.energyUnits} Energy units (${result.usage.inputTokens} in / ${result.usage.outputTokens} out tokens), not charged to the creator` : ""}`
         : `Build ${result?.buildId}: not rechecked (${result?.reason === "run_in_progress" ? "a Lumine run is in progress; try again later" : result?.reason || "unknown"})`,
     );
   }

package/lib/admin-daily-collection.js

@@ -0,0 +1,88 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+
+function invalid(message) {
+  const error = new Error(message);
+  error.code = "CLI_ADMIN_CLI_VALIDATION";
+  throw error;
+}
+
+const sha = (value) => createHash("sha256").update(value).digest("hex");
+
+// Resuming reuses explicitly dated, byte-verified receipts. It does not assert
+// that old observations are fresh, read, or an editorial duty is complete.
+export function createDailyCollection(dir, options, { now = Date.now, clock = () => performance.now() } = {}) {
+  const started = clock();
+  const today = new Date(now()).toISOString().slice(0, 10);
+  const costDate = options.adminCostDate || options.adminDate || new Date(now() - 86400000).toISOString().slice(0, 10);
+  if (options.adminCostDate && options.adminDate && options.adminCostDate !== options.adminDate)
+    invalid("--cost-date and legacy --date must identify the same closed UTC cost day.");
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(costDate) || !Number.isFinite(Date.parse(`${costDate}T00:00:00Z`)) ||
+      new Date(`${costDate}T00:00:00Z`).toISOString().slice(0, 10) !== costDate || costDate >= today)
+    invalid("Use --cost-date YYYY-MM-DD for a completed UTC day, not today's run date.");
+  const phase = options.adminPhase || "all";
+  if (!["all", "priority", "evidence"].includes(phase)) invalid("--phase must be priority, evidence, or all.");
+  const maxSteps = Number(options.adminMaxSteps === "" || options.adminMaxSteps == null ? 200 : options.adminMaxSteps);
+  const maxSeconds = Number(options.adminMaxSeconds === "" || options.adminMaxSeconds == null ? 900 : options.adminMaxSeconds);
+  if (!Number.isInteger(maxSteps) || maxSteps < 1 || maxSteps > 1000 ||
+      !Number.isInteger(maxSeconds) || maxSeconds < 1 || maxSeconds > 14400)
+    invalid("Use --max-steps 1–1000 and --max-seconds 1–14400.");
+  const file = path.join(dir, "gather-checkpoint.json");
+  let checkpoint = { protocol: 1, collectionId: randomUUID(), startedAt: new Date(now()).toISOString(), costDate, entries: {} };
+  if (options.adminResume) {
+    if (!fs.existsSync(file)) invalid("No gather checkpoint exists in this directory; run without --resume first.");
+    checkpoint = JSON.parse(fs.readFileSync(file, "utf8"));
+    if (checkpoint.protocol !== 1 || checkpoint.costDate !== costDate || !checkpoint.entries || typeof checkpoint.entries !== "object")
+      invalid("The checkpoint belongs to a different cost day or format. Use its --cost-date or start a new directory.");
+  }
+  const save = () => {
+    const temporary = `${file}.${process.pid}.next`;
+    fs.writeFileSync(temporary, JSON.stringify(checkpoint, null, 2) + "\n", { mode: 0o600 });
+    fs.renameSync(temporary, file);
+  };
+  save();
+  let executed = 0;
+  return {
+    costDate, phase, collectionId: checkpoint.collectionId, startedAt: checkpoint.startedAt,
+    warnings: options.adminDate ? ["--date is a legacy alias for --cost-date (a completed UTC day), not the management run date."] : [],
+    invalidate(name) {
+      if (checkpoint.entries[name]) { checkpoint.entries[name].ok = false; save(); }
+    },
+    collect(name, args, outputName, stage, run) {
+      const outputFile = path.join(dir, outputName);
+      const key = sha(JSON.stringify(args));
+      const cached = checkpoint.entries[name];
+      if (options.adminResume && cached?.ok && cached.requestHash === key && cached.file === outputName) {
+        try {
+          const bytes = fs.readFileSync(outputFile);
+          const json = JSON.parse(bytes);
+          if (sha(bytes) === cached.sha256 && json.ok === true && typeof json.status === "string")
+            return { ok: true, json, attempts: 0, durationMs: 0, capturedAt: cached.capturedAt, reused: true };
+        } catch { /* Missing/changed bytes require a fresh read, never a cached success. */ }
+      }
+      const remainingMs = maxSeconds * 1000 - (clock() - started);
+      const reason = phase !== "all" && phase !== stage ? `outside-${phase}-phase`
+        : executed >= maxSteps ? "step-budget" : remainingMs <= 0 ? "time-budget" : null;
+      if (reason) return { ok: false, deferred: true, reason, attempts: 0, durationMs: 0 };
+      executed++;
+      let result;
+      try { result = run(args, { outputFile, retryRead: true, timeoutMs: Math.max(1, Math.min(120000, Math.floor(remainingMs))) }); }
+      catch (error) { result = { ok: false, attempts: 1, json: { error: { message: String(error.message || error) } } }; }
+      const capturedAt = new Date(now()).toISOString();
+      let digest;
+      if (result.ok) {
+        try {
+          const bytes = fs.readFileSync(outputFile);
+          if (JSON.stringify(JSON.parse(bytes)) !== JSON.stringify(result.json)) throw new Error("receipt mismatch");
+          digest = sha(bytes);
+        } catch {
+          result = { ...result, ok: false, json: { error: { code: "CLI_DAILY_RECEIPT_INVALID", message: "Successful collection did not save its matching receipt." } } };
+        }
+      }
+      checkpoint.entries[name] = { ok: result.ok, requestHash: key, file: outputName, capturedAt, ...(digest ? { sha256: digest } : {}) };
+      save();
+      return { ...result, capturedAt, reused: false };
+    },
+  };
+}

package/lib/admin-daily.js

@@ -8,6 +8,7 @@ import { adminWorkDirectory } from "./admin-work-directory.js";
 import { readAdminJsonFile, writeAdminJsonFile } from "./admin-news.js";
 import { createDailyReviewState, dailyRunProgress } from "./admin-duties.js";
 import { summarizeOwnerViewport, formatOwnerViewportReport } from "./admin-owner-viewport.js";
+import { createDailyCollection } from "./admin-daily-collection.js";
 export { dailyRunProgress };
 
 // Multi-step conveniences for the full daily management run. Each one runs
@@ -22,7 +23,7 @@ const MARKED_ASSET = fileURLToPath(
 
 export function runAdmin(
   args,
-  { outputFile, extraEnv, retryRead = false, spawnImpl = spawnSync } = {},
+  { outputFile, extraEnv, retryRead = false, spawnImpl = spawnSync, timeoutMs } = {},
 ) {
   const startedAt = performance.now();
   const attemptFile = outputFile
@@ -33,6 +34,7 @@ export function runAdmin(
   const result = spawnImpl(process.execPath, [LUMINE_BIN, ...full], {
     encoding: "utf8",
     maxBuffer: 256 * 1024 * 1024,
+    ...(timeoutMs ? { timeout: timeoutMs } : {}),
     env: { ...process.env, ...(extraEnv || {}) },
   });
   let parsed = null;
@@ -84,6 +86,9 @@ export function runAdmin(
     sponsor: ["applications"],
     "bot-output": [null],
     "math-lab": ["queue"],
+    arena: ["queue", "today-queue"],
+    "word-games": ["status"],
+    nonogram: ["status"],
     subjects: ["candidates"],
     subject: ["get"],
   };
@@ -98,8 +103,9 @@ export function runAdmin(
     result.error ||
     result.signal ||
     parsed?.error?.code === "lumine_http_invalid_response";
-  if (!ok && retryRead && readOnly && transient) {
-    const retried = runAdmin(args, { outputFile, extraEnv, spawnImpl });
+  const remainingMs = timeoutMs == null ? undefined : Math.floor(timeoutMs - (performance.now() - startedAt));
+  if (!ok && retryRead && readOnly && transient && (remainingMs == null || remainingMs > 0)) {
+    const retried = runAdmin(args, { outputFile, extraEnv, spawnImpl, timeoutMs: remainingMs });
     return {
       ...retried,
       durationMs: Math.round(performance.now() - startedAt),
@@ -166,16 +172,21 @@ export function renderBotOutput({ chatMessages, comments }, file) {
   fs.writeFileSync(file, lines.join("\n") + "\n", { mode: 0o600 });
 }
 
-export async function dailyRunGather(options, { run = runAdmin } = {}) {
+export async function dailyRunGather(options, { run = runAdmin, now, clock } = {}) {
   const startedAt = performance.now();
   const dir = ensureDir(
     path.resolve(options.adminOutputDir || options.adminDir || "."),
   );
-  const yesterday = options.adminDate || utcDayKey(-1);
+  const collection = createDailyCollection(dir, options, { now, clock });
+  const yesterday = collection.costDate;
   const steps = [];
+  const failLast = (error) => {
+    collection.invalidate(steps.at(-1).name);
+    Object.assign(steps.at(-1), { ok: false, error });
+  };
+  const evidenceNames = /^(ai-costs|media-costs|reward-activity|reward-diagnostics|owner-wake|bot-output)/;
   const step = (name, args, file) => {
-    const outputFile = path.join(dir, file);
-    const res = run(args, { outputFile, retryRead: true });
+    const res = collection.collect(name, args, file, evidenceNames.test(name) ? "evidence" : "priority", run);
     steps.push({
       name,
       file,
@@ -183,14 +194,49 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
       attempts: res.attempts,
       durationMs: res.durationMs,
       recovered: Boolean(res.recovered),
-      ...(res.ok ? {} : { error: res.json?.error || res.stderr }),
+      capturedAt: res.capturedAt || null,
+      reused: Boolean(res.reused),
+      ...(res.deferred ? { deferred: true, reason: res.reason } : res.ok ? {} : { error: res.json?.error || res.stderr }),
     });
     return res;
   };
   step("energy-budget", ["energy-budget"], "energy-budget.json");
   step("news", ["news"], "news.json");
   step("brief", ["brief"], "brief.json");
+  step("todos", ["todo", "list"], "todos.json");
+  step("escalations", ["escalation", "list"], "escalations.json");
   step("math-lab-queue", ["math-lab", "queue"], "math-lab-queue.json");
+  step("arena-queue", ["arena", "queue"], "arena-queue.json");
+  step("word-games-status", ["word-games", "status"], "word-games-status.json");
+  step("nonogram-status", ["nonogram", "status"], "nonogram-status.json");
+  const personalQueue = { complete: false, pages: 0, members: 0 };
+  let personalCursor = 0;
+  const personalCursors = new Set();
+  for (;;) {
+    personalQueue.pages++;
+    const res = step(`arena-today-page-${personalQueue.pages}`,
+      ["arena", "today-queue", "--cursor", String(personalCursor), "--limit", "100"],
+      `arena-today-queue-${personalQueue.pages}.json`);
+    if (!res.ok) break;
+    const data = res.json?.data;
+    const rawNext = data?.nextCursor;
+    const next = Number(rawNext || 0);
+    if (!Array.isArray(data?.members) || !Object.hasOwn(data, "nextCursor") ||
+        !(rawNext === null || (typeof rawNext === "number" && Number.isSafeInteger(rawNext)) || (typeof rawNext === "string" && /^\d+$/.test(rawNext))) ||
+        !Number.isSafeInteger(next) || next < 0) {
+      failLast("Invalid Arena personal queue page.");
+      break;
+    }
+    personalQueue.members += data.members.length;
+    if (!next) { personalQueue.complete = true; break; }
+    if (personalCursors.has(next) || personalQueue.pages >= 100) {
+      collection.invalidate(steps.at(-1).name);
+      steps.push({ name: "arena-today-pagination", ok: false, error: "Arena personal queue repeated a cursor or reached its 100-page bound." });
+      break;
+    }
+    personalCursors.add(next);
+    personalCursor = next;
+  }
   step("ai-costs-monthly", ["ai-costs", "monthly"], "ai-monthly.json");
   step("ai-costs-day", ["ai-costs", "day", yesterday], "ai-day.json");
   step("media-costs", ["media-costs", "monthly"], "media.json");
@@ -222,10 +268,7 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
       !(data.nextCursor === null ||
         (typeof data.nextCursor === "string" && /^\d+(\.\d\.\d+)?$/.test(data.nextCursor)))
     ) {
-      Object.assign(steps[steps.length - 1], {
-        ok: false,
-        error: "Invalid pending Build review page: expected filter, items and nextCursor.",
-      });
+      failLast("Invalid pending Build review page: expected filter, items and nextCursor.");
       break;
     }
     buildReviews.items += data.items.length;
@@ -234,6 +277,7 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
       break;
     }
     if (reviewCursors.has(data.nextCursor) || buildReviews.pages >= 100) {
+      collection.invalidate(steps.at(-1).name);
       steps.push({
         name: "build-reviews-pagination",
         ok: false,
@@ -249,9 +293,7 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
   // management approvals (birthdates, teacher signups, meetups) with their
   // flags: a required report section (agent-guides/lumine-admin.md)
   step("approvals-pending", ["approvals", "list", "--status", "pending"], "approvals-pending.json");
-  step("todos", ["todo", "list"], "todos.json");
   step("personal-followups", ["followup", "list"], "personal-followups.json");
-  step("escalations", ["escalation", "list"], "escalations.json");
   const wake = step("owner-wake", ["owner-trace", "--since", "24h", "--wake", "--limit", "2000"], "owner-wake.json");
   // A phone tab can live longer than the daily window. Retain its version,
   // browser and device context instead of silently calling it unknown.
@@ -264,7 +306,10 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
     ...(!wake.ok ? ["owner-wake"] : []),
     ...(!wakeSessions.ok ? ["owner-wake-sessions"] : []),
   ];
-  if (ownerWake.collectionFailures.length) ownerWake.coverage = ownerWake.usableSamples ? "partial" : "unavailable";
+  if (ownerWake.collectionFailures.length) {
+    ownerWake.coverage = ownerWake.usableSamples ? "partial" : "unavailable";
+    ownerWake.detail.coverage = ownerWake.detail.samples ? "partial" : "unavailable";
+  }
   writeAdminJsonFile(path.join(dir, "owner-wake-summary.json"), ownerWake, { privateFile: true });
   fs.writeFileSync(path.join(dir, "owner-wake-summary.md"), formatOwnerViewportReport(ownerWake), { mode: 0o600 });
   steps.push({ name: "owner-wake-summary", file: "owner-wake-summary.json", ok: true });
@@ -281,6 +326,7 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
   let cursor = "";
   let pages = 0;
   let botOk = true;
+  const botCursors = new Set();
   for (;;) {
     pages += 1;
     const file = `bot-output-${pages}.json`;
@@ -294,12 +340,18 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
       break;
     }
     const data = res.json?.data || {};
+    if (!Array.isArray(data.chatMessages) || !Array.isArray(data.comments) || typeof data.pagination?.exhausted !== "boolean") {
+      botOk = false;
+      failLast("Invalid bot-output page: rows and explicit exhaustion are required.");
+      break;
+    }
     chatMessages.push(...(data.chatMessages || []));
     comments.push(...(data.comments || []));
     const p = data.pagination || {};
     if (p.exhausted && !data.chatTruncated && !data.commentsTruncated) break;
     cursor = p.nextCursor || "";
-    if (!cursor || pages > 50) {
+    if (!cursor || botCursors.has(cursor) || pages >= 50) {
+      collection.invalidate(steps.at(-1).name);
       botOk = false;
       steps.push({
         name: "bot-output",
@@ -308,6 +360,7 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
       });
       break;
     }
+    botCursors.add(cursor);
   }
   if (botOk) renderBotOutput({ chatMessages, comments }, path.join(dir, "bot-chats.txt"));
 
@@ -316,6 +369,9 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
     durationMs: Math.round(performance.now() - startedAt),
     dir,
     yesterdayUtc: yesterday,
+    costDateUtc: yesterday,
+    collection: { id: collection.collectionId, startedAt: collection.startedAt, phase: collection.phase, warnings: collection.warnings },
+    personalQueue,
     buildReviews,
     ownerWake: {
       coverage: ownerWake.coverage,
@@ -331,7 +387,8 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
       readFile: botOk ? path.join(dir, "bot-chats.txt") : null,
     },
     steps,
-    failed: steps.filter((s) => !s.ok).map((s) => s.name),
+    failed: steps.filter((s) => !s.ok && !s.deferred).map((s) => s.name),
+    deferred: steps.filter((s) => s.deferred).map((s) => ({ name: s.name, reason: s.reason })),
   };
   fs.writeFileSync(
     path.join(dir, "gather.json"),
@@ -348,8 +405,8 @@ export async function dailyRunGather(options, { run = runAdmin } = {}) {
     { privateFile: true },
   );
   return {
-    ok: summary.failed.length === 0,
-    status: summary.failed.length ? "partial_failure" : "success",
+    ok: summary.failed.length === 0 && summary.deferred.length === 0,
+    status: summary.failed.length ? "partial_failure" : summary.deferred.length ? "deferred" : "success",
     data: summary,
   };
 }
@@ -447,10 +504,37 @@ nav{position:fixed;top:0;left:0;bottom:0;width:250px;overflow:auto;background:va
 nav h4{margin:0 0 10px;font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--muted)}nav a{display:block;padding:4px 6px;border-radius:6px;color:var(--fg);text-decoration:none;font-size:13px}nav a:hover{background:var(--line)}
 main{margin-left:250px;padding:28px 40px;max-width:1100px}a{color:var(--link)}table{border-collapse:collapse;margin:10px 0;display:block;overflow-x:auto}th,td{border:1px solid var(--line);padding:6px 9px;text-align:left;vertical-align:top}
 code{background:var(--code);padding:1px 5px;border-radius:4px;font-size:.9em}pre{background:var(--code);padding:12px;border-radius:8px;overflow:auto}h2{border-bottom:1px solid var(--line);padding-bottom:4px;margin-top:34px}
+.relay-actions{border:1px solid var(--line);border-radius:12px;padding:16px;margin:20px 0;background:var(--nav)}
+.relay-actions h3{margin:0 0 8px}.relay-actions p{margin:8px 0}.relay-buttons{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,230px),1fr));gap:8px}
+.relay-actions button{font:inherit;font-size:1rem;text-align:left;min-height:44px;padding:10px 12px;border:1px solid var(--line);border-radius:8px;background:var(--bg);color:var(--fg);cursor:pointer;overflow-wrap:anywhere}
+.relay-actions button:hover{border-color:var(--link)}.relay-actions button:focus-visible{outline:2px solid var(--link);outline-offset:2px}.relay-actions button:disabled{cursor:wait;opacity:.65}
+.relay-actions .relay-master{grid-column:1/-1;font-weight:650;border-color:var(--link);color:var(--link)}.relay-actions [role=status]{min-height:1.55em;color:var(--muted);font-size:1rem}
+.relay-prompt-source{width:100%;min-height:180px;padding:12px;font:inherit;color:var(--fg);background:var(--bg);border:1px solid var(--line);border-radius:8px}
 @media (max-width:760px){nav{position:static;width:auto;height:auto;border-right:0;border-bottom:1px solid var(--line)}main{margin-left:0;padding:16px}}
 </style></head><body><nav><h4>Sections</h4><div id="toc"></div><h4 style="margin-top:18px">Source</h4><a href="source.html">Markdown</a></nav><main id="content">Loading…</main>
 <script src="marked.min.js"></script><script>
 fetch('daily-management-report.md',{cache:'no-store'}).then(r=>{if(!r.ok)throw new Error('Report source unavailable');return r.text()}).then(md=>{const el=document.getElementById('content');el.innerHTML=marked.parse(md);const toc=document.getElementById('toc');let i=0;el.querySelectorAll('h1,h2').forEach(h=>{h.id='s'+(i++);if(h.tagName==='H2'){const a=document.createElement('a');a.href='#'+h.id;a.textContent=h.textContent;toc.appendChild(a)}})}).catch(()=>{document.getElementById('content').textContent='The report could not load. Open Markdown under Source, or reload this page.'});
+document.getElementById('content').addEventListener('click',async event=>{
+  const button=event.target.closest('button[data-copy-prompt]');
+  if(!button||button.disabled)return;
+  const group=button.closest('.relay-actions');
+  const source=document.getElementById(button.dataset.copyPrompt);
+  const status=group?.querySelector('[role=status]');
+  if(!group||!status||!source?.matches('textarea.relay-prompt-source')||!group.contains(source))return;
+  const buttons=Array.from(group.querySelectorAll('button[data-copy-prompt]'));
+  buttons.forEach(b=>{b.disabled=true});
+  try{
+    await navigator.clipboard.writeText(source.value);
+    status.textContent=button.textContent.replace(/^Copy: /,'')+' copied. Paste it into the agent chat you choose.';
+  }catch{
+    source.hidden=false;
+    source.focus();
+    source.select();
+    status.textContent='Automatic copy is unavailable. The prompt is selected below; copy it with your keyboard.';
+  }finally{
+    buttons.forEach(b=>{b.disabled=false});
+  }
+});
 </script></body></html>`;
 }
 

package/lib/admin-duties.js

@@ -28,6 +28,8 @@ export function createDailyReviewState(dir, gather, previous = {}) {
     .map((step) => ({
       ...(step.ok ? fingerprint(dir, step.file) : { file: step.file }),
       fetched: step.ok,
+      ...(step.deferred ? { deferred: true, reason: step.reason } : {}),
+      ...(step.capturedAt ? { capturedAt: step.capturedAt, reused: Boolean(step.reused) } : {}),
       read: false,
     }));
   if (gather.botOutput.complete)
@@ -42,6 +44,10 @@ export function createDailyReviewState(dir, gather, previous = {}) {
     if (gather.buildReviews && (
       source.file === "rr-pending.json" || /^build-reviews-\d+\.json$/.test(source.file)
     )) continue;
+    if (gather.personalQueue && /^arena-today-queue-\d+\.json$/.test(source.file)) continue;
+    if (gather.botOutput && (
+      source.file === "bot-chats.txt" || /^bot-output-\d+\.json$/.test(source.file)
+    )) continue;
     if (!sources.some((current) => current.file === source.file)) sources.push({ ...source, retained: true, read: false });
   }
   return {
@@ -49,6 +55,7 @@ export function createDailyReviewState(dir, gather, previous = {}) {
     scope: previous.scope || "collection",
     sources,
     collectionFailures: gather.failed || [],
+    collectionDeferred: gather.deferred || [],
     requiredDuties: [...new Set(["effort-levels", "report-browser", ...(previous.requiredDuties || [])])],
     note: "Collection is not a full review. Add every duty required by the run scope and its carryovers. Reading and browser checks require explicit evidence acknowledgments.",
   };
@@ -157,8 +164,9 @@ export function summarizeDailyProgress(dir, state, evidence = {}) {
     .filter((item) => item.status !== "completed")
     .map((item) => item.id);
   const collectionFailures = state.collectionFailures || [];
+  const collectionDeferred = state.collectionDeferred || [];
   const complete =
-    collectionFailures.length === 0 && sources.every((item) => item.read) && incomplete.length === 0;
+    collectionFailures.length === 0 && collectionDeferred.length === 0 && sources.every((item) => item.read) && incomplete.length === 0;
   return {
     scope: state.scope || "declared-duties",
     coverageBasis: "declared sources and duties only",
@@ -166,6 +174,7 @@ export function summarizeDailyProgress(dir, state, evidence = {}) {
     effortAssignments,
     sources,
     collectionFailures,
+    collectionDeferred,
     duties,
     complete,
     reading: {

package/lib/admin-owner-trace.js

@@ -201,6 +201,9 @@ function describeViewport(data) {
     `nav bottom ${nav.bottom ?? "?"} (${nav.position || "absent"})`,
     `inset ${data.inset ?? "?"} focus ${focus.tag || "none"}${focus.type ? `:${focus.type}` : ""}`,
     `scroll ${data.root?.scrollTop ?? "?"}`,
+    isPlainObject(data.signals) ? `signals ${Object.entries(data.signals).map(([name, count]) => `${name}:${count}`).join(",")}` : "",
+    isPlainObject(data.layout) ? `detail ${data.layout.omitted || `v${data.layout.v}; body top ${data.layout.body?.top ?? "?"}; ancestor effects ${Array.isArray(data.layout.ancestors) ? data.layout.ancestors.length : "?"}`}` : "",
+    isPlainObject(data.activity) ? `changes ${data.activity.changes ?? "?"}/${data.activity.limit ?? "?"}; skipped events ${data.activity.skippedEvents ?? "?"}` : "",
     data._trimmed ? `trimmed ${JSON.stringify(data._trimmed)}` : "",
   ].filter(Boolean).join(" · ");
 }

package/lib/admin-owner-viewport.js

@@ -33,7 +33,9 @@ export function summarizeOwnerViewport(data, sessionData = data) {
     }
     cycle.samples += 1;
     if (d.phase === "background") cycle.backgroundSamples += 1;
-    cycle.lastScheduledMs = Math.max(cycle.lastScheduledMs, Number(d.scheduledMs) || 0);
+    // Activity samples can occur minutes later; only a scheduled baseline
+    // establishes that the report actually observed the 20-second follow-up.
+    if (d.phase === "settle") cycle.lastScheduledMs = Math.max(cycle.lastScheduledMs, Number(d.scheduledMs) || 0);
     if (d.phase !== "settle" || d.scheduledMs < 1000 || d.visibility !== "visible") continue;
     cycle.settledSamples += 1;
     const nav = d.nav;
@@ -81,6 +83,7 @@ export function summarizeOwnerViewport(data, sessionData = data) {
     truncated: Boolean(data?.truncated), sessionHeadersTruncated: Boolean(sessionData?.truncated),
     viewportEvents, usableSamples, unavailableSamples: unavailable, droppedEvents: dropped,
     wakeProfiles: events.filter(e => e.type === "wake").length,
+    detail: summarizeViewportDetail(events, usableSamples, partial),
     clients, clientsWithoutGeometry,
     cycles: rows, cyclesMissingHeaders: missingHeaders,
     cyclesReaching20s: rows.filter(c => c.lastScheduledMs >= 20_000).length,
@@ -92,6 +95,92 @@ export function summarizeOwnerViewport(data, sessionData = data) {
   };
 }
 
+function summarizeViewportDetail(events, usableSamples, partial) {
+  const rows = events.filter(e => e.type === "wake-viewport" && e.data?.v === 1 &&
+    !e.data.error && !e.data._trimmed && e.data.window && e.data.root && e.data.focus);
+  const detailed = rows.filter(e => e.data.layout?.v === 2 && !e.data.layout.omitted);
+  const omitted = rows.filter(e => e.data.layout?.omitted).length;
+  const limitedAncestors = detailed.filter(e => e.data.layout.ancestorLimit).length;
+  const capped = new Set();
+  const groups = new Map();
+  const examples = [];
+  let firstTouchPairs = 0, firstTouchChanges = 0, boundaryChanges = 0, ancestorSamples = 0;
+  const addExample = (event, kind, extra) => {
+    if (examples.filter(example => example.kind === kind).length < 3) examples.push({ kind, sessionId: event.sessionId,
+      cycle: event.data.cycle, seq: event.seq, clientTime: event.clientTime, path: event.path, ...extra });
+  };
+  for (const event of rows) {
+    const d = event.data, key = `${event.sessionId}:${d.cycle}`;
+    const limit = Number(d.activity?.limit);
+    if ((limit > 0 && Number(d.activity?.changes) >= limit) || Number(d.activity?.skippedEvents) > 0) capped.add(key);
+    if (d.layout?.v !== 2 || d.layout.omitted) continue;
+    if (Array.isArray(d.layout.ancestors) && d.layout.ancestors.length) {
+      ancestorSamples++;
+      addExample(event, "ancestor-layout-effects", { ancestors: d.layout.ancestors });
+    }
+    if (!groups.has(key)) groups.set(key, []);
+    groups.get(key).push(event);
+  }
+  for (const group of groups.values()) {
+    // Within one client session sequence order survives wall-clock changes.
+    group.sort((a, b) => a.seq - b.seq || a.clientTime - b.clientTime);
+    let previous = null, firstTouch = null;
+    for (const event of group) {
+      const d = event.data;
+      if (d.signals?.["first-touch"]) firstTouch = event;
+      if (d.signals?.["after-first-touch"] && firstTouch) {
+        const delta = compareBoundaries(firstTouch, event);
+        // A tap can navigate or focus a keyboard; neither is a same-page repair.
+        if (delta && d.elapsedMs - firstTouch.data.elapsedMs <= 2000) {
+          firstTouchPairs++;
+          if (delta.maximum >= 40) {
+            firstTouchChanges++;
+            addExample(event, "first-touch-boundary-change", { beforeSeq: firstTouch.seq, ...delta });
+          }
+        }
+        firstTouch = null;
+      }
+      if (previous) {
+        const delta = compareBoundaries(previous, event);
+        if (delta && delta.maximum >= 40) {
+          boundaryChanges++;
+          addExample(event, "boundary-change", { beforeSeq: previous.seq, signals: d.signals, ...delta });
+        }
+      }
+      previous = event;
+    }
+  }
+  return {
+    coverage: !detailed.length ? "unavailable" : partial || limitedAncestors || detailed.length < usableSamples ? "partial" : "observed",
+    samples: detailed.length, omittedSamples: omitted, limitedAncestorSamples: limitedAncestors, activityCappedCycles: capped.size,
+    firstTouchPairs, firstTouchChanges, boundaryChanges, ancestorSamples, examples,
+    note: "Boundary changes (>=40px) and ancestor CSS effects are comparison evidence, not confirmed gaps or repairs. A first touch can naturally move browser controls. Unchanged DOM measurements cannot rule out a visible rendering fault. Activity capture is bounded; no samples or a reached cap cannot establish healthy behavior.",
+  };
+}
+
+function compareBoundaries(before, after) {
+  const a = before.data, b = after.data;
+  if (![a.elapsedMs, b.elapsedMs, a.window.width, b.window.width].every(Number.isFinite) ||
+      before.path !== after.path || a.window.width !== b.window.width ||
+      a.layout.orientation !== b.layout.orientation || b.elapsedMs <= a.elapsedMs) return null;
+  for (const d of [a, b]) {
+    if (d.visibility !== "visible" || d.inset !== 0 || d.focus.editable ||
+        ["input", "textarea", "iframe"].includes(d.focus.tag) ||
+        !Number.isFinite(d.visual?.scale) || Math.abs(d.visual.scale - 1) > 0.01 ||
+        d.nav?.position !== "fixed" || parseFloat(d.nav.bottomStyle) !== 0 ||
+        d.nav.height <= 0 || d.nav.display === "none" || d.nav.visibility === "hidden") return null;
+    if (![d.window.height, d.root.height, d.visual.height, d.visual.offsetTop, d.nav.bottom].every(Number.isFinite)) return null;
+  }
+  const changes = {
+    window: b.window.height - a.window.height,
+    root: b.root.height - a.root.height,
+    visual: b.visual.height - a.visual.height,
+    visualTop: b.visual.offsetTop - a.visual.offsetTop,
+    navBottom: b.nav.bottom - a.nav.bottom,
+  };
+  return { changes, maximum: Math.max(...Object.values(changes).map(Math.abs)) };
+}
+
 export function formatOwnerViewportReport(summary) {
   const lines = [
     "# Owner wake viewport follow-up", "",
@@ -100,6 +189,9 @@ export function formatOwnerViewportReport(summary) {
     `Collection failures: ${summary.collectionFailures?.join(", ") || "none"}.`, "",
     `Large-gap candidates: ${summary.largeGapCycles} cycles; ${summary.repeatedLargeGapCycles} had settled bottom-nav gaps >=100px at least 500ms apart in actual time, no focused input, no app keyboard inset and scale 1.`, "",
     `Missing/trimmed geometry: ${summary.unavailableSamples}; clients without usable geometry: ${summary.clientsWithoutGeometry}; reported dropped events: ${summary.droppedEvents}; cycles without session context: ${summary.cyclesMissingHeaders}; truncated trace: ${summary.truncated}; truncated session history: ${summary.sessionHeadersTruncated}.`, "",
+    `Expanded diagnostics: **${summary.detail?.coverage || "unavailable"}**; ${summary.detail?.samples || 0} detailed samples, ${summary.detail?.omittedSamples || 0} payload-budget omissions, ${summary.detail?.limitedAncestorSamples || 0} bounded ancestor scans, ${summary.detail?.activityCappedCycles || 0} cycles reached the activity cap.`, "",
+    `Comparison leads: ${summary.detail?.boundaryChanges || 0} boundary changes >=40px; ${summary.detail?.firstTouchPairs || 0} comparable first-touch pairs (${summary.detail?.firstTouchChanges || 0} changed >=40px); ${summary.detail?.ancestorSamples || 0} samples with ancestor layout effects. These are not diagnoses. See detail.examples in owner-wake-summary.json and the corresponding raw sequence numbers.`, "",
+    summary.detail?.note || "Expanded telemetry has not been observed in this window.", "",
     summary.note, "",
     "Read owner-wake.json and owner-wake-sessions.json alongside this summary. Compare affected and ordinary cycles within the same client/browser version. Distinguish viewport height changes, viewport panning and nav displacement; correlate the wake performance profile and its upload network tag. Record the evidence and next action in the daily report even when coverage is unavailable.", "",
     "| Client | Platform | Cycle | Samples | Settled | Large gap | Max root gap | Max visual gap |",

package/lib/admin.js

@@ -3013,6 +3013,20 @@ export function parseAdminOperation(options) {
     // Mikey's decisions, any time; each comes with its evidence (approvals.ts).
     return buildApprovalOperation({ action, target, options });
   }
+  if (namespace === "dictionary") {
+    if (action === "korean-status") return readOperation("dictionary.korean-status", "/cli/admin/dictionary/korean/status", { requiresRun: false });
+    if (action === "korean-pending") return readOperation("dictionary.korean-pending", withQuery("/cli/admin/dictionary/korean/pending", {
+      cursor: options.adminCursor || undefined,
+      limit: parseRequiredInteger(options.adminLimit || 30, "--limit", 1, 100),
+    }), { requiresRun: false });
+    if (action === "korean-review" && target) {
+      const raw = readAdminJsonFile(target, "<reviewed-definitions.json>", { maxBytes: 512 * 1024 });
+      const items = Array.isArray(raw) ? raw : raw?.items;
+      if (!Array.isArray(items) || !items.length || items.length > 100) throw cliValidationError("Review 1 to 100 Korean definitions, keeping exported word IDs, revisions and source hashes.");
+      return writeOperation("dictionary.korean-review", "POST", "/cli/admin/dictionary/korean/review", { items, dryRun: Boolean(options.adminDryRun) }, { requiresRun: false, mutates: !options.adminDryRun, timeoutMs: 120000 });
+    }
+    throw cliValidationError("Use: lumine admin dictionary korean-status | korean-pending [--cursor <time:id>] [--limit <1-100>] | korean-review <reviewed-definitions.json> [--dry-run]");
+  }
   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", {

package/lib/commands.js

@@ -2474,6 +2474,7 @@ export function parseArgs(args) {
   const booleanFlags = new Set([
     // lumine admin arena import --live
     "live",
+    "additive",
     "remove",
     "fault",
     "noAnnounce",
@@ -2701,6 +2702,7 @@ export function parseArgs(args) {
     // lumine admin arena (admin-arena.js)
     adminArenaAudio: raw.audio ? String(raw.audio) : "",
     adminArenaLive: parseBoolean(raw.live, false),
+    adminArenaAdditive: parseBoolean(raw.additive, false),
     adminArenaItem: raw.item ? String(raw.item) : "",
     adminArenaTo: raw.to ? String(raw.to) : "",
     adminClaimFile: raw.claim ? String(raw.claim) : "",
@@ -2851,6 +2853,10 @@ export function parseArgs(args) {
     adminTarget: raw.target ? String(raw.target) : "",
     adminActions: raw.actions ? String(raw.actions) : "",
     adminDate: raw.date ? String(raw.date) : "",
+    adminCostDate: raw.costDate ? String(raw.costDate) : "",
+    adminPhase: raw.phase ? String(raw.phase) : "",
+    adminMaxSteps: raw.maxSteps ?? "",
+    adminMaxSeconds: raw.maxSeconds ?? "",
     adminDays: raw.days ? String(raw.days) : "",
     adminSpendingMonth: raw.month,
     adminSpendingFrom: raw.from,
@@ -3310,6 +3316,7 @@ export function printHelp() {
   lumine admin teachers audit [--limit <1-100>] [--cursor <c>] [--all] | revoke <userId> --reason <text>   (approved teachers, a page at a time or --all: new flags first, then changed since your review; revoke removes the status cleanly)
   lumine admin teachers branches suggest | networks | confirm <networkId> --branch <name> [--branch <name>] [--note <text>] | unconfirm <networkId> | set <userId|username> --branch <name> [--note <text>] | clear <userId|username> | apply | list [--branch <name>|none]   (which branch each teacher works at, confirmed by you through the academy networks they use: suggest finds the networks, confirm names their branch (repeat --branch for a building branches share), apply gives teachers the branch most of their actions there point at and lists the unclear ones; set wins over networks)
   lumine admin teachers review <userId> --decision legit|revoke --note <text> [--fingerprint <fp>, required for revoke] | review --all-flagged --expect <id[:fp],...> --note <text>   (record your review of the facts shown; --all-flagged records only the --expect teachers; nothing is recorded if they changed since. A reviewed teacher comes back when its flags or linked accounts change; accounts sharing a network count only when they change a network flag)
+  lumine admin dictionary korean-status | korean-pending [--cursor <time:id>] [--limit <1-100>] | korean-review <reviewed-definitions.json> [--dry-run]   (shared Korean word-bank definitions; daily review, no paid generation)
   lumine admin english import <verdicts.json> --pass a|b | adjudicate <file> | add-questions <file> | relevel <file> | mastery <userId> --reason <why> | backfill-distractors | 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>]
@@ -3338,7 +3345,7 @@ export function printHelp() {
   lumine admin reward-review reject|revoke <review-id> --reason <text> [--json]
   lumine admin recommendations list [--since-run|--after <date>|--include-legacy] [--all --checkpoint <file> [--resume]] [--content-types comment,dailyReflection] [--unviewed|--viewed] [--cursor <cursor>] [--json]
   lumine admin builds candidates [--since-run|--after <date>|--include-legacy] [--all --checkpoint <file> [--resume]] [--cursor <cursor>] [--limit <number>] [--json]
-  lumine admin daily-run gather --output-dir <dir> [--date YYYY-MM-DD] [--json]   (all read-only daily reports + bot-output pages + bot-chats.txt)
+  lumine admin daily-run gather --output-dir <dir> [--cost-date YYYY-MM-DD] [--phase priority|evidence|all] [--max-steps 200] [--max-seconds 900] [--resume] [--json]   (closed UTC cost day; resumable collection, never automatic review)
   lumine admin daily-run progress --dir <dir> [--file <duty-evidence.json>] [--json]   (reading, canonical effort counts, pending duties)
   lumine admin featured candidates [--days 7] [--after <iso>] [--json]   (recent, provably never-Featured Subjects with comment counts)
   lumine admin report serve --file <report.md> [--port <n>] [--open] [--json]   (loopback report page with section nav)

package/lib/sdk.js

@@ -41,6 +41,9 @@ export const SDK_CLI_METHODS = {
   "wordMaster.reportIssue": { path: "api/content/word-master/telemetry", scopes: ["content:write"], write: true },
   "wordMaster.getDailyWords": { path: "api/content/word-master/words", scopes: ["content:read"] },
   "wordMaster.getWord": { path: "api/content/word-master/details", scopes: ["content:write"], write: true },
+  "wordMaster.lookupWord": { path: "api/content/word-master/dictionary", scopes: ["content:read"] },
+  "wordMaster.generateKoreanDefinition": { path: "api/content/word-master/korean-definition", scopes: ["content:write"], write: true },
+  "wordMaster.getKoreanDefinition": { path: "api/content/word-master/korean-definition-status", scopes: ["content:write"], write: true },
   "wordMaster.generateEntry": { path: "api/content/word-master/generate-entry", scopes: ["content:write"], write: true },
   "wordMaster.getEntry": { path: "api/content/word-master/entry-status", scopes: ["content:read"], write: true },
   "wordMaster.encounterWords": { path: "api/content/word-master/encounter", scopes: ["content:write"], write: true },

package/package.json

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

package/sdk/BUILD_SDK_INDEX.md

@@ -1,8 +1,8 @@
 # Build SDK Index
 
 Version: 1.73.0
-Updated: 2026-10-25
-Generated: 2026-10-25T00:59:10.277Z
+Updated: 2026-10-27
+Generated: 2026-10-26T22:37:17.385Z
 
 ## Platform rules
 Each rule below is a way an app breaks once it runs inside Twinkle's sandboxed frame, even when the code itself is correct. They outrank every other guideline: follow them in every change, including small ones, and fix any break of them you see in code you touch.
@@ -828,6 +828,21 @@ const result = await Twinkle.characters.chat({ character: 'zero', thinkingMode:
   - Returns: { word: { id, word, definition, example, wordLevel, canGenerate }, mode }
   - Open an existing Word Master word’s reviewed definition and example, and add it to the viewer’s book.
   - Pass wordId or the exact word. Reuses reviewed existing definitions and suitable public AI Card examples. Blank definition/example means missing. Adds this encounter to the book but awards nothing; this is a write for CLI/capture permission purposes. No viewer AI Battery is used.
+- async lookupWord({ wordId, word }) | scopes: content:read
+  - Returns: { word: { id, word, wordLevel, definitions: [{ partOfSpeech, definition }], koreanDefinition, koreanDefinitionRevision, koreanDefinitionStatus } }
+  - Read an exact word from the shared dictionary without spending Battery or changing the viewer’s book.
+  - Pass wordId or an exact English headword (1–64 characters; internal spaces, apostrophes and hyphens supported). Only existing, uncensored word-bank entries are eligible; an unknown spelling returns dictionary_word_not_found (404). This does not create words or perform reverse Korean search.
+  - koreanDefinitionStatus is missing, generated (awaiting daily review), or reviewed. definitions contains up to 12 existing English meanings. Reads never generate or charge. Always use current canonical text: daily corrections replace earlier generated text.
+- async generateKoreanDefinition({ wordId, requestId, useAiBattery }) | scopes: content:write
+  - Returns: { entry?: { id, wordId, requestId, status, failureCode }, word?, pending?, alreadyComplete?, aiUsagePolicy? }
+  - Fill a missing shared Korean definition using the searching member’s AI Battery.
+  - Before the intentional search, clearly disclose that a missing Korean definition uses the viewer’s AI Battery; pass useAiBattery:true. Do not generate on page load, resume, keystrokes or background refresh. Cached content costs no Battery. This is shared canonical dictionary content in BOTH preview and live, across all apps; it grants no XP, Coins, mastery or completion receipt.
+  - Persist a stable 16–64 character requestId before calling. One reservation per word prevents concurrent duplicate generations. pending:true means another request owns that reservation: use free lookupWord checks, then allow an explicit retry if it remains missing. Never invent a payment or definition from local state.
+  - entry.status is pending, generated, ready, failed or superseded. Recover unknown transport outcomes with getKoreanDefinition and the SAME requestId; retrying generate with that same ID is idempotent. A confirmed failed job may be deliberately retried with a new ID. Only successful saved definitions charge Battery, atomically with publication. At most 20 generation attempts per member per UTC day and one active generation per member.
+- async getKoreanDefinition({ requestId }) | scopes: content:write
+  - Returns: { entry: { id, wordId, requestId, status, failureCode } | null, word?, aiUsagePolicy? }
+  - Recover a Korean-definition request after a lost response without another model call.
+  - Scoped to this build and viewer. A generated result is saved and charged once; status never launches another model call. entry:null means no job was found: an explicit retry must reuse the saved requestId. Return values include the current shared definition, including subsequent reviewer corrections.
 - async generateEntry({ wordId, requestId, useAiBattery }) | scopes: content:write
   - Returns: { entry?, word?, alreadyComplete?, aiUsagePolicy, mode }
   - Use viewer AI Battery to fill a missing meaning/example once, with a server-verified contribution receipt.

package/sdk/LUMINE_ADMIN.md

@@ -1653,6 +1653,27 @@ control contents. Normal wakes are retained for comparison. `--perf` also
 includes the geometry rows. The session's `viewportTrace: 1` marks support;
 older tabs do not acquire it until they load a version containing the change.
 
+The October 26 expanded recorder keeps that v1 event compatible and adds
+`layout.v: 2` (`viewportDetail: 2` on the session): body/root bounds, nav padding,
+orientation and bounded ancestor CSS-effect flags. Mobile load/return cycles
+also capture one first-touch/300ms pair and at most four debounced
+resize/scroll/orientation bursts. `signals` and `activity` retain event counts,
+the cap and skipped/pending events; optional context can explicitly report
+`omitted: "payload-budget"`. No page content, screenshot or automatic correction
+is included. Check `work/mobile-bottom-gap-20261026/telemetry/STATUS.md` for
+actual release status; use the workspace CLI for this expanded summary until
+an npm release containing it is recorded there.
+
+The daily summary's `detail` reports expanded coverage, capped/omitted samples,
+boundary changes, comparable first-touch pairs and ancestor effects, with raw
+sequence numbers for follow-up. These are comparison leads, never proof of a
+rendering defect or repair. Normal toolbar movement changes heights too. A
+normal DOM rectangle cannot disprove a visible compositor-only gap, and reads
+may flush pending layout. Review new evidence and keep the original roughly
+108px gap open until its cause and fix are established. Follow the owner-wake
+section in `agent-guides/lumine-admin.md`; do not restart the stopped physical
+phone/Simulator investigation without Mikey's instruction.
+
 `daily-run gather` additionally saves `owner-wake.json`, the retained session
 context in `owner-wake-sessions.json`, and `owner-wake-summary.json` / `.md`.
 Include the coverage and follow-up in the daily report. A >=100px settled gap
@@ -5544,3 +5565,13 @@ Every full daily website-management run adds reviewed Word Master words across a
 ## Word Search monthly champions
 
 Word Search rankings come from server-verified solves, but every board comes from public inputs, so a script playing at a human-looking pace can still rank. A month's champion prize (word-search-champion-v1) opens only after review. From 07:00 UTC on the 2nd, run `lumine admin word-games champions --build <id>`. It lists the last three final months: the current candidate, whether the win is confirmed or collected, and each top-three player's best solves (score, seconds, words, gaps between words, gap variation (near 0 means machine-even spacing), misses, pauses, hints, best streak, days played). Confirm a believable human with `lumine admin word-games confirm <YYYY-MM> <userId> --build <id> --reason "<evidence>"`. Disqualify a scripted winner with `disqualify`; the next eligible player becomes the candidate, so review them too. Removed and fully banned accounts are skipped automatically. Both writes are audited, and neither works after the prize is collected. Until confirmation the winner's game shows that the win is being checked.
+
+## Shared Korean dictionary definitions
+
+Every full management run includes this dedicated review, requested by Mikey October 27. A missing Korean definition is generated on an intentional member search using **that member's AI Battery**; saved definitions are shared and free to reuse. Preview and live apps use the same canonical word bank. These admin commands never invoke a paid model, charge a member, or grant rewards.
+
+- `lumine admin dictionary korean-status --json`: current generated/reviewed/pending coverage, oldest pending time, outstanding jobs and recent failures.
+- `lumine admin dictionary korean-pending --limit 100 [--cursor <time:id>] --json`: full text, English reference meanings, exact IDs/revisions/source hashes. Continue through `nextCursor` until null. Read and assess every entry; collection alone is not review.
+- `lumine admin dictionary korean-review <reviewed.json> --dry-run --json`, then omit `--dry-run` to apply the same reviewed payload within authorized content-maintenance scope. Accepts an array or `{ "items": [...] }`, 1–100 entries, each `{ "wordId": 123, "word": "example", "expectedRevision": 1, "expectedSourceHash": "<exported SHA-256>", "koreanDefinition": "<checked Korean meaning>", "reason": "<what was checked or corrected>" }`. Keep exact exported identity/version fields; supply a reason even when accepting unchanged text. All entries commit together with a mutation audit. Conflicts require re-export and re-review, never blind retry with new revisions.
+
+Assess common senses, part of speech and inflections, precision and natural Korean for learners. Use your own language judgment and source checks where needed; no paid batch-generation calls. Corrections update the shared word-bank field for all apps; successful reviews mark it reviewed and advance its revision. Future paid generation never overwrites existing text. The final run report includes reviewed/corrected/remaining counts, oldest waiting age, generation/Battery recovery failures, pagination coverage and carryovers. Re-read status after applying. Missing tables/endpoints mean the release is unavailable, not an empty healthy queue.