@unified-product-graph/core 0.8.7 → 0.8.8

package/dist/index.d.cts

@@ -8804,12 +8804,21 @@ interface UPGValidationWarning {
      * re-runs the validator and re-classifies these as policy violations so a
      * CI gate still fails, without making the parser refuse to read the file.
      */
-    rule?: 'property-type' | 'property-enum' | 'self-loop';
+    rule?: 'property-type' | 'property-enum' | 'self-loop' | 'framework-score';
 }
 /**
- * Warning `rule` codes for the content-depth checks added in UPG-632.
+ * Warning `rule` codes for the content-depth checks.
  * `verify`/`check` treat a document carrying any of these as a policy
  * violation (exit 2) even though they never block the load path.
+ *
+ * - `property-type` / `property-enum` / `self-loop` — UPG-632.
+ * - `framework-score` — UPG-638. A `framework_exercise`'s persisted per-entity
+ *   result (carried on its `framework_exercise_includes_node` edge properties)
+ *   that violates the framework's own input spec: an invalid enum bucket, a
+ *   non-numeric / out-of-scale / negative score, or a zero in a divisor input
+ *   (e.g. RICE `effort`, WSJF `job_size`). A WARNING, not an error: a drifted
+ *   exercise still LOADS, consistent with the severity discipline above. See
+ *   `validateFrameworkScores`.
  */
 declare const CONTENT_DEPTH_WARNING_RULES: ReadonlySet<NonNullable<UPGValidationWarning['rule']>>;
 /**
@@ -19463,6 +19472,23 @@ interface FrameworkSlot {
     label: string;
     /** The UPG entity type that fills this slot */
     entityTypeId: string;
+    /**
+     * The semantic role this slot plays in the framework, as a stable
+     * machine-readable id (e.g. "pain_reliever", "accountable", "must_have").
+     *
+     * Distinct from `entityTypeId`: many frameworks fill several slots with the
+     * SAME entity type (a Value Proposition Canvas has six `feature` slots; a RACI
+     * matrix four `role` slots), and the slot role is what disambiguates them so a
+     * consumer can address "the pain-reliever features" rather than just "the
+     * features". Framework-local vocabulary, not a global UPG type.
+     *
+     * Additive and optional. It is also distinct from the COARSE structural
+     * `FrameworkEntityTypeSpec.role` (item/bucket/scored_item/root/leaf/branch),
+     * which describes an entity type's structural place; this is the FINE semantic
+     * part a specific slot plays. Neither is a validation signal — scoring is keyed
+     * off `scope: 'framework'` properties, not roles.
+     */
+    role?: string;
     /** Explanation of what this slot represents in the framework */
     description?: string;
 }

package/dist/index.d.ts

@@ -8804,12 +8804,21 @@ interface UPGValidationWarning {
      * re-runs the validator and re-classifies these as policy violations so a
      * CI gate still fails, without making the parser refuse to read the file.
      */
-    rule?: 'property-type' | 'property-enum' | 'self-loop';
+    rule?: 'property-type' | 'property-enum' | 'self-loop' | 'framework-score';
 }
 /**
- * Warning `rule` codes for the content-depth checks added in UPG-632.
+ * Warning `rule` codes for the content-depth checks.
  * `verify`/`check` treat a document carrying any of these as a policy
  * violation (exit 2) even though they never block the load path.
+ *
+ * - `property-type` / `property-enum` / `self-loop` — UPG-632.
+ * - `framework-score` — UPG-638. A `framework_exercise`'s persisted per-entity
+ *   result (carried on its `framework_exercise_includes_node` edge properties)
+ *   that violates the framework's own input spec: an invalid enum bucket, a
+ *   non-numeric / out-of-scale / negative score, or a zero in a divisor input
+ *   (e.g. RICE `effort`, WSJF `job_size`). A WARNING, not an error: a drifted
+ *   exercise still LOADS, consistent with the severity discipline above. See
+ *   `validateFrameworkScores`.
  */
 declare const CONTENT_DEPTH_WARNING_RULES: ReadonlySet<NonNullable<UPGValidationWarning['rule']>>;
 /**
@@ -19463,6 +19472,23 @@ interface FrameworkSlot {
     label: string;
     /** The UPG entity type that fills this slot */
     entityTypeId: string;
+    /**
+     * The semantic role this slot plays in the framework, as a stable
+     * machine-readable id (e.g. "pain_reliever", "accountable", "must_have").
+     *
+     * Distinct from `entityTypeId`: many frameworks fill several slots with the
+     * SAME entity type (a Value Proposition Canvas has six `feature` slots; a RACI
+     * matrix four `role` slots), and the slot role is what disambiguates them so a
+     * consumer can address "the pain-reliever features" rather than just "the
+     * features". Framework-local vocabulary, not a global UPG type.
+     *
+     * Additive and optional. It is also distinct from the COARSE structural
+     * `FrameworkEntityTypeSpec.role` (item/bucket/scored_item/root/leaf/branch),
+     * which describes an entity type's structural place; this is the FINE semantic
+     * part a specific slot plays. Neither is a validation signal — scoring is keyed
+     * off `scope: 'framework'` properties, not roles.
+     */
+    role?: string;
     /** Explanation of what this slot represents in the framework */
     description?: string;
 }