@unified-product-graph/core 0.17.2 → 0.17.4

package/dist/index.js

@@ -20,7 +20,8 @@ var UPG_DOMAINS = [
       "strategic_pillar",
       "assumption",
       "decision",
-      "constraint"
+      "constraint",
+      "strategic_question"
     ]
   },
   {
@@ -539,6 +540,10 @@ var UPG_ENTITY_META = [
   { name: "assumption", type_id: "ent_014", maturity: "stable", since: "0.1.0" },
   { name: "decision", type_id: "ent_015", maturity: "stable", since: "0.1.0" },
   { name: "constraint", type_id: "ent_348", maturity: "stable", since: "0.4.3" },
+  // (0.17.4) Strategy-domain sibling of research_question / design_question,
+  // completing the domain-question triad. An open coordination/ownership question
+  // a plan is exposed to (distinct from `assumption`, which the plan is built on).
+  { name: "strategic_question", type_id: "ent_357", maturity: "proposed", since: "0.17.4" },
   // ── User ──
   { name: "persona", type_id: "ent_016", maturity: "stable", since: "0.1.0" },
   { name: "job", type_id: "ent_017", maturity: "stable", since: "0.1.0" },
@@ -1013,6 +1018,12 @@ var CLASSIFICATION_EDGE_PROPERTY_SCHEMA = {
     description: "Optional. A source URL, or a competitor_signal / evidence node id backing the classification. Mirrors feature_rivals_competitor_feature.evidence (free text or a node id)."
   }
 };
+var DEFER_EDGE_PROPERTY_SCHEMA = {
+  deferred_to: {
+    type: "string",
+    description: 'Target period the parked work is deferred to. Freeform, mirroring strategic_theme.time_horizon. @example "Q4 2026", "FY27", "next release".'
+  }
+};
 var UPG_EDGE_CATALOG = {
   // ── Part 1: Core Narrative Spine (Ring 1) ──────────────────────────────────
   // 1.1 User Domain
@@ -1029,7 +1040,7 @@ var UPG_EDGE_CATALOG = {
   persona_aspires_to_desired_outcome: { forward_verb: "aspires_to", reverse_verb: "aspirational_for", classification: "hierarchy", source_type: "persona", target_type: "desired_outcome" },
   // Delegation (0.11.6): a persona delegates work to another. The common case is human -> agent
   // (Content Ops Lead -> Content Agent), but it also expresses human -> human (editor -> reviewer).
-  persona_delegates_to_persona: { forward_verb: "delegates_to", reverse_verb: "delegated_by", classification: "semantic", source_type: "persona", target_type: "persona" },
+  persona_delegates_to_persona: { forward_verb: "delegates_to", reverse_verb: "delegated_by", classification: "semantic", source_type: "persona", target_type: "persona", cross_product_eligible: true },
   persona_incurs_switching_cost: { forward_verb: "incurs", reverse_verb: "incurred_by", classification: "hierarchy", source_type: "persona", target_type: "switching_cost" },
   job_surfaces_need: { forward_verb: "surfaces", reverse_verb: "surfaces_from", classification: "causal", source_type: "job", target_type: "need" },
   job_motivates_desired_outcome: { forward_verb: "motivates", reverse_verb: "motivated_by", classification: "causal", source_type: "job", target_type: "desired_outcome" },
@@ -1147,15 +1158,15 @@ var UPG_EDGE_CATALOG = {
   // Dual-registered as a cross-edge (UPG_CROSS_EDGE_TYPES) so it also spans our
   // product graph and a watched competitor-intelligence graph. Distinct from
   // `competitor_feature_inspires_feature` (ideation lineage, not parity).
-  feature_rivals_competitor_feature: { forward_verb: "rivals", reverse_verb: "is_rivalled_by", classification: "cross-domain", source_type: "feature", target_type: "competitor_feature", carries_properties: true },
+  feature_rivals_competitor_feature: { forward_verb: "rivals", reverse_verb: "is_rivalled_by", classification: "cross-domain", source_type: "feature", target_type: "competitor_feature", carries_properties: true, cross_product_eligible: true },
   // 0.10.0 (spec issue #41): competitor_signal is a dated competitor move (feature
   // launch / pricing change / acquisition / partnership / market entry) emitted by a
   // competitor and mapped onto our portfolio. `emits` is within the watched graph;
   // `maps_to_feature` / `surfaces_opportunity` cross from the watched signal into our
   // product graph (dual-registered as cross-edges in UPG_CROSS_EDGE_TYPES).
   competitor_emits_competitor_signal: { forward_verb: "emits", reverse_verb: "emitted_by", classification: "hierarchy", source_type: "competitor", target_type: "competitor_signal" },
-  competitor_signal_maps_to_feature: { forward_verb: "maps_to", reverse_verb: "targeted_by_signal", classification: "cross-domain", source_type: "competitor_signal", target_type: "feature" },
-  competitor_signal_surfaces_opportunity: { forward_verb: "surfaces", reverse_verb: "prompted_by_signal", classification: "cross-domain", source_type: "competitor_signal", target_type: "opportunity" },
+  competitor_signal_maps_to_feature: { forward_verb: "maps_to", reverse_verb: "targeted_by_signal", classification: "cross-domain", source_type: "competitor_signal", target_type: "feature", cross_product_eligible: true },
+  competitor_signal_surfaces_opportunity: { forward_verb: "surfaces", reverse_verb: "prompted_by_signal", classification: "cross-domain", source_type: "competitor_signal", target_type: "opportunity", cross_product_eligible: true },
   competitive_analysis_analyses_competitor: { forward_verb: "analyses", reverse_verb: "analysed_in", classification: "hierarchy", source_type: "competitive_analysis", target_type: "competitor" },
   competitive_analysis_identifies_market_trend: { forward_verb: "identifies", reverse_verb: "identified_in", classification: "hierarchy", source_type: "competitive_analysis", target_type: "market_trend" },
   competitive_analysis_scopes_market_segment: { forward_verb: "scopes", reverse_verb: "scoped_in", classification: "hierarchy", source_type: "competitive_analysis", target_type: "market_segment" },
@@ -1188,13 +1199,13 @@ var UPG_EDGE_CATALOG = {
   // competitor can be classified directly against a `registry/{classification_value}`
   // canonical, eliminating the per-graph taxonomy node. Within-graph (the catalogue
   // case) here; cross-product against the registry canonical via create_cross_product_edge.
-  competitor_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "competitor", target_type: "classification_value", carries_properties: true, property_schema: CLASSIFICATION_EDGE_PROPERTY_SCHEMA },
+  competitor_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "competitor", target_type: "classification_value", carries_properties: true, property_schema: CLASSIFICATION_EDGE_PROPERTY_SCHEMA, cross_product_eligible: true },
   // 0.10.3: the polymorphic, type-agnostic sibling. ANY node (a feature, a
   // product, a market_segment) classified against a classification_value, so
   // classification is not welded to the competitor type. Also dual-registered as
   // a cross-edge for the registry-canonical case. source_type:'node' (wildcard);
   // listed in UPG_POLYMORPHIC_EDGE_KEYS.
-  node_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "node", target_type: "classification_value", carries_properties: true, property_schema: CLASSIFICATION_EDGE_PROPERTY_SCHEMA },
+  node_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "node", target_type: "classification_value", carries_properties: true, property_schema: CLASSIFICATION_EDGE_PROPERTY_SCHEMA, cross_product_eligible: true },
   persona_anti_fit_for_classification_value: { forward_verb: "is_anti_fit_for", reverse_verb: "should_not_be_picked_by", classification: "semantic", source_type: "persona", target_type: "classification_value" },
   persona_anti_fit_for_product: { forward_verb: "is_anti_fit_for", reverse_verb: "should_not_be_picked_by", classification: "semantic", source_type: "persona", target_type: "product" },
   persona_anti_fit_for_competitor: { forward_verb: "is_anti_fit_for", reverse_verb: "should_not_be_picked_by", classification: "semantic", source_type: "persona", target_type: "competitor" },
@@ -1247,28 +1258,28 @@ var UPG_EDGE_CATALOG = {
   feedback_program_has_beta_program: { forward_verb: "has", reverse_verb: "part_of", classification: "hierarchy", source_type: "feedback_program", target_type: "beta_program" },
   // ── Part 2: Strategic & Execution Spine (Ring 2) ───────────────────────────
   // 2.1 Strategic Domain
-  product_pursues_outcome: { forward_verb: "pursues", reverse_verb: "pursued_by", classification: "hierarchy", source_type: "product", target_type: "outcome" },
-  product_targets_objective: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "hierarchy", source_type: "product", target_type: "objective" },
-  product_guided_by_vision: { forward_verb: "guided_by", reverse_verb: "guides", classification: "hierarchy", source_type: "product", target_type: "vision" },
+  product_pursues_outcome: { forward_verb: "pursues", reverse_verb: "pursued_by", classification: "hierarchy", source_type: "product", target_type: "outcome", cross_product_eligible: true },
+  product_targets_objective: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "hierarchy", source_type: "product", target_type: "objective", cross_product_eligible: true },
+  product_guided_by_vision: { forward_verb: "guided_by", reverse_verb: "guides", classification: "hierarchy", source_type: "product", target_type: "vision", cross_product_eligible: true },
   // product→{mission,strategic_theme,strategic_pillar,initiative,capability,value_stream,assumption}
   // are semantic "how the product relates to the strategic cascade", not containment.
   // The containment chain is product → vision → mission → strategic_pillar → … so these
   // targets are reachable via the vision/mission hierarchy already.
