@unified-product-graph/core 0.13.1 → 0.14.0

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.cts CHANGED
@@ -10542,72 +10542,31 @@ interface SwitchingCostProperties {
10542
10542
  * pain: 4,
10543
10543
  * }
10544
10544
  */
10545
+ /**
10546
+ * Opportunity carries no intrinsic scalar properties: it is defined by its
10547
+ * title/description and its edges (to the problems/needs it addresses and the
10548
+ * solutions proposed against it). Its former scoring inputs (`reach`,
10549
+ * `frequency`, `pain`, `opportunity_score`) were framework-scoped from 0.9.0 —
10550
+ * they live on the `framework_exercise` includes-edge of the `opportunity-sizing`
10551
+ * framework, not on the entity. Removed from the schema in 0.14.0 (UPG-574).
10552
+ */
10545
10553
  interface OpportunityProperties {
10546
- /**
10547
- * How many users experience this problem.
10548
- * @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic
10549
- * property. Apply the `opportunity-sizing` framework; the value lives on the
10550
- * framework_exercise includes-edge. Removed in 0.9.1.
10551
- */
10552
- reach?: UPGAssessment;
10553
- /**
10554
- * How often users experience this problem.
10555
- * @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.
10556
- */
10557
- frequency?: UPGAssessment;
10558
- /**
10559
- * How painful it is when unaddressed.
10560
- * @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.
10561
- */
10562
- pain?: UPGAssessment;
10563
- /**
10564
- * Computed: normalized_reach x normalized_frequency x normalized_pain (0-1).
10565
- * @deprecated 0.9.0:computed by the `opportunity-sizing` framework on its
10566
- * application edge, not stored on the entity. Removed in 0.9.1.
10567
- */
10568
- opportunity_score?: number;
10569
10554
  }
10570
10555
  /** A proposed response to an opportunity
10571
10556
  *
10572
10557
  * @example
10573
10558
  * const properties: SolutionProperties = {
10574
10559
  * timeline: 'Kickoff 2026-04-22, results by 2026-05-15.',
10575
- * reach: 4,
10576
- * impact: 4,
10577
10560
  * }
10561
+ *
10562
+ * RICE scoring inputs (`reach`, `impact`, `confidence`, `effort`) and the
10563
+ * computed `rice_score` were framework-scoped from 0.9.0 and removed from the
10564
+ * schema in 0.14.0 (UPG-574): apply the `rice-scoring` framework and read the
10565
+ * score off the `framework_exercise` includes-edge, not the entity.
10578
10566
  */
10579
10567
  interface SolutionProperties {
10580
10568
  /** Estimated delivery or target timeline */
10581
10569
  timeline?: string;
10582
- /**
10583
- * How many users this solution reaches (1 = few, 5 = most).
10584
- * @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic
10585
- * property. Apply the `rice-scoring` framework; the value lives on the
10586
- * framework_exercise includes-edge. Removed in 0.9.1.
10587
- */
10588
- reach?: UPGAssessment;
10589
- /**
10590
- * Expected impact on the target outcome (1 = minimal, 5 = transformative).
10591
- * @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.
10592
- */
10593
- impact?: UPGAssessment;
10594
- /**
10595
- * How confident the team is in this solution (1 = speculative, 5 = proven).
10596
- * @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.
10597
- */
10598
- confidence?: UPGAssessment;
10599
- /**
10600
- * Level of effort required to implement (1 = trivial, 5 = very large).
10601
- * @deprecated 0.9.0:effort is a framework-scoped scoring input (it varies by
10602
- * assessor and method), not an intrinsic property. Removed in 0.9.1.
10603
- */
10604
- effort?: UPGAssessment;
10605
- /**
10606
- * Computed: (reach × impact × confidence) / effort.
10607
- * @deprecated 0.9.0:computed by the `rice-scoring` framework on its
10608
- * application edge, not stored on the entity. Removed in 0.9.1.
10609
- */
10610
- rice_score?: number;
10611
10570
  }
