@stage5/lumine 0.2.61 → 0.2.63

package/README.md

@@ -284,7 +284,7 @@ starts unless they accept it there. This notice is invitation metadata only;
 it does not expose the unapproved Workshop plan or private chat.
 
 When a user approves a plan, `duty watch` returns the scoped assignment file and
-contribution workspace to that same session. It does not launch a fresh Codex
+exact approved Build workspace to that same session. It does not launch a fresh Codex
 or Claude process. The on-duty agent uses this explicit lifecycle while it
 works:
 
@@ -298,7 +298,7 @@ lumine sponsor job complete 42 --summary "Implemented and tested the approved ch
 
 `pulse` renews the duty/job leases and returns any newly approved follow-up.
 `update` sends the exact file text back to Zero or Ciel as a user-visible
-message from Lumine, their added brain. Use it for concise, deliberate
+message from Lumine, the on-duty project collaborator they talk with. Use it for concise, deliberate
 milestones only; never send hidden reasoning, raw terminal output, credentials,
 tokens, private paths, or unrelated data. Run `pulse` between substantial work
 steps. `relay-applied` is an explicit receipt;
@@ -318,11 +318,14 @@ shows none of the Workshop UI.
 
 Zero or Ciel remains the user-facing teammate. The on-duty agent session
 receives only the initial relay and active-job Build follow-ups covered by the
-user’s explicit Workshop consent, the assigned contribution branch, and its
-scoped Build Forum—not the raw assistant chat. It cannot merge into Main,
-publish, or use website-management APIs. Lumine records
+user’s explicit Workshop consent and the exact approved Main or requester-owned
+branch—not the raw assistant chat. Temporary job access never includes Forum
+comments. A Forum snapshot is available only when the sponsor's normal account
+already owns the project or is an accepted teammate. Editing jobs save directly
+to the approved workspace after Twinkle creates a restore point; they cannot
+publish or use website-management APIs. Lumine records
 the requested and provider-reported model, effort, service tier, runtime/usage
-evidence, coordinator/helper tree, saved artifact, and branch notice. Every
+evidence, coordinator/helper tree, restore point, and saved artifact. Every
 completed handoff enters the daily integrity flow; probationary, hard-flagged,
 and sampled work requires review. Each unique cleared contribution to another
 user earns a flat 50 Karma Points, while self-sponsored testing, retries, and

package/lib/admin-workflows.js

