@meltstudio/meltctl 4.117.1 → 4.118.1

package/dist/index.js

@@ -14,7 +14,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/utils/version.ts"() {
     "use strict";
-    CLI_VERSION = "4.117.1";
+    CLI_VERSION = "4.118.1";
   }
 });
 
@@ -164,10 +164,16 @@ function getUpdateSeverity(current, latest) {
   if (latMajor === curMajor && latMinor === curMinor && latPatch > curPatch) return "patch";
   return "none";
 }
-async function checkAndEnforceUpdate() {
+function isAlwaysRunnable(commandName) {
+  return commandName !== void 0 && ALWAYS_RUNNABLE_COMMANDS.has(commandName);
+}
+async function checkAndEnforceUpdate(commandName) {
   if (isCI()) {
     return;
   }
+  if (isAlwaysRunnable(commandName)) {
+    return;
+  }
   try {
     const currentVersion = await getCurrentCliVersion();
     const latestVersion = await getLatestCliVersion();
@@ -211,10 +217,12 @@ async function checkAndEnforceUpdate() {
     return;
   }
 }
+var ALWAYS_RUNNABLE_COMMANDS;
 var init_version_check = __esm({
   "src/utils/version-check.ts"() {
     "use strict";
     init_version();
+    ALWAYS_RUNNABLE_COMMANDS = /* @__PURE__ */ new Set(["login", "logout", "update", "version", "mcp", "help"]);
   }
 });
 
@@ -1893,13 +1901,13 @@ async function loginCommand() {
     server.listen(port, () => {
       const authUrl = `${API_BASE}/auth/google?redirect_uri=${encodeURIComponent(redirectUri)}`;
       console.log();
-      console.log(chalk5.bold("  A browser window will open shortly."));
-      console.log(chalk5.dim("  Please log in with your @meltstudio.co Google Workspace account."));
+      console.log(chalk5.bold("  Open this URL to log in (or wait for your browser to open):"));
       console.log();
-      setTimeout(() => {
-        openBrowser(authUrl);
-        console.log(chalk5.dim(`  If the browser didn't open, visit: ${authUrl}`));
-      }, 2e3);
+      console.log(`  ${chalk5.cyan(authUrl)}`);
+      console.log();
+      console.log(chalk5.dim("  Sign in with your @meltstudio.co Google Workspace account."));
+      console.log();
+      openBrowser(authUrl);
     });
   });
   console.log(chalk5.dim("Exchanging authorization code..."));
@@ -3647,7 +3655,7 @@ async function loadAuth() {
   } catch (err) {
     if (err.code === "ENOENT") {
       throw new AuthError(
-        "No meltctl session found. Run `npx @meltstudio/meltctl@latest login` first, then restart your MCP-enabled editor."
+        "meltctl tools are disabled until you log in. Run `npx @meltstudio/meltctl@latest login`, then restart this editor so the MCP server picks up the new token."
       );
     }
     throw err;
@@ -3662,7 +3670,7 @@ async function loadAuth() {
   }
   if (new Date(stored.expiresAt) <= /* @__PURE__ */ new Date()) {
     throw new AuthError(
-      "meltctl session expired. Run `npx @meltstudio/meltctl@latest login` to refresh, then restart your MCP-enabled editor."
+      "meltctl tools are disabled because the saved session has expired. Run `npx @meltstudio/meltctl@latest login` to refresh it, then restart this editor."
     );
   }
   return stored;
@@ -3691,13 +3699,35 @@ async function safe(fn) {
     return fail(message);
   }
 }
+function withClient(getClient2, handler) {
+  return async () => {
+    try {
+      const client = await getClient2();
+      return await handler(client);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return fail(message);
+    }
+  };
+}
+function withClientArgs(getClient2, handler) {
+  return async (args) => {
+    try {
+      const client = await getClient2();
+      return await handler(client, args);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return fail(message);
+    }
+  };
+}
 async function listProjects(client) {
   return safe(() => client.projects.list());
 }
 async function getProjectSettings(client, input3) {
   return safe(() => client.pm.getProjectSettings(input3.projectId));
 }
-function registerProjectTools(server, client) {
+function registerProjectTools(server, getClient2) {
   server.registerTool(
     "list_projects",
     {
@@ -3705,7 +3735,7 @@ function registerProjectTools(server, client) {
       description: "Lists every Melt project the authenticated user can see. Use this to resolve a project's name to its numeric `projectId` before calling any other tool. Returns id, name, client, project manager, and repo count per project.",
       inputSchema: {}
     },
-    () => listProjects(client)
+    withClient(getClient2, listProjects)
   );
   server.registerTool(
     "get_project_settings",
@@ -3716,7 +3746,7 @@ function registerProjectTools(server, client) {
         projectId: z22.number().int().positive().describe("Strapi project id from list_projects.")
       }
     },
-    (args) => getProjectSettings(client, args)
+    withClientArgs(getClient2, getProjectSettings)
   );
 }
 var SHAPE_DESC = "crawling | walking | running. Target shape is intent (PM sets when creating); current shape is computed from feature stages.";
@@ -3745,7 +3775,7 @@ var createPhaseInputSchema = z3.object({
   targetShape: z3.enum(["crawling", "walking", "running"]).default("walking"),
   isPrimary: z3.boolean().optional()
 });
-function registerPhaseTools(server, client) {
+function registerPhaseTools(server, getClient2) {
   server.registerTool(
     "list_phases",
     {
@@ -3756,7 +3786,7 @@ function registerPhaseTools(server, client) {
         includeClosed: z3.boolean().optional().describe("Default false. Set true to include closed phases as history.")
       }
     },
-    (args) => listPhases(client, args)
+    withClientArgs(getClient2, listPhases)
   );
   server.registerTool(
     "create_phase",
@@ -3772,7 +3802,7 @@ function registerPhaseTools(server, client) {
         )
       }
     },
-    (args) => createPhase(client, args)
+    withClientArgs(getClient2, createPhase)
   );
   server.registerTool(
     "assign_feature_to_phase",
@@ -3784,7 +3814,7 @@ function registerPhaseTools(server, client) {
         featureId: z3.string().uuid().describe("Feature id from list_features or create_feature.")
       }
     },
-    (args) => assignFeatureToPhase(client, args)
+    withClientArgs(getClient2, assignFeatureToPhase)
   );
   server.registerTool(
     "unassign_feature_from_phase",
@@ -3796,7 +3826,7 @@ function registerPhaseTools(server, client) {
         featureId: z3.string().uuid().describe("Feature id of the membership to remove. The feature itself is not deleted.")
       }
     },
-    (args) => unassignFeatureFromPhase(client, args)
+    withClientArgs(getClient2, unassignFeatureFromPhase)
   );
 }
 var STAGE_VALUES = ["idea", "poc", "pt", "mv", "mk", "ma", "mbi"];
