@stage5/lumine 0.3.41 → 0.3.43

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-featured.js

@@ -253,6 +253,7 @@ export async function runFeaturedWorkflow({
   operation,
   authToken,
   runId,
+  sourceRunId = 0,
   request = requestJson,
 }) {
   const apiUrl = String(options.apiUrl).replace(/\/$/, "");
@@ -273,9 +274,9 @@ export async function runFeaturedWorkflow({
       options.adminFile,
       options.adminApprove,
     );
-    if (plan.runId !== runId)
+    if (plan.runId !== runId && !(sourceRunId > 0 && plan.runId === sourceRunId))
       throw invalid(
-        "This plan belongs to a different run; prepare and approve a fresh plan.",
+        "This plan belongs to a different run; prepare and approve a fresh plan, or apply it from an approvals run started on its full run (--scope approvals --source-run).",
       );
     const result = await call(
       "/plan/apply",

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
@@ -1310,6 +1312,8 @@ export async function adminCommand(options) {
   });
   let runId = 0;
   let runScope = null;
+  // The full run an approvals run applies (0 for every other run).
+  let sourceRunId = 0;
   let correctionSessionId = 0;
   let correctionSession = null;
   let commentSessionId = 0;
@@ -1404,6 +1408,8 @@ export async function adminCommand(options) {
     if (selectedRun) {
       runScope = canonicalAdminRunScope(selectedRun);
       assertAdminOperationAllowedForRunScope({ operation, runScope });
+      sourceRunId =
+        runScope === "approvals" ? Number(selectedRun.sourceRunId || 0) : 0;
     }
     if (options.adminIdentity && commentSession) {
       const requestedIdentity = parseIdentity(options.adminIdentity);
@@ -1517,6 +1523,8 @@ export async function adminCommand(options) {
         operation,
         authToken: auth.token,
         runId,
+        // An approvals run applies its source full run's Featured plan.
+        sourceRunId,
       });
     } else if (operation.name === "build.review") {
       result = await runManagedBuildReview({
@@ -2300,7 +2308,8 @@ export function canonicalAdminRunScope(run) {
   const raw = run?.runScope;
   if (raw === undefined || raw === null || raw === "") return "full";
   const scope = String(raw);
-  if (["full", "featured", "newspaper"].includes(scope)) return scope;
+  if (["full", "featured", "newspaper", "approvals"].includes(scope))
+    return scope;
   throw cliValidationError(
     "The API returned an invalid administrator run scope.",
   );
@@ -2332,6 +2341,17 @@ const FEATURED_RUN_OPERATIONS = new Set([
   "daily-run.fail",
 ]);
 
+// An approvals run acts on Mikey's decisions whenever he gets to them: a full
+// run's write work without the newspaper, sponsor scan or bank seeding (the
+// API holds the same line through the run's scopes).
+const APPROVALS_RUN_EXCLUDED_OPERATIONS = new Set([
+  "news.claim",
+  "news.print",
+  "news.submit",
+  "sponsor.integrity.scan",
+  "reward-bank.seed",
+]);
+
 export function assertAdminOperationAllowedForRunScope({
   operation,
   runScope,
@@ -2352,6 +2372,12 @@ export function assertAdminOperationAllowedForRunScope({
       `A newspaper-only run does not authorize ${operation.name}.`,
     );
   }
+  if (runScope === "approvals") {
+    if (!APPROVALS_RUN_EXCLUDED_OPERATIONS.has(operation.name)) return;
+    throw cliValidationError(
+      `An approvals run does not do ${operation.name}; that belongs to a full daily run.`,
+    );
+  }
   if (runScope !== "featured") return;
   const subjectCommentAlias =
     operation.name === "post.comments" &&
@@ -3013,28 +3039,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 +3242,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 },
       );
     }
@@ -3870,8 +3812,23 @@ export function parseAdminOperation(options) {
   if (namespace === "daily-run") {
     if (action === "start") {
       const runScope = parseDailyRunScope(options.adminScope || "full");
-      const commentMode = parseCommentMode(options.commentMode || "off");
-      if (runScope !== "full" && commentMode !== "off") {
+      // An approvals run acts on decisions, so it posts unless told otherwise.
+      const commentMode = parseCommentMode(
+        options.commentMode || (runScope === "approvals" ? "post" : "off"),
+      );
+      // Optional: lets an approvals run reuse that run's plans and drafts.
+      const sourceRunId =
+        runScope === "approvals" && options.adminSourceRun
+          ? parseRequiredInteger(options.adminSourceRun, "--source-run", 1)
+          : undefined;
+      if (runScope !== "approvals" && options.adminSourceRun) {
+        throw cliValidationError("--source-run is only for --scope approvals.");
+      }
+      if (
+        runScope !== "full" &&
+        runScope !== "approvals" &&
+        commentMode !== "off"
+      ) {
         throw cliValidationError("A scoped run requires --comment-mode off.");
       }
       return writeOperation(
@@ -3887,6 +3844,7 @@ export function parseAdminOperation(options) {
           commentMode,
           scope: runScope,
           runKey: options.runKey || defaultDailyRunKey(runScope),
+          ...(sourceRunId ? { sourceRunId } : {}),
         },
       );
     }
@@ -5537,8 +5495,10 @@ function parseDailyRunScope(value) {
   const scope = String(value || "full")
     .trim()
     .toLowerCase();
-  if (!["full", "featured", "newspaper"].includes(scope)) {
-    throw cliValidationError("--scope must be full, featured, or newspaper.");
+  if (!["full", "featured", "newspaper", "approvals"].includes(scope)) {
+    throw cliValidationError(
+      "--scope must be full, featured, newspaper, or approvals.",
+    );
   }
   return scope;
 }
@@ -5870,17 +5830,24 @@ function printAdminEnergyBudget(energyBudget) {
     );
   }
   console.log(
-    "day        | charged | overflow | users | rechg | runs | calls/run avg/p90 | $/run avg/p90 | stops chg/unchg | busy | queue rst/stop/resume | telemetry rows",
+    "day        | charged | overflow | users | rechg | runs | calls/run avg/p90 | $/run avg/p90 | stops chg/unchg | busy | queue rst/stop/resume/wait-cancel | telemetry rows",
   );
   for (const day of energyBudget.byDay || []) {
     const m = day.telemetry.metrics;
     const runs = day.runs.total;
     // Queue metrics are absent from APIs older than the queued-request telemetry.
-    const queue = ["queued_restored", "queued_stopped", "busy_resume_requested"]
+    // worker_wait_cancelled: a request cancelled because the Build worker
+    // stayed unreachable through the API handoff wait.
+    const queue = [
+      "queued_restored",
+      "queued_stopped",
+      "busy_resume_requested",
+      "worker_wait_cancelled",
+    ]
       .map((metric) => String(m[metric]?.count ?? "-"))
       .join("/");
     console.log(
-      `${day.dayKey}${day.inProgress ? "*" : " "}| ${formatAdminUsd(day.chargedUsd).padStart(7)} | ${formatAdminUsd(day.overflowUsd).padStart(8)} | ${String(day.users).padStart(5)} | ${String(day.recharges).padStart(5)} | ${String(runs.runs).padStart(4)} | ${String(runs.callsPerRun.avg).padStart(7)}/${String(runs.callsPerRun.p90).padEnd(9)} | ${formatAdminUsd(runs.usdPerRun.avg).padStart(6)}/${formatAdminUsd(runs.usdPerRun.p90).padEnd(6)} | ${String(m.budget_stop_changed.count).padStart(7)}/${String(m.budget_stop_unchanged.count).padEnd(7)} | ${String(m.busy_refusal.count).padStart(4)} | ${queue.padEnd(21)} | ${day.telemetry.rowCount}`,
+      `${day.dayKey}${day.inProgress ? "*" : " "}| ${formatAdminUsd(day.chargedUsd).padStart(7)} | ${formatAdminUsd(day.overflowUsd).padStart(8)} | ${String(day.users).padStart(5)} | ${String(day.recharges).padStart(5)} | ${String(runs.runs).padStart(4)} | ${String(runs.callsPerRun.avg).padStart(7)}/${String(runs.callsPerRun.p90).padEnd(9)} | ${formatAdminUsd(runs.usdPerRun.avg).padStart(6)}/${formatAdminUsd(runs.usdPerRun.p90).padEnd(6)} | ${String(m.budget_stop_changed.count).padStart(7)}/${String(m.budget_stop_unchanged.count).padEnd(7)} | ${String(m.busy_refusal.count).padStart(4)} | ${queue.padEnd(33)} | ${day.telemetry.rowCount}`,
     );
   }
   console.log("* = in-progress UTC day; never headline it.");
@@ -6419,37 +6386,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 +6396,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 +6418,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 +6494,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 +6512,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 +6537,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 +6562,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/build-review.js

@@ -909,15 +909,19 @@ async function runChromeReview({
       }
     }
     await cdp.send("Browser.close").catch(() => {});
+    let forcedTermination = false;
     const closeResult = await Promise.race([
       closed,
       delay(5_000).then(() => {
+        forcedTermination = true;
         child.kill("SIGTERM");
         return closed;
       }),
     ]);
     return {
       ...closeResult,
+      closeRequested: true,
+      forcedTermination,
       stdout,
       stderr,
       consoleLines: consoleLines.slice(-MAX_CAPTURED_LOG_LINES),
@@ -934,6 +938,31 @@ async function runChromeReview({
   }
 }
 
+const CHROME_KILLED_AFTER_CLOSE_CODE = 2;
+
+// Chrome sometimes exits 2 (RESULT_CODE_KILLED) while tearing down a
+// GPU-heavy page after our own Browser.close. Every piece of evidence was
+// captured before that close, so that one shutdown result is cleanup, not a
+// failed review. Any other code, a signal, or our forced kill still fails.
+export function reviewBrowserExitedCleanly(browser) {
+  return (
+    browser?.code === 0 ||
+    (browser?.code === CHROME_KILLED_AFTER_CLOSE_CODE &&
+      !browser.signal &&
+      browser.closeRequested === true &&
+      browser.forcedTermination === false)
+  );
+}
+
+// The last few Chrome stderr lines, for diagnosing a nonzero exit.
+function chromeStderrTail(stderr) {
+  return String(stderr || "")
+    .split(/\r?\n/)
+    .filter(Boolean)
+    .slice(-20)
+    .map((line) => line.slice(0, 400));
+}
+
 function captureConsoleEvidence(stderr, cdpLines = []) {
   const chromeLines = String(stderr || "")
     .split(/\r?\n/)
@@ -1003,8 +1032,9 @@ export async function runManagedBuildReview({ options, authToken, buildId }) {
   const interactionOutcome = browser.interaction || null;
   const interactionCompleted =
     !interaction || interactionOutcome?.status === "completed";
+  const browserExitedCleanly = reviewBrowserExitedCleanly(browser);
   const confirmed =
-    browser.code === 0 &&
+    browserExitedCleanly &&
     screenshotBytes > 0 &&
     browser.runtimeReadiness?.ready === true &&
     beforeVersion === afterVersion &&
@@ -1025,6 +1055,10 @@ export async function runManagedBuildReview({ options, authToken, buildId }) {
       executable,
       exitCode: browser.code,
       signal: browser.signal,
+      closeRequested: browser.closeRequested === true,
+      forcedTermination: browser.forcedTermination === true,
+      exitedCleanly: browserExitedCleanly,
+      stderrTail: browser.code === 0 ? null : chromeStderrTail(browser.stderr),
       runtimeReadiness: browser.runtimeReadiness,
     },
     screenshot: {
@@ -1059,7 +1093,12 @@ export async function runManagedBuildReview({ options, authToken, buildId }) {
         ? "The Build was republished during review; review the new artifact before commenting."
         : browser.runtimeReadiness?.runtimeErrorVisible
           ? "The isolated Build runtime exposed a runtime error instead of a reviewable app."
-          : interactionFailure
+          : !browserExitedCleanly &&
+              screenshotBytes > 0 &&
+              browser.runtimeReadiness?.ready === true &&
+              interactionCompleted
+            ? `Chrome exited with ${browser.signal ? `signal ${browser.signal}` : `code ${browser.code}`}${browser.forcedTermination ? " after the CLI had to stop it" : ""} once the review evidence was captured. The app loaded and the screenshots are in the receipt, but the receipt is not confirmed; see browser.stderrTail and review again.`
+            : interactionFailure
             ? `Interaction step ${interactionOutcome?.failedStep?.index ?? "?"} (${interactionOutcome?.failedStep?.kind ?? "?"}) failed: ${interactionOutcome?.failedStep?.error ?? "unknown"} The receipt lists the ${interactionOutcome?.stepsCompleted ?? 0} completed step(s) and their screenshots; fix the script and review again.`
             : "The isolated Build runtime did not become visibly reviewable before the observation window ended.",
       interactionFailure

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,8 +2793,12 @@ 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) : "",
+    adminSourceRun: raw.sourceRun ? String(raw.sourceRun) : "",
     adminTarget: raw.target ? String(raw.target) : "",
     adminActions: raw.actions ? String(raw.actions) : "",
     adminDate: raw.date ? String(raw.date) : "",
@@ -3231,6 +3236,7 @@ export function printHelp() {
   lumine admin ai-email-policy get --email <address> [--json]
   lumine admin ai-email-policy set --email <address> --mode <automatic|separate_accounts> --note <text> [--json]
   lumine admin daily-run start [--scope full|featured|newspaper] [--identity zero|ciel|auto] [--comment-mode off|draft|post] [--run-key <key>] [--json]
+  lumine admin daily-run start --scope approvals [--source-run <run-id>] [--identity zero|ciel] [--comment-mode off|draft|post] [--json]   # act on Mikey's decisions; --source-run reuses that run's plans and drafts
   lumine admin daily-run status|report|complete|fail [--run <completed-run-id>] [--reason <text>] [--json]
   lumine admin daily-run escalation add --target <target> --note <summary> [--severity attention|urgent] [--json]
   lumine admin escalation list [--status open|acknowledged|resolved|all] [--limit <number>] [--json]
@@ -3255,7 +3261,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.43",
   "description": "Command line tools for launching Lumine builds on Twinkle.",
   "type": "module",
   "bin": {

package/sdk/LUMINE_ADMIN.md

@@ -28,6 +28,30 @@ canonical structured data.
   `off`. It cannot inspect queues, conduct, logs, Builds, or Featured.
   Completion does not advance full-review windows or carry-over telemetry.
   Its distinct `/daily-runs/start/newspaper` endpoint fails closed on older APIs.
+- `--scope approvals [--source-run <id>]` acts on Mikey's decisions whenever
+  he gets to them (Mikey, 10-17: don't be trapped by the morning run). It has
+  a full run's write work: Featured plans and changes, Featured-comment and
+  generic recommendations, rewards, comments (draft, post, edit) and chat. It
+  has none of the newspaper, sponsor scan, bank seeding or reading duties, and
+  never counts as a full review, so review windows don't move.
+  - `--source-run` is optional. It lets the run use that run's prepared
+    Featured plan (same hash) and review receipts for up to 7 days, abandoned
+    runs included. A stale board is still refused at apply, so prepare a new
+    plan then.
+  - Source drafts expire after 30 minutes: re-draft an approved comment with
+    its approved text (with a fresh `builds review` receipt for an app). The
+    API refuses a second published comment by the same identity in the same
+    place for the same source run.
+  - Identity defaults to the source run's (else today's scheduled one) and
+    `--identity` overrides it. Either way it is named explicitly, so Bangkok
+    midnight doesn't end the run. `--comment-mode` defaults to `post`.
+    Its distinct `/daily-runs/start/approvals` endpoint fails closed on older
+    APIs.
+- **Complete a full run when its report is delivered** (`daily-run complete`),
+  even with Mikey's decisions still pending. Do not hold it open for them: an
+  expired run can never be completed, so the review would not count, its
+  report would be unavailable, and the next run would re-read the whole
+  window. When Mikey answers, start an approvals run on it.
 - The public content actor is Zero or Ciel. Mikey's operator ID is retained in
   private audit rows and is not embedded in public comment metadata.
 - Delegated HTTP work never authenticates as the bot, opens a bot socket, changes
@@ -1017,6 +1041,8 @@ identity, or advances rotation.
 lumine admin daily-run start --identity auto --comment-mode off --json
 lumine admin daily-run start --scope featured --identity auto --json
 lumine admin daily-run start --scope newspaper --identity auto --json
+lumine admin daily-run start --scope approvals --source-run 125 --json
+lumine admin daily-run start --scope approvals --identity zero --json
 lumine admin daily-run start --identity ciel --comment-mode draft \
   --run-key daily:2026-08-06:review --json
 lumine admin daily-run status --json
@@ -2769,7 +2795,9 @@ inferred. The CLI then reads the live board and verifies exact membership/order.
 Retry the identical apply command after uncertain transport failure; it reuses
 the same idempotency key. If the final read fails or finds an intervening change,
 the error retains the canonical apply receipt and never restores old state.
-Expired/different runs require a fresh plan and renewed approval.
+A different run requires a fresh plan and renewed approval, except an
+approvals run started with `--source-run <the plan's run>`, which can apply
+that exact plan with the same hash (or prepare a new one).
 
 Use the following workflow for full daily comment review, or only when Mikey's
 Featured slice includes comment encouragement:
@@ -5346,17 +5374,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.