@unified-product-graph/core 0.21.0 → 0.22.1

package/dist/index.d.cts

@@ -5793,6 +5793,20 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    organization_thinks_in_workspace: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    product_area_thinks_in_workspace: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
     product_thinks_in_workspace: {
         forward_verb: string;
         reverse_verb: string;
@@ -5800,7 +5814,7 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    workspace_produced_decision: {
+    workspace_produced_node: {
         forward_verb: string;
         reverse_verb: string;
         classification: "causal";
@@ -7672,7 +7686,7 @@ declare function isDeliberateOnlyEdge(type: string): boolean;
 /**
  * Canonical allow-list of edges that use the `'node'` wildcard endpoint.
  *
- * Five semantic families are sanctioned:
+ * Eight semantic families are sanctioned:
  *
  * 1. **Universal semantic verbs**: any node can inform / constrain / inspire
  *    any other node. The meaning is deliberately abstract; consumers render
@@ -7687,6 +7701,15 @@ declare function isDeliberateOnlyEdge(type: string): boolean;
  * 5. **Framework exercises**: a framework_exercise can include any entity type
  *    it scores. The technique is type-agnostic, so binding the target would
  *    re-weld frameworks to one entity type — the limitation this edge removes.
+ * 6. **Universal classification**: any node can be classified against a
+ *    classification_value. Classification schemes are type-agnostic.
+ * 7. **Work-item issue links**: blocks/relates/duplicates spans the work-item
+ *    set {feature, epic, user_story, task, bug} — endpoint-polymorphic over a
+ *    bounded family, not the full type universe.
+ * 8. **Workspace provenance** (WS3, 2026-07-05): a workspace's commit loop can
+ *    produce any entity type arranged in it (decision, feature, persona, ...).
+ *    Widened from the single-target `workspace_produced_decision`; see
+ *    `UPG_EDGE_MIGRATIONS` for the rename rule.
  *
  * Adding a new polymorphic edge requires extending this array AND the
  * spec-integrity regression test, which forces a conscious decision and
@@ -22495,7 +22518,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.21.0";
+declare const UPG_VERSION: "0.22.1";
 /**
  * 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

@@ -5793,6 +5793,20 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    organization_thinks_in_workspace: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    product_area_thinks_in_workspace: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
     product_thinks_in_workspace: {
         forward_verb: string;
         reverse_verb: string;
@@ -5800,7 +5814,7 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    workspace_produced_decision: {
+    workspace_produced_node: {
         forward_verb: string;
         reverse_verb: string;
         classification: "causal";
@@ -7672,7 +7686,7 @@ declare function isDeliberateOnlyEdge(type: string): boolean;
 /**
  * Canonical allow-list of edges that use the `'node'` wildcard endpoint.
  *
- * Five semantic families are sanctioned:
+ * Eight semantic families are sanctioned:
  *
  * 1. **Universal semantic verbs**: any node can inform / constrain / inspire
  *    any other node. The meaning is deliberately abstract; consumers render
@@ -7687,6 +7701,15 @@ declare function isDeliberateOnlyEdge(type: string): boolean;
  * 5. **Framework exercises**: a framework_exercise can include any entity type
  *    it scores. The technique is type-agnostic, so binding the target would
  *    re-weld frameworks to one entity type — the limitation this edge removes.
+ * 6. **Universal classification**: any node can be classified against a
+ *    classification_value. Classification schemes are type-agnostic.
+ * 7. **Work-item issue links**: blocks/relates/duplicates spans the work-item
+ *    set {feature, epic, user_story, task, bug} — endpoint-polymorphic over a
+ *    bounded family, not the full type universe.
+ * 8. **Workspace provenance** (WS3, 2026-07-05): a workspace's commit loop can
+ *    produce any entity type arranged in it (decision, feature, persona, ...).
+ *    Widened from the single-target `workspace_produced_decision`; see
+ *    `UPG_EDGE_MIGRATIONS` for the rename rule.
  *
  * Adding a new polymorphic edge requires extending this array AND the
  * spec-integrity regression test, which forces a conscious decision and
@@ -22495,7 +22518,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.21.0";
+declare const UPG_VERSION: "0.22.1";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -2302,8 +2302,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" },
@@ -3246,7 +3269,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) {
@@ -4008,13 +4034,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] ?? [];
@@ -8791,6 +8823,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
@@ -29641,7 +29692,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.21.0";
+var UPG_VERSION = "0.22.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();