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

package/dist/index.js

@@ -7923,7 +7923,6 @@ function migrateStatusValue(entityType, currentStatus) {
   if (!typeMap) return null;
   return typeMap[currentStatus] ?? null;
 }
-var crossProductEdgeTypeSet = new Set(UPG_CROSS_EDGE_TYPES);
 var UPG_PROPERTY_SCHEMA = {
   // A11yAnnotationProperties: Accessibility annotation.
   a11y_annotation: {
@@ -11297,31 +11296,37 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Customer Jobs",
+        "role": "customer_job",
         "entityTypeId": "job",
         "description": "Place job entities in the Customer Jobs position of the matrix"
       },
       {
         "label": "Pains",
+        "role": "pain",
         "entityTypeId": "need",
         "description": "Place need entities in the Pains position of the matrix"
       },
       {
         "label": "Gains",
+        "role": "gain",
         "entityTypeId": "desired_outcome",
         "description": "Place desired outcome entities in the Gains position of the matrix"
       },
       {
         "label": "Products & Services",
+        "role": "product_or_service",
         "entityTypeId": "feature",
         "description": "Place feature entities in the Products & Services position of the matrix"
       },
       {
         "label": "Pain Relievers",
+        "role": "pain_reliever",
         "entityTypeId": "feature",
         "description": "Place feature entities in the Pain Relievers position of the matrix"
       },
       {
         "label": "Gain Creators",
+        "role": "gain_creator",
         "entityTypeId": "feature",
         "description": "Place feature entities in the Gain Creators position of the matrix"
       }
@@ -11950,26 +11955,31 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Competitive Rivalry",
+        "role": "competitive_rivalry",
         "entityTypeId": "competitor",
         "description": "Intensity of competition among existing players"
       },
       {
         "label": "Threat of New Entrants",
+        "role": "new_entrants",
         "entityTypeId": "competitor",
         "description": "How easy is it for new competitors to enter?"
       },
       {
         "label": "Threat of Substitutes",
+        "role": "substitutes",
         "entityTypeId": "competitor",
         "description": "Can customers switch to alternatives?"
       },
       {
         "label": "Buyer Power",
+        "role": "buyer_power",
         "entityTypeId": "persona",
         "description": "How much leverage do buyers have?"
       },
       {
         "label": "Supplier Power",
+        "role": "supplier_power",
         "entityTypeId": "persona",
         "description": "How much leverage do suppliers have?"
       }
@@ -12137,31 +12147,37 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Inbound Logistics",
+        "role": "inbound_logistics",
         "entityTypeId": "key_activity",
         "description": "Inbound Logistics phase: key activity entities move through this stage"
       },
       {
         "label": "Operations",
+        "role": "operations",
         "entityTypeId": "key_activity",
         "description": "Operations phase: key activity entities move through this stage"
       },
       {
         "label": "Outbound Logistics",
+        "role": "outbound_logistics",
         "entityTypeId": "key_activity",
         "description": "Outbound Logistics phase: key activity entities move through this stage"
       },
       {
         "label": "Marketing & Sales",
+        "role": "marketing_and_sales",
         "entityTypeId": "key_activity",
         "description": "Marketing & Sales phase: key activity entities move through this stage"
       },
       {
         "label": "Service",
+        "role": "service",
         "entityTypeId": "key_activity",
         "description": "Service phase: key activity entities move through this stage"
       },
       {
         "label": "Support Activities",
+        "role": "support_activity",
         "entityTypeId": "capability",
         "description": "Support Activities phase: capability entities move through this stage"
       }
