@unified-product-graph/core 0.12.5 → 0.12.7

package/dist/index.d.cts

@@ -1633,6 +1633,13 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    product_expresses_brand_identity: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     design_system_encompasses_user_journey: {
         forward_verb: string;
         reverse_verb: string;
@@ -1710,6 +1717,13 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    screen_markets_product: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     screen_navigates_to_screen: {
         forward_verb: string;
         reverse_verb: string;
@@ -7482,7 +7496,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';
+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';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -21834,7 +21848,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.5";
+declare const UPG_VERSION: "0.12.7";
 /**
  * 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

@@ -1633,6 +1633,13 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    product_expresses_brand_identity: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     design_system_encompasses_user_journey: {
         forward_verb: string;
         reverse_verb: string;
@@ -1710,6 +1717,13 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    screen_markets_product: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     screen_navigates_to_screen: {
         forward_verb: string;
         reverse_verb: string;
@@ -7482,7 +7496,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';
+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';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -21834,7 +21848,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.5";
+declare const UPG_VERSION: "0.12.7";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -578,7 +578,7 @@ var UPG_ENTITY_META = [
   // (method / success_criteria / sample_size) when `test_plan` re-homed to the
   // QA/testing domain (UPG-678).
   { name: "experiment_plan", type_id: "ent_340", maturity: "stable", since: "0.2.6" },
-  { name: "experiment_run", type_id: "ent_341", maturity: "proposed", since: "0.2.6" },
+  { name: "experiment_run", type_id: "ent_341", maturity: "stable", since: "0.2.6" },
   { name: "learning", type_id: "ent_029", maturity: "stable", since: "0.1.0" },
   // test_plan re-homed validation → testing/QA (UPG-678). It is the QA
   // verification-procedure plan (test scope / environments / pass criteria);
@@ -666,7 +666,7 @@ var UPG_ENTITY_META = [
   // asserts `proposed` as the post-re-canon invariant. Graduating here would
   // break that contract; promotion is a separate, ticketed decision once the
   // story_statement → user_story migration has fully aged out.
-  { name: "user_story", type_id: "ent_073", maturity: "proposed", since: "0.1.0" },
+  { name: "user_story", type_id: "ent_073", maturity: "stable", since: "0.1.0" },
   { name: "story_statement", type_id: "ent_342", maturity: "deprecated", since: "0.2.7", deprecated_in: "0.7.0", replacement: "user_story" },
   { name: "story_task", type_id: "ent_343", maturity: "deprecated", since: "0.2.7", deprecated_in: "0.4.0", replacement: "task" },
   { name: "acceptance_criterion", type_id: "ent_074", maturity: "stable", since: "0.1.0" },
@@ -955,8 +955,9 @@ var UPG_ENTITY_META = [
   { name: "framework_exercise", type_id: "ent_350", maturity: "proposed", since: "0.8.4" }
 ];
 var DEFERRED_PROPOSED_BY_CONTRACT = {
-  user_story: "UPG-571: frozen proposed by the v0.7.0 re-canon contract (story_statement to user_story); user-story-split.test.ts asserts the invariant.",
-  experiment_run: "UPG-664: the optional multi-run / replication child; experiment_plan graduated to stable, the run stays proposed.",
+  // user_story (UPG-571) and experiment_run (UPG-664) graduated to stable in
+  // 0.12.6 — Captain lifted both freezes ("we are using them"). Their contracts
+  // are settled; they are now stable, not deferred.
   ai_experiment: "UPG-665: AI prompt/model restructure (open ADR).",
   ai_dataset: "UPG-665: AI prompt/model restructure (open ADR).",
   ai_trace: "UPG-665: AI prompt/model restructure (open ADR)."
@@ -1443,6 +1444,11 @@ var UPG_EDGE_CATALOG = {
   design_system_defines_design_token: { forward_verb: "defines", reverse_verb: "defined_in", classification: "hierarchy", source_type: "design_system", target_type: "design_token" },
   design_system_codified_in_design_guideline: { forward_verb: "codified_in", reverse_verb: "codifies", classification: "hierarchy", source_type: "design_system", target_type: "design_guideline" },
   design_system_expresses_brand_identity: { forward_verb: "expresses", reverse_verb: "expressed_in", classification: "hierarchy", source_type: "design_system", target_type: "brand_identity" },
+  // Product expresses the brand (0.12.7, UPG-698). A product references the shared
+  // brand_identity. Dual-registered: also a cross-edge for the common case where the
+  // brand is a registry singleton in another graph (the ratified pattern: brand is a
+  // singleton expressed, not instance_of-d); this catalog entry is the within-graph case.
+  product_expresses_brand_identity: { forward_verb: "expresses", reverse_verb: "expressed_by", classification: "semantic", source_type: "product", target_type: "brand_identity" },
   design_system_encompasses_user_journey: { forward_verb: "encompasses", reverse_verb: "encompassed_in", classification: "hierarchy", source_type: "design_system", target_type: "user_journey" },
   design_system_encompasses_user_flow: { forward_verb: "encompasses", reverse_verb: "encompassed_in", classification: "hierarchy", source_type: "design_system", target_type: "user_flow" },
   design_system_informed_by_insight: { forward_verb: "informed_by", reverse_verb: "informs", classification: "hierarchy", source_type: "design_system", target_type: "insight" },
@@ -1455,6 +1461,11 @@ var UPG_EDGE_CATALOG = {
   design_component_composes_design_component: { forward_verb: "composes", reverse_verb: "composed_in", classification: "hierarchy", source_type: "design_component", target_type: "design_component" },
   prototype_annotated_with_annotation: { forward_verb: "annotated_with", reverse_verb: "annotates", classification: "hierarchy", source_type: "prototype", target_type: "annotation" },
   screen_renders_design_component: { forward_verb: "renders", reverse_verb: "rendered_on", classification: "hierarchy", source_type: "screen", target_type: "design_component" },
+  // Marketing surface to product (0.12.7, UPG-696/698). A marketing/landing screen
+  // markets a product. Dual-registered: also a cross-edge (UPG_CROSS_EDGE_TYPES) for
+  // 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" },
   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" },
@@ -3132,7 +3143,9 @@ var UPG_CROSS_EDGE_TYPES = [
   "competitor_classified_as_classification_value",
   "node_classified_as_classification_value",
   "journey_phase_realises_operating_stage",
-  "screen_markets_product"
+  "screen_markets_product",
+  "screen_renders_design_component",
+  "product_expresses_brand_identity"
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 
@@ -3401,7 +3414,20 @@ var UPG_VALID_CHILDREN = {
   // ── OKR hierarchy ──────────────────────────────────────────────────────────
   objective: ["key_result", "metric"],
   key_result: ["metric"],
-  // ── Strategic cascade: vision → mission → strategic_pillar → … ─────────────
+  // ── Strategic cascade: vision → mission → strategic_pillar → strategic_theme →
+  //    { initiative, objective } ───────────────────────────────────────────────
+  //
+  // strategic_pillar vs strategic_theme (UPG-692 T3.3 — distinct cascade levels,
+  // NOT duplicates; sharpened rather than merged):
+  //   - strategic_pillar = a DURABLE structural division of the strategy. A
+  //     standing area the org organises around for years (e.g. "Structured
+  //     content", "Developer experience"). Few, long-lived; time_horizon is
+  //     multi-year / open-ended; carries its own `success_indicator`.
+  //   - strategic_theme = a TIME-BOUND thrust WITHIN a pillar. The current bet
+  //     for a period (e.g. "Go AI-native this year"). More numerous, rotates;
+  //     time_horizon is bounded (Q / FY); has NO `success_indicator` because it
+  //     is measured through its child objectives (strategic_theme_contains_objective).
+  //     That success-measurement asymmetry is the load-bearing distinction.
   vision: ["mission"],
   mission: ["strategic_pillar"],
   strategic_pillar: ["strategic_theme", "capability", "value_stream", "decision"],
@@ -12541,16 +12567,18 @@ var UPG_PROPERTY_SCHEMA = {
   // StrategicPillarProperties: StrategicPillar entity. Durable multi-year direction the product commits to.
   strategic_pillar: {
     owner: { type: "string", description: "Owning person or team. Promote to a `node_owned_by_person` edge if ownership must be queryable." },
-    description: { type: "string", description: "Narrative of the pillar's intent" },
-    scope: { type: "string", description: "What this pillar covers" },
-    time_horizon: { type: "string", description: 'Planning horizon. Typically multi-year. @example "3 years", "2026-2028"' },
-    success_indicator: { type: "string", description: "How the business knows the pillar is on track. Narrative, not a metric edge." }
-  },
-  // StrategicThemeProperties: StrategicTheme entity.
+    description: { type: "string", description: "Narrative of the pillar's intent as a durable strategic area" },
+    scope: { type: "string", description: "The standing organisational area this pillar owns" },
+    time_horizon: { type: "string", description: 'Standing / multi-year horizon, often open-ended (a pillar is durable). @example "3 years", "2026-2028", "ongoing"' },
+    success_indicator: { type: "string", description: "How the business knows this durable pillar is on track. Narrative, not a metric edge. A strategic_theme deliberately has no success_indicator: it is measured through its child objectives, not on its own." }
+  },
+  // StrategicThemeProperties: StrategicTheme entity. A time-bound thrust WITHIN a
+  // strategic_pillar (distinct cascade level, UPG-692 T3.3) — measured through its
+  // child objectives, so it carries no success_indicator of its own.
   strategic_theme: {
     owner: { type: "string", description: "Owning person or team. Promote to a `node_owned_by_person` edge if ownership must be queryable." },
-    time_horizon: { type: "string", description: 'Planning horizon. @example "Q1 2026", "FY26"' },
-    description: { type: "string", description: "Short narrative of what the theme is about" },
+    time_horizon: { type: "string", description: 'Bounded period this theme is active (a theme is time-bound, within a pillar). @example "Q1 2026", "FY26"' },
+    description: { type: "string", description: "Short narrative of this time-bound thrust within its pillar" },
     scope: { type: "string", description: "What the theme explicitly includes or excludes" }
   },
   // SubscriptionProperties: Subscription.
@@ -29222,7 +29250,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.12.5";
+var UPG_VERSION = "0.12.7";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();