@stage5/lumine 0.3.18 → 0.3.19

package/README.md

@@ -96,8 +96,11 @@ run `lumine suggestions <build-url-or-id>` to see their open suggestion inbox.
 The inbox prints canonical follow-up commands for merging or replacing Main and
 for applying the exact frozen thumbnail shown in a suggestion. The same actions
 are also available directly as `lumine suggestions merge <id>`,
-`lumine suggestions replace-main <id>`, and
-`lumine suggestions adopt-thumbnail <id>`. Large inboxes are cursor-paginated;
+`lumine suggestions replace-main <id>`,
+`lumine suggestions adopt-thumbnail <id>`, and
+`lumine suggestions adopt-title <id>`. To pass on a branch, thumbnail or name
+suggestion, run `lumine suggestions decline <id>`; the chat card shows it was
+declined for both sides and it leaves the inbox. Large inboxes are cursor-paginated;
 the CLI prints the exact `--cursor` command for the next page.
 
 Use `lumine explore` to list public open-source Build apps that can be used as

package/lib/admin-receipts.js

@@ -40,6 +40,33 @@ export function receiptToKeep(operation, result) {
       });
     }
     default:
+      // Bridge Builder writes answer with the whole crew view: members' who-
+      // are-you answers, parents' addresses and questions, held parent emails.
+      // Keep the decision only (ids, statuses, counts), never the crew.
+      if (String(operation?.name || "").startsWith("meetup.")) {
+        const crew = data.crew || {};
+        return keep({
+          crewId: crew.crewId ?? data.result?.crewId ?? null,
+          crewStatus: crew.status ?? null,
+          currentStep: crew.progress?.currentStep ?? null,
+          result: scalarsOf(data.result),
+          ...(data.slot ? { slot: scalarsOf(data.slot) } : {}),
+          ...(data.unlocks ? { unlocks: scalarsOf(data.unlocks) } : {}),
+        });
+      }
       return result;
   }
 }
+
+// Numbers, booleans, short status words and arrays of ids: what proves a
+// decision without copying anyone's text.
+function scalarsOf(value) {
+  if (!value || typeof value !== "object") return null;
+  const out = {};
+  for (const [key, item] of Object.entries(value)) {
+    if (typeof item === "number" || typeof item === "boolean" || item === null) out[key] = item;
+    else if (typeof item === "string" && /^[\w:.-]{0,40}$/.test(item)) out[key] = item;
+    else if (Array.isArray(item) && item.every((x) => typeof x === "number")) out[key] = item;
+  }
+  return out;
+}

package/lib/admin.js

@@ -2583,7 +2583,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>] | slot <crewId> --confirm <slotIndex> | resend-email <crewId>.";
+      "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>.";
     const note = String(options.note || "").trim();
     if (note.length > 1000) {
       throw cliValidationError("--note must be at most 1000 characters.");
@@ -2748,6 +2748,29 @@ export function parseAdminOperation(options) {
         { requiresRun: false },
       );
     }
+    if (action === "info") {
+      // Staff's "who are you" check on a member (ruled 2026-10-07): the member
+      // gives their teacher's name and class name (or how they know the crew)
+      // on the crew page; the crew waits until you accept. Nobody is contacted.
+      const crewId = parseRequiredInteger(target, "Crew ID", 1);
+      const memberId = parseRequiredInteger(extra, "Member user ID", 1);
+      const decision = parseChoice(options.adminDecision || "", "--decision", [
+        "ask",
+        "accept",
+        "ask-again",
+        "withdraw",
+      ]);
+      if (decision === "ask-again" && !note) {
+        throw cliValidationError("--decision ask-again needs --note <what to tell the member>.");
+      }
+      return writeOperation(
+        "meetup.info",
+        "POST",
+        `/cli/admin/meetup-quest/crews/${crewId}/members/${memberId}/info-check`,
+        { action: decision === "ask" ? "request" : decision, 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).
@@ -5716,7 +5739,7 @@ function formatMeetupMembers(members) {
   return (members || [])
     .map(
       (member) =>
-        `${member.username || `user ${member.userId}`} (${member.userId}, ${member.branch || "no branch"}${member.parentOk === undefined ? "" : member.parentOk ? ", parent OK" : ", parent not yet"}${member.attended ? ", attended" : ""})`,
+        `${member.username || `user ${member.userId}`} (${member.userId}, ${member.branch || "no branch"}${member.parentOk === undefined ? "" : member.parentOk ? ", parent OK" : ", parent not yet"}${member.attended ? ", attended" : ""}${member.infoCheck === "requested" ? ", details asked" : member.infoCheck === "answered" ? ", ANSWERED: review" : ""})`,
     )
     .join("; ");
 }
@@ -5731,6 +5754,17 @@ function printMeetupCrew(crew) {
     console.log(`  ${step.number}. ${step.label} [${step.state}] ${step.detail}`);
   }
   console.log(`  Members: ${formatMeetupMembers(crew.members)}`);
+  // staff's "who are you" checks on these members (any crew), newest first
+  for (const check of crew.memberChecks || []) {
+    const answer = check.teacherName
+      ? `teacher "${check.teacherName}", class "${check.className}"`
+      : check.relationship
+        ? `how they know the crew: "${check.relationship}"`
+        : "no answer yet";
+    console.log(
+      `  Who-are-you check #${check.checkId} · ${check.username} (${check.userId}) · crew #${check.crewId} · ${check.status}${check.askNote ? ` · asked: "${check.askNote}"` : ""} · ${answer}${check.reviewedBy ? ` · ${check.status} by ${check.reviewedBy}` : ""}${check.staffNote ? ` · note: ${check.staffNote}` : ""}`,
+    );
+  }
   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}"` : ""}`,
@@ -5875,11 +5909,21 @@ 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> (classroom plans: approve at the headmaster desk with a room and times).",
+        "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).",
       );
     }
     return;
   }
