@stage5/lumine 0.2.18 → 0.2.19

package/lib/commands.js

@@ -65,6 +65,7 @@ import {
 import { probeUrl, requestJson } from "./http.js";
 import { sdkCommand } from "./sdk.js";
 import { doctorCommand, normalizePreviewUrl } from "./doctor.js";
+import { adminCommand } from "./admin.js";
 import {
   defaultMainCheckoutDir,
   defaultReferenceDir,
@@ -108,10 +109,15 @@ export async function main() {
     printHelp();
     return;
   }
-  if (options.updateCheck) {
+  if (options.updateCheck && !(options.command === "admin" && options.json)) {
     await maybeCheckForLumineCliUpdate({ options });
   }
 
+  if (options.command === "admin") {
+    await adminCommand(options);
+    return;
+  }
+
   if (options.command === "workspace") {
     await workspace(options);
     return;
@@ -2088,6 +2094,8 @@ export function parseArgs(args) {
     "json",
     "keepAssets",
     "noBrowser",
+    "includeComments",
+    "anyoneCanReward",
   ]);
 
   for (let i = 0; i < rest.length; i += 1) {
@@ -2156,6 +2164,27 @@ export function parseArgs(args) {
             : ""),
       ).trim() || "",
     cursor: Math.max(0, Math.floor(Number(raw.cursor) || 0)),
+    adminCursor: raw.cursor ? String(raw.cursor) : "",
+    adminAfter: raw.after ? String(raw.after) : "",
+    adminEffort: raw.effort ? String(raw.effort) : "",
+    adminLevel: raw.level ? String(raw.level) : "",
+    adminIds: raw.subjectIds
+      ? String(raw.subjectIds)
+      : raw.ids
+        ? String(raw.ids)
+        : "",
+    adminType: raw.type ? String(raw.type) : "",
+    adminKind: raw.kind ? String(raw.kind) : "",
+    adminIdentity: raw.identity ? String(raw.identity) : "",
+    commentMode: raw.commentMode ? String(raw.commentMode) : "",
+    runKey: raw.runKey ? String(raw.runKey) : "",
+    idempotencyKey: raw.idempotencyKey ? String(raw.idempotencyKey) : "",
+    draftId: raw.draftId ? String(raw.draftId) : "",
+    twinkles: raw.twinkles ? String(raw.twinkles) : "",
+    adminReason: raw.reason ? String(raw.reason) : "",
+    rewardTwinkles: raw.rewardTwinkles ? String(raw.rewardTwinkles) : "",
+    includeComments: parseBoolean(raw.includeComments, false),
+    anyoneCanReward: parseBoolean(raw.anyoneCanReward, false),
     repeat: Math.min(Math.max(Math.floor(Number(raw.repeat) || 1), 1), 20),
     allowWrite: parseBoolean(raw.allowWrite, false),
     assumeYes: parseBoolean(raw.yes, false),
@@ -2468,6 +2497,21 @@ export function printHelp() {
   lumine thumbnail capture [--out <file>]
   lumine thumbnail generate ["<prompt>"] --model <gpt-image-2|nano-banana>
   lumine doctor runtime-assets
+  lumine admin identity list|status|use <zero|ciel|auto> [--json]
+  lumine admin daily-run start [--identity zero|ciel|auto] [--comment-mode off|draft|post] [--run-key <key>] [--json]
+  lumine admin daily-run status|complete|fail [--reason <text>] [--json]
+  lumine admin recommendations list [--cursor <cursor>] [--json]
+  lumine admin subjects candidates [--after <date>] [--effort unassigned] [--cursor <cursor>] [--json]
+  lumine admin subject get|comments|reveal <subject-url-or-id> [--cursor <cursor>] [--json]
+  lumine admin subject effort set <subject-id> --level <1|2|3> [--json]
+  lumine admin subject creator set-made-by-poster <subject-id> [--json]
+  lumine admin subject feature|unfeature <subject-id> [--json]
+  lumine admin featured list|reorder --subject-ids <id,id,...> [--json]
+  lumine admin post get|comments <target> [--type subject|comment|aiStory|dailyReflection] [--cursor <cursor>] [--json]
+  lumine admin post recommend <target> [--type subject|comment|aiStory|dailyReflection] [--anyone-can-reward] [--reward-twinkles 3] [--json]
+  lumine admin post reward <target> [--type subject|comment|aiStory|dailyReflection] --twinkles 3 [--json]
+  lumine admin comment draft <subject-id> [--identity zero|ciel|auto] [--json]
+  lumine admin comment post --draft-id <id> [--json]
 
 Examples:
   npx @stage5/lumine@latest
@@ -2509,6 +2553,11 @@ Examples:
   npx @stage5/lumine@latest thumbnail capture --out capture.png
   npx @stage5/lumine@latest thumbnail generate --model gpt-image-2 --yes
   npx @stage5/lumine@latest doctor runtime-assets --build 917 --json
+  npx @stage5/lumine@latest admin daily-run start --identity auto --comment-mode off --json
+  npx @stage5/lumine@latest admin recommendations list --json
+  npx @stage5/lumine@latest admin subjects candidates --effort unassigned --json
+  npx @stage5/lumine@latest admin subject get 123 --include-comments --json
+  npx @stage5/lumine@latest admin post recommend comment:456 --anyone-can-reward --reward-twinkles 3 --json
 
 Options:
   --api-url <url>       Twinkle API origin
@@ -2526,6 +2575,21 @@ Options:
   --summary <text>      Save summary
   --note <text>         Message attached to a branch suggestion
   --cursor <id>         Continue an owner suggestion inbox listing
+  --after <date>        Admin subjects: inclusive Unix/ISO creation boundary
+  --effort unassigned  Admin subjects: show only unassigned effort
+  --identity <mode>     Admin identity: zero, ciel, or auto
+  --comment-mode <mode> Admin run comments: off, draft, or post
+  --run-key <key>       Idempotency key for an admin daily run
+  --idempotency-key <k> Stable retry key for one admin mutation
+  --level <1|2|3>       Admin subject effort level
+  --subject-ids <ids>   Complete ordered Featured subject IDs
+  --type <type>         Admin target: subject, comment, aiStory, or dailyReflection
+  --kind recommend      Admin recommendation queue kind
+  --anyone-can-reward   Enable canonical reward eligibility
+  --reward-twinkles 3   Pair a recommendation with exactly 3 Twinkles
+  --twinkles 3          Give exactly 3 Twinkles through the normal economy
+  --draft-id <id>       Canonical delegated comment draft ID
+  --reason <text>       Reason when marking an admin run failed
   --force               Overwrite server files even if this workspace is stale or missing filesHash
   --search <text>       Search public open-source Builds
   --sort <sort>         Sort open-source Builds: forks, popular, recent
@@ -2539,7 +2603,7 @@ Options:
   --allow-write         Permit sdk methods that mutate app data
   --path <api/...>      Call an sdk endpoint not in the curated list
   --scopes <a,b>        Override requested build API token scopes
-  --json                Print machine-readable output for doctor commands
+  --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 or nano-banana (required, no default)

package/lib/constants.js

@@ -330,6 +330,7 @@ export const MAIN_CHECKOUT_READONLY_COMMANDS = new Set([
   "versions",
 ]);
 export const COMMANDS = new Set([
+  "admin",
   "workspace",
   "login",
   "logout",

package/lib/http.js

@@ -20,7 +20,10 @@ export async function requestJson({
   const data = parseJson(text);
   if (!response.ok) {
     const error = new Error(
-      data?.error || data?.message || `${method} ${url} failed`,
+      data?.error?.message ||
+        (typeof data?.error === "string" ? data.error : "") ||
+        data?.message ||
+        `${method} ${url} failed`,
     );
     error.status = response.status;
     error.data = data;

package/package.json

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