@unified-product-graph/core 0.22.1 → 0.23.0

package/dist/index.d.cts

@@ -1470,6 +1470,20 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    epic_decomposes_into_task: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    epic_affected_by_bug: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
     task_has_subtask: {
         forward_verb: string;
         reverse_verb: string;
@@ -15405,7 +15419,7 @@ interface EventSchemaProperties {
  */
 interface DashboardProperties {
     /** Analytics tool hosting this dashboard */
-    tool?: 'looker' | 'amplitude' | 'mixpanel' | 'posthog' | 'custom';
+    tool?: 'looker' | 'amplitude' | 'mixpanel' | 'posthog' | 'omni' | 'custom';
     /** URL to the live dashboard */
     url?: string;
     /** Intended audience for this dashboard */
@@ -22518,7 +22532,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.22.1";
+declare const UPG_VERSION: "0.23.0";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.d.ts

@@ -1470,6 +1470,20 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    epic_decomposes_into_task: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    epic_affected_by_bug: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
     task_has_subtask: {
         forward_verb: string;
         reverse_verb: string;
@@ -15405,7 +15419,7 @@ interface EventSchemaProperties {
  */
 interface DashboardProperties {
     /** Analytics tool hosting this dashboard */
-    tool?: 'looker' | 'amplitude' | 'mixpanel' | 'posthog' | 'custom';
+    tool?: 'looker' | 'amplitude' | 'mixpanel' | 'posthog' | 'omni' | 'custom';
     /** URL to the live dashboard */
     url?: string;
     /** Intended audience for this dashboard */
@@ -22518,7 +22532,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.22.1";
+declare const UPG_VERSION: "0.23.0";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -1429,6 +1429,17 @@ var UPG_EDGE_CATALOG = {
   bug_affects_feature: { forward_verb: "affects", reverse_verb: "affected_by", classification: "cross-domain", source_type: "bug", target_type: "feature" },
   roadmap_item_references_feature: { forward_verb: "references", reverse_verb: "referenced_by", classification: "cross-domain", source_type: "roadmap_item", target_type: "feature" },
   feature_decomposes_into_task: { forward_verb: "decomposes_into", reverse_verb: "implements", classification: "hierarchy", source_type: "feature", target_type: "task" },
+  // Epic-level mirrors of the feature→task / feature→bug hierarchy (feedback
+  // df99026a). A `feature` is the flat planning root, but an `epic` is a body of
+  // work under it, and real imported ticket sets (Linear/Jira) carry bugs and
+  // pure engineering tasks that belong to ONE epic, not the feature as a whole.
+  // Without these, such tickets had to be mislabelled `user_story` (the only
+  // epic child) to keep the epic grouping. These are additive twins of the
+  // feature-level edges (same verbs/classification), so `pickCanonicalEdge` /
+  // `resolveContainmentEdge('epic', 'task'|'bug')` and the adapter import path
+  // resolve them with no further wiring.
+  epic_decomposes_into_task: { forward_verb: "decomposes_into", reverse_verb: "implements", classification: "hierarchy", source_type: "epic", target_type: "task" },
+  epic_affected_by_bug: { forward_verb: "affected_by", reverse_verb: "affects", classification: "hierarchy", source_type: "epic", target_type: "bug" },
   task_has_subtask: { forward_verb: "has_subtask", reverse_verb: "is_subtask_of", classification: "hierarchy", source_type: "task", target_type: "task" },
   // ── Planning cadence (0.20.0) ────────────────────────────────────────────────
   // The cadence axis. E1 self-nests the interval (a program-increment contains
@@ -3732,7 +3743,10 @@ var UPG_VALID_CHILDREN = {
   // task_implements_user_story edge.
   feature: ["epic", "bug", "task"],
   feature_area: ["feature", "feature_area"],
-  epic: ["user_story"],
+  // epic owns user_story (the templated promise) and, mirroring feature, may
+  // also directly contain bug/task — heterogeneous imported tickets that belong
+  // to one epic rather than the feature as a whole (feedback df99026a).
+  epic: ["user_story", "bug", "task"],
   user_story: ["acceptance_criterion"],
   task: ["task"],
   // planning_cycle (0.20.0): the cadence axis self-nests (a program-increment
@@ -10717,7 +10731,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // DashboardProperties: Dashboard entity.
   dashboard: {
-    tool: { type: "string", enum: ["looker", "amplitude", "mixpanel", "posthog", "custom"], description: "Analytics tool hosting this dashboard" },
+    tool: { type: "string", enum: ["looker", "amplitude", "mixpanel", "posthog", "omni", "custom"], description: "Analytics tool hosting this dashboard" },
     url: { type: "string", description: "URL to the live dashboard", modifier: "volatile" },
     audience: { type: "string", description: "Intended audience for this dashboard" },
     element_count: { type: "number", description: "Number of widgets or panels on the dashboard", modifier: "derived" },
@@ -22876,6 +22890,12 @@ var PRODUCT_SPEC_GUIDE = {
       entity_types: ["feature_area", "feature", "epic", "user_story", "task"],
       edge_chain: ["feature_area_contains_feature", "feature_decomposed_into_epic", "epic_specified_by_user_story", "task_implements_user_story"]
     },
+    {
+      name: "Epic Work Items",
+      description: "A bug or a pure engineering/infra task that belongs to one specific epic (not the feature as a whole) attaches directly to that epic, mirroring how task and bug attach at the feature level. Use this when importing a real tracker (Linear/Jira) whose tickets are heterogeneous: keep genuine stories as user_story, but let bugs, spikes, and engineering tasks nest under their epic with their true type instead of being mislabelled to preserve the grouping.",
+      entity_types: ["epic", "task", "bug"],
+      edge_chain: ["epic_decomposes_into_task", "epic_affected_by_bug"]
+    },
     {
       name: "Planning Cadence",
       description: "The cadence axis. Create a planning_cycle (a sprint, iteration, quarter, or PI), nest finer cycles inside a coarse one, schedule the stories that flow through it, and scope the objectives the cycle serves. Scheduling and scoping are deliberate links, not containment: a story keeps its feature/epic parent.",
@@ -29692,7 +29712,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.22.1";
+var UPG_VERSION = "0.23.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();