@stage5/lumine 0.3.41 → 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
@@ -3013,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
@@ -3229,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).",
-        );
-      }
-      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).",
-        );
+    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.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",
-        "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",
+        "meetup.announce-checkins",
         "POST",
-        `/cli/admin/meetup-quest/crews/${crewId}/resend-email`,
-        {},
+        "/cli/admin/meetup-quest/announce-checkins",
+        { send: true, agent },
         { requiresRun: false },
       );
     }
@@ -6419,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(
@@ -6460,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 || []) {
@@ -6481,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 }) {
@@ -6589,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  ")}`);
     }
@@ -6607,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;
   }
@@ -6622,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;
@@ -6647,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/package.json

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

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.