@stage5/lumine 0.2.54 → 0.2.56

package/lib/admin.js

@@ -1,4 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
+import { once } from "node:events";
 import { readFileSync } from "node:fs";
 import { assertAuthScope, resolveAuth } from "./auth.js";
 import { requestJson } from "./http.js";
@@ -8,7 +9,13 @@ import {
   validateNewsEditorial,
   writeNewsClaimArtifacts,
 } from "./admin-news.js";
-import { runAutomaticPagination, runBatchSkips } from "./admin-workflows.js";
+import {
+  forEachPaginatedResultItem,
+  getPaginatedResultStorage,
+  runAutomaticPagination,
+  runBatchSkips,
+  writePaginatedResultJson,
+} from "./admin-workflows.js";
 import {
   parseBuildReviewReceipt,
   runManagedBuildReview,
@@ -380,9 +387,25 @@ export function assertRecommendationWindowResult({ operation, result }) {
   }
 }
 
-function finishAdminOutput({ options, operation, result }) {
+async function finishAdminOutput({ options, operation, result }) {
+  const paginationStorage = getPaginatedResultStorage(result);
   if (options.json) {
-    console.log(JSON.stringify(result));
+    if (paginationStorage) {
+      await writePaginatedResultJson({
+        result,
+        write: async (chunk) => {
+          if (!process.stdout.write(chunk)) {
+            await once(process.stdout, "drain");
+          }
+        },
+      });
+    } else {
+      console.log(JSON.stringify(result));
+    }
+    return result;
+  }
+  if (paginationStorage) {
+    await printSpooledAdminResult({ result, storage: paginationStorage });
     return result;
   }
   printAdminResult({ operation, result });
@@ -2375,6 +2398,57 @@ function printAdminMonthlyMediaCosts(monthlyMediaCosts) {
   );
 }
 
+async function printSpooledAdminResult({ result, storage }) {
+  const data = result?.data || {};
+  const count = Number(storage.candidateCount || 0);
+  if (storage.collectionKey === "subjects") {
+    console.log(`${count} subject(s):`);
+    await forEachPaginatedResultItem(result, async (subject) => {
+      console.log(
+        `#${subject.id} ${subject.title || "(untitled)"} — ${subject.author?.username || "unknown"} — effort ${subject.effortLevel ?? "unknown"}`,
+      );
+      console.log(`  ${subject.url}`);
+    });
+  } else if (storage.collectionKey === "events") {
+    console.log(`${count} audit event(s):`);
+    await forEachPaginatedResultItem(result, async (event) => {
+      const target =
+        event.targetType && event.targetId
+          ? ` ${event.targetType}:${event.targetId}`
+          : "";
+      console.log(
+        `#${event.id} run ${event.runId ?? "-"} ${event.action}${target} — ${event.result}${event.changed === true ? " (changed)" : event.changed === false ? " (no change)" : ""}`,
+      );
+    });
+  } else if (storage.collectionKey === "comments") {
+    console.log(`${count} comment(s) for ${data.subject?.url || "this target"}:`);
+    await forEachPaginatedResultItem(result, async (comment) => {
+      console.log(
+        `#${comment.id} ${comment.author?.username || "unknown"}: ${comment.content || "(empty)"}`,
+      );
+    });
+  } else if (storage.collectionKey === "items") {
+    console.log(`${count} recommendation candidate(s):`);
+    await forEachPaginatedResultItem(result, async (item) => {
+      console.log(`#${item.contentId} ${item.contentType}`);
+      if (item.url || item.subjectUrl) {
+        console.log(`  ${item.url || item.subjectUrl}`);
+      }
+    });
+  } else if (storage.collectionKey === "builds") {
+    console.log(`${count} Build candidate(s):`);
+    await forEachPaginatedResultItem(result, async (build) => {
+      console.log(`#${build.id} ${build.title || "(untitled)"}`);
+      if (build.url) console.log(`  ${build.url}`);
+    });
+  } else {
+    console.log(
+      `${count} ${storage.collectionKey} candidate(s) saved at ${storage.spoolPath}.`,
+    );
+  }
+  printPagination(data.pagination);
+}
+
 function printAdminResult({ operation, result }) {
   const data = result?.data || {};
   if (Array.isArray(data.applications)) {

package/lib/auth.js

@@ -6,6 +6,9 @@ import { requestJson } from "./http.js";
 import { sleep, trimTrailingSlash } from "./util.js";
 
 export async function login(options) {
+  const report = options.loginProgressToStderr
+    ? (...args) => console.error(...args)
+    : (...args) => console.log(...args);
   const start = await requestJson({
     method: "POST",
     url: `${options.apiUrl}/cli/device/start`,
@@ -23,15 +26,15 @@ export async function login(options) {
   });
 
   const approvalUrl = start.verificationUriComplete || start.verificationUri;
-  console.log("Connect Lumine CLI to Twinkle.");
+  report("Connect Lumine CLI to Twinkle.");
   if (options.openBrowser && approvalUrl) {
-    console.log("Opening Twinkle in your browser...");
+    report("Opening Twinkle in your browser...");
     const opened = await openBrowser(approvalUrl);
-    if (!opened) console.log("Could not open the browser automatically.");
+    if (!opened) report("Could not open the browser automatically.");
   }
-  console.log(`Approval link: ${approvalUrl}`);
-  console.log(`Code: ${start.userCode}`);
-  console.log("Leave this terminal open. Waiting for approval...");
+  report(`Approval link: ${approvalUrl}`);
+  report(`Code: ${start.userCode}`);
+  report("Leave this terminal open. Waiting for approval...");
 
   const intervalMs = Math.max(Number(start.interval || 3), 1) * 1000;
   const startedAt = Date.now();
@@ -52,10 +55,10 @@ export async function login(options) {
       userId: tokenResponse.user?.id || null,
       expiresAt: Date.now() + Number(tokenResponse.expiresIn || 0) * 1000,
     });
-    console.log(
+    report(
       `Logged in${tokenResponse.user?.username ? ` as ${tokenResponse.user.username}` : ""}.`,
     );
-    console.log("You can now run `lumine` to choose a project.");
+    report("You can now run `lumine` to choose a project.");
     return;
   }
 
@@ -112,7 +115,10 @@ export async function ensureAuth(options) {
   } catch (error) {
     if (options.authToken || !isMissingLoginError(error)) throw error;
   }
-  await login(options);
+  await login({
+    ...options,
+    loginProgressToStderr: Boolean(options.json),
+  });
   return await resolveAuth(options);
 }
 

package/lib/commands.js

@@ -2730,8 +2730,8 @@ export function printHelp() {
   lumine agent --provider <codex|claude-code> "<build request>"
   lumine sponsor agreement|apply|status|withdraw
   lumine sponsor capacity [--concurrency <n>] [--helpers <n>] [--daily-limit <n>] [--weekly-limit <n>]
-  lumine sponsor duty start <zero|ciel> --provider <codex|claude-code> [--model <name>] [--effort <level>] [--service-tier <tier>]
-  lumine sponsor duty pause|resume|stop <zero|ciel>
+  lumine sponsor duty start --provider <codex|claude-code> [--model <name>] [--effort <level>] [--service-tier <tier>]
+  lumine sponsor duty pause|resume|stop
   lumine sponsor jobs
   lumine app-mcp <published-app-url-or-id> [--no-open]
   lumine new [title]
@@ -2907,7 +2907,7 @@ Options:
   --since-run           Recommendations since the previous completed run (default)
   --include-legacy      Explicitly include the full historical recommendation queue
   --all                 Automatically read every page in the canonical snapshot
-  --checkpoint <file>   Persist automatic pagination or batch progress
+  --checkpoint <file>   Persist bounded pagination metadata or batch progress
   --resume              Resume the exact request recorded by --checkpoint
   --output <file>       Save an admin result or newspaper claim as JSON
   --output-dir <dir>    Directory for managed Build review evidence

package/lib/sponsor.js

@@ -6,7 +6,7 @@ import { stdin as input, stdout as output } from "node:process";
 
 import { agentCommand } from "./agent.js";
 import { notifyBuildOwnerOfContribution } from "./api.js";
-import { resolveAuth, writeAuthFile } from "./auth.js";
+import { ensureAuth, resolveAuth, writeAuthFile } from "./auth.js";
 import { readCompleteBuildForumSnapshot } from "./forum.js";
 import { requestJson } from "./http.js";
 import { sleep } from "./util.js";
@@ -24,7 +24,7 @@ export async function sponsorCommand(options, commandServices) {
     .trim()
     .toLowerCase();
   if (area === "agreement") {
-    const auth = await resolveAuth(options);
+    const auth = await ensureAuth(options);
     const agreement = await sponsorRequest({
       options,
       auth,
@@ -50,7 +50,7 @@ export async function sponsorCommand(options, commandServices) {
     return;
   }
   if (area === "jobs") {
-    const auth = await resolveAuth(options);
+    const auth = await ensureAuth(options);
     const result = await sponsorRequest({
       options,
       auth,
@@ -67,7 +67,7 @@ export async function sponsorCommand(options, commandServices) {
 }
 
 async function applyToSponsor(options) {
-  const auth = await resolveAuth(options);
+  const auth = await ensureAuth(options);
   const agreement = await sponsorRequest({ options, auth, path: "/agreement" });
   if (!options.json) {
     printSponsorAgreement(agreement, { ...options, json: false });
@@ -135,7 +135,7 @@ async function applyToSponsor(options) {
 }
 
 async function withdrawSponsorApplication(options) {
-  const auth = await resolveAuth(options);
+  const auth = await ensureAuth(options);
   if (!options.assumeYes && input.isTTY && output.isTTY) {
     const rl = readline.createInterface({ input, output });
     try {
@@ -162,7 +162,7 @@ async function withdrawSponsorApplication(options) {
 }
 
 async function updateSponsorCapacity(options) {
-  const auth = await resolveAuth(options);
+  const auth = await ensureAuth(options);
   const status = await sponsorRequest({ options, auth, path: "/status" });
   if (!status.sponsor) {
     throw new Error("An approved sponsor account is required first.");
@@ -212,24 +212,41 @@ async function sponsorDutyCommand(options, args, commandServices) {
     .trim()
     .toLowerCase();
   if (action === "status") {
+    if (args.length > 1) throw new Error(sponsorUsage());
     await printSponsorStatus(options);
     return;
   }
-  const persona = normalizePersona(args[1] || options.sponsorPersona);
-  const auth = await resolveAuth(options);
+  if (args.length > 1 || options.sponsorPersona) {
+    throw new Error(
+      "Sponsor duty is shared by Zero and Ciel. Remove the persona argument.",
+    );
+  }
   if (["pause", "resume", "stop"].includes(action)) {
+    const auth = await ensureAuth(options);
+    const status = await sponsorRequest({ options, auth, path: "/status" });
+    const currentDuties = (status.duties || []).filter((duty) =>
+      ["active", "paused"].includes(String(duty.state || "")),
+    );
+    if (currentDuties.length === 0) {
+      throw new Error("No active sponsor duty session was found.");
+    }
+    if (currentDuties.length > 1) {
+      throw new Error(
+        `Multiple legacy duty sessions are still open (${currentDuties.map((duty) => `#${duty.id}`).join(", ")}). Stop them with the CLI version that started them before using shared duty.`,
+      );
+    }
+    const dutyId = Number(currentDuties[0].id || 0);
+    if (!dutyId) throw new Error("Twinkle returned an invalid duty session.");
     const state =
       action === "resume" ? "active" : action === "stop" ? "stopped" : "paused";
     const result = await sponsorRequest({
       options,
       auth,
       method: "POST",
-      path: `/duty/${persona}/state`,
-      body: { state },
+      path: "/duty/state",
+      body: { dutySessionId: dutyId, state },
     });
-    printJsonOrLines(options, result, [
-      `${displayPersona(persona)} duty is now ${state}.`,
-    ]);
+    printJsonOrLines(options, result, [`Sponsor duty is now ${state}.`]);
     return;
   }
   if (action !== "start") throw new Error(sponsorUsage());
@@ -242,13 +259,14 @@ async function sponsorDutyCommand(options, args, commandServices) {
       "--service-tier is currently supported only by the Codex duty adapter.",
     );
   }
+  const auth = await ensureAuth(options);
   const started = await sponsorRequest({
     options,
     auth,
     method: "POST",
     path: "/duty/start",
     body: {
-      persona,
+      scope: "shared",
       provider,
       requestedModel: options.model || null,
       requestedEffort: options.sponsorEffort || null,
@@ -259,7 +277,6 @@ async function sponsorDutyCommand(options, args, commandServices) {
   await runSponsorDuty({
     options,
     auth,
-    persona,
     provider,
     started,
     commandServices,
@@ -269,7 +286,6 @@ async function sponsorDutyCommand(options, args, commandServices) {
 async function runSponsorDuty({
   options,
   auth,
-  persona,
   provider,
   started,
   commandServices,
@@ -279,6 +295,9 @@ async function runSponsorDuty({
   if (!dutyId || !leaseToken) {
     throw new Error("Twinkle did not return a valid sponsor duty lease.");
   }
+  if (started.duty?.scope !== "shared") {
+    throw new Error("Twinkle did not return a shared sponsor duty lease.");
+  }
   let canonicalDuty = started.duty;
   let stopRequested = false;
   let dutyLeaseError = null;
@@ -332,9 +351,7 @@ async function runSponsorDuty({
     Math.max(10, Number(started.heartbeatEverySeconds || 30)) * 1_000,
   );
 
-  console.log(
-    `${displayPersona(persona)} sponsor duty started with ${provider}.`,
-  );
+  console.log(`Shared Zero/Ciel sponsor duty started with ${provider}.`);
   printDutyRuntime(canonicalDuty);
   console.log(
     "The Workshop is now discoverable to users. Press Ctrl-C for a graceful stop.",
@@ -364,7 +381,6 @@ async function runSponsorDuty({
           sponsorAuth: auth,
           dutyId,
           dutyLeaseToken: leaseToken,
-          persona,
           provider,
           claim,
           commandServices,
@@ -384,8 +400,8 @@ async function runSponsorDuty({
         options,
         auth,
         method: "POST",
-        path: `/duty/${persona}/state`,
-        body: { state: "paused" },
+        path: "/duty/state",
+        body: { dutySessionId: dutyId, state: "paused" },
       });
       canonicalDuty = paused.duty || canonicalDuty;
     }
@@ -400,8 +416,8 @@ async function runSponsorDuty({
         options,
         auth,
         method: "POST",
-        path: `/duty/${persona}/state`,
-        body: { state: "stopped" },
+        path: "/duty/state",
+        body: { dutySessionId: dutyId, state: "stopped" },
       }).catch((error) => {
         if (!dutyLeaseError) {
           console.error(
@@ -411,7 +427,7 @@ async function runSponsorDuty({
       });
     }
   }
-  console.log(`${displayPersona(persona)} sponsor duty stopped.`);
+  console.log("Shared Zero/Ciel sponsor duty stopped.");
 }
 
 async function processSponsorJob({
@@ -419,12 +435,12 @@ async function processSponsorJob({
   sponsorAuth,
   dutyId,
   dutyLeaseToken,
-  persona,
   provider,
   claim,
   commandServices,
 }) {
   const job = claim.job;
+  const persona = normalizeJobPersona(job?.persona);
   const jobId = Number(job.id);
   const attemptToken = String(claim.attempt?.token || "");
   const workspaceToken = String(claim.workspaceToken?.accessToken || "");
@@ -1134,7 +1150,7 @@ async function sponsorRequest({
 }
 
 async function printSponsorStatus(options) {
-  const auth = await resolveAuth(options);
+  const auth = await ensureAuth(options);
   const status = await sponsorRequest({ options, auth, path: "/status" });
   if (options.json) {
     console.log(JSON.stringify(status, null, 2));
@@ -1152,8 +1168,12 @@ async function printSponsorStatus(options) {
     );
   }
   for (const duty of status.duties || []) {
+    const scope =
+      duty.scope === "shared"
+        ? "shared Zero/Ciel"
+        : `legacy assistant user ${duty.personaUserId}`;
     console.log(
-      `Duty #${duty.id}: user ${duty.personaUserId} ${duty.state} · ${duty.provider} · model=${duty.requestedModel || "provider default"} · effort=${duty.requestedEffort || "provider default"}`,
+      `Duty #${duty.id}: ${scope} · ${duty.state} · ${duty.provider} · model=${duty.requestedModel || "provider default"} · effort=${duty.requestedEffort || "provider default"}`,
     );
   }
 }
@@ -1252,12 +1272,12 @@ function normalizeProvider(value) {
   return provider;
 }
 
-function normalizePersona(value) {
+function normalizeJobPersona(value) {
   const persona = String(value || "")
     .trim()
     .toLowerCase();
   if (!PERSONAS.has(persona)) {
-    throw new Error("Choose a duty persona: zero or ciel.");
+    throw new Error("Twinkle returned an invalid Workshop job assistant.");
   }
   return persona;
 }
@@ -1284,8 +1304,8 @@ function sponsorUsage() {
     "  lumine sponsor status",
     "  lumine sponsor withdraw [--yes]",
     "  lumine sponsor capacity [--concurrency <n>] [--helpers <n>] [--daily-limit <n>] [--weekly-limit <n>]",
-    "  lumine sponsor duty start <zero|ciel> --provider <codex|claude-code> [--model <name>] [--effort <level>] [--service-tier <tier>]",
-    "  lumine sponsor duty pause|resume|stop <zero|ciel>",
+    "  lumine sponsor duty start --provider <codex|claude-code> [--model <name>] [--effort <level>] [--service-tier <tier>]",
+    "  lumine sponsor duty pause|resume|stop",
     "  lumine sponsor jobs [--limit <n>]",
   ].join("\n");
 }

package/package.json

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

package/sdk/LUMINE_ADMIN.md

@@ -663,7 +663,9 @@ artifact snapshot, branch-notice evidence, and requested/resolved provider,
 model, effort, service-tier, runtime, usage, and agent-tree records. It never
 includes raw Zero/Ciel chat.
 
-`clear` qualifies that unique handoff for its flat 50 KP award;
+`clear` qualifies a contribution to another user for its flat 50 KP award;
+self-sponsored testing remains ineligible even when its integrity evidence is
+cleared.
 `disqualify` makes it ineligible. `hold` and `flag` require an evidence note and
 remain open. The scan itself never changes sponsor status or applies a sanction.
 Use the separate, audited `sponsor status set` command for an explicit human
@@ -881,12 +883,15 @@ feed-ID high-water mark and the server timestamp, then traverse the indexed
 row moved forward when it was reshared. Explicit legacy scans retain the
 descending primary-key walk. A page
 can be empty while `hasMore` remains true; continue until `exhausted`. `--all`
-does that automatically and writes a private checkpoint after every
-server-confirmed page; `--resume` continues only when the checkpoint belongs to
-the same API, run, and exact request. The final result can be copied to
-`--output`, while `--checkpoint` is resumable operational state. Subject
-`--after` is inclusive, and every opaque cursor is bound to its original
-filters.
+does that automatically, fsyncs each confirmed page to a private NDJSON
+candidate spool, and writes only bounded cursor, boundary, count, byte-length,
+and digest metadata to the private checkpoint. `--resume` continues only when
+the checkpoint belongs to the same API, run, and exact request and its confirmed
+spool prefix still matches those metadata; an unconfirmed fsynced tail is
+discarded before the next request. The final JSON collection is streamed from
+the spool and can be copied to a separate `--output` file, while `--checkpoint`
+remains resumable operational state. Subject `--after` is inclusive, and every
+opaque cursor is bound to its original filters.
 
 For `--all --json`, stdout remains exactly one JSON value. Scan-start, first-
 page, every-tenth-page, and exhaustion progress is written to **stderr** with