@unified-product-graph/core 0.12.6 → 0.12.8

package/dist/index.cjs

@@ -38,7 +38,10 @@ __export(index_exports, {
   MARKET_COMPETITIVE_PLAYBOOK: () => MARKET_COMPETITIVE_PLAYBOOK,
   OPERATIONS_QUALITY_PLAYBOOK: () => OPERATIONS_QUALITY_PLAYBOOK,
   PRODUCT_DELIVERY_PLAYBOOK: () => PRODUCT_DELIVERY_PLAYBOOK,
+  PROPERTY_MODIFIERS: () => PROPERTY_MODIFIERS,
+  PROPERTY_MODIFIER_SEMANTICS: () => PROPERTY_MODIFIER_SEMANTICS,
   PROPERTY_SCALE_MAP: () => PROPERTY_SCALE_MAP,
+  RECORD_ENTITY_TYPES: () => RECORD_ENTITY_TYPES,
   REFLECT_MODES: () => REFLECT_MODES,
   REGISTRY_PRODUCT_ID: () => REGISTRY_PRODUCT_ID,
   STRATEGY_OUTCOMES_PLAYBOOK: () => STRATEGY_OUTCOMES_PLAYBOOK,
@@ -140,6 +143,7 @@ __export(index_exports, {
   getDomainIdForType: () => getDomainIdForType,
   getDomainsInRing: () => getDomainsInRing,
   getEdgePropertySchema: () => getEdgePropertySchema,
+  getEntityModifierSummary: () => getEntityModifierSummary,
   getEnumScale: () => getEnumScale,
   getEnumValueMeta: () => getEnumValueMeta,
   getGuideForDomain: () => getGuideForDomain,
@@ -155,6 +159,7 @@ __export(index_exports, {
   getPropertiesForScale: () => getPropertiesForScale,
   getPropertyDefaultScale: () => getPropertyDefaultScale,
   getPropertyMigrations: () => getPropertyMigrations,
+  getPropertyModifier: () => getPropertyModifier,
   getPropertySchema: () => getPropertySchema,
   getRegion: () => getRegion,
   getRegionForEntityType: () => getRegionForEntityType,
@@ -171,6 +176,7 @@ __export(index_exports, {
   getValidChildren: () => getValidChildren,
   getVisibleTypes: () => getVisibleTypes,
   hasStatusMigration: () => hasStatusMigration,
+  isAggregateShapedProperty: () => isAggregateShapedProperty,
   isCanonical: () => isCanonical,
   isCanonicalProductStage: () => isCanonicalProductStage,
   isContainmentFreeType: () => isContainmentFreeType,
@@ -183,9 +189,12 @@ __export(index_exports, {
   isLifecyclePlannedType: () => isLifecyclePlannedType,
   isPolymorphicEdge: () => isPolymorphicEdge,
   isPortfolio: () => isPortfolio,
+  isRecordEntity: () => isRecordEntity,
   isRegisteredPolymorphicEdge: () => isRegisteredPolymorphicEdge,
+  isRuntimeStateShapedProperty: () => isRuntimeStateShapedProperty,
   isSubSequenceStep: () => isSubSequenceStep,
   isUPGDocument: () => isUPGDocument,
+  listPropertiesByModifier: () => listPropertiesByModifier,
   listStatusMigrations: () => listStatusMigrations,
   listTreePatternSummaries: () => listTreePatternSummaries,
   migrateEdge: () => migrateEdge,
@@ -1659,6 +1668,11 @@ var UPG_EDGE_CATALOG = {
   design_system_defines_design_token: { forward_verb: "defines", reverse_verb: "defined_in", classification: "hierarchy", source_type: "design_system", target_type: "design_token" },
   design_system_codified_in_design_guideline: { forward_verb: "codified_in", reverse_verb: "codifies", classification: "hierarchy", source_type: "design_system", target_type: "design_guideline" },
   design_system_expresses_brand_identity: { forward_verb: "expresses", reverse_verb: "expressed_in", classification: "hierarchy", source_type: "design_system", target_type: "brand_identity" },
+  // Product expresses the brand (0.12.7, UPG-698). A product references the shared
+  // brand_identity. Dual-registered: also a cross-edge for the common case where the
+  // brand is a registry singleton in another graph (the ratified pattern: brand is a
+  // singleton expressed, not instance_of-d); this catalog entry is the within-graph case.
+  product_expresses_brand_identity: { forward_verb: "expresses", reverse_verb: "expressed_by", classification: "semantic", source_type: "product", target_type: "brand_identity" },
   design_system_encompasses_user_journey: { forward_verb: "encompasses", reverse_verb: "encompassed_in", classification: "hierarchy", source_type: "design_system", target_type: "user_journey" },
   design_system_encompasses_user_flow: { forward_verb: "encompasses", reverse_verb: "encompassed_in", classification: "hierarchy", source_type: "design_system", target_type: "user_flow" },
   design_system_informed_by_insight: { forward_verb: "informed_by", reverse_verb: "informs", classification: "hierarchy", source_type: "design_system", target_type: "insight" },
@@ -1671,6 +1685,11 @@ var UPG_EDGE_CATALOG = {
   design_component_composes_design_component: { forward_verb: "composes", reverse_verb: "composed_in", classification: "hierarchy", source_type: "design_component", target_type: "design_component" },
   prototype_annotated_with_annotation: { forward_verb: "annotated_with", reverse_verb: "annotates", classification: "hierarchy", source_type: "prototype", target_type: "annotation" },
   screen_renders_design_component: { forward_verb: "renders", reverse_verb: "rendered_on", classification: "hierarchy", source_type: "screen", target_type: "design_component" },
+  // Marketing surface to product (0.12.7, UPG-696/698). A marketing/landing screen
+  // markets a product. Dual-registered: also a cross-edge (UPG_CROSS_EDGE_TYPES) for
+  // the common case where the product lives in another graph; this catalog entry is
+  // the within-graph degenerate case (a product's own landing page).
+  screen_markets_product: { forward_verb: "markets", reverse_verb: "marketed_by", classification: "semantic", source_type: "screen", target_type: "product" },
   screen_navigates_to_screen: { forward_verb: "navigates_to", reverse_verb: "navigated_from", classification: "hierarchy", source_type: "screen", target_type: "screen" },
   screen_surfaces_feature: { forward_verb: "surfaces", reverse_verb: "surfaced_on", classification: "cross-domain", source_type: "screen", target_type: "feature" },
   screen_wireframed_as_wireframe: { forward_verb: "wireframed_as", reverse_verb: "wireframes", classification: "hierarchy", source_type: "screen", target_type: "wireframe" },
@@ -3348,7 +3367,9 @@ var UPG_CROSS_EDGE_TYPES = [
   "competitor_classified_as_classification_value",
   "node_classified_as_classification_value",
   "journey_phase_realises_operating_stage",
-  "screen_markets_product"
+  "screen_markets_product",
+  "screen_renders_design_component",
+  "product_expresses_brand_identity"
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 
@@ -19411,6 +19432,62 @@ function isUPGDocument(doc) {
   return validateUPGDocument(doc).valid;
 }
 
+// src/properties/property-modifiers.ts
+var PROPERTY_MODIFIERS = ["derived", "snapshot", "volatile"];
+var PROPERTY_MODIFIER_SEMANTICS = {
+  derived: "Computed from edges/children at read-time; never hand-authored. A stored value that contradicts the graph is a smell.",
+  snapshot: "A stale-stamped cache of a live reading; SHOULD pair with a `*_as_of` timestamp. Definition entities carry live state only as a snapshot.",
+  volatile: "An environment-specific pointer (URL / path / id) that may rot or be stripped on export; not portable modeling knowledge."
+};
+function listPropertiesByModifier(modifier) {
+  const out = [];
+  for (const [type, props] of Object.entries(UPG_PROPERTY_SCHEMA)) {
+    for (const [property, def] of Object.entries(props)) {
+      const m = def?.modifier;
+      if (!m) continue;
+      if (modifier && m !== modifier) continue;
+      out.push({ type, property, modifier: m });
+    }
+  }
+  return out;
+}
+function getPropertyModifier(entityType, property) {
+  return UPG_PROPERTY_SCHEMA[entityType]?.[property]?.modifier;
+}
+function getEntityModifierSummary(entityType) {
+  const props = UPG_PROPERTY_SCHEMA[entityType];
+  if (!props) return void 0;
+  const summary = { derived: [], snapshot: [], volatile: [] };
+  let any = false;
+  for (const [property, def] of Object.entries(props)) {
+    const m = def?.modifier;
+    if (!m) continue;
+    summary[m].push(property);
+    any = true;
+  }
+  return any ? summary : void 0;
+}
+var RECORD_ENTITY_TYPES = /* @__PURE__ */ new Set([
+  "ai_cost_tracker",
+  "eval_run",
+  "test_result",
+  "agent_session",
+  "cohort",
+  "ai_trace",
+  "workflow_run"
+]);
+function isRecordEntity(entityType) {
+  return RECORD_ENTITY_TYPES.has(entityType);
+}
+function isAggregateShapedProperty(name, def) {
+  if (def?.type !== "number") return false;
+  return name.endsWith("_count") || name === "headcount";
+}
+function isRuntimeStateShapedProperty(name, def) {
+  if (def?.type !== "number") return false;
+  return /_rate$/.test(name) || /_pct$/.test(name) || /^current_/.test(name) || /_remaining$/.test(name) || /_p\d+_/.test(name) || /^monthly_/.test(name) || /_per_/.test(name);
+}
+
 // src/properties/edge-property-validation.ts
 function validateEdgeProperties(edgeType, properties) {
   const schema = getEdgePropertySchema(edgeType);
@@ -29453,7 +29530,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.12.6";
+var UPG_VERSION = "0.12.8";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -29536,7 +29613,10 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   MARKET_COMPETITIVE_PLAYBOOK,
   OPERATIONS_QUALITY_PLAYBOOK,
   PRODUCT_DELIVERY_PLAYBOOK,
+  PROPERTY_MODIFIERS,
+  PROPERTY_MODIFIER_SEMANTICS,
   PROPERTY_SCALE_MAP,
+  RECORD_ENTITY_TYPES,
   REFLECT_MODES,
   REGISTRY_PRODUCT_ID,
   STRATEGY_OUTCOMES_PLAYBOOK,
@@ -29638,6 +29718,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getDomainIdForType,
   getDomainsInRing,
   getEdgePropertySchema,
+  getEntityModifierSummary,
   getEnumScale,
   getEnumValueMeta,
   getGuideForDomain,
@@ -29653,6 +29734,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getPropertiesForScale,
   getPropertyDefaultScale,
   getPropertyMigrations,
+  getPropertyModifier,
   getPropertySchema,
   getRegion,
   getRegionForEntityType,
@@ -29669,6 +29751,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getValidChildren,
   getVisibleTypes,
   hasStatusMigration,
+  isAggregateShapedProperty,
   isCanonical,
   isCanonicalProductStage,
   isContainmentFreeType,
@@ -29681,9 +29764,12 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   isLifecyclePlannedType,
   isPolymorphicEdge,
   isPortfolio,
+  isRecordEntity,
   isRegisteredPolymorphicEdge,
+  isRuntimeStateShapedProperty,
   isSubSequenceStep,
   isUPGDocument,
+  listPropertiesByModifier,
   listStatusMigrations,
   listTreePatternSummaries,
   migrateEdge,