@unified-product-graph/core 0.9.5 → 0.9.7

package/dist/index.cjs

@@ -35,6 +35,7 @@ __export(index_exports, {
   PRODUCT_DELIVERY_PLAYBOOK: () => PRODUCT_DELIVERY_PLAYBOOK,
   PROPERTY_SCALE_MAP: () => PROPERTY_SCALE_MAP,
   REFLECT_MODES: () => REFLECT_MODES,
+  REGISTRY_PRODUCT_ID: () => REGISTRY_PRODUCT_ID,
   STRATEGY_OUTCOMES_PLAYBOOK: () => STRATEGY_OUTCOMES_PLAYBOOK,
   UPG_ACTIVE_TYPES: () => UPG_ACTIVE_TYPES,
   UPG_ANTI_PATTERNS: () => UPG_ANTI_PATTERNS,
@@ -706,7 +707,9 @@ var UPG_ENTITY_META = [
   { name: "objective", type_id: "ent_004", maturity: "stable", since: "0.1.0" },
   { name: "key_result", type_id: "ent_005", maturity: "stable", since: "0.1.0" },
   { name: "metric", type_id: "ent_006", maturity: "stable", since: "0.1.0" },
-  { name: "metric_quality_assessment", type_id: "ent_339", maturity: "proposed", since: "0.2.2" },
+  // F7 (UPG-673): graduated proposed → stable at v0.9.x — proposed since 0.2.2,
+  // the metric-quality assessment artefact is settled with no open restructure.
+  { name: "metric_quality_assessment", type_id: "ent_339", maturity: "stable", since: "0.2.2" },
   { name: "vision", type_id: "ent_007", maturity: "stable", since: "0.1.0" },
   { name: "mission", type_id: "ent_008", maturity: "stable", since: "0.1.0" },
   { name: "strategic_theme", type_id: "ent_009", maturity: "stable", since: "0.1.0" },
@@ -763,8 +766,11 @@ var UPG_ENTITY_META = [
   { name: "market_segment", type_id: "ent_036", maturity: "stable", since: "0.1.0" },
   { name: "competitive_analysis", type_id: "ent_037", maturity: "stable", since: "0.1.0" },
   // Classification taxonomy hosted by competitive_analysis.
-  { name: "classification_axis", type_id: "ent_346", maturity: "proposed", since: "0.4.0" },
-  { name: "classification_value", type_id: "ent_347", maturity: "proposed", since: "0.4.0" },
+  // F7 (UPG-673): graduated proposed → stable at v0.9.x — two minor releases
+  // stable since 0.4.0, the taxonomy-axis/value pair backs the competitive-
+  // analysis classification spine with no open rename/restructure ticket.
+  { name: "classification_axis", type_id: "ent_346", maturity: "stable", since: "0.4.0" },
+  { name: "classification_value", type_id: "ent_347", maturity: "stable", since: "0.4.0" },
   // ── UX Research ──
   { name: "research_study", type_id: "ent_038", maturity: "stable", since: "0.1.0" },
   { name: "research_insight", type_id: "ent_039", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "insight" },
@@ -804,8 +810,10 @@ var UPG_ENTITY_META = [
   { name: "journey_phase", type_id: "ent_330", maturity: "proposed", since: "0.2.0" },
   { name: "journey_action", type_id: "ent_331", maturity: "proposed", since: "0.2.0" },
   { name: "design_decision", type_id: "ent_319", maturity: "deprecated", since: "0.2.0", deprecated_in: "0.2.0", replacement: "decision" },
-  { name: "brand_logo", type_id: "ent_321", maturity: "proposed", since: "0.2.0" },
-  { name: "brand_imagery", type_id: "ent_322", maturity: "proposed", since: "0.2.0" },
+  // F7 (UPG-673): graduated proposed → stable at v0.9.x — proposed since 0.2.0,
+  // the brand-identity set (logo + imagery) is settled with no open rename.
+  { name: "brand_logo", type_id: "ent_321", maturity: "stable", since: "0.2.0" },
+  { name: "brand_imagery", type_id: "ent_322", maturity: "stable", since: "0.2.0" },
   // ── Product Spec ──
   { name: "feature_area", type_id: "ent_314", maturity: "stable", since: "0.1.0" },
   { name: "feature", type_id: "ent_071", maturity: "stable", since: "0.1.0" },
@@ -821,6 +829,15 @@ var UPG_ENTITY_META = [
   // alias. `story_task` (the original work half) was already collapsed into
   // canonical `task` at v0.4.0. So the canonical shape is: user_story (statement)
   // + task (work), linked by `task_implements_user_story`.
+  //
+  // F7 (UPG-673) — DEFERRED, deliberately kept `proposed`. The audit flagged
+  // user_story as a stable-spine candidate, but the v0.7.0 re-canon contract
+  // (UPG-571) freezes maturity at `proposed` until the re-canonicalised name
+  // has soaked across a full migration window. `user-story-split.test.ts`
+  // ("user_story is canonical again (ent_073, proposed, not deprecated)")
+  // 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: "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" },
@@ -1837,8 +1854,11 @@ var UPG_EDGE_CATALOG = {
   value_proposition_targets_persona_cross_domain: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "value_proposition", target_type: "persona" },
   revenue_stream_drives_metric: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "revenue_stream", target_type: "metric" },
   // Ring 5 structural edges
-  funnel_step_maps_to_journey_step: { forward_verb: "maps_to", reverse_verb: "mapped_by", classification: "cross-domain", source_type: "funnel", target_type: "journey_step" },
-  customer_journey_stage_contains_funnel_step: { forward_verb: "contains", reverse_verb: "contained_in", classification: "cross-domain", source_type: "customer_journey_stage", target_type: "funnel" },
+  // (UPG-668, P-I) These three edges name `funnel_step` but were typed against
+  // `funnel`, so they resolved from the wrong side and were invisible on the
+  // funnel_step card. Repointed to `funnel_step`; keys unchanged.
+  funnel_step_maps_to_journey_step: { forward_verb: "maps_to", reverse_verb: "mapped_by", classification: "cross-domain", source_type: "funnel_step", target_type: "journey_step" },
+  customer_journey_stage_contains_funnel_step: { forward_verb: "contains", reverse_verb: "contained_in", classification: "cross-domain", source_type: "customer_journey_stage", target_type: "funnel_step" },
   customer_journey_stage_spans_journey_step: { forward_verb: "spans", reverse_verb: "spanned_by", classification: "cross-domain", source_type: "customer_journey_stage", target_type: "journey_step" },
   dependency_blocks_team: { forward_verb: "blocks", reverse_verb: "blocked_by", classification: "cross-domain", source_type: "dependency", target_type: "team" },
   dependency_depends_on_team: { forward_verb: "depends_on", reverse_verb: "depended_on_by", classification: "cross-domain", source_type: "dependency", target_type: "team" },
@@ -1891,7 +1911,7 @@ var UPG_EDGE_CATALOG = {
   positioning_within_market_segment: { forward_verb: "within", reverse_verb: "positioned_by", classification: "cross-domain", source_type: "positioning", target_type: "market_segment" },
   ideal_customer_profile_targets_market_segment: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "ideal_customer_profile", target_type: "market_segment" },
   launch_amplified_by_marketing_channel: { forward_verb: "amplified_by", reverse_verb: "amplifies", classification: "cross-domain", source_type: "launch", target_type: "marketing_channel" },
-  sales_motion_qualifies_via_funnel_step: { forward_verb: "qualifies_via", reverse_verb: "qualifies_for", classification: "cross-domain", source_type: "sales_motion", target_type: "funnel" },
+  sales_motion_qualifies_via_funnel_step: { forward_verb: "qualifies_via", reverse_verb: "qualifies_for", classification: "cross-domain", source_type: "sales_motion", target_type: "funnel_step" },
   objection_sourced_from_quote: { forward_verb: "sourced_from", reverse_verb: "surfaced_objection", classification: "cross-domain", source_type: "objection", target_type: "quote" },
   proof_point_derived_from_evidence: { forward_verb: "derived_from", reverse_verb: "evidences", classification: "cross-domain", source_type: "proof_point", target_type: "evidence" },
   proof_point_derived_from_insight: { forward_verb: "derived_from", reverse_verb: "evidences", classification: "cross-domain", source_type: "proof_point", target_type: "insight" },
@@ -2905,7 +2925,104 @@ var UPG_EDGE_CATALOG = {
   // to `journey_step_reveals_need` (existing); both express "what
   // research surfaces at this step". Useful for any journey-based
   // research method (CX mapping, service blueprint, behavioural cohort).
-  journey_step_yields_observation: { forward_verb: "yields", reverse_verb: "yielded_in", classification: "cross-domain", source_type: "journey_step", target_type: "observation" }
+  journey_step_yields_observation: { forward_verb: "yields", reverse_verb: "yielded_in", classification: "cross-domain", source_type: "journey_step", target_type: "observation" },
+  // ── Part 11: F6 (UPG-672) dead-end & missing-bridge pass ────────────────────
+  // P-A (scored / synthesis / verdict leaves with 0 outbound) + P-D (missing
+  // forward bridges) from the 36-domain wiring audit. Every edge below closes a
+  // confirmed dead-end or missing direction. Naming respects the F2 prefix gate
+  // (key begins with its `source_type` as a whole token) and the F3 dup gate (no
+  // source→target pair already in the catalog). Verified against the catalog at
+  // build time; see the F6 commit body for the audit ledger references.
+  // ── F6: Priority 1 — both-sides-verified cross-domain bridges ──────────────
+  // data_classification ↔ privacy_policy (security SEC-3/L5 + legal). The
+  // classification leaf reached only data_source; it could not reach the policy
+  // that governs how it must be handled. A privacy_policy GOVERNS a data
+  // classification (sets retention / handling rules for that sensitivity tier).
+  data_classification_governed_by_privacy_policy: { forward_verb: "governed_by", reverse_verb: "governs", classification: "cross-domain", source_type: "data_classification", target_type: "privacy_policy" },
+  // design_component → a11y conformance (design_system DS-3 + accessibility A).
+  // The whole conformance DIRECTION was missing: a11y_issue → design_component
+  // existed (defect points back), but no component → standard/guideline link
+  // expressing "this component CONFORMS TO this rule". Both the testable
+  // standard and the human-readable guideline are valid conformance targets.
+  design_component_conforms_to_a11y_standard: { forward_verb: "conforms_to", reverse_verb: "governs_conformance_of", classification: "cross-domain", source_type: "design_component", target_type: "a11y_standard" },
+  design_component_conforms_to_a11y_guideline: { forward_verb: "conforms_to", reverse_verb: "governs_conformance_of", classification: "cross-domain", source_type: "design_component", target_type: "a11y_guideline" },
+  // feature_request → feature ship-closure (feedback + product_spec). A request
+  // could reach an opportunity but never the feature that ships it, so the loop
+  // from "user asked" to "we built it" had no closing edge. A feature_request
+  // BECOMES a feature when the team commits to building it.
+  feature_request_becomes_feature: { forward_verb: "becomes", reverse_verb: "originated_from", classification: "cross-domain", source_type: "feature_request", target_type: "feature" },
+  // objective → outcome (OKR spine). objective reached key_result and metric but
+  // 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" },
+  // ── 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
+  // an opportunity, and is QUANTIFIED BY the metric that tracks its satisfaction.
+  desired_outcome_reveals_opportunity: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "desired_outcome", target_type: "opportunity" },
+  desired_outcome_quantified_by_metric: { forward_verb: "quantified_by", reverse_verb: "quantifies", classification: "cross-domain", source_type: "desired_outcome", target_type: "metric" },
+  // feasibility_study + design_sprint: discovery VERDICTS with 0 outbound — they
+  // could not reach the decision, solution, or learning they exist to produce.
+  // A study/sprint INFORMS a decision, RECOMMENDS a solution, and PRODUCES a
+  // learning. solution is intra-discovery (semantic); decision (strategy) and
+  // learning (validation) are cross-domain.
+  feasibility_study_informs_decision: { forward_verb: "informs", reverse_verb: "informed_by", classification: "cross-domain", source_type: "feasibility_study", target_type: "decision" },
+  feasibility_study_recommends_solution: { forward_verb: "recommends", reverse_verb: "recommended_by", classification: "semantic", source_type: "feasibility_study", target_type: "solution" },
+  feasibility_study_produces_learning: { forward_verb: "produces", reverse_verb: "produced_by", classification: "cross-domain", source_type: "feasibility_study", target_type: "learning" },
+  design_sprint_informs_decision: { forward_verb: "informs", reverse_verb: "informed_by", classification: "cross-domain", source_type: "design_sprint", target_type: "decision" },
+  design_sprint_recommends_solution: { forward_verb: "recommends", reverse_verb: "recommended_by", classification: "semantic", source_type: "design_sprint", target_type: "solution" },
+  design_sprint_produces_learning: { forward_verb: "produces", reverse_verb: "produced_by", classification: "cross-domain", source_type: "design_sprint", target_type: "learning" },
+  // affinity_cluster → observation (user_research). A cluster synthesised an
+  // insight but could not OWN the raw observations it groups; the cluster's
+  // membership was unrepresentable. Intra-domain ownership → hierarchy.
+  affinity_cluster_groups_observation: { forward_verb: "groups", reverse_verb: "grouped_in", classification: "hierarchy", source_type: "affinity_cluster", target_type: "observation" },
+  // feedback_theme → opportunity (feedback). A theme validated needs and
+  // surfaced insights but could not point at the opportunity it implies — the
+  // theme could not become actionable discovery input.
+  feedback_theme_reveals_opportunity: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "feedback_theme", target_type: "opportunity" },
+  // competitor_feature → capability (market_intelligence). A competitor feature
+  // inspired our solution/feature but could not map to the capability it
+  // demonstrates — competitive capability benchmarking was unrepresentable.
+  competitor_feature_benchmarks_capability: { forward_verb: "benchmarks", reverse_verb: "benchmarked_by", classification: "cross-domain", source_type: "competitor_feature", target_type: "capability" },
+  // switching_cost → competitor (user). A switching cost is the friction of
+  // leaving an incumbent, but the leaf had 0 outbound — it could not name the
+  // competitor it locks the user into. It LOCKS IN a competitor.
+  switching_cost_locks_in_competitor: { forward_verb: "locks_in", reverse_verb: "locked_in_by", classification: "cross-domain", source_type: "switching_cost", target_type: "competitor" },
+  // ── F6: region tail — confirmed dead-end leaves across remaining domains ────
+  // test_result (testing) had 0 outbound — a failing result could not file the
+  // defect it found. A test_result REPORTS a bug.
+  test_result_reports_bug: { forward_verb: "reports", reverse_verb: "reported_by", classification: "cross-domain", source_type: "test_result", target_type: "bug" },
+  // content_piece → social_post (content → marketing). Content reached messaging
+  // and campaigns but not the social post it is repurposed into — the atomisation
+  // step had no edge.
+  content_piece_repurposed_as_social_post: { forward_verb: "repurposed_as", reverse_verb: "repurposed_from", classification: "cross-domain", source_type: "content_piece", target_type: "social_post" },
+  // translation_key (localisation) had 0 outbound — it could neither reach the
+  // content it localises nor the locale it targets. Both bridges close the leaf.
+  // translation_key → content_piece is cross-domain; → locale is intra-domain.
+  translation_key_localises_content_piece: { forward_verb: "localises", reverse_verb: "localised_by", classification: "cross-domain", source_type: "translation_key", target_type: "content_piece" },
+  translation_key_targets_locale: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "semantic", source_type: "translation_key", target_type: "locale" },
+  // partner_revenue_share → revenue_stream (ecosystem → business_model). The
+  // share governed a partner tier but never fed the revenue stream it
+  // contributes to — partner economics could not roll up to the model.
+  partner_revenue_share_feeds_revenue_stream: { forward_verb: "feeds", reverse_verb: "fed_by", classification: "cross-domain", source_type: "partner_revenue_share", target_type: "revenue_stream" },
+  // retrospective (team_org) had 0 outbound — its outputs (learnings, decisions/
+  // action items) could not leave the ceremony. A retrospective PRODUCES a
+  // learning and YIELDS a decision. Both targets cross-domain.
+  retrospective_produces_learning: { forward_verb: "produces", reverse_verb: "produced_in", classification: "cross-domain", source_type: "retrospective", target_type: "learning" },
+  retrospective_yields_decision: { forward_verb: "yields", reverse_verb: "decided_in", classification: "cross-domain", source_type: "retrospective", target_type: "decision" },
+  // status_report → milestone (program_mgmt). A report had 0 outbound; it could
+  // not name the milestone whose status it reports. Intra-domain → semantic.
+  status_report_reports_on_milestone: { forward_verb: "reports_on", reverse_verb: "reported_in", classification: "semantic", source_type: "status_report", target_type: "milestone" },
+  // quote_document → deal (sales). A quote had 0 outbound; it could not advance
+  // the deal it prices. Intra-domain and directional → causal.
+  quote_document_advances_deal: { forward_verb: "advances", reverse_verb: "advanced_by", classification: "causal", source_type: "quote_document", target_type: "deal" },
+  // data_quality_rule → data_source (data_analytics). A quality rule had 0
+  // outbound; it could not name the source it governs. Intra-domain → semantic.
+  data_quality_rule_governs_data_source: { forward_verb: "governs", reverse_verb: "governed_by", classification: "semantic", source_type: "data_quality_rule", target_type: "data_source" },
+  // press_release → launch (marketing → go_to_market). A press release had 0
+  // outbound; it could not name the launch it announces.
+  press_release_announces_launch: { forward_verb: "announces", reverse_verb: "announced_by", classification: "cross-domain", source_type: "press_release", target_type: "launch" }
 };
 var UPG_POLYMORPHIC_EDGE_KEYS = [
   // Universal semantic verbs
@@ -2968,8 +3085,10 @@ var UPG_CROSS_EDGE_TYPES = [
   "cannibalises",
   "succeeds",
   "hosts",
-  "contributes_to"
+  "contributes_to",
+  "instance_of"
 ];
+var REGISTRY_PRODUCT_ID = "registry";
 
 // src/registry/entity-type-resolution.ts
 var TYPES = getTypes();
@@ -3252,7 +3371,11 @@ var UPG_VALID_CHILDREN = {
     "survey_response"
   ],
   observation: ["quote"],
-  affinity_cluster: ["insight"],
+  // F6 (UPG-672): affinity_cluster owns the observations it groups, in addition
+  // to the insights it synthesises. Pairs with `affinity_cluster_groups_observation`
+  // in the edge catalog (hierarchy). An observation can be both directly owned by
+  // its research_study and grouped under an affinity_cluster (multi-parent grammar).
+  affinity_cluster: ["insight", "observation"],
   // insight refines into insight; a raw insight can be distilled
   // into a more specific insight (refines_into chain).
   // v0.5.8 (UPG-528 Part 2d): insights own their evidencing quotes;
@@ -10470,6 +10593,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // LearningPathProperties: Learning path.
   learning_path: {
+    path_order: { type: "number", description: "Display order of this path within a curriculum or program (0-indexed). The scalar ordering convention shared with `journey_step.step_order` and `journey_action.action_order` (UPG-663 / UPG-674). Makes a learning_path a deterministically orderable sequence among sibling paths rather than a star." },
     path_difficulty: { type: "string", enum: ["beginner", "intermediate", "advanced"], description: "Overall difficulty level of the learning path" },
     item_count: { type: "number", description: "Number of items (tutorials, videos, etc.) in the path" },
     estimated_hours: { type: "number", description: "Estimated total hours to complete the path" },
@@ -10619,6 +10743,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // MilestoneProperties: Milestone.
   milestone: {
+    milestone_order: { type: "number", description: "Display order of this milestone within its parent project (0-indexed). The scalar ordering convention shared with `journey_step.step_order` and `journey_action.action_order` (UPG-663 / UPG-674). Orders the delivery milestones a project moves through, independent of `due_date`." },
     due_date: { type: "string", description: "Target due date (ISO format)" },
     met_on_time: { type: "boolean", description: "Whether the milestone was met on time" }
   },
@@ -10823,6 +10948,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // PartnerTierProperties: Partner tier.
   partner_tier: {
+    tier_order: { type: "number", description: "Display order of this tier among sibling partner tiers (1 = first tier shown). Mirrors `pricing_tier.tier_order`; part of the spec-wide `*_order` sequence convention (UPG-663 / UPG-674). Distinct from `tier_level`, which is a prestige rank, not a presentation order." },
     tier_level: { type: "number", description: "Numeric rank of the tier (higher = more prestigious)" },
     requirements: { type: "string[]", description: "What a partner must achieve to reach this tier" },
     benefits: { type: "string[]", description: "Benefits granted at this tier level" }
@@ -11245,6 +11371,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // ScreenStateProperties: Specific state of a screen.
   screen_state: {
+    state_order: { type: "number", description: "Display order of this state within its parent screen (0-indexed). The scalar ordering convention shared with `journey_step.step_order` and `journey_action.action_order` (UPG-663 / UPG-674). Orders the states a screen moves through (e.g. skeleton, loading, populated)." },
     state_name: { type: "string", enum: ["empty", "loading", "error", "populated", "skeleton", "partial"], description: "State" },
     trigger: { type: "string", description: "Cause for entering this state" },
     condition: { type: "string", description: "Data or environmental condition the state represents" },
@@ -11757,6 +11884,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // UserFlowProperties: User flow.
   user_flow: {
+    flow_order: { type: "number", description: "Display order of this flow among sibling flows (0-indexed). The scalar ordering convention shared with `journey_step.step_order` and `journey_action.action_order` (UPG-663 / UPG-674). The free-text `steps` array below still captures the within-flow narrative; this scalar makes the flow itself a deterministically orderable sibling." },
     trigger: { type: "string", description: "Initiating event" },
     steps: { type: "string[]", description: "Ordered steps" },
     success_state: { type: "string", description: "Successful completion" },
@@ -17820,7 +17948,10 @@ var PRIORITY_LABELS = [
   {
     id: "solution",
     canonical_label: "Solution",
-    alt_labels: ["proposed solution", "solution idea", "concept", "approach"],
+    // 'concept' stripped (P-B / UPG-670): bare "concept" was shared with the
+    // distinct `design_concept` type. `design_concept` keeps it; here a search
+    // for a solution uses "approach" / "proposed solution".
+    alt_labels: ["proposed solution", "solution idea", "approach"],
     framework_labels: {
       ost: "Solution",
       design_thinking: "Solution",
@@ -17983,7 +18114,10 @@ var PRIORITY_LABELS = [
   {
     id: "outcome",
     canonical_label: "Outcome",
-    alt_labels: ["desired outcome", "product outcome", "business outcome", "target outcome"],
+    // 'desired outcome' stripped (P-B / UPG-670): it was the canonical label of
+    // the distinct `desired_outcome` (Ulwick JTBD) type. The OST framework_label
+    // below still surfaces "Desired Outcome" in OST context, framework-scoped.
+    alt_labels: ["product outcome", "business outcome", "target outcome"],
     framework_labels: {
       ost: "Desired Outcome",
       okr_tree: "Outcome"
@@ -18011,7 +18145,10 @@ var PRIORITY_LABELS = [
   {
     id: "feature",
     canonical_label: "Feature",
-    alt_labels: ["capability", "product feature", "functionality"],
+    // 'capability' stripped (P-B / UPG-670): it is the canonical label of the
+    // distinct `capability` type (Wardley / DDD). A search for "capability" must
+    // resolve there, not to a feature.
+    alt_labels: ["product feature", "functionality"],
     framework_labels: {
       rice: "Scored Item",
       moscow: "Prioritised Item",
@@ -18082,7 +18219,10 @@ var PRIORITY_LABELS = [
   {
     id: "distribution_channel",
     canonical_label: "Distribution Channel",
-    alt_labels: ["channel", "sales channel", "delivery channel", "distribution"],
+    // bare 'channel' stripped (P-B / UPG-670): shared 3-way with
+    // `acquisition_channel` and `marketing_channel`. BMC/Lean-Canvas framework
+    // contexts still surface "Channel" via framework_labels below.
+    alt_labels: ["distribution channel", "sales channel", "delivery channel", "distribution"],
     framework_labels: {
       bmc: "Channel",
       lean_canvas: "Channel"
@@ -18262,7 +18402,8 @@ var PRIORITY_LABELS = [
 ];
 var STANDARD_LABELS = {
   // Strategic layer
-  product: { alt_labels: ["offering", "app", "service", "platform"] },
+  // 'service' stripped (P-B / UPG-670): canonical label of the distinct `service` type.
+  product: { alt_labels: ["offering", "app", "platform"] },
   vision: { alt_labels: ["product vision", "north star vision", "long-term vision"] },
   mission: { alt_labels: ["mission statement", "purpose"] },
   strategic_theme: { alt_labels: ["focus area", "strategic focus area"] },
@@ -18280,7 +18421,8 @@ var STANDARD_LABELS = {
   design_sprint: { alt_labels: ["sprint", "gv sprint", "google ventures sprint"] },
   // Validation layer
   learning: { alt_labels: ["validated learning", "lesson learned", "takeaway"] },
-  test_plan: { alt_labels: ["experiment plan", "validation plan"] },
+  // 'experiment plan' stripped (P-B / UPG-670): canonical label of the distinct `experiment_plan` type.
+  test_plan: { alt_labels: ["test strategy", "validation plan"] },
   research_plan: { alt_labels: ["study plan", "research brief"] },
   evidence: { alt_labels: ["proof", "supporting data", "signal"] },
   variant: { alt_labels: ["test variant", "experiment arm", "variation"] },
@@ -18288,7 +18430,9 @@ var STANDARD_LABELS = {
   competitor: { alt_labels: ["rival", "alternative", "competitive product", "competing product"] },
   competitor_feature: { alt_labels: ["competitive feature", "rival capability"] },
   market_trend: { alt_labels: ["trend", "industry trend", "macro trend"] },
-  market_segment: { alt_labels: ["segment", "market slice", "tam segment", "sam segment"] },
+  // bare 'segment' stripped (P-B / UPG-670): shared 2-way with `behavioral_segment`.
+  // 'market segment' is the qualified, unambiguous form.
+  market_segment: { alt_labels: ["market segment", "market slice", "tam segment", "sam segment"] },
   competitive_analysis: { alt_labels: ["competitor analysis", "competitive landscape", "market analysis"] },
   // UX Research layer
   research_study: { alt_labels: ["study", "user study", "research project", "ux study"] },
@@ -18324,7 +18468,8 @@ var STANDARD_LABELS = {
   brand_typography: { alt_labels: ["typeface", "font family", "type system"] },
   brand_voice: { alt_labels: ["tone of voice", "brand tone", "writing style"] },
   // Product Specification layer
-  epic: { alt_labels: ["initiative", "large story", "feature set"] },
+  // 'initiative' stripped (P-B / UPG-670): canonical label of the distinct `initiative` type.
+  epic: { alt_labels: ["large story", "feature set"] },
   feature_area: { alt_labels: ["feature group", "capability area", "module"] },
   acceptance_criterion: { alt_labels: ["ac", "done criterion", "acceptance criteria", "definition of done"] },
   release: { alt_labels: ["version", "ship", "launch version", "build"] },
@@ -18338,8 +18483,10 @@ var STANDARD_LABELS = {
   // Engineering layer
   bounded_context: { alt_labels: ["context", "domain boundary", "module boundary"] },
   service: { alt_labels: ["microservice", "backend service", "api service"] },
-  domain_event: { alt_labels: ["event", "system event", "business event"] },
-  api_contract: { alt_labels: ["api spec", "api schema", "contract", "openapi spec"] },
+  // 'event' stripped (P-B / UPG-670): canonical label of the distinct `event` type.
+  domain_event: { alt_labels: ["system event", "business event"] },
+  // 'contract' stripped (P-B / UPG-670): canonical label of the distinct `contract` (legal) type.
+  api_contract: { alt_labels: ["api spec", "api schema", "openapi spec"] },
   technical_debt_item: { alt_labels: ["tech debt", "debt", "tech debt item", "cleanup"] },
   feature_flag: { alt_labels: ["flag", "toggle", "feature toggle", "release flag"] },
   aggregate: { alt_labels: ["aggregate root", "ddd aggregate"] },
@@ -18352,15 +18499,19 @@ var STANDARD_LABELS = {
   queue_topic: { alt_labels: ["topic", "message queue", "event bus topic", "pubsub topic"] },
   build_artifact: { alt_labels: ["artifact", "binary", "docker image", "package"] },
   code_repository: { alt_labels: ["repo", "repository", "git repo", "codebase"] },
-  library_dependency: { alt_labels: ["dependency", "package", "library", "npm package"] },
+  // 'dependency' stripped (P-B / UPG-670): canonical label of the distinct `dependency` type.
+  library_dependency: { alt_labels: ["package", "library", "npm package"] },
   integration_pattern: { alt_labels: ["integration", "pattern", "middleware pattern"] },
   external_api: { alt_labels: ["third-party api", "vendor api", "saas integration"] },
   data_flow: { alt_labels: ["data movement", "data transfer", "pipeline flow"] },
   // Growth layer
-  acquisition_channel: { alt_labels: ["channel", "traffic source", "user source"] },
+  // bare 'channel' stripped (P-B / UPG-670): shared 3-way (see distribution_channel).
+  acquisition_channel: { alt_labels: ["acquisition channel", "traffic source", "user source"] },
   growth_campaign: { alt_labels: ["campaign", "marketing campaign", "ad campaign", "growth campaign"] },
   cohort: { alt_labels: ["user cohort", "retention cohort", "signup cohort"] },
-  behavioral_segment: { alt_labels: ["segment", "user segment", "audience segment", "behavioural segment"] },
+  // bare 'segment' stripped (P-B / UPG-670): shared 2-way with `market_segment`.
+  // 'behavioral segment' / 'user segment' keep the affordance unambiguously.
+  behavioral_segment: { alt_labels: ["user segment", "audience segment", "behavioural segment"] },
   growth_loop: { alt_labels: ["viral loop", "referral loop", "flywheel"] },
   attribution_model: { alt_labels: ["attribution", "marketing attribution", "channel attribution"] },
   // Business Model layer
@@ -18389,7 +18540,8 @@ var STANDARD_LABELS = {
   retrospective: { alt_labels: ["retro", "sprint retro", "team retro", "post-mortem"] },
   dependency: { alt_labels: ["team dependency", "cross-team dependency", "blocker"] },
   department: { alt_labels: ["org unit", "division", "business unit"] },
-  skill: { alt_labels: ["competency", "capability", "expertise"] },
+  // 'capability' stripped (P-B / UPG-670): canonical label of the distinct `capability` type.
+  skill: { alt_labels: ["competency", "expertise"] },
   ceremony: { alt_labels: ["ritual", "meeting cadence", "standup", "retrospective meeting"] },
   capacity_plan: { alt_labels: ["resourcing plan", "staffing plan", "headcount plan"] },
   // Data & Analytics layer
@@ -18399,7 +18551,8 @@ var STANDARD_LABELS = {
   data_model: { alt_labels: ["erd", "entity relationship diagram", "schema model"] },
   data_quality_rule: { alt_labels: ["data rule", "quality check", "data validation"] },
   data_product: { alt_labels: ["data asset", "data offering"] },
-  data_pipeline: { alt_labels: ["etl", "elt", "ingestion pipeline", "data flow"] },
+  // 'data flow' stripped (P-B / UPG-670): canonical label of the distinct `data_flow` type.
+  data_pipeline: { alt_labels: ["etl", "elt", "ingestion pipeline"] },
   data_lineage: { alt_labels: ["lineage", "data provenance", "data trail"] },
   glossary_term: { alt_labels: ["term", "definition", "business term"] },
   data_domain: { alt_labels: ["data area", "data subject area"] },
@@ -18441,7 +18594,8 @@ var STANDARD_LABELS = {
   error_budget: { alt_labels: ["reliability budget", "downtime budget"] },
   investigation: { alt_labels: ["incident investigation", "root cause analysis", "debugging"] },
   postmortem: { alt_labels: ["post-mortem", "incident review", "rca", "root cause analysis"] },
-  runbook: { alt_labels: ["operations guide", "playbook", "sop", "standard operating procedure"] },
+  // 'playbook' stripped (P-B / UPG-670): canonical label of the distinct `playbook` type.
+  runbook: { alt_labels: ["operations guide", "sop", "standard operating procedure"] },
   monitor: { alt_labels: ["health check", "synthetic monitor", "uptime check"] },
   alert_rule: { alt_labels: ["alert", "pager rule", "notification rule"] },
   release_strategy: { alt_labels: ["rollout strategy", "deployment strategy", "canary release"] },
@@ -18456,17 +18610,26 @@ var STANDARD_LABELS = {
   security_control: { alt_labels: ["control", "safeguard", "countermeasure", "mitigation"] },
   security_policy: { alt_labels: ["infosec policy", "security standard"] },
   penetration_test: { alt_labels: ["pentest", "pen test", "security test"] },
-  security_review: { alt_labels: ["code review", "security assessment", "audit"] },
+  // bare 'audit' / 'security assessment' stripped (P-B / UPG-670): both owned by
+  // `security_audit`. A `security_review` is a code-review-scoped activity; the
+  // qualified 'security code review' keeps it findable without colliding.
+  security_review: { alt_labels: ["code review", "security code review"] },
   data_classification: { alt_labels: ["classification", "sensitivity level", "data label"] },
   access_policy: { alt_labels: ["iam policy", "rbac rule", "permission", "access control"] },
   // Sales & Revenue layer
-  account: { alt_labels: ["customer account", "client", "organization"] },
-  contact: { alt_labels: ["person", "buyer", "champion"] },
+  // 'organization' stripped (P-B / UPG-670): canonical label of the distinct `organization` type.
+  account: { alt_labels: ["customer account", "client"] },
+  // 'person' stripped (P-B / UPG-670): canonical label of the distinct `person` type.
+  contact: { alt_labels: ["buyer", "champion"] },
   lead: { alt_labels: ["prospect", "mql", "sql", "marketing lead"] },
-  deal: { alt_labels: ["opportunity", "sales opportunity", "opp"] },
+  // 'opportunity' stripped (P-B / UPG-670): canonical label of the distinct `opportunity` (OST) type.
+  deal: { alt_labels: ["sales opportunity", "opp"] },
   pipeline_sales: { alt_labels: ["sales pipeline", "deal pipeline", "revenue pipeline"] },
   pipeline_stage: { alt_labels: ["deal stage", "sales stage"] },
-  quote_document: { alt_labels: ["quote", "proposal", "estimate", "quotation"] },
+  // bare 'quote' qualified to 'sales quote' (P-B / UPG-670): 'quote' is the
+  // canonical label of the distinct `quote` type. The qualified form keeps the
+  // sales-document search affordance without misresolving.
+  quote_document: { alt_labels: ["sales quote", "proposal", "estimate", "quotation"] },
   subscription: { alt_labels: ["recurring revenue", "saas subscription", "plan"] },
   invoice: { alt_labels: ["bill", "payment request"] },
   forecast: { alt_labels: ["revenue forecast", "sales forecast", "projection"] },
@@ -18487,7 +18650,8 @@ var STANDARD_LABELS = {
   a11y_annotation: { alt_labels: ["accessibility annotation", "aria note"] },
   // Marketing & Communications layer
   marketing_strategy: { alt_labels: ["marketing plan", "growth strategy"] },
-  marketing_channel: { alt_labels: ["channel", "paid channel", "organic channel"] },
+  // bare 'channel' stripped (P-B / UPG-670): shared 3-way (see distribution_channel).
+  marketing_channel: { alt_labels: ["marketing channel", "paid channel", "organic channel"] },
   marketing_campaign_plan: { alt_labels: ["campaign plan", "launch campaign"] },
   email_sequence: { alt_labels: ["drip campaign", "nurture sequence", "email flow"] },
   social_post: { alt_labels: ["tweet", "linkedin post", "social media post"] },
@@ -18561,7 +18725,9 @@ var STANDARD_LABELS = {
   agent_session: { alt_labels: ["session", "agent run", "agent conversation"] },
   review_gate: { alt_labels: ["approval gate", "quality gate", "stage gate"] },
   approval_record: { alt_labels: ["approval", "sign-off", "authorization"] },
-  agent_skill: { alt_labels: ["skill", "tool", "agent capability"] },
+  // bare 'skill' qualified to 'agent skill' (P-B / UPG-670): 'skill' is the
+  // canonical label of the distinct team_org `skill` type.
+  agent_skill: { alt_labels: ["agent skill", "tool", "agent capability"] },
   agent_hook: { alt_labels: ["hook", "trigger", "callback"] },
   workflow_artifact: { alt_labels: ["artifact", "output artifact", "generated artifact"] },
   // Portfolio layer
@@ -23705,6 +23871,96 @@ var UPG_ANTI_PATTERNS = [
     stages: ["concept", "validation", "build", "beta", "launch", "growth"],
     severity: "high",
     source: { kind: "fundamental" }
+  },
+  // ── F5 (UPG-671): anti-pattern enforcement ────────────────────────────────
+  // P-C from the 36-domain wiring audit: domain-guide anti-patterns described
+  // in prose with no machine-checkable detector. These two map cleanly to a
+  // RelationshipCheck (edge presence/absence) and are promoted here.
+  {
+    id: "insights-without-evidence",
+    name: "Insights without evidence",
+    description: "The graph has insight entities but none are backed by a primary-evidence link: no observation yields them (`observation_yields_insight`), no survey response evidences them (`survey_response_evidences_insight`), and no quote is attached (`insight_evidenced_by_quote`). An insight with no evidence behind it is an opinion wearing a research label.",
+    structured_condition: {
+      operator: "and",
+      checks: [
+        { check: { type: "entity_count", entity_type: "insight", comparison: "nonzero" } },
+        {
+          check: {
+            type: "relationship",
+            source_type: "observation",
+            edge_type: "observation_yields_insight",
+            target_type: "insight",
+            comparison: "not_exists"
+          }
+        },
+        {
+          check: {
+            type: "relationship",
+            source_type: "survey_response",
+            edge_type: "survey_response_evidences_insight",
+            target_type: "insight",
+            comparison: "not_exists"
+          }
+        },
+        {
+          check: {
+            type: "relationship",
+            source_type: "insight",
+            edge_type: "insight_evidenced_by_quote",
+            target_type: "quote",
+            comparison: "not_exists"
+          }
+        }
+      ]
+    },
+    why_it_matters: "Insights untethered from evidence cannot be trusted, contested, or traced. Downstream opportunities and design questions inherit an unfalsifiable claim.",
+    remediation: "Back each insight with at least one primary record via `observation_yields_insight`, `survey_response_evidences_insight`, or `insight_evidenced_by_quote`. Capture the supporting observation or quote first.",
+    stages: ["concept", "validation", "build", "beta", "launch", "growth", "mature"],
+    severity: "high",
+    source: { kind: "practitioner", attribution: "Steve Portigal, Interviewing Users" }
+  },
+  {
+    id: "feature-requests-without-provenance",
+    name: "Feature requests without provenance",
+    description: "The graph has feature_request entities but none trace back to a source: no feedback program collects them (`feedback_program_collects_feature_request`), no customer feedback becomes one (`customer_feedback_becomes_feature_request`), and none originate from a behavioural segment (`feature_request_from_behavioral_segment`). A request with no provenance cannot be weighed against who asked or how many.",
+    structured_condition: {
+      operator: "and",
+      checks: [
+        { check: { type: "entity_count", entity_type: "feature_request", comparison: "nonzero" } },
+        {
+          check: {
+            type: "relationship",
+            source_type: "feedback_program",
+            edge_type: "feedback_program_collects_feature_request",
+            target_type: "feature_request",
+            comparison: "not_exists"
+          }
+        },
+        {
+          check: {
+            type: "relationship",
+            source_type: "customer_feedback",
+            edge_type: "customer_feedback_becomes_feature_request",
+            target_type: "feature_request",
+            comparison: "not_exists"
+          }
+        },
+        {
+          check: {
+            type: "relationship",
+            source_type: "feature_request",
+            edge_type: "feature_request_from_behavioral_segment",
+            target_type: "behavioral_segment",
+            comparison: "not_exists"
+          }
+        }
+      ]
+    },
+    why_it_matters: "Requests without a source get prioritised on volume of voice, not on the strength or fit of who is asking. The loudest channel wins by default.",
+    remediation: "Attach provenance to each `feature_request` via `feedback_program_collects_feature_request`, `customer_feedback_becomes_feature_request`, or `feature_request_from_behavioral_segment` before it enters prioritisation.",
+    stages: ["beta", "launch", "growth", "mature"],
+    severity: "medium",
+    source: { kind: "practitioner", attribution: "Marty Cagan, Inspired (product discovery)" }
   }
 ];
 function getAntiPatternById(id) {
@@ -24043,6 +24299,10 @@ var UPG_REGIONS = [
       "strategy"
     ],
     entities: [
+      {
+        type: "product",
+        role: "container"
+      },
       {
         type: "vision",
         role: "root"
@@ -24082,7 +24342,11 @@ var UPG_REGIONS = [
       {
         type: "metric",
         role: "leaf",
-        notes: "shared with Analytics"
+        notes: "also anchors Analytics; canonical home is Strategy"
+      },
+      {
+        type: "metric_quality_assessment",
+        role: "leaf"
       },
       {
         type: "decision",
@@ -24093,6 +24357,10 @@ var UPG_REGIONS = [
         type: "assumption",
         role: "leaf"
       },
+      {
+        type: "constraint",
+        role: "leaf"
+      },
       {
         type: "outcome",
         role: "hub"
@@ -24206,7 +24474,7 @@ var UPG_REGIONS = [
       {
         type: "participant",
         role: "leaf",
-        notes: "research-resolved persona"
+        notes: "research-resolved persona; canonical home is Discovery/Research/Validation"
       }
     ],
     anchor: {
@@ -24377,6 +24645,14 @@ var UPG_REGIONS = [
         role: "hub",
         notes: "self-nesting"
       },
+      {
+        type: "experiment_plan",
+        role: "container"
+      },
+      {
+        type: "experiment_run",
+        role: "container"
+      },
       {
         type: "learning",
         role: "leaf"
@@ -24546,10 +24822,6 @@ var UPG_REGIONS = [
         type: "competitive_analysis",
         role: "container"
       },
-      {
-        type: "territory",
-        role: "leaf"
-      },
       {
         type: "classification_axis",
         role: "container",
@@ -24569,7 +24841,7 @@ var UPG_REGIONS = [
     },
     intra_edges: [
       "competitor_offers_competitor_feature",
-      "competitive_analysis_contains_competitor",
+      "competitive_analysis_analyses_competitor",
       "competitive_analysis_dimensioned_by_classification_axis",
       "classification_axis_includes_classification_value",
       "competitor_classified_as_classification_value"
@@ -24670,6 +24942,10 @@ var UPG_REGIONS = [
         type: "screen",
         role: "leaf"
       },
+      {
+        type: "screen_state",
+        role: "leaf"
+      },
       {
         type: "wireframe",
         role: "leaf"
@@ -24747,6 +25023,18 @@ var UPG_REGIONS = [
         type: "content_piece",
         role: "leaf"
       },
+      {
+        type: "knowledge_base_article",
+        role: "leaf"
+      },
+      {
+        type: "content_calendar",
+        role: "container"
+      },
+      {
+        type: "documentation_template",
+        role: "leaf"
+      },
       {
         type: "document",
         role: "leaf"
@@ -24765,13 +25053,13 @@ var UPG_REGIONS = [
     intra_edges: [
       "user_journey_contains_journey_step",
       "design_system_contains_design_component",
-      "brand_identity_contains_brand_colour",
-      "design_component_self_nests"
+      "brand_identity_coloured_with_brand_colour",
+      "design_component_composes_design_component"
     ],
     boundary_edges: [
       {
         direction: "import",
-        edge_id: "need_informs_design_question",
+        edge_id: "need_reframed_as_design_question",
         crosses_into: "users_needs"
       },
       {
@@ -24795,8 +25083,8 @@ var UPG_REGIONS = [
         crosses_into: "engineering_platform"
       },
       {
-        direction: "sideways",
-        edge_id: "feature_sketched_in_wireframe",
+        direction: "export",
+        edge_id: "wireframe_specifies_feature",
         crosses_into: "product_delivery"
       },
       {
@@ -24871,20 +25159,68 @@ var UPG_REGIONS = [
         role: "container",
         notes: "semantic spanner, not containment"
       },
+      {
+        type: "changelog",
+        role: "leaf"
+      },
+      {
+        type: "feedback_program",
+        role: "container"
+      },
+      {
+        type: "feature_request",
+        role: "leaf"
+      },
+      {
+        type: "feedback_vote",
+        role: "leaf"
+      },
+      {
+        type: "nps_campaign",
+        role: "leaf"
+      },
+      {
+        type: "user_advisory_board",
+        role: "container"
+      },
+      {
+        type: "beta_program",
+        role: "leaf"
+      },
+      {
+        type: "feedback_theme",
+        role: "leaf"
+      },
+      {
+        type: "program",
+        role: "container"
+      },
+      {
+        type: "project",
+        role: "container"
+      },
       {
         type: "milestone",
+        role: "leaf"
+      },
+      {
+        type: "risk_register",
         role: "container"
       },
       {
-        type: "changelog",
+        type: "change_request",
         role: "leaf"
       },
       {
-        type: "feature_request",
+        type: "deliverable",
         role: "leaf"
       },
       {
-        type: "feedback_vote",
+        type: "resource_allocation",
+        role: "leaf"
+      },
+      {
+        type: "status_report",
         role: "leaf"
       }
     ],
@@ -24953,8 +25289,8 @@ var UPG_REGIONS = [
         crosses_into: "discovery_research_validation"
       },
       {
-        direction: "sideways",
-        edge_id: "feature_sketched_in_wireframe",
+        direction: "import",
+        edge_id: "wireframe_specifies_feature",
         crosses_into: "experience_design_brand"
       },
       {
@@ -25017,10 +25353,6 @@ var UPG_REGIONS = [
         type: "database_schema",
         role: "leaf"
       },
-      {
-        type: "data_model",
-        role: "leaf"
-      },
       {
         type: "aggregate",
         role: "container"
@@ -25085,6 +25417,111 @@ var UPG_REGIONS = [
       {
         type: "technical_debt_item",
         role: "leaf"
+      },
+      {
+        type: "investigation",
+        role: "container"
+      },
+      {
+        type: "root_cause",
+        role: "container"
+      },
+      {
+        type: "symptom",
+        role: "leaf"
+      },
+      {
+        type: "fix",
+        role: "leaf"
+      },
+      {
+        type: "ai_model",
+        role: "container"
+      },
+      {
+        type: "prompt_template",
+        role: "leaf"
+      },
+      {
+        type: "prompt_version",
+        role: "leaf"
+      },
+      {
+        type: "eval_benchmark",
+        role: "container"
+      },
+      {
+        type: "eval_run",
+        role: "leaf"
+      },
+      {
+        type: "ai_cost_tracker",
+        role: "leaf"
+      },
+      {
+        type: "hallucination_report",
+        role: "leaf"
+      },
+      {
+        type: "ai_guardrail",
+        role: "leaf"
+      },
+      {
+        type: "model_comparison",
+        role: "leaf"
+      },
+      {
+        type: "ai_experiment",
+        role: "leaf"
+      },
+      {
+        type: "ai_dataset",
+        role: "leaf"
+      },
+      {
+        type: "ai_trace",
+        role: "container",
+        notes: "self-nesting inference chain"
+      },
+      {
+        type: "workflow_template",
+        role: "container"
+      },
+      {
+        type: "workflow_run",
+        role: "container"
+      },
+      {
+        type: "workflow_artifact",
+        role: "leaf"
+      },
+      {
+        type: "agent_definition",
+        role: "container"
+      },
+      {
+        type: "agent_session",
+        role: "leaf"
+      },
+      {
+        type: "agent_skill",
+        role: "leaf"
+      },
+      {
+        type: "agent_hook",
+        role: "leaf"
+      },
+      {
+        type: "agent_task",
+        role: "leaf"
+      },
+      {
+        type: "review_gate",
+        role: "container"
+      },
+      {
+        type: "approval_record",
+        role: "leaf"
       }
     ],
     anchor: {
@@ -25103,7 +25540,7 @@ var UPG_REGIONS = [
       "service_depends_on_library_dependency",
       "service_carries_technical_debt_item",
       "service_toggles_feature_flag",
-      "service_caused_by_root_cause",
+      "service_affected_by_root_cause",
       "service_investigated_via_investigation"
     ],
     boundary_edges: [
@@ -25187,6 +25624,26 @@ var UPG_REGIONS = [
         type: "unit_economics",
         role: "leaf"
       },
+      {
+        type: "partnership",
+        role: "leaf"
+      },
+      {
+        type: "key_resource",
+        role: "leaf"
+      },
+      {
+        type: "key_activity",
+        role: "leaf"
+      },
+      {
+        type: "customer_relationship",
+        role: "leaf"
+      },
+      {
+        type: "distribution_channel",
+        role: "leaf"
+      },
       {
         type: "pricing_strategy",
         role: "root"
@@ -25195,6 +25652,18 @@ var UPG_REGIONS = [
         type: "pricing_tier",
         role: "leaf"
       },
+      {
+        type: "discount_strategy",
+        role: "leaf"
+      },
+      {
+        type: "trial_config",
+        role: "leaf"
+      },
+      {
+        type: "paywall",
+        role: "leaf"
+      },
       {
         type: "gtm_strategy",
         role: "root"
@@ -25211,10 +25680,30 @@ var UPG_REGIONS = [
         type: "messaging",
         role: "leaf"
       },
+      {
+        type: "content_strategy",
+        role: "container"
+      },
+      {
+        type: "sales_motion",
+        role: "leaf"
+      },
+      {
+        type: "demand_gen_program",
+        role: "leaf"
+      },
+      {
+        type: "territory",
+        role: "leaf"
+      },
       {
         type: "objection",
         role: "leaf"
       },
+      {
+        type: "rebuttal",
+        role: "container"
+      },
       {
         type: "proof_point",
         role: "leaf"
@@ -25262,6 +25751,114 @@ var UPG_REGIONS = [
       {
         type: "variant",
         role: "leaf"
+      },
+      {
+        type: "account",
+        role: "container"
+      },
+      {
+        type: "contact",
+        role: "leaf"
+      },
+      {
+        type: "lead",
+        role: "leaf"
+      },
+      {
+        type: "deal",
+        role: "container"
+      },
+      {
+        type: "pipeline_sales",
+        role: "container"
+      },
+      {
+        type: "pipeline_stage",
+        role: "leaf"
+      },
+      {
+        type: "quote_document",
+        role: "leaf"
+      },
+      {
+        type: "subscription",
+        role: "container"
+      },
+      {
+        type: "invoice",
+        role: "leaf"
+      },
+      {
+        type: "forecast",
+        role: "leaf"
+      },
+      {
+        type: "marketing_strategy",
+        role: "container"
+      },
+      {
+        type: "marketing_channel",
+        role: "container"
+      },
+      {
+        type: "marketing_campaign_plan",
+        role: "container"
+      },
+      {
+        type: "email_sequence",
+        role: "leaf"
+      },
+      {
+        type: "social_post",
+        role: "leaf"
+      },
+      {
+        type: "seo_keyword",
+        role: "leaf"
+      },
+      {
+        type: "ad_creative",
+        role: "leaf"
+      },
+      {
+        type: "press_release",
+        role: "leaf"
+      },
+      {
+        type: "event",
+        role: "leaf"
+      },
+      {
+        type: "community_initiative",
+        role: "leaf"
+      },
+      {
+        type: "partner_program",
+        role: "container"
+      },
+      {
+        type: "partner_tier",
+        role: "leaf"
+      },
+      {
+        type: "api_ecosystem",
+        role: "container"
+      },
+      {
+        type: "marketplace_listing",
+        role: "leaf"
+      },
+      {
+        type: "developer_portal",
+        role: "leaf"
+      },
+      {
+        type: "integration_partner",
+        role: "leaf"
+      },
+      {
+        type: "partner_revenue_share",
+        role: "leaf"
       }
     ],
     anchor: {
@@ -25368,7 +25965,8 @@ var UPG_REGIONS = [
     entities: [
       {
         type: "metric",
-        role: "anchor"
+        role: "anchor",
+        notes: "canonical home is Strategy; anchors Analytics as the measurement plane"
       },
       {
         type: "data_source",
@@ -25382,24 +25980,36 @@ var UPG_REGIONS = [
         type: "dashboard",
         role: "container"
       },
+      {
+        type: "data_model",
+        role: "leaf"
+      },
       {
         type: "data_domain",
         role: "container"
       },
       {
-        type: "glossary_term",
+        type: "data_product",
         role: "leaf"
       },
       {
-        type: "forecast",
+        type: "data_pipeline",
         role: "leaf"
       },
       {
-        type: "data_quality_rule",
+        type: "data_lineage",
         role: "leaf"
       },
       {
-        type: "data_contract",
+        type: "glossary_term",
+        role: "leaf"
+      },
+      {
+        type: "report",
+        role: "leaf"
+      },
+      {
+        type: "data_quality_rule",
         role: "leaf"
       }
     ],
@@ -25525,7 +26135,27 @@ var UPG_REGIONS = [
       {
         type: "deployment",
         role: "leaf",
-        notes: "shared with Engineering"
+        notes: "canonical home is Engineering; release event surfaced to Ops"
+      },
+      {
+        type: "alert_rule",
+        role: "leaf"
+      },
+      {
+        type: "ci_pipeline",
+        role: "container"
+      },
+      {
+        type: "release_strategy",
+        role: "leaf"
+      },
+      {
+        type: "on_call_rotation",
+        role: "leaf"
+      },
+      {
+        type: "infrastructure_component",
+        role: "container"
       },
       {
         type: "test_suite",
@@ -25543,10 +26173,26 @@ var UPG_REGIONS = [
         type: "test_result",
         role: "leaf"
       },
+      {
+        type: "regression_test",
+        role: "leaf"
+      },
+      {
+        type: "test_coverage_report",
+        role: "leaf"
+      },
+      {
+        type: "test_environment",
+        role: "leaf"
+      },
       {
         type: "threat_model",
         role: "root"
       },
+      {
+        type: "threat",
+        role: "leaf"
+      },
       {
         type: "security_control",
         role: "leaf"
@@ -25563,14 +26209,34 @@ var UPG_REGIONS = [
         type: "penetration_test",
         role: "leaf"
       },
+      {
+        type: "security_review",
+        role: "container"
+      },
+      {
+        type: "data_classification",
+        role: "leaf"
+      },
+      {
+        type: "access_policy",
+        role: "leaf"
+      },
       {
         type: "a11y_standard",
         role: "leaf"
       },
+      {
+        type: "a11y_guideline",
+        role: "leaf"
+      },
       {
         type: "a11y_audit",
         role: "leaf"
       },
+      {
+        type: "a11y_issue",
+        role: "leaf"
+      },
       {
         type: "a11y_annotation",
         role: "leaf"
@@ -25588,11 +26254,15 @@ var UPG_REGIONS = [
         role: "leaf"
       },
       {
-        type: "root_cause",
+        type: "data_contract",
         role: "leaf"
       },
       {
-        type: "investigation",
+        type: "audit_log_policy",
+        role: "leaf"
+      },
+      {
+        type: "security_audit",
         role: "leaf"
       },
       {
@@ -25621,16 +26291,16 @@ var UPG_REGIONS = [
         role: "root"
       },
       {
-        type: "beta_program",
+        type: "customer_journey_stage",
         role: "container"
       },
       {
-        type: "feedback_program",
-        role: "container"
+        type: "touchpoint",
+        role: "leaf"
       },
       {
-        type: "user_advisory_board",
-        role: "container"
+        type: "success_milestone",
+        role: "leaf"
       },
       {
         type: "team",
@@ -25644,6 +26314,10 @@ var UPG_REGIONS = [
         type: "role",
         role: "leaf"
       },
+      {
+        type: "person",
+        role: "leaf"
+      },
       {
         type: "stakeholder",
         role: "leaf",
@@ -25671,6 +26345,78 @@ var UPG_REGIONS = [
       },
       {
         type: "capacity_plan",
+        role: "leaf"
+      },
+      {
+        type: "legal_entity",
+        role: "container"
+      },
+      {
+        type: "ip_asset",
+        role: "leaf"
+      },
+      {
+        type: "contract",
+        role: "container"
+      },
+      {
+        type: "contract_clause",
+        role: "leaf"
+      },
+      {
+        type: "privacy_policy",
+        role: "leaf"
+      },
+      {
+        type: "locale",
+        role: "container"
+      },
+      {
+        type: "translation_key",
+        role: "leaf"
+      },
+      {
+        type: "translation_bundle",
+        role: "container"
+      },
+      {
+        type: "locale_config",
+        role: "leaf"
+      },
+      {
+        type: "cultural_adaptation",
+        role: "leaf"
+      },
+      {
+        type: "regional_pricing",
+        role: "leaf"
+      },
+      {
+        type: "education_program",
+        role: "container"
+      },
+      {
+        type: "tutorial",
+        role: "leaf"
+      },
+      {
+        type: "walkthrough",
+        role: "leaf"
+      },
+      {
+        type: "webinar",
+        role: "leaf"
+      },
+      {
+        type: "certification",
+        role: "leaf"
+      },
+      {
+        type: "help_video",
+        role: "leaf"
+      },
+      {
+        type: "learning_path",
         role: "container"
       }
     ],
@@ -25687,7 +26433,6 @@ var UPG_REGIONS = [
       "incident_analysed_in_postmortem",
       "incident_triggers_postmortem",
       "incident_breaches_service_level_objective",
-      "incident_caused_by_root_cause",
       "incident_exploits_vulnerability"
     ],
     boundary_edges: [
@@ -25708,8 +26453,8 @@ var UPG_REGIONS = [
       },
       {
         direction: "export",
-        edge_id: "beta_program_runs_experiment",
-        crosses_into: "discovery_research_validation"
+        edge_id: "incident_caused_by_root_cause",
+        crosses_into: "engineering_platform"
       },
       {
         direction: "export",
@@ -26105,7 +26850,16 @@ function portfolioBody(doc) {
     product_areas: [...doc.product_areas ?? []].sort((a, b) => byCodeUnit(a.id ?? "", b.id ?? "")).map((a) => orderedObject(a, ["id", "title", "description", "parent_area_id", "strategic_priority", "products"], { forceKeys: ["id", "title"] })),
     portfolios: [...doc.portfolios ?? []].sort((a, b) => byCodeUnit(a.id ?? "", b.id ?? "")).map((p) => orderedObject(p, ["id", "title", "description", "parent_portfolio_id", "hierarchy_model", "products"], { forceKeys: ["id", "title"] })),
     products,
-    cross_edges: sortEdges(doc.cross_edges ?? []).map(canonicalCrossEdge)
+    cross_edges: sortEdges(doc.cross_edges ?? []).map(canonicalCrossEdge),
+    // Registry tier (shared vocabulary). Emitted only when non-empty so existing
+    // portfolio files without a registry stay byte-identical. Canonical entities
+    // are normal nodes, serialised with the same node/edge canonical rules.
+    ...doc.registry && doc.registry.nodes.length > 0 ? {
+      registry: {
+        nodes: sortNodes(doc.registry.nodes).map(canonicalNode),
+        ...doc.registry.edges && doc.registry.edges.length > 0 ? { edges: sortEdges(doc.registry.edges).map(canonicalEdge) } : {}
+      }
+    } : {}
   };
 }
 function computeBodyChecksum(doc) {
@@ -26205,6 +26959,13 @@ function normalizeDocument(obj) {
       })),
       cross_edges: raw.cross_edges ?? []
     };
+    const rawRegistry = raw.registry;
+    if (rawRegistry && Array.isArray(rawRegistry.nodes)) {
+      out2.registry = {
+        nodes: rawRegistry.nodes.map((n) => repairNodeDrift(n)),
+        ...Array.isArray(rawRegistry.edges) ? { edges: rawRegistry.edges } : {}
+      };
+    }
     return out2;
   }
   const out = {
@@ -26227,7 +26988,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.9.5";
+var UPG_VERSION = "0.9.7";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -26307,6 +27068,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   PRODUCT_DELIVERY_PLAYBOOK,
   PROPERTY_SCALE_MAP,
   REFLECT_MODES,
+  REGISTRY_PRODUCT_ID,
   STRATEGY_OUTCOMES_PLAYBOOK,
   UPG_ACTIVE_TYPES,
   UPG_ANTI_PATTERNS,