@stage5/lumine 0.2.38 → 0.2.39

package/README.md

@@ -11,6 +11,7 @@ npx @stage5/lumine@latest rename "My New Build Title"
 npx @stage5/lumine@latest rename "New Title" --target 123
 npx @stage5/lumine@latest describe "A welcoming place to build together"
 npx @stage5/lumine@latest describe --no-description --target 123
+npx @stage5/lumine@latest upgrade https://www.twin-kle.com/app/123
 npx @stage5/lumine@latest projects
 npx @stage5/lumine@latest branches 884
 npx @stage5/lumine@latest suggestions 884
@@ -40,6 +41,14 @@ website. Both commands target the current workspace or selected Build; pass
 `--target <build-url-or-id>` to update another Build you own. Run
 `lumine describe --no-description` to clear a description explicitly.
 
+The configured project-limit reviewer can run
+`lumine upgrade <build-url-or-id>` to grant Main—and therefore every branch—the
+full approved project room of 500 files and 5 MB. The server verifies reviewer
+authority, resolves branch URLs back to their canonical Main project, and
+returns the confirmed canonical limits after commit. Running the command again
+is a safe no-op that reports the already-active canonical limits. Omit the
+target to use the current workspace or selected project.
+
 For team projects, Lumine mirrors the website workspace flow: choosing or
 pulling the owner's main project creates or reuses your contribution branch and
 checks out that branch locally. Saves go to your branch, so the project owner

package/lib/api.js

@@ -147,6 +147,16 @@ export async function createBuild({ options, auth, title, description }) {
   });
 }
 
+export async function upgradeBuildProjectLimits({ options, auth, buildId }) {
+  return await requestJson({
+    method: "PUT",
+    url: `${options.apiUrl}/build/${buildId}/project-limit-upgrade`,
+    authToken: auth.token,
+    body: {},
+    timeoutMs: options.timeoutMs,
+  });
+}
+
 export async function saveProjectFiles({
   options,
   auth,

package/lib/commands.js

@@ -46,6 +46,7 @@ import {
   saveProjectFiles,
   suggestBuildThumbnailToOwner,
   updateBuildMetadata,
+  upgradeBuildProjectLimits,
 } from "./api.js";
 import { assetsCommand, confirmPrompt, writeAssetsManifest } from "./assets.js";
 import { thumbnailCommand } from "./thumbnail.js";
@@ -67,6 +68,7 @@ import {
   defaultReferenceDir,
   defaultVersionCheckoutDir,
   defaultWorkspaceDir,
+  formatBytes,
   parseBoolean,
   resolveBuildId,
   resolveBuildReference,
@@ -142,6 +144,10 @@ export async function main() {
     await describeBuild(options);
     return;
   }
+  if (options.command === "upgrade") {
+    await upgradeProject(options);
+    return;
+  }
   if (options.command === "projects") {
     await projects(options);
     return;
@@ -285,6 +291,61 @@ export async function describeBuild(options) {
   );
 }
 
+export async function upgradeProject(options) {
+  if (options.positional?.length > 1) {
+    throw new Error("Usage: lumine upgrade [twinkle-build-url-or-id]");
+  }
+  const explicitTarget = String(options.target || "").trim();
+  const explicitBuildId = explicitTarget
+    ? resolveRequiredBuildId(explicitTarget)
+    : 0;
+  if (
+    explicitTarget &&
+    (!Number.isSafeInteger(explicitBuildId) || explicitBuildId <= 0)
+  ) {
+    throw new Error("Pass a Twinkle build URL or positive integer build id.");
+  }
+  const auth = await ensureAuth(options);
+  await assertAuthScope({ options, auth, scope: "build:write" });
+  // A branch URL already contains canonical Main's id. Let the server resolve
+  // numeric branch build ids, but do not require private-project read access
+  // merely to translate a reviewer-provided branch URL.
+  const buildId = explicitTarget
+    ? explicitBuildId
+    : await resolveRequiredBuildIdOrSelected(options, auth);
+  if (!Number.isSafeInteger(buildId) || buildId <= 0) {
+    throw new Error("Pass a Twinkle build URL or positive integer build id.");
+  }
+  const result = await upgradeBuildProjectLimits({
+    options,
+    auth,
+    buildId,
+  });
+  const upgradedBuild = result?.build;
+  const canonicalBuildId = Number(upgradedBuild?.id || 0);
+  const maxFilesPerProject = Number(
+    upgradedBuild?.projectLimits?.maxFilesPerProject || 0,
+  );
+  const maxProjectBytes = Number(
+    upgradedBuild?.projectLimits?.maxProjectBytes || 0,
+  );
+  if (
+    result?.success !== true ||
+    canonicalBuildId <= 0 ||
+    maxFilesPerProject <= 0 ||
+    maxProjectBytes <= 0
+  ) {
+    throw new Error("Twinkle did not return the upgraded project limits.");
+  }
+  const buildLabel = formatBuildTitle(upgradedBuild);
+  const limitsLabel = `${maxFilesPerProject} project files and ${formatBytes(maxProjectBytes)}`;
+  console.log(
+    result.changed
+      ? `Upgraded ${buildLabel} to ${limitsLabel}.`
+      : `${buildLabel} already has ${limitsLabel}.`,
+  );
+}
+
 async function updateOwnedBuildDetails({
   options,
   patch,
@@ -2504,6 +2565,7 @@ export function printHelp() {
   lumine new [title]
   lumine rename [title] [--target <twinkle-build-url-or-id>]
   lumine describe [description] [--target <twinkle-build-url-or-id>]
+  lumine upgrade [twinkle-build-url-or-id]
   lumine projects
   lumine branches [twinkle-build-url-or-id] [--limit <n>]
   lumine suggest branch [message] [--target <twinkle-branch-url>]
@@ -2580,6 +2642,7 @@ Examples:
   npx @stage5/lumine@latest rename "New Title" --target 123
   npx @stage5/lumine@latest describe "A welcoming place to build together"
   npx @stage5/lumine@latest describe --no-description --target 123
+  npx @stage5/lumine@latest upgrade https://www.twin-kle.com/app/123
   npx @stage5/lumine@latest new --title "Daily Reflection App" --description "Private journal with streaks"
   npx @stage5/lumine@latest branches 884
   npx @stage5/lumine@latest suggest branch "Ready for review"
@@ -2625,7 +2688,7 @@ Options:
   --auth-file <path>    Saved login path
   --auth-token <token>  Override saved login
   --dir <path>          Directory for pulled project files
-  --target <build>      Explicit Build URL or ID for rename/describe
+  --target <build>      Explicit Build URL or ID for rename/describe/upgrade
   --main                With pull/versions/restore: target the team project's main
   --version <n>         With pull: read-only checkout of previous save v<n>
   --title <text>        Build title for new/rename

package/lib/constants.js

@@ -338,6 +338,7 @@ export const COMMANDS = new Set([
   "new",
   "rename",
   "describe",
+  "upgrade",
   "projects",
   "branches",
   "suggest",

package/package.json

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