@unified-product-graph/core 0.9.6 → 0.9.8

package/dist/index.d.cts

@@ -6831,6 +6831,202 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    data_classification_governed_by_privacy_policy: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_component_conforms_to_a11y_standard: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_component_conforms_to_a11y_guideline: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feature_request_becomes_feature: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    objective_advances_outcome: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    desired_outcome_reveals_opportunity: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    desired_outcome_quantified_by_metric: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feasibility_study_informs_decision: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feasibility_study_recommends_solution: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    feasibility_study_produces_learning: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_sprint_informs_decision: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_sprint_recommends_solution: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    design_sprint_produces_learning: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    affinity_cluster_groups_observation: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    feedback_theme_reveals_opportunity: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    competitor_feature_benchmarks_capability: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    switching_cost_locks_in_competitor: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    test_result_reports_bug: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    content_piece_repurposed_as_social_post: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    translation_key_localises_content_piece: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    translation_key_targets_locale: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    partner_revenue_share_feeds_revenue_stream: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    retrospective_produces_learning: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    retrospective_yields_decision: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    status_report_reports_on_milestone: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    quote_document_advances_deal: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    data_quality_rule_governs_data_source: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    press_release_announces_launch: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
 };
 /** The `UPGEdgeType` union derived from the registry above. Declared here (not
  *  in `shapes/edges.ts`) so the polymorphic list below can reference it
@@ -6976,7 +7172,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -7011,6 +7207,26 @@ interface UPGCrossEdge {
     target_product_id?: string;
     /** Confidence level if this edge was inferred during import */
     mapping_confidence?: UPGMappingConfidence;
