@meltstudio/meltctl 4.158.0 → 4.160.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.158.0";
+    CLI_VERSION = "4.160.0";
   }
 });
 
@@ -1062,6 +1062,15 @@ function createPmResource(config) {
       const res = await apiFetch(config, `/pm/phases/${phaseId}/features/${featureId}`, { method: "DELETE" });
       unwrap("unassign feature", res);
     },
+    /**
+     * Patch the per-phase intent for a feature in a phase (#446 stage 2).
+     * Edits the through-table row's `targetStage`, `phaseDescription`, and/or
+     * `linearEpicUrl`. Server returns the updated membership row.
+     */
+    async updatePhaseFeature(phaseId, featureId, patch) {
+      const res = await apiFetch(config, `/pm/phases/${phaseId}/features/${featureId}`, { method: "PATCH", body: JSON.stringify(patch) });
+      return unwrap("update phase feature", res);
+    },
     // ─── Roadmap ──────────────────────────────────────────────────────────
     async getRoadmap(projectId) {
       const res = await apiFetch(config, `/pm/projects/${projectId}/roadmap`);
@@ -4011,6 +4020,15 @@ function createPmResource2(config) {
       const res = await apiFetch2(config, `/pm/phases/${phaseId}/features/${featureId}`, { method: "DELETE" });
       unwrap2("unassign feature", res);
     },
+    /**
+     * Patch the per-phase intent for a feature in a phase (#446 stage 2).
+     * Edits the through-table row's `targetStage`, `phaseDescription`, and/or
+     * `linearEpicUrl`. Server returns the updated membership row.
+     */
+    async updatePhaseFeature(phaseId, featureId, patch) {
+      const res = await apiFetch2(config, `/pm/phases/${phaseId}/features/${featureId}`, { method: "PATCH", body: JSON.stringify(patch) });
+      return unwrap2("update phase feature", res);
+    },
     // ─── Roadmap ──────────────────────────────────────────────────────────
     async getRoadmap(projectId) {
       const res = await apiFetch2(config, `/pm/projects/${projectId}/roadmap`);
@@ -4769,7 +4787,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.")
       }
@@ -4805,6 +4823,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."
         )
@@ -4826,6 +4847,7 @@ function registerProjectTools(server, getClient2) {
 }
 var SHAPE_VALUES = ["crawling", "walking", "running"];
 var SHAPE_DESC = "crawling | walking | running. Target shape is intent (PM sets when creating); current shape is computed from feature stages.";
+var STAGE_VALUES = ["idea", "poc", "pt", "mv", "mk", "ma", "mbi"];
 async function listPhases(client, input3) {
   return safe(() => client.pm.listPhases(input3.projectId, input3.includeClosed ?? false));
 }
@@ -4851,13 +4873,18 @@ async function assignFeatureToPhase(client, input3) {
 async function unassignFeatureFromPhase(client, input3) {
   return safe(() => client.pm.unassignFeature(input3.phaseId, input3.featureId));
 }
+async function updatePhaseFeature(client, input3) {
+  const { phaseId, featureId, ...patch } = input3;
+  return safe(() => client.pm.updatePhaseFeature(phaseId, featureId, patch));
+}
 var createPhaseInputSchema = z3.object({
   projectId: z3.number().int().positive(),
   name: z3.string().min(1),
   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(
@@ -4889,6 +4916,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."
         )
       }
     },
@@ -4926,6 +4956,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."
         )
       }
     },
@@ -4968,9 +5001,38 @@ Mandatory caller behavior: present the phase's name + id + active/closed status
     },
     withClientArgs(getClient2, unassignFeatureFromPhase)
   );
+  server.registerTool(
+    "update_phase_feature",
+    {
+      title: "Update phase-feature membership",
+      description: "Edits the per-phase intent for a feature in a phase: targetStage (what this phase aims to bring the feature to), phaseDescription (PM-authored note about what this jump means in this phase), linearEpicUrl (per-phase Linear epic). The same feature can have different per-phase targets \u2014 e.g. 'prototype' in phase 1, 'MVP' in phase 2. Use after assign_feature_to_phase when the PM wants per-membership values different from the feature-row defaults. The PM should review the proposed change before this is called \u2014 this is a write operation. Pass linearEpicUrl=null to clear the per-phase Linear link.",
+      inputSchema: {
+        phaseId: z3.string().uuid().describe("Phase id from list_phases."),
+        featureId: z3.string().uuid().describe("Feature id of the membership to edit."),
+        targetStage: z3.enum(STAGE_VALUES).optional().describe(
+          "Per-phase target stage. What this phase aims to bring the feature to \u2014 e.g. 'pt' for prototype in an early phase, 'mv' for MVP in a later one. 7-stage enum (idea | poc | pt | mv | mk | ma | mbi)."
+        ),
+        phaseDescription: z3.string().min(1).optional().describe(
+          "One-line PM-voice note: what should this feature be doing once this phase's jump lands. New memberships default to 'PM to refine'."
+        ),
+        linearEpicUrl: z3.string().url().nullable().optional().describe(
+          "Per-phase Linear epic URL. Each phase's work on a feature can be its own epic. Pass null to clear."
+        )
+      }
+    },
+    withClientArgs(getClient2, updatePhaseFeature)
+  );
 }
-var STAGE_VALUES = ["idea", "poc", "pt", "mv", "mk", "ma", "mbi"];
+var STAGE_VALUES2 = ["idea", "poc", "pt", "mv", "mk", "ma", "mbi"];
 var STAGE_DESC = "idea | poc | pt | mv | mk | ma | mbi. The 7 maturity stages from the workflow doc \u2014 pick the one that matches where the work *looks like* it is right now (or where it should land for target).";