@@ -3834,7 +3864,7 @@ var updateFeatureInputSchema = z4.object({
   clientDependencies: z4.string().optional(),
   linearEpicUrl: z4.string().url().nullable().optional()
 });
-function registerFeatureTools(server, client) {
+function registerFeatureTools(server, getClient2) {
   server.registerTool(
     "list_features",
     {
@@ -3844,7 +3874,7 @@ function registerFeatureTools(server, client) {
         projectId: z4.number().int().positive()
       }
     },
-    (args) => listFeatures(client, args)
+    withClientArgs(getClient2, listFeatures)
   );
   server.registerTool(
     "create_feature",
@@ -3863,7 +3893,7 @@ function registerFeatureTools(server, client) {
         clientDependencies: z4.string().optional().describe("Free-text. What blockers from the client side, if any.")
       }
     },
-    (args) => createFeature(client, args)
+    withClientArgs(getClient2, createFeature)
   );
   server.registerTool(
     "update_feature",
@@ -3885,7 +3915,7 @@ function registerFeatureTools(server, client) {
         )
       }
     },
-    (args) => updateFeature(client, args)
+    withClientArgs(getClient2, updateFeature)
   );
 }
 var FLAG_STATUS_VALUES = ["open", "resolved", "dismissed", "all"];
@@ -3909,7 +3939,7 @@ var dismissAuditFlagInputSchema = z5.object({
   flagId: z5.string().uuid(),
   reason: z5.string().min(1)
 });
