@unified-product-graph/core 0.7.5 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -7970,6 +7970,19 @@ declare const UPG_SCALES: Record<string, UPGScaleDefinition>;
7970
7970
  * const point = scale?.points.find(p => p.value === assessment.value)
7971
7971
  */
7972
7972
  declare function getScale(scaleId: string): UPGScaleDefinition | undefined;
7973
+ /**
7974
+ * Per-property scale overrides.
7975
+ *
7976
+ * Maps a property name to the scale that best captures its semantics.
7977
+ * Properties absent from this map fall back to `'scale_5'`, a generic
7978
+ * 1–5 ordinal. The mapping is keyed by property name only; the `entityType`
7979
+ * parameter on `getPropertyDefaultScale` is reserved for future per-entity
7980
+ * disambiguation.
7981
+ *
7982
+ * Sources: all `UPGAssessment`-typed properties across
7983
+ * `packages/upg-spec/src/properties/domains/` (audited at v0.4.0).
7984
+ */
7985
+ declare const PROPERTY_SCALE_MAP: Record<string, string>;
7973
7986
  /**
7974
7987
  * Return the default scale ID for a given entity-type / property-name pair.
7975
7988
  *
@@ -7993,6 +8006,18 @@ declare function getScale(scaleId: string): UPGScaleDefinition | undefined;
7993
8006
  * getPropertyDefaultScale('anything', 'unknown_property') // → 'scale_5'
7994
8007
  */
7995
8008
  declare function getPropertyDefaultScale(_entityType: string, propertyName: string): string;
8009
+ /**
8010
+ * Inverse of `PROPERTY_SCALE_MAP`: the canonical property names that default to
8011
+ * a given scale, in declaration order. Useful for documentation surfaces that
8012
+ * want to show "where is this scale used".
8013
+ *
8014
+ * Returns an empty array for scales no property defaults to (e.g. the generic
8015
+ * `'scale_5'` fallback, which is never an explicit entry).
8016
+ *
8017
+ * @example
8018
+ * getPropertiesForScale('effort_5') // → ['effort', 'effort_estimate', 'effort_to_fix']
8019
+ */
8020
+ declare function getPropertiesForScale(scaleId: string): string[];
7996
8021
 
7997
8022
  /**
7998
8023
  * UPG Enum Scales. Runtime metadata for the closed-enum primitives in
@@ -8845,17 +8870,81 @@ type HealthStatus = 'on_track' | 'at_risk' | 'off_track';
8845
8870
  * `'guideline'`: recommendation, encouraged, not enforced
8846
8871
  */
8847
8872
  type RuleStrength = 'must' | 'must_not' | 'exception' | 'warning' | 'guideline';
8848
- /** Confidence level for assumptions, evidence, and feasibility */
8873
+ /**
8874
+ * Confidence level for assumptions, evidence, and feasibility.
8875
+ *
8876
+ * @deprecated since v0.8.0. Confidence is now expressed as a structured
8877
+ * `UPGAssessment` on the numeric `confidence_5` scale (UPG-579 Option C), so
8878
+ * the qualitative label and a computable/comparable value travel together.
8879
+ * Migrate `confidence: Confidence` to `confidence: UPGAssessment` with
8880
+ * `scale_id: 'confidence_5'` (suggested value map: `high` -> 5, `medium` -> 3,
8881
+ * `low` -> 1). The enum is retained only for back-compat reads.
8882
+ */
8849
8883
  type Confidence = 'high' | 'medium' | 'low';
8850
8884
  /**
8851
8885
  * Three-point ordinal scale: low / medium / high.
8852
8886
  *
8853
- * Intentional alias of `Confidence`. The value set is identical.
8854
- * Use `LowMedHigh` when the property semantics are clearly about magnitude
8855
- * or degree (e.g. `substitutability`, `magnitude`) rather than epistemic
8856
- * confidence. Both types accept the same runtime strings.
8887
+ * @deprecated since v0.8.0. Alias of the deprecated `Confidence`; was used by
8888
+ * zero properties. For magnitude/degree judgments use a named enum scale or a
8889
+ * `UPGAssessment`. Retained only for back-compat.
8857
8890
  */
8858
8891
  type LowMedHigh = Confidence;
8892
+ /**
8893
+ * Maturity of a root-cause determination during incident debugging.
8894
+ *
8895
+ * Used by `engineering.ts` (`root_cause.cause_confidence`). An epistemic
8896
+ * *maturity ladder*, distinct from `Confidence`'s level vocabulary. Pairs
8897
+ * with `UPG_ENUM_SCALES.CauseConfidence` for per-value labels.
8898
+ *
8899
+ * Members (tentative → certain):
8900
+ * `'hypothesised'` : a proposed cause, not yet tested
8901
+ * `'likely'` : supported by evidence but not conclusively proven
8902
+ * `'confirmed'` : verified as the cause
8903
+ */
8904
+ type CauseConfidence = 'hypothesised' | 'likely' | 'confirmed';
8905
+ /**
8906
+ * A person's comfort level with a tool, technology, or practice.
8907
+ *
8908
+ * Used by `users.ts` (`persona.tech_comfort`). Pairs with
8909
+ * `UPG_ENUM_SCALES.ComfortLevel` for per-value labels and descriptions.
8910
+ *
8911
+ * Members (low → expert, plus an escape hatch):
8912
+ * `'low'` : little or no familiarity
8913
+ * `'medium'` : functional, everyday competence
8914
+ * `'high'` : confident, fluent use
8915
+ * `'expert'` : deep mastery; can teach or extend
8916
+ * `'other'` : a comfort profile not captured by the above tiers
8917
+ */
8918
+ type ComfortLevel = 'low' | 'medium' | 'high' | 'expert' | 'other';
8919
+ /**
8920
+ * Operational log / alert verbosity level. Distinct from user-impact
8921
+ * `severity_5` (UPG-579 Option 0): this classifies how loud a signal should
8922
+ * be, not how bad an outcome is for the user.
8923
+ *
8924
+ * Used by `devops.ts` (`monitor.severity`). Pairs with
8925
+ * `UPG_ENUM_SCALES.LogLevel` for per-value labels and descriptions.
8926
+ *
8927
+ * Members (loudest → quietest):
8928
+ * `'critical'` : page someone now; service-affecting
8929
+ * `'warning'` : needs attention soon, not yet service-affecting
8930
+ * `'info'` : informational; no action required
8931
+ */
8932
+ type LogLevel = 'critical' | 'warning' | 'info';
8933
+ /**
8934
+ * Incident severity tier (paging classification). Distinct from user-impact
8935
+ * `severity_5` and from `LogLevel` (UPG-579 Option 0): this is the ops-side
8936
+ * blast-radius tier used to drive escalation and response process.
8937
+ *
8938
+ * Used by `devops.ts` (`incident.severity_level`). Pairs with
8939
+ * `UPG_ENUM_SCALES.IncidentSeverity` for per-value labels and descriptions.
8940
+ *
8941
+ * Members (most severe -> least):
8942
+ * `'sev1'` : critical outage; full response, exec-visible
8943
+ * `'sev2'` : major degradation; urgent response
8944
+ * `'sev3'` : minor/partial impact; handled in hours
8945
+ * `'sev4'` : negligible impact; routine handling
8946
+ */
8947
+ type IncidentSeverity = 'sev1' | 'sev2' | 'sev3' | 'sev4';
8859
8948
  /**
8860
8949
  * Urgency level of an inbound signal (customer, support, or market).
8861
8950
  *
@@ -8872,6 +8961,40 @@ type SignalUrgency = 'low' | 'medium' | 'high' | 'critical';
8872
8961
  * negative → mixed (valence-first).
8873
8962
  */
8874
8963
  type SignalSentiment = 'positive' | 'neutral' | 'negative' | 'mixed';
8964
+ /**
8965
+ * Capability/process maturity on the CMMI ladder. Used by `strategy.ts`
8966
+ * (`maturity_level`, `target_maturity`). Pairs with `UPG_ENUM_SCALES.MaturityLevel`.
8967
+ */
8968
+ type MaturityLevel = 'initial' | 'developing' | 'defined' | 'managed' | 'optimizing';
8969
+ /**
8970
+ * WCAG conformance level. Used by `accessibility.ts` (`conformance_level`,
8971
+ * `level`). Pairs with `UPG_ENUM_SCALES.ConformanceLevel`.
8972
+ */
8973
+ type ConformanceLevel = 'A' | 'AA' | 'AAA';
8974
+ /**
8975
+ * Data classification / sensitivity tier. Used by `data.ts` (`sensitivity`)
8976
+ * and `security.ts` (`level`). Pairs with `UPG_ENUM_SCALES.DataSensitivity`.
8977
+ */
8978
+ type DataSensitivity = 'public' | 'internal' | 'confidential' | 'restricted';
8979
+ /**
8980
+ * Learning difficulty tier. Used by `education.ts` (`difficulty`,
8981
+ * `path_difficulty`). Pairs with `UPG_ENUM_SCALES.DifficultyLevel`.
8982
+ */
8983
+ type DifficultyLevel = 'beginner' | 'intermediate' | 'advanced';
8984
+ /**
8985
+ * Qualitative frequency rating (distinct from the numeric `frequency_5` scale
8986
+ * and from `Cadence`'s calendar tiers). Used by `frequency_rating` across
8987
+ * gtm/business-model/engineering/content/customer-success. Pairs with
8988
+ * `UPG_ENUM_SCALES.FrequencyRating`.
8989
+ */
8990
+ type FrequencyRating = 'constant' | 'regular' | 'occasional' | 'rare' | 'other';
8991
+ /**
8992
+ * Direction of evidence relative to a claim (supports / refutes / neutral).
8993
+ * Distinct from `confidence_impact` (strengthens/weakens) per the UPG-579
8994
+ * polysemy verdicts. Used by `validation.ts` (`direction`, `result_direction`).
8995
+ * Pairs with `UPG_ENUM_SCALES.EvidenceDirection`.
8996
+ */
8997
+ type EvidenceDirection = 'supports' | 'refutes' | 'neutral';
8875
8998
  /**
8876
8999
  * Channel through which an inbound signal was received.
8877
9000
  *
@@ -9163,9 +9286,9 @@ interface InitiativeProperties {
9163
9286
  */