+var STARTING_POINT_VALUES = [
+  "unknown",
+  "starter_kit",
+  "saas",
+  "oss_library",
+  "from_scratch"
+];
+var STARTING_POINT_DESC = "unknown | starter_kit | saas | oss_library | from_scratch. The feature's technical starting point. Drives audit calibration \u2014 a feature backed by SaaS (Stripe, Auth0) gets to MVP in one jump; one built from scratch needs more. starter_kit is called out specially in audits + portal as a Melt differentiator. Default 'unknown' for historical features where the starting point is genuinely not known \u2014 downstream consumers treat 'unknown' as 'skip this dimension', not 'from scratch'.";
 var PRD_PATH_DESC = "http(s) URL pointing to the PRD (Notion, Google Doc, etc.). Omit if there is no PRD yet \u2014 relative paths or plain text are rejected.";
 async function listFeatures(client, input3) {
   const { projectId, ...filters } = input3;
@@ -4998,8 +5060,9 @@ var createFeatureInputSchema = z4.object({
   category: z4.string().min(1),
   description: z4.string().optional(),
   prdPath: z4.string().url().optional(),
-  currentStage: z4.enum(STAGE_VALUES).optional(),
-  targetStage: z4.enum(STAGE_VALUES).optional(),
+  currentStage: z4.enum(STAGE_VALUES2).optional(),
+  targetStage: z4.enum(STAGE_VALUES2).optional(),
+  startingPoint: z4.enum(STARTING_POINT_VALUES).optional(),
   status: z4.string().optional(),
   clientNotes: z4.string().optional(),
   createdAt: z4.string().datetime().optional(),
@@ -5012,8 +5075,9 @@ var updateFeatureInputSchema = z4.object({
   category: z4.string().min(1).optional(),
   description: z4.string().optional(),
   prdPath: z4.string().url().optional(),
-  currentStage: z4.enum(STAGE_VALUES).optional(),
-  targetStage: z4.enum(STAGE_VALUES).optional(),
+  currentStage: z4.enum(STAGE_VALUES2).optional(),
+  targetStage: z4.enum(STAGE_VALUES2).optional(),
+  startingPoint: z4.enum(STARTING_POINT_VALUES).optional(),
   status: z4.string().optional(),
   clientNotes: z4.string().optional(),
   linearEpicUrl: z4.string().url().nullable().optional()
@@ -5029,8 +5093,8 @@ function registerFeatureTools(server, getClient2) {
         phaseId: z4.string().uuid().optional().describe("Limit to features assigned to this phase (phase_features join)."),
         status: z4.string().optional().describe("Filter by status \u2014 typically not_started / in_progress / done."),
         category: z4.string().optional().describe("Filter by roadmap category, exact match."),
-        currentStage: z4.enum(STAGE_VALUES).optional().describe("Filter by current_stage."),
-        targetStage: z4.enum(STAGE_VALUES).optional().describe("Filter by target_stage.")
+        currentStage: z4.enum(STAGE_VALUES2).optional().describe("Filter by current_stage."),
+        targetStage: z4.enum(STAGE_VALUES2).optional().describe("Filter by target_stage.")
       }
     },
     withClientArgs(getClient2, listFeatures)
@@ -5046,8 +5110,9 @@ function registerFeatureTools(server, getClient2) {
         category: z4.string().min(1).describe('Roadmap grouping, e.g. "Frontend & UI", "API & Data", "Ops".'),
         description: z4.string().optional().describe("One-sentence summary for the roadmap row."),
         prdPath: z4.string().url().optional().describe(PRD_PATH_DESC),
-        currentStage: z4.enum(STAGE_VALUES).optional().describe(`Default idea. ${STAGE_DESC}`),
-        targetStage: z4.enum(STAGE_VALUES).optional().describe(`Default mv. ${STAGE_DESC}`),
+        currentStage: z4.enum(STAGE_VALUES2).optional().describe(`Default idea. ${STAGE_DESC}`),
+        targetStage: z4.enum(STAGE_VALUES2).optional().describe(`Default mv. ${STAGE_DESC}`),
+        startingPoint: z4.enum(STARTING_POINT_VALUES).optional().describe(`Default unknown. ${STARTING_POINT_DESC}`),
         status: z4.string().optional().describe("Default not_started. Common values: not_started, in_progress, done."),
         clientNotes: z4.string().optional().describe("Free-text. What blockers from the client side, if any."),
         createdAt: z4.string().datetime().optional().describe(
@@ -5096,8 +5161,9 @@ Mandatory caller behavior: present the feature's name + id + every phase it curr
         category: z4.string().min(1).optional(),
         description: z4.string().optional(),
         prdPath: z4.string().url().optional().describe(PRD_PATH_DESC),
-        currentStage: z4.enum(STAGE_VALUES).optional().describe(STAGE_DESC),
-        targetStage: z4.enum(STAGE_VALUES).optional().describe(STAGE_DESC),
+        currentStage: z4.enum(STAGE_VALUES2).optional().describe(STAGE_DESC),
+        targetStage: z4.enum(STAGE_VALUES2).optional().describe(STAGE_DESC),
+        startingPoint: z4.enum(STARTING_POINT_VALUES).optional().describe(STARTING_POINT_DESC),
         status: z4.string().optional().describe("Common values: not_started, in_progress, done."),
         clientNotes: z4.string().optional(),
         linearEpicUrl: z4.string().url().nullable().optional().describe(

package/package.json

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