@unified-product-graph/core 0.9.12 → 0.9.14

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,
@@ -3137,7 +3139,9 @@ var UPG_EDGE_CATALOG = {
   specification_extends_specification: { forward_verb: "extends", reverse_verb: "extended_by", classification: "hierarchy", source_type: "specification", target_type: "specification" },
   specification_competes_with_specification: { forward_verb: "competes_with", reverse_verb: "competes_with", classification: "semantic", source_type: "specification", target_type: "specification" },
   primitive_defined_by_specification: { forward_verb: "defined_by", reverse_verb: "defines", classification: "semantic", source_type: "primitive", target_type: "specification" },
-  primitive_composes_primitive: { forward_verb: "composes", reverse_verb: "composed_by", classification: "hierarchy", source_type: "primitive", target_type: "primitive" }
+  primitive_composes_primitive: { forward_verb: "composes", reverse_verb: "composed_by", classification: "hierarchy", source_type: "primitive", target_type: "primitive" },
+  // Stewardship: a registry specification is governed by a (registry-hostable) organization (0.9.13).
+  specification_governed_by_organization: { forward_verb: "governed_by", reverse_verb: "governs", classification: "semantic", source_type: "specification", target_type: "organization" }
 };
 var UPG_POLYMORPHIC_EDGE_KEYS = [
   // Universal semantic verbs
@@ -7419,6 +7423,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
@@ -10872,8 +10892,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: {
@@ -17785,6 +17804,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(
@@ -18231,6 +18568,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) ─────────────────────
@@ -19144,6 +19801,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
     };
@@ -19156,6 +19814,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 ?? {}
     };
@@ -19164,6 +19823,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 ?? {}
   };
@@ -24373,6 +25033,47 @@ var UPG_ANTI_PATTERNS = [
     stages: ["beta", "launch", "growth", "mature"],
     severity: "medium",
     source: { kind: "practitioner", attribution: "Marty Cagan, Inspired (product discovery)" }
+  },
+  // ── Foundations layer (0.9.13): portfolio-scoped, registry-aware ──────────
+  // These read the shared registry + cross-product edges, so they are evaluated
+  // by portfolio_validate, not the single-graph evaluator. They carry no
+  // structured_condition (the detector is cross-product, not a single-graph
+  // IntelligenceCondition).
+  {
+    id: "specification-without-implementer",
+    since: "0.9.13",
+    scope: "portfolio",
+    name: "Specification without implementer",
+    description: "A specification in the shared registry has no product, feature, or api_contract implementing or conforming to it anywhere in the portfolio. A specification nobody implements is a document, not a contract: it states an intent the portfolio never honours.",
+    why_it_matters: "An unimplemented specification carries authority it has not earned. Teams cite it as a standard while no surface actually conforms, so conformance claims cannot be trusted or traced.",
+    remediation: "Link at least one product, feature, or api_contract to the specification via `product_implements_specification`, `product_exposes_specification`, `feature_conforms_to_specification`, or `api_contract_speaks_specification`; or retire the specification from the registry.",
+    stages: ["validation", "build", "beta", "launch", "growth", "mature"],
+    severity: "medium",
+    source: { kind: "fundamental" }
+  },
+  {
+    id: "primitive-scattered-without-canonical",
+    since: "0.9.13",
+    scope: "portfolio",
+    name: "Primitive scattered without a canonical",
+    description: "The same primitive concept appears as a product-local node in two or more products, but no canonical primitive in the shared registry unifies them. Each product redefines the building block on its own terms, so the portfolio carries several drifting copies of one shared idea instead of a single authoritative definition.",
+    why_it_matters: "Scattered primitives drift apart in name, shape, and meaning. Cross-product reasoning breaks because the same concept reads as several unrelated entities, and a change to the shared building block has no single place to land.",
+    remediation: "Define the shared primitive once in the registry with `define_canonical_entity`, then link each product copy via `register_instance` so the building block has one authoritative definition.",
+    stages: ["build", "beta", "launch", "growth", "mature"],
+    severity: "medium",
+    source: { kind: "fundamental" }
+  },
+  {
+    id: "product-reimplements-specification",
+    since: "0.9.13",
+    scope: "portfolio",
+    name: "Specification reimplemented across products",
+    description: "Two or more products independently implement the same registry specification rather than one depending on a shared implementation. Parallel implementations of a single contract multiply the surface that must stay in sync and usually signal a missing shared library or service.",
+    why_it_matters: "Every independent reimplementation of a specification is another place a conformance bug can hide and another copy that drifts from the contract. The cost of a spec change scales with the number of reimplementers.",
+    remediation: "Consolidate onto one implementation that the others depend on (`depends_on_product` / `hosts`), or confirm the duplication is deliberate and record why. Capture the stewarding organization with `create_registry_edge` so the contract has an owner.",
+    stages: ["build", "beta", "launch", "growth", "mature"],
+    severity: "low",
+    source: { kind: "fundamental" }
   }
 ];
 function getAntiPatternById(id) {
@@ -24396,6 +25097,7 @@ function evaluateAntiPatterns(inputs, options) {
   const idFilter = options?.anti_pattern_ids ? new Set(options.anti_pattern_ids) : void 0;
   const fires = [];
   for (const ap of UPG_ANTI_PATTERNS) {
+    if (ap.scope === "portfolio" || !ap.structured_condition) continue;
     if (severityFilter && ap.severity !== severityFilter) continue;
     if (idFilter && !idFilter.has(ap.id)) continue;
     if (inputs.productStage && !ap.stages.includes(inputs.productStage)) {
@@ -24556,6 +25258,7 @@ function buildViolation(ap) {
 }
 function collectTargetEntities(cond) {
   const types = /* @__PURE__ */ new Set();
+  if (!cond) return [];
   walk(cond);
   return [...types].sort();
   function walk(c) {
@@ -27432,7 +28135,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.9.12";
+var UPG_VERSION = "0.9.14";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -27502,8 +28205,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,