9164
9287
  interface CapabilityProperties {
9165
9288
  /** Current maturity */
9166
- maturity_level?: 'initial' | 'developing' | 'defined' | 'managed' | 'optimizing';
9289
+ maturity_level?: MaturityLevel;
9167
9290
  /** Target maturity */
9168
- target_maturity?: 'initial' | 'developing' | 'defined' | 'managed' | 'optimizing';
9291
+ target_maturity?: MaturityLevel;
9169
9292
  /** Gap between current and target */
9170
9293
  gap?: string;
9171
9294
  /**
@@ -9198,8 +9321,8 @@ interface CapabilityProperties {
9198
9321
  * }
9199
9322
  */
9200
9323
  interface ValueStreamProperties {
9201
- /** Current stage in the value delivery pipeline */
9202
- stream_stage?: string;
9324
+ /** Current stage in the value delivery pipeline (UPG-579 Option B). */
9325
+ stream_stage?: 'discovery' | 'definition' | 'build' | 'delivery' | 'operation' | 'other';
9203
9326
  /**
9204
9327
  * End-to-end lead time.
9205
9328
  * @example "2 weeks"
@@ -9246,8 +9369,8 @@ interface StrategicPillarProperties {
9246
9369
  * }
9247
9370
  */
9248
9371
  interface AssumptionProperties {
9249
- /** Confidence before testing. Independent of whether the assumption is validated (tracked in lifecycle). */
9250
- confidence?: Confidence;
9372
+ /** Confidence before testing (UPGAssessment on `confidence_5`). Independent of whether the assumption is validated (tracked in lifecycle). */
9373
+ confidence?: UPGAssessment;
9251
9374
  /** Validation method, planned or used */
9252
9375
  validation_method?: string;
9253
9376
  /** Exposure if the assumption turns out wrong */
@@ -9375,7 +9498,7 @@ interface PersonaProperties {
9375
9498
  * Tech comfort. Closed set so personas across products compare on the same axis.
9376
9499
  * Free-text colour belongs in `context` or `motivation`.
9377
9500
  */
9378
- tech_comfort?: 'low' | 'medium' | 'high' | 'expert' | 'other';
9501
+ tech_comfort?: ComfortLevel;
9379
9502
  /** Industry or domain knowledge this persona brings
9380
9503
  * @example "10+ years SaaS experience", "New to healthcare IT" */
9381
9504
  domain_expertise?: string;
@@ -9551,8 +9674,8 @@ interface FeasibilityStudyProperties {
9551
9674
  study_type?: 'technical' | 'business' | 'market' | 'resource';
9552
9675
  /** Outcome conclusion of the study */
9553
9676
  conclusion?: 'feasible' | 'not_feasible' | 'conditional' | 'needs_more_data';
9554
- /** Confidence in the conclusion */
9555
- confidence?: Confidence;
9677
+ /** Confidence in the conclusion (UPGAssessment on `confidence_5`). */
9678
+ confidence?: UPGAssessment;
9556
9679
  }
9557
9680
  /** DesignSprint entity.
9558
9681
  *
@@ -9595,7 +9718,7 @@ interface DesignSprintProperties {
9595
9718
  * will_result_in: 'will result in higher decision confidence',
9596
9719
  * we_know_when: 'we know when 60% of decisions cite evidence',
9597
9720
  * risk_if_wrong: 'Wasted dev cycles wiring evidence panels users ignore',
9598
- * current_confidence: { value: 3, scale: 'confidence_5pt', label: 'Medium' },
9721
+ * current_confidence: { value: 3, scale: 'confidence_5', label: 'Medium' },
9599
9722
  * }
9600
9723
  */
9601
9724
  interface HypothesisProperties {
@@ -9639,8 +9762,8 @@ interface HypothesisEvidenceProperties {
9639
9762
  * longer type-check. Migration: `confirms → supports`, `disconfirms → refutes`,
9640
9763
  * `inconclusive → neutral`.
9641
9764
  */
9642
- direction?: 'supports' | 'refutes' | 'neutral';
9643
- /** Strength of the evidence (UPGAssessment, scale `weight_5pt`). */
9765
+ direction?: EvidenceDirection;
9766
+ /** Strength of the evidence (UPGAssessment, scale `scale_5`). */
9644
9767
  weight?: UPGAssessment;
9645
9768
  /** Plain-English summary of what the evidence shows. */
9646
9769
  summary?: string;
@@ -9696,8 +9819,8 @@ interface ExperimentProperties {
9696
9819
  * method: 'a_b_test',
9697
9820
  * success_criteria: 'Day-7 activation rate +5% lift, p<0.05',
9698
9821
  * target_metric_id: 'mtr_day7_activation',
9699
- * projected_reach: { value: 4, scale: 'reach_5pt', evidence: 'Cohort sizing' },
9700
- * confidence: { value: 3, scale: 'confidence_5pt' },
9822
+ * projected_reach: { value: 4, scale: 'reach_5', evidence: 'Cohort sizing' },
9823
+ * confidence: { value: 3, scale: 'confidence_5' },
9701
9824
  * planned_start_date: '2026-05-01',
9702
9825
  * planned_end_date: '2026-05-21',
9703
9826
  * }
@@ -9711,7 +9834,7 @@ interface ExperimentPlanProperties {
9711
9834
  projected_reach?: UPGAssessment;
9712
9835
  /** Projected impact on the target metric (UPGAssessment) */
9713
9836
  projected_impact?: UPGAssessment;
9714
- /** Team confidence at plan-time (UPGAssessment, scale `confidence_5pt`) */
9837
+ /** Team confidence at plan-time (UPGAssessment, scale `confidence_5`) */
9715
9838
  confidence?: UPGAssessment;
9716
9839
  /** Cost estimate at plan-time (UPGAssessment) */
9717
9840
  cost_estimate?: UPGAssessment;
@@ -9736,7 +9859,7 @@ interface ExperimentPlanProperties {
9736
9859
  * actual_end_date: '2026-05-22',
9737
9860
  * actual_reach: 12450,
9738
9861
  * outcome_summary: 'Variant B uplift +6.3% on day-7 activation, p=0.03.',
9739
- * severity_of_finding: { value: 4, scale: 'severity_5pt' },
9862
+ * severity_of_finding: { value: 4, scale: 'severity_5' },
9740
9863
  * learning: 'Onboarding tooltip placement materially shifts activation; productize.',
9741
9864
  * disposition: 'confirmed',
9742
9865
  * }
@@ -9787,7 +9910,7 @@ interface LearningProperties {
9787
9910
  * `Evidence.direction` and `HypothesisEvidence.direction`. Migration:
9788
9911
  * `positive → supports`, `negative → refutes`, `neutral → neutral`.
9789
9912
  */
9790
- result_direction?: 'supports' | 'refutes' | 'neutral';
9913
+ result_direction?: EvidenceDirection;
9791
9914
  /** Confidence impact on the parent hypothesis */
9792
9915
  confidence_impact?: 'strengthens' | 'weakens' | 'neutral';
9793
9916
  }
@@ -9850,7 +9973,7 @@ interface ResearchPlanProperties {
9850
9973
  * evidence_rigor: 'quantitative',
9851
9974
  * evidence_source: 'experiment_run',
9852
9975
  * direction: 'supports',
9853
- * weight: { value: 4, scale: 'weight_5pt', label: 'Strong' },
9976
+ * weight: { value: 4, scale: 'scale_5', label: 'Strong' },
9854
9977
  * summary: 'Variant B uplift +6.3% on day-7 activation, p=0.03 across n=12,450.',
9855
9978
  * observed_at: '2026-05-22',
9856
9979
  * }
@@ -9864,8 +9987,8 @@ interface EvidenceProperties {
9864
9987
  */
9865
9988
  evidence_source?: 'experiment_run' | 'observation' | 'quote' | 'metric_change' | 'market_data' | 'interview';
9866
9989
  /** Direction relative to the parent hypothesis. */
9867
- direction?: 'supports' | 'refutes' | 'neutral';
9868
- /** Strength (UPGAssessment, scale `weight_5pt`). */
9990
+ direction?: EvidenceDirection;
9991
+ /** Strength (UPGAssessment, scale `scale_5`). */
9869
9992
  weight?: UPGAssessment;
9870
9993
  /** Plain-English summary. */
9871
9994
  summary?: string;
@@ -9873,11 +9996,6 @@ interface EvidenceProperties {
9873
9996
  observed_at?: ISODate;
9874
9997
  /** Free-text provenance note */
9875
9998
  source?: string;
9876
- /**
9877
- * @deprecated since v0.4.0. Use `weight: UPGAssessment`.
9878
- * Simple enum replaced by structured assessment to align with UPG scoring patterns.
9879
- */
9880
- strength?: 'strong' | 'moderate' | 'weak';
9881
9999
  }
9882
10000
 
9883
10001
  /**
@@ -10284,7 +10402,7 @@ interface ObservationProperties {
10284
10402
  * Structured sentiment. Tools like Dovetail and EnjoyHQ converge on these
10285
10403
  * four values. More precise than `highlight_tag` for aggregation.
10286
10404
  */
10287
- sentiment?: 'positive' | 'negative' | 'neutral' | 'mixed';
10405
+ sentiment?: SignalSentiment;
10288
10406
  }
10289
10407
  /** Verbatim quote from a participant.
10290
10408
  * Link to the participant via an edge, not a speaker property.
@@ -10319,8 +10437,8 @@ interface InsightProperties {
10319
10437
  * `strategic` = finding that affects product direction.
10320
10438
  */
10321
10439
  insight_level?: 'pattern' | 'finding' | 'actionable' | 'strategic';
10322
- /** Confidence. Reflects the strength and diversity of supporting evidence. */
10323
- confidence?: Confidence;
10440
+ /** Confidence (UPGAssessment on `confidence_5`). Reflects the strength and diversity of supporting evidence. */
10441
+ confidence?: UPGAssessment;
10324
10442
  /** Supporting observations, quotes, or evidence items. Higher counts increase confidence. */
10325
10443
  evidence_count?: number;
10326
10444
  /**
@@ -10364,8 +10482,8 @@ interface AffinityClusterProperties {
10364
10482
  theme?: string;
10365
10483
  /** Observations in this cluster */
10366
10484
  child_observation_count?: number;
10367
- /** Confidence in the theme's validity */
10368
- confidence?: Confidence;
10485
+ /** Confidence in the theme's validity (UPGAssessment on `confidence_5`). */
10486
+ confidence?: UPGAssessment;
10369
10487
  }
10370
10488
  /** Research question guiding a study.
10371
10489
  *
@@ -10589,8 +10707,8 @@ interface DesignQuestionProperties {
10589
10707
  framing?: 'how_might_we' | 'what_if' | 'why_do' | 'how_do' | 'what_prevents' | 'other';
10590
10708
  /** Importance against other backlog questions */
10591
10709
  priority?: Priority;
10592
- /** Confidence the question is well-framed. Distinct from confidence in any answer. */
10593
- confidence?: Confidence;
10710
+ /** Confidence the question is well-framed (UPGAssessment on `confidence_5`). Distinct from confidence in any answer. */
10711
+ confidence?: UPGAssessment;
10594
10712
  /** Underlying assumptions. Surfaced explicitly so they can be challenged or validated. */
10595
10713
  assumptions?: string[];
10596
10714
  /** Primary validation method */
@@ -11171,10 +11289,11 @@ interface OutcomeProperties {
11171
11289
  /** Confidence this is the right outcome to pursue */
11172
11290
  confidence?: UPGAssessment;
11173
11291
  /**
11174
- * Current lifecycle phase. Free-form until an outcome lifecycle is defined
11175
- * in `grammar/lifecycles.ts`.
11292
+ * Current lifecycle phase, mirroring the `outcome` lifecycle in
11293
+ * `grammar/lifecycles.ts` (UPG-579 Option B): `identified` -> `measuring` ->
11294
+ * `achieved` | `abandoned`.
11176
11295
  */
11177
- outcome_status?: string;
11296
+ outcome_status?: 'identified' | 'measuring' | 'achieved' | 'abandoned';
11178
11297
  }
11179
11298
  /** A high-level strategic goal. The O in OKR.
11180
11299
  *
@@ -11329,18 +11448,14 @@ interface UserStoryProperties {
11329
11448
  }
11330
11449
  /**
11331
11450
  * @deprecated since v0.4.0. Use `TaskProperties`. `story_task` collapsed into
11332
- * canonical `task`. `estimate` absorbed; `task_implements_user_story`
11333
- * edge expresses the story relationship.
11334
- * Migration: `UPG_MIGRATIONS['0.4.0']` renames story_task nodes to task.
11335
- */
11336
- interface StoryTaskProperties {
11337
- /** @deprecated Use TaskProperties.estimate */
11338
- estimate?: string;
11339
- /** @deprecated Use TaskProperties.effort (string form) */
11340
- effort?: number;
11341
- /** @deprecated Use TaskProperties.priority */
11342
- priority?: Priority;
11343
- }
11451
+ * canonical `task`. `task_implements_user_story` edge expresses the story
11452
+ * relationship. The former `estimate` / `effort` / `priority` fields were
11453
+ * removed in v0.8.0 (UPG-574); their values live on the canonical `task`
11454
+ * (`TaskProperties.estimate` / `.effort` / `.priority`).
11455
+ * Migration: `UPG_MIGRATIONS['0.4.0']` renames story_task nodes to task;
11456
+ * `UPG_PROPERTY_MIGRATIONS['0.8.0']` drops the removed property residue.
11457
+ */
11458
+ type StoryTaskProperties = Record<string, never>;
11344
11459
  /** Acceptance criterion on a story or feature.
11345
11460
  *
11346
11461
  * @example
@@ -11381,18 +11496,11 @@ interface ReleaseProperties {
11381
11496
  *
11382
11497
  * @example
11383
11498
  * const properties: TaskProperties = {
11384
- * task_status: 'todo',
11385
11499
  * assignee: 'sam.patel@arkheiev.com',
11386
11500
  * effort: '3 person-weeks',
11387
11501
  * }
11388
11502
  */
11389
11503
  interface TaskProperties {
11390
- /**
11391
- * @deprecated since v0.4.0. Use top-level `UPGBaseNode.status`.
11392
- * Values map identically: todo | in_progress | in_review | done.
11393
- * Migration: `UPG_PROPERTY_MIGRATIONS['0.4.0']` lifts this to `status`.
11394
- */
11395
- task_status?: 'todo' | 'in_progress' | 'in_review' | 'done';
11396
11504
  /** Assigned person */
11397
11505
  assignee?: string;
11398
11506
  /** Effort estimate (e.g. "2h", "1d", "3 points"). Use a consistent unit within your team. */
@@ -11414,23 +11522,19 @@ interface TaskProperties {
11414
11522
  *
11415
11523
  * @example
11416
11524
  * const properties: BugProperties = {
11417
- * bug_severity: 'critical',
11418
- * bug_status: 'open',
11525
+ * bug_severity: { value: 5, scale: 'severity_5', label: 'critical' },
11419
11526
  * steps_to_reproduce: 'steps to reproduce',
11420
11527
  * }
11421
11528
  */
11422
11529
  interface BugProperties {
11423
11530
  /**
11424
- * Impact severity. Independent of priority (which governs when it gets fixed).
11425
- * `critical` = data loss or complete feature failure. `trivial` = cosmetic only.
11426
- */
11427
- bug_severity?: 'critical' | 'major' | 'minor' | 'trivial';
11428
- /**
11429
- * @deprecated since v0.4.0. Use top-level `UPGBaseNode.status`.
11430
- * Values map identically: open | in_progress | fixed | verified | wont_fix.
11431
- * Migration: `UPG_PROPERTY_MIGRATIONS['0.4.0']` lifts this to `status`.
11531
+ * Impact severity (UPGAssessment on the `severity_5` scale). Independent of
11532
+ * priority (which governs when it gets fixed). Migrated from the inline
11533
+ * `critical|major|minor|trivial` enum (UPG-579 Option C): map
11534
+ * `critical` -> 5, `major` -> 4, `minor` -> 2, `trivial` -> 1; carry the old
11535
+ * word in `label`.
11432
11536
  */
11433
- bug_status?: 'open' | 'in_progress' | 'fixed' | 'verified' | 'wont_fix';
11537
+ bug_severity?: UPGAssessment;
11434
11538
  /** Step-by-step reproduction */
11435
11539
  steps_to_reproduce?: string;
11436
11540
  /** Observed environment (e.g. "prod", "staging", "iOS 17.4") */
@@ -11479,8 +11583,8 @@ interface RoadmapItemProperties {
11479
11583
  priority?: Priority;
11480
11584
  /** Status. `deferred` = explicitly pushed to a later period. */
11481
11585
  item_status?: 'planned' | 'in_progress' | 'shipped' | 'deferred';
11482
- /** Delivery confidence within the planned period. */
11483
- confidence?: Confidence;
11586
+ /** Delivery confidence within the planned period (UPGAssessment on `confidence_5`). */
11587
+ confidence?: UPGAssessment;
11484
11588
  /** ISO date work begins. More precise than `quarter` for continuous planning. */
11485
11589
  start_date?: ISODate;
11486
11590
  /** ISO date completion is expected. For shipped items, the actual completion date. */
@@ -11558,7 +11662,10 @@ type GuardrailStatus = 'safe' | 'warning' | 'breached';
11558
11662
  type MetricSegmentType = 'persona' | 'cohort' | 'channel' | 'geography' | 'device' | 'plan' | 'custom';
11559
11663
  /** Why a metric is used as a proxy */
11560
11664
  type ProxyReason = 'qualitative' | 'no_direct_measure' | 'not_yet_instrumented' | 'too_expensive';
11561
- /** How strongly a proxy metric predicts the direct measure */
11665
+ /**
11666
+ * How strongly a proxy metric predicts the direct measure. Pairs with
11667
+ * `UPG_ENUM_SCALES.ProxyConfidence` for per-value labels and descriptions.
11668
+ */
11562
11669
  type ProxyConfidence = 'strong' | 'moderate' | 'weak';
11563
11670
  /** A time-series reading for a metric. One data point in the metric's history. */
11564
11671
  interface MetricDataPoint {
@@ -12219,7 +12326,7 @@ interface RootCauseProperties {
12219
12326
  * `UPGAssessment`-typed epistemic confidence used elsewhere. The 3-tier shape
12220
12327
  * stays as a discrete RCA-lifecycle marker.
12221
12328
  */
12222
- cause_confidence?: 'hypothesised' | 'likely' | 'confirmed';
12329
+ cause_confidence?: CauseConfidence;
12223
12330
  /** One-paragraph evidence summary. Log lines, traces, repro steps. Detailed artefacts go on linked `evidence` nodes. */
12224
12331
  evidence_summary?: string;
12225
12332
  /** Legacy free-form category. Retained for v0.2 baseline; new graphs prefer `cause_category`. */
@@ -12276,7 +12383,7 @@ interface SymptomProperties {
12276
12383
  * Migration: `once → rare`, `sporadic → occasional`,
12277
12384
  * `frequent → regular`, `constant → constant`.
12278
12385
  */
12279
- frequency_rating?: 'rare' | 'occasional' | 'regular' | 'constant' | 'other';
12386
+ frequency_rating?: FrequencyRating;
12280
12387
  /** Approximate count of users affected. Snapshot estimate. */
12281
12388
  affected_users_estimate?: number;
12282
12389
  /** Reproduction reliability */
@@ -12466,16 +12573,18 @@ interface IncidentProperties {
12466
12573
  */
12467
12574
  incident_type?: 'operational' | 'security' | 'data_breach' | 'performance' | 'dependency' | 'other';
12468
12575
  /**
12469
- * Severity. `sev1` = critical/system down. `sev2` = major impact.
12470
- * `sev3` = minor impact. `sev4` = minimal impact.
12576
+ * Incident severity tier (paging classification). `sev1` = critical/system
12577
+ * down. `sev2` = major impact. `sev3` = minor impact. `sev4` = minimal.
12578
+ * Uses the `IncidentSeverity` scale; distinct from user-impact `severity_5`.
12471
12579
  * @example "sev1" for complete service unavailability
12472
12580
  */
12473
- severity_level?: 'sev1' | 'sev2' | 'sev3' | 'sev4';
12581
+ severity_level?: IncidentSeverity;
12474
12582
  /**
12475
- * Notification urgency. Independent of severity.
12476
- * `high` triggers phone calls. `low` sends a message.
12583
+ * Notification urgency. Independent of severity. Uses the shared
12584
+ * `SignalUrgency` scale (`low` | `medium` | `high` | `critical`);
12585
+ * higher tiers escalate the notification channel.
12477
12586
  */
12478
- urgency?: 'high' | 'low';
12587
+ urgency?: SignalUrgency;
12479
12588
  /** ISO timestamp the incident started or was first detected. */
12480
12589
  started_at?: ISODateTime;
12481
12590
  /** ISO timestamp first acknowledged by a responder. Used to compute time-to-acknowledge. */
@@ -12608,10 +12717,11 @@ interface AlertRuleProperties {
12608
12717
  */
12609
12718
  condition?: string;
12610
12719
  /**
12611
- * Routes notification and escalation.
12720
+ * Routes notification and escalation. Uses the `LogLevel` scale (operational
12721
+ * verbosity, distinct from user-impact `severity_5`).
12612
12722
  * `critical` = page immediately. `warning` = notify, don't page. `info` = log only.
12613
12723
  */
12614
- severity?: 'critical' | 'warning' | 'info';
12724
+ severity?: LogLevel;
12615
12725
  /**
12616
12726
  * Notification destination.
12617
12727
  * @example "pagerduty:sev1-rotation", "slack:#alerts-low"
@@ -13095,12 +13205,14 @@ interface VulnerabilityProperties {
13095
13205
  cvss_score?: number;
13096
13206
  /**
13097
13207
  * Categorical severity derived from CVSS.
13098
- * `critical` = 9.0–10.0. `high` = 7.0–8.9. `medium` = 4.0–6.9.
13099
- * `low` = 0.1–3.9. `informational` = 0.0.
13100
- * Score alone is insufficient for triage; severity drives filtering and prioritisation.
13101
- * @example "critical" for a remotely exploitable, no-auth-required vulnerability
13208
+ * Impact severity (UPGAssessment on the `severity_5` scale). Score alone is
13209
+ * insufficient for triage; severity drives filtering and prioritisation.
13210
+ * Migrated from the inline `critical|high|medium|low|informational` enum
13211
+ * (UPG-579 Option C): map `critical` -> 5, `high` -> 4, `medium` -> 3,
13212
+ * `low` -> 2, `informational` -> 1; carry the old word in `label`.
13213
+ * @example value 5, label 'Critical', scale_id 'severity_5' (a remotely exploitable, no-auth vuln)
13102
13214
  */
13103
- severity?: 'critical' | 'high' | 'medium' | 'low' | 'informational';
13215
+ severity?: UPGAssessment;
13104
13216
  /**
13105
13217
  * CVSS scoring version. v3.1 and v4.0 differ significantly for the same vulnerability.
13106
13218
  * @example "v4.0" for vulnerabilities scored after the v4.0 release in 2023
@@ -13183,8 +13295,8 @@ interface SecurityControlProperties {
13183
13295
  interface SecurityPolicyProperties {
13184
13296
  /** Systems or processes covered */
13185
13297
  scope?: string;
13186
- /** Review cadence (e.g. "annually", "quarterly") */
13187
- review_cadence?: string;
13298
+ /** Review cadence (e.g. `yearly`, `quarterly`). Uses the shared `Cadence` scale. */
13299
+ review_cadence?: Cadence;
13188
13300
  /** Version */
13189
13301
  version?: string;
13190
13302
  /** ISO effective date */
@@ -13253,7 +13365,7 @@ interface SecurityReviewProperties {
13253
13365
  */
13254
13366
  interface DataClassificationProperties {
13255
13367
  /** Sensitivity level */
13256
- level?: 'public' | 'internal' | 'confidential' | 'restricted';
13368
+ level?: DataSensitivity;
13257
13369
  /** Handling rules */
13258
13370
  handling_requirements?: string;
13259
13371
  /** Example data covered */
@@ -13302,7 +13414,7 @@ interface A11yStandardProperties {
13302
13414
  /** Version of the standard (e.g. "2.1", "2.2") */
13303
13415
  version?: string;
13304
13416
  /** Target conformance level */
13305
- conformance_level?: 'A' | 'AA' | 'AAA';
13417
+ conformance_level?: ConformanceLevel;
13306
13418
  }
13307
13419
  /** Accessibility guideline.
13308
13420
  *
@@ -13319,7 +13431,7 @@ interface A11yGuidelineProperties {
13319
13431
  /** Guideline reference number (e.g. "1.1", "2.4") */
13320
13432
  guideline_number?: string;
13321
13433
  /** WCAG conformance level required */
13322
- level?: 'A' | 'AA' | 'AAA';
13434
+ level?: ConformanceLevel;
13323
13435
  /** Imperative force of this guideline. */
13324
13436
  rule_strength?: RuleStrength;
13325
13437
  }
@@ -13367,13 +13479,12 @@ interface A11yAuditProperties {
13367
13479
  */
13368
13480
  interface A11yIssueProperties {
13369
13481
  /**
13370
- * Severity. Aligned to axe-core's 4-level impact scale (industry standard):
13371
- * 'minor' < 'moderate' < 'serious' < 'critical'.
13372
- *
13373
- * Migration: the previous 3-level scale ('critical' | 'major' | 'minor')
13374
- * maps to ('critical' | 'serious' | 'minor') respectively.
13482
+ * Impact severity (UPGAssessment on the `severity_5` scale). Migrated from
13483
+ * the inline axe-core 4-level enum (`minor|moderate|serious|critical`)
13484
+ * (UPG-579 Option C): map `critical` -> 5, `serious` -> 4, `moderate` -> 3,
13485
+ * `minor` -> 2; carry the old word in `label`.
13375
13486
  */
13376
- severity?: 'minor' | 'moderate' | 'serious' | 'critical';
13487
+ severity?: UPGAssessment;
13377
13488
  /** WCAG success criterion violated (e.g. "1.1.1", "2.4.7") */
13378
13489
  wcag_criterion?: string;
13379
13490
  /** Identifier of the rule that flagged the issue */
@@ -13458,7 +13569,7 @@ interface FeatureRequestProperties {
13458
13569
  /** Number of votes or upvotes from users */
13459
13570
  vote_count?: number;
13460
13571
  /** Detected sentiment of the request */
13461
- signal_sentiment?: 'positive' | 'negative' | 'neutral' | 'mixed';
13572
+ signal_sentiment?: SignalSentiment;
13462
13573
  /** Channel through which the request was received */
13463
13574
  signal_channel?: string;
13464
13575
  /** Perceived urgency of the request */
@@ -13523,8 +13634,8 @@ interface NpsCampaignProperties {
13523
13634
  interface UserAdvisoryBoardProperties {
13524
13635
  /** Number of members on the board */
13525
13636
  member_count?: number;
13526
- /** How often the board meets (e.g. "monthly", "quarterly") */
13527
- meeting_cadence?: string;
13637
+ /** How often the board meets. Uses the shared `Cadence` scale. */
13638
+ meeting_cadence?: Cadence;
13528
13639
  /** Primary topic or area the board advises on */
13529
13640
  board_focus?: string;
13530
13641
  }
@@ -13554,7 +13665,7 @@ interface BetaProgramProperties {
13554
13665
  interface FeedbackThemeProperties {
13555
13666
  /** Display name of the theme */
13556
13667
  /** Overall sentiment across mentions */
13557
- sentiment?: 'positive' | 'neutral' | 'negative' | 'mixed';
13668
+ sentiment?: SignalSentiment;
13558
13669
  /** Whether this theme can be acted upon */
13559
13670
  actionable?: boolean;
13560
13671
  /** How often the theme is mentioned (1-5) */
@@ -13588,8 +13699,8 @@ interface DataSourceProperties {
13588
13699
  source_type?: 'database' | 'api' | 'event_stream' | 'warehouse';
13589
13700
  /** Current connection health */
13590
13701
  connection_status?: 'connected' | 'disconnected' | 'error';
13591
- /** How often the data is refreshed (e.g. "hourly", "daily") */
13592
- refresh_cadence?: string;
13702
+ /** How often the data is refreshed. Uses the shared `Cadence` scale. */
13703
+ refresh_cadence?: Cadence;
13593
13704
  }
13594
13705
  /** EventSchema entity.
13595
13706
  *
@@ -13626,8 +13737,8 @@ interface DashboardProperties {
13626
13737
  audience?: string;
13627
13738
  /** Number of widgets or panels on the dashboard */
13628
13739
  element_count?: number;
13629
- /** How often the dashboard data refreshes */
13630
- refresh_cadence?: string;
13740
+ /** How often the dashboard data refreshes. Uses the shared `Cadence` scale. */
13741
+ refresh_cadence?: Cadence;
13631
13742
  /** Number of user-configurable filters */
13632
13743
  filter_count?: number;
13633
13744
  }
@@ -13695,8 +13806,8 @@ interface DataQualityRuleProperties {
13695
13806
  * }
13696
13807
  */
13697
13808
  interface DataProductProperties {
13698
- /** Classification of the data product (e.g. "report", "dataset", "stream") */
13699
- data_product_type?: string;
13809
+ /** Classification of the data product (UPG-579 Option B). */
13810
+ data_product_type?: 'report' | 'dataset' | 'stream' | 'api' | 'ml_feature' | 'other';
13700
13811
  /** Freshness SLA commitment (e.g. "< 1 hour") */
13701
13812
  sla_freshness?: string;
13702
13813
  }
@@ -13777,7 +13888,7 @@ interface DataDomainProperties {
13777
13888
  */
13778
13889
  domain_type?: 'master' | 'operational' | 'analytical' | 'reference';
13779
13890
  /** Sensitivity band applied across the domain */
13780
- sensitivity?: 'public' | 'internal' | 'confidential' | 'restricted';
13891
+ sensitivity?: DataSensitivity;
13781
13892
  }
13782
13893
  /** Report entity.
13783
13894
  *
@@ -13952,7 +14063,7 @@ interface ContentCalendarProperties {
13952
14063
  /** Recurrence period (ISO-8601 `Duration`, e.g. `'P7D'`) */
13953
14064
  frequency_period?: Duration;
13954
14065
  /** Qualitative rate tier when an exact rate is unknown */
13955
- frequency_rating?: 'rare' | 'occasional' | 'regular' | 'constant' | 'other';
14066
+ frequency_rating?: FrequencyRating;
13956
14067
  }
13957
14068
  /** Content theme.
13958
14069
  *
@@ -14406,8 +14517,8 @@ interface DepartmentProperties {
14406
14517
  * }
14407
14518
  */
14408
14519
  interface SkillProperties {
14409
- /** Category of the skill (e.g. "technical", "leadership", "design") */
14410
- skill_category?: string;
14520
+ /** Category of the skill (UPG-579 Option B). */
14521
+ skill_category?: 'technical' | 'leadership' | 'design' | 'product' | 'business' | 'operations' | 'other';
14411
14522
  /** Description of proficiency levels for this skill */
14412
14523
  proficiency_levels?: string[];
14413
14524
  /** Problem domain the skill applies to (e.g. "payments", "accessibility") */
@@ -14429,8 +14540,8 @@ interface SkillProperties {
14429
14540
  interface CeremonyProperties {
14430
14541
  /** Kind of recurring meeting */
14431
14542
  ceremony_type?: 'standup' | 'planning' | 'review' | 'retro' | 'sync' | 'demo' | 'other';
14432
- /** How often the ceremony occurs (e.g. "daily", "biweekly") */
14433
- cadence?: string;
14543
+ /** How often the ceremony occurs. Uses the shared `Cadence` scale. */
14544
+ cadence?: Cadence;
14434
14545
  /** Typical duration of the meeting in minutes */
14435
14546
  duration_minutes?: number;
14436
14547
  /** People or roles who attend */
@@ -14554,8 +14665,8 @@ interface ChangeRequestProperties {
14554
14665
  * }
14555
14666
  */
14556
14667
  interface DeliverableProperties {
14557
- /** Kind of deliverable (e.g. "document", "prototype", "release") */
14558
- deliverable_type?: string;
14668
+ /** Kind of deliverable (UPG-579 Option B). */
14669
+ deliverable_type?: 'document' | 'prototype' | 'release' | 'design' | 'report' | 'other';
14559
14670
  /** Due date for the deliverable (ISO format) */
14560
14671
  due_date?: ISODate;
14561
14672
  /** Current progress status */
@@ -15358,7 +15469,7 @@ interface KeyActivityProperties {
15358
15469
  /** Recurrence period (ISO-8601 `Duration`, e.g. `'P7D'`) */
15359
15470
  frequency_period?: Duration;
15360
15471
  /** Qualitative tier. Use when an exact rate is unknown. */
15361
- frequency_rating?: 'rare' | 'occasional' | 'regular' | 'constant' | 'other';
15472
+ frequency_rating?: FrequencyRating;
15362
15473
  /** Operationally accountable team or individual */
15363
15474
  operational_owner?: string;
15364
15475
  /** Bottleneck or scaling constraint */
@@ -15791,7 +15902,7 @@ interface ContentStrategyProperties {
15791
15902
  /** Recurrence period (ISO-8601 `Duration`, e.g. `'P7D'`) */
15792
15903
  frequency_period?: Duration;
15793
15904
  /** Qualitative rate tier when an exact rate is unknown */
15794
- frequency_rating?: 'rare' | 'occasional' | 'regular' | 'constant' | 'other';
15905
+ frequency_rating?: FrequencyRating;
15795
15906
  }
15796
15907
  /** SalesMotion entity.
15797
15908
  *
@@ -15928,6 +16039,7 @@ interface TerritoryProperties {
15928
16039
  *
15929
16040
  * https://unifiedproductgraph.org/spec | MIT
15930
16041
  */
16042
+
15931
16043
  /** Pricing strategy.
15932
16044
  *
15933
16045
  * @example
@@ -15940,8 +16052,8 @@ interface TerritoryProperties {
15940
16052
  interface PricingStrategyProperties {
15941
16053
  /** Pricing methodology used */
15942
16054
  strategy_type?: 'value_based' | 'cost_plus' | 'competitor_based' | 'penetration' | 'freemium';
15943
- /** How often pricing is reviewed */
15944
- review_cadence?: string;
16055
+ /** How often pricing is reviewed. Uses the shared `Cadence` scale. */
16056
+ review_cadence?: Cadence;
15945
16057
  /** Date of the last pricing change (ISO format) */
15946
16058
  last_change?: string;
15947
16059
  }
@@ -16088,8 +16200,8 @@ interface DealProperties {
16088
16200
  * }
16089
16201
  */
16090
16202
  interface PipelineSalesProperties {
16091
- /** Classification of the pipeline (e.g. "new business", "expansion") */
16092
- pipeline_type?: string;
16203
+ /** Classification of the pipeline (UPG-579 Option B). */
16204
+ pipeline_type?: 'new_business' | 'expansion' | 'renewal' | 'partner' | 'other';
16093
16205
  /** Average days from opportunity creation to close */
16094
16206
  avg_cycle_days?: number;
16095
16207
  }
@@ -16419,7 +16531,7 @@ interface SupportTicketProperties {
16419
16531
  /** Where the ticket originated (e.g. "email", "in-app", "chat") */
16420
16532
  source?: string;
16421
16533
  /** Detected sentiment of the customer's message */
16422
- signal_sentiment?: 'positive' | 'negative' | 'neutral' | 'mixed';
16534
+ signal_sentiment?: SignalSentiment;
16423
16535
  /** Channel through which the signal was received */
16424
16536
  signal_channel?: string;
16425
16537
  /** Perceived urgency of the customer's request */
@@ -16438,11 +16550,11 @@ interface CustomerFeedbackProperties {
16438
16550
  /** How the feedback was collected */
16439
16551
  feedback_type?: 'survey' | 'interview' | 'review' | 'nps';
16440
16552
  /** Overall sentiment of the feedback */
16441
- sentiment?: 'positive' | 'neutral' | 'negative';
16553
+ sentiment?: SignalSentiment;
16442
16554
  /** Exact words from the customer */
16443
16555
  verbatim?: string;
16444
16556
  /** Detected sentiment of the underlying signal */
16445
- signal_sentiment?: 'positive' | 'negative' | 'neutral' | 'mixed';
16557
+ signal_sentiment?: SignalSentiment;
16446
16558
  /** Channel through which the signal was received */
16447
16559
  signal_channel?: string;
16448
16560
  /** Perceived urgency of the feedback */
@@ -16466,11 +16578,11 @@ interface ChurnReasonProperties {
16466
16578
  /** The recurrence period the count is measured over (ISO-8601 `Duration`, e.g. `'P30D'`) */
16467
16579
  frequency_period?: Duration;
16468
16580
  /** Qualitative frequency tier when an exact count is not known */
16469
- frequency_rating?: 'rare' | 'occasional' | 'regular' | 'constant' | 'other';
16581
+ frequency_rating?: FrequencyRating;
16470
16582
  /** Other factors that contributed to the churn */
16471
16583
  contributing_factors?: string[];
16472
16584
  /** Detected sentiment of the churn signal */
16473
- signal_sentiment?: 'positive' | 'negative' | 'neutral' | 'mixed';
16585
+ signal_sentiment?: SignalSentiment;
16474
16586
  /** Channel through which the churn signal was received */
16475
16587
  signal_channel?: string;
16476
16588
  /** Urgency of the churn risk */
@@ -16764,7 +16876,7 @@ interface TutorialProperties {
16764
16876
  /** Delivery format of the tutorial */
16765
16877
  tutorial_format?: 'written' | 'video' | 'interactive' | 'code_along';
16766
16878
  /** Skill level required to follow the tutorial */
16767
- difficulty?: 'beginner' | 'intermediate' | 'advanced';
16879
+ difficulty?: DifficultyLevel;
16768
16880
  /** Estimated time to complete in minutes */
16769
16881
  duration_minutes?: number;
16770
16882
  /** Percentage of users who complete the tutorial */
@@ -16859,7 +16971,7 @@ interface HelpVideoProperties {
16859
16971
  */
16860
16972
  interface LearningPathProperties {
16861
16973
  /** Overall difficulty level of the learning path */
16862
- path_difficulty?: 'beginner' | 'intermediate' | 'advanced';
16974
+ path_difficulty?: DifficultyLevel;
16863
16975
  /** Number of items (tutorials, videos, etc.) in the path */
16864
16976
  item_count?: number;
16865
16977
  /** Estimated total hours to complete the path */
@@ -17726,16 +17838,18 @@ type UPGNode<T extends keyof UPGPropertyMap = keyof UPGPropertyMap> = UPGBaseNod
17726
17838
  * AUTO-GENERATED by scripts/generate-property-registry.ts
17727
17839
  * Do not edit manually. Run: npx tsx scripts/generate-property-registry.ts
17728
17840
  *
17729
- * Generated: 2026-05-20T13:06:08.581Z
17730
- * Entity types with properties: 316
17841
+ * Generated: 2026-05-30T16:49:47.051Z
17842
+ * Entity types with properties: 315
17731
17843
  */
17732
17844
  interface PropertyDefinition {
17733
- type: 'string' | 'number' | 'boolean' | 'string[]' | 'object';
17845
+ type: 'string' | 'number' | 'boolean' | 'string[]' | 'object' | 'assessment';
17734
17846
  description?: string;
17735
17847
  enum?: string[];
17736
- /** For object-typed fields: nested property shapes. */
17848
+ /** For 'assessment'-typed fields: the canonical UPG scale this property is rated on (e.g. 'confidence_5'). */
17849
+ scale_id?: string;
17850
+ /** For object/assessment fields: nested property shapes. */
17737
17851
  properties?: Record<string, PropertyDefinition>;
17738
- /** For object-typed fields: required keys within `properties`. */
17852
+ /** For object/assessment fields: required keys within `properties`. */
17739
17853
  required?: string[];
17740
17854
  }
17741
17855
  type PropertySchema = Record<string, PropertyDefinition>;
@@ -18183,6 +18297,14 @@ interface UPGPlaybook {
18183
18297
  * the canonical playbook usually is not.
18184
18298
  */
18185
18299
  framework_id?: string;
18300
+ /**
18301
+ * Optional: frameworks relevant to this playbook's region, surfaced as
18302
+ * "related reading" without implying they are invoked as steps (unlike
18303
+ * `framework_id` / framework-kind steps). Each references a `UPGFramework.id`.
18304
+ * Lets consumers show a region's signature frameworks even when the
18305
+ * creation sequence is pure `entity_sequence`. (UPG-580 / Riker's note.)
18306
+ */
18307
+ related_framework_ids?: readonly string[];
18186
18308
  /**
18187
18309
  * The single named outcome entity this playbook produces. Defaults to the
18188
18310
  * region's anchor entity if omitted.
@@ -19141,14 +19263,12 @@ declare function validateProductStageStrict(value: unknown): string | null;
19141
19263
  /**
19142
19264
  * Canonical playbook definitions.
19143
19265
  *
19144
- * 23 playbooks across 10 regions:
19266
+ * 12 playbooks across 10 regions:
19145
19267
  * - 10 canonical (one per region; W1 invariant).
19146
- * - 13 specialised (alternative entry paths, often framework-anchored).
19268
+ * - 2 specialised (business-growth-metric-driven, business-marketing-audience-first).
19147
19269
  *
19148
- * 3 specialised playbooks ship with `framework_id` set per Q.D:
19149
- * business-model-bmc → business-model-canvas
19150
- * business-growth-funnel → pirate-metrics-aarrr
19151
- * discovery-validation-hypothesis-cycle → build-measure-learn
19270
+ * UPG-585: no playbook is framework-anchored anymore; framework anchors now
19271
+ * live on the canonical playbooks' related_framework_ids.
19152
19272
  *
19153
19273
  * Every existing v0.2.x workflow maps here; cross-region lens workflows
19154
19274
  * (`product-journey`, `full-product-journey`) were dropped; their content
@@ -19163,26 +19283,15 @@ declare const STRATEGY_OUTCOMES_PLAYBOOK: UPGPlaybook;
19163
19283
  */
19164
19284
  declare const USERS_NEEDS_PLAYBOOK: UPGPlaybook;
19165
19285
  declare const DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK: UPGPlaybook;
19166
- declare const DISCOVERY_VALIDATION_HYPOTHESIS_PLAYBOOK: UPGPlaybook;
19167
19286
  declare const MARKET_COMPETITIVE_PLAYBOOK: UPGPlaybook;
19168
19287
  declare const EXPERIENCE_DESIGN_BRAND_PLAYBOOK: UPGPlaybook;
19169
- declare const EXPERIENCE_UX_DOMAIN_ONLY_PLAYBOOK: UPGPlaybook;
19170
- declare const EXPERIENCE_DESIGN_SYSTEM_PLAYBOOK: UPGPlaybook;
19171
- declare const EXPERIENCE_CONTENT_PLAYBOOK: UPGPlaybook;
19172
19288
  declare const PRODUCT_DELIVERY_PLAYBOOK: UPGPlaybook;
19173
- declare const PRODUCT_FEEDBACK_SYNTHESIS_PLAYBOOK: UPGPlaybook;
19174
19289
  declare const ENGINEERING_PLATFORM_PLAYBOOK: UPGPlaybook;
19175
- declare const ENGINEERING_ARCHITECTURE_ONLY_PLAYBOOK: UPGPlaybook;
19176
19290
  declare const BUSINESS_GTM_GROWTH_PLAYBOOK: UPGPlaybook;
19177
- declare const BUSINESS_MODEL_BMC_PLAYBOOK: UPGPlaybook;
19178
- declare const BUSINESS_PRICING_PLAYBOOK: UPGPlaybook;
19179
- declare const BUSINESS_GROWTH_FUNNEL_PLAYBOOK: UPGPlaybook;
19180
- declare const BUSINESS_MARKETING_PLAYBOOK: UPGPlaybook;
19181
19291
  declare const BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK: UPGPlaybook;
19182
19292
  declare const BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK: UPGPlaybook;
19183
19293
  declare const ANALYTICS_DATA_PLAYBOOK: UPGPlaybook;
19184
19294
  declare const OPERATIONS_QUALITY_PLAYBOOK: UPGPlaybook;
19185
- declare const OPERATIONS_TEAM_RITUALS_PLAYBOOK: UPGPlaybook;
19186
19295
  /**
19187
19296
  * Every canonical playbook shipped with `@unified-product-graph/core`.
19188
19297
  *
@@ -19949,8 +20058,7 @@ declare const UPG_FRAMEWORKS_BY_CATEGORY: Record<string, UPGFramework[]>;
19949
20058
  * server, CLI, SDK, cloud export, AI agents via MCP) calls this one serialiser,
19950
20059
  * so git diffs reflect MEANING, not formatting.
19951
20060
  *
19952
- * Spec: `TPC-context/upg/02-spec/decisions/2026-05-29-upg-file-format-identity.md`
19953
- * (Addendum A). Anchored on RFC 8785 (JSON Canonicalization Scheme) for the
20061
+ * Anchored on RFC 8785 (JSON Canonicalization Scheme) for the
19954
20062
  * object-internal rules, with two deliberate deviations for the git-review
19955
20063
  * lifecycle: (1) pretty-print (2-space, one element per line, LF) rather than
19956
20064
  * JCS's compact single line; (2) semantic sort of the set-like arrays
@@ -20070,7 +20178,7 @@ declare function isCanonical(text: string): boolean;
20070
20178
  */
20071
20179
 
20072
20180
  /** The current spec version implemented by this package */
20073
- declare const UPG_VERSION: "0.7.3";
20181
+ declare const UPG_VERSION: "0.8.0";
20074
20182
  /**
20075
20183
  * The `.upg` JSON document format version. Written to the `upg_version` field.
20076
20184
  * Evolves independently from `UPG_VERSION` (the catalogue version).
@@ -20185,4 +20293,4 @@ declare const UPG_EDGE_COUNT: number;
20185
20293
  /** Total number of entity type entries in the meta registry (including deprecated) */
20186
20294
  declare const UPG_META_COUNT: number;
20187
20295
 
20188
- export { type A11yAnnotationProperties, type A11yAuditProperties, type A11yGuidelineProperties, type A11yIssueProperties, type A11yStandardProperties, ANALYTICS_DATA_PLAYBOOK, type AcceptanceCriterionProperties, type AccessPolicyProperties, type AccountProperties, type AcquisitionChannelProperties, type AdCreativeProperties, type AffinityClusterProperties, type AgentDefinitionProperties, type AgentHookProperties, type AgentSessionProperties, type AgentSkillProperties, type AgentTaskProperties, type AggregateProperties, type AiCostTrackerProperties, type AiDatasetProperties, type AiExperimentProperties, type AiGuardrailProperties, type AiModelProperties, type AiTraceProperties, type AlertRuleProperties, type AnnotationProperties, type AntiPatternInputs, type AntiPatternViolation, type AnyUPGEntityType, type ApiContractProperties, type ApiEcosystemProperties, type ApiEndpointProperties, type ApproachBinding, type ApproachFilter, type ApproachRun, type ApproachRuntime, type ApprovalRecordProperties, type AssumptionProperties, type AttributionModelProperties, type AuditLogPolicyProperties, BUSINESS_GROWTH_FUNNEL_PLAYBOOK, BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK, BUSINESS_GTM_GROWTH_PLAYBOOK, BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK, BUSINESS_MARKETING_PLAYBOOK, BUSINESS_MODEL_BMC_PLAYBOOK, BUSINESS_PRICING_PLAYBOOK, type BehavioralSegmentProperties, type BenchmarkCheck, type BetaProgramProperties, type BoundedContextProperties, type BrandAssetProperties, type BrandColourProperties, type BrandIdentityProperties, type BrandImageryProperties, type BrandLogoProperties, type BrandTypographyProperties, type BrandVoiceProperties, type BugProperties, type BuildArtifactProperties, type BusinessModelProperties, type Cadence, type CapabilityProperties, type CapacityPlanProperties, type CeremonyProperties, type CertificationProperties, type ChangeRequestProperties, type ChangelogProperties, type ChurnReasonProperties, type CiPipelineProperties, type ClassificationAxisProperties, type ClassificationCapability, type ClassificationCapabilitySurface, type ClassificationCommitment, type ClassificationValueProperties, type CodeRepositoryProperties, type CohortProperties, type CommandProperties, type CommunityInitiativeProperties, type CompetitiveAnalysisProperties, type CompetitiveBattleCardProperties, type CompetitorFeatureProperties, type CompetitorProperties, type ComplianceFrameworkProperties, type ComplianceRequirementProperties, type Confidence, type ConstraintKind, type ConstraintProperties, type ConstraintStatus, type ContactProperties, type ContentCalendarProperties, type ContentPieceProperties, type ContentStrategyProperties, type ContentThemeProperties, type ContractClauseProperties, type ContractProperties, type CostStructureProperties, type CountBenchmark, type Cron, type CulturalAdaptationProperties, type CustomerFeedbackProperties, type CustomerHealthScoreProperties, type CustomerJourneyStageProperties, type CustomerRelationshipProperties, DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK, DISCOVERY_VALIDATION_HYPOTHESIS_PLAYBOOK, type DashboardProperties, type DataClassificationProperties, type DataContractProperties, type DataDomainProperties, type DataFlowProperties, type DataLineageProperties, type DataModelProperties, type DataPipelineProperties, type DataProductProperties, type DataQualityRuleProperties, type DataSourceProperties, type DatabaseSchemaProperties, type DealProperties, type DecisionProperties, type DeliverableProperties, type DemandGenProgramProperties, type DepartmentProperties, type DependencyProperties, type DeploymentProperties, type DeprecatedUPGEntityType, type DesignComponentProperties, type DesignConceptProperties, type DesignGuidelineProperties, type DesignPatternProperties, type DesignQuestionProperties, type DesignSprintProperties, type DesignSystemProperties, type DesignTokenProperties, type DesiredOutcomeProperties, type DeveloperPortalProperties, type DiscountStrategyProperties, type DistributionChannelProperties, type DocumentProperties, type DocumentationTemplateProperties, type DomainActivation, type DomainCountCheck, type DomainEntityProperties, type DomainEventProperties, type DomainGuideStep, type DomainPopulationCheck, type Duration, ENGINEERING_ARCHITECTURE_ONLY_PLAYBOOK, ENGINEERING_PLATFORM_PLAYBOOK, EXPERIENCE_CONTENT_PLAYBOOK, EXPERIENCE_DESIGN_BRAND_PLAYBOOK, EXPERIENCE_DESIGN_SYSTEM_PLAYBOOK, EXPERIENCE_UX_DOMAIN_ONLY_PLAYBOOK, type EducationProgramProperties, type EmailSequenceProperties, type EmptyCell, type EmptyCellRationaleKind, type EntityCheck, type EntitySequenceStep, type EntityTypeMeta, type EntityTypeResolution, type EntryMode, type EpicProperties, type ErrorBudgetProperties, type EvalBenchmarkProperties, type EvalRunProperties, type EvaluateAntiPatternsOptions, type EventProperties, type EventSchemaProperties, type EvidenceProperties, type ExperimentPlanProperties, type ExperimentProperties, type ExperimentRunProperties, type ExternalApiProperties, type FeasibilityStudyProperties, type FeatureAreaProperties, type FeatureFlagProperties, type FeatureProperties, type FeatureRequestProperties, type FeedbackProgramProperties, type FeedbackThemeProperties, type FeedbackVoteProperties, type FixProperties, type ForecastProperties, type FrameworkCategory, type FrameworkComputedProperty, type FrameworkConstant, type FrameworkDataSpec, type FrameworkEducation, type FrameworkEntityTypeSpec, type FrameworkInvocationStep, type FrameworkLayout, type FrameworkLevel, type FrameworkOrigin, type FrameworkPresentationSpec, type FrameworkPropertyRequirement, type FrameworkSlot, type FrameworkStep, type FrameworkStructureSpec, type FrameworkValidationResult, type FunnelProperties, type FunnelStage, type FunnelStepProperties, type GlossaryTermProperties, type GrowthCampaignProperties, type GrowthLoopProperties, type GtmStrategyProperties, type GuardrailStatus, type HallucinationReportProperties, type HealthStatus, type HelpVideoProperties, type HypothesisEvidenceProperties, type HypothesisProperties, type ISO4217, type ISODate, type ISODateTime, type IdealCustomerProfileProperties, type IncidentProperties, type InfrastructureComponentProperties, type InitiativeProperties, type InsightProperties, type IntegrationPartnerProperties, type IntegrationPatternProperties, type IntelligenceCondition, type InteractionSpecProperties, type InternalDocProperties, type InterviewGuideProperties, type InvestigationProperties, type InvoiceProperties, type IpAssetProperties, type JobProperties, type JobStepProperties, type JourneyActionProperties, type JourneyPhaseProperties, type JourneyStepProperties, type JourneyType, type KeyActivityProperties, type KeyResourceProperties, type KeyResultProperties, type KnowledgeBaseArticleProperties, LEGACY_PRODUCT_STAGES, type LaunchProperties, type LeadProperties, type LearningPathProperties, type LearningProperties, type LegalEntityProperties, type LibraryDependencyProperties, type LifecyclePhase, type LifecycleRenderShape, type LifecycleRenderState, type LifecycleRenderTransition, type LifecycleState, type LocaleConfigProperties, type LocaleProperties, type LowMedHigh, MARKDOWN_FORMAT_VERSION, MARKET_COMPETITIVE_PLAYBOOK, type MarketSegmentProperties, type MarketTrendProperties, type MarketingCampaignPlanProperties, type MarketingChannelProperties, type MarketingPlatform, type MarketingStrategyProperties, type MarketplaceListingProperties, type MatrixSlot, type MessagingProperties, type MetricCategory, type MetricDataPoint, type MetricDesignation, type MetricHealth, type MetricImpactLevel, type MetricIndicatorDirection, type MetricProperties, type MetricQualityAssessmentProperties, type MetricSegmentType, type MetricStatisticalFunction, type MilestoneProperties, type MissionProperties, type ModelComparisonProperties, type MonitorProperties, type NamedGroup, type NeedMaturity, type NeedProperties, type NeedValence, type NpsCampaignProperties, OPERATIONS_QUALITY_PLAYBOOK, OPERATIONS_TEAM_RITUALS_PLAYBOOK, type ObjectionProperties, type ObjectiveProperties, type ObservationProperties, type OnCallRotationProperties, type OpportunityProperties, type OrganizationProperties, type OrphanCheck, type OutcomeProperties, PRODUCT_DELIVERY_PLAYBOOK, PRODUCT_FEEDBACK_SYNTHESIS_PLAYBOOK, type ParticipantProperties, type PartnerProgramProperties, type PartnerRevenueShareProperties, type PartnerTierProperties, type PartnershipProperties, type PaywallProperties, type PenetrationTestProperties, type PersonProperties, type PersonaProperties, type PipelineSalesProperties, type PipelineStageProperties, type PlaybookBinding, type PlaybookFilter, type PlaybookProperties, type PlaybookRun, type PlaybookRuntime, type PortfolioProperties, type PositioningProperties, type PostmortemProperties, type PressReleaseProperties, type PricingStrategyProperties, type PricingTierProperties, type Priority, type PrivacyPolicyProperties, type ProductAreaProperties, type ProductProperties, type ProductStageCoercion, type ProgramProperties, type ProjectProperties, type PromptTemplateProperties, type PromptVersionProperties, type ProofPointProperties, type PropertyDefinition, type PropertySchema, type Protocol, type PrototypeProperties, type ProxyConfidence, type ProxyReason, type QaSessionProperties, type QueueTopicProperties, type QuoteDocumentProperties, type QuoteProperties, REFLECT_MODES, type RatioBenchmark, type ReadModelProperties, type RebuttalProperties, type ReflectMode, type RegionalPricingProperties, type RegressionTestProperties, type RelationshipBenchmark, type RelationshipCheck, type ReleaseProperties, type ReleaseStrategyProperties, type ReportProperties, type ResearchPlanProperties, type ResearchQuestionProperties, type ResearchStudyProperties, type ResourceAllocationProperties, type RetrospectiveProperties, type RevenueStreamProperties, type ReviewGateProperties, type RiskProperties, type RiskRegisterProperties, type RoadmapItemProperties, type RoadmapProperties, type RoleProperties, type RootCauseProperties, type RuleStrength, type RunContext, type RunbookProperties, STRATEGY_OUTCOMES_PLAYBOOK, type SalesMotionProperties, type ScreenProperties, type ScreenStateProperties, type SecurityAuditProperties, type SecurityControlProperties, type SecurityPolicyProperties, type SecurityReviewProperties, type Semver, type SeoKeywordProperties, type SerializeOptions, type ServiceBlueprintProperties, type ServiceLevelAgreementProperties, type ServiceLevelIndicatorProperties, type ServiceLevelObjectiveProperties, type ServiceProperties, type SignalChannel, type SignalSentiment, type SignalUrgency, type SkillProperties, type SocialPostProperties, type SolutionProperties, type StageRange, type StakeholderProperties, type StatusReportProperties, type Step, type StepKind, type StepOutput, type StepOutputKind, type StoryTaskProperties, type StrategicPillarProperties, type StrategicThemeProperties, type StructurePattern, type SubSequenceStep, type SubscriptionProperties, type SuccessMilestoneProperties, type SupportTicketProperties, type SurfaceId, type SurveyResponseProperties, type SwitchingCostProperties, type SymptomProperties, type TableColumn, type TargetCustomerSegmentProperties, type TaskProperties, type TeamOkrProperties, type TeamProperties, type TechnicalDebtItemProperties, type TerritoryProperties, type TestCaseProperties, type TestCoverageReportProperties, type TestEnvironmentProperties, type TestPlanProperties, type TestResultProperties, type TestSuiteProperties, type ThemeProperties, type ThreatModelProperties, type ThreatProperties, type Timeframe, type TotalEntityCountCheck, type TouchpointProperties, type TranslationBundleProperties, type TranslationKeyProperties, type TrialConfigProperties, type TutorialProperties, type UPGAnchorEntity, type UPGAntiPattern, type UPGAntiPatternSeverity, type UPGApproach, type UPGApproachEnvelope, type UPGApproachId, type UPGAssessment, type UPGBaseNode, type UPGBenchmarkSource, type UPGBoundaryDirection, type UPGBoundaryEdge, type UPGCrossEdge, type UPGCrossEdgeType, type UPGCuratedAntiPattern, type UPGDocument, type UPGDomain, type UPGDomainBridge, type UPGDomainId, type UPGDomainPattern, type UPGDomainRing, type UPGDomainUsageGuide, type UPGEdge, type UPGEdgeDefinition, type UPGEdgeMigration, type UPGEdgeMigrationEndpoints, type UPGEdgePickHint, type UPGEdgeType, type UPGEntityType, type UPGEntityTypeMaturity, type UPGEnumScaleDefinition, type UPGEnumScaleValue, type UPGFramework, type UPGFrameworkMeta, type UPGHeader, type UPGHeaderIntegrity, type UPGHeaderProvenance, type UPGIntegrity, type UPGLens, type UPGLensIntelligencePrompt, type UPGLifecycle, type UPGMappingConfidence, type UPGNode, type UPGOrganization, type UPGPlaybook, type UPGPortfolio, type UPGPortfolioDocument, type UPGProduct, type UPGProductArea, type UPGProductStage, type UPGPropertyMap, type UPGPropertyMigration, type UPGPropertyMigrationChange, type UPGRegion, type UPGRegionEntityMembership, type UPGRegionEntityRole, type UPGRegionId, type UPGRegionShape, type UPGScaleDefinition, type UPGScalePoint, type UPGSource, type UPGSplitEdge, type UPGSplitMigration, type UPGSplitRoute, type UPGSplitRouteTarget, type UPGSplitTarget, type UPGTypeLabel, type UPGTypeMigration, type UPGValidationError, type UPGValidationResult, type UPGValidationWarning, type UPGWildcardEndpoint, UPG_ACTIVE_TYPES, UPG_ANTI_PATTERNS, UPG_APPROACHES, UPG_APPROACHES_BY_ID, UPG_CANONICAL_FORMAT_VERSION, UPG_CONTAINMENT_FREE_TYPES, UPG_COUNT_BENCHMARKS, UPG_CROSS_EDGE_TYPES, UPG_DEPRECATED_TYPES, UPG_DOMAINS, UPG_DOMAIN_ACTIVATION, UPG_DOMAIN_COUNT, UPG_DOMAIN_GUIDES, UPG_DOMAIN_RINGS, UPG_EDGE_CATALOG, UPG_EDGE_COUNT, UPG_EDGE_MIGRATIONS, UPG_EDGE_PAIR_MAP, UPG_EDGE_TYPES, UPG_ENTITY_COUNT, UPG_ENTITY_META, UPG_ENTITY_META_BY_ID, UPG_ENTITY_META_BY_NAME, UPG_ENTITY_TO_DOMAIN, UPG_ENUM_SCALES, UPG_FORMAT_VERSION, UPG_FRAMEWORKS, UPG_FRAMEWORKS_BY_CATEGORY, UPG_FRAMEWORKS_BY_ID, UPG_FRAMEWORK_CATEGORIES, UPG_LENSES, UPG_LIFECYCLES, UPG_LIFECYCLE_FREE_TYPES, UPG_LIFECYCLE_PLANNED_TYPES, UPG_META_COUNT, UPG_MIGRATIONS, UPG_PLAYBOOKS, UPG_POLYMORPHIC_EDGE_KEYS, UPG_PRODUCT_STAGES, UPG_PRODUCT_STAGE_COERCION_MAP, UPG_PROPERTY_MIGRATIONS, UPG_PROPERTY_SCHEMA, UPG_RATIO_BENCHMARKS, UPG_REGIONS, UPG_REGION_COUNT, UPG_REGION_MAP, UPG_RELATIONSHIP_BENCHMARKS, UPG_SCALES, UPG_SPLIT_MIGRATIONS, UPG_STATUS_MIGRATIONS, UPG_STRUCTURE_PATTERNS, UPG_TYPES, UPG_TYPES_SET, UPG_TYPE_ALIASES, UPG_TYPE_LABELS, UPG_TYPE_LABELS_MAP, UPG_TYPE_NAMES, UPG_VALID_CHILDREN, UPG_VERSION, UPG_WILDCARD_ENDPOINT, USERS_NEEDS_PLAYBOOK, type UnitEconomicsProperties, UnknownEntityTypeError, type UserAdvisoryBoardProperties, type UserFlowProperties, type UserJourneyProperties, type UserStoryProperties, type ValueObjectProperties, type ValuePropositionProperties, type ValueStreamProperties, type VariantProperties, type VisionProperties, type VulnerabilityProperties, type WalkMigrationChainResult, type WalkthroughProperties, type WebinarProperties, type WireframeProperties, type WorkflowArtifactProperties, type WorkflowRunProperties, type WorkflowTemplateProperties, type WorkspaceProperties, backfillSlug, buildTypeAliases, canBeChildOf, coerceProductStage, collectSlugsForType, compareVersions, computeBodyChecksum, evaluateAntiPatterns, findInvalidStatusMigrationTargets, formatUpgText, generateSlug, getAnchorEntity, getAntiPatternById, getAntiPatterns, getAntiPatternsBySeverity, getAntiPatternsForStage, getBenchmark, getBenchmarksByDomain, getCanonicalPlaybookForRegion, getDefaultLens, getDeprecatedTypes, getDomainForType, getDomainIdForType, getDomainsInRing, getEnumScale, getEnumValueMeta, getGuideForDomain, getLens, getLensIds, getLensPlaybook, getLensesForDomain, getLifecycleForType, getLifecycleRenderShape, getMigrationMap, getPlaybookById, getPlaybooksForRegion, getPropertyDefaultScale, getPropertyMigrations, getPropertySchema, getRegion, getRegionForEntityType, getReplacementType, getRingForDomain, getScale, getSplitMigrations, getTypeId, getTypeName, getTypes, getUPGEdgeMigrations, getValidChildren, getVisibleTypes, hasStatusMigration, isCanonical, isCanonicalProductStage, isContainmentFreeType, isDeprecatedType, isDomainGuideStep, isEntitySequenceStep, isFrameworkInvocationStep, isLegacyProductStage, isLifecycleFreeType, isLifecyclePlannedType, isPolymorphicEdge, isPortfolio, isRegisteredPolymorphicEdge, isSubSequenceStep, isUPGDocument, listStatusMigrations, migrateEdge, migrateNode, migrateNodeProperties, migrateProductStage, migrateStatusValue, normalizeDocument, parseUpg, pickCanonicalEdge, resolveAllEdges, resolveContainmentEdge, resolveEntityType, resolveLabel, resolveSlugCollision, rotateSlug, serializeCanonical, validateProductStageStrict, validateUPGDocument, validateUPGFramework, walkMigrationChainToCanonical };
20296
+ export { type A11yAnnotationProperties, type A11yAuditProperties, type A11yGuidelineProperties, type A11yIssueProperties, type A11yStandardProperties, ANALYTICS_DATA_PLAYBOOK, type AcceptanceCriterionProperties, type AccessPolicyProperties, type AccountProperties, type AcquisitionChannelProperties, type AdCreativeProperties, type AffinityClusterProperties, type AgentDefinitionProperties, type AgentHookProperties, type AgentSessionProperties, type AgentSkillProperties, type AgentTaskProperties, type AggregateProperties, type AiCostTrackerProperties, type AiDatasetProperties, type AiExperimentProperties, type AiGuardrailProperties, type AiModelProperties, type AiTraceProperties, type AlertRuleProperties, type AnnotationProperties, type AntiPatternInputs, type AntiPatternViolation, type AnyUPGEntityType, type ApiContractProperties, type ApiEcosystemProperties, type ApiEndpointProperties, type ApproachBinding, type ApproachFilter, type ApproachRun, type ApproachRuntime, type ApprovalRecordProperties, type AssumptionProperties, type AttributionModelProperties, type AuditLogPolicyProperties, BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK, BUSINESS_GTM_GROWTH_PLAYBOOK, BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK, type BehavioralSegmentProperties, type BenchmarkCheck, type BetaProgramProperties, type BoundedContextProperties, type BrandAssetProperties, type BrandColourProperties, type BrandIdentityProperties, type BrandImageryProperties, type BrandLogoProperties, type BrandTypographyProperties, type BrandVoiceProperties, type BugProperties, type BuildArtifactProperties, type BusinessModelProperties, type Cadence, type CapabilityProperties, type CapacityPlanProperties, type CauseConfidence, type CeremonyProperties, type CertificationProperties, type ChangeRequestProperties, type ChangelogProperties, type ChurnReasonProperties, type CiPipelineProperties, type ClassificationAxisProperties, type ClassificationCapability, type ClassificationCapabilitySurface, type ClassificationCommitment, type ClassificationValueProperties, type CodeRepositoryProperties, type CohortProperties, type ComfortLevel, type CommandProperties, type CommunityInitiativeProperties, type CompetitiveAnalysisProperties, type CompetitiveBattleCardProperties, type CompetitorFeatureProperties, type CompetitorProperties, type ComplianceFrameworkProperties, type ComplianceRequirementProperties, type Confidence, type ConformanceLevel, type ConstraintKind, type ConstraintProperties, type ConstraintStatus, type ContactProperties, type ContentCalendarProperties, type ContentPieceProperties, type ContentStrategyProperties, type ContentThemeProperties, type ContractClauseProperties, type ContractProperties, type CostStructureProperties, type CountBenchmark, type Cron, type CulturalAdaptationProperties, type CustomerFeedbackProperties, type CustomerHealthScoreProperties, type CustomerJourneyStageProperties, type CustomerRelationshipProperties, DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK, type DashboardProperties, type DataClassificationProperties, type DataContractProperties, type DataDomainProperties, type DataFlowProperties, type DataLineageProperties, type DataModelProperties, type DataPipelineProperties, type DataProductProperties, type DataQualityRuleProperties, type DataSensitivity, type DataSourceProperties, type DatabaseSchemaProperties, type DealProperties, type DecisionProperties, type DeliverableProperties, type DemandGenProgramProperties, type DepartmentProperties, type DependencyProperties, type DeploymentProperties, type DeprecatedUPGEntityType, type DesignComponentProperties, type DesignConceptProperties, type DesignGuidelineProperties, type DesignPatternProperties, type DesignQuestionProperties, type DesignSprintProperties, type DesignSystemProperties, type DesignTokenProperties, type DesiredOutcomeProperties, type DeveloperPortalProperties, type DifficultyLevel, type DiscountStrategyProperties, type DistributionChannelProperties, type DocumentProperties, type DocumentationTemplateProperties, type DomainActivation, type DomainCountCheck, type DomainEntityProperties, type DomainEventProperties, type DomainGuideStep, type DomainPopulationCheck, type Duration, ENGINEERING_PLATFORM_PLAYBOOK, EXPERIENCE_DESIGN_BRAND_PLAYBOOK, type EducationProgramProperties, type EmailSequenceProperties, type EmptyCell, type EmptyCellRationaleKind, type EntityCheck, type EntitySequenceStep, type EntityTypeMeta, type EntityTypeResolution, type EntryMode, type EpicProperties, type ErrorBudgetProperties, type EvalBenchmarkProperties, type EvalRunProperties, type EvaluateAntiPatternsOptions, type EventProperties, type EventSchemaProperties, type EvidenceDirection, type EvidenceProperties, type ExperimentPlanProperties, type ExperimentProperties, type ExperimentRunProperties, type ExternalApiProperties, type FeasibilityStudyProperties, type FeatureAreaProperties, type FeatureFlagProperties, type FeatureProperties, type FeatureRequestProperties, type FeedbackProgramProperties, type FeedbackThemeProperties, type FeedbackVoteProperties, type FixProperties, type ForecastProperties, type FrameworkCategory, type FrameworkComputedProperty, type FrameworkConstant, type FrameworkDataSpec, type FrameworkEducation, type FrameworkEntityTypeSpec, type FrameworkInvocationStep, type FrameworkLayout, type FrameworkLevel, type FrameworkOrigin, type FrameworkPresentationSpec, type FrameworkPropertyRequirement, type FrameworkSlot, type FrameworkStep, type FrameworkStructureSpec, type FrameworkValidationResult, type FrequencyRating, type FunnelProperties, type FunnelStage, type FunnelStepProperties, type GlossaryTermProperties, type GrowthCampaignProperties, type GrowthLoopProperties, type GtmStrategyProperties, type GuardrailStatus, type HallucinationReportProperties, type HealthStatus, type HelpVideoProperties, type HypothesisEvidenceProperties, type HypothesisProperties, type ISO4217, type ISODate, type ISODateTime, type IdealCustomerProfileProperties, type IncidentProperties, type IncidentSeverity, type InfrastructureComponentProperties, type InitiativeProperties, type InsightProperties, type IntegrationPartnerProperties, type IntegrationPatternProperties, type IntelligenceCondition, type InteractionSpecProperties, type InternalDocProperties, type InterviewGuideProperties, type InvestigationProperties, type InvoiceProperties, type IpAssetProperties, type JobProperties, type JobStepProperties, type JourneyActionProperties, type JourneyPhaseProperties, type JourneyStepProperties, type JourneyType, type KeyActivityProperties, type KeyResourceProperties, type KeyResultProperties, type KnowledgeBaseArticleProperties, LEGACY_PRODUCT_STAGES, type LaunchProperties, type LeadProperties, type LearningPathProperties, type LearningProperties, type LegalEntityProperties, type LibraryDependencyProperties, type LifecyclePhase, type LifecycleRenderShape, type LifecycleRenderState, type LifecycleRenderTransition, type LifecycleState, type LocaleConfigProperties, type LocaleProperties, type LogLevel, type LowMedHigh, MARKDOWN_FORMAT_VERSION, MARKET_COMPETITIVE_PLAYBOOK, type MarketSegmentProperties, type MarketTrendProperties, type MarketingCampaignPlanProperties, type MarketingChannelProperties, type MarketingPlatform, type MarketingStrategyProperties, type MarketplaceListingProperties, type MatrixSlot, type MaturityLevel, type MessagingProperties, type MetricCategory, type MetricDataPoint, type MetricDesignation, type MetricHealth, type MetricImpactLevel, type MetricIndicatorDirection, type MetricProperties, type MetricQualityAssessmentProperties, type MetricSegmentType, type MetricStatisticalFunction, type MilestoneProperties, type MissionProperties, type ModelComparisonProperties, type MonitorProperties, type NamedGroup, type NeedMaturity, type NeedProperties, type NeedValence, type NpsCampaignProperties, OPERATIONS_QUALITY_PLAYBOOK, type ObjectionProperties, type ObjectiveProperties, type ObservationProperties, type OnCallRotationProperties, type OpportunityProperties, type OrganizationProperties, type OrphanCheck, type OutcomeProperties, PRODUCT_DELIVERY_PLAYBOOK, PROPERTY_SCALE_MAP, type ParticipantProperties, type PartnerProgramProperties, type PartnerRevenueShareProperties, type PartnerTierProperties, type PartnershipProperties, type PaywallProperties, type PenetrationTestProperties, type PersonProperties, type PersonaProperties, type PipelineSalesProperties, type PipelineStageProperties, type PlaybookBinding, type PlaybookFilter, type PlaybookProperties, type PlaybookRun, type PlaybookRuntime, type PortfolioProperties, type PositioningProperties, type PostmortemProperties, type PressReleaseProperties, type PricingStrategyProperties, type PricingTierProperties, type Priority, type PrivacyPolicyProperties, type ProductAreaProperties, type ProductProperties, type ProductStageCoercion, type ProgramProperties, type ProjectProperties, type PromptTemplateProperties, type PromptVersionProperties, type ProofPointProperties, type PropertyDefinition, type PropertySchema, type Protocol, type PrototypeProperties, type ProxyConfidence, type ProxyReason, type QaSessionProperties, type QueueTopicProperties, type QuoteDocumentProperties, type QuoteProperties, REFLECT_MODES, type RatioBenchmark, type ReadModelProperties, type RebuttalProperties, type ReflectMode, type RegionalPricingProperties, type RegressionTestProperties, type RelationshipBenchmark, type RelationshipCheck, type ReleaseProperties, type ReleaseStrategyProperties, type ReportProperties, type ResearchPlanProperties, type ResearchQuestionProperties, type ResearchStudyProperties, type ResourceAllocationProperties, type RetrospectiveProperties, type RevenueStreamProperties, type ReviewGateProperties, type RiskProperties, type RiskRegisterProperties, type RoadmapItemProperties, type RoadmapProperties, type RoleProperties, type RootCauseProperties, type RuleStrength, type RunContext, type RunbookProperties, STRATEGY_OUTCOMES_PLAYBOOK, type SalesMotionProperties, type ScreenProperties, type ScreenStateProperties, type SecurityAuditProperties, type SecurityControlProperties, type SecurityPolicyProperties, type SecurityReviewProperties, type Semver, type SeoKeywordProperties, type SerializeOptions, type ServiceBlueprintProperties, type ServiceLevelAgreementProperties, type ServiceLevelIndicatorProperties, type ServiceLevelObjectiveProperties, type ServiceProperties, type SignalChannel, type SignalSentiment, type SignalUrgency, type SkillProperties, type SocialPostProperties, type SolutionProperties, type StageRange, type StakeholderProperties, type StatusReportProperties, type Step, type StepKind, type StepOutput, type StepOutputKind, type StoryTaskProperties, type StrategicPillarProperties, type StrategicThemeProperties, type StructurePattern, type SubSequenceStep, type SubscriptionProperties, type SuccessMilestoneProperties, type SupportTicketProperties, type SurfaceId, type SurveyResponseProperties, type SwitchingCostProperties, type SymptomProperties, type TableColumn, type TargetCustomerSegmentProperties, type TaskProperties, type TeamOkrProperties, type TeamProperties, type TechnicalDebtItemProperties, type TerritoryProperties, type TestCaseProperties, type TestCoverageReportProperties, type TestEnvironmentProperties, type TestPlanProperties, type TestResultProperties, type TestSuiteProperties, type ThemeProperties, type ThreatModelProperties, type ThreatProperties, type Timeframe, type TotalEntityCountCheck, type TouchpointProperties, type TranslationBundleProperties, type TranslationKeyProperties, type TrialConfigProperties, type TutorialProperties, type UPGAnchorEntity, type UPGAntiPattern, type UPGAntiPatternSeverity, type UPGApproach, type UPGApproachEnvelope, type UPGApproachId, type UPGAssessment, type UPGBaseNode, type UPGBenchmarkSource, type UPGBoundaryDirection, type UPGBoundaryEdge, type UPGCrossEdge, type UPGCrossEdgeType, type UPGCuratedAntiPattern, type UPGDocument, type UPGDomain, type UPGDomainBridge, type UPGDomainId, type UPGDomainPattern, type UPGDomainRing, type UPGDomainUsageGuide, type UPGEdge, type UPGEdgeDefinition, type UPGEdgeMigration, type UPGEdgeMigrationEndpoints, type UPGEdgePickHint, type UPGEdgeType, type UPGEntityType, type UPGEntityTypeMaturity, type UPGEnumScaleDefinition, type UPGEnumScaleValue, type UPGFramework, type UPGFrameworkMeta, type UPGHeader, type UPGHeaderIntegrity, type UPGHeaderProvenance, type UPGIntegrity, type UPGLens, type UPGLensIntelligencePrompt, type UPGLifecycle, type UPGMappingConfidence, type UPGNode, type UPGOrganization, type UPGPlaybook, type UPGPortfolio, type UPGPortfolioDocument, type UPGProduct, type UPGProductArea, type UPGProductStage, type UPGPropertyMap, type UPGPropertyMigration, type UPGPropertyMigrationChange, type UPGRegion, type UPGRegionEntityMembership, type UPGRegionEntityRole, type UPGRegionId, type UPGRegionShape, type UPGScaleDefinition, type UPGScalePoint, type UPGSource, type UPGSplitEdge, type UPGSplitMigration, type UPGSplitRoute, type UPGSplitRouteTarget, type UPGSplitTarget, type UPGTypeLabel, type UPGTypeMigration, type UPGValidationError, type UPGValidationResult, type UPGValidationWarning, type UPGWildcardEndpoint, UPG_ACTIVE_TYPES, UPG_ANTI_PATTERNS, UPG_APPROACHES, UPG_APPROACHES_BY_ID, UPG_CANONICAL_FORMAT_VERSION, UPG_CONTAINMENT_FREE_TYPES, UPG_COUNT_BENCHMARKS, UPG_CROSS_EDGE_TYPES, UPG_DEPRECATED_TYPES, UPG_DOMAINS, UPG_DOMAIN_ACTIVATION, UPG_DOMAIN_COUNT, UPG_DOMAIN_GUIDES, UPG_DOMAIN_RINGS, UPG_EDGE_CATALOG, UPG_EDGE_COUNT, UPG_EDGE_MIGRATIONS, UPG_EDGE_PAIR_MAP, UPG_EDGE_TYPES, UPG_ENTITY_COUNT, UPG_ENTITY_META, UPG_ENTITY_META_BY_ID, UPG_ENTITY_META_BY_NAME, UPG_ENTITY_TO_DOMAIN, UPG_ENUM_SCALES, UPG_FORMAT_VERSION, UPG_FRAMEWORKS, UPG_FRAMEWORKS_BY_CATEGORY, UPG_FRAMEWORKS_BY_ID, UPG_FRAMEWORK_CATEGORIES, UPG_LENSES, UPG_LIFECYCLES, UPG_LIFECYCLE_FREE_TYPES, UPG_LIFECYCLE_PLANNED_TYPES, UPG_META_COUNT, UPG_MIGRATIONS, UPG_PLAYBOOKS, UPG_POLYMORPHIC_EDGE_KEYS, UPG_PRODUCT_STAGES, UPG_PRODUCT_STAGE_COERCION_MAP, UPG_PROPERTY_MIGRATIONS, UPG_PROPERTY_SCHEMA, UPG_RATIO_BENCHMARKS, UPG_REGIONS, UPG_REGION_COUNT, UPG_REGION_MAP, UPG_RELATIONSHIP_BENCHMARKS, UPG_SCALES, UPG_SPLIT_MIGRATIONS, UPG_STATUS_MIGRATIONS, UPG_STRUCTURE_PATTERNS, UPG_TYPES, UPG_TYPES_SET, UPG_TYPE_ALIASES, UPG_TYPE_LABELS, UPG_TYPE_LABELS_MAP, UPG_TYPE_NAMES, UPG_VALID_CHILDREN, UPG_VERSION, UPG_WILDCARD_ENDPOINT, USERS_NEEDS_PLAYBOOK, type UnitEconomicsProperties, UnknownEntityTypeError, type UserAdvisoryBoardProperties, type UserFlowProperties, type UserJourneyProperties, type UserStoryProperties, type ValueObjectProperties, type ValuePropositionProperties, type ValueStreamProperties, type VariantProperties, type VisionProperties, type VulnerabilityProperties, type WalkMigrationChainResult, type WalkthroughProperties, type WebinarProperties, type WireframeProperties, type WorkflowArtifactProperties, type WorkflowRunProperties, type WorkflowTemplateProperties, type WorkspaceProperties, backfillSlug, buildTypeAliases, canBeChildOf, coerceProductStage, collectSlugsForType, compareVersions, computeBodyChecksum, evaluateAntiPatterns, findInvalidStatusMigrationTargets, formatUpgText, generateSlug, getAnchorEntity, getAntiPatternById, getAntiPatterns, getAntiPatternsBySeverity, getAntiPatternsForStage, getBenchmark, getBenchmarksByDomain, getCanonicalPlaybookForRegion, getDefaultLens, getDeprecatedTypes, getDomainForType, getDomainIdForType, getDomainsInRing, getEnumScale, getEnumValueMeta, getGuideForDomain, getLens, getLensIds, getLensPlaybook, getLensesForDomain, getLifecycleForType, getLifecycleRenderShape, getMigrationMap, getPlaybookById, getPlaybooksForRegion, getPropertiesForScale, getPropertyDefaultScale, getPropertyMigrations, getPropertySchema, getRegion, getRegionForEntityType, getReplacementType, getRingForDomain, getScale, getSplitMigrations, getTypeId, getTypeName, getTypes, getUPGEdgeMigrations, getValidChildren, getVisibleTypes, hasStatusMigration, isCanonical, isCanonicalProductStage, isContainmentFreeType, isDeprecatedType, isDomainGuideStep, isEntitySequenceStep, isFrameworkInvocationStep, isLegacyProductStage, isLifecycleFreeType, isLifecyclePlannedType, isPolymorphicEdge, isPortfolio, isRegisteredPolymorphicEdge, isSubSequenceStep, isUPGDocument, listStatusMigrations, migrateEdge, migrateNode, migrateNodeProperties, migrateProductStage, migrateStatusValue, normalizeDocument, parseUpg, pickCanonicalEdge, resolveAllEdges, resolveContainmentEdge, resolveEntityType, resolveLabel, resolveSlugCollision, rotateSlug, serializeCanonical, validateProductStageStrict, validateUPGDocument, validateUPGFramework, walkMigrationChainToCanonical };