+  if (operation.name === "meetup.info") {
+    const status = data.result?.status;
+    console.log(
+      result?.changed === false
+        ? `Member ${data.result?.userId} already has an open question (${status}).`
+        : `Member ${data.result?.userId} on crew #${data.result?.crewId}: ${status === "requested" ? "asked (their crew page now asks for their teacher and class, or how they know the crew)" : status}.`,
+    );
+    if (data.crew) printMeetupCrew(data.crew);
+    return;
+  }
   if (operation.name === "meetup.show" || operation.name === "meetup.parent-reply") {
     printMeetupCrew(data.crew || {});
     return;

package/lib/api.js

@@ -530,6 +530,24 @@ export async function adoptBuildTitleSuggestion({
   });
 }
 
+// The owner passing on one teammate suggestion (branch updates, thumbnail or
+// name): the card settles as declined for both sides and leaves the inbox.
+export async function declineBuildOwnerSuggestion({
+  options,
+  auth,
+  rootBuildId,
+  contributionBuildId,
+  suggestionMessageId,
+}) {
+  return await requestJson({
+    method: "POST",
+    url: `${options.apiUrl}/build/${rootBuildId}/contributions/${contributionBuildId}/decline-suggestion`,
+    authToken: auth.token,
+    body: { suggestionMessageId },
+    timeoutMs: options.timeoutMs,
+  });
+}
+
 export async function mergeContributionIntoMain({
   options,
   auth,

package/lib/commands.js

@@ -23,6 +23,7 @@ import {
 import {
   adoptBuildThumbnailSuggestion,
   adoptBuildTitleSuggestion,
+  declineBuildOwnerSuggestion,
   createBuild,
   fetchAllRuntimeAssets,
   forkBuild,
@@ -764,11 +765,50 @@ export async function suggestions(options) {
     return;
   }
 
+  if (action === "decline") {
+    const description = describeSuggestionForDecline(suggestion);
+    if (!options.assumeYes) {
+      const confirmed = await confirmPrompt(
+        `Decline suggestion #${suggestionId} (${description}) on Build #${rootBuildId}? [y/N] `,
+      );
+      if (confirmed === null) {
+        console.log("Not a TTY — re-run with --yes to decline the suggestion.");
+        return;
+      }
+      if (!confirmed) {
+        console.log("Aborted. Suggestion left open.");
+        return;
+      }
+    }
+    await declineBuildOwnerSuggestion({
+      options,
+      auth,
+      rootBuildId,
+      contributionBuildId,
+      suggestionMessageId: suggestionId,
+    });
+    console.log(
+      `Declined suggestion #${suggestionId} (${description}) on Build #${rootBuildId}.`,
+    );
+    return;
+  }
+
   throw new Error(
-    "Usage: lumine suggestions [build] | lumine suggestions merge|replace-main|adopt-thumbnail|adopt-title <suggestion-id> [--build <id>]",
+    "Usage: lumine suggestions [build] | lumine suggestions merge|replace-main|adopt-thumbnail|adopt-title|decline <suggestion-id> [--build <id>]",
   );
 }
 
+function describeSuggestionForDecline(suggestion) {
+  if (suggestion.type === "title") {
+    return `name "${suggestion.suggestedTitle}"`;
+  }
+  if (suggestion.type === "thumbnail") return "thumbnail";
+  const branchNumber = Number(suggestion.branchNumber || 0);
+  return branchNumber
+    ? `updates from branch ${branchNumber}`
+    : `updates from branch #${suggestion.branchBuildId}`;
+}
+
 async function resolveSuggestionRootBuildId(options, auth) {
   const requestedBuildId = options.buildIdFlag
     ? resolveRequiredBuildId(options.buildIdFlag)
@@ -827,6 +867,9 @@ export function printBuildSuggestions({
       console.log(
         `  replace: lumine suggestions replace-main ${suggestionId} --build ${rootBuildId}`,
       );
+      console.log(
+        `  decline: lumine suggestions decline ${suggestionId} --build ${rootBuildId}`,
+      );
       continue;
     }
     if (suggestion.type === "title") {
@@ -838,6 +881,9 @@ export function printBuildSuggestions({
       console.log(
         `  apply: lumine suggestions adopt-title ${suggestionId} --build ${rootBuildId}`,
       );
+      console.log(
+        `  decline: lumine suggestions decline ${suggestionId} --build ${rootBuildId}`,
+      );
       continue;
     }
     console.log(
@@ -850,6 +896,9 @@ export function printBuildSuggestions({
     console.log(
       `  apply: lumine suggestions adopt-thumbnail ${suggestionId} --build ${rootBuildId}`,
     );
+    console.log(
+      `  decline: lumine suggestions decline ${suggestionId} --build ${rootBuildId}`,
+    );
   }
   if (hasMore && nextCursor > 0) {
     console.log(
@@ -2429,6 +2478,7 @@ export function parseArgs(args) {
     "replace-main",
     "adopt-thumbnail",
     "adopt-title",
+    "decline",
   ]);
   const suggestionAction =
     command === "suggest"
@@ -2970,6 +3020,7 @@ export function printHelp() {
   lumine suggestions replace-main <suggestion-id> [--build <id>]
   lumine suggestions adopt-thumbnail <suggestion-id> [--build <id>] [--yes]
   lumine suggestions adopt-title <suggestion-id> [--build <id>] [--yes]
+  lumine suggestions decline <suggestion-id> [--build <id>] [--yes]
   lumine explore [search terms]
   lumine select [twinkle-build-url]
   lumine pull [twinkle-build-url]
@@ -3040,7 +3091,7 @@ export function printHelp() {
   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>] | 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> | 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]

package/lib/constants.js

@@ -238,8 +238,9 @@ lumine save --summary "Describe the change"
 - On an owned canonical team project, \`lumine suggestions\` lists the owner's
   currently open branch, thumbnail and name suggestions. Act on the exact
   suggestion id it prints with \`lumine suggestions merge\`, \`replace-main\`,
-  \`adopt-thumbnail\` or \`adopt-title\`; do not infer an action from stale
-  local branch state.
+  \`adopt-thumbnail\`, \`adopt-title\` or \`decline\`; do not infer an action
+  from stale local branch state. Decline only when the user asks to pass on
+  that suggestion.
 
 ## Assets (Runtime Media)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage5/lumine",
-  "version": "0.3.18",
+  "version": "0.3.19",
   "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-06T10:12:09.371Z
+Generated: 2026-10-07T07:52:06.040Z
 
 ## Notes
 - This SDK is injected into Build iframes via the Build preview/runtime.
@@ -257,6 +257,7 @@ files:read, media:read, media:write, live:read, live:write, user:read, users:rea
   - title/body are accepted as aliases for label/summary.
   - target is accepted as a backwards-compatible alias for launchTarget.
   - Twinkle applies app API rate limits, a stricter notification emit rate limit, and existing notification mutes.
+  - Twinkle shows the acting member's username right before `summary` in the notification row, so write `summary` as a predicate ('posted in Lobby', 'responded to the Twinkle Newspaper'), never starting with the member's name (otherwise it reads 'Liki Liki responded…').
   - Example: await Twinkle.notifications.notifySubscribers('room.message', { targetKey: 'room:lobby', eventKey: 'room.message.created', label: 'Room messages', summary: 'posted in Lobby', launchTarget: { view: 'room', roomId: 'lobby', messageId } });
 - async getSubjectUpdateSubscription(subjectId) | scopes: notifications:read
   - Returns: { subscription }