@unified-product-graph/core 0.17.1 → 0.17.3

package/dist/index.js

@@ -1029,7 +1029,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 +1147,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 +1188,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 +1247,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 +1278,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 +1306,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 +1448,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 +1460,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 +1481,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" },
@@ -2068,6 +2068,16 @@ var UPG_EDGE_CATALOG = {
   // UPG_EDGE_MIGRATIONS['0.9.9'].
   product_organised_into_department: { forward_verb: "organised_into", reverse_verb: "organises", classification: "hierarchy", source_type: "product", target_type: "department" },
   department_contains_team: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "department", target_type: "team" },
+  // Second-level team nesting (0.17.2). department_contains_team covers the first
+  // level (department -> team); this covers a team nested inside another team in
+  // the same department (a sub-team or squad under a parent team). Modelled
+  // parent -> child like feature_area_contains_feature_area, so the org map builds
+  // correctly in get_tree (which reads source as the parent); the reverse verb
+  // belongs_to gives the upward "this team is part of that team" read. The
+  // same-department expectation is advisory (a write-time warning), never a hard
+  // block; cross-department reporting lines belong to person_reports_to_person at
+  // the individual level.
+  team_contains_team: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "team", target_type: "team" },
   department_includes_stakeholder: { forward_verb: "includes", reverse_verb: "included_in", classification: "hierarchy", source_type: "department", target_type: "stakeholder" },
   // NOTE: `person` is a containment-free entity type (see
   // UPG_CONTAINMENT_FREE_TYPES in grammar/hierarchy.ts). It is referenced
@@ -2326,10 +2336,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,
@@ -2993,7 +3003,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
@@ -3076,9 +3086,16 @@ 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" },
+  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" }
 };
+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_POLYMORPHIC_EDGE_KEYS = [
   // Universal semantic verbs
   "node_informs_node",
@@ -3138,46 +3155,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"
+  "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"];
@@ -3631,7 +3649,11 @@ var UPG_VALID_CHILDREN = {
     "skill",
     "ceremony",
     "capacity_plan",
-    "decision"
+    "decision",
+    // Self-nesting (0.17.2): a parent team contains its sub-teams / squads, one
+    // level below department_contains_team. Backs team_contains_team. Mirrors
+    // feature_area_contains_feature_area (same-type child listed last).
+    "team"
   ],
   // ── Data & Analytics hierarchy ───────────────────────────────────────────────
   data_source: ["metric", "data_pipeline", "data_lineage", "event_schema"],