10612
10571
  /** FeasibilityStudy entity.
10613
10572
  *
@@ -12133,10 +12092,8 @@ interface DesignGuidelineProperties {
12133
12092
  applies_to?: string;
12134
12093
  /** Reasoning. Why this rule exists. */
12135
12094
  rationale?: string;
12136
- /** Imperative force. Supersedes `strictness`. */
12095
+ /** Imperative force. (Superseded the removed `strictness` field in 0.14.0, UPG-574.) */
12137
12096
  rule_strength?: RuleStrength;
12138
- /** RFC-2119-flavoured binding strength */
12139
- strictness?: 'must' | 'should' | 'may';
12140
12097
  /** Exception request or documentation process */
12141
12098
  exception_policy?: string;
12142
12099
  }
@@ -12661,12 +12618,6 @@ interface TaskProperties {
12661
12618
  due_date?: ISODate;
12662
12619
  /** Free-form classification tags. Applied uniformly across work item types. */
12663
12620
  labels?: string[];
12664
- /**
12665
- * Story-point or sizing estimate. String to support fibonacci, t-shirt sizes,
12666
- * or custom scales (e.g. "5", "M", "3 pts"). Absorbed from `StoryTaskProperties`
12667
- * when `story_task` collapsed into `task` (v0.4.0).
12668
- */
12669
- estimate?: string;
12670
12621
  }
12671
12622
  /** Bug report.
12672
12623
  *
@@ -13455,9 +13406,7 @@ interface InvestigationProperties {
13455
13406
  * severity: 4,
13456
13407
  * cause_confidence: 'confirmed',
13457
13408
  * evidence_summary: 'Trace shows retry loop on 4xx responses; reproduced in staging with synthetic 401.',
13458
- * category: 'architecture',
13459
13409
  * affected_area: 'Billing settlement service',
13460
- * verified: true,
13461
13410
  * }
13462
13411
  */
