@unified-product-graph/core 0.41.0 → 0.42.0

package/dist/index.cjs

@@ -17958,12 +17958,12 @@ var UPG_FRAMEWORKS = [
       "required_properties": {}
     },
     "structure": {
-      "pattern": "flow"
+      "pattern": "cycle"
     },
     "presentation": {
       "layout": {
-        "type": "flow",
-        "direction": "LR"
+        "type": "cycle",
+        "direction": "clockwise"
       },
       "colour_by": "status",
       "card_fields": [
@@ -18330,18 +18330,42 @@ var UPG_FRAMEWORKS = [
       {
         "label": "Now",
         "role": "now",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "horizon",
+            "op": "eq",
+            "value": "now"
+          }
+        ],
         "entityTypeId": "feature",
         "description": "Committed work in progress"
       },
       {
         "label": "Next",
         "role": "next",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "horizon",
+            "op": "eq",
+            "value": "next"
+          }
+        ],
         "entityTypeId": "feature",
         "description": "High-confidence upcoming work"
       },
       {
         "label": "Later",
         "role": "later",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "horizon",
+            "op": "eq",
+            "value": "later"
+          }
+        ],
         "entityTypeId": "initiative",
         "description": "Exploratory, needs more discovery"
       }
@@ -18357,31 +18381,46 @@ var UPG_FRAMEWORKS = [
           "role": "item"
         }
       ],
-      "required_properties": {}
+      "required_properties": {
+        "feature": [
+          {
+            "property": "horizon",
+            "type": "enum",
+            "required": true,
+            "scope": "framework",
+            "label": "Roadmap horizon",
+            "description": "Which horizon this item sits in for the current roadmap",
+            "enum_values": [
+              "now",
+              "next",
+              "later"
+            ]
+          }
+        ],
+        "initiative": [
+          {
+            "property": "horizon",
+            "type": "enum",
+            "required": true,
+            "scope": "framework",
+            "label": "Roadmap horizon",
+            "description": "Which horizon this item sits in for the current roadmap",
+            "enum_values": [
+              "now",
+              "next",
+              "later"
+            ]
+          }
+        ]
+      }
     },
     "structure": {
-      "pattern": "table"
+      "pattern": "collection"
     },
     "presentation": {
       "layout": {
-        "type": "table",
-        "columns": [
-          {
-            "property": "title",
-            "label": "Now",
-            "sortable": true
-          },
-          {
-            "property": "title",
-            "label": "Next",
-            "sortable": true
-          },
-          {
-            "property": "title",
-            "label": "Later",
-            "sortable": true
-          }
-        ]
+        "type": "grid",
+        "groupBy": "horizon"
       },
       "sort_by": {
         "property": "title",
@@ -18431,9 +18470,60 @@ var UPG_FRAMEWORKS = [
     ],
     "slots": [
       {
-        "label": "Requirements to categorise",
+        "label": "Must have",
+        "role": "must",
         "entityTypeId": "feature",
-        "description": "Features or requirements sorted into the four MoSCoW buckets"
+        "description": "Non-negotiable for this release; without it the release fails",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "moscow",
+            "op": "eq",
+            "value": "must"
+          }
+        ]
+      },
+      {
+        "label": "Should have",
+        "role": "should",
+        "entityTypeId": "feature",
+        "description": "Important but not release-blocking; a workaround exists",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "moscow",
+            "op": "eq",
+            "value": "should"
+          }
+        ]
+      },
+      {
+        "label": "Could have",
+        "role": "could",
+        "entityTypeId": "feature",
+        "description": "Desirable, included only if capacity allows",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "moscow",
+            "op": "eq",
+            "value": "could"
+          }
+        ]
+      },
+      {
+        "label": "Won't have",
+        "role": "wont",
+        "entityTypeId": "feature",
+        "description": "Explicitly out of scope for this release, recorded so the decision is visible",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "moscow",
+            "op": "eq",
+            "value": "wont"
+          }
+        ]
       }
     ],
     "data": {
@@ -19474,12 +19564,12 @@ var UPG_FRAMEWORKS = [
       "required_properties": {}
     },
     "structure": {
-      "pattern": "flow"
+      "pattern": "cycle"
     },
     "presentation": {
       "layout": {
-        "type": "flow",
-        "direction": "LR"
+        "type": "cycle",
+        "direction": "clockwise"
       },
       "colour_by": "status",
       "card_fields": [
@@ -19509,7 +19599,7 @@ var UPG_FRAMEWORKS = [
     ],
     "name": "Pirate Metrics AARRR",
     "version": "1.0.0",
-    "description": "Track user lifecycle across five stages: Acquisition, Activation, Retention, Revenue, and Referral.",
+    "description": "Track user lifecycle across five stages: Acquisition, Activation, Retention, Referral, and Revenue.",
     "category": "growth",
     "origin": {
       "type": "practitioner",
@@ -19525,9 +19615,74 @@ var UPG_FRAMEWORKS = [
     ],
     "slots": [
       {
-        "label": "Lifecycle metric",
+        "label": "Acquisition",
+        "role": "acquisition",
+        "entityTypeId": "metric",
+        "description": "Metrics for how users first find the product",
+        "predicate": [
+          {
+            "scope": "entity",
+            "property": "metric_category",
+            "op": "eq",
+            "value": "acquisition"
+          }
+        ]
+      },
+      {
+        "label": "Activation",
+        "role": "activation",
+        "entityTypeId": "metric",
+        "description": "Metrics for whether users reach their first meaningful outcome",
+        "predicate": [
+          {
+            "scope": "entity",
+            "property": "metric_category",
+            "op": "eq",
+            "value": "activation"
+          }
+        ]
+      },
+      {
+        "label": "Retention",
+        "role": "retention",
+        "entityTypeId": "metric",
+        "description": "Metrics for whether users keep coming back",
+        "predicate": [
+          {
+            "scope": "entity",
+            "property": "metric_category",
+            "op": "eq",
+            "value": "retention"
+          }
+        ]
+      },
+      {
+        "label": "Referral",
+        "role": "referral",
+        "entityTypeId": "metric",
+        "description": "Metrics for whether users bring others with them",
+        "predicate": [
+          {
+            "scope": "entity",
+            "property": "metric_category",
+            "op": "eq",
+            "value": "referral"
+          }
+        ]
+      },
+      {
+        "label": "Revenue",
+        "role": "revenue",
         "entityTypeId": "metric",
-        "description": "A metric tracking one stage of the customer lifecycle funnel"
+        "description": "Metrics for whether users pay",
+        "predicate": [
+          {
+            "scope": "entity",
+            "property": "metric_category",
+            "op": "eq",
+            "value": "revenue"
+          }
+        ]
       }
     ],
     "data": {
@@ -19549,8 +19704,8 @@ var UPG_FRAMEWORKS = [
               "acquisition",
               "activation",
               "retention",
-              "revenue",
-              "referral"
+              "referral",
+              "revenue"
             ]
           }
         ]
@@ -19578,14 +19733,14 @@ var UPG_FRAMEWORKS = [
           "entity_type": "metric"
         },
         {
-          "id": "revenue",
-          "label": "Revenue",
+          "id": "referral",
+          "label": "Referral",
           "order": 3,
           "entity_type": "metric"
         },
         {
-          "id": "referral",
-          "label": "Referral",
+          "id": "revenue",
+          "label": "Revenue",
           "order": 4,
           "entity_type": "metric"
         }
@@ -19827,18 +19982,42 @@ var UPG_FRAMEWORKS = [
       {
         "label": "Outer Ring",
         "role": "outer_ring",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "bullseye_ring",
+            "op": "eq",
+            "value": "outer"
+          }
+        ],
         "entityTypeId": "acquisition_channel",
         "description": "All 19 traction channels brainstormed"
       },
       {
         "label": "Middle Ring",
         "role": "middle_ring",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "bullseye_ring",
+            "op": "eq",
+            "value": "middle"
+          }
+        ],
         "entityTypeId": "acquisition_channel",
         "description": "Top 6 channels worth testing"
       },
       {
         "label": "Inner Ring",
         "role": "inner_ring",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "bullseye_ring",
+            "op": "eq",
+            "value": "inner"
+          }
+        ],
         "entityTypeId": "acquisition_channel",
         "description": "Top 3 channels to focus on"
       },