-  product_fulfils_mission: { forward_verb: "fulfils", reverse_verb: "fulfilled_by", classification: "semantic", source_type: "product", target_type: "mission" },
-  product_organises_around_strategic_theme: { forward_verb: "organises_around", reverse_verb: "organises", classification: "semantic", source_type: "product", target_type: "strategic_theme" },
-  product_stands_on_strategic_pillar: { forward_verb: "stands_on", reverse_verb: "supports", classification: "semantic", source_type: "product", target_type: "strategic_pillar" },
-  product_invests_in_initiative: { forward_verb: "invests_in", reverse_verb: "investment_of", classification: "semantic", source_type: "product", target_type: "initiative" },
+  product_fulfils_mission: { forward_verb: "fulfils", reverse_verb: "fulfilled_by", classification: "semantic", source_type: "product", target_type: "mission", cross_product_eligible: true },
+  product_organises_around_strategic_theme: { forward_verb: "organises_around", reverse_verb: "organises", classification: "semantic", source_type: "product", target_type: "strategic_theme", cross_product_eligible: true },
+  product_stands_on_strategic_pillar: { forward_verb: "stands_on", reverse_verb: "supports", classification: "semantic", source_type: "product", target_type: "strategic_pillar", cross_product_eligible: true },
+  product_invests_in_initiative: { forward_verb: "invests_in", reverse_verb: "investment_of", classification: "semantic", source_type: "product", target_type: "initiative", cross_product_eligible: true },
   product_develops_capability: { forward_verb: "develops", reverse_verb: "developed_by", classification: "semantic", source_type: "product", target_type: "capability" },
   product_delivers_through_value_stream: { forward_verb: "delivers_through", reverse_verb: "delivers_for", classification: "semantic", source_type: "product", target_type: "value_stream" },
   product_holds_assumption: { forward_verb: "holds", reverse_verb: "held_by", classification: "semantic", source_type: "product", target_type: "assumption" },