@@ -542,6 +542,12 @@ function aggregatePageResult({ operation, lastPage, checkpointPath, state }) {
   const last = lastPage || { ok: true, status: "success", data: {} };
   const lastData = { ...(last.data || {}) };
   delete lastData[operation.pagination.collectionKey];
+  const lastPagination = { ...(last.data?.pagination || {}) };
+  const pageScannedCount = normalizeScannedCount(
+    lastPagination.scannedCount,
+    0,
+  );
+  delete lastPagination.scannedCount;
   if (state.filterSummariesComplete) {
     if (state.clientFilter) lastData.clientFilter = state.clientFilter;
     else delete lastData.clientFilter;
@@ -568,7 +574,8 @@ function aggregatePageResult({ operation, lastPage, checkpointPath, state }) {
     data: {
       ...lastData,
       pagination: {
-        ...(last.data?.pagination || {}),
+        ...lastPagination,
+        pageScannedCount,
         nextCursor: state.nextCursor,
         hasMore: !state.exhausted,
         exhausted: state.exhausted,

package/lib/admin.js

@@ -171,12 +171,32 @@ export async function adminCommand(options) {
     scope: operation.mutates ? "build:write" : "build:read",
   });
   let runId = 0;
+  let correctionSessionId = 0;
+  let correctionSession = null;
   if (adminOperationRequiresRun(operation)) {
-    const runStatus = await requestJson({
-      url: `${options.apiUrl}/cli/admin/daily-runs/status`,
-      authToken: auth.token,
-      timeoutMs: options.timeoutMs,
-    });
+    if (operation.correctionEligible) {
+      const correctionStatus = await requestJson({
+        url: `${options.apiUrl}/cli/admin/corrections/status`,
+        authToken: auth.token,
+        timeoutMs: options.timeoutMs,
+      });
+      const correction = correctionStatus?.data?.correction || null;
+      if (
+        correction?.status === "active" &&
+        Number(correction.correctionCommentId || 0) ===
+          Number(operation.correctionCommentId || 0)
+      ) {
+        correctionSessionId = Number(correction.id || 0);
+        correctionSession = correction;
+      }
+    }
+    const runStatus = correctionSessionId
+      ? null
+      : await requestJson({
+          url: `${options.apiUrl}/cli/admin/daily-runs/status`,
+          authToken: auth.token,
+          timeoutMs: options.timeoutMs,
+        });
     const activeRun = runStatus?.data?.run || null;
     const retryableFinishedRun = [
       "daily-run.complete",
@@ -186,15 +206,29 @@ export async function adminCommand(options) {
       : null;
     const selectedRun = activeRun || retryableFinishedRun;
     runId = Number(selectedRun?.id || 0);
-    if (!runId) throw noActiveRunError();
-    if (options.adminIdentity) {
+    if (!runId && !correctionSessionId) {
+      if (operation.correctionEligible) {
+        const error = new Error(
+          `Start a correction session first: lumine admin correction start ${operation.correctionCommentId}.`,
+        );
+        error.code = "CLI_ADMIN_CORRECTION_NOT_ACTIVE";
+        throw error;
+      }
+      throw noActiveRunError();
+    }
+    if (options.adminIdentity && (selectedRun || correctionSession)) {
       const requestedIdentity = parseIdentity(options.adminIdentity);
+      const canonicalIdentity = correctionSession
+        ? correctionSession.identity?.key
+        : selectedRun?.identity?.key;
       if (
         requestedIdentity !== "auto" &&
-        requestedIdentity !== selectedRun?.identity?.key
+        requestedIdentity !== canonicalIdentity
       ) {
         throw cliValidationError(
-          `--identity ${requestedIdentity} does not match active run #${runId} (${selectedRun?.identity?.key || "unknown"}).`,
+          correctionSession
+            ? `--identity ${requestedIdentity} does not match correction session #${correctionSessionId} (${canonicalIdentity || "unknown"}).`
+            : `--identity ${requestedIdentity} does not match active run #${runId} (${canonicalIdentity || "unknown"}).`,
         );
       }
     }
@@ -211,6 +245,13 @@ export async function adminCommand(options) {
         body: operation.body,
         headers: {
           ...(runId ? { "x-lumine-admin-run-id": String(runId) } : {}),
+          ...(correctionSessionId
+            ? {
+                "x-lumine-admin-correction-session-id": String(
+                  correctionSessionId,
+                ),
+              }
+            : {}),
           ...(requestId ? { "x-lumine-idempotency-key": requestId } : {}),
         },
         timeoutMs: options.timeoutMs,
@@ -663,6 +704,9 @@ function adminOperationRequiresRun(operation) {
       "rescue.wordle.audit",
       "daily-run.start",
       "daily-run.status",
+      "correction.start",
+      "correction.status",
+      "correction.complete",
       "escalation.list",
       "escalation.set",
       "notable.add",
@@ -694,6 +738,39 @@ export function parseAdminOperation(options) {
   const [namespace = "", action = "", target = "", extra = ""] =
     options.positional;
 
+  if (namespace === "correction" || namespace === "corrections") {
+    if (!action || action === "status") {
+      return readOperation("correction.status", "/cli/admin/corrections/status");
+    }
+    if (action === "start") {
+      const commentId = parseRequiredInteger(target, "comment ID", 1);
+      return writeOperation(
+        "correction.start",
+        "POST",
+        "/cli/admin/corrections",
+        {
+          commentId,
+        },
+      );
+    }
+    if (action === "complete" || action === "stop") {
+      const correctionId = parseRequiredInteger(
+        target,
+        "correction session ID",
+        1,
+      );
+      return writeOperation(
+        "correction.complete",
+        "POST",
+        `/cli/admin/corrections/${correctionId}/complete`,
+        {},
+      );
+    }
+    throw cliValidationError(
+      "Usage: lumine admin correction start <commentId> | correction status | correction complete <sessionId>.",
+    );
+  }
+
   if (namespace === "identity") {
     if (action === "list") {
       return readOperation("identity.list", "/cli/admin/identities");
@@ -1260,7 +1337,10 @@ export function parseAdminOperation(options) {
 
   if (namespace === "comments" && action === "get") {
     const commentId = parseRequiredInteger(target, "comment ID", 1);
-    return readOperation("comments.get", `/cli/admin/comments/${commentId}`);
+    return readOperation("comments.get", `/cli/admin/comments/${commentId}`, {
+      correctionEligible: true,
+      correctionCommentId: commentId,
+    });
   }
 
   if (namespace === "post") {
@@ -1674,6 +1754,10 @@ export function parseAdminOperation(options) {
         "PUT",
         `/cli/admin/comments/${commentId}`,
         { content: readComposedTextFile(options.adminFile) },
+        {
+          correctionEligible: true,
+          correctionCommentId: commentId,
+        },
       );
     }
     if (action === "post") {
@@ -1738,7 +1822,10 @@ function postGetOperation(target, options) {
     return subjectGetOperation(parsedTarget.id, options);
   }
   if (parsedTarget.type === "comment") {
-    return readOperation("post.get", `/cli/admin/comments/${parsedTarget.id}`);
+    return readOperation("post.get", `/cli/admin/comments/${parsedTarget.id}`, {
+      correctionEligible: true,
+      correctionCommentId: parsedTarget.id,
+    });
   }
   return readOperation(
     "post.get",
@@ -2066,8 +2153,8 @@ function bodyReadOperation(name, method, path, body) {
   return { name, method, path, body, mutates: false };
 }
 
-function writeOperation(name, method, path, body) {
-  return { name, method, path, body, mutates: true };
+function writeOperation(name, method, path, body, extra = {}) {
+  return { name, method, path, body, mutates: true, ...extra };
 }
 
 function withQuery(path, values) {
@@ -2810,6 +2897,11 @@ function printAdminResult({ operation, result }) {
     console.log(
       `Run #${data.run.id}: ${data.run.status}; identity ${data.run.identity.key}; comments ${data.run.commentMode}.`,
     );
+    if (data.scheduledDay && data.scheduledIdentity) {
+      console.log(
+        `Bangkok schedule for ${data.scheduledDay}: ${data.scheduledIdentity.key}.`,
+      );
+    }
     if (data.carryoverTodos) {
       printTodoItems(data.carryoverTodos.items || [], "Carry-over work");
     }
@@ -2824,6 +2916,11 @@ function printAdminResult({ operation, result }) {
   }
   if (Object.hasOwn(data, "activeRun")) {
     console.log(`Preferred identity: ${data.preferredIdentity}.`);
+    if (data.scheduledDay && data.scheduledIdentity) {
+      console.log(
+        `Bangkok schedule for ${data.scheduledDay}: ${data.scheduledIdentity.key}.`,
+      );
+    }
     console.log(
       `Last completed identity: ${data.lastCompletedIdentity || "none"}.`,
     );

package/lib/api.js

@@ -80,6 +80,7 @@ export async function loadBuildFiles({ options, auth, buildId, includeContent })
     url: url.toString(),
     authToken: auth.token,
     timeoutMs: options.timeoutMs,
+    signal: options.signal,
   });
 }
 

package/lib/auth.js

@@ -23,6 +23,7 @@ export async function login(options) {
       ],
     },
     timeoutMs: options.timeoutMs,
+    signal: options.signal,
   });
 
   const approvalUrl = start.verificationUriComplete || start.verificationUri;
@@ -41,7 +42,7 @@ export async function login(options) {
   const expiresInMs = Math.max(Number(start.expiresIn || 600), 1) * 1000;
 
   while (Date.now() - startedAt < expiresInMs) {
-    await sleep(intervalMs);
+    await sleep(intervalMs, options.signal);
     const tokenResponse = await pollToken({
       options,
       deviceCode: start.deviceCode,
@@ -72,6 +73,7 @@ export async function pollToken({ options, deviceCode }) {
       url: `${options.apiUrl}/cli/device/token`,
       body: { deviceCode },
       timeoutMs: options.timeoutMs,
+      signal: options.signal,
     });
   } catch (error) {
     if (error.status === 428 || error.data?.error === "authorization_pending") {
@@ -102,6 +104,7 @@ export async function whoami(options) {
     url: `${options.apiUrl}/cli/session`,
     authToken: auth.token,
     timeoutMs: options.timeoutMs,
+    signal: options.signal,
   });
   console.log(
     `Logged in as ${session.username || auth.username || "unknown"} ` +
@@ -187,6 +190,7 @@ export async function assertAuthScope({ options, auth, scope }) {
     url: `${options.apiUrl}/cli/session`,
     authToken: auth.token,
     timeoutMs: options.timeoutMs,
+    signal: options.signal,
   });
   const scopes = Array.isArray(session.scopes) ? session.scopes : [];
   if (!scopes.includes(scope)) {

package/lib/commands.js

@@ -1547,6 +1547,7 @@ export async function pullBuildFiles({ options, auth, buildId }) {
     build,
     dir,
     fileCount: files.length,
+    filesHash: typeof result.filesHash === "string" ? result.filesHash : null,
     manifest: result.projectManifest || null,
     assetCount,
   };

package/lib/forum.js

@@ -76,6 +76,7 @@ export async function loadBuildForumPage({
     url: url.toString(),
     authToken: auth.token,
     timeoutMs: options.timeoutMs,
+    signal: options.signal,
   });
 }
 

package/lib/http.js

@@ -7,16 +7,17 @@ export async function requestJson({
   body,
   timeoutMs,
   headers = {},
+  signal,
 }) {
-  const response = await request({
+  const { response, text } = await requestText({
     method,
     url,
     authToken,
     body,
     timeoutMs,
     headers,
+    signal,
   });
-  const text = await response.text();
   const data = parseJson(text);
   if (!response.ok) {
     const error = new Error(
@@ -32,9 +33,13 @@ export async function requestJson({
   return data || {};
 }
 
-export async function probeUrl({ url, authToken, timeoutMs }) {
-  const response = await request({ url, authToken, timeoutMs });
-  const text = await response.text();
+export async function probeUrl({ url, authToken, timeoutMs, signal }) {
+  const { response, text } = await requestText({
+    url,
+    authToken,
+    timeoutMs,
+    signal,
+  });
   return {
     ok: response.ok && text.trim().length > 0,
     status: response.status,
@@ -42,18 +47,30 @@ export async function probeUrl({ url, authToken, timeoutMs }) {
   };
 }
 
-export async function request({
+export async function requestText({
   method = "GET",
   url,
   authToken,
   body,
   timeoutMs,
   headers = {},
+  signal,
 }) {
   const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  const parentAbort = () => controller.abort(signal?.reason);
+  if (signal?.aborted) parentAbort();
+  else signal?.addEventListener("abort", parentAbort, { once: true });
+  const effectiveTimeoutMs = Math.max(Number(timeoutMs) || 0, 1);
+  const timeoutError = new Error(
+    `HTTP request timed out after ${effectiveTimeoutMs}ms.`,
+  );
+  timeoutError.code = "lumine_http_timeout";
+  const timeout = setTimeout(
+    () => controller.abort(timeoutError),
+    effectiveTimeoutMs,
+  );
   try {
-    return await fetch(url, {
+    const response = await fetch(url, {
       method,
       headers: {
         ...(authToken ? { authorization: authorizationHeader(authToken) } : {}),
@@ -63,8 +80,11 @@ export async function request({
       body: body ? JSON.stringify(body) : undefined,
       signal: controller.signal,
     });
+    const text = await response.text();
+    return { response, text };
   } finally {
     clearTimeout(timeout);
+    signal?.removeEventListener("abort", parentAbort);
   }
 }
 

package/lib/sdk.js

@@ -2,7 +2,7 @@ import path from "path";
 
 import { ensureAuth, assertAuthScope } from "./auth.js";
 import { mintBuildApiToken } from "./api.js";
-import { request } from "./http.js";
+import { requestText } from "./http.js";
 import { parseJson, resolveBuildId } from "./util.js";
 import { findLocalProjectMetadata } from "./workspace.js";
 
@@ -495,7 +495,7 @@ export async function executeSdkHttpCall({
   buildApiToken,
 }) {
   const startedAt = Date.now();
-  const response = await request({
+  const { response, text } = await requestText({
     method,
     url,
     authToken,
@@ -503,7 +503,6 @@ export async function executeSdkHttpCall({
     timeoutMs: options.timeoutMs,
     headers: buildApiToken ? { "x-build-api-token": buildApiToken } : {},
   });
-  const text = await response.text();
   return {
     ok: response.ok,
     status: response.status,