13463
13412
  interface RootCauseProperties {
@@ -13480,12 +13429,8 @@ interface RootCauseProperties {
13480
13429
  cause_confidence?: CauseConfidence;
13481
13430
  /** One-paragraph evidence summary. Log lines, traces, repro steps. Detailed artefacts go on linked `evidence` nodes. */
13482
13431
  evidence_summary?: string;
13483
- /** Legacy free-form category. Retained for v0.2 baseline; new graphs prefer `cause_category`. */
13484
- category?: 'architecture' | 'design' | 'data' | 'infrastructure' | 'process' | 'dependency' | 'other';
13485
13432
  /** Affected area of the system */
13486
13433
  affected_area?: string;
13487
- /** Verified through investigation */
13488
- verified?: boolean;
13489
13434
  }
13490
13435
  /** Observable behaviour produced by a root cause.
13491
13436
  *
@@ -16855,10 +16800,8 @@ interface BehavioralSegmentProperties {
16855
16800
  included_behaviors?: string[];
16856
16801
  /** Excluding behaviours (negative criteria, free-text labels) */
16857
16802
  excluded_behaviors?: string[];
16858
- /** Estimated current size. Snapshot value. */
16803
+ /** Estimated current size. Snapshot value. (`size`, the v0.2 alias, removed in 0.14.0, UPG-574.) */
16859
16804
  size_estimate?: number;
16860
- /** Size. Alias retained for the v0.2 baseline. */
16861
- size?: number;
16862
16805
  /** ISO start of the validity window. Behavioural definitions decay; outside the window the snapshot should be re-computed. */
16863
16806
  validity_period_start?: ISODate;
16864
16807
  /** End of the window over which the segment definition is considered valid (ISO format) */
@@ -21941,7 +21884,7 @@ declare function isCanonical(text: string): boolean;
21941
21884
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
21942
21885
  * The `check:version-lockstep` gate enforces this at release time.
21943
21886
  */
21944
- declare const UPG_VERSION: "0.13.1";
21887
+ declare const UPG_VERSION: "0.14.0";
21945
21888
  /**
21946
21889
  * The `.upg` JSON document format version. Written to the `upg_version` field.
21947
21890
  * Evolves independently from `UPG_VERSION` (the catalogue version).
package/dist/index.d.ts CHANGED
@@ -10542,72 +10542,31 @@ interface SwitchingCostProperties {
10542
10542
  * pain: 4,
10543
10543
  * }
10544
10544
  */
10545
+ /**
10546
+ * Opportunity carries no intrinsic scalar properties: it is defined by its
10547
+ * title/description and its edges (to the problems/needs it addresses and the
10548
+ * solutions proposed against it). Its former scoring inputs (`reach`,
10549
+ * `frequency`, `pain`, `opportunity_score`) were framework-scoped from 0.9.0 —
10550
+ * they live on the `framework_exercise` includes-edge of the `opportunity-sizing`
10551
+ * framework, not on the entity. Removed from the schema in 0.14.0 (UPG-574).
10552
+ */
10545
10553
  interface OpportunityProperties {
10546
- /**
10547
- * How many users experience this problem.
10548
- * @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic
10549
- * property. Apply the `opportunity-sizing` framework; the value lives on the
10550
- * framework_exercise includes-edge. Removed in 0.9.1.
10551
- */
10552
- reach?: UPGAssessment;
10553
- /**
10554
- * How often users experience this problem.
10555
- * @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.
10556
- */
10557
- frequency?: UPGAssessment;
10558
- /**
10559
- * How painful it is when unaddressed.
10560
- * @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.
10561
- */
10562
- pain?: UPGAssessment;
10563
- /**
10564
- * Computed: normalized_reach x normalized_frequency x normalized_pain (0-1).
10565
- * @deprecated 0.9.0:computed by the `opportunity-sizing` framework on its
10566
- * application edge, not stored on the entity. Removed in 0.9.1.
10567
- */
10568
- opportunity_score?: number;
10569
10554
  }
10570
10555
  /** A proposed response to an opportunity
10571
10556
  *
10572
10557
  * @example
10573
10558
  * const properties: SolutionProperties = {
10574
10559
  * timeline: 'Kickoff 2026-04-22, results by 2026-05-15.',
10575
- * reach: 4,
10576
- * impact: 4,
10577
10560
  * }
10561
+ *
10562
+ * RICE scoring inputs (`reach`, `impact`, `confidence`, `effort`) and the
10563
+ * computed `rice_score` were framework-scoped from 0.9.0 and removed from the
10564
+ * schema in 0.14.0 (UPG-574): apply the `rice-scoring` framework and read the
10565
+ * score off the `framework_exercise` includes-edge, not the entity.
10578
10566
  */
10579
10567
  interface SolutionProperties {
10580
10568
  /** Estimated delivery or target timeline */
10581
10569
  timeline?: string;
10582
- /**
10583
- * How many users this solution reaches (1 = few, 5 = most).
10584
- * @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic
10585
- * property. Apply the `rice-scoring` framework; the value lives on the
10586
- * framework_exercise includes-edge. Removed in 0.9.1.
10587
- */
10588
- reach?: UPGAssessment;
10589
- /**
10590
- * Expected impact on the target outcome (1 = minimal, 5 = transformative).
10591
- * @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.
10592
- */
10593
- impact?: UPGAssessment;
10594
- /**
10595
- * How confident the team is in this solution (1 = speculative, 5 = proven).
10596
- * @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.
10597
- */
10598
- confidence?: UPGAssessment;
10599
- /**
10600
- * Level of effort required to implement (1 = trivial, 5 = very large).
10601
- * @deprecated 0.9.0:effort is a framework-scoped scoring input (it varies by
10602
- * assessor and method), not an intrinsic property. Removed in 0.9.1.
10603
- */
10604
- effort?: UPGAssessment;
10605
- /**
10606
- * Computed: (reach × impact × confidence) / effort.
10607
- * @deprecated 0.9.0:computed by the `rice-scoring` framework on its
10608
- * application edge, not stored on the entity. Removed in 0.9.1.
10609
- */
10610
- rice_score?: number;
10611
10570
  }
10612
10571
  /** FeasibilityStudy entity.
10613
10572
  *
@@ -12133,10 +12092,8 @@ interface DesignGuidelineProperties {
12133
12092
  applies_to?: string;
12134
12093
  /** Reasoning. Why this rule exists. */
12135
12094
  rationale?: string;
12136
- /** Imperative force. Supersedes `strictness`. */
12095
+ /** Imperative force. (Superseded the removed `strictness` field in 0.14.0, UPG-574.) */
12137
12096
  rule_strength?: RuleStrength;
12138
- /** RFC-2119-flavoured binding strength */
12139
- strictness?: 'must' | 'should' | 'may';
12140
12097
  /** Exception request or documentation process */
12141
12098
  exception_policy?: string;
12142
12099
  }