-  product_measures_with_metric: { forward_verb: "measures_with", reverse_verb: "measures", classification: "hierarchy", source_type: "product", target_type: "metric" },
-  outcome_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "outcome", target_type: "metric" },
+  product_measures_with_metric: { forward_verb: "measures_with", reverse_verb: "measures", classification: "hierarchy", source_type: "product", target_type: "metric", cross_product_eligible: true },
+  outcome_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "outcome", target_type: "metric", cross_product_eligible: true },
   // (UPG-677) outcome_tracked_by_metric retired — near-synonym of
   // outcome_measured_by_metric (the kept canonical key). Captain's lean =
   // collapse. See UPG_EDGE_MIGRATIONS['0.9.9'].
-  objective_achieved_through_key_result: { forward_verb: "achieved_through", reverse_verb: "achieves", classification: "hierarchy", source_type: "objective", target_type: "key_result" },
-  objective_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "objective", target_type: "metric" },
-  key_result_quantified_by_metric: { forward_verb: "quantified_by", reverse_verb: "quantifies", classification: "hierarchy", source_type: "key_result", target_type: "metric" },
+  objective_achieved_through_key_result: { forward_verb: "achieved_through", reverse_verb: "achieves", classification: "hierarchy", source_type: "objective", target_type: "key_result", cross_product_eligible: true },
+  objective_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "objective", target_type: "metric", cross_product_eligible: true },
+  key_result_quantified_by_metric: { forward_verb: "quantified_by", reverse_verb: "quantifies", classification: "hierarchy", source_type: "key_result", target_type: "metric", cross_product_eligible: true },
   // (UPG-677) key_result_tracked_by_metric retired — near-synonym of
   // key_result_quantified_by_metric (the kept canonical key). Captain's lean =
   // collapse. See UPG_EDGE_MIGRATIONS['0.9.9'].
@@ -1278,7 +1289,7 @@ 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" },
-  strategic_theme_pursues_initiative: { forward_verb: "pursues", reverse_verb: "pursued_under", classification: "hierarchy", source_type: "strategic_theme", target_type: "initiative" },
+  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
   // roadmap_theme sit on different spines (strategy cascade vs roadmap cascade), so