+    /**
+     * Sanctioned divergence marker (`instance_of` only). When true, registry drift
+     * detection treats an instance title that differs from its canonical as
+     * intentional (an informative product-local name, e.g. "Vercel Platform / SDK"
+     * vs canonical "Vercel"), excluding it from the `title_divergence` count so
+     * `clean` reflects only un-sanctioned drift.
+     */
+    alias?: boolean;
+    /**
+     * Audience relevance for `area_serves_persona` / `area_targets_market_segment`:
+     * whether the audience is a primary or secondary focus of this area. The
+     * primary-vs-secondary distinction is the core value of the area-to-audience matrix.
+     */
+    relevance?: 'primary' | 'secondary';
+    /**
+     * Audience role in this area's context (`area_serves_persona`). Mirrors
+     * `PersonaProperties.audience_role`: the same persona can be a `buyer` for one
+     * area and a `user` for another.
+     */
+    audience_role?: 'buyer' | 'user' | 'champion' | 'influencer' | 'partner';
 }
 /**
  * A product area within a portfolio. The organisational axis (who owns
@@ -11023,6 +11239,14 @@ interface WireframeProperties {
  * }
  */
 interface UserFlowProperties {
+    /**
+     * 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.
+     */
+    flow_order?: number;
     /** Initiating event */
     trigger?: string;
     /** Ordered steps */
@@ -11066,6 +11290,13 @@ interface ScreenProperties {
  * }
  */
 interface ScreenStateProperties {
+    /**
+     * 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_order?: number;
     /** State */
     state_name: 'empty' | 'loading' | 'error' | 'populated' | 'skeleton' | 'partial';
     /** Cause for entering this state */
@@ -14855,6 +15086,13 @@ interface ProjectProperties {
  * }
  */
 interface MilestoneProperties {
+    /**
+     * 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`.
+     */
+    milestone_order?: number;
     /** Target due date (ISO format) */
     due_date?: ISODate;
     /** Whether the milestone was met on time */
@@ -17205,6 +17443,13 @@ interface HelpVideoProperties {
  * }
  */
 interface LearningPathProperties {
+    /**
+     * 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_order?: number;
     /** Overall difficulty level of the learning path */
     path_difficulty?: DifficultyLevel;
     /** Number of items (tutorials, videos, etc.) in the path */
@@ -17242,6 +17487,13 @@ interface PartnerProgramProperties {
  * }
  */
 interface PartnerTierProperties {
+    /**
+     * 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_order?: number;
     /** Numeric rank of the tier (higher = more prestigious) */
     tier_level?: number;
     /** What a partner must achieve to reach this tier */
@@ -18105,7 +18357,7 @@ type UPGNode<T extends keyof UPGPropertyMap = keyof UPGPropertyMap> = UPGBaseNod
  * AUTO-GENERATED by scripts/generate-property-registry.ts
  * Do not edit manually. Run: npx tsx scripts/generate-property-registry.ts
  *
- * Generated: 2026-06-09T23:36:57.066Z
+ * Generated: 2026-06-10T00:33:26.360Z
  * Entity types with properties: 316
  */
 interface PropertyDefinition {
@@ -20546,7 +20798,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.9.6";
+declare const UPG_VERSION: "0.9.8";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.d.ts

@@ -6831,6 +6831,202 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    data_classification_governed_by_privacy_policy: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_component_conforms_to_a11y_standard: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_component_conforms_to_a11y_guideline: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feature_request_becomes_feature: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    objective_advances_outcome: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    desired_outcome_reveals_opportunity: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    desired_outcome_quantified_by_metric: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feasibility_study_informs_decision: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feasibility_study_recommends_solution: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    feasibility_study_produces_learning: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_sprint_informs_decision: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    design_sprint_recommends_solution: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    design_sprint_produces_learning: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    affinity_cluster_groups_observation: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    feedback_theme_reveals_opportunity: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    competitor_feature_benchmarks_capability: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    switching_cost_locks_in_competitor: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    test_result_reports_bug: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    content_piece_repurposed_as_social_post: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    translation_key_localises_content_piece: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    translation_key_targets_locale: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    partner_revenue_share_feeds_revenue_stream: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    retrospective_produces_learning: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    retrospective_yields_decision: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    status_report_reports_on_milestone: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    quote_document_advances_deal: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    data_quality_rule_governs_data_source: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    press_release_announces_launch: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
 };
 /** The `UPGEdgeType` union derived from the registry above. Declared here (not
  *  in `shapes/edges.ts`) so the polymorphic list below can reference it
@@ -6976,7 +7172,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -7011,6 +7207,26 @@ interface UPGCrossEdge {
     target_product_id?: string;
     /** Confidence level if this edge was inferred during import */
     mapping_confidence?: UPGMappingConfidence;
+    /**
+     * Sanctioned divergence marker (`instance_of` only). When true, registry drift
+     * detection treats an instance title that differs from its canonical as
+     * intentional (an informative product-local name, e.g. "Vercel Platform / SDK"
+     * vs canonical "Vercel"), excluding it from the `title_divergence` count so
+     * `clean` reflects only un-sanctioned drift.
+     */
+    alias?: boolean;
+    /**
+     * Audience relevance for `area_serves_persona` / `area_targets_market_segment`:
+     * whether the audience is a primary or secondary focus of this area. The
+     * primary-vs-secondary distinction is the core value of the area-to-audience matrix.
+     */
+    relevance?: 'primary' | 'secondary';
+    /**
+     * Audience role in this area's context (`area_serves_persona`). Mirrors
+     * `PersonaProperties.audience_role`: the same persona can be a `buyer` for one
+     * area and a `user` for another.
+     */
+    audience_role?: 'buyer' | 'user' | 'champion' | 'influencer' | 'partner';
 }
 /**
  * A product area within a portfolio. The organisational axis (who owns
@@ -11023,6 +11239,14 @@ interface WireframeProperties {
  * }
  */
 interface UserFlowProperties {
+    /**
+     * 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.
+     */
+    flow_order?: number;
     /** Initiating event */
     trigger?: string;
     /** Ordered steps */
@@ -11066,6 +11290,13 @@ interface ScreenProperties {
  * }
  */
 interface ScreenStateProperties {
+    /**
+     * 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_order?: number;
     /** State */
     state_name: 'empty' | 'loading' | 'error' | 'populated' | 'skeleton' | 'partial';
     /** Cause for entering this state */
@@ -14855,6 +15086,13 @@ interface ProjectProperties {
  * }
  */
 interface MilestoneProperties {
+    /**
+     * 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`.
+     */
+    milestone_order?: number;
     /** Target due date (ISO format) */
     due_date?: ISODate;
     /** Whether the milestone was met on time */
@@ -17205,6 +17443,13 @@ interface HelpVideoProperties {
  * }
  */
 interface LearningPathProperties {
+    /**
+     * 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_order?: number;
     /** Overall difficulty level of the learning path */
     path_difficulty?: DifficultyLevel;
     /** Number of items (tutorials, videos, etc.) in the path */
@@ -17242,6 +17487,13 @@ interface PartnerProgramProperties {
  * }
  */
 interface PartnerTierProperties {
+    /**
+     * 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_order?: number;
     /** Numeric rank of the tier (higher = more prestigious) */
     tier_level?: number;
     /** What a partner must achieve to reach this tier */
@@ -18105,7 +18357,7 @@ type UPGNode<T extends keyof UPGPropertyMap = keyof UPGPropertyMap> = UPGBaseNod
  * AUTO-GENERATED by scripts/generate-property-registry.ts
  * Do not edit manually. Run: npx tsx scripts/generate-property-registry.ts
  *
- * Generated: 2026-06-09T23:36:57.066Z
+ * Generated: 2026-06-10T00:33:26.360Z
  * Entity types with properties: 316
  */
 interface PropertyDefinition {
@@ -20546,7 +20798,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.9.6";
+declare const UPG_VERSION: "0.9.8";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).