@unified-product-graph/core 0.21.0 → 0.22.0

package/README.md

@@ -7,7 +7,7 @@
 
 The TypeScript core for the **Unified Product Graph (UPG)**, an open specification that gives product tools a shared vocabulary for entities, edges, and frameworks.
 
-320 entity types across 37 domains. 1037 typed edges. 46 canonical framework definitions, with more added as each is reviewed.
+320 entity types across 37 domains. 1039 typed edges. 46 canonical framework definitions, with more added as each is reviewed.
 
 ## Install
 

package/dist/index.cjs

@@ -2557,8 +2557,31 @@ var UPG_EDGE_CATALOG = {
   product_cannibalises_product: { forward_verb: "cannibalises", reverse_verb: "cannibalised_by", classification: "causal", source_type: "product", target_type: "product" },
   product_succeeds_product: { forward_verb: "succeeds", reverse_verb: "succeeded_by", classification: "causal", source_type: "product", target_type: "product" },
   // 8.3 Workspace Edges
+  // Altitude anchors (WS3, 2026-07-05): a workspace scopes to exactly one of
+  // three legal altitudes — organization / product_area ("plane") / product —
+  // each a typed hierarchy edge, not a polymorphic `_node` wildcard. Per the
+  // enum-vs-polymorphism ADR (2026-06-16), this family fails universality
+  // (the anchor set is a closed altitude ladder, not "any entity") and is
+  // structural (it must resolve through `resolveContainmentEdge`/`get_tree`),
+  // so it stays enumerated — the same shape `feature`'s five typed parent
+  // edges already use. Same verb pair across all three altitudes. Neither new
+  // edge is cross_product_eligible: an org/plane-altitude workspace lives in
+  // the same portfolio-level `.upg` as its anchor, same as sibling containment
+  // edges (organization_organised_into_product_area, portfolio_contains_product).
+  organization_thinks_in_workspace: { forward_verb: "thinks_in", reverse_verb: "thinks_for", classification: "hierarchy", source_type: "organization", target_type: "workspace" },
+  product_area_thinks_in_workspace: { forward_verb: "thinks_in", reverse_verb: "thinks_for", classification: "hierarchy", source_type: "product_area", target_type: "workspace" },
   product_thinks_in_workspace: { forward_verb: "thinks_in", reverse_verb: "thinks_for", classification: "hierarchy", source_type: "product", target_type: "workspace" },
-  workspace_produced_decision: { forward_verb: "produced", reverse_verb: "produced_in", classification: "causal", source_type: "workspace", target_type: "decision" },
+  // Commit provenance (WS3, 2026-07-05): widened from the single-target
+  // `workspace_produced_decision` to the `node` wildcard — a workspace's
+  // commit loop can legitimately produce any entity type arranged in it
+  // (decision, feature, persona, ...), so per the same ADR test this family
+  // is universal + non-structural (provenance metadata, not the produced
+  // node's real containment edge) and collapses polymorphic, mirroring
+  // `decision_produces_node`. See UPG_EDGE_MIGRATIONS for the rename rule.
+  // Edge-provenance (which workspace produced a committed *edge*, not just a
+  // node) has no schema mechanism yet — deliberately deferred, see the WS3
+  // proposal doc, ripple map "surprises" #3.
+  workspace_produced_node: { forward_verb: "produced", reverse_verb: "produced_in", classification: "causal", source_type: "workspace", target_type: "node" },
   // ── P14 edges (replacing foreign-key properties) ─────────────────────────
   feature_addresses_job: { forward_verb: "addresses", reverse_verb: "addressed_by", classification: "cross-domain", source_type: "feature", target_type: "job" },
   feature_drives_key_result: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "feature", target_type: "key_result" },
