@unified-product-graph/core 0.9.13 → 0.9.15

package/dist/index.cjs

@@ -25,8 +25,10 @@ __export(index_exports, {
   BUSINESS_GTM_GROWTH_PLAYBOOK: () => BUSINESS_GTM_GROWTH_PLAYBOOK,
   BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK: () => BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK,
   CONTENT_DEPTH_WARNING_RULES: () => CONTENT_DEPTH_WARNING_RULES,
+  DEFAULT_ENTITY_EMOJI: () => DEFAULT_ENTITY_EMOJI,
   DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK: () => DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK,
   ENGINEERING_PLATFORM_PLAYBOOK: () => ENGINEERING_PLATFORM_PLAYBOOK,
+  ENTITY_EMOJI: () => ENTITY_EMOJI,
   EXPERIENCE_DESIGN_BRAND_PLAYBOOK: () => EXPERIENCE_DESIGN_BRAND_PLAYBOOK,
   FOUNDATIONS_PLAYBOOK: () => FOUNDATIONS_PLAYBOOK,
   LEGACY_PRODUCT_STAGES: () => LEGACY_PRODUCT_STAGES,
@@ -89,6 +91,8 @@ __export(index_exports, {
   UPG_SPLIT_MIGRATIONS: () => UPG_SPLIT_MIGRATIONS,
   UPG_STATUS_MIGRATIONS: () => UPG_STATUS_MIGRATIONS,
   UPG_STRUCTURE_PATTERNS: () => UPG_STRUCTURE_PATTERNS,
+  UPG_TREE_PATTERNS: () => UPG_TREE_PATTERNS,
+  UPG_TREE_PATTERNS_BY_ID: () => UPG_TREE_PATTERNS_BY_ID,
   UPG_TYPES: () => UPG_TYPES,
   UPG_TYPES_SET: () => UPG_TYPES_SET,
   UPG_TYPE_ALIASES: () => UPG_TYPE_ALIASES,
@@ -147,6 +151,7 @@ __export(index_exports, {
   getRingForDomain: () => getRingForDomain,
   getScale: () => getScale,
   getSplitMigrations: () => getSplitMigrations,
+  getTreePattern: () => getTreePattern,
   getTypeId: () => getTypeId,
   getTypeName: () => getTypeName,
   getTypes: () => getTypes,
@@ -7421,6 +7426,22 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.9.14: drop the key_result kr_status / status twin (A2) ──────────────
+  //
+  // key_result carried BOTH a lifecycle `status` and a `kr_status` property with
+  // the identical four-value enum (on_track | at_risk | behind | achieved) ==
+  // the KEY_RESULT_LIFECYCLE phases. Two fields, same values: an authoring trap.
+  // The redundant property is removed; the authored health value lifts to the
+  // canonical `UPGBaseNode.status` so a graph that set `kr_status` stays correct.
+  "0.9.14": [
+    {
+      kind: "lift_property_to_top_level",
+      type: "key_result",
+      from_property: "kr_status",
+      to: "status",
+      reason: "A2 (0.9.14). key_result.kr_status duplicated the lifecycle `status` with the identical enum (on_track | at_risk | behind | achieved). The twin is removed; the authored health value lifts to `UPGBaseNode.status` verbatim."
+    }
+  ],
   // ── v0.9.12: technical-domain enum widening + data_flow orientation split ──
   //
   // Real authoring outgrew four engineering-domain enums. 0.9.12 widens them
@@ -10874,8 +10895,7 @@ var UPG_PROPERTY_SCHEMA = {
   key_result: {
     current_value: { type: "number", description: "Most recent observed value" },
     target_value: { type: "number", description: "Value for full achievement" },
-    unit: { type: "string", description: 'Display unit (e.g. "%", "users", "\xA3")' },
-    kr_status: { type: "string", enum: ["on_track", "at_risk", "behind", "achieved"], description: "Delivery health" }
+    unit: { type: "string", description: 'Display unit (e.g. "%", "users", "\xA3")' }
   },
   // KnowledgeBaseArticleProperties: Knowledge base article.
   knowledge_base_article: {
@@ -17787,6 +17807,324 @@ var UPG_FRAMEWORKS = [
         "Time pressure makes a deeper trace expensive and the first-order call is good enough"
       ]
     }
+  },
+  {
+    "id": "value-vs-effort",
+    "approach_ids": [
+      "prioritise"
+    ],
+    "name": "Value vs Effort",
+    "version": "1.0.0",
+    "description": "Plot features on a 2x2 matrix of value against effort. Quick wins (high value, low effort) get prioritised first.",
+    "category": "prioritization",
+    "origin": {
+      "type": "practitioner",
+      "description": "Common product management prioritisation tool. A simplified form of cost-benefit analysis.",
+      "license": "cc_by"
+    },
+    "tags": [
+      "prioritization",
+      "quadrant"
+    ],
+    "slots": [
+      {
+        "label": "Quick Wins",
+        "entityTypeId": "feature",
+        "role": "quick_win",
+        "description": "High value, low effort: do first"
+      },
+      {
+        "label": "Big Bets",
+        "entityTypeId": "feature",
+        "role": "big_bet",
+        "description": "High value, high effort: plan carefully"
+      },
+      {
+        "label": "Fill-ins",
+        "entityTypeId": "feature",
+        "role": "fill_in",
+        "description": "Low value, low effort: do when idle"
+      },
+      {
+        "label": "Avoid",
+        "entityTypeId": "feature",
+        "role": "money_pit",
+        "description": "Low value, high effort: deprioritise"
+      }
+    ],
+    "data": {
+      "entity_types": [
+        {
+          "type": "feature",
+          "role": "item"
+        }
+      ],
+      "required_properties": {
+        "feature": [
+          {
+            "property": "value",
+            "type": "number",
+            "required": true,
+            "label": "Value",
+            "description": "Expected business value (1-10)"
+          },
+          {
+            "property": "effort",
+            "type": "number",
+            "required": true,
+            "label": "Effort",
+            "description": "Implementation effort (1-10)"
+          }
+        ]
+      },
+      "computed_properties": [
+        {
+          "property": "value_effort_ratio",
+          "expression": "value / effort",
+          "entity_type": "feature",
+          "label": "Value/Effort Ratio",
+          "format": "number"
+        }
+      ]
+    },
+    "structure": {
+      "pattern": "quadrant"
+    },
+    "presentation": {
+      "layout": {
+        "type": "quadrant",
+        "x_axis": "impact",
+        "y_axis": "effort",
+        "x_label": "Quick Wins",
+        "y_label": "Big Bets"
+      },
+      "colour_by": "group",
+      "card_fields": [
+        "title",
+        "description"
+      ]
+    },
+    "education": {
+      "purpose": "Plot features on a value/effort matrix to identify quick wins (high value, low effort) and avoid resource traps (low value, high effort).",
+      "core_question": "Which features give us the best return on engineering investment, and which are traps disguised as good ideas?",
+      "when_to_use": [
+        "You have more ideas or features than capacity to build them",
+        "Stakeholders disagree on what to build next",
+        "You need a transparent, defensible prioritisation process"
+      ],
+      "when_not_to_use": [
+        "You have a single obvious next step with no contention",
+        "The backlog is small enough to sequence intuitively"
+      ]
+    }
+  },
+  {
+    "id": "eisenhower-matrix",
+    "approach_ids": [
+      "prioritise"
+    ],
+    "name": "Eisenhower Matrix",
+    "version": "1.0.0",
+    "description": "Classify tasks by urgency and importance into four quadrants: do, schedule, delegate, or eliminate.",
+    "category": "prioritization",
+    "origin": {
+      "type": "practitioner",
+      "attribution": "Dwight D. Eisenhower",
+      "description": "Based on a quote attributed to Eisenhower: 'What is important is seldom urgent and what is urgent is seldom important.' Popularised by Stephen Covey.",
+      "license": "public_domain"
+    },
+    "tags": [
+      "prioritization",
+      "quadrant"
+    ],
+    "slots": [
+      {
+        "label": "Do First",
+        "entityTypeId": "feature",
+        "role": "do_first",
+        "description": "Urgent and important: act immediately"
+      },
+      {
+        "label": "Schedule",
+        "entityTypeId": "feature",
+        "role": "schedule",
+        "description": "Important but not urgent: plan it"
+      },
+      {
+        "label": "Delegate",
+        "entityTypeId": "feature",
+        "role": "delegate",
+        "description": "Urgent but not important: hand off"
+      },
+      {
+        "label": "Eliminate",
+        "entityTypeId": "feature",
+        "role": "eliminate",
+        "description": "Neither urgent nor important: drop it"
+      }
+    ],
+    "data": {
+      "entity_types": [
+        {
+          "type": "feature",
+          "role": "item"
+        }
+      ],
+      "required_properties": {
+        "feature": [
+          {
+            "property": "urgency",
+            "type": "number",
+            "required": true,
+            "label": "Urgency",
+            "description": "How time-sensitive is this? (1-5)"
+          },
+          {
+            "property": "importance",
+            "type": "number",
+            "required": true,
+            "label": "Importance",
+            "description": "How important is this to goals? (1-5)"
+          }
+        ]
+      },
+      "computed_properties": [
+        {
+          "property": "priority_score",
+          "expression": "(urgency * 2) + importance",
+          "entity_type": "feature",
+          "label": "Priority Score",
+          "format": "number"
+        }
+      ]
+    },
+    "structure": {
+      "pattern": "quadrant"
+    },
+    "presentation": {
+      "layout": {
+        "type": "quadrant",
+        "x_axis": "impact",
+        "y_axis": "effort",
+        "x_label": "Do First",
+        "y_label": "Schedule"
+      },
+      "colour_by": "group",
+      "card_fields": [
+        "title",
+        "description"
+      ]
+    },
+    "education": {
+      "purpose": "Sort tasks by urgency and importance into four quadrants, making it clear what to do now, schedule, delegate, or eliminate.",
+      "core_question": "Am I spending my time on what matters most, or am I trapped in the urgent-but-unimportant quadrant?",
+      "when_to_use": [
+        "You have more ideas or features than capacity to build them",
+        "Stakeholders disagree on what to build next",
+        "You need a transparent, defensible prioritisation process"
+      ],
+      "when_not_to_use": [
+        "You have a single obvious next step with no contention",
+        "The backlog is small enough to sequence intuitively"
+      ]
+    }
+  },
+  {
+    "id": "four-forces-of-progress",
+    "approach_ids": [
+      "reflect"
+    ],
+    "name": "Four Forces of Progress",
+    "version": "1.0.0",
+    "description": "Analyse the four forces that drive or inhibit customers switching to a new solution: Push, Pull, Anxiety, and Habit.",
+    "category": "discovery",
+    "origin": {
+      "type": "practitioner",
+      "attribution": "Bob Moesta",
+      "description": "Demand-Side Sales 101",
+      "url": "https://jobstobedone.org/",
+      "year": 2014,
+      "license": "published_methodology"
+    },
+    "tags": [
+      "discovery",
+      "matrix"
+    ],
+    "slots": [
+      {
+        "label": "Push of Current Situation",
+        "entityTypeId": "need",
+        "role": "push",
+        "description": "Place need entities in the Push of Current Situation position of the matrix"
+      },
+      {
+        "label": "Pull of New Solution",
+        "entityTypeId": "desired_outcome",
+        "role": "pull",
+        "description": "Place desired outcome entities in the Pull of New Solution position of the matrix"
+      },
+      {
+        "label": "Anxiety of New Solution",
+        "entityTypeId": "switching_cost",
+        "role": "anxiety",
+        "description": "Place switching cost entities in the Anxiety of New Solution position of the matrix"
+      },
+      {
+        "label": "Habit of Current Situation",
+        "entityTypeId": "switching_cost",
+        "role": "habit",
+        "description": "Place switching cost entities in the Habit of Current Situation position of the matrix"
+      }
+    ],
+    "data": {
+      "entity_types": [
+        {
+          "type": "need",
+          "role": "bucket"
+        },
+        {
+          "type": "switching_cost",
+          "role": "bucket"
+        },
+        {
+          "type": "desired_outcome",
+          "role": "bucket"
+        }
+      ],
+      "required_properties": {}
+    },
+    "structure": {
+      "pattern": "matrix"
+    },
+    "presentation": {
+      "layout": {
+        "type": "matrix",
+        "rows": 2,
+        "cols": 2
+      },
+      "sort_by": {
+        "property": "title",
+        "direction": "asc"
+      },
+      "colour_by": "group",
+      "card_fields": [
+        "title",
+        "description"
+      ]
+    },
+    "education": {
+      "purpose": "Map the four forces that drive or resist a customer's switch to a new solution (Push, Pull, Anxiety, Habit) to understand why people change (or don't).",
+      "core_question": "Are the push and pull forces strong enough to overcome the anxiety of the new and the comfort of the familiar?",
+      "when_to_use": [
+        "You need to understand unmet user needs before committing to solutions",
+        "The problem space is ambiguous and requires structured exploration",
+        "You want to reduce the risk of building the wrong thing"
+      ],
+      "when_not_to_use": [
+        "The solution is well-understood and validated",
+        "You are in a delivery phase with clear requirements"
+      ]
+    }
   }
 ];
 var UPG_FRAMEWORKS_BY_ID = Object.fromEntries(
@@ -18233,6 +18571,326 @@ function isUPGDocument(doc) {
   return validateUPGDocument(doc).valid;
 }
 
+// src/presentation/entity-emoji.ts
+var DEFAULT_ENTITY_EMOJI = "\u{1F4E6}";
+var ENTITY_EMOJI = {
+  a11y_annotation: "\u{1F9BB}",
+  a11y_audit: "\u267F",
+  a11y_guideline: "\u{1F9AF}",
+  a11y_issue: "\u{1F6AB}",
+  a11y_standard: "\u{1F4CF}",
+  acceptance_criterion: "\u2705",
+  access_policy: "\u{1F511}",
+  account: "\u{1F3E6}",
+  acquisition_channel: "\u{1F3A3}",
+  ad_creative: "\u{1F58C}\uFE0F",
+  affinity_cluster: "\u{1F9F2}",
+  agent_definition: "\u{1F9BE}",
+  agent_hook: "\u{1F9F7}",
+  agent_session: "\u{1F9D1}\u200D\u{1F4BB}",
+  agent_skill: "\u{1FA84}",
+  agent_task: "\u{1F3AB}",
+  aggregate: "\u{1FAD9}",
+  ai_cost_tracker: "\u{1F4B8}",
+  ai_dataset: "\u{1FA86}",
+  ai_experiment: "\u{1F47E}",
+  ai_guardrail: "\u{1F6A6}",
+  ai_model: "\u{1F916}",
+  ai_trace: "\u{1FAA1}",
+  alert_rule: "\u{1F6CE}\uFE0F",
+  annotation: "\u{1F5EF}\uFE0F",
+  api_contract: "\u{1F91D}",
+  api_ecosystem: "\u{1F578}\uFE0F",
+  api_endpoint: "\u{1F50C}",
+  approval_record: "\u{1F50F}",
+  assumption: "\u{1F914}",
+  attribution_model: "\u{1F575}\uFE0F",
+  audit_log_policy: "\u{1FAB5}",
+  behavioral_segment: "\u{1F43E}",
+  beta_program: "\u{1F423}",
+  bounded_context: "\u{1F532}",
+  brand_asset: "\u{1F5C2}\uFE0F",
+  brand_colour: "\u{1F308}",
+  brand_identity: "\u{1F4A0}",
+  brand_imagery: "\u{1F5BC}\uFE0F",
+  brand_logo: "\u{1F537}",
+  brand_typography: "\u{1F524}",
+  brand_voice: "\u{1F399}\uFE0F",
+  bug: "\u{1F41B}",
+  build_artifact: "\u{1F3FA}",
+  business_model: "\u{1F4B0}",
+  capability: "\u{1F4AA}",
+  capacity_plan: "\u{1F5D3}\uFE0F",
+  ceremony: "\u{1F514}",
+  certification: "\u{1F3F5}\uFE0F",
+  change_request: "\u270F\uFE0F",
+  changelog: "\u{1F570}\uFE0F",
+  churn_reason: "\u{1F494}",
+  ci_pipeline: "\u{1F687}",
+  classification_axis: "\u2194\uFE0F",
+  classification_value: "\u{1F4CD}",
+  code_repository: "\u{1F4BE}",
+  cohort: "\u{1F465}",
+  command: "\u2328\uFE0F",
+  community_initiative: "\u{1F30D}",
+  competitive_analysis: "\u{1F4CA}",
+  competitive_battle_card: "\u2694\uFE0F",
+  competitor: "\u{1F94A}",
+  competitor_feature: "\u{1F52C}",
+  compliance_framework: "\u{1F3DF}\uFE0F",
+  compliance_requirement: "\u26F2",
+  constraint: "\u{1F512}",
+  contact: "\u{1F4C7}",
+  content_calendar: "\u{1F4C5}",
+  content_piece: "\u{1F5D2}\uFE0F",
+  content_strategy: "\u270D\uFE0F",
+  content_theme: "\u{1F4A1}",
+  contract: "\u{1F4D1}",
+  contract_clause: "\xA7",
+  cost_structure: "\u{1F9EE}",
+  cultural_adaptation: "\u{1F30F}",
+  customer_feedback: "\u{1F536}",
+  customer_health_score: "\u{1F49A}",
+  customer_journey_stage: "\u{1F68F}",
+  customer_relationship: "\u{1FAF6}",
+  dashboard: "\u{1F39B}\uFE0F",
+  data_classification: "\u{1F343}",
+  data_contract: "\u{1F523}",
+  data_domain: "\u{1F3F7}\uFE0F",
+  data_flow: "\u2195\uFE0F",
+  data_lineage: "\u{1F333}",
+  data_model: "\u{1F5C3}\uFE0F",
+  data_pipeline: "\u{1FAA3}",
+  data_product: "\u{1F381}",
+  data_quality_rule: "\u{1F9F9}",
+  data_source: "\u{1F6E2}\uFE0F",
+  database_schema: "\u{1F5C4}\uFE0F",
+  deal: "\u{1F4BC}",
+  decision: "\u2696\uFE0F",
+  deliverable: "\u{1F380}",
+  demand_gen_program: "\u{1F4E3}",
+  department: "\u{1F3EC}",
+  dependency: "\u26D3\uFE0F",
+  deployment: "\u{1F4E4}",
+  design_component: "\u{1F9F1}",
+  design_concept: "\u{1F331}",
+  design_guideline: "\u{1F4CC}",
+  design_pattern: "\u{1F9E9}",
+  design_question: "\u{1F4AD}",
+  design_sprint: "\u{1F3C3}",
+  design_system: "\u{1F9F0}",
+  design_token: "\u{1FA99}",
+  desired_outcome: "\u{1F31F}",
+  developer_portal: "\u{1F391}",
+  discount_strategy: "\u2702\uFE0F",
+  distribution_channel: "\u{1F69A}",
+  document: "\u{1F4C3}",
+  documentation_template: "\u{1F58A}\uFE0F",
+  domain_entity: "\u{1F4E6}",
+  domain_event: "\u{1F4E1}",
+  education_program: "\u{1F3EB}",
+  email_sequence: "\u{1F4E7}",
+  epic: "\u{1F4DC}",
+  error_budget: "\u23F3",
+  eval_benchmark: "\u{1F396}\uFE0F",
+  eval_run: "\u{1F39F}\uFE0F",
+  event: "\u{1F388}",
+  event_schema: "\u{1F520}",
+  evidence: "\u{1F50E}",
+  experiment: "\u{1F9EB}",
+  experiment_plan: "\u{1F4D0}",
+  experiment_run: "\u25B6\uFE0F",
+  external_api: "\u{1F310}",
+  feasibility_study: "\u{1F3D7}\uFE0F",
+  feature: "\u2B50",
+  feature_area: "\u{1F4C1}",
+  feature_flag: "\u{1F38C}",
+  feature_request: "\u{1F64F}",
+  feedback_program: "\u{1F3A4}",
+  feedback_theme: "\u{1F4CE}",
+  feedback_vote: "\u{1F44D}",
+  fix: "\u{1FA9B}",
+  forecast: "\u{1F52E}",
+  framework_exercise: "\u{1F4CB}",
+  funnel: "\u2B07\uFE0F",
+  funnel_step: "\u{1F53D}",
+  glossary_term: "\u{1F4D6}",
+  growth_campaign: "\u{1F4E2}",
+  growth_loop: "\u267E\uFE0F",
+  gtm_strategy: "\u{1F3F9}",
+  hallucination_report: "\u{1F47B}",
+  help_video: "\u{1F3AC}",
+  hypothesis: "\u{1F9EA}",
+  ideal_customer_profile: "\u{1F464}",
+  incident: "\u{1F6A8}",
+  infrastructure_component: "\u{1F5A7}",
+  initiative: "\u{1F680}",
+  insight: "\u{1F526}",
+  integration_partner: "\u{1F5FF}",
+  integration_pattern: "\u{1F517}",
+  interaction_spec: "\u{1F5B1}\uFE0F",
+  interview_guide: "\u{1F4CB}",
+  investigation: "\u{1F50D}",
+  invoice: "\u{1F4B3}",
+  ip_asset: "\xA9\uFE0F",
+  job: "\u{1F528}",
+  job_step: "\u{1F463}",
+  journey_action: "\u26A1",
+  journey_phase: "\u{1F516}",
+  journey_step: "\u{1FA9C}",
+  key_activity: "\u{1F6E0}\uFE0F",
+  key_resource: "\u{1F3ED}",
+  key_result: "\u{1F4C8}",
+  knowledge_base_article: "\u{1F4D3}",
+  launch: "\u{1F6F8}",
+  lead: "\u{1F33F}",
+  learning: "\u{1F9E0}",
+  learning_path: "\u{1F97E}",
+  legal_entity: "\u{1F3E2}",
+  library_dependency: "\u{1F4DA}",
+  locale: "\u{1F30E}",
+  locale_config: "\u{1F5FE}",
+  market_segment: "\u{1F3AF}",
+  market_trend: "\u{1F4C9}",
+  marketing_campaign_plan: "\u{1F4C6}",
+  marketing_channel: "\u{1F4FB}",
+  marketing_strategy: "\u{1F531}",
+  marketplace_listing: "\u{1F6D2}",
+  messaging: "\u2709\uFE0F",
+  metric: "\u{1F522}",
+  metric_quality_assessment: "\u{1FA7A}",
+  milestone: "\u26F3",
+  mission: "\u{1F9ED}",
+  model_comparison: "\u{1F504}",
+  monitor: "\u{1F4FA}",
+  need: "\u{1FAC0}",
+  nps_campaign: "\u{1F60A}",
+  objection: "\u{1F6A7}",
+  objective: "\u{1F3C1}",
+  observation: "\u{1F441}\uFE0F",
+  on_call_rotation: "\u{1F3D5}\uFE0F",
+  opportunity: "\u{1F6AA}",
+  organization: "\u{1F3D9}\uFE0F",
+  outcome: "\u{1F3C6}",
+  participant: "\u{1F64B}",
+  partner_program: "\u{1F397}\uFE0F",
+  partner_revenue_share: "\u{1F932}",
+  partner_tier: "\u{1F948}",
+  partnership: "\u{1FAF1}\u{1F3FB}\u200D\u{1FAF2}\u{1F3FC}",
+  paywall: "\u{1F6C2}",
+  penetration_test: "\u{1F5E1}\uFE0F",
+  person: "\u{1F9D1}",
+  persona: "\u{1F3AD}",
+  pipeline_sales: "\u{1FA88}",
+  pipeline_stage: "\u{1F9FD}",
+  playbook: "\u{1F4D2}",
+  portfolio: "\u{1F9F8}",
+  positioning: "\u{1F3AA}",
+  postmortem: "\u{1FA7B}",
+  press_release: "\u{1F5DE}\uFE0F",
+  pricing_strategy: "\u{1F4B1}",
+  pricing_tier: "\u{1F949}",
+  primitive: "\u{1F4CB}",
+  privacy_policy: "\u{1F6E1}\uFE0F",
+  product: "\u{1F9EC}",
+  product_area: "\u{1FA80}",
+  program: "\u{1F6CB}\uFE0F",
+  project: "\u{1F9F3}",
+  prompt_template: "\u2712\uFE0F",
+  prompt_version: "\u{1F5E8}\uFE0F",
+  proof_point: "\u{1F9FE}",
+  prototype: "\u{1F4F1}",
+  qa_session: "\u{1F41E}",
+  queue_topic: "\u{1F4EC}",
+  quote: "\u{1F5E3}\uFE0F",
+  quote_document: "\u{1F4B2}",
+  read_model: "\u{1FA9F}",
+  rebuttal: "\u21A9\uFE0F",
+  regional_pricing: "\u{1F4B4}",
+  regression_test: "\u267B\uFE0F",
+  release: "\u{1F6A2}",
+  release_strategy: "\u{1FA82}",
+  report: "\u{1F4F0}",
+  research_plan: "\u{1F5FA}\uFE0F",
+  research_question: "\u2753",
+  research_study: "\u{1F9D1}\u200D\u{1F52C}",
+  resource_allocation: "\u{1F967}",
+  retrospective: "\u{1FA9E}",
+  revenue_stream: "\u{1F4B5}",
+  review_gate: "\u{1F6A5}",
+  risk: "\u{1F3B2}",
+  risk_register: "\u{1F9EF}",
+  roadmap: "\u{1F6E3}\uFE0F",
+  roadmap_item: "\u{1F6A9}",
+  roadmap_theme: "\u{1F3A8}",
+  role: "\u{1FAAA}",
+  root_cause: "\u{1FA9D}",
+  runbook: "\u{1F4D8}",
+  sales_motion: "\u{1F501}",
+  screen: "\u{1F5A5}\uFE0F",
+  screen_state: "\u{1F533}",
+  security_audit: "\u{1F6C3}",
+  security_control: "\u{1F39A}\uFE0F",
+  security_policy: "\u{1F510}",
+  security_review: "\u{1F9D0}",
+  seo_keyword: "#\uFE0F\u20E3",
+  service: "\u2699\uFE0F",
+  service_blueprint: "\u{1F7E3}",
+  service_level_agreement: "\u23F1\uFE0F",
+  service_level_indicator: "\u{1F321}\uFE0F",
+  service_level_objective: "\u{1F945}",
+  skill: "\u{1F393}",
+  social_post: "\u{1F426}",
+  solution: "\u{1F527}",
+  specification: "\u{1F4CB}",
+  stakeholder: "\u{1F9D1}\u200D\u{1F4BC}",
+  status_report: "\u{1F4C4}",
+  strategic_pillar: "\u{1F3DB}\uFE0F",
+  strategic_theme: "\u{1F9F5}",
+  subscription: "\u{1F502}",
+  success_milestone: "\u{1F389}",
+  support_ticket: "\u{1F198}",
+  survey_response: "\u{1F4E8}",
+  switching_cost: "\u2693",
+  symptom: "\u26A0\uFE0F",
+  task: "\u2611\uFE0F",
+  team: "\u{1FAC2}",
+  team_okr: "\u{1F3C5}",
+  technical_debt_item: "\u{1FAA4}",
+  territory: "\u{1F3F4}",
+  test_case: "\u{1F335}",
+  test_coverage_report: "\u{1F38F}",
+  test_environment: "\u2697\uFE0F",
+  test_plan: "\u{1F4DD}",
+  test_result: "\u{1F3B0}",
+  test_suite: "\u{1F4C2}",
+  threat: "\u2620\uFE0F",
+  threat_model: "\u{1F3F4}\u200D\u2620\uFE0F",
+  touchpoint: "\u{1F446}",
+  translation_bundle: "\u{1F202}\uFE0F",
+  translation_key: "\u{1F5DD}\uFE0F",
+  trial_config: "\u{1F193}",
+  tutorial: "\u{1F9D1}\u200D\u{1F3EB}",
+  unit_economics: "\u{1F4B9}",
+  user_advisory_board: "\u{1FAF5}",
+  user_flow: "\u{1F500}",
+  user_journey: "\u{1F6E4}\uFE0F",
+  user_story: "\u{1F4AC}",
+  value_object: "\u{1F48E}",
+  value_proposition: "\u2728",
+  value_stream: "\u{1F30A}",
+  variant: "\u{1F18E}",
+  vision: "\u{1F52D}",
+  vulnerability: "\u{1F513}",
+  walkthrough: "\u{1F6B6}",
+  webinar: "\u{1F3A5}",
+  wireframe: "\u25AD",
+  workflow_artifact: "\u{1F5F3}\uFE0F",
+  workflow_run: "\u23EF\uFE0F",
+  workflow_template: "\u{1F3BB}",
+  workspace: "\u{1F3E0}"
+};
+
 // src/presentation/labels.ts
 var PRIORITY_LABELS = [
   // ── need (CONSOLIDATED: replaces pain_point + user_need) ─────────────────────
@@ -19146,6 +19804,7 @@ var UPG_TYPE_LABELS = UPG_ACTIVE_TYPES.map((typeName) => {
     };
     return {
       ...priority,
+      emoji: ENTITY_EMOJI[typeName] ?? DEFAULT_ENTITY_EMOJI,
       alt_labels: [...priority.alt_labels, ...newAliases, ...slotAliases2],
       framework_labels: mergedFrameworkLabels
     };
@@ -19158,6 +19817,7 @@ var UPG_TYPE_LABELS = UPG_ACTIVE_TYPES.map((typeName) => {
     return {
       id: typeName,
       canonical_label: toTitleCase(typeName),
+      emoji: ENTITY_EMOJI[typeName] ?? DEFAULT_ENTITY_EMOJI,
       alt_labels: [...standard.alt_labels, ...newAliases, ...slotAliases2],
       framework_labels: generated?.framework_labels ?? {}
     };
@@ -19166,6 +19826,7 @@ var UPG_TYPE_LABELS = UPG_ACTIVE_TYPES.map((typeName) => {
   return {
     id: typeName,
     canonical_label: toTitleCase(typeName),
+    emoji: ENTITY_EMOJI[typeName] ?? DEFAULT_ENTITY_EMOJI,
     alt_labels: [...migrationAliases, ...slotAliases],
     framework_labels: generated?.framework_labels ?? {}
   };
@@ -19204,6 +19865,110 @@ function buildTypeAliases() {
 }
 var UPG_TYPE_ALIASES = buildTypeAliases();
 
+// src/presentation/tree-patterns.ts
+var UPG_TREE_PATTERNS = [
+  {
+    id: "ost",
+    label: "Opportunity Solution Tree",
+    description: "A desired outcome branching into the opportunities under it and the solutions that address them (Teresa Torres).",
+    framework_id: "opportunity-solution-tree",
+    anchor_type: "outcome",
+    fallback_anchors: ["desired_outcome", "opportunity"],
+    child_map: {
+      outcome: ["opportunity"],
+      desired_outcome: ["opportunity"],
+      opportunity: ["solution"]
+    },
+    natural_depth: 3
+  },
+  {
+    id: "okr",
+    label: "Objectives and Key Results",
+    description: "Strategic themes containing objectives, each measured by its key results (John Doerr).",
+    framework_id: "okr-framework",
+    anchor_type: "strategic_theme",
+    fallback_anchors: ["objective"],
+    child_map: {
+      strategic_theme: ["objective"],
+      objective: ["key_result"]
+    },
+    natural_depth: 3
+  },
+  {
+    id: "user",
+    label: "User chain",
+    description: "A persona and the jobs it pursues, branching into the needs and desired outcomes behind them.",
+    anchor_type: "persona",
+    fallback_anchors: ["job"],
+    child_map: {
+      persona: ["job", "need", "desired_outcome"],
+      job: ["need", "desired_outcome"]
+    },
+    natural_depth: 3
+  },
+  {
+    id: "product",
+    label: "Product breakdown",
+    description: "The product organised into feature areas, then features, epics, and user stories.",
+    anchor_type: "product",
+    fallback_anchors: ["feature_area", "feature"],
+    child_map: {
+      product: ["feature_area"],
+      feature_area: ["feature"],
+      feature: ["epic"],
+      epic: ["user_story"]
+    },
+    natural_depth: 5
+  },
+  {
+    id: "validation",
+    label: "Validation chain",
+    description: "A hypothesis through its experiment plan, experiment, run, and the learning it produced.",
+    framework_id: "build-measure-learn",
+    anchor_type: "hypothesis",
+    fallback_anchors: ["experiment_plan", "experiment"],
+    child_map: {
+      hypothesis: ["experiment_plan"],
+      experiment_plan: ["experiment"],
+      experiment: ["experiment_run"],
+      experiment_run: ["learning"]
+    },
+    natural_depth: 5
+  },
+  {
+    id: "strategy",
+    label: "Strategy cascade",
+    description: "Vision and mission into the strategic themes (bets), the initiatives that pursue them, and the outcomes they drive. Themes anchor on vision OR the product, whichever the graph wired.",
+    anchor_type: "vision",
+    fallback_anchors: ["product", "strategic_theme"],
+    child_map: {
+      vision: ["mission", "strategic_theme"],
+      product: ["strategic_theme"],
+      mission: ["strategic_theme"],
+      strategic_theme: ["initiative"],
+      initiative: ["outcome"]
+    },
+    natural_depth: 4
+  },
+  {
+    id: "feature_areas",
+    label: "Feature areas",
+    description: "Feature areas and the features they contain.",
+    anchor_type: "feature_area",
+    fallback_anchors: ["feature"],
+    child_map: {
+      feature_area: ["feature"]
+    },
+    natural_depth: 2
+  }
+];
+var UPG_TREE_PATTERNS_BY_ID = Object.fromEntries(
+  UPG_TREE_PATTERNS.map((p) => [p.id, p])
+);
+function getTreePattern(id) {
+  return UPG_TREE_PATTERNS_BY_ID[id];
+}
+
 // src/playbooks/definitions/index.ts
 function seqStep(order, phase, entity_types, prompt_hint, options) {
   return {
@@ -27477,7 +28242,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.9.13";
+var UPG_VERSION = "0.9.15";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -27547,8 +28312,10 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   BUSINESS_GTM_GROWTH_PLAYBOOK,
   BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK,
   CONTENT_DEPTH_WARNING_RULES,
+  DEFAULT_ENTITY_EMOJI,
   DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK,
   ENGINEERING_PLATFORM_PLAYBOOK,
+  ENTITY_EMOJI,
   EXPERIENCE_DESIGN_BRAND_PLAYBOOK,
   FOUNDATIONS_PLAYBOOK,
   LEGACY_PRODUCT_STAGES,
@@ -27611,6 +28378,8 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   UPG_SPLIT_MIGRATIONS,
   UPG_STATUS_MIGRATIONS,
   UPG_STRUCTURE_PATTERNS,
+  UPG_TREE_PATTERNS,
+  UPG_TREE_PATTERNS_BY_ID,
   UPG_TYPES,
   UPG_TYPES_SET,
   UPG_TYPE_ALIASES,
@@ -27669,6 +28438,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getRingForDomain,
   getScale,
   getSplitMigrations,
+  getTreePattern,
   getTypeId,
   getTypeName,
   getTypes,