@stage5/lumine 0.3.40 → 0.3.42

package/README.md

@@ -61,20 +61,14 @@ Mikey reviews with `lumine admin storage list`, `show <user>`,
 or grants directly with `lumine admin storage grant <user> --size <size>`.
 Approvals are capped at 2 GB and never lower a creator below the default.
 
-Bridge Builder meetup quest crews (the website's /achievements/bridge-builder
-page) are reviewed with `lumine admin meetup list [--status review|active|completed|all]`,
-`show <crewId>` (includes a one-hour link to the proof video),
-`approve-crew <crewId>`, `approve-grownup <crewId>`,
-`request-changes <crewId> --note <text>`,
-`approve-plan <crewId> [--note <text>]`, `send-back <crewId> --note <text>`
-(sends back whatever is waiting: the video, else the plan) and
-`approve <crewId> --attended <userId,userId,...>`, which unlocks the
-achievement for every member ticked once the server confirms the requirements.
-`request-changes` holds the current crew or grown-up approval step, shows the
-staff note to every member on the crew page and chat tracker, and announces it
-in the crew chat. Members can request review again after making the changes;
-staff still need to approve the step. Use `info` only for private questions to
-one member about their identity.
+Bridge Builder crews (the website's /achievements/bridge-builder page) are
+managed with `lumine admin meetup list [--status review|active|completed|all]`,
+`show <crewId>`, `info <crewId> <userId> --decision ...` (a member's private
+who-are-you check), `set-branch`, `branches`, `emails`, `funnel` and the
+`announce-checkins [--send] [--as zero|ciel]` (the check-in announcement posts
+itself once; this previews it or retries a failed crew). Since 2026-10-17
+Bridge Builder unlocks from QR check-ins (7 people, or one meetup a grown-up
+witnessed); crews no longer wait for staff approvals.
 
 For team projects, Lumine mirrors the website workspace flow: choosing or
 pulling the owner's main project creates or reuses your contribution branch and

package/lib/admin.js

@@ -323,7 +323,7 @@ function buildNotableScoringOperation({ action, target, options }) {
 
 // Management approvals (dob/mentor/meetup) and the teacher audit.
 const APPROVAL_USAGE =
-  "Use: 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>]";
+  "Use: lumine admin approvals list [--status pending|approved|rejected|settled|all] [--type dob|mentor|meetup] | show <id> | approve <id> [--reason <text>] | reject <id> [--reason <text>] | supermod <id> [--reason <text>]";
 const TEACHER_USAGE =
   "Use: lumine admin teachers audit [--limit <1-100>] [--cursor <c>] [--all] | branches suggest|networks|confirm|unconfirm|set|clear|apply|list (`lumine admin teachers branches usage` prints each one) | revoke <userId> --reason <text> | review <userId> --decision legit|revoke --note <text> [--fingerprint <fp>] (revoke needs it) | review --all-flagged --expect <id[:fp],...> --note <text>";
 
@@ -343,6 +343,8 @@ function buildApprovalOperation({ action, target, options }) {
           "pending",
           "approved",
           "rejected",
+          // a Bridge Builder hold that resolved on its own
+          "settled",
           "all",
         ]),
         type: options.adminType
@@ -2922,7 +2924,22 @@ export function parseAdminOperation(options) {
       if (!Array.isArray(items) || !items.length || items.length > 100) throw cliValidationError("Import 1 to 100 reviewed words, with definitions and examples.");
       return writeOperation("word-games.import", "POST", "/cli/admin/word-games/import", { items, dryRun: Boolean(options.adminDryRun) }, { requiresRun: false, mutates: !options.adminDryRun, timeoutMs: 120000 });
     }
-    throw cliValidationError("Use: lumine admin word-games status | candidates <1-5> [--after <id>] [--limit <n>] | import <reviewed-words.json> [--dry-run]");
+    // Word Search monthly champions: evidence first, then a verdict (Mikey 10-17).
+    if (action === "champions") return readOperation("word-games.champions", withQuery("/cli/admin/word-games/champions", {
+      buildId: parseRequiredInteger(options.adminBuild, "--build", 1),
+    }), { requiresRun: false });
+    if ((action === "confirm" || action === "disqualify") && target) {
+      const reason = String(options.adminReason || "").trim();
+      if (!/^\d{4}-\d{2}$/.test(target) || reason.length < 8) throw cliValidationError(`Use: lumine admin word-games ${action} <YYYY-MM> <userId> --build <id> --reason "<evidence>"`);
+      return writeOperation("word-games.champion-review", "POST", "/cli/admin/word-games/champions/review", {
+        buildId: parseRequiredInteger(options.adminBuild, "--build", 1),
+        month: target,
+        userId: parseRequiredInteger(extra, "user id", 1),
+        verdict: action === "confirm" ? "confirmed" : "disqualified",
+        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>\"");
   }
   if (namespace === "english") {
     return buildEnglishOperation({ action, target, options });
@@ -2998,28 +3015,15 @@ export function parseAdminOperation(options) {
   }
 
   if (MEETUP_NAMESPACES.has(namespace)) {
-    // Bridge Builder meetup quest crews (achievement type 'meetup'): the same
-    // reviews as the admin controls on the website quest page. Mikey's own
-    // decision, any time, never in a daily run.
+    // Bridge Builder crews (achievement type 'meetup'): the same admin tools as
+    // the website. Crews no longer wait for staff approvals (check-ins are the
+    // proof, 2026-10-17). Mikey's own decision, any time, never in a daily run.
     const usage =
-      "Usage: lumine admin meetup list [--status review|active|completed|all] | approve-crew <crewId> | approve-grownup <crewId> | request-changes <crewId> --note <text> | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | parent-reply <crewId> <memberUserId> --note <text> | funnel [--days <1-90>] | branches [list|show|approve|reject|merge] | show <crewId> | approve-plan <crewId> [--note <text>] | send-back <crewId> --note <text> | approve <crewId> --attended <userId,userId,...> [--note <text>] | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | set-branch <crewId> <userId> --branch <name> [--note <text>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>.";
+      "Usage: lumine admin meetup list [--status review|active|completed|all] | show <crewId> | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | set-branch <crewId> <userId> --branch <name> [--note <text>] | branches [list|show|approve|reject|merge] | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | funnel [--days <1-90>] | story ... | announce-checkins [--send] [--as zero|ciel].";
     const note = String(options.note || "").trim();
     if (note.length > 1000) {
       throw cliValidationError("--note must be at most 1000 characters.");
     }
-    if (action === "parent-reply") {
-      // Answer a parent's question: shown on their page, and they are emailed.
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      const memberId = parseRequiredInteger(extra, "Member (child) user ID", 1);
-      if (!note) throw cliValidationError("parent-reply needs --note <your answer>.");
-      return writeOperation(
-        "meetup.parent-reply",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/parents/${memberId}/reply`,
-        { reply: note },
-        { requiresRun: false },
-      );
-    }
     if (action === "branches" || action === "branch") {
       // Every branch name a member types is registered; the first sighting alerts
       // Mikey (a Zero DM card). Approve = a real branch, reject = not real (the
@@ -3214,96 +3218,25 @@ export function parseAdminOperation(options) {
         { requiresRun: false },
       );
     }
-    if (action === "request-changes") {
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      if (!note) throw cliValidationError("request-changes needs --note <what the whole crew must change>.");
-      return writeOperation(
-        "meetup.request-changes",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/request-changes`,
-        { note },
-        { requiresRun: false },
-      );
-    }
-    if (action === "approve-crew" || action === "approve-grownup") {
-      // Every step passes through the owner: the crew (members + branches) and
-      // the grown-up step (parents' yes + the named adult).
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      return writeOperation(
-        action === "approve-crew" ? "meetup.approve-crew" : "meetup.approve-grownup",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/${action}`,
-        {},
-        { requiresRun: false },
-      );
-    }
-    if (action === "approve-plan") {
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      return writeOperation(
-        "meetup.approve-plan",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/approve-plan`,
-        { note },
-        { requiresRun: false },
-      );
-    }
-    if (action === "send-back") {
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      if (!note) {
-        throw cliValidationError(
-          "lumine admin meetup send-back <crewId> needs --note <what to change> (the crew sees it).",
-        );
+    if (action === "announce-checkins") {
+      // The check-in rework's one announcement in every active crew chat
+      // (pre-written, no AI Energy). Without --send it only shows the messages.
+      const agent = String(options.adminAs || "zero").toLowerCase();
+      if (!["zero", "ciel"].includes(agent)) {
+        throw cliValidationError("lumine admin meetup announce-checkins [--send] [--as zero|ciel]");
       }
-      return writeOperation(
-        "meetup.send-back",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/send-back`,
-        { note },
-        { requiresRun: false },
-      );
-    }
-    if (action === "approve") {
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      const attendedUserIds = String(options.adminAttended || "")
-        .split(",")
-        .map((part) => part.trim())
-        .filter(Boolean)
-        .map((part) => parseRequiredInteger(part, "--attended user ID", 1));
-      if (!attendedUserIds.length) {
-        throw cliValidationError(
-          "lumine admin meetup approve <crewId> needs --attended <userId,userId,...> (the members who showed up in the video).",
-        );
-      }
-      return writeOperation(
-        "meetup.approve",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/approve`,
-        { attendedUserIds: [...new Set(attendedUserIds)], note },
-        { requiresRun: false },
-      );
-    }
-    if (action === "slot") {
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      if (options.adminConfirm === "") {
-        throw cliValidationError(
-          "lumine admin meetup slot <crewId> needs --confirm <slotIndex> (0 is the first offered slot; see `show`).",
+      if (!options.adminSend) {
+        return readOperation(
+          "meetup.announce-checkins",
+          withQuery("/cli/admin/meetup-quest/announce-checkins", { agent }),
+          { requiresRun: false },
         );
       }
       return writeOperation(
-        "meetup.slot",
+        "meetup.announce-checkins",
         "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/slot`,
-        { slotIndex: parseRequiredInteger(options.adminConfirm, "--confirm", 0, 9) },
-        { requiresRun: false },
-      );
-    }
-    if (action === "resend-email") {
-      const crewId = parseRequiredInteger(target, "Crew ID", 1);
-      return writeOperation(
-        "meetup.resend-email",
-        "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/resend-email`,
-        {},
+        "/cli/admin/meetup-quest/announce-checkins",
+        { send: true, agent },
         { requiresRun: false },
       );
     }
@@ -6404,37 +6337,6 @@ function shortDate(seconds) {
   return value > 0 ? new Date(value * 1000).toISOString().slice(0, 10) : "";
 }
 
-export function meetupAdultLine(adult) {
-  const request = adult?.request || null;
-  if (adult?.display?.kind === "classroom") {
-    return adult.display.status === "confirmed"
-      ? `  Adult coming: classroom meetup, supervised at ${adult.display.name} (Twinkle arranges the grown-up)`
-      : "  Adult coming: classroom meetup, Twinkle arranges the grown-up (slot not confirmed yet)";
-  }
-  if (!adult?.kind) {
-    return request?.status === "declined"
-      ? `  Adult coming: not named yet (Twinkle teacher ${request.teacherUsername} (user ${request.teacherUserId}) declined${request.afterYes ? " after saying yes" : ""} ${shortDate(request.answeredAt)})`
-      : "";
-  }
-  if (adult.kind !== "teacher") return `  Adult coming: parent: ${adult.name}`;
-  if (adult.teacher?.userId) {
-    const who = `Twinkle teacher ${adult.teacher.username} (user ${adult.teacher.userId}, approved teacher account)`;
-    if (Number(adult.confirmedAt || 0) > 0) {
-      return `  Adult coming: ${who}, confirmed ${shortDate(adult.confirmedAt)}`;
-    }
-    if (adult.display?.status === "waiting" || request?.status === "open") {
-      return `  Adult coming: ${who}, waiting for confirmation${request?.sentAt ? ` (asked ${shortDate(request.sentAt)})` : ""}`;
-    }
-    if (adult.display?.status === "confirmed" || (!adult.display && !adult.teacherProblem)) {
-      return `  Adult coming: ${who}`;
-    }
-  }
-  // the API blanks `name` for a teacher that does not count; staff get what
-  // is on file as `unconfirmedName`
-  const typed = adult.unconfirmedName || adult.name;
-  return `  Adult coming: Twinkle teacher NOT CONFIRMED${typed ? ` (on file: "${typed}")` : ""}: ${adult.teacherProblem || "no approved teacher account picked"}`;
-}
-
 function printMeetupCrew(crew) {
   const progress = crew.progress || {};
   console.log(
@@ -6445,9 +6347,10 @@ function printMeetupCrew(crew) {
     console.log(`  ${step.number}. ${step.label} [${step.state}] ${step.detail}`);
   }
   console.log(`  Members: ${formatMeetupMembers(crew.members)}`);
-  for (const [step, review] of Object.entries(crew.reviews || {})) {
-    console.log(`  ${step === "crew" ? "Crew" : "Parents and adult"} approval: ${review.status}${review.requestedAt ? ` (review requested ${shortDate(review.requestedAt)})` : ""}`);
-    if (review.note) console.log(`    Shared staff note (every crew member sees this): ${review.note}`);
+  if (crew.completedAt) {
+    console.log(
+      `  Met up ${shortDate(crew.completedAt)}${crew.tier ? ` (${crew.tier})` : ""}: checked in ${(crew.members || []).filter((m) => m.attended).map((m) => m.username).join(", ") || "nobody"}`,
+    );
   }
   // staff's "who are you" checks on these members (any crew), newest first
   for (const check of crew.memberChecks || []) {
@@ -6466,43 +6369,11 @@ function printMeetupCrew(crew) {
       `  Branch set by ${change.actorUsername || "staff"} ${shortDate(change.createdAt)} · ${change.username} (${change.userId}): "${change.oldBranch || "none"}" -> "${change.newBranch}"${change.note ? ` · private note: ${change.note}` : ""}`,
     );
   }
-  for (const parent of crew.parentContacts || []) {
-    console.log(
-      `  Parent of ${parent.childUsername}: ${parent.status}${parent.verifiedGuardian ? " (guardian on file)" : parent.staffVerified ? " (staff verified)" : " (child-typed address: NOT verified)"} · ${parent.email}${parent.question ? ` · asks: "${parent.question}"` : ""}`,
-    );
-  }
   if (Array.isArray(crew.invites) && crew.invites.length) {
     console.log(
       `  Pending invites: ${crew.invites.map((invite) => `${invite.username} (${invite.userId}, invite ${invite.inviteId})`).join("; ")}`,
     );
   }
-  const adultLine = meetupAdultLine(crew.adult);
-  if (adultLine) console.log(adultLine);
-  const plan = crew.plan || {};
-  if (plan.status && plan.status !== "none") {
-    console.log(
-      `  Plan (${plan.status}): ${plan.date}${plan.time ? ` at ${plan.time}` : ""} in ${plan.area}: ${plan.activity}${plan.note ? ` · note: ${plan.note}` : ""}`,
-    );
-  }
-  if (crew.planApprovedBy?.username) {
-    console.log(`  Plan approved by ${crew.planApprovedBy.username}`);
-  }
-  const venue = crew.venue || {};
-  if (venue.status && venue.status !== "none") {
-    const slots = (venue.slots || []).map(
-      (slot, index) => `[${index}] ${slot.date} ${slot.start}-${slot.end}`,
-    );
-    console.log(
-      `  Venue (${venue.status}): ${venue.room ? `${venue.branch} · ${venue.room}` : "no classroom (meets elsewhere with the grown-up)"}${slots.length ? ` · slots ${slots.join(", ")}` : ""}${venue.confirmedSlot ? ` · SET: ${venue.confirmedSlot.date} ${venue.confirmedSlot.start}-${venue.confirmedSlot.end}` : ""}`,
-    );
-  }
-  const video = crew.video || {};
-  if (video.status && video.status !== "none") {
-    console.log(
-      `  Video (${video.status}): ${video.fileName}${video.note ? ` · note: ${video.note}` : ""}`,
-    );
-    if (video.url) console.log(`  Watch (link expires in 1 hour): ${video.url}`);
-  }
 }
 
 function printMeetupResult({ operation, data, result }) {
@@ -6574,7 +6445,7 @@ function printMeetupResult({ operation, data, result }) {
     const open = (data.drafts || []).filter((d) => d.status === "held" || d.status === "failed");
     if (!open.length) console.log("Nothing is waiting.");
     for (const d of open) {
-      console.log(`\n#${d.id} [${d.status}] crew #${d.crewId} ${d.kind === "brief" ? "meetup request" : "reply"} -> ${d.to}`);
+      console.log(`\n#${d.id} [${d.status}] ${d.kind === "witness" ? `member #${d.childUserId} asks a parent to be the grown-up` : `crew #${d.crewId} ${d.kind === "brief" ? "meetup request" : "reply"}`} -> ${d.to}`);
       console.log(`  Subject: ${d.subject}`);
       console.log(`  ${String(d.body).split("\n").join("\n  ")}`);
     }
@@ -6592,8 +6463,18 @@ function printMeetupResult({ operation, data, result }) {
     console.log(`  quest page viewers: ${data.questPage?.viewers ?? 0}, of whom ever in a crew: ${data.questPage?.viewersEverInCrew ?? 0}`);
     console.log(`  crews by status: ${JSON.stringify(data.crews?.byStatus || {})}; active by step: ${JSON.stringify(data.crews?.activeByStep || {})}; active by size: ${JSON.stringify(data.crews?.activeBySize || {})}`);
     if (data.branches) console.log(`  branch names: ${JSON.stringify(data.branches.byStatus)}${data.branches.oldestPendingHours ? `; oldest pending ${data.branches.oldestPendingHours}h` : ""}`);
+    if (data.checkins) {
+      const c = data.checkins;
+      console.log(`  check-ins: ${c.ok} pairs (${c.together} together), ${c.refused} refused ${JSON.stringify(c.refusedBy || {})}, crews meeting: ${c.crews}`);
+      // the proximity ladder: which rung showed "together" (a pair can pass several)
+      if (c.byNetwork !== undefined) {
+        console.log(`    together by: network ${c.byNetwork}, academy branch ${c.byAcademy}, sound ${c.bySound} (${c.soundOnly} by sound alone); later proved ${c.upgraded}`);
+        console.log(`    sound check: ${JSON.stringify(c.soundStatus || {})}; grown-up scans ${c.witnessScans?.total || 0} (${c.witnessScans?.inPlace || 0} in place, ${c.witnessScans?.bySound || 0} by sound)`);
+      }
+    }
+    if (data.completedByTier) console.log(`  crews that met, by tier: ${JSON.stringify(data.completedByTier)}`);
     for (const crew of data.activeCrews || []) {
-      console.log(`  #${crew.crewId} step ${crew.step} · ${crew.members} member(s) · idle ${crew.daysIdle}d · ${crew.unverifiedBranches ? `${crew.unverifiedBranches} branch(es) to verify · ` : ""}${crew.parents && crew.parents.asked ? `parents ${crew.parents.approved}/${crew.parents.asked} · ` : ""}chat7d ${crew.chat7d ? `${crew.chat7d.messages} msg/${crew.chat7d.speakers} people` : "n/a"} · ${crew.blocking}`);
+      console.log(`  #${crew.crewId} step ${crew.step} · ${crew.members} member(s) · idle ${crew.daysIdle}d · ${crew.unverifiedBranches ? `${crew.unverifiedBranches} branch(es) to verify · ` : ""}${crew.metAt ? "met up · " : ""}chat7d ${crew.chat7d ? `${crew.chat7d.messages} msg/${crew.chat7d.speakers} people` : "n/a"} · ${crew.blocking}`);
     }
     return;
   }
@@ -6607,7 +6488,7 @@ function printMeetupResult({ operation, data, result }) {
     }
     if (crews.some((crew) => crew.waitingFor)) {
       console.log(
-        "Review: lumine admin meetup show <crewId>, then approve-crew | approve-plan | approve-grownup | send-back --note | approve --attended <ids> | info <crewId> <userId> --decision accept|ask-again (a member's who-are-you answer) (classroom plans: approve at the headmaster desk with a room and times).",
+        "Review: lumine admin meetup show <crewId>, then info <crewId> <userId> --decision accept|ask-again (a member's who-are-you answer).",
       );
     }
     return;
@@ -6632,46 +6513,20 @@ function printMeetupResult({ operation, data, result }) {
     if (data.crew) printMeetupCrew(data.crew);
     return;
   }
-  if (operation.name === "meetup.show" || operation.name === "meetup.parent-reply") {
-    printMeetupCrew(data.crew || {});
-    return;
-  }
-  if (operation.name === "meetup.slot") {
+  if (operation.name === "meetup.announce-checkins") {
     console.log(
-      `Slot set for crew #${data.crew?.crewId}: ${data.slot?.date} ${data.slot?.start}-${data.slot?.end}.`,
+      `${data.send ? "Announced" : "Preview (nothing sent; the announcement posts itself after the update floor reaches 2.3.112, and --send retries a crew not announced yet)"} as ${data.agent === "ciel" ? "Ciel" : "Zero"}:`,
     );
-    if (data.crew) printMeetupCrew(data.crew);
+    for (const crew of data.crews || []) {
+      console.log(`\n#${crew.crewId} "${crew.name}" ${crew.sent ? "SENT" : crew.already ? "(already announced)" : crew.failed ? "FAILED (not posted; --send retries it)" : "(not announced yet)"}`);
+      console.log(`  ${String(crew.text).split("\n").join("\n  ")}`);
+    }
     return;
   }
-  if (operation.name === "meetup.resend-email") {
-    const email = data.email || {};
-    console.log(
-      email.sent
-        ? `Coordinator ${email.kind} email ${email.mode === "sent" ? "sent" : `built (${email.mode})`} to ${email.to}.`
-        : `No email sent: ${email.reason || "unknown"}.`,
-    );
+  if (operation.name === "meetup.show") {
+    printMeetupCrew(data.crew || {});
     return;
   }
-  const stage = data.result?.stage === "video" ? "video" : "plan";
-  if (operation.name === "meetup.approve-crew" || operation.name === "meetup.approve-grownup") {
-    console.log(
-      `${result?.changed === false ? "Already approved" : "Approved"} crew #${data.result?.crewId}'s ${operation.name === "meetup.approve-crew" ? "crew step" : "grown-up step"}.`,
-    );
-  } else if (operation.name === "meetup.approve-plan") {
-    console.log(
-      result?.changed === false
-        ? `Crew #${data.result?.crewId}'s plan was already approved.`
-        : `Approved crew #${data.result?.crewId}'s plan. Next the crew gets its parents' yes and names a grown-up.`,
-    );
-  } else if (operation.name === "meetup.send-back") {
-    console.log(`Sent crew #${data.result?.crewId}'s ${stage} back with your note.`);
-  } else if (operation.name === "meetup.approve") {
-    const unlocked = data.unlocks?.unlockedUserIds || [];
-    const failed = data.unlocks?.failed || [];
-    console.log(
-      `${result?.changed === false ? "Already approved" : "Approved"} crew #${data.result?.crewId}${data.result?.tier ? ` at ${data.result.tier} tier` : ""}: unlocked for user(s) ${unlocked.join(", ") || "none"}.${failed.length ? ` Unlock FAILED for ${failed.join(", ")}; run the same command again.` : ""}`,
-    );
-  }
   if (data.crew) printMeetupCrew(data.crew);
 }
 

package/lib/commands.js

@@ -2483,9 +2483,10 @@ export function parseArgs(args) {
     "confirmEmailRule",
     "includePrefix",
     "allowSharedNetwork",
+    "send",
   ]);
   // A flag that may stand alone (true) or carry a value: `--confirm` confirms
-  // an AI bucket change; `meetup slot <crewId> --confirm <slotIndex>` picks a slot.
+  // an AI bucket change.
   const optionalValueFlags = new Set(["confirm"]);
 
   for (let i = 0; i < rest.length; i += 1) {
@@ -2792,6 +2793,9 @@ export function parseArgs(args) {
     adminConfirm: raw.confirm === undefined ? "" : String(raw.confirm),
     adminInto: raw.into === undefined ? "" : String(raw.into),
     adminNoAnnounce: Boolean(raw.noAnnounce),
+    // meetup announce-checkins: post for real, and who speaks (zero | ciel)
+    adminSend: Boolean(raw.send),
+    adminAs: raw.as ? String(raw.as) : "",
     adminContextLimit: raw.limit === undefined ? 20 : Number(raw.limit),
     adminRun: raw.run ? String(raw.run) : "",
     adminTarget: raw.target ? String(raw.target) : "",
@@ -3255,7 +3259,7 @@ export function printHelp() {
   lumine admin cardcraft-review list [--status pending|approved|all] [--cursor <id>] | show <id> | approve|reject|revoke <id> [--reason <text>]
   lumine admin craft seed --build <id> --file <pairs.json> [--confirm] | stats --build <id> [--limit <1-100>] | revise --build <id> --item <id|name> [--why <text>] [--emoji <emoji>] [--category <field>] [--confirm] | revise --build <id> --pair <pairId|a+b> --why <text> [--confirm] | retire --build <id> --item <id|name> --reason <text> [--confirm] | unfizzle --build <id> [--since <iso>] [--pair <a+b>] [--confirm]   (Twinkle.craft curation: dry run without --confirm)
   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>]
-  lumine admin meetup list [--status review|active|completed|all] | approve-crew <crewId> | approve-grownup <crewId> | request-changes <crewId> --note <text> | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | parent-reply <crewId> <memberUserId> --note <text> | funnel [--days <1-90>] | branches [list [--status pending|official|rejected|all] | show <id> | approve <id> | reject <id> [--note <text>] | merge <id> --into <officialId>] | show <crewId> | approve-plan <crewId> [--note <text>] | send-back <crewId> --note <text> | approve <crewId> --attended <userId,userId,...> [--note <text>] | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | set-branch <crewId> <userId> --branch "<name>" [--note <text>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>   (Bridge Builder meetup quest)
+  lumine admin meetup list [--status review|active|completed|all] | show <crewId> | info <crewId> <userId> --decision ask|accept|ask-again|withdraw [--note <text>] | set-branch <crewId> <userId> --branch "<name>" [--note <text>] | branches [list [--status pending|official|rejected|all] | show <id> | approve <id> | reject <id> [--note <text>] | merge <id> --into <officialId>] | emails [list|send <id>|discard <id>|review on|off] | friends [status|on|off] | funnel [--days <1-90>] | announce-checkins [--send] [--as zero|ciel]   (Bridge Builder crews and check-ins)
   lumine admin meetup story list | show <crewId> | approve <crewId> [--note <text>] [--no-announce] | send-back <crewId> --note <text> | unpublish <crewId> --note <text>   (Bridge Builder story pages: publishes only what every tagged member's parent allowed)
   lumine admin reward-activity [--date YYYY-MM-DD] [--days <1..31>] [--build <id>] [--json]
   lumine admin chat-reports list [--status pending|open|reviewing|resolved|dismissed|all] [--cursor <id>] [--json]

package/lib/sdk.js

@@ -50,6 +50,9 @@ export const SDK_CLI_METHODS = {
   "wordMaster.answerQuiz": { path: "api/content/word-master/answer", scopes: ["content:write"], write: true },
   "wordMaster.getItems": { path: "api/content/word-master/items", scopes: ["content:read"] },
   "wordMaster.useItem": { path: "api/content/word-master/use-item", scopes: ["content:write"], write: true },
+  "wordMaster.startPuzzle": { path: "api/content/word-master/puzzle-start", scopes: ["content:write"], write: true },
+  "wordMaster.sendPuzzleEvents": { path: "api/content/word-master/puzzle-events", scopes: ["content:write"], write: true },
+  "wordMaster.getPuzzleHint": { path: "api/content/word-master/puzzle-hint", scopes: ["content:write"], write: true },
   "grammarbles.listQuestions": { path: "api/content/grammarbles/questions", scopes: ["content:read"] },
   "grammarbles.getMyQuestionHistory": { path: "api/content/grammarbles/history", scopes: ["content:read"] },
   "minecraft.getWorlds": { path: "api/minecraft/worlds", scopes: ["content:read"] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage5/lumine",
-  "version": "0.3.40",
+  "version": "0.3.42",
   "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.67.0
+Version: 1.68.0
 Updated: 2026-10-16
-Generated: 2026-10-16T15:37:18.409Z
+Generated: 2026-10-17T04:41:51.966Z
 
 ## Notes
 - This SDK is injected into Build iframes via the Build preview/runtime.
@@ -40,6 +40,7 @@ Generated: 2026-10-16T15:37:18.409Z
 - word-game-quiz-v1 is a completion reward proof for a correctly answered, Battery-settled Twinkle.wordMaster quiz from today in the same app/viewer/runtime mode. Pass quiz.completionToken to rewards.claim; each quiz pays once across all rules. A series of identical rules allows a bounded number of distinct daily quizzes. Normal review and publication approval still apply; a contribution preview never pays real XP or Coins.
 - word-game-entry-v1 verifies a Battery-settled missing-definition/example contribution made today in this app/runtime mode, paying each contribution once. Its platform cap is three claims per viewer/app/day. word-game-quiz-v1 is capped at five. Declare matching completion rules and normal reward review; these proofs do not approve the app themselves.
 - word-game-puzzle-v1 preserves Word Search streak bonuses using canonical puzzle reward history: daily-easy/medium/hard with optional -s10 and -s20 tiers. A learner earns each difficulty once per UTC day across every tier and release. rewards.getStatus returns wordGamePuzzle { streakDays, ruleIds, earnedLevels }; choose its ruleIds and display canonical rule amounts. Streaks count consecutive days with a puzzle reward, capped at 30. This profile checks streak eligibility and duplicate difficulty claims in addition to the approved timer; it does not simulate or prove the puzzle solve.
+- word-game-puzzle-v2 is the same daily rule and also requires a server-verified finished solve of that difficulty today (Twinkle.wordMaster.startPuzzle and sendPuzzleEvents). word-search-champion-v1 pays only the rank-1 viewer of a completed UTC month on the server-written verified:month:YYYY-MM board (score, then earliest), once per month and only after the month is final (07:00 UTC on the 2nd, when its last boards can no longer take scores); once anyone collected a month, nobody else can; a removed or fully banned #1 passes the prize to the next eligible player; The daily Twinkle review confirms each month’s winner from the server’s record of their solves before the prize opens (a disqualified winner passes it to the next eligible player). rewards.getStatus returns wordSearchChampion: { month, months, claimable, checking } — months are ready to collect; checking lists wins still being confirmed (show a checking message, no collect button). Show the champion banner from that status, never from app storage.
 
 ## AI decision design
 - Twinkle.ai.decide runs JEV, a model for narrow decisions over supplied text or structured state, and it is free for viewers: decisions are covered by Twinkle and never use their AI Energy. Whenever an app makes a judgment that ordinary code can only approximate, consider JEV first. Proven patterns: an opponent or boss coach that reads the player's habits (favourite lane, repeated trick, cheese move) and picks a counter-plan from a fixed list, as in Red Square's boss and Open Football's opponent coach; NPCs that understand what a player types and choose an action; classifying or scoring user submissions; ranking supplied candidates; and picking the next exercise or difficulty from evidence about the learner. Any app with an AI opponent, NPC, or adaptive difficulty should decide explicitly whether JEV improves it. These are examples to reason from, not a keyword checklist or a requirement to add AI to every app.
@@ -761,6 +762,21 @@ const result = await Twinkle.characters.chat({ character: 'zero', thinkingMode:
   - Returns: { item: { id, itemType, usedAt, requestId, puzzleKey }, mode }
   - Consume an earned item once and return a receipt for its game effect.
   - puzzleKey starts items: and has at most 128 letters/digits/:|_-. Persist requestId and puzzleKey before sending. Retry the same IDs after a lost response; apply each receipt once and persist it with the session. Reuse on another puzzle is rejected. Item use is free of AI Battery.
+- async startPuzzle({ level, play, dayKey, revision, gridHash, requestId }) | scopes: content:write
+  - Returns: { sessionId, gridHash, words, ranked }
+  - Start a verified Word Search solve when the timer starts.
+  - Server-verified solves (Mikey 10-17): the server rebuilds the same deterministic board, checks every found word and times the solve itself; it computes the score with the same rules as the app.
+  - play: classic (Original themes board for dayKey and level), daily (Word Master mix from the packet with this revision) or items. dayKey is today or yesterday (UTC). gridHash is the board hash the app built; a mismatch returns code word_search_board_mismatch (play unranked and ask the viewer to reload).
+  - Start the session when the board appears (the ranked clock starts then; the board is the same for everyone all day). Pass a requestId (8–64 letters, digits, - or _) saved before the call: retrying with it returns the same session, so a lost response never costs the ranked attempt. Only the viewer’s first session for a board ranks, whatever the play mode (Items and Word Master mix share boards) and in live or preview; later sessions are practice. Ranked solves allow up to 10 minutes of pauses in total.
+- async sendPuzzleEvents({ sessionId, events }) | scopes: content:write
+  - Returns: { sessionId, status, found, total, ranked, result }
+  - Report found words, misses, pauses and resumes for a verified solve.
+  - Events: { kind: "word", t, cells: [row0, col0, row1, col1] } (the selection’s end cells, either direction), { kind: "miss", t }, { kind: "pause" }, { kind: "resume" }. t is wall-clock milliseconds since the timer started; send each word right away. Pauses are timed by the server clock.
+  - When the last word arrives the server finishes the solve: status finished (result.finalScore, elapsedSeconds, hintsUsed, streakBonusPoints, ranked) or timeout. Show the server result as the official score.
+  - Ranked results need human pacing: send one word per call, with the app’s t at least one second apart. A solve with words under a second apart by t, words arriving under 250 ms apart, several words in one call, or a word reported more than 8 seconds late still counts toward daily rewards but is left off the leaderboards (ranked: false). Boards come from public inputs, so this limits bots rather than making them impossible.
+- async getPuzzleHint({ sessionId, word, t }) | scopes: content:write
+  - Returns: { sessionId, word, row, col, hintsUsed }
+  - Reveal one letter of a word in a verified Classic solve.
 - async getWord({ wordId, word }) | scopes: content:write
   - 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.
@@ -1287,6 +1303,7 @@ const result = await Twinkle.characters.chat({ character: 'zero', thinkingMode:
   - Submit only after computing the final score when a run, shift, match, or level attempt ends; do not submit every frame or every tick.
   - Only improved personal-best scores replace the existing score row.
   - meta is optional JSON object data, max 2 KB.
+  - Boards whose key starts with verified: are written by the server from checked results (Word Search verified solves: verified:day:{dayKey}:{level} for Classic, verified:day:{dayKey}:wm-{level} for Word Master mix, verified:month:YYYY-MM, verified:all, verified:all:{level}, verified:points). Read them with get; submit refuses them.
 
 ### Twinkle.sharedDb
 - async getTopics() | scopes: sharedDb:read

package/sdk/LUMINE_ADMIN.md

@@ -5346,17 +5346,22 @@ Study's registered `study-record-v1` checks use learner AI Energy for accepted,
 
 For total JEV cost, include `dailyAiCosts.byProviderModel` for TypeSafe/JEV across both AI Energy and system-covered ledgers. Report serving/shadow/audit operations separately as above; the Build SDK's system-covered/failed calls use `jev_decision`, while ordinary viewer SDK checks are already counted by the AI Energy ledger. Do not add the Study report's known-cost sum on top of the canonical overall AI-cost total: it is a diagnostic breakdown of those same calls.
 
-## Bridge Builder crew reviews (no daily run required)
-
-On the website, Zero and Ciel acting for an admin can make these staff decisions too (who-are-you checks, branch corrections, crew, plan and branch reviews), through the same routes the admin's own taps use and only after the admin's yes on the approval card (Mikey, 2026-10-10). A member's Zero or Ciel still cannot.
-
-- `lumine admin meetup list` shows steps waiting for staff. Use `list --status active` to include crews making requested changes.
-- `lumine admin meetup show <crewId>` shows canonical progress, approval status, shared feedback, and private staff evidence.
-- `lumine admin meetup approve-crew <crewId>` and `approve-grownup <crewId>` approve the corresponding ready step.
-- `lumine admin meetup request-changes <crewId> --note <text>` holds the current crew or grown-up step, displays the note to **every crew member**, and announces it in the crew chat. The note is required (maximum 1,000 characters). Members use **Request review again** after making changes; this alerts staff and returns the step to the queue without approving it.
-- `lumine admin meetup send-back <crewId> --note <text>` is for a pending plan or video. Those steps keep their existing revise-and-submit flow.
-- `lumine admin meetup info <crewId> <userId> --decision ask|accept|ask-again|withdraw` is a **private identity check**. Its question and answer are visible only to the named member and staff. Use `request-changes`, not `info`, for instructions the whole crew needs to see.
-- `lumine admin meetup set-branch <crewId> <userId> --branch <name> [--note <text>]` corrects a member's branch instead of a database write. `--branch` must be an official branch (a registry alias such as `Busan` resolves to its official name, `Haeundae`), a name still pending in the branch registry, or `"Not a Twinkle student"`. Former Twinkle students get the branch they went to. An official branch is verified at once; a pending name waits for its branch decision. The crew's progress, tier and staff alerts follow the new branch; approvals already given stay. The same branch again changes nothing. The private note and the change history are shown only to admins (`meetup show`, the crew page's staff panel); nobody is messaged. The command refuses members who left and crews that are not active.
+## Bridge Builder crews and check-ins (no daily run required)
+
+Since 2026-10-17 Bridge Builder unlocks from QR check-ins: 7 different people, or one meetup a grown-up witnessed. Crews no longer wait for staff approvals. On the website, Zero and Ciel acting for an admin can make the staff decisions below (who-are-you checks, branch corrections and branch reviews). They use the same routes as the admin's own taps, and only after the admin's yes on the approval card (Mikey, 2026-10-10). A member's Zero or Ciel still cannot.
+
+- `lumine admin meetup list` shows crews whose member answered a who-are-you check. `list --status active` shows every live crew, and `list --status completed` the crews that have met up.
+- `lumine admin meetup show <crewId>` shows canonical progress, who checked in, the tier and private staff evidence.
+- `lumine admin meetup info <crewId> <userId> --decision ask|accept|ask-again|withdraw` is a **private identity check**. Its question and answer are visible only to the named member and staff. Until staff accept, that member doesn't count toward the crew's tier.
+- `lumine admin meetup set-branch <crewId> <userId> --branch <name> [--note <text>]` corrects a member's branch instead of a database write.
+  - `--branch` must be one of: an official branch (an alias such as `Busan` resolves to `Haeundae`), a name still pending in the branch registry, or `"Not a Twinkle student"`. Former Twinkle students get the branch they went to.
+  - An official branch is verified at once and the crew's tier follows; a pending name waits for its branch decision.
+  - The private note and the change history are admin-only; nobody is messaged.
+  - It refuses members who left and crews that are not active.
+- `lumine admin meetup funnel [--days <1-90>]` shows views, crews by stage, and check-ins: pairs, how many were on one network or at an academy, and refusals by reason.
+- `lumine admin meetup emails` lists parent emails held for review. Kind `witness` is a child asking a parent to be the grown-up.
+- `lumine admin meetup announce-checkins [--send] [--as zero|ciel]` is about the one-time announcement of the check-in rework in each crew chat. It posts itself when the website with check-ins is out. The messages are pre-written; without `--send` this only shows them. `--send` retries a crew whose post failed. Each crew gets it once.
+- **Held unlocks:** a member who reached 7 people when no counted check-in was on one network or at an academy gets a `meetup` approval item instead of an instant unlock (`lumine admin approvals list --type meetup`). Approving it unlocks Bridge Builder.
 
 Every decision requires Mikey's authorization for that crew and action. Mutations are audited and idempotent; `--output <path>` is an explicit request to retain the canonical JSON. General write receipts omit private crew details.
 
@@ -5364,3 +5369,7 @@ Every decision requires Mikey's authorization for that crew and action. Mutation
 ## 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.
+
+## 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.