@unified-product-graph/core 0.12.8 → 0.13.1

package/dist/index.d.cts

@@ -1724,6 +1724,34 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    screen_targets_competitor: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    feature_surfaces_product: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    feature_uses_design_component: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    product_implements_design_system: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     screen_navigates_to_screen: {
         forward_verb: string;
         reverse_verb: string;
@@ -3565,13 +3593,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    revenue_stream_measured_by_metric_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     pricing_tier_targets_behavioral_segment: {
         forward_verb: string;
         reverse_verb: string;
@@ -7496,7 +7517,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value' | 'journey_phase_realises_operating_stage' | 'screen_markets_product' | 'screen_renders_design_component' | 'product_expresses_brand_identity';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value' | 'journey_phase_realises_operating_stage' | 'screen_markets_product' | 'screen_renders_design_component' | 'product_expresses_brand_identity' | 'shares_job' | 'shares_need' | 'persona_delegates_to_persona' | 'screen_targets_competitor' | 'feature_surfaces_product' | 'feature_uses_design_component' | 'product_implements_design_system';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -8464,7 +8485,7 @@ declare const UPG_LIFECYCLES: readonly UPGLifecycle[];
  *
  * @example
  * const lifecycle = getLifecycleForType('hypothesis')
- * // → HYPOTHESIS_LIFECYCLE
+ * // → HYPOTHESIS_CLAIM_LIFECYCLE
  *
  * const noLifecycle = getLifecycleForType('persona')
  * // → undefined
@@ -21920,7 +21941,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.12.8";
+declare const UPG_VERSION: "0.13.1";
 /**
  * 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

@@ -1724,6 +1724,34 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    screen_targets_competitor: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    feature_surfaces_product: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    feature_uses_design_component: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    product_implements_design_system: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     screen_navigates_to_screen: {
         forward_verb: string;
         reverse_verb: string;
@@ -3565,13 +3593,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    revenue_stream_measured_by_metric_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     pricing_tier_targets_behavioral_segment: {
         forward_verb: string;
         reverse_verb: string;
@@ -7496,7 +7517,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value' | 'journey_phase_realises_operating_stage' | 'screen_markets_product' | 'screen_renders_design_component' | 'product_expresses_brand_identity';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value' | 'journey_phase_realises_operating_stage' | 'screen_markets_product' | 'screen_renders_design_component' | 'product_expresses_brand_identity' | 'shares_job' | 'shares_need' | 'persona_delegates_to_persona' | 'screen_targets_competitor' | 'feature_surfaces_product' | 'feature_uses_design_component' | 'product_implements_design_system';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -8464,7 +8485,7 @@ declare const UPG_LIFECYCLES: readonly UPGLifecycle[];
  *
  * @example
  * const lifecycle = getLifecycleForType('hypothesis')
- * // → HYPOTHESIS_LIFECYCLE
+ * // → HYPOTHESIS_CLAIM_LIFECYCLE
  *
  * const noLifecycle = getLifecycleForType('persona')
  * // → undefined
@@ -21920,7 +21941,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.12.8";
+declare const UPG_VERSION: "0.13.1";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -1466,6 +1466,25 @@ var UPG_EDGE_CATALOG = {
   // the common case where the product lives in another graph; this catalog entry is
   // the within-graph degenerate case (a product's own landing page).
   screen_markets_product: { forward_verb: "markets", reverse_verb: "marketed_by", classification: "semantic", source_type: "screen", target_type: "product" },
+  // Connective cross-product references (0.13.1, Data's connective-layer brief).
+  // Dual-registered (also in UPG_CROSS_EDGE_TYPES) for the common cross-graph case;
+  // these catalog entries are the within-graph degenerate case.
+  //   - screen_targets_competitor: a comparison / "vs" / positioning screen targets a
+  //     competitor (the competitor typically lives in a watched competitor-intel graph).
+  //   - feature_surfaces_product: a feature surfaces / embeds another product (a "Canvas"
+  //     feature that IS the Canvas product embedded). The feature-granular sibling of
+  //     depends_on_product; wires the portfolio from islands into a mesh.
+  //   - feature_uses_design_component: a feature consumes a shared design_component (the
+  //     feature sibling of screen_renders_design_component; the component lives in the
+  //     design-system product graph).
+  //   - product_implements_design_system: a product adopts / implements the shared design
+  //     system (the adoption semantic, mirroring product_implements_specification). Distinct
+  //     from the hierarchy `product_systematised_in_design_system` (structural containment):
+  //     same pattern as brand (branded_as = hierarchy, expresses = semantic).
+  screen_targets_competitor: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "semantic", source_type: "screen", target_type: "competitor" },
+  feature_surfaces_product: { forward_verb: "surfaces", reverse_verb: "surfaced_by", classification: "semantic", source_type: "feature", target_type: "product" },
+  feature_uses_design_component: { forward_verb: "uses", reverse_verb: "used_by", classification: "semantic", source_type: "feature", target_type: "design_component" },
+  product_implements_design_system: { forward_verb: "implements", reverse_verb: "implemented_by", classification: "semantic", source_type: "product", target_type: "design_system" },
   screen_navigates_to_screen: { forward_verb: "navigates_to", reverse_verb: "navigated_from", classification: "hierarchy", source_type: "screen", target_type: "screen" },
   screen_surfaces_feature: { forward_verb: "surfaces", reverse_verb: "surfaced_on", classification: "cross-domain", source_type: "screen", target_type: "feature" },
   screen_wireframed_as_wireframe: { forward_verb: "wireframed_as", reverse_verb: "wireframes", classification: "hierarchy", source_type: "screen", target_type: "wireframe" },
@@ -1835,7 +1854,9 @@ var UPG_EDGE_CATALOG = {
   persona_belongs_to_market_segment: { forward_verb: "belongs_to", reverse_verb: "includes_persona", classification: "cross-domain", source_type: "persona", target_type: "market_segment" },
   revenue_stream_priced_by_pricing_strategy: { forward_verb: "priced_by", reverse_verb: "prices", classification: "cross-domain", source_type: "revenue_stream", target_type: "pricing_strategy" },
   revenue_stream_drives_outcome: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "revenue_stream", target_type: "outcome" },
-  revenue_stream_measured_by_metric_cross_domain: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "revenue_stream", target_type: "metric" },
+  // revenue_stream_measured_by_metric_cross_domain dropped in 0.13.0 Wave 1 (UPG-685 T0.1):
+  // a cross-domain-classified shadow of revenue_stream_measured_by_metric (same measured_by
+  // verbs); pickCanonicalEdge never returned it. Dual-read to the canonical in UPG_EDGE_MIGRATIONS.
   pricing_tier_targets_behavioral_segment: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "pricing_tier", target_type: "behavioral_segment" },
   key_resource_enables_value_proposition: { forward_verb: "enables", reverse_verb: "enabled_by", classification: "cross-domain", source_type: "key_resource", target_type: "value_proposition" },
   // 4.3 Go-To-Market Domain
@@ -3145,7 +3166,15 @@ var UPG_CROSS_EDGE_TYPES = [
   "journey_phase_realises_operating_stage",
   "screen_markets_product",
   "screen_renders_design_component",
-  "product_expresses_brand_identity"
+  "product_expresses_brand_identity",
+  // Connective cross-product layer (0.13.1) — see UPGCrossEdgeType above.
+  "shares_job",
+  "shares_need",
+  "persona_delegates_to_persona",
+  "screen_targets_competitor",
+  "feature_surfaces_product",
+  "feature_uses_design_component",
+  "product_implements_design_system"
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 
@@ -3602,7 +3631,12 @@ var UPG_VALID_CHILDREN = {
   ],
   // ── Data & Analytics hierarchy ───────────────────────────────────────────────
   data_source: ["metric", "data_pipeline", "data_lineage", "event_schema"],
-  metric: ["metric", "outcome", "data_quality_rule", "metric_quality_assessment"],
+  // UPG-685 T0.4 (0.13.0 Wave 1): `outcome` removed as a metric child. It closed a
+  // containment cycle (outcome ⊃ metric ⊃ outcome) and was backed only by the CAUSAL
+  // `metric_drives_outcome` edge, not a hierarchy edge — the "metric leads to outcome"
+  // meaning lives correctly on that causal edge. The real containment (outcome ⊃ metric)
+  // is kept. Sub-metric trees (metric ⊃ metric) stay.
+  metric: ["metric", "data_quality_rule", "metric_quality_assessment"],
   data_domain: ["data_product", "data_source", "glossary_term", "data_model", "dashboard"],
   dashboard: ["report", "experiment_run"],
   // ── Content & Knowledge hierarchy ────────────────────────────────────────────
@@ -4005,43 +4039,6 @@ var SOLUTION_LIFECYCLE = {
     }
   ]
 };
-var HYPOTHESIS_LIFECYCLE = {
-  entity_type: "hypothesis",
-  initial_phase: "untested",
-  terminal_phases: ["resolved"],
-  phases: [
-    {
-      id: "untested",
-      label: "Untested",
-      description: "The belief is stated. No experiment has been designed or run.",
-      transitions_to: ["testing"]
-    },
-    {
-      id: "testing",
-      label: "Testing",
-      description: "An experiment is actively running to test this hypothesis. Evidence is being gathered.",
-      transitions_to: ["resolved"]
-    },
-    {
-      id: "resolved",
-      label: "Resolved",
-      description: "The hypothesis has been tested and a conclusion reached. The resolved phase has two states: validated (belief held) or invalidated (belief did not hold).",
-      transitions_to: [],
-      core_states: [
-        {
-          id: "validated",
-          label: "Validated",
-          description: "Evidence supports the hypothesis. The belief held. Learnings can inform solution design."
-        },
-        {
-          id: "invalidated",
-          label: "Invalidated",
-          description: "Evidence contradicts the hypothesis. The belief did not hold. Learnings prevent investment in the wrong direction."
-        }
-      ]
-    }
-  ]
-};
 var HYPOTHESIS_CLAIM_LIFECYCLE = {
   entity_type: "hypothesis",
   initial_phase: "drafted",
@@ -6194,9 +6191,7 @@ var UPG_LIFECYCLES = [
   OPPORTUNITY_LIFECYCLE,
   SOLUTION_LIFECYCLE,
   HYPOTHESIS_CLAIM_LIFECYCLE,
-  // v0.4.0 canonical (re-promoted as 'hypothesis')
-  HYPOTHESIS_LIFECYCLE,
-  // pre-v0.2.8 legacy (retained for migration compat)
+  // canonical 'hypothesis' lifecycle. The pre-v0.2.8 legacy binding (untested → testing → resolved) was removed in 0.13.0 Wave 1 (UPG-685 T0.3): it was a dead second binding for the same entity_type, always shadowed by this one, and the legacy-status remap lives in UPG_*_MIGRATIONS, not a live lifecycle.
   EXPERIMENT_LIFECYCLE,
   EXPERIMENT_PLAN_LIFECYCLE,
   EXPERIMENT_RUN_LIFECYCLE,
@@ -8804,6 +8799,7 @@ var UPG_EDGE_MIGRATIONS = {
     { kind: "rename", from: "value_proposition_targets_persona_cross_domain", to: "value_proposition_targets_persona", requires_source_type: "value_proposition", requires_target_type: "persona", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of value_proposition_targets_persona; the suffixed twin never resolved." },
     { kind: "rename", from: "metric_measures_metric_cross_domain", to: "metric_measures_metric", requires_source_type: "metric", requires_target_type: "metric", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of metric_measures_metric; the suffixed twin never resolved." },
     { kind: "rename", from: "insight_validates_need_cross_domain", to: "insight_validates_need", requires_source_type: "insight", requires_target_type: "need", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of insight_validates_need; the suffixed twin never resolved." },
+    { kind: "rename", from: "revenue_stream_measured_by_metric_cross_domain", to: "revenue_stream_measured_by_metric", requires_source_type: "revenue_stream", requires_target_type: "metric", reason: "Duplicate collapse (UPG-685 T0.1, 0.13.0 Wave 1). Cross-domain-classified shadow of revenue_stream_measured_by_metric (same measured_by/measures verbs); pickCanonicalEdge never returned it (the semantic key wins the pair; revenue_stream_drives_metric serves the cross-domain ask). Verb-preserving collapse onto the semantic canonical." },
     // ── Tier 2: tense / suffix twins ──
     { kind: "rename", from: "metric_decomposed_into_metric", to: "metric_decomposes_into_metric", requires_source_type: "metric", requires_target_type: "metric", reason: "Duplicate collapse (UPG-677). Tense-twin of the active-voice metric_decomposes_into_metric." },
     { kind: "rename", from: "product_decided_via_decision_hierarchy", to: "product_decided_via_decision", requires_source_type: "product", requires_target_type: "decision", reason: "Duplicate collapse (UPG-677). Suffix-twin of product_decided_via_decision." },
@@ -20873,6 +20869,29 @@ var UPG_TREE_PATTERNS = [
     // readable money-model overview; `depth` extends into the metric -> metric
     // decomposition waterfall.
     natural_depth: 3
+  },
+  {
+    id: "north_star",
+    label: "North Star impact",
+    description: "A north-star metric, the input/sub-metrics it decomposes into, and the outcomes it drives. The metric-rooted, leading-indicator view: outcomes hang off the metric by influence (the causal `drives` edge), distinct from the OKR view where the outcome sits on top and the metric measures it.",
+    framework_id: "north-star-metric",
+    region: "strategy_outcomes",
+    gap_policy: "all-optional",
+    anchor_type: "metric",
+    // A north-star tree roots at a metric by definition; no fallback (no metric =
+    // no north-star view, honestly empty rather than rooting elsewhere).
+    fallback_anchors: [],
+    child_map: {
+      // A metric decomposes into its input/sub-metrics (the `metric_decomposes_into_metric`
+      // hierarchy) AND drives the outcomes it predicts (the causal `metric_drives_outcome`).
+      // The outcome is a child by INFLUENCE, not containment — the leading-to-lagging chain.
+      // Following the causal edge by type-adjacency (cf. `strategy`'s initiative -> outcome)
+      // is how the metric-rooted view renders without re-creating the metric ⊃ outcome
+      // containment cycle removed in UPG-685 T0.4. The assembler's `seen` set terminates the
+      // metric -> metric recursion for free.
+      metric: [opt("metric"), opt("outcome")]
+    },
+    natural_depth: 3
   }
 ];
 var UPG_TREE_PATTERNS_BY_ID = Object.fromEntries(
@@ -28281,11 +28300,6 @@ var UPG_REGIONS = [
         edge_id: "key_result_quantified_by_metric",
         crosses_into: "strategy_outcomes"
       },
-      {
-        direction: "import",
-        edge_id: "revenue_stream_measured_by_metric_cross_domain",
-        crosses_into: "business_gtm_growth"
-      },
       {
         direction: "import",
         edge_id: "service_level_objective_tracks_metric",
@@ -29306,7 +29320,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.12.8";
+var UPG_VERSION = "0.13.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();