@unified-product-graph/mcp-server 0.8.15 → 0.9.0

package/dist/index.js

@@ -116,7 +116,7 @@ var UPG_DOMAINS = [
   {
     id: "product_spec",
     label: "Product Specification",
-    description: "What you are building and shipping. Feature areas group related capabilities. Features, epics, and user stories break work down. Acceptance criteria define done. Tasks and bugs track execution. Releases and changelogs mark what shipped. Roadmaps and roadmap items plan what comes next. Themes group strategic bets. Translates Strategy into Engineering and tracks delivery through Program Management.",
+    description: "What you are building and shipping. Feature areas group related capabilities. Features, epics, and user stories break work down. Acceptance criteria define done. Tasks and bugs track execution. Releases and changelogs mark what shipped. Roadmaps and roadmap items plan what comes next. Roadmap themes group roadmap work around the customer problem it solves, one level down from the strategic themes in Strategy. Translates Strategy into Engineering and tracks delivery through Program Management.",
     types: [
       "feature",
       "feature_area",
@@ -128,7 +128,7 @@ var UPG_DOMAINS = [
       "bug",
       "roadmap",
       "roadmap_item",
-      "theme",
+      "roadmap_theme",
       "changelog"
     ]
   },
@@ -556,8 +556,8 @@ var UPG_ENTITY_META = [
   { name: "need", type_id: "ent_313", maturity: "stable", since: "0.1.0" },
   { name: "switching_cost", type_id: "ent_022", maturity: "stable", since: "0.1.0" },
   // ── Discovery ──
-  { name: "opportunity", type_id: "ent_023", maturity: "stable", since: "0.1.0" },
-  { name: "solution", type_id: "ent_024", maturity: "stable", since: "0.1.0" },
+  { name: "opportunity", type_id: "ent_023", maturity: "stable", since: "0.1.0", default_frameworks: ["opportunity-sizing", "rice-scoring"] },
+  { name: "solution", type_id: "ent_024", maturity: "stable", since: "0.1.0", default_frameworks: ["rice-scoring"] },
   { name: "feasibility_study", type_id: "ent_025", maturity: "stable", since: "0.1.0" },
   { name: "design_sprint", type_id: "ent_026", maturity: "stable", since: "0.1.0" },
   // ── Validation ──
@@ -658,7 +658,8 @@ var UPG_ENTITY_META = [
   { name: "bug", type_id: "ent_077", maturity: "stable", since: "0.1.0" },
   { name: "roadmap", type_id: "ent_078", maturity: "stable", since: "0.1.0" },
   { name: "roadmap_item", type_id: "ent_079", maturity: "stable", since: "0.1.0" },
-  { name: "theme", type_id: "ent_080", maturity: "stable", since: "0.1.0" },
+  { name: "theme", type_id: "ent_080", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.9.0", replacement: "roadmap_theme" },
+  { name: "roadmap_theme", type_id: "ent_351", maturity: "stable", since: "0.1.0" },
   { name: "changelog", type_id: "ent_081", maturity: "stable", since: "0.1.0" },
   // ── Engineering ──
   { name: "bounded_context", type_id: "ent_082", maturity: "stable", since: "0.1.0" },
@@ -1165,6 +1166,12 @@ var UPG_EDGE_CATALOG = {
   strategic_pillar_delivers_value_stream: { forward_verb: "delivers", reverse_verb: "delivered_by", classification: "hierarchy", source_type: "strategic_pillar", target_type: "value_stream" },
   strategic_pillar_decided_via_decision: { forward_verb: "decided_via", reverse_verb: "decided_for", classification: "hierarchy", source_type: "strategic_pillar", target_type: "decision" },
   strategic_theme_pursues_initiative: { forward_verb: "pursues", reverse_verb: "pursued_under", classification: "hierarchy", source_type: "strategic_theme", target_type: "initiative" },
+  // v0.9.0 (UPG-660): the soft bridge from the annual strategy focus area to the
+  // roadmap grouping that realises it. Semantic, NOT hierarchy: strategic_theme and
+  // roadmap_theme sit on different spines (strategy cascade vs roadmap cascade), so
+  // this is a cross-reference, not containment. Pairs with the theme → roadmap_theme
+  // rename that removed the bare-'theme' collision (N6/UPG-652 lineage).
+  strategic_theme_realised_by_roadmap_theme: { forward_verb: "realised_by", reverse_verb: "realises", classification: "semantic", source_type: "strategic_theme", target_type: "roadmap_theme" },
   // v0.5.4 (UPG-511): three edges that lift strategic_theme from structural
   // isolation to a conceptually central strategy node.
   //
@@ -1222,7 +1229,7 @@ var UPG_EDGE_CATALOG = {
   product_builds_feature: { forward_verb: "builds", reverse_verb: "built_by", classification: "hierarchy", source_type: "product", target_type: "feature" },
   product_ships_via_release: { forward_verb: "ships_via", reverse_verb: "ships", classification: "hierarchy", source_type: "product", target_type: "release" },
   product_plans_via_roadmap: { forward_verb: "plans_via", reverse_verb: "plans_for", classification: "hierarchy", source_type: "product", target_type: "roadmap" },
-  product_categorises_by_theme: { forward_verb: "categorises_by", reverse_verb: "categorises", classification: "hierarchy", source_type: "product", target_type: "theme" },
+  product_categorises_by_roadmap_theme: { forward_verb: "categorises_by", reverse_verb: "categorises", classification: "hierarchy", source_type: "product", target_type: "roadmap_theme" },
   feature_area_contains_feature: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "feature_area", target_type: "feature" },
   feature_area_contains_feature_area: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "feature_area", target_type: "feature_area" },
   outcome_delivered_by_feature: { forward_verb: "delivered_by", reverse_verb: "delivers", classification: "cross-domain", source_type: "outcome", target_type: "feature" },
@@ -1246,12 +1253,12 @@ var UPG_EDGE_CATALOG = {
   release_contains_bug: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "release", target_type: "bug" },
   release_documented_in_changelog: { forward_verb: "documented_in", reverse_verb: "documents", classification: "hierarchy", source_type: "release", target_type: "changelog" },
   roadmap_contains_roadmap_item: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "roadmap", target_type: "roadmap_item" },
-  roadmap_categorised_by_theme: { forward_verb: "categorised_by", reverse_verb: "categorises", classification: "hierarchy", source_type: "roadmap", target_type: "theme" },
+  roadmap_categorised_by_roadmap_theme: { forward_verb: "categorised_by", reverse_verb: "categorises", classification: "hierarchy", source_type: "roadmap", target_type: "roadmap_theme" },
   roadmap_schedules_release: { forward_verb: "schedules", reverse_verb: "scheduled_in", classification: "hierarchy", source_type: "roadmap", target_type: "release" },
-  theme_groups_feature: { forward_verb: "groups", reverse_verb: "grouped_in", classification: "hierarchy", source_type: "theme", target_type: "feature" },
-  // feature_area is not contained by theme; themes span multiple
+  roadmap_theme_groups_feature: { forward_verb: "groups", reverse_verb: "grouped_in", classification: "hierarchy", source_type: "roadmap_theme", target_type: "feature" },
+  // feature_area is not contained by roadmap_theme; roadmap themes span multiple
   // areas cross-cuttingly. Containment path: product → feature_area.
-  theme_spans_feature_area: { forward_verb: "spans", reverse_verb: "spanned_by", classification: "semantic", source_type: "theme", target_type: "feature_area" },
+  roadmap_theme_spans_feature_area: { forward_verb: "spans", reverse_verb: "spanned_by", classification: "semantic", source_type: "roadmap_theme", target_type: "feature_area" },
   // The legacy `story_task` collapsed into `task` (v0.4.0), so the implements
   // relationship is the canonical `task_implements_user_story` above; there is
   // no separate story_task edge. (v0.2.7 introduced the Statement/Implementation
@@ -2733,7 +2740,8 @@ var UPG_CROSS_EDGE_TYPES = [
   "shares_metric",
   "depends_on_product",
   "cannibalises",
-  "succeeds"
+  "succeeds",
+  "hosts"
 ];
 var TYPES = getTypes();
 var TYPES_SET = new Set(TYPES);
@@ -2827,7 +2835,7 @@ var UPG_VALID_CHILDREN = {
     "feature_area",
     "release",
     "roadmap",
-    "theme",
+    "roadmap_theme",
     // Engineering
     "bounded_context",
     "code_repository",
@@ -3223,8 +3231,8 @@ var UPG_VALID_CHILDREN = {
   a11y_standard: ["a11y_guideline", "a11y_audit", "a11y_annotation"],
   a11y_audit: ["a11y_issue"],
   // ── Product Specification expansion ─────────────────────────────────────────
-  roadmap: ["roadmap_item", "theme", "release"],
-  theme: ["feature"],
+  roadmap: ["roadmap_item", "roadmap_theme", "release"],
+  roadmap_theme: ["feature"],
   // ── Unified Context Layer hierarchy ─────────────────────────────────────────
   design_system: [
     "design_component",
@@ -5820,7 +5828,7 @@ var UPG_LIFECYCLE_FREE_TYPES = /* @__PURE__ */ new Set([
   //    v0.7.0/UPG-571. ─
   "acceptance_criterion",
   "changelog",
-  "theme",
+  "roadmap_theme",
   "user_story",
   // ── Strategy: metric is a measurement definition; metric_quality_assessment
   //    is a point-in-time snapshot; value_stream is a mapped flow;
@@ -6121,6 +6129,21 @@ var UPG_SCALES = {
   }
 };
 var UPG_MIGRATIONS = {
+  "0.9.0": [
+    // (since v0.9.0, UPG-660) theme → roadmap_theme. `theme` was the only bare,
+    // unqualified theme among four domain-prefixed siblings (strategic_theme,
+    // content_theme, feedback_theme); it claimed the unqualified word and read as
+    // interchangeable with strategic_theme (the N6/UPG-652 confusion). Renamed to
+    // roadmap_theme so all four read consistently and the customer-problem roadmap
+    // grouping is explicit. Lifecycle-free, identical property surface (theme_scope
+    // / priority); no property migration required. Paired edge renames live in
+    // UPG_EDGE_MIGRATIONS['0.9.0'].
+    {
+      from: "theme",
+      to: "roadmap_theme",
+      reason: 'theme renamed to roadmap_theme (UPG-660). The bare "theme" was the only domain-unprefixed theme among strategic_theme / content_theme / feedback_theme; it grabbed the unqualified word and read as interchangeable with strategic_theme. roadmap_theme makes the customer-problem roadmap grouping explicit and consistent across the four. Same property surface (theme_scope / priority); no property migration needed.'
+    }
+  ],
   "0.7.0": [
     // (since v0.7.0, UPG-571) story_statement → user_story. The v0.2.7 split
     // correctly separated the templated promise from the engineering work
@@ -7103,6 +7126,17 @@ var UPG_SPLIT_MIGRATIONS = {
   ]
 };
 var UPG_EDGE_MIGRATIONS = {
+  "0.9.0": [
+    // (since v0.9.0, UPG-660) theme → roadmap_theme. The four canonical edges that
+    // touch the roadmap theme are renamed to the roadmap_theme form. Endpoint guards
+    // reference the POST-migration (roadmap_theme) types; edge migration runs after
+    // node migration, so by the time these rules apply the node has already been
+    // renamed theme → roadmap_theme (UPG_MIGRATIONS['0.9.0']).
+    { kind: "rename", from: "product_categorises_by_theme", to: "product_categorises_by_roadmap_theme", requires_source_type: "product", requires_target_type: "roadmap_theme", reason: "theme \u2192 roadmap_theme (UPG-660). Product categorises by the roadmap theme; edge key updated to the renamed target type." },
+    { kind: "rename", from: "roadmap_categorised_by_theme", to: "roadmap_categorised_by_roadmap_theme", requires_source_type: "roadmap", requires_target_type: "roadmap_theme", reason: "theme \u2192 roadmap_theme (UPG-660). Roadmap is categorised by the roadmap theme; edge key updated to the renamed target type." },
+    { kind: "rename", from: "theme_groups_feature", to: "roadmap_theme_groups_feature", requires_source_type: "roadmap_theme", requires_target_type: "feature", reason: "theme \u2192 roadmap_theme (UPG-660). The roadmap theme groups features; edge key updated to the renamed source type." },
+    { kind: "rename", from: "theme_spans_feature_area", to: "roadmap_theme_spans_feature_area", requires_source_type: "roadmap_theme", requires_target_type: "feature_area", reason: "theme \u2192 roadmap_theme (UPG-660). The roadmap theme spans feature areas; edge key updated to the renamed source type." }
+  ],
   "0.7.0": [
     // (since v0.7.0, UPG-571) story_statement → user_story re-canon. The four
     // canonical edges that touch the statement are renamed to the user_story
@@ -9919,7 +9953,7 @@ var UPG_PROPERTY_SCHEMA = {
     reach: {
       type: "assessment",
       scale_id: "reach_5",
-      description: "How many users experience this problem",
+      description: "How many users experience this problem. @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic property. Apply the `opportunity-sizing` framework; the value lives on the framework_exercise includes-edge. Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -9931,7 +9965,7 @@ var UPG_PROPERTY_SCHEMA = {
     frequency: {
       type: "assessment",
       scale_id: "frequency_5",
-      description: "How often users experience this problem",
+      description: "How often users experience this problem. @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -9943,7 +9977,7 @@ var UPG_PROPERTY_SCHEMA = {
     pain: {
       type: "assessment",
       scale_id: "pain_5",
-      description: "How painful it is when unaddressed",
+      description: "How painful it is when unaddressed. @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -9952,7 +9986,7 @@ var UPG_PROPERTY_SCHEMA = {
       },
       required: ["value", "label"]
     },
-    opportunity_score: { type: "number", description: "Computed: normalized_reach x normalized_frequency x normalized_pain (0-1)" }
+    opportunity_score: { type: "number", description: "Computed: normalized_reach x normalized_frequency x normalized_pain (0-1). @deprecated 0.9.0:computed by the `opportunity-sizing` framework on its application edge, not stored on the entity. Removed in 0.9.1." }
   },
   // OrganizationProperties: Organization entity.
   organization: {
@@ -10366,6 +10400,11 @@ var UPG_PROPERTY_SCHEMA = {
     start_date: { type: "string", description: "ISO date work begins. More precise than `quarter` for continuous planning." },
     target_date: { type: "string", description: "ISO date completion is expected. For shipped items, the actual completion date." }
   },
+  // RoadmapThemeProperties: Thematic grouping of roadmap work, around the customer problem it solves.
+  roadmap_theme: {
+    theme_scope: { type: "string", description: "Scope description" },
+    priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Priority" }
+  },
   // RoleProperties: Role entity.
   role: {
     responsibilities: { type: "string[]", description: "Key responsibilities of the role" },
@@ -10551,7 +10590,7 @@ var UPG_PROPERTY_SCHEMA = {
     reach: {
       type: "assessment",
       scale_id: "reach_5",
-      description: "How many users this solution reaches (1 = few, 5 = most)",
+      description: "How many users this solution reaches (1 = few, 5 = most). @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic property. Apply the `rice-scoring` framework; the value lives on the framework_exercise includes-edge. Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -10563,7 +10602,7 @@ var UPG_PROPERTY_SCHEMA = {
     impact: {
       type: "assessment",
       scale_id: "impact_5",
-      description: "Expected impact on the target outcome (1 = minimal, 5 = transformative)",
+      description: "Expected impact on the target outcome (1 = minimal, 5 = transformative). @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -10575,7 +10614,7 @@ var UPG_PROPERTY_SCHEMA = {
     confidence: {
       type: "assessment",
       scale_id: "confidence_5",
-      description: "How confident the team is in this solution (1 = speculative, 5 = proven)",
+      description: "How confident the team is in this solution (1 = speculative, 5 = proven). @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -10587,7 +10626,7 @@ var UPG_PROPERTY_SCHEMA = {
     effort: {
       type: "assessment",
       scale_id: "effort_5",
-      description: "Level of effort required to implement (1 = trivial, 5 = very large)",
+      description: "Level of effort required to implement (1 = trivial, 5 = very large). @deprecated 0.9.0:effort is a framework-scoped scoring input (it varies by assessor and method), not an intrinsic property. Removed in 0.9.1.",
       properties: {
         value: { type: "number", description: "The numeric value, used for computation." },
         label: { type: "string", description: "The qualitative label (what the assessor meant)." },
@@ -10596,7 +10635,7 @@ var UPG_PROPERTY_SCHEMA = {
       },
       required: ["value", "label"]
     },
-    rice_score: { type: "number", description: "Computed: (reach \xD7 impact \xD7 confidence) / effort" }
+    rice_score: { type: "number", description: "Computed: (reach \xD7 impact \xD7 confidence) / effort. @deprecated 0.9.0:computed by the `rice-scoring` framework on its application edge, not stored on the entity. Removed in 0.9.1." }
   },
   // StakeholderProperties: Stakeholder entity.
   stakeholder: {
@@ -10843,11 +10882,6 @@ var UPG_PROPERTY_SCHEMA = {
     skipped_count: { type: "number", description: "Number of tests that were skipped in the last run" },
     flaky_count: { type: "number", description: "Number of tests that passed only on retry (flaky) in the last run" }
   },
-  // ThemeProperties: Thematic grouping of work.
-  theme: {
-    theme_scope: { type: "string", description: "Scope description" },
-    priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Priority" }
-  },
   // ThreatProperties: Threat.
   threat: {
     category: { type: "string", description: 'Attack or threat scenario. @example "injection", "misconfiguration", "social engineering", "supply chain"' },
@@ -11076,6 +11110,188 @@ function getPropertySchema(entityType) {
   return UPG_PROPERTY_SCHEMA[entityType];
 }
 var UPG_FRAMEWORKS = [
+  {
+    "id": "opportunity-sizing",
+    "approach_ids": [
+      "prioritise"
+    ],
+    "name": "Opportunity Sizing",
+    "version": "1.0.0",
+    "description": "Size opportunities by Reach, Frequency, and Pain to rank which problems are most worth solving before committing to solutions.",
+    "category": "prioritization",
+    "origin": {
+      "type": "practitioner",
+      "attribution": "Continuous discovery practice",
+      "description": "A lightweight discovery-prioritisation method: weigh how many users hit a problem, how often, and how much it hurts, to rank opportunities before investing in solutions.",
+      "url": "https://www.producttalk.org/2016/08/opportunity-solution-tree/",
+      "year": 2016,
+      "license": "open_attribution"
+    },
+    "tags": [
+      "prioritization",
+      "discovery",
+      "table"
+    ],
+    "slots": [
+      {
+        "label": "Opportunities to size",
+        "entityTypeId": "opportunity",
+        "description": "Opportunities scored on Reach, Frequency, and Pain."
+      }
+    ],
+    "data": {
+      "entity_types": [
+        {
+          "type": "opportunity",
+          "role": "scored_item"
+        }
+      ],
+      "required_properties": {
+        "opportunity": [
+          {
+            "property": "reach",
+            "type": "assessment",
+            "scale_id": "reach_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Reach",
+            "description": "How many users experience this problem?"
+          },
+          {
+            "property": "frequency",
+            "type": "assessment",
+            "scale_id": "frequency_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Frequency",
+            "description": "How often do they run into it?"
+          },
+          {
+            "property": "pain",
+            "type": "assessment",
+            "scale_id": "pain_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Pain",
+            "description": "How painful is it when left unaddressed?"
+          }
+        ]
+      },
+      "computed_properties": [
+        {
+          "property": "opportunity_score",
+          "expression": "reach * frequency * pain",
+          "entity_type": "opportunity",
+          "label": "Opportunity Score",
+          "format": "number"
+        }
+      ],
+      "scoring_method": {
+        "applies_to": [
+          "opportunity"
+        ],
+        "inputs": [
+          {
+            "property": "reach",
+            "type": "assessment",
+            "scale_id": "reach_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Reach",
+            "description": "How many users experience this problem?"
+          },
+          {
+            "property": "frequency",
+            "type": "assessment",
+            "scale_id": "frequency_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Frequency",
+            "description": "How often do they run into it?"
+          },
+          {
+            "property": "pain",
+            "type": "assessment",
+            "scale_id": "pain_5",
+            "required": true,
+            "scope": "framework",
+            "label": "Pain",
+            "description": "How painful is it when left unaddressed?"
+          }
+        ],
+        "computed": [
+          {
+            "property": "opportunity_score",
+            "expression": "reach * frequency * pain",
+            "label": "Opportunity Score",
+            "format": "number"
+          }
+        ]
+      }
+    },
+    "structure": {
+      "pattern": "table"
+    },
+    "presentation": {
+      "layout": {
+        "type": "table",
+        "columns": [
+          {
+            "property": "title",
+            "label": "Opportunities to size",
+            "sortable": true
+          },
+          {
+            "property": "reach",
+            "label": "Reach",
+            "sortable": true,
+            "format": "number"
+          },
+          {
+            "property": "frequency",
+            "label": "Frequency",
+            "sortable": true,
+            "format": "number"
+          },
+          {
+            "property": "pain",
+            "label": "Pain",
+            "sortable": true,
+            "format": "number"
+          },
+          {
+            "property": "opportunity_score",
+            "label": "Opportunity Score",
+            "sortable": true,
+            "format": "score_pill"
+          }
+        ]
+      },
+      "sort_by": {
+        "property": "opportunity_score",
+        "direction": "desc"
+      },
+      "colour_by": "score",
+      "card_fields": [
+        "title",
+        "description",
+        "status"
+      ]
+    },
+    "education": {
+      "purpose": "Rank opportunities by how widely, how often, and how painfully a problem is felt, so discovery effort flows to the problems most worth solving.",
+      "core_question": "Of the problems we could pursue, which affect the most users, most often, with the most pain?",
+      "when_to_use": [
+        "You have more opportunities than you can pursue",
+        "You need to compare problems before committing to solutions",
+        "You want a defensible, transparent way to choose what to explore"
+      ],
+      "when_not_to_use": [
+        "A single opportunity is already validated and obvious",
+        "You have no signal yet on reach, frequency, or pain"
+      ]
+    }
+  },
   {
     "id": "opportunity-solution-tree",
     "approach_ids": [
@@ -12332,7 +12548,7 @@ var UPG_FRAMEWORKS = [
     ],
     "name": "RICE Scoring",
     "version": "1.0.0",
-    "description": "Score features, opportunities, and needs by Reach, Impact, Confidence, and Effort to produce a ranked priority list.",
+    "description": "Score features, solutions, opportunities, and needs by Reach, Impact, Confidence, and Effort to produce a ranked priority list.",
     "category": "prioritization",
     "origin": {
       "type": "practitioner",
@@ -12357,6 +12573,11 @@ var UPG_FRAMEWORKS = [
         "entityTypeId": "opportunity",
         "description": "Opportunities scored on the same RICE Scoring inputs as features."
       },
+      {
+        "label": "Solutions to score",
+        "entityTypeId": "solution",
+        "description": "Solutions scored on the same RICE Scoring inputs as features."
+      },
       {
         "label": "Needs to score",
         "entityTypeId": "need",
@@ -12373,6 +12594,10 @@ var UPG_FRAMEWORKS = [
           "type": "opportunity",
           "role": "scored_item"
         },
+        {
+          "type": "solution",
+          "role": "scored_item"
+        },
         {
           "type": "need",
           "role": "scored_item"
@@ -12455,6 +12680,44 @@ var UPG_FRAMEWORKS = [
             "description": "How much work is required to build and ship this, on the effort scale?"
           }
         ],
+        "solution": [
+          {
+            "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?"
+          }
+        ],
         "need": [
           {
             "property": "reach",
@@ -12509,6 +12772,13 @@ var UPG_FRAMEWORKS = [
           "label": "RICE Score",
           "format": "number"
         },
+        {
+          "property": "rice_score",
+          "expression": "(reach * impact * confidence) / effort",
+          "entity_type": "solution",
+          "label": "RICE Score",
+          "format": "number"
+        },
         {
           "property": "rice_score",
           "expression": "(reach * impact * confidence) / effort",
@@ -12521,6 +12791,7 @@ var UPG_FRAMEWORKS = [
         "applies_to": [
           "feature",
           "opportunity",
+          "solution",
           "need"
         ],
         "inputs": [
@@ -16767,7 +17038,8 @@ var STANDARD_LABELS = {
   product: { alt_labels: ["offering", "app", "service", "platform"] },
   vision: { alt_labels: ["product vision", "north star vision", "long-term vision"] },
   mission: { alt_labels: ["mission statement", "purpose"] },
-  strategic_theme: { alt_labels: ["theme", "strategic pillar", "focus area"] },
+  strategic_theme: { alt_labels: ["focus area", "strategic focus area"] },
+  // N6: not 'theme'/'strategic pillar' (own types)
   initiative: { alt_labels: ["strategic initiative", "program initiative", "workstream"] },
   capability: { alt_labels: ["business capability", "organizational capability"] },
   value_stream: { alt_labels: ["value chain", "stream"] },
@@ -16829,7 +17101,8 @@ var STANDARD_LABELS = {
   fix: { alt_labels: ["bugfix", "patch", "remediation"] },
   roadmap: { alt_labels: ["product roadmap", "release plan", "timeline"] },
   roadmap_item: { alt_labels: ["roadmap entry", "planned item"] },
-  theme: { alt_labels: ["product theme", "bucket", "category"] },
+  roadmap_theme: { alt_labels: ["product theme", "roadmap theme"] },
+  // UPG-660: renamed from bare 'theme' (N6 lineage)
   // Engineering layer
   bounded_context: { alt_labels: ["context", "domain boundary", "module boundary"] },
   service: { alt_labels: ["microservice", "backend service", "api service"] },
@@ -17028,7 +17301,8 @@ var STANDARD_LABELS = {
   feedback_vote: { alt_labels: ["upvote", "vote", "user vote"] },
   user_advisory_board: { alt_labels: ["cab", "customer advisory board", "advisory council"] },
   beta_program: { alt_labels: ["beta", "early access", "preview program"] },
-  feedback_theme: { alt_labels: ["feedback cluster", "theme", "feedback category"] },
+  feedback_theme: { alt_labels: ["feedback cluster", "feedback category"] },
+  // N6: not bare 'theme'
   // Pricing & Packaging layer
   pricing_strategy: { alt_labels: ["pricing model", "monetization strategy"] },
   package: { alt_labels: ["product package", "bundle", "sku"] },
@@ -17532,9 +17806,9 @@ var PRODUCT_DELIVERY_PLAYBOOK = {
     ),
     seqStep(
       6,
-      "Themes & Changelog",
-      ["theme", "changelog"],
-      "Group releases into strategic themes. Maintain a changelog the team and customers can read together."
+      "Roadmap Themes & Changelog",
+      ["roadmap_theme", "changelog"],
+      "Group roadmap work into roadmap themes around the customer problem. Maintain a changelog the team and customers can read together."
     )
   ]
 };
@@ -18788,7 +19062,7 @@ var PRODUCT_SPEC_GUIDE = {
   // registered to product_spec but missing from the navigation order).
   // `changelog` lives here because it is a structural product-shipping
   // artefact; content domain references it only via cross-domain bridges.
-  creation_sequence: ["feature_area", "feature", "epic", "user_story", "acceptance_criterion", "task", "bug", "release", "roadmap", "roadmap_item", "theme", "changelog"],
+  creation_sequence: ["feature_area", "feature", "epic", "user_story", "acceptance_criterion", "task", "bug", "release", "roadmap", "roadmap_item", "roadmap_theme", "changelog"],
   patterns: [
     {
       name: "Feature Decomposition",
@@ -23213,7 +23487,7 @@ var UPG_REGIONS = [
         role: "leaf"
       },
       {
-        type: "theme",
+        type: "roadmap_theme",
         role: "container",
         notes: "semantic spanner, not containment"
       },
@@ -23249,10 +23523,10 @@ var UPG_REGIONS = [
       "user_story_verified_by_acceptance_criterion",
       "task_implements_user_story",
       "roadmap_contains_roadmap_item",
-      "roadmap_categorised_by_theme",
+      "roadmap_categorised_by_roadmap_theme",
       "roadmap_schedules_release",
       "release_documented_in_changelog",
-      "theme_spans_feature_area",
+      "roadmap_theme_spans_feature_area",
       "milestone_gates_release",
       "roadmap_item_references_feature",
       "feature_request_voted_on_by_feedback_vote"
@@ -24372,7 +24646,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.15";
+var UPG_VERSION = "0.9.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
 var UPG_TYPES_SET = new Set(UPG_TYPES);
@@ -26257,6 +26531,10 @@ import {
   writePortfolioScopedNode as writePortfolioScopedNode2,
   openPortfolioStoreIfExists,
   assignProductToArea,
+  updateProductArea,
+  removeProductFromArea,
+  deleteArea,
+  moveProductToArea,
   PortfolioRoutingError as PortfolioRoutingError2
 } from "@unified-product-graph/sdk";
 var listProductAreas = async (_args, _ctx) => {
@@ -26479,6 +26757,73 @@ var getChanges = (args, ctx) => {
     )
   );
 };
+var updateAreaTool = async (args, _ctx) => {
+  const areaId = args.area_id;
+  if (!areaId) return textError("Missing required parameter: area_id");
+  const hasField = args.title !== void 0 || args.description !== void 0 || args.strategic_priority !== void 0 || args.owner !== void 0 || "parent_area_id" in args;
+  if (!hasField) {
+    return textError(
+      "Nothing to update: pass at least one of: title, description, strategic_priority, owner, parent_area_id."
+    );
+  }
+  try {
+    const result = await updateProductArea(process.cwd(), areaId, {
+      title: args.title,
+      description: args.description,
+      strategic_priority: args.strategic_priority,
+      owner: args.owner,
+      // Tri-state: present (incl. null) re-parents/un-nests; absent leaves unchanged.
+      ..."parent_area_id" in args ? { parent_area_id: args.parent_area_id ?? null } : {}
+    });
+    return text(
+      JSON.stringify({ message: `Updated area (${result.updated.join(", ")})`, ...result }, null, 2)
+    );
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
+var removeProductFromAreaTool = async (args, _ctx) => {
+  const productId = args.product_id;
+  const areaId = args.area_id;
+  if (!productId) return textError("Missing required parameter: product_id");
+  if (!areaId) return textError("Missing required parameter: area_id");
+  try {
+    const result = await removeProductFromArea(process.cwd(), { product_id: productId, area_id: areaId });
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
+var deleteAreaTool = async (args, _ctx) => {
+  const areaId = args.area_id;
+  if (!areaId) return textError("Missing required parameter: area_id");
+  try {
+    const result = await deleteArea(process.cwd(), areaId, { force: args.force });
+    return text(JSON.stringify({ message: `Deleted area ${areaId}`, ...result }, null, 2));
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
+var moveProductToAreaTool = async (args, _ctx) => {
+  const productId = args.product_id;
+  const toAreaId = args.to_area_id;
+  if (!productId) return textError("Missing required parameter: product_id");
+  if (!toAreaId) return textError("Missing required parameter: to_area_id");
+  try {
+    const result = await moveProductToArea(process.cwd(), {
+      product_id: productId,
+      to_area_id: toAreaId,
+      from_area_id: args.from_area_id
+    });
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
 
 // src/tools/workspace.ts
 import * as fs from "fs";
@@ -26491,7 +26836,9 @@ import {
   openPortfolioStoreIfExists as openPortfolioStoreIfExists2,
   registerProductOnPortfolio,
   findProductFileById,
-  attachProductToPortfolio
+  attachProductToPortfolio,
+  detachProductFromPortfolio,
+  deleteCrossProductEdge
 } from "@unified-product-graph/sdk";
 import {
   createProduct,
@@ -26505,6 +26852,25 @@ import {
 var listLocalProducts = (_args, _ctx) => {
   const cwd = process.cwd();
   const products = [];
+  const membership = /* @__PURE__ */ new Map();
+  try {
+    const pdoc = JSON.parse(fs.readFileSync(path3.join(cwd, ".upg", "portfolio.upg"), "utf-8"));
+    for (const area of pdoc.product_areas ?? []) {
+      for (const pid of area.products ?? []) {
+        const m = membership.get(pid) ?? { areas: [], portfolios: [] };
+        m.areas.push(area.title ?? area.id);
+        membership.set(pid, m);
+      }
+    }
+    for (const pf of pdoc.portfolios ?? []) {
+      for (const pid of pf.products ?? []) {
+        const m = membership.get(pid) ?? { areas: [], portfolios: [] };
+        m.portfolios.push(pf.title ?? pf.id);
+        membership.set(pid, m);
+      }
+    }
+  } catch {
+  }
   const candidates = [];
   const topEntries = fs.readdirSync(cwd, { withFileTypes: true });
   for (const entry of topEntries) {
@@ -26529,13 +26895,19 @@ var listLocalProducts = (_args, _ctx) => {
     try {
       const raw = fs.readFileSync(filePath, "utf-8");
       const doc = JSON.parse(raw);
+      if (!doc.product) continue;
       const coerced = coerceProductStage(doc.product?.stage);
+      const pid = doc.product?.id ?? null;
+      const m = pid ? membership.get(pid) : void 0;
       products.push({
+        id: pid,
         file: path3.relative(cwd, filePath),
         title: doc.product?.title ?? "(untitled)",
         stage: coerced.canonical ?? null,
         nodes: Array.isArray(doc.nodes) ? doc.nodes.length : 0,
-        edges: Array.isArray(doc.edges) ? doc.edges.length : 0
+        edges: Array.isArray(doc.edges) ? doc.edges.length : 0,
+        ...m && m.areas.length > 0 ? { areas: m.areas } : {},
+        ...m && m.portfolios.length > 0 ? { portfolios: m.portfolios } : {}
       });
     } catch {
     }
@@ -26926,6 +27298,126 @@ var attachProductToPortfolioTool = async (args, _ctx) => {
     return textError(err.message);
   }
 };
+var detachProductFromPortfolioTool = async (args, _ctx) => {
+  const productId = args.product_id;
+  const portfolioId = args.portfolio_id;
+  if (!productId) return textError("Missing required parameter: product_id");
+  if (!portfolioId) return textError("Missing required parameter: portfolio_id");
+  try {
+    const result = await detachProductFromPortfolio(process.cwd(), {
+      product_id: productId,
+      portfolio_id: portfolioId
+    });
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    return textError(err.message);
+  }
+};
+var deleteCrossProductEdgeTool = async (args, _ctx) => {
+  const edgeIdArg = args.edge_id;
+  if (!edgeIdArg) return textError("Missing required parameter: edge_id");
+  try {
+    const result = await deleteCrossProductEdge(process.cwd(), edgeIdArg);
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    return textError(err.message);
+  }
+};
+var batchCreateCrossProductEdges = async (args, _ctx) => {
+  const edgesArg = args.edges;
+  if (!Array.isArray(edgesArg) || edgesArg.length === 0) {
+    return textError("Missing required parameter: edges (a non-empty array).");
+  }
+  if (edgesArg.length > 50) {
+    return textError(`Too many edges: ${edgesArg.length}. Max 50 per batch_create_cross_product_edges call.`);
+  }
+  const cwd = process.cwd();
+  const portfolioPath = resolvePortfolioPath(cwd);
+  if (!portfolioPath) {
+    return textError("No workspace found. Run `init_workspace` first to enable portfolio cross-product edges.");
+  }
+  const autoCreatePortfolio = args.auto_create_portfolio ?? false;
+  const portfolioExisted = fs.existsSync(portfolioPath);
+  if (!portfolioExisted && !autoCreatePortfolio) {
+    return textError(
+      'No portfolio document found at .upg/portfolio.upg. Cross-product edges express portfolio-level relationships and should be anchored to a portfolio that contains the products. Create a portfolio first (`create_node({type: "portfolio", title: "..."})`), or pass `auto_create_portfolio: true`.'
+    );
+  }
+  const prepared = [];
+  for (let i = 0; i < edgesArg.length; i++) {
+    const e = edgesArg[i];
+    const sourceIdArg = e.source_id;
+    const targetIdArg = e.target_id;
+    const edgeTypeArg = e.type;
+    const sourceProductId = e.source_product_id;
+    const targetProductId = e.target_product_id;
+    if (!sourceIdArg) return textError(`edges[${i}]: missing source_id`);
+    if (!targetIdArg) return textError(`edges[${i}]: missing target_id`);
+    if (!edgeTypeArg) return textError(`edges[${i}]: missing type`);
+    if (!UPG_CROSS_EDGE_TYPES.includes(edgeTypeArg)) {
+      return textError(`edges[${i}]: invalid cross-product edge type "${edgeTypeArg}". Valid types: ${UPG_CROSS_EDGE_TYPES.join(", ")}`);
+    }
+    let qualifiedSource;
+    if (sourceIdArg.includes("/")) qualifiedSource = sourceIdArg;
+    else if (sourceProductId) qualifiedSource = `${sourceProductId}/${sourceIdArg}`;
+    else return textError(`edges[${i}]: source_id "${sourceIdArg}" is a bare node id. Supply source_product_id or a qualified {product_id}/{node_id}.`);
+    let qualifiedTarget;
+    if (targetIdArg.includes("/")) qualifiedTarget = targetIdArg;
+    else if (targetProductId) qualifiedTarget = `${targetProductId}/${targetIdArg}`;
+    else return textError(`edges[${i}]: target_id "${targetIdArg}" is a bare node id. Supply target_product_id or a qualified {product_id}/{node_id}.`);
+    prepared.push({
+      id: edgeId3(),
+      source: qualifiedSource,
+      target: qualifiedTarget,
+      type: edgeTypeArg,
+      source_product_id: sourceProductId ?? qualifiedSource.split("/")[0],
+      target_product_id: targetProductId ?? qualifiedTarget.split("/")[0]
+    });
+  }
+  const portfolioStore = new UPGPortfolioStore();
+  try {
+    await portfolioStore.loadOrInit(portfolioPath);
+  } catch (err) {
+    return textError(`Failed to load portfolio document: ${err.message}`);
+  }
+  const registeredProducts = [];
+  const portfolioDoc = portfolioStore.getDocument();
+  if (portfolioDoc) {
+    const productIds = /* @__PURE__ */ new Set();
+    for (const e of prepared) {
+      if (e.source_product_id) productIds.add(e.source_product_id);
+      if (e.target_product_id) productIds.add(e.target_product_id);
+    }
+    for (const pid of productIds) {
+      const lookup = findProductFileById(cwd, pid);
+      const wasNew = registerProductOnPortfolio(portfolioDoc, {
+        id: pid,
+        ...lookup ? { file_path: lookup.file_path, title: lookup.title } : {}
+      });
+      if (wasNew) registeredProducts.push({ id: pid, ...lookup ? { file_path: lookup.file_path, title: lookup.title } : {} });
+    }
+    if (registeredProducts.length > 0) portfolioStore.markDirty();
+  }
+  try {
+    for (const e of prepared) portfolioStore.addCrossEdge(e);
+    await portfolioStore.flush();
+  } catch (err) {
+    return textError(`Failed to write cross-product edges: ${err.message}`);
+  }
+  return text(
+    JSON.stringify(
+      {
+        message: `Created ${prepared.length} cross-product edge(s)`,
+        created: prepared,
+        count: prepared.length,
+        portfolio_file: path3.relative(cwd, portfolioPath),
+        ...registeredProducts.length > 0 ? { registered_products: registeredProducts } : {}
+      },
+      null,
+      2
+    )
+  );
+};
 
 // src/tools/schema.ts
 var getEntitySchema = (args, _ctx) => {
@@ -29552,7 +30044,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "list_cross_edge_types",
-    description: "List the canonical cross-product edge types from `UPG_CROSS_EDGE_TYPES`: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`. Portfolio-level relationships across products. Distinct from the within-product `UPG_EDGE_CATALOG`.",
+    description: "List the canonical cross-product edge types from `UPG_CROSS_EDGE_TYPES`: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts`. Portfolio-level relationships across products. Distinct from the within-product `UPG_EDGE_CATALOG`.",
     inputSchema: { type: "object", properties: {} }
   },
   {
@@ -29937,6 +30429,66 @@ var TOOL_DEFINITIONS = [
       required: ["product_id", "area_id"]
     }
   },
+  {
+    name: "update_area",
+    description: "Edit a product area in `.upg/portfolio.upg` (title, description, strategic_priority, owner) and/or re-parent it via `parent_area_id`. The mirror of `update_product` for the organisational axis. `parent_area_id` is tri-state: omit to leave unchanged, pass null to un-nest (top-level), or pass an area id to re-parent (rejected if it would create a cycle).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        area_id: { type: "string", description: "Product area id to edit (from list_product_areas)" },
+        title: { type: "string", description: "New area title" },
+        description: { type: "string", description: "New area description" },
+        strategic_priority: {
+          type: "string",
+          enum: ["urgent", "high", "medium", "low", "none"],
+          description: "Strategic priority (canonical Priority scale)"
+        },
+        parent_area_id: {
+          type: ["string", "null"],
+          description: "Re-parent under this area id; null un-nests (top-level); omit to leave unchanged"
+        },
+        owner: { type: "string", description: "Person or team that owns this area" }
+      },
+      required: ["area_id"]
+    }
+  },
+  {
+    name: "remove_product_from_area",
+    description: "Remove a product from a product area's `products[]` in `.upg/portfolio.upg` (the product stays registered on the portfolio and in any other container). The inverse of `assign_product_to_area`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        product_id: { type: "string", description: "Product id (from list_local_products)" },
+        area_id: { type: "string", description: "Product area id (from list_product_areas)" }
+      },
+      required: ["product_id", "area_id"]
+    }
+  },
+  {
+    name: "delete_area",
+    description: "Delete a product area from `.upg/portfolio.upg`. Guarded: refuses while the area still has products unless `force: true`. Child areas are un-nested (their parent link is cleared) so no parent reference dangles.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        area_id: { type: "string", description: "Product area id to delete (from list_product_areas)" },
+        force: { type: "boolean", description: "Delete even if the area still has products (default false)" }
+      },
+      required: ["area_id"]
+    }
+  },
+  {
+    name: "move_product_to_area",
+    description: "Move a product to a different product area: remove it from `from_area_id` (or, when omitted, from every area it currently sits in) and add it to `to_area_id`. Convenience over remove_product_from_area + assign_product_to_area.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        product_id: { type: "string", description: "Product id (from list_local_products)" },
+        to_area_id: { type: "string", description: "Destination product area id (from list_product_areas)" },
+        from_area_id: { type: "string", description: "Source area id to remove from; omit to remove from all areas" }
+      },
+      required: ["product_id", "to_area_id"]
+    }
+  },
   {
     name: "attach_product_to_portfolio",
     description: "Place an existing product under a portfolio (adds it to the portfolio's `products[]` in `.upg/portfolio.upg`). Resolves the portfolio against the portfolio document and auto-registers the product on the portfolio registry. Use after `create_product`, or pass `portfolio_id` to `create_product` directly.",
@@ -29949,6 +30501,18 @@ var TOOL_DEFINITIONS = [
       required: ["product_id", "portfolio_id"]
     }
   },
+  {
+    name: "detach_product_from_portfolio",
+    description: "Remove a product from a portfolio's `products[]` in `.upg/portfolio.upg` (the product stays registered and in any other container). The inverse of `attach_product_to_portfolio`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        product_id: { type: "string", description: "Product id (from list_local_products)" },
+        portfolio_id: { type: "string", description: "Portfolio id (from list_portfolios)" }
+      },
+      required: ["product_id", "portfolio_id"]
+    }
+  },
   {
     name: "list_portfolios",
     description: "List portfolios from the portfolio document (`.upg/portfolio.upg`). Portfolios represent the strategic axis (where we invest). Returns an empty list when no portfolio document exists yet.",
@@ -29961,7 +30525,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "create_cross_product_edge",
-    description: "Create a cross-product relationship between two entities in different products within a portfolio graph. Types: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`.",
+    description: "Create a cross-product relationship between two entities in different products within a portfolio graph. Types: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts` (host product runs the hosted product inside itself, directed host to hosted).",
     inputSchema: {
       type: "object",
       properties: {
@@ -29969,7 +30533,7 @@ var TOOL_DEFINITIONS = [
         target_id: { type: "string", description: "Target node ID" },
         type: {
           type: "string",
-          enum: ["shares_persona", "shares_competitor", "shares_metric", "depends_on_product", "cannibalises", "succeeds"],
+          enum: ["shares_persona", "shares_competitor", "shares_metric", "depends_on_product", "cannibalises", "succeeds", "hosts"],
           description: "Cross-product relationship type"
         },
         source_product_id: { type: "string", description: "Product ID of the source node" },
@@ -29978,6 +30542,47 @@ var TOOL_DEFINITIONS = [
       required: ["source_id", "target_id", "type"]
     }
   },
+  {
+    name: "delete_cross_product_edge",
+    description: "Delete a cross-product edge from `.upg/portfolio.upg` by id. The inverse of `create_cross_product_edge`. Returns `deleted: false` (not an error) when no edge with that id exists.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        edge_id: { type: "string", description: "Cross-product edge id (from list_portfolio_cross_edges)" }
+      },
+      required: ["edge_id"]
+    }
+  },
+  {
+    name: "batch_create_cross_product_edges",
+    description: "Create up to 50 cross-product edges in one atomic write (the portfolio-tier mirror of batch_create_edges). Every edge is validated and qualified before anything is written; if any is invalid the whole batch is rejected. Referenced products are auto-registered.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        edges: {
+          type: "array",
+          description: "Cross-product edges to create (max 50). Each: { source_id, target_id, type, source_product_id?, target_product_id? }.",
+          items: {
+            type: "object",
+            properties: {
+              source_id: { type: "string", description: "Source node ID (bare or qualified {product_id}/{node_id})" },
+              target_id: { type: "string", description: "Target node ID (bare or qualified {product_id}/{node_id})" },
+              type: {
+                type: "string",
+                enum: ["shares_persona", "shares_competitor", "shares_metric", "depends_on_product", "cannibalises", "succeeds", "hosts"],
+                description: "Cross-product relationship type"
+              },
+              source_product_id: { type: "string", description: "Product ID of the source node (qualifies a bare source_id)" },
+              target_product_id: { type: "string", description: "Product ID of the target node (qualifies a bare target_id)" }
+            },
+            required: ["source_id", "target_id", "type"]
+          }
+        },
+        auto_create_portfolio: { type: "boolean", description: "Create an empty portfolio document if none exists (default false)" }
+      },
+      required: ["edges"]
+    }
+  },
   {
     name: "list_portfolio_cross_edges",
     description: "List all cross-product edges stored in the portfolio document (`.upg/portfolio.upg`). Empty list when the portfolio document is absent.",
@@ -30157,10 +30762,17 @@ var HANDLERS = {
   get_area_context: getAreaContext,
   create_area: createArea,
   assign_product_to_area: assignProductToAreaTool,
+  update_area: updateAreaTool,
+  remove_product_from_area: removeProductFromAreaTool,
+  delete_area: deleteAreaTool,
+  move_product_to_area: moveProductToAreaTool,
   list_portfolios: listPortfolios,
   get_organization: getOrganization,
   create_cross_product_edge: createCrossProductEdge,
+  delete_cross_product_edge: deleteCrossProductEdgeTool,
+  batch_create_cross_product_edges: batchCreateCrossProductEdges,
   attach_product_to_portfolio: attachProductToPortfolioTool,
+  detach_product_from_portfolio: detachProductFromPortfolioTool,
   list_portfolio_cross_edges: listPortfolioCrossEdges,
   migrate_cross_edges: migrateCrossEdges,
   get_sync_state: getSyncState,