@unified-product-graph/core 0.10.2 → 0.10.4

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK: () => BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK,
   BUSINESS_GTM_GROWTH_PLAYBOOK: () => BUSINESS_GTM_GROWTH_PLAYBOOK,
   BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK: () => BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK,
+  CLASSIFICATION_EDGE_PROPERTY_SCHEMA: () => CLASSIFICATION_EDGE_PROPERTY_SCHEMA,
   CONTENT_DEPTH_WARNING_RULES: () => CONTENT_DEPTH_WARNING_RULES,
   DEFAULT_ENTITY_EMOJI: () => DEFAULT_ENTITY_EMOJI,
   DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK: () => DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK,
@@ -135,6 +136,7 @@ __export(index_exports, {
   getDomainForType: () => getDomainForType,
   getDomainIdForType: () => getDomainIdForType,
   getDomainsInRing: () => getDomainsInRing,
+  getEdgePropertySchema: () => getEdgePropertySchema,
   getEnumScale: () => getEnumScale,
   getEnumValueMeta: () => getEnumValueMeta,
   getGuideForDomain: () => getGuideForDomain,
@@ -199,6 +201,7 @@ __export(index_exports, {
   ringOrderedDomainIds: () => ringOrderedDomainIds,
   rotateSlug: () => rotateSlug,
   serializeCanonical: () => serializeCanonical,
+  validateEdgeProperties: () => validateEdgeProperties,
   validateProductStageStrict: () => validateProductStageStrict,
   validateUPGDocument: () => validateUPGDocument,
   validateUPGFramework: () => validateUPGFramework,
@@ -1185,6 +1188,32 @@ function getTypeName(typeId) {
 
 // src/catalog/edge-catalog.ts
 var UPG_WILDCARD_ENDPOINT = "node";
+var CLASSIFICATION_EDGE_PROPERTY_SCHEMA = {
+  confidence: {
+    type: "assessment",
+    scale_id: "confidence_5",
+    description: "How sure we are this node belongs in this classification cell, on the canonical confidence_5 scale. Numeric value plus a high/medium/low label.",
+    properties: {
+      value: { type: "number", description: "Numeric value 1-5 (confidence_5)." },
+      label: { type: "string", description: "Qualitative label (Guessing/Hunch/Some evidence/Confident/Data-backed, or high/medium/low)." },
+      scale_id: { type: "string", description: "Scale rated on (optional; defaults confidence_5)." },
+      normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
+    },
+    required: ["value", "label"]
+  },
+  assessed_on: {
+    type: "string",
+    description: 'Provenance: ISO date-time the classification was made or last re-checked. Drives staleness queries. @example "2026-06-13"'
+  },
+  rationale: {
+    type: "string",
+    description: "Optional. Short note on why this node sits in this cell. Edge-level, distinct from classification_value.rationale (why the value exists as a category)."
+  },
+  evidence: {
+    type: "string",
+    description: "Optional. A source URL, or a competitor_signal / evidence node id backing the classification. Mirrors feature_rivals_competitor_feature.evidence (free text or a node id)."
+  }
+};
 var UPG_EDGE_CATALOG = {
   // ── Part 1: Core Narrative Spine (Ring 1) ──────────────────────────────────
   // 1.1 User Domain
@@ -1357,7 +1386,13 @@ var UPG_EDGE_CATALOG = {
   // competitor can be classified directly against a `registry/{classification_value}`
   // canonical, eliminating the per-graph taxonomy node. Within-graph (the catalogue
   // case) here; cross-product against the registry canonical via create_cross_product_edge.
-  competitor_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "competitor", target_type: "classification_value" },
+  competitor_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "competitor", target_type: "classification_value", carries_properties: true, property_schema: CLASSIFICATION_EDGE_PROPERTY_SCHEMA },
+  // 0.10.3: the polymorphic, type-agnostic sibling. ANY node (a feature, a
+  // product, a market_segment) classified against a classification_value, so
+  // classification is not welded to the competitor type. Also dual-registered as
+  // a cross-edge for the registry-canonical case. source_type:'node' (wildcard);
+  // listed in UPG_POLYMORPHIC_EDGE_KEYS.
+  node_classified_as_classification_value: { forward_verb: "classified_as", reverse_verb: "classification_of", classification: "semantic", source_type: "node", target_type: "classification_value", carries_properties: true, property_schema: CLASSIFICATION_EDGE_PROPERTY_SCHEMA },
   persona_anti_fit_for_classification_value: { forward_verb: "is_anti_fit_for", reverse_verb: "should_not_be_picked_by", classification: "semantic", source_type: "persona", target_type: "classification_value" },
   persona_anti_fit_for_product: { forward_verb: "is_anti_fit_for", reverse_verb: "should_not_be_picked_by", classification: "semantic", source_type: "persona", target_type: "product" },
   persona_anti_fit_for_competitor: { forward_verb: "is_anti_fit_for", reverse_verb: "should_not_be_picked_by", classification: "semantic", source_type: "persona", target_type: "competitor" },
@@ -3195,7 +3230,9 @@ var UPG_POLYMORPHIC_EDGE_KEYS = [
   // Universal architecture references
   "node_belongs_to_bounded_context",
   // Framework exercises (an exercise can include any entity type)
-  "framework_exercise_includes_node"
+  "framework_exercise_includes_node",
+  // Universal classification (any node classified against a classification_value)
+  "node_classified_as_classification_value"
 ];
 var _POLY_KEY_SET = new Set(UPG_POLYMORPHIC_EDGE_KEYS);
 function isPolymorphicEdge(key) {
@@ -3209,6 +3246,10 @@ function edgeCarriesProperties(type) {
   const def = UPG_EDGE_CATALOG[type];
   return def?.carries_properties === true;
 }
+function getEdgePropertySchema(type) {
+  const def = UPG_EDGE_CATALOG[type];
+  return def?.property_schema;
+}
 
 // src/catalog/legacy-product-stages.ts
 var LEGACY_PRODUCT_STAGES = Object.freeze({
@@ -3253,7 +3294,8 @@ var UPG_CROSS_EDGE_TYPES = [
   "feature_rivals_competitor_feature",
   "competitor_signal_maps_to_feature",
   "competitor_signal_surfaces_opportunity",
-  "competitor_classified_as_classification_value"
+  "competitor_classified_as_classification_value",
+  "node_classified_as_classification_value"
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 
@@ -18738,6 +18780,65 @@ function isUPGDocument(doc) {
   return validateUPGDocument(doc).valid;
 }
 
+// src/properties/edge-property-validation.ts
+function validateEdgeProperties(edgeType, properties) {
+  const schema = getEdgePropertySchema(edgeType);
+  if (!schema || !properties) return [];
+  const errors = [];
+  const allowed = Object.keys(schema);
+  for (const key of Object.keys(properties)) {
+    if (!allowed.includes(key)) {
+      errors.push(`unknown property "${key}" for edge type "${edgeType}" (allowed: ${allowed.join(", ")})`);
+    }
+  }
+  for (const [key, def] of Object.entries(schema)) {
+    const val = properties[key];
+    if (val === void 0 || val === null) continue;
+    errors.push(...validateValue(key, def, val));
+  }
+  return errors;
+}
+function validateValue(key, def, val) {
+  const errors = [];
+  switch (def.type) {
+    case "string":
+      if (typeof val !== "string") errors.push(`property "${key}" must be a string`);
+      break;
+    case "number":
+      if (typeof val !== "number") errors.push(`property "${key}" must be a number`);
+      break;
+    case "boolean":
+      if (typeof val !== "boolean") errors.push(`property "${key}" must be a boolean`);
+      break;
+    case "assessment": {
+      if (typeof val !== "object" || Array.isArray(val)) {
+        errors.push(`property "${key}" must be an assessment object with value and label`);
+        break;
+      }
+      const a = val;
+      for (const r of def.required ?? ["value", "label"]) {
+        if (a[r] === void 0 || a[r] === null) errors.push(`assessment "${key}" is missing required "${r}"`);
+      }
+      if (a.value !== void 0 && a.value !== null) {
+        if (typeof a.value !== "number") {
+          errors.push(`assessment "${key}".value must be a number`);
+        } else {
+          const scaleId = (typeof a.scale_id === "string" ? a.scale_id : void 0) ?? def.scale_id;
+          const scale = scaleId ? getScale(scaleId) : void 0;
+          if (scale && (a.value < scale.min || a.value > scale.max)) {
+            errors.push(`assessment "${key}".value ${a.value} is out of range ${scale.min}-${scale.max} for scale ${scaleId}`);
+          }
+        }
+      }
+      if (typeof a.scale_id === "string" && def.scale_id !== void 0 && a.scale_id !== def.scale_id) {
+        errors.push(`assessment "${key}".scale_id "${a.scale_id}" must be "${def.scale_id}"`);
+      }
+      break;
+    }
+  }
+  return errors;
+}
+
 // src/presentation/entity-emoji.ts
 var DEFAULT_ENTITY_EMOJI = "\u{1F4E6}";
 var ENTITY_EMOJI = {
@@ -28637,7 +28738,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.10.2";
+var UPG_VERSION = "0.10.4";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -28706,6 +28807,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK,
   BUSINESS_GTM_GROWTH_PLAYBOOK,
   BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK,
+  CLASSIFICATION_EDGE_PROPERTY_SCHEMA,
   CONTENT_DEPTH_WARNING_RULES,
   DEFAULT_ENTITY_EMOJI,
   DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK,
@@ -28817,6 +28919,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getDomainForType,
   getDomainIdForType,
   getDomainsInRing,
+  getEdgePropertySchema,
   getEnumScale,
   getEnumValueMeta,
   getGuideForDomain,
@@ -28881,6 +28984,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   ringOrderedDomainIds,
   rotateSlug,
   serializeCanonical,
+  validateEdgeProperties,
   validateProductStageStrict,
   validateUPGDocument,
   validateUPGFramework,