-function registerAuditTools(server, client) {
+function registerAuditTools(server, getClient2) {
   server.registerTool(
     "list_audit_flags",
     {
@@ -3922,7 +3952,7 @@ function registerAuditTools(server, client) {
         )
       }
     },
-    (args) => listAuditFlags(client, args)
+    withClientArgs(getClient2, listAuditFlags)
   );
   server.registerTool(
     "get_audit_catalog",
@@ -3931,7 +3961,7 @@ function registerAuditTools(server, client) {
       description: "Returns every audit rule the system knows about (code, category, title, description, severity, rubric version). Use this to explain to a PM what a specific flag means, or to enumerate what kinds of things we audit for. Catalog is read-only \u2014 new entries land via migration.",
       inputSchema: {}
     },
-    () => getAuditCatalog(client)
+    withClient(getClient2, getAuditCatalog)
   );
   server.registerTool(
     "dismiss_audit_flag",
@@ -3945,7 +3975,7 @@ function registerAuditTools(server, client) {
         )
       }
     },
-    (args) => dismissAuditFlag(client, args)
+    withClientArgs(getClient2, dismissAuditFlag)
   );
   server.registerTool(
     "run_project_audit",
@@ -3956,7 +3986,7 @@ function registerAuditTools(server, client) {
         projectId: z5.number().int().positive()
       }
     },
-    (args) => runProjectAudit(client, args)
+    withClientArgs(getClient2, runProjectAudit)
   );
 }
 async function listPlans(client, input3 = {}) {
@@ -3973,7 +4003,7 @@ var listPlansInputSchema = z6.object({
   repository: z6.string().optional(),
   limit: z6.number().int().positive().max(200).optional()
 });
-function registerPlanTools(server, client) {
+function registerPlanTools(server, getClient2) {
   server.registerTool(
     "list_plans",
     {
@@ -3990,7 +4020,7 @@ function registerPlanTools(server, client) {
         limit: z6.number().int().positive().max(200).optional().describe("Cap the return size. Default is whatever the API returns (typically 50).")
       }
     },
-    (args) => listPlans(client, args)
+    withClientArgs(getClient2, listPlans)
   );
   server.registerTool(
     "get_plan",
@@ -4001,7 +4031,7 @@ function registerPlanTools(server, client) {
         planId: z6.string().uuid()
       }
     },
-    (args) => getPlan(client, args)
+    withClientArgs(getClient2, getPlan)
   );
 }
 async function listBoardAudits(client, input3 = {}) {
@@ -4020,7 +4050,7 @@ var listBoardAuditsInputSchema = z7.object({
   projectId: z7.number().int().positive().optional(),
   limit: z7.number().int().positive().max(200).optional()
 });
-function registerBoardAuditTools(server, client) {
+function registerBoardAuditTools(server, getClient2) {
   server.registerTool(
     "list_board_audits",
     {
@@ -4031,7 +4061,7 @@ function registerBoardAuditTools(server, client) {
         limit: z7.number().int().positive().max(200).optional()
       }
     },
-    (args) => listBoardAudits(client, args)
+    withClientArgs(getClient2, listBoardAudits)
   );
   server.registerTool(
     "get_board_audit",
@@ -4042,7 +4072,7 @@ function registerBoardAuditTools(server, client) {
         auditId: z7.string().uuid()
       }
     },
-    (args) => getBoardAudit(client, args)
+    withClientArgs(getClient2, getBoardAudit)
   );
   server.registerTool(
     "list_latest_board_audits",
@@ -4051,7 +4081,7 @@ function registerBoardAuditTools(server, client) {
       description: "Cross-project rollup: one entry per project showing its most recent board audit (score, severity-binned finding counts, run timestamp). Use this for questions like 'which of my projects has the worst board hygiene right now?' Cheaper than calling `list_board_audits` per project.",
       inputSchema: {}
     },
-    () => listLatestBoardAudits(client)
+    withClient(getClient2, listLatestBoardAudits)
   );
   server.registerTool(
     "get_board_audit_catalog",
@@ -4060,13 +4090,13 @@ function registerBoardAuditTools(server, client) {
       description: "Returns every board-audit rule the system knows about (code, category, title, description, severity). Complements `get_audit_catalog` (which is for project-level flags); this one covers ticket-tracker hygiene checks.",
       inputSchema: {}
     },
-    () => getBoardAuditCatalog(client)
+    withClient(getClient2, getBoardAuditCatalog)
   );
 }
 async function getProjectHealth(client, input3) {
   return safe(() => client.pm.getProjectHealth(input3.projectId));
 }
-function registerProjectHealthTools(server, client) {
+function registerProjectHealthTools(server, getClient2) {
   server.registerTool(
     "get_project_health",
     {
@@ -4078,7 +4108,7 @@ function registerProjectHealthTools(server, client) {
         )
       }
     },
-    (args) => getProjectHealth(client, args)
+    withClientArgs(getClient2, getProjectHealth)
   );
 }
 async function getMyPortfolioStatus(client, input3) {
@@ -4089,7 +4119,7 @@ async function getMyPortfolioStatus(client, input3) {
     })
   );
 }