@@ -19851,6 +20030,14 @@ var UPG_FRAMEWORKS = [
       {
         "label": "Bullseye Channel",
         "role": "bullseye_channel",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "bullseye_ring",
+            "op": "eq",
+            "value": "bullseye"
+          }
+        ],
         "entityTypeId": "acquisition_channel",
         "description": "The single best-performing channel"
       }
@@ -19866,7 +20053,24 @@ var UPG_FRAMEWORKS = [
           "role": "item"
         }
       ],
-      "required_properties": {}
+      "required_properties": {
+        "acquisition_channel": [
+          {
+            "property": "bullseye_ring",
+            "type": "enum",
+            "required": true,
+            "scope": "framework",
+            "label": "Bullseye ring",
+            "description": "Which ring this channel currently sits in as the field narrows",
+            "enum_values": [
+              "outer",
+              "middle",
+              "inner",
+              "bullseye"
+            ]
+          }
+        ]
+      }
     },
     "structure": {
       "pattern": "funnel"
@@ -22010,24 +22214,104 @@ var UPG_FRAMEWORKS = [
         "label": "Quick Wins",
         "entityTypeId": "feature",
         "role": "quick_win",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "value",
+            "op": "band",
+            "value": [
+              6,
+              11
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "effort",
+            "op": "band",
+            "value": [
+              1,
+              6
+            ]
+          }
+        ],
         "description": "High value, low effort: do first"
       },
       {
         "label": "Big Bets",
         "entityTypeId": "feature",
         "role": "big_bet",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "value",
+            "op": "band",
+            "value": [
+              6,
+              11
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "effort",
+            "op": "band",
+            "value": [
+              6,
+              11
+            ]
+          }
+        ],
         "description": "High value, high effort: plan carefully"
       },
       {
         "label": "Fill-ins",
         "entityTypeId": "feature",
         "role": "fill_in",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "value",
+            "op": "band",
+            "value": [
+              1,
+              6
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "effort",
+            "op": "band",
+            "value": [
+              1,
+              6
+            ]
+          }
+        ],
         "description": "Low value, low effort: do when idle"
       },
       {
         "label": "Avoid",
         "entityTypeId": "feature",
         "role": "money_pit",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "value",
+            "op": "band",
+            "value": [
+              1,
+              6
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "effort",
+            "op": "band",
+            "value": [
+              6,
+              11
+            ]
+          }
+        ],
         "description": "Low value, high effort: deprioritise"
       }
     ],
