@stage5/lumine 0.3.19 → 0.3.22

package/README.md

@@ -64,11 +64,17 @@ 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. At least 3 attendees from 3 different
-branches are required.
+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.
 
 For team projects, Lumine mirrors the website workspace flow: choosing or
 pulling the owner's main project creates or reuses your contribution branch and
@@ -231,10 +237,17 @@ audio, and MIDI data (`.mid`/`.midi`; playback still needs an app-side parser
 or synth); `lumine assets list` prints your uploads and refreshes
 `.twinkle/assets.json`.
 
-`lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana>` creates
+**Nano Banana migration (0.3.21):** `--model nano-banana` now selects
+Nano Banana 2.1, the fast tier. In CLI 0.3.20 and earlier it selected Pro.
+To preserve Pro output in an existing script, change the option to
+`--model nano-banana-pro` before upgrading. Existing installed CLIs keep
+using Pro through the server's legacy model alias. This CLI release must be
+published after the API update that accepts the new model IDs.
+
+`lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro>` creates
 an AI-generated image asset instead of uploading one. `--model` is required
 (Flare = fast generation; Sunburst = precise editing; gpt-image-2 = original
-model; nano-banana = Gemini). Generation spends your Twinkle AI Battery, so the
+model; nano-banana = Gemini Nano Banana 2.1, nano-banana-pro = Gemini Nano Banana Pro). Generation spends your Twinkle AI Battery, so the
 CLI shows the estimated cost and asks for confirmation first — non-interactive
 runs must pass
 `--yes` to consent. `--quality low|medium|high|xhigh|max` applies to GPT Image
@@ -246,7 +259,7 @@ actual battery usage also includes prompt and reference input.
 `lumine thumbnail set <file>` uploads a jpg/png/webp (max 8MB) as the build's
 thumbnail. `lumine thumbnail capture` screenshots the running app server-side
 and sets the result (add `--out <file>` to keep a local copy).
-`lumine thumbnail generate ["<prompt>"] --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana>`
+`lumine thumbnail generate ["<prompt>"] --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro>`
 generates an AI image and sets it as the thumbnail (the image is also kept as a
 normal reusable asset); without a prompt the server composes one from the build
 title and description. Replacing an existing thumbnail asks for confirmation;

package/lib/admin-receipts.js

@@ -1,3 +1,5 @@
+import { teacherBranchApplyReceipt } from "./admin-teacher-branches.js";
+
 // What a write keeps on disk as its receipt (admin-request-intents.js writes
 // it to the admin work directory). Most writes keep the API's response; these
 // return private evidence (a teacher's identity facts, a reported child's
@@ -29,6 +31,8 @@ export function receiptToKeep(operation, result) {
         })),
         skipped: (data.skipped || []).map((s) => ({ userId: s.userId ?? null, reason: s.reason ?? null })),
       });