@@ -1306,11 +1317,11 @@ var UPG_EDGE_CATALOG = {
   // surfaces the upward-rollup read. Mirrors `strategic_pillar_organises_
   // strategic_theme` (pillar → theme), completing the strategic cascade:
   // strategic_pillar → strategic_theme → objective → key_result.
-  strategic_theme_delivers_outcome: { forward_verb: "delivers", reverse_verb: "delivered_by", classification: "causal", source_type: "strategic_theme", target_type: "outcome" },
-  strategic_theme_measured_by_key_result: { forward_verb: "measured_by", reverse_verb: "measures", classification: "causal", source_type: "strategic_theme", target_type: "key_result" },
-  strategic_theme_contains_objective: { forward_verb: "contains", reverse_verb: "rolls_up_to", classification: "hierarchy", source_type: "strategic_theme", target_type: "objective" },
+  strategic_theme_delivers_outcome: { forward_verb: "delivers", reverse_verb: "delivered_by", classification: "causal", source_type: "strategic_theme", target_type: "outcome", cross_product_eligible: true },
+  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" },
-  initiative_drives_outcome: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "initiative", target_type: "outcome" },
+  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
   // Wardley-style value chain: need → capability → capability → feature.
@@ -1448,7 +1459,7 @@ var UPG_EDGE_CATALOG = {
   // 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" },
+  product_expresses_brand_identity: { forward_verb: "expresses", reverse_verb: "expressed_by", classification: "semantic", source_type: "product", target_type: "brand_identity", cross_product_eligible: true },
   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" },
@@ -1460,12 +1471,12 @@ var UPG_EDGE_CATALOG = {
   design_component_specified_by_interaction_spec: { forward_verb: "specified_by", reverse_verb: "specifies", classification: "hierarchy", source_type: "design_component", target_type: "interaction_spec" },
   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" },
+  screen_renders_design_component: { forward_verb: "renders", reverse_verb: "rendered_on", classification: "hierarchy", source_type: "screen", target_type: "design_component", cross_product_eligible: true },
   // 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_markets_product: { forward_verb: "markets", reverse_verb: "marketed_by", classification: "semantic", source_type: "screen", target_type: "product", cross_product_eligible: true },
   // 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.
@@ -1481,10 +1492,10 @@ var UPG_EDGE_CATALOG = {
   //     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_targets_competitor: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "semantic", source_type: "screen", target_type: "competitor", cross_product_eligible: true },
+  feature_surfaces_product: { forward_verb: "surfaces", reverse_verb: "surfaced_by", classification: "semantic", source_type: "feature", target_type: "product", cross_product_eligible: true },
+  feature_uses_design_component: { forward_verb: "uses", reverse_verb: "used_by", classification: "semantic", source_type: "feature", target_type: "design_component", cross_product_eligible: true },
+  product_implements_design_system: { forward_verb: "implements", reverse_verb: "implemented_by", classification: "semantic", source_type: "product", target_type: "design_system", cross_product_eligible: true },
   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" },
@@ -2336,10 +2347,10 @@ var UPG_EDGE_CATALOG = {
   experiment_run_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "experiment_run", target_type: "metric" },
   solution_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "solution", target_type: "metric" },
   // ── Cross-domain: Ownership ──────────────────────────────────────────────────
-  node_owned_by_team: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "team" },
+  node_owned_by_team: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "team", cross_product_eligible: true },
   node_owned_by_role: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "role" },
   node_owned_by_stakeholder: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "stakeholder" },
-  node_owned_by_department: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "department" },
+  node_owned_by_department: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "department", cross_product_eligible: true },
   node_owned_by_person: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "node", target_type: "person" },
   // ── Cross-domain: Architecture (DDD) ─────────────────────────────────────────
   // Service, domain_event, domain_entity, aggregate, read_model, api_contract,