@@ -22044,6 +22328,7 @@ var UPG_FRAMEWORKS = [
             "property": "value",
             "type": "number",
             "required": true,
+            "scope": "framework",
             "label": "Value",
             "description": "Expected business value (1-10)"
           },
@@ -22051,6 +22336,7 @@ var UPG_FRAMEWORKS = [
             "property": "effort",
             "type": "number",
             "required": true,
+            "scope": "framework",
             "label": "Effort",
             "description": "Implementation effort (1-10)"
           }
@@ -22072,10 +22358,10 @@ var UPG_FRAMEWORKS = [
     "presentation": {
       "layout": {
         "type": "quadrant",
-        "x_axis": "impact",
-        "y_axis": "effort",
-        "x_label": "Quick Wins",
-        "y_label": "Big Bets"
+        "x_axis": "effort",
+        "y_axis": "value",
+        "x_label": "Effort",
+        "y_label": "Value"
       },
       "colour_by": "group",
       "card_fields": [
@@ -22121,24 +22407,104 @@ var UPG_FRAMEWORKS = [
         "label": "Do First",
         "entityTypeId": "feature",
         "role": "do_first",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "urgency",
+            "op": "band",
+            "value": [
+              4,
+              6
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "importance",
+            "op": "band",
+            "value": [
+              4,
+              6
+            ]
+          }
+        ],
         "description": "Urgent and important: act immediately"
       },
       {
         "label": "Schedule",
         "entityTypeId": "feature",
         "role": "schedule",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "urgency",
+            "op": "band",
+            "value": [
+              1,
+              4
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "importance",
+            "op": "band",
+            "value": [
+              4,
+              6
+            ]
+          }
+        ],
         "description": "Important but not urgent: plan it"
       },
       {
         "label": "Delegate",
         "entityTypeId": "feature",
         "role": "delegate",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "urgency",
+            "op": "band",
+            "value": [
+              4,
+              6
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "importance",
+            "op": "band",
+            "value": [
+              1,
+              4
+            ]
+          }
+        ],
         "description": "Urgent but not important: hand off"
       },
       {
         "label": "Eliminate",
         "entityTypeId": "feature",
         "role": "eliminate",
+        "predicate": [
+          {
+            "scope": "framework",
+            "property": "urgency",
+            "op": "band",
+            "value": [
+              1,
+              4
+            ]
+          },
+          {
+            "scope": "framework",
+            "property": "importance",
+            "op": "band",
+            "value": [
+              1,
+              4
+            ]
+          }
+        ],
         "description": "Neither urgent nor important: drop it"
       }
     ],
@@ -22155,6 +22521,7 @@ var UPG_FRAMEWORKS = [
             "property": "urgency",
             "type": "number",
             "required": true,
+            "scope": "framework",
             "label": "Urgency",
             "description": "How time-sensitive is this? (1-5)"
           },
@@ -22162,6 +22529,7 @@ var UPG_FRAMEWORKS = [
             "property": "importance",
             "type": "number",
             "required": true,
+            "scope": "framework",
             "label": "Importance",
             "description": "How important is this to goals? (1-5)"
           }
@@ -22183,10 +22551,10 @@ var UPG_FRAMEWORKS = [
     "presentation": {
       "layout": {
         "type": "quadrant",
-        "x_axis": "impact",
-        "y_axis": "effort",
-        "x_label": "Do First",
-        "y_label": "Schedule"
+        "x_axis": "urgency",
+        "y_axis": "importance",
+        "x_label": "Urgency",
+        "y_label": "Importance"
       },
       "colour_by": "group",
       "card_fields": [
@@ -33408,7 +33776,8 @@ var UPG_STRUCTURE_PATTERNS = [
   "funnel",
   "collection",
   "quadrant",
-  "flow"
+  "flow",
+  "cycle"
 ];
 
 // src/frameworks/relational-paths.ts
@@ -34276,7 +34645,7 @@ function checkHeaderSealText(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.41.0";
+var UPG_VERSION = "0.42.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();