@unified-product-graph/core 0.17.8 → 0.18.0

package/dist/index.cjs

@@ -103,6 +103,7 @@ __export(index_exports, {
   UPG_PLAYBOOKS: () => UPG_PLAYBOOKS,
   UPG_POLYMORPHIC_EDGE_KEYS: () => UPG_POLYMORPHIC_EDGE_KEYS,
   UPG_PORTFOLIO_KINDS: () => UPG_PORTFOLIO_KINDS,
+  UPG_PORTFOLIO_SHARED_TYPES: () => UPG_PORTFOLIO_SHARED_TYPES,
   UPG_PRODUCT_STAGES: () => UPG_PRODUCT_STAGES,
   UPG_PRODUCT_STAGE_COERCION_MAP: () => UPG_PRODUCT_STAGE_COERCION_MAP,
   UPG_PROPERTY_MIGRATIONS: () => UPG_PROPERTY_MIGRATIONS,
@@ -141,6 +142,7 @@ __export(index_exports, {
   concernEvaluatedFor: () => concernEvaluatedFor,
   concernFor: () => concernFor,
   concernGatesFor: () => concernGatesFor,
+  crossProductScope: () => crossProductScope,
   describeTreePattern: () => describeTreePattern,
   edgeCarriesProperties: () => edgeCarriesProperties,
   evaluateAntiPatterns: () => evaluateAntiPatterns,
@@ -202,7 +204,9 @@ __export(index_exports, {
   isCanonical: () => isCanonical,
   isCanonicalProductStage: () => isCanonicalProductStage,
   isContainmentFreeType: () => isContainmentFreeType,
+  isCrossCapable: () => isCrossCapable,
   isCrossProductEligible: () => isCrossProductEligible,
+  isCuratedCrossEligible: () => isCuratedCrossEligible,
   isDeliberateOnlyEdge: () => isDeliberateOnlyEdge,
   isDeprecatedType: () => isDeprecatedType,
   isDomainGuideStep: () => isDomainGuideStep,
@@ -213,6 +217,7 @@ __export(index_exports, {
   isLifecyclePlannedType: () => isLifecyclePlannedType,
   isPolymorphicEdge: () => isPolymorphicEdge,
   isPortfolio: () => isPortfolio,
+  isPortfolioSharedType: () => isPortfolioSharedType,
   isRecordEntity: () => isRecordEntity,
   isRegisteredPolymorphicEdge: () => isRegisteredPolymorphicEdge,
   isRuntimeStateShapedProperty: () => isRuntimeStateShapedProperty,
@@ -766,27 +771,27 @@ function getDomainIdForType(entityType) {
 // src/registry/entity-meta.ts
 var UPG_ENTITY_META = [
   // Foundations (0.9.12): shared specifications + the primitives they define.
-  { name: "specification", type_id: "ent_352", maturity: "proposed", since: "0.9.12" },
-  { name: "primitive", type_id: "ent_353", maturity: "proposed", since: "0.9.12" },
-  { name: "operating_lifecycle", type_id: "ent_355", maturity: "proposed", since: "0.11.6" },
-  { name: "operating_stage", type_id: "ent_356", maturity: "proposed", since: "0.11.6" },
+  { name: "specification", type_id: "ent_352", maturity: "proposed", since: "0.9.12", portfolio_shared: true },
+  { name: "primitive", type_id: "ent_353", maturity: "proposed", since: "0.9.12", portfolio_shared: true },
+  { name: "operating_lifecycle", type_id: "ent_355", maturity: "proposed", since: "0.11.6", portfolio_shared: true },
+  { name: "operating_stage", type_id: "ent_356", maturity: "proposed", since: "0.11.6", portfolio_shared: true },
   // ── Strategic ──
   { name: "product", type_id: "ent_001", maturity: "stable", since: "0.1.0" },
-  { name: "outcome", type_id: "ent_002", maturity: "stable", since: "0.1.0" },
+  { name: "outcome", type_id: "ent_002", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "kpi", type_id: "ent_003", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "metric" },
-  { name: "objective", type_id: "ent_004", maturity: "stable", since: "0.1.0" },
-  { name: "key_result", type_id: "ent_005", maturity: "stable", since: "0.1.0" },
-  { name: "metric", type_id: "ent_006", maturity: "stable", since: "0.1.0" },
+  { name: "objective", type_id: "ent_004", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "key_result", type_id: "ent_005", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "metric", type_id: "ent_006", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   // F7 (UPG-673): graduated proposed → stable at v0.9.x — proposed since 0.2.2,
   // the metric-quality assessment artefact is settled with no open restructure.
   { name: "metric_quality_assessment", type_id: "ent_339", maturity: "stable", since: "0.2.2" },
-  { name: "vision", type_id: "ent_007", maturity: "stable", since: "0.1.0" },
-  { name: "mission", type_id: "ent_008", maturity: "stable", since: "0.1.0" },
-  { name: "strategic_theme", type_id: "ent_009", maturity: "stable", since: "0.1.0" },
-  { name: "initiative", type_id: "ent_010", maturity: "stable", since: "0.1.0" },
-  { name: "capability", type_id: "ent_011", maturity: "stable", since: "0.1.0" },
+  { name: "vision", type_id: "ent_007", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "mission", type_id: "ent_008", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "strategic_theme", type_id: "ent_009", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "initiative", type_id: "ent_010", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "capability", type_id: "ent_011", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "value_stream", type_id: "ent_012", maturity: "stable", since: "0.1.0" },
-  { name: "strategic_pillar", type_id: "ent_013", maturity: "stable", since: "0.1.0" },
+  { name: "strategic_pillar", type_id: "ent_013", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "assumption", type_id: "ent_014", maturity: "stable", since: "0.1.0" },
   { name: "decision", type_id: "ent_015", maturity: "stable", since: "0.1.0" },
   { name: "constraint", type_id: "ent_348", maturity: "stable", since: "0.4.3" },
@@ -842,18 +847,18 @@ var UPG_ENTITY_META = [
   { name: "evidence", type_id: "ent_031", maturity: "stable", since: "0.1.0" },
   { name: "research_plan", type_id: "ent_032", maturity: "stable", since: "0.1.0" },
   // ── Market Intelligence ──
-  { name: "competitor", type_id: "ent_033", maturity: "stable", since: "0.1.0" },
-  { name: "competitor_feature", type_id: "ent_034", maturity: "stable", since: "0.1.0" },
-  { name: "competitor_signal", type_id: "ent_354", maturity: "proposed", since: "0.10.0" },
+  { name: "competitor", type_id: "ent_033", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "competitor_feature", type_id: "ent_034", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "competitor_signal", type_id: "ent_354", maturity: "proposed", since: "0.10.0", portfolio_shared: true },
   { name: "market_trend", type_id: "ent_035", maturity: "stable", since: "0.1.0" },
-  { name: "market_segment", type_id: "ent_036", maturity: "stable", since: "0.1.0" },
+  { name: "market_segment", type_id: "ent_036", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "competitive_analysis", type_id: "ent_037", maturity: "stable", since: "0.1.0" },
   // Classification taxonomy hosted by competitive_analysis.
   // F7 (UPG-673): graduated proposed → stable at v0.9.x — two minor releases
   // stable since 0.4.0, the taxonomy-axis/value pair backs the competitive-
   // analysis classification spine with no open rename/restructure ticket.
-  { name: "classification_axis", type_id: "ent_346", maturity: "stable", since: "0.4.0" },
-  { name: "classification_value", type_id: "ent_347", maturity: "stable", since: "0.4.0" },
+  { name: "classification_axis", type_id: "ent_346", maturity: "stable", since: "0.4.0", portfolio_shared: true },
+  { name: "classification_value", type_id: "ent_347", maturity: "stable", since: "0.4.0", portfolio_shared: true },
   // ── UX Research ──
   { name: "research_study", type_id: "ent_038", maturity: "stable", since: "0.1.0" },
   { name: "research_insight", type_id: "ent_039", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "insight" },
@@ -875,9 +880,9 @@ var UPG_ENTITY_META = [
   { name: "how_might_we", type_id: "ent_333", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.2.0", replacement: "design_question" },
   { name: "design_concept", type_id: "ent_054", maturity: "stable", since: "0.1.0" },
   { name: "prototype", type_id: "ent_055", maturity: "stable", since: "0.1.0" },
-  { name: "design_component", type_id: "ent_056", maturity: "stable", since: "0.1.0" },
+  { name: "design_component", type_id: "ent_056", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "design_token", type_id: "ent_057", maturity: "stable", since: "0.1.0" },
-  { name: "brand_identity", type_id: "ent_058", maturity: "stable", since: "0.1.0" },
+  { name: "brand_identity", type_id: "ent_058", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "brand_colour", type_id: "ent_059", maturity: "stable", since: "0.1.0" },
   { name: "brand_typography", type_id: "ent_060", maturity: "stable", since: "0.1.0" },
   { name: "brand_voice", type_id: "ent_061", maturity: "stable", since: "0.1.0" },
@@ -886,7 +891,7 @@ var UPG_ENTITY_META = [
   { name: "design_guideline", type_id: "ent_064", maturity: "stable", since: "0.1.0" },
   { name: "annotation", type_id: "ent_065", maturity: "stable", since: "0.1.0" },
   { name: "interaction_spec", type_id: "ent_066", maturity: "stable", since: "0.1.0" },
-  { name: "design_system", type_id: "ent_067", maturity: "stable", since: "0.1.0" },
+  { name: "design_system", type_id: "ent_067", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "user_flow", type_id: "ent_068", maturity: "stable", since: "0.1.0" },
   { name: "screen", type_id: "ent_069", maturity: "stable", since: "0.1.0" },
   { name: "screen_state", type_id: "ent_070", maturity: "stable", since: "0.1.0" },
@@ -1005,15 +1010,15 @@ var UPG_ENTITY_META = [
   { name: "rebuttal", type_id: "ent_140", maturity: "stable", since: "0.1.0" },
   { name: "proof_point", type_id: "ent_141", maturity: "stable", since: "0.1.0" },
   // ── Team & Organisation ──
-  { name: "team", type_id: "ent_142", maturity: "stable", since: "0.1.0" },
+  { name: "team", type_id: "ent_142", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "role", type_id: "ent_143", maturity: "stable", since: "0.1.0" },
   { name: "stakeholder", type_id: "ent_144", maturity: "stable", since: "0.1.0" },
   { name: "person", type_id: "ent_349", maturity: "stable", since: "0.5.0" },
   { name: "product_decision", type_id: "ent_145", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.2.0", replacement: "decision" },
   { name: "team_okr", type_id: "ent_146", maturity: "stable", since: "0.1.0" },
   { name: "retrospective", type_id: "ent_147", maturity: "stable", since: "0.1.0" },
-  { name: "dependency", type_id: "ent_148", maturity: "stable", since: "0.1.0" },
-  { name: "department", type_id: "ent_149", maturity: "stable", since: "0.1.0" },
+  { name: "dependency", type_id: "ent_148", maturity: "stable", since: "0.1.0", portfolio_shared: true },
+  { name: "department", type_id: "ent_149", maturity: "stable", since: "0.1.0", portfolio_shared: true },
   { name: "skill", type_id: "ent_150", maturity: "stable", since: "0.1.0" },
   { name: "ceremony", type_id: "ent_151", maturity: "stable", since: "0.1.0" },
   { name: "capacity_plan", type_id: "ent_152", maturity: "stable", since: "0.1.0" },
@@ -1225,6 +1230,10 @@ var UPG_ENTITY_META_BY_ID = new Map(
 );
 var UPG_ACTIVE_TYPES = UPG_ENTITY_META.filter((m) => m.maturity === "stable" || m.maturity === "proposed").map((m) => m.name);
 var UPG_DEPRECATED_TYPES = UPG_ENTITY_META.filter((m) => m.maturity === "deprecated").map((m) => m.name);
+var UPG_PORTFOLIO_SHARED_TYPES = UPG_ENTITY_META.filter((m) => m.portfolio_shared === true).map((m) => m.name);
+function isPortfolioSharedType(name) {
+  return UPG_ENTITY_META_BY_NAME.get(name)?.portfolio_shared === true;
+}
 function isDeprecatedType(name) {
   const meta = UPG_ENTITY_META_BY_NAME.get(name);
   return meta?.maturity === "deprecated";
@@ -10319,6 +10328,21 @@ function rotateSlug(node, next) {
   return node;
 }
 
+// src/grammar/cross-scope.ts
+var CURATED_CROSS_EDGE_SET = new Set(UPG_CROSS_EDGE_TYPES);
+function isCrossCapable(sourceType, targetType) {
+  return isPortfolioSharedType(sourceType) || isPortfolioSharedType(targetType);
+}
+function isCuratedCrossEligible(edgeType) {
+  return CURATED_CROSS_EDGE_SET.has(edgeType);
+}
+function crossProductScope(edgeType) {
+  if (CURATED_CROSS_EDGE_SET.has(edgeType)) return "curated";
+  const def = UPG_EDGE_CATALOG[edgeType];
+  if (def && isCrossCapable(def.source_type, def.target_type)) return "provisional";
+  return "resident";
+}
+
 // src/properties/property-schema.ts
 var UPG_PROPERTY_SCHEMA = {
   // A11yAnnotationProperties: Accessibility annotation.
@@ -29975,7 +29999,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.17.8";
+var UPG_VERSION = "0.18.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -30113,6 +30137,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   UPG_PLAYBOOKS,
   UPG_POLYMORPHIC_EDGE_KEYS,
   UPG_PORTFOLIO_KINDS,
+  UPG_PORTFOLIO_SHARED_TYPES,
   UPG_PRODUCT_STAGES,
   UPG_PRODUCT_STAGE_COERCION_MAP,
   UPG_PROPERTY_MIGRATIONS,
@@ -30151,6 +30176,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   concernEvaluatedFor,
   concernFor,
   concernGatesFor,
+  crossProductScope,
   describeTreePattern,
   edgeCarriesProperties,
   evaluateAntiPatterns,
@@ -30212,7 +30238,9 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   isCanonical,
   isCanonicalProductStage,
   isContainmentFreeType,
+  isCrossCapable,
   isCrossProductEligible,
+  isCuratedCrossEligible,
   isDeliberateOnlyEdge,
   isDeprecatedType,
   isDomainGuideStep,
@@ -30223,6 +30251,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   isLifecyclePlannedType,
   isPolymorphicEdge,
   isPortfolio,
+  isPortfolioSharedType,
   isRecordEntity,
   isRegisteredPolymorphicEdge,
   isRuntimeStateShapedProperty,