@unified-product-graph/core 0.20.0 → 0.20.2

package/dist/index.d.cts

@@ -1148,6 +1148,14 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    strategic_pillar_measured_by_metric: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
     strategic_theme_pursues_initiative: {
         forward_verb: string;
         reverse_verb: string;
@@ -1194,6 +1202,21 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    initiative_advances_key_result: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
+    initiative_delivered_via_roadmap_theme: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     initiative_drives_outcome: {
         forward_verb: string;
         reverse_verb: string;
@@ -9942,8 +9965,8 @@ declare function rotateSlug<T extends Pick<UPGBaseNode, 'slug' | 'aliases'>>(nod
  * eligible" rule over-admits ~5×, because portfolio-shared types also anchor rich
  * within-graph decomposition). So eligibility is a two-layer model:
  *
- *  - **curated**     — the blessed canonical set (`UPG_CROSS_EDGE_TYPES`, 59 types:
- *                      21 portfolio-native + 38 catalog-flagged `cross_product_eligible`).
+ *  - **curated**     — the blessed canonical set (`UPG_CROSS_EDGE_TYPES`, 61 types:
+ *                      21 portfolio-native + 40 catalog-flagged `cross_product_eligible`).
  *                      Hard-allow at the write surface, no warning.
  *  - **provisional** — an unflagged catalog edge that PASSES the shared-tier gate
  *                      (≥1 endpoint `portfolio_shared`). Allowed at the write surface
@@ -9959,8 +9982,10 @@ declare function rotateSlug<T extends Pick<UPGBaseNode, 'slug' | 'aliases'>>(nod
  *
  * The gate (`isCrossCapable`) is DERIVED from `EntityTypeMeta.portfolio_shared`, so
  * the guardrail is self-maintaining: a new persona/job/need internal edge is
- * auto-rejected with no list to touch. The canonical `UPG_CROSS_EDGE_TYPES` snapshot
- * is UNCHANGED (adapters / portfolio_query / list_cross_edge_types keep reading 59);
+ * auto-rejected with no list to touch. The gate LOGIC itself never changes the
+ * canonical `UPG_CROSS_EDGE_TYPES` snapshot (adapters / portfolio_query /
+ * list_cross_edge_types keep reading whatever it currently is, 61 as of 0.20.1);
+ * only a new `cross_product_eligible` flag or portfolio-native type grows it.
  * `crossProductScope` is a separate predicate the write + read surfaces consult.
  */
 /** The three cross-product states a directed relationship can occupy. */
@@ -9983,7 +10008,7 @@ type CrossProductScope = 'curated' | 'provisional' | 'resident';
 declare function isCrossCapable(sourceType: string, targetType: string): boolean;
 /**
  * True if this cross-edge type is in the curated canonical set (`UPG_CROSS_EDGE_TYPES`,
- * the 59). Distinct from the catalog's `isCrossProductEligible` (the 38 dual-registered
+ * the 61). Distinct from the catalog's `isCrossProductEligible` (the 40 dual-registered
  * flags only): this also covers the 21 portfolio-native cross-only types.
  *
  * @example
@@ -22482,7 +22507,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.20.0";
+declare const UPG_VERSION: "0.20.2";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.d.ts

@@ -1148,6 +1148,14 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    strategic_pillar_measured_by_metric: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
     strategic_theme_pursues_initiative: {
         forward_verb: string;
         reverse_verb: string;
@@ -1194,6 +1202,21 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    initiative_advances_key_result: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
+    initiative_delivered_via_roadmap_theme: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     initiative_drives_outcome: {
         forward_verb: string;
         reverse_verb: string;
@@ -9942,8 +9965,8 @@ declare function rotateSlug<T extends Pick<UPGBaseNode, 'slug' | 'aliases'>>(nod
  * eligible" rule over-admits ~5×, because portfolio-shared types also anchor rich
  * within-graph decomposition). So eligibility is a two-layer model:
  *
- *  - **curated**     — the blessed canonical set (`UPG_CROSS_EDGE_TYPES`, 59 types:
- *                      21 portfolio-native + 38 catalog-flagged `cross_product_eligible`).
+ *  - **curated**     — the blessed canonical set (`UPG_CROSS_EDGE_TYPES`, 61 types:
+ *                      21 portfolio-native + 40 catalog-flagged `cross_product_eligible`).
  *                      Hard-allow at the write surface, no warning.
  *  - **provisional** — an unflagged catalog edge that PASSES the shared-tier gate
  *                      (≥1 endpoint `portfolio_shared`). Allowed at the write surface
@@ -9959,8 +9982,10 @@ declare function rotateSlug<T extends Pick<UPGBaseNode, 'slug' | 'aliases'>>(nod
  *
  * The gate (`isCrossCapable`) is DERIVED from `EntityTypeMeta.portfolio_shared`, so
  * the guardrail is self-maintaining: a new persona/job/need internal edge is
- * auto-rejected with no list to touch. The canonical `UPG_CROSS_EDGE_TYPES` snapshot
- * is UNCHANGED (adapters / portfolio_query / list_cross_edge_types keep reading 59);
+ * auto-rejected with no list to touch. The gate LOGIC itself never changes the
+ * canonical `UPG_CROSS_EDGE_TYPES` snapshot (adapters / portfolio_query /
+ * list_cross_edge_types keep reading whatever it currently is, 61 as of 0.20.1);
+ * only a new `cross_product_eligible` flag or portfolio-native type grows it.
  * `crossProductScope` is a separate predicate the write + read surfaces consult.
  */
 /** The three cross-product states a directed relationship can occupy. */
@@ -9983,7 +10008,7 @@ type CrossProductScope = 'curated' | 'provisional' | 'resident';
 declare function isCrossCapable(sourceType: string, targetType: string): boolean;
 /**
  * True if this cross-edge type is in the curated canonical set (`UPG_CROSS_EDGE_TYPES`,
- * the 59). Distinct from the catalog's `isCrossProductEligible` (the 38 dual-registered
+ * the 61). Distinct from the catalog's `isCrossProductEligible` (the 40 dual-registered
  * flags only): this also covers the 21 portfolio-native cross-only types.
  *
  * @example
@@ -22482,7 +22507,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.20.0";
+declare const UPG_VERSION: "0.20.2";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -1308,6 +1308,10 @@ var UPG_EDGE_CATALOG = {
   strategic_pillar_enables_capability: { forward_verb: "enables", reverse_verb: "enabled_by", classification: "hierarchy", source_type: "strategic_pillar", target_type: "capability" },
   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" },
+  // 0.20.1: the durable pillar's own north-star, mirroring objective_measured_by_metric
+  // one level up the cascade. A strategic_pillar is multi-year and org-wide, so its
+  // measuring metric is portfolio-shared just like the pillar itself.
+  strategic_pillar_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "strategic_pillar", target_type: "metric", cross_product_eligible: true },
   strategic_theme_pursues_initiative: { forward_verb: "pursues", reverse_verb: "pursued_under", classification: "hierarchy", source_type: "strategic_theme", target_type: "initiative", cross_product_eligible: true },
   // 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
@@ -1340,6 +1344,17 @@ var UPG_EDGE_CATALOG = {
   strategic_theme_measured_by_key_result: { forward_verb: "measured_by", reverse_verb: "measures", classification: "causal", source_type: "strategic_theme", target_type: "key_result", cross_product_eligible: true },
   strategic_theme_contains_objective: { forward_verb: "contains", reverse_verb: "rolls_up_to", classification: "hierarchy", source_type: "strategic_theme", target_type: "objective", cross_product_eligible: true },
   initiative_assumes_assumption: { forward_verb: "assumes", reverse_verb: "assumed_by", classification: "hierarchy", source_type: "initiative", target_type: "assumption" },
+  // 0.20.1: the G6 alignment-sheet bridge edges — an initiative reaches directly
+  // into the OKR ladder and the roadmap, rather than only via its parent
+  // strategic_theme. `advances_key_result` is intra-strategy execution (both
+  // ends sit in the strategy domain), so causal not cross-domain; the KR is
+  // portfolio-shared like the initiative, so the pair is cross-product-eligible.
+  initiative_advances_key_result: { forward_verb: "advances", reverse_verb: "advanced_by", classification: "causal", source_type: "initiative", target_type: "key_result", cross_product_eligible: true },
+  // `delivered_via_roadmap_theme` mirrors strategic_theme_realised_by_roadmap_theme:
+  // a semantic cross-reference between the strategy spine and the roadmap spine,
+  // not containment. roadmap_theme is not portfolio-shared, so this stays
+  // within-graph (no cross_product_eligible flag).
+  initiative_delivered_via_roadmap_theme: { forward_verb: "delivered_via", reverse_verb: "delivers", classification: "semantic", source_type: "initiative", target_type: "roadmap_theme" },
   initiative_drives_outcome: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "initiative", target_type: "outcome", cross_product_eligible: true },
   capability_enables_value_stream: { forward_verb: "enables", reverse_verb: "enabled_by", classification: "cross-domain", source_type: "capability", target_type: "value_stream" },
   // v0.5.2 (UPG-528): three capability-anchored edges that complete the
@@ -3599,7 +3614,11 @@ var UPG_VALID_CHILDREN = {
   //     That success-measurement asymmetry is the load-bearing distinction.
   vision: ["mission"],
   mission: ["strategic_pillar"],
-  strategic_pillar: ["strategic_theme", "capability", "value_stream", "decision"],
+  // 0.20.1: metric added as a strategic_pillar child, backing
+  // strategic_pillar_measured_by_metric (hierarchy) — the pillar's own
+  // north-star, mirrored from objective: ['key_result', 'metric', ...] one
+  // level down the cascade.
+  strategic_pillar: ["strategic_theme", "capability", "value_stream", "decision", "metric"],
   // v0.5.4 (UPG-511): objectives are the specific quarterly bets *within* a
   // strategic theme. The theme is the multi-quarter focus area; objectives are
   // subordinate. Pairs with `strategic_theme_contains_objective` in the edge
@@ -29900,7 +29919,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.20.0";
+var UPG_VERSION = "0.20.2";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();