@@ -3003,7 +3014,7 @@ var UPG_EDGE_CATALOG = {
   // not the outcome it exists to move; the strategic spine was severed at its
   // anchor (0 outbound to outcome). An objective ADVANCES an outcome. Intra-
   // domain (both in strategy) and directional → causal.
-  objective_advances_outcome: { forward_verb: "advances", reverse_verb: "advanced_by", classification: "causal", source_type: "objective", target_type: "outcome" },
+  objective_advances_outcome: { forward_verb: "advances", reverse_verb: "advanced_by", classification: "causal", source_type: "objective", target_type: "outcome", cross_product_eligible: true },
   // ── F6: Priority 2 — scored / synthesis / verdict dead-end leaves (P-A) ─────
   // desired_outcome (Ulwick-scored: importance × satisfaction) had 0 outbound —
   // the scores could not flow anywhere. An under-served desired_outcome REVEALS
@@ -3086,9 +3097,61 @@ var UPG_EDGE_CATALOG = {
   specification_governed_by_organization: { forward_verb: "governed_by", reverse_verb: "governs", classification: "semantic", source_type: "specification", target_type: "organization" },
   // Operating-lifecycle cross-edges (0.11.6): a product's journey phase realises a canonical
   // operating stage (the cross-surface join key); a stage is measured by a rollup metric (loop close).
-  journey_phase_realises_operating_stage: { forward_verb: "realises", reverse_verb: "realised_by", classification: "cross-domain", source_type: "journey_phase", target_type: "operating_stage" },
-  operating_stage_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "operating_stage", target_type: "metric" }
+  journey_phase_realises_operating_stage: { forward_verb: "realises", reverse_verb: "realised_by", classification: "cross-domain", source_type: "journey_phase", target_type: "operating_stage", cross_product_eligible: true },
+  operating_stage_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "operating_stage", target_type: "metric" },
+  // ── OKR planning coverage (0.17.4) ──────────────────────────────────────────
+  // Reconciling the strategy graph against a live planning doc surfaced texture
+  // the objective — the node every OKR doc organises itself around — could not
+  // reach: cross-team dependencies and deferred (out-of-scope) work.
+  // objective ↔ dependency. Every OKR in the source doc carries a dependency
+  // table ("which other team's work this depends on"). `dependency` (team_org)
+  // already carries dependency_type / criticality / target_date; it was
+  // reachable only from `team`. An objective DEPENDS ON a dependency; the
+  // dependency BLOCKS the objective (explicit mirror, not left implicit).
+  // Cross-domain, not hierarchy: a dependency is parented under its owning team,
+  // so an objective references it laterally rather than containing it. Both are
+  // cross_product_eligible — a Studio objective can depend on a dependency owned
+  // by another team's graph within the portfolio (0.17.3 locked predicate).
+  objective_depends_on_dependency: { forward_verb: "depends_on", reverse_verb: "dependency_of", classification: "cross-domain", source_type: "objective", target_type: "dependency", cross_product_eligible: true },
+  dependency_blocks_objective: { forward_verb: "blocks", reverse_verb: "blocked_by", classification: "cross-domain", source_type: "dependency", target_type: "objective", cross_product_eligible: true },
+  // objective / initiative → strategic_question. A planning doc's "Risks & Open
+  // Questions" section names unresolved coordination questions the plan is
+  // exposed to (who owns a capability across teams after a reorg). The
+  // strategy-domain sibling of research_question / design_question. The question
+  // is raised under (contained by) the objective or initiative that surfaces it,
+  // so hierarchy — mirroring initiative_assumes_assumption. Within-graph: the
+  // question node is authored alongside its objective, so NOT
+  // cross_product_eligible (the cross-team nature lives in the question text, not
+  // in a cross-graph edge).
+  objective_raises_strategic_question: { forward_verb: "raises", reverse_verb: "raised_by", classification: "hierarchy", source_type: "objective", target_type: "strategic_question" },
+  initiative_raises_strategic_question: { forward_verb: "raises", reverse_verb: "raised_by", classification: "hierarchy", source_type: "initiative", target_type: "strategic_question" },
+  // objective → feature / capability (the defer / out-of-scope edge). Every OKR
+  // in the source doc carries an explicit "Out of scope" list, load-bearing for
+  // keeping a quarter from silently expanding (localization deferred to Q4,
+  // another team's feature work parked). Modelled as an edge to the real feature
+  // or capability parked for later, not a scalar exclusion string, so the parked
+  // work stays queryable and connected. The `deferred_to` edge property carries
+  // the temporal target. feature is product_spec (cross-domain); capability is
+  // intra-strategy (semantic). Both cross_product_eligible: deferring another
+  // product's feature or capability, authored in a different graph within the
+  // portfolio, fits the 0.17.3 locked predicate.
+  objective_defers_feature: { forward_verb: "defers", reverse_verb: "deferred_by", classification: "cross-domain", source_type: "objective", target_type: "feature", carries_properties: true, property_schema: DEFER_EDGE_PROPERTY_SCHEMA, cross_product_eligible: true, deliberate_only: true },
+  objective_defers_capability: { forward_verb: "defers", reverse_verb: "deferred_by", classification: "semantic", source_type: "objective", target_type: "capability", carries_properties: true, property_schema: DEFER_EDGE_PROPERTY_SCHEMA, cross_product_eligible: true, deliberate_only: true }
 };