@@ -3501,7 +3524,10 @@ var UPG_POLYMORPHIC_EDGE_KEYS = [
   // intended semantic domain; the endpoints are the `node` wildcard.
   "work_item_blocks_work_item",
   "work_item_relates_to_work_item",
-  "work_item_duplicates_work_item"
+  "work_item_duplicates_work_item",
+  // Workspace provenance (WS3, 2026-07-05): a workspace can produce any
+  // entity type arranged in it. Widened from workspace_produced_decision.
+  "workspace_produced_node"
 ];
 var _POLY_KEY_SET = new Set(UPG_POLYMORPHIC_EDGE_KEYS);
 function isPolymorphicEdge(key) {
@@ -4263,13 +4289,19 @@ var UPG_VALID_CHILDREN = {
   // ── Portfolio layer hierarchy ────────────────────────────────────────────────
   // organization → product_area is the org-axis anchor (who owns what);
   // organization → portfolio is the strategic-axis anchor (where you invest).
-  organization: ["portfolio", "product_area"],
+  // organization → workspace (WS3, 2026-07-05): org-altitude workspace anchor
+  // (organization_thinks_in_workspace) — a workspace scoped to org altitude
+  // lives in the same portfolio-level graph as its organization node.
+  organization: ["portfolio", "product_area", "workspace"],
   // portfolios can nest (multi-level investment structures).
   portfolio: ["product", "portfolio"],
   // product_area is the organisational container for products and can
   // nest (parent → sub-area). product_area also groups features; the
-  // "Studio area owns 6 features" mental model.
-  product_area: ["product", "product_area", "feature"]
+  // "Studio area owns 6 features" mental model. product_area → workspace
+  // (WS3, 2026-07-05): plane-altitude workspace anchor
+  // (product_area_thinks_in_workspace) — "plane" is Entopo's app-level name
+  // for product_area, not a distinct spec entity.
+  product_area: ["product", "product_area", "feature", "workspace"]
 };
 function getValidChildren(entityType) {
   return UPG_VALID_CHILDREN[entityType] ?? [];
@@ -9046,6 +9078,25 @@ function getScalarToEdgeMigrations(fromVersion, toVersion) {
   return result;
 }
 var UPG_EDGE_MIGRATIONS = {
+  // (target version TBD at release ceremony — pencilled at 0.22.0, the next
+  // breaking slot after 0.21.0 per the docket; adjust the key if Wave 4
+  // claims it first.) WS3 commit-provenance collapse (2026-07-05, ratified):
+  // `workspace_produced_decision` widens to the `node` wildcard endpoint —
+  // a workspace's commit loop can legitimately produce any entity type
+  // arranged in it (decision, feature, persona, ...), not just decisions.
+  // No flip (source stays workspace); the target node's concrete type is
+  // unchanged (still a decision), only the edge key + catalog target_type
+  // widen. See the enum-vs-polymorphism ADR and the WS3 proposal doc for
+  // the full reasoning (mirrors decision_produces_node).
+  "0.22.0": [
+    // No requires_target_type: the destination's target_type is the `node`
+    // wildcard, and the endpoint guard is checked against the catalog's
+    // declared type (per the spec-integrity "endpoint guards match the
+    // catalog entry" test), not the concrete instance type — a concrete
+    // `decision` instance would never satisfy a literal 'node' guard at
+    // runtime. Gate only on the unwidened source endpoint.
+    { kind: "rename", from: "workspace_produced_decision", to: "workspace_produced_node", requires_source_type: "workspace", reason: "WS3 commit-provenance collapse (2026-07-05, Captain-ratified). workspace_produced_decision widens to the polymorphic workspace_produced_node: a workspace commit can legitimately produce any entity type, not just a decision. No flip; only the target_type widens from decision to the node wildcard." }
+  ],
   "0.9.9": [
     // (since v0.9.9, UPG-664/UPG-678) Validation experiment-model + test_plan
     // re-home. The validation chain is reshaped to the single-parent line
@@ -29896,7 +29947,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.21.0";
+var UPG_VERSION = "0.22.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();