@meltstudio/meltctl 4.157.1 → 4.159.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.157.1";
+    CLI_VERSION = "4.159.0";
   }
 });
 
@@ -1067,6 +1067,26 @@ function createPmResource(config) {
       const res = await apiFetch(config, `/pm/projects/${projectId}/roadmap`);
       return unwrap("get roadmap", res);
     },
+    // ─── Client portal ────────────────────────────────────────────────────
+    /**
+     * Composite snapshot that backs the per-project client portal page. Wraps
+     * the roadmap with project identity + PM contact + a single `lastUpdated`
+     * timestamp. Auth-only (any @meltstudio.co JWT) in v1; the external-auth
+     * variant will mount on a different route with the same response shape.
+     */
+    async getPortal(projectId) {
+      const res = await apiFetch(config, `/pm/projects/${projectId}/portal`);
+      return unwrap("get portal", res);
+    },
+    /**
+     * Fire-and-forget portal view log. Called once per page mount from the
+     * dashboard. The server stamps `viewer_email` from the JWT, so the only
+     * thing the client supplies is the project id.
+     */
+    async logPortalView(projectId) {
+      const res = await apiFetch(config, `/pm/projects/${projectId}/portal-view`, { method: "POST" });
+      return unwrap("log portal view", res, 201);
+    },
     // ─── Project settings ─────────────────────────────────────────────────
     async getProjectSettings(projectId) {
       const res = await apiFetch(config, `/pm/project-settings/${projectId}`);
@@ -3996,6 +4016,26 @@ function createPmResource2(config) {
       const res = await apiFetch2(config, `/pm/projects/${projectId}/roadmap`);
       return unwrap2("get roadmap", res);
     },
+    // ─── Client portal ────────────────────────────────────────────────────
+    /**
+     * Composite snapshot that backs the per-project client portal page. Wraps
+     * the roadmap with project identity + PM contact + a single `lastUpdated`
+     * timestamp. Auth-only (any @meltstudio.co JWT) in v1; the external-auth
+     * variant will mount on a different route with the same response shape.
+     */
+    async getPortal(projectId) {
+      const res = await apiFetch2(config, `/pm/projects/${projectId}/portal`);
+      return unwrap2("get portal", res);
+    },
+    /**
+     * Fire-and-forget portal view log. Called once per page mount from the
+     * dashboard. The server stamps `viewer_email` from the JWT, so the only
+     * thing the client supplies is the project id.
+     */
+    async logPortalView(projectId) {
+      const res = await apiFetch2(config, `/pm/projects/${projectId}/portal-view`, { method: "POST" });
+      return unwrap2("log portal view", res, 201);
+    },
     // ─── Project settings ─────────────────────────────────────────────────
     async getProjectSettings(projectId) {
       const res = await apiFetch2(config, `/pm/project-settings/${projectId}`);
@@ -4729,7 +4769,7 @@ function registerProjectTools(server, getClient2) {
     "get_project_settings",
     {
       title: "Get project settings",
-      description: 'Returns the project\'s PM-skills settings: cadence (weekly/biweekly/monthly), start_day, demo_day, team_size, velocity_override, Linear workspace, Notion URLs, code repo path, tech-support contact, default language, project glossary, project stage. Includes a `warnings` array flagging settings whose absence breaks downstream behavior (e.g., "calculator: missing teamSize"). Returns sensible defaults if no settings row exists yet (cadence=weekly, start_day=Monday, demo_day=Friday, defaultLanguage=English).',
+      description: 'Returns the project\'s PM-skills settings: cadence (weekly/biweekly/monthly), start_day, demo_day, team_size, velocity_override, Linear workspace, Notion URLs, code repo path, tech-support contact, default language, project glossary, project stage, default jump duration weeks. Includes a `warnings` array flagging settings whose absence breaks downstream behavior (e.g., "calculator: missing teamSize"). Returns sensible defaults if no settings row exists yet (cadence=weekly, start_day=Monday, demo_day=Friday, defaultLanguage=English, defaultJumpDurationWeeks=1).',
       inputSchema: {
         projectId: z22.number().int().positive().describe("Strapi project id from list_projects.")
       }
@@ -4765,6 +4805,9 @@ function registerProjectTools(server, getClient2) {
         projectGlossary: z22.string().nullable().optional().describe(
           "Free-text project glossary surfaced to skills as context. Pass null to clear."
         ),
+        defaultJumpDurationWeeks: z22.number().positive().optional().describe(
+          "Project-wide default weeks per maturity jump. New phases inherit this on insert; PMs override per phase via update_phase. Used by the maturity-jumps calculator: total_jumps \xD7 jumpDurationWeeks \xD7 teamSize = total_weeks. Tighter values (0.25-0.5) model fast iteration; longer values (2-3) model robust hardening. NOT NULL with default 1; omit to leave the existing value in place."
+        ),
         projectStage: z22.enum(PROJECT_STAGE_VALUES).nullable().optional().describe(
           "Canonical PM-owned project stage that drives audit calibration: prototype | early_revenue | growth | scale. The server stamps projectStageSetBy + projectStageSetAt automatically. Pass null to clear."
         )
@@ -4817,7 +4860,8 @@ var createPhaseInputSchema = z3.object({
   targetShape: z3.enum(SHAPE_VALUES).default("walking"),
   isPrimary: z3.boolean().optional(),
   createdAt: z3.string().datetime().optional(),
-  closedAt: z3.string().datetime().nullable().optional()
+  closedAt: z3.string().datetime().nullable().optional(),
+  jumpDurationWeeks: z3.number().positive().optional()
 });
 function registerPhaseTools(server, getClient2) {
   server.registerTool(
@@ -4849,6 +4893,9 @@ function registerPhaseTools(server, getClient2) {
         ),
         closedAt: z3.string().datetime().nullable().optional().describe(
           "ISO 8601 timestamp. When set, the phase is created as historical (isActive=false, isPrimary=false). Use to backfill phases that closed months ago."
+        ),
+        jumpDurationWeeks: z3.number().positive().optional().describe(
+          "Override the project default jump duration for this phase, in weeks. Tighter (0.25-0.5) for fast iteration / proof-of-concept; longer (2-3) for hardening. Omit to inherit pm_project_settings.defaultJumpDurationWeeks."
         )
       }
     },
@@ -4886,6 +4933,9 @@ function registerPhaseTools(server, getClient2) {
         ),
         closedAt: z3.string().datetime().nullable().optional().describe(
           "ISO 8601 timestamp or null. When set non-null, forces isActive=false + isPrimary=false. When null, clears the closed-at stamp."
+        ),
+        jumpDurationWeeks: z3.number().positive().optional().describe(
+          "Override the project default jump duration for this phase, in weeks. Tighter (0.25-0.5) for fast iteration / proof-of-concept; longer (2-3) for hardening. The audit will eventually flag mismatches between jump duration and per-feature target stages."
         )
       }
     },

package/package.json

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