@melius-ai/cli 0.3.0 → 0.4.0

package/README.md

@@ -25,6 +25,20 @@ mel run wait <runId>
 2. In the Melius app, go to **Team settings → Integrations** and create an API key (it starts with `mel_` and is shown once — copy it immediately).
 3. Authenticate the CLI with it: `mel auth login --api-key mel_<your-key>`.
 
+## Upgrading
+
+Check your installed version with `mel --version`. Upgrade with the same tool you installed with:
+
+```bash
+# npm
+npm install -g @melius-ai/cli@latest
+
+# Homebrew (macOS/Linux)
+brew update && brew upgrade mel
+```
+
+To see the latest published version, run `npm view @melius-ai/cli version` (or visit the [package page on npm](https://www.npmjs.com/package/@melius-ai/cli)). Releases follow [semantic versioning](https://semver.org) — a major version bump (for example `1.x` → `2.x`) can include breaking changes, so review what changed before upgrading across one.
+
 ## Sandbox setup
 
 In the Claude Code sandbox, only two environment variables are needed:

package/dist/bin/mel.js

@@ -4,9 +4,10 @@ import {
   EXIT_API_ERROR,
   createProgram,
   formatError,
+  printUpgradeNoticeIfNeeded,
   withDefaultHelp,
   writeError
-} from "../chunk-JVD4O5T3.js";
+} from "../chunk-EXHDKHNG.js";
 
 // bin/mel.ts
 var program = createProgram();
@@ -23,3 +24,6 @@ try {
     EXIT_API_ERROR
   );
 }
+printUpgradeNoticeIfNeeded({
+  quiet: Boolean(program.opts().quiet)
+});

package/dist/{chunk-JVD4O5T3.js → chunk-EXHDKHNG.js}

@@ -9809,6 +9809,128 @@ var ElevenLabsVoiceSettingsSchema = external_exports.object({
   outputFormat: ElevenLabsOutputFormatSchema.optional()
 });
 