@@ -10624,6 +10646,7 @@ var UPG_PROPERTY_SCHEMA = {
   // ConstraintProperties: Constraint: a named limitation or boundary on product creation.
   constraint: {
     constraint_kind: { type: "string", enum: ["resource", "technical", "regulatory", "temporal", "compliance", "other"], description: "Limitation category" },
+    constraint_origin: { type: "string", enum: ["internal", "external"], description: "Provenance: internal (a self-imposed principle or operating tenet) or external (a limit, requirement, or ceiling imposed from outside)." },
     constraint_status: { type: "string", enum: ["binding", "advisory", "lifted"], description: "Whether binding, advisory, or lifted" },
     rule_strength: { type: "string", enum: ["must", "must_not", "exception", "warning", "guideline"], description: "Enforcement strictness. Reuses the governance/guideline rule vocabulary." },
     source: { type: "string", description: "Free-text origin: policy document, regulation, stakeholder, technical doc." },
@@ -21014,6 +21037,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(
@@ -22803,6 +22850,12 @@ var STRATEGY_GUIDE = {
       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: [
@@ -22813,7 +22866,8 @@ var STRATEGY_GUIDE = {
   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: "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)." }
   ]
 };
 var PRODUCT_SPEC_GUIDE = {
@@ -23364,6 +23418,12 @@ var TEAM_ORG_GUIDE = {
       description: "Teams are staffed with roles, target OKRs, reflect in retrospectives, and are blocked by dependencies",
       entity_types: ["team", "role", "team_okr", "retrospective", "dependency"],
       edge_chain: ["team_staffed_with_role", "team_targets_team_okr", "team_reflects_in_retrospective", "dependency_blocks_team"]
+    },
+    {
+      name: "Org Nesting",
+      description: "A department contains its teams; a parent team contains its sub-teams or squads one level deeper. Keep a sub-team in the same department as its parent team. Cross-department reporting lines are modelled at the individual level with person_reports_to_person, not by nesting a team under a parent in another department.",
+      entity_types: ["department", "team"],
+      edge_chain: ["department_contains_team", "team_contains_team"]
     }
   ],
   required_bridges: [
@@ -23374,6 +23434,7 @@ var TEAM_ORG_GUIDE = {
     { description: "Teams without OKRs: every team needs clear goals" },
     { description: "Dependencies without both teams linked: a dependency must connect blocker and blocked" },
     { description: "Retrospectives without action items: reflection without action is just venting" },
+    { description: "Nesting a sub-team under a parent team in a different department: a team_contains_team nesting should stay within one department (both teams sharing a department_contains_team parent). A cross-department nesting is almost always a modelling error; model a cross-department reporting line at the individual level with person_reports_to_person instead." },
     { description: "Double-modelling the org as product_area and team_org: a product_area is the classification axis ON products (which area a product belongs to, the axis used to group products); a team_org department/team is the people structure (the org chart, who reports to whom). Use product_area to classify products and department/team for the org chart, and relate them through the team that owns an area rather than restating one as the other." }
   ]
 };
@@ -26096,7 +26157,7 @@ var UPG_ANTI_PATTERNS = [
   {
     id: "competitors-missing-past-validation",
     name: "Competitor catalogue empty past validation",
-    description: "The graph has zero competitor entities at validation stage or later. Past concept, the absence of named competitors usually means alternatives haven't been thought through, not that none exist.",
+    description: "The graph has zero competitor entities at build stage or later. Past validation, the absence of named competitors usually means alternatives haven't been thought through, not that none exist. A graph still at concept or validation is exempt: cataloguing the field can wait until you commit to building.",
     structured_condition: {
       check: {
         type: "benchmark",
@@ -26106,14 +26167,18 @@ var UPG_ANTI_PATTERNS = [
     },
     why_it_matters: "Without competitors in the graph, positioning, differentiation, and switching-cost analysis lack referents. The team is reasoning in a vacuum.",
     remediation: "Catalogue the 3\u20135 closest alternatives users would pick today. Use `/upg-compete` to author.",
-    stages: ["validation", "build", "beta", "launch", "growth", "mature"],
+    // Fires from build onward, matching the name (past the validation stage). A
+    // concept or validation graph is still framing the problem; holding it to a
+    // competitor benchmark there is the false alarm this anti-pattern caused on
+    // legitimately-young graphs.
+    stages: ["build", "beta", "launch", "growth", "mature"],
     severity: "medium",
     source: { kind: "industry_practice", category: "product_strategy" }
   },
   {
     id: "persona-count-below-stage-benchmark",
     name: "Persona count below stage benchmark",
-    description: "The graph has fewer personas than the stage-appropriate benchmark expects. Persona under-coverage signals the team has not segmented its audience.",
+    description: "The graph has fewer personas than the stage-appropriate benchmark expects, from beta onward. Persona under-coverage at that point signals the team has not segmented its audience. Concept through build are exempt: the sound move there is to start with one beachhead persona and expand as you find fit.",
     structured_condition: {
       check: {
         type: "benchmark",
@@ -26121,9 +26186,13 @@ var UPG_ANTI_PATTERNS = [
         comparison: "below_min"
       }
     },
-    why_it_matters: 'A graph with one persona past validation is usually carrying an unexamined "everyone is the same user" assumption.',
+    why_it_matters: "A graph still on a single persona by beta is usually carrying an unexamined assumption that every user is the same.",
     remediation: "Add personas representing the next 1\u20132 most distinct user segments. Use `/upg-new-persona`.",
-    stages: ["validation", "build", "beta", "launch", "growth", "mature"],
+    // Fires from beta onward. The persona benchmark expects 2+ from validation,
+    // but the canonical beachhead move is to start with one persona and expand as
+    // fit is found, so holding a build-stage graph to a multi-persona bar is a
+    // false alarm. By beta an unsegmented audience is a real signal.
+    stages: ["beta", "launch", "growth", "mature"],
     severity: "medium",
     source: { kind: "practitioner", attribution: "Alan Cooper, The Inmates Are Running the Asylum" }
   },
@@ -26148,7 +26217,7 @@ var UPG_ANTI_PATTERNS = [
   {
     id: "single-domain-graph",
     name: "Single-domain graph",
-    description: "The graph has more than five entities but they all live in a single UPG domain. A real product spans multiple domains; a single-domain graph is usually a deep notebook in one corner with the rest of the picture missing.",
+    description: "The graph has more than five entities but they all live in a single UPG domain, at beta stage or later. A real product spans multiple domains by then; a single-domain graph that far along is usually a deep notebook in one corner with the rest of the picture missing. Concept through build are exempt: a graph legitimately starts deep in one domain and broadens as it matures.",
     structured_condition: {
       operator: "and",
       checks: [
@@ -26158,7 +26227,11 @@ var UPG_ANTI_PATTERNS = [
     },
     why_it_matters: 'Single-domain coverage prevents cross-domain reasoning. The graph cannot answer questions like "which feature serves which persona?" or "which experiment validates which hypothesis?".',
     remediation: "Identify the next adjacent domain (usually `user`, `validation`, or `product_spec`) and add 2\u20133 anchor entities to bridge.",
-    stages: ["validation", "build", "beta", "launch"],
+    // Fires from beta onward. Early on a graph is legitimately deep in one domain
+    // (a discovery notebook, a thin internal tool); only once it reaches beta is
+    // single-domain coverage a smell rather than a normal starting shape. Extends
+    // through growth and mature, where a single-domain graph is most telling.
+    stages: ["beta", "launch", "growth", "mature"],
     severity: "medium",
     source: { kind: "fundamental" }
   },
@@ -29556,7 +29629,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.17.1";
+var UPG_VERSION = "0.17.3";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -29658,6 +29731,8 @@ export {
   UPG_CONTAINMENT_FREE_TYPES,
   UPG_COUNT_BENCHMARKS,
   UPG_CROSS_EDGE_TYPES,
+  UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES,
+  UPG_CROSS_ONLY_EDGE_TYPES,
   UPG_DEPRECATED_TYPES,
   UPG_DOMAINS,
   UPG_DOMAIN_ACTIVATION,
@@ -29788,6 +29863,7 @@ export {
   isCanonical,
   isCanonicalProductStage,
   isContainmentFreeType,
+  isCrossProductEligible,
   isDeprecatedType,
   isDomainGuideStep,
   isEntitySequenceStep,