@unified-product-graph/core 0.23.1 → 0.24.0

package/dist/index.d.cts

@@ -1476,6 +1476,7 @@ declare const UPG_EDGE_CATALOG: {
         classification: "hierarchy";
         source_type: string;
         target_type: string;
+        cross_product_eligible: true;
     };
     epic_affected_by_bug: {
         forward_verb: string;
@@ -1483,6 +1484,7 @@ declare const UPG_EDGE_CATALOG: {
         classification: "hierarchy";
         source_type: string;
         target_type: string;
+        cross_product_eligible: true;
     };
     task_has_subtask: {
         forward_verb: string;
@@ -7641,6 +7643,120 @@ declare const UPG_EDGE_CATALOG: {
         cross_product_eligible: true;
         deliberate_only: true;
     };
+    deal_involves_contact: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    deal_challenged_by_objection: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_armed_with_competitive_battle_card: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_lost_to_competitor: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    deal_closed_via_contract: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_blocked_by_feature: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
+    research_study_analyzes_deal: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
+    account_raises_support_ticket: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    account_health_scored_via_customer_health_score: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    account_lost_because_churn_reason: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    account_implements_via_project: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    subscription_renews_via_deal: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    account_participates_in_beta_program: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_gated_by_security_review: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feature_communicated_via_messaging: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    launch_coordinated_via_project: {
+        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
@@ -11843,6 +11959,18 @@ interface EmptyCell {
  * const properties: ClassificationAxisProperties = {
  *   axis_kind: 'categorical',
  * }
+ *
+ * @example
+ * // Canonical governance axis `change_blast_radius` (ordinal): grade a change /
+ * // feature / decision by how much risk it carries, so review ceremony and
+ * // agent-autonomy gating scale with reach. Four ordered values —
+ * // Trivial(0) < Standard(1) < Significant(2) < Critical(3) — classified via the
+ * // polymorphic `node_classified_as_classification_value` edge. Report metrics
+ * // WITHIN tier (pooling across tiers is Simpson's-paradox bait). See
+ * // decisions/2026-07-15-change-blast-radius-axis.md.
+ * const properties: ClassificationAxisProperties = {
+ *   axis_kind: 'ordinal',
+ * }
  */
 interface ClassificationAxisProperties {
     /**
@@ -17496,8 +17624,10 @@ interface PositioningProperties {
  * }
  */
 interface MessagingProperties {
-    /** Channel this messaging variant is crafted for */
-    channel?: 'landing_page' | 'email' | 'social' | 'ad' | 'pitch' | 'press' | 'in_product' | 'other';
+    /** Channel this messaging variant is crafted for. `enablement` is the internal
+     * field-ops channel (SE/PMM/SA enablement one-pagers, battlecards' narrative),
+     * distinct from `pitch` (external, customer-facing). */
+    channel?: 'landing_page' | 'email' | 'social' | 'ad' | 'pitch' | 'press' | 'in_product' | 'enablement' | 'other';
     /** Marketing funnel stage this variant targets */
     funnel_stage?: 'awareness' | 'consideration' | 'conversion' | 'retention';
     /** Primary headline or hook */
@@ -17786,6 +17916,26 @@ interface AccountProperties {
     industry?: string;
     /** Number of employees at the account */
     employee_count?: number;
+    /**
+     * Go-to-market tier this account is served at. A segmentation *decision*
+     * (how the field org treats the account), distinct from `employee_count`
+     * (a raw fact) and aligned with but not identical to the ideal customer
+     * profile's `company_size` buckets. `strategic` is the tier that escalates
+     * to a dedicated account-plan graph (Tier 3 client model).
+     */
+    segment?: 'smb' | 'mid_market' | 'enterprise' | 'strategic';
+    /**
+     * Annual contract value in the account's billing currency. The single most
+     * common enterprise account-tiering input; a snapshot that changes on
+     * expansion or renewal.
+     */
+    annual_contract_value?: number;
+    /**
+     * Geographic region the account is managed in (e.g. "EMEA", "NA-West").
+     * Free-form: territory taxonomies vary by org and are modelled structurally
+     * via the `territory` entity when they need to be queryable.
+     */
+    region?: string;
 }
 /** Contact.
  *
@@ -17799,6 +17949,15 @@ interface ContactProperties {
     contact_role?: string;
     /** Whether this person has purchasing authority */
     is_decision_maker?: boolean;
+    /**
+     * Role this contact plays in the buying committee (the decision-making unit).
+     * The substrate of enterprise multi-threading and of qualification frameworks
+     * (MEDDICC/SPICED): a deal with no `champion` and no `economic_buyer` mapped is
+     * single-threaded and at risk. `is_decision_maker` becomes largely derivable
+     * (`buying_role = economic_buyer`) but is kept for back-compat.
+     * @example 'economic_buyer'
+     */
+    buying_role?: 'champion' | 'economic_buyer' | 'technical_evaluator' | 'end_user' | 'detractor' | 'influencer' | 'procurement' | 'legal' | 'security';
 }
 /** Lead.
  *
@@ -17834,6 +17993,45 @@ interface DealProperties {
     close_date?: ISODate;
     /** Likelihood of closing (0-100%) */
     probability?: number;
+    /**
+     * Terminal result of the deal. An Event-axis outcome (the verdict on a
+     * one-time event), NOT a lifecycle phase, so it is `deal_outcome` and not
+     * `deal_status` per the status-convention Rule 3. Lifecycle (open/won/lost as
+     * phases) belongs on the base `status` slot; this records the win/loss verdict
+     * a closed deal carries and gives `deal_lost_to_competitor` / win-loss study
+     * derivations their anchor.
+     * @example 'won'
+     */
+    deal_outcome?: 'won' | 'lost' | 'no_decision';
+    /**
+     * Motion this deal belongs to. Mirrors `PipelineSales.pipeline_type` at the
+     * deal grain; `renewal` is the value `subscription_renews_via_deal` points at.
+     * @example 'expansion'
+     */
+    deal_type?: 'new_business' | 'expansion' | 'renewal';
+    /**
+     * The single most-used CRM field: the next concrete action to move the deal.
+     * Free text on purpose (a coordination note, not a structured task).
+     * @example 'Send security questionnaire to procurement'
+     */
+    next_step?: string;
+    /** When the `next_step` is due (ISO format). */
+    next_step_date?: ISODate;
+    /**
+     * Qualification framework this deal is scored against. Names the rubric so the
+     * `qualification_score` is interpretable; per-pillar booleans (MEDDICC's Metrics /
+     * Economic buyer / Decision criteria / …) are deferred until `custom` recurrence
+     * proves the demand.
+     * @example 'meddicc'
+     */
+    qualification_framework?: 'meddicc' | 'bant' | 'spiced' | 'custom';
+    /**
+     * How well-qualified the deal is, on the canonical `confidence_5` scale
+     * (UPGAssessment: numeric value plus a high/medium/low label). Coarse by
+     * design; the granular per-pillar breakdown is deferred (see
+     * `qualification_framework`).
+     */
+    qualification_score?: UPGAssessment;
 }
 /** Sales pipeline.
  *
@@ -22540,7 +22738,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.23.1";
+declare const UPG_VERSION: "0.24.0";
 /**
  * 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

@@ -1476,6 +1476,7 @@ declare const UPG_EDGE_CATALOG: {
         classification: "hierarchy";
         source_type: string;
         target_type: string;
+        cross_product_eligible: true;
     };
     epic_affected_by_bug: {
         forward_verb: string;
@@ -1483,6 +1484,7 @@ declare const UPG_EDGE_CATALOG: {
         classification: "hierarchy";
         source_type: string;
         target_type: string;
+        cross_product_eligible: true;
     };
     task_has_subtask: {
         forward_verb: string;
@@ -7641,6 +7643,120 @@ declare const UPG_EDGE_CATALOG: {
         cross_product_eligible: true;
         deliberate_only: true;
     };
+    deal_involves_contact: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
+    deal_challenged_by_objection: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_armed_with_competitive_battle_card: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_lost_to_competitor: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    deal_closed_via_contract: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_blocked_by_feature: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
+    research_study_analyzes_deal: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
+    account_raises_support_ticket: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    account_health_scored_via_customer_health_score: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    account_lost_because_churn_reason: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    account_implements_via_project: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    subscription_renews_via_deal: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    account_participates_in_beta_program: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    deal_gated_by_security_review: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    feature_communicated_via_messaging: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    launch_coordinated_via_project: {
+        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
@@ -11843,6 +11959,18 @@ interface EmptyCell {
  * const properties: ClassificationAxisProperties = {
  *   axis_kind: 'categorical',
  * }
+ *
+ * @example
+ * // Canonical governance axis `change_blast_radius` (ordinal): grade a change /
+ * // feature / decision by how much risk it carries, so review ceremony and
+ * // agent-autonomy gating scale with reach. Four ordered values —
+ * // Trivial(0) < Standard(1) < Significant(2) < Critical(3) — classified via the
+ * // polymorphic `node_classified_as_classification_value` edge. Report metrics
+ * // WITHIN tier (pooling across tiers is Simpson's-paradox bait). See
+ * // decisions/2026-07-15-change-blast-radius-axis.md.
+ * const properties: ClassificationAxisProperties = {
+ *   axis_kind: 'ordinal',
+ * }
  */
 interface ClassificationAxisProperties {
     /**
@@ -17496,8 +17624,10 @@ interface PositioningProperties {
  * }
  */
 interface MessagingProperties {
-    /** Channel this messaging variant is crafted for */
-    channel?: 'landing_page' | 'email' | 'social' | 'ad' | 'pitch' | 'press' | 'in_product' | 'other';
+    /** Channel this messaging variant is crafted for. `enablement` is the internal
+     * field-ops channel (SE/PMM/SA enablement one-pagers, battlecards' narrative),
+     * distinct from `pitch` (external, customer-facing). */
+    channel?: 'landing_page' | 'email' | 'social' | 'ad' | 'pitch' | 'press' | 'in_product' | 'enablement' | 'other';
     /** Marketing funnel stage this variant targets */
     funnel_stage?: 'awareness' | 'consideration' | 'conversion' | 'retention';
     /** Primary headline or hook */
@@ -17786,6 +17916,26 @@ interface AccountProperties {
     industry?: string;
     /** Number of employees at the account */
     employee_count?: number;
+    /**
+     * Go-to-market tier this account is served at. A segmentation *decision*
+     * (how the field org treats the account), distinct from `employee_count`
+     * (a raw fact) and aligned with but not identical to the ideal customer
+     * profile's `company_size` buckets. `strategic` is the tier that escalates
+     * to a dedicated account-plan graph (Tier 3 client model).
+     */
+    segment?: 'smb' | 'mid_market' | 'enterprise' | 'strategic';
+    /**
+     * Annual contract value in the account's billing currency. The single most
+     * common enterprise account-tiering input; a snapshot that changes on
+     * expansion or renewal.
+     */
+    annual_contract_value?: number;
+    /**
+     * Geographic region the account is managed in (e.g. "EMEA", "NA-West").
+     * Free-form: territory taxonomies vary by org and are modelled structurally
+     * via the `territory` entity when they need to be queryable.
+     */
+    region?: string;
 }
 /** Contact.
  *
@@ -17799,6 +17949,15 @@ interface ContactProperties {
     contact_role?: string;
     /** Whether this person has purchasing authority */
     is_decision_maker?: boolean;
+    /**
+     * Role this contact plays in the buying committee (the decision-making unit).
+     * The substrate of enterprise multi-threading and of qualification frameworks
+     * (MEDDICC/SPICED): a deal with no `champion` and no `economic_buyer` mapped is
+     * single-threaded and at risk. `is_decision_maker` becomes largely derivable
+     * (`buying_role = economic_buyer`) but is kept for back-compat.
+     * @example 'economic_buyer'
+     */
+    buying_role?: 'champion' | 'economic_buyer' | 'technical_evaluator' | 'end_user' | 'detractor' | 'influencer' | 'procurement' | 'legal' | 'security';
 }
 /** Lead.
  *
@@ -17834,6 +17993,45 @@ interface DealProperties {
     close_date?: ISODate;
     /** Likelihood of closing (0-100%) */
     probability?: number;
+    /**
+     * Terminal result of the deal. An Event-axis outcome (the verdict on a
+     * one-time event), NOT a lifecycle phase, so it is `deal_outcome` and not
+     * `deal_status` per the status-convention Rule 3. Lifecycle (open/won/lost as
+     * phases) belongs on the base `status` slot; this records the win/loss verdict
+     * a closed deal carries and gives `deal_lost_to_competitor` / win-loss study
+     * derivations their anchor.
+     * @example 'won'
+     */
+    deal_outcome?: 'won' | 'lost' | 'no_decision';
+    /**
+     * Motion this deal belongs to. Mirrors `PipelineSales.pipeline_type` at the
+     * deal grain; `renewal` is the value `subscription_renews_via_deal` points at.
+     * @example 'expansion'
+     */
+    deal_type?: 'new_business' | 'expansion' | 'renewal';
+    /**
+     * The single most-used CRM field: the next concrete action to move the deal.
+     * Free text on purpose (a coordination note, not a structured task).
+     * @example 'Send security questionnaire to procurement'
+     */
+    next_step?: string;
+    /** When the `next_step` is due (ISO format). */
+    next_step_date?: ISODate;
+    /**
+     * Qualification framework this deal is scored against. Names the rubric so the
+     * `qualification_score` is interpretable; per-pillar booleans (MEDDICC's Metrics /
+     * Economic buyer / Decision criteria / …) are deferred until `custom` recurrence
+     * proves the demand.
+     * @example 'meddicc'
+     */
+    qualification_framework?: 'meddicc' | 'bant' | 'spiced' | 'custom';
+    /**
+     * How well-qualified the deal is, on the canonical `confidence_5` scale
+     * (UPGAssessment: numeric value plus a high/medium/low label). Coarse by
+     * design; the granular per-pillar breakdown is deferred (see
+     * `qualification_framework`).
+     */
+    qualification_score?: UPGAssessment;
 }
 /** Sales pipeline.
  *
@@ -22540,7 +22738,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.23.1";
+declare const UPG_VERSION: "0.24.0";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).