-function registerPortfolioStatusTools(server, client) {
+function registerPortfolioStatusTools(server, getClient2) {
   server.registerTool(
     "get_my_portfolio_status",
     {
@@ -4104,38 +4134,32 @@ function registerPortfolioStatusTools(server, client) {
         )
       }
     },
-    (args) => getMyPortfolioStatus(client, args)
+    withClientArgs(getClient2, getMyPortfolioStatus)
   );
 }
 var VERSION = "0.0.0";
-function createMcpServer(client) {
+function createMcpServer(clientOrProvider) {
+  const getClient2 = typeof clientOrProvider === "function" ? clientOrProvider : () => Promise.resolve(clientOrProvider);
   const server = new McpServer(
     { name: "meltctl-mcp", version: VERSION },
     { capabilities: { tools: {} } }
   );
-  registerProjectTools(server, client);
-  registerPhaseTools(server, client);
-  registerFeatureTools(server, client);
-  registerAuditTools(server, client);
-  registerPlanTools(server, client);
-  registerBoardAuditTools(server, client);
-  registerProjectHealthTools(server, client);
-  registerPortfolioStatusTools(server, client);
+  registerProjectTools(server, getClient2);
+  registerPhaseTools(server, getClient2);
+  registerFeatureTools(server, getClient2);
+  registerAuditTools(server, getClient2);
+  registerPlanTools(server, getClient2);
+  registerBoardAuditTools(server, getClient2);
+  registerProjectHealthTools(server, getClient2);
+  registerPortfolioStatusTools(server, getClient2);
   return server;
 }
 async function startServer() {
-  let client;
-  try {
+  const getClient2 = async () => {
     const auth = await loadAuth();
-    client = createMeltClient2({ baseUrl: API_BASE2, token: auth.token });
-  } catch (err) {
-    if (err instanceof AuthError) {
-      console.error(`[meltctl-mcp] ${err.message}`);
-      process.exit(1);
-    }
-    throw err;
-  }
-  const server = createMcpServer(client);
+    return createMeltClient2({ baseUrl: API_BASE2, token: auth.token });
+  };
+  const server = createMcpServer(getClient2);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -4185,8 +4209,12 @@ ${chalk16.dim("  plan submit [file]     Submit or update a plan")}
 ${chalk16.dim("  plan list              List plans (managers only)")}
 ${chalk16.dim("  event track --skill    Track skill usage (called by skills automatically)")}
 `
-).hook("preAction", async () => {
-  await checkAndEnforceUpdate();
+).hook("preAction", async (_thisCommand, actionCommand) => {
+  let cmd = actionCommand;
+  while (cmd.parent && cmd.parent.name() !== "meltctl") {
+    cmd = cmd.parent;
+  }
+  await checkAndEnforceUpdate(cmd.name());
 }).hook("postAction", async (_thisCommand, actionCommand) => {
   try {
     const parts = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "4.117.1",
+  "version": "4.118.1",
   "description": "AI-first development tools for teams - set up AGENTS.md, Claude Code, Cursor, and OpenCode standards",
   "main": "dist/index.js",
   "type": "module",