@@ -12232,26 +12248,31 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Portfolio",
+        "role": "portfolio",
         "entityTypeId": "portfolio",
         "description": "Innovation portfolio balanced across three horizons: core performance, emerging growth, and future creation"
       },
       {
         "label": "Product",
+        "role": "product",
         "entityTypeId": "product",
         "description": "Product or business unit assigned to a horizon: H1 (defend and extend), H2 (build), or H3 (seed and explore)"
       },
       {
         "label": "Initiative",
+        "role": "initiative",
         "entityTypeId": "portfolio",
         "description": "Growth initiative positioned in a horizon, with appropriate funding model, governance, and success metrics"
       },
       {
         "label": "Product Area",
+        "role": "product_area",
         "entityTypeId": "product_area",
         "description": "Product area representing a horizon: core products (H1), adjacent expansions (H2), or experimental ventures (H3)"
       },
       {
         "label": "Capability",
+        "role": "capability",
         "entityTypeId": "capability",
         "description": "Capability needed to execute across horizons: H1 needs efficiency, H2 needs scaling, H3 needs discovery"
       }
@@ -12315,7 +12336,7 @@ var UPG_FRAMEWORKS = [
     ],
     "name": "RICE Scoring",
     "version": "1.0.0",
-    "description": "Score features and opportunities by Reach, Impact, Confidence, and Effort to produce a ranked priority list.",
+    "description": "Score features, opportunities, and needs by Reach, Impact, Confidence, and Effort to produce a ranked priority list.",
     "category": "prioritization",
     "origin": {
       "type": "practitioner",
@@ -12333,7 +12354,7 @@ var UPG_FRAMEWORKS = [
       {
         "label": "Items to score",
         "entityTypeId": "feature",
-        "description": "Features, opportunities, or solutions being evaluated"
+        "description": "Features, opportunities, or needs being evaluated"
       },
       {
         "label": "Opportunities to score",
@@ -12499,7 +12520,60 @@ var UPG_FRAMEWORKS = [
           "label": "RICE Score",
           "format": "number"
         }
-      ]
+      ],
+      "scoring_lens": {
+        "applies_to": [
+          "feature",
+          "opportunity",
+          "need"
+        ],
+        "inputs": [
+          {
+            "property": "reach",
+            "type": "assessment",
+            "scale_id": "reach_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Reach",
+            "description": "How many users will this impact per quarter?"
+          },
+          {
+            "property": "impact",
+            "type": "assessment",
+            "scale_id": "impact_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Impact",
+            "description": "How much will this impact each user, on the impact scale?"
+          },
+          {
+            "property": "confidence",
+            "type": "assessment",
+            "scale_id": "confidence_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Confidence",
+            "description": "How confident are you in the reach, impact, and effort estimates?"
+          },
+          {
+            "property": "effort",
+            "type": "assessment",
+            "scale_id": "effort_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Effort",
+            "description": "How much work is required to build and ship this, on the effort scale?"
+          }
+        ],
+        "computed": [
+          {
+            "property": "rice_score",
+            "expression": "(reach * impact * confidence) / effort",
+            "label": "RICE Score",
+            "format": "number"
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "table"
@@ -12678,21 +12752,25 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Must-haves",
+        "role": "must_have",
         "entityTypeId": "feature",
         "description": "Expected features: absence causes dissatisfaction"
       },
       {
         "label": "Performance",
+        "role": "performance",
         "entityTypeId": "feature",
         "description": "More is better: linear satisfaction increase"
       },
       {
         "label": "Delighters",
+        "role": "delighter",
         "entityTypeId": "feature",
         "description": "Unexpected features: presence creates delight"
       },
       {
         "label": "Indifferent",
+        "role": "indifferent",
         "entityTypeId": "feature",
         "description": "Features users don't care about either way"
       }
@@ -12701,7 +12779,7 @@ var UPG_FRAMEWORKS = [
       "entity_types": [
         {
           "type": "feature",
-          "role": "item"
+          "role": "scored_item"
         }
       ],
       "required_properties": {
@@ -12785,7 +12863,90 @@ var UPG_FRAMEWORKS = [
           "label": "Dissatisfaction Coefficient",
           "format": "number"
         }
-      ]
+      ],
+      "scoring_lens": {
+        "applies_to": [
+          "feature"
+        ],
+        "inputs": [
+          {
+            "property": "functional_response",
+            "type": "enum",
+            "required": true,
+            "scope": "framework",
+            "label": "Functional Response",
+            "description": "How users feel when the feature IS present",
+            "enum_values": [
+              "i_like_it",
+              "i_expect_it",
+              "i_am_neutral",
+              "i_can_tolerate_it",
+              "i_dislike_it"
+            ]
+          },
+          {
+            "property": "dysfunctional_response",
+            "type": "enum",
+            "required": true,
+            "scope": "framework",
+            "label": "Dysfunctional Response",
+            "description": "How users feel when the feature IS NOT present",
+            "enum_values": [
+              "i_like_it",
+              "i_expect_it",
+              "i_am_neutral",
+              "i_can_tolerate_it",
+              "i_dislike_it"
+            ]
+          },
+          {
+            "property": "delighter_count",
+            "type": "number",
+            "required": false,
+            "scope": "framework",
+            "label": "Delighter classifications",
+            "description": "Count of survey responses classifying this feature as a delighter (attractive)"
+          },
+          {
+            "property": "performance_count",
+            "type": "number",
+            "required": false,
+            "scope": "framework",
+            "label": "Performance classifications",
+            "description": "Count of survey responses classifying this feature as performance (one-dimensional)"
+          },
+          {
+            "property": "must_be_count",
+            "type": "number",
+            "required": false,
+            "scope": "framework",
+            "label": "Must-be classifications",
+            "description": "Count of survey responses classifying this feature as must-be (basic)"
+          },
+          {
+            "property": "indifferent_count",
+            "type": "number",
+            "required": false,
+            "scope": "framework",
+            "label": "Indifferent classifications",
+            "description": "Count of survey responses classifying this feature as indifferent"
+          }
+        ],
+        "computed": [
+          {
+            "property": "satisfaction_coefficient",
+            "expression": "(delighter_count + performance_count) / (delighter_count + performance_count + must_be_count + indifferent_count)",
+            "label": "Satisfaction Coefficient",
+            "format": "number"
+          },
+          {
+            "property": "dissatisfaction_coefficient",
+            "expression": "(must_be_count + performance_count) / (delighter_count + performance_count + must_be_count + indifferent_count) * -1",
+            "label": "Dissatisfaction Coefficient",
+            "format": "number"
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "matrix"
@@ -12840,16 +13001,19 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Now",
+        "role": "now",
         "entityTypeId": "feature",
         "description": "Committed work in progress"
       },
       {
         "label": "Next",
+        "role": "next",
         "entityTypeId": "feature",
         "description": "High-confidence upcoming work"
       },
       {
         "label": "Later",
+        "role": "later",
         "entityTypeId": "initiative",
         "description": "Exploratory, needs more discovery"
       }
@@ -13365,26 +13529,31 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Atoms",
+        "role": "atom",
         "entityTypeId": "design_component",
         "description": "Atoms: design component entities for this dimension of the framework"
       },
       {
         "label": "Molecules",
+        "role": "molecule",
         "entityTypeId": "design_component",
         "description": "Molecules: design token entities for this dimension of the framework"
       },
       {
         "label": "Organisms",
+        "role": "organism",
         "entityTypeId": "design_pattern",
         "description": "Organisms: design pattern entities for this dimension of the framework"
       },
       {
         "label": "Templates",
+        "role": "template",
         "entityTypeId": "wireframe",
         "description": "Templates: design system entities for this dimension of the framework"
       },
       {
         "label": "Pages",
+        "role": "page",
         "entityTypeId": "screen",
         "description": "Pages: screen entities for this dimension of the framework"
       }
@@ -14049,26 +14218,31 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Outer Ring",
+        "role": "outer_ring",
         "entityTypeId": "acquisition_channel",
         "description": "All 19 traction channels brainstormed"
       },
       {
         "label": "Middle Ring",
+        "role": "middle_ring",
         "entityTypeId": "acquisition_channel",
         "description": "Top 6 channels worth testing"
       },
       {
         "label": "Inner Ring",
+        "role": "inner_ring",
         "entityTypeId": "acquisition_channel",
         "description": "Top 3 channels to focus on"
       },
       {
         "label": "Traction Test",
+        "role": "traction_test",
         "entityTypeId": "growth_campaign",
         "description": "Cheap test for each channel"
       },
       {
         "label": "Bullseye Channel",
+        "role": "bullseye_channel",
         "entityTypeId": "acquisition_channel",
         "description": "The single best-performing channel"
       }
@@ -14138,26 +14312,31 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Free Entry",
+        "role": "free_entry",
         "entityTypeId": "gtm_strategy",
         "description": "How users access the product for free"
       },
       {
         "label": "Aha Moment",
+        "role": "aha_moment",
         "entityTypeId": "gtm_strategy",
         "description": "First experience of core value"
       },
       {
         "label": "Expansion Motion",
+        "role": "expansion_motion",
         "entityTypeId": "sales_motion",
         "description": "How usage spreads within accounts"
       },
       {
         "label": "Monetisation Trigger",
+        "role": "monetisation_trigger",
         "entityTypeId": "gtm_strategy",
         "description": "When and how to convert to paid"
       },
       {
         "label": "Metric",
+        "role": "metric",
         "entityTypeId": "metric",
         "description": "Key metric driving the PLG motion"
       }
@@ -14232,21 +14411,25 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Objective",
+        "role": "objective",
         "entityTypeId": "objective",
         "description": "Qualitative, inspiring goal"
       },
       {
         "label": "Key Result 1",
+        "role": "key_result",
         "entityTypeId": "key_result",
         "description": "Measurable outcome proving progress"
       },
       {
         "label": "Key Result 2",
+        "role": "key_result",
         "entityTypeId": "key_result",
         "description": "Measurable outcome proving progress"
       },
       {
         "label": "Initiatives",
+        "role": "initiative",
         "entityTypeId": "initiative",
         "description": "Work streams that drive key results"
       }
@@ -14320,26 +14503,31 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Activity",
+        "role": "activity",
         "entityTypeId": "key_activity",
         "description": "Place persona entities in the Activity position of the matrix"
       },
       {
         "label": "Responsible",
+        "role": "responsible",
         "entityTypeId": "role",
         "description": "Does the work"
       },
       {
         "label": "Accountable",
+        "role": "accountable",
         "entityTypeId": "role",
         "description": "Makes the final call"
       },
       {
         "label": "Consulted",
+        "role": "consulted",
         "entityTypeId": "role",
         "description": "Gives input"
       },
       {
         "label": "Informed",
+        "role": "informed",
         "entityTypeId": "role",
         "description": "Kept in the loop"
       }