+// ../api-contract/src/lora.ts
+var c6 = initContract();
+var MAX_LORA_NAME_LENGTH = 80;
+var MAX_LORA_DESCRIPTION_LENGTH = 1e3;
+var MAX_LORA_TRIGGER_WORDS_LENGTH = 500;
+var MAX_LORA_FILE_SIZE_BYTES = 2 * 1024 * 1024 * 1024;
+var MAX_LORAS_PER_GENERATION = 5;
+var MIN_LORA_WEIGHT = 0;
+var MAX_LORA_WEIGHT = 1.5;
+var MIN_SDXL_STEPS = 1;
+var MAX_SDXL_STEPS = 60;
+var MIN_SDXL_GUIDANCE_SCALE = 0;
+var MAX_SDXL_GUIDANCE_SCALE = 20;
+var LoraBaseModelSchema = external_exports.enum(["sdxl", "flux", "other"]);
+var LoraSelectionSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  weight: external_exports.number().min(MIN_LORA_WEIGHT).max(MAX_LORA_WEIGHT)
+});
+var LoraStackSchema = external_exports.array(LoraSelectionSchema).max(MAX_LORAS_PER_GENERATION);
+var AppliedLoraSchema = external_exports.object({
+  id: external_exports.string(),
+  name: external_exports.string(),
+  weight: external_exports.number()
+});
+var SdxlStepsSchema = external_exports.number().int().min(MIN_SDXL_STEPS).max(MAX_SDXL_STEPS);
+var SdxlGuidanceScaleSchema = external_exports.number().min(MIN_SDXL_GUIDANCE_SCALE).max(MAX_SDXL_GUIDANCE_SCALE);
+var LoraSummarySchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  name: external_exports.string(),
+  description: external_exports.string(),
+  /** Activation tokens parsed from the file (best-effort); null if none. */
+  triggerWords: external_exports.string().nullable(),
+  baseModel: LoraBaseModelSchema,
+  /** Recommended blend weight the picker pre-fills. */
+  defaultScale: external_exports.number(),
+  previewUrl: external_exports.string().nullable(),
+  /** teamId is null ⇒ a global/curated LoRA owned by Melius (added by us). */
+  isGlobal: external_exports.boolean(),
+  fileSizeBytes: external_exports.number(),
+  createdAt: external_exports.string(),
+  updatedAt: external_exports.string()
+});
+var ListLorasResponseSchema = external_exports.object({
+  loras: external_exports.array(LoraSummarySchema)
+});
+var InitLoraUploadBodySchema = external_exports.object({
+  filename: external_exports.string().min(1),
+  sizeInBytes: external_exports.number().int().positive().max(MAX_LORA_FILE_SIZE_BYTES)
+});
+var InitLoraUploadResponseSchema = external_exports.object({
+  /** Short-lived presigned PUT the client uploads the raw weights to. */
+  uploadUrl: external_exports.string(),
+  s3Bucket: external_exports.string(),
+  s3Key: external_exports.string()
+});
+var CreateLoraBodySchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(MAX_LORA_NAME_LENGTH),
+  description: external_exports.string().max(MAX_LORA_DESCRIPTION_LENGTH).optional(),
+  /** Uploader override; server falls back to the parsed metadata when omitted. */
+  triggerWords: external_exports.string().max(MAX_LORA_TRIGGER_WORDS_LENGTH).optional(),
+  baseModel: LoraBaseModelSchema,
+  s3Bucket: external_exports.string().min(1),
+  s3Key: external_exports.string().min(1),
+  /** Client-attested SHA-256 of the uploaded file (integrity reference). */
+  sha256: external_exports.string().min(1),
+  fileSizeBytes: external_exports.number().int().positive().max(MAX_LORA_FILE_SIZE_BYTES),
+  defaultScale: external_exports.number().min(MIN_LORA_WEIGHT).max(MAX_LORA_WEIGHT).optional()
+});
+var ForbiddenSchema = MessageResponseSchema;
+var NotFoundSchema = MessageResponseSchema;
+var BadRequestSchema = MessageResponseSchema;
+var ConflictSchema = MessageResponseSchema;
+var loraContract = c6.router({
+  listLoras: {
+    method: "GET",
+    path: "/teams/:teamId/loras",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    responses: {
+      200: ListLorasResponseSchema,
+      403: ForbiddenSchema,
+      404: NotFoundSchema
+    }
+  },
+  // @SkipManagedTransaction on the handler — only mints a presigned PUT.
+  initLoraUpload: {
+    method: "POST",
+    path: "/teams/:teamId/loras/upload",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    body: InitLoraUploadBodySchema,
+    responses: {
+      200: InitLoraUploadResponseSchema,
+      400: BadRequestSchema,
+      403: ForbiddenSchema
+    }
+  },
+  createLora: {
+    method: "POST",
+    path: "/teams/:teamId/loras",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    body: CreateLoraBodySchema,
+    responses: {
+      201: LoraSummarySchema,
+      400: BadRequestSchema,
+      403: ForbiddenSchema,
+      409: ConflictSchema
+    }
+  },
+  deleteLora: {
+    method: "DELETE",
+    path: "/teams/:teamId/loras/:loraId",
+    pathParams: external_exports.object({
+      teamId: external_exports.string().uuid(),
+      loraId: external_exports.string().uuid()
+    }),
+    responses: {
+      200: external_exports.object({ id: external_exports.string().uuid() }),
+      403: ForbiddenSchema,
+      404: NotFoundSchema
+    }
+  }
+});
+
 // ../api-contract/src/preview-asset.ts
 var PreviewAssetSchema = external_exports.object({
   url: external_exports.string(),
@@ -9917,7 +10039,7 @@ var TemplatePortSummarySchema = external_exports.object({
 });
 
 // ../api-contract/src/canvas.ts
-var c6 = initContract();
+var c7 = initContract();
 var CanvasResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
   teamId: external_exports.string().uuid(),
@@ -9975,7 +10097,13 @@ var ModelConfigSchema = external_exports.object({
   font: external_exports.object({
     source: external_exports.enum(["custom", "google"]),
     familyName: external_exports.string()
-  }).optional()
+  }).optional(),
+  /** SDXL only: the LoRA stack applied to this version (name denormalized so history survives deletion). */
+  loras: external_exports.array(AppliedLoraSchema).optional(),
+  /** SDXL only: sampler steps used for this version. */
+  steps: external_exports.number().optional(),
+  /** SDXL only: classifier-free guidance scale used for this version. */
+  guidanceScale: external_exports.number().optional()
 });
 var ModelConfigInputSchema = external_exports.object({
   model: external_exports.string(),
@@ -10369,7 +10497,17 @@ var RunNodeBodySchema = external_exports.object({
    * ElevenLabs voice tuning for TTS / voice-changer runs. Applied when
    * provided; the `voice-granular-controls` flag only gates the toolbar UI.
    */
-  elevenLabsVoiceSettings: ElevenLabsVoiceSettingsSchema.optional()
+  elevenLabsVoiceSettings: ElevenLabsVoiceSettingsSchema.optional(),
+  /**
+   * LoRA adapters to stack on a self-hosted SDXL generation (`{ id, weight }`).
+   * The server resolves each id to a presigned weights URL and validates team
+   * access. Only honored on the SDXL model.
+   */
+  loras: LoraStackSchema.optional(),
+  /** SDXL sampler steps. Only honored on the SDXL model. */
+  steps: SdxlStepsSchema.optional(),
+  /** SDXL guidance scale. Only honored on the SDXL model. */
+  guidanceScale: SdxlGuidanceScaleSchema.optional()
 });
 var RunImageToolBodySchema = external_exports.object({
   canvasId: external_exports.string().uuid().optional(),
@@ -10798,7 +10936,7 @@ var CanvasSettingsResponseSchema = external_exports.object({
   createdAt: external_exports.string().datetime(),
   updatedAt: external_exports.string().datetime()
 });
-var canvasContract = c6.router({
+var canvasContract = c7.router({
   createCanvas: {
     method: "POST",
     path: "/projects/:projectId/canvases",
@@ -10852,7 +10990,7 @@ var canvasContract = c6.router({
       canvasId: external_exports.string().uuid()
     }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   duplicateCanvas: {
     method: "POST",
@@ -11267,7 +11405,7 @@ var canvasContract = c6.router({
     pathParams: external_exports.object({ nodeRunId: external_exports.string().uuid() }),
     body: external_exports.object({}),
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: NodeRunErrorResponseSchema,
       409: NodeRunErrorResponseSchema
     },
@@ -11445,7 +11583,7 @@ var canvasContract = c6.router({
     path: "/comment-threads/:threadId",
     pathParams: external_exports.object({ threadId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   // ── Comments ────────────────────────────────────────────────────────
   addComment: {
@@ -11460,7 +11598,7 @@ var canvasContract = c6.router({
     path: "/comments/:commentId",
     pathParams: external_exports.object({ commentId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   // ── Direct CRDT Mutations (CLI/Agent) ───────────────────────────────
   // These endpoints write directly to the Y.Doc (CRDT) for the canvas.
@@ -11500,7 +11638,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: MessageResponseSchema,
       409: MessageResponseSchema
     }
@@ -11536,7 +11674,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: MessageResponseSchema,
       409: MessageResponseSchema
     }
@@ -11629,7 +11767,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       403: MessageResponseSchema,
       404: MessageResponseSchema,
       409: MessageResponseSchema
@@ -11713,7 +11851,7 @@ var canvasContract = c6.router({
     path: "/canvases/:canvasId/settings",
     pathParams: external_exports.object({ canvasId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   // ── Agent presence ──────────────────────────────────────────────────
   // Broadcast an agent's "claim region" to all connected canvas
@@ -11740,16 +11878,16 @@ var canvasContract = c6.router({
         }).nullable().optional(),
         status: external_exports.string().min(1).max(80)
       }).refine(
-        (c16) => c16.nodeIds.length > 0 || c16.bounds != null,
+        (c17) => c17.nodeIds.length > 0 || c17.bounds != null,
         "claim must include nodeIds or bounds"
       ).nullable()
     }),
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   }
 });
 
 // ../api-contract/src/custom-font.ts
-var c7 = initContract();
+var c8 = initContract();
 var CustomFontResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
   familyName: external_exports.string(),
@@ -11773,7 +11911,7 @@ var CompleteCustomFontUploadBodySchema = external_exports.object({
   sizeInBytes: external_exports.number().int().positive(),
   parts: external_exports.array(CompletedPartSchema)
 });
-var customFontContract = c7.router({
+var customFontContract = c8.router({
   list: {
     method: "GET",
     path: "/custom-fonts",
@@ -11801,7 +11939,7 @@ var customFontContract = c7.router({
 });
 
 // ../api-contract/src/generation.ts
-var c8 = initContract();
+var c9 = initContract();
 var GenerationJobStatusSchema = external_exports.enum([
   "in_progress",
   "finished",
@@ -11859,7 +11997,21 @@ var GenerationRunBodySchema = external_exports.object({
    * by every other model. When absent, the server falls back to a
    * default Google font (Inter).
    */
-  font: BetterFontSelectionSchema.optional()
+  font: BetterFontSelectionSchema.optional(),
+  /**
+   * LoRA adapters to stack on a LoRA-capable image generation (`{ id, weight }`;
+   * the server resolves each id to a presigned weights URL). Only honored on
+   * LoRA-capable models (SDXL on Modal, Flux on fal); ignored by every other
+   * model.
+   */
+  loras: LoraStackSchema.optional(),
+  /** Sampler steps. Only honored on LoRA-capable models (SDXL, Flux). */
+  steps: SdxlStepsSchema.optional(),
+  /**
+   * Classifier-free guidance scale. Only honored on LoRA-capable models
+   * (SDXL, Flux).
+   */
+  guidanceScale: SdxlGuidanceScaleSchema.optional()
 });
 var ModelCategorySchema = external_exports.enum([
   "image",
@@ -12112,7 +12264,7 @@ var SeedancePrecheckResponseSchema = external_exports.object({
   reason: external_exports.string(),
   cacheKey: external_exports.string()
 });
-var generationContract = c8.router({
+var generationContract = c9.router({
   listGenerativeModels: {
     method: "GET",
     path: "/generation/models",
@@ -12171,7 +12323,7 @@ var generationContract = c8.router({
       until: external_exports.string().datetime().optional()
     }),
     responses: {
-      200: c8.otherResponse({
+      200: c9.otherResponse({
         contentType: "text/csv",
         body: external_exports.string()
       })
@@ -12198,7 +12350,7 @@ var generationContract = c8.router({
 });
 
 // ../api-contract/src/presets.ts
-var c9 = initContract();
+var c10 = initContract();
 var TextNodeDataSchema = external_exports.object({
   title: external_exports.string(),
   mode: external_exports.string(),
@@ -12300,7 +12452,7 @@ var PresetResponseSchema = external_exports.object({
   nodes: external_exports.array(PresetNodeSchema),
   edges: external_exports.array(PresetEdgeSchema)
 });
-var presetsContract = c9.router({
+var presetsContract = c10.router({
   listPresets: {
     method: "GET",
     path: "/presets",
@@ -12314,7 +12466,7 @@ var presetsContract = c9.router({
 });
 
 // ../api-contract/src/profile.ts
-var c10 = initContract();
+var c11 = initContract();
 var MagicResizeCustomResolutionSchema = external_exports.object({
   width: external_exports.number().int().min(64).max(4096),
   height: external_exports.number().int().min(64).max(4096)
@@ -12345,7 +12497,7 @@ var ReferralRewardNotificationSchema = external_exports.object({
   counterpartName: external_exports.string(),
   redeemedAt: external_exports.string().datetime()
 });
-var profileContract = c10.router({
+var profileContract = c11.router({
   getMyProfile: {
     method: "GET",
     path: "/profile/me",
@@ -12404,7 +12556,7 @@ var profileContract = c10.router({
 });
 
 // ../api-contract/src/share.ts
-var c11 = initContract();
+var c12 = initContract();
 var ShareModeSchema = external_exports.enum(["restricted", "view"]);
 var ShareCanvasResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
@@ -12440,7 +12592,7 @@ var ShareProjectInfoResponseSchema = external_exports.object({
     avatarUrl: external_exports.string().nullable()
   }).nullable()
 });
-var shareContract = c11.router({
+var shareContract = c12.router({
   // Public endpoint — no auth required
   getSharedProjectInfo: {
     method: "GET",
@@ -12527,7 +12679,7 @@ var shareContract = c11.router({
 });
 
 // ../api-contract/src/team.ts
-var c12 = initContract();
+var c13 = initContract();
 var TeamRoleSchema = external_exports.enum(["owner", "admin", "editor", "viewer"]);
 var TeamPlanSchema = external_exports.enum([
   "TIER_0",
@@ -12741,7 +12893,7 @@ var EmailInviteSchema = external_exports.object({
   senderName: external_exports.string(),
   createdAt: external_exports.string().datetime()
 });
-var teamContract = c12.router({
+var teamContract = c13.router({
   createTeam: {
     method: "POST",
     path: "/teams",
@@ -12806,7 +12958,7 @@ var teamContract = c12.router({
     method: "DELETE",
     path: "/teams/current",
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   listMembers: {
     method: "GET",
@@ -12827,7 +12979,7 @@ var teamContract = c12.router({
     path: "/teams/current/members/:userId",
     pathParams: external_exports.object({ userId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   getShareableLink: {
     method: "GET",
@@ -12868,7 +13020,7 @@ var teamContract = c12.router({
     path: "/teams/current/invite-email/:inviteId",
     pathParams: external_exports.object({ inviteId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   listJoinRequests: {
     method: "GET",
@@ -12887,7 +13039,7 @@ var teamContract = c12.router({
     path: "/teams/current/join-requests/:requestId",
     pathParams: external_exports.object({ requestId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   updateDomainJoinSettings: {
     method: "PATCH",
@@ -12909,7 +13061,7 @@ var teamContract = c12.router({
 });
 
 // ../api-contract/src/project.ts
-var c13 = initContract();
+var c14 = initContract();
 var CanvasSummarySchema = external_exports.object({
   id: external_exports.string().uuid(),
   title: external_exports.string(),
@@ -13008,7 +13160,7 @@ var ProjectSettingsResponseSchema = external_exports.object({
   createdAt: external_exports.string().datetime(),
   updatedAt: external_exports.string().datetime()
 });
-var projectContract = c13.router({
+var projectContract = c14.router({
   createProject: {
     method: "POST",
     path: "/projects",
@@ -13045,14 +13197,14 @@ var projectContract = c13.router({
     path: "/projects/:projectId",
     pathParams: ProjectIdParamsSchema,
     body: null,
-    responses: { 204: c13.noBody() }
+    responses: { 204: c14.noBody() }
   },
   recordProjectView: {
     method: "POST",
     path: "/projects/:projectId/view",
     pathParams: ProjectIdParamsSchema,
     body: null,
-    responses: { 204: c13.noBody() }
+    responses: { 204: c14.noBody() }
   },
   listRecentProjects: {
     method: "GET",
@@ -13152,12 +13304,12 @@ var projectContract = c13.router({
     path: "/projects/:projectId/settings",
     pathParams: ProjectIdParamsSchema,
     body: null,
-    responses: { 204: c13.noBody() }
+    responses: { 204: c14.noBody() }
   }
 });
 
 // ../api-contract/src/upload.ts
-var c14 = initContract();
+var c15 = initContract();
 var InitUploadBodySchema = external_exports.object({
   nodeId: external_exports.string().uuid().optional(),
   filename: external_exports.string(),
@@ -13229,7 +13381,7 @@ var CompleteUploadResponseSchema = external_exports.object({
   // clients tolerate deploy skew with older core versions.
   nodeVersionId: external_exports.string().uuid().nullable().optional()
 });
-var uploadContract = c14.router({
+var uploadContract = c15.router({
   init: {
     method: "POST",
     path: "/upload/init",
@@ -13254,8 +13406,8 @@ var uploadContract = c14.router({
 });
 
 // ../api-contract/src/public/index.ts
-var c15 = initContract();
-var publicContract = c15.router(
+var c16 = initContract();
+var publicContract = c16.router(
   {
     project: {
       create: projectContract.createProject,
@@ -13548,6 +13700,65 @@ function setConfigValue(key, value) {
   writeConfigFile({ [key]: value });
 }
 
+// src/lib/update-notice.ts
+var MEL_CLI_LATEST_VERSION_HEADER = "x-mel-cli-latest-version";
+var serverLatestVersion = null;
+function recordServerLatestVersion(value) {
+  if (value) serverLatestVersion = value;
+}
+var SEMVER_PATTERN = /^v?\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+function parseVersion(version) {
+  const trimmed = version.trim();
+  if (!SEMVER_PATTERN.test(trimmed)) return null;
+  const core = trimmed.replace(/^v/, "").split(/[-+]/)[0];
+  const [major, minor, patch] = core.split(".").map((p) => Number.parseInt(p, 10));
+  return [major, minor, patch];
+}
+function isNewerVersion(current, latest) {
+  const c17 = parseVersion(current);
+  const l = parseVersion(latest);
+  if (!c17 || !l) return false;
+  for (let i = 0; i < 3; i++) {
+    if (l[i] > c17[i]) return true;
+    if (l[i] < c17[i]) return false;
+  }
+  return false;
+}
+function isMajorUpgrade(current, latest) {
+  const c17 = parseVersion(current);
+  const l = parseVersion(latest);
+  if (!c17 || !l) return false;
+  return l[0] > c17[0];
+}
+function shouldShowUpgradeNotice(ctx = {}) {
+  const current = ctx.current ?? "0.4.0";
+  const latest = ctx.latest ?? serverLatestVersion;
+  const env = ctx.env ?? process.env;
+  const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
+  if (!latest) return false;
+  if (ctx.quiet) return false;
+  if (!isTty) return false;
+  if (env["MEL_NO_UPDATE_NOTIFIER"]) return false;
+  if (env["CI"]) return false;
+  return isNewerVersion(current, latest);
+}
+function formatUpgradeNotice(current, latest) {
+  const breaking = isMajorUpgrade(current, latest) ? " This is a new major version that may include breaking changes." : "";
+  return `
+mel ${latest} is available (you have ${current}).${breaking}
+Upgrade: npm install -g @melius-ai/cli@latest  (or: brew upgrade mel)   Silence: MEL_NO_UPDATE_NOTIFIER=1
+`;
+}
+function printUpgradeNoticeIfNeeded(ctx = {}) {
+  try {
+    if (!shouldShowUpgradeNotice(ctx)) return;
+    const current = ctx.current ?? "0.4.0";
+    const latest = ctx.latest ?? serverLatestVersion;
+    process.stderr.write(formatUpgradeNotice(current, latest));
+  } catch {
+  }
+}
+
 // src/lib/client.ts
 var _client = null;
 var _verbose = false;
@@ -13678,6 +13889,9 @@ function createClient(config) {
         }
         const t0 = _verbose ? Date.now() : 0;
         const response = await fetchWithRateLimitRetry(path4, fetchOpts);
+        recordServerLatestVersion(
+          response.headers.get(MEL_CLI_LATEST_VERSION_HEADER)
+        );
         const contentType = response.headers.get("content-type");
         let responseBody;
         if (contentType?.includes("application/json")) {
@@ -14228,8 +14442,8 @@ function computeAutoformat(allNodes, allEdges, nodeIds) {
     topologyEdges.push({ ...edge, srcNodeId: src, dstNodeId: dst });
   }
   const rawComponents = findConnectedComponents(targetIds, topologyEdges);
-  const connectedComponents = rawComponents.filter((c16) => c16.length > 1);
-  const isolatedIds = rawComponents.filter((c16) => c16.length === 1).flat().sort();
+  const connectedComponents = rawComponents.filter((c17) => c17.length > 1);
+  const isolatedIds = rawComponents.filter((c17) => c17.length === 1).flat().sort();
   if (isolatedIds.length > 0) connectedComponents.push(isolatedIds);
   const components = connectedComponents.sort((a, b) => {
     const aHasText = a.some((id) => {
@@ -14419,7 +14633,7 @@ function computeAutoformat(allNodes, allEdges, nodeIds) {
       const col = i % cols;
       const row = Math.floor(i / cols);
       let cx = originX;
-      for (let c16 = 0; c16 < col; c16++) cx += colWidths[c16] + COL_GAP2;
+      for (let c17 = 0; c17 < col; c17++) cx += colWidths[c17] + COL_GAP2;
       let cy = originY;
       for (let r = 0; r < row; r++) cy += rowHeights[r] + ROW_GAP2;
       posMap.set(targets[i].id, { x: cx, y: cy });
@@ -14494,16 +14708,16 @@ function findNearestClearPosition(idealX, idealY, blockW, blockH, obstacles) {
   let bestPos = null;
   let bestMaxDim = Infinity;
   let bestDist = Infinity;
-  for (const c16 of candidates) {
-    if (!overlapsAny(c16.x, c16.y, blockW, blockH, obstacles)) {
-      const totalW = Math.max(allMaxX, c16.x + blockW) - Math.min(allMinX, c16.x);
-      const totalH = Math.max(allMaxY, c16.y + blockH) - Math.min(allMinY, c16.y);
+  for (const c17 of candidates) {
+    if (!overlapsAny(c17.x, c17.y, blockW, blockH, obstacles)) {
+      const totalW = Math.max(allMaxX, c17.x + blockW) - Math.min(allMinX, c17.x);
+      const totalH = Math.max(allMaxY, c17.y + blockH) - Math.min(allMinY, c17.y);
       const maxDim = Math.max(totalW, totalH);
-      const dist = Math.abs(c16.x - idealX) + Math.abs(c16.y - idealY);
+      const dist = Math.abs(c17.x - idealX) + Math.abs(c17.y - idealY);
       if (maxDim < bestMaxDim || maxDim === bestMaxDim && dist < bestDist) {
         bestMaxDim = maxDim;
         bestDist = dist;
-        bestPos = c16;
+        bestPos = c17;
       }
     }
   }
@@ -18350,7 +18564,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.3.0").showSuggestionAfterError(true).option("--json", "Force JSON output (default)").option("--text", "Human-readable output").option(
+  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.4.0").showSuggestionAfterError(true).option("--json", "Force JSON output (default)").option("--text", "Human-readable output").option(
     "--fields <fields>",
     "Select specific output fields (comma-separated)"
   ).option("--quiet", "Suppress output, exit code only").option("--verbose", "Log request/response metadata to stderr").addHelpText(
@@ -18424,6 +18638,7 @@ export {
   EXIT_API_ERROR,
   formatError,
   writeError,
+  printUpgradeNoticeIfNeeded,
   withDefaultHelp,
   createProgram
 };

package/dist/src/index.js

@@ -2,7 +2,7 @@ import { createRequire } from 'node:module'; const require = createRequire(impor
 import {
   createProgram,
   withDefaultHelp
-} from "../chunk-JVD4O5T3.js";
+} from "../chunk-EXHDKHNG.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melius-ai/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The Melius command-line interface — create canvases and run AI image/video generations from your terminal",
   "keywords": [
     "ai",