@meltstudio/meltctl 4.159.0 → 4.161.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.159.0";
+    CLI_VERSION = "4.161.0";
   }
 });
 
@@ -954,8 +954,6 @@ function createPmResource(config) {
         params.set("category", filters.category);
       if (filters?.currentStage)
         params.set("currentStage", filters.currentStage);
-      if (filters?.targetStage)
-        params.set("targetStage", filters.targetStage);
       const res = await apiFetch(config, `/pm/features?${params}`);
       return unwrap("list features", res);
     },
@@ -1062,6 +1060,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`);
@@ -3903,8 +3910,6 @@ function createPmResource2(config) {
         params.set("category", filters.category);
       if (filters?.currentStage)
         params.set("currentStage", filters.currentStage);
-      if (filters?.targetStage)
-        params.set("targetStage", filters.targetStage);
       const res = await apiFetch2(config, `/pm/features?${params}`);
       return unwrap2("list features", res);
     },
@@ -4011,6 +4016,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`);
@@ -4829,6 +4843,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));
 }
@@ -4854,6 +4869,10 @@ 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),
@@ -4978,9 +4997,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;
@@ -5008,8 +5056,8 @@ 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(),
+  startingPoint: z4.enum(STARTING_POINT_VALUES).optional(),
   status: z4.string().optional(),
   clientNotes: z4.string().optional(),
   createdAt: z4.string().datetime().optional(),
@@ -5022,25 +5070,23 @@ 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(),
+  startingPoint: z4.enum(STARTING_POINT_VALUES).optional(),
   status: z4.string().optional(),
-  clientNotes: z4.string().optional(),
-  linearEpicUrl: z4.string().url().nullable().optional()
+  clientNotes: z4.string().optional()
 });
 function registerFeatureTools(server, getClient2) {
   server.registerTool(
     "list_features",
     {
       title: "List features",
-      description: "Lists features on the project. Each entry has id, name, category, description, current_stage, target_stage, status, prd_path, client_notes, and Linear epic url if synced. Optional filters narrow server-side: phaseId returns only features assigned to that phase; status / category / currentStage / targetStage filter on the matching column.",
+      description: "Lists features on the project. Each entry has id, name, category, description, current_stage, status, prd_path, client_notes, and starting_point. Per-phase target stage + Linear epic live on the phase membership (see list_phases), not the feature row. Optional filters narrow server-side: phaseId returns only features assigned to that phase; status / category / currentStage filter on the matching column.",
       inputSchema: {
         projectId: z4.number().int().positive(),
         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.")
       }
     },
     withClientArgs(getClient2, listFeatures)
@@ -5056,8 +5102,8 @@ 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}`),
+        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(
@@ -5099,20 +5145,17 @@ Mandatory caller behavior: present the feature's name + id + every phase it curr
     "update_feature",
     {
       title: "Update feature",
-      description: "Patches fields on an existing feature. Pass only the fields you want to change. Common uses: advancing current_stage as work progresses, flipping status to in_progress/done, wiring linearEpicUrl after the Linear epic exists. The PM should review the proposed change before this is called \u2014 this is a write operation. Pass linearEpicUrl=null to clear the Linear link.",
+      description: "Patches fields on an existing feature. Pass only the fields you want to change. Common uses: advancing current_stage as work progresses, flipping status to in_progress/done, setting starting_point. The PM should review the proposed change before this is called \u2014 this is a write operation. Per-phase target stage + Linear epic are NOT set here \u2014 they live on the phase membership; use update_phase_feature for those.",
       inputSchema: {
         id: z4.string().uuid().describe("Feature id from list_features or create_feature."),
         name: z4.string().min(1).optional(),
         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),
+        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(
-          "Linear epic URL for the feature. Pass null to clear. Setting this also marks the feature as synced (synced_to_linear_at = now); clearing it also clears that timestamp."
-        )
+        clientNotes: z4.string().optional()
       }
     },
     withClientArgs(getClient2, updateFeature)

package/package.json

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