@@ -14413,21 +14601,25 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "What Went Well",
+        "role": "went_well",
         "entityTypeId": "outcome",
         "description": "Practices to continue"
       },
       {
         "label": "What Didn't Go Well",
+        "role": "went_poorly",
         "entityTypeId": "need",
         "description": "Issues to address"
       },
       {
         "label": "Action Items",
+        "role": "action_item",
         "entityTypeId": "learning",
         "description": "Changes for next iteration"
       },
       {
         "label": "Learnings",
+        "role": "learning",
         "entityTypeId": "learning",
         "description": "Insights to carry forward"
       }
@@ -14624,7 +14816,7 @@ var UPG_FRAMEWORKS = [
       "entity_types": [
         {
           "type": "team",
-          "role": "scored_item"
+          "role": "item"
         },
         {
           "type": "retrospective",
@@ -14788,7 +14980,36 @@ var UPG_FRAMEWORKS = [
           "label": "Severity",
           "format": "number"
         }
-      ]
+      ],
+      "scoring_lens": {
+        "applies_to": [
+          "risk"
+        ],
+        "inputs": [
+          {
+            "property": "probability",
+            "type": "number",
+            "required": true,
+            "label": "Probability",
+            "description": "Likelihood the risk materialises (risk.probability assessment)"
+          },
+          {
+            "property": "impact",
+            "type": "number",
+            "required": true,
+            "label": "Impact",
+            "description": "Consequence severity if the risk materialises (risk.impact assessment)"
+          }
+        ],
+        "computed": [
+          {
+            "property": "severity",
+            "expression": "probability * impact",
+            "label": "Severity",
+            "format": "number"
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "table"
@@ -14864,31 +15085,37 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Items to score",
+        "role": "candidate",
         "entityTypeId": "feature",
         "description": "Features or experiments being evaluated"
       },
       {
         "label": "Impact",
+        "role": "impact",
         "entityTypeId": "outcome",
         "description": "How much will this move the needle?"
       },
       {
         "label": "Confidence",
+        "role": "confidence",
         "entityTypeId": "assumption",
         "description": "How sure are we about the impact?"
       },
       {
         "label": "Ease",
+        "role": "ease",
         "entityTypeId": "feature",
         "description": "How easy is this to implement?"
       },
       {
         "label": "Opportunities to score",
+        "role": "candidate",
         "entityTypeId": "opportunity",
         "description": "Opportunities scored on the same ICE Scoring inputs as features."
       },
       {
         "label": "Needs to score",
+        "role": "candidate",
         "entityTypeId": "need",
         "description": "Needs scored on the same ICE Scoring inputs as features."
       }
@@ -15018,7 +15245,48 @@ var UPG_FRAMEWORKS = [
           "label": "ICE Score",
           "format": "number"
         }
-      ]
+      ],
+      "scoring_lens": {
+        "applies_to": [
+          "feature",
+          "opportunity",
+          "need"
+        ],
+        "inputs": [
+          {
+            "property": "impact",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Impact",
+            "description": "Expected impact on the target metric (1-10)"
+          },
+          {
+            "property": "confidence",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Confidence",
+            "description": "Confidence in the impact estimate (1-10)"
+          },
+          {
+            "property": "ease",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Ease",
+            "description": "Ease of implementation (1-10)"
+          }
+        ],
+        "computed": [
+          {
+            "property": "ice_score",
+            "expression": "impact * confidence * ease",
+            "label": "ICE Score",
+            "format": "number"
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "table"
@@ -15098,31 +15366,37 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Backlog Items",
+        "role": "candidate",
         "entityTypeId": "feature",
         "description": "Backlog Items: feature entries to evaluate"
       },
       {
         "label": "User/Business Value",
+        "role": "user_business_value",
         "entityTypeId": "metric",
         "description": "User/Business Value: metric entries to evaluate"
       },
       {
         "label": "Time Criticality",
+        "role": "time_criticality",
         "entityTypeId": "metric",
         "description": "How much value decays if delivery is delayed (deadlines, competition, seasonal windows)"
       },
       {
         "label": "Risk Reduction / Opportunity Enablement",
+        "role": "risk_reduction",
         "entityTypeId": "metric",
         "description": "Risk Reduction / Opportunity Enablement: metric entries to evaluate"
       },
       {
         "label": "Job Size",
+        "role": "job_size",
         "entityTypeId": "metric",
         "description": "Estimated effort (story points, t-shirt size, or person-weeks)"
       },
       {
         "label": "Opportunities to score",
+        "role": "candidate",
         "entityTypeId": "opportunity",
         "description": "Opportunities scored on the same WSJF (Weighted Shortest Job First) inputs as features."
       }
@@ -15227,7 +15501,55 @@ var UPG_FRAMEWORKS = [
           "label": "WSJF Score",
           "format": "number"
         }
-      ]
+      ],
+      "scoring_lens": {
+        "applies_to": [
+          "feature",
+          "opportunity"
+        ],
+        "inputs": [
+          {
+            "property": "user_value",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "User/Business Value",
+            "description": "Relative value to users and the business if delivered"
+          },
+          {
+            "property": "time_criticality",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Time Criticality",
+            "description": "How much value decays if delivery is delayed (deadlines, competition, seasonal windows)"
+          },
+          {
+            "property": "risk_reduction",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Risk Reduction / Opportunity Enablement",
+            "description": "Value from reducing risk or enabling future opportunities"
+          },
+          {
+            "property": "job_size",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Job Size",
+            "description": "Estimated effort (story points, t-shirt size, or person-weeks)"
+          }
+        ],
+        "computed": [
+          {
+            "property": "wsjf_score",
+            "expression": "(user_value + time_criticality + risk_reduction) / job_size",
+            "label": "WSJF Score",
+            "format": "number"
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "table"
@@ -15300,7 +15622,7 @@ var UPG_FRAMEWORKS = [
     ],
     "name": "Cost of Delay",
     "version": "1.0.0",
-    "description": "Quantify the economic cost of not shipping a feature to drive priority decisions. Combines urgency with value.",
+    "description": "Quantify the economic cost of not shipping a feature or opportunity to drive priority decisions. Combines urgency with value.",
     "category": "prioritization",
     "origin": {
       "type": "practitioner",
@@ -15416,7 +15738,39 @@ var UPG_FRAMEWORKS = [
           "label": "WSJF Score",
           "format": "number"
         }
-      ]
+      ],
+      "scoring_lens": {
+        "applies_to": [
+          "feature",
+          "opportunity"
+        ],
+        "inputs": [
+          {
+            "property": "cost_of_delay",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Cost of Delay",
+            "description": "Weekly revenue impact of not shipping"
+          },
+          {
+            "property": "job_size",
+            "type": "number",
+            "required": true,
+            "scope": "framework",
+            "label": "Job Size",
+            "description": "Weeks of development effort"
+          }
+        ],
+        "computed": [
+          {
+            "property": "wsjf_score",
+            "expression": "cost_of_delay / job_size",
+            "label": "WSJF Score",
+            "format": "number"
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "table"
@@ -15498,16 +15852,19 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "Symptom",
+        "role": "symptom",
         "entityTypeId": "need",
         "description": "The observed problem the analysis starts from."
       },
       {
         "label": "Why chain",
+        "role": "why",
         "entityTypeId": "insight",
         "description": 'Each "why?" answer along the chain, typically five iterations deep.'
       },
       {
         "label": "Root cause",
+        "role": "root_cause",
         "entityTypeId": "insight",
         "description": "The terminal answer at the bottom of the chain: the underlying cause to address."
       }
@@ -15852,16 +16209,19 @@ var UPG_FRAMEWORKS = [
     "slots": [
       {
         "label": "First-order move",
+        "role": "first_order",
         "entityTypeId": "decision",
         "description": "The decision or move under consideration."
       },
       {
         "label": "Second-order consequences",
+        "role": "second_order",
         "entityTypeId": "insight",
         "description": "Downstream effects that follow from the first-order move."
       },
       {
         "label": "Higher-order consequences",
+        "role": "higher_order",
         "entityTypeId": "insight",
         "description": "Third-, fourth-, fifth-order ripples: second-order consequences of the second-order consequences."
       }
@@ -15920,6 +16280,7 @@ for (const fw of UPG_FRAMEWORKS) {
   if (!UPG_FRAMEWORKS_BY_CATEGORY[fw.category]) UPG_FRAMEWORKS_BY_CATEGORY[fw.category] = [];
   UPG_FRAMEWORKS_BY_CATEGORY[fw.category].push(fw);
 }
+var crossProductEdgeTypeSet = new Set(UPG_CROSS_EDGE_TYPES);
 var PRIORITY_LABELS = [
   // ── need (CONSOLIDATED: replaces pain_point + user_need) ─────────────────────
   {
@@ -24004,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.6";
+var UPG_VERSION = "0.8.7";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
 var UPG_TYPES_SET = new Set(UPG_TYPES);
@@ -24714,12 +25075,13 @@ var listNodes = (args, ctx) => {
 };
 var getNode = (args, ctx) => {
   const { store } = ctx;
-  if (!args.node_id) return textError(`Missing required parameter: node_id`);
+  const nodeId2 = args.node_id ?? args.id;
+  if (!nodeId2) return textError(`Missing required parameter: node_id (alias: id)`);
   const result = getNodeLib(store, {
-    node_id: args.node_id,
+    node_id: nodeId2,
     compact_edges: args.compact_edges ?? false
   });
-  if (!result) return textError(`Node not found: ${args.node_id}`);
+  if (!result) return textError(`Node not found: ${nodeId2}`);
   const typed = result;
   if (typed.node.properties) {
     const { unknown_properties, warning } = checkUnknownProperties(typed.node.type, typed.node.properties);
@@ -26158,7 +26520,10 @@ var listLocalProducts = (_args, _ctx) => {
 };
 var switchProduct = async (args, ctx) => {
   const { store } = ctx;
-  const fileArg = args.file;
+  const fileArg = args.file ?? args.product;
+  if (typeof fileArg !== "string" || fileArg.length === 0) {
+    return textError("Missing required parameter: file (alias: product). Pass a .upg path or a bare product name.");
+  }
   let resolved = path3.resolve(fileArg);
   if (!fs.existsSync(resolved)) {
     const cwd = process.cwd();
@@ -26513,6 +26878,7 @@ var getEntitySchema = (args, _ctx) => {
 // src/tools/frameworks.ts
 import {
   applyFramework as applyFrameworkLib,
+  applyFrameworkEnvelope,
   scoreEntity as scoreEntityLib
 } from "@unified-product-graph/sdk";
 var applyFramework = (args, ctx) => {
@@ -26528,18 +26894,7 @@ var applyFramework = (args, ctx) => {
       entity_ids: args.entity_ids ?? [],
       status: args.status
     });
-    return text(
-      JSON.stringify(
-        {
-          exercise_id: result.exercise.id,
-          exercise: result.exercise,
-          included: result.edges.map((e) => ({ edge_id: e.id, entity_id: e.target })),
-          warnings: result.warnings
-        },
-        null,
-        2
-      )
-    );
+    return text(JSON.stringify(applyFrameworkEnvelope(result), null, 2));
   } catch (err) {
     return textError(err.message);
   }
@@ -26966,9 +27321,11 @@ var validateGraph = (args, ctx) => {
     argsHint: `scope=${scope}, limit=${limit}`
   });
   if (guardOutcome.kind === "refuse") return guardOutcome.result;
-  const driftClean = skipDrift || summary.entity_drift === 0 && summary.edge_drift === 0 && summary.top_level_drift === 0 && summary.lifecycle_drift === 0 && summary.self_referential === 0 && summary.property_drift === 0 && edgeTypePairDrift.length === 0 && graphTopologySelfLoops.length === 0 && propertyTypeDrift.length === 0;
+  const structurallyClean = summary.entity_drift === 0 && summary.edge_drift === 0 && summary.top_level_drift === 0 && summary.lifecycle_drift === 0 && summary.self_referential === 0 && summary.property_drift === 0 && edgeTypePairDrift.length === 0 && graphTopologySelfLoops.length === 0 && propertyTypeDrift.length === 0;
+  const driftClean = skipDrift || structurallyClean;
   const antiPatternClean = skipAntiPatterns || (antiPatternViolations?.length ?? 0) === 0;
   const valid = driftClean && antiPatternClean;
+  const structurallyValid = skipDrift ? void 0 : structurallyClean;
   let highCount = 0;
   let mediumCount = 0;
   let lowCount = 0;
@@ -26981,6 +27338,11 @@ var validateGraph = (args, ctx) => {
   }
   const response = {
     valid,
+    // N4 (UPG QA 0.8.7): additive structural-conformance signal. true ⟺ every
+    // drift class is 0, independent of anti-pattern health. Omitted when
+    // `skip_drift` is true (structure was not assessed). A CI gate that wants
+    // "is this graph spec-shaped?" should read this, not `valid`.
+    ...structurallyValid !== void 0 ? { structurally_valid: structurallyValid } : {},
     summary: {
       ...summary,
       spec_version: UPG_VERSION,
@@ -27286,19 +27648,31 @@ var listFrameworks = (args) => {
   const slice = pool.slice(cursorOffset, cursorOffset + limit);
   const nextOffset = cursorOffset + slice.length;
   const nextCursor = nextOffset < total ? encodeCursor(nextOffset) : void 0;
+  const frameworks = slice.map((f) => ({
+    id: f.id,
+    name: f.name,
+    category: f.category,
+    description: f.description,
+    tags: f.tags,
+    approach_ids: f.approach_ids,
+    structure_pattern: f.structure?.pattern
+  }));
   const body = {
     total,
     count: slice.length,
-    frameworks: slice
+    frameworks
   };
   if (nextCursor) body.next_cursor = nextCursor;
   return text(JSON.stringify(body, null, 2));
 };
 var getFramework = (args) => {
-  const id = args.id;
-  if (!id) return textError("Missing required parameter: id");
+  const id = args.id ?? args.framework_id;
+  if (!id) return textError("Missing required parameter: id (alias: framework_id)");
   const framework = UPG_FRAMEWORKS_BY_ID[id];
-  if (!framework) return textError(`Unknown framework id: ${id}`);
+  if (!framework)
+    return textError(
+      `Unknown framework id: "${id}". Pass a framework id from the catalog (e.g. 'moscow', 'rice-scoring', 'kano-model'). See list_frameworks for the full list.`
+    );
   return text(JSON.stringify(framework, null, 2));
 };
 function buildEdgeEntries(filterSource, filterTarget) {
@@ -28264,7 +28638,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        node_id: { type: "string", description: "The node ID" },
+        node_id: { type: "string", description: "The node ID. Alias: `id`." },
+        id: { type: "string", description: "Alias for `node_id`." },
         compact_edges: { type: "boolean", description: "Omit source_title/target_title from edges (saves ~30% on edge-heavy nodes)" }
       },
       required: ["node_id"]
@@ -28706,7 +29081,11 @@ var TOOL_DEFINITIONS = [
       properties: {
         file: {
           type: "string",
-          description: "Path to the .upg file (relative, absolute, or a bare product name in workspace mode)."
+          description: "Path to the .upg file (relative, absolute, or a bare product name in workspace mode). Alias: `product`."
+        },
+        product: {
+          type: "string",
+          description: "Alias for `file`."
         }
       },
       required: ["file"]
@@ -28989,7 +29368,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "list_frameworks",
-    description: "List the canonical `UPGFramework` definitions; the 34 curated, famous product frameworks that anchor the public catalog (spanning strategy, discovery, prioritisation, design, growth, engineering, and reflection classics). Paginated (default 50, max 200). Cursor is opaque: pass `next_cursor` from a previous response. Optional `category` is exact-match against `UPGFramework.category` and applies before pagination.",
+    description: "List the canonical `UPGFramework` definitions: the curated, famous product frameworks that anchor the public catalog (spanning strategy, discovery, prioritisation, design, growth, engineering, and reflection classics). Returns a lightweight summary per framework (id, name, category, description, tags, approach_ids, structure_pattern); call `get_framework(id)` for the full record. Paginated (default 50, max 200). Cursor is opaque: pass `next_cursor` from a previous response. Optional `category` is exact-match against `UPGFramework.category` and applies before pagination.",
     inputSchema: {
       type: "object",
       properties: {
@@ -29005,7 +29384,8 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string", description: "Framework id (kebab-case)." }
+        id: { type: "string", description: "Framework id (kebab-case). Alias: `framework_id`." },
+        framework_id: { type: "string", description: "Alias for `id` (matches the key used by apply_framework / prioritise)." }
       },
       required: ["id"]
     }
@@ -29918,6 +30298,7 @@ async function runMcpServer() {
     }
   }
   const store = new UPGFileStore();
+  store.setWriter("upg-mcp-local", SERVER_VERSION);
   await store.load(resolvedPath);
   const deprecated = getDeprecatedTypes();
   const nodes = store.getAllNodes();