+    case "teachers.branches.apply":
+      return keep(teacherBranchApplyReceipt(data));
     case "chat-reports.set": {
       const report = data.report || {};
       return keep({

package/lib/admin-teacher-branches.js

@@ -0,0 +1,302 @@
+// `lumine admin teachers branches …`: the teacher branch registry (2026-10-08).
+// Which Twinkle branch each approved teacher works at, confirmed by Mikey
+// through the academy networks teachers use, not the branch they typed when
+// they applied. Mikey only, any time, no daily run. Networks are named by a
+// short id and a masked address; a raw address never reaches the CLI.
+//
+//   suggest                 academy networks found live, each with a suggested branch
+//   networks                the confirmed networks
+//   confirm <networkId> --branch <name> [--branch <name>]   (two or more: a shared building)
+//   unconfirm <networkId>
+//   set <userId|username> --branch <name> [--note]   owner setting, beats networks
+//   clear <userId|username>
+//   apply                   recompute network branches from the confirmed networks
+//   list [--branch <name>|none]
+
+export const TEACHER_BRANCHES_USAGE =
+  "Use: lumine admin teachers branches suggest | networks | confirm <networkId> --branch <name> [--branch <name> ...] [--note <text>] | unconfirm <networkId> | set <userId|username> --branch <name> [--note <text>] | clear <userId|username> | apply | list [--branch <name>|none] [--json]";
+
+const BASE = "/cli/admin/teachers/branches";
+// a live scan of a year of teachers' network use: the server stops at 75 s
+const SCAN_TIMEOUT_MS = 150000;
+
+function validationError(message) {
+  const error = new Error(message);
+  error.code = "CLI_ADMIN_CLI_VALIDATION";
+  return error;
+}
+
+const read = (name, path, extra = {}) => ({
+  name,
+  method: "GET",
+  path,
+  body: undefined,
+  mutates: false,
+  requiresRun: false,
+  ...extra,
+});
+const write = (name, path, body, extra = {}) => ({
+  name,
+  method: "POST",
+  path,
+  body,
+  mutates: true,
+  requiresRun: false,
+  ...extra,
+});
+
+/** --branch (repeatable, or comma-separated) and --branches → names. */
+export function parseBranchNames(raw) {
+  return [
+    ...new Set(
+      String(raw || "")
+        .split(",")
+        .map((name) => name.trim())
+        .filter(Boolean),
+    ),
+  ];
+}
+
+function networkIdOf(raw) {
+  const id = String(raw || "").trim().toLowerCase();
+  if (!/^[0-9a-f]{10}$/.test(id)) {
+    throw validationError(
+      "Name the network by the 10-character id `lumine admin teachers branches suggest` printed.",
+    );
+  }
+  return id;
+}
+
+function teacherRefOf(raw) {
+  const ref = String(raw || "").trim();
+  if (!ref) throw validationError(TEACHER_BRANCHES_USAGE);
+  return encodeURIComponent(ref);
+}
+
+export function buildTeacherBranchOperation({ sub, target, options }) {
+  const names = parseBranchNames(options.adminBranch);
+  const note = String(options.note || "").trim();
+  if (!sub || sub === "list") {
+    const branch = names.join(",");
+    return read(
+      "teachers.branches.list",
+      branch ? `${BASE}?branch=${encodeURIComponent(branch)}` : BASE,
+    );
+  }
+  if (sub === "suggest") {
+    return read("teachers.branches.suggest", `${BASE}/suggest`, {
+      timeoutMs: SCAN_TIMEOUT_MS,
+    });
+  }
+  if (sub === "networks") {
+    return read("teachers.branches.networks", `${BASE}/networks`);
+  }
+  if (sub === "confirm") {
+    const id = networkIdOf(target);
+    if (!names.length) {
+      throw validationError(
+        "confirm needs --branch <name> (repeat --branch, or --branches A,B, for a building branches share).",
+      );
+    }
+    return write(
+      "teachers.branches.confirm",
+      `${BASE}/networks/${id}`,
+      { branches: names, ...(note ? { note } : {}) },
+      { timeoutMs: SCAN_TIMEOUT_MS },
+    );
+  }
+  if (sub === "unconfirm") {
+    return write("teachers.branches.unconfirm", `${BASE}/networks/${networkIdOf(target)}/unconfirm`, {});
+  }
+  if (sub === "set") {
+    const ref = teacherRefOf(target);
+    if (names.length !== 1) throw validationError("set needs exactly one --branch <name>.");
+    return write("teachers.branches.set", `${BASE}/teacher/${ref}`, {
+      branch: names[0],
+      ...(note ? { note } : {}),
+    });
+  }
+  if (sub === "clear") {
+    return write("teachers.branches.clear", `${BASE}/teacher/${teacherRefOf(target)}/clear`, {});
+  }
+  if (sub === "apply") {
+    return write("teachers.branches.apply", `${BASE}/apply`, {}, { timeoutMs: SCAN_TIMEOUT_MS });
+  }
+  throw validationError(TEACHER_BRANCHES_USAGE);
+}
+
+/** What an apply keeps as its receipt: counts and the changes, not the lists. */
+export function teacherBranchApplyReceipt(data = {}) {
+  return {
+    counts: data.counts || null,
+    changes: (data.changes || []).map((c) => ({
+      userId: c.userId ?? null,
+      from: c.from ?? null,
+      to: c.to ?? null,
+      ...(c.to ? { share: c.share ?? null, actions: c.actions ?? null, days: c.days ?? null } : {}),
+    })),
+  };
+}
+
+const day = (seconds) =>
+  Number(seconds) > 0 ? new Date(Number(seconds) * 1000).toISOString().slice(0, 10) : "-";
+const GAP_LABELS = {
+  replica_busy: "replica busy",
+  time_limit: "read too slow",
+  time_budget: "out of time",
+  unreadable: "replica busy or too slow",
+};
+const gapText = (gaps) => {
+  const parts = Object.entries(gaps || {})
+    .filter(([, n]) => n > 0)
+    .map(([why, n]) => `${n} ${GAP_LABELS[why] || why}`);
+  return parts.length ? ` (${parts.join(", ")})` : "";
+};
+const evidence = (x) =>
+  x && x.actions != null ? ` · ${x.actions} actions on ${x.days ?? "?"} day(s)` : "";
+const names = (branches) => (branches || []).map((b) => b.displayName || b).join(" + ");
+
+function printSuggest(data) {
+  console.log(
+    `Academy networks (${data.academyMinAccounts}+ accounts in ${data.windowDays} days) used by the ${data.teachers} approved teachers: ${(data.networks || []).length}.`,
+  );
+  if (data.incomplete) {
+    console.log(
+      `Incomplete: ${data.teachersNotRead} teacher(s) not read${gapText(data.teachersNotReadBy)}, ${data.addressesNotCounted} address(es) not counted${gapText(data.addressesNotCountedBy)}. Run it again for the rest.`,
+    );
+  }
+  for (const n of data.networks || []) {
+    console.log("");
+    console.log(
+      `${n.networkId}  ${n.address} · ${n.accounts} accounts · ${n.teachers} teachers · ${n.teacherActions} teacher actions · ${day(n.firstAt)} → ${day(n.lastAt)}`,
+    );
+    const suggestion = n.suggested
+      ? n.suggested.displayName
+      : n.tiedWith?.length
+        ? `tie: ${names(n.tiedWith)}`
+        : "none (no official branch typed)";
+    console.log(
+      `  suggested: ${suggestion}${n.confirmed ? ` · CONFIRMED: ${names(n.confirmed.branches)}${n.confirmed.note ? ` (${n.confirmed.note})` : ""}` : ""}`,
+    );
+    console.log(`  typed: ${(n.typed || []).map((t) => `${t.branch} ${t.teachers}`).join(", ")}`);
+    console.log(
+      `  top: ${(n.topTeachers || []).map((t) => `${t.username || "?"} (#${t.userId}${t.typedBranch ? `, typed "${t.typedBranch}"` : ""}) ${t.actions}`).join("; ")}`,
+    );
+  }
+  if ((data.confirmedNotSeen || []).length) {
+    console.log("\nConfirmed but not seen as an academy network this time:");
+    for (const n of data.confirmedNotSeen) console.log(`  ${n.networkId}  ${n.address} → ${names(n.branches)}`);
+  }
+  console.log(
+    `\nOfficial branches: ${(data.officialBranches || []).map((b) => b.displayName).join(", ")}`,
+  );
+  console.log(
+    "Confirm: lumine admin teachers branches confirm <networkId> --branch <name> (repeat --branch for a building branches share), then: lumine admin teachers branches apply",
+  );
+}
+
+function printList(data) {
+  const counts = Object.entries(data.counts || {})
+    .sort((a, b) => b[1] - a[1])
+    .map(([branch, n]) => `${branch} ${n}`)
+    .join(", ");
+  console.log(`${data.total} approved teachers: ${counts || "-"}`);
+  let current = null;
+  for (const t of data.teachers || []) {
+    const label = t.branch?.displayName || "No confirmed branch";
+    if (label !== current) {
+      current = label;
+      console.log(`\n${label}`);
+    }
+    const source = t.branch
+      ? t.branch.source === "owner"
+        ? " · set by owner"
+        : ` · network ${t.branch.share ?? "?"}%${evidence(t.branch)}`
+      : "";
+    console.log(
+      `  ${t.username} (#${t.userId})${source}${t.typedBranch ? ` · typed "${t.typedBranch}"` : ""} · last active ${day(t.lastActive)}`,
+    );
+  }
+}
+
+function printApply(data) {
+  const c = data.counts || {};
+  console.log(
+    `Applied ${c.confirmedNetworks} confirmed network(s) to ${c.teachers} teachers: ${c.assigned} assigned, ${c.ambiguous} ambiguous, ${c.lowEvidence ?? 0} low evidence (under ${c.minDays ?? "?"} days), ${c.unknown} unknown, ${c.ownerSet} set by owner${c.notRead ? `, ${c.notRead} not read${gapText(c.notReadBy)} (unchanged; run again)` : ""}. ${c.changed} changed; ${c.differsFromTyped} differ from what they typed${c.removedNotTeachers ? `; ${c.removedNotTeachers} former teacher row(s) removed` : ""}.`,
+  );
+  if ((data.changes || []).length) {
+    console.log("\nChanged:");
+    for (const ch of data.changes) {
+      console.log(
+        `  ${ch.username} (#${ch.userId}): ${ch.from || "none"} → ${ch.to || "none"}${ch.to ? ` (${ch.share}%${evidence(ch)})` : ""}`,
+      );
+    }
+  }
+  if ((data.ambiguous || []).length) {
+    console.log("\nAmbiguous (set one with `teachers branches set <user> --branch <name>`):");
+    for (const a of data.ambiguous) {
+      console.log(
+        `  ${a.username} (#${a.userId}) · ${a.candidates.join(" or ")} · ${a.split}${a.typedBranch ? ` · typed "${a.typedBranch}"` : ""} · ${a.reason}`,
+      );
+    }
+  }
+  if ((data.lowEvidence || []).length) {
+    console.log(
+      `\nLow evidence, not assigned (fewer than ${data.counts?.minDays ?? "?"} days on the branch: a visit, or a new teacher):`,
+    );
+    for (const l of data.lowEvidence) {
+      console.log(
+        `  ${l.username} (#${l.userId}) · ${l.branch} ${l.share}%${evidence(l)}${l.typedBranch ? ` · typed "${l.typedBranch}"` : ""}`,
+      );
+    }
+  }
+  if ((data.differsFromTyped || []).length) {
+    console.log("\nAssigned a branch other than the one they typed:");
+    for (const d of data.differsFromTyped) {
+      console.log(`  ${d.username} (#${d.userId}) · typed "${d.typedBranch}" · network ${d.branch} ${d.share}%${evidence(d)}`);
+    }
+  }
+  const unknown = Object.entries(data.unknownReasons || {});
+  if (unknown.length) console.log(`\nUnknown: ${unknown.map(([why, n]) => `${n} ${why}`).join("; ")}`);
+}
+
+export function printTeacherBranchResult({ operation, data }) {
+  switch (operation.name) {
+    case "teachers.branches.suggest":
+      return printSuggest(data);
+    case "teachers.branches.list":
+      return printList(data);
+    case "teachers.branches.apply":
+      return printApply(data);
+    case "teachers.branches.networks": {
+      const networks = data.networks || [];
+      if (!networks.length) return console.log("No confirmed networks yet: lumine admin teachers branches suggest");
+      for (const n of networks) {
+        console.log(
+          `${n.networkId}  ${n.address} → ${names(n.branches)}${n.shared ? " (shared building)" : ""} · confirmed ${day(n.confirmedAt)}${n.note ? ` · ${n.note}` : ""}`,
+        );
+      }
+      return undefined;
+    }
+    case "teachers.branches.confirm":
+      return console.log(
+        `Confirmed ${data.networkId} (${data.address}) as ${names(data.branches)}${data.shared ? " (a shared building: each teacher's typed branch decides there)" : ""}${data.previous?.length ? `; was ${data.previous.join(" + ")}` : ""}. Next: ${data.next}`,
+      );
+    case "teachers.branches.unconfirm":
+      return console.log(
+        `Unconfirmed ${data.networkId} (${data.address}; was ${(data.removedBranches || []).join(" + ")}). Next: ${data.next}`,
+      );
+    case "teachers.branches.set":
+      return console.log(
+        `${data.username} (#${data.userId}) is now ${data.branch?.displayName} (set by owner; networks no longer change it)${data.previous ? `; was ${data.previous.branchKey} (${data.previous.source})` : ""}.`,
+      );
+    case "teachers.branches.clear":
+      return console.log(
+        data.previous
+          ? `Cleared #${data.userId}${data.username ? ` (${data.username})` : ""}: was ${data.previous.branchKey} (${data.previous.source}). ${data.next}`
+          : `#${data.userId} had no branch.`,
+      );
+    default:
+      return console.log(JSON.stringify(data, null, 2));
+  }
+}

package/lib/admin.js

@@ -39,6 +39,10 @@ import {
   printOwnerTrace,
 } from "./admin-owner-trace.js";
 import { formatChatReportResult } from "./admin-chat-reports.js";
+import {
+  buildTeacherBranchOperation,
+  printTeacherBranchResult,
+} from "./admin-teacher-branches.js";
 import {
   buildProfileShowOperation,
   formatProfileReview,
@@ -240,7 +244,7 @@ function parseReviewRequestRef(target, { type: fixedType, typeOption } = {}) {
 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>]";
 const TEACHER_USAGE =
-  "Use: lumine admin teachers audit [--limit <1-100>] [--cursor <c>] [--all] | revoke <userId> --reason <text> | review <userId> --decision legit|revoke --note <text> [--fingerprint <fp>] (revoke needs it) | review --all-flagged --expect <id[:fp],...> --note <text>";
+  "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>";
 
 function parseApprovalId(target) {
   const raw = String(target || "").replace(/^approval:/, "");
@@ -369,6 +373,14 @@ const TEACHER_AUDIT_PAGE = 50;
 const TEACHER_REVIEW_BATCH = 25;
 
 function buildTeacherOperation({ action, target, options }) {
+  // the teacher branch registry (admin-teacher-branches.js)
+  if (action === "branches" || action === "branch") {
+    return buildTeacherBranchOperation({
+      sub: target,
+      target: options.positional?.[3],
+      options,
+    });
+  }
   if (!action || action === "audit") {
     const operation = readOperation(
       "teachers.audit",
@@ -2583,7 +2595,7 @@ export function parseAdminOperation(options) {
     // reviews as the admin controls on the website quest page. 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> | 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>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>.";
+      "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>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>.";
     const note = String(options.note || "").trim();
     if (note.length > 1000) {
       throw cliValidationError("--note must be at most 1000 characters.");
@@ -2771,6 +2783,17 @@ 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).
@@ -5744,6 +5767,46 @@ function formatMeetupMembers(members) {
     .join("; ");
 }
 
+// The crew's grown-up: a parent as the crew typed it; a Twinkle teacher is an
+// approved teacher account (username + id) with where their answer stands
+// (confirmed <date> / waiting for confirmation / declined); a classroom names
+// no person (Twinkle arranges it).
+function shortDate(seconds) {
+  const value = Number(seconds || 0);
+  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(
@@ -5754,6 +5817,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}`);
+  }
   // staff's "who are you" checks on these members (any crew), newest first
   for (const check of crew.memberChecks || []) {
     const answer = check.teacherName
@@ -5775,11 +5842,8 @@ function printMeetupCrew(crew) {
       `  Pending invites: ${crew.invites.map((invite) => `${invite.username} (${invite.userId}, invite ${invite.inviteId})`).join("; ")}`,
     );
   }
-  if (crew.adult?.kind) {
-    console.log(
-      `  Adult coming: ${crew.adult.kind === "teacher" ? "Twinkle teacher" : "parent"}: ${crew.adult.name}`,
-    );
-  }
+  const adultLine = meetupAdultLine(crew.adult);
+  if (adultLine) console.log(adultLine);
   const plan = crew.plan || {};
   if (plan.status && plan.status !== "none") {
     console.log(
@@ -6175,7 +6239,11 @@ export function formatTeacherReviewLine(teacher) {
     ? ` · last review ${r.decision} ${approvalDate(r.reviewedAt)} by ${r.reviewedBy}${r.note ? `: "${r.note}"` : ""}`
     : "";
   const flags = (teacher.flags || []).length ? ` · flags ${teacher.flags.join(", ")}` : "";
-  return `[${status}] ${a.username || "?"} (#${a.userId})${flags}${reviewed}`;
+  // the owner-confirmed branch (teachers branches); not part of the review
+  const branch = teacher.branch
+    ? ` · ${teacher.branch.displayName}${teacher.branch.source === "owner" ? " (set by owner)" : ""}`
+    : "";
+  return `[${status}] ${a.username || "?"} (#${a.userId})${branch}${flags}${reviewed}`;
 }
 
 // One audit entry: reviewed-unchanged teachers are one line (already judged);
@@ -6503,6 +6571,10 @@ function printAdminResult({ operation, result }) {
     );
     return;
   }
+  if (operation.name.startsWith("teachers.branches.")) {
+    printTeacherBranchResult({ operation, data });
+    return;
+  }
   if (operation.name.startsWith("approvals.") || operation.name.startsWith("teachers.")) {
     printApprovalResult({ operation, data });
     return;

package/lib/assets.js

@@ -66,7 +66,7 @@ export async function assetsCommand(options) {
     return;
   }
   throw new Error(
-    'Usage: lumine assets [list] | lumine assets upload <file...> | lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana> | lumine assets delete <assetId> | lumine assets prune [--yes] | lumine assets storage | lumine assets request-storage [--size 500MB|1GB|2GB] [--reason "<what it is for>"]',
+    'Usage: lumine assets [list] | lumine assets upload <file...> | lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro> | lumine assets delete <assetId> | lumine assets prune [--yes] | lumine assets storage | lumine assets request-storage [--size 500MB|1GB|2GB] [--reason "<what it is for>"]',
   );
 }
 
@@ -156,7 +156,7 @@ export function resolveGenerateModel(options) {
   const model = GENERATE_MODEL_ALIASES[rawModel];
   if (!model) {
     throw new Error(
-      "--model is required: gpt-image-2.5-flare (fast generation), gpt-image-2.5-sunburst (precise editing), gpt-image-2, or nano-banana. No default model is applied.",
+      "--model is required: gpt-image-2.5-flare (fast generation), gpt-image-2.5-sunburst (precise editing), gpt-image-2, nano-banana (Nano Banana 2.1) or nano-banana-pro. No default model is applied.",
     );
   }
   const rawQuality = String(options.quality || "").trim();
@@ -165,7 +165,7 @@ export function resolveGenerateModel(options) {
   }
   if (rawQuality && !model.startsWith("gpt-image-")) {
     throw new Error(
-      "--quality only applies to GPT Image models; nano-banana has a single quality tier.",
+      "--quality only applies to GPT Image models; nano-banana and nano-banana-pro have a single quality tier.",
     );
   }
   if (model === "gpt-image-2" && ["xhigh", "max"].includes(rawQuality)) {
@@ -212,7 +212,7 @@ export async function assetsGenerate(options) {
   const prompt = String(options.positional[1] || "").trim();
   if (!prompt) {
     throw new Error(
-      'Usage: lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana> [--quality low|medium|high|xhigh|max] [--name <fileName>] [--yes]',
+      'Usage: lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro> [--quality low|medium|high|xhigh|max] [--name <fileName>] [--yes]',
     );
   }
   const { model, quality } = resolveGenerateModel(options);

package/lib/commands.js

@@ -2455,7 +2455,10 @@ export function parseArgs(args) {
     const [key, inlineValue] = arg.slice(2).split("=", 2);
     const camelKey = toCamelCase(key);
     if (inlineValue !== undefined) {
-      raw[camelKey] = inlineValue;
+      raw[camelKey] =
+        camelKey === "branch" && raw.branch !== undefined
+          ? `${raw.branch},${inlineValue}`
+          : inlineValue;
     } else if (booleanFlags.has(camelKey)) {
       raw[camelKey] = true;
     } else {
@@ -2467,7 +2470,11 @@ export function parseArgs(args) {
       ) {
         throw new Error(`Missing value for --${key}.`);
       }
-      raw[camelKey] = nextValue;
+      // --branch repeats: `--branch Mokdong --branch TwinkleU`
+      raw[camelKey] =
+        camelKey === "branch" && raw.branch !== undefined
+          ? `${raw.branch},${nextValue}`
+          : nextValue;
       i += 1;
     }
   }
@@ -2671,6 +2678,8 @@ export function parseArgs(args) {
     twinkles: raw.twinkles ? String(raw.twinkles) : "",
     adminReason: raw.reason ? String(raw.reason) : "",
     adminSkill: raw.skill ? String(raw.skill) : "",
+    // --branch may repeat (a building two branches share); --branches A,B too
+    adminBranch: [raw.branch, raw.branches].filter(Boolean).join(","),
     adminPass: raw.pass ? String(raw.pass) : "",
     adminLimit: raw.limit === undefined ? null : raw.limit,
     storageSize: raw.size ? String(raw.size) : "",
@@ -2704,6 +2713,7 @@ export function parseArgs(args) {
     repeat: Math.min(Math.max(Math.floor(Number(raw.repeat) || 1), 1), 20),
     allowWrite: parseBoolean(raw.allowWrite, false),
     assumeYes: parseBoolean(raw.yes, false),
+    show: parseBoolean(raw.show, false),
     sdkPath: raw.path ? String(raw.path) : "",
     sdkScopes: String(raw.scopes || "")
       .split(",")
@@ -3041,7 +3051,7 @@ export function printHelp() {
   lumine sdk call <namespace.method> [jsonArgs]
   lumine assets [list]
   lumine assets upload <file...>
-  lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana>
+  lumine assets generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro>
   lumine assets delete <assetId>
   lumine assets prune [--yes]
   lumine assets storage [--json]
@@ -3055,7 +3065,7 @@ export function printHelp() {
   lumine cardcraft check|status|review
   lumine thumbnail set <file>
   lumine thumbnail capture [--out <file>]
-  lumine thumbnail generate ["<prompt>"] --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana>
+  lumine thumbnail generate ["<prompt>"] --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro>
   lumine doctor runtime-assets
   lumine admin identity list|status|use <zero|ciel|auto> [--json]
   lumine admin identity inspect <user-id|username> --reason <management-reason> [--include-private-evidence] [--output <file>] [--json]   (nothing kept on disk unless --output; that copy is 0600)
@@ -3086,12 +3096,13 @@ export function printHelp() {
   lumine admin review list [--type rewards|project|storage|cardcraft] [--status queue|pending|approved|rejected|all] [--cursor <c>] | show <type:id> [--dir <path>] | approve <type:id> [--config <rules.json>] [--size <500MB|1GB|2GB|n MB>] [--reason <text>] | reject|revoke <type:id> [--reason <text>] | propose rewards:<id> --dir <edited-snapshot> --config <rules.json>
   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>]   (management approvals with evidence: birthdates, teacher signups, meetups)
   lumine admin teachers audit [--limit <1-100>] [--cursor <c>] [--all] | revoke <userId> --reason <text>   (approved teachers, a page at a time or --all: new flags first, then changed since your review; revoke removes the status cleanly)
+  lumine admin teachers branches suggest | networks | confirm <networkId> --branch <name> [--branch <name>] [--note <text>] | unconfirm <networkId> | set <userId|username> --branch <name> [--note <text>] | clear <userId|username> | apply | list [--branch <name>|none]   (which branch each teacher works at, confirmed by you through the academy networks they use: suggest finds the networks, confirm names their branch (repeat --branch for a building branches share), apply gives teachers the branch most of their actions there point at and lists the unclear ones; set wins over networks)
   lumine admin teachers review <userId> --decision legit|revoke --note <text> [--fingerprint <fp>, required for revoke] | review --all-flagged --expect <id[:fp],...> --note <text>   (record your review of the facts shown; --all-flagged records only the --expect teachers; nothing is recorded if they changed since. A reviewed teacher comes back when its flags or linked accounts change; accounts sharing a network count only when they change a network flag)
   lumine admin english import <verdicts.json> --pass a|b | adjudicate <file> | add-questions <file> | relevel <file> | mastery <userId> --reason <why> | backfill-distractors | summary | review [--limit <n>] | accept|retire <questionId> | retag <questionId> --skill <code>   (English skill tags and bank upkeep for Grammarbles; content written by Claude Code agents)
   lumine admin reward-review list [--status pending|approved|all] [--cursor <id>] [--json]
   lumine admin cardcraft-review list [--status pending|approved|all] [--cursor <id>] | show <id> | approve|reject|revoke <id> [--reason <text>]
   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> | 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>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>   (Bridge Builder meetup quest)
+  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>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>   (Bridge Builder meetup quest)
   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]
@@ -3307,7 +3318,7 @@ Options:
   --json                Print machine-readable output where supported
   --keep-assets         Keep doctor probe assets instead of deleting them
   --no-browser          Skip doctor browser probes
-  --model <model>       Image model for generate: gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2, or nano-banana (required)
+  --model <model>       Image model for generate: gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2, nano-banana (Nano Banana 2.1) or nano-banana-pro (required)
   --quality <q>         GPT Image quality: low, medium, high, xhigh, max (default high; xhigh/max require 2.5)
   --name <fileName>     File name hint for a generated asset
   --out <path>          With thumbnail capture: also save the capture locally

package/lib/constants.js

@@ -21,8 +21,14 @@ export const GENERATE_MODEL_ALIASES = {
   flare: "gpt-image-2.5-flare",
   sunburst: "gpt-image-2.5-sunburst",
   "gpt-image-2": "gpt-image-2",
-  "nano-banana": "gemini-3-pro-image-preview",
-  "gemini-3-pro-image-preview": "gemini-3-pro-image-preview",
+  // Gemini by tier (the API's NANO_BANANA_MODEL / NANO_BANANA_PRO_MODEL):
+  // nano-banana = the fast tier (Nano Banana 2.1 since 2026-10-08), pro = Pro
+  "nano-banana": "gemini-nano-banana-2.1",
+  "nano-banana-2.1": "gemini-nano-banana-2.1",
+  "gemini-nano-banana-2.1": "gemini-nano-banana-2.1",
+  "nano-banana-pro": "gemini-3-pro-image",
+  "gemini-3-pro-image": "gemini-3-pro-image",
+  "gemini-3-pro-image-preview": "gemini-3-pro-image",
 };
 export const GENERATE_QUALITIES = new Set([
   "low",
@@ -278,10 +284,10 @@ lumine save --summary "Describe the change"
   replaces. Update code references, then delete or prune the old asset.
 - Prefer one small assets module (e.g. src/assets.js) mapping names to asset
   URLs over scattering URLs through the code.
-- \`lumine assets generate "<prompt>" --model <gpt-image-2|nano-banana>\` creates
+- \`lumine assets generate "<prompt>" --model <gpt-image-2|nano-banana|nano-banana-pro>\` creates
   an AI-generated image asset. --model is REQUIRED (no default): gpt-image-2 is
-  best quality but slower and pricier; nano-banana (Gemini) is faster and
-  cheaper. It spends the logged-in user's AI Battery, so it asks y/N with the
+  best quality but slower and pricier; nano-banana (Gemini Nano Banana 2.1) is
+  the fastest and cheapest; nano-banana-pro (Gemini Nano Banana Pro) sits between. It spends the logged-in user's AI Battery, so it asks y/N with the
   estimated cost first; non-interactive runs must pass --yes to consent.
   Optional: --quality low|medium|high (gpt-image-2 only, default high),
   --name <fileName>. The asset lands in .twinkle/${ASSETS_METADATA_FILE} like an upload.
@@ -313,7 +319,7 @@ lumine save --summary "Describe the change"
   build's thumbnail. Thumbnails display ~16:9; the image is uploaded uncropped.
 - \`lumine thumbnail capture\` screenshots the running app server-side and sets
   the result as the thumbnail (add --out <file> to also save it locally).
-- \`lumine thumbnail generate "<prompt>" --model <gpt-image-2|nano-banana>\`
+- \`lumine thumbnail generate "<prompt>" --model <gpt-image-2|nano-banana|nano-banana-pro>\`
   generates an AI image and sets it as the thumbnail (also stored as a normal
   reusable asset). Same battery-cost consent rules as \`assets generate\`.
 - Replacing an existing thumbnail asks y/N; pass --yes for non-interactive runs.

package/lib/thumbnail.js

@@ -42,7 +42,7 @@ export async function thumbnailCommand(options) {
     return;
   }
   throw new Error(
-    'Usage: lumine thumbnail set <file> | lumine thumbnail capture [--out <file>] | lumine thumbnail generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana>',
+    'Usage: lumine thumbnail set <file> | lumine thumbnail capture [--out <file>] | lumine thumbnail generate "<prompt>" --model <gpt-image-2.5-flare|gpt-image-2.5-sunburst|gpt-image-2|nano-banana|nano-banana-pro>',
   );
 }
 

package/package.json

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

package/sdk/BUILD_SDK_INDEX.md

@@ -2,7 +2,7 @@
 
 Version: 1.63.0
 Updated: 2026-09-28
-Generated: 2026-10-07T07:52:06.040Z
+Generated: 2026-10-08T04:59:03.150Z
 
 ## Notes
 - This SDK is injected into Build iframes via the Build preview/runtime.
@@ -536,6 +536,7 @@ const result = await Twinkle.ai.chat({ message, history: chatHistory, systemProm
   - referenceImageB64 may be a raw base64 string or a data:image/...;base64 URL.
   - Optional model: gpt-image-2.5-flare or gpt-image-2.5-sunburst. Without a model, OpenAI uses Flare for new images and Sunburst when a reference image or continuation is supplied. Explicit gpt-image-2 remains supported.
   - Quality accepts low, medium, high, xhigh, or max. xhigh and max require a GPT Image 2.5 model. Gemini has one quality tier.
+  - engine: 'gemini' uses Google's Nano Banana 2.1 (the fast Gemini image tier; it replaced the retired original Nano Banana on 2026-10-08).
   - GPT Image 2.5 battery spending uses actual image-model input and output token usage. The confirmation shows an image-output estimate; prompts and reference images use additional energy.
   - responseId and imageId are opaque continuation handles. Pass them back unchanged to edit a prior result; do not assume an OpenAI ID format. Existing GPT Image 2 continuations remain usable.
   - Example: const result = await Twinkle.ai.generateImage({ prompt: 'Create a fashion guide portrait for this face with flattering colors and outfit ideas', referenceImageB64, quality: 'high', onStatus: (status) => console.log(status.stage) });

package/sdk/LUMINE_ADMIN.md

@@ -1208,6 +1208,47 @@ lumine admin identity network <userId|username> --reason <text> [--include-priva
 - Revoke marks the request rejected, keeps who, when and why, and refuses sage/founder holders.
 - The daily-run procedure is in `agent-guides/lumine-admin.md`.
 
+### Teacher branches (Mikey only, any time; added 2026-10-08)
+
+Which Twinkle branch each approved teacher works at, confirmed by Mikey through the academy networks teachers use. The branch a teacher typed when they applied is only a hint: many typed nothing, two branches, "Substitute", or an alias.
+
+```bash
+lumine admin teachers branches suggest
+lumine admin teachers branches networks
+lumine admin teachers branches confirm <networkId> --branch <name> [--branch <name> ...] [--note <text>]
+lumine admin teachers branches unconfirm <networkId>
+lumine admin teachers branches set <userId|username> --branch <name> [--note <text>]
+lumine admin teachers branches clear <userId|username>
+lumine admin teachers branches apply
+lumine admin teachers branches list [--branch <name>|none] [--json]
+```
+
+- `suggest` finds the **academy networks** live: an address (`users_actions`) that 15 or more accounts used in the last 365 days, among addresses approved teachers used at least 3 times. Each one shows:
+  - a 10-character `networkId` and a masked address (`58.151.x.59`); raw addresses never leave the server;
+  - its account and teacher counts, and when teachers used it (an academy that changed address shows as two networks with dates that meet);
+  - what its teachers typed, the branch most of them typed (`suggested`; `tie` when two are level), and its top 5 teachers;
+  - whether it is already `CONFIRMED`.
+  The read uses the read replica only, never the primary, and is time-bounded (75 s). A busy replica, or a read that hits its cap, is reported as not read, with the reason; it is never an error. `Incomplete` means run it again.
+- `confirm` names the network's branch. The network id must come from a `suggest` of the last 7 days (the server remembers what suggest found, so a confirm does not rescan; otherwise run suggest again). Names are the official Bridge Builder branches or their aliases (`meetup_quest_branches`; "Twinkle U" = TwinkleU, 목동 = Mokdong). A branch that is not official yet is refused: make it official in `lumine admin meetup branches` first. Give **two or more `--branch`** (or `--branches A,B`) for a building branches share (Mikey 10-08: TwinkleU and Mokdong share one). Confirming again replaces the branches. `unconfirm` removes a network.
+- `apply` recomputes the branch of every approved teacher that Mikey has not set, from their last-365-day actions on confirmed networks only:
+  - a single-branch network counts for its branch;
+  - on a shared network the actions count for the teacher's typed branch when it is one of that network's branches; otherwise they count for the shared group;
+  - the teacher gets the top branch when it is not tied, holds at least half the actions (with shared networks that include it), and no other branch has 10% or more;
+  - and the branch has actions on at least **3 distinct days** (Korea time) and at least 3 actions. Fewer is **low evidence**, which may be a single meetup visit to another branch or a new teacher. Such a teacher is listed with the branch, actions and days, and gets no branch. The default is 3 days, pending Mikey's confirmation. `TEACHER_BRANCH_MIN_DAYS` on the API overrides it; 0 turns it off;
+  - otherwise the teacher is **ambiguous** (two branches, a substitute, or mostly in a shared building with no matching typed branch) and is listed with the candidate branches. No actions on a confirmed network is **unknown**. Teachers who could not be read (replica busy, slow read, time budget) are left unchanged and counted as not read.
+  Ambiguous, low-evidence and unknown teachers get no branch; an earlier network branch is removed. It reports:
+  - counts: assigned / ambiguous / low evidence / unknown / set by owner / not read, with reasons;
+  - every change, with share, actions and days;
+  - the ambiguous and low-evidence lists;
+  - teachers given a branch other than the one they typed. Run it after each confirm or unconfirm.
+- `set` is Mikey's own setting for one teacher and always wins: `apply` never changes it. `clear` removes any branch (the next `apply` may give a network branch).
+- `list` shows every approved teacher grouped by branch, with the source (`set by owner`, or `network NN% · N actions on N day(s)`), what they typed and when last active. `--branch none` lists those without one.
+- Only approved teachers ever show a branch. Revoking a teacher deletes their branch, and other features (`loadTeacherBranches`) never return a branch for an account that is no longer a teacher.
+- Little Star is official (Mikey 10-08). "Littlestar" and 리틀스타 resolve to it.
+- `teachers audit` shows each teacher's confirmed branch on its line. The branch is not part of the review fingerprint, so a branch change never marks a reviewed teacher changed.
+- Writes are audited server-side. The local receipts hold the network id, masked address and branches; an `apply` receipt keeps only the counts and the changes.
+- After it goes live: `suggest`, Mikey confirms the networks, then `apply`, then settle the ambiguous teachers with `set`.
+
 ### Build XP/Coin reward approvals (any time; also a full-daily-review duty)
 
 The creator's Lumine designs the rewards and writes them into the app. The
@@ -4886,3 +4927,14 @@ After the Study review migration is deployed, the full daily website run also re
 Study's registered `study-record-v1` checks use learner AI Energy for accepted, revise and uncertain results. Preview checks use real AI Energy but cannot award XP/Coins. The agreed proposal pays 2,000 XP + 500 Coins at most once per learner per UTC day. Breadface's `breadface-v1` uses deterministic server physics, not a model. Both creator proposals must be accepted to publish; inspect the canonical review state and acceptance/rejection events during follow-up.
 
 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)
+
+- `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.
+
+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.