@unified-product-graph/mcp-server 0.8.8 → 0.8.9

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `@unified-product-graph/mcp-server` are documented in this file. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.8.9] - 2026-06-03
+
+### Added
+- `apply_framework` accepts `slot_roles` (entity id to role); `score_entity` accepts `slot_role` (Phase 3b-2), validated against the framework's declared slot roles.
+
+### Changed
+- Bundles core 0.8.9 (scoring_lens to scoring_method rename; slot_role on the exercise edge).
+
 ## [0.8.8] - 2026-06-03
 
 ### Added

package/TOOLS.md

@@ -1410,12 +1410,13 @@ Apply a framework (MoSCoW, RICE, Kano, ...) to a set of entities: creates a fram
 | ---- | ---- | -------- | ----------- |
 | `entity_ids` | array |  | Entities to pull into the exercise (any type). |
 | `framework_id` | string | ✓ | Required. UPGFramework.id (e.g. "moscow", "rice-scoring"). |
+| `slot_roles` | object |  | Optional map of entity id → framework slot role (e.g. { "feat_x": "pain_reliever" }), stamped onto each entity's includes edge. Validated against the framework's declared slot roles (warn-only). |
 | `status` | string |  | Lifecycle phase: draft \| active \| archived (default draft). |
 | `title` | string |  | Human label for the exercise (default "<Framework> exercise"). |
 
 **Returns:**
 
-JSON: `{ exercise_id, exercise, included: [{ edge_id, entity_id, edge_type }], warnings }`
+JSON: `{ exercise_id, exercise, included: [{ edge_id, entity_id, edge_type, slot_role? }], warnings }`
 (the shared cross-surface envelope; identical to CLI `apply --json`).
 
 **Throws:**
@@ -2359,7 +2360,8 @@ Record a framework's result for one entity on the exercise's includes edge (a Mo
 | `entity_id` | string | ✓ | Required. The entity being scored. |
 | `exercise_id` | string | ✓ | Required. The framework_exercise id. |
 | `replace` | boolean |  | Replace the edge properties instead of merging (default false). |
-| `values` | object | ✓ | Required. The result as { input: value }, e.g. { "moscow": "must" } or { "reach": 800, "impact": 3 }. |
+| `slot_role` | string |  | Optional framework slot role this entity plays (e.g. "pain_reliever"). Rides the same edge as the scores; validated against the framework's declared slot roles (warn-only). |
+| `values` | object | ✓ | Required. The result as { input: value }, e.g. { "moscow": "must" } or { "reach": 4, "impact": 3 }. |
 
 **Returns:**
 

package/dist/index.js

@@ -12521,7 +12521,7 @@ var UPG_FRAMEWORKS = [
           "format": "number"
         }
       ],
-      "scoring_lens": {
+      "scoring_method": {
         "applies_to": [
           "feature",
           "opportunity",
@@ -12864,7 +12864,7 @@ var UPG_FRAMEWORKS = [
           "format": "number"
         }
       ],
-      "scoring_lens": {
+      "scoring_method": {
         "applies_to": [
           "feature"
         ],
@@ -14981,7 +14981,7 @@ var UPG_FRAMEWORKS = [
           "format": "number"
         }
       ],
-      "scoring_lens": {
+      "scoring_method": {
         "applies_to": [
           "risk"
         ],
@@ -15246,7 +15246,7 @@ var UPG_FRAMEWORKS = [
           "format": "number"
         }
       ],
-      "scoring_lens": {
+      "scoring_method": {
         "applies_to": [
           "feature",
           "opportunity",
@@ -15502,7 +15502,7 @@ var UPG_FRAMEWORKS = [
           "format": "number"
         }
       ],
-      "scoring_lens": {
+      "scoring_method": {
         "applies_to": [
           "feature",
           "opportunity"
@@ -15739,7 +15739,7 @@ var UPG_FRAMEWORKS = [
           "format": "number"
         }
       ],
-      "scoring_lens": {
+      "scoring_method": {
         "applies_to": [
           "feature",
           "opportunity"
@@ -24365,7 +24365,7 @@ function serializePortfolioWithHeader(doc, opts) {
   header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
   return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
 }
-var UPG_VERSION = "0.8.7";
+var UPG_VERSION = "0.8.9";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
 var UPG_TYPES_SET = new Set(UPG_TYPES);
@@ -26892,6 +26892,7 @@ var applyFramework = (args, ctx) => {
       framework_id: frameworkId,
       title: args.title,
       entity_ids: args.entity_ids ?? [],
+      slot_roles: args.slot_roles,
       status: args.status
     });
     return text(JSON.stringify(applyFrameworkEnvelope(result), null, 2));
@@ -26915,6 +26916,7 @@ var scoreEntity = (args, ctx) => {
     exercise_id: exerciseId,
     entity_id: entityId,
     values,
+    slot_role: args.slot_role,
     replace: args.replace
   });
   if ("error" in result) return textError(result.error);
@@ -29299,6 +29301,7 @@ var TOOL_DEFINITIONS = [
         framework_id: { type: "string", description: 'Required. UPGFramework.id (e.g. "moscow", "rice-scoring").' },
         title: { type: "string", description: 'Human label for the exercise (default "<Framework> exercise").' },
         entity_ids: { type: "array", items: { type: "string" }, description: "Entities to pull into the exercise (any type)." },
+        slot_roles: { type: "object", description: `Optional map of entity id \u2192 framework slot role (e.g. { "feat_x": "pain_reliever" }), stamped onto each entity's includes edge. Validated against the framework's declared slot roles (warn-only).` },
         status: { type: "string", description: "Lifecycle phase: draft | active | archived (default draft)." }
       },
       required: ["framework_id"]
@@ -29312,7 +29315,8 @@ var TOOL_DEFINITIONS = [
       properties: {
         exercise_id: { type: "string", description: "Required. The framework_exercise id." },
         entity_id: { type: "string", description: "Required. The entity being scored." },
-        values: { type: "object", description: 'Required. The result as { input: value }, e.g. { "moscow": "must" } or { "reach": 800, "impact": 3 }.' },
+        values: { type: "object", description: 'Required. The result as { input: value }, e.g. { "moscow": "must" } or { "reach": 4, "impact": 3 }.' },
+        slot_role: { type: "string", description: `Optional framework slot role this entity plays (e.g. "pain_reliever"). Rides the same edge as the scores; validated against the framework's declared slot roles (warn-only).` },
         replace: { type: "boolean", description: "Replace the edge properties instead of merging (default false)." }
       },
       required: ["exercise_id", "entity_id", "values"]