@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.cjs +151 -188
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +16 -73
- package/dist/index.d.ts +16 -73
- package/dist/index.js +151 -188
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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).
|