@@ -12661,12 +12618,6 @@ interface TaskProperties {
12661
12618
  due_date?: ISODate;
12662
12619
  /** Free-form classification tags. Applied uniformly across work item types. */
12663
12620
  labels?: string[];
12664
- /**
12665
- * Story-point or sizing estimate. String to support fibonacci, t-shirt sizes,
12666
- * or custom scales (e.g. "5", "M", "3 pts"). Absorbed from `StoryTaskProperties`
12667
- * when `story_task` collapsed into `task` (v0.4.0).
12668
- */
12669
- estimate?: string;
12670
12621
  }
12671
12622
  /** Bug report.
12672
12623
  *
@@ -13455,9 +13406,7 @@ interface InvestigationProperties {
13455
13406
  * severity: 4,
13456
13407
  * cause_confidence: 'confirmed',
13457
13408
  * evidence_summary: 'Trace shows retry loop on 4xx responses; reproduced in staging with synthetic 401.',
13458
- * category: 'architecture',
13459
13409
  * affected_area: 'Billing settlement service',
13460
- * verified: true,
13461
13410
  * }
13462
13411
  */
13463
13412
  interface RootCauseProperties {
@@ -13480,12 +13429,8 @@ interface RootCauseProperties {
13480
13429
  cause_confidence?: CauseConfidence;
13481
13430
  /** One-paragraph evidence summary. Log lines, traces, repro steps. Detailed artefacts go on linked `evidence` nodes. */
13482
13431
  evidence_summary?: string;
13483
- /** Legacy free-form category. Retained for v0.2 baseline; new graphs prefer `cause_category`. */
13484
- category?: 'architecture' | 'design' | 'data' | 'infrastructure' | 'process' | 'dependency' | 'other';
13485
13432
  /** Affected area of the system */
13486
13433
  affected_area?: string;
13487
- /** Verified through investigation */
13488
- verified?: boolean;
13489
13434
  }
13490
13435
  /** Observable behaviour produced by a root cause.
13491
13436
  *
@@ -16855,10 +16800,8 @@ interface BehavioralSegmentProperties {
16855
16800
  included_behaviors?: string[];
16856
16801
  /** Excluding behaviours (negative criteria, free-text labels) */
16857
16802
  excluded_behaviors?: string[];
16858
- /** Estimated current size. Snapshot value. */
16803
+ /** Estimated current size. Snapshot value. (`size`, the v0.2 alias, removed in 0.14.0, UPG-574.) */
16859
16804
  size_estimate?: number;
16860
- /** Size. Alias retained for the v0.2 baseline. */
16861
- size?: number;
16862
16805
  /** ISO start of the validity window. Behavioural definitions decay; outside the window the snapshot should be re-computed. */
16863
16806
  validity_period_start?: ISODate;
16864
16807
  /** End of the window over which the segment definition is considered valid (ISO format) */
@@ -21941,7 +21884,7 @@ declare function isCanonical(text: string): boolean;
21941
21884
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
21942
21885
  * The `check:version-lockstep` gate enforces this at release time.
21943
21886
  */
21944
- declare const UPG_VERSION: "0.13.1";
21887
+ declare const UPG_VERSION: "0.14.0";
21945
21888
  /**
21946
21889
  * The `.upg` JSON document format version. Written to the `upg_version` field.
21947
21890
  * Evolves independently from `UPG_VERSION` (the catalogue version).