@unified-product-graph/core 0.8.16 → 0.9.1

package/dist/index.js

@@ -91,7 +91,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",
@@ -103,7 +103,7 @@ var UPG_DOMAINS = [
       "bug",
       "roadmap",
       "roadmap_item",
-      "theme",
+      "roadmap_theme",
       "changelog"
     ]
   },
@@ -536,8 +536,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 ──
@@ -638,7 +638,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" },
@@ -1154,6 +1155,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.
   //
@@ -1211,7 +1218,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" },
@@ -1235,12 +1242,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
@@ -2752,7 +2759,8 @@ var UPG_CROSS_EDGE_TYPES = [
   "depends_on_product",
   "cannibalises",
   "succeeds",
-  "hosts"
+  "hosts",
+  "contributes_to"
 ];
 
 // src/registry/entity-type-resolution.ts
@@ -2850,7 +2858,7 @@ var UPG_VALID_CHILDREN = {
     "feature_area",
     "release",
     "roadmap",
-    "theme",
+    "roadmap_theme",
     // Engineering
     "bounded_context",
     "code_repository",
@@ -3246,8 +3254,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",
@@ -5860,7 +5868,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;
@@ -6540,6 +6548,21 @@ function getEnumValueMeta(scaleName, value) {
 
 // src/grammar/migrations.ts
 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
@@ -7582,6 +7605,17 @@ function getSplitMigrations(fromVersion, toVersion) {
   return result;
 }
 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
@@ -10478,7 +10512,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)." },
@@ -10490,7 +10524,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)." },
@@ -10502,7 +10536,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)." },
@@ -10511,7 +10545,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: {
@@ -10925,6 +10959,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" },
@@ -11110,7 +11149,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)." },
@@ -11122,7 +11161,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)." },
@@ -11134,7 +11173,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)." },
@@ -11146,7 +11185,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)." },
@@ -11155,7 +11194,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: {
@@ -11402,11 +11441,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"' },
@@ -11637,6 +11671,188 @@ function getPropertySchema(entityType) {
 
 // src/frameworks/canonical.ts
 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": [
@@ -12893,7 +13109,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",
@@ -12918,6 +13134,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",
@@ -12934,6 +13155,10 @@ var UPG_FRAMEWORKS = [
           "type": "opportunity",
           "role": "scored_item"
         },
+        {
+          "type": "solution",
+          "role": "scored_item"
+        },
         {
           "type": "need",
           "role": "scored_item"
@@ -13016,6 +13241,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",
@@ -13070,6 +13333,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",
@@ -13082,6 +13352,7 @@ var UPG_FRAMEWORKS = [
         "applies_to": [
           "feature",
           "opportunity",
+          "solution",
           "need"
         ],
         "inputs": [
@@ -17764,7 +18035,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"] },
@@ -17826,7 +18098,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"] },
@@ -18025,7 +18298,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"] },
@@ -18531,9 +18805,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."
     )
   ]
 };
@@ -19838,7 +20112,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",
@@ -24320,7 +24594,7 @@ var UPG_REGIONS = [
         role: "leaf"
       },
       {
-        type: "theme",
+        type: "roadmap_theme",
         role: "container",
         notes: "semantic spanner, not containment"
       },
@@ -24356,10 +24630,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"
@@ -25680,7 +25954,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.8.16";
+var UPG_VERSION = "0.9.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();