@meltstudio/meltctl 4.107.0 → 4.109.0

package/dist/index.js

@@ -14,7 +14,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/utils/version.ts"() {
     "use strict";
-    CLI_VERSION = "4.107.0";
+    CLI_VERSION = "4.109.0";
   }
 });
 
@@ -979,6 +979,30 @@ function createPmResource(config) {
       const status = opts?.status ?? "open";
       const res = await apiFetch(config, `/pm/risks?status=${status}`);
       return unwrap("list risks", res);
+    },
+    // ─── Portfolio status ──────────────────────────────────────────────────
+    /**
+     * Cross-project ranked answer to "where do I focus next?". Returns a
+     * sorted-by-urgency list where each entry surfaces the project's open
+     * flags grouped by severity, the top reasons it needs attention, the
+     * latest plan score, and the same composite health score the dashboard
+     * cards use.
+     *
+     * - Default (no opts) → caller's own portfolio. Non-managers always see
+     *   only this regardless of `pmEmail`; the API enforces that.
+     * - `pmEmail` (managers only) → another PM's portfolio.
+     * - `limit` → caps the all-org manager view; ignored when `pmEmail` is
+     *   set since a single PM rarely owns more than a handful of projects.
+     */
+    async getMyPortfolioStatus(opts) {
+      const params = new URLSearchParams();
+      if (opts?.pmEmail)
+        params.set("pmEmail", opts.pmEmail);
+      if (opts?.limit !== void 0)
+        params.set("limit", String(opts.limit));
+      const qs = params.toString();
+      const res = await apiFetch(config, `/pm/portfolio-status${qs ? `?${qs}` : ""}`);
+      return unwrap("get my portfolio status", res);
     }
   };
 }
@@ -2633,6 +2657,7 @@ import { z as z5 } from "zod";
 import { z as z6 } from "zod";
 import { z as z7 } from "zod";
 import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 function createAuditsResource2(config) {
   return {
     async submit(input3) {
@@ -3320,6 +3345,30 @@ function createPmResource2(config) {
       const status = opts?.status ?? "open";
       const res = await apiFetch2(config, `/pm/risks?status=${status}`);
       return unwrap2("list risks", res);
+    },
+    // ─── Portfolio status ──────────────────────────────────────────────────
+    /**
+     * Cross-project ranked answer to "where do I focus next?". Returns a
+     * sorted-by-urgency list where each entry surfaces the project's open
+     * flags grouped by severity, the top reasons it needs attention, the
+     * latest plan score, and the same composite health score the dashboard
+     * cards use.
+     *
+     * - Default (no opts) → caller's own portfolio. Non-managers always see
+     *   only this regardless of `pmEmail`; the API enforces that.
+     * - `pmEmail` (managers only) → another PM's portfolio.
+     * - `limit` → caps the all-org manager view; ignored when `pmEmail` is
+     *   set since a single PM rarely owns more than a handful of projects.
+     */
+    async getMyPortfolioStatus(opts) {
+      const params = new URLSearchParams();
+      if (opts?.pmEmail)
+        params.set("pmEmail", opts.pmEmail);
+      if (opts?.limit !== void 0)
+        params.set("limit", String(opts.limit));
+      const qs = params.toString();
+      const res = await apiFetch2(config, `/pm/portfolio-status${qs ? `?${qs}` : ""}`);
+      return unwrap2("get my portfolio status", res);
     }
   };
 }
@@ -3821,6 +3870,32 @@ function registerProjectHealthTools(server, client) {
     (args) => getProjectHealth(client, args)
   );
 }
+async function getMyPortfolioStatus(client, input3) {
+  return safe(
+    () => client.pm.getMyPortfolioStatus({
+      pmEmail: input3.pmEmail,
+      limit: input3.limit
+    })
+  );
+}
+function registerPortfolioStatusTools(server, client) {
+  server.registerTool(
+    "get_my_portfolio_status",
+    {
+      title: "Get my portfolio status",
+      description: "Cross-project ranked answer to 'where do I focus next?'. Returns one entry per project the caller can see, sorted by urgency desc. Each entry includes: 0\u2013100 health score (same formula as the dashboard cards), open audit-flag counts grouped by severity (critical/high/medium/low), up to 3 short topAttentionReasons derived from the highest-severity open flags, latest plan score across the project's repos, and the most recent audit timestamp. Default scope is the caller's own projects; managers can pass `pmEmail` to view another PM's portfolio or omit it to see the org-wide top `limit` projects (default 10). Use this for 'how is my portfolio doing?' and 'which project of <person>'s needs help?' questions \u2014 it pulls in one tool call what would otherwise be `list_projects` + N \xD7 `get_project_health` + N \xD7 `list_audit_flags`.",
+      inputSchema: {
+        pmEmail: z9.string().email().optional().describe(
+          "Manager-only override. When set, scopes the response to that PM's projects. Non-managers may only set this to their own email; any other value returns 403."
+        ),
+        limit: z9.number().int().positive().max(100).optional().describe(
+          "Max entries to return when called by a manager without `pmEmail` (top-N by urgency). Ignored for PM-scoped calls \u2014 those return every project the PM owns. Default 10, max 100."
+        )
+      }
+    },
+    (args) => getMyPortfolioStatus(client, args)
+  );
+}
 var VERSION = "0.0.0";
 function createMcpServer(client) {
   const server = new McpServer(
@@ -3834,6 +3909,7 @@ function createMcpServer(client) {
   registerPlanTools(server, client);
   registerBoardAuditTools(server, client);
   registerProjectHealthTools(server, client);
+  registerPortfolioStatusTools(server, client);
   return server;
 }
 async function startServer() {

package/package.json

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