+var UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES = Object.keys(UPG_EDGE_CATALOG).filter(
+  (k) => UPG_EDGE_CATALOG[k].cross_product_eligible === true
+);
+function isCrossProductEligible(type) {
+  const def = UPG_EDGE_CATALOG[type];
+  return def?.cross_product_eligible === true;
+}
+var UPG_DELIBERATE_ONLY_EDGE_TYPES = Object.keys(UPG_EDGE_CATALOG).filter(
+  (k) => UPG_EDGE_CATALOG[k].deliberate_only === true
+);
+function isDeliberateOnlyEdge(type) {
+  const def = UPG_EDGE_CATALOG[type];
+  return def?.deliberate_only === true;
+}
 var UPG_POLYMORPHIC_EDGE_KEYS = [
   // Universal semantic verbs
   "node_informs_node",
@@ -3148,52 +3211,47 @@ function isLegacyProductStage(stage) {
 }
 
 // src/shapes/document.ts
-var UPG_CROSS_EDGE_TYPES = [
+var UPG_CROSS_ONLY_EDGE_TYPES = [
+  // Peer overlap: "these two products share / overlap on this thing." Symmetric,
+  // no canonical instance_of identity. shares_job / shares_need are the job/need
+  // siblings of the persona/competitor/metric peers (connective layer, 0.13.1).
   "shares_persona",
   "shares_competitor",
   "shares_metric",
+  "shares_job",
+  "shares_need",
+  // Product-to-product relationships.
   "depends_on_product",
+  // runtime dependency (built-on / dogfood), not containment
   "cannibalises",
   "succeeds",
   "hosts",
+  // host runs the hosted product inside itself (container -> contained)
+  // OKR / measurement rollup primitives: the cascade ACROSS products (subordinate
+  // -> superior). `contributes_to` rolls a product strategy entity up to a higher-
+  // level one; `rolls_up_to` feeds a product metric into a higher-level north-star.
   "contributes_to",
+  "rolls_up_to",
+  // Canonical instance + area-to-audience: the target lives in the portfolio
+  // `registry` section (`registry/{node_id}`). `instance_of` is same-type
+  // canonical-to-instance; the area edges are minted via `link_area_to_audience`.
   "instance_of",
   "area_serves_persona",
   "area_targets_market_segment",
-  "rolls_up_to",
+  // Foundations (0.9.12): a product-graph entity links to a canonical specification
+  // or primitive in the registry (`registry/{node_id}` target, same shape as
+  // instance_of). Registry-internal spec-to-spec links are catalog edges, not these.
   "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",
-  // 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",
-  // Org-link (0.17.0): dual-registered ownership edges (see UPGCrossEdgeType above).
-  "node_owned_by_team",
-  "node_owned_by_department",
-  // Cross-graph strategy & measurement (0.17.2): dual-registered OKR/measurement
-  // hierarchy edges so the strategy spine can span files (see UPGCrossEdgeType above).
-  "strategic_theme_contains_objective",
-  "objective_achieved_through_key_result",
-  "key_result_quantified_by_metric",
-  "objective_measured_by_metric"
+  "primitive_stored_as_data_type"
+];
+var UPG_CROSS_EDGE_TYPES = [
+  ...UPG_CROSS_ONLY_EDGE_TYPES,
+  ...UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 var UPG_PORTFOLIO_KINDS = ["owned", "watched", "strategic", "internal", "gtm"];
@@ -3461,7 +3519,9 @@ var UPG_VALID_CHILDREN = {
   // where self-nesting genuinely lives, not on `experiment`).
   experiment_run: ["learning", "evidence", "metric", "experiment_run"],
   // ── OKR hierarchy ──────────────────────────────────────────────────────────
-  objective: ["key_result", "metric"],
+  // strategic_question (0.17.4): an open coordination question raised under an
+  // objective (objective_raises_strategic_question, hierarchy).
+  objective: ["key_result", "metric", "strategic_question"],
   key_result: ["metric"],
   // ── Strategic cascade: vision → mission → strategic_pillar → strategic_theme →
   //    { initiative, objective } ───────────────────────────────────────────────
@@ -3486,7 +3546,7 @@ var UPG_VALID_CHILDREN = {
   // catalog (hierarchy, strategic_theme → objective, reverse_verb: rolls_up_to;
   // renamed from objective_rolls_up_to_strategic_theme in UPG-676).
   strategic_theme: ["initiative", "objective"],
-  initiative: ["assumption"],
+  initiative: ["assumption", "strategic_question"],
   // v0.5.2 (UPG-528): capability decomposes into sub-capabilities (Wardley
   // value-chain spine) and is realised by user-facing features. Pairs with
   // `capability_depends_on_capability` and `capability_implemented_by_feature`
@@ -4559,6 +4619,15 @@ var ASSUMPTION_LIFECYCLE = {
     }
   ]
 };
+var STRATEGIC_QUESTION_LIFECYCLE = {
+  entity_type: "strategic_question",
+  initial_phase: "open",
+  terminal_phases: ["resolved"],
+  phases: [
+    { id: "open", label: "Open", description: "The question has been raised but not yet answered. The plan is exposed to it.", transitions_to: ["resolved"] },
+    { id: "resolved", label: "Resolved", description: "The question has been answered; the resolution is captured. The plan is no longer exposed to it. May reopen if the answer unravels.", transitions_to: ["open"] }
+  ]
+};
 var OUTCOME_LIFECYCLE = {
   entity_type: "outcome",
   initial_phase: "identified",
@@ -6236,6 +6305,7 @@ var UPG_LIFECYCLES = [
   INITIATIVE_LIFECYCLE,
   STRATEGIC_PILLAR_LIFECYCLE,
   ASSUMPTION_LIFECYCLE,
+  STRATEGIC_QUESTION_LIFECYCLE,
   FEATURE_AREA_LIFECYCLE,
   FEATURE_LIFECYCLE,
   EPIC_LIFECYCLE,
@@ -12712,6 +12782,15 @@ var UPG_PROPERTY_SCHEMA = {
     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." }
   },
+  // StrategicQuestionProperties: StrategicQuestion entity. An open coordination or
+  // ownership question a plan is exposed to (strategy sibling of research_question /
+  // design_question). `status` is the node lifecycle (open -> resolved).
+  strategic_question: {
+    question: { type: "string", description: "The question itself. Primary content." },
+    context: { type: "string", description: "Context that surfaced the question: the reorg, the boundary, the unowned area." },
+    resolution: { type: "string", description: "The answer, captured when the question moves to `resolved`." },
+    priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance to resolve relative to other open questions." }
+  },
   // 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.
@@ -19740,6 +19819,7 @@ var ENTITY_EMOJI = {
   stakeholder: "\u{1F9D1}\u200D\u{1F4BC}",
   status_report: "\u{1F4C4}",
   strategic_pillar: "\u{1F3DB}\uFE0F",
+  strategic_question: "\u2754",
   strategic_theme: "\u{1F9F5}",
   subscription: "\u{1F502}",
   success_milestone: "\u{1F389}",
@@ -20297,6 +20377,7 @@ var STANDARD_LABELS = {
   value_stream: { alt_labels: ["value chain", "stream"] },
   strategic_pillar: { alt_labels: ["pillar", "foundation"] },
   assumption: { alt_labels: ["belief", "working assumption", "premise"] },
+  strategic_question: { alt_labels: ["open question", "coordination question", "ownership question"] },
   // User layer
   job_step: { alt_labels: ["job stage", "job phase", "job map step"] },
   switching_cost: { alt_labels: ["lock-in", "migration cost", "switching barrier"] },
@@ -21035,6 +21116,30 @@ var UPG_TREE_PATTERNS = [
       metric: [opt("metric"), opt("outcome")]
     },
     natural_depth: 3
+  },
+  {
+    id: "org",
+    label: "Org chart",
+    description: "Departments and the teams they contain, plus the sub-teams nested within those teams. The people-structure org chart, walked by containment (department_contains_team, then team_contains_team). Distinct from product_area, which is the product classification axis, not the org.",
+    region: "operations_quality",
+    gap_policy: "all-optional",
+    anchor_type: "department",
+    // A graph with no department roots at the team (team -> sub-team), reported
+    // anchor_resolved_from: department. A sub-team also renders as a bare team
+    // root when its parent department is not modelled.
+    fallback_anchors: ["team"],
+    child_map: {
+      // department -> team (department_contains_team) is the first level; team ->
+      // team (team_contains_team, 0.17.2) is the second, so a sub-team nested one
+      // level deeper than department_contains_team renders under its parent team.
+      // Self-nesting: the assembler's `seen` set terminates a team -> team cycle
+      // for free (a team met again becomes a shared reference).
+      department: [opt("team")],
+      team: [opt("team")]
+    },
+    // Default to 3 tiers (department -> team -> sub-team); `depth` extends into
+    // deeper team_contains_team nesting.
+    natural_depth: 3
   }
 ];
 var UPG_TREE_PATTERNS_BY_ID = Object.fromEntries(
@@ -22817,25 +22922,34 @@ var STRATEGY_GUIDE = {
   // entries are later additions appended in chronological-introduction
   // order. Placement reflects the order in which they would naturally be
   // authored after the canonical strategy spine.
-  creation_sequence: ["product", "vision", "mission", "outcome", "objective", "key_result", "metric", "metric_quality_assessment", "strategic_theme", "strategic_pillar", "initiative", "capability", "value_stream", "assumption", "decision", "constraint"],
+  creation_sequence: ["product", "vision", "mission", "outcome", "objective", "key_result", "metric", "metric_quality_assessment", "strategic_theme", "strategic_pillar", "initiative", "capability", "value_stream", "assumption", "strategic_question", "decision", "constraint"],
   patterns: [
     {
       name: "Strategic Cascade",
       description: "Vision grounds mission, product pursues outcomes and targets objectives, objectives achieved through key results measured by metrics",
       entity_types: ["vision", "mission", "outcome", "objective", "key_result", "metric"],
       edge_chain: ["product_guided_by_vision", "product_fulfils_mission", "vision_realised_through_mission", "product_pursues_outcome", "product_targets_objective", "objective_achieved_through_key_result", "outcome_measured_by_metric"]
+    },
+    {
+      name: "Rendering the company spine",
+      description: "The company OKR / strategy / north-star spine already renders with get_tree, no new pattern needed: switch to the org_rollup member (the company rollup graph) and run the okr, strategy, or north_star tree pattern there. In a portfolio the spine can span files, a rollup theme laddering into product-graph objectives through the cross-product strategic_theme_contains_objective edge; get_tree walks the active member, so render the rollup for the whole-company view and a product for its slice.",
+      entity_types: ["strategic_theme", "objective", "key_result", "metric"],
+      edge_chain: ["strategic_theme_contains_objective", "objective_achieved_through_key_result", "key_result_quantified_by_metric"]
     }
   ],
   required_bridges: [
     { edge_type: "outcome_reveals_opportunity", target_domain: "discovery", when: "Outcomes should connect to the opportunities that deliver them" },
     { edge_type: "outcome_delivered_by_feature", target_domain: "product_spec", when: "Strategic outcomes should decompose into shipped features" },
-    { edge_type: "assumption_becomes_hypothesis", target_domain: "validation", when: "Risky assumptions should become testable hypotheses" }
+    { edge_type: "assumption_becomes_hypothesis", target_domain: "validation", when: "Risky assumptions should become testable hypotheses" },
+    { edge_type: "objective_depends_on_dependency", target_domain: "team_org", when: "An objective that hinges on cross-team work should name the dependency it is exposed to" },
+    { edge_type: "objective_defers_feature", target_domain: "product_spec", when: "Work an objective explicitly puts out of scope for now should point at the deferred feature with a deferred_to period, not silently vanish from the quarter" }
   ],
   anti_patterns: [
     { description: "Outcomes without metrics. Measurement is the signal an outcome happened." },
     { description: "Objectives without key results: an objective without measurement is a wish" },
     { description: "Too many strategic themes: focus beats breadth, aim for 2-4 active themes" },
-    { description: "Constraints without an origin: a qualitative guardrail lives on a constraint, so set constraint_origin to say where it comes from. internal marks a self-imposed principle or operating tenet the team commits to; external marks a limit, requirement, or ceiling imposed from outside (a regulation, a budget cap, a platform bound)." }
+    { description: "Constraints without an origin: a qualitative guardrail lives on a constraint, so set constraint_origin to say where it comes from. internal marks a self-imposed principle or operating tenet the team commits to; external marks a limit, requirement, or ceiling imposed from outside (a regulation, a budget cap, a platform bound)." },
+    { description: "Overloading assumption for open questions: an assumption is a premise the plan is built on and resolves by being tested (assumption_becomes_hypothesis). An unresolved coordination or ownership question the plan is exposed to (who owns a capability across teams, where a boundary falls after a reorg) is a strategic_question, raised under the objective or initiative it hangs off. Do not force one into the other." }
   ]
 };
 var PRODUCT_SPEC_GUIDE = {
@@ -26888,6 +27002,10 @@ var UPG_REGIONS = [
         type: "assumption",
         role: "leaf"
       },
+      {
+        type: "strategic_question",
+        role: "leaf"
+      },
       {
         type: "constraint",
         role: "leaf"
@@ -26913,6 +27031,8 @@ var UPG_REGIONS = [
       "strategic_pillar_decided_via_decision",
       "strategic_theme_pursues_initiative",
       "initiative_assumes_assumption",
+      "objective_raises_strategic_question",
+      "initiative_raises_strategic_question",
       "initiative_drives_outcome",
       "objective_achieved_through_key_result",
       "objective_measured_by_metric",
@@ -29597,7 +29717,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.17.2";
+var UPG_VERSION = "0.17.4";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -29670,6 +29790,7 @@ export {
   COVERAGE_ANTI_PATTERNS,
   DEFAULT_ENTITY_EMOJI,
   DEFERRED_PROPOSED_BY_CONTRACT,
+  DEFER_EDGE_PROPERTY_SCHEMA,
   DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK,
   ENGINEERING_PLATFORM_PLAYBOOK,
   ENTITY_EMOJI,
@@ -29699,6 +29820,9 @@ export {
   UPG_CONTAINMENT_FREE_TYPES,
   UPG_COUNT_BENCHMARKS,
   UPG_CROSS_EDGE_TYPES,
+  UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES,
+  UPG_CROSS_ONLY_EDGE_TYPES,
+  UPG_DELIBERATE_ONLY_EDGE_TYPES,
   UPG_DEPRECATED_TYPES,
   UPG_DOMAINS,
   UPG_DOMAIN_ACTIVATION,
@@ -29829,6 +29953,8 @@ export {
   isCanonical,
   isCanonicalProductStage,
   isContainmentFreeType,
+  isCrossProductEligible,
+  isDeliberateOnlyEdge,
   isDeprecatedType,
   isDomainGuideStep,
   isEntitySequenceStep,