@meltstudio/meltctl 5.18.0 → 5.19.0

package/dist/index.js

@@ -7450,7 +7450,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/utils/version.ts"() {
     "use strict";
-    CLI_VERSION = "5.18.0";
+    CLI_VERSION = "5.19.0";
   }
 });
 
@@ -27403,8 +27403,14 @@ function createPmResource(config2) {
       });
       return unwrap("promote scenario", res);
     },
-    async assignFeature(phaseId, featureId) {
-      const res = await apiFetch(config2, `/pm/phases/${phaseId}/features`, { method: "POST", body: JSON.stringify({ featureId }) });
+    /**
+     * Add a feature to a phase, optionally authoring the per-phase intent in
+     * the same call (#611). Omitting `init` keeps the historical behaviour —
+     * the membership takes the schema defaults (target `mv`, placeholder
+     * scope) and the PM refines later via {@link updatePhaseFeature}.
+     */
+    async assignFeature(phaseId, featureId, init) {
+      const res = await apiFetch(config2, `/pm/phases/${phaseId}/features`, { method: "POST", body: JSON.stringify({ featureId, ...init }) });
       return unwrap("assign feature", res, 201);
     },
     async unassignFeature(phaseId, featureId) {
@@ -54055,8 +54061,14 @@ function createPmResource2(config2) {
       });
       return unwrap2("promote scenario", res);
     },
-    async assignFeature(phaseId, featureId) {
-      const res = await apiFetch2(config2, `/pm/phases/${phaseId}/features`, { method: "POST", body: JSON.stringify({ featureId }) });
+    /**
+     * Add a feature to a phase, optionally authoring the per-phase intent in
+     * the same call (#611). Omitting `init` keeps the historical behaviour —
+     * the membership takes the schema defaults (target `mv`, placeholder
+     * scope) and the PM refines later via {@link updatePhaseFeature}.
+     */
+    async assignFeature(phaseId, featureId, init) {
+      const res = await apiFetch2(config2, `/pm/phases/${phaseId}/features`, { method: "POST", body: JSON.stringify({ featureId, ...init }) });
       return unwrap2("assign feature", res, 201);
     },
     async unassignFeature(phaseId, featureId) {
@@ -55358,7 +55370,8 @@ async function deletePhase(client, input) {
   });
 }
 async function assignFeatureToPhase(client, input) {
-  return safe(() => client.pm.assignFeature(input.phaseId, input.featureId));
+  const { phaseId, featureId, ...init } = input;
+  return safe(() => client.pm.assignFeature(phaseId, featureId, init));
 }
 async function unassignFeatureFromPhase(client, input) {
   return safe(() => client.pm.unassignFeature(input.phaseId, input.featureId));
@@ -55474,10 +55487,19 @@ Mandatory caller behavior: present the phase's name + id + active/closed status
     "assign_feature_to_phase",
     {
       title: "Assign feature to phase",
-      description: "Adds an existing feature to an existing phase. Captures the feature's current_stage as a stage_snapshot at join time \u2014 closed phases keep the snapshot they ended at, even if the feature later progresses. The feature and phase must belong to the same project. Returns the membership row.",
+      description: "Adds an existing feature to an existing phase, and is where the per-phase INTENT should be authored. A feature can sit in several phases, so what matters is which SLICE of it this phase builds \u2014 set targetStage and phaseDescription here rather than leaving the defaults for a follow-up update_phase_feature call. Left unset they fall back to target 'mv' and the placeholder 'PM to refine', which renders on the roadmap as an unscoped row the PM has to come back and fix. Captures the feature's current_stage as a stage_snapshot at join time \u2014 closed phases keep the snapshot they ended at, even if the feature later progresses. The feature and phase must belong to the same project. Returns the membership row.",
       inputSchema: {
         phaseId: external_exports.string().uuid().describe("Phase id from list_phases or create_phase."),
-        featureId: external_exports.string().uuid().describe("Feature id from list_features or create_feature.")
+        featureId: external_exports.string().uuid().describe("Feature id from list_features or create_feature."),
+        targetStage: external_exports.enum(STAGE_VALUES).optional().describe(
+          "Per-phase target stage \u2014 what THIS phase brings the feature to, which is usually not its eventual target (e.g. 'pt' in an early phase, 'mv' in a later one). 7-stage enum (idea | poc | pt | mv | mk | ma | mbi). Defaults to 'mv' when omitted."
+        ),
+        phaseDescription: external_exports.string().min(1).optional().describe(
+          "Per-phase scope: which part of the feature this phase builds, in PM voice \u2014 e.g. 'Core: email/password auth' in one phase and 'Extended: Google + Apple SSO, magic-link spike' in the next. Shown on the roadmap board and the client portal under the feature name, so write it for the client to read. Defaults to the 'PM to refine' placeholder when omitted."
+        ),
+        force: external_exports.boolean().optional().describe(
+          "Required (true) only when setting targetStage on a membership in a LOCKED phase (state active/proposed) \u2014 that moves every downstream planning baseline. Plain assigns never need it."
+        )
       }
     },
     withClientArgs(getClient2, assignFeatureToPhase)
@@ -55498,7 +55520,7 @@ Mandatory caller behavior: present the phase's name + id + active/closed status
     "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), status (per-phase status \u2014 a feature can be done in one phase and in_progress in another). The same feature can have different per-phase values across phases. 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. Editing a membership in a LOCKED phase (state active/proposed) requires force=true.",
+      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), status (per-phase status \u2014 a feature can be done in one phase and in_progress in another). The same feature can have different per-phase values across phases. Use to REVISE a membership \u2014 the initial targetStage and phaseDescription are better set on assign_feature_to_phase, in one call. 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. Editing a membership in a LOCKED phase (state active/proposed) requires force=true.",
       inputSchema: {
         phaseId: external_exports.string().uuid().describe("Phase id from list_phases."),
         featureId: external_exports.string().uuid().describe("Feature id of the membership to edit."),
@@ -55506,7 +55528,7 @@ Mandatory caller behavior: present the phase's name + id + active/closed status
           "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: external_exports.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'."
+          "Per-phase scope in PM voice: which part of the feature this phase builds / what it should be doing once this phase's jump lands. Shown on the roadmap board and the client portal under the feature name. New memberships default to the 'PM to refine' placeholder."
         ),
         linearEpicUrl: external_exports.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."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "5.18.0",
+  "version": "5.19.0",
   "description": "AI-first development tooling for Melt teams — companion CLI for the org-distributed Claude Code dev skills",
   "main": "dist/index